@xenosystem/agent-sdk 0.9.26 → 0.9.28

package/dist/electron/index.d.cts

@@ -394,6 +394,7 @@ interface SessionMeta {
     lastActivity: string;
     workingDirectory: string;
     model: string;
+    executionMode?: ExecutionMode;
     parentSession?: string;
     checkpoints: string[];
     messageCount: number;
@@ -1100,6 +1101,54 @@ declare class AuditLogger {
     exportJson(targetPath: string): Promise<number>;
     flush(): Promise<void>;
 }
+interface ToolContinuationGoal {
+    sessionId: string;
+    goalId: string;
+    requestId: string;
+}
+interface TranscriptBytePageOptions {
+    cursor?: string;
+    maxBytes?: number;
+    direction?: "forward" | "backward";
+}
+interface TranscriptBytePage {
+    encoding: "base64";
+    content: string;
+    direction: "forward" | "backward";
+    offset: number;
+    bytesRead: number;
+    totalBytes: number;
+    transcriptVersion: string;
+    nextCursor: string | null;
+}
+interface TranscriptRecordPageOptions {
+    cursor?: string;
+    maxBytes?: number;
+    maxRecords?: number;
+}
+interface TranscriptPageRecord {
+    offset: number;
+    bytes: number;
+    event: Readonly<Record<string, unknown>> & {
+        id: string;
+        timestamp: string;
+        type: string;
+        sequence: number;
+    };
+}
+interface TranscriptRecordPage {
+    cursor: string;
+    records: TranscriptPageRecord[];
+    issues: Array<{
+        code: "invalid_record" | "record_exceeds_page_budget";
+        offset: number;
+        bytes: number;
+    }>;
+    bytesRead: number;
+    totalBytes: number;
+    transcriptVersion: string;
+    nextCursor: string | null;
+}
 declare class TranscriptWriter {
     private sessionDir;
     private sessionId;
@@ -1121,6 +1170,8 @@ declare class TranscriptWriter {
     private resolveWorkspaceMarkdownPath;
     private appendMarkdownEvent;
     private buildMarkdownDocument;
+    readBytePage(options?: TranscriptBytePageOptions): Promise<TranscriptBytePage | null>;
+    readRecordPage(options?: TranscriptRecordPageOptions): Promise<TranscriptRecordPage | null>;
     read(options?: {
         types?: TranscriptEventType[];
         limit?: number;
@@ -1173,6 +1224,7 @@ interface SessionCreateOptions {
     parentSession?: string;
     workingDirectory: string;
     model: string;
+    executionMode?: ExecutionMode;
     hostBinding?: AgentSessionHostBindingV1;
 }
 interface SessionResumeOptions {
@@ -1270,6 +1322,23 @@ interface CompletionGuard {
     evaluate(ctx: CompletionGuardEvaluationContext): CompletionGuardDecision | null | undefined | Promise<CompletionGuardDecision | null | undefined>;
 }
 type CompressionLLMFn = (systemPrompt: string, messages: Message[]) => Promise<string>;
+interface ModelWorkRequestIdentity {
+    requestId: string;
+    turnId: string;
+    iteration: number;
+    model: string;
+}
+type ModelWorkSettlement = ModelWorkRequestIdentity & ({
+    status: "metered";
+    inputTokens: number;
+    outputTokens: number;
+} | {
+    status: "unknown";
+});
+interface ModelWorkAccounting {
+    admit(request: Readonly<ModelWorkRequestIdentity>, signal: AbortSignal): void | Promise<void>;
+    settle(result: Readonly<ModelWorkSettlement>, signal: AbortSignal): void | Promise<void>;
+}
 interface ModeSwitchRequest {
     from: ExecutionMode;
     to: ExecutionMode;
@@ -1292,6 +1361,7 @@ interface AgentLoopConfig {
     systemPrompt: string;
     requesterLabel?: string;
     ownerSessionId?: string;
+    getOwnerSessionId?: () => string | undefined;
     executionMode?: ExecutionMode;
     permissionEngine: PermissionEngine;
     toolRegistry?: ToolRegistry;
@@ -1300,6 +1370,7 @@ interface AgentLoopConfig {
     onToolWillExecute?: (name: string, input: Record<string, unknown>) => void | Promise<void>;
     onToolEnd?: (name: string, result: ToolResult) => void;
     onIteration?: (iteration: number, totalTokens: number) => void;
+    modelWorkAccounting?: ModelWorkAccounting;
     onError?: (error: Error, context: string) => void;
     onTranscriptError?: (error: Error, context: string) => void;
     onModeSwitchRequest?: (request: ModeSwitchRequest) => Promise<boolean>;
@@ -1383,12 +1454,16 @@ interface SessionIntegrationConfig {
 }
 interface AgentRunOptions {
     messageId?: string;
+    goalTurn?: ToolContinuationGoal;
+    continuationId?: string;
 }
 declare class AgentLoop {
     private config;
     private toolRegistry;
     private _messages;
     private totalInputTokens;
+    private modelWorkAttemptedRequests;
+    private modelWorkMeteredRequests;
     private totalOutputTokens;
     private lastRequestInputTokens;
     private pendingContextInjections;
@@ -1398,6 +1473,7 @@ declare class AgentLoop {
     private interruptionRequested;
     private currentTraceId;
     private lastRunTraceId;
+    private currentOwnerSessionId;
     private lastRunTerminationInfo;
     private activeTaskPrompt;
     private activeToolPolicy;
@@ -1424,6 +1500,11 @@ declare class AgentLoop {
         output: number;
         total: number;
     };
+    get modelWorkUsage(): {
+        attemptedRequests: number;
+        meteredRequests: number;
+        coverageComplete: boolean;
+    };
     get lastTraceId(): string | null;
     get lastRunTermination(): AgentRunTermination | null;
     get queryState(): QueryState;

package/dist/electron/index.d.ts

@@ -394,6 +394,7 @@ interface SessionMeta {
     lastActivity: string;
     workingDirectory: string;
     model: string;
+    executionMode?: ExecutionMode;
     parentSession?: string;
     checkpoints: string[];
     messageCount: number;
@@ -1100,6 +1101,54 @@ declare class AuditLogger {
     exportJson(targetPath: string): Promise<number>;
     flush(): Promise<void>;
 }
+interface ToolContinuationGoal {
+    sessionId: string;
+    goalId: string;
+    requestId: string;
+}
+interface TranscriptBytePageOptions {
+    cursor?: string;
+    maxBytes?: number;
+    direction?: "forward" | "backward";
+}
+interface TranscriptBytePage {
+    encoding: "base64";
+    content: string;
+    direction: "forward" | "backward";
+    offset: number;
+    bytesRead: number;
+    totalBytes: number;
+    transcriptVersion: string;
+    nextCursor: string | null;
+}
+interface TranscriptRecordPageOptions {
+    cursor?: string;
+    maxBytes?: number;
+    maxRecords?: number;
+}
+interface TranscriptPageRecord {
+    offset: number;
+    bytes: number;
+    event: Readonly<Record<string, unknown>> & {
+        id: string;
+        timestamp: string;
+        type: string;
+        sequence: number;
+    };
+}
+interface TranscriptRecordPage {
+    cursor: string;
+    records: TranscriptPageRecord[];
+    issues: Array<{
+        code: "invalid_record" | "record_exceeds_page_budget";
+        offset: number;
+        bytes: number;
+    }>;
+    bytesRead: number;
+    totalBytes: number;
+    transcriptVersion: string;
+    nextCursor: string | null;
+}
 declare class TranscriptWriter {
     private sessionDir;
     private sessionId;
@@ -1121,6 +1170,8 @@ declare class TranscriptWriter {
     private resolveWorkspaceMarkdownPath;
     private appendMarkdownEvent;
     private buildMarkdownDocument;
+    readBytePage(options?: TranscriptBytePageOptions): Promise<TranscriptBytePage | null>;
+    readRecordPage(options?: TranscriptRecordPageOptions): Promise<TranscriptRecordPage | null>;
     read(options?: {
         types?: TranscriptEventType[];
         limit?: number;
@@ -1173,6 +1224,7 @@ interface SessionCreateOptions {
     parentSession?: string;
     workingDirectory: string;
     model: string;
+    executionMode?: ExecutionMode;
     hostBinding?: AgentSessionHostBindingV1;
 }
 interface SessionResumeOptions {
@@ -1270,6 +1322,23 @@ interface CompletionGuard {
     evaluate(ctx: CompletionGuardEvaluationContext): CompletionGuardDecision | null | undefined | Promise<CompletionGuardDecision | null | undefined>;
 }
 type CompressionLLMFn = (systemPrompt: string, messages: Message[]) => Promise<string>;
+interface ModelWorkRequestIdentity {
+    requestId: string;
+    turnId: string;
+    iteration: number;
+    model: string;
+}
+type ModelWorkSettlement = ModelWorkRequestIdentity & ({
+    status: "metered";
+    inputTokens: number;
+    outputTokens: number;
+} | {
+    status: "unknown";
+});
+interface ModelWorkAccounting {
+    admit(request: Readonly<ModelWorkRequestIdentity>, signal: AbortSignal): void | Promise<void>;
+    settle(result: Readonly<ModelWorkSettlement>, signal: AbortSignal): void | Promise<void>;
+}
 interface ModeSwitchRequest {
     from: ExecutionMode;
     to: ExecutionMode;
@@ -1292,6 +1361,7 @@ interface AgentLoopConfig {
     systemPrompt: string;
     requesterLabel?: string;
     ownerSessionId?: string;
+    getOwnerSessionId?: () => string | undefined;
     executionMode?: ExecutionMode;
     permissionEngine: PermissionEngine;
     toolRegistry?: ToolRegistry;
@@ -1300,6 +1370,7 @@ interface AgentLoopConfig {
     onToolWillExecute?: (name: string, input: Record<string, unknown>) => void | Promise<void>;
     onToolEnd?: (name: string, result: ToolResult) => void;
     onIteration?: (iteration: number, totalTokens: number) => void;
+    modelWorkAccounting?: ModelWorkAccounting;
     onError?: (error: Error, context: string) => void;
     onTranscriptError?: (error: Error, context: string) => void;
     onModeSwitchRequest?: (request: ModeSwitchRequest) => Promise<boolean>;
@@ -1383,12 +1454,16 @@ interface SessionIntegrationConfig {
 }
 interface AgentRunOptions {
     messageId?: string;
+    goalTurn?: ToolContinuationGoal;
+    continuationId?: string;
 }
 declare class AgentLoop {
     private config;
     private toolRegistry;
     private _messages;
     private totalInputTokens;
+    private modelWorkAttemptedRequests;
+    private modelWorkMeteredRequests;
     private totalOutputTokens;
     private lastRequestInputTokens;
     private pendingContextInjections;
@@ -1398,6 +1473,7 @@ declare class AgentLoop {
     private interruptionRequested;
     private currentTraceId;
     private lastRunTraceId;
+    private currentOwnerSessionId;
     private lastRunTerminationInfo;
     private activeTaskPrompt;
     private activeToolPolicy;
@@ -1424,6 +1500,11 @@ declare class AgentLoop {
         output: number;
         total: number;
     };
+    get modelWorkUsage(): {
+        attemptedRequests: number;
+        meteredRequests: number;
+        coverageComplete: boolean;
+    };
     get lastTraceId(): string | null;
     get lastRunTermination(): AgentRunTermination | null;
     get queryState(): QueryState;