@xenosystem/agent-sdk 0.9.21 → 0.9.22

package/dist/electron/index.d.cts

@@ -74,6 +74,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;
+    };
+}
 type PermissionProfileName = "default" | "read-only" | "trusted-dev";
 type PermissionProfileDecision = "allow" | "ask" | "deny";
 type PermissionProfileMode = "default" | "acceptEdits" | "bypassPermissions" | "auto";
@@ -219,6 +246,7 @@ interface ToolResult {
     assistantOnlyContent?: ToolAssistantContentBlock[];
     operation?: ToolOperationSnapshot;
     evidence?: ToolEvidence[];
+    webContext?: WebContextToolResult;
     retryable?: boolean;
 }
 interface ToolExecutionContext {
@@ -262,6 +290,7 @@ interface ToolResultBlock {
     is_error?: boolean;
     operation?: ToolOperationSnapshot;
     evidence?: ToolEvidence[];
+    web_context?: WebContextToolResult;
     retryable?: boolean;
 }
 type ContentBlock = TextBlock | ToolUseBlock;
@@ -947,6 +976,7 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
     success: boolean;
     outputPreview: string;
     error?: string;
+    webContext?: WebContextToolResult;
     elapsedMs: number;
     iteration?: number;
 }) | (XenoRuntimeEventBase & {
@@ -1080,6 +1110,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>;
@@ -1122,18 +1162,34 @@ interface SessionResumeOptions {
     sessionId: string;
     fromCheckpoint?: string;
 }
+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";
+    detail: string;
+}
+interface SessionRecoveryResult {
+    messages: Message[];
+    source: SessionRecoverySource;
+    sourceId?: string;
+    issues: SessionRecoveryIssue[];
+    repairMessages: Message[];
+    transcriptEventCount: number;
+    latestTimestamp?: string;
+}
 declare class SessionManager {
     private sessionDir;
     private _meta;
     private _transcript;
     private _checkpoints;
     private _lock;
+    private _recovery;
     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;
     updateMeta(partial: Partial<SessionMeta>): Promise<void>;
     end(status?: "completed" | "abandoned"): Promise<void>;
     recordUserMessage(content: string): Promise<void>;

package/dist/electron/index.d.ts

@@ -74,6 +74,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;
+    };
+}
 type PermissionProfileName = "default" | "read-only" | "trusted-dev";
 type PermissionProfileDecision = "allow" | "ask" | "deny";
 type PermissionProfileMode = "default" | "acceptEdits" | "bypassPermissions" | "auto";
@@ -219,6 +246,7 @@ interface ToolResult {
     assistantOnlyContent?: ToolAssistantContentBlock[];
     operation?: ToolOperationSnapshot;
     evidence?: ToolEvidence[];
+    webContext?: WebContextToolResult;
     retryable?: boolean;
 }
 interface ToolExecutionContext {
@@ -262,6 +290,7 @@ interface ToolResultBlock {
     is_error?: boolean;
     operation?: ToolOperationSnapshot;
     evidence?: ToolEvidence[];
+    web_context?: WebContextToolResult;
     retryable?: boolean;
 }
 type ContentBlock = TextBlock | ToolUseBlock;
@@ -947,6 +976,7 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
     success: boolean;
     outputPreview: string;
     error?: string;
+    webContext?: WebContextToolResult;
     elapsedMs: number;
     iteration?: number;
 }) | (XenoRuntimeEventBase & {
@@ -1080,6 +1110,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>;
@@ -1122,18 +1162,34 @@ interface SessionResumeOptions {
     sessionId: string;
     fromCheckpoint?: string;
 }
+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";
+    detail: string;
+}
+interface SessionRecoveryResult {
+    messages: Message[];
+    source: SessionRecoverySource;
+    sourceId?: string;
+    issues: SessionRecoveryIssue[];
+    repairMessages: Message[];
+    transcriptEventCount: number;
+    latestTimestamp?: string;
+}
 declare class SessionManager {
     private sessionDir;
     private _meta;
     private _transcript;
     private _checkpoints;
     private _lock;
+    private _recovery;
     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;
     updateMeta(partial: Partial<SessionMeta>): Promise<void>;
     end(status?: "completed" | "abandoned"): Promise<void>;
     recordUserMessage(content: string): Promise<void>;