@cuylabs/agent-core 4.8.1 → 4.10.0

package/README.md

@@ -40,8 +40,7 @@ and host implementations stay decoupled.
 - Skills and built-in dispatch-based child-agent delegation
 - OpenTelemetry tracing
 - MCP integration
-- EventBus — pluggable pub/sub with history replay and backpressure
-- AgentSignal — typed inter-agent signalling within teams
+- Event primitives — AgentSignal fan-out and EventBus replay/backpressure
 - Runtime-facing task, turn, and workflow primitives for durable adapters
 
 ## Installation
@@ -121,17 +120,17 @@ import { Inference } from "@cuylabs/agent-core/inference";
 import { createAgentTaskRunner } from "@cuylabs/agent-core/execution";
 import { localHost } from "@cuylabs/agent-core/tool/host";
 import { createPromptBuilder } from "@cuylabs/agent-core/prompt";
-import { withinScope } from "@cuylabs/agent-core/scope";
+import { withinScope } from "@cuylabs/agent-core/execution/scope";
 import { createSkillRegistry } from "@cuylabs/agent-core/skill";
 import { createSubAgentTools } from "@cuylabs/agent-core/subagents";
 import { createMCPManager } from "@cuylabs/agent-core/mcp";
-import { createEventBus } from "@cuylabs/agent-core/events";
-import type { AgentSignal } from "@cuylabs/agent-core/signal";
+import { createEventBus, type AgentSignal } from "@cuylabs/agent-core/events";
 ```
 
 Additional focused entrypoints are available for `tool`, `tracking`, `storage`,
-`reasoning`, `models`, `mcp`, `inference`, `tool/host`, `scope`, `dispatch`,
-`subagents`, `events`, and `signal`.
+`reasoning`, `models`, `mcp`, `inference`, `tool/host`, `execution/scope`,
+`execution/turn`, `execution/workflow`, `dispatch`, `subagents`, `events`,
+`events/signal`, and `events/event-bus`.
 
 For non-local tool execution environments, install a dedicated host package and
 pass its host instance through the same `host` option.
@@ -163,14 +162,14 @@ turn surfaces those packages build on:
 Start with the package docs:
 
 - [docs/README.md](./docs/README.md) for the learning path
-- [docs/agent.md](./docs/agent.md) for the main `Agent` API
+- [docs/agent/README.md](./docs/agent/README.md) for the main `Agent` API
 - [docs/middleware/](./docs/middleware/README.md) for model/tool hooks and lifecycle middleware
-- [docs/scope.md](./docs/scope.md) for nested execution lineage and scope snapshots
+- [docs/execution/scope.md](./docs/execution/scope.md) for nested execution lineage and scope snapshots
 - [docs/tools/](./docs/tools/README.md) for tool definition and execution
 - [docs/execution/README.md](./docs/execution/README.md) for task/turn/workflow execution integration
-- [docs/events.md](./docs/events.md) for the EventBus pub/sub interface
-- [docs/signal.md](./docs/signal.md) for inter-agent signalling
-- [docs/tracing.md](./docs/tracing.md) for tracing setup
+- [docs/events.md](./docs/events.md) for EventBus and AgentSignal event primitives
+- [docs/signal.md](./docs/signal.md) for inter-agent signalling details
+- [docs/agent/tracing.md](./docs/agent/tracing.md) for tracing setup
 
 Runnable examples live in [examples/README.md](./examples/README.md).
 

package/dist/agent/chat-loop/commit-batch.d.ts

@@ -0,0 +1,10 @@
+import type { SessionManager } from "../../storage/index.js";
+import type { MiddlewareRunner } from "../../middleware/runner.js";
+import type { AgentTurnEngine } from "../../execution/turn/index.js";
+import type { AgentTurnCommitApplier } from "../../execution/turn/runner/types.js";
+export declare function createChatLoopCommitBatchApplier(params: {
+    turnEngine: AgentTurnEngine;
+    sessions: SessionManager;
+    middlewareRunner: MiddlewareRunner;
+}): AgentTurnCommitApplier;
+//# sourceMappingURL=commit-batch.d.ts.map

package/dist/agent/chat-loop/commit-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-batch.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/commit-batch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,sCAAsC,CAAC;AAE9C,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,GAAG,sBAAsB,CAuBzB"}

package/dist/agent/chat-loop/context-recovery.d.ts

@@ -0,0 +1,29 @@
+import type { Logger } from "../../logger/types.js";
+import type { SessionManager } from "../../storage/index.js";
+import type { CompactionConfig } from "../../types/compaction.js";
+import type { AgentContextCompactionPhase } from "../../types/events.js";
+import type { ContextWindowManager } from "../../context/window/index.js";
+import type { AgentMemoryProvider } from "../../memory/index.js";
+import { type AgentContextCompactionCheckResult } from "../turn-context/compaction/check.js";
+export interface ResolvedContextRecoveryConfig {
+    enabled: boolean;
+    compactBeforeStep: boolean;
+    maxRetries: number;
+}
+export declare function resolveContextRecoveryConfig(compaction: CompactionConfig | undefined): ResolvedContextRecoveryConfig;
+export declare function isContextOverflowError(error: unknown): boolean;
+export declare function runContextRecoveryCompaction(params: {
+    contextManager: ContextWindowManager;
+    sessions: SessionManager;
+    logger?: Logger;
+    force: boolean;
+    phase: AgentContextCompactionPhase;
+    sessionId?: string;
+    turnId?: string;
+    cwd?: string;
+    abort?: AbortSignal;
+    memoryProvider?: AgentMemoryProvider;
+    retryAttempt?: number;
+    transientContextTokens?: number;
+}): Promise<AgentContextCompactionCheckResult>;
+//# sourceMappingURL=context-recovery.d.ts.map

package/dist/agent/chat-loop/context-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-recovery.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/context-recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,qCAAqC,CAAC;AAI7C,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,gBAAgB,GAAG,SAAS,GACvC,6BAA6B,CAa/B;AAeD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAoB9D;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,cAAc,EAAE,oBAAoB,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,2BAA2B,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,GAAG,OAAO,CAAC,iCAAiC,CAAC,CAE7C"}

package/dist/agent/chat-loop/finalize-turn.d.ts

@@ -0,0 +1,19 @@
+import type { AgentTurnEngine } from "../../execution/turn/index.js";
+import { type AgentTurnCommitApplier } from "../../execution/turn/index.js";
+import type { TurnChangeTracker } from "../../tracking/turn-tracker/index.js";
+import type { AgentEvent } from "../../types/events.js";
+import type { TokenUsage } from "../../types/messages.js";
+import type { ChatLoopDeps } from "./types.js";
+export interface ChatLoopFinalizationResult {
+    output?: string;
+    usage?: TokenUsage;
+}
+export declare function finalizeChatLoopTurn(options: {
+    deps: ChatLoopDeps;
+    turnEngine: AgentTurnEngine;
+    applyCommitBatch: AgentTurnCommitApplier;
+    turnTracker: TurnChangeTracker;
+    text: string;
+    usage?: TokenUsage;
+}): AsyncGenerator<AgentEvent, ChatLoopFinalizationResult>;
+//# sourceMappingURL=finalize-turn.d.ts.map

package/dist/agent/chat-loop/finalize-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize-turn.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/finalize-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,wBAAuB,oBAAoB,CAAC,OAAO,EAAE;IACnD,IAAI,EAAE,YAAY,CAAC;IACnB,UAAU,EAAE,eAAe,CAAC;IAC5B,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,cAAc,CAAC,UAAU,EAAE,0BAA0B,CAAC,CAgEzD"}

package/dist/agent/chat-loop/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Chat loop helpers for direct turn execution, commit boundaries,
+ * model-step snapshots, context recovery, and turn finalization.
+ */
+export type { ChatLoopDeps } from "./types.js";
+export { runChatLoop } from "./loop.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/chat-loop/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/agent/chat-loop/loop.d.ts

@@ -0,0 +1,8 @@
+import type { AgentEvent } from "../../types/events.js";
+import type { ChatLoopDeps } from "./types.js";
+/**
+ * Run the core chat loop: input commit → step loop → output commit →
+ * auto-compaction → turn summary → complete.
+ */
+export declare function runChatLoop(deps: ChatLoopDeps): AsyncGenerator<AgentEvent>;
+//# sourceMappingURL=loop.d.ts.map

package/dist/agent/chat-loop/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAiBxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C;;;GAGG;AACH,wBAAuB,WAAW,CAChC,IAAI,EAAE,YAAY,GACjB,cAAc,CAAC,UAAU,CAAC,CA0V5B"}

package/dist/agent/chat-loop/model-step-runner.d.ts

@@ -0,0 +1,26 @@
+import type { ModelContextCompactionReport } from "../../context/assembly/index.js";
+import type { AgentTurnEngine } from "../../execution/turn/index.js";
+import { type AgentTurnCommitApplier } from "../../execution/turn/index.js";
+import type { StepProcessingOutput } from "../../execution/turn/index.js";
+import type { AgentEvent } from "../../types/events.js";
+import { type ResolvedContextRecoveryConfig } from "./context-recovery.js";
+import { type ChatModelStepToolRecord } from "./model-step-snapshot.js";
+import type { ChatLoopDeps } from "./types.js";
+import type { ResolvedTurnTools } from "./turn-tools.js";
+export interface ChatModelStepRunResult {
+    stepResult: StepProcessingOutput;
+    toolRecord: ChatModelStepToolRecord;
+    compactionReport?: ModelContextCompactionReport;
+}
+export declare function runChatModelStepWithRecovery(options: {
+    deps: ChatLoopDeps;
+    step: number;
+    turnEngine: AgentTurnEngine;
+    applyCommitBatch: AgentTurnCommitApplier;
+    resolvedTurnTools: ResolvedTurnTools;
+    turnMcpTools: ChatLoopDeps["mcpTools"];
+    toolRecord: ChatModelStepToolRecord;
+    contextRecovery: ResolvedContextRecoveryConfig;
+    compactionReport?: ModelContextCompactionReport;
+}): AsyncGenerator<AgentEvent, ChatModelStepRunResult>;
+//# sourceMappingURL=model-step-runner.d.ts.map

package/dist/agent/chat-loop/model-step-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-step-runner.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/model-step-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAEL,KAAK,6BAA6B,EAEnC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,EAAE,uBAAuB,CAAC;IACpC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;CACjD;AAED,wBAAuB,4BAA4B,CAAC,OAAO,EAAE;IAC3D,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,eAAe,CAAC;IAC5B,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACvC,UAAU,EAAE,uBAAuB,CAAC;IACpC,eAAe,EAAE,6BAA6B,CAAC;IAC/C,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;CACjD,GAAG,cAAc,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAmIrD"}

package/dist/agent/chat-loop/model-step-snapshot.d.ts

@@ -0,0 +1,49 @@
+import type { Tool as AITool } from "ai";
+import type { MiddlewareRunner } from "../../middleware/runner.js";
+import type { PromptBuilder } from "../../prompt/index.js";
+import type { SessionManager } from "../../storage/index.js";
+import type { Tool } from "../../tool/tool.js";
+import type { Message } from "../../types/messages.js";
+import type { ModelContextAssemblyReport, ModelContextCompactionReport } from "../../context/assembly/index.js";
+import type { ContextWindowManager } from "../../context/window/index.js";
+import type { AgentMemoryProvider } from "../../memory/index.js";
+import type { Logger } from "../../logger/types.js";
+import type { AgentEvent } from "../../types/events.js";
+import type { EffectiveAgentConfig } from "../setup.js";
+import { type ResolvedTurnTools } from "./turn-tools.js";
+export type ChatModelStepToolRecord = Record<string, Tool.Info>;
+export interface ChatModelStepSnapshot {
+    sessionId: string;
+    turnId: string;
+    step: number;
+    systemPrompts: string[];
+    messages: Message[];
+    contextReport: ModelContextAssemblyReport;
+    tools: ChatModelStepToolRecord;
+    mcpTools: Record<string, AITool>;
+    events: AgentEvent[];
+}
+export declare function createChatModelStepToolRecord(params: {
+    liveTools: Map<string, Tool.AnyInfo>;
+    resolvedTurnTools: ResolvedTurnTools;
+}): ChatModelStepToolRecord;
+export declare function createChatModelStepSnapshot(params: {
+    sessionId: string;
+    turnId: string;
+    step: number;
+    sessions: SessionManager;
+    liveTools: Map<string, Tool.AnyInfo>;
+    resolvedTurnTools: ResolvedTurnTools;
+    mcpTools: Record<string, AITool>;
+    promptBuilder?: PromptBuilder;
+    middlewareRunner: MiddlewareRunner;
+    contextManager: ContextWindowManager;
+    compactionReport?: ModelContextCompactionReport;
+    fitAssembledContext?: boolean;
+    memoryProvider?: AgentMemoryProvider;
+    logger?: Logger;
+    systemOverride?: string;
+    config: EffectiveAgentConfig;
+    abort?: AbortSignal;
+}): Promise<ChatModelStepSnapshot>;
+//# sourceMappingURL=model-step-snapshot.d.ts.map

package/dist/agent/chat-loop/model-step-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-step-snapshot.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/model-step-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,IAAI,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EACV,0BAA0B,EAC1B,4BAA4B,EAC7B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAEhE,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,0BAA0B,CAAC;IAC1C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;CACtC,GAAG,uBAAuB,CAI1B;AAYD,wBAAsB,2BAA2B,CAAC,MAAM,EAAE;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,oBAAoB,CAAC;IACrC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA6CjC"}

package/dist/agent/chat-loop/turn-tools.d.ts

@@ -0,0 +1,19 @@
+import type { Tool as AITool } from "ai";
+import type { Tool } from "../../tool/tool.js";
+import type { AgentTurnToolContext, AgentTurnToolProvider } from "../../tool/turn-tools.js";
+type TurnToolCleanup = () => void | Promise<void>;
+export interface ResolvedTurnTools {
+    tools: Map<string, Tool.AnyInfo>;
+    mcpTools: Record<string, AITool>;
+    cleanup: TurnToolCleanup[];
+}
+export declare function resolveTurnTools(options: {
+    providers: AgentTurnToolProvider[];
+    context: AgentTurnToolContext;
+    baseTools: Map<string, Tool.AnyInfo>;
+    baseMcpTools: Record<string, AITool>;
+}): Promise<ResolvedTurnTools>;
+export declare function mergeTurnTools(baseTools: Map<string, Tool.AnyInfo>, turnTools: Map<string, Tool.AnyInfo>): Map<string, Tool.AnyInfo>;
+export declare function cleanupTurnTools(cleanup: TurnToolCleanup[]): Promise<void>;
+export {};
+//# sourceMappingURL=turn-tools.d.ts.map

package/dist/agent/chat-loop/turn-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-tools.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/turn-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,IAAI,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,KAAK,eAAe,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAElD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,OAAO,EAAE,oBAAoB,CAAC;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwC7B;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EACpC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,GACnC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAa3B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,eAAe,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/agent/chat-loop/types.d.ts

@@ -0,0 +1,60 @@
+import type { ModelMessage, TelemetryOptions, Tool as AITool } from "ai";
+import type { Message } from "../../types/messages.js";
+import type { Tool } from "../../tool/tool.js";
+import type { ToolHost } from "../../tool/host/types.js";
+import type { HumanInputController } from "../../human/controller.js";
+import type { MiddlewareRunner } from "../../middleware/runner.js";
+import type { InterventionController } from "../../intervention/intervention.js";
+import type { ContextWindowManager } from "../../context/window/index.js";
+import type { TurnChangeTracker } from "../../tracking/turn-tracker/index.js";
+import type { PromptBuilder } from "../../prompt/index.js";
+import type { ReasoningLevel } from "../../models/reasoning/index.js";
+import type { SessionManager } from "../../storage/index.js";
+import type { ToolExecutionMode } from "../../inference/types.js";
+import type { Logger } from "../../logger/types.js";
+import type { EffectiveAgentConfig } from "../setup.js";
+import type { AgentTurnToolProvider } from "../../tool/turn-tools.js";
+import type { AgentMemoryProvider } from "../../memory/index.js";
+/** Everything the chat loop needs from the Agent instance. */
+export interface ChatLoopDeps {
+    sessionId: string;
+    turnId: string;
+    message: string;
+    abort: AbortSignal;
+    systemOverride?: string;
+    sessions: SessionManager;
+    /**
+     * Live reference to the agent's tools Map.
+     *
+     * The loop rebuilds a `Record<string, Tool.Info>` from this Map at
+     * the start of each model step so that mid-turn additions (e.g.
+     * tools loaded by `tool_search` via `agent.addTool()`) are visible
+     * to the next step without restarting the turn.
+     */
+    tools: Map<string, Tool.AnyInfo>;
+    config: EffectiveAgentConfig;
+    turnTracker: TurnChangeTracker;
+    interventionCtrl: InterventionController;
+    middlewareRunner: MiddlewareRunner;
+    contextManager: ContextWindowManager;
+    rememberedDoomLoopTools: Set<string>;
+    reasoningLevel: ReasoningLevel;
+    promptBuilder?: PromptBuilder;
+    host: ToolHost;
+    humanInputController?: HumanInputController;
+    memoryProvider?: AgentMemoryProvider;
+    mcpTools: Record<string, AITool>;
+    turnToolProviders: AgentTurnToolProvider[];
+    telemetrySettings?: TelemetryOptions;
+    toModelMessages: (messages: Message[]) => ModelMessage[];
+    setIsStreaming: (value: boolean) => void;
+    /**
+     * Tool execution mode for this chat loop.
+     * - `"auto"` — tools auto-execute via AI SDK (default)
+     * - `"plan"` — tools are planned, then dispatched via `runToolBatch()`
+     */
+    toolExecutionMode?: ToolExecutionMode;
+    /** Logger for diagnostic output. */
+    logger?: Logger;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent/chat-loop/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/agent/chat-loop/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,IAAI,IAAI,MAAM,EAAE,MAAM,IAAI,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB;;;;;;;OAOG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,EAAE,oBAAoB,CAAC;IACrC,uBAAuB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,IAAI,EAAE,QAAQ,CAAC;IACf,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iBAAiB,EAAE,qBAAqB,EAAE,CAAC;IAC3C,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,eAAe,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,CAAC;IACzD,cAAc,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACzC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/agent/defaults.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Agent defaults — canonical constants and composable default resolution.
+ *
+ * This module is the single source of truth for agent baseline values.
+ * Model-loop numeric defaults come from the inference layer so lower-level
+ * modules do not depend on the agent facade.
+ */
+import type { SandboxSession } from "../sandbox/types.js";
+import { DEFAULT_MAX_STEPS } from "../inference/defaults.js";
+export { DEFAULT_SYSTEM_PROMPT } from "../prompt/templates.js";
+/** Default agent name used when no explicit name is provided. */
+export declare const DEFAULT_AGENT_NAME = "agent";
+export { DEFAULT_MAX_STEPS };
+/** Default max output tokens */
+export declare const DEFAULT_MAX_TOKENS = 32000;
+/**
+ * Overridable agent default values.
+ *
+ * Each field is optional — only set the values you want to override.
+ * Unset fields fall back to the base constants above.
+ */
+export interface AgentDefaults {
+    systemPrompt?: string;
+    maxSteps?: number;
+    maxOutputTokens?: number;
+}
+/**
+ * A function that inspects the agent's construction context and returns
+ * default overrides. Return `undefined` or `{}` to keep the base defaults.
+ */
+export type AgentDefaultsProvider = (context: AgentDefaultsContext) => AgentDefaults | undefined;
+/**
+ * Context available to a defaults provider at agent construction time.
+ */
+export interface AgentDefaultsContext {
+    /** The sandbox session, if one was provided. */
+    sandbox?: SandboxSession;
+    /** The resolved working directory. */
+    cwd: string;
+    /** The model identifier string extracted from the LanguageModel. */
+    modelId?: string;
+}
+/**
+ * Resolve agent defaults by merging base constants with zero or more
+ * provider-supplied overrides. Later providers take precedence.
+ *
+ * Explicit values from the user's `AgentConfig` always win — this only
+ * determines what the `??` fallback values are in `createEffectiveAgentConfig`.
+ *
+ * @example
+ * ```ts
+ * const defaults = resolveAgentDefaults(context, [
+ *   sandboxDefaultsProvider,
+ *   modelDefaultsProvider,
+ * ]);
+ * // defaults.maxSteps → provider-overridden or 50
+ * ```
+ */
+export declare function resolveAgentDefaults(context: AgentDefaultsContext, providers?: AgentDefaultsProvider[]): Required<AgentDefaults>;
+/**
+ * Built-in defaults provider: adjusts defaults based on sandbox metadata.
+ *
+ * When a managed sandbox is present (e.g. Docker), container-based workloads
+ * typically run longer operations. This provider bumps `maxSteps` to 100
+ * for managed sandboxes to avoid premature termination of multi-step
+ * container tasks.
+ */
+export declare function sandboxDefaultsProvider(context: AgentDefaultsContext): AgentDefaults | undefined;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/agent/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/agent/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAEL,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAS/D,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,gCAAgC;AAChC,eAAO,MAAM,kBAAkB,QAA4B,CAAC;AAM5D;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,oBAAoB,KAC1B,aAAa,GAAG,SAAS,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,oBAAoB,EAC7B,SAAS,CAAC,EAAE,qBAAqB,EAAE,GAClC,QAAQ,CAAC,aAAa,CAAC,CAqBzB;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,oBAAoB,GAC5B,aAAa,GAAG,SAAS,CAa3B"}

package/dist/agent/event-printer.d.ts

@@ -0,0 +1,94 @@
+/**
+ * CLI-friendly event printer for `agent.chat()` streams.
+ *
+ * Provides a zero-config function that handles the full `AgentEvent`
+ * union, writing text deltas to stdout, tool calls with emoji prefixes,
+ * and lifecycle events to stderr.  Covers the same ground as the
+ * 80-line `handleEvent()` in example 03–streaming but as a reusable
+ * one-liner:
+ *
+ * ```ts
+ * const print = createEventPrinter();
+ * for await (const event of agent.chat("demo", "Hello")) {
+ *   print(event);
+ * }
+ * ```
+ *
+ * All options are optional — sensible defaults work out of the box.
+ */
+import type { AgentEvent } from "../types/events.js";
+/** Controls which event categories the printer renders. */
+export interface EventPrinterOptions {
+    /**
+     * Show tool start/result/error events.
+     * @default true
+     */
+    tools?: boolean;
+    /**
+     * Show reasoning tokens (thinking models like o3, o4-mini).
+     * @default true
+     */
+    reasoning?: boolean;
+    /**
+     * Show step/lifecycle banners.
+     * @default false
+     */
+    steps?: boolean;
+    /**
+     * Show approval, intervention, and safety events.
+     * @default true
+     */
+    safety?: boolean;
+    /**
+     * Show the completion summary line.
+     * @default true
+     */
+    completion?: boolean;
+    /**
+     * Show team coordination events (team-*).
+     * @default false
+     */
+    team?: boolean;
+    /**
+     * Writable stream for text output.
+     * @default process.stdout
+     */
+    stdout?: NodeJS.WritableStream;
+    /**
+     * Writable stream for diagnostic/lifecycle output.
+     * @default process.stderr
+     */
+    stderr?: NodeJS.WritableStream;
+}
+/**
+ * Create a stateless event handler for printing `AgentEvent`s to the
+ * terminal.
+ *
+ * @param options - Fine-tune which event categories are rendered.
+ * @returns A function that accepts one `AgentEvent` and writes to stdout/stderr.
+ *
+ * @example
+ * ```ts
+ * import { createAgent, createEventPrinter } from "@cuylabs/agent-core";
+ *
+ * const agent = createAgent({ model, systemPrompt: "Be concise." });
+ * const print = createEventPrinter();
+ *
+ * for await (const event of agent.chat("demo", "Hello")) {
+ *   print(event);
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Quiet mode — text only, no tool or lifecycle output
+ * const print = createEventPrinter({
+ *   tools: false,
+ *   reasoning: false,
+ *   steps: false,
+ *   completion: false,
+ * });
+ * ```
+ */
+export declare function createEventPrinter(options?: EventPrinterOptions): (event: AgentEvent) => void;
+//# sourceMappingURL=event-printer.d.ts.map

package/dist/agent/event-printer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-printer.d.ts","sourceRoot":"","sources":["../../src/agent/event-printer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOrD,2DAA2D;AAC3D,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAE/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CAChC;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,mBAAwB,GAChC,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAkJ7B"}

package/dist/agent/fork.d.ts

@@ -0,0 +1,59 @@
+import type { LanguageModel } from "ai";
+import type { ReasoningLevel } from "../models/reasoning/index.js";
+import type { Profile } from "../profiles/types.js";
+import type { PromptConfig } from "../prompt/types.js";
+import type { Tool } from "../tool/tool.js";
+import type { AgentConfig } from "./types/index.js";
+import type { EffectiveAgentConfig } from "./setup.js";
+import type { PromptBuilder } from "../prompt/index.js";
+import type { MiddlewareRunner } from "../middleware/runner.js";
+import { SessionManager } from "../storage/index.js";
+import type { ToolHost } from "../tool/host/types.js";
+import type { SandboxSession } from "../sandbox/types.js";
+import type { HumanInputController } from "../human/controller.js";
+import type { MCPManager } from "../mcp/types.js";
+import type { AgentMiddleware } from "../middleware/types.js";
+import type { AgentTurnToolProvider } from "../tool/turn-tools.js";
+export interface AgentForkOptions {
+    name?: string;
+    systemPrompt?: string;
+    prompt?: PromptConfig;
+    model?: LanguageModel;
+    temperature?: number;
+    tools?: Tool.AnyInfo[];
+    maxSteps?: number;
+    reasoningLevel?: ReasoningLevel;
+    profile?: Profile;
+    middleware?: AgentMiddleware[];
+    additionalMiddleware?: AgentMiddleware[];
+    turnToolProviders?: AgentTurnToolProvider[];
+}
+export declare function resolveForkOptions(options: AgentForkOptions, parentTools: Tool.AnyInfo[], systemPrompt: string): AgentForkOptions;
+export declare function resolveChildPromptConfig(options: {
+    forkOptions: AgentForkOptions;
+    promptBuilder?: PromptBuilder;
+    parentPromptConfig?: PromptConfig;
+    parentSystemPrompt: string;
+}): {
+    systemPrompt?: string;
+    prompt?: PromptConfig;
+};
+export declare function resolveForkMiddleware(options: AgentForkOptions, middlewareRunner: MiddlewareRunner): AgentMiddleware[];
+export declare function createForkedAgentConfig(options: {
+    forkOptions: AgentForkOptions;
+    parentConfig: EffectiveAgentConfig;
+    parentTools: Tool.AnyInfo[];
+    reasoningLevel: ReasoningLevel;
+    host: ToolHost;
+    sandbox?: SandboxSession;
+    humanInputController?: HumanInputController;
+    ownsHost: boolean;
+    sessions: SessionManager;
+    mcpManager?: MCPManager;
+    middlewareRunner: MiddlewareRunner;
+    promptBuilder?: PromptBuilder;
+}): AgentConfig & {
+    tools?: Tool.AnyInfo[];
+    sessionManager?: SessionManager;
+};
+//# sourceMappingURL=fork.d.ts.map

package/dist/agent/fork.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../../src/agent/fork.ts"],"names":[],"mappings":"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"}

package/dist/agent/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Agent Internal Module
+ *
+ * Core agent implementation and turn orchestration helpers.
+ */
+export { Agent, createAgent } from "./instance/index.js";
+export { runChatLoop, type ChatLoopDeps } from "./chat-loop/index.js";
+export { ensureSessionLoaded } from "./session.js";
+export type { EffectiveAgentConfig } from "./setup.js";
+export { createEventPrinter, type EventPrinterOptions, } from "./event-printer.js";
+export { compactAgentMessages } from "./turn-context/index.js";
+export type { AgentMessageCompactionResult } from "./turn-context/index.js";
+export { DEFAULT_AGENT_NAME, DEFAULT_SYSTEM_PROMPT, DEFAULT_MAX_STEPS, DEFAULT_MAX_TOKENS, resolveAgentDefaults, sandboxDefaultsProvider, } from "./defaults.js";
+export type { AgentDefaults, AgentDefaultsProvider, AgentDefaultsContext, } from "./defaults.js";
+export { autoDetectStreamProvider } from "./stream-provider.js";
+export * from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agent/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,cAAc,kBAAkB,CAAC"}

package/dist/agent/instance/context-management.d.ts

@@ -0,0 +1,29 @@
+import type { ContextWindowStats } from "../../context/window/manager.js";
+import type { ContextWindowManager } from "../../context/window/index.js";
+import type { Logger } from "../../logger/types.js";
+import type { AgentMemoryProvider } from "../../memory/index.js";
+import type { SessionManager } from "../../storage/index.js";
+import type { Message } from "../../types/messages.js";
+import { type AgentContextCompactionResult, type AgentMessageCompactionResult } from "../turn-context/index.js";
+export declare function getAgentContextStats(options: {
+    contextManager: ContextWindowManager;
+    sessions: SessionManager;
+}): ContextWindowStats;
+export declare function compactLoadedAgentContext(options: {
+    contextManager: ContextWindowManager;
+    sessions: SessionManager;
+    logger: Logger;
+    memoryProvider?: AgentMemoryProvider;
+    sessionId?: string;
+    cwd: string;
+}): Promise<AgentContextCompactionResult>;
+export declare function compactAgentMessageList(options: {
+    contextManager: ContextWindowManager;
+    messages: Message[];
+    logger: Logger;
+    force?: boolean;
+    memoryProvider?: AgentMemoryProvider;
+    sessionId?: string;
+    cwd: string;
+}): Promise<AgentMessageCompactionResult>;
+//# sourceMappingURL=context-management.d.ts.map

package/dist/agent/instance/context-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-management.d.ts","sourceRoot":"","sources":["../../../src/agent/instance/context-management.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAGL,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,EAClC,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,cAAc,EAAE,oBAAoB,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC;CAC1B,GAAG,kBAAkB,CAErB;AAED,wBAAsB,yBAAyB,CAAC,OAAO,EAAE;IACvD,cAAc,EAAE,oBAAoB,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAExC;AAED,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACrD,cAAc,EAAE,oBAAoB,CAAC;IACrC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAExC"}