@cueloop/schema 0.1.0-alpha.100 → 0.1.0-alpha.101

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cueloop/schema",
-  "version": "0.1.0-alpha.100",
+  "version": "0.1.0-alpha.101",
   "description": "The Thread primitive: types, markdown block model, quote-primary anchors, feedback serialization",
   "homepage": "https://github.com/mmurakaru/cueloop#readme",
   "bugs": {

package/src/agent-harness.ts

@@ -2,7 +2,7 @@ import type { AgentPermission, AgentTool, AgentConfigOption } from "./thread-age
 
 /** Harness events carry transcript data without exposing a provider's wire protocol. */
 export type AgentHarnessEvent =
-  | { kind: "message"; id?: string; text: string }
+  | { kind: "message"; id?: string; text: string; replace?: boolean }
   | AgentHarnessDiagnostic
   | {
       kind: "tool";
@@ -24,10 +24,10 @@ export interface AgentHarnessResult {
 /** One harness connection owns initialization, session restore, and its subprocess. */
 export interface AgentHarnessConnection {
   start(): Promise<string>;
-  prompt(text: string): Promise<AgentHarnessResult>;
+  prompt(text: string, requestId?: string): Promise<AgentHarnessResult>;
   cancel(): void;
   permission(requestId: string, optionId?: string): void;
-  close(): void;
+  close(): void | Promise<void>;
   configure?(id: string, value: string): Promise<void>;
 }
 
@@ -45,6 +45,7 @@ export interface AgentHarnessAdapter {
   id: string;
   label: string;
   connect(options: AgentHarnessOptions): AgentHarnessConnection;
+  remove?(sessionId: string): void | Promise<void>;
 }
 
 /** Tools use the daemon API; call arguments and results are serialized JSON validated at the boundary. */

package/src/index.ts

@@ -22,3 +22,4 @@ export { agentCommentRoot } from "./agent-comment";
 export * from "./agent-input";
 
 export * from "./harness-output-routing";
+export type { SharedAgentRequest, SharedAgentFrame } from "./shared-agent";

package/src/path-view.ts

@@ -91,15 +91,14 @@ export function sharePublicationView(
 ): Thread {
   const shared = viewFollowing(session, publication.shareBranch ?? session.history?.branch);
 
-  return {
-    ...shared,
-    shares: [
-      {
-        id: session.id,
-        requireAuth: publication.requireAuth,
-        allowlist: publication.requireAuth ? publication.allowlist : [],
-        shareBranch: shared.history?.branch ?? publication.shareBranch ?? MAIN_BRANCH,
-      },
-    ],
+  const link: ShareLink = {
+    id: session.id,
+    requireAuth: publication.requireAuth,
+    allowlist: publication.requireAuth ? publication.allowlist : [],
+    shareBranch: shared.history?.branch ?? publication.shareBranch ?? MAIN_BRANCH,
   };
+
+  if (publication.agentEnabled) link.agentEnabled = true;
+
+  return { ...shared, shares: [link] };
 }

package/src/shared-agent.ts

@@ -0,0 +1,15 @@
+import type { Thread } from "./types";
+import type { AgentComment, AgentPromptRequest, ThreadAgentState } from "./thread-agent";
+
+/** Gateway requests retain their identity until the owner durably accepts them. */
+export interface SharedAgentRequest {
+  author: string;
+  params: AgentPromptRequest & { operationId: string };
+  comment?: AgentComment;
+}
+
+/** The owner receives a current artifact and the unacknowledged request outbox. */
+export type SharedAgentFrame =
+  | { type: "hello"; shareId: string }
+  | { type: "requests"; thread: Thread; requests: SharedAgentRequest[] }
+  | { type: "state"; state: ThreadAgentState; accepted?: string[] };

package/src/thread-agent.ts

@@ -43,6 +43,7 @@ export interface AgentPermission {
 export type AgentPhase =
   | { kind: "idle" }
   | { kind: "running" }
+  | { kind: "offline" }
   | { kind: "permission"; permission: AgentPermission }
   | { kind: "failed"; error: string };
 
@@ -67,6 +68,7 @@ export interface AgentSubmission {
   commentId?: string;
   messageId?: string;
   prompt: string;
+  harnessPrompt?: string;
   quote?: string;
   context?: string;
   status: "queued" | "running" | "completed" | "failed";
@@ -89,4 +91,7 @@ export interface AgentPromptRequest {
   context?: string;
   retry?: string;
   operationId?: string;
+  commentId?: string;
+  inputOnly?: boolean;
+  discussion?: string;
 }

package/src/types.ts

@@ -274,7 +274,7 @@ export interface Identity {
 }
 
 /** A share link's public or private policy; a private link with an empty allowlist admits no viewers. */
-export type SharePolicy = Pick<ShareLink, "requireAuth" | "allowlist">;
+export type SharePolicy = Pick<ShareLink, "requireAuth" | "allowlist" | "agentEnabled">;
 
 /**
  * One published share link for a thread. A thread can have several, each an
@@ -287,6 +287,7 @@ export interface ShareLink {
   name?: string;
   requireAuth: boolean;
   allowlist: string[];
+  agentEnabled?: boolean;
   owner?: string;
   shareBranch?: string;
 }