Add npm publish workflow

Author: vamgan

.github/workflows/publish.yml

@@ -0,0 +1,31 @@
+name: Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Package version to publish, for example 0.1.0"
+        required: true
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+          cache: npm
+      - run: npm ci
+      - run: npm run typecheck
+      - run: npm test
+      - run: npm run build
+      - run: npm version "${{ inputs.version }}" --no-git-tag-version
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

README.md

@@ -12,3 +12,7 @@ This package is the compatibility anchor for all AgentDispatch repositories. Clo
 - Adapters: provider-specific implementations behind a stable `BackendAdapter` contract.
 - Policies: provider-neutral authorization rules for account profiles, capabilities, task types, and target modes.
 - Testing: `assertBackendAdapterContract` gives adapter repos a reusable conformance check.
+
+## Publishing
+
+See `docs/release.md` for the npm publishing workflow and the dependency-order checklist for the separate `agent-dispatch` repositories.

docs/release.md

@@ -0,0 +1,38 @@
+# Release Workflow
+
+`@agentdispatch/core` is the compatibility anchor for all AgentDispatch packages. Publish it before replacing bootstrap `file:../agentdispatch-core` links in dependent repositories.
+
+## Prerequisites
+
+- Create the `@agentdispatch` npm organization or scope.
+- Add an npm automation token as `NPM_TOKEN` in `agent-dispatch/core` repository secrets.
+- Confirm the package name `@agentdispatch/core` is available.
+
+## Publish Core
+
+Use the `Publish` GitHub Actions workflow with the target version, for example `0.1.0`.
+
+The workflow runs:
+
+```bash
+npm ci
+npm run typecheck
+npm test
+npm run build
+npm publish --provenance --access public
+```
+
+## Update Dependents
+
+After the core package is published:
+
+1. Replace `file:../agentdispatch-core` dev dependencies with `^0.1.0`.
+2. Keep `@agentdispatch/core` as a peer dependency in adapters, stores, MCP, SDK, and CLI packages.
+3. Remove CI bootstrap skips that detect `file:../` dependencies.
+4. Publish dependent packages in dependency order:
+   - `@agentdispatch/store-sqlite`
+   - `@agentdispatch/adapter-aws-agentcore`
+   - `@agentdispatch/sdk`
+   - `@agentdispatch/mcp-server`
+   - `@agentdispatch/cli`
+   - `@agentdispatch/worker-agentcore`