@company-semantics/contracts 95.0.0 → 97.0.0

package/src/api/generated.ts

@@ -1712,7 +1712,7 @@ export interface paths {
         };
         /**
          * Read one analysis workflow’s generic lifecycle envelope
-         * @description The domain-agnostic projection a client polls: identity, registered type, activity-free lifecycle state, start and completion times, the opaque domain progress and result payloads (null until the domain adapter supplies them), a closed failure class on a failed workflow, the frozen typed outcome of the current execution epoch once it settles (null until then), and the capabilities the surface may offer — canStop from the generic layer, canContinue as the domain declares it. Org-scoped: a workflow in another workspace answers 404.
+         * @description The domain-agnostic projection a client polls: identity, registered type, activity-free lifecycle state, start and completion times, the opaque domain progress and result payloads (null until the domain adapter supplies them), a closed failure class on a failed workflow, the frozen typed outcome of the current execution epoch once it settles (null until then), the execution affordances offered now (the contracts offer table over state, the type’s execution support and the frozen outcome, filtered by the viewer’s policy), the workflow it was relaunched from, the current execution epoch’s start and completion times, and the legacy capabilities (canStop, canContinue) kept until their consumers move. Org-scoped: a workflow in another workspace answers 404.
          */
         get: operations["getAnalysisWorkflow"];
         put?: never;
@@ -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;
@@ -4868,7 +4928,7 @@ export interface paths {
         };
         /**
          * Get the price list
-         * @description The seat price, the hosted surcharge and BYO fee, the active price-book version, and every priced model at its reference rates beside the hosted rates derived from them.
+         * @description The seat price, the hosted surcharge and BYO fee, a price-book version (the active one, or the one named by ?version), and every priced model as its card: provenance, aliases, and each processing mode and prompt tier at its reference rates beside the hosted rates derived from them.
          */
         get: operations["getBillingPriceList"];
         put?: never;
@@ -4879,6 +4939,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/billing/price-book-versions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List price-book versions
+         * @description Every published price-book version, newest first, with its provenance and the one calls are priced against now marked active.
+         */
+        get: operations["getBillingPriceBookVersions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/source-sync/discovery/runs": {
         parameters: {
             query?: never;
@@ -7263,6 +7343,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 +7469,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 +7597,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 +7725,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;
@@ -7568,6 +7760,38 @@ export interface components {
                 canStop: boolean;
                 canContinue: boolean;
             };
+            executionAffordances: ({
+                /** @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;
+                };
+            })[];
+            relaunchedFrom: string | null;
+            epochStartedAt: string | null;
+            epochCompletedAt: string | null;
         };
         StopAnalysisWorkflowResponse: {
             /** @constant */
@@ -7586,10 +7810,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 +9021,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 +9155,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";
@@ -10163,6 +10477,16 @@ export interface components {
                 }[];
             }[];
         };
+        PriceBookVersionList: {
+            versions: {
+                versionLabel: string;
+                /** Format: date-time */
+                effectiveAt: string;
+                source: string;
+                notes: string | null;
+                active: boolean;
+            }[];
+        };
         SourceSyncDiscoveryRunResponse: {
             /** Format: uuid */
             runId: string;
@@ -14118,6 +14442,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: {
@@ -20395,7 +20858,9 @@ export interface operations {
     };
     getBillingPriceList: {
         parameters: {
-            query?: never;
+            query?: {
+                version?: string;
+            };
             header?: never;
             path?: never;
             cookie?: never;
@@ -20411,6 +20876,13 @@ export interface operations {
                     "application/json": components["schemas"]["PriceList"];
                 };
             };
+            /** @description No price-book version carries that label */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
             /** @description No price book is loaded */
             503: {
                 headers: {
@@ -20420,6 +20892,26 @@ export interface operations {
             };
         };
     };
+    getBillingPriceBookVersions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The price book version history */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PriceBookVersionList"];
+                };
+            };
+        };
+    };
     startSourceDiscoveryRun: {
         parameters: {
             query?: never;

package/src/generated/openapi-routes.ts

@@ -11,9 +11,13 @@ export const openApiRoutes = {
   '/api/account/sessions/{sessionId}': ['DELETE'],
   '/api/affordances/state': ['GET'],
   '/api/analysis-workflows/{id}': ['GET'],
+  '/api/analysis-workflows/{id}/continue': ['POST'],
+  '/api/analysis-workflows/{id}/retry': ['POST'],
+  '/api/analysis-workflows/{id}/run-again': ['POST'],
   '/api/analysis-workflows/{id}/settlement': ['POST'],
   '/api/analysis-workflows/{id}/stop': ['POST'],
   '/api/auth/consent/grant': ['POST'],
+  '/api/billing/price-book-versions': ['GET'],
   '/api/billing/price-list': ['GET'],
   '/api/capabilities': ['GET'],
   '/api/chat/interactive-tasks/submit': ['POST'],

package/src/root-exports/delivery.ts

@@ -215,9 +215,41 @@ export type {
 // chat part and by the generic projection read. Namespaced `<domain>/<flow>`
 // so domains cannot collide, and a CLOSED const array so the discriminator is
 // validated and handled exhaustively. See src/workflows/README.md.
-export { ANALYSIS_WORKFLOW_TYPES, isWorkflowType } from "../workflows/index";
+export {
+  ANALYSIS_WORKFLOW_STATES,
+  ANALYSIS_WORKFLOW_TYPES,
+  isWorkflowType,
+} from "../workflows/index";
+
+export type { AnalysisWorkflowState, WorkflowType } from "../workflows/index";
+
+// Workflow execution actions (ADR-CONTRACTS-227): `executionAffordancesFor` is
+// the one total offer table from a workflow's state, its type's support and
+// its frozen outcome to the workflow.* affordances. See
+// src/workflows/execution-affordances.ts.
+export {
+  DOMAIN_RELAUNCH_AFFORDANCE_IDS,
+  WORKFLOW_EXECUTION_ACTIONS,
+  executionAffordancesFor,
+} from "../workflows/index";
+
+export type {
+  ExecutionAffordancesInput,
+  WorkflowExecutionAction,
+  WorkflowExecutionAffordance,
+  WorkflowExecutionSupport,
+} from "../workflows/index";
+
+// Workflow execution projection fields (ADR-CONTRACTS-227): the offered
+// workflow.* affordances, relaunch lineage and per-epoch timing the backend
+// composes into its (backend-local) workflow projection. See
+// src/workflows/projection-fields.ts.
+export {
+  WorkflowExecutionAffordanceSchema,
+  WorkflowExecutionProjectionFieldsSchema,
+} from "../workflows/index";
 
-export type { WorkflowType } from "../workflows/index";
+export type { WorkflowExecutionProjectionFields } from "../workflows/index";
 
 // The typed outcome of a workflow's terminal transition (control ADR-CTRL-540):
 // per-type closed reasons, typed facts and an explicit disposition, classified
@@ -317,6 +349,7 @@ export {
   ReviewOpenArgsSchema,
   SourceSyncOpenUpdateArgsSchema,
   TeamOpenArgsSchema,
+  WorkflowExecutionArgsSchema,
   sameAffordances,
 } from "../affordances/index";