@xenosystem/agent-sdk 0.10.37 → 0.10.39

package/dist/electron/index.d.cts

@@ -52,6 +52,64 @@ interface XenoRequestContext {
         readonly name: string;
         readonly version: string;
     };
+    readonly headers?: Readonly<Record<string, string>>;
+}
+type AgentChildOutcome = "completed" | "failed" | "timeout" | "cancelled" | "incomplete";
+interface AgentChildTokenUsage {
+    input: number;
+    output: number;
+    total: number;
+}
+type BackgroundDispatchStatus = "running" | AgentChildOutcome;
+interface BackgroundDispatchReport {
+    dispatchId: string;
+    agent?: string;
+    promptPreview: string;
+    outcome: AgentChildOutcome;
+    output?: string;
+    error?: string;
+    errorCode?: string;
+    reason?: string;
+    durationMs: number;
+    tokenUsage?: AgentChildTokenUsage;
+}
+interface BackgroundDispatchSettlement {
+    outcome: AgentChildOutcome;
+    output?: string;
+    error?: string;
+    errorCode?: string;
+    reason?: string;
+    tokenUsage?: AgentChildTokenUsage;
+}
+interface BackgroundDispatchRecord {
+    dispatchId: string;
+    agent?: string;
+    promptPreview: string;
+    startedAt: number;
+    status: BackgroundDispatchStatus;
+    report?: BackgroundDispatchReport;
+}
+interface BackgroundDispatchHandle {
+    readonly dispatchId: string;
+    settle(result: BackgroundDispatchSettlement): void;
+}
+interface BackgroundDispatchRegistry {
+    start(info: {
+        dispatchId: string;
+        agent?: string;
+        promptPreview: string;
+    }, cancel: (reason?: string) => void): BackgroundDispatchHandle;
+    get(dispatchId: string): BackgroundDispatchRecord | undefined;
+    list(): BackgroundDispatchRecord[];
+    wait(dispatchId: string, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<BackgroundDispatchRecord | undefined>;
+    cancel(dispatchId: string, reason?: string): boolean;
+    cancelAll(reason?: string): number;
+    markConsumed(dispatchId: string): void;
+    isConsumed(dispatchId: string): boolean;
+    onReport(listener: (report: BackgroundDispatchReport) => void): () => void;
 }
 type TokenEstimator = (text: string, model: string) => number;
 type TokenAccountingSource = "exact" | "provider-reported" | "estimated";
@@ -693,6 +751,11 @@ interface MemoryManagerOptions {
         maxCharsPerSession?: number;
     };
 }
+interface PromptMemoryBundle {
+    resolved: ResolvedMemory;
+    projectSessionContext?: ProjectSessionContext;
+    prompt: string;
+}
 type MemoryAccessScope = "none" | "session" | "project" | "user";
 declare class MemoryManager {
     private cwd;
@@ -719,6 +782,11 @@ declare class MemoryManager {
         maxTokens?: number;
         maxCharsPerSession?: number;
     }): Promise<ProjectSessionContext>;
+    private readRecentTranscriptExcerpt;
+    loadPromptBundle(options?: {
+        excludeSessionId?: string;
+        includeProjectSessionContext?: boolean;
+    }): Promise<PromptMemoryBundle>;
     private filterProjectSessions;
     private normalizePath;
     private extractRecentTranscriptExcerpt;
@@ -1085,6 +1153,8 @@ interface LlmClientDeps {
 declare class LlmClient {
     private deps;
     constructor(deps: LlmClientDeps);
+    setRequestContext(context: Readonly<XenoRequestContext> | undefined): void;
+    getRequestContext(): Readonly<XenoRequestContext> | undefined;
     configureAuthorization(options: Pick<LlmClientDeps, "apiKey" | "authorizeRequest">): void;
     private localGrammarProbe?;
     readonly id = "xeno-llm-client";
@@ -1235,7 +1305,7 @@ interface LLMProvider {
 type QueryState = "idle" | "preparing" | "building_context" | "requesting_model" | "retrying" | "executing_tools" | "waiting_for_tool" | "evaluating_completion" | "finalizing" | "suspended" | "completed" | "failed" | "interrupted";
 type QueryWatchdogReason = "idle" | "lease" | "hard";
 type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled" | "tool.operation.outcome_unknown";
-type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
+type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "dispatch.settled" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
 interface XenoRuntimeEventBase {
     id: string;
     sequence: number;
@@ -1280,6 +1350,16 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
     deferred: boolean;
     turnId?: string;
     iteration?: number;
+}) | (XenoRuntimeEventBase & {
+    type: "dispatch.settled";
+    dispatchId: string;
+    outcome: "completed" | "failed" | "timeout" | "cancelled" | "incomplete";
+    agent?: string;
+    errorCode?: string;
+    turnActive: boolean;
+    delivery: "injected" | "queued";
+    durationMs: number;
+    summary: string;
 }) | (XenoRuntimeEventBase & {
     type: "context.history.compacted";
     turnId?: string;
@@ -1849,6 +1929,9 @@ declare class AgentLoop {
     private totalOutputTokens;
     private lastRequestInputTokens;
     private pendingContextInjections;
+    private dispatchRegistry;
+    private dispatchUnsubscribe;
+    private activeRunCount;
     private lastCheckpointMessageCount;
     private ollamaBaseUrl;
     private activeAbortController;
@@ -1892,6 +1975,8 @@ declare class AgentLoop {
     createSoftBudgetCloudProvider(): LLMProvider;
     private callCloudWithOutputCap;
     private requestStreams;
+    setRequestContext(context: XenoRequestContext): void;
+    getRequestContext(): Readonly<XenoRequestContext> | undefined;
     configureModelExecution(options: {
         provider?: LLMProvider;
         modelWorkAccounting?: ModelWorkAccounting;
@@ -1913,6 +1998,8 @@ declare class AgentLoop {
     set executionMode(value: ExecutionMode);
     get systemPrompt(): string;
     set systemPrompt(value: string);
+    private promptGate;
+    holdRunUntil(gate: Promise<void>): void;
     use(middleware: ToolMiddleware): this;
     registerPromptSection(provider: PromptSectionProvider): this;
     registerCompletionGuard(guard: CompletionGuard): this;
@@ -1976,10 +2063,13 @@ declare class AgentLoop {
         content: string;
         sourceNodeId?: string;
         label?: string;
+        dispatchId?: string;
     }): Promise<{
         status: "injected" | "deferred";
         pendingCount: number;
     }>;
+    attachBackgroundDispatch(registry: BackgroundDispatchRegistry): () => void;
+    private deliverBackgroundDispatchReport;
     get pendingContextInjectionCount(): number;
     private flushContextInjections;
     get messages(): Message[];

package/dist/electron/index.d.ts

@@ -52,6 +52,64 @@ interface XenoRequestContext {
         readonly name: string;
         readonly version: string;
     };
+    readonly headers?: Readonly<Record<string, string>>;
+}
+type AgentChildOutcome = "completed" | "failed" | "timeout" | "cancelled" | "incomplete";
+interface AgentChildTokenUsage {
+    input: number;
+    output: number;
+    total: number;
+}
+type BackgroundDispatchStatus = "running" | AgentChildOutcome;
+interface BackgroundDispatchReport {
+    dispatchId: string;
+    agent?: string;
+    promptPreview: string;
+    outcome: AgentChildOutcome;
+    output?: string;
+    error?: string;
+    errorCode?: string;
+    reason?: string;
+    durationMs: number;
+    tokenUsage?: AgentChildTokenUsage;
+}
+interface BackgroundDispatchSettlement {
+    outcome: AgentChildOutcome;
+    output?: string;
+    error?: string;
+    errorCode?: string;
+    reason?: string;
+    tokenUsage?: AgentChildTokenUsage;
+}
+interface BackgroundDispatchRecord {
+    dispatchId: string;
+    agent?: string;
+    promptPreview: string;
+    startedAt: number;
+    status: BackgroundDispatchStatus;
+    report?: BackgroundDispatchReport;
+}
+interface BackgroundDispatchHandle {
+    readonly dispatchId: string;
+    settle(result: BackgroundDispatchSettlement): void;
+}
+interface BackgroundDispatchRegistry {
+    start(info: {
+        dispatchId: string;
+        agent?: string;
+        promptPreview: string;
+    }, cancel: (reason?: string) => void): BackgroundDispatchHandle;
+    get(dispatchId: string): BackgroundDispatchRecord | undefined;
+    list(): BackgroundDispatchRecord[];
+    wait(dispatchId: string, options?: {
+        timeoutMs?: number;
+        signal?: AbortSignal;
+    }): Promise<BackgroundDispatchRecord | undefined>;
+    cancel(dispatchId: string, reason?: string): boolean;
+    cancelAll(reason?: string): number;
+    markConsumed(dispatchId: string): void;
+    isConsumed(dispatchId: string): boolean;
+    onReport(listener: (report: BackgroundDispatchReport) => void): () => void;
 }
 type TokenEstimator = (text: string, model: string) => number;
 type TokenAccountingSource = "exact" | "provider-reported" | "estimated";
@@ -693,6 +751,11 @@ interface MemoryManagerOptions {
         maxCharsPerSession?: number;
     };
 }
+interface PromptMemoryBundle {
+    resolved: ResolvedMemory;
+    projectSessionContext?: ProjectSessionContext;
+    prompt: string;
+}
 type MemoryAccessScope = "none" | "session" | "project" | "user";
 declare class MemoryManager {
     private cwd;
@@ -719,6 +782,11 @@ declare class MemoryManager {
         maxTokens?: number;
         maxCharsPerSession?: number;
     }): Promise<ProjectSessionContext>;
+    private readRecentTranscriptExcerpt;
+    loadPromptBundle(options?: {
+        excludeSessionId?: string;
+        includeProjectSessionContext?: boolean;
+    }): Promise<PromptMemoryBundle>;
     private filterProjectSessions;
     private normalizePath;
     private extractRecentTranscriptExcerpt;
@@ -1085,6 +1153,8 @@ interface LlmClientDeps {
 declare class LlmClient {
     private deps;
     constructor(deps: LlmClientDeps);
+    setRequestContext(context: Readonly<XenoRequestContext> | undefined): void;
+    getRequestContext(): Readonly<XenoRequestContext> | undefined;
     configureAuthorization(options: Pick<LlmClientDeps, "apiKey" | "authorizeRequest">): void;
     private localGrammarProbe?;
     readonly id = "xeno-llm-client";
@@ -1235,7 +1305,7 @@ interface LLMProvider {
 type QueryState = "idle" | "preparing" | "building_context" | "requesting_model" | "retrying" | "executing_tools" | "waiting_for_tool" | "evaluating_completion" | "finalizing" | "suspended" | "completed" | "failed" | "interrupted";
 type QueryWatchdogReason = "idle" | "lease" | "hard";
 type ToolOperationRuntimeEventType = "tool.operation.started" | "tool.operation.progress" | "tool.operation.promotion_requested" | "tool.operation.promoted" | "tool.operation.stalled" | "tool.operation.verifying" | "tool.operation.completed" | "tool.operation.failed" | "tool.operation.timed_out" | "tool.operation.cancelled" | "tool.operation.outcome_unknown";
-type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
+type XenoRuntimeEventType = "thread.started" | "turn.started" | "turn.completed" | "turn.failed" | "turn.interrupted" | "query.state" | "query.watchdog" | "provider.event" | "model.text.delta" | "context.pressure" | "context.injected" | "context.history.compacted" | "dispatch.settled" | "tool.started" | "tool.permission" | "tool.completed" | "tool.history.repaired" | "tool.failure_guard.tripped" | ToolOperationRuntimeEventType | "turn.suspended" | "turn.continuation_enqueued" | "turn.continuation_resumed" | "turn.continuation_exhausted" | "diff.completed";
 interface XenoRuntimeEventBase {
     id: string;
     sequence: number;
@@ -1280,6 +1350,16 @@ type XenoRuntimeEvent = (XenoRuntimeEventBase & {
     deferred: boolean;
     turnId?: string;
     iteration?: number;
+}) | (XenoRuntimeEventBase & {
+    type: "dispatch.settled";
+    dispatchId: string;
+    outcome: "completed" | "failed" | "timeout" | "cancelled" | "incomplete";
+    agent?: string;
+    errorCode?: string;
+    turnActive: boolean;
+    delivery: "injected" | "queued";
+    durationMs: number;
+    summary: string;
 }) | (XenoRuntimeEventBase & {
     type: "context.history.compacted";
     turnId?: string;
@@ -1849,6 +1929,9 @@ declare class AgentLoop {
     private totalOutputTokens;
     private lastRequestInputTokens;
     private pendingContextInjections;
+    private dispatchRegistry;
+    private dispatchUnsubscribe;
+    private activeRunCount;
     private lastCheckpointMessageCount;
     private ollamaBaseUrl;
     private activeAbortController;
@@ -1892,6 +1975,8 @@ declare class AgentLoop {
     createSoftBudgetCloudProvider(): LLMProvider;
     private callCloudWithOutputCap;
     private requestStreams;
+    setRequestContext(context: XenoRequestContext): void;
+    getRequestContext(): Readonly<XenoRequestContext> | undefined;
     configureModelExecution(options: {
         provider?: LLMProvider;
         modelWorkAccounting?: ModelWorkAccounting;
@@ -1913,6 +1998,8 @@ declare class AgentLoop {
     set executionMode(value: ExecutionMode);
     get systemPrompt(): string;
     set systemPrompt(value: string);
+    private promptGate;
+    holdRunUntil(gate: Promise<void>): void;
     use(middleware: ToolMiddleware): this;
     registerPromptSection(provider: PromptSectionProvider): this;
     registerCompletionGuard(guard: CompletionGuard): this;
@@ -1976,10 +2063,13 @@ declare class AgentLoop {
         content: string;
         sourceNodeId?: string;
         label?: string;
+        dispatchId?: string;
     }): Promise<{
         status: "injected" | "deferred";
         pendingCount: number;
     }>;
+    attachBackgroundDispatch(registry: BackgroundDispatchRegistry): () => void;
+    private deliverBackgroundDispatchReport;
     get pendingContextInjectionCount(): number;
     private flushContextInjections;
     get messages(): Message[];