@cuylabs/agent-core 0.9.0 → 0.10.0

package/dist/types-DmDwi2zI.d.ts

@@ -1,339 +0,0 @@
-import { LanguageModel, TelemetrySettings, ModelMessage, ToolSet } from 'ai';
-import { T as Tool } from './tool-CZWN3KbO.js';
-import { T as ToolHost } from './types-CHiPh8U2.js';
-import { M as MiddlewareRunner } from './runner-CI-XeR16.js';
-import { n as InterventionController, T as ToolExecutionMode, I as InferenceStreamInput } from './types-BlOKk-Bb.js';
-import { R as ReasoningLevel } from './types-CQaXbRsS.js';
-import { N as NormalizedToolReplayPolicy, d as TurnTrackerContext } from './tool-DkhSCV2Y.js';
-import { T as TokenUsage, M as Message } from './messages-BYWGn8TY.js';
-import { f as StreamProvider } from './types-DTSkxakL.js';
-import { S as StepProcessingResult, A as AgentEvent, b as AgentTurnBoundaryKind } from './events-CE72w8W4.js';
-
-/**
- * Doom-loop handling contracts for repeated tool invocations.
- */
-/**
- * Response from a doom-loop handler.
- */
-type DoomLoopAction = "allow" | "deny" | "remember";
-/**
- * Doom-loop detection request.
- */
-interface DoomLoopRequest {
-    /** The tool being called repeatedly */
-    tool: string;
-    /** How many times it has been called with the same input */
-    repeatCount: number;
-    /** The repeated input */
-    input: unknown;
-    /** Session ID */
-    sessionId: string;
-}
-/**
- * Handler for doom-loop situations.
- */
-type DoomLoopHandler = (request: DoomLoopRequest) => Promise<DoomLoopAction>;
-
-/**
- * Options for processing a streamed model result.
- */
-interface StepProcessingOptions {
-    /** Session ID (optional - for tracking purposes) */
-    sessionID?: string;
-    /** Abort signal */
-    abort: AbortSignal;
-    /** Normalize provider/runtime errors before emitting them as events */
-    normalizeError?: (error: unknown) => Error;
-    /** Event callback */
-    onEvent: (event: AgentEvent) => void | Promise<void>;
-    /** Doom loop threshold (default: 3) */
-    doomLoopThreshold?: number;
-    /** Enforce doom loop (throw error vs warn) when no handler is provided */
-    enforceDoomLoop?: boolean;
-    /**
-     * Handler for doom loop detection.
-     * Allows user choice: allow, deny, or remember.
-     */
-    onDoomLoop?: DoomLoopHandler;
-    /** Tools that are "remembered" (allowed without asking) */
-    rememberedDoomLoopTools?: Set<string>;
-    /** Token limit for context overflow detection */
-    contextTokenLimit?: number;
-    /** Callback for context overflow */
-    onContextOverflow?: (tokens: number, limit: number) => void | Promise<void>;
-    /** Current step number */
-    currentStep?: number;
-    /** Max steps */
-    maxSteps?: number;
-}
-/**
- * Result of stream processing.
- */
-interface StepProcessingOutput {
-    /** Processing result */
-    result: StepProcessingResult;
-    /** Accumulated text */
-    text: string;
-    /** Tool results */
-    toolResults: Array<{
-        toolName: string;
-        toolCallId: string;
-        result: unknown;
-    }>;
-    /** Final usage */
-    usage?: TokenUsage;
-    /** Finish reason reported by the most recent completed step */
-    finishReason?: string;
-    /** Error if any */
-    error?: Error;
-}
-/**
- * @deprecated Use `StepProcessingOptions`.
- */
-type ProcessorOptions = StepProcessingOptions;
-/**
- * @deprecated Use `StepProcessingOutput`.
- */
-type ProcessorOutput = StepProcessingOutput;
-
-interface AgentTurnEngineOptions {
-    sessionId: string;
-    startedAt: string;
-    getToolReplayPolicy?: (toolName: string) => NormalizedToolReplayPolicy | undefined;
-}
-interface AgentTurnBoundaryMetadata {
-    step?: number;
-    messageRole?: Message["role"];
-    pendingToolCallCount?: number;
-}
-interface AgentTurnStepCommitToolCall {
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-    replayPolicy?: NormalizedToolReplayPolicy;
-}
-interface AgentTurnStepCommitToolResult {
-    toolCallId: string;
-    toolName: string;
-    result: unknown;
-    replayPolicy?: NormalizedToolReplayPolicy;
-}
-interface AgentTurnStepCommitSnapshot {
-    toolCalls: AgentTurnStepCommitToolCall[];
-    toolResults: AgentTurnStepCommitToolResult[];
-}
-interface CreateAgentTurnStepCommitBatchOptions {
-    assistantMessageId?: string;
-    toolMessageIds?: Record<string, string>;
-    createdAt?: Date;
-}
-interface AgentTurnCommitBatch {
-    startBoundary: AgentEvent & {
-        type: "turn-boundary";
-    };
-    finishBoundary: AgentEvent & {
-        type: "turn-boundary";
-    };
-    messages: Message[];
-}
-interface AgentTurnOutputCommitOptions {
-    text: string;
-    usage?: TokenUsage;
-    createdAt?: Date;
-    id?: string;
-}
-type AgentTurnBoundaryEvent = AgentEvent & {
-    type: "turn-boundary";
-};
-
-type AgentTurnPhase = "initializing" | "committing-input" | "running-model" | "running-tools" | "committing-step" | "committing-output" | "completed" | "failed";
-interface AgentTurnBoundarySnapshot {
-    kind: AgentTurnBoundaryKind;
-    createdAt: string;
-    step?: number;
-    messageRole?: "system" | "user" | "assistant" | "tool";
-    pendingToolCallCount?: number;
-}
-interface AgentTurnActiveToolCall {
-    toolCallId: string;
-    toolName: string;
-    input: unknown;
-    startedAt: string;
-    replayPolicy?: NormalizedToolReplayPolicy;
-}
-interface AgentTurnResolvedToolCall {
-    toolCallId: string;
-    toolName: string;
-    outcome: "result" | "error";
-    value: unknown;
-    resolvedAt: string;
-    replayPolicy?: NormalizedToolReplayPolicy;
-}
-/**
- * Neutral state model for a single in-flight agent turn.
- *
- * This is intentionally infrastructure-agnostic. Runtime adapters can persist
- * or inspect it without coupling `agent-core` to Dapr, queues, or workflow
- * engines. The current shape is suitable for durable tracking and forms the
- * basis for future workflow-level resume support.
- */
-interface AgentTurnState {
-    sessionId: string;
-    phase: AgentTurnPhase;
-    step: number;
-    maxSteps?: number;
-    response: string;
-    usage: TokenUsage;
-    eventCount: number;
-    activeToolCalls: AgentTurnActiveToolCall[];
-    resolvedToolCalls: AgentTurnResolvedToolCall[];
-    lastFinishReason?: string;
-    lastBoundary?: AgentTurnBoundarySnapshot;
-    lastEvent?: AgentEvent;
-    error?: string;
-    startedAt: string;
-    updatedAt: string;
-}
-interface CreateAgentTurnStateOptions {
-    sessionId: string;
-    startedAt: string;
-}
-interface AgentTurnStateAdvanceOptions {
-    toolReplayPolicy?: NormalizedToolReplayPolicy;
-}
-/**
- * Create the initial neutral state for a single agent turn.
- */
-declare function createAgentTurnState(options: CreateAgentTurnStateOptions): AgentTurnState;
-/**
- * Advance neutral turn state from a streamed `AgentEvent`.
- *
- * This reducer deliberately models coarse but deterministic boundaries:
- * step start, tool activity, step finish, completion, and failure. Runtime
- * adapters can persist the resulting state now, and future resume-capable
- * engines can build on the same state transitions.
- */
-declare function advanceAgentTurnState(state: AgentTurnState, event: AgentEvent, updatedAt: string, options?: AgentTurnStateAdvanceOptions): AgentTurnState;
-/**
- * Mark the turn as failed when execution aborts without a terminal `error`
- * event. This covers exceptions thrown by the stream itself or runtime
- * wrappers around the loop.
- */
-declare function failAgentTurnState(state: AgentTurnState, error: Error, updatedAt: string): AgentTurnState;
-
-/**
- * Neutral internal turn engine for one in-flight agent turn.
- */
-declare class AgentTurnEngine {
-    private turnState;
-    private readonly pendingToolCalls;
-    private readonly pendingToolResults;
-    private readonly getToolReplayPolicy?;
-    constructor(options: AgentTurnEngineOptions);
-    getState(): AgentTurnState;
-    hasPendingToolCalls(): boolean;
-    createStepCommitSnapshot(): AgentTurnStepCommitSnapshot | undefined;
-    recordEvent(event: AgentEvent, updatedAt: string): AgentTurnState;
-    createBoundaryEvent(boundary: AgentTurnBoundaryKind, metadata?: AgentTurnBoundaryMetadata): AgentTurnBoundaryEvent;
-    createInputCommit(options: {
-        content: string;
-        system?: string;
-        createdAt?: Date;
-        id?: string;
-    }): AgentTurnCommitBatch;
-    createInterventionCommit(options: {
-        id: string;
-        content: string;
-        createdAt?: Date;
-    }): AgentTurnCommitBatch;
-    consumeStepCommit(step: number): AgentTurnCommitBatch | undefined;
-    createOutputCommit(options: AgentTurnOutputCommitOptions): AgentTurnCommitBatch | undefined;
-}
-declare function createAgentTurnEngine(options: AgentTurnEngineOptions): AgentTurnEngine;
-
-interface AgentTurnCommitOptions {
-    emitMessages?: boolean;
-}
-type AgentTurnCommitApplier = (batch: AgentTurnCommitBatch, options?: AgentTurnCommitOptions) => AsyncGenerator<AgentEvent>;
-interface AgentTurnStepRuntimeConfig {
-    model: LanguageModel;
-    cwd: string;
-    temperature?: number;
-    topP?: number;
-    maxOutputTokens?: number;
-    maxSteps: number;
-    doomLoopThreshold?: number;
-    enforceDoomLoop?: boolean;
-    onDoomLoop?: DoomLoopHandler;
-    contextWindow?: number;
-    streamProvider?: StreamProvider;
-    telemetry?: TelemetrySettings;
-}
-interface PrepareModelStepOptions {
-    sessionId: string;
-    step: number;
-    systemPrompts: string[];
-    messages: Message[];
-    toModelMessages: (messages: Message[]) => ModelMessage[];
-    abort: AbortSignal;
-    tools: Record<string, Tool.Info>;
-    mcpTools?: ToolSet;
-    config: AgentTurnStepRuntimeConfig;
-    host?: ToolHost;
-    turnTracker?: TurnTrackerContext;
-    intervention?: InterventionController;
-    middleware?: MiddlewareRunner;
-    reasoningLevel?: ReasoningLevel;
-    toolExecutionMode?: ToolExecutionMode;
-}
-interface PreparedAgentModelStep {
-    step: number;
-    messages: Message[];
-    modelMessages: ModelMessage[];
-    inferenceInput: InferenceStreamInput;
-    stepProcessing: {
-        maxSteps: number;
-        doomLoopThreshold?: number;
-        enforceDoomLoop?: boolean;
-        onDoomLoop?: DoomLoopHandler;
-        contextTokenLimit?: number;
-    };
-}
-interface RunModelStepOptions {
-    preparedStep: PreparedAgentModelStep;
-    turnEngine: AgentTurnEngine;
-    applyCommitBatch: AgentTurnCommitApplier;
-    rememberedDoomLoopTools?: Set<string>;
-}
-interface CommitStepOptions {
-    step: number;
-    finishReason?: string;
-    turnEngine: AgentTurnEngine;
-    applyCommitBatch: AgentTurnCommitApplier;
-}
-interface CommitOutputOptions {
-    text: string;
-    usage?: StepProcessingOutput["usage"];
-    turnEngine: AgentTurnEngine;
-    applyCommitBatch: AgentTurnCommitApplier;
-}
-interface RunToolBatchOptions {
-    sessionId: string;
-    snapshot: AgentTurnStepCommitSnapshot;
-    tools: Record<string, Tool.Info>;
-    cwd: string;
-    abort: AbortSignal;
-    host?: ToolHost;
-    turnTracker?: TurnTrackerContext;
-    middleware?: MiddlewareRunner;
-    turnState?: AgentTurnState;
-}
-interface RunToolBatchResult {
-    snapshot: AgentTurnStepCommitSnapshot;
-    turnState?: AgentTurnState;
-    events: Array<Extract<AgentEvent, {
-        type: "tool-result" | "tool-error";
-    }>>;
-}
-
-export { type AgentTurnActiveToolCall as A, advanceAgentTurnState as B, type CommitOutputOptions as C, type DoomLoopAction as D, createAgentTurnEngine as E, createAgentTurnState as F, failAgentTurnState as G, type PrepareModelStepOptions as P, type RunModelStepOptions as R, type StepProcessingOptions as S, type AgentTurnBoundaryMetadata as a, type AgentTurnBoundarySnapshot as b, type AgentTurnCommitApplier as c, type AgentTurnCommitBatch as d, type AgentTurnCommitOptions as e, AgentTurnEngine as f, type AgentTurnEngineOptions as g, type AgentTurnPhase as h, type AgentTurnResolvedToolCall as i, type AgentTurnState as j, type AgentTurnStateAdvanceOptions as k, type AgentTurnStepCommitSnapshot as l, type AgentTurnStepCommitToolCall as m, type AgentTurnStepCommitToolResult as n, type AgentTurnStepRuntimeConfig as o, type CommitStepOptions as p, type CreateAgentTurnStateOptions as q, type CreateAgentTurnStepCommitBatchOptions as r, type DoomLoopHandler as s, type DoomLoopRequest as t, type PreparedAgentModelStep as u, type ProcessorOptions as v, type ProcessorOutput as w, type RunToolBatchOptions as x, type RunToolBatchResult as y, type StepProcessingOutput as z };

package/dist/types-YuWV4ag7.d.ts

@@ -1,72 +0,0 @@
-import { A as AgentEvent } from './events-CE72w8W4.js';
-
-/**
- * Agent Signal — typed event dispatch interface.
- *
- * Defines how consumers subscribe to {@link AgentEvent}s without being
- * part of the middleware stack.  Each Agent owns a signal; events are
- * scoped to that agent instance.
- *
- * The default implementation (`LocalSignal`) dispatches in-process via
- * plain function calls.  A distributed runtime can supply its own
- * implementation that bridges to external infrastructure.
- */
-
-/**
- * Extract a single variant from the AgentEvent union by its `type` tag.
- */
-type EventOf<T extends AgentEvent["type"]> = Extract<AgentEvent, {
-    type: T;
-}>;
-/** Handler for a specific event type. */
-type TypedHandler<T extends AgentEvent["type"]> = (event: EventOf<T>) => void;
-/** Handler that receives every event regardless of type. */
-type WildcardHandler = (event: AgentEvent) => void;
-/** Call to remove a previously registered handler. */
-type Unsubscribe = () => void;
-/**
- * Typed, multi-consumer event dispatch.
- *
- * Subscribe to agent events from anywhere — SSE routes, TUI renderers,
- * plugins, tests.  The interface is deliberately minimal so that backend
- * implementations (in-process, Dapr, Redis, …) have a small contract to
- * fulfil.
- *
- * @example
- * ```ts
- * // Subscribe to a specific event
- * const off = agent.signal.on("text-delta", (e) => process.stdout.write(e.text));
- *
- * // Subscribe to everything
- * const off2 = agent.signal.onAny((e) => logger.info(e.type));
- *
- * // Clean up
- * off();
- * off2();
- * ```
- */
-interface AgentSignal {
-    /**
-     * Subscribe to a specific event type.
-     *
-     * @returns An unsubscribe function.
-     */
-    on<T extends AgentEvent["type"]>(type: T, handler: TypedHandler<T>): Unsubscribe;
-    /**
-     * Subscribe to all events.
-     *
-     * @returns An unsubscribe function.
-     */
-    onAny(handler: WildcardHandler): Unsubscribe;
-    /**
-     * Dispatch an event to every matching handler.
-     *
-     * Called internally by the Agent — but nothing prevents external code
-     * from injecting a synthetic event (useful for testing or bridging).
-     */
-    emit(event: AgentEvent): void;
-    /** Remove all handlers.  Called during agent disposal. */
-    clear(): void;
-}
-
-export type { AgentSignal as A, EventOf as E, TypedHandler as T, Unsubscribe as U, WildcardHandler as W };