indusagi 0.13.5 → 0.13.7

package/dist/types/facade/bot/actions/webfetch.d.ts

@@ -1,35 +0,0 @@
-/**
- * Web Fetch Tool
- *
- * Fetches content from a specified URL.
- * Supports text, markdown, and HTML format options.
- */
-import type { AgentTool } from "../types.js";
-declare const webFetchSchema: import("@sinclair/typebox").TObject<{
-    url: import("@sinclair/typebox").TString;
-    format: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"text">, import("@sinclair/typebox").TLiteral<"markdown">, import("@sinclair/typebox").TLiteral<"html">]>>;
-    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>;
-export interface WebFetchToolDetails {
-    url: string;
-    format?: "text" | "markdown" | "html";
-    timeout?: number;
-    contentType?: string;
-    fetchedBytes?: number;
-}
-export interface WebFetchToolOptions {
-    /** Maximum response size in bytes (default: 5MB) */
-    maxResponseSize?: number;
-    /** Default timeout in milliseconds (default: 30000) */
-    defaultTimeout?: number;
-    /** Optional proxy base URL that forwards target URL via ?url= */
-    proxyUrl?: string;
-}
-export declare function createWebFetchTool(options?: WebFetchToolOptions): AgentTool<typeof webFetchSchema>;
-/** Default web fetch tool */
-export declare const webFetchTool: AgentTool<import("@sinclair/typebox").TObject<{
-    url: import("@sinclair/typebox").TString;
-    format: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"text">, import("@sinclair/typebox").TLiteral<"markdown">, import("@sinclair/typebox").TLiteral<"html">]>>;
-    timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any>;
-export {};

package/dist/types/facade/bot/actions/websearch.d.ts

@@ -1,37 +0,0 @@
-/**
- * Web Search Tool
- *
- * Performs real-time web searches by scraping DuckDuckGo's lightweight HTML
- * results endpoint. Each organic hit is distilled to the three fields a model
- * reasons over — title, destination URL, and a short snippet — and rendered as a
- * compact numbered list. Provides up-to-date information for current events and
- * recent data.
- */
-import type { AgentTool } from "../types.js";
-declare const webSearchSchema: import("@sinclair/typebox").TObject<{
-    query: import("@sinclair/typebox").TString;
-    numResults: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>;
-export interface WebSearchToolDetails {
-    query: string;
-    numResults?: number;
-}
-export interface WebSearchToolOptions {
-    /** Custom API base URL (for testing or alternative endpoints) */
-    baseUrl?: string;
-    /** API key for Exa AI (if required) */
-    apiKey?: string;
-    /** Max requests per process window */
-    rateLimitPerMinute?: number;
-    /** Optional result filtering hook */
-    filterResult?: (raw: string) => string;
-    /** Optional fallback implementation */
-    fallbackSearch?: (query: string, numResults?: number, signal?: AbortSignal) => Promise<string>;
-}
-export declare function createWebSearchTool(options?: WebSearchToolOptions): AgentTool<typeof webSearchSchema>;
-/** Default web search tool */
-export declare const webSearchTool: AgentTool<import("@sinclair/typebox").TObject<{
-    query: import("@sinclair/typebox").TString;
-    numResults: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
-}>, any>;
-export {};

package/dist/types/facade/bot/actions/websearch.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/facade/bot/actions/write.d.ts

@@ -1,45 +0,0 @@
-import type { AgentTool } from "../types.js";
-import { type CheckpointHandle } from "./checkpoint.js";
-import { type ReadStateHandle } from "./read-state.js";
-declare const writeSchema: import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TString;
-    content: import("@sinclair/typebox").TString;
-}>;
-/**
- * Pluggable filesystem callbacks for the write tool. Override them to direct
- * writes at an alternate backend, for instance an SSH or remote-mount layer.
- */
-export interface WriteOperations {
-    /** Write text out to a file. */
-    writeFile: (absolutePath: string, content: string) => Promise<void>;
-    /** Make sure a directory is present, building any missing parents along the way. */
-    mkdir: (dir: string) => Promise<void>;
-    /** Optional callback for taking a snapshot of a file ahead of overwriting it. */
-    copyFile?: (from: string, to: string) => Promise<void>;
-}
-export interface WriteToolOptions {
-    /** Swap out the filesystem callbacks; the local disk is used by default. */
-    operations?: WriteOperations;
-    /** If set, duplicate any existing file to a sibling .bak before it is overwritten. */
-    createBackup?: boolean;
-    /**
-     * Optional read-before-edit gate store. When present, overwriting an EXISTING
-     * file is refused unless it was read this session and has not drifted on disk;
-     * brand-new files (not yet on disk) are exempt. Absent → no gate (no-op).
-     */
-    readState?: ReadStateHandle;
-    /**
-     * Optional file-checkpoint sink. When present, the file's pre-mutation
-     * on-disk content (or `null` when it did not exist) is captured exactly once
-     * before the overwrite, so a later rewind can roll the working tree back.
-     * Absent → no snapshot (no-op).
-     */
-    checkpoint?: CheckpointHandle;
-}
-export declare function createWriteTool(cwd: string, options?: WriteToolOptions): AgentTool<typeof writeSchema>;
-/** Ready-to-use write tool bound to the current working directory. */
-export declare const writeTool: AgentTool<import("@sinclair/typebox").TObject<{
-    path: import("@sinclair/typebox").TString;
-    content: import("@sinclair/typebox").TString;
-}>, any>;
-export {};

package/dist/types/facade/bot/agent-loop.d.ts

@@ -1,30 +0,0 @@
-/**
- * The engine that runs the agent's turn cycle.
- *
- * Throughout this module the conversation is carried as AgentMessage values.
- * They are only flattened into the provider's Message[] representation at the
- * last possible moment — immediately before a model call inside
- * streamAssistantResponse — and never anywhere else.
- */
-import { EventStream } from "../ml/index.js";
-import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from "./types.js";
-/**
- * Conservative static allow-list of tools that only read state, never mutate
- * it. Consecutive runs of these within a single assistant turn are safe to
- * dispatch concurrently. Anything not on this list — mutating tools (edit,
- * write, bash), and every dynamic / MCP / composio tool whose behavior the
- * loop can't statically vouch for — runs serially in request order.
- *
- * Callers can supply their own set through `AgentLoopConfig.readOnlyToolNames`.
- */
-export declare const READ_ONLY_TOOL_NAMES: ReadonlySet<string>;
-/**
- * Begin a brand-new run. The supplied prompt messages are appended to the
- * conversation up front, then the turn cycle starts.
- */
-export declare function agentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;
-/**
- * Pick a run back up from wherever the context currently sits, without adding
- * any new prompt messages.
- */
-export declare function agentLoopContinue(context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;

package/dist/types/facade/bot/agent-loop.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/facade/bot/agent.d.ts

@@ -1,140 +0,0 @@
-/**
- * High-level Agent wrapper around the streaming loop. It keeps the mutable run
- * state, exposes the public prompt/steer/follow-up surface, and forwards work to
- * the loop functions directly. There is no transport indirection here: by
- * default the model is reached through streamSimple.
- */
-import { type ImageContent, type Message, type Model, type ThinkingBudgets } from "../ml/index.js";
-import type { AgentEvent, AgentMessage, AgentState, AgentTool, CanUseToolFn, StreamFn, ThinkingLevel } from "./types.js";
-type QueueMode = "all" | "one-at-a-time";
-export interface AgentOptions {
-    initialState?: Partial<AgentState>;
-    /**
-     * Hook that maps the agent's AgentMessage[] onto the provider-facing
-     * Message[] right before every model call. When omitted, the built-in
-     * reducer keeps only user/assistant/toolResult messages and converts
-     * attachments.
-     */
-    convertToLlm?: (messages: AgentMessage[]) => Message[] | Promise<Message[]>;
-    /**
-     * Runs ahead of convertToLlm and may rewrite the message list — handy for
-     * trimming long histories or splicing in extra context.
-     */
-    transformContext?: (messages: AgentMessage[], signal?: AbortSignal) => Promise<AgentMessage[]>;
-    /**
-     * How queued steering messages are released: "all" flushes the whole queue
-     * in one go, "one-at-a-time" releases a single message per turn.
-     */
-    steeringMode?: QueueMode;
-    /**
-     * How queued follow-up messages are released: "all" flushes the whole queue
-     * in one go, "one-at-a-time" releases a single message per turn.
-     */
-    followUpMode?: QueueMode;
-    /**
-     * Swap in an alternative streaming implementation — e.g. a remote proxy
-     * backend. Falls back to streamSimple when not provided.
-     */
-    streamFn?: StreamFn;
-    /**
-     * Stable identifier passed through to providers that key their server-side
-     * caches on a session, so repeated turns can reuse prior context.
-     */
-    sessionId?: string;
-    /**
-     * Supplies a fresh API key per call. Useful when credentials rotate or
-     * expire, such as short-lived OAuth access tokens.
-     */
-    getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
-    /**
-     * Hard permission gate consulted before each tool runs. A host supplies it to
-     * enforce an allow/ask/deny policy; the loop awaits it on the validated args
-     * and either proceeds (optionally with substituted input) or short-circuits
-     * to an isError result. Omit it to allow every tool — today's behavior.
-     */
-    canUseTool?: CanUseToolFn;
-    /**
-     * Per-level token allowances for thinking; only meaningful for providers
-     * whose reasoning effort is expressed as a token budget.
-     */
-    thinkingBudgets?: ThinkingBudgets;
-}
-export declare class Agent {
-    private _state;
-    private readonly eventBus;
-    private readonly stateManager;
-    private readonly queuePolicy;
-    private abortController?;
-    private convertToLlm;
-    private transformContext?;
-    streamFn: StreamFn;
-    private _sessionId?;
-    getApiKey?: (provider: string) => Promise<string | undefined> | string | undefined;
-    canUseTool?: CanUseToolFn;
-    private runningPrompt?;
-    private resolveRunningPrompt?;
-    private _thinkingBudgets?;
-    constructor(opts?: AgentOptions);
-    /**
-     * The session identifier currently forwarded to providers for caching.
-     */
-    get sessionId(): string | undefined;
-    /**
-     * Update the provider-caching session identifier. Set a new value whenever
-     * the conversation changes identity — a brand-new session, a branch, or a
-     * resumed run.
-     */
-    set sessionId(value: string | undefined);
-    /**
-     * The thinking-level token budgets currently in effect, if any.
-     */
-    get thinkingBudgets(): ThinkingBudgets | undefined;
-    /**
-     * Override the thinking-level token budgets for providers that meter
-     * reasoning by token count.
-     */
-    set thinkingBudgets(value: ThinkingBudgets | undefined);
-    get state(): AgentState;
-    subscribe(fn: (e: AgentEvent) => void): () => void;
-    setSystemPrompt(v: string): void;
-    setModel(m: Model<any>): void;
-    setThinkingLevel(l: ThinkingLevel): void;
-    setSteeringMode(mode: QueueMode): void;
-    getSteeringMode(): QueueMode;
-    setFollowUpMode(mode: QueueMode): void;
-    getFollowUpMode(): QueueMode;
-    setTools(t: AgentTool<any>[]): void;
-    replaceMessages(ms: AgentMessage[]): void;
-    appendMessage(m: AgentMessage): void;
-    /**
-     * Enqueue a steering message to redirect the agent while it is running. It
-     * lands once the in-flight tool finishes and causes any still-pending tool
-     * calls in that turn to be skipped.
-     */
-    steer(m: AgentMessage): void;
-    /**
-     * Enqueue a follow-up message that is held back until the agent has gone
-     * idle — i.e. there are no outstanding tool calls and no steering left to
-     * process.
-     */
-    followUp(m: AgentMessage): void;
-    clearSteeringQueue(): void;
-    clearFollowUpQueue(): void;
-    clearAllQueues(): void;
-    clearMessages(): void;
-    abort(): void;
-    waitForIdle(): Promise<void>;
-    reset(): void;
-    /** Submit a new prompt, given either raw text or one or more AgentMessages. */
-    prompt(message: AgentMessage | AgentMessage[]): Promise<void>;
-    prompt(input: string, images?: ImageContent[]): Promise<void>;
-    /** Resume the existing conversation, e.g. to retry after a context overflow. */
-    continue(): Promise<void>;
-    /**
-     * Core driver for a run. Passing a messages array opens a new turn seeded
-     * with them; passing nothing resumes the conversation already in state.
-     */
-    private _runLoop;
-    private emit;
-}
-export {};

package/dist/types/facade/bot/error-handler.d.ts

@@ -1,7 +0,0 @@
-export interface AgentErrorContext {
-    phase: "llm_stream" | "tool_execution" | "steering" | "unknown";
-    toolName?: string;
-}
-export declare class AgentErrorHandler {
-    handle(error: unknown, context: AgentErrorContext): Error;
-}

package/dist/types/facade/bot/event-bus.d.ts

@@ -1,8 +0,0 @@
-import type { AgentEvent } from "./types.js";
-export type AgentEventListener = (event: AgentEvent) => void;
-export declare class AgentEventBus {
-    private listeners;
-    subscribe(listener: AgentEventListener): () => void;
-    emit(event: AgentEvent): void;
-    clear(): void;
-}

package/dist/types/facade/bot/index.d.ts

@@ -1,7 +0,0 @@
-export * from "./agent.js";
-export * from "./agent-loop.js";
-export * from "./proxy.js";
-export * from "./types.js";
-export * from "./actions/index.js";
-export * from "./messages.js";
-export * from "./session-manager.js";

package/dist/types/facade/bot/messages.d.ts

@@ -1,83 +0,0 @@
-/**
- * Extra message variants that only appear within a live session, plus the
- * routine that collapses an AgentMessage list into the plain Message list a
- * model can read.
- *
- * The base AgentMessage union is widened (via declaration merging) with four
- * session-only kinds — recorded shell runs, extension-supplied entries, and the
- * two flavours of summary (branch and compaction). The transformer below knows
- * how each of those, as well as the ordinary kinds, becomes an LLM Message.
- */
-import type { AgentMessage } from "./types.js";
-import type { ImageContent, Message, TextContent } from "../ml/index.js";
-export declare const COMPACTION_SUMMARY_PREFIX = "Earlier turns in this conversation were condensed. Here is the recap that replaces them:\n\n<summary>\n";
-export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
-export declare const BRANCH_SUMMARY_PREFIX = "Recap of a side branch that the conversation has since returned from:\n\n<summary>\n";
-export declare const BRANCH_SUMMARY_SUFFIX = "</summary>";
-/**
- * One shell command captured from the inline `!` entry point.
- */
-export interface BashExecutionMessage {
-    role: "bashExecution";
-    command: string;
-    output: string;
-    exitCode: number | undefined;
-    cancelled: boolean;
-    truncated: boolean;
-    fullOutputPath?: string;
-    timestamp: number;
-    /** Set by the `!!` form to suppress this entry from the model context. */
-    excludeFromContext?: boolean;
-}
-/**
- * Content an extension dropped into the conversation through sendMessage().
- * This is the vehicle extensions use to inject their own material into the
- * ongoing dialogue.
- */
-export interface CustomMessage<T = unknown> {
-    role: "custom";
-    customType: string;
-    content: string | (TextContent | ImageContent)[];
-    display: boolean;
-    details?: T;
-    timestamp: number;
-}
-export interface BranchSummaryMessage {
-    role: "branchSummary";
-    summary: string;
-    fromId: string;
-    timestamp: number;
-}
-export interface CompactionSummaryMessage {
-    role: "compactionSummary";
-    summary: string;
-    tokensBefore: number;
-    timestamp: number;
-}
-declare module "./types.js" {
-    interface CustomAgentMessages {
-        bashExecution: BashExecutionMessage;
-        custom: CustomMessage;
-        branchSummary: BranchSummaryMessage;
-        compactionSummary: CompactionSummaryMessage;
-    }
-}
-/**
- * Turn a captured shell run into the user-message text shown to the model.
- */
-export declare function bashExecutionToText(msg: BashExecutionMessage): string;
-export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
-export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
-/** Reconstruct a CustomMessage (the in-memory AgentMessage form) from saved entry fields. */
-export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string): CustomMessage;
-/**
- * Reduce an AgentMessage list (session-only kinds included) to the plain
- * Message list the model accepts. Anything a translator maps to `undefined`
- * is removed from the result.
- *
- * Reached from:
- * - the Agent's convertToLlm hook, used for prompts and queued input
- * - compaction summarization
- * - extensions and tools wanting a model-ready view
- */
-export declare function convertToLlm(messages: AgentMessage[]): Message[];

package/dist/types/facade/bot/permission-gate.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/types/facade/bot/proxy.d.ts

@@ -1,70 +0,0 @@
-/**
- * Client for talking to a remote streaming endpoint that fronts the model. It
- * opens an SSE connection, decodes the line-delimited proxy events, and rebuilds
- * the assistant message incrementally so the result matches a direct stream.
- */
-import { EventStream, type AssistantMessage, type AssistantMessageEvent, type Context, type Model, type SimpleStreamOptions, type StopReason } from "../ml/index.js";
-declare class ProxyMessageEventStream extends EventStream<AssistantMessageEvent, AssistantMessage> {
-    constructor();
-}
-export type ProxyAssistantMessageEvent = {
-    type: "start";
-} | {
-    type: "text_start";
-    contentIndex: number;
-} | {
-    type: "text_delta";
-    contentIndex: number;
-    delta: string;
-} | {
-    type: "text_end";
-    contentIndex: number;
-    contentSignature?: string;
-} | {
-    type: "thinking_start";
-    contentIndex: number;
-} | {
-    type: "thinking_delta";
-    contentIndex: number;
-    delta: string;
-} | {
-    type: "thinking_end";
-    contentIndex: number;
-    contentSignature?: string;
-} | {
-    type: "toolcall_start";
-    contentIndex: number;
-    id: string;
-    toolName: string;
-} | {
-    type: "toolcall_delta";
-    contentIndex: number;
-    delta: string;
-} | {
-    type: "toolcall_end";
-    contentIndex: number;
-} | {
-    type: "done";
-    reason: Extract<StopReason, "stop" | "length" | "toolUse">;
-    usage: AssistantMessage["usage"];
-} | {
-    type: "error";
-    reason: Extract<StopReason, "aborted" | "error">;
-    errorMessage?: string;
-    usage: AssistantMessage["usage"];
-};
-export interface RetryConfig {
-    maxAttempts?: number;
-    baseDelayMs?: number;
-    maxDelayMs?: number;
-}
-export interface ProxyStreamOptions extends SimpleStreamOptions {
-    authToken: string;
-    getAuthToken?: () => Promise<string>;
-    proxyUrl: string;
-    timeoutMs?: number;
-    retry?: RetryConfig;
-    logger?: (message: string, meta?: Record<string, unknown>) => void;
-}
-export declare function streamProxy(model: Model<any>, context: Context, options: ProxyStreamOptions): ProxyMessageEventStream;
-export {};