@company-semantics/contracts 22.0.0 → 22.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@company-semantics/contracts",
-  "version": "22.0.0",
+  "version": "22.2.0",
   "private": false,
   "repository": {
     "type": "git",

package/src/api/generated-spec-hash.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED — do not edit. Run pnpm generate:spec-hash to regenerate.
-export const SPEC_HASH = 'c4553ad2d609' as const;
-export const SPEC_HASH_FULL = 'c4553ad2d6092751eed87104b6614f3ef60884954c1d5a029a98129d32c5b9bf' as const;
+export const SPEC_HASH = '151972b62216' as const;
+export const SPEC_HASH_FULL = '151972b622165a687006fbe1047eb84210072a2c2be50fd1c7651312e5266e1f' as const;

package/src/api/generated.ts

@@ -2959,6 +2959,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/api/factory/kpis": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Read the factory KPI rollup (navigability over traversal_cost events) */
+        get: operations["factoryKpis"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/api/internal-admin/impersonate/start": {
         parameters: {
             query?: never;
@@ -3805,6 +3822,19 @@ export interface components {
             homeUnitId?: string;
             /** @enum {string} */
             homeUnitRole?: "member" | "unit_owner";
+            stagedPlacement?: {
+                title?: string;
+                /** Format: uuid */
+                managerUserId?: string;
+                /** Format: uuid */
+                homeUnitId?: string;
+                /** @enum {string} */
+                homeUnitRole?: "member" | "unit_owner";
+                /** @default [] */
+                unitOwnerOf: string[];
+                /** @default [] */
+                contributesTo: string[];
+            };
         };
         InviteListResponse: {
             id: string;
@@ -4811,8 +4841,6 @@ export interface components {
                     /** Format: uuid */
                     id: string;
                     name: string;
-                    /** @enum {string} */
-                    mutability: "derived" | "user_managed";
                 }[];
             }[];
             edges: {
@@ -5394,6 +5422,95 @@ export interface components {
             } | null;
             receivedAt: string | null;
         };
+        SoftwareFactoryKpis: {
+            generatedFrom: {
+                events: number;
+                sessions: number;
+            };
+            navigability: {
+                overall: {
+                    p95Reads: number;
+                    p50Reads: number;
+                    p95ContextTokens: number;
+                    p50ContextTokens: number;
+                    reachedEditRate: number;
+                    searchEscapeRate: number;
+                    medianReadsAfterFirstEdit: number;
+                    p95ReadsAfterFirstEdit: number;
+                    navMapUsageBySource: {
+                        [key: string]: number;
+                    };
+                };
+                mapRoi: {
+                    withMap: {
+                        p95Reads: number;
+                        p95ContextTokens: number;
+                        n: number;
+                    };
+                    withoutMap: {
+                        p95Reads: number;
+                        p95ContextTokens: number;
+                        n: number;
+                    };
+                };
+                entropyLeaders: {
+                    prdId: string;
+                    p95Reads: number;
+                    p95ContextTokens: number;
+                    medianReadsAfterFirstEdit: number;
+                }[];
+                bySource: ({
+                    source: string;
+                } & {
+                    p95Reads?: number;
+                    p50Reads?: number;
+                    p95ContextTokens?: number;
+                    p50ContextTokens?: number;
+                    reachedEditRate?: number;
+                    searchEscapeRate?: number;
+                    medianReadsAfterFirstEdit?: number;
+                    p95ReadsAfterFirstEdit?: number;
+                    navMapUsageBySource?: {
+                        [key: string]: number;
+                    };
+                })[];
+                trend: {
+                    recent: {
+                        p95Reads?: number;
+                        p50Reads?: number;
+                        p95ContextTokens?: number;
+                        p50ContextTokens?: number;
+                        reachedEditRate?: number;
+                        searchEscapeRate?: number;
+                        medianReadsAfterFirstEdit?: number;
+                        p95ReadsAfterFirstEdit?: number;
+                        navMapUsageBySource?: {
+                            [key: string]: number;
+                        };
+                    };
+                    prior: {
+                        p95Reads?: number;
+                        p50Reads?: number;
+                        p95ContextTokens?: number;
+                        p50ContextTokens?: number;
+                        reachedEditRate?: number;
+                        searchEscapeRate?: number;
+                        medianReadsAfterFirstEdit?: number;
+                        p95ReadsAfterFirstEdit?: number;
+                        navMapUsageBySource?: {
+                            [key: string]: number;
+                        };
+                    };
+                    deltaP95Reads: number | null;
+                };
+            };
+            throughput: {
+                [key: string]: unknown;
+            } | null;
+            quality: {
+                [key: string]: unknown;
+            } | null;
+        };
         ImpersonationSessionResponse: {
             session: {
                 impersonationSessionId: string;
@@ -10388,6 +10505,40 @@ export interface operations {
             };
         };
     };
+    factoryKpis: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Factory KPI rollup (navigability populated; throughput/quality null) */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SoftwareFactoryKpis"];
+                };
+            };
+            /** @description Not authenticated */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not an internal admin */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     startImpersonation: {
         parameters: {
             query?: never;

package/src/index.ts

@@ -531,6 +531,7 @@ export type {
   InteractiveFieldType,
   InteractiveFieldDescriptor,
   InteractiveTaskSubject,
+  InteractiveTaskDestination,
   InteractiveTaskData,
   InteractiveTaskPart,
   InteractiveTaskDataPart,

package/src/message-parts/README.md

@@ -44,6 +44,7 @@ Canonical vocabulary for structured assistant message output. Defines the type s
 - `InteractiveFieldType` _(type)_ — The input shape of an editable field. - `member-ref`: a workspace member id (backed by a member picker). -…
 - `InteractiveTaskData` _(type)_ — Interactive task surface data payload.
 - `InteractiveTaskDataPart` _(type)_ — Interactive task data part (wire format).
+- `InteractiveTaskDestination` _(type)_ — Read-only destination the task attaches to (e.g. the agent-resolved company-md page a context doc import…
 - `InteractiveTaskKind` _(type)_ — The set of editable tasks the assistant can present inline.
 - `InteractiveTaskPart` _(type)_ — Interactive task message part (semantic type).
 - `InteractiveTaskSubject` _(type)_ — Read-only subject the task acts upon (e.g. the member being edited).

package/src/message-parts/index.ts

@@ -50,6 +50,7 @@ export type {
   InteractiveFieldType,
   InteractiveFieldDescriptor,
   InteractiveTaskSubject,
+  InteractiveTaskDestination,
   InteractiveTaskData,
   InteractiveTaskPart,
   InteractiveTaskDataPart,

package/src/message-parts/interactive.ts

@@ -17,8 +17,13 @@
  *   then runs the governance engine (create execution → execute), so the change
  *   is audited and reversible like every other chat action.
  * - At most one GOVERNED surface (preview ∪ interactive) is active per turn.
+ * - A task acts upon either a member `subject` (e.g. member.changeManager) OR a
+ *   `destination` (e.g. companyMd.importContextDoc, where the import attaches a
+ *   context doc to an agent-resolved company-md page instead of editing a member).
+ *   Both are optional on InteractiveTaskData; the active taskKind selects which.
  *
  * @see decisions/ADR-CONTRACTS-068.md for design rationale
+ * @see decisions/ADR-CONTRACTS-070-interactive-context-doc-import-surface.md for the import destination surface
  */
 
 import type { ConfirmationRiskLevel } from "./confirmation";
@@ -27,7 +32,9 @@ import type { ConfirmationRiskLevel } from "./confirmation";
  * The set of editable tasks the assistant can present inline.
  * Mirrors the `{domain}.{verb}` naming of ExecutionKind. Extensible union.
  */
-export type InteractiveTaskKind = "member.changeManager";
+export type InteractiveTaskKind =
+  | "member.changeManager"
+  | "companyMd.importContextDoc";
 
 /**
  * How the frontend sources candidate values for an editable field.
@@ -83,6 +90,18 @@ export interface InteractiveTaskSubject {
   context?: Record<string, string>;
 }
 
+/**
+ * Read-only destination the task attaches to (e.g. the agent-resolved company-md
+ * page a context doc import lands on). Used by tasks that act on a document
+ * target rather than a member subject (e.g. companyMd.importContextDoc).
+ */
+export interface InteractiveTaskDestination {
+  /** Company-md page id the context doc attaches to. */
+  docId: string;
+  /** Display title of the destination page for the surface header. */
+  docTitle: string;
+}
+
 /**
  * Interactive task surface data payload.
  */
@@ -95,8 +114,10 @@ export interface InteractiveTaskData {
   title: string;
   /** Optional detail. */
   description?: string;
-  /** What the task acts upon. */
-  subject: InteractiveTaskSubject;
+  /** The member the task acts upon; set by member tasks (e.g. member.changeManager). */
+  subject?: InteractiveTaskSubject;
+  /** The company-md page the task attaches to; set by import tasks (e.g. companyMd.importContextDoc). */
+  destination?: InteractiveTaskDestination;
   /** The editable fields. */
   fields: InteractiveFieldDescriptor[];
   /** Endpoint the frontend POSTs the filled form to. */