@pellux/goodvibes-contracts 1.3.2 → 1.4.0

package/artifacts/operator-contract.json

@@ -3,7 +3,7 @@
   "product": {
     "id": "goodvibes",
     "surface": "operator",
-    "version": "1.3.2"
+    "version": "1.4.0"
   },
   "auth": {
     "modes": [
@@ -22067,6 +22067,16 @@
                   },
                   "createdAt": {
                     "type": "number"
+                  },
+                  "deliveryState": {
+                    "type": "string",
+                    "enum": [
+                      "cancelled",
+                      "queued"
+                    ]
+                  },
+                  "inReplyTo": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -22145,6 +22155,99 @@
         },
         "invokable": true
       },
+      {
+        "id": "companion.chat.messages.steer",
+        "title": "Steer Companion Chat (Interrupt And Send)",
+        "description": "Send a message that runs IMMEDIATELY, interrupting the in-flight turn if one is running. The message jumps to the front of the pending-turn queue; the active turn is cancelled through the same finalization path as companion.chat.turns.cancel (any non-empty partial reply is persisted with `deliveryState: \"cancelled\"` and the terminal `turn.cancelled` event reaches every subscriber), then the steered message's turn starts. Messages queued behind an active turn keep their places behind the steer. With no turn running this behaves as an ordinary send. Accepts the same payload as companion.chat.messages.create (`body`/`content`, `attachments`, `metadata`). Returns the new message id, `steered: true`, and `cancelledTurnId` when a turn was interrupted. Ordinary sends posted while a turn is running are QUEUED (transcript-visible immediately with `deliveryState: \"queued\"`, answered in order) — steer is the explicit jump-the-line verb.",
+        "category": "companion",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "write:sessions"
+        ],
+        "http": {
+          "method": "POST",
+          "path": "/api/companion/chat/sessions/{sessionId}/messages/steer"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "sessionId": {
+              "type": "string"
+            },
+            "body": {
+              "type": "string"
+            },
+            "content": {
+              "type": "string"
+            },
+            "attachments": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "artifactId": {
+                    "type": "string"
+                  },
+                  "label": {
+                    "type": "string"
+                  },
+                  "metadata": {
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": false
+                  }
+                },
+                "required": [
+                  "artifactId"
+                ],
+                "additionalProperties": false
+              }
+            },
+            "metadata": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": false
+            }
+          },
+          "required": [
+            "sessionId"
+          ],
+          "additionalProperties": true
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "sessionId": {
+              "type": "string"
+            },
+            "messageId": {
+              "type": "string"
+            },
+            "steered": {
+              "type": "boolean"
+            },
+            "cancelledTurnId": {
+              "type": "string"
+            },
+            "turnStarted": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "sessionId",
+            "messageId",
+            "steered",
+            "turnStarted"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
       {
         "id": "companion.chat.sessions.close",
         "title": "Close Companion Chat Session",
@@ -22611,6 +22714,16 @@
                   },
                   "createdAt": {
                     "type": "number"
+                  },
+                  "deliveryState": {
+                    "type": "string",
+                    "enum": [
+                      "cancelled",
+                      "queued"
+                    ]
+                  },
+                  "inReplyTo": {
+                    "type": "string"
                   }
                 },
                 "required": [
@@ -22919,6 +23032,68 @@
         },
         "invokable": true
       },
+      {
+        "id": "companion.chat.turns.cancel",
+        "title": "Cancel Companion Chat Turn",
+        "description": "Stop the in-flight turn for a companion chat session — a true server-side stop: the provider stream is aborted, any non-empty partial reply is persisted to the transcript with an explicit `deliveryState: \"cancelled\"` marker (an honest partial, never disguised as a complete reply) AND committed to the model-facing conversation history with an explicit interruption note — later turns can reason about what the user saw and stopped, which is usually what a follow-up or steer refers to, and the terminal `turn.cancelled` event is published to every subscriber of the session stream so a stop from one client converges on all others. Any announced tool call without a result is closed with a synthetic error `turn.tool_result` before the terminal event. Optional `turnId` guards against cancelling a newer turn a stale stop raced against (409 TURN_MISMATCH). No turn in flight is the benign 404 NO_ACTIVE_TURN (the turn finished before the stop landed). Repeat cancels are idempotent successes. The session stays open; the next message starts a fresh turn normally.",
+        "category": "companion",
+        "source": "builtin",
+        "access": "authenticated",
+        "transport": [
+          "http",
+          "ws"
+        ],
+        "scopes": [
+          "write:sessions"
+        ],
+        "http": {
+          "method": "POST",
+          "path": "/api/companion/chat/sessions/{sessionId}/turns/cancel"
+        },
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "sessionId": {
+              "type": "string"
+            },
+            "turnId": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "sessionId"
+          ],
+          "additionalProperties": true
+        },
+        "outputSchema": {
+          "type": "object",
+          "properties": {
+            "sessionId": {
+              "type": "string"
+            },
+            "turnId": {
+              "type": "string"
+            },
+            "cancelled": {
+              "type": "boolean"
+            },
+            "alreadyCancelled": {
+              "type": "boolean"
+            },
+            "partialPersisted": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "sessionId",
+            "turnId",
+            "cancelled",
+            "partialPersisted"
+          ],
+          "additionalProperties": false
+        },
+        "invokable": true
+      },
       {
         "id": "config.get",
         "title": "Get Config",
@@ -81377,10 +81552,10 @@
       }
     ],
     "schemaCoverage": {
-      "methods": 327,
-      "typedInputs": 327,
+      "methods": 329,
+      "typedInputs": 329,
       "genericInputs": 0,
-      "typedOutputs": 327,
+      "typedOutputs": 329,
       "genericOutputs": 0
     },
     "eventCoverage": {
@@ -81389,8 +81564,8 @@
       "withWireEvents": 31
     },
     "validationCoverage": {
-      "methods": 327,
-      "validated": 325,
+      "methods": 329,
+      "validated": 327,
       "skippedGeneric": 0,
       "skippedUntyped": 2
     }

package/dist/generated/foundation-client-types.d.ts

@@ -30,6 +30,8 @@ export type CompanionChatMessage = {
     role: CompanionChatMessageRole;
     content: string;
     createdAt: number;
+    deliveryState?: "cancelled" | "queued";
+    inReplyTo?: string;
 };
 export type CompanionChatSessionsListTotals = {
     sessions: number;
@@ -529,6 +531,19 @@ export interface OperatorMethodInputMap {
     "companion.chat.messages.list": {
         sessionId: string;
     };
+    "companion.chat.messages.steer": ({
+        sessionId: string;
+        body?: string;
+        content?: string;
+        attachments?: readonly ({
+            artifactId: string;
+            label?: string;
+            metadata?: {};
+        })[];
+        metadata?: {};
+    } & {
+        readonly [key: string]: unknown;
+    });
     "companion.chat.sessions.close": {
         sessionId: string;
     };
@@ -559,6 +574,12 @@ export interface OperatorMethodInputMap {
     } & {
         readonly [key: string]: unknown;
     });
+    "companion.chat.turns.cancel": ({
+        sessionId: string;
+        turnId?: string;
+    } & {
+        readonly [key: string]: unknown;
+    });
     "config.get": {};
     "config.set": ({
         key: string;
@@ -4532,6 +4553,13 @@ export interface OperatorMethodOutputMap {
         sessionId: string;
         messages: readonly CompanionChatMessage[];
     };
+    "companion.chat.messages.steer": {
+        sessionId: string;
+        messageId: string;
+        steered: boolean;
+        cancelledTurnId?: string;
+        turnStarted: boolean;
+    };
     "companion.chat.sessions.close": {
         sessionId: string;
         status: string;
@@ -4556,6 +4584,13 @@ export interface OperatorMethodOutputMap {
     "companion.chat.sessions.update": {
         session: CompanionChatSession;
     };
+    "companion.chat.turns.cancel": {
+        sessionId: string;
+        turnId: string;
+        cancelled: boolean;
+        alreadyCancelled?: boolean;
+        partialPersisted: boolean;
+    };
     "config.get": ({
         danger?: ({} & {
             readonly [key: string]: ({} & {