@adcp/sdk 14.0.0-beta.12 → 14.0.0-beta.13

package/dist/lib/server/decisioning/runtime/task-registry.js

@@ -18,7 +18,8 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var task_registry_exports = {};
 __export(task_registry_exports, {
-  createInMemoryTaskRegistry: () => createInMemoryTaskRegistry
+  createInMemoryTaskRegistry: () => createInMemoryTaskRegistry,
+  taskRecordMatchesScope: () => taskRecordMatchesScope
 });
 module.exports = __toCommonJS(task_registry_exports);
 var import_node_crypto = require("node:crypto");
@@ -26,17 +27,27 @@ const TERMINAL_TASK_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "
 function isTerminalTaskStatus(status) {
   return TERMINAL_TASK_STATUSES.has(status);
 }
+function taskRecordMatchesScope(record, scope) {
+  if (record.accountId !== scope.accountId) return false;
+  return record.ownerScope === scope.ownerScope || record.ownerScope === void 0 && scope.ownerScope === `account:${scope.accountId}`;
+}
+function taskStorageKey(taskId, scope) {
+  return JSON.stringify([scope.accountId, scope.ownerScope, taskId]);
+}
 function createInMemoryTaskRegistry() {
   const tasks = /* @__PURE__ */ new Map();
   const backgrounds = /* @__PURE__ */ new Map();
   return {
+    scopeVersion: 1,
     async create(opts) {
       const taskId = opts.overrideTaskId ?? `task_${(0, import_node_crypto.randomUUID)()}`;
-      if (tasks.has(taskId)) {
+      const scope = { accountId: opts.accountId, ownerScope: opts.ownerScope ?? `account:${opts.accountId}` };
+      const storageKey = taskStorageKey(taskId, scope);
+      if (tasks.has(storageKey)) {
         throw new Error(`task_id already registered: ${taskId}`);
       }
       const now = (/* @__PURE__ */ new Date()).toISOString();
-      tasks.set(taskId, {
+      tasks.set(storageKey, {
         taskId,
         tool: opts.tool,
         accountId: opts.accountId,
@@ -48,28 +59,31 @@ function createInMemoryTaskRegistry() {
       });
       return { taskId };
     },
-    async getTask(taskId) {
-      const record = tasks.get(taskId);
+    async getTask(taskId, scope) {
+      const record = tasks.get(taskStorageKey(taskId, scope));
       return record ?? null;
     },
+    async _getTaskUnsafe(taskId) {
+      const matches = Array.from(tasks.values()).filter((record) => record.taskId === taskId);
+      return matches.length === 1 ? matches[0] : null;
+    },
     async list(opts) {
-      if (opts.ownerScope === void 0) return { tasks: [] };
       return {
         tasks: Array.from(tasks.values()).filter(
-          (record) => record.accountId === opts.accountId && (record.ownerScope === opts.ownerScope || record.ownerScope === void 0 && opts.ownerScope === `account:${opts.accountId}`)
+          (record) => record.accountId === opts.accountId && record.ownerScope === opts.ownerScope
         )
       };
     },
-    async complete(taskId, result) {
-      const existing = tasks.get(taskId);
+    async complete(taskId, scope, result) {
+      const existing = tasks.get(taskStorageKey(taskId, scope));
       if (!existing) return;
       if (isTerminalTaskStatus(existing.status)) return;
       existing.status = "completed";
       existing.result = result;
       existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     },
-    async fail(taskId, error, result) {
-      const existing = tasks.get(taskId);
+    async fail(taskId, scope, error, result) {
+      const existing = tasks.get(taskStorageKey(taskId, scope));
       if (!existing) return;
       if (isTerminalTaskStatus(existing.status)) return;
       existing.status = "failed";
@@ -78,29 +92,34 @@ function createInMemoryTaskRegistry() {
       existing.statusMessage = error.message;
       existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     },
-    async updateProgress(taskId, progress) {
-      const existing = tasks.get(taskId);
+    async updateProgress(taskId, scope, progress) {
+      const existing = tasks.get(taskStorageKey(taskId, scope));
       if (!existing) return;
       if (isTerminalTaskStatus(existing.status)) return;
       if (existing.status === "submitted") existing.status = "working";
       existing.progress = progress;
       existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     },
-    _registerBackground(taskId, completion) {
+    _registerBackground(taskId, scope, completion) {
+      const storageKey = taskStorageKey(taskId, scope);
       const composed = completion.then(
         () => {
-          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);
+          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);
         },
         () => {
-          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);
+          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);
         }
       );
-      backgrounds.set(taskId, composed);
+      backgrounds.set(storageKey, composed);
     },
-    async awaitTask(taskId) {
-      const pending = backgrounds.get(taskId);
+    async awaitTask(taskId, scope) {
+      const pending = backgrounds.get(taskStorageKey(taskId, scope));
       if (pending) await pending;
     },
+    async _awaitTaskUnsafe(taskId) {
+      const pending = Array.from(backgrounds.entries()).filter(([key]) => JSON.parse(key)[2] === taskId).map(([, completion]) => completion);
+      await Promise.all(pending);
+    },
     clear() {
       tasks.clear();
       backgrounds.clear();
@@ -109,6 +128,7 @@ function createInMemoryTaskRegistry() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  createInMemoryTaskRegistry
+  createInMemoryTaskRegistry,
+  taskRecordMatchesScope
 });
 //# sourceMappingURL=task-registry.js.map

package/dist/lib/server/decisioning/runtime/task-registry.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/task-registry.ts"],"sourcesContent":["/**\n * In-memory task registry for the v6.0 alpha runtime.\n *\n * The framework owns task lifecycle. When an adopter method returns a\n * `TaskHandoff` marker, the framework:\n *   1. Allocates a `taskId` and writes a `submitted` record.\n *   2. Returns the submitted envelope to the buyer immediately.\n *   3. Runs the handoff function in the background.\n *   4. Updates the record on progress (`updateProgress`) and terminal\n *      state (`complete` / `fail`) from the method's return/throw.\n *\n * Adopters never call into the registry directly. Wire-level `tasks/get`\n * integration (so buyers can poll the lifecycle) reads via `getTask`;\n * test harnesses use `awaitTask` to flush the background promise\n * deterministically.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { AdcpStructuredError, TaskHandoffProgress } from '../async-outcome';\n\n/**\n * AdCP-spec task lifecycle states. Mirrors `enums/task-status.json` —\n * the v6 framework writes `'submitted'` on create, transitions to\n * `'working'` on the first `updateProgress()` call, and terminates at\n * `'completed'` / `'failed'`. The other states (`'input-required'`,\n * `'canceled'`, `'rejected'`, `'auth-required'`, `'unknown'`) are\n * reserved for adopter-emitted transitions via the forthcoming\n * `taskRegistry.transition()` API (v6.1).\n */\nexport type TaskStatus =\n  | 'submitted'\n  | 'working'\n  | 'input-required'\n  | 'completed'\n  | 'canceled'\n  | 'failed'\n  | 'rejected'\n  | 'auth-required'\n  | 'unknown';\n\nconst TERMINAL_TASK_STATUSES: ReadonlySet<TaskStatus> = new Set(['completed', 'failed', 'rejected', 'canceled']);\n\nfunction isTerminalTaskStatus(status: TaskStatus): boolean {\n  return TERMINAL_TASK_STATUSES.has(status);\n}\n\nexport interface TaskRecord<TResult = unknown, TError extends AdcpStructuredError = AdcpStructuredError> {\n  taskId: string;\n  /** Tool name that started the task (e.g., 'create_media_buy'). */\n  tool: string;\n  /** Account that started the task — sessionKey-like for cross-request scoping. */\n  accountId: string;\n  /** Tenant/principal owner scope used with accountId for list/read isolation. */\n  ownerScope?: string;\n  /** Current lifecycle state — full AdCP-spec `task-status` enum. */\n  status: TaskStatus;\n  /** Status message on the final arm (`error.message` on failed). */\n  statusMessage?: string;\n  /** Canonical terminal artifact on `completed`, `failed`, or `rejected`. */\n  result?: TResult;\n  /** Terminal error on `failed`. */\n  error?: TError;\n  /**\n   * Intermediate progress from `TaskHandoffContext.update(...)` calls.\n   * Written by the background handoff function; surfaced to buyers polling\n   * `tasks_get` via the spec `progress` field.\n   */\n  progress?: TaskHandoffProgress;\n  /**\n   * Whether the buyer wired `push_notification_config.url` on the original\n   * request. Surfaced to the buyer via `tasks_get`'s spec-defined\n   * `has_webhook: boolean` field so they can decide between long-poll vs.\n   * single-shot polling.\n   */\n  hasWebhook?: boolean;\n  /** ISO 8601 timestamps. */\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface TaskRegistryListOptions {\n  accountId: string;\n  /**\n   * Caller ownership scope derived from buyer agent, credential, session,\n   * or the single-principal account fallback. Optional for source\n   * compatibility with older custom registries, but buyer-visible protocol\n   * task tools pass it whenever they can identify a caller and built-in\n   * registries fail closed when it is absent.\n   */\n  ownerScope?: string;\n}\n\nexport interface TaskRegistryListResult<TResult = unknown> {\n  tasks: TaskRecord<TResult>[];\n}\n\n// All read/write methods are async to accommodate storage-backed\n// implementations (`createPostgresTaskRegistry`). The in-memory impl\n// resolves immediately. The framework `await`s every call, so the\n// in-memory case pays one microtask per dispatch — negligible.\nexport interface TaskRegistry {\n  /**\n   * Allocate a new task record. Returns the `taskId` the framework hands\n   * to `platform.xxxTask(taskId, ...)`. Initial status is `submitted`.\n   *\n   * `hasWebhook: true` when the buyer wired `push_notification_config.url`\n   * — surfaced via `tasks_get`'s `has_webhook` field. Defaults to `false`.\n   *\n   * `overrideTaskId` — when set, the registry uses this exact string as the\n   * task id instead of minting a fresh one. Throws if the id is already\n   * registered (uniqueness is the caller's responsibility).\n   */\n  create(opts: {\n    tool: string;\n    accountId: string;\n    ownerScope?: string;\n    hasWebhook?: boolean;\n    overrideTaskId?: string;\n  }): Promise<{ taskId: string }>;\n\n  /** Read a task by id. Returns `null` if unknown. */\n  getTask<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null>;\n\n  /**\n   * List tasks owned by a resolved account. Buyer-facing AdCP task\n   * reconciliation must use this scoped surface, never the transport-level\n   * MCP TaskStore, because MCP task records do not carry AdCP ownership,\n   * protocol, or tool metadata.\n   *\n   * Multi-tenant deployments that share an AdCP account across principals\n   * must persist and filter by `ownerScope`. Rows without `ownerScope` are\n   * treated as legacy account-scoped rows: built-in registries return them\n   * only for the account-fallback owner scope (`account:${accountId}`), not\n   * for credential-, agent-, or session-scoped callers.\n   */\n  list?(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult>;\n\n  /**\n   * Mark a task `completed` with the method's return value. No-op if the\n   * task is already terminal (idempotent).\n   */\n  complete<TResult>(taskId: string, result: TResult): Promise<void>;\n\n  /**\n   * Mark a task `failed` with the structured error and, when available, the\n   * canonical terminal artifact. No-op if the task is already terminal.\n   */\n  fail(taskId: string, error: AdcpStructuredError, result?: unknown): Promise<void>;\n\n  /**\n   * Record intermediate progress from `TaskHandoffContext.update(...)`.\n   * Transitions the task from `'submitted'` → `'working'` on the first\n   * call. No-op on already-terminal tasks. The `progress` payload is\n   * written to the record and surfaced to buyers polling `tasks_get`.\n   */\n  updateProgress(taskId: string, progress: TaskHandoffProgress): Promise<void>;\n\n  /**\n   * Register the background completion promise the framework spawned for\n   * the `*Task` invocation. Tests await this for deterministic settlement;\n   * production callers don't need it.\n   *\n   * @internal\n   */\n  _registerBackground(taskId: string, completion: Promise<void>): void;\n\n  /**\n   * Await any registered background completion for a task. Resolves\n   * immediately if no background is registered or it has already settled.\n   * Used by test harnesses + `tasks/get` integration.\n   */\n  awaitTask(taskId: string): Promise<void>;\n\n  /**\n   * Optional test-harness flush. In-memory registries expose this so\n   * `AdcpServer.compliance.reset()` can clear hardcoded overrideTaskId\n   * records between repeated storyboard runs. Persistent registries should\n   * omit it unless they can safely flush their configured backend.\n   */\n  clear?(): void | Promise<void>;\n}\n\nexport function createInMemoryTaskRegistry(): TaskRegistry {\n  const tasks = new Map<string, TaskRecord<unknown>>();\n  const backgrounds = new Map<string, Promise<void>>();\n\n  return {\n    async create(opts: {\n      tool: string;\n      accountId: string;\n      ownerScope?: string;\n      hasWebhook?: boolean;\n      overrideTaskId?: string;\n    }): Promise<{ taskId: string }> {\n      const taskId = opts.overrideTaskId ?? `task_${randomUUID()}`;\n      if (tasks.has(taskId)) {\n        throw new Error(`task_id already registered: ${taskId}`);\n      }\n      const now = new Date().toISOString();\n      tasks.set(taskId, {\n        taskId,\n        tool: opts.tool,\n        accountId: opts.accountId,\n        ownerScope: opts.ownerScope ?? `account:${opts.accountId}`,\n        status: 'submitted',\n        ...(opts.hasWebhook && { hasWebhook: true }),\n        createdAt: now,\n        updatedAt: now,\n      });\n      return { taskId };\n    },\n\n    async getTask<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null> {\n      const record = tasks.get(taskId);\n      return (record as TaskRecord<TResult> | undefined) ?? null;\n    },\n\n    async list(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult> {\n      if (opts.ownerScope === undefined) return { tasks: [] };\n      return {\n        tasks: Array.from(tasks.values()).filter(\n          record =>\n            record.accountId === opts.accountId &&\n            (record.ownerScope === opts.ownerScope ||\n              (record.ownerScope === undefined && opts.ownerScope === `account:${opts.accountId}`))\n        ),\n      };\n    },\n\n    async complete<TResult>(taskId: string, result: TResult): Promise<void> {\n      const existing = tasks.get(taskId);\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'completed';\n      existing.result = result;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async fail(taskId: string, error: AdcpStructuredError, result?: unknown): Promise<void> {\n      const existing = tasks.get(taskId);\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'failed';\n      existing.error = error;\n      if (result !== undefined) existing.result = result;\n      existing.statusMessage = error.message;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async updateProgress(taskId: string, progress: TaskHandoffProgress): Promise<void> {\n      const existing = tasks.get(taskId);\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      if (existing.status === 'submitted') existing.status = 'working';\n      existing.progress = progress;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    _registerBackground(taskId: string, completion: Promise<void>): void {\n      const composed: Promise<void> = completion.then(\n        () => {\n          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);\n        },\n        () => {\n          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);\n        }\n      );\n      backgrounds.set(taskId, composed);\n    },\n\n    async awaitTask(taskId: string): Promise<void> {\n      const pending = backgrounds.get(taskId);\n      if (pending) await pending;\n    },\n\n    clear(): void {\n      tasks.clear();\n      backgrounds.clear();\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/task-registry.ts"],"sourcesContent":["/**\n * In-memory task registry for the v6.0 alpha runtime.\n *\n * The framework owns task lifecycle. When an adopter method returns a\n * `TaskHandoff` marker, the framework:\n *   1. Allocates a `taskId` and writes a `submitted` record.\n *   2. Returns the submitted envelope to the buyer immediately.\n *   3. Runs the handoff function in the background.\n *   4. Updates the record on progress (`updateProgress`) and terminal\n *      state (`complete` / `fail`) from the method's return/throw.\n *\n * Adopters never call into the registry directly. Wire-level `tasks/get`\n * integration (so buyers can poll the lifecycle) reads via scoped `getTask`;\n * test harnesses use `awaitTask` to flush the background promise\n * deterministically.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { AdcpStructuredError, TaskHandoffProgress } from '../async-outcome';\n\n/**\n * AdCP-spec task lifecycle states. Mirrors `enums/task-status.json` —\n * the v6 framework writes `'submitted'` on create, transitions to\n * `'working'` on the first `updateProgress()` call, and terminates at\n * `'completed'` / `'failed'`. The other states (`'input-required'`,\n * `'canceled'`, `'rejected'`, `'auth-required'`, `'unknown'`) are\n * reserved for adopter-emitted transitions via the forthcoming\n * `taskRegistry.transition()` API (v6.1).\n */\nexport type TaskStatus =\n  | 'submitted'\n  | 'working'\n  | 'input-required'\n  | 'completed'\n  | 'canceled'\n  | 'failed'\n  | 'rejected'\n  | 'auth-required'\n  | 'unknown';\n\nconst TERMINAL_TASK_STATUSES: ReadonlySet<TaskStatus> = new Set(['completed', 'failed', 'rejected', 'canceled']);\n\nfunction isTerminalTaskStatus(status: TaskStatus): boolean {\n  return TERMINAL_TASK_STATUSES.has(status);\n}\n\nexport interface TaskRecord<TResult = unknown, TError extends AdcpStructuredError = AdcpStructuredError> {\n  taskId: string;\n  /** Tool name that started the task (e.g., 'create_media_buy'). */\n  tool: string;\n  /** Account that started the task — sessionKey-like for cross-request scoping. */\n  accountId: string;\n  /** Tenant/principal owner scope used with accountId for list/read isolation. */\n  ownerScope?: string;\n  /** Current lifecycle state — full AdCP-spec `task-status` enum. */\n  status: TaskStatus;\n  /** Status message on the final arm (`error.message` on failed). */\n  statusMessage?: string;\n  /** Canonical terminal artifact on `completed`, `failed`, or `rejected`. */\n  result?: TResult;\n  /** Terminal error on `failed`. */\n  error?: TError;\n  /**\n   * Intermediate progress from `TaskHandoffContext.update(...)` calls.\n   * Written by the background handoff function; surfaced to buyers polling\n   * `tasks_get` via the spec `progress` field.\n   */\n  progress?: TaskHandoffProgress;\n  /**\n   * Whether the buyer wired `push_notification_config.url` on the original\n   * request. Surfaced to the buyer via `tasks_get`'s spec-defined\n   * `has_webhook: boolean` field so they can decide between long-poll vs.\n   * single-shot polling.\n   */\n  hasWebhook?: boolean;\n  /** ISO 8601 timestamps. */\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface TaskRegistryListOptions {\n  accountId: string;\n  /** Caller ownership scope derived from authenticated server context. */\n  ownerScope: string;\n}\n\n/** Account/principal boundary required for buyer-visible task access. */\nexport interface TaskRegistryScope {\n  accountId: string;\n  ownerScope: string;\n}\n\n/** Defense-in-depth boundary check for custom registry results. */\nexport function taskRecordMatchesScope(record: TaskRecord, scope: TaskRegistryScope): boolean {\n  if (record.accountId !== scope.accountId) return false;\n  return (\n    record.ownerScope === scope.ownerScope ||\n    (record.ownerScope === undefined && scope.ownerScope === `account:${scope.accountId}`)\n  );\n}\n\nfunction taskStorageKey(taskId: string, scope: TaskRegistryScope): string {\n  return JSON.stringify([scope.accountId, scope.ownerScope, taskId]);\n}\n\nexport interface TaskRegistryListResult<TResult = unknown> {\n  tasks: TaskRecord<TResult>[];\n}\n\n// All read/write methods are async to accommodate storage-backed\n// implementations (`createPostgresTaskRegistry`). The in-memory impl\n// resolves immediately. The framework `await`s every call, so the\n// in-memory case pays one microtask per dispatch — negligible.\nexport interface TaskRegistry {\n  /** Confirms that lifecycle methods use the account/principal-scoped v1 signatures. */\n  readonly scopeVersion: 1;\n\n  /**\n   * Allocate a new task record. Returns the `taskId` the framework hands\n   * to `platform.xxxTask(taskId, ...)`. Initial status is `submitted`.\n   *\n   * `hasWebhook: true` when the buyer wired `push_notification_config.url`\n   * — surfaced via `tasks_get`'s `has_webhook` field. Defaults to `false`.\n   *\n   * `overrideTaskId` — when set, the registry uses this exact string as the\n   * task id instead of minting a fresh one. Throws if the id is already\n   * registered in the same account/principal scope (uniqueness within that\n   * scope is the caller's responsibility).\n   */\n  create(opts: {\n    tool: string;\n    accountId: string;\n    ownerScope?: string;\n    hasWebhook?: boolean;\n    overrideTaskId?: string;\n  }): Promise<{ taskId: string }>;\n\n  /** Read a task within its account/principal boundary. */\n  getTask<TResult = unknown>(taskId: string, scope: TaskRegistryScope): Promise<TaskRecord<TResult> | null>;\n\n  /** Administrative/test access; returns null when an id is ambiguous across scopes. Never expose to buyer traffic. */\n  _getTaskUnsafe<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null>;\n\n  /**\n   * List tasks owned by a resolved account. Buyer-facing AdCP task\n   * reconciliation must use this scoped surface, never the transport-level\n   * MCP TaskStore, because MCP task records do not carry AdCP ownership,\n   * protocol, or tool metadata.\n   *\n   * Multi-tenant deployments that share an AdCP account across principals\n   * must persist and filter by `ownerScope`. Rows without `ownerScope` are\n   * treated as legacy account-scoped rows: built-in registries return them\n   * only for the account-fallback owner scope (`account:${accountId}`), not\n   * for credential-, agent-, or session-scoped callers.\n   */\n  list?(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult>;\n\n  /**\n   * Mark a task `completed` with the method's return value. No-op if the\n   * task is already terminal (idempotent).\n   */\n  complete<TResult>(taskId: string, scope: TaskRegistryScope, result: TResult): Promise<void>;\n\n  /**\n   * Mark a task `failed` with the structured error and, when available, the\n   * canonical terminal artifact. No-op if the task is already terminal.\n   */\n  fail(taskId: string, scope: TaskRegistryScope, error: AdcpStructuredError, result?: unknown): Promise<void>;\n\n  /**\n   * Record intermediate progress from `TaskHandoffContext.update(...)`.\n   * Transitions the task from `'submitted'` → `'working'` on the first\n   * call. No-op on already-terminal tasks. The `progress` payload is\n   * written to the record and surfaced to buyers polling `tasks_get`.\n   */\n  updateProgress(taskId: string, scope: TaskRegistryScope, progress: TaskHandoffProgress): Promise<void>;\n\n  /**\n   * Register the background completion promise the framework spawned for\n   * the `*Task` invocation. Tests await this for deterministic settlement;\n   * production callers don't need it.\n   */\n  _registerBackground(taskId: string, scope: TaskRegistryScope, completion: Promise<void>): void;\n\n  /**\n   * Await any registered background completion for a task. Resolves\n   * immediately if no background is registered or it has already settled.\n   * Used by test harnesses + `tasks/get` integration.\n   */\n  awaitTask(taskId: string, scope: TaskRegistryScope): Promise<void>;\n\n  /** Administrative/test wait across every scope sharing this public task id. Never expose to buyer traffic. */\n  _awaitTaskUnsafe(taskId: string): Promise<void>;\n\n  /**\n   * Optional test-harness flush. In-memory registries expose this so\n   * `AdcpServer.compliance.reset()` can clear hardcoded overrideTaskId\n   * records between repeated storyboard runs. Persistent registries should\n   * omit it unless they can safely flush their configured backend.\n   */\n  clear?(): void | Promise<void>;\n}\n\nexport function createInMemoryTaskRegistry(): TaskRegistry {\n  const tasks = new Map<string, TaskRecord<unknown>>();\n  const backgrounds = new Map<string, Promise<void>>();\n\n  return {\n    scopeVersion: 1,\n    async create(opts: {\n      tool: string;\n      accountId: string;\n      ownerScope?: string;\n      hasWebhook?: boolean;\n      overrideTaskId?: string;\n    }): Promise<{ taskId: string }> {\n      const taskId = opts.overrideTaskId ?? `task_${randomUUID()}`;\n      const scope = { accountId: opts.accountId, ownerScope: opts.ownerScope ?? `account:${opts.accountId}` };\n      const storageKey = taskStorageKey(taskId, scope);\n      if (tasks.has(storageKey)) {\n        throw new Error(`task_id already registered: ${taskId}`);\n      }\n      const now = new Date().toISOString();\n      tasks.set(storageKey, {\n        taskId,\n        tool: opts.tool,\n        accountId: opts.accountId,\n        ownerScope: opts.ownerScope ?? `account:${opts.accountId}`,\n        status: 'submitted',\n        ...(opts.hasWebhook && { hasWebhook: true }),\n        createdAt: now,\n        updatedAt: now,\n      });\n      return { taskId };\n    },\n\n    async getTask<TResult = unknown>(taskId: string, scope: TaskRegistryScope): Promise<TaskRecord<TResult> | null> {\n      const record = tasks.get(taskStorageKey(taskId, scope));\n      return (record as TaskRecord<TResult> | undefined) ?? null;\n    },\n\n    async _getTaskUnsafe<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null> {\n      const matches = Array.from(tasks.values()).filter(record => record.taskId === taskId);\n      return matches.length === 1 ? (matches[0] as TaskRecord<TResult>) : null;\n    },\n\n    async list(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult> {\n      return {\n        tasks: Array.from(tasks.values()).filter(\n          record => record.accountId === opts.accountId && record.ownerScope === opts.ownerScope\n        ),\n      };\n    },\n\n    async complete<TResult>(taskId: string, scope: TaskRegistryScope, result: TResult): Promise<void> {\n      const existing = tasks.get(taskStorageKey(taskId, scope));\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'completed';\n      existing.result = result;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async fail(taskId: string, scope: TaskRegistryScope, error: AdcpStructuredError, result?: unknown): Promise<void> {\n      const existing = tasks.get(taskStorageKey(taskId, scope));\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'failed';\n      existing.error = error;\n      if (result !== undefined) existing.result = result;\n      existing.statusMessage = error.message;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async updateProgress(taskId: string, scope: TaskRegistryScope, progress: TaskHandoffProgress): Promise<void> {\n      const existing = tasks.get(taskStorageKey(taskId, scope));\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      if (existing.status === 'submitted') existing.status = 'working';\n      existing.progress = progress;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    _registerBackground(taskId: string, scope: TaskRegistryScope, completion: Promise<void>): void {\n      const storageKey = taskStorageKey(taskId, scope);\n      const composed: Promise<void> = completion.then(\n        () => {\n          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);\n        },\n        () => {\n          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);\n        }\n      );\n      backgrounds.set(storageKey, composed);\n    },\n\n    async awaitTask(taskId: string, scope: TaskRegistryScope): Promise<void> {\n      const pending = backgrounds.get(taskStorageKey(taskId, scope));\n      if (pending) await pending;\n    },\n\n    async _awaitTaskUnsafe(taskId: string): Promise<void> {\n      const pending = Array.from(backgrounds.entries())\n        .filter(([key]) => (JSON.parse(key) as [string, string, string])[2] === taskId)\n        .map(([, completion]) => completion);\n      await Promise.all(pending);\n    },\n\n    clear(): void {\n      tasks.clear();\n      backgrounds.clear();\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/runtime/task-registry.mjs

@@ -3,17 +3,27 @@ const TERMINAL_TASK_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "
 function isTerminalTaskStatus(status) {
   return TERMINAL_TASK_STATUSES.has(status);
 }
+function taskRecordMatchesScope(record, scope) {
+  if (record.accountId !== scope.accountId) return false;
+  return record.ownerScope === scope.ownerScope || record.ownerScope === void 0 && scope.ownerScope === `account:${scope.accountId}`;
+}
+function taskStorageKey(taskId, scope) {
+  return JSON.stringify([scope.accountId, scope.ownerScope, taskId]);
+}
 function createInMemoryTaskRegistry() {
   const tasks = /* @__PURE__ */ new Map();
   const backgrounds = /* @__PURE__ */ new Map();
   return {
+    scopeVersion: 1,
     async create(opts) {
       const taskId = opts.overrideTaskId ?? `task_${randomUUID()}`;
-      if (tasks.has(taskId)) {
+      const scope = { accountId: opts.accountId, ownerScope: opts.ownerScope ?? `account:${opts.accountId}` };
+      const storageKey = taskStorageKey(taskId, scope);
+      if (tasks.has(storageKey)) {
         throw new Error(`task_id already registered: ${taskId}`);
       }
       const now = (/* @__PURE__ */ new Date()).toISOString();
-      tasks.set(taskId, {
+      tasks.set(storageKey, {
         taskId,
         tool: opts.tool,
         accountId: opts.accountId,
@@ -25,28 +35,31 @@ function createInMemoryTaskRegistry() {
       });
       return { taskId };
     },
-    async getTask(taskId) {
-      const record = tasks.get(taskId);
+    async getTask(taskId, scope) {
+      const record = tasks.get(taskStorageKey(taskId, scope));
       return record ?? null;
     },
+    async _getTaskUnsafe(taskId) {
+      const matches = Array.from(tasks.values()).filter((record) => record.taskId === taskId);
+      return matches.length === 1 ? matches[0] : null;
+    },
     async list(opts) {
-      if (opts.ownerScope === void 0) return { tasks: [] };
       return {
         tasks: Array.from(tasks.values()).filter(
-          (record) => record.accountId === opts.accountId && (record.ownerScope === opts.ownerScope || record.ownerScope === void 0 && opts.ownerScope === `account:${opts.accountId}`)
+          (record) => record.accountId === opts.accountId && record.ownerScope === opts.ownerScope
         )
       };
     },
-    async complete(taskId, result) {
-      const existing = tasks.get(taskId);
+    async complete(taskId, scope, result) {
+      const existing = tasks.get(taskStorageKey(taskId, scope));
       if (!existing) return;
       if (isTerminalTaskStatus(existing.status)) return;
       existing.status = "completed";
       existing.result = result;
       existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     },
-    async fail(taskId, error, result) {
-      const existing = tasks.get(taskId);
+    async fail(taskId, scope, error, result) {
+      const existing = tasks.get(taskStorageKey(taskId, scope));
       if (!existing) return;
       if (isTerminalTaskStatus(existing.status)) return;
       existing.status = "failed";
@@ -55,29 +68,34 @@ function createInMemoryTaskRegistry() {
       existing.statusMessage = error.message;
       existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     },
-    async updateProgress(taskId, progress) {
-      const existing = tasks.get(taskId);
+    async updateProgress(taskId, scope, progress) {
+      const existing = tasks.get(taskStorageKey(taskId, scope));
       if (!existing) return;
       if (isTerminalTaskStatus(existing.status)) return;
       if (existing.status === "submitted") existing.status = "working";
       existing.progress = progress;
       existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
     },
-    _registerBackground(taskId, completion) {
+    _registerBackground(taskId, scope, completion) {
+      const storageKey = taskStorageKey(taskId, scope);
       const composed = completion.then(
         () => {
-          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);
+          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);
         },
         () => {
-          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);
+          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);
         }
       );
-      backgrounds.set(taskId, composed);
+      backgrounds.set(storageKey, composed);
     },
-    async awaitTask(taskId) {
-      const pending = backgrounds.get(taskId);
+    async awaitTask(taskId, scope) {
+      const pending = backgrounds.get(taskStorageKey(taskId, scope));
       if (pending) await pending;
     },
+    async _awaitTaskUnsafe(taskId) {
+      const pending = Array.from(backgrounds.entries()).filter(([key]) => JSON.parse(key)[2] === taskId).map(([, completion]) => completion);
+      await Promise.all(pending);
+    },
     clear() {
       tasks.clear();
       backgrounds.clear();
@@ -85,6 +103,7 @@ function createInMemoryTaskRegistry() {
   };
 }
 export {
-  createInMemoryTaskRegistry
+  createInMemoryTaskRegistry,
+  taskRecordMatchesScope
 };
 //# sourceMappingURL=task-registry.mjs.map

package/dist/lib/server/decisioning/runtime/task-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/task-registry.ts"],"sourcesContent":["/**\n * In-memory task registry for the v6.0 alpha runtime.\n *\n * The framework owns task lifecycle. When an adopter method returns a\n * `TaskHandoff` marker, the framework:\n *   1. Allocates a `taskId` and writes a `submitted` record.\n *   2. Returns the submitted envelope to the buyer immediately.\n *   3. Runs the handoff function in the background.\n *   4. Updates the record on progress (`updateProgress`) and terminal\n *      state (`complete` / `fail`) from the method's return/throw.\n *\n * Adopters never call into the registry directly. Wire-level `tasks/get`\n * integration (so buyers can poll the lifecycle) reads via `getTask`;\n * test harnesses use `awaitTask` to flush the background promise\n * deterministically.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { AdcpStructuredError, TaskHandoffProgress } from '../async-outcome';\n\n/**\n * AdCP-spec task lifecycle states. Mirrors `enums/task-status.json` —\n * the v6 framework writes `'submitted'` on create, transitions to\n * `'working'` on the first `updateProgress()` call, and terminates at\n * `'completed'` / `'failed'`. The other states (`'input-required'`,\n * `'canceled'`, `'rejected'`, `'auth-required'`, `'unknown'`) are\n * reserved for adopter-emitted transitions via the forthcoming\n * `taskRegistry.transition()` API (v6.1).\n */\nexport type TaskStatus =\n  | 'submitted'\n  | 'working'\n  | 'input-required'\n  | 'completed'\n  | 'canceled'\n  | 'failed'\n  | 'rejected'\n  | 'auth-required'\n  | 'unknown';\n\nconst TERMINAL_TASK_STATUSES: ReadonlySet<TaskStatus> = new Set(['completed', 'failed', 'rejected', 'canceled']);\n\nfunction isTerminalTaskStatus(status: TaskStatus): boolean {\n  return TERMINAL_TASK_STATUSES.has(status);\n}\n\nexport interface TaskRecord<TResult = unknown, TError extends AdcpStructuredError = AdcpStructuredError> {\n  taskId: string;\n  /** Tool name that started the task (e.g., 'create_media_buy'). */\n  tool: string;\n  /** Account that started the task — sessionKey-like for cross-request scoping. */\n  accountId: string;\n  /** Tenant/principal owner scope used with accountId for list/read isolation. */\n  ownerScope?: string;\n  /** Current lifecycle state — full AdCP-spec `task-status` enum. */\n  status: TaskStatus;\n  /** Status message on the final arm (`error.message` on failed). */\n  statusMessage?: string;\n  /** Canonical terminal artifact on `completed`, `failed`, or `rejected`. */\n  result?: TResult;\n  /** Terminal error on `failed`. */\n  error?: TError;\n  /**\n   * Intermediate progress from `TaskHandoffContext.update(...)` calls.\n   * Written by the background handoff function; surfaced to buyers polling\n   * `tasks_get` via the spec `progress` field.\n   */\n  progress?: TaskHandoffProgress;\n  /**\n   * Whether the buyer wired `push_notification_config.url` on the original\n   * request. Surfaced to the buyer via `tasks_get`'s spec-defined\n   * `has_webhook: boolean` field so they can decide between long-poll vs.\n   * single-shot polling.\n   */\n  hasWebhook?: boolean;\n  /** ISO 8601 timestamps. */\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface TaskRegistryListOptions {\n  accountId: string;\n  /**\n   * Caller ownership scope derived from buyer agent, credential, session,\n   * or the single-principal account fallback. Optional for source\n   * compatibility with older custom registries, but buyer-visible protocol\n   * task tools pass it whenever they can identify a caller and built-in\n   * registries fail closed when it is absent.\n   */\n  ownerScope?: string;\n}\n\nexport interface TaskRegistryListResult<TResult = unknown> {\n  tasks: TaskRecord<TResult>[];\n}\n\n// All read/write methods are async to accommodate storage-backed\n// implementations (`createPostgresTaskRegistry`). The in-memory impl\n// resolves immediately. The framework `await`s every call, so the\n// in-memory case pays one microtask per dispatch — negligible.\nexport interface TaskRegistry {\n  /**\n   * Allocate a new task record. Returns the `taskId` the framework hands\n   * to `platform.xxxTask(taskId, ...)`. Initial status is `submitted`.\n   *\n   * `hasWebhook: true` when the buyer wired `push_notification_config.url`\n   * — surfaced via `tasks_get`'s `has_webhook` field. Defaults to `false`.\n   *\n   * `overrideTaskId` — when set, the registry uses this exact string as the\n   * task id instead of minting a fresh one. Throws if the id is already\n   * registered (uniqueness is the caller's responsibility).\n   */\n  create(opts: {\n    tool: string;\n    accountId: string;\n    ownerScope?: string;\n    hasWebhook?: boolean;\n    overrideTaskId?: string;\n  }): Promise<{ taskId: string }>;\n\n  /** Read a task by id. Returns `null` if unknown. */\n  getTask<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null>;\n\n  /**\n   * List tasks owned by a resolved account. Buyer-facing AdCP task\n   * reconciliation must use this scoped surface, never the transport-level\n   * MCP TaskStore, because MCP task records do not carry AdCP ownership,\n   * protocol, or tool metadata.\n   *\n   * Multi-tenant deployments that share an AdCP account across principals\n   * must persist and filter by `ownerScope`. Rows without `ownerScope` are\n   * treated as legacy account-scoped rows: built-in registries return them\n   * only for the account-fallback owner scope (`account:${accountId}`), not\n   * for credential-, agent-, or session-scoped callers.\n   */\n  list?(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult>;\n\n  /**\n   * Mark a task `completed` with the method's return value. No-op if the\n   * task is already terminal (idempotent).\n   */\n  complete<TResult>(taskId: string, result: TResult): Promise<void>;\n\n  /**\n   * Mark a task `failed` with the structured error and, when available, the\n   * canonical terminal artifact. No-op if the task is already terminal.\n   */\n  fail(taskId: string, error: AdcpStructuredError, result?: unknown): Promise<void>;\n\n  /**\n   * Record intermediate progress from `TaskHandoffContext.update(...)`.\n   * Transitions the task from `'submitted'` → `'working'` on the first\n   * call. No-op on already-terminal tasks. The `progress` payload is\n   * written to the record and surfaced to buyers polling `tasks_get`.\n   */\n  updateProgress(taskId: string, progress: TaskHandoffProgress): Promise<void>;\n\n  /**\n   * Register the background completion promise the framework spawned for\n   * the `*Task` invocation. Tests await this for deterministic settlement;\n   * production callers don't need it.\n   *\n   * @internal\n   */\n  _registerBackground(taskId: string, completion: Promise<void>): void;\n\n  /**\n   * Await any registered background completion for a task. Resolves\n   * immediately if no background is registered or it has already settled.\n   * Used by test harnesses + `tasks/get` integration.\n   */\n  awaitTask(taskId: string): Promise<void>;\n\n  /**\n   * Optional test-harness flush. In-memory registries expose this so\n   * `AdcpServer.compliance.reset()` can clear hardcoded overrideTaskId\n   * records between repeated storyboard runs. Persistent registries should\n   * omit it unless they can safely flush their configured backend.\n   */\n  clear?(): void | Promise<void>;\n}\n\nexport function createInMemoryTaskRegistry(): TaskRegistry {\n  const tasks = new Map<string, TaskRecord<unknown>>();\n  const backgrounds = new Map<string, Promise<void>>();\n\n  return {\n    async create(opts: {\n      tool: string;\n      accountId: string;\n      ownerScope?: string;\n      hasWebhook?: boolean;\n      overrideTaskId?: string;\n    }): Promise<{ taskId: string }> {\n      const taskId = opts.overrideTaskId ?? `task_${randomUUID()}`;\n      if (tasks.has(taskId)) {\n        throw new Error(`task_id already registered: ${taskId}`);\n      }\n      const now = new Date().toISOString();\n      tasks.set(taskId, {\n        taskId,\n        tool: opts.tool,\n        accountId: opts.accountId,\n        ownerScope: opts.ownerScope ?? `account:${opts.accountId}`,\n        status: 'submitted',\n        ...(opts.hasWebhook && { hasWebhook: true }),\n        createdAt: now,\n        updatedAt: now,\n      });\n      return { taskId };\n    },\n\n    async getTask<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null> {\n      const record = tasks.get(taskId);\n      return (record as TaskRecord<TResult> | undefined) ?? null;\n    },\n\n    async list(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult> {\n      if (opts.ownerScope === undefined) return { tasks: [] };\n      return {\n        tasks: Array.from(tasks.values()).filter(\n          record =>\n            record.accountId === opts.accountId &&\n            (record.ownerScope === opts.ownerScope ||\n              (record.ownerScope === undefined && opts.ownerScope === `account:${opts.accountId}`))\n        ),\n      };\n    },\n\n    async complete<TResult>(taskId: string, result: TResult): Promise<void> {\n      const existing = tasks.get(taskId);\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'completed';\n      existing.result = result;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async fail(taskId: string, error: AdcpStructuredError, result?: unknown): Promise<void> {\n      const existing = tasks.get(taskId);\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'failed';\n      existing.error = error;\n      if (result !== undefined) existing.result = result;\n      existing.statusMessage = error.message;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async updateProgress(taskId: string, progress: TaskHandoffProgress): Promise<void> {\n      const existing = tasks.get(taskId);\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      if (existing.status === 'submitted') existing.status = 'working';\n      existing.progress = progress;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    _registerBackground(taskId: string, completion: Promise<void>): void {\n      const composed: Promise<void> = completion.then(\n        () => {\n          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);\n        },\n        () => {\n          if (backgrounds.get(taskId) === composed) backgrounds.delete(taskId);\n        }\n      );\n      backgrounds.set(taskId, composed);\n    },\n\n    async awaitTask(taskId: string): Promise<void> {\n      const pending = backgrounds.get(taskId);\n      if (pending) await pending;\n    },\n\n    clear(): void {\n      tasks.clear();\n      backgrounds.clear();\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/task-registry.ts"],"sourcesContent":["/**\n * In-memory task registry for the v6.0 alpha runtime.\n *\n * The framework owns task lifecycle. When an adopter method returns a\n * `TaskHandoff` marker, the framework:\n *   1. Allocates a `taskId` and writes a `submitted` record.\n *   2. Returns the submitted envelope to the buyer immediately.\n *   3. Runs the handoff function in the background.\n *   4. Updates the record on progress (`updateProgress`) and terminal\n *      state (`complete` / `fail`) from the method's return/throw.\n *\n * Adopters never call into the registry directly. Wire-level `tasks/get`\n * integration (so buyers can poll the lifecycle) reads via scoped `getTask`;\n * test harnesses use `awaitTask` to flush the background promise\n * deterministically.\n *\n * Status: Preview / 6.0.\n *\n * @public\n */\n\nimport { randomUUID } from 'node:crypto';\nimport type { AdcpStructuredError, TaskHandoffProgress } from '../async-outcome';\n\n/**\n * AdCP-spec task lifecycle states. Mirrors `enums/task-status.json` —\n * the v6 framework writes `'submitted'` on create, transitions to\n * `'working'` on the first `updateProgress()` call, and terminates at\n * `'completed'` / `'failed'`. The other states (`'input-required'`,\n * `'canceled'`, `'rejected'`, `'auth-required'`, `'unknown'`) are\n * reserved for adopter-emitted transitions via the forthcoming\n * `taskRegistry.transition()` API (v6.1).\n */\nexport type TaskStatus =\n  | 'submitted'\n  | 'working'\n  | 'input-required'\n  | 'completed'\n  | 'canceled'\n  | 'failed'\n  | 'rejected'\n  | 'auth-required'\n  | 'unknown';\n\nconst TERMINAL_TASK_STATUSES: ReadonlySet<TaskStatus> = new Set(['completed', 'failed', 'rejected', 'canceled']);\n\nfunction isTerminalTaskStatus(status: TaskStatus): boolean {\n  return TERMINAL_TASK_STATUSES.has(status);\n}\n\nexport interface TaskRecord<TResult = unknown, TError extends AdcpStructuredError = AdcpStructuredError> {\n  taskId: string;\n  /** Tool name that started the task (e.g., 'create_media_buy'). */\n  tool: string;\n  /** Account that started the task — sessionKey-like for cross-request scoping. */\n  accountId: string;\n  /** Tenant/principal owner scope used with accountId for list/read isolation. */\n  ownerScope?: string;\n  /** Current lifecycle state — full AdCP-spec `task-status` enum. */\n  status: TaskStatus;\n  /** Status message on the final arm (`error.message` on failed). */\n  statusMessage?: string;\n  /** Canonical terminal artifact on `completed`, `failed`, or `rejected`. */\n  result?: TResult;\n  /** Terminal error on `failed`. */\n  error?: TError;\n  /**\n   * Intermediate progress from `TaskHandoffContext.update(...)` calls.\n   * Written by the background handoff function; surfaced to buyers polling\n   * `tasks_get` via the spec `progress` field.\n   */\n  progress?: TaskHandoffProgress;\n  /**\n   * Whether the buyer wired `push_notification_config.url` on the original\n   * request. Surfaced to the buyer via `tasks_get`'s spec-defined\n   * `has_webhook: boolean` field so they can decide between long-poll vs.\n   * single-shot polling.\n   */\n  hasWebhook?: boolean;\n  /** ISO 8601 timestamps. */\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface TaskRegistryListOptions {\n  accountId: string;\n  /** Caller ownership scope derived from authenticated server context. */\n  ownerScope: string;\n}\n\n/** Account/principal boundary required for buyer-visible task access. */\nexport interface TaskRegistryScope {\n  accountId: string;\n  ownerScope: string;\n}\n\n/** Defense-in-depth boundary check for custom registry results. */\nexport function taskRecordMatchesScope(record: TaskRecord, scope: TaskRegistryScope): boolean {\n  if (record.accountId !== scope.accountId) return false;\n  return (\n    record.ownerScope === scope.ownerScope ||\n    (record.ownerScope === undefined && scope.ownerScope === `account:${scope.accountId}`)\n  );\n}\n\nfunction taskStorageKey(taskId: string, scope: TaskRegistryScope): string {\n  return JSON.stringify([scope.accountId, scope.ownerScope, taskId]);\n}\n\nexport interface TaskRegistryListResult<TResult = unknown> {\n  tasks: TaskRecord<TResult>[];\n}\n\n// All read/write methods are async to accommodate storage-backed\n// implementations (`createPostgresTaskRegistry`). The in-memory impl\n// resolves immediately. The framework `await`s every call, so the\n// in-memory case pays one microtask per dispatch — negligible.\nexport interface TaskRegistry {\n  /** Confirms that lifecycle methods use the account/principal-scoped v1 signatures. */\n  readonly scopeVersion: 1;\n\n  /**\n   * Allocate a new task record. Returns the `taskId` the framework hands\n   * to `platform.xxxTask(taskId, ...)`. Initial status is `submitted`.\n   *\n   * `hasWebhook: true` when the buyer wired `push_notification_config.url`\n   * — surfaced via `tasks_get`'s `has_webhook` field. Defaults to `false`.\n   *\n   * `overrideTaskId` — when set, the registry uses this exact string as the\n   * task id instead of minting a fresh one. Throws if the id is already\n   * registered in the same account/principal scope (uniqueness within that\n   * scope is the caller's responsibility).\n   */\n  create(opts: {\n    tool: string;\n    accountId: string;\n    ownerScope?: string;\n    hasWebhook?: boolean;\n    overrideTaskId?: string;\n  }): Promise<{ taskId: string }>;\n\n  /** Read a task within its account/principal boundary. */\n  getTask<TResult = unknown>(taskId: string, scope: TaskRegistryScope): Promise<TaskRecord<TResult> | null>;\n\n  /** Administrative/test access; returns null when an id is ambiguous across scopes. Never expose to buyer traffic. */\n  _getTaskUnsafe<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null>;\n\n  /**\n   * List tasks owned by a resolved account. Buyer-facing AdCP task\n   * reconciliation must use this scoped surface, never the transport-level\n   * MCP TaskStore, because MCP task records do not carry AdCP ownership,\n   * protocol, or tool metadata.\n   *\n   * Multi-tenant deployments that share an AdCP account across principals\n   * must persist and filter by `ownerScope`. Rows without `ownerScope` are\n   * treated as legacy account-scoped rows: built-in registries return them\n   * only for the account-fallback owner scope (`account:${accountId}`), not\n   * for credential-, agent-, or session-scoped callers.\n   */\n  list?(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult>;\n\n  /**\n   * Mark a task `completed` with the method's return value. No-op if the\n   * task is already terminal (idempotent).\n   */\n  complete<TResult>(taskId: string, scope: TaskRegistryScope, result: TResult): Promise<void>;\n\n  /**\n   * Mark a task `failed` with the structured error and, when available, the\n   * canonical terminal artifact. No-op if the task is already terminal.\n   */\n  fail(taskId: string, scope: TaskRegistryScope, error: AdcpStructuredError, result?: unknown): Promise<void>;\n\n  /**\n   * Record intermediate progress from `TaskHandoffContext.update(...)`.\n   * Transitions the task from `'submitted'` → `'working'` on the first\n   * call. No-op on already-terminal tasks. The `progress` payload is\n   * written to the record and surfaced to buyers polling `tasks_get`.\n   */\n  updateProgress(taskId: string, scope: TaskRegistryScope, progress: TaskHandoffProgress): Promise<void>;\n\n  /**\n   * Register the background completion promise the framework spawned for\n   * the `*Task` invocation. Tests await this for deterministic settlement;\n   * production callers don't need it.\n   */\n  _registerBackground(taskId: string, scope: TaskRegistryScope, completion: Promise<void>): void;\n\n  /**\n   * Await any registered background completion for a task. Resolves\n   * immediately if no background is registered or it has already settled.\n   * Used by test harnesses + `tasks/get` integration.\n   */\n  awaitTask(taskId: string, scope: TaskRegistryScope): Promise<void>;\n\n  /** Administrative/test wait across every scope sharing this public task id. Never expose to buyer traffic. */\n  _awaitTaskUnsafe(taskId: string): Promise<void>;\n\n  /**\n   * Optional test-harness flush. In-memory registries expose this so\n   * `AdcpServer.compliance.reset()` can clear hardcoded overrideTaskId\n   * records between repeated storyboard runs. Persistent registries should\n   * omit it unless they can safely flush their configured backend.\n   */\n  clear?(): void | Promise<void>;\n}\n\nexport function createInMemoryTaskRegistry(): TaskRegistry {\n  const tasks = new Map<string, TaskRecord<unknown>>();\n  const backgrounds = new Map<string, Promise<void>>();\n\n  return {\n    scopeVersion: 1,\n    async create(opts: {\n      tool: string;\n      accountId: string;\n      ownerScope?: string;\n      hasWebhook?: boolean;\n      overrideTaskId?: string;\n    }): Promise<{ taskId: string }> {\n      const taskId = opts.overrideTaskId ?? `task_${randomUUID()}`;\n      const scope = { accountId: opts.accountId, ownerScope: opts.ownerScope ?? `account:${opts.accountId}` };\n      const storageKey = taskStorageKey(taskId, scope);\n      if (tasks.has(storageKey)) {\n        throw new Error(`task_id already registered: ${taskId}`);\n      }\n      const now = new Date().toISOString();\n      tasks.set(storageKey, {\n        taskId,\n        tool: opts.tool,\n        accountId: opts.accountId,\n        ownerScope: opts.ownerScope ?? `account:${opts.accountId}`,\n        status: 'submitted',\n        ...(opts.hasWebhook && { hasWebhook: true }),\n        createdAt: now,\n        updatedAt: now,\n      });\n      return { taskId };\n    },\n\n    async getTask<TResult = unknown>(taskId: string, scope: TaskRegistryScope): Promise<TaskRecord<TResult> | null> {\n      const record = tasks.get(taskStorageKey(taskId, scope));\n      return (record as TaskRecord<TResult> | undefined) ?? null;\n    },\n\n    async _getTaskUnsafe<TResult = unknown>(taskId: string): Promise<TaskRecord<TResult> | null> {\n      const matches = Array.from(tasks.values()).filter(record => record.taskId === taskId);\n      return matches.length === 1 ? (matches[0] as TaskRecord<TResult>) : null;\n    },\n\n    async list(opts: TaskRegistryListOptions): Promise<TaskRegistryListResult> {\n      return {\n        tasks: Array.from(tasks.values()).filter(\n          record => record.accountId === opts.accountId && record.ownerScope === opts.ownerScope\n        ),\n      };\n    },\n\n    async complete<TResult>(taskId: string, scope: TaskRegistryScope, result: TResult): Promise<void> {\n      const existing = tasks.get(taskStorageKey(taskId, scope));\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'completed';\n      existing.result = result;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async fail(taskId: string, scope: TaskRegistryScope, error: AdcpStructuredError, result?: unknown): Promise<void> {\n      const existing = tasks.get(taskStorageKey(taskId, scope));\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      existing.status = 'failed';\n      existing.error = error;\n      if (result !== undefined) existing.result = result;\n      existing.statusMessage = error.message;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    async updateProgress(taskId: string, scope: TaskRegistryScope, progress: TaskHandoffProgress): Promise<void> {\n      const existing = tasks.get(taskStorageKey(taskId, scope));\n      if (!existing) return;\n      if (isTerminalTaskStatus(existing.status)) return;\n      if (existing.status === 'submitted') existing.status = 'working';\n      existing.progress = progress;\n      existing.updatedAt = new Date().toISOString();\n    },\n\n    _registerBackground(taskId: string, scope: TaskRegistryScope, completion: Promise<void>): void {\n      const storageKey = taskStorageKey(taskId, scope);\n      const composed: Promise<void> = completion.then(\n        () => {\n          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);\n        },\n        () => {\n          if (backgrounds.get(storageKey) === composed) backgrounds.delete(storageKey);\n        }\n      );\n      backgrounds.set(storageKey, composed);\n    },\n\n    async awaitTask(taskId: string, scope: TaskRegistryScope): Promise<void> {\n      const pending = backgrounds.get(taskStorageKey(taskId, scope));\n      if (pending) await pending;\n    },\n\n    async _awaitTaskUnsafe(taskId: string): Promise<void> {\n      const pending = Array.from(backgrounds.entries())\n        .filter(([key]) => (JSON.parse(key) as [string, string, string])[2] === taskId)\n        .map(([, completion]) => completion);\n      await Promise.all(pending);\n    },\n\n    clear(): void {\n      tasks.clear();\n      backgrounds.clear();\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/runtime/to-context.d.mts

@@ -28,7 +28,7 @@
  */
 import type { Account } from '../account.mjs';
 import type { RequestContext } from '../context.mjs';
-import type { TaskRegistry } from './task-registry.mjs';
+import type { TaskRegistry, TaskRegistryScope } from './task-registry.mjs';
 import { type TaskHandoffContext } from '../async-outcome.mjs';
 import type { CtxMetadataStore } from '../../ctx-metadata/index.mjs';
 export declare function buildRequestContext<TCtxMeta = Record<string, unknown>>(handlerCtx: HandlerContext<Account<TCtxMeta>>, ctxMetadataStore?: CtxMetadataStore, input?: Readonly<Record<string, unknown>>): RequestContext<Account<TCtxMeta>>;
@@ -50,4 +50,4 @@ export declare function buildRequestContext<TCtxMeta = Record<string, unknown>>(
  * `heartbeat()` remains a no-op stub (v6.1); it is a liveness / TTL-reset
  * signal for operator infrastructure, not buyer-facing.
  */
-export declare function buildHandoffContext(taskRegistry: TaskRegistry, taskId: string): TaskHandoffContext;
+export declare function buildHandoffContext(taskRegistry: TaskRegistry, taskId: string, scope: TaskRegistryScope): TaskHandoffContext;

package/dist/lib/server/decisioning/runtime/to-context.d.ts

@@ -28,7 +28,7 @@
  */
 import type { Account } from '../account';
 import type { RequestContext } from '../context';
-import type { TaskRegistry } from './task-registry';
+import type { TaskRegistry, TaskRegistryScope } from './task-registry';
 import { type TaskHandoffContext } from '../async-outcome';
 import type { CtxMetadataStore } from '../../ctx-metadata';
 export declare function buildRequestContext<TCtxMeta = Record<string, unknown>>(handlerCtx: HandlerContext<Account<TCtxMeta>>, ctxMetadataStore?: CtxMetadataStore, input?: Readonly<Record<string, unknown>>): RequestContext<Account<TCtxMeta>>;
@@ -50,5 +50,5 @@ export declare function buildRequestContext<TCtxMeta = Record<string, unknown>>(
  * `heartbeat()` remains a no-op stub (v6.1); it is a liveness / TTL-reset
  * signal for operator infrastructure, not buyer-facing.
  */
-export declare function buildHandoffContext(taskRegistry: TaskRegistry, taskId: string): TaskHandoffContext;
+export declare function buildHandoffContext(taskRegistry: TaskRegistry, taskId: string, scope: TaskRegistryScope): TaskHandoffContext;
 //# sourceMappingURL=to-context.d.ts.map

package/dist/lib/server/decisioning/runtime/to-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-context.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/runtime/to-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAgC,MAAM,oBAAoB,CAAC;AAgDzF,wBAAgB,mBAAmB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAC7C,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CA2EnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAgBlG"}
+{"version":3,"file":"to-context.d.ts","sourceRoot":"","sources":["../../../../../src/lib/server/decisioning/runtime/to-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAEL,KAAK,kBAAkB,EAGxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,gBAAgB,EAAgC,MAAM,oBAAoB,CAAC;AAgDzF,wBAAgB,mBAAmB,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpE,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAC7C,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CA2EnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,iBAAiB,GACvB,kBAAkB,CAgBpB"}

package/dist/lib/server/decisioning/runtime/to-context.js

@@ -103,12 +103,12 @@ function buildRequestContext(handlerCtx, ctxMetadataStore, input) {
     }
   };
 }
-function buildHandoffContext(taskRegistry, taskId) {
+function buildHandoffContext(taskRegistry, taskId, scope) {
   return {
     id: taskId,
     update: async (progress) => {
       try {
-        await taskRegistry.updateProgress(taskId, progress);
+        await taskRegistry.updateProgress(taskId, scope, progress);
       } catch {
       }
     },

package/dist/lib/server/decisioning/runtime/to-context.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/to-context.ts"],"sourcesContent":["/**\n * Translate the existing `HandlerContext` into the v6 `RequestContext` shape\n * that platform methods receive.\n *\n * The handler-style framework already resolves the account, sets sessionKey,\n * and exposes `store` + `authInfo` + `emitWebhook`. The new context layers\n * `state.*` (sync state reads), `resolve.*` (async framework-mediated\n * resolvers), and `handoffToTask(...)` (the unified hybrid-seller handoff\n * primitive) on top.\n *\n * **Stub status — v6.0 alpha.** `state.*` (workflow-step reads, proposal\n * lookups, governance JWS) and `resolve.*` (property/collection-list +\n * format fetchers) are NOT yet wired. The state readers return empty\n * results; the resolvers throw. Touching them in a platform method will\n * crash the request — the framework hasn't connected them to an underlying\n * store / fetch layer yet.\n *\n * Adopters spiking against the preview surface MUST avoid `ctx.state.*`\n * and `ctx.resolve.*` until the wire-up commits land in rc.1. Use\n * `ctx.account`, `ctx.handoffToTask(...)`, and the structured-error /\n * status-change primitives only.\n *\n * @internal — framework-internal wiring; not adopter surface. The\n * exported helpers (`buildRequestContext`, `buildHandoffContext`) are\n * called from the dispatch seam in `from-platform.ts`. Adopters should\n * never construct a `RequestContext` themselves; the framework supplies\n * one to every specialism method call.\n */\n\nimport type { HandlerContext } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext, CtxMetadataAccessor } from '../context';\nimport type { TaskRegistry } from './task-registry';\nimport {\n  _createTaskHandoff,\n  type TaskHandoffContext,\n  type TaskHandoff,\n  type TaskHandoffOptions,\n} from '../async-outcome';\nimport type { CtxMetadataStore, ResourceKind, CtxMetadataRef } from '../../ctx-metadata';\n\n/**\n * Build an account-scoped CtxMetadataAccessor for a single request.\n *\n * Account scope comes from `ctx.account.id` — accessor methods don't take\n * an account param. When `account.id` is null/undefined (no-account tools),\n * the accessor methods reject — no-account tools cannot use ctx_metadata\n * (cross-tenant collision risk via missing scope).\n */\nfunction buildCtxMetadataAccessor(store: CtxMetadataStore, accountId: string): CtxMetadataAccessor {\n  return {\n    get(kind: ResourceKind, id: string) {\n      return store.get(accountId, kind, id);\n    },\n    bulkGet(refs: readonly CtxMetadataRef[]) {\n      return store.bulkGet(accountId, refs);\n    },\n    set(kind: ResourceKind, id: string, value: unknown, ttlSeconds?: number) {\n      return store.set(accountId, kind, id, value, ttlSeconds);\n    },\n    delete(kind: ResourceKind, id: string) {\n      return store.delete(accountId, kind, id);\n    },\n    account(id: string) {\n      return store.get(accountId, 'account', id);\n    },\n    product(id: string) {\n      return store.get(accountId, 'product', id);\n    },\n    mediaBuy(id: string) {\n      return store.get(accountId, 'media_buy', id);\n    },\n    package(id: string) {\n      return store.get(accountId, 'package', id);\n    },\n    creative(id: string) {\n      return store.get(accountId, 'creative', id);\n    },\n    audience(id: string) {\n      return store.get(accountId, 'audience', id);\n    },\n    signal(id: string) {\n      return store.get(accountId, 'signal', id);\n    },\n  };\n}\n\nexport function buildRequestContext<TCtxMeta = Record<string, unknown>>(\n  handlerCtx: HandlerContext<Account<TCtxMeta>>,\n  ctxMetadataStore?: CtxMetadataStore,\n  input?: Readonly<Record<string, unknown>>\n): RequestContext<Account<TCtxMeta>> {\n  // `account` may legitimately be undefined for tools whose wire request\n  // doesn't carry an `account` field AND whose `resolveAccountFromAuth`\n  // returned null (`'explicit'`-mode adopters who don't model the\n  // no-account tools, or buyers calling without auth). Adopter handlers\n  // for those tools are responsible for either deriving the account\n  // themselves (e.g., via `media_buy_id` ownership) or throwing\n  // `AdcpError('ACCOUNT_NOT_FOUND')` if account is required.\n  //\n  // The `RequestContext.account` type is non-optional for ergonomic typing\n  // — adopters writing handlers for the 90% case (tools with `account` on\n  // the wire) shouldn't have to optional-chain everywhere. Adopters of\n  // no-account tools either:\n  //   1. Declare `resolution: 'derived'` and return a singleton from\n  //      `accounts.resolve(undefined)` — `ctx.account` is always set\n  //   2. Implement only `'explicit'` and never claim no-account\n  //      specialisms — the tool is unreachable\n  //   3. Read `ctx.account` defensively (`as Account | undefined` cast)\n  //      and look up by request body when missing\n  const account = handlerCtx.account as Account<TCtxMeta>;\n\n  const stubResolver = (name: string) => async (): Promise<never> => {\n    throw new Error(\n      `ctx.resolve.${name}: not yet wired in v6.0 alpha — landing in rc.1. ` +\n        `Avoid touching ctx.resolve.* in adopter code until the framework ` +\n        `connects this resolver to an underlying fetcher.`\n    );\n  };\n\n  // Bind ctx-metadata accessor when store wired AND account scope present.\n  // No-account tools (provide_performance_feedback, list_creative_formats)\n  // get `ctx.ctxMetadata = undefined` even when the store is wired — cannot\n  // use ctx_metadata without an account boundary (cross-tenant risk).\n  const ctxMetadata =\n    ctxMetadataStore != null && account != null && (account.id ?? '') !== ''\n      ? buildCtxMetadataAccessor(ctxMetadataStore, account.id)\n      : undefined;\n\n  return {\n    account,\n    ...(handlerCtx.agent != null && { agent: handlerCtx.agent }),\n    ...(handlerCtx.callerMutationScope != null && {\n      callerMutationScope: Object.freeze({ ...handlerCtx.callerMutationScope }),\n    }),\n    ...(handlerCtx.proposalRefinementScope != null && {\n      proposalRefinementScope: Object.freeze({ ...handlerCtx.proposalRefinementScope }),\n    }),\n    ...(input != null && { input }),\n    state: {\n      findByObject: () => [],\n      findProposalById: () => null,\n      governanceContext: () => null,\n      workflowSteps: () => [],\n    },\n    resolve: {\n      propertyList: stubResolver('propertyList'),\n      collectionList: stubResolver('collectionList'),\n      creativeFormat: stubResolver('creativeFormat'),\n    },\n    ctxMetadata,\n    handoffToTask<TResult>(\n      fn: (taskCtx: TaskHandoffContext) => Promise<TResult>,\n      options?: TaskHandoffOptions\n    ): TaskHandoff<TResult> {\n      if (options?.task_id !== undefined) {\n        if (typeof options.task_id !== 'string' || options.task_id.length === 0) {\n          throw new Error('handoffToTask options.task_id must be a non-empty string');\n        }\n        if (options.task_id.length > 128) {\n          throw new Error('handoffToTask options.task_id must be ≤ 128 characters');\n        }\n      }\n      return _createTaskHandoff(fn, options);\n    },\n  };\n}\n\n/**\n * Construct a `TaskHandoffContext` from a registry + framework-issued\n * task id. The framework calls this AFTER detecting a `TaskHandoff`\n * marker on a method's return — the handoff function gets a context\n * carrying the framework-allocated `taskId` plus `update`/`heartbeat`\n * affordances.\n *\n * `update(progress)` writes the progress payload to the task record and\n * transitions status `submitted` → `working`. Buyers polling `tasks_get`\n * see the `progress` object and the `'working'` status — this is the\n * buyer-facing UX signal that distinguishes \"stuck/no news\" from\n * \"step 2/3, awaiting trafficker.\" Errors from the registry write are\n * swallowed so a transient DB hiccup doesn't abort the adopter's handoff\n * function.\n *\n * `heartbeat()` remains a no-op stub (v6.1); it is a liveness / TTL-reset\n * signal for operator infrastructure, not buyer-facing.\n */\nexport function buildHandoffContext(taskRegistry: TaskRegistry, taskId: string): TaskHandoffContext {\n  return {\n    id: taskId,\n    update: async progress => {\n      try {\n        await taskRegistry.updateProgress(taskId, progress);\n      } catch {\n        // Swallow — a transient registry write failure must not abort the\n        // adopter's background handoff function. The buyer-facing impact is\n        // a missed progress event, not a failed task.\n      }\n    },\n    heartbeat: async () => {\n      await Promise.resolve();\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/to-context.ts"],"sourcesContent":["/**\n * Translate the existing `HandlerContext` into the v6 `RequestContext` shape\n * that platform methods receive.\n *\n * The handler-style framework already resolves the account, sets sessionKey,\n * and exposes `store` + `authInfo` + `emitWebhook`. The new context layers\n * `state.*` (sync state reads), `resolve.*` (async framework-mediated\n * resolvers), and `handoffToTask(...)` (the unified hybrid-seller handoff\n * primitive) on top.\n *\n * **Stub status — v6.0 alpha.** `state.*` (workflow-step reads, proposal\n * lookups, governance JWS) and `resolve.*` (property/collection-list +\n * format fetchers) are NOT yet wired. The state readers return empty\n * results; the resolvers throw. Touching them in a platform method will\n * crash the request — the framework hasn't connected them to an underlying\n * store / fetch layer yet.\n *\n * Adopters spiking against the preview surface MUST avoid `ctx.state.*`\n * and `ctx.resolve.*` until the wire-up commits land in rc.1. Use\n * `ctx.account`, `ctx.handoffToTask(...)`, and the structured-error /\n * status-change primitives only.\n *\n * @internal — framework-internal wiring; not adopter surface. The\n * exported helpers (`buildRequestContext`, `buildHandoffContext`) are\n * called from the dispatch seam in `from-platform.ts`. Adopters should\n * never construct a `RequestContext` themselves; the framework supplies\n * one to every specialism method call.\n */\n\nimport type { HandlerContext } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext, CtxMetadataAccessor } from '../context';\nimport type { TaskRegistry, TaskRegistryScope } from './task-registry';\nimport {\n  _createTaskHandoff,\n  type TaskHandoffContext,\n  type TaskHandoff,\n  type TaskHandoffOptions,\n} from '../async-outcome';\nimport type { CtxMetadataStore, ResourceKind, CtxMetadataRef } from '../../ctx-metadata';\n\n/**\n * Build an account-scoped CtxMetadataAccessor for a single request.\n *\n * Account scope comes from `ctx.account.id` — accessor methods don't take\n * an account param. When `account.id` is null/undefined (no-account tools),\n * the accessor methods reject — no-account tools cannot use ctx_metadata\n * (cross-tenant collision risk via missing scope).\n */\nfunction buildCtxMetadataAccessor(store: CtxMetadataStore, accountId: string): CtxMetadataAccessor {\n  return {\n    get(kind: ResourceKind, id: string) {\n      return store.get(accountId, kind, id);\n    },\n    bulkGet(refs: readonly CtxMetadataRef[]) {\n      return store.bulkGet(accountId, refs);\n    },\n    set(kind: ResourceKind, id: string, value: unknown, ttlSeconds?: number) {\n      return store.set(accountId, kind, id, value, ttlSeconds);\n    },\n    delete(kind: ResourceKind, id: string) {\n      return store.delete(accountId, kind, id);\n    },\n    account(id: string) {\n      return store.get(accountId, 'account', id);\n    },\n    product(id: string) {\n      return store.get(accountId, 'product', id);\n    },\n    mediaBuy(id: string) {\n      return store.get(accountId, 'media_buy', id);\n    },\n    package(id: string) {\n      return store.get(accountId, 'package', id);\n    },\n    creative(id: string) {\n      return store.get(accountId, 'creative', id);\n    },\n    audience(id: string) {\n      return store.get(accountId, 'audience', id);\n    },\n    signal(id: string) {\n      return store.get(accountId, 'signal', id);\n    },\n  };\n}\n\nexport function buildRequestContext<TCtxMeta = Record<string, unknown>>(\n  handlerCtx: HandlerContext<Account<TCtxMeta>>,\n  ctxMetadataStore?: CtxMetadataStore,\n  input?: Readonly<Record<string, unknown>>\n): RequestContext<Account<TCtxMeta>> {\n  // `account` may legitimately be undefined for tools whose wire request\n  // doesn't carry an `account` field AND whose `resolveAccountFromAuth`\n  // returned null (`'explicit'`-mode adopters who don't model the\n  // no-account tools, or buyers calling without auth). Adopter handlers\n  // for those tools are responsible for either deriving the account\n  // themselves (e.g., via `media_buy_id` ownership) or throwing\n  // `AdcpError('ACCOUNT_NOT_FOUND')` if account is required.\n  //\n  // The `RequestContext.account` type is non-optional for ergonomic typing\n  // — adopters writing handlers for the 90% case (tools with `account` on\n  // the wire) shouldn't have to optional-chain everywhere. Adopters of\n  // no-account tools either:\n  //   1. Declare `resolution: 'derived'` and return a singleton from\n  //      `accounts.resolve(undefined)` — `ctx.account` is always set\n  //   2. Implement only `'explicit'` and never claim no-account\n  //      specialisms — the tool is unreachable\n  //   3. Read `ctx.account` defensively (`as Account | undefined` cast)\n  //      and look up by request body when missing\n  const account = handlerCtx.account as Account<TCtxMeta>;\n\n  const stubResolver = (name: string) => async (): Promise<never> => {\n    throw new Error(\n      `ctx.resolve.${name}: not yet wired in v6.0 alpha — landing in rc.1. ` +\n        `Avoid touching ctx.resolve.* in adopter code until the framework ` +\n        `connects this resolver to an underlying fetcher.`\n    );\n  };\n\n  // Bind ctx-metadata accessor when store wired AND account scope present.\n  // No-account tools (provide_performance_feedback, list_creative_formats)\n  // get `ctx.ctxMetadata = undefined` even when the store is wired — cannot\n  // use ctx_metadata without an account boundary (cross-tenant risk).\n  const ctxMetadata =\n    ctxMetadataStore != null && account != null && (account.id ?? '') !== ''\n      ? buildCtxMetadataAccessor(ctxMetadataStore, account.id)\n      : undefined;\n\n  return {\n    account,\n    ...(handlerCtx.agent != null && { agent: handlerCtx.agent }),\n    ...(handlerCtx.callerMutationScope != null && {\n      callerMutationScope: Object.freeze({ ...handlerCtx.callerMutationScope }),\n    }),\n    ...(handlerCtx.proposalRefinementScope != null && {\n      proposalRefinementScope: Object.freeze({ ...handlerCtx.proposalRefinementScope }),\n    }),\n    ...(input != null && { input }),\n    state: {\n      findByObject: () => [],\n      findProposalById: () => null,\n      governanceContext: () => null,\n      workflowSteps: () => [],\n    },\n    resolve: {\n      propertyList: stubResolver('propertyList'),\n      collectionList: stubResolver('collectionList'),\n      creativeFormat: stubResolver('creativeFormat'),\n    },\n    ctxMetadata,\n    handoffToTask<TResult>(\n      fn: (taskCtx: TaskHandoffContext) => Promise<TResult>,\n      options?: TaskHandoffOptions\n    ): TaskHandoff<TResult> {\n      if (options?.task_id !== undefined) {\n        if (typeof options.task_id !== 'string' || options.task_id.length === 0) {\n          throw new Error('handoffToTask options.task_id must be a non-empty string');\n        }\n        if (options.task_id.length > 128) {\n          throw new Error('handoffToTask options.task_id must be ≤ 128 characters');\n        }\n      }\n      return _createTaskHandoff(fn, options);\n    },\n  };\n}\n\n/**\n * Construct a `TaskHandoffContext` from a registry + framework-issued\n * task id. The framework calls this AFTER detecting a `TaskHandoff`\n * marker on a method's return — the handoff function gets a context\n * carrying the framework-allocated `taskId` plus `update`/`heartbeat`\n * affordances.\n *\n * `update(progress)` writes the progress payload to the task record and\n * transitions status `submitted` → `working`. Buyers polling `tasks_get`\n * see the `progress` object and the `'working'` status — this is the\n * buyer-facing UX signal that distinguishes \"stuck/no news\" from\n * \"step 2/3, awaiting trafficker.\" Errors from the registry write are\n * swallowed so a transient DB hiccup doesn't abort the adopter's handoff\n * function.\n *\n * `heartbeat()` remains a no-op stub (v6.1); it is a liveness / TTL-reset\n * signal for operator infrastructure, not buyer-facing.\n */\nexport function buildHandoffContext(\n  taskRegistry: TaskRegistry,\n  taskId: string,\n  scope: TaskRegistryScope\n): TaskHandoffContext {\n  return {\n    id: taskId,\n    update: async progress => {\n      try {\n        await taskRegistry.updateProgress(taskId, scope, progress);\n      } catch {\n        // Swallow — a transient registry write failure must not abort the\n        // adopter's background handoff function. The buyer-facing impact is\n        // a missed progress event, not a failed task.\n      }\n    },\n    heartbeat: async () => {\n      await Promise.resolve();\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/runtime/to-context.mjs

@@ -81,12 +81,12 @@ function buildRequestContext(handlerCtx, ctxMetadataStore, input) {
     }
   };
 }
-function buildHandoffContext(taskRegistry, taskId) {
+function buildHandoffContext(taskRegistry, taskId, scope) {
   return {
     id: taskId,
     update: async (progress) => {
       try {
-        await taskRegistry.updateProgress(taskId, progress);
+        await taskRegistry.updateProgress(taskId, scope, progress);
       } catch {
       }
     },

package/dist/lib/server/decisioning/runtime/to-context.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/to-context.ts"],"sourcesContent":["/**\n * Translate the existing `HandlerContext` into the v6 `RequestContext` shape\n * that platform methods receive.\n *\n * The handler-style framework already resolves the account, sets sessionKey,\n * and exposes `store` + `authInfo` + `emitWebhook`. The new context layers\n * `state.*` (sync state reads), `resolve.*` (async framework-mediated\n * resolvers), and `handoffToTask(...)` (the unified hybrid-seller handoff\n * primitive) on top.\n *\n * **Stub status — v6.0 alpha.** `state.*` (workflow-step reads, proposal\n * lookups, governance JWS) and `resolve.*` (property/collection-list +\n * format fetchers) are NOT yet wired. The state readers return empty\n * results; the resolvers throw. Touching them in a platform method will\n * crash the request — the framework hasn't connected them to an underlying\n * store / fetch layer yet.\n *\n * Adopters spiking against the preview surface MUST avoid `ctx.state.*`\n * and `ctx.resolve.*` until the wire-up commits land in rc.1. Use\n * `ctx.account`, `ctx.handoffToTask(...)`, and the structured-error /\n * status-change primitives only.\n *\n * @internal — framework-internal wiring; not adopter surface. The\n * exported helpers (`buildRequestContext`, `buildHandoffContext`) are\n * called from the dispatch seam in `from-platform.ts`. Adopters should\n * never construct a `RequestContext` themselves; the framework supplies\n * one to every specialism method call.\n */\n\nimport type { HandlerContext } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext, CtxMetadataAccessor } from '../context';\nimport type { TaskRegistry } from './task-registry';\nimport {\n  _createTaskHandoff,\n  type TaskHandoffContext,\n  type TaskHandoff,\n  type TaskHandoffOptions,\n} from '../async-outcome';\nimport type { CtxMetadataStore, ResourceKind, CtxMetadataRef } from '../../ctx-metadata';\n\n/**\n * Build an account-scoped CtxMetadataAccessor for a single request.\n *\n * Account scope comes from `ctx.account.id` — accessor methods don't take\n * an account param. When `account.id` is null/undefined (no-account tools),\n * the accessor methods reject — no-account tools cannot use ctx_metadata\n * (cross-tenant collision risk via missing scope).\n */\nfunction buildCtxMetadataAccessor(store: CtxMetadataStore, accountId: string): CtxMetadataAccessor {\n  return {\n    get(kind: ResourceKind, id: string) {\n      return store.get(accountId, kind, id);\n    },\n    bulkGet(refs: readonly CtxMetadataRef[]) {\n      return store.bulkGet(accountId, refs);\n    },\n    set(kind: ResourceKind, id: string, value: unknown, ttlSeconds?: number) {\n      return store.set(accountId, kind, id, value, ttlSeconds);\n    },\n    delete(kind: ResourceKind, id: string) {\n      return store.delete(accountId, kind, id);\n    },\n    account(id: string) {\n      return store.get(accountId, 'account', id);\n    },\n    product(id: string) {\n      return store.get(accountId, 'product', id);\n    },\n    mediaBuy(id: string) {\n      return store.get(accountId, 'media_buy', id);\n    },\n    package(id: string) {\n      return store.get(accountId, 'package', id);\n    },\n    creative(id: string) {\n      return store.get(accountId, 'creative', id);\n    },\n    audience(id: string) {\n      return store.get(accountId, 'audience', id);\n    },\n    signal(id: string) {\n      return store.get(accountId, 'signal', id);\n    },\n  };\n}\n\nexport function buildRequestContext<TCtxMeta = Record<string, unknown>>(\n  handlerCtx: HandlerContext<Account<TCtxMeta>>,\n  ctxMetadataStore?: CtxMetadataStore,\n  input?: Readonly<Record<string, unknown>>\n): RequestContext<Account<TCtxMeta>> {\n  // `account` may legitimately be undefined for tools whose wire request\n  // doesn't carry an `account` field AND whose `resolveAccountFromAuth`\n  // returned null (`'explicit'`-mode adopters who don't model the\n  // no-account tools, or buyers calling without auth). Adopter handlers\n  // for those tools are responsible for either deriving the account\n  // themselves (e.g., via `media_buy_id` ownership) or throwing\n  // `AdcpError('ACCOUNT_NOT_FOUND')` if account is required.\n  //\n  // The `RequestContext.account` type is non-optional for ergonomic typing\n  // — adopters writing handlers for the 90% case (tools with `account` on\n  // the wire) shouldn't have to optional-chain everywhere. Adopters of\n  // no-account tools either:\n  //   1. Declare `resolution: 'derived'` and return a singleton from\n  //      `accounts.resolve(undefined)` — `ctx.account` is always set\n  //   2. Implement only `'explicit'` and never claim no-account\n  //      specialisms — the tool is unreachable\n  //   3. Read `ctx.account` defensively (`as Account | undefined` cast)\n  //      and look up by request body when missing\n  const account = handlerCtx.account as Account<TCtxMeta>;\n\n  const stubResolver = (name: string) => async (): Promise<never> => {\n    throw new Error(\n      `ctx.resolve.${name}: not yet wired in v6.0 alpha — landing in rc.1. ` +\n        `Avoid touching ctx.resolve.* in adopter code until the framework ` +\n        `connects this resolver to an underlying fetcher.`\n    );\n  };\n\n  // Bind ctx-metadata accessor when store wired AND account scope present.\n  // No-account tools (provide_performance_feedback, list_creative_formats)\n  // get `ctx.ctxMetadata = undefined` even when the store is wired — cannot\n  // use ctx_metadata without an account boundary (cross-tenant risk).\n  const ctxMetadata =\n    ctxMetadataStore != null && account != null && (account.id ?? '') !== ''\n      ? buildCtxMetadataAccessor(ctxMetadataStore, account.id)\n      : undefined;\n\n  return {\n    account,\n    ...(handlerCtx.agent != null && { agent: handlerCtx.agent }),\n    ...(handlerCtx.callerMutationScope != null && {\n      callerMutationScope: Object.freeze({ ...handlerCtx.callerMutationScope }),\n    }),\n    ...(handlerCtx.proposalRefinementScope != null && {\n      proposalRefinementScope: Object.freeze({ ...handlerCtx.proposalRefinementScope }),\n    }),\n    ...(input != null && { input }),\n    state: {\n      findByObject: () => [],\n      findProposalById: () => null,\n      governanceContext: () => null,\n      workflowSteps: () => [],\n    },\n    resolve: {\n      propertyList: stubResolver('propertyList'),\n      collectionList: stubResolver('collectionList'),\n      creativeFormat: stubResolver('creativeFormat'),\n    },\n    ctxMetadata,\n    handoffToTask<TResult>(\n      fn: (taskCtx: TaskHandoffContext) => Promise<TResult>,\n      options?: TaskHandoffOptions\n    ): TaskHandoff<TResult> {\n      if (options?.task_id !== undefined) {\n        if (typeof options.task_id !== 'string' || options.task_id.length === 0) {\n          throw new Error('handoffToTask options.task_id must be a non-empty string');\n        }\n        if (options.task_id.length > 128) {\n          throw new Error('handoffToTask options.task_id must be ≤ 128 characters');\n        }\n      }\n      return _createTaskHandoff(fn, options);\n    },\n  };\n}\n\n/**\n * Construct a `TaskHandoffContext` from a registry + framework-issued\n * task id. The framework calls this AFTER detecting a `TaskHandoff`\n * marker on a method's return — the handoff function gets a context\n * carrying the framework-allocated `taskId` plus `update`/`heartbeat`\n * affordances.\n *\n * `update(progress)` writes the progress payload to the task record and\n * transitions status `submitted` → `working`. Buyers polling `tasks_get`\n * see the `progress` object and the `'working'` status — this is the\n * buyer-facing UX signal that distinguishes \"stuck/no news\" from\n * \"step 2/3, awaiting trafficker.\" Errors from the registry write are\n * swallowed so a transient DB hiccup doesn't abort the adopter's handoff\n * function.\n *\n * `heartbeat()` remains a no-op stub (v6.1); it is a liveness / TTL-reset\n * signal for operator infrastructure, not buyer-facing.\n */\nexport function buildHandoffContext(taskRegistry: TaskRegistry, taskId: string): TaskHandoffContext {\n  return {\n    id: taskId,\n    update: async progress => {\n      try {\n        await taskRegistry.updateProgress(taskId, progress);\n      } catch {\n        // Swallow — a transient registry write failure must not abort the\n        // adopter's background handoff function. The buyer-facing impact is\n        // a missed progress event, not a failed task.\n      }\n    },\n    heartbeat: async () => {\n      await Promise.resolve();\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../../src/lib/server/decisioning/runtime/to-context.ts"],"sourcesContent":["/**\n * Translate the existing `HandlerContext` into the v6 `RequestContext` shape\n * that platform methods receive.\n *\n * The handler-style framework already resolves the account, sets sessionKey,\n * and exposes `store` + `authInfo` + `emitWebhook`. The new context layers\n * `state.*` (sync state reads), `resolve.*` (async framework-mediated\n * resolvers), and `handoffToTask(...)` (the unified hybrid-seller handoff\n * primitive) on top.\n *\n * **Stub status — v6.0 alpha.** `state.*` (workflow-step reads, proposal\n * lookups, governance JWS) and `resolve.*` (property/collection-list +\n * format fetchers) are NOT yet wired. The state readers return empty\n * results; the resolvers throw. Touching them in a platform method will\n * crash the request — the framework hasn't connected them to an underlying\n * store / fetch layer yet.\n *\n * Adopters spiking against the preview surface MUST avoid `ctx.state.*`\n * and `ctx.resolve.*` until the wire-up commits land in rc.1. Use\n * `ctx.account`, `ctx.handoffToTask(...)`, and the structured-error /\n * status-change primitives only.\n *\n * @internal — framework-internal wiring; not adopter surface. The\n * exported helpers (`buildRequestContext`, `buildHandoffContext`) are\n * called from the dispatch seam in `from-platform.ts`. Adopters should\n * never construct a `RequestContext` themselves; the framework supplies\n * one to every specialism method call.\n */\n\nimport type { HandlerContext } from '../../create-adcp-server';\nimport type { Account } from '../account';\nimport type { RequestContext, CtxMetadataAccessor } from '../context';\nimport type { TaskRegistry, TaskRegistryScope } from './task-registry';\nimport {\n  _createTaskHandoff,\n  type TaskHandoffContext,\n  type TaskHandoff,\n  type TaskHandoffOptions,\n} from '../async-outcome';\nimport type { CtxMetadataStore, ResourceKind, CtxMetadataRef } from '../../ctx-metadata';\n\n/**\n * Build an account-scoped CtxMetadataAccessor for a single request.\n *\n * Account scope comes from `ctx.account.id` — accessor methods don't take\n * an account param. When `account.id` is null/undefined (no-account tools),\n * the accessor methods reject — no-account tools cannot use ctx_metadata\n * (cross-tenant collision risk via missing scope).\n */\nfunction buildCtxMetadataAccessor(store: CtxMetadataStore, accountId: string): CtxMetadataAccessor {\n  return {\n    get(kind: ResourceKind, id: string) {\n      return store.get(accountId, kind, id);\n    },\n    bulkGet(refs: readonly CtxMetadataRef[]) {\n      return store.bulkGet(accountId, refs);\n    },\n    set(kind: ResourceKind, id: string, value: unknown, ttlSeconds?: number) {\n      return store.set(accountId, kind, id, value, ttlSeconds);\n    },\n    delete(kind: ResourceKind, id: string) {\n      return store.delete(accountId, kind, id);\n    },\n    account(id: string) {\n      return store.get(accountId, 'account', id);\n    },\n    product(id: string) {\n      return store.get(accountId, 'product', id);\n    },\n    mediaBuy(id: string) {\n      return store.get(accountId, 'media_buy', id);\n    },\n    package(id: string) {\n      return store.get(accountId, 'package', id);\n    },\n    creative(id: string) {\n      return store.get(accountId, 'creative', id);\n    },\n    audience(id: string) {\n      return store.get(accountId, 'audience', id);\n    },\n    signal(id: string) {\n      return store.get(accountId, 'signal', id);\n    },\n  };\n}\n\nexport function buildRequestContext<TCtxMeta = Record<string, unknown>>(\n  handlerCtx: HandlerContext<Account<TCtxMeta>>,\n  ctxMetadataStore?: CtxMetadataStore,\n  input?: Readonly<Record<string, unknown>>\n): RequestContext<Account<TCtxMeta>> {\n  // `account` may legitimately be undefined for tools whose wire request\n  // doesn't carry an `account` field AND whose `resolveAccountFromAuth`\n  // returned null (`'explicit'`-mode adopters who don't model the\n  // no-account tools, or buyers calling without auth). Adopter handlers\n  // for those tools are responsible for either deriving the account\n  // themselves (e.g., via `media_buy_id` ownership) or throwing\n  // `AdcpError('ACCOUNT_NOT_FOUND')` if account is required.\n  //\n  // The `RequestContext.account` type is non-optional for ergonomic typing\n  // — adopters writing handlers for the 90% case (tools with `account` on\n  // the wire) shouldn't have to optional-chain everywhere. Adopters of\n  // no-account tools either:\n  //   1. Declare `resolution: 'derived'` and return a singleton from\n  //      `accounts.resolve(undefined)` — `ctx.account` is always set\n  //   2. Implement only `'explicit'` and never claim no-account\n  //      specialisms — the tool is unreachable\n  //   3. Read `ctx.account` defensively (`as Account | undefined` cast)\n  //      and look up by request body when missing\n  const account = handlerCtx.account as Account<TCtxMeta>;\n\n  const stubResolver = (name: string) => async (): Promise<never> => {\n    throw new Error(\n      `ctx.resolve.${name}: not yet wired in v6.0 alpha — landing in rc.1. ` +\n        `Avoid touching ctx.resolve.* in adopter code until the framework ` +\n        `connects this resolver to an underlying fetcher.`\n    );\n  };\n\n  // Bind ctx-metadata accessor when store wired AND account scope present.\n  // No-account tools (provide_performance_feedback, list_creative_formats)\n  // get `ctx.ctxMetadata = undefined` even when the store is wired — cannot\n  // use ctx_metadata without an account boundary (cross-tenant risk).\n  const ctxMetadata =\n    ctxMetadataStore != null && account != null && (account.id ?? '') !== ''\n      ? buildCtxMetadataAccessor(ctxMetadataStore, account.id)\n      : undefined;\n\n  return {\n    account,\n    ...(handlerCtx.agent != null && { agent: handlerCtx.agent }),\n    ...(handlerCtx.callerMutationScope != null && {\n      callerMutationScope: Object.freeze({ ...handlerCtx.callerMutationScope }),\n    }),\n    ...(handlerCtx.proposalRefinementScope != null && {\n      proposalRefinementScope: Object.freeze({ ...handlerCtx.proposalRefinementScope }),\n    }),\n    ...(input != null && { input }),\n    state: {\n      findByObject: () => [],\n      findProposalById: () => null,\n      governanceContext: () => null,\n      workflowSteps: () => [],\n    },\n    resolve: {\n      propertyList: stubResolver('propertyList'),\n      collectionList: stubResolver('collectionList'),\n      creativeFormat: stubResolver('creativeFormat'),\n    },\n    ctxMetadata,\n    handoffToTask<TResult>(\n      fn: (taskCtx: TaskHandoffContext) => Promise<TResult>,\n      options?: TaskHandoffOptions\n    ): TaskHandoff<TResult> {\n      if (options?.task_id !== undefined) {\n        if (typeof options.task_id !== 'string' || options.task_id.length === 0) {\n          throw new Error('handoffToTask options.task_id must be a non-empty string');\n        }\n        if (options.task_id.length > 128) {\n          throw new Error('handoffToTask options.task_id must be ≤ 128 characters');\n        }\n      }\n      return _createTaskHandoff(fn, options);\n    },\n  };\n}\n\n/**\n * Construct a `TaskHandoffContext` from a registry + framework-issued\n * task id. The framework calls this AFTER detecting a `TaskHandoff`\n * marker on a method's return — the handoff function gets a context\n * carrying the framework-allocated `taskId` plus `update`/`heartbeat`\n * affordances.\n *\n * `update(progress)` writes the progress payload to the task record and\n * transitions status `submitted` → `working`. Buyers polling `tasks_get`\n * see the `progress` object and the `'working'` status — this is the\n * buyer-facing UX signal that distinguishes \"stuck/no news\" from\n * \"step 2/3, awaiting trafficker.\" Errors from the registry write are\n * swallowed so a transient DB hiccup doesn't abort the adopter's handoff\n * function.\n *\n * `heartbeat()` remains a no-op stub (v6.1); it is a liveness / TTL-reset\n * signal for operator infrastructure, not buyer-facing.\n */\nexport function buildHandoffContext(\n  taskRegistry: TaskRegistry,\n  taskId: string,\n  scope: TaskRegistryScope\n): TaskHandoffContext {\n  return {\n    id: taskId,\n    update: async progress => {\n      try {\n        await taskRegistry.updateProgress(taskId, scope, progress);\n      } catch {\n        // Swallow — a transient registry write failure must not abort the\n        // adopter's background handoff function. The buyer-facing impact is\n        // a missed progress event, not a failed task.\n      }\n    },\n    heartbeat: async () => {\n      await Promise.resolve();\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/lib/server/decisioning/specialisms/creative-ad-server.d.mts

@@ -27,7 +27,7 @@ import type { Account, NoAccountCtx } from '../account.mjs';
 import type { RequestContext } from '../context.mjs';
 import type { TaskHandoff } from '../async-outcome.mjs';
 import type { ServerPayload } from '../../../types/server-payload.mjs';
-import type { BuildCreativeRequest, CreativeManifest, PreviewCreativeRequest as LegacyPreviewCreativeRequest, PreviewCreativeResponse as LegacyPreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, BuildCreativeSuccess, BuildCreativeMultiSuccess } from '../../../types/tools.generated.mjs';
+import type { BuildCreativeRequest, CreativeManifest, PreviewCreativeRequest as LegacyPreviewCreativeRequest, PreviewCreativeResponse as LegacyPreviewCreativeResponse, ListCreativeFormatsRequest, ListCreativeFormatsResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, BuildCreativeSuccess, BuildCreativeMultiSuccess, BuildCreativeVariantSuccess } from '../../../types/tools.generated.mjs';
 import type { CanonicalSyncCreativeAsset, CanonicalCreativeResponse, CanonicalListCreativesRequest, CanonicalListCreativesResponse, CanonicalPreviewCreativeRequest, CanonicalPreviewCreativeResponse } from '../../../v2/projection/creative-delivery.mjs';
 import type { SyncCreativesRow } from './sales.mjs';
 type SyncCreative = CanonicalSyncCreativeAsset;
@@ -40,7 +40,8 @@ export type GetCreativeDeliveryPayload = ServerPayload<CanonicalCreativeResponse
 export type LegacyGetCreativeDeliveryPayload = ServerPayload<GetCreativeDeliveryResponse>;
 export type LegacyBuildCreativePayload = ServerPayload<BuildCreativeSuccess>;
 export type LegacyBuildCreativeMultiPayload = ServerPayload<BuildCreativeMultiSuccess>;
-export type LegacyBuildCreativeReturn = CreativeManifest | CreativeManifest[] | LegacyBuildCreativePayload | LegacyBuildCreativeMultiPayload;
+export type BuildCreativeVariantPayload = ServerPayload<BuildCreativeVariantSuccess>;
+export type LegacyBuildCreativeReturn = CreativeManifest | CreativeManifest[] | LegacyBuildCreativePayload | LegacyBuildCreativeMultiPayload | BuildCreativeVariantPayload;
 interface CreativeAdServerPlatformBase<TCtxMeta> {
     /**
      * Build / retrieve creative tags. Two invocation modes per the spec: