@cueloop/schema 0.1.0-alpha.98 → 0.1.0-alpha.99

package/package.json

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

package/src/agent-comment.ts

@@ -5,8 +5,10 @@ import type { AgentComment, ThreadAgentState } from "./thread-agent";
 /** Submitted bottom prompts are discussion roots without duplicating them in stored comments. */
 export function agentCommentRoot(state: ThreadAgentState, id: string): AgentComment | undefined {
   const comment = state.comments.find((entry) => entry.id === id);
+
   if (comment) return comment;
   const submission = state.submissions?.find((entry) => entry.id === id && entry.commentId === id);
+
   if (!submission) return undefined;
   const blocks = parseBlocks(submission.prompt);
   const anchor = makeAnchor(blocks, 0, 0, Math.min(blocks[0]?.text.length ?? 0, 32768));

package/src/thread-agent.ts

@@ -1,4 +1,4 @@
-import type { Anchor } from "./types";
+import type { Anchor, OperationReceipt } from "./types";
 
 /** An agent message keeps its identity after streaming and across reconnects. */
 export interface AgentMessage {
@@ -56,6 +56,10 @@ export interface ThreadAgentState {
   tools: AgentTool[];
   comments: AgentComment[];
   submissions?: AgentSubmission[];
+  /** Original accepted submission identities survive acknowledgement loss and daemon restart. */
+  promptOperations?: (OperationReceipt<string[]> & {
+    outcome?: "completed" | "failed" | "cancelled";
+  })[];
   configOptions?: AgentConfigOption[];
 }
 
@@ -68,6 +72,8 @@ export interface AgentSubmission {
   quote?: string;
   context?: string;
   status: "queued" | "running" | "completed" | "failed";
+  /** Explicit cancellation is terminal without changing legacy retry status. */
+  cancelled?: boolean;
 }
 
 /** Model and reasoning choices are advertised by the harness, never invented by the UI. */
@@ -78,3 +84,12 @@ export interface AgentConfigOption {
   currentValue: string;
   options: { value: string; name: string }[];
 }
+
+/** Prompt submission preserves operation identity while optional context remains separate from input. */
+export interface AgentPromptRequest {
+  id: string;
+  text: string;
+  context?: string;
+  retry?: string;
+  operationId?: string;
+}

package/src/types.ts

@@ -226,6 +226,7 @@ export interface Annotation {
 }
 
 export const REVIEW_SEVERITIES = ["p0", "p1", "p2"] as const;
+
 export type ReviewSeverity = (typeof REVIEW_SEVERITIES)[number];
 
 /** Data needed to render and publish one agent-authored pull request comment. */
@@ -281,8 +282,16 @@ export interface PendingDelivery {
 }
 
 export const MESSAGE_OUTCOMES = ["comment", "approved", "changes_requested"] as const;
+
 export type MessageOutcome = (typeof MESSAGE_OUTCOMES)[number];
 
+/** Durable acceptance records are committed together with the mutation they identify. */
+export interface OperationReceipt<Result> {
+  operationId: string;
+  fingerprint: string;
+  result: Result;
+}
+
 export interface Message {
   /** Stable identity used to deduplicate at-least-once harness delivery. */
   id: string;
@@ -387,6 +396,8 @@ export interface Thread {
    * progress. Undefined = the walk never started.
    */
   viewedPaths?: string[];
+  /** Acceptance receipts persist atomically with review messages for safe explicit retries. */
+  messageOperations?: OperationReceipt<Message>[];
   message: Message | null;
   status: SessionStatus;
   createdAt: string;