@cuylabs/agent-core 0.6.0 → 0.7.0

package/dist/{session-manager-Uawm2Le7.d.ts → session-manager-B_CWGTsl.d.ts}

@@ -271,4 +271,4 @@ declare class SessionManager {
     getStorage(): SessionStorage;
 }
 
-export { type BranchEntry as B, type CompactionEntry as C, type EntryBase as E, type FileEntry as F, type MessageEntry as M, STORAGE_VERSION as S, type CreateSessionOptions as a, type MetadataEntry as b, type SessionContext as c, type SessionEntry as d, type SessionHeader as e, type SessionInfo as f, SessionManager as g, type SessionStorage as h, type SerializedMessage as i, type ConfigChangeEntry as j };
+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/skill/index.d.ts

@@ -1,9 +1,11 @@
-import { h as SkillScope, i as SkillSource, a as SkillMetadata, g as SkillResourceType, c as SkillResource, b as SkillContent, d as SkillConfig, S as SkillDiscoveryResult, T as Tool } from '../tool-pFAnJc5Y.js';
-export { R as RemoteSkillEntry, e as RemoteSkillIndex, f as SkillDiscoveryError, j as SkillSourceType } from '../tool-pFAnJc5Y.js';
-import { S as SkillRegistry } from '../registry-CuRWWtcT.js';
-export { c as createSkillRegistry, e as emptySkillRegistry } from '../registry-CuRWWtcT.js';
+import { h as SkillScope, i as SkillSource, a as SkillMetadata, g as SkillResourceType, c as SkillResource, b as SkillContent, d as SkillConfig, S as SkillDiscoveryResult, T as Tool } from '../tool-Db1Ue-1U.js';
+export { R as RemoteSkillEntry, e as RemoteSkillIndex, f as SkillDiscoveryError, j as SkillSourceType } from '../tool-Db1Ue-1U.js';
+import { S as SkillRegistry } from '../registry-BDLIHOQB.js';
+export { c as createSkillRegistry, e as emptySkillRegistry } from '../registry-BDLIHOQB.js';
 import 'zod';
-import '../tool-DYp6-cC3.js';
+import '../tool-HUtkiVBx.js';
+import '../types-CHiPh8U2.js';
+import '../types-9jGQUjqW.js';
 
 declare const SKILL_FILENAME = "SKILL.md";
 declare const DEFAULT_SKILL_MAX_SIZE = 102400;

package/dist/storage/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FileEntry, i as SerializedMessage, d as SessionEntry, M as MessageEntry, b as MetadataEntry, f as SessionInfo, h as SessionStorage, e as SessionHeader, g as SessionManager } from '../session-manager-Uawm2Le7.js';
-export { B as BranchEntry, C as CompactionEntry, j as ConfigChangeEntry, a as CreateSessionOptions, E as EntryBase, S as STORAGE_VERSION, c as SessionContext } from '../session-manager-Uawm2Le7.js';
+import { F as FileEntry, g as SessionEntry, M as MessageEntry, c as MetadataEntry, e as SerializedMessage, i as SessionInfo, j as SessionStorage, h as SessionHeader, S as SessionManager } from '../session-manager-B_CWGTsl.js';
+export { B as BranchEntry, C as CompactionEntry, a as ConfigChangeEntry, b as CreateSessionOptions, E as EntryBase, d as STORAGE_VERSION, f as SessionContext } from '../session-manager-B_CWGTsl.js';
 import { M as Message } from '../messages-BYWGn8TY.js';
 
 /**

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

@@ -1,14 +1,18 @@
-export { c as AgentProfile, D as DEFAULT_MAX_CONCURRENT, d as DEFAULT_MAX_SPAWN_DEPTH, e as DEFAULT_SESSION_TITLE_PREFIX, S as SubAgentCompletedResult, f as SubAgentHandle, g as SubAgentStatus, h as SubAgentToolConfig, i as SubAgentTracker, j as SubAgentUsage, l as createSubAgentTools } from '../index-DZQJD_hp.js';
+export { c as AgentProfile, D as DEFAULT_MAX_CONCURRENT, d as DEFAULT_MAX_SPAWN_DEPTH, e as DEFAULT_SESSION_TITLE_PREFIX, S as SubAgentCompletedResult, g as SubAgentHandle, h as SubAgentStatus, i as SubAgentToolConfig, j as SubAgentTracker, k as SubAgentUsage, m as createSubAgentTools } from '../index-C33hlD6H.js';
 import 'ai';
 import '../types-CQaXbRsS.js';
-import '../tool-pFAnJc5Y.js';
+import '../tool-Db1Ue-1U.js';
 import 'zod';
-import '../tool-DYp6-cC3.js';
-import '../runner-G1wxEgac.js';
+import '../tool-HUtkiVBx.js';
+import '../types-CHiPh8U2.js';
+import '../types-9jGQUjqW.js';
+import '../runner-DSKaEz3z.js';
+import '@ai-sdk/provider-utils';
 import '../messages-BYWGn8TY.js';
-import '../session-manager-Uawm2Le7.js';
+import '../session-manager-B_CWGTsl.js';
 import '../types-VQgymC1N.js';
 import '../tracker-DClqYqTj.js';
-import '../builder-BKkipazh.js';
-import '../registry-CuRWWtcT.js';
-import '../types-BWo810L_.js';
+import '../builder-BRvqCcIk.js';
+import '../registry-BDLIHOQB.js';
+import '../types-FRpzzg_9.js';
+import '../types-CqDZTh4d.js';

package/dist/tool/index.d.ts

@@ -1,9 +1,12 @@
-import { T as Tool } from '../tool-pFAnJc5Y.js';
-export { C as CompatibleSchema, I as InferSchemaOutput, k as defineTool } from '../tool-pFAnJc5Y.js';
-import { a as ToolReplayPolicy, F as FileOperationMeta, N as NormalizedToolReplayPolicy, d as ToolHost, e as TurnTrackerContext } from '../tool-DYp6-cC3.js';
-import { M as MiddlewareRunner } from '../runner-G1wxEgac.js';
+import { T as Tool } from '../tool-Db1Ue-1U.js';
+export { C as CompatibleSchema, I as InferSchemaOutput, k as defineTool } from '../tool-Db1Ue-1U.js';
+import { a as ToolReplayPolicy, F as FileOperationMeta, N as NormalizedToolReplayPolicy, d as TurnTrackerContext } from '../tool-HUtkiVBx.js';
+import { T as ToolHost } from '../types-CHiPh8U2.js';
+import { M as MiddlewareRunner } from '../runner-DSKaEz3z.js';
 import 'zod';
+import '../types-9jGQUjqW.js';
 import 'ai';
+import '@ai-sdk/provider-utils';
 import '../messages-BYWGn8TY.js';
 import '../types-CQaXbRsS.js';
 

package/dist/tool/index.js

@@ -2,9 +2,6 @@ import {
   ToolRegistry,
   defaultRegistry
 } from "../chunk-SDSBEQXG.js";
-import {
-  executeAgentToolCall
-} from "../chunk-FG4MD5MU.js";
 import {
   MAX_BYTES,
   MAX_LINES,
@@ -16,6 +13,10 @@ import {
   normalizeToolReplayPolicy,
   truncateOutput
 } from "../chunk-P6YF7USR.js";
+import {
+  executeAgentToolCall
+} from "../chunk-IEFIQENH.js";
+import "../chunk-N7P4PN3O.js";
 import "../chunk-VEKUXUVF.js";
 export {
   MAX_BYTES,

package/dist/{tool-pFAnJc5Y.d.ts → tool-Db1Ue-1U.d.ts}

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { T as ToolMetadata, a as ToolReplayPolicy, b as ToolContext, F as FileOperationMeta, c as ToolResult } from './tool-DYp6-cC3.js';
+import { T as ToolMetadata, a as ToolReplayPolicy, b as ToolContext, F as FileOperationMeta, c as ToolResult } from './tool-HUtkiVBx.js';
 
 /**
  * Skill System Types

package/dist/{tool-DYp6-cC3.d.ts → tool-HUtkiVBx.d.ts}

@@ -1,101 +1,5 @@
-/**
- * ToolHost — execution environment abstraction for agent tools.
- *
- * A ToolHost defines *where* tools execute: local machine, Docker container,
- * SSH remote, etc. Every host provides two surfaces:
- *
- * 1. **File system** — read, write, stat, list, check existence
- * 2. **Process execution** — spawn commands, kill processes
- *
- * Tools call `ctx.host.readFile()` / `ctx.host.exec()` instead of importing
- * `fs` and `child_process` directly. The host implementation handles the rest.
- *
- * @example
- * ```typescript
- * // Default: runs everything locally
- * const agent = createAgent({ host: localHost() });
- *
- * // Future: run tools inside a Docker container
- * const agent = createAgent({ host: dockerHost("my-container") });
- * ```
- */
-/** Options for spawning a process. */
-interface ExecOptions {
-    /** Working directory for the command. */
-    cwd?: string;
-    /** Environment variables (merged with host defaults). */
-    env?: Record<string, string | undefined>;
-    /** Abort signal for cancellation. */
-    signal?: AbortSignal;
-    /** Timeout in milliseconds. 0 = no timeout. */
-    timeout?: number;
-    /** Callback for stdout data as it arrives. */
-    onStdout?: (data: Buffer) => void;
-    /** Callback for stderr data as it arrives. */
-    onStderr?: (data: Buffer) => void;
-}
-/** Result of a process execution. */
-interface ExecResult {
-    /** Combined stdout output. */
-    stdout: string;
-    /** Combined stderr output. */
-    stderr: string;
-    /** Exit code (null if killed by signal). */
-    exitCode: number | null;
-    /** Whether the process was killed due to timeout. */
-    timedOut: boolean;
-}
-/** Minimal stat result — only the fields tools actually need. */
-interface FileStat {
-    /** File size in bytes. */
-    size: number;
-    /** Last modification time. */
-    mtime: Date;
-    /** Whether this entry is a directory. */
-    isDirectory: boolean;
-    /** Whether this entry is a regular file. */
-    isFile: boolean;
-}
-/** A directory entry returned by `readdir`. */
-interface DirEntry {
-    /** Entry name (not full path). */
-    name: string;
-    /** Whether this entry is a directory. */
-    isDirectory: boolean;
-    /** Whether this entry is a regular file. */
-    isFile: boolean;
-}
-/**
- * The execution environment for agent tools.
- *
- * Abstracts filesystem and process operations so tools work identically
- * whether running locally, in Docker, over SSH, or in any other environment.
- */
-interface ToolHost {
-    /** Human-readable host identifier (e.g. "local", "docker:my-container"). */
-    readonly name: string;
-    /** Read a file as a UTF-8 string. Throws if the file doesn't exist. */
-    readFile(path: string): Promise<string>;
-    /** Read raw bytes from a file. Throws if the file doesn't exist. */
-    readBytes(path: string, offset: number, length: number): Promise<Buffer>;
-    /** Write a UTF-8 string to a file. Creates parent directories as needed. */
-    writeFile(path: string, content: string): Promise<void>;
-    /** Check if a path exists. Never throws. */
-    exists(path: string): Promise<boolean>;
-    /** Get file metadata. Throws if the path doesn't exist. */
-    stat(path: string): Promise<FileStat>;
-    /** List directory entries. Throws if the path is not a directory. */
-    readdir(path: string): Promise<DirEntry[]>;
-    /** Create directories recursively. No-op if they already exist. */
-    mkdir(path: string): Promise<void>;
-    /**
-     * Execute a shell command.
-     *
-     * The host decides which shell to use (e.g. local host uses the user's
-     * `$SHELL`, Docker host uses `docker exec`, SSH host uses remote shell).
-     */
-    exec(command: string, options?: ExecOptions): Promise<ExecResult>;
-}
+import { T as ToolHost } from './types-CHiPh8U2.js';
+import { b as ScopeSnapshot } from './types-9jGQUjqW.js';
 
 /**
  * Tool-related types for @cuylabs/agent-core
@@ -128,6 +32,8 @@ interface ToolContext {
     messageID: string;
     /** Agent name */
     agent: string;
+    /** Active execution scope snapshot for this tool call. */
+    scope?: ScopeSnapshot;
     /**
      * Execution environment for file and process operations.
      *
@@ -236,4 +142,4 @@ interface ToolMetadata {
     [key: string]: unknown;
 }
 
-export type { DirEntry as D, ExecOptions as E, FileOperationMeta as F, NormalizedToolReplayPolicy as N, ToolMetadata as T, ToolReplayPolicy as a, ToolContext as b, ToolResult as c, ToolHost as d, TurnTrackerContext as e, ExecResult as f, FileStat as g, ToolReplayMode as h, ToolSideEffectLevel as i };
+export type { FileOperationMeta as F, NormalizedToolReplayPolicy as N, ToolMetadata as T, ToolReplayPolicy as a, ToolContext as b, ToolResult as c, TurnTrackerContext as d, ToolReplayMode as e, ToolSideEffectLevel as f };

package/dist/tracking/index.d.ts

@@ -1,6 +1,8 @@
 import { T as TurnChangeTracker } from '../tracker-DClqYqTj.js';
 export { F as FileBaseline, a as TurnFileChange, b as TurnSummary, c as TurnTrackerConfig, U as UndoResult, d as createTurnTracker } from '../tracker-DClqYqTj.js';
-import { F as FileOperationMeta } from '../tool-DYp6-cC3.js';
+import { F as FileOperationMeta } from '../tool-HUtkiVBx.js';
+import '../types-CHiPh8U2.js';
+import '../types-9jGQUjqW.js';
 
 /**
  * Checkpoint system contracts for @cuylabs/agent-core.

package/dist/types-9jGQUjqW.d.ts

@@ -0,0 +1,29 @@
+type ScopeKind = "task" | "turn" | "model" | "tool" | "commit" | "sub-agent" | "activity";
+type ScopeAttributeValue = string | number | boolean | null;
+type ScopeAttributes = Record<string, ScopeAttributeValue | undefined>;
+interface Scope {
+    id: string;
+    rootId: string;
+    kind: ScopeKind;
+    name: string;
+    parentId?: string;
+    depth: number;
+    startedAt: string;
+    sessionId?: string;
+    taskId?: string;
+    step?: number;
+    attributes: ScopeAttributes;
+}
+type ScopeSnapshot = Scope;
+interface ScopeOptions {
+    id?: string;
+    kind: ScopeKind;
+    name: string;
+    parent?: ScopeSnapshot | null;
+    sessionId?: string;
+    taskId?: string;
+    step?: number;
+    attributes?: ScopeAttributes;
+}
+
+export type { ScopeOptions as S, Scope as a, ScopeSnapshot as b, ScopeAttributeValue as c, ScopeAttributes as d, ScopeKind as e };

package/dist/types-CHiPh8U2.d.ts

@@ -0,0 +1,100 @@
+/**
+ * ToolHost — execution environment abstraction for agent tools.
+ *
+ * A ToolHost defines *where* tools execute: local machine, Docker container,
+ * SSH remote, etc. Every host provides two surfaces:
+ *
+ * 1. **File system** — read, write, stat, list, check existence
+ * 2. **Process execution** — spawn commands, kill processes
+ *
+ * Tools call `ctx.host.readFile()` / `ctx.host.exec()` instead of importing
+ * `fs` and `child_process` directly. The host implementation handles the rest.
+ *
+ * @example
+ * ```typescript
+ * // Default: runs everything locally
+ * const agent = createAgent({ host: localHost() });
+ *
+ * // Future: run tools inside a Docker container
+ * const agent = createAgent({ host: dockerHost("my-container") });
+ * ```
+ */
+/** Options for spawning a process. */
+interface ExecOptions {
+    /** Working directory for the command. */
+    cwd?: string;
+    /** Environment variables (merged with host defaults). */
+    env?: Record<string, string | undefined>;
+    /** Abort signal for cancellation. */
+    signal?: AbortSignal;
+    /** Timeout in milliseconds. 0 = no timeout. */
+    timeout?: number;
+    /** Callback for stdout data as it arrives. */
+    onStdout?: (data: Buffer) => void;
+    /** Callback for stderr data as it arrives. */
+    onStderr?: (data: Buffer) => void;
+}
+/** Result of a process execution. */
+interface ExecResult {
+    /** Combined stdout output. */
+    stdout: string;
+    /** Combined stderr output. */
+    stderr: string;
+    /** Exit code (null if killed by signal). */
+    exitCode: number | null;
+    /** Whether the process was killed due to timeout. */
+    timedOut: boolean;
+}
+/** Minimal stat result — only the fields tools actually need. */
+interface FileStat {
+    /** File size in bytes. */
+    size: number;
+    /** Last modification time. */
+    mtime: Date;
+    /** Whether this entry is a directory. */
+    isDirectory: boolean;
+    /** Whether this entry is a regular file. */
+    isFile: boolean;
+}
+/** A directory entry returned by `readdir`. */
+interface DirEntry {
+    /** Entry name (not full path). */
+    name: string;
+    /** Whether this entry is a directory. */
+    isDirectory: boolean;
+    /** Whether this entry is a regular file. */
+    isFile: boolean;
+}
+/**
+ * The execution environment for agent tools.
+ *
+ * Abstracts filesystem and process operations so tools work identically
+ * whether running locally, in Docker, over SSH, or in any other environment.
+ */
+interface ToolHost {
+    /** Human-readable host identifier (e.g. "local", "docker:my-container"). */
+    readonly name: string;
+    /** Read a file as a UTF-8 string. Throws if the file doesn't exist. */
+    readFile(path: string): Promise<string>;
+    /** Read raw bytes from a file. Throws if the file doesn't exist. */
+    readBytes(path: string, offset: number, length: number): Promise<Buffer>;
+    /** Write a UTF-8 string to a file. Creates parent directories as needed. */
+    writeFile(path: string, content: string): Promise<void>;
+    /** Check if a path exists. Never throws. */
+    exists(path: string): Promise<boolean>;
+    /** Get file metadata. Throws if the path doesn't exist. */
+    stat(path: string): Promise<FileStat>;
+    /** List directory entries. Throws if the path is not a directory. */
+    readdir(path: string): Promise<DirEntry[]>;
+    /** Create directories recursively. No-op if they already exist. */
+    mkdir(path: string): Promise<void>;
+    /**
+     * Execute a shell command.
+     *
+     * The host decides which shell to use (e.g. local host uses the user's
+     * `$SHELL`, Docker host uses `docker exec`, SSH host uses remote shell).
+     */
+    exec(command: string, options?: ExecOptions): Promise<ExecResult>;
+}
+
+export type { DirEntry as D, ExecOptions as E, FileStat as F, ToolHost as T, ExecResult as a };