@markusylisiurunen/tau 0.3.41 → 0.3.43

package/dist/protocol/session_protocol.d.ts

@@ -1,5 +1,5 @@
 import type { AssistantMessage, Message, TextContent, ThinkingContent, Tool, ToolCall } from "@earendil-works/pi-ai";
-export declare const SESSION_PROTOCOL_VERSION: 8;
+export declare const SESSION_PROTOCOL_VERSION: 9;
 export declare const SESSION_PROTOCOL_MAX_EXEC_CAPTURE_BYTES: number;
 export declare const SESSION_PROTOCOL_MAX_EXEC_STDIN_BYTES: number;
 export declare const SESSION_PROTOCOL_METHODS: readonly ["initialize", "session.create", "session.list", "session.observe", "session.unobserve", "session.record", "session.submit", "session.queue", "session.steer", "session.cancelPendingMessages", "session.retry", "session.exec", "session.cancelExec", "session.sample", "session.interrupt", "session.snapshot", "session.startGoal", "session.resumeGoal", "session.clearGoal", "session.setReasoning", "session.setPersona", "session.resolvePrompt", "session.autocompletePaths", "session.reload", "session.compact", "session.rewind", "session.interruptSubagent", "session.ephemeral.create", "session.ephemeral.submit", "session.ephemeral.close", "session.clientTool.ack", "session.clientTool.result"];
@@ -290,35 +290,87 @@ export type SessionProtocolMessage = {
     state: SessionProtocolMessageState;
     modelVisible: boolean;
     message: SessionProtocolMessagePayload;
-    turn?: SessionProtocolTurnOutcome;
 };
+export type SessionProtocolSubject = {
+    type: "session";
+} | {
+    type: "message";
+    id: string;
+} | {
+    type: "tool";
+    id: string;
+} | {
+    type: "agent";
+    id: string;
+} | {
+    type: "operation";
+    id: string;
+};
+export type SessionProtocolTimelineNotice = {
+    kind: string;
+    version: number;
+    severity: "info" | "warn" | "error";
+    subject: SessionProtocolSubject;
+    presentation: {
+        title: string;
+        content?: string[];
+    };
+    data: Record<string, unknown>;
+};
+export declare function projectSessionProtocolNoticePresentation(title: string, content?: readonly string[]): SessionProtocolTimelineNotice["presentation"];
 export type SessionProtocolTimelineItem = {
     type: "message";
     id: string;
+    sequence: number;
+    createdAt: number;
     messageId: string;
+} | {
+    type: "tool";
+    id: string;
+    sequence: number;
+    createdAt: number;
+    toolId: string;
 } | {
     type: "notice";
     id: string;
-    notice: SessionProtocolNotice;
+    sequence: number;
+    createdAt: number;
+    notice: SessionProtocolTimelineNotice;
 } | {
     type: "operation";
     id: string;
-    operation: SessionProtocolOperation;
+    sequence: number;
+    createdAt: number;
+    operationId: string;
 };
-export type SessionProtocolNotice = {
-    severity: "info" | "warn" | "error";
-    text: string;
-    timestamp: number;
+export type SessionProtocolTimeline = {
+    epoch: number;
+    sequence: number;
+    items: SessionProtocolTimelineItem[];
 };
-export type SessionProtocolOperation = {
+type SessionProtocolOperationBase = {
+    id: string;
     kind: "auto-compaction" | "manual-compaction" | "reload" | "rewind";
-    status: "running" | "succeeded" | "failed" | "cancelled" | "skipped";
     startedAt: number;
-    finishedAt?: number;
-    summary?: string;
-    error?: string;
-    data?: Record<string, unknown>;
 };
+export type SessionProtocolOperation = SessionProtocolOperationBase & ({
+    status: "running";
+} | {
+    status: "succeeded";
+    finishedAt: number;
+} | {
+    status: "failed";
+    finishedAt: number;
+    error: string;
+} | {
+    status: "skipped";
+    finishedAt: number;
+    reason: "no-eligible-history";
+} | {
+    status: "cancelled";
+    finishedAt: number;
+    reason: "interrupted" | "session-recovered";
+});
 export type SessionProtocolPromptCompositionSnapshot = {
     environmentTag: string;
     subagentPrompts: Record<string, string>;
@@ -419,10 +471,10 @@ export type SessionProtocolFlySpriteExecutionEnvironmentSnapshot = {
 export type SessionProtocolExecutionEnvironmentSnapshot = SessionProtocolLocalExecutionEnvironmentSnapshot | SessionProtocolCloudflareSandboxExecutionEnvironmentSnapshot | SessionProtocolFlySpriteExecutionEnvironmentSnapshot;
 export type SessionProtocolAgentStateSnapshot = {
     revision: number;
-    contextEpoch: string;
+    modelContextKey: string;
     usageCheckpoint?: {
         historyEntryId: string;
-        contextEpoch: string;
+        modelContextKey: string;
         tokens: number;
     };
 };
@@ -444,8 +496,9 @@ export type SessionProtocolSnapshot = {
     catalog: SessionProtocolContentCatalogSnapshot;
     executionEnvironment: SessionProtocolExecutionEnvironmentSnapshot;
     messages: SessionProtocolMessage[];
-    timeline: SessionProtocolTimelineItem[];
+    timeline: SessionProtocolTimeline;
     tools: Record<string, SessionProtocolToolRun>;
+    operations: Record<string, SessionProtocolOperation>;
     agents: Record<string, SessionProtocolAgentRun>;
     facets: Record<string, SessionProtocolFacet>;
 };
@@ -531,21 +584,7 @@ export type SessionProtocolAgentRun = {
         contextWindow: number;
     };
 };
-export type SessionProtocolFacetSubject = {
-    type: "session";
-} | {
-    type: "message";
-    id: string;
-} | {
-    type: "tool";
-    id: string;
-} | {
-    type: "agent";
-    id: string;
-} | {
-    type: "operation";
-    id: string;
-};
+export type SessionProtocolFacetSubject = SessionProtocolSubject;
 export type SessionProtocolFacet = {
     id: string;
     subject: SessionProtocolFacetSubject;
@@ -673,7 +712,22 @@ export type SessionProtocolParsedSuccessResponseMessage = Omit<SessionProtocolSu
     result: unknown;
 };
 export type SessionProtocolParsedResponseMessage = SessionProtocolParsedSuccessResponseMessage | SessionProtocolErrorResponseMessage;
-export type SessionProtocolDeltaReason = "user-message" | "assistant-stream" | "assistant-message" | "tool-run" | "tool-result" | "notice" | "agent-run" | "maintenance" | "configuration" | "goal" | "recovery";
+export type SessionProtocolDeltaCause = {
+    type: "user-message" | "assistant-stream" | "assistant-message" | "tool-run" | "tool-result" | "notice" | "agent-run" | "maintenance" | "configuration" | "goal";
+} | {
+    type: "compaction";
+    previousEpoch: number;
+    epoch: number;
+    kind: "auto" | "manual";
+    cutType: "turn-boundary" | "split-turn";
+    retainedMessageCount: number;
+} | {
+    type: "rewind";
+    epoch: number;
+    cutoffSequence: number;
+} | {
+    type: "resync";
+};
 export type SessionProtocolChange = {
     type: "agent-state.set";
     agentState: SessionProtocolAgentStateSnapshot;
@@ -692,7 +746,6 @@ export type SessionProtocolChange = {
 } | {
     type: "message.append";
     message: SessionProtocolMessage;
-    timelineItem?: SessionProtocolTimelineItem;
 } | {
     type: "message.replace";
     message: SessionProtocolMessage;
@@ -705,18 +758,25 @@ export type SessionProtocolChange = {
 } | {
     type: "timeline.append";
     item: SessionProtocolTimelineItem;
-} | {
-    type: "timeline.replace";
-    item: SessionProtocolTimelineItem;
 } | {
     type: "timeline.remove";
     id: string;
+} | {
+    type: "timeline.advance";
+    epoch: number;
+    sequence: number;
 } | {
     type: "tool.set";
     tool: SessionProtocolToolRun;
 } | {
     type: "tool.remove";
     id: string;
+} | {
+    type: "operation.set";
+    operation: SessionProtocolOperation;
+} | {
+    type: "operation.remove";
+    id: string;
 } | {
     type: "agent.set";
     agent: SessionProtocolAgentRun;
@@ -743,7 +803,7 @@ export type SessionProtocolDeltaMessage = {
     sessionId: string;
     fromRevision: number | null;
     toRevision: number;
-    reason: SessionProtocolDeltaReason;
+    cause: SessionProtocolDeltaCause;
     delta: SessionProtocolDelta;
 };
 export type SessionProtocolReadyMessage = {
@@ -786,7 +846,22 @@ export type SessionProtocolEphemeralAgentThreadUpdateEvent = {
         lastActivityText?: string;
     };
 };
-export type SessionProtocolEphemeralEvent = SessionProtocolEphemeralAgentThreadUpdateEvent;
+export type SessionProtocolFeedbackTone = "default" | "error";
+export type SessionProtocolFeedbackEvent = {
+    type: "feedback.notice";
+    title: string;
+    tone: SessionProtocolFeedbackTone;
+    presentation: "footer";
+    durationMs: number;
+};
+export type SessionProtocolEphemeralTimelineEvent = {
+    type: "timeline.item";
+    epoch: number;
+    item: Extract<SessionProtocolTimelineItem, {
+        type: "notice";
+    }>;
+};
+export type SessionProtocolEphemeralEvent = SessionProtocolEphemeralAgentThreadUpdateEvent | SessionProtocolFeedbackEvent | SessionProtocolEphemeralTimelineEvent;
 export type SessionProtocolEphemeralMessage = {
     version: typeof SESSION_PROTOCOL_VERSION;
     type: "session.ephemeral";
@@ -846,7 +921,7 @@ export declare function createSessionProtocolDeltaMessage(options: {
     sessionId: string;
     fromRevision: number | null;
     toRevision: number;
-    reason: SessionProtocolDeltaReason;
+    cause: SessionProtocolDeltaCause;
     delta: SessionProtocolDelta;
 }): SessionProtocolDeltaMessage;
 export declare function createSessionProtocolEphemeralMessage(options: {