@camox/api-contract 0.80.0 → 0.81.0

package/dist/router.d.ts

@@ -1,8 +1,8 @@
 import { z } from "zod";
 import { DurableObject, WorkerEntrypoint, WorkflowEntrypoint, WorkflowEvent, WorkflowStep } from "cloudflare:workers";
-import { AgentActivity, ConnectedAgentClient, ThreadSender, ThreadView } from "@camox/api-contract/threads";
+import { AgentActivity, ConnectedAgentClient, EditorWhere, ThreadSender, ThreadView } from "@camox/api-contract/threads";
 import { PiHarness, PiHarnessOptions } from "agents/harness/pi";
-import { CapabilityStartContext, Lifecycle } from "agents/lifecycle";
+import { CapabilityStartContext, Lifecycle, LifecycleJobContext } from "agents/lifecycle";
 import { WebSockets } from "agents/websockets";
 import "@earendil-works/pi-ai";
 import "@earendil-works/pi-ai/models";
@@ -9753,6 +9753,8 @@ type OpeningMessage = {
   from: OpeningSender;
   answer?: boolean;
   attachments?: MessageAttachment[];
+  /** Where the editor was in the studio as they sent it, for a message sent from there. */
+  where?: EditorWhere;
 };
 /**
  * How the API opens a draft's thread with no studio connected (`Thread.open`): what it belongs
@@ -9768,12 +9770,17 @@ type ThreadOpening = {
 };
 /**
  * Cloudflare's `PiHarness`, leaving Pi closed when the object starts until `started` holds: Pi
- * creates its tables as it opens, and a thread nobody messaged has no run to resume.
+ * creates its tables as it opens, and a thread nobody messaged has no run to resume. `settled`
+ * hears each time a session of the thread has no task left: Pi has no hook for a run that fails,
+ * but the harness's job waking a session completes once its tasks are all over, failed or not.
  */
 declare class UntilStartedPiHarness extends PiHarness {
   #private;
-  constructor(started: () => Promise<boolean>, options: PiHarnessOptions);
+  constructor(started: () => Promise<boolean>, { settled, ...options }: PiHarnessOptions & {
+    settled: () => Promise<void>;
+  });
   onStart(context: CapabilityStartContext): Promise<void>;
+  onJob(context: LifecycleJobContext): Promise<void | import("agents/lifecycle").LifecycleJobOutcome>;
 }
 /**
  * One thread with Camox's agent, addressed by the thread's own id. Pi Durable runs the agent
@@ -9822,14 +9829,11 @@ declare class Thread extends DurableObject<Bindings> {
    */
   showDrafts(): Promise<void>;
   /**
-   * Opens the thread from the API, with no studio connected: records what it belongs to and the
-   * API's origin, adds the Brief if any, which the model reads and studios show as from Camox
-   * (ADR 0025), then the opening messages, each recorded as its sender's kind has it, and starts
-   * the agent's run, which acts as the last message's sender. Every message but the last goes in
-   * before the run, the last starting it, so the model reads them all on its first call.
-   * Repeating it changes nothing.
+   * Opens the thread from the API, with no studio connected: its Brief, if any, then its opening
+   * messages, each recorded as its sender's kind has it, the last starting the agent's run, which
+   * acts as its sender (`Turns.take`). Repeating it changes nothing.
    */
-  open({ identity, apiOrigin, brief, messages }: ThreadOpening): Promise<void>;
+  open(opening: ThreadOpening): Promise<void>;
   /**
    * Sends a message into the thread from the API, with no studio connected, as an editor's
    * message from the studio is sent: it starts the agent's run, or steers the one going, and the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camox/api-contract",
-  "version": "0.80.0",
+  "version": "0.81.0",
   "license": "UNLICENSED",
   "files": [
     "src",