@company-semantics/contracts 94.0.0 → 96.0.0

package/src/api/generated.ts

@@ -1763,6 +1763,66 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/analysis-workflows/{id}/continue": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Start another execution of a stopped analysis workflow
+         * @description Reopens a STOPPED workflow in a new execution epoch and starts the execution its type serves for continue — only for a type whose execution support declares continue (otherwise 409 not_supported). Answers 202 when started; 409 not_stopped or execution_in_flight otherwise. Runtime posture: intent write, impersonation restricted (it spends model calls); the billing pre-flight runs before anything is created, and a refusal is the billing refusal envelope. An Idempotency-Key header replays the first answer for the same workflow and action. Org-scoped: a workflow in another workspace answers 404.
+         */
+        post: operations["continueAnalysisWorkflow"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/analysis-workflows/{id}/retry": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Retry a failed analysis workflow in the same workflow
+         * @description Reopens a FAILED workflow in a new execution epoch (never a new workflow id) and starts the execution its type serves for retry — only for a type whose execution support declares retry (otherwise 409 not_supported). Answers 202 when started; 409 not_failed or execution_in_flight otherwise. Runtime posture: intent write, impersonation restricted (it spends model calls); the billing pre-flight runs before anything is created, and a refusal is the billing refusal envelope. An Idempotency-Key header replays the first answer for the same workflow and action. Org-scoped: a workflow in another workspace answers 404.
+         */
+        post: operations["retryAnalysisWorkflow"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/analysis-workflows/{id}/run-again": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Run a settled analysis workflow again as a new workflow
+         * @description Launches a NEW workflow from the settled one’s parameters under the caller’s current authorization, recording relaunchedFrom, and anchors it in the launching conversation named by chatId so its settlement is delivered there. The old workflow is never written. Only for a type whose execution support declares runAgain (otherwise 409 not_supported); a workflow already open for the same launch answers 409 run_in_progress with its id — never joined, never duplicated. A conversation the caller may not write in answers 404 before anything is created. Runtime posture: intent write, impersonation restricted (it spends model calls); the billing pre-flight runs before anything is created, and a refusal is the billing refusal envelope. An Idempotency-Key header replays the first answer for the same workflow and action. Org-scoped: a workflow in another workspace answers 404.
+         */
+        post: operations["runAnalysisWorkflowAgain"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/affordances/state": {
         parameters: {
             query?: never;
@@ -7263,6 +7323,34 @@ export interface components {
                     args: {
                         executionId: string;
                     };
+                } | {
+                    /** @constant */
+                    id: "workflow.stop";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.continue";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.retry";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.runAgain";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
                 })[];
             } | {
                 /** @constant */
@@ -7361,6 +7449,34 @@ export interface components {
                     args: {
                         executionId: string;
                     };
+                } | {
+                    /** @constant */
+                    id: "workflow.stop";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.continue";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.retry";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.runAgain";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
                 })[];
             } | {
                 /** @constant */
@@ -7461,6 +7577,34 @@ export interface components {
                     args: {
                         executionId: string;
                     };
+                } | {
+                    /** @constant */
+                    id: "workflow.stop";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.continue";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.retry";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.runAgain";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
                 })[];
             } | {
                 /** @constant */
@@ -7561,6 +7705,34 @@ export interface components {
                     args: {
                         executionId: string;
                     };
+                } | {
+                    /** @constant */
+                    id: "workflow.stop";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.continue";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.retry";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.runAgain";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
                 })[];
             }) | null;
             error?: string;
@@ -7586,10 +7758,44 @@ export interface components {
             /** @enum {string} */
             result: "delivered" | "deferred" | "busy" | "skipped" | "not_settled";
         };
+        WorkflowExecutionStartedResponse: {
+            /** @constant */
+            started: true;
+            /** Format: uuid */
+            workflowId: string;
+            executionEpoch: number;
+            /** @constant */
+            state: "pending";
+        };
+        WorkflowExecutionRefusal: {
+            /** @constant */
+            refused: true;
+            /** @enum {string} */
+            reason: "not_stopped" | "not_failed" | "execution_in_flight" | "not_supported" | "run_in_progress";
+            /** @enum {string} */
+            state: "pending" | "running" | "draining" | "stopped" | "complete" | "failed";
+            /** Format: uuid */
+            workflowId: string;
+            openWorkflowId?: string | null;
+        };
+        WorkflowRunAgainResponse: {
+            /** @constant */
+            launched: true;
+            /** Format: uuid */
+            workflowId: string;
+            /** Format: uuid */
+            relaunchedFrom: string;
+            /** @constant */
+            state: "pending";
+        };
+        RunAnalysisWorkflowAgainRequest: {
+            /** Format: uuid */
+            chatId: string;
+        };
         AffordanceStateResponse: {
             entries: {
                 /** @enum {string} */
-                id: "sourceSync.findFiles" | "integrations.connectGoogleDrive" | "sourceSync.enable" | "billing.open" | "orgStructure.reanalyze" | "hris.resyncDirectory" | "review.open" | "integrations.open" | "hris.connect" | "account.editProfile" | "workspace.openOrgSettings" | "sourceSync.addFile" | "sourceSync.openUpdate" | "orgStructure.openReview" | "chat.open" | "companyMd.openDoc" | "companyMd.openHistory" | "team.open" | "execution.open";
+                id: "sourceSync.findFiles" | "integrations.connectGoogleDrive" | "sourceSync.enable" | "billing.open" | "orgStructure.reanalyze" | "hris.resyncDirectory" | "review.open" | "integrations.open" | "hris.connect" | "account.editProfile" | "workspace.openOrgSettings" | "sourceSync.addFile" | "sourceSync.openUpdate" | "orgStructure.openReview" | "chat.open" | "companyMd.openDoc" | "companyMd.openHistory" | "team.open" | "execution.open" | "workflow.stop" | "workflow.continue" | "workflow.retry" | "workflow.runAgain";
                 /** @enum {string} */
                 policy: "allowed" | "blocked";
                 availability: {
@@ -8763,6 +8969,34 @@ export interface components {
                     args: {
                         executionId: string;
                     };
+                } | {
+                    /** @constant */
+                    id: "workflow.stop";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.continue";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.retry";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
+                } | {
+                    /** @constant */
+                    id: "workflow.runAgain";
+                    args: {
+                        /** Format: uuid */
+                        workflowId: string;
+                    };
                 } | {
                     /** @constant */
                     id: "review.open";
@@ -8869,6 +9103,34 @@ export interface components {
                         args: {
                             executionId: string;
                         };
+                    } | {
+                        /** @constant */
+                        id: "workflow.stop";
+                        args: {
+                            /** Format: uuid */
+                            workflowId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "workflow.continue";
+                        args: {
+                            /** Format: uuid */
+                            workflowId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "workflow.retry";
+                        args: {
+                            /** Format: uuid */
+                            workflowId: string;
+                        };
+                    } | {
+                        /** @constant */
+                        id: "workflow.runAgain";
+                        args: {
+                            /** Format: uuid */
+                            workflowId: string;
+                        };
                     } | {
                         /** @constant */
                         id: "review.open";
@@ -10129,17 +10391,38 @@ export interface components {
             hostedSurchargeBps: number;
             byoFeeBps: number;
             priceBookVersion: string;
+            /** Format: date-time */
+            priceBookEffectiveAt: string;
             models: {
                 /** @enum {string} */
                 provider: "openai" | "anthropic";
                 modelId: string;
-                inputPerMMicros: string;
-                outputPerMMicros: string;
-                cacheReadPerMMicros: string;
-                cacheWritePerMMicros: string;
-                reasoningPerMMicros: string;
-                hostedInputPerMMicros: string;
-                hostedOutputPerMMicros: string;
+                aliases: string[];
+                sourceUrl: string | null;
+                retrievedOn: string | null;
+                promptTierMeasure: ("input_incl_cache" | "input_excl_cache") | null;
+                promptTokensCeiling: number | null;
+                tiers: {
+                    /** @enum {string} */
+                    processingMode: "standard" | "batch" | "flex" | "fast" | "ultrafast";
+                    promptTokensAbove: number;
+                    reference: {
+                        inputPerMMicros: string;
+                        outputPerMMicros: string | null;
+                        cacheReadPerMMicros: string | null;
+                        cacheWritePerMMicros: string | null;
+                        cacheWrite1hPerMMicros: string | null;
+                        reasoningPerMMicros: string | null;
+                    };
+                    hosted: {
+                        inputPerMMicros: string;
+                        outputPerMMicros: string | null;
+                        cacheReadPerMMicros: string | null;
+                        cacheWritePerMMicros: string | null;
+                        cacheWrite1hPerMMicros: string | null;
+                        reasoningPerMMicros: string | null;
+                    };
+                }[];
             }[];
         };
         SourceSyncDiscoveryRunResponse: {
@@ -14097,6 +14380,145 @@ export interface operations {
             };
         };
     };
+    continueAnalysisWorkflow: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Another execution of the same workflow is under way */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowExecutionStartedResponse"];
+                };
+            };
+            /** @description The workflow id is not a uuid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No such workflow in this workspace */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Nothing was started: the reason and the workflow’s authoritative current state */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowExecutionRefusal"];
+                };
+            };
+        };
+    };
+    retryAnalysisWorkflow: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Another execution of the same workflow is under way */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowExecutionStartedResponse"];
+                };
+            };
+            /** @description The workflow id is not a uuid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No such workflow in this workspace */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Nothing was started: the reason and the workflow’s authoritative current state */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowExecutionRefusal"];
+                };
+            };
+        };
+    };
+    runAnalysisWorkflowAgain: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RunAnalysisWorkflowAgainRequest"];
+            };
+        };
+        responses: {
+            /** @description A new workflow was launched and anchored in the conversation */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowRunAgainResponse"];
+                };
+            };
+            /** @description The workflow id or the chat id is not a uuid */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No such workflow, or no such conversation the caller may write in */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Nothing was started: the reason and the workflow’s authoritative current state */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WorkflowExecutionRefusal"];
+                };
+            };
+        };
+    };
     getAffordanceState: {
         parameters: {
             query: {

package/src/billing/README.md

@@ -18,7 +18,8 @@ What it publishes:
 - **Closed enums**, each an `as const` tuple with a union type and a `z.enum`
   built from the same tuple: credential source, funding mode, platform status,
   AI pause reason, ledger entry type, reservation state, settlement basis,
-  top-up kind and status, token dimension, principal kind, and provider.
+  top-up kind and status, token dimension, principal kind, provider, processing
+  mode and prompt tier measure.
 - **Derived tables.** `SEAT_BILLABILITY`, the mapping from principal kind to
   seat billability, and `TokenDimensionsSchema`, one integer count per token
   dimension.
@@ -99,6 +100,41 @@ owner is always its owner contradicts ADR-BE-296, and nothing imported them.
   who paid and was never credited, and `succeeded` and `credited` stay distinct
   in `TOP_UP_STATUSES` so that gap is visible to an operator.
 
+## Price list card (ADR slug price-list-tiers)
+
+`PriceListSchema` publishes one card per model (`PriceListModelSchema`), not one
+flat rate row. The card mirrors the provider's own pricing structure, so a
+customer can check every charge against the provider's published page.
+
+- **A card is `tiers[]`**: one `PriceListTierSchema` entry per
+  (`processingMode`, `promptTokensAbove`). Each tier carries the provider's
+  `reference` rates and the `hosted` rates derived from them, both as
+  `PriceListRatesSchema` (micro-USD per million tokens). Every priced model has a
+  `standard` tier at `promptTokensAbove: 0`; a request whose prompt is above a
+  tier's threshold pays that tier's rates on every dimension.
+- **A processing mode is an explicit provider rate set, never a multiplier we
+  derive.** `PROCESSING_MODES` names the sets (standard, batch, flex, fast,
+  ultrafast); a mode's rates are the provider's published numbers, because
+  providers do not price modes by a clean factor (OpenAI gpt-4o Fast is 1.7x
+  Standard).
+- **`null` means the provider publishes no separate rate** for that dimension —
+  never `"0"`. An input-side null (cache read, cache write) bills at the tier's
+  input rate, which is what the provider charges. `cacheWrite1hPerMMicros` is
+  published for transparency; the backend refuses 1-hour-TTL requests until a
+  usage axis exists for it (`TokenDimensionsSchema` is unchanged).
+- **A model with more than one tier names its `promptTierMeasure`**
+  (`PROMPT_TIER_MEASURES`): what the provider counts to choose the tier. An
+  ambiguous provider rule is never guessed; the long tier stays unpublished and
+  `promptTokensCeiling` refuses prompts above the published range.
+- **An id is listed once** per price list: as a card's `modelId` or as one
+  card's `aliases` entry, never both.
+- **Corrections publish a new price-book version; history is never
+  recomputed.** `priceBookEffectiveAt` says when a version took effect,
+  `PriceBookVersionListSchema` lists every version that has ever priced a
+  charge, and `PriceListQuerySchema` selects one by label (omit for the active
+  version). The query schema is the one request-side shape here, published
+  because the version label is part of the price list's public promise.
+
 <!-- BEGIN GENERATED: readme-public-api — derived from code by `pnpm readme-api`. Do not edit. -->
 
 ## Public API
@@ -169,14 +205,30 @@ owner is always its owner contradicts ADR-BE-296, and nothing imported them.
 - `OrgBillingOverview` _(type)_ — Everything the org's billing page needs, in one response.
 - `OrgBillingOverviewSchema` — Everything the org's billing page needs, in ONE response.
 - `PRINCIPAL_KINDS` — WHAT KIND of thing an org membership represents.
+- `PROCESSING_MODES` — How a provider processes a request, which selects the rate set it is billed at.
+- `PROMPT_TIER_MEASURES` — What a provider counts to decide which prompt-length tier a request pays.
 - `PortalSessionResponse` _(type)_ — A Stripe customer-portal session to send the customer to.
 - `PortalSessionResponseSchema` — A Stripe customer-portal session to send the customer to.
+- `PriceBookVersionList` _(type)_ — The price book's version history, newest first.
+- `PriceBookVersionListSchema` — The price book's version history, newest first.
+- `PriceBookVersionSummary` _(type)_ — One published price-book version.
+- `PriceBookVersionSummarySchema` — One published price-book version, newest first in the list.
 - `PriceList` _(type)_ — The published price book, versioned.
-- `PriceListModel` _(type)_ — One priced model.
-- `PriceListModelSchema` — One priced model.
+- `PriceListModel` _(type)_ — One priced model's card: provenance, aliases and tiers per mode.
+- `PriceListModelSchema` — One priced model's card: its provenance, the ids it serves, and its tiers per processing mode.
+- `PriceListQuery` _(type)_ — The price-list query: an optional version label, else the active one.
+- `PriceListQuerySchema` — `GET /api/billing/price-list?version=<label>` — omit for the active version.
+- `PriceListRates` _(type)_ — One rate set, micro-USD per million tokens; null = no separate rate.
+- `PriceListRatesSchema` — One rate set, micro-USD PER MILLION tokens.
 - `PriceListSchema` — The published price book, versioned.
+- `PriceListTier` _(type)_ — One tier of one processing mode: reference and hosted rates.
+- `PriceListTierSchema` — One tier of one processing mode.
 - `PrincipalKind` _(type)_ — What kind of thing an org membership represents.
 - `PrincipalKindSchema`
+- `ProcessingMode` _(type)_
+- `ProcessingModeSchema`
+- `PromptTierMeasure` _(type)_
+- `PromptTierMeasureSchema`
 - `ProviderKeyList` _(type)_ — Every provider the org could configure a key for.
 - `ProviderKeyListSchema` — Every provider the org could configure a key for, configured or not.
 - `ProviderKeyStatus` _(type)_ — What an org may see about one of its own provider keys.