@adcp/sdk 12.1.0 → 13.0.0-rc.0

package/dist/lib/testing/storyboard/shape-drift-hints.d.mts

@@ -26,10 +26,9 @@ import type { ShapeDriftHint } from './types.mjs';
  * helper that builds the correct shape.
  *
  * Helper names aren't uniformly prefixed — `get_products` uses
- * `productsResponse` (no `get` prefix) while `get_media_buys` uses
- * `getMediaBuysResponse`. Names match the exports in
- * `src/lib/server/responses.ts` verbatim so a developer can grep
- * straight from the hint.
+ * `legacyProductsResponse` (no `get` prefix) while `get_media_buys` uses
+ * `legacyGetMediaBuysResponse`. Names match the explicit compatibility
+ * aliases on `@adcp/sdk/server`.
  */
 export declare const LIST_WRAPPER_TOOLS: Record<string, {
     wrapperKey: string;

package/dist/lib/testing/storyboard/shape-drift-hints.d.ts

@@ -26,10 +26,9 @@ import type { ShapeDriftHint } from './types';
  * helper that builds the correct shape.
  *
  * Helper names aren't uniformly prefixed — `get_products` uses
- * `productsResponse` (no `get` prefix) while `get_media_buys` uses
- * `getMediaBuysResponse`. Names match the exports in
- * `src/lib/server/responses.ts` verbatim so a developer can grep
- * straight from the hint.
+ * `legacyProductsResponse` (no `get` prefix) while `get_media_buys` uses
+ * `legacyGetMediaBuysResponse`. Names match the explicit compatibility
+ * aliases on `@adcp/sdk/server`.
  */
 export declare const LIST_WRAPPER_TOOLS: Record<string, {
     wrapperKey: string;

package/dist/lib/testing/storyboard/shape-drift-hints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shape-drift-hints.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0C9C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWrF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAKnH"}
+{"version":3,"file":"shape-drift-hints.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0C9C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAWrF,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE,CAKnH"}

package/dist/lib/testing/storyboard/shape-drift-hints.js

@@ -23,19 +23,19 @@ __export(shape_drift_hints_exports, {
 });
 module.exports = __toCommonJS(shape_drift_hints_exports);
 const HELPER_MIN_VERSION = {
-  buildCreativeResponse: "5.14.0",
-  listCreativesResponse: "5.10.0",
-  listCreativeFormatsResponse: "5.10.0",
-  listAccountsResponse: "5.10.0",
-  productsResponse: "5.10.0",
-  getMediaBuysResponse: "5.10.0",
-  getSignalsResponse: "5.10.0",
-  listPropertyListsResponse: "5.10.0",
-  listCollectionListsResponse: "5.10.0",
-  listContentStandardsResponse: "5.10.0",
-  getPlanAuditLogsResponse: "5.10.0",
-  syncCreativesResponse: "5.10.0",
-  previewCreativeResponse: "5.10.0"
+  legacyBuildCreativeResponse: "13.0.0",
+  legacyListCreativesResponse: "13.0.0",
+  legacyListCreativeFormatsResponse: "13.0.0",
+  legacyListAccountsResponse: "13.0.0",
+  legacyProductsResponse: "13.0.0",
+  legacyGetMediaBuysResponse: "13.0.0",
+  legacyGetSignalsResponse: "13.0.0",
+  legacyListPropertyListsResponse: "13.0.0",
+  legacyListCollectionListsResponse: "13.0.0",
+  legacyListContentStandardsResponse: "13.0.0",
+  legacyGetPlanAuditLogsResponse: "13.0.0",
+  legacySyncCreativesResponse: "13.0.0",
+  legacyPreviewCreativeResponse: "13.0.0"
 };
 function semverLessThan(a, b) {
   const normalize = (v) => v.replace(/^.*@/, "").replace(/-.*$/, "");
@@ -47,16 +47,16 @@ function semverLessThan(a, b) {
   return aPatch < bPatch;
 }
 const LIST_WRAPPER_TOOLS = {
-  list_creatives: { wrapperKey: "creatives", helper: "listCreativesResponse" },
-  list_creative_formats: { wrapperKey: "formats", helper: "listCreativeFormatsResponse" },
-  list_accounts: { wrapperKey: "accounts", helper: "listAccountsResponse" },
-  get_products: { wrapperKey: "products", helper: "productsResponse" },
-  get_media_buys: { wrapperKey: "media_buys", helper: "getMediaBuysResponse" },
-  get_signals: { wrapperKey: "signals", helper: "getSignalsResponse" },
-  list_property_lists: { wrapperKey: "lists", helper: "listPropertyListsResponse" },
-  list_collection_lists: { wrapperKey: "lists", helper: "listCollectionListsResponse" },
-  list_content_standards: { wrapperKey: "standards", helper: "listContentStandardsResponse" },
-  get_plan_audit_logs: { wrapperKey: "plans", helper: "getPlanAuditLogsResponse" }
+  list_creatives: { wrapperKey: "creatives", helper: "legacyListCreativesResponse" },
+  list_creative_formats: { wrapperKey: "formats", helper: "legacyListCreativeFormatsResponse" },
+  list_accounts: { wrapperKey: "accounts", helper: "legacyListAccountsResponse" },
+  get_products: { wrapperKey: "products", helper: "legacyProductsResponse" },
+  get_media_buys: { wrapperKey: "media_buys", helper: "legacyGetMediaBuysResponse" },
+  get_signals: { wrapperKey: "signals", helper: "legacyGetSignalsResponse" },
+  list_property_lists: { wrapperKey: "lists", helper: "legacyListPropertyListsResponse" },
+  list_collection_lists: { wrapperKey: "lists", helper: "legacyListCollectionListsResponse" },
+  list_content_standards: { wrapperKey: "standards", helper: "legacyListContentStandardsResponse" },
+  get_plan_audit_logs: { wrapperKey: "plans", helper: "legacyGetPlanAuditLogsResponse" }
 };
 function detectShapeDriftHints(taskName, payload, libraryVersion) {
   const hint = detect(taskName, payload);
@@ -100,7 +100,7 @@ function detect(taskName, payload) {
         observed_variant: "platform_native_fields",
         expected_variant: "{ creative_manifest: { format_id, assets } }",
         instance_path: "",
-        message: `build_creative returned platform-native fields at the top level (${platformNativePresent.join(", ")}). Required: { creative_manifest: { format_id, assets } }. Use buildCreativeResponse() from @adcp/sdk/server.`
+        message: `build_creative returned platform-native fields at the top level (${platformNativePresent.join(", ")}). Required: { creative_manifest: { format_id, assets } }. Use legacyBuildCreativeResponse() from @adcp/sdk/server.`
       };
     }
   }
@@ -115,7 +115,7 @@ function detect(taskName, payload) {
         observed_variant: "per_item_shape",
         expected_variant: "{ creatives: [{ creative_id, action, ... }] }",
         instance_path: "",
-        message: `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(", ")}). Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). Use syncCreativesResponse() from @adcp/sdk/server.`
+        message: `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(", ")}). Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). Use legacySyncCreativesResponse() from @adcp/sdk/server.`
       };
     }
     const results = p.results;
@@ -129,7 +129,7 @@ function detect(taskName, payload) {
           observed_variant: "wrong_wrapper_key",
           expected_variant: "{ creatives: [{ creative_id, action, ... }] }",
           instance_path: "/results",
-          message: `sync_creatives returned { results: [...] } instead of { creatives: [...] } \u2014 wrong wrapper key. Required: { creatives: [{ creative_id, action, ... }] }. Use syncCreativesResponse() from @adcp/sdk/server.`
+          message: `sync_creatives returned { results: [...] } instead of { creatives: [...] } \u2014 wrong wrapper key. Required: { creatives: [{ creative_id, action, ... }] }. Use legacySyncCreativesResponse() from @adcp/sdk/server.`
         };
       }
     }
@@ -146,7 +146,7 @@ function detect(taskName, payload) {
         observed_variant: "raw_render_fields",
         expected_variant: "{ response_type: 'single', previews: [{ renders: [...] }], expires_at }",
         instance_path: "",
-        message: `preview_creative returned raw render fields at the top level (${driftSignal.join(", ")}). Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. Use previewCreativeResponse() from @adcp/sdk/server.`
+        message: `preview_creative returned raw render fields at the top level (${driftSignal.join(", ")}). Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. Use legacyPreviewCreativeResponse() from @adcp/sdk/server.`
       };
     }
   }

package/dist/lib/testing/storyboard/shape-drift-hints.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"sourcesContent":["/**\n * Structured shape-drift hint detection (issue #935).\n *\n * The runner emits one `ShapeDriftHint` per response when it recognizes a\n * common payload-shape mistake — bare arrays from list tools, platform-\n * native fields from `build_creative`, missing wrappers on `sync_creatives`\n * / `preview_creative`. Each hint carries the same prose the legacy\n * `detectShapeDriftHint` returned, plus structured fields (`tool`,\n * `observed_variant`, `expected_variant`, `instance_path`) so renderers\n * (CLI, Addie, JUnit, SARIF) can build per-case fix plans without re-\n * parsing the message.\n *\n * The string-only `detectShapeDriftHint` in `validations.ts` is a thin\n * shim over this detector — kept so existing unit tests and external\n * callers keep working, but the canonical path is structured.\n *\n * Fires unconditionally (regardless of step pass/fail) — same gate as\n * `ValidationResult.warning` carried previously. The caller (`runner.ts`)\n * merges the result into `StoryboardStepResult.hints[]`.\n */\nimport type { ShapeDriftHint } from './types';\n\n/**\n * Minimum @adcp/client version in which each server-side helper first shipped.\n * Used to suffix shape-drift hints when the agent reports an older SDK version.\n * Keys match the helper name referenced in the hint `message`.\n */\nconst HELPER_MIN_VERSION: Record<string, string> = {\n  buildCreativeResponse: '5.14.0',\n  listCreativesResponse: '5.10.0',\n  listCreativeFormatsResponse: '5.10.0',\n  listAccountsResponse: '5.10.0',\n  productsResponse: '5.10.0',\n  getMediaBuysResponse: '5.10.0',\n  getSignalsResponse: '5.10.0',\n  listPropertyListsResponse: '5.10.0',\n  listCollectionListsResponse: '5.10.0',\n  listContentStandardsResponse: '5.10.0',\n  getPlanAuditLogsResponse: '5.10.0',\n  syncCreativesResponse: '5.10.0',\n  previewCreativeResponse: '5.10.0',\n};\n\n/**\n * Compare two semver strings using numeric segment ordering.\n * Returns true when `a` is strictly less than `b`.\n * Handles `@adcp/client@X.Y.Z` format by stripping the package prefix.\n */\nfunction semverLessThan(a: string, b: string): boolean {\n  // Strip package prefix (e.g. \"@adcp/client@\") and pre-release suffix (e.g. \"-beta.1\")\n  const normalize = (v: string) => v.replace(/^.*@/, '').replace(/-.*$/, '');\n  const segs = (v: string) =>\n    normalize(v)\n      .split('.')\n      .map(s => parseInt(s, 10) || 0);\n  const [aMaj = 0, aMin = 0, aPatch = 0] = segs(a);\n  const [bMaj = 0, bMin = 0, bPatch = 0] = segs(b);\n  if (aMaj !== bMaj) return aMaj < bMaj;\n  if (aMin !== bMin) return aMin < bMin;\n  return aPatch < bPatch;\n}\n\n/**\n * List-shaped tools where handlers commonly return the bare inner array\n * (`[{...}]`) at the top level instead of wrapping it in the required\n * object envelope. Each entry names the wrapper key and the response\n * helper that builds the correct shape.\n *\n * Helper names aren't uniformly prefixed — `get_products` uses\n * `productsResponse` (no `get` prefix) while `get_media_buys` uses\n * `getMediaBuysResponse`. Names match the exports in\n * `src/lib/server/responses.ts` verbatim so a developer can grep\n * straight from the hint.\n */\nexport const LIST_WRAPPER_TOOLS: Record<string, { wrapperKey: string; helper: string }> = {\n  list_creatives: { wrapperKey: 'creatives', helper: 'listCreativesResponse' },\n  list_creative_formats: { wrapperKey: 'formats', helper: 'listCreativeFormatsResponse' },\n  list_accounts: { wrapperKey: 'accounts', helper: 'listAccountsResponse' },\n  get_products: { wrapperKey: 'products', helper: 'productsResponse' },\n  get_media_buys: { wrapperKey: 'media_buys', helper: 'getMediaBuysResponse' },\n  get_signals: { wrapperKey: 'signals', helper: 'getSignalsResponse' },\n  list_property_lists: { wrapperKey: 'lists', helper: 'listPropertyListsResponse' },\n  list_collection_lists: { wrapperKey: 'lists', helper: 'listCollectionListsResponse' },\n  list_content_standards: { wrapperKey: 'standards', helper: 'listContentStandardsResponse' },\n  get_plan_audit_logs: { wrapperKey: 'plans', helper: 'getPlanAuditLogsResponse' },\n};\n\n/**\n * Detect shape-drift and return the structured hints that apply (zero or\n * one — the detector emits at most one hint per response, but returns an\n * array so callers can spread it into `step.hints[]` without a guard).\n *\n * @param taskName — tool name (snake_case) the storyboard dispatched under\n * @param payload — raw response payload, after the runner's `_message`\n *   pre-strip. `unknown` rather than `Record<string, unknown>` so bare-\n *   array payloads are recognizable at the top level; object branches\n *   guard internally.\n * @param libraryVersion — optional SDK version string the agent self-reported\n *   in `get_adcp_capabilities` (e.g. `\"@adcp/client@4.16.2\"`). When present\n *   and below the helper's minimum version, the hint message is suffixed with\n *   an upgrade note so developers know to update their SDK dep.\n */\nexport function detectShapeDriftHints(taskName: string, payload: unknown, libraryVersion?: string): ShapeDriftHint[] {\n  const hint = detect(taskName, payload);\n  if (!hint) return [];\n  if (libraryVersion) hint.message = appendVersionSuffix(hint.message, libraryVersion);\n  return [hint];\n}\n\n/**\n * If the hint message references a helper that requires a minimum SDK\n * version and the agent's reported version is below it, append an upgrade\n * note to the message. Returns the message unchanged if no version data or\n * no match.\n */\nfunction appendVersionSuffix(message: string, libraryVersion: string): string {\n  // Skip non-numeric version strings (e.g. \"local-dev\") to avoid spurious suffixes\n  const stripped = libraryVersion.replace(/^.*@/, '').replace(/-.*$/, '');\n  if (!/^\\d+\\.\\d+/.test(stripped)) return message;\n  for (const [helper, minVersion] of Object.entries(HELPER_MIN_VERSION)) {\n    if (message.includes(helper) && semverLessThan(libraryVersion, minVersion)) {\n      return (\n        message +\n        ` (Note: your agent reports ${libraryVersion} — ${helper}() ships in @adcp/client ≥${minVersion}. Upgrade your SDK dep.)`\n      );\n    }\n  }\n  return message;\n}\n\nfunction detect(taskName: string, payload: unknown): ShapeDriftHint | undefined {\n  if (Array.isArray(payload)) {\n    const listMeta = LIST_WRAPPER_TOOLS[taskName];\n    if (!listMeta) return undefined;\n    return {\n      kind: 'shape_drift',\n      tool: taskName,\n      observed_variant: 'bare_array',\n      expected_variant: `{ ${listMeta.wrapperKey}: [...] }`,\n      instance_path: '',\n      message:\n        `${taskName} returned a bare array at the top level. ` +\n        `Required: { ${listMeta.wrapperKey}: [...] }. ` +\n        `Use ${listMeta.helper}() from @adcp/sdk/server.`,\n    };\n  }\n\n  if (typeof payload !== 'object' || payload === null) return undefined;\n  const p = payload as Record<string, unknown>;\n\n  if (taskName === 'build_creative') {\n    const hasManifest = 'creative_manifest' in p || 'creative_manifests' in p;\n    const platformNativeKeys = ['tag_url', 'creative_id', 'media_type', 'tag_type'];\n    const platformNativePresent = platformNativeKeys.filter(k => k in p);\n    if (!hasManifest && platformNativePresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'platform_native_fields',\n        expected_variant: '{ creative_manifest: { format_id, assets } }',\n        instance_path: '',\n        message:\n          `build_creative returned platform-native fields at the top level (${platformNativePresent.join(', ')}). ` +\n          `Required: { creative_manifest: { format_id, assets } }. ` +\n          `Use buildCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  if (taskName === 'sync_creatives') {\n    const hasValidWrapper = 'creatives' in p || 'errors' in p || 'task_id' in p;\n    const perItemKeys = ['creative_id', 'platform_id', 'action'];\n    const perItemPresent = perItemKeys.filter(k => k in p);\n    if (!hasValidWrapper && perItemPresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'per_item_shape',\n        expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n        instance_path: '',\n        message:\n          `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(', ')}). ` +\n          `Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). ` +\n          `Use syncCreativesResponse() from @adcp/sdk/server.`,\n      };\n    }\n\n    const results = p.results;\n    if (!hasValidWrapper && Array.isArray(results) && results.length > 0) {\n      const firstRow = results[0];\n      const looksLikeCreativeRow =\n        firstRow != null && typeof firstRow === 'object' && ('creative_id' in firstRow || 'action' in firstRow);\n      if (looksLikeCreativeRow) {\n        return {\n          kind: 'shape_drift',\n          tool: taskName,\n          observed_variant: 'wrong_wrapper_key',\n          expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n          instance_path: '/results',\n          message:\n            `sync_creatives returned { results: [...] } instead of { creatives: [...] } — wrong wrapper key. ` +\n            `Required: { creatives: [{ creative_id, action, ... }] }. ` +\n            `Use syncCreativesResponse() from @adcp/sdk/server.`,\n        };\n      }\n    }\n  }\n\n  if (taskName === 'preview_creative') {\n    const hasValidWrapper = 'response_type' in p || 'previews' in p || 'results' in p;\n    const rawRenderKeys = ['preview_url', 'preview_html', 'interactive_url'];\n    const rawRenderPresent = rawRenderKeys.filter(k => k in p);\n    const driftSignal = rawRenderPresent.filter(k => k !== 'interactive_url');\n    if (!hasValidWrapper && driftSignal.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'raw_render_fields',\n        expected_variant: \"{ response_type: 'single', previews: [{ renders: [...] }], expires_at }\",\n        instance_path: '',\n        message:\n          `preview_creative returned raw render fields at the top level (${driftSignal.join(', ')}). ` +\n          `Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. ` +\n          `Use previewCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"sourcesContent":["/**\n * Structured shape-drift hint detection (issue #935).\n *\n * The runner emits one `ShapeDriftHint` per response when it recognizes a\n * common payload-shape mistake — bare arrays from list tools, platform-\n * native fields from `build_creative`, missing wrappers on `sync_creatives`\n * / `preview_creative`. Each hint carries the same prose the legacy\n * `detectShapeDriftHint` returned, plus structured fields (`tool`,\n * `observed_variant`, `expected_variant`, `instance_path`) so renderers\n * (CLI, Addie, JUnit, SARIF) can build per-case fix plans without re-\n * parsing the message.\n *\n * The string-only `detectShapeDriftHint` in `validations.ts` is a thin\n * shim over this detector — kept so existing unit tests and external\n * callers keep working, but the canonical path is structured.\n *\n * Fires unconditionally (regardless of step pass/fail) — same gate as\n * `ValidationResult.warning` carried previously. The caller (`runner.ts`)\n * merges the result into `StoryboardStepResult.hints[]`.\n */\nimport type { ShapeDriftHint } from './types';\n\n/**\n * Minimum @adcp/client version in which each server-side helper first shipped.\n * Used to suffix shape-drift hints when the agent reports an older SDK version.\n * Keys match the helper name referenced in the hint `message`.\n */\nconst HELPER_MIN_VERSION: Record<string, string> = {\n  legacyBuildCreativeResponse: '13.0.0',\n  legacyListCreativesResponse: '13.0.0',\n  legacyListCreativeFormatsResponse: '13.0.0',\n  legacyListAccountsResponse: '13.0.0',\n  legacyProductsResponse: '13.0.0',\n  legacyGetMediaBuysResponse: '13.0.0',\n  legacyGetSignalsResponse: '13.0.0',\n  legacyListPropertyListsResponse: '13.0.0',\n  legacyListCollectionListsResponse: '13.0.0',\n  legacyListContentStandardsResponse: '13.0.0',\n  legacyGetPlanAuditLogsResponse: '13.0.0',\n  legacySyncCreativesResponse: '13.0.0',\n  legacyPreviewCreativeResponse: '13.0.0',\n};\n\n/**\n * Compare two semver strings using numeric segment ordering.\n * Returns true when `a` is strictly less than `b`.\n * Handles `@adcp/client@X.Y.Z` format by stripping the package prefix.\n */\nfunction semverLessThan(a: string, b: string): boolean {\n  // Strip package prefix (e.g. \"@adcp/client@\") and pre-release suffix (e.g. \"-beta.1\")\n  const normalize = (v: string) => v.replace(/^.*@/, '').replace(/-.*$/, '');\n  const segs = (v: string) =>\n    normalize(v)\n      .split('.')\n      .map(s => parseInt(s, 10) || 0);\n  const [aMaj = 0, aMin = 0, aPatch = 0] = segs(a);\n  const [bMaj = 0, bMin = 0, bPatch = 0] = segs(b);\n  if (aMaj !== bMaj) return aMaj < bMaj;\n  if (aMin !== bMin) return aMin < bMin;\n  return aPatch < bPatch;\n}\n\n/**\n * List-shaped tools where handlers commonly return the bare inner array\n * (`[{...}]`) at the top level instead of wrapping it in the required\n * object envelope. Each entry names the wrapper key and the response\n * helper that builds the correct shape.\n *\n * Helper names aren't uniformly prefixed — `get_products` uses\n * `legacyProductsResponse` (no `get` prefix) while `get_media_buys` uses\n * `legacyGetMediaBuysResponse`. Names match the explicit compatibility\n * aliases on `@adcp/sdk/server`.\n */\nexport const LIST_WRAPPER_TOOLS: Record<string, { wrapperKey: string; helper: string }> = {\n  list_creatives: { wrapperKey: 'creatives', helper: 'legacyListCreativesResponse' },\n  list_creative_formats: { wrapperKey: 'formats', helper: 'legacyListCreativeFormatsResponse' },\n  list_accounts: { wrapperKey: 'accounts', helper: 'legacyListAccountsResponse' },\n  get_products: { wrapperKey: 'products', helper: 'legacyProductsResponse' },\n  get_media_buys: { wrapperKey: 'media_buys', helper: 'legacyGetMediaBuysResponse' },\n  get_signals: { wrapperKey: 'signals', helper: 'legacyGetSignalsResponse' },\n  list_property_lists: { wrapperKey: 'lists', helper: 'legacyListPropertyListsResponse' },\n  list_collection_lists: { wrapperKey: 'lists', helper: 'legacyListCollectionListsResponse' },\n  list_content_standards: { wrapperKey: 'standards', helper: 'legacyListContentStandardsResponse' },\n  get_plan_audit_logs: { wrapperKey: 'plans', helper: 'legacyGetPlanAuditLogsResponse' },\n};\n\n/**\n * Detect shape-drift and return the structured hints that apply (zero or\n * one — the detector emits at most one hint per response, but returns an\n * array so callers can spread it into `step.hints[]` without a guard).\n *\n * @param taskName — tool name (snake_case) the storyboard dispatched under\n * @param payload — raw response payload, after the runner's `_message`\n *   pre-strip. `unknown` rather than `Record<string, unknown>` so bare-\n *   array payloads are recognizable at the top level; object branches\n *   guard internally.\n * @param libraryVersion — optional SDK version string the agent self-reported\n *   in `get_adcp_capabilities` (e.g. `\"@adcp/client@4.16.2\"`). When present\n *   and below the helper's minimum version, the hint message is suffixed with\n *   an upgrade note so developers know to update their SDK dep.\n */\nexport function detectShapeDriftHints(taskName: string, payload: unknown, libraryVersion?: string): ShapeDriftHint[] {\n  const hint = detect(taskName, payload);\n  if (!hint) return [];\n  if (libraryVersion) hint.message = appendVersionSuffix(hint.message, libraryVersion);\n  return [hint];\n}\n\n/**\n * If the hint message references a helper that requires a minimum SDK\n * version and the agent's reported version is below it, append an upgrade\n * note to the message. Returns the message unchanged if no version data or\n * no match.\n */\nfunction appendVersionSuffix(message: string, libraryVersion: string): string {\n  // Skip non-numeric version strings (e.g. \"local-dev\") to avoid spurious suffixes\n  const stripped = libraryVersion.replace(/^.*@/, '').replace(/-.*$/, '');\n  if (!/^\\d+\\.\\d+/.test(stripped)) return message;\n  for (const [helper, minVersion] of Object.entries(HELPER_MIN_VERSION)) {\n    if (message.includes(helper) && semverLessThan(libraryVersion, minVersion)) {\n      return (\n        message +\n        ` (Note: your agent reports ${libraryVersion} — ${helper}() ships in @adcp/client ≥${minVersion}. Upgrade your SDK dep.)`\n      );\n    }\n  }\n  return message;\n}\n\nfunction detect(taskName: string, payload: unknown): ShapeDriftHint | undefined {\n  if (Array.isArray(payload)) {\n    const listMeta = LIST_WRAPPER_TOOLS[taskName];\n    if (!listMeta) return undefined;\n    return {\n      kind: 'shape_drift',\n      tool: taskName,\n      observed_variant: 'bare_array',\n      expected_variant: `{ ${listMeta.wrapperKey}: [...] }`,\n      instance_path: '',\n      message:\n        `${taskName} returned a bare array at the top level. ` +\n        `Required: { ${listMeta.wrapperKey}: [...] }. ` +\n        `Use ${listMeta.helper}() from @adcp/sdk/server.`,\n    };\n  }\n\n  if (typeof payload !== 'object' || payload === null) return undefined;\n  const p = payload as Record<string, unknown>;\n\n  if (taskName === 'build_creative') {\n    const hasManifest = 'creative_manifest' in p || 'creative_manifests' in p;\n    const platformNativeKeys = ['tag_url', 'creative_id', 'media_type', 'tag_type'];\n    const platformNativePresent = platformNativeKeys.filter(k => k in p);\n    if (!hasManifest && platformNativePresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'platform_native_fields',\n        expected_variant: '{ creative_manifest: { format_id, assets } }',\n        instance_path: '',\n        message:\n          `build_creative returned platform-native fields at the top level (${platformNativePresent.join(', ')}). ` +\n          `Required: { creative_manifest: { format_id, assets } }. ` +\n          `Use legacyBuildCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  if (taskName === 'sync_creatives') {\n    const hasValidWrapper = 'creatives' in p || 'errors' in p || 'task_id' in p;\n    const perItemKeys = ['creative_id', 'platform_id', 'action'];\n    const perItemPresent = perItemKeys.filter(k => k in p);\n    if (!hasValidWrapper && perItemPresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'per_item_shape',\n        expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n        instance_path: '',\n        message:\n          `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(', ')}). ` +\n          `Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). ` +\n          `Use legacySyncCreativesResponse() from @adcp/sdk/server.`,\n      };\n    }\n\n    const results = p.results;\n    if (!hasValidWrapper && Array.isArray(results) && results.length > 0) {\n      const firstRow = results[0];\n      const looksLikeCreativeRow =\n        firstRow != null && typeof firstRow === 'object' && ('creative_id' in firstRow || 'action' in firstRow);\n      if (looksLikeCreativeRow) {\n        return {\n          kind: 'shape_drift',\n          tool: taskName,\n          observed_variant: 'wrong_wrapper_key',\n          expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n          instance_path: '/results',\n          message:\n            `sync_creatives returned { results: [...] } instead of { creatives: [...] } — wrong wrapper key. ` +\n            `Required: { creatives: [{ creative_id, action, ... }] }. ` +\n            `Use legacySyncCreativesResponse() from @adcp/sdk/server.`,\n        };\n      }\n    }\n  }\n\n  if (taskName === 'preview_creative') {\n    const hasValidWrapper = 'response_type' in p || 'previews' in p || 'results' in p;\n    const rawRenderKeys = ['preview_url', 'preview_html', 'interactive_url'];\n    const rawRenderPresent = rawRenderKeys.filter(k => k in p);\n    const driftSignal = rawRenderPresent.filter(k => k !== 'interactive_url');\n    if (!hasValidWrapper && driftSignal.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'raw_render_fields',\n        expected_variant: \"{ response_type: 'single', previews: [{ renders: [...] }], expires_at }\",\n        instance_path: '',\n        message:\n          `preview_creative returned raw render fields at the top level (${driftSignal.join(', ')}). ` +\n          `Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. ` +\n          `Use legacyPreviewCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/testing/storyboard/shape-drift-hints.mjs

@@ -1,17 +1,17 @@
 const HELPER_MIN_VERSION = {
-  buildCreativeResponse: "5.14.0",
-  listCreativesResponse: "5.10.0",
-  listCreativeFormatsResponse: "5.10.0",
-  listAccountsResponse: "5.10.0",
-  productsResponse: "5.10.0",
-  getMediaBuysResponse: "5.10.0",
-  getSignalsResponse: "5.10.0",
-  listPropertyListsResponse: "5.10.0",
-  listCollectionListsResponse: "5.10.0",
-  listContentStandardsResponse: "5.10.0",
-  getPlanAuditLogsResponse: "5.10.0",
-  syncCreativesResponse: "5.10.0",
-  previewCreativeResponse: "5.10.0"
+  legacyBuildCreativeResponse: "13.0.0",
+  legacyListCreativesResponse: "13.0.0",
+  legacyListCreativeFormatsResponse: "13.0.0",
+  legacyListAccountsResponse: "13.0.0",
+  legacyProductsResponse: "13.0.0",
+  legacyGetMediaBuysResponse: "13.0.0",
+  legacyGetSignalsResponse: "13.0.0",
+  legacyListPropertyListsResponse: "13.0.0",
+  legacyListCollectionListsResponse: "13.0.0",
+  legacyListContentStandardsResponse: "13.0.0",
+  legacyGetPlanAuditLogsResponse: "13.0.0",
+  legacySyncCreativesResponse: "13.0.0",
+  legacyPreviewCreativeResponse: "13.0.0"
 };
 function semverLessThan(a, b) {
   const normalize = (v) => v.replace(/^.*@/, "").replace(/-.*$/, "");
@@ -23,16 +23,16 @@ function semverLessThan(a, b) {
   return aPatch < bPatch;
 }
 const LIST_WRAPPER_TOOLS = {
-  list_creatives: { wrapperKey: "creatives", helper: "listCreativesResponse" },
-  list_creative_formats: { wrapperKey: "formats", helper: "listCreativeFormatsResponse" },
-  list_accounts: { wrapperKey: "accounts", helper: "listAccountsResponse" },
-  get_products: { wrapperKey: "products", helper: "productsResponse" },
-  get_media_buys: { wrapperKey: "media_buys", helper: "getMediaBuysResponse" },
-  get_signals: { wrapperKey: "signals", helper: "getSignalsResponse" },
-  list_property_lists: { wrapperKey: "lists", helper: "listPropertyListsResponse" },
-  list_collection_lists: { wrapperKey: "lists", helper: "listCollectionListsResponse" },
-  list_content_standards: { wrapperKey: "standards", helper: "listContentStandardsResponse" },
-  get_plan_audit_logs: { wrapperKey: "plans", helper: "getPlanAuditLogsResponse" }
+  list_creatives: { wrapperKey: "creatives", helper: "legacyListCreativesResponse" },
+  list_creative_formats: { wrapperKey: "formats", helper: "legacyListCreativeFormatsResponse" },
+  list_accounts: { wrapperKey: "accounts", helper: "legacyListAccountsResponse" },
+  get_products: { wrapperKey: "products", helper: "legacyProductsResponse" },
+  get_media_buys: { wrapperKey: "media_buys", helper: "legacyGetMediaBuysResponse" },
+  get_signals: { wrapperKey: "signals", helper: "legacyGetSignalsResponse" },
+  list_property_lists: { wrapperKey: "lists", helper: "legacyListPropertyListsResponse" },
+  list_collection_lists: { wrapperKey: "lists", helper: "legacyListCollectionListsResponse" },
+  list_content_standards: { wrapperKey: "standards", helper: "legacyListContentStandardsResponse" },
+  get_plan_audit_logs: { wrapperKey: "plans", helper: "legacyGetPlanAuditLogsResponse" }
 };
 function detectShapeDriftHints(taskName, payload, libraryVersion) {
   const hint = detect(taskName, payload);
@@ -76,7 +76,7 @@ function detect(taskName, payload) {
         observed_variant: "platform_native_fields",
         expected_variant: "{ creative_manifest: { format_id, assets } }",
         instance_path: "",
-        message: `build_creative returned platform-native fields at the top level (${platformNativePresent.join(", ")}). Required: { creative_manifest: { format_id, assets } }. Use buildCreativeResponse() from @adcp/sdk/server.`
+        message: `build_creative returned platform-native fields at the top level (${platformNativePresent.join(", ")}). Required: { creative_manifest: { format_id, assets } }. Use legacyBuildCreativeResponse() from @adcp/sdk/server.`
       };
     }
   }
@@ -91,7 +91,7 @@ function detect(taskName, payload) {
         observed_variant: "per_item_shape",
         expected_variant: "{ creatives: [{ creative_id, action, ... }] }",
         instance_path: "",
-        message: `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(", ")}). Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). Use syncCreativesResponse() from @adcp/sdk/server.`
+        message: `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(", ")}). Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). Use legacySyncCreativesResponse() from @adcp/sdk/server.`
       };
     }
     const results = p.results;
@@ -105,7 +105,7 @@ function detect(taskName, payload) {
           observed_variant: "wrong_wrapper_key",
           expected_variant: "{ creatives: [{ creative_id, action, ... }] }",
           instance_path: "/results",
-          message: `sync_creatives returned { results: [...] } instead of { creatives: [...] } \u2014 wrong wrapper key. Required: { creatives: [{ creative_id, action, ... }] }. Use syncCreativesResponse() from @adcp/sdk/server.`
+          message: `sync_creatives returned { results: [...] } instead of { creatives: [...] } \u2014 wrong wrapper key. Required: { creatives: [{ creative_id, action, ... }] }. Use legacySyncCreativesResponse() from @adcp/sdk/server.`
         };
       }
     }
@@ -122,7 +122,7 @@ function detect(taskName, payload) {
         observed_variant: "raw_render_fields",
         expected_variant: "{ response_type: 'single', previews: [{ renders: [...] }], expires_at }",
         instance_path: "",
-        message: `preview_creative returned raw render fields at the top level (${driftSignal.join(", ")}). Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. Use previewCreativeResponse() from @adcp/sdk/server.`
+        message: `preview_creative returned raw render fields at the top level (${driftSignal.join(", ")}). Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. Use legacyPreviewCreativeResponse() from @adcp/sdk/server.`
       };
     }
   }

package/dist/lib/testing/storyboard/shape-drift-hints.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"sourcesContent":["/**\n * Structured shape-drift hint detection (issue #935).\n *\n * The runner emits one `ShapeDriftHint` per response when it recognizes a\n * common payload-shape mistake — bare arrays from list tools, platform-\n * native fields from `build_creative`, missing wrappers on `sync_creatives`\n * / `preview_creative`. Each hint carries the same prose the legacy\n * `detectShapeDriftHint` returned, plus structured fields (`tool`,\n * `observed_variant`, `expected_variant`, `instance_path`) so renderers\n * (CLI, Addie, JUnit, SARIF) can build per-case fix plans without re-\n * parsing the message.\n *\n * The string-only `detectShapeDriftHint` in `validations.ts` is a thin\n * shim over this detector — kept so existing unit tests and external\n * callers keep working, but the canonical path is structured.\n *\n * Fires unconditionally (regardless of step pass/fail) — same gate as\n * `ValidationResult.warning` carried previously. The caller (`runner.ts`)\n * merges the result into `StoryboardStepResult.hints[]`.\n */\nimport type { ShapeDriftHint } from './types';\n\n/**\n * Minimum @adcp/client version in which each server-side helper first shipped.\n * Used to suffix shape-drift hints when the agent reports an older SDK version.\n * Keys match the helper name referenced in the hint `message`.\n */\nconst HELPER_MIN_VERSION: Record<string, string> = {\n  buildCreativeResponse: '5.14.0',\n  listCreativesResponse: '5.10.0',\n  listCreativeFormatsResponse: '5.10.0',\n  listAccountsResponse: '5.10.0',\n  productsResponse: '5.10.0',\n  getMediaBuysResponse: '5.10.0',\n  getSignalsResponse: '5.10.0',\n  listPropertyListsResponse: '5.10.0',\n  listCollectionListsResponse: '5.10.0',\n  listContentStandardsResponse: '5.10.0',\n  getPlanAuditLogsResponse: '5.10.0',\n  syncCreativesResponse: '5.10.0',\n  previewCreativeResponse: '5.10.0',\n};\n\n/**\n * Compare two semver strings using numeric segment ordering.\n * Returns true when `a` is strictly less than `b`.\n * Handles `@adcp/client@X.Y.Z` format by stripping the package prefix.\n */\nfunction semverLessThan(a: string, b: string): boolean {\n  // Strip package prefix (e.g. \"@adcp/client@\") and pre-release suffix (e.g. \"-beta.1\")\n  const normalize = (v: string) => v.replace(/^.*@/, '').replace(/-.*$/, '');\n  const segs = (v: string) =>\n    normalize(v)\n      .split('.')\n      .map(s => parseInt(s, 10) || 0);\n  const [aMaj = 0, aMin = 0, aPatch = 0] = segs(a);\n  const [bMaj = 0, bMin = 0, bPatch = 0] = segs(b);\n  if (aMaj !== bMaj) return aMaj < bMaj;\n  if (aMin !== bMin) return aMin < bMin;\n  return aPatch < bPatch;\n}\n\n/**\n * List-shaped tools where handlers commonly return the bare inner array\n * (`[{...}]`) at the top level instead of wrapping it in the required\n * object envelope. Each entry names the wrapper key and the response\n * helper that builds the correct shape.\n *\n * Helper names aren't uniformly prefixed — `get_products` uses\n * `productsResponse` (no `get` prefix) while `get_media_buys` uses\n * `getMediaBuysResponse`. Names match the exports in\n * `src/lib/server/responses.ts` verbatim so a developer can grep\n * straight from the hint.\n */\nexport const LIST_WRAPPER_TOOLS: Record<string, { wrapperKey: string; helper: string }> = {\n  list_creatives: { wrapperKey: 'creatives', helper: 'listCreativesResponse' },\n  list_creative_formats: { wrapperKey: 'formats', helper: 'listCreativeFormatsResponse' },\n  list_accounts: { wrapperKey: 'accounts', helper: 'listAccountsResponse' },\n  get_products: { wrapperKey: 'products', helper: 'productsResponse' },\n  get_media_buys: { wrapperKey: 'media_buys', helper: 'getMediaBuysResponse' },\n  get_signals: { wrapperKey: 'signals', helper: 'getSignalsResponse' },\n  list_property_lists: { wrapperKey: 'lists', helper: 'listPropertyListsResponse' },\n  list_collection_lists: { wrapperKey: 'lists', helper: 'listCollectionListsResponse' },\n  list_content_standards: { wrapperKey: 'standards', helper: 'listContentStandardsResponse' },\n  get_plan_audit_logs: { wrapperKey: 'plans', helper: 'getPlanAuditLogsResponse' },\n};\n\n/**\n * Detect shape-drift and return the structured hints that apply (zero or\n * one — the detector emits at most one hint per response, but returns an\n * array so callers can spread it into `step.hints[]` without a guard).\n *\n * @param taskName — tool name (snake_case) the storyboard dispatched under\n * @param payload — raw response payload, after the runner's `_message`\n *   pre-strip. `unknown` rather than `Record<string, unknown>` so bare-\n *   array payloads are recognizable at the top level; object branches\n *   guard internally.\n * @param libraryVersion — optional SDK version string the agent self-reported\n *   in `get_adcp_capabilities` (e.g. `\"@adcp/client@4.16.2\"`). When present\n *   and below the helper's minimum version, the hint message is suffixed with\n *   an upgrade note so developers know to update their SDK dep.\n */\nexport function detectShapeDriftHints(taskName: string, payload: unknown, libraryVersion?: string): ShapeDriftHint[] {\n  const hint = detect(taskName, payload);\n  if (!hint) return [];\n  if (libraryVersion) hint.message = appendVersionSuffix(hint.message, libraryVersion);\n  return [hint];\n}\n\n/**\n * If the hint message references a helper that requires a minimum SDK\n * version and the agent's reported version is below it, append an upgrade\n * note to the message. Returns the message unchanged if no version data or\n * no match.\n */\nfunction appendVersionSuffix(message: string, libraryVersion: string): string {\n  // Skip non-numeric version strings (e.g. \"local-dev\") to avoid spurious suffixes\n  const stripped = libraryVersion.replace(/^.*@/, '').replace(/-.*$/, '');\n  if (!/^\\d+\\.\\d+/.test(stripped)) return message;\n  for (const [helper, minVersion] of Object.entries(HELPER_MIN_VERSION)) {\n    if (message.includes(helper) && semverLessThan(libraryVersion, minVersion)) {\n      return (\n        message +\n        ` (Note: your agent reports ${libraryVersion} — ${helper}() ships in @adcp/client ≥${minVersion}. Upgrade your SDK dep.)`\n      );\n    }\n  }\n  return message;\n}\n\nfunction detect(taskName: string, payload: unknown): ShapeDriftHint | undefined {\n  if (Array.isArray(payload)) {\n    const listMeta = LIST_WRAPPER_TOOLS[taskName];\n    if (!listMeta) return undefined;\n    return {\n      kind: 'shape_drift',\n      tool: taskName,\n      observed_variant: 'bare_array',\n      expected_variant: `{ ${listMeta.wrapperKey}: [...] }`,\n      instance_path: '',\n      message:\n        `${taskName} returned a bare array at the top level. ` +\n        `Required: { ${listMeta.wrapperKey}: [...] }. ` +\n        `Use ${listMeta.helper}() from @adcp/sdk/server.`,\n    };\n  }\n\n  if (typeof payload !== 'object' || payload === null) return undefined;\n  const p = payload as Record<string, unknown>;\n\n  if (taskName === 'build_creative') {\n    const hasManifest = 'creative_manifest' in p || 'creative_manifests' in p;\n    const platformNativeKeys = ['tag_url', 'creative_id', 'media_type', 'tag_type'];\n    const platformNativePresent = platformNativeKeys.filter(k => k in p);\n    if (!hasManifest && platformNativePresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'platform_native_fields',\n        expected_variant: '{ creative_manifest: { format_id, assets } }',\n        instance_path: '',\n        message:\n          `build_creative returned platform-native fields at the top level (${platformNativePresent.join(', ')}). ` +\n          `Required: { creative_manifest: { format_id, assets } }. ` +\n          `Use buildCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  if (taskName === 'sync_creatives') {\n    const hasValidWrapper = 'creatives' in p || 'errors' in p || 'task_id' in p;\n    const perItemKeys = ['creative_id', 'platform_id', 'action'];\n    const perItemPresent = perItemKeys.filter(k => k in p);\n    if (!hasValidWrapper && perItemPresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'per_item_shape',\n        expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n        instance_path: '',\n        message:\n          `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(', ')}). ` +\n          `Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). ` +\n          `Use syncCreativesResponse() from @adcp/sdk/server.`,\n      };\n    }\n\n    const results = p.results;\n    if (!hasValidWrapper && Array.isArray(results) && results.length > 0) {\n      const firstRow = results[0];\n      const looksLikeCreativeRow =\n        firstRow != null && typeof firstRow === 'object' && ('creative_id' in firstRow || 'action' in firstRow);\n      if (looksLikeCreativeRow) {\n        return {\n          kind: 'shape_drift',\n          tool: taskName,\n          observed_variant: 'wrong_wrapper_key',\n          expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n          instance_path: '/results',\n          message:\n            `sync_creatives returned { results: [...] } instead of { creatives: [...] } — wrong wrapper key. ` +\n            `Required: { creatives: [{ creative_id, action, ... }] }. ` +\n            `Use syncCreativesResponse() from @adcp/sdk/server.`,\n        };\n      }\n    }\n  }\n\n  if (taskName === 'preview_creative') {\n    const hasValidWrapper = 'response_type' in p || 'previews' in p || 'results' in p;\n    const rawRenderKeys = ['preview_url', 'preview_html', 'interactive_url'];\n    const rawRenderPresent = rawRenderKeys.filter(k => k in p);\n    const driftSignal = rawRenderPresent.filter(k => k !== 'interactive_url');\n    if (!hasValidWrapper && driftSignal.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'raw_render_fields',\n        expected_variant: \"{ response_type: 'single', previews: [{ renders: [...] }], expires_at }\",\n        instance_path: '',\n        message:\n          `preview_creative returned raw render fields at the top level (${driftSignal.join(', ')}). ` +\n          `Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. ` +\n          `Use previewCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/storyboard/shape-drift-hints.ts"],"sourcesContent":["/**\n * Structured shape-drift hint detection (issue #935).\n *\n * The runner emits one `ShapeDriftHint` per response when it recognizes a\n * common payload-shape mistake — bare arrays from list tools, platform-\n * native fields from `build_creative`, missing wrappers on `sync_creatives`\n * / `preview_creative`. Each hint carries the same prose the legacy\n * `detectShapeDriftHint` returned, plus structured fields (`tool`,\n * `observed_variant`, `expected_variant`, `instance_path`) so renderers\n * (CLI, Addie, JUnit, SARIF) can build per-case fix plans without re-\n * parsing the message.\n *\n * The string-only `detectShapeDriftHint` in `validations.ts` is a thin\n * shim over this detector — kept so existing unit tests and external\n * callers keep working, but the canonical path is structured.\n *\n * Fires unconditionally (regardless of step pass/fail) — same gate as\n * `ValidationResult.warning` carried previously. The caller (`runner.ts`)\n * merges the result into `StoryboardStepResult.hints[]`.\n */\nimport type { ShapeDriftHint } from './types';\n\n/**\n * Minimum @adcp/client version in which each server-side helper first shipped.\n * Used to suffix shape-drift hints when the agent reports an older SDK version.\n * Keys match the helper name referenced in the hint `message`.\n */\nconst HELPER_MIN_VERSION: Record<string, string> = {\n  legacyBuildCreativeResponse: '13.0.0',\n  legacyListCreativesResponse: '13.0.0',\n  legacyListCreativeFormatsResponse: '13.0.0',\n  legacyListAccountsResponse: '13.0.0',\n  legacyProductsResponse: '13.0.0',\n  legacyGetMediaBuysResponse: '13.0.0',\n  legacyGetSignalsResponse: '13.0.0',\n  legacyListPropertyListsResponse: '13.0.0',\n  legacyListCollectionListsResponse: '13.0.0',\n  legacyListContentStandardsResponse: '13.0.0',\n  legacyGetPlanAuditLogsResponse: '13.0.0',\n  legacySyncCreativesResponse: '13.0.0',\n  legacyPreviewCreativeResponse: '13.0.0',\n};\n\n/**\n * Compare two semver strings using numeric segment ordering.\n * Returns true when `a` is strictly less than `b`.\n * Handles `@adcp/client@X.Y.Z` format by stripping the package prefix.\n */\nfunction semverLessThan(a: string, b: string): boolean {\n  // Strip package prefix (e.g. \"@adcp/client@\") and pre-release suffix (e.g. \"-beta.1\")\n  const normalize = (v: string) => v.replace(/^.*@/, '').replace(/-.*$/, '');\n  const segs = (v: string) =>\n    normalize(v)\n      .split('.')\n      .map(s => parseInt(s, 10) || 0);\n  const [aMaj = 0, aMin = 0, aPatch = 0] = segs(a);\n  const [bMaj = 0, bMin = 0, bPatch = 0] = segs(b);\n  if (aMaj !== bMaj) return aMaj < bMaj;\n  if (aMin !== bMin) return aMin < bMin;\n  return aPatch < bPatch;\n}\n\n/**\n * List-shaped tools where handlers commonly return the bare inner array\n * (`[{...}]`) at the top level instead of wrapping it in the required\n * object envelope. Each entry names the wrapper key and the response\n * helper that builds the correct shape.\n *\n * Helper names aren't uniformly prefixed — `get_products` uses\n * `legacyProductsResponse` (no `get` prefix) while `get_media_buys` uses\n * `legacyGetMediaBuysResponse`. Names match the explicit compatibility\n * aliases on `@adcp/sdk/server`.\n */\nexport const LIST_WRAPPER_TOOLS: Record<string, { wrapperKey: string; helper: string }> = {\n  list_creatives: { wrapperKey: 'creatives', helper: 'legacyListCreativesResponse' },\n  list_creative_formats: { wrapperKey: 'formats', helper: 'legacyListCreativeFormatsResponse' },\n  list_accounts: { wrapperKey: 'accounts', helper: 'legacyListAccountsResponse' },\n  get_products: { wrapperKey: 'products', helper: 'legacyProductsResponse' },\n  get_media_buys: { wrapperKey: 'media_buys', helper: 'legacyGetMediaBuysResponse' },\n  get_signals: { wrapperKey: 'signals', helper: 'legacyGetSignalsResponse' },\n  list_property_lists: { wrapperKey: 'lists', helper: 'legacyListPropertyListsResponse' },\n  list_collection_lists: { wrapperKey: 'lists', helper: 'legacyListCollectionListsResponse' },\n  list_content_standards: { wrapperKey: 'standards', helper: 'legacyListContentStandardsResponse' },\n  get_plan_audit_logs: { wrapperKey: 'plans', helper: 'legacyGetPlanAuditLogsResponse' },\n};\n\n/**\n * Detect shape-drift and return the structured hints that apply (zero or\n * one — the detector emits at most one hint per response, but returns an\n * array so callers can spread it into `step.hints[]` without a guard).\n *\n * @param taskName — tool name (snake_case) the storyboard dispatched under\n * @param payload — raw response payload, after the runner's `_message`\n *   pre-strip. `unknown` rather than `Record<string, unknown>` so bare-\n *   array payloads are recognizable at the top level; object branches\n *   guard internally.\n * @param libraryVersion — optional SDK version string the agent self-reported\n *   in `get_adcp_capabilities` (e.g. `\"@adcp/client@4.16.2\"`). When present\n *   and below the helper's minimum version, the hint message is suffixed with\n *   an upgrade note so developers know to update their SDK dep.\n */\nexport function detectShapeDriftHints(taskName: string, payload: unknown, libraryVersion?: string): ShapeDriftHint[] {\n  const hint = detect(taskName, payload);\n  if (!hint) return [];\n  if (libraryVersion) hint.message = appendVersionSuffix(hint.message, libraryVersion);\n  return [hint];\n}\n\n/**\n * If the hint message references a helper that requires a minimum SDK\n * version and the agent's reported version is below it, append an upgrade\n * note to the message. Returns the message unchanged if no version data or\n * no match.\n */\nfunction appendVersionSuffix(message: string, libraryVersion: string): string {\n  // Skip non-numeric version strings (e.g. \"local-dev\") to avoid spurious suffixes\n  const stripped = libraryVersion.replace(/^.*@/, '').replace(/-.*$/, '');\n  if (!/^\\d+\\.\\d+/.test(stripped)) return message;\n  for (const [helper, minVersion] of Object.entries(HELPER_MIN_VERSION)) {\n    if (message.includes(helper) && semverLessThan(libraryVersion, minVersion)) {\n      return (\n        message +\n        ` (Note: your agent reports ${libraryVersion} — ${helper}() ships in @adcp/client ≥${minVersion}. Upgrade your SDK dep.)`\n      );\n    }\n  }\n  return message;\n}\n\nfunction detect(taskName: string, payload: unknown): ShapeDriftHint | undefined {\n  if (Array.isArray(payload)) {\n    const listMeta = LIST_WRAPPER_TOOLS[taskName];\n    if (!listMeta) return undefined;\n    return {\n      kind: 'shape_drift',\n      tool: taskName,\n      observed_variant: 'bare_array',\n      expected_variant: `{ ${listMeta.wrapperKey}: [...] }`,\n      instance_path: '',\n      message:\n        `${taskName} returned a bare array at the top level. ` +\n        `Required: { ${listMeta.wrapperKey}: [...] }. ` +\n        `Use ${listMeta.helper}() from @adcp/sdk/server.`,\n    };\n  }\n\n  if (typeof payload !== 'object' || payload === null) return undefined;\n  const p = payload as Record<string, unknown>;\n\n  if (taskName === 'build_creative') {\n    const hasManifest = 'creative_manifest' in p || 'creative_manifests' in p;\n    const platformNativeKeys = ['tag_url', 'creative_id', 'media_type', 'tag_type'];\n    const platformNativePresent = platformNativeKeys.filter(k => k in p);\n    if (!hasManifest && platformNativePresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'platform_native_fields',\n        expected_variant: '{ creative_manifest: { format_id, assets } }',\n        instance_path: '',\n        message:\n          `build_creative returned platform-native fields at the top level (${platformNativePresent.join(', ')}). ` +\n          `Required: { creative_manifest: { format_id, assets } }. ` +\n          `Use legacyBuildCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  if (taskName === 'sync_creatives') {\n    const hasValidWrapper = 'creatives' in p || 'errors' in p || 'task_id' in p;\n    const perItemKeys = ['creative_id', 'platform_id', 'action'];\n    const perItemPresent = perItemKeys.filter(k => k in p);\n    if (!hasValidWrapper && perItemPresent.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'per_item_shape',\n        expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n        instance_path: '',\n        message:\n          `sync_creatives returned a single creative's inner shape at the top level (${perItemPresent.join(', ')}). ` +\n          `Required: { creatives: [{ creative_id, action, ... }] } (or { errors: [...] } / { status: 'submitted', task_id }). ` +\n          `Use legacySyncCreativesResponse() from @adcp/sdk/server.`,\n      };\n    }\n\n    const results = p.results;\n    if (!hasValidWrapper && Array.isArray(results) && results.length > 0) {\n      const firstRow = results[0];\n      const looksLikeCreativeRow =\n        firstRow != null && typeof firstRow === 'object' && ('creative_id' in firstRow || 'action' in firstRow);\n      if (looksLikeCreativeRow) {\n        return {\n          kind: 'shape_drift',\n          tool: taskName,\n          observed_variant: 'wrong_wrapper_key',\n          expected_variant: '{ creatives: [{ creative_id, action, ... }] }',\n          instance_path: '/results',\n          message:\n            `sync_creatives returned { results: [...] } instead of { creatives: [...] } — wrong wrapper key. ` +\n            `Required: { creatives: [{ creative_id, action, ... }] }. ` +\n            `Use legacySyncCreativesResponse() from @adcp/sdk/server.`,\n        };\n      }\n    }\n  }\n\n  if (taskName === 'preview_creative') {\n    const hasValidWrapper = 'response_type' in p || 'previews' in p || 'results' in p;\n    const rawRenderKeys = ['preview_url', 'preview_html', 'interactive_url'];\n    const rawRenderPresent = rawRenderKeys.filter(k => k in p);\n    const driftSignal = rawRenderPresent.filter(k => k !== 'interactive_url');\n    if (!hasValidWrapper && driftSignal.length > 0) {\n      return {\n        kind: 'shape_drift',\n        tool: taskName,\n        observed_variant: 'raw_render_fields',\n        expected_variant: \"{ response_type: 'single', previews: [{ renders: [...] }], expires_at }\",\n        instance_path: '',\n        message:\n          `preview_creative returned raw render fields at the top level (${driftSignal.join(', ')}). ` +\n          `Required: { response_type: 'single', previews: [{ renders: [{ preview_url | preview_html }] }], expires_at }. ` +\n          `Use legacyPreviewCreativeResponse() from @adcp/sdk/server.`,\n      };\n    }\n  }\n\n  return undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/lib/testing/storyboard/task-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-map.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/task-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsDjD,CAAC;AAgDF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAEzC,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,GAAE;IAAE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACxG,OAAO,CAAC,UAAU,CAAC,CAuFrB"}
+{"version":3,"file":"task-map.d.ts","sourceRoot":"","sources":["../../../../src/lib/testing/storyboard/task-map.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAI3C;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsDjD,CAAC;AAwFF;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAEzC,MAAM,EAAE,GAAG,EACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,GAAE;IAAE,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACxG,OAAO,CAAC,UAAU,CAAC,CA0FrB"}

package/dist/lib/testing/storyboard/task-map.js

@@ -37,8 +37,8 @@ const TASK_TO_METHOD = {
   provide_performance_feedback: "providePerformanceFeedback",
   // Creative
   list_creative_formats: "listCreativeFormats",
-  build_creative: "buildCreative",
-  preview_creative: "previewCreative",
+  build_creative: "buildCreativeLegacy",
+  preview_creative: "previewCreativeLegacy",
   sync_creatives: "syncCreatives",
   list_creatives: "listCreatives",
   // Signals
@@ -71,9 +71,45 @@ const TASK_TO_METHOD = {
   si_send_message: "siSendMessage",
   si_terminate_session: "siTerminateSession"
 };
+const LEGACY_CREATIVE_TASK_TO_METHOD = {
+  get_products: "getProductsLegacy",
+  create_media_buy: "createMediaBuyLegacy",
+  update_media_buy: "updateMediaBuyLegacy",
+  sync_creatives: "syncCreativesLegacy",
+  list_creatives: "listCreativesLegacy"
+};
+function gradesLegacyCreativeWire(client) {
+  if (client === null || typeof client !== "object") return false;
+  const getAdcpVersion = client.getAdcpVersion;
+  if (typeof getAdcpVersion !== "function") return false;
+  let version;
+  try {
+    version = getAdcpVersion.call(client);
+  } catch {
+    return false;
+  }
+  if (typeof version !== "string") return false;
+  const match = /^v?(\d+)(?:\.(\d+))?/.exec(version.trim());
+  if (!match) return false;
+  const major = Number(match[1]);
+  const minor = Number(match[2] ?? 0);
+  return major < 3 || major === 3 && minor < 2;
+}
 function isRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
+function withLegacyCreativeWireHint(params) {
+  const ext = isRecord(params.ext) ? params.ext : {};
+  const adcp = isRecord(ext.adcp) ? ext.adcp : {};
+  if (adcp.creative_wire === "legacy" || adcp.creative_wire === "canonical") return params;
+  return {
+    ...params,
+    ext: {
+      ...ext,
+      adcp: { ...adcp, creative_wire: "legacy" }
+    }
+  };
+}
 function readAdcpError(value) {
   if (!isRecord(value)) return void 0;
   const error = value.adcp_error;
@@ -108,7 +144,9 @@ function normalizeStoryboardTaskSuccess(result, taskName, terminalDataError, adc
   return true;
 }
 async function executeStoryboardTask(client, taskName, params, opts = {}) {
-  const methodName = Object.hasOwn(TASK_TO_METHOD, taskName) ? TASK_TO_METHOD[taskName] : void 0;
+  const legacyMethodName = gradesLegacyCreativeWire(client) ? LEGACY_CREATIVE_TASK_TO_METHOD[taskName] : void 0;
+  const methodName = legacyMethodName ?? (Object.hasOwn(TASK_TO_METHOD, taskName) ? TASK_TO_METHOD[taskName] : void 0);
+  const callParams = legacyMethodName ? withLegacyCreativeWireHint(params) : params;
   const taskOptions = opts.skipIdempotencyAutoInject || opts.skipAccountValidation ? {
     ...opts.skipIdempotencyAutoInject && { skipIdempotencyAutoInject: true },
     ...opts.skipAccountValidation && { skipAccountValidation: true }
@@ -116,9 +154,9 @@ async function executeStoryboardTask(client, taskName, params, opts = {}) {
   let result;
   const invoke = async () => {
     if (methodName && typeof client[methodName] === "function") {
-      return taskOptions ? client[methodName](params, void 0, taskOptions) : client[methodName](params);
+      return taskOptions ? client[methodName](callParams, void 0, taskOptions) : client[methodName](callParams);
     }
-    return client.executeTask(taskName, params, void 0, taskOptions);
+    return client.executeTask(taskName, callParams, void 0, taskOptions);
   };
   const MAX_RETRIES = 3;
   const BASE_DELAY_MS = 2e3;

package/dist/lib/testing/storyboard/task-map.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/testing/storyboard/task-map.ts"],"sourcesContent":["/**\n * Maps AdCP task names (from storyboard YAML) to SingleAgentClient method names.\n *\n * Each storyboard step has a `task` field like \"sync_accounts\" or \"get_products\".\n * This map resolves those to the camelCase method on SingleAgentClient.\n *\n * Tasks without a dedicated method fall through to `executeTask()`.\n */\n\nimport type { TaskResult } from '../types';\nimport type { AdcpErrorInfo } from '../../core/ConversationTypes';\nimport { isTerminalAdcpError, readExtractionPath } from '../../utils/response-unwrapper';\n\n/**\n * Map of AdCP task names to SingleAgentClient method names.\n * Only includes tasks that have dedicated typed methods.\n */\nexport const TASK_TO_METHOD: Record<string, string> = {\n  // Account & audience\n  sync_accounts: 'syncAccounts',\n  list_accounts: 'listAccounts',\n  sync_audiences: 'syncAudiences',\n\n  // Product discovery & media buy\n  get_products: 'getProducts',\n  create_media_buy: 'createMediaBuy',\n  update_media_buy: 'updateMediaBuy',\n  get_media_buys: 'getMediaBuys',\n  get_media_buy_delivery: 'getMediaBuyDelivery',\n  provide_performance_feedback: 'providePerformanceFeedback',\n\n  // Creative\n  list_creative_formats: 'listCreativeFormats',\n  build_creative: 'buildCreative',\n  preview_creative: 'previewCreative',\n  sync_creatives: 'syncCreatives',\n  list_creatives: 'listCreatives',\n\n  // Signals\n  get_signals: 'getSignals',\n  activate_signal: 'activateSignal',\n\n  // Capabilities\n  get_adcp_capabilities: 'getAdcpCapabilities',\n\n  // Governance\n  sync_plans: 'syncPlans',\n  check_governance: 'checkGovernance',\n  get_plan_audit_logs: 'getPlanAuditLogs',\n  create_property_list: 'createPropertyList',\n  get_property_list: 'getPropertyList',\n  update_property_list: 'updatePropertyList',\n  list_property_lists: 'listPropertyLists',\n  delete_property_list: 'deletePropertyList',\n  list_collection_lists: 'listCollectionLists',\n  list_content_standards: 'listContentStandards',\n  get_content_standards: 'getContentStandards',\n  create_content_standards: 'createContentStandards',\n  update_content_standards: 'updateContentStandards',\n  calibrate_content: 'calibrateContent',\n  validate_content_delivery: 'validateContentDelivery',\n\n  // Account\n  get_account_financials: 'getAccountFinancials',\n  log_event: 'logEvent',\n\n  // Sponsored Intelligence\n  si_get_offering: 'siGetOffering',\n  si_initiate_session: 'siInitiateSession',\n  si_send_message: 'siSendMessage',\n  si_terminate_session: 'siTerminateSession',\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction readAdcpError(value: unknown): AdcpErrorInfo | undefined {\n  if (!isRecord(value)) return undefined;\n  const error = value.adcp_error;\n  if (!isRecord(error) || typeof error.code !== 'string') return undefined;\n  return error as unknown as AdcpErrorInfo;\n}\n\nfunction readFirstError(value: unknown): AdcpErrorInfo | undefined {\n  if (!isRecord(value) || !Array.isArray(value.errors)) return undefined;\n  const first = value.errors[0];\n  if (!isRecord(first) || typeof first.code !== 'string') return undefined;\n  return {\n    code: first.code,\n    message: typeof first.message === 'string' ? first.message : String(first.code),\n    ...(typeof first.recovery === 'string' && { recovery: first.recovery as AdcpErrorInfo['recovery'] }),\n    ...(typeof first.field === 'string' && { field: first.field }),\n    ...(typeof first.suggestion === 'string' && { suggestion: first.suggestion }),\n    ...(typeof first.retry_after === 'number' && { retry_after: first.retry_after }),\n    ...(isRecord(first.details) && { details: first.details }),\n  };\n}\n\nfunction errorMessageFrom(error: AdcpErrorInfo | undefined, fallback: unknown): string | undefined {\n  if (typeof error?.message === 'string' && error.message.length > 0) return error.message;\n  if (typeof error?.code === 'string') return error.code;\n  return typeof fallback === 'string' && fallback.length > 0 ? fallback : undefined;\n}\n\nfunction normalizeStoryboardTaskSuccess(\n  result: unknown,\n  taskName: string,\n  terminalDataError?: boolean,\n  adcpError?: AdcpErrorInfo\n): boolean {\n  if (!isRecord(result)) return true;\n  if (typeof result.success === 'boolean') return result.success;\n  if (result.status === 'failed' || result.status === 'rejected') return false;\n  if (adcpError || result.adcpError || result.adcp_error) return false;\n  if (terminalDataError ?? isTerminalAdcpError(result.data, taskName)) return false;\n  return true;\n}\n\n/**\n * Execute a storyboard task against a SingleAgentClient.\n *\n * Uses the typed method if one exists, otherwise falls back to executeTask().\n * When the agent returns an async status (working/submitted), waits for\n * completion before returning — storyboard steps expect final results.\n */\nexport async function executeStoryboardTask(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic dispatch requires any\n  client: any,\n  taskName: string,\n  params: Record<string, unknown>,\n  opts: { skipIdempotencyAutoInject?: boolean; skipAccountValidation?: boolean; signal?: AbortSignal } = {}\n): Promise<TaskResult> {\n  const methodName = Object.hasOwn(TASK_TO_METHOD, taskName) ? TASK_TO_METHOD[taskName] : undefined;\n\n  // Only pass TaskOptions when a flag is actually set — avoids changing\n  // behavior for the common path that relies on method defaults.\n  const taskOptions =\n    opts.skipIdempotencyAutoInject || opts.skipAccountValidation\n      ? {\n          ...(opts.skipIdempotencyAutoInject && { skipIdempotencyAutoInject: true }),\n          ...(opts.skipAccountValidation && { skipAccountValidation: true }),\n        }\n      : undefined;\n\n  let result;\n  const invoke = async () => {\n    if (methodName && typeof client[methodName] === 'function') {\n      // Typed methods take (params, inputHandler?, options?). Pass options\n      // only when set, otherwise they take their defaults.\n      return taskOptions ? client[methodName](params, undefined, taskOptions) : client[methodName](params);\n    }\n    return client.executeTask(taskName, params, undefined, taskOptions);\n  };\n\n  // Retry with exponential backoff on rate limit errors\n  const MAX_RETRIES = 3;\n  const BASE_DELAY_MS = 2000;\n  for (let attempt = 0; ; attempt++) {\n    try {\n      result = await raceWithSignal(invoke(), opts.signal);\n      break;\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      const isRateLimit =\n        /rate limit/i.test(msg) || (/\"code\":\\s*-32000/.test(msg) && /rate.?limit|too many|throttl/i.test(msg));\n      if (isRateLimit && attempt < MAX_RETRIES) {\n        const jitter = Math.random() * 1000;\n        const delay = BASE_DELAY_MS * 2 ** attempt + jitter;\n        await raceWithSignal(new Promise(resolve => setTimeout(resolve, delay)), opts.signal);\n        continue;\n      }\n      throw err;\n    }\n  }\n\n  // If the agent returned an async status but included data in the initial\n  // response (common for agents that process synchronously but report as\n  // submitted), use that data. Only poll when there's no data at all.\n  const hasData = result.data !== undefined && result.data !== null;\n  const isAsync = result.status === 'submitted' || result.status === 'working';\n  const prePollingDebugLogs = Array.isArray(result.debug_logs) ? [...result.debug_logs] : [];\n  let replacedByPolling = false;\n  if (!hasData && isAsync && result.submitted?.waitForCompletion) {\n    try {\n      const timeout = new Promise<never>((_, reject) =>\n        setTimeout(() => reject(new Error('Task polling timeout')), 30_000)\n      );\n      result = await raceWithSignal(\n        Promise.race([result.submitted.waitForCompletion(2000, opts.signal), timeout]),\n        opts.signal\n      );\n      replacedByPolling = true;\n    } catch (err) {\n      if (opts.signal?.aborted) throw err;\n      // Polling failed or timed out — return the intermediate result as-is\n    }\n  }\n\n  const terminalDataError = isTerminalAdcpError(result.data, taskName);\n  const adcpError =\n    result.adcpError ??\n    result.adcp_error ??\n    readAdcpError(result.data) ??\n    (terminalDataError ? readFirstError(result.data) : undefined);\n  const data = result.data ?? (adcpError ? { adcp_error: adcpError } : undefined);\n  const success = normalizeStoryboardTaskSuccess(result, taskName, terminalDataError, adcpError);\n  const error = result.error ?? (!success ? errorMessageFrom(adcpError, undefined) : undefined);\n  const extractionPath = readExtractionPath(data);\n  const debugLogs = Array.isArray(result.debug_logs) ? result.debug_logs : [];\n  const mergedDebugLogs = replacedByPolling ? [...prePollingDebugLogs, ...debugLogs] : debugLogs;\n  return {\n    success,\n    data,\n    error,\n    ...(adcpError && { adcp_error: adcpError }),\n    ...(extractionPath !== undefined && { _extraction_path: extractionPath }),\n    ...(mergedDebugLogs.length > 0 && { debug_logs: mergedDebugLogs }),\n  };\n}\n\nfunction raceWithSignal<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {\n  if (!signal) return promise;\n  if (signal.aborted) return Promise.reject(signal.reason ?? new Error('aborted'));\n\n  return new Promise<T>((resolve, reject) => {\n    const onAbort = () => reject(signal.reason ?? new Error('aborted'));\n    signal.addEventListener('abort', onAbort, { once: true });\n    promise.then(\n      value => {\n        signal.removeEventListener('abort', onAbort);\n        resolve(value);\n      },\n      err => {\n        signal.removeEventListener('abort', onAbort);\n        reject(err);\n      }\n    );\n  });\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../../src/lib/testing/storyboard/task-map.ts"],"sourcesContent":["/**\n * Maps AdCP task names (from storyboard YAML) to SingleAgentClient method names.\n *\n * Each storyboard step has a `task` field like \"sync_accounts\" or \"get_products\".\n * This map resolves those to the camelCase method on SingleAgentClient.\n *\n * Tasks without a dedicated method fall through to `executeTask()`.\n */\n\nimport type { TaskResult } from '../types';\nimport type { AdcpErrorInfo } from '../../core/ConversationTypes';\nimport { isTerminalAdcpError, readExtractionPath } from '../../utils/response-unwrapper';\n\n/**\n * Map of AdCP task names to SingleAgentClient method names.\n * Only includes tasks that have dedicated typed methods.\n */\nexport const TASK_TO_METHOD: Record<string, string> = {\n  // Account & audience\n  sync_accounts: 'syncAccounts',\n  list_accounts: 'listAccounts',\n  sync_audiences: 'syncAudiences',\n\n  // Product discovery & media buy\n  get_products: 'getProducts',\n  create_media_buy: 'createMediaBuy',\n  update_media_buy: 'updateMediaBuy',\n  get_media_buys: 'getMediaBuys',\n  get_media_buy_delivery: 'getMediaBuyDelivery',\n  provide_performance_feedback: 'providePerformanceFeedback',\n\n  // Creative\n  list_creative_formats: 'listCreativeFormats',\n  build_creative: 'buildCreativeLegacy',\n  preview_creative: 'previewCreativeLegacy',\n  sync_creatives: 'syncCreatives',\n  list_creatives: 'listCreatives',\n\n  // Signals\n  get_signals: 'getSignals',\n  activate_signal: 'activateSignal',\n\n  // Capabilities\n  get_adcp_capabilities: 'getAdcpCapabilities',\n\n  // Governance\n  sync_plans: 'syncPlans',\n  check_governance: 'checkGovernance',\n  get_plan_audit_logs: 'getPlanAuditLogs',\n  create_property_list: 'createPropertyList',\n  get_property_list: 'getPropertyList',\n  update_property_list: 'updatePropertyList',\n  list_property_lists: 'listPropertyLists',\n  delete_property_list: 'deletePropertyList',\n  list_collection_lists: 'listCollectionLists',\n  list_content_standards: 'listContentStandards',\n  get_content_standards: 'getContentStandards',\n  create_content_standards: 'createContentStandards',\n  update_content_standards: 'updateContentStandards',\n  calibrate_content: 'calibrateContent',\n  validate_content_delivery: 'validateContentDelivery',\n\n  // Account\n  get_account_financials: 'getAccountFinancials',\n  log_event: 'logEvent',\n\n  // Sponsored Intelligence\n  si_get_offering: 'siGetOffering',\n  si_initiate_session: 'siInitiateSession',\n  si_send_message: 'siSendMessage',\n  si_terminate_session: 'siTerminateSession',\n};\n\n/** Storyboards grade the selected protocol wire, not the SDK's canonical API. */\nconst LEGACY_CREATIVE_TASK_TO_METHOD: Readonly<Record<string, string>> = {\n  get_products: 'getProductsLegacy',\n  create_media_buy: 'createMediaBuyLegacy',\n  update_media_buy: 'updateMediaBuyLegacy',\n  sync_creatives: 'syncCreativesLegacy',\n  list_creatives: 'listCreativesLegacy',\n};\n\nfunction gradesLegacyCreativeWire(client: unknown): boolean {\n  if (client === null || typeof client !== 'object') return false;\n  const getAdcpVersion = (client as { getAdcpVersion?: unknown }).getAdcpVersion;\n  if (typeof getAdcpVersion !== 'function') return false;\n  let version: unknown;\n  try {\n    version = getAdcpVersion.call(client);\n  } catch {\n    return false;\n  }\n  if (typeof version !== 'string') return false;\n  const match = /^v?(\\d+)(?:\\.(\\d+))?/.exec(version.trim());\n  if (!match) return false;\n  const major = Number(match[1]);\n  const minor = Number(match[2] ?? 0);\n  return major < 3 || (major === 3 && minor < 2);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction withLegacyCreativeWireHint(params: Record<string, unknown>): Record<string, unknown> {\n  const ext = isRecord(params.ext) ? params.ext : {};\n  const adcp = isRecord(ext.adcp) ? ext.adcp : {};\n  if (adcp.creative_wire === 'legacy' || adcp.creative_wire === 'canonical') return params;\n  return {\n    ...params,\n    ext: {\n      ...ext,\n      adcp: { ...adcp, creative_wire: 'legacy' },\n    },\n  };\n}\n\nfunction readAdcpError(value: unknown): AdcpErrorInfo | undefined {\n  if (!isRecord(value)) return undefined;\n  const error = value.adcp_error;\n  if (!isRecord(error) || typeof error.code !== 'string') return undefined;\n  return error as unknown as AdcpErrorInfo;\n}\n\nfunction readFirstError(value: unknown): AdcpErrorInfo | undefined {\n  if (!isRecord(value) || !Array.isArray(value.errors)) return undefined;\n  const first = value.errors[0];\n  if (!isRecord(first) || typeof first.code !== 'string') return undefined;\n  return {\n    code: first.code,\n    message: typeof first.message === 'string' ? first.message : String(first.code),\n    ...(typeof first.recovery === 'string' && { recovery: first.recovery as AdcpErrorInfo['recovery'] }),\n    ...(typeof first.field === 'string' && { field: first.field }),\n    ...(typeof first.suggestion === 'string' && { suggestion: first.suggestion }),\n    ...(typeof first.retry_after === 'number' && { retry_after: first.retry_after }),\n    ...(isRecord(first.details) && { details: first.details }),\n  };\n}\n\nfunction errorMessageFrom(error: AdcpErrorInfo | undefined, fallback: unknown): string | undefined {\n  if (typeof error?.message === 'string' && error.message.length > 0) return error.message;\n  if (typeof error?.code === 'string') return error.code;\n  return typeof fallback === 'string' && fallback.length > 0 ? fallback : undefined;\n}\n\nfunction normalizeStoryboardTaskSuccess(\n  result: unknown,\n  taskName: string,\n  terminalDataError?: boolean,\n  adcpError?: AdcpErrorInfo\n): boolean {\n  if (!isRecord(result)) return true;\n  if (typeof result.success === 'boolean') return result.success;\n  if (result.status === 'failed' || result.status === 'rejected') return false;\n  if (adcpError || result.adcpError || result.adcp_error) return false;\n  if (terminalDataError ?? isTerminalAdcpError(result.data, taskName)) return false;\n  return true;\n}\n\n/**\n * Execute a storyboard task against a SingleAgentClient.\n *\n * Uses the typed method if one exists, otherwise falls back to executeTask().\n * When the agent returns an async status (working/submitted), waits for\n * completion before returning — storyboard steps expect final results.\n */\nexport async function executeStoryboardTask(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic dispatch requires any\n  client: any,\n  taskName: string,\n  params: Record<string, unknown>,\n  opts: { skipIdempotencyAutoInject?: boolean; skipAccountValidation?: boolean; signal?: AbortSignal } = {}\n): Promise<TaskResult> {\n  const legacyMethodName = gradesLegacyCreativeWire(client) ? LEGACY_CREATIVE_TASK_TO_METHOD[taskName] : undefined;\n  const methodName =\n    legacyMethodName ?? (Object.hasOwn(TASK_TO_METHOD, taskName) ? TASK_TO_METHOD[taskName] : undefined);\n  const callParams = legacyMethodName ? withLegacyCreativeWireHint(params) : params;\n\n  // Only pass TaskOptions when a flag is actually set — avoids changing\n  // behavior for the common path that relies on method defaults.\n  const taskOptions =\n    opts.skipIdempotencyAutoInject || opts.skipAccountValidation\n      ? {\n          ...(opts.skipIdempotencyAutoInject && { skipIdempotencyAutoInject: true }),\n          ...(opts.skipAccountValidation && { skipAccountValidation: true }),\n        }\n      : undefined;\n\n  let result;\n  const invoke = async () => {\n    if (methodName && typeof client[methodName] === 'function') {\n      // Typed methods take (params, inputHandler?, options?). Pass options\n      // only when set, otherwise they take their defaults.\n      return taskOptions ? client[methodName](callParams, undefined, taskOptions) : client[methodName](callParams);\n    }\n    return client.executeTask(taskName, callParams, undefined, taskOptions);\n  };\n\n  // Retry with exponential backoff on rate limit errors\n  const MAX_RETRIES = 3;\n  const BASE_DELAY_MS = 2000;\n  for (let attempt = 0; ; attempt++) {\n    try {\n      result = await raceWithSignal(invoke(), opts.signal);\n      break;\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      const isRateLimit =\n        /rate limit/i.test(msg) || (/\"code\":\\s*-32000/.test(msg) && /rate.?limit|too many|throttl/i.test(msg));\n      if (isRateLimit && attempt < MAX_RETRIES) {\n        const jitter = Math.random() * 1000;\n        const delay = BASE_DELAY_MS * 2 ** attempt + jitter;\n        await raceWithSignal(new Promise(resolve => setTimeout(resolve, delay)), opts.signal);\n        continue;\n      }\n      throw err;\n    }\n  }\n\n  // If the agent returned an async status but included data in the initial\n  // response (common for agents that process synchronously but report as\n  // submitted), use that data. Only poll when there's no data at all.\n  const hasData = result.data !== undefined && result.data !== null;\n  const isAsync = result.status === 'submitted' || result.status === 'working';\n  const prePollingDebugLogs = Array.isArray(result.debug_logs) ? [...result.debug_logs] : [];\n  let replacedByPolling = false;\n  if (!hasData && isAsync && result.submitted?.waitForCompletion) {\n    try {\n      const timeout = new Promise<never>((_, reject) =>\n        setTimeout(() => reject(new Error('Task polling timeout')), 30_000)\n      );\n      result = await raceWithSignal(\n        Promise.race([result.submitted.waitForCompletion(2000, opts.signal), timeout]),\n        opts.signal\n      );\n      replacedByPolling = true;\n    } catch (err) {\n      if (opts.signal?.aborted) throw err;\n      // Polling failed or timed out — return the intermediate result as-is\n    }\n  }\n\n  const terminalDataError = isTerminalAdcpError(result.data, taskName);\n  const adcpError =\n    result.adcpError ??\n    result.adcp_error ??\n    readAdcpError(result.data) ??\n    (terminalDataError ? readFirstError(result.data) : undefined);\n  const data = result.data ?? (adcpError ? { adcp_error: adcpError } : undefined);\n  const success = normalizeStoryboardTaskSuccess(result, taskName, terminalDataError, adcpError);\n  const error = result.error ?? (!success ? errorMessageFrom(adcpError, undefined) : undefined);\n  const extractionPath = readExtractionPath(data);\n  const debugLogs = Array.isArray(result.debug_logs) ? result.debug_logs : [];\n  const mergedDebugLogs = replacedByPolling ? [...prePollingDebugLogs, ...debugLogs] : debugLogs;\n  return {\n    success,\n    data,\n    error,\n    ...(adcpError && { adcp_error: adcpError }),\n    ...(extractionPath !== undefined && { _extraction_path: extractionPath }),\n    ...(mergedDebugLogs.length > 0 && { debug_logs: mergedDebugLogs }),\n  };\n}\n\nfunction raceWithSignal<T>(promise: Promise<T>, signal?: AbortSignal): Promise<T> {\n  if (!signal) return promise;\n  if (signal.aborted) return Promise.reject(signal.reason ?? new Error('aborted'));\n\n  return new Promise<T>((resolve, reject) => {\n    const onAbort = () => reject(signal.reason ?? new Error('aborted'));\n    signal.addEventListener('abort', onAbort, { once: true });\n    promise.then(\n      value => {\n        signal.removeEventListener('abort', onAbort);\n        resolve(value);\n      },\n      err => {\n        signal.removeEventListener('abort', onAbort);\n        reject(err);\n      }\n    );\n  });\n}\n"],"mappings":"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","names":[]}