psadk 1.4.8 → 1.5.0

package/build/main/lib/PSAgentConfig.d.ts

@@ -1,27 +1,42 @@
+import type { Message, SimpleStreamOptions, ThinkingBudgets, Transport } from '@earendil-works/pi-ai';
 import { z } from 'zod/v4';
+import type { IStreamLogger } from './PSAgentLogger';
 import { PSAgentTask } from './PSAgentTask';
 import { PSAgentTool } from './PSAgentTool';
+import type { AfterToolCallContext, AfterToolCallResult, AgentEvent, AgentLoopTurnUpdate, AgentMessage, BeforeToolCallContext, BeforeToolCallResult, QueueMode, StreamFn, ToolExecutionMode } from './agent-core/src/types.js';
+/**
+ * Configuration for `PSAgent` running in **remote** mode (default).
+ *
+ * This is the base config used by all consumers. It does not expose any
+ * local-mode options — those live exclusively on {@link PSAgentLocalConfig}.
+ */
 export interface PSAgentConfig {
     agent_class?: 'LlmAgent' | 'LoopAgent' | 'ParallelAgent' | 'SequentialAgent';
     name: string;
     description: string;
     instruction: string;
     sub_agents?: PSAgentConfig[];
-    additional_properties?: Record<string, any>;
+    additional_properties?: Record<string, unknown>;
     examples?: string[];
     model?: string;
     llm_config?: {
         max_completion_tokens?: number;
         context_window?: number;
+        /** @default 50 */
         max_specific_tool_calls?: number;
         reasoning_effort?: 'minimal' | 'low' | 'medium' | 'high';
+        /** 0–1 */
         temperature?: number;
+        /** 0–1 */
         top_p?: number;
         verbosity?: 'low' | 'medium' | 'high';
+        /** Enable prompt caching. @default false */
         enable_prompt_caching?: boolean;
+        /** Cache the system prompt. @default true when enable_prompt_caching is true */
         cache_system_prompt?: boolean;
+        /** Message indices to set cache breakpoints at (Anthropic models). */
         cache_breakpoints?: number[];
-    } & Record<string, any>;
+    } & Record<string, unknown>;
     input_schema?: z.core.JSONSchema.BaseSchema;
     output_schema?: z.core.JSONSchema.BaseSchema;
     show_plan?: boolean;
@@ -30,37 +45,106 @@ export interface PSAgentConfig {
     tasks?: PSAgentTask[];
     token?: string;
     getToken?: () => Promise<string>;
+    /**
+     * Callable invoked before every LLM call in local mode to supply fresh non-auth headers.
+     * Called once per LLM request — suitable for short-lived headers such as app tokens and
+     * trace IDs that expire faster than the agent's lifetime.
+     *
+     * **`Authorization` must NOT be returned from this callable.** Auth is handled exclusively
+     * by `getToken`/`getApiKey` so that per-call bearer-token refresh works correctly.
+     * Returning `Authorization` here would re-introduce the defaultHeaders override bug.
+     *
+     * Errors thrown by this callable are caught and treated as `{}` (non-fatal) so the
+     * LLM call proceeds with the headers already present on `model.headers`.
+     *
+     * Only used when `local: true`. Has no effect in remote mode.
+     */
+    getHeaders?: () => Promise<Record<string, string>>;
     additional_headers?: Record<string, string>;
     evaluation?: {
         run_evaluator: boolean;
         reference_correlation_ids: string[] | null;
     };
-    /** Run the agent in-process via agent-core instead of the PS API. Default: false. */
-    local?: boolean;
-    /** Callback invoked for each streamed event during local execution. */
-    onEvent?: (event: LocalAgentEvent) => void;
+    /** Optional logger forwarded to execution. */
+    log?: IStreamLogger;
+    /** A2A server port. @default 41241 */
     port?: number;
 }
 /**
- * Event emitted during local agent execution (local: true mode).
- * Shape mirrors the remote event polling format so execute() can share a single handler path.
+ * Additional options available exclusively when `local: true` is set.
+ *
+ * Every field mirrors its counterpart in `AgentOptions` from `agent-core`
+ * so callers using the local path never need a nested options bag.
+ *
+ * These fields are **not** present on {@link PSAgentConfig} and will not
+ * appear in intellisense for remote-mode consumers.
  */
-export interface LocalAgentEvent {
-    /** Current agent status */
-    agentStatus: 'pending' | 'in-progress' | 'waiting' | 'completed' | 'failed';
-    /** Unix timestamp (ms) when the event was generated */
-    timestamp: number;
-    /** Tool name — present when agentStatus is 'waiting' */
-    tool?: string;
-    /** Tool input — present when agentStatus is 'waiting' */
-    toolInput?: {
-        request_body: Record<string, any>;
-    };
-    /** Agent output — present when agentStatus is 'completed' */
-    output?: {
-        response: string;
-        [key: string]: any;
-    };
-    /** Error or status message — present when agentStatus is 'failed' or 'in-progress' */
-    message?: string;
+export interface PSAgentLocalOptions {
+    /** Override the stream function used by the local Agent. Defaults to `streamSimple`. */
+    streamFn?: StreamFn;
+    /** Preferred transport forwarded to the stream function. */
+    transport?: Transport;
+    /** Convert AgentMessages to the provider Message format before each LLM call. */
+    convertToLlm?: (messages: AgentMessage[]) => Message[] | Promise<Message[]>;
+    /** Transform the full context (e.g. apply RAG, summarise) before each LLM call. */
+    transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
+    /** Resolve an API key for a given provider at runtime. */
+    getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
+    /** Called with each raw streaming payload from the provider. */
+    onPayload?: SimpleStreamOptions['onPayload'];
+    /** Called once the full provider response object is available. */
+    onResponse?: SimpleStreamOptions['onResponse'];
+    /** Called before every tool execution; can override or block the call. */
+    beforeToolCall?: (context: BeforeToolCallContext, signal?: AbortSignal) => Promise<BeforeToolCallResult | undefined>;
+    /** Called after every tool execution; can override the result. */
+    afterToolCall?: (context: AfterToolCallContext, signal?: AbortSignal) => Promise<AfterToolCallResult | undefined>;
+    /** Called before each new agent loop turn; can inject messages or mutate state. */
+    prepareNextTurn?: (signal?: AbortSignal) => Promise<AgentLoopTurnUpdate | undefined> | AgentLoopTurnUpdate | undefined;
+    /** Session identifier forwarded to providers for cache-aware backends. */
+    sessionId?: string;
+    /** Per-level thinking token budgets forwarded to the stream function. */
+    thinkingBudgets?: ThinkingBudgets;
+    /** Optional cap for provider-requested retry delays (ms). */
+    maxRetryDelayMs?: number;
+    /** How to execute multiple tool calls in one assistant turn. @default "parallel" */
+    toolExecution?: ToolExecutionMode;
+    /** How queued steering messages are drained. @default "one-at-a-time" */
+    steeringMode?: QueueMode;
+    /** How queued follow-up messages are drained. @default "one-at-a-time" */
+    followUpMode?: QueueMode;
+    /**
+     * Listeners subscribed to the local Agent's lifecycle events.
+     * Each entry is registered via `agent.subscribe(listener)` before the first prompt.
+     */
+    localListeners?: Array<(event: AgentEvent, signal: AbortSignal) => Promise<void> | void>;
 }
+/**
+ * Configuration for `PSAgent` running in **local** mode (`local: true`).
+ *
+ * Extends {@link PSAgentConfig} with all local-only options from
+ * {@link PSAgentLocalOptions}. The `local` discriminant is required and
+ * must be `true`.
+ *
+ * Remote consumers who do not set `local: true` will never see these
+ * additional fields in their config type.
+ */
+export type PSAgentLocalConfig = PSAgentConfig & PSAgentLocalOptions & {
+    /** Must be `true` to enable local in-process execution via `agent-core`. */
+    local: true;
+};
+/**
+ * The full config type accepted by the `PSAgent` constructor.
+ *
+ * - When `local` is absent or `false`, only {@link PSAgentConfig} fields are valid.
+ * - When `local: true`, all {@link PSAgentLocalConfig} fields become available.
+ *
+ * Use this type when writing helpers or utilities that accept either mode.
+ */
+export type PSAgentConfigWithLocal = PSAgentConfig | PSAgentLocalConfig;
+/**
+ * @deprecated Use {@link PSAgentLocalOptions} instead.
+ * Kept for backward compatibility with existing imports.
+ */
+export type LocalAgentOptions = PSAgentLocalOptions & {
+    local?: boolean;
+};

package/build/main/lib/PSAgentLogger.js

@@ -4,7 +4,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PSAgentLogger = void 0;
-/* eslint-disable @typescript-eslint/no-explicit-any */
 const node_fs_1 = __importDefault(require("node:fs"));
 const debuglogger_1 = __importDefault(require("./utils/debuglogger"));
 class PSAgentLogger {
@@ -74,4 +73,4 @@ class PSAgentLogger {
     }
 }
 exports.PSAgentLogger = PSAgentLogger;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUFNBZ2VudExvZ2dlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvUFNBZ2VudExvZ2dlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSx1REFBdUQ7QUFDdkQsc0RBQXlCO0FBRXpCLHNFQUE4QztBQWtCOUMsTUFBYSxhQUFhO0lBQ3hCLE1BQU0sQ0FBQyxFQUFFLEdBQUcsSUFBSSxDQUFDO0lBQ1QsS0FBSyxHQUFHLElBQUEscUJBQVcsRUFBQyxPQUFPLENBQUMsQ0FBQztJQUNwQixXQUFXLENBQXFCO0lBQ3pDLE1BQU0sQ0FBVTtJQUNoQixJQUFJLENBQVU7SUFDdEIsWUFBWSxPQU1YO1FBQ0MsSUFBSSxPQUFPLEVBQUUsWUFBWSxLQUFLLFNBQVMsRUFBRSxDQUFDO1lBQ3hDLGFBQWEsQ0FBQyxFQUFFLEdBQUcsT0FBTyxDQUFDLFlBQVksQ0FBQztRQUMxQyxDQUFDO1FBQ0QsSUFBSSxPQUFPLEVBQUUsTUFBTSxFQUFFLENBQUM7WUFDcEIsSUFBSSxDQUFDLEtBQUssR0FBRyxJQUFBLHFCQUFXLEVBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDO1FBQzNDLENBQUM7UUFDRCxJQUFJLENBQUMsV0FBVyxHQUFHLE9BQU8sRUFBRSxXQUFXLENBQUM7UUFDeEMsSUFBSSxDQUFDLE1BQU0sR0FBRyxPQUFPLEVBQUUsTUFBTSxDQUFDO1FBQzlCLElBQUksQ0FBQyxJQUFJLEdBQUcsT0FBTyxFQUFFLElBQUksQ0FBQztJQUM1QixDQUFDO0lBRUQsR0FBRyxDQUFDLElBQVksRUFBRSxPQUFZLEVBQUUsR0FBRyxjQUFxQjtRQUN0RCxNQUFNLEtBQUssR0FBRyxhQUFhLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDakMsSUFBSSxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7WUFDckIsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1lBQ3ZCLGlCQUFFLENBQUMsY0FBYyxDQUNmLElB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUFNBZ2VudExvZ2dlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9saWIvUFNBZ2VudExvZ2dlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7QUFBQSxzREFBeUI7QUFFekIsc0VBQThDO0FBa0I5QyxNQUFhLGFBQWE7SUFDeEIsTUFBTSxDQUFDLEVBQUUsR0FBRyxJQUFJLENBQUM7SUFDVCxLQUFLLEdBQUcsSUFBQSxxQkFBVyxFQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ3BCLFdBQVcsQ0FBcUI7SUFDekMsTUFBTSxDQUFVO0lBQ2hCLElBQUksQ0FBVTtJQUN0QixZQUFZLE9BTVg7UUFDQyxJQUFJLE9BQU8sRUFBRSxZQUFZLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDeEMsYUFBYSxDQUFDLEVBQUUsR0FBRyxPQUFPLENBQUMsWUFBWSxDQUFDO1FBQzFDLENBQUM7UUFDRCxJQUFJLE9BQU8sRUFBRSxNQUFNLEVBQUUsQ0FBQztZQUNwQixJQUFJLENBQUMsS0FBSyxHQUFHLElBQUEscUJBQVcsRUFBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDM0MsQ0FBQztRQUNELElBQUksQ0FBQyxXQUFXLEdBQUcsT0FBTyxFQUFFLFdBQVcsQ0FBQztRQUN4QyxJQUFJLENBQUMsTUFBTSxHQUFHLE9BQU8sRUFBRSxNQUFNLENBQUM7UUFDOUIsSUFBSSxDQUFDLElBQUksR0FBRyxPQUFPLEVBQUUsSUFBSSxDQUFDO0lBQzVCLENBQUM7SUFFRCxHQUFHLENBQUMsSUFBWSxFQUFFLE9BQVksRUFBRSxHQUFHLGNBQXFCO1FBQ3RELE1BQU0sS0FBSyxHQUFHLGFBQWEsQ0FBQyxFQUFFLEVBQUUsQ0FBQztRQUNqQyxJQUFJLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUNyQixNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7WUFDdkIsaUJBQUUsQ0FBQyxjQUFjLENBQ2YsSUFBSSxDQUFDLFdBQVcs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

package/build/main/lib/PSAgentTool.d.ts

@@ -9,6 +9,11 @@ export interface IPSAgentToolInput {
     method?: string;
     requestBody: z.core.JSONSchema.BaseSchema;
 }
+export interface IPSAgentToolRunOptions extends Record<string, any> {
+    toolCallId?: string;
+    signal?: AbortSignal;
+    onUpdate?: (partialResult: Record<string, any>) => void;
+}
 export declare class PSAgentTool {
     private name;
     private description;
@@ -24,7 +29,7 @@ export declare class PSAgentTool {
         local_execution?: boolean;
         hitl?: boolean;
         inputschema: IPSAgentToolInput;
-        runCallback?: (input: Record<string, any>, log?: IStreamLogger) => Promise<Record<string, any>>;
+        runCallback?: (input: Record<string, any>, log?: IStreamLogger, options?: IPSAgentToolRunOptions) => Promise<Record<string, any>>;
     });
     get Name(): string;
     set Name(value: string);
@@ -46,11 +51,11 @@ export declare class PSAgentTool {
     });
     get Inputs(): IPSAgentToolInput;
     set Inputs(value: IPSAgentToolInput);
-    run(input: Record<string, any>, log?: IStreamLogger): Promise<Record<string, any>>;
+    run(input: Record<string, any>, log?: IStreamLogger, options?: IPSAgentToolRunOptions): Promise<Record<string, any>>;
     static LocalTool({ name, description, requestschema, runCallback, }: {
         name: string;
         description: string;
         requestschema: z.core.JSONSchema.BaseSchema;
-        runCallback: (input: Record<string, any>, log?: IStreamLogger) => Promise<Record<string, any>>;
+        runCallback: (input: Record<string, any>, log?: IStreamLogger, options?: IPSAgentToolRunOptions) => Promise<Record<string, any>>;
     }): PSAgentTool;
 }

package/build/main/lib/PSAgentTool.js

@@ -67,11 +67,11 @@ class PSAgentTool {
     set Inputs(value) {
         this.inputschema = value;
     }
-    run(input, log) {
+    run(input, log, options) {
         if (!this.runCallback) {
             throw new Error('run callback function is not defined for this tool');
         }
-        return this.runCallback(input, log);
+        return this.runCallback(input, log, options);
     }
     static LocalTool({ name, description, requestschema, runCallback, }) {
         return new PSAgentTool({
@@ -92,4 +92,4 @@ class PSAgentTool {
     }
 }
 exports.PSAgentTool = PSAgentTool;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUFNBZ2VudFRvb2wuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL1BTQWdlbnRUb29sLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUlBLDZDQUF1RDtBQWV2RCxNQUFhLFdBQVc7SUFDZCxJQUFJLENBQVM7SUFDYixXQUFXLENBQVM7SUFDcEIsSUFBSSxDQUFTO0lBQ2IsZUFBZSxDQUFVO0lBQ3pCLElBQUksQ0FJVjtJQUNNLFdBQVcsQ0FBb0I7SUFDL0IsV0FBVyxDQUdlO0lBRWxDLFlBQVksRUFDVixJQUFJLEVBQ0osV0FBVyxFQUNYLElBQUksR0FBRyxLQUFLLEVBQ1osZUFBZSxHQUFHLElBQUksRUFDdEIsSUFBSSxHQUFHLElBQUksRUFDWCxXQUFXLEVBQ1gsV0FBVyxHQVlaO1FBQ0MsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxDQUFDLFdBQVcsR0FBRyxXQUFXLENBQUM7UUFDL0IsSUFBSSxDQUFDLElBQUksR0FBRyxJQUFJLENBQUM7UUFDakIsSUFBSSxDQUFDLGVBQWUsR0FBRyxlQUFlLENBQUM7UUFDdkMsSUFBSSxDQUFDLElBQUksR0FBRztZQUNWLFFBQVEsRUFBRSxJQUFJO1lBQ2QsU0FBUyxFQUFFLFFBQVE7WUFDbkIsS0FBSyxFQUFFLENBQUM7U0FDVCxDQUFDO1FBQ0YsSUFBSSxDQUFDLFdBQVcsR0FBRyxXQUFXLENBQUM7UUFDL0IsSUFBSSxXQUFXLEVBQUUsQ0FBQztZQUNoQixJQUFJLE9BQU8sV0FBVyxLQUFLLFVBQVUsRUFBRSxDQUFDO2dCQUN0QyxNQUFNLElBQUksS0FBSyxDQUFDLGdDQUFnQyxDQUFDLENBQUM7WUFDcEQsQ0FBQztZQUNELElBQUksQ0FBQyxXQUFXLEdBQUcsV0FBVyxDQUFDO1FBQ2pDLENBQUM7SUFDSCxDQUFDO0lBQ0QsSUFBVyxJQUFJO1FBQ2IsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDO0lBQ25CLENBQUM7SUFDRCxJQUFXLElBQUksQ0FBQyxLQUFhO1FBQzNCLElBQUksQ0FBQyxJQUFJLEdBQUcsS0FBSyxDQUFDO0lBQ3BCLENBQUM7SUFDRCxJQUFXLFdBQVc7UUFDcEIsT0FBTyxJQUFJLENBQUMsV0FBVyxDQUFDO0lBQzFCLENBQUM7SUFDRCxJQUFXLFdBQVcsQ0FBQyxLQUFhO1FBQ2xDLElBQUksQ0FBQyxXQUFXLEdBQUcsS0FBSyxDQUFDO0lBQzNCLENBQUM7SUFDRCxJQUFXLElBQUk7UUFDYixPQUFPLElBQUksQ0FBQyxJQUFJLENBQUM7SUFDbkIsQ0FBQztJQUNELElBQVcsSUFBSSxDQUFDLEtBQWE7UUFDM0IsSUFBSSxDQUFDLElBQUksR0FBRyxLQUFLLENBQUM7SUFDcEIsQ0FBQztJQUNELElBQVcsY0FBYztRQUN2QixPQUFPLElBQUksQ0FBQyxlQUFlLENBQUM7SUFDOUIsQ0FBQztJQUNELElBQVcsY0FBYyxDQUFDLEtBQWM7UUFDdEMsSUFBSSxDQUFDLGVBQWUsR0FBRyxLQUFLLENBQUM7SUFDL0IsQ0FBQztJQUNELElBQVcsSUFBSTtRQUNiLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQztJQUNuQixDQUFDO0lBQ0QsSUFBVyxJQUFJLENBQUMsS0FJZjtRQUNDLElBQUksQ0FBQyxJQUFJLEdBQUcsS0FBSyxDQUFDO0lBQ3BCLENBQUM7SUFDRCxJQUFXLE1BQU07UUFDZixPQUFPO1lBQ0wsR0FBRyxJQUFJLENBQUMsV0FBVztZQUNuQixXQUFXLEVBQUUsSUFBQSw4QkFBb0IsRUFBQyxJQUFJLENBQUMsV0FBVyxDQUFDLFdBQVcsQ0FBQztTQUNoRSxDQUFDO0lBQ0osQ0FBQztJQUNELElBQVcsTUFBTSxDQUFDLEtBQXdCO1FBQ3hDLElBQUksQ0FBQyxXQUFXLEdBQUcsS0FBSyxDQUFDO0lBQzNCLENBQUM7SUFFTSxHQUFHLENBQ1IsS0FBMEIsRUFDMUIsR0FBbUI7UUFFbkIsSUFBSSxDQUFDLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUN0QixNQUFNLElBQUksS0FBSyxDQUFDLG9EQUFvRCxDQUFDLENBQUM7UUFDeEUsQ0FBQztRQUNELE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQyxLQUFLLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDdEMsQ0FBQztJQUVNLE1BQU0sQ0FBQyxTQUFTLENBQUMsRUFDdEIsSUFBSSxFQUNKLFdBQVcsRUFDWCxhQUFhLEVBQ2IsV0FBVyxHQVNaO1FBQ0MsT0FBTyxJQUFJLFdBQVcsQ0FBQztZQUNyQixJQUFJO1lBQ0osV0FBVztZQUNYLElBQUksRUFBRSxLQUFLO1lBQ1gsZUFBZSxFQUFFLElBQUk7WUFDckIsSUFBSSxFQUFFLElBQUk7WUFDVixXQUFXLEVBQUU7Z0JBQ1gsMkJBQTJCO2dCQUMzQiwwQ0FBMEM7Z0JBQzFDLEdBQUcsRUFBRSxvQkFBb0IsSUFBSSxFQUFFO2dCQUMvQixNQUFNLEVBQUUsTUFBTTtnQkFDZCxXQUFXLEVBQUUsYUFBYTthQUMzQjtZQUNELFdBQVc7U0FDWixDQUFDLENBQUM7SUFDTCxDQUFDO0NBQ0Y7QUF6SUQsa0NBeUlDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUFNBZ2VudFRvb2wuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbGliL1BTQWdlbnRUb29sLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUdBLDZDQUF1RDtBQXFCdkQsTUFBYSxXQUFXO0lBQ2QsSUFBSSxDQUFTO0lBQ2IsV0FBVyxDQUFTO0lBQ3BCLElBQUksQ0FBUztJQUNiLGVBQWUsQ0FBVTtJQUN6QixJQUFJLENBSVY7SUFDTSxXQUFXLENBQW9CO0lBQy9CLFdBQVcsQ0FJZTtJQUVsQyxZQUFZLEVBQ1YsSUFBSSxFQUNKLFdBQVcsRUFDWCxJQUFJLEdBQUcsS0FBSyxFQUNaLGVBQWUsR0FBRyxJQUFJLEVBQ3RCLElBQUksR0FBRyxJQUFJLEVBQ1gsV0FBVyxFQUNYLFdBQVcsR0FhWjtRQUNDLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO1FBQ2pCLElBQUksQ0FBQyxXQUFXLEdBQUcsV0FBVyxDQUFDO1FBQy9CLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO1FBQ2pCLElBQUksQ0FBQyxlQUFlLEdBQUcsZUFBZSxDQUFDO1FBQ3ZDLElBQUksQ0FBQyxJQUFJLEdBQUc7WUFDVixRQUFRLEVBQUUsSUFBSTtZQUNkLFNBQVMsRUFBRSxRQUFRO1lBQ25CLEtBQUssRUFBRSxDQUFDO1NBQ1QsQ0FBQztRQUNGLElBQUksQ0FBQyxXQUFXLEdBQUcsV0FBVyxDQUFDO1FBQy9CLElBQUksV0FBVyxFQUFFLENBQUM7WUFDaEIsSUFBSSxPQUFPLFdBQVcsS0FBSyxVQUFVLEVBQUUsQ0FBQztnQkFDdEMsTUFBTSxJQUFJLEtBQUssQ0FBQyxnQ0FBZ0MsQ0FBQyxDQUFDO1lBQ3BELENBQUM7WUFDRCxJQUFJLENBQUMsV0FBVyxHQUFHLFdBQVcsQ0FBQztRQUNqQyxDQUFDO0lBQ0gsQ0FBQztJQUNELElBQVcsSUFBSTtRQUNiLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQztJQUNuQixDQUFDO0lBQ0QsSUFBVyxJQUFJLENBQUMsS0FBYTtRQUMzQixJQUFJLENBQUMsSUFBSSxHQUFHLEtBQUssQ0FBQztJQUNwQixDQUFDO0lBQ0QsSUFBVyxXQUFXO1FBQ3BCLE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQztJQUMxQixDQUFDO0lBQ0QsSUFBVyxXQUFXLENBQUMsS0FBYTtRQUNsQyxJQUFJLENBQUMsV0FBVyxHQUFHLEtBQUssQ0FBQztJQUMzQixDQUFDO0lBQ0QsSUFBVyxJQUFJO1FBQ2IsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUFDO0lBQ25CLENBQUM7SUFDRCxJQUFXLElBQUksQ0FBQyxLQUFhO1FBQzNCLElBQUksQ0FBQyxJQUFJLEdBQUcsS0FBSyxDQUFDO0lBQ3BCLENBQUM7SUFDRCxJQUFXLGNBQWM7UUFDdkIsT0FBTyxJQUFJLENBQUMsZUFBZSxDQUFDO0lBQzlCLENBQUM7SUFDRCxJQUFXLGNBQWMsQ0FBQyxLQUFjO1FBQ3RDLElBQUksQ0FBQyxlQUFlLEdBQUcsS0FBSyxDQUFDO0lBQy9CLENBQUM7SUFDRCxJQUFXLElBQUk7UUFDYixPQUFPLElBQUksQ0FBQyxJQUFJLENBQUM7SUFDbkIsQ0FBQztJQUNELElBQVcsSUFBSSxDQUFDLEtBSWY7UUFDQyxJQUFJLENBQUMsSUFBSSxHQUFHLEtBQUssQ0FBQztJQUNwQixDQUFDO0lBQ0QsSUFBVyxNQUFNO1FBQ2YsT0FBTztZQUNMLEdBQUcsSUFBSSxDQUFDLFdBQVc7WUFDbkIsV0FBVyxFQUFFLElBQUEsOEJBQW9CLEVBQUMsSUFBSSxDQUFDLFdBQVcsQ0FBQyxXQUFXLENBQUM7U0FDaEUsQ0FBQztJQUNKLENBQUM7SUFDRCxJQUFXLE1BQU0sQ0FBQyxLQUF3QjtRQUN4QyxJQUFJLENBQUMsV0FBVyxHQUFHLEtBQUssQ0FBQztJQUMzQixDQUFDO0lBRU0sR0FBRyxDQUNSLEtBQTBCLEVBQzFCLEdBQW1CLEVBQ25CLE9BQWdDO1FBRWhDLElBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7WUFDdEIsTUFBTSxJQUFJLEtBQUssQ0FBQyxvREFBb0QsQ0FBQyxDQUFDO1FBQ3hFLENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQyxXQUFXLENBQUMsS0FBSyxFQUFFLEdBQUcsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUMvQyxDQUFDO0lBRU0sTUFBTSxDQUFDLFNBQVMsQ0FBQyxFQUN0QixJQUFJLEVBQ0osV0FBVyxFQUNYLGFBQWEsRUFDYixXQUFXLEdBVVo7UUFDQyxPQUFPLElBQUksV0FBVyxDQUFDO1lBQ3JCLElBQUk7WUFDSixXQUFXO1lBQ1gsSUFBSSxFQUFFLEtBQUs7WUFDWCxlQUFlLEVBQUUsSUFBSTtZQUNyQixJQUFJLEVBQUUsSUFBSTtZQUNWLFdBQVcsRUFBRTtnQkFDWCwyQkFBMkI7Z0JBQzNCLDBDQUEwQztnQkFDMUMsR0FBRyxFQUFFLG9CQUFvQixJQUFJLEVBQUU7Z0JBQy9CLE1BQU0sRUFBRSxNQUFNO2dCQUNkLFdBQVcsRUFBRSxhQUFhO2FBQzNCO1lBQ0QsV0FBVztTQUNaLENBQUMsQ0FBQztJQUNMLENBQUM7Q0FDRjtBQTdJRCxrQ0E2SUMifQ==

package/build/main/lib/agent-core/{agent-loop.d.ts → src/agent-loop.d.ts}

@@ -3,7 +3,7 @@
  * Transforms to Message[] only at the LLM call boundary.
  */
 import { EventStream } from '@earendil-works/pi-ai';
-import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from './types.js';
+import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from './types.ts';
 export type AgentEventSink = (event: AgentEvent) => Promise<void> | void;
 /**
  * Start an agent loop with a new prompt message.