@company-semantics/contracts 22.1.0 → 22.2.0

package/package.json

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

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. */