@apostra/sdk 0.40.0 → 0.41.0

package/dist/generated/metadata.d.ts

@@ -1,4 +1,4 @@
-export declare const version = "0.40.0";
+export declare const version = "0.41.0";
 export declare const baseUrl = "https://api.apostra.com/api/v3";
 export declare const m2mTokenUrl = "https://identity.scope3.com/oauth2/token";
 export declare const operations: {
@@ -178,7 +178,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:read"];
         }];
-        readonly summary: "Current account, state, blockers, exact fixes, and reachable accounts. For seller demand, use it to tell whether readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand. A Developer account adds each agent's stage, blocker, and next call.";
+        readonly summary: "Current account, state, blockers, exact fixes, accounts to pick from. For seller demand, tells if readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand. A Developer account adds each agent's stage, blocker, next call.";
     };
     readonly log_event: {
         readonly path: "/tools/log_event";
@@ -209,20 +209,6 @@ export declare const operations: {
         }];
         readonly summary: "Open the Advertisers Page: every advertiser with its campaign and draft counts and one next action each. Use it for \"show my advertisers\" or \"where do I start\"; the Page self-fetches. To add or set up an advertiser, pass intent: \"add\". For a text answer use search(kind: \"advertiser\").";
     };
-    readonly open_agent_certification_page: {
-        readonly path: "/tools/open_agent_certification_page";
-        readonly method: "POST";
-        readonly body: true;
-        readonly binary: false;
-        readonly idempotencyKey: false;
-        readonly parameters: readonly [];
-        readonly security: readonly [{
-            readonly apiKeyAuth: readonly [];
-        }, {
-            readonly m2mOAuth: readonly ["interchange:read"];
-        }];
-        readonly summary: "Open one agent’s Test & certify Page: live certification per use case, recent test runs, AdCP 4.0 readiness and capability declarations. Read-only.";
-    };
     readonly open_agent_page: {
         readonly path: "/tools/open_agent_page";
         readonly method: "POST";
@@ -361,7 +347,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:read"];
         }];
-        readonly summary: "Open Creative Library. Use search for a plain object answer. Composer needs campaignId; assembly needs no Creative Engine. To save a draft, use exactly one format: a canonical format such as image, hosted video, or hosted audio, or a seller format.";
+        readonly summary: "Open Creative Library. Use search for a plain object answer. The composer can start from an advertiser or a campaign and does not need a Creative Engine. To save a draft, use exactly one format: a canonical format such as image, hosted video, or hosted audio, or a seller format.";
     };
     readonly open_developer_home: {
         readonly path: "/tools/open_developer_home";
@@ -473,7 +459,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:write"];
         }];
-        readonly summary: "Rechecks one external sales-agent source with no-spend get_products and, if it publishes one, a catalog refresh. Returns each check, findings still open, evidence IDs and readiness; no source configuration or media buy.";
+        readonly summary: "Rechecks one external sales-agent source with no-spend get_products and, if it publishes one, a catalog refresh. Returns each check, findings still open, evidence IDs and readiness; no source configuration or media buy. scope accounts re-lists the source's accounts instead.";
     };
     readonly request_buyer_child_account: {
         readonly path: "/tools/request_buyer_child_account";
@@ -629,7 +615,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:read"];
         }];
-        readonly summary: "File or update a typed ask in the Apostra Support workflow; returns askId. Supply is buyer inventory. Call immediately with type support when a person explicitly asks for a human; do not diagnose first.";
+        readonly summary: "File or update a typed ask in the Apostra Support workflow; returns askId. kind create files a new ask; kind update sends only id and requester. Supply is buyer inventory. Call immediately with type support when a person explicitly asks for a human; do not diagnose first.";
     };
     readonly save_audience: {
         readonly path: "/tools/save_audience";
@@ -757,7 +743,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:write"];
         }];
-        readonly summary: "Declare publisher domains this Seller sells and its claimed properties. `domains` replaces the complete set; `add`, `remove`, `declareProperties`, and `removeProperties` change named items only. Read authorization; never assume it.";
+        readonly summary: "Declare publisher domains this Seller sells and its claimed properties. `domains` replaces the complete set; `add`, `remove`, `declareProperties`, `removeProperties`, and `refresh` act on named items only. Read authorization; never assume it.";
     };
     readonly save_creative: {
         readonly path: "/tools/save_creative";
@@ -771,7 +757,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:write"];
         }];
-        readonly summary: "advertiserId/campaignId:name,message;assets/landing_page_url/social/sourceAssetRef/sourceAssets;Supplied content/assets only;generate new media (radio spots):save_creative_session;exactly one format selector:formatKind/formatParams,creativeFormatId/formatOptionRef;libraryRole:Buyer Account only.";
+        readonly summary: "Save content you supply: advertiserId/campaignId, name, message, assets (landing_page_url, social, sourceAssetRef/sourceAssets). New media like radio spots: use save_creative_session. One format selector: formatKind+formatParams or creativeFormatId+formatOptionRef. libraryRole: Buyer Account only.";
     };
     readonly save_creative_collection: {
         readonly path: "/tools/save_creative_collection";
@@ -857,7 +843,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:write"];
         }];
-        readonly summary: "Create or update where a seller's inventory comes from. Pass `id` to change a source or omit it to add one. Pass only `agentId` or `adServer` to open the form that connects an agent or an ad server. Credentials are never passed here; a source that needs one returns the page that collects it.";
+        readonly summary: "Create or update where a seller's inventory comes from. Pass `id` to change a source or omit it to add one. Add a sales agent with only `agentId`, never its address, or an ad server with only `adServer`; each opens a form. Credentials are never passed here; a source that needs one returns its form.";
     };
     readonly save_lesson: {
         readonly path: "/tools/save_lesson";
@@ -914,7 +900,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:write"];
         }];
-        readonly summary: "Create DRAFT buy; no spend until confirmed. Meta: shared campaign=seller_optimized; ad sets=fixed; ask if unclear. Shared: omit buy/product budgets. Pause/resume: mediaBuyId + isPaused. Proposal: flight + total budget; omit products. channelGroupId: required if grouped; invalid ungrouped/updates.";
+        readonly summary: "Create DRAFT buy; no spend until confirmed. Meta: shared campaign=seller_optimized; ad sets=fixed; ask if unclear. Shared: omit product budgets. Pause/resume: mediaBuyId + isPaused. Proposal: flight + total budget; omit products. channelGroupId: required if grouped; invalid ungrouped/updates.";
     };
     readonly save_media_kit: {
         readonly path: "/tools/save_media_kit";
@@ -1014,7 +1000,7 @@ export declare const operations: {
         }, {
             readonly m2mOAuth: readonly ["interchange:write"];
         }];
-        readonly summary: "Save Seller identity, capabilities, Apostra listing, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, an admission, or the intake hold. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get(kind:\"distribution\").";
+        readonly summary: "Save Seller identity, capabilities, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, an admission, the intake hold, or the demo's expiry and sample sources. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get.";
     };
     readonly save_signal: {
         readonly path: "/tools/save_signal";

package/dist/generated/metadata.js

@@ -1,5 +1,5 @@
 // Generated. Do not edit.
-export const version = '0.40.0';
+export const version = '0.41.0';
 export const baseUrl = "https://api.apostra.com/api/v3";
 export const m2mTokenUrl = "https://identity.scope3.com/oauth2/token";
 export const operations = {
@@ -244,7 +244,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "Current account, state, blockers, exact fixes, and reachable accounts. For seller demand, use it to tell whether readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand. A Developer account adds each agent's stage, blocker, and next call."
+        "summary": "Current account, state, blockers, exact fixes, accounts to pick from. For seller demand, tells if readiness stops requests before source calls; read before diagnosing source health, empty responses, or demand. A Developer account adds each agent's stage, blocker, next call."
     },
     "log_event": {
         "path": "/tools/log_event",
@@ -285,25 +285,6 @@ export const operations = {
         ],
         "summary": "Open the Advertisers Page: every advertiser with its campaign and draft counts and one next action each. Use it for \"show my advertisers\" or \"where do I start\"; the Page self-fetches. To add or set up an advertiser, pass intent: \"add\". For a text answer use search(kind: \"advertiser\")."
     },
-    "open_agent_certification_page": {
-        "path": "/tools/open_agent_certification_page",
-        "method": "POST",
-        "body": true,
-        "binary": false,
-        "idempotencyKey": false,
-        "parameters": [],
-        "security": [
-            {
-                "apiKeyAuth": []
-            },
-            {
-                "m2mOAuth": [
-                    "interchange:read"
-                ]
-            }
-        ],
-        "summary": "Open one agent’s Test & certify Page: live certification per use case, recent test runs, AdCP 4.0 readiness and capability declarations. Read-only."
-    },
     "open_agent_page": {
         "path": "/tools/open_agent_page",
         "method": "POST",
@@ -492,7 +473,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "Open Creative Library. Use search for a plain object answer. Composer needs campaignId; assembly needs no Creative Engine. To save a draft, use exactly one format: a canonical format such as image, hosted video, or hosted audio, or a seller format."
+        "summary": "Open Creative Library. Use search for a plain object answer. The composer can start from an advertiser or a campaign and does not need a Creative Engine. To save a draft, use exactly one format: a canonical format such as image, hosted video, or hosted audio, or a seller format."
     },
     "open_developer_home": {
         "path": "/tools/open_developer_home",
@@ -644,7 +625,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "Rechecks one external sales-agent source with no-spend get_products and, if it publishes one, a catalog refresh. Returns each check, findings still open, evidence IDs and readiness; no source configuration or media buy."
+        "summary": "Rechecks one external sales-agent source with no-spend get_products and, if it publishes one, a catalog refresh. Returns each check, findings still open, evidence IDs and readiness; no source configuration or media buy. scope accounts re-lists the source's accounts instead."
     },
     "request_buyer_child_account": {
         "path": "/tools/request_buyer_child_account",
@@ -855,7 +836,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "File or update a typed ask in the Apostra Support workflow; returns askId. Supply is buyer inventory. Call immediately with type support when a person explicitly asks for a human; do not diagnose first."
+        "summary": "File or update a typed ask in the Apostra Support workflow; returns askId. kind create files a new ask; kind update sends only id and requester. Supply is buyer inventory. Call immediately with type support when a person explicitly asks for a human; do not diagnose first."
     },
     "save_audience": {
         "path": "/tools/save_audience",
@@ -1028,7 +1009,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "Declare publisher domains this Seller sells and its claimed properties. `domains` replaces the complete set; `add`, `remove`, `declareProperties`, and `removeProperties` change named items only. Read authorization; never assume it."
+        "summary": "Declare publisher domains this Seller sells and its claimed properties. `domains` replaces the complete set; `add`, `remove`, `declareProperties`, `removeProperties`, and `refresh` act on named items only. Read authorization; never assume it."
     },
     "save_creative": {
         "path": "/tools/save_creative",
@@ -1047,7 +1028,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "advertiserId/campaignId:name,message;assets/landing_page_url/social/sourceAssetRef/sourceAssets;Supplied content/assets only;generate new media (radio spots):save_creative_session;exactly one format selector:formatKind/formatParams,creativeFormatId/formatOptionRef;libraryRole:Buyer Account only."
+        "summary": "Save content you supply: advertiserId/campaignId, name, message, assets (landing_page_url, social, sourceAssetRef/sourceAssets). New media like radio spots: use save_creative_session. One format selector: formatKind+formatParams or creativeFormatId+formatOptionRef. libraryRole: Buyer Account only."
     },
     "save_creative_collection": {
         "path": "/tools/save_creative_collection",
@@ -1163,7 +1144,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "Create or update where a seller's inventory comes from. Pass `id` to change a source or omit it to add one. Pass only `agentId` or `adServer` to open the form that connects an agent or an ad server. Credentials are never passed here; a source that needs one returns the page that collects it."
+        "summary": "Create or update where a seller's inventory comes from. Pass `id` to change a source or omit it to add one. Add a sales agent with only `agentId`, never its address, or an ad server with only `adServer`; each opens a form. Credentials are never passed here; a source that needs one returns its form."
     },
     "save_lesson": {
         "path": "/tools/save_lesson",
@@ -1240,7 +1221,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "Create DRAFT buy; no spend until confirmed. Meta: shared campaign=seller_optimized; ad sets=fixed; ask if unclear. Shared: omit buy/product budgets. Pause/resume: mediaBuyId + isPaused. Proposal: flight + total budget; omit products. channelGroupId: required if grouped; invalid ungrouped/updates."
+        "summary": "Create DRAFT buy; no spend until confirmed. Meta: shared campaign=seller_optimized; ad sets=fixed; ask if unclear. Shared: omit product budgets. Pause/resume: mediaBuyId + isPaused. Proposal: flight + total budget; omit products. channelGroupId: required if grouped; invalid ungrouped/updates."
     },
     "save_media_kit": {
         "path": "/tools/save_media_kit",
@@ -1375,7 +1356,7 @@ export const operations = {
                 ]
             }
         ],
-        "summary": "Save Seller identity, capabilities, Apostra listing, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, an admission, or the intake hold. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get(kind:\"distribution\")."
+        "summary": "Save Seller identity, capabilities, buyer-visible listing (mediaKit is a deprecated alias), Distribution's OpenAI challenge token, an admission, the intake hold, or the demo's expiry and sample sources. Scope3 eligibility and Market Maker entitlements are read-only here. Read Distribution with get."
     },
     "save_signal": {
         "path": "/tools/save_signal",