@xenosystem/agent-sdk 0.9.21 → 0.9.24

package/dist/session/index.d.cts

@@ -24,6 +24,33 @@ interface CompactionRecord {
     artifactReferences: string[];
     createdAt: string;
 }
+declare const WEB_CONTEXT_TOOL_RESULT_SCHEMA: "xeno.web-context.tool-result.v1";
+interface WebContextEvidenceProjection {
+    evidenceId: string;
+    requestId: string;
+    sourceUrl: string;
+    finalUrl?: string;
+    citations: Array<{
+        url: string;
+        title?: string;
+        artifactId?: string;
+    }>;
+}
+interface WebContextToolResult {
+    schemaVersion: typeof WEB_CONTEXT_TOOL_RESULT_SCHEMA;
+    operation: "search" | "fetch";
+    requestId: string;
+    evidence: WebContextEvidenceProjection;
+    job?: {
+        jobId: string;
+        state: string;
+    };
+    artifact?: {
+        artifactId: string;
+        mediaType: string;
+        bytes: number;
+    };
+}
 interface ImageUrlBlock {
     type: "image_url";
     image_url: {
@@ -107,6 +134,7 @@ interface ToolResultBlock {
     is_error?: boolean;
     operation?: ToolOperationSnapshot;
     evidence?: ToolEvidence[];
+    web_context?: WebContextToolResult;
     retryable?: boolean;
 }
 type ContentBlock = TextBlock | ToolUseBlock;
@@ -212,6 +240,7 @@ interface ContextCompressedData {
     messagesRemoved: number;
     tokensSaved: number;
     compaction?: CompactionRecord;
+    activeContextMessages?: Message[];
 }
 interface SessionEndData {
     reason: "user_exit" | "error" | "completed";
@@ -316,6 +345,16 @@ declare class TranscriptWriter {
         offset?: number;
     }): Promise<TranscriptEvent[]>;
     private isMessageData;
+    isMessageEvent(event: TranscriptEvent): event is TranscriptEvent & {
+        data: Message;
+    };
+    readValidated(): Promise<{
+        events: TranscriptEvent[];
+        issues: Array<{
+            code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence";
+            detail: string;
+        }>;
+    }>;
     getMessages(): Promise<Message[]>;
     replaceMessages(messages: Message[]): Promise<void>;
     truncateAfterMessageCount(messageCount: number): Promise<void>;
@@ -353,6 +392,7 @@ declare class SessionLock {
     private legacyLockPath;
     private sessionId;
     private heartbeatTimer?;
+    private acquiredOwner?;
     constructor(sessionDir: string);
     acquire(): Promise<void>;
     release(): Promise<void>;
@@ -393,18 +433,46 @@ declare class SessionRegistry {
     private static normalizeWorkingDirectory;
     private static deleteWorkspaceMirror;
 }
+type SessionRecoverySource = "transcript" | "checkpoint" | "empty";
+interface SessionRecoveryIssue {
+    code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence" | "interrupted_tool_call" | "checkpoint_fallback" | "divergent_checkpoint" | "stale_metadata" | "invalid_compaction_snapshot";
+    detail: string;
+}
+interface SessionRecoveryResult {
+    messages: Message[];
+    transcriptMessages: Message[];
+    source: SessionRecoverySource;
+    sourceId?: string;
+    issues: SessionRecoveryIssue[];
+    repairMessages: Message[];
+    transcriptEventCount: number;
+    latestTimestamp?: string;
+}
+declare function repairInterruptedToolCalls(messages: Message[]): {
+    messages: Message[];
+    repairs: Message[];
+    interruptedToolUseIds: string[];
+};
+declare function recoverSessionMessages(sessionDir: string, options?: {
+    metadataMessageCount?: number;
+}): Promise<SessionRecoveryResult>;
 declare class SessionManager {
     private sessionDir;
     private _meta;
     private _transcript;
     private _checkpoints;
     private _lock;
+    private _recovery;
+    private _detachedForHandoff;
     private constructor();
     static create(options: SessionCreateOptions): Promise<SessionManager>;
     static resume(options: SessionResumeOptions): Promise<SessionManager>;
     get meta(): SessionMeta;
     get transcript(): TranscriptWriter;
     get checkpoints(): CheckpointManager;
+    get recovery(): SessionRecoveryResult;
+    detachForHandoff(): Promise<void>;
+    get detachedForHandoff(): boolean;
     updateMeta(partial: Partial<SessionMeta>): Promise<void>;
     end(status?: "completed" | "abandoned"): Promise<void>;
     recordUserMessage(content: string): Promise<void>;
@@ -528,4 +596,4 @@ declare class TurnRestoreManager {
     private getBackupPath;
     private enqueue;
 }
-export { CheckpointManager, DIRECT_SHELL_CONTEXT_WARNING, MAX_DIRECT_SHELL_OUTPUT_CHARS, type RecentSessionEntry, type RecentSessionsIndex, type SessionCreateOptions, SessionLock, SessionManager, SessionRegistry, type SessionResumeOptions, TranscriptWriter, type TurnRestoreAvailability, type TurnRestoreFilePreview, TurnRestoreManager, type TurnRestorePoint, type TurnRestoreResult, createDirectShellMessage, forgetRecentSession, forgetRecentSessionById, formatDirectShellContext, generateSessionId, getRecentSessionsIndexPath, isDirectShellMessage, isValidSessionId, loadRecentSessionsIndex, lookupRecentSession, normalizeDirectShellResultRecord, normalizeWorkingDirectory, parseSessionId, readSessionFormatVersion, recordRecentSession };
+export { CheckpointManager, DIRECT_SHELL_CONTEXT_WARNING, MAX_DIRECT_SHELL_OUTPUT_CHARS, type RecentSessionEntry, type RecentSessionsIndex, type SessionCreateOptions, SessionLock, SessionManager, type SessionRecoveryIssue, type SessionRecoveryResult, type SessionRecoverySource, SessionRegistry, type SessionResumeOptions, TranscriptWriter, type TurnRestoreAvailability, type TurnRestoreFilePreview, TurnRestoreManager, type TurnRestorePoint, type TurnRestoreResult, createDirectShellMessage, forgetRecentSession, forgetRecentSessionById, formatDirectShellContext, generateSessionId, getRecentSessionsIndexPath, isDirectShellMessage, isValidSessionId, loadRecentSessionsIndex, lookupRecentSession, normalizeDirectShellResultRecord, normalizeWorkingDirectory, parseSessionId, readSessionFormatVersion, recordRecentSession, recoverSessionMessages, repairInterruptedToolCalls };

package/dist/session/index.d.ts

@@ -24,6 +24,33 @@ interface CompactionRecord {
     artifactReferences: string[];
     createdAt: string;
 }
+declare const WEB_CONTEXT_TOOL_RESULT_SCHEMA: "xeno.web-context.tool-result.v1";
+interface WebContextEvidenceProjection {
+    evidenceId: string;
+    requestId: string;
+    sourceUrl: string;
+    finalUrl?: string;
+    citations: Array<{
+        url: string;
+        title?: string;
+        artifactId?: string;
+    }>;
+}
+interface WebContextToolResult {
+    schemaVersion: typeof WEB_CONTEXT_TOOL_RESULT_SCHEMA;
+    operation: "search" | "fetch";
+    requestId: string;
+    evidence: WebContextEvidenceProjection;
+    job?: {
+        jobId: string;
+        state: string;
+    };
+    artifact?: {
+        artifactId: string;
+        mediaType: string;
+        bytes: number;
+    };
+}
 interface ImageUrlBlock {
     type: "image_url";
     image_url: {
@@ -107,6 +134,7 @@ interface ToolResultBlock {
     is_error?: boolean;
     operation?: ToolOperationSnapshot;
     evidence?: ToolEvidence[];
+    web_context?: WebContextToolResult;
     retryable?: boolean;
 }
 type ContentBlock = TextBlock | ToolUseBlock;
@@ -212,6 +240,7 @@ interface ContextCompressedData {
     messagesRemoved: number;
     tokensSaved: number;
     compaction?: CompactionRecord;
+    activeContextMessages?: Message[];
 }
 interface SessionEndData {
     reason: "user_exit" | "error" | "completed";
@@ -316,6 +345,16 @@ declare class TranscriptWriter {
         offset?: number;
     }): Promise<TranscriptEvent[]>;
     private isMessageData;
+    isMessageEvent(event: TranscriptEvent): event is TranscriptEvent & {
+        data: Message;
+    };
+    readValidated(): Promise<{
+        events: TranscriptEvent[];
+        issues: Array<{
+            code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence";
+            detail: string;
+        }>;
+    }>;
     getMessages(): Promise<Message[]>;
     replaceMessages(messages: Message[]): Promise<void>;
     truncateAfterMessageCount(messageCount: number): Promise<void>;
@@ -353,6 +392,7 @@ declare class SessionLock {
     private legacyLockPath;
     private sessionId;
     private heartbeatTimer?;
+    private acquiredOwner?;
     constructor(sessionDir: string);
     acquire(): Promise<void>;
     release(): Promise<void>;
@@ -393,18 +433,46 @@ declare class SessionRegistry {
     private static normalizeWorkingDirectory;
     private static deleteWorkspaceMirror;
 }
+type SessionRecoverySource = "transcript" | "checkpoint" | "empty";
+interface SessionRecoveryIssue {
+    code: "torn_transcript_tail" | "invalid_transcript_event" | "non_monotonic_sequence" | "interrupted_tool_call" | "checkpoint_fallback" | "divergent_checkpoint" | "stale_metadata" | "invalid_compaction_snapshot";
+    detail: string;
+}
+interface SessionRecoveryResult {
+    messages: Message[];
+    transcriptMessages: Message[];
+    source: SessionRecoverySource;
+    sourceId?: string;
+    issues: SessionRecoveryIssue[];
+    repairMessages: Message[];
+    transcriptEventCount: number;
+    latestTimestamp?: string;
+}
+declare function repairInterruptedToolCalls(messages: Message[]): {
+    messages: Message[];
+    repairs: Message[];
+    interruptedToolUseIds: string[];
+};
+declare function recoverSessionMessages(sessionDir: string, options?: {
+    metadataMessageCount?: number;
+}): Promise<SessionRecoveryResult>;
 declare class SessionManager {
     private sessionDir;
     private _meta;
     private _transcript;
     private _checkpoints;
     private _lock;
+    private _recovery;
+    private _detachedForHandoff;
     private constructor();
     static create(options: SessionCreateOptions): Promise<SessionManager>;
     static resume(options: SessionResumeOptions): Promise<SessionManager>;
     get meta(): SessionMeta;
     get transcript(): TranscriptWriter;
     get checkpoints(): CheckpointManager;
+    get recovery(): SessionRecoveryResult;
+    detachForHandoff(): Promise<void>;
+    get detachedForHandoff(): boolean;
     updateMeta(partial: Partial<SessionMeta>): Promise<void>;
     end(status?: "completed" | "abandoned"): Promise<void>;
     recordUserMessage(content: string): Promise<void>;
@@ -528,4 +596,4 @@ declare class TurnRestoreManager {
     private getBackupPath;
     private enqueue;
 }
-export { CheckpointManager, DIRECT_SHELL_CONTEXT_WARNING, MAX_DIRECT_SHELL_OUTPUT_CHARS, type RecentSessionEntry, type RecentSessionsIndex, type SessionCreateOptions, SessionLock, SessionManager, SessionRegistry, type SessionResumeOptions, TranscriptWriter, type TurnRestoreAvailability, type TurnRestoreFilePreview, TurnRestoreManager, type TurnRestorePoint, type TurnRestoreResult, createDirectShellMessage, forgetRecentSession, forgetRecentSessionById, formatDirectShellContext, generateSessionId, getRecentSessionsIndexPath, isDirectShellMessage, isValidSessionId, loadRecentSessionsIndex, lookupRecentSession, normalizeDirectShellResultRecord, normalizeWorkingDirectory, parseSessionId, readSessionFormatVersion, recordRecentSession };
+export { CheckpointManager, DIRECT_SHELL_CONTEXT_WARNING, MAX_DIRECT_SHELL_OUTPUT_CHARS, type RecentSessionEntry, type RecentSessionsIndex, type SessionCreateOptions, SessionLock, SessionManager, type SessionRecoveryIssue, type SessionRecoveryResult, type SessionRecoverySource, SessionRegistry, type SessionResumeOptions, TranscriptWriter, type TurnRestoreAvailability, type TurnRestoreFilePreview, TurnRestoreManager, type TurnRestorePoint, type TurnRestoreResult, createDirectShellMessage, forgetRecentSession, forgetRecentSessionById, formatDirectShellContext, generateSessionId, getRecentSessionsIndexPath, isDirectShellMessage, isValidSessionId, loadRecentSessionsIndex, lookupRecentSession, normalizeDirectShellResultRecord, normalizeWorkingDirectory, parseSessionId, readSessionFormatVersion, recordRecentSession, recoverSessionMessages, repairInterruptedToolCalls };