@cuylabs/agent-core 0.9.0 → 0.11.0

package/dist/session-manager-KbYt2WUh.d.ts

@@ -1,282 +0,0 @@
-import { M as Message } from './messages-BYWGn8TY.js';
-
-/**
- * Storage Types
- *
- * Core types for session storage with tree structure support.
- * Designed for append-only event sourcing with branching.
- */
-/**
- * Base interface for all session entries
- * Supports tree structure via id/parentId
- */
-interface EntryBase {
-    /** Unique entry ID (8-char hex) */
-    id: string;
-    /** Parent entry ID (null for first entry after header) */
-    parentId: string | null;
-    /** ISO timestamp */
-    timestamp: string;
-}
-/**
- * Session header - always first entry in file
- */
-interface SessionHeader {
-    type: "header";
-    /** Storage format version */
-    version: number;
-    /** Session ID */
-    id: string;
-    /** Working directory */
-    cwd: string;
-    /** ISO timestamp */
-    timestamp: string;
-    /** Parent session ID (if forked) */
-    parentSessionId?: string;
-    /** Session title */
-    title?: string;
-}
-/**
- * Serialized message (dates as ISO strings)
- */
-interface SerializedMessage {
-    id: string;
-    role: "user" | "assistant" | "tool" | "system";
-    content: string;
-    createdAt: string;
-    system?: string;
-    finish?: string;
-    tokens?: {
-        inputTokens?: number;
-        outputTokens?: number;
-        totalTokens?: number;
-    };
-    cost?: number;
-    error?: {
-        name: string;
-        message: string;
-        code?: string;
-    };
-    /** Tool calls for assistant messages with finish=tool-calls */
-    toolCalls?: Array<{
-        toolCallId: string;
-        toolName: string;
-        args: unknown;
-    }>;
-    toolCallId?: string;
-    toolName?: string;
-    result?: unknown;
-}
-/**
- * Message entry
- */
-interface MessageEntry extends EntryBase {
-    type: "message";
-    message: SerializedMessage;
-}
-/**
- * Compaction/summarization entry
- * Replaces old messages with a summary
- */
-interface CompactionEntry extends EntryBase {
-    type: "compaction";
-    /** Summary of compacted messages */
-    summary: string;
-    /** ID of first entry that was kept (not compacted) */
-    firstKeptEntryId: string;
-    /** Token count before compaction */
-    tokensBefore: number;
-    /** Token count after compaction */
-    tokensAfter: number;
-    /** Files that were read during compacted messages */
-    readFiles?: string[];
-    /** Files that were modified during compacted messages */
-    modifiedFiles?: string[];
-}
-/**
- * Session info/metadata update
- */
-interface MetadataEntry extends EntryBase {
-    type: "metadata";
-    /** Updated title */
-    title?: string;
-    /** User-defined name */
-    name?: string;
-}
-/**
- * Branch marker - indicates a branch point
- */
-interface BranchEntry extends EntryBase {
-    type: "branch";
-    /** ID of the entry we're branching from */
-    branchFromId: string;
-    /** Optional summary of the branch */
-    summary?: string;
-}
-/**
- * Model/config change entry
- */
-interface ConfigChangeEntry extends EntryBase {
-    type: "config_change";
-    /** What changed */
-    change: "model" | "reasoning_level" | "temperature" | "other";
-    /** Previous value */
-    from?: string;
-    /** New value */
-    to: string;
-}
-/**
- * All entry types (excluding header)
- */
-type SessionEntry = MessageEntry | CompactionEntry | MetadataEntry | BranchEntry | ConfigChangeEntry;
-/**
- * All file entries (including header)
- */
-type FileEntry = SessionHeader | SessionEntry;
-/**
- * Session summary info (lightweight, for listing)
- */
-interface SessionInfo {
-    /** Session ID */
-    id: string;
-    /** File path */
-    path: string;
-    /** Working directory */
-    cwd: string;
-    /** Session title */
-    title?: string;
-    /** User-defined name */
-    name?: string;
-    /** Parent session ID (if forked) */
-    parentSessionId?: string;
-    /** Creation time */
-    createdAt: Date;
-    /** Last modified time */
-    updatedAt: Date;
-    /** Number of message entries */
-    messageCount: number;
-    /** First user message (preview) */
-    firstMessage?: string;
-}
-/**
- * Session storage interface
- * Pluggable backend for session persistence
- */
-interface SessionStorage {
-    /**
-     * Create a new session
-     */
-    create(header: SessionHeader): Promise<void>;
-    /**
-     * Append an entry to a session
-     */
-    append(sessionId: string, entry: SessionEntry): Promise<void>;
-    /**
-     * Append multiple entries atomically
-     */
-    appendBatch(sessionId: string, entries: SessionEntry[]): Promise<void>;
-    /**
-     * Read all entries from a session
-     */
-    read(sessionId: string): Promise<FileEntry[]>;
-    /**
-     * Delete a session
-     */
-    delete(sessionId: string): Promise<boolean>;
-    /**
-     * Check if session exists
-     */
-    exists(sessionId: string): Promise<boolean>;
-    /**
-     * List all sessions (lightweight info only)
-     */
-    list(): Promise<SessionInfo[]>;
-    /**
-     * Clear all sessions
-     */
-    clear(): Promise<void>;
-}
-/**
- * Current storage format version
- */
-declare const STORAGE_VERSION = 1;
-
-/**
- * Options for creating a new session.
- */
-interface CreateSessionOptions {
-    /** Custom session ID (auto-generated if not provided) */
-    id?: string;
-    /** Working directory */
-    cwd: string;
-    /** Session title */
-    title?: string;
-    /** Parent session ID (if forking) */
-    parentSessionId?: string;
-}
-/**
- * Session context for LLM calls.
- */
-interface SessionContext {
-    /** Messages for LLM context */
-    messages: Message[];
-    /** Current leaf entry ID */
-    leafId: string | null;
-    /** Session metadata */
-    metadata: {
-        id: string;
-        cwd: string;
-        title?: string;
-        name?: string;
-    };
-}
-
-/**
- * Manages session lifecycle with tree-structured entries.
- */
-declare class SessionManager {
-    private storage;
-    private currentSessionId;
-    private currentLeafId;
-    private entriesCache;
-    private idsCache;
-    constructor(storage?: SessionStorage);
-    create(options: CreateSessionOptions): Promise<string>;
-    load(sessionId: string): Promise<void>;
-    getSessionId(): string | null;
-    getLeafId(): string | null;
-    addMessage(message: Message): Promise<string>;
-    addMessages(messages: Message[]): Promise<string[]>;
-    getMessages(leafId?: string): Message[];
-    addCompaction(options: {
-        summary: string;
-        firstKeptEntryId: string;
-        tokensBefore: number;
-        tokensAfter: number;
-        readFiles?: string[];
-        modifiedFiles?: string[];
-    }): Promise<string>;
-    replaceWithCompaction(options: {
-        summary: string;
-        messages: Message[];
-        tokensBefore: number;
-        tokensAfter: number;
-        readFiles?: string[];
-        modifiedFiles?: string[];
-    }): Promise<string>;
-    branch(fromEntryId: string, summary?: string): Promise<string>;
-    switchToLeaf(leafId: string): void;
-    updateMetadata(updates: {
-        title?: string;
-        name?: string;
-    }): Promise<void>;
-    getContext(): SessionContext;
-    getEntries(): FileEntry[];
-    getHeader(): SessionHeader | null;
-    listSessions(): Promise<SessionInfo[]>;
-    deleteSession(sessionId: string): Promise<boolean>;
-    sessionExists(sessionId: string): Promise<boolean>;
-    getStorage(): SessionStorage;
-}
-
-export { type BranchEntry as B, type CompactionEntry as C, type EntryBase as E, type FileEntry as F, type MessageEntry as M, SessionManager as S, type ConfigChangeEntry as a, type CreateSessionOptions as b, type MetadataEntry as c, STORAGE_VERSION as d, type SerializedMessage as e, type SessionContext as f, type SessionEntry as g, type SessionHeader as h, type SessionInfo as i, type SessionStorage as j };

package/dist/signal/index.d.ts

@@ -1,28 +0,0 @@
-import { A as AgentSignal, T as TypedHandler, U as Unsubscribe, W as WildcardHandler } from '../types-YuWV4ag7.js';
-export { E as EventOf } from '../types-YuWV4ag7.js';
-import { A as AgentEvent } from '../events-CE72w8W4.js';
-import 'ai';
-import '../messages-BYWGn8TY.js';
-
-/**
- * LocalSignal — in-process event dispatch.
- *
- * Dispatches events synchronously via direct function calls.
- * Zero dependencies, zero serialization, zero network.
- *
- * Handler errors are caught silently — a broken listener must never
- * interrupt the agent's streaming pipeline.
- */
-
-declare class LocalSignal implements AgentSignal {
-    /** type → Set<handler> for typed subscriptions */
-    private readonly typed;
-    /** handlers that receive every event */
-    private readonly wildcard;
-    on<T extends AgentEvent["type"]>(type: T, handler: TypedHandler<T>): Unsubscribe;
-    onAny(handler: WildcardHandler): Unsubscribe;
-    emit(event: AgentEvent): void;
-    clear(): void;
-}
-
-export { AgentSignal, LocalSignal, TypedHandler, Unsubscribe, WildcardHandler };

package/dist/signal/index.js

@@ -1,6 +0,0 @@
-import {
-  LocalSignal
-} from "../chunk-DXFBQMXP.js";
-export {
-  LocalSignal
-};

package/dist/sub-agent/index.d.ts

@@ -1,24 +0,0 @@
-export { b as AgentDiscoveryOptions, c as AgentDiscoveryResult, d as AgentProfile, e as AgentSource, D as DEFAULT_MAX_CONCURRENT, f as DEFAULT_MAX_SPAWN_DEPTH, g as DEFAULT_SESSION_TITLE_PREFIX, h as DiscoveredProfile, M as MarkdownAgentFrontmatter, i as MarkdownAgentProfile, j as ParsedMarkdownAgent, k as ParsedToolSpec, l as ProfileResolvers, S as SubAgentCompletedResult, m as SubAgentHandle, n as SubAgentStatus, o as SubAgentToolConfig, p as SubAgentTracker, q as SubAgentUsage, T as ToolModifier, t as createSubAgentTools, u as discoverAgentProfiles, v as getProjectAgentsDir, w as getUserAgentsDir, x as isMarkdownProfile, y as parseAgentFrontmatter, z as parseMarkdownAgent, B as parseToolSpec, E as toAgentProfile } from '../index-DQuTZ8xL.js';
-import 'ai';
-import '../types-BlZwmnuW.js';
-import '../types-CQaXbRsS.js';
-import '../tool-CZWN3KbO.js';
-import 'zod';
-import '../tool-DkhSCV2Y.js';
-import '../types-CHiPh8U2.js';
-import '../types-CQL-SvTn.js';
-import '../types-DTSkxakL.js';
-import '@ai-sdk/provider-utils';
-import '../events-CE72w8W4.js';
-import '../messages-BYWGn8TY.js';
-import '../types-BfNpU8NS.js';
-import '../session-manager-KbYt2WUh.js';
-import '../types-VQgymC1N.js';
-import '../types-YuWV4ag7.js';
-import '../tracker-DClqYqTj.js';
-import '../builder-BgZ_j4Vs.js';
-import '../registry-DwYqsQkX.js';
-import '../runner-CI-XeR16.js';
-import '../types-BlOKk-Bb.js';
-import '../llm-error-D93FNNLY.js';
-import '../types-DmDwi2zI.js';

package/dist/sub-agent/index.js

@@ -1,32 +0,0 @@
-import {
-  DEFAULT_MAX_CONCURRENT,
-  DEFAULT_MAX_SPAWN_DEPTH,
-  DEFAULT_SESSION_TITLE_PREFIX,
-  SubAgentTracker,
-  createSubAgentTools,
-  discoverAgentProfiles,
-  getProjectAgentsDir,
-  getUserAgentsDir,
-  isMarkdownProfile,
-  parseAgentFrontmatter,
-  parseMarkdownAgent,
-  parseToolSpec,
-  toAgentProfile
-} from "../chunk-JLXG2SH7.js";
-import "../chunk-EKR6PKXU.js";
-import "../chunk-MHKK374K.js";
-export {
-  DEFAULT_MAX_CONCURRENT,
-  DEFAULT_MAX_SPAWN_DEPTH,
-  DEFAULT_SESSION_TITLE_PREFIX,
-  SubAgentTracker,
-  createSubAgentTools,
-  discoverAgentProfiles,
-  getProjectAgentsDir,
-  getUserAgentsDir,
-  isMarkdownProfile,
-  parseAgentFrontmatter,
-  parseMarkdownAgent,
-  parseToolSpec,
-  toAgentProfile
-};

package/dist/tool-CZWN3KbO.d.ts

@@ -1,141 +0,0 @@
-import { z } from 'zod';
-import { a as ToolMetadata, b as ToolReplayPolicy, T as ToolContext, F as FileOperationMeta, c as ToolResult } from './tool-DkhSCV2Y.js';
-
-/**
- * Tool definition namespace for @cuylabs/agent-core
- *
- * Provides consistent tool creation via Tool.define.
- */
-
-/**
- * A schema type compatible with both Zod 3 and Zod 4.
- *
- * Uses structural typing so that schemas from either Zod version satisfy
- * the constraint. This avoids the problem where Zod 3's `ZodType` class
- * and Zod 4's `ZodType` class have incompatible internal shapes, causing
- * type errors when a library compiled against one version is consumed with
- * the other.
- *
- * Both Zod 3 and Zod 4 (classic API) schemas have `parse()` and `_output`.
- */
-interface CompatibleSchema<T = any> {
-    /** Parse and validate input data. Present in both Zod 3 and Zod 4. */
-    parse(data: unknown): T;
-    /**
-     * Type-level output marker used by both Zod versions:
-     * - Zod 3: `readonly _output!: T` (definite assignment assertion)
-     * - Zod 4 classic: `get _output(): T` (getter)
-     */
-    readonly _output: T;
-}
-/**
- * Infer the output type from a compatible schema.
- * Equivalent to `z.infer<T>` but works with both Zod 3 and Zod 4 schemas.
- */
-type InferSchemaOutput<T extends CompatibleSchema> = T["_output"];
-/**
- * Tool namespace - tool definition utilities
- */
-declare namespace Tool {
-    /**
-     * Tool info interface - the shape of a defined tool
-     */
-    interface Info<TParams extends CompatibleSchema = any, TMeta extends ToolMetadata = ToolMetadata> {
-        /** Unique tool identifier */
-        id: string;
-        /** Recovery semantics for resume-capable runtimes. */
-        replayPolicy?: ToolReplayPolicy;
-        /** Initialize the tool (can be async for dynamic descriptions) */
-        init: (ctx?: InitContext) => Promise<InitResult<TParams, TMeta>> | InitResult<TParams, TMeta>;
-    }
-    /**
-     * Any tool info - for use in arrays and collections where generic types vary
-     */
-    type AnyInfo = Info<any, any>;
-    /**
-     * Context passed during tool initialization
-     */
-    interface InitContext {
-        /** Working directory */
-        cwd?: string;
-        /** Agent name (if known) */
-        agent?: string;
-    }
-    /**
-     * Result of tool initialization
-     */
-    interface InitResult<TParams extends CompatibleSchema = any, TMeta extends ToolMetadata = ToolMetadata> {
-        /** Tool description for the LLM */
-        description: string;
-        /** Zod schema for parameters */
-        parameters: TParams;
-        /** Execute the tool */
-        execute: (params: InferSchemaOutput<TParams>, ctx: ToolContext) => Promise<ExecuteResult<TMeta>>;
-        /** Optional custom validation error formatter */
-        formatValidationError?: (error: z.ZodError) => string;
-        /**
-         * File operation metadata for automatic turn tracking.
-         * When set, the agent will automatically capture file baselines
-         * before tool execution for undo/diff capabilities.
-         *
-         * @example
-         * ```typescript
-         * // For a write tool
-         * fileOps: {
-         *   pathArgs: ['path'],
-         *   operationType: 'write'
-         * }
-         * ```
-         */
-        fileOps?: FileOperationMeta;
-        /** Optional replay metadata for resume-capable runtimes. */
-        replayPolicy?: ToolReplayPolicy;
-    }
-    /**
-     * Result of tool execution
-     */
-    interface ExecuteResult<TMeta extends ToolMetadata = ToolMetadata> {
-        /** Short title for display */
-        title: string;
-        /** Main output text */
-        output: string;
-        /** Metadata */
-        metadata: TMeta;
-    }
-    interface DefineOptions {
-        /** Static replay metadata exposed to higher-level runtimes. */
-        replayPolicy?: ToolReplayPolicy;
-    }
-    /**
-     * Define a tool with standard patterns
-     *
-     * @example
-     * ```typescript
-     * const myTool = Tool.define("my_tool", {
-     *   description: "Does something useful",
-     *   parameters: z.object({
-     *     input: z.string().describe("The input to process"),
-     *   }),
-     *   execute: async (params, ctx) => ({
-     *     title: "Processed",
-     *     output: `Result: ${params.input}`,
-     *     metadata: {},
-     *   }),
-     * });
-     * ```
-     */
-    function define<TParams extends CompatibleSchema, TMeta extends ToolMetadata = ToolMetadata>(id: string, init: Info<TParams, TMeta>["init"] | Awaited<ReturnType<Info<TParams, TMeta>["init"]>>, options?: DefineOptions): Info<TParams, TMeta>;
-}
-/**
- * Legacy helper - wraps to Tool.Info format
- *
- * @deprecated Use Tool.define instead
- */
-declare function defineTool<TParams extends CompatibleSchema>(definition: {
-    id: string;
-    description: string;
-    parameters: TParams;
-    execute: (params: InferSchemaOutput<TParams>, ctx: ToolContext) => Promise<ToolResult>;
-}): Tool.Info<TParams>;
-
-export { type CompatibleSchema as C, type InferSchemaOutput as I, Tool as T, defineTool as d };

package/dist/tool-DkhSCV2Y.d.ts

@@ -1,145 +0,0 @@
-import { T as ToolHost } from './types-CHiPh8U2.js';
-import { S as ScopeSnapshot } from './types-CQL-SvTn.js';
-
-/**
- * Tool-related types for @cuylabs/agent-core
- *
- * Defines the interfaces for tool execution context, results,
- * and metadata used throughout the agent system.
- */
-
-/**
- * Turn tracker interface for tool context
- * Minimal interface to avoid circular dependencies
- */
-interface TurnTrackerContext {
-    /** Capture baseline before writing to a file */
-    beforeWrite(path: string): Promise<boolean>;
-    /** Check if a file is being tracked */
-    isTracking(path: string): boolean;
-}
-/**
- * Tool execution context
- */
-interface ToolContext {
-    /** Working directory for file operations */
-    cwd: string;
-    /** Abort signal for cancellation */
-    abort: AbortSignal;
-    /** Session ID */
-    sessionID: string;
-    /** Message ID */
-    messageID: string;
-    /** Agent name */
-    agent: string;
-    /** Active execution scope snapshot for this tool call. */
-    scope?: ScopeSnapshot;
-    /**
-     * Execution environment for file and process operations.
-     *
-     * Tools should call `ctx.host.readFile()`, `ctx.host.exec()`, etc.
-     * instead of importing `fs` and `child_process` directly. This
-     * allows the same tools to work on local, Docker, SSH, or any
-     * other host without code changes.
-     *
-     * When not provided, tools may fall back to direct Node.js APIs,
-     * but new tools should always prefer `ctx.host`.
-     */
-    host?: ToolHost;
-    /**
-     * Turn change tracker - automatically captures file baselines.
-     * Call `turnTracker.beforeWrite(path)` before modifying files
-     * for undo/diff capabilities.
-     */
-    turnTracker?: TurnTrackerContext;
-    /** Extra context data */
-    extra?: Record<string, unknown>;
-}
-/**
- * Result returned by a tool
- */
-interface ToolResult {
-    /** Short title for display */
-    title: string;
-    /** Main output text */
-    output: string;
-    /** Optional metadata */
-    metadata?: ToolMetadata;
-}
-/**
- * File operation metadata - declare how a tool modifies files
- * Used by TurnChangeTracker for automatic baseline capture
- */
-interface FileOperationMeta {
-    /**
-     * Names of parameters that contain file paths to track.
-     * The tracker will capture baselines for these files before the tool runs.
-     * @example ['path'] for write tool, ['filePath'] for edit tool
-     */
-    pathArgs?: string[];
-    /**
-     * Type of file operation - determines if baseline capture is needed.
-     * - 'read': No baseline capture (file not modified)
-     * - 'write': Capture baseline before overwriting
-     * - 'create': Capture baseline (to know file didn't exist)
-     * - 'delete': Capture baseline before deletion
-     */
-    operationType?: "read" | "write" | "delete" | "create";
-}
-/**
- * Replay mode used by resume-capable runtimes after a crash.
- *
- * - `replay` — the tool may be executed again automatically
- * - `skip` — the tool should not be replayed automatically
- * - `manual` — a higher-level runtime must require an explicit decision
- */
-type ToolReplayMode = "replay" | "skip" | "manual";
-/**
- * Coarse side-effect classification for tool execution.
- *
- * - `none` — read-only or otherwise safe to repeat
- * - `local` — mutates local state such as files
- * - `external` — may affect processes, networks, services, or systems
- */
-type ToolSideEffectLevel = "none" | "local" | "external";
-/**
- * Declares how a resume-capable runtime should treat a tool after failure.
- *
- * This stays infrastructure-agnostic so Dapr and other runtimes can consume
- * the same semantics without leaking runtime-specific types into `agent-core`.
- */
-interface ToolReplayPolicy {
-    /** Replay behavior requested by the tool author. */
-    mode?: ToolReplayMode;
-    /** Coarse side-effect classification. */
-    sideEffectLevel?: ToolSideEffectLevel;
-    /** Optional human-readable rationale for audits and recovery UIs. */
-    reason?: string;
-}
-/**
- * Fully resolved replay policy with defaults applied.
- */
-interface NormalizedToolReplayPolicy {
-    mode: ToolReplayMode;
-    sideEffectLevel: ToolSideEffectLevel;
-    reason?: string;
-}
-/**
- * Tool metadata
- */
-interface ToolMetadata {
-    /** Whether output was truncated */
-    truncated?: boolean;
-    /** Path to full output if truncated */
-    outputPath?: string;
-    /**
-     * File operation metadata for automatic turn tracking.
-     * When set, the agent will automatically capture file baselines
-     * before tool execution for undo/diff capabilities.
-     */
-    fileOps?: FileOperationMeta;
-    /** Additional metadata */
-    [key: string]: unknown;
-}
-
-export type { FileOperationMeta as F, NormalizedToolReplayPolicy as N, ToolContext as T, ToolMetadata as a, ToolReplayPolicy as b, ToolResult as c, TurnTrackerContext as d, ToolReplayMode as e, ToolSideEffectLevel as f };