feat: add Contextivity ACP and permanent nightly distribution

.github/workflows/contextivity-candidate.yml

@@ -0,0 +1,251 @@
+name: Contextivity candidate
+
+on:
+  schedule:
+    - cron: "15 */3 * * *"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Exact official pingdotgg/t3code nightly tag (vX.Y.Z-nightly.YYYYMMDD.N)
+        required: false
+        type: string
+
+permissions:
+  contents: write
+  issues: write
+  id-token: write
+  attestations: write
+  actions: read
+
+concurrency:
+  group: contextivity-candidate
+  cancel-in-progress: false
+
+jobs:
+  sync:
+    name: Sync exact upstream nightly
+    runs-on: ubuntu-24.04
+    timeout-minutes: 20
+    outputs:
+      tag: ${{ steps.sync.outputs.tag }}
+      sha: ${{ steps.sync.outputs.sha }}
+      upstream_commit: ${{ steps.sync.outputs.upstream_commit }}
+    steps:
+      - name: Checkout downstream
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version-file: package.json
+
+      - id: discover
+        name: Discover official upstream nightly
+        env:
+          INPUT_TAG: ${{ github.event.inputs.tag }}
+        run: |
+          set -eu
+          if test -n "${INPUT_TAG:-}"; then
+            echo "tag=$INPUT_TAG" >> "$GITHUB_OUTPUT"
+          else
+            node --experimental-strip-types contextivity/src/cli.ts discover-upstream > "$RUNNER_TEMP/upstream.json"
+            node -e 'const fs=require("fs"); const n=JSON.parse(fs.readFileSync(process.env.RUNNER_TEMP+"/upstream.json","utf8")); fs.appendFileSync(process.env.GITHUB_OUTPUT, "tag="+n.tag+"\n")'
+          fi
+
+      - id: sync
+        name: Merge exact upstream tag
+        run: |
+          set -eu
+          tag="${{ steps.discover.outputs.tag }}"
+          if ! node --experimental-strip-types contextivity/src/cli.ts sync-tag --tag "$tag" > "$RUNNER_TEMP/sync.json"; then
+            reason=$(node -e 'const fs=require("fs"); const s=JSON.parse(fs.readFileSync(process.env.RUNNER_TEMP+"/sync.json","utf8")); process.stdout.write(s.reason||"sync failed")')
+            node --experimental-strip-types contextivity/src/cli.ts report-sync-failure --tag "$tag" --reason "$reason" || true
+            exit 1
+          fi
+          echo "tag=$tag" >> "$GITHUB_OUTPUT"
+          echo "sha=$(git rev-parse HEAD)" >> "$GITHUB_OUTPUT"
+          echo "upstream_commit=$(node -e 'const fs=require("fs"); const s=JSON.parse(fs.readFileSync(process.env.RUNNER_TEMP+"/sync.json","utf8")); process.stdout.write(s.upstreamCommit||"")')" >> "$GITHUB_OUTPUT"
+
+      - name: Downstream unit tests
+        run: node --test --experimental-strip-types contextivity/src/*.test.ts
+
+      - name: Persist synced commit
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -eu
+          sha=$(git rev-parse HEAD)
+          if git merge-base --is-ancestor "$sha" "origin/${GITHUB_REF_NAME}" 2>/dev/null; then
+            exit 0
+          fi
+          git push origin "HEAD:refs/heads/contextivity-sync/${GITHUB_RUN_ID}"
+
+  verify:
+    name: ACP tests and server build
+    needs: sync
+    runs-on: ubuntu-24.04
+    timeout-minutes: 30
+    steps:
+      - name: Checkout synced SHA
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.sync.outputs.sha }}
+          fetch-depth: 0
+
+      - name: Setup Vite+
+        uses: voidzero-dev/setup-vp@v1
+        with:
+          node-version-file: package.json
+          cache: true
+          run-install: true
+
+      - name: Print candidate test plan
+        run: node --experimental-strip-types contextivity/src/cli.ts candidate-test-plan
+
+      - name: Generic ACP and sub-agent tests
+        run: |
+          vp test run \
+            apps/server/src/provider/Layers/AcpRegistryAdapter.test.ts \
+            apps/server/src/provider/Layers/AcpRegistryProvider.test.ts \
+            apps/server/src/provider/acp/AcpAdapterSupport.test.ts \
+            apps/server/src/provider/acp/AcpCoreRuntimeEvents.test.ts \
+            apps/server/src/provider/acp/AcpRegistrySupport.test.ts \
+            apps/server/src/provider/acp/AcpRuntimeModel.test.ts \
+            apps/server/src/provider/acp/AcpSessionRuntime.policy.test.ts \
+            apps/server/src/provider/acp/ContextivityAcpExtension.test.ts \
+            apps/server/src/provider/acp/ContextivityAcpSubagentMapper.test.ts \
+            packages/client-runtime/src/state/subagentRuntime.test.ts \
+            apps/server/src/distribution/contextivityDistribution.test.ts \
+            apps/server/src/cloud/selfUpdate.test.ts
+
+      - name: Server typecheck and build
+        run: |
+          vp run --filter t3 typecheck
+          vp run --filter t3 build
+
+      - name: Upload server dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: t3-server-dist
+          path: apps/server/dist
+          if-no-files-found: error
+
+  pack:
+    name: Pack ${{ matrix.platform }}
+    needs: [sync, verify]
+    strategy:
+      fail-fast: true
+      matrix:
+        include:
+          - os: ubuntu-24.04
+            platform: linux-x64
+          - os: ubuntu-24.04-arm
+            platform: linux-arm64
+          - os: macos-13
+            platform: darwin-x64
+          - os: macos-14
+            platform: darwin-arm64
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    steps:
+      - name: Checkout synced SHA
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.sync.outputs.sha }}
+
+      - name: Setup Vite+
+        uses: voidzero-dev/setup-vp@v1
+        with:
+          node-version-file: package.json
+          cache: true
+          run-install: true
+
+      - name: Build server
+        run: vp run --filter t3 build
+
+      - name: Stage self-contained archive
+        env:
+          PLATFORM: ${{ matrix.platform }}
+        run: |
+          set -eu
+          mkdir -p contextivity-dist
+          node --experimental-strip-types contextivity/src/pack-server.ts \
+            --platform "$PLATFORM" \
+            --out contextivity-dist \
+            --upstream-version "$(node -e 'console.log(require("./apps/server/package.json").version)')" \
+            --contextivity-revision "$(git rev-parse --short=7 HEAD)"
+
+      - name: Upload archive
+        uses: actions/upload-artifact@v4
+        with:
+          name: archive-${{ matrix.platform }}
+          path: contextivity-dist/t3-server-${{ matrix.platform }}.tar.gz
+          if-no-files-found: error
+
+  publish:
+    name: Publish immutable candidate
+    needs: [sync, pack]
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          ref: ${{ needs.sync.outputs.sha }}
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version-file: package.json
+
+      - name: Download archives
+        uses: actions/download-artifact@v4
+        with:
+          pattern: archive-*
+          merge-multiple: true
+          path: contextivity-dist
+
+      - name: Write candidate manifest
+        env:
+          TAG: ${{ needs.sync.outputs.tag }}
+          SHA: ${{ needs.sync.outputs.sha }}
+        run: |
+          set -eu
+          node --experimental-strip-types contextivity/src/write-candidate-manifest.ts \
+            --tag "$TAG" \
+            --sha "${{ needs.sync.outputs.upstream_commit }}" \
+            --dir contextivity-dist \
+            --build-revision "${GITHUB_RUN_ID}-${GITHUB_SHA}" \
+            --node-engine "$(node -e 'console.log(require("./apps/server/package.json").engines.node)')" \
+            --contextivity-revision "$(git rev-parse --short=7 HEAD)"
+
+      - name: Attest artifacts
+        uses: actions/attest-build-provenance@v3
+        with:
+          subject-path: contextivity-dist/*
+
+      - name: Publish immutable candidate release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -eu
+          node --experimental-strip-types contextivity/src/cli.ts publish-candidate \
+            --dir contextivity-dist \
+            --repo "${{ github.repository }}"
+
+      - name: Advance downstream branch after a successful candidate
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -eu
+          git push origin "${{ needs.sync.outputs.sha }}:refs/heads/${GITHUB_REF_NAME}"
+          git push origin --delete "contextivity-sync/${GITHUB_RUN_ID}" || true
+
+      - name: Upload candidate assets
+        uses: actions/upload-artifact@v4
+        with:
+          name: contextivity-candidate
+          path: contextivity-dist
+          if-no-files-found: error

.github/workflows/contextivity-promote.yml

@@ -0,0 +1,81 @@
+name: Contextivity promote
+
+on:
+  workflow_dispatch:
+    inputs:
+      channel:
+        description: Fleet pointer to advance
+        required: true
+        type: choice
+        options:
+          - nightly
+          - stable
+      version:
+        description: Exact candidate identity (upstreamVersion-ctx.revision)
+        required: true
+        type: string
+      macClientVersion:
+        description: Installed official Mac desktop version (must equal manifest upstreamVersion)
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  issues: write
+
+concurrency:
+  group: contextivity-promote
+  cancel-in-progress: false
+
+jobs:
+  promote:
+    name: Manual fleet promotion
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Setup Node
+        uses: actions/setup-node@v5
+        with:
+          node-version-file: package.json
+
+      - name: Download matching candidate
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -eu
+          mkdir -p contextivity-dist
+          gh release download "contextivity-candidate/${{ github.event.inputs.version }}" \
+            --repo "${{ github.repository }}" \
+            --dir contextivity-dist \
+            --pattern "manifest.json"
+
+      - name: Exact-version Mac client gate
+        run: |
+          set -eu
+          node --experimental-strip-types contextivity/src/cli.ts promote \
+            --channel "${{ github.event.inputs.channel }}" \
+            --manifest contextivity-dist/manifest.json \
+            --version "${{ github.event.inputs.version }}" \
+            --mac-client-version "${{ github.event.inputs.macClientVersion }}" \
+            > contextivity-dist/pointer.json
+
+      - name: Publish pointer without touching the official desktop app
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          set -eu
+          channel="${{ github.event.inputs.channel }}"
+          tag="contextivity-${channel}"
+          notes="Pointer only. Install with t3-ctx updater update --channel ${channel}. Do not use the public npm t3 package."
+          if gh release view "$tag" --repo "${{ github.repository }}" >/dev/null 2>&1; then
+            gh release delete "$tag" --repo "${{ github.repository }}" --yes --cleanup-tag
+          fi
+          gh release create "$tag" contextivity-dist/pointer.json contextivity-dist/manifest.json \
+            --repo "${{ github.repository }}" \
+            --title "Contextivity ${channel} pointer" \
+            --notes "$notes" \
+            --prerelease \
+            --latest=false

.gitignore

@@ -38,3 +38,4 @@ node_modules/
 *.log
 .env*
 !.env.example
+contextivity-dist/

AGENTS.md

@@ -1,6 +1,6 @@
 # T3 Code
 
-T3 Code is a minimal GUI for coding agents. A Node WebSocket server wraps provider CLIs (Codex, Claude Code, Cursor, Grok, OpenCode) and serves web, desktop, and mobile clients.
+T3 Code is a minimal GUI for coding agents. A Node WebSocket server wraps provider CLIs (Codex, Claude Code, Cursor, Grok, OpenCode, and generic ACP Registry agents) and serves web, desktop, and mobile clients.
 
 You can think of T3 Code as an open source "bring-your-own-subscription" alternative to apps like Claude Desktop, Codex App, Cursor Glass and Conductor.
 
@@ -48,7 +48,7 @@ We need to be on the same page with terminology. When communicating, use this la
 - **we, us, and maintainers** mean Theo, Julius and the people building T3 Code. These are who you are talking to now.
 - **user** means the person using T3 Code to direct coding agents.
 - **agent** means the coding agent a user runs inside T3 Code. Depending on context, that may also include you.
-- **provider** means the agent runtime or harness T3 Code talks to, such as Codex, Claude, Cursor, or OpenCode.
+- **provider** means the agent runtime or harness T3 Code talks to, such as Codex, Claude, Cursor, OpenCode, or a generic ACP Registry agent.
 - **client** means the web, desktop, or mobile UI.
 - **environment** means one running T3 server and the machine, filesystem, provider credentials, and state it owns.
 - **project** means an environment-local workspace record rooted at a directory.
@@ -68,7 +68,7 @@ The most common defect in this repo is a change that works on the path you teste
 
 - **Entry points.** A behavior reachable from the chat view is usually also reachable from Settings, the command palette, and a keybinding. Fixing one is not fixing the feature.
 - **Clients.** Web, desktop (wraps web, adds Electron shell/IPC), and mobile (React Native, separate navigation). Shared logic lives in `packages/client-runtime`
-- **Providers.** Codex, Claude, Cursor, Grok, and OpenCode each have an adapter. Provider-shaped features need a decision per adapter, even if the decision is "not supported here".
+- **Providers.** Codex, Claude, Cursor, Grok, OpenCode, and ACP Registry each have an adapter. Provider-shaped features need a decision per adapter, even if the decision is "not supported here".
 - **Contracts.** Anything crossing the wire is typed in `packages/contracts`. Change the schema and the server, web, mobile, and desktop all follow.
 - **Reverse states.** If you added a way in, add the way out and the way to see it. Snooze needs unsnooze. Close needs reopen. A one-way door is a bug.
 - **Connection modes.** Local, remote/relay, and tunnel behave differently. Multi-device and multi-environment cases are real.

README.md

@@ -2,7 +2,7 @@
 
 T3 Code is an "agent harness control surface". It enables control of the agents on your machine with a best-in-class mobile app ([iOS](https://apps.apple.com/us/app/t3-code-remote-claude-more/id6787819824), [Android](https://play.google.com/store/apps/details?id=com.t3tools.t3code)), [web app](https://app.t3.codes) and [Electron-based desktop app](https://t3.codes).
 
-Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, and OpenCode. If they're set up on your computer, T3 Code can control them.
+Works with your subscriptions on Claude Code, Codex, Cursor, Grok Build, and OpenCode, plus generic ACP agents such as Contextivity. If they're set up on your computer, T3 Code can control them.
 
 ## "Wait, what are you selling me?"
 
@@ -13,13 +13,14 @@ We wanted something performant, remote-ready, and truly open. If we ever go the
 ## Installation
 
 > [!WARNING]
-> T3 Code currently supports Codex, Claude, Cursor, Grok Build and OpenCode. Install and authenticate at least one provider before use:
+> T3 Code currently supports Codex, Claude, Cursor, Grok Build, OpenCode, and generic ACP agents. Install and authenticate at least one provider before use:
 >
 > - Codex: install [Codex CLI](https://developers.openai.com/codex/cli) and run `codex login`
 > - Claude: install [Claude Code](https://claude.com/product/claude-code) and run `claude auth login`
 > - Cursor: install [Cursor CLI](https://cursor.com/cli) and run `agent login`
 > - Grok Build: install [Grok Build CLI](https://x.ai/cli) and run `grok login`
 > - OpenCode: install [OpenCode](https://opencode.ai) and run `opencode auth login`
+> - ACP Registry: add a configured ACP executable in Settings (for Contextivity, `contextivity-agent --mode acp`). See [ACP Registry](./docs/user/providers-acp-registry.md)
 
 ### Try it out (install-free)