feat(persona, dispatch): Phase 0 — full §6 schema + dispatch envelope contracts

.github/workflows/publish.yml

@@ -88,7 +88,10 @@ jobs:
               # DelegationRequest types) — must build + publish after it. Same
               # max-parallel: 1 contract keeps webhook-runtime's publish after
               # specialists'.
-              PACKAGES='["traits","persona","connectivity","coordination","core","sessions","surfaces","policy","proactive","harness","telemetry","memory","turn-context","inbox","continuation","sdk","vfs","specialists","webhook-runtime","cloudflare-runtime"]'
+              # persona + dispatch (Phase 0 of proactive-unification) are types-only
+              # packages with zero runtime deps — keep persona where main placed it
+              # (after traits) and insert dispatch alongside it.
+              PACKAGES='["traits","persona","dispatch","connectivity","coordination","core","sessions","surfaces","policy","proactive","harness","telemetry","memory","turn-context","inbox","continuation","sdk","vfs","specialists","webhook-runtime","cloudflare-runtime"]'
               FIRST='traits'
               ;;
             *)

package.json

@@ -17,6 +17,7 @@
     "packages/routing",
     "packages/connectivity",
     "packages/coordination",
+    "packages/dispatch",
     "packages/proactive",
     "packages/policy",
     "packages/integration",
@@ -29,6 +30,7 @@
   ],
   "scripts": {
     "build": "npm run build --workspaces --if-present",
+    "typecheck": "npm run typecheck -w @agent-assistant/dispatch && npm run typecheck -w @agent-assistant/persona",
     "build:sdk": "npm run build -w @agent-assistant/sdk",
     "pretest": "npm run build",
     "test": "npm run test --workspaces --if-present -- --passWithNoTests",

packages/dispatch/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0 - 2026-05-23
+
+- Added dispatch envelope contract types: `DispatchEnvelope`, `EventEnvelope`, and `IntegrationAccess`.
+- Added dispatch response union: `DispatchResponse`.
+- Added response helper types: `DeliveryHint`, `LogEntry`, `SandboxTask`, and `AfterTaskHook`.

packages/dispatch/README.md

@@ -0,0 +1,26 @@
+# @agent-assistant/dispatch
+
+TypeScript contract types for proactive persona dispatch requests and responses in Agent Assistant. The exported dispatch envelope follows canonical spec section 7.2: https://github.com/AgentWorkforce/sage/blob/main/specs/proactive-unification.md#72-dispatch-envelope.
+
+The response union covers the synchronous, sandbox-borrow, async callback, and error outcomes from canonical spec section 7.5: https://github.com/AgentWorkforce/sage/blob/main/specs/proactive-unification.md#75-async-callback.
+
+```ts
+import type { DispatchEnvelope, DispatchResponse } from "@agent-assistant/dispatch";
+
+const envelope: DispatchEnvelope<{ cron: string }> = {
+  type: "cron.tick",
+  personaId: "morning-briefing",
+  workspaceId: "workspace-1",
+  deploymentId: "deployment-1",
+  occurredAt: new Date().toISOString(),
+  envelope: {
+    id: "evt-1",
+    payload: { cron: "0 8 * * 1-5" },
+  },
+};
+
+const response: DispatchResponse = {
+  kind: "done",
+  delivery: [{ kind: "slack.message", text: "Briefing ready" }],
+};
+```

packages/dispatch/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@agent-assistant/dispatch",
+  "version": "0.1.0",
+  "description": "Dispatch envelope and async response contract types for Agent Assistant proactive personas",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsc --noEmit --module NodeNext --moduleResolution NodeNext --target ES2022 --strict --skipLibCheck --types vitest src/types.test.ts && vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/agent-assistant"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

packages/dispatch/src/index.ts

@@ -0,0 +1,10 @@
+export type {
+  AfterTaskHook,
+  DeliveryHint,
+  DispatchEnvelope,
+  DispatchResponse,
+  EventEnvelope,
+  IntegrationAccess,
+  LogEntry,
+  SandboxTask,
+} from "./types.js";