@zinn-digital/sdk 0.1.1347 → 0.1.1351

package/dist/generated/schema.d.ts

@@ -56263,6 +56263,8 @@ export interface components {
             updated_at: string;
         };
         AdminBoardActivity: {
+            /** @description The member of staff behind an act done from an impersonated session (`user:<staff id>`, the audit log's ref); null for an ordinary act. Staff-only: customer payloads read `support` instead (VERIFY-ACTORS6). */
+            acting_ref?: string | null;
             actor_id: components["schemas"]["Uuid"] | null;
             actor_is_client: boolean;
             /**
@@ -61178,10 +61180,22 @@ export interface components {
                 basis?: string;
                 /** Format: date-time */
                 recorded_at?: string | null;
+                /** @description Who last recorded the consent, by name (else e-mail) — set ONLY when `recorded_by_kind` is `person` (a current member of this org); empty otherwise. Never a raw `user:<id>` (VERIFY-ADSACTOR). */
                 recorded_by?: string;
+                /**
+                 * @description Who recorded the consent, as a kind the screen translates — the same kinds as `AdsBudgetDecision.decided_by_kind` (`support` = our staff, including while impersonating). `null` when nobody has.
+                 * @enum {string|null}
+                 */
+                recorded_by_kind?: "person" | "support" | "agency" | "former_member" | "assistant" | "automatic" | "integration" | "other" | null;
                 /** Format: date-time */
                 terms_accepted_at?: string | null;
+                /** @description Who accepted the Customer Match terms — the same rule as `recorded_by`. */
                 terms_accepted_by?: string;
+                /**
+                 * @description Who accepted the terms, as a kind (as `recorded_by_kind`); `null` when nobody has.
+                 * @enum {string|null}
+                 */
+                terms_accepted_by_kind?: "person" | "support" | "agency" | "former_member" | "assistant" | "automatic" | "integration" | "other" | null;
             };
             /** Format: date-time */
             created_at: string;
@@ -61489,7 +61503,7 @@ export interface components {
             /** @description The person who decided, by name (else e-mail) — set ONLY when `decided_by_kind` is `person`, i.e. a current member of this org; empty for every other kind. Never a raw `user:<id>` or `mcp:<id>`: the audit trail keeps the stored actor. */
             decided_by: string;
             /**
-             * @description Who decided, as a kind the screen translates: `person` (a current member, named in `decided_by`), `support` (our staff), `agency` (a member of the parent org), `former_member` (removed, deleted or not of this org), `assistant` (the AI assistant over MCP), `automatic` (the autopilot), `integration` (an API key), `other`.
+             * @description Who decided, as a kind the screen translates: `person` (a current member, named in `decided_by`), `support` (our staff — including a decision made while our staff were signed in to this account on the customer's behalf (impersonation): it is recorded as the staff member, never the customer), `agency` (a member of the parent org), `former_member` (removed, deleted or not of this org), `assistant` (the AI assistant over MCP), `automatic` (the autopilot), `integration` (an API key, stored as `apikey:<id>`), `other`.
              * @enum {string}
              */
             decided_by_kind: "person" | "support" | "agency" | "former_member" | "assistant" | "automatic" | "integration" | "other";
@@ -61822,6 +61836,7 @@ export interface components {
             connection_id: string;
             /** Format: date-time */
             decided_at: string | null;
+            /** @description Who approved or declined it: who stored it (`user:<id>`, `autopilot`, `mcp:<id>`, `apikey:<id>`, …) — except a member of our staff, who reads `support` and never their id (VERIFY-ADSACTOR: an impersonated write is recorded as the staff member). */
             decided_by: string;
             /** @description Why the change was not sent, its CODE leading (`ceiling`, `killed`, `paused`, `disconnected`, `standing: …`, `needsReconnect`, `adBelowGood`, `xWritesOff`, za-70 `collides` — the collision simulator found what `summary.collision` names — or `collisionUnread` — the account could not be read for the replay — and za-10 `convertingSearch: …` — a negative keyword that would block a search with a conversion in the last 30 days, refused at the send even when a person approved it; SERVEWATCH `strategyStarves` — a bid-strategy switch whose ceiling or bids cannot win most of the campaign's searches against Google's own top-of-page estimates, refused whoever asked, its figures in `summary.serving_check`; UNDOSTRAT, on an APPLIED change whose Undo puts a bid strategy back: `killed` · `paused` · `standing` · `strategyStarves` followed by `: undo refused` — the restore passes the kill switch, good standing and the same simulation — and `undoReadBackDiffers: <campaigns>`, the strategy Google read back after the Undo is not `summary.bidding_before`, so the change stays applied and its Undo can be sent again); otherwise the network's own sentence. Empty when nothing went wrong. */
             error: string;
@@ -61831,6 +61846,7 @@ export interface components {
             org_id: string;
             /** Format: date-time */
             proposed_at: string;
+            /** @description Who proposed the change: who stored it (`user:<id>`, `autopilot`, `mcp:<id>`, `apikey:<id>`, …) — except a member of our staff, who reads `support` and never their id (VERIFY-ADSACTOR: an impersonated write is recorded as the staff member). */
             proposed_by: string;
             status: components["schemas"]["AdsChangeStatus"];
             /** @description What the change does, for the card. SERVEWATCH adds `serving_check` (a bid-strategy switch simulated before the send: `verdict` ok · unknown · starves, `strategy`, `reason`, `ceiling_micros`, `need_micros`, `reach_pct` of the searches the ceiling can win, `raise_to_micros`, `fix`), `restores_served` (a serving-watch revert of the change that stopped a campaign) and `converting_removal` (a removal of campaigns that produced `share_pct`% of the account's results in 30 days: `campaigns`, `share_pct`, `conversions` — an automatic one waits for a person). UNDOSTRAT adds `bidding_before` on a change that alters a campaign's bidding: one entry per campaign (`resource`, `type` the bidding strategy type, `portfolio` a portfolio strategy's resource or `settings` the strategy's own values — `location`, `locationFractionMicros`, `cpcBidCeilingMicros`, `cpcBidFloorMicros`, `targetCpaMicros`, `targetRoas`, `enhancedCpcEnabled`), read before the send. Its Undo restores exactly that, and is marked undone only when Google reads it back. */
@@ -63861,7 +63877,13 @@ export interface components {
             created_by: string;
             /** Format: date-time */
             decided_at: string | null;
+            /** @description Who decided, by name (else e-mail) — set ONLY when `decided_by_kind` is `person`, a current member of this org; empty otherwise. Never the stored `user:<id>` (ADSACTOR r2): the audit trail keeps it. */
             decided_by: string;
+            /**
+             * @description Who decided, as a kind the screen translates — the same rule as a budget decision's `decided_by_kind` (`automatic` also covers a review settled by the autopilot's own test). `null` while nothing is decided.
+             * @enum {string|null}
+             */
+            decided_by_kind: "person" | "support" | "agency" | "former_member" | "assistant" | "automatic" | "integration" | "other" | null;
             /** @enum {string} */
             decision: "" | "keep" | "pause" | "revert" | "extend";
             /** Format: date */
@@ -65375,8 +65397,9 @@ export interface components {
         /** @description One person, resolved to something a human recognises. ⛔ Every `*_by` field on the AGENCY's side of this API carries one of these rather than a bare id — the People drawer rendered a raw UUID at a colleague's name until 2026-09-01, and an object with no id-shaped field to reach for is what stops that recurring. */
         AgencyBoardActor: {
             email?: string;
-            id: components["schemas"]["Uuid"];
-            /** @description Display name, falling back to the email address when the account has never set one. Never blank. */
+            /** @description Null when a member of staff did this from an impersonated session — `name` is then `support` and no person is named (VERIFY-ACTORS6). */
+            id: components["schemas"]["Uuid"] | null;
+            /** @description Display name, falling back to the email address when the account has never set one. Never blank. `support` for an act a member of staff did while impersonating. */
             name: string;
         };
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1347",
+  "version": "0.1.1351",
   "description": "Typed TypeScript client for the Zinn Digital Platform API, generated from its OpenAPI spec.",
   "license": "MIT",
   "author": "Neil Lock \u2014 CEO, Zinn Digital\u00ae Ltd <office@zinndigital.com>",