@adcp/sdk 14.0.0-beta.10 → 14.0.0-beta.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/adcp-storyboard-sandbox.js +16 -0
- package/bin/adcp.js +28 -30
- package/dist/lib/core/AgentClient.d.ts.map +1 -1
- package/dist/lib/core/SingleAgentClient.d.mts +2 -1
- package/dist/lib/core/SingleAgentClient.d.ts +2 -1
- package/dist/lib/core/SingleAgentClient.d.ts.map +1 -1
- package/dist/lib/core/SingleAgentClient.js +113 -64
- package/dist/lib/core/SingleAgentClient.js.map +1 -1
- package/dist/lib/core/SingleAgentClient.mjs +113 -64
- package/dist/lib/core/SingleAgentClient.mjs.map +1 -1
- package/dist/lib/index.d.mts +1 -1
- package/dist/lib/index.d.ts +1 -1
- package/dist/lib/index.d.ts.map +1 -1
- package/dist/lib/index.js.map +1 -1
- package/dist/lib/index.mjs.map +1 -1
- package/dist/lib/protocols/a2a.d.mts +10 -3
- package/dist/lib/protocols/a2a.d.ts +10 -3
- package/dist/lib/protocols/a2a.d.ts.map +1 -1
- package/dist/lib/protocols/a2a.js +162 -34
- package/dist/lib/protocols/a2a.js.map +1 -1
- package/dist/lib/protocols/a2a.mjs +166 -34
- package/dist/lib/protocols/a2a.mjs.map +1 -1
- package/dist/lib/schemas/index.d.mts +385 -1
- package/dist/lib/schemas/index.d.ts +385 -1
- package/dist/lib/schemas/index.d.ts.map +1 -1
- package/dist/lib/schemas/index.js +13 -0
- package/dist/lib/schemas/index.js.map +1 -1
- package/dist/lib/schemas/index.mjs +11 -0
- package/dist/lib/schemas/index.mjs.map +1 -1
- package/dist/lib/schemas-data/v2.5/_provenance.json +1 -1
- package/dist/lib/server/a2a-adapter.d.mts +59 -33
- package/dist/lib/server/a2a-adapter.d.ts +59 -33
- package/dist/lib/server/a2a-adapter.d.ts.map +1 -1
- package/dist/lib/server/a2a-adapter.js +278 -67
- package/dist/lib/server/a2a-adapter.js.map +1 -1
- package/dist/lib/server/a2a-adapter.mjs +280 -68
- package/dist/lib/server/a2a-adapter.mjs.map +1 -1
- package/dist/lib/server/create-adcp-server.d.ts.map +1 -1
- package/dist/lib/server/create-adcp-server.js +35 -108
- package/dist/lib/server/create-adcp-server.js.map +1 -1
- package/dist/lib/server/create-adcp-server.mjs +37 -109
- package/dist/lib/server/create-adcp-server.mjs.map +1 -1
- package/dist/lib/server/decisioning/index.d.mts +2 -0
- package/dist/lib/server/decisioning/index.d.ts +2 -0
- package/dist/lib/server/decisioning/index.d.ts.map +1 -1
- package/dist/lib/server/decisioning/index.js +5 -2
- package/dist/lib/server/decisioning/index.js.map +1 -1
- package/dist/lib/server/decisioning/index.mjs +3 -1
- package/dist/lib/server/decisioning/index.mjs.map +1 -1
- package/dist/lib/server/decisioning/response-summary.d.mts +33 -0
- package/dist/lib/server/decisioning/response-summary.d.ts +34 -0
- package/dist/lib/server/decisioning/response-summary.d.ts.map +1 -0
- package/dist/lib/server/decisioning/response-summary.js +62 -0
- package/dist/lib/server/decisioning/response-summary.js.map +1 -0
- package/dist/lib/server/decisioning/response-summary.mjs +37 -0
- package/dist/lib/server/decisioning/response-summary.mjs.map +1 -0
- package/dist/lib/server/decisioning/runtime/from-platform.d.ts.map +1 -1
- package/dist/lib/server/decisioning/runtime/from-platform.js +27 -5
- package/dist/lib/server/decisioning/runtime/from-platform.js.map +1 -1
- package/dist/lib/server/decisioning/runtime/from-platform.mjs +27 -5
- package/dist/lib/server/decisioning/runtime/from-platform.mjs.map +1 -1
- package/dist/lib/server/decisioning/specialisms/sales.d.mts +7 -1
- package/dist/lib/server/decisioning/specialisms/sales.d.ts +7 -1
- package/dist/lib/server/decisioning/specialisms/sales.d.ts.map +1 -1
- package/dist/lib/server/decisioning/specialisms/sales.js.map +1 -1
- package/dist/lib/server/index.d.mts +1 -1
- package/dist/lib/server/index.d.ts +1 -1
- package/dist/lib/server/index.d.ts.map +1 -1
- package/dist/lib/server/index.js.map +1 -1
- package/dist/lib/server/index.mjs.map +1 -1
- package/dist/lib/server/responses.d.ts.map +1 -1
- package/dist/lib/server/responses.js +9 -1
- package/dist/lib/server/responses.js.map +1 -1
- package/dist/lib/server/responses.mjs +8 -1
- package/dist/lib/server/responses.mjs.map +1 -1
- package/dist/lib/signing/agent-context.d.mts +1 -0
- package/dist/lib/signing/agent-context.d.ts +1 -0
- package/dist/lib/signing/agent-context.d.ts.map +1 -1
- package/dist/lib/signing/agent-context.js +37 -2
- package/dist/lib/signing/agent-context.js.map +1 -1
- package/dist/lib/signing/agent-context.mjs +38 -3
- package/dist/lib/signing/agent-context.mjs.map +1 -1
- package/dist/lib/signing/agent-fetch.d.mts +1 -2
- package/dist/lib/signing/agent-fetch.d.ts +1 -2
- package/dist/lib/signing/agent-fetch.d.ts.map +1 -1
- package/dist/lib/signing/agent-fetch.js +2 -0
- package/dist/lib/signing/agent-fetch.js.map +1 -1
- package/dist/lib/signing/agent-fetch.mjs +2 -0
- package/dist/lib/signing/agent-fetch.mjs.map +1 -1
- package/dist/lib/signing/agent-resolver/etld.js.map +1 -1
- package/dist/lib/signing/agent-resolver/etld.mjs.map +1 -1
- package/dist/lib/testing/client.d.mts +6 -0
- package/dist/lib/testing/client.d.ts +6 -0
- package/dist/lib/testing/client.d.ts.map +1 -1
- package/dist/lib/testing/client.js +76 -4
- package/dist/lib/testing/client.js.map +1 -1
- package/dist/lib/testing/client.mjs +75 -4
- package/dist/lib/testing/client.mjs.map +1 -1
- package/dist/lib/testing/compliance/comply.d.ts.map +1 -1
- package/dist/lib/testing/compliance/comply.js +6 -0
- package/dist/lib/testing/compliance/comply.js.map +1 -1
- package/dist/lib/testing/compliance/comply.mjs +7 -1
- package/dist/lib/testing/compliance/comply.mjs.map +1 -1
- package/dist/lib/testing/storyboard/context.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/context.js +9 -4
- package/dist/lib/testing/storyboard/context.js.map +1 -1
- package/dist/lib/testing/storyboard/context.mjs +9 -4
- package/dist/lib/testing/storyboard/context.mjs.map +1 -1
- package/dist/lib/testing/storyboard/request-builder.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/request-builder.js +28 -4
- package/dist/lib/testing/storyboard/request-builder.js.map +1 -1
- package/dist/lib/testing/storyboard/request-builder.mjs +28 -4
- package/dist/lib/testing/storyboard/request-builder.mjs.map +1 -1
- package/dist/lib/testing/storyboard/request-signing/functional-dispatch.d.mts +15 -0
- package/dist/lib/testing/storyboard/request-signing/functional-dispatch.d.ts +16 -0
- package/dist/lib/testing/storyboard/request-signing/functional-dispatch.d.ts.map +1 -0
- package/dist/lib/testing/storyboard/request-signing/functional-dispatch.js +106 -0
- package/dist/lib/testing/storyboard/request-signing/functional-dispatch.js.map +1 -0
- package/dist/lib/testing/storyboard/request-signing/functional-dispatch.mjs +82 -0
- package/dist/lib/testing/storyboard/request-signing/functional-dispatch.mjs.map +1 -0
- package/dist/lib/testing/storyboard/request-signing/test-kit.d.mts +15 -0
- package/dist/lib/testing/storyboard/request-signing/test-kit.d.ts +15 -0
- package/dist/lib/testing/storyboard/request-signing/test-kit.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/request-signing/test-kit.js +58 -0
- package/dist/lib/testing/storyboard/request-signing/test-kit.js.map +1 -1
- package/dist/lib/testing/storyboard/request-signing/test-kit.mjs +58 -0
- package/dist/lib/testing/storyboard/request-signing/test-kit.mjs.map +1 -1
- package/dist/lib/testing/storyboard/request-signing/vector-loader.d.mts +2 -0
- package/dist/lib/testing/storyboard/request-signing/vector-loader.d.ts +2 -0
- package/dist/lib/testing/storyboard/request-signing/vector-loader.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/request-signing/vector-loader.js +7 -1
- package/dist/lib/testing/storyboard/request-signing/vector-loader.js.map +1 -1
- package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs +6 -1
- package/dist/lib/testing/storyboard/request-signing/vector-loader.mjs.map +1 -1
- package/dist/lib/testing/storyboard/runner.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/runner.js +31 -7
- package/dist/lib/testing/storyboard/runner.js.map +1 -1
- package/dist/lib/testing/storyboard/runner.mjs +31 -7
- package/dist/lib/testing/storyboard/runner.mjs.map +1 -1
- package/dist/lib/testing/storyboard/validations.d.mts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts +1 -1
- package/dist/lib/testing/storyboard/validations.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/validations.js +18 -7
- package/dist/lib/testing/storyboard/validations.js.map +1 -1
- package/dist/lib/testing/storyboard/validations.mjs +18 -7
- package/dist/lib/testing/storyboard/validations.mjs.map +1 -1
- package/dist/lib/testing/storyboard/webhook-receiver.d.ts.map +1 -1
- package/dist/lib/testing/storyboard/webhook-receiver.js +32 -20
- package/dist/lib/testing/storyboard/webhook-receiver.js.map +1 -1
- package/dist/lib/testing/storyboard/webhook-receiver.mjs +32 -20
- package/dist/lib/testing/storyboard/webhook-receiver.mjs.map +1 -1
- package/dist/lib/testing/types.d.mts +10 -0
- package/dist/lib/testing/types.d.ts +10 -0
- package/dist/lib/testing/types.d.ts.map +1 -1
- package/dist/lib/testing/types.js.map +1 -1
- package/dist/lib/types/comply-test-controller.d.ts +1 -14
- package/dist/lib/types/core.generated.d.mts +1 -1
- package/dist/lib/types/core.generated.d.ts +1 -1
- package/dist/lib/types/core.generated.d.ts.map +1 -1
- package/dist/lib/types/core.generated.js.map +1 -1
- package/dist/lib/types/get-products.d.ts +1 -14
- package/dist/lib/types/schemas.generated.d.ts +519 -571
- package/dist/lib/types/schemas.generated.d.ts.map +1 -1
- package/dist/lib/types/schemas.generated.js +2 -2
- package/dist/lib/types/schemas.generated.js.map +1 -1
- package/dist/lib/types/schemas.generated.mjs +2 -2
- package/dist/lib/types/schemas.generated.mjs.map +1 -1
- package/dist/lib/types/tools.generated.d.mts +1 -1
- package/dist/lib/types/tools.generated.d.ts +1 -1
- package/dist/lib/types/tools.generated.d.ts.map +1 -1
- package/dist/lib/types/tools.generated.js.map +1 -1
- package/dist/lib/utils/a2a-artifacts.d.ts.map +1 -1
- package/dist/lib/utils/a2a-artifacts.js +2 -2
- package/dist/lib/utils/a2a-artifacts.js.map +1 -1
- package/dist/lib/utils/a2a-artifacts.mjs +2 -2
- package/dist/lib/utils/a2a-artifacts.mjs.map +1 -1
- package/dist/lib/utils/a2a-discovery.d.mts +3 -3
- package/dist/lib/utils/a2a-discovery.d.ts +3 -3
- package/dist/lib/utils/a2a-discovery.js +1 -1
- package/dist/lib/utils/a2a-discovery.js.map +1 -1
- package/dist/lib/utils/a2a-discovery.mjs +1 -1
- package/dist/lib/utils/a2a-discovery.mjs.map +1 -1
- package/dist/lib/utils/tool-request-schemas.d.mts +31 -31
- package/dist/lib/utils/tool-request-schemas.d.ts +31 -31
- package/dist/lib/v2/projection/index.d.mts +2 -0
- package/dist/lib/v2/projection/index.d.ts +2 -0
- package/dist/lib/v2/projection/index.d.ts.map +1 -1
- package/dist/lib/v2/projection/index.js +3 -0
- package/dist/lib/v2/projection/index.js.map +1 -1
- package/dist/lib/v2/projection/index.mjs +2 -0
- package/dist/lib/v2/projection/index.mjs.map +1 -1
- package/dist/lib/v2/projection/legacy-normalization.d.mts +24 -0
- package/dist/lib/v2/projection/legacy-normalization.d.ts +25 -0
- package/dist/lib/v2/projection/legacy-normalization.d.ts.map +1 -0
- package/dist/lib/v2/projection/legacy-normalization.js +32 -0
- package/dist/lib/v2/projection/legacy-normalization.js.map +1 -0
- package/dist/lib/v2/projection/legacy-normalization.mjs +8 -0
- package/dist/lib/v2/projection/legacy-normalization.mjs.map +1 -0
- package/dist/lib/version.d.mts +3 -3
- package/dist/lib/version.d.ts +3 -3
- package/dist/lib/version.js +3 -3
- package/dist/lib/version.js.map +1 -1
- package/dist/lib/version.mjs +3 -3
- package/dist/lib/version.mjs.map +1 -1
- package/docs/guides/BUILD-AN-AGENT.md +42 -6
- package/docs/llms.txt +2 -2
- package/docs/migration-13-to-14.md +17 -0
- package/package.json +44 -41
|
@@ -40,6 +40,8 @@ import { createIdempotencyStore } from "../../idempotency/index.mjs";
|
|
|
40
40
|
import { pgBackend, getIdempotencyMigration } from "../../idempotency/backends/pg.mjs";
|
|
41
41
|
import { createPostgresTaskRegistry, getDecisioningTaskRegistryMigration } from "./postgres-task-registry.mjs";
|
|
42
42
|
import { isTaskHandoff, _extractHandoffEntry } from "../async-outcome.mjs";
|
|
43
|
+
import { _extractResponseSummaryEntry } from "../response-summary.mjs";
|
|
44
|
+
import { productsResponse } from "../../responses.mjs";
|
|
43
45
|
import { TOOL_ENTITY_FIELDS } from "./entity-hydration.generated.mjs";
|
|
44
46
|
import { z } from "zod";
|
|
45
47
|
import { createInMemoryTaskRegistry } from "./task-registry.mjs";
|
|
@@ -2431,6 +2433,9 @@ async function runWithTokenRefresh(fn, refresh) {
|
|
|
2431
2433
|
async function projectSync(fn, mapResult, refresh) {
|
|
2432
2434
|
try {
|
|
2433
2435
|
const result = await runWithTokenRefresh(fn, refresh);
|
|
2436
|
+
if (_extractResponseSummaryEntry(result)) {
|
|
2437
|
+
throw new TypeError("withResponseSummary is supported only for synchronous getProducts results");
|
|
2438
|
+
}
|
|
2434
2439
|
const wire = mapResult(result);
|
|
2435
2440
|
if (wire != null && typeof wire === "object") {
|
|
2436
2441
|
stripCtxMetadata(wire);
|
|
@@ -2498,9 +2503,15 @@ function isReturnedErrorArm(value) {
|
|
|
2498
2503
|
return Object.keys(record).every((key) => RETURNED_ERROR_ARM_KEYS.has(key));
|
|
2499
2504
|
}
|
|
2500
2505
|
async function routeIfHandoff(taskRegistry, opts, result, project) {
|
|
2506
|
+
const rejectResponseSummary = (value) => {
|
|
2507
|
+
if (_extractResponseSummaryEntry(value)) {
|
|
2508
|
+
throw new TypeError("withResponseSummary is supported only for synchronous getProducts results");
|
|
2509
|
+
}
|
|
2510
|
+
};
|
|
2501
2511
|
if (isTaskHandoff(result)) {
|
|
2502
2512
|
const entry = _extractHandoffEntry(result);
|
|
2503
2513
|
if (!entry) {
|
|
2514
|
+
rejectResponseSummary(result);
|
|
2504
2515
|
return await project(result);
|
|
2505
2516
|
}
|
|
2506
2517
|
const { fn: taskFn, options } = entry;
|
|
@@ -2509,12 +2520,14 @@ async function routeIfHandoff(taskRegistry, opts, result, project) {
|
|
|
2509
2520
|
opts,
|
|
2510
2521
|
async (taskId) => {
|
|
2511
2522
|
const inner = await taskFn(buildHandoffContext(taskRegistry, taskId));
|
|
2523
|
+
rejectResponseSummary(inner);
|
|
2512
2524
|
return await project(inner);
|
|
2513
2525
|
},
|
|
2514
2526
|
options?.task_id
|
|
2515
2527
|
);
|
|
2516
2528
|
}
|
|
2517
2529
|
rejectHandRolledSubmitted(result);
|
|
2530
|
+
rejectResponseSummary(result);
|
|
2518
2531
|
return await project(result);
|
|
2519
2532
|
}
|
|
2520
2533
|
async function dispatchHitl(taskRegistry, opts, taskFn, overrideTaskId) {
|
|
@@ -3328,6 +3341,11 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
|
|
|
3328
3341
|
} else {
|
|
3329
3342
|
result = await sales.getProducts(canonicalParams, reqCtx);
|
|
3330
3343
|
}
|
|
3344
|
+
const summarized = _extractResponseSummaryEntry(result);
|
|
3345
|
+
if (summarized && (isTaskHandoff(summarized.payload) || _extractResponseSummaryEntry(summarized.payload) !== void 0)) {
|
|
3346
|
+
throw new TypeError("withResponseSummary may wrap only a synchronous getProducts payload");
|
|
3347
|
+
}
|
|
3348
|
+
const resultForRouting = summarized?.payload ?? result;
|
|
3331
3349
|
const projectProducts = async (terminalResult) => {
|
|
3332
3350
|
const preparedProjection = preparePerProductProjectionCatalogs(terminalResult, legacyFormatConverter);
|
|
3333
3351
|
const requestLegacyFormatConverter = await resolveLegacyProductFormats(
|
|
@@ -3360,14 +3378,18 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
|
|
|
3360
3378
|
ctx: reqCtx
|
|
3361
3379
|
});
|
|
3362
3380
|
}
|
|
3363
|
-
|
|
3381
|
+
const wireResponse = asProductResponseForWire(
|
|
3364
3382
|
canonicalResult,
|
|
3365
3383
|
responseWireMode,
|
|
3366
3384
|
canonicalFormatLegacyResolver,
|
|
3367
3385
|
shouldEmitTransitionalDualCreativeWire(ctx.servedAdcpVersion, params)
|
|
3368
3386
|
);
|
|
3387
|
+
return summarized ? productsResponse(
|
|
3388
|
+
wireResponse,
|
|
3389
|
+
summarized.summary
|
|
3390
|
+
) : wireResponse;
|
|
3369
3391
|
};
|
|
3370
|
-
const isHandoff = isTaskHandoff(
|
|
3392
|
+
const isHandoff = isTaskHandoff(resultForRouting);
|
|
3371
3393
|
if (buyingMode === "wholesale" && isHandoff) {
|
|
3372
3394
|
throw new AdcpError("INVALID_REQUEST", {
|
|
3373
3395
|
message: "get_products buying_mode=wholesale must return synchronously; use incomplete[] for partial feed results.",
|
|
@@ -3376,8 +3398,8 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
|
|
|
3376
3398
|
});
|
|
3377
3399
|
}
|
|
3378
3400
|
if (!isHandoff && push.url === void 0) {
|
|
3379
|
-
rejectHandRolledSubmitted(
|
|
3380
|
-
return projectProducts(
|
|
3401
|
+
rejectHandRolledSubmitted(resultForRouting);
|
|
3402
|
+
return projectProducts(resultForRouting);
|
|
3381
3403
|
}
|
|
3382
3404
|
const accountId = reqCtx.account?.id;
|
|
3383
3405
|
if (accountId === void 0) {
|
|
@@ -3402,7 +3424,7 @@ function buildMediaBuyHandlers(platform, taskRegistry, taskWebhookEmit, observab
|
|
|
3402
3424
|
observability,
|
|
3403
3425
|
logger
|
|
3404
3426
|
},
|
|
3405
|
-
|
|
3427
|
+
resultForRouting,
|
|
3406
3428
|
projectProducts
|
|
3407
3429
|
);
|
|
3408
3430
|
},
|