Merge remote-tracking branch 'origin/main' into tyler/showcase-fix-shelldocs-structure

# Conflicts:
#	showcase/shell-docs/src/app/[[...slug]]/page.tsx

Author: tylerslaton

.claude/skills/showcase-demo-debugging/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: showcase-demo-debugging
 description: Build, debug, and regression-test CopilotKit showcase demos. Use when working under showcase/, creating new showcase demos/items/cells/pills, implementing showcase features, investigating showcase demo bugs, D5/e2e-deep failures, aimock fixture gaps, direct-LLM versus aimock behavior, recording fixtures, testing every demo pill/cell, verifying repeated and interleaved suggestion-pill fixture stability, enforcing langgraph-python 1:1 parity, or migrating a demo to the v2 CopilotKit showcase flow.
+metadata:
+  internal: true
 ---
 
 # Showcase Demo Work

.github/config-allowlist.txt

@@ -102,6 +102,7 @@ showcase/integrations/langroid/next.config.ts
 showcase/integrations/llamaindex/next.config.ts
 showcase/integrations/mastra/next.config.ts
 showcase/integrations/ms-agent-dotnet/next.config.ts
+showcase/integrations/ms-agent-harness-dotnet/next.config.ts
 showcase/integrations/ms-agent-python/next.config.ts
 showcase/integrations/pydantic-ai/next.config.ts
 showcase/integrations/spring-ai/next.config.ts

.github/workflows/prerelease.yml

@@ -74,11 +74,24 @@ jobs:
       - name: Run tests
         run: pnpm run test
 
+      # Exclude node_modules and build caches from the artifact. Including
+      # them produces ~6M files for this monorepo, which OOMs
+      # upload-artifact's Node process at its 4GB heap limit during
+      # enumeration (each pnpm symlink resolves to a separate entry, and
+      # the action holds the full manifest in memory before streaming).
+      # The publish job runs `pnpm install --frozen-lockfile` after
+      # download to restore node_modules from pnpm-lock.yaml — mirrors
+      # publish-release.yml.
       - name: Upload workspace
         uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
         with:
           name: workspace
-          path: .
+          path: |
+            .
+            !**/node_modules/**
+            !**/.next/**
+            !**/.turbo/**
+            !**/.nx/**
           include-hidden-files: true
           retention-days: 1
 
@@ -107,6 +120,14 @@ jobs:
           node-version: 22.x
           registry-url: https://registry.npmjs.org
 
+      # Restore node_modules — the build job excludes them from the
+      # uploaded workspace artifact (see "Upload workspace" above). Uses
+      # pnpm-lock.yaml from the artifact, so this is a deterministic
+      # restore of exactly what the build job ran with. `pnpm tsx` in the
+      # publish step below requires tsx to be installed locally.
+      - name: Install Dependencies
+        run: pnpm install --frozen-lockfile
+
       - name: Publish prerelease
         env:
           NODE_AUTH_TOKEN: ""

.github/workflows/showcase_build.yml

@@ -43,6 +43,7 @@ on:
           - ms-agent-python
           - claude-sdk-typescript
           - ms-agent-dotnet
+          - ms-agent-harness-dotnet
           - claude-sdk-python
           - built-in-agent
           - shell-dojo
@@ -124,6 +125,8 @@ jobs:
               - 'showcase/integrations/claude-sdk-typescript/**'
             ms_agent_dotnet:
               - 'showcase/integrations/ms-agent-dotnet/**'
+            ms_agent_harness_dotnet:
+              - 'showcase/integrations/ms-agent-harness-dotnet/**'
             claude_sdk_python:
               - 'showcase/integrations/claude-sdk-python/**'
             built_in_agent:
@@ -187,6 +190,7 @@ jobs:
             {"dispatch_name":"ms-agent-python","filter_key":"ms_agent_python","context":"showcase/integrations/ms-agent-python","image":"showcase-ms-agent-python","railway_id":"655db75a-af8d-427d-a4f9-441570ae5003","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
             {"dispatch_name":"claude-sdk-typescript","filter_key":"claude_sdk_typescript","context":"showcase/integrations/claude-sdk-typescript","image":"showcase-claude-sdk-typescript","railway_id":"18a98727-5700-44aa-b497-b60795dbbd6a","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
             {"dispatch_name":"ms-agent-dotnet","filter_key":"ms_agent_dotnet","context":"showcase/integrations/ms-agent-dotnet","image":"showcase-ms-agent-dotnet","railway_id":"beeb2dd6-87a4-4599-aa07-0578f7bd6519","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
+            {"dispatch_name":"ms-agent-harness-dotnet","filter_key":"ms_agent_harness_dotnet","context":"showcase/integrations/ms-agent-harness-dotnet","image":"showcase-ms-agent-harness-dotnet","railway_id":"6343d7f9-6c3f-4c8d-9a6e-79f03d2f1e37","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
             {"dispatch_name":"claude-sdk-python","filter_key":"claude_sdk_python","context":"showcase/integrations/claude-sdk-python","image":"showcase-claude-sdk-python","railway_id":"b122ab65-9854-4cb2-a68e-b50ff13f7481","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
             {"dispatch_name":"built-in-agent","filter_key":"built_in_agent","context":"showcase/integrations/built-in-agent","image":"showcase-built-in-agent","railway_id":"f4f8371a-bc46-45b2-b6d4-9c9af608bdbf","timeout":15,"lfs":false,"build_args":"","dockerfile":"","health_path":"/api/health"},
             {"dispatch_name":"shell-dojo","filter_key":"shell_dojo","context":".","image":"showcase-shell-dojo","railway_id":"7ad1ece7-2228-49cd-8a78-bddf30322907","timeout":10,"lfs":false,"build_args":"","dockerfile":"showcase/shell-dojo/Dockerfile","health_path":"/"},
@@ -304,7 +308,7 @@ jobs:
         uses: depot/setup-action@15c09a5f77a0840ad4bce955686522a257853461 # v1
 
       - name: Login to GHCR
-        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4.1.0
+        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee # v4.2.0
         with:
           registry: ghcr.io
           username: ${{ github.actor }}
@@ -397,7 +401,7 @@ jobs:
           done
 
       - name: Build and push
-        uses: depot/build-push-action@5f3b3c2e5a00f0093de47f657aeaefcedff27d18 # v1
+        uses: depot/build-push-action@98e78adca7817480b8185f474a400b451d74e287 # v1.18.0
         with:
           project: m2kw2wmmcp
           context: ${{ matrix.service.context }}

.github/workflows/showcase_build_check.yml

@@ -78,6 +78,8 @@ jobs:
               - 'showcase/integrations/claude-sdk-typescript/**'
             ms_agent_dotnet:
               - 'showcase/integrations/ms-agent-dotnet/**'
+            ms_agent_harness_dotnet:
+              - 'showcase/integrations/ms-agent-harness-dotnet/**'
             claude_sdk_python:
               - 'showcase/integrations/claude-sdk-python/**'
             built_in_agent:
@@ -141,6 +143,7 @@ jobs:
             {"dispatch_name":"ms-agent-python","filter_key":"ms_agent_python","context":"showcase/integrations/ms-agent-python","image":"showcase-ms-agent-python","timeout":15,"lfs":false,"build_args":"","dockerfile":""},
             {"dispatch_name":"claude-sdk-typescript","filter_key":"claude_sdk_typescript","context":"showcase/integrations/claude-sdk-typescript","image":"showcase-claude-sdk-typescript","timeout":15,"lfs":false,"build_args":"","dockerfile":""},
             {"dispatch_name":"ms-agent-dotnet","filter_key":"ms_agent_dotnet","context":"showcase/integrations/ms-agent-dotnet","image":"showcase-ms-agent-dotnet","timeout":15,"lfs":false,"build_args":"","dockerfile":""},
+            {"dispatch_name":"ms-agent-harness-dotnet","filter_key":"ms_agent_harness_dotnet","context":"showcase/integrations/ms-agent-harness-dotnet","image":"showcase-ms-agent-harness-dotnet","timeout":15,"lfs":false,"build_args":"","dockerfile":""},
             {"dispatch_name":"claude-sdk-python","filter_key":"claude_sdk_python","context":"showcase/integrations/claude-sdk-python","image":"showcase-claude-sdk-python","timeout":15,"lfs":false,"build_args":"","dockerfile":""},
             {"dispatch_name":"built-in-agent","filter_key":"built_in_agent","context":"showcase/integrations/built-in-agent","image":"showcase-built-in-agent","timeout":15,"lfs":false,"build_args":"","dockerfile":""},
             {"dispatch_name":"shell-dojo","filter_key":"shell_dojo","context":".","image":"showcase-shell-dojo","timeout":10,"lfs":false,"build_args":"","dockerfile":"showcase/shell-dojo/Dockerfile"},
@@ -261,7 +264,7 @@ jobs:
           done
 
       - name: Build Docker image (no push)
-        uses: depot/build-push-action@5f3b3c2e5a00f0093de47f657aeaefcedff27d18 # v1
+        uses: depot/build-push-action@98e78adca7817480b8185f474a400b451d74e287 # v1.18.0
         with:
           project: m2kw2wmmcp
           context: ${{ matrix.service.context }}

.github/workflows/showcase_deploy.yml

@@ -41,6 +41,7 @@ on:
           - ms-agent-python
           - claude-sdk-typescript
           - ms-agent-dotnet
+          - ms-agent-harness-dotnet
           - claude-sdk-python
           - built-in-agent
           - shell-dojo
@@ -110,6 +111,7 @@ jobs:
             {"dispatch_name":"ms-agent-python","railway_id":"655db75a-af8d-427d-a4f9-441570ae5003","health_path":"/api/health"},
             {"dispatch_name":"claude-sdk-typescript","railway_id":"18a98727-5700-44aa-b497-b60795dbbd6a","health_path":"/api/health"},
             {"dispatch_name":"ms-agent-dotnet","railway_id":"beeb2dd6-87a4-4599-aa07-0578f7bd6519","health_path":"/api/health"},
+            {"dispatch_name":"ms-agent-harness-dotnet","railway_id":"6343d7f9-6c3f-4c8d-9a6e-79f03d2f1e37","health_path":"/api/health"},
             {"dispatch_name":"claude-sdk-python","railway_id":"b122ab65-9854-4cb2-a68e-b50ff13f7481","health_path":"/api/health"},
             {"dispatch_name":"built-in-agent","railway_id":"f4f8371a-bc46-45b2-b6d4-9c9af608bdbf","health_path":"/api/health"},
             {"dispatch_name":"shell-dojo","railway_id":"7ad1ece7-2228-49cd-8a78-bddf30322907","health_path":"/"},

.github/workflows/showcase_eval-webhook_build.yml

@@ -21,7 +21,7 @@ jobs:
           persist-credentials: false
 
       - name: Log in to GHCR
-        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4.1.0
+        uses: docker/login-action@650006c6eb7dba73a995cc03b0b2d7f5ca915bee # v4.2.0
         with:
           registry: ghcr.io
           username: ${{ github.actor }}

.github/workflows/showcase_keep-alive.yml

@@ -44,6 +44,7 @@ jobs:
           - llamaindex
           - mastra
           - ms-agent-dotnet
+          - ms-agent-harness-dotnet
           - ms-agent-python
           - pydantic-ai
           - spring-ai

.oxlintrc.json

@@ -28,6 +28,12 @@
     "unicorn/prefer-array-flat-map": "warn"
   },
   "overrides": [
+    {
+      "files": ["packages/**/*.{ts,tsx}"],
+      "rules": {
+        "copilotkit/no-single-arg-zod-record": "error"
+      }
+    },
     {
       "files": ["packages/**/*.{ts,tsx}", "examples/**/*.{ts,tsx}"],
       "rules": {

lefthook.yml

@@ -29,7 +29,15 @@ pre-commit:
       # still invokes this hook with an empty expansion, and oxlint/oxfmt
       # would default to operating on the current directory, defeating the
       # scoping entirely. stage_fixed re-stages whatever the hooks modify.
-      glob: "*.{js,jsx,ts,tsx,mjs,cjs,json,jsonc,json5,md,css,yml,yaml,html,vue,py}"
+      # Intentionally excludes json/jsonc/json5: oxfmt --write rewrites JSON
+      # files into JSON5 syntax (4-space indent, trailing commas, compact
+      # objects) when invoked via lefthook with staged file paths. The result
+      # is invalid strict JSON that pnpm rejects with ERR_PNPM_JSON_PARSE,
+      # blocking every commit that touches a package.json (see PRs #5054,
+      # #5055). JSON formatting is owned by pnpm/manual editing; oxfmt has
+      # no per-file knobs to keep package.json valid, so the only safe fix
+      # is to keep .json* out of this hook entirely.
+      glob: "*.{js,jsx,ts,tsx,mjs,cjs,md,css,yml,yaml,html,vue,py}"
       # Mirror the ignorePatterns in .oxlintrc.json / .oxfmtrc.json at the
       # hook layer. Without this, a docs-only commit expands {staged_files}
       # to a single docs/** path; oxlint silently processes 0 files, then