@agntk/core 0.3.5 → 1.1.0

package/README.md

@@ -36,7 +36,7 @@ const text = await result.text;
 interface Agent {
   readonly name: string;
 
-  init(): Promise<void>;              // Called automatically by stream()
+  init(): Promise<void>; // Called automatically by stream()
   stream(input: { prompt: string }): Promise<AgentStreamResult>;
 
   getSystemPrompt(): string;
@@ -44,44 +44,45 @@ interface Agent {
 }
 
 interface AgentStreamResult {
-  fullStream: AsyncIterable<StreamChunk>;   // All event types
-  text: PromiseLike<string>;                // Final accumulated text
-  usage: PromiseLike<LanguageModelUsage>;   // Token usage
+  fullStream: AsyncIterable<StreamChunk>; // All event types
+  text: PromiseLike<string>; // Final accumulated text
+  usage: PromiseLike<LanguageModelUsage>; // Token usage
 }
 ```
 
 ## `createAgent(options)`
 
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `name` | `string` | **required** | Display name — used in logs, traces, and persistent memory |
-| `instructions` | `string` | None | Natural language context injected as the system prompt |
-| `workspaceRoot` | `string` | `process.cwd()` | Root for file operations |
-| `maxSteps` | `number` | `25` | Max tool-loop iterations |
-| `model` | `LanguageModel` | Auto-resolved | AI SDK model instance (optional override) |
-| `usageLimits` | `UsageLimits` | None | Token and request caps |
-| `tools` | `Record<string, Tool>` | `{}` | Custom tools (merged with built-in tools) |
+| Option               | Type                      | Default         | Description                                                |
+| -------------------- | ------------------------- | --------------- | ---------------------------------------------------------- |
+| `name`               | `string`                  | **required**    | Display name — used in logs, traces, and persistent memory |
+| `instructions`       | `string`                  | None            | Natural language context injected as the system prompt     |
+| `workspaceRoot`      | `string`                  | `process.cwd()` | Root for file operations                                   |
+| `maxSteps`           | `number`                  | `25`            | Max tool-loop iterations                                   |
+| `model`              | `LanguageModel`           | Auto-resolved   | AI SDK model instance (optional override)                  |
+| `usageLimits`        | `UsageLimits`             | None            | Token and request caps                                     |
+| `tools`              | `Record<string, Tool>`    | `{}`            | Custom tools (merged with built-in tools)                  |
+| `onSubAgentActivity` | `SubAgentActivityHandler` | None            | Callback for live sub-agent stream chunks                  |
 
 ## Built-in Tools
 
 Every agent comes with 20 built-in tools:
 
-| Category | Tools |
-|----------|-------|
-| **Files** | `file_read`, `file_write`, `file_edit`, `file_create`, `glob`, `grep` |
-| **Code** | `ast_grep_search`, `ast_grep_replace` |
-| **Shell** | `shell`, `background` |
-| **Planning** | `plan`, `deep_reasoning` |
-| **Memory** | `remember`, `recall`, `update_context`, `forget` |
-| **Sub-Agents** | `spawn_agent` |
-| **Skills** | `search_skills` |
-| **Progress** | `progress_read`, `progress_update` |
-| **Browser** | `browser` |
+| Category       | Tools                                                                 |
+| -------------- | --------------------------------------------------------------------- |
+| **Files**      | `file_read`, `file_write`, `file_edit`, `file_create`, `glob`, `grep` |
+| **Code**       | `ast_grep_search`, `ast_grep_replace`                                 |
+| **Shell**      | `shell`, `background`                                                 |
+| **Planning**   | `plan`, `deep_reasoning`                                              |
+| **Memory**     | `remember`, `recall`, `update_context`, `forget`                      |
+| **Sub-Agents** | `spawn_agent`                                                         |
+| **Skills**     | `search_skills`                                                       |
+| **Progress**   | `progress_read`, `progress_update`                                    |
+| **Browser**    | `browser`                                                             |
 
 ```typescript
 const agent = createAgent({
   name: 'my-agent',
-  tools: { myCustomTool },  // Custom tools merge with built-in tools
+  tools: { myCustomTool }, // Custom tools merge with built-in tools
 });
 ```
 
@@ -125,21 +126,21 @@ const config = getConfig();
 
 All providers use `@ai-sdk/openai-compatible` for unified access:
 
-| Provider | Default | Description |
-|----------|---------|-------------|
-| `openrouter` | ✅ | Routes to any model (Anthropic, Google, Meta, etc.) |
-| `openai` | | Direct OpenAI API |
-| `ollama` | | Local models via Ollama |
-| Custom | | Any OpenAI-compatible API via `customProviders` config |
+| Provider     | Default | Description                                            |
+| ------------ | ------- | ------------------------------------------------------ |
+| `openrouter` | ✅      | Routes to any model (Anthropic, Google, Meta, etc.)    |
+| `openai`     |         | Direct OpenAI API                                      |
+| `ollama`     |         | Local models via Ollama                                |
+| Custom       |         | Any OpenAI-compatible API via `customProviders` config |
 
 ## Model Tiers
 
-| Tier | Purpose |
-|------|---------|
-| `fast` | Quick responses, low cost |
-| `standard` | Balanced quality/cost |
+| Tier        | Purpose                         |
+| ----------- | ------------------------------- |
+| `fast`      | Quick responses, low cost       |
+| `standard`  | Balanced quality/cost           |
 | `reasoning` | Complex logic, chain-of-thought |
-| `powerful` | Best quality, highest cost |
+| `powerful`  | Best quality, highest cost      |
 
 ## Memory
 
@@ -170,8 +171,8 @@ const approved = await hook.wait({ amount: 5000 });
 ```typescript
 import { parseDuration, formatDuration } from '@agntk/core/advanced';
 
-parseDuration('2h');      // 7200000
-formatDuration(7200000);  // "2h"
+parseDuration('2h'); // 7200000
+formatDuration(7200000); // "2h"
 ```
 
 ## Skills

package/dist/advanced/index.d.ts

@@ -1,42 +1,33 @@
-/**
- * @agntk/core/advanced — Advanced features.
- *
- * Guardrail runners, approval internals, reflection internals,
- * best-of-n, browser streaming, observability, streaming types,
- * and other power-user features.
- *
- * Import from '@agntk/core/advanced' instead of '@agntk/core'.
- */
-export { buildReflectionPrompt, createReflectionPrepareStep, estimateReflectionTokens } from '../reflection.js';
+export { buildReflectionPrompt, createReflectionPrepareStep, estimateReflectionTokens, } from '../reflection.js';
 export type { ReflectionStrategy, ReflectionConfig } from '../reflection.js';
 export { contentFilter, topicFilter, lengthLimit, custom } from '../guardrails/built-ins.js';
-export { runGuardrails, wrapWithGuardrails, handleGuardrailResults, buildRetryFeedback } from '../guardrails/runner.js';
+export { runGuardrails, wrapWithGuardrails, handleGuardrailResults, buildRetryFeedback, } from '../guardrails/runner.js';
 export { GuardrailBlockedError } from '../guardrails/types.js';
-export type { Guardrail, GuardrailResult, GuardrailContext, GuardrailsConfig, OnBlockAction } from '../guardrails/types.js';
-export { applyApproval, resolveApprovalConfig, isDangerousTool, DANGEROUS_TOOLS } from '../tools/approval.js';
+export type { Guardrail, GuardrailResult, GuardrailContext, GuardrailsConfig, OnBlockAction, } from '../guardrails/types.js';
+export { applyApproval, resolveApprovalConfig, isDangerousTool, DANGEROUS_TOOLS, } from '../tools/approval.js';
 export type { ApprovalConfig, ApprovalHandler, ApprovalRequest } from '../tools/approval.js';
 export { withBestOfN } from '../wrappers/best-of-n.js';
 export type { BestOfNConfig, BestOfNCandidate, BestOfNResult } from '../wrappers/best-of-n.js';
 export { createBrowserStream, BrowserStreamEmitter } from '../tools/browser/stream.js';
-export type { BrowserStreamConfig, FrameData, InputEvent, BrowserStreamEvent } from '../tools/browser/stream.js';
-export { initObservability, createTelemetrySettings, isObservabilityEnabled, shutdownObservability } from '../observability/index.js';
+export type { BrowserStreamConfig, FrameData, InputEvent, BrowserStreamEvent, } from '../tools/browser/stream.js';
+export { initObservability, createTelemetrySettings, isObservabilityEnabled, shutdownObservability, } from '../observability/index.js';
 export type { ObservabilityConfig, LangfuseConfig, TelemetrySettings } from '../observability/index.js';
 export type { StreamEventType, StreamEventDataMap, SessionStartData, StepStartData, StepFinishData, TextDeltaData, TextFinishData, ReasoningDeltaData, ReasoningFinishData, ToolCallData, ToolResultData, SourceData, ErrorData, CompleteData, MessagePartType, MessagePart, ToolCallInfo, SourceInfo, StreamingMessage, } from '../types/streaming.js';
 export type { ToolLifecycle, ToolContext, ToolError, ToolErrorType } from '../types/lifecycle.js';
-export { buildSystemContext, formatSystemContextBlock, buildDynamicSystemPrompt } from '../prompts/context.js';
+export { buildSystemContext, formatSystemContextBlock, buildDynamicSystemPrompt, } from '../prompts/context.js';
 export type { SystemContext } from '../prompts/context.js';
 export { defineHook, createWebhook, resumeHook, sleep, getHookRegistry, HookRegistry, HookNotFoundError, HookNotPendingError, HookRejectedError, FatalError, RetryableError, } from '../workflow/hooks.js';
 export type { Hook, HookDefinition, HookInstance, HookStatus, WebhookOptions, WebhookResult, SleepOptions, } from '../workflow/hooks.js';
 export { wrapToolAsDurableStep, wrapToolsAsDurable, wrapSelectedToolsAsDurable, } from '../workflow/durable-tool.js';
 export type { DurabilityConfig } from '../workflow/durable-tool.js';
-export { checkWorkflowAvailability, parseDuration, formatDuration, } from '../workflow/utils.js';
-export { subAgentConfigs, getSubAgentConfig, subAgentRoles } from '../presets/sub-agent-configs.js';
-export type { SubAgentRole } from '../presets/sub-agent-configs.js';
-export { loadSkillsFromPaths, buildSkillsSystemPrompt, searchSkills, filterEligibleSkills, isSkillEligible } from '../skills/index.js';
+export { checkWorkflowAvailability, parseDuration, formatDuration } from '../workflow/utils.js';
+export { withRefineLoop } from '../wrappers/refine-loop.js';
+export type { RefineLoopConfig, RefineLoopResult, RefineLoopAttempt, EvaluationResult, } from '../wrappers/refine-loop.js';
+export { loadSkillsFromPaths, buildSkillsSystemPrompt, searchSkills, filterEligibleSkills, isSkillEligible, } from '../skills/index.js';
 export type { SkillSearchResult } from '../skills/index.js';
 export type { UsageSnapshot } from '../usage-limits.js';
-export { createMemoryTools } from '../memory/tools.js';
-export type { MemoryToolsOptions } from '../memory/tools.js';
+export { AgentRegistry, type AgentRegistryEntry, type AgentStatus, type SpawnErrorType, } from '../tools/spawn-agent/registry.js';
+export { createCheckAgentTool, type CheckAgentResult, type CheckAgentEntry, } from '../tools/spawn-agent/check-agent.js';
 export { createSearchSkillsTool, clearSkillsCache } from '../tools/search-skills.js';
 export type { SearchSkillsToolConfig } from '../tools/search-skills.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/advanced/index.js

@@ -1,63 +1,18 @@
-/**
- * @agntk/core/advanced — Advanced features.
- *
- * Guardrail runners, approval internals, reflection internals,
- * best-of-n, browser streaming, observability, streaming types,
- * and other power-user features.
- *
- * Import from '@agntk/core/advanced' instead of '@agntk/core'.
- */
-// ═══════════════════════════════════════════════════════════════════════════════
-// Reflection (internals)
-// ═══════════════════════════════════════════════════════════════════════════════
-export { buildReflectionPrompt, createReflectionPrepareStep, estimateReflectionTokens } from '../reflection.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Guardrails (runners + built-ins)
-// ═══════════════════════════════════════════════════════════════════════════════
+export { buildReflectionPrompt, createReflectionPrepareStep, estimateReflectionTokens, } from '../reflection.js';
 export { contentFilter, topicFilter, lengthLimit, custom } from '../guardrails/built-ins.js';
-export { runGuardrails, wrapWithGuardrails, handleGuardrailResults, buildRetryFeedback } from '../guardrails/runner.js';
+export { runGuardrails, wrapWithGuardrails, handleGuardrailResults, buildRetryFeedback, } from '../guardrails/runner.js';
 export { GuardrailBlockedError } from '../guardrails/types.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Approval (internals)
-// ═══════════════════════════════════════════════════════════════════════════════
-export { applyApproval, resolveApprovalConfig, isDangerousTool, DANGEROUS_TOOLS } from '../tools/approval.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Best-of-N
-// ═══════════════════════════════════════════════════════════════════════════════
+export { applyApproval, resolveApprovalConfig, isDangerousTool, DANGEROUS_TOOLS, } from '../tools/approval.js';
 export { withBestOfN } from '../wrappers/best-of-n.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Browser Streaming
-// ═══════════════════════════════════════════════════════════════════════════════
 export { createBrowserStream, BrowserStreamEmitter } from '../tools/browser/stream.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Observability
-// ═══════════════════════════════════════════════════════════════════════════════
-export { initObservability, createTelemetrySettings, isObservabilityEnabled, shutdownObservability } from '../observability/index.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Prompts (internals)
-// ═══════════════════════════════════════════════════════════════════════════════
-export { buildSystemContext, formatSystemContextBlock, buildDynamicSystemPrompt } from '../prompts/context.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Workflow Hooks & Durability
-// ═══════════════════════════════════════════════════════════════════════════════
+export { initObservability, createTelemetrySettings, isObservabilityEnabled, shutdownObservability, } from '../observability/index.js';
+export { buildSystemContext, formatSystemContextBlock, buildDynamicSystemPrompt, } from '../prompts/context.js';
 export { defineHook, createWebhook, resumeHook, sleep, getHookRegistry, HookRegistry, HookNotFoundError, HookNotPendingError, HookRejectedError, FatalError, RetryableError, } from '../workflow/hooks.js';
 export { wrapToolAsDurableStep, wrapToolsAsDurable, wrapSelectedToolsAsDurable, } from '../workflow/durable-tool.js';
-export { checkWorkflowAvailability, parseDuration, formatDuration, } from '../workflow/utils.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Sub-Agent Configs
-// ═══════════════════════════════════════════════════════════════════════════════
-export { subAgentConfigs, getSubAgentConfig, subAgentRoles } from '../presets/sub-agent-configs.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Skills Search (advanced)
-// ═══════════════════════════════════════════════════════════════════════════════
-export { loadSkillsFromPaths, buildSkillsSystemPrompt, searchSkills, filterEligibleSkills, isSkillEligible } from '../skills/index.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Memory Tools
-// ═══════════════════════════════════════════════════════════════════════════════
-export { createMemoryTools } from '../memory/tools.js';
-// ═══════════════════════════════════════════════════════════════════════════════
-// Search Skills Tool
-// ═══════════════════════════════════════════════════════════════════════════════
+export { checkWorkflowAvailability, parseDuration, formatDuration } from '../workflow/utils.js';
+export { withRefineLoop } from '../wrappers/refine-loop.js';
+export { loadSkillsFromPaths, buildSkillsSystemPrompt, searchSkills, filterEligibleSkills, isSkillEligible, } from '../skills/index.js';
+export { AgentRegistry, } from '../tools/spawn-agent/registry.js';
+export { createCheckAgentTool, } from '../tools/spawn-agent/check-agent.js';
 export { createSearchSkillsTool, clearSkillsCache } from '../tools/search-skills.js';
-// Pool (SpecialistPool) — removed: replaced by spawn-agent tool
 //# sourceMappingURL=index.js.map

package/dist/advanced/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/advanced/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,yBAAyB;AACzB,kFAAkF;AAElF,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAG7G,kFAAkF;AAClF,mCAAmC;AACnC,kFAAkF;AAElF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,kFAAkF;AAClF,uBAAuB;AACvB,kFAAkF;AAElF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAG3G,kFAAkF;AAClF,YAAY;AACZ,kFAAkF;AAElF,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,kFAAkF;AAClF,oBAAoB;AACpB,kFAAkF;AAElF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAGpF,kFAAkF;AAClF,gBAAgB;AAChB,kFAAkF;AAElF,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAmC7H,kFAAkF;AAClF,sBAAsB;AACtB,kFAAkF;AAElF,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAG5G,kFAAkF;AAClF,8BAA8B;AAC9B,kFAAkF;AAElF,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,KAAK,EACL,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,cAAc,GACf,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,yBAAyB,EACzB,aAAa,EACb,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,kFAAkF;AAClF,oBAAoB;AACpB,kFAAkF;AAElF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAGjG,kFAAkF;AAClF,2BAA2B;AAC3B,kFAAkF;AAElF,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAe9H,kFAAkF;AAClF,eAAe;AACf,kFAAkF;AAElF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,kFAAkF;AAClF,qBAAqB;AACrB,kFAAkF;AAElF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAGlF,gEAAgE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/advanced/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAS5D,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAQpF,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AA2B1B,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,KAAK,EACL,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,cAAc,GACf,MAAM,mBAAmB,CAAC;AAW3B,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,yBAAyB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE7F,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQzD,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,eAAe,GAChB,MAAM,WAAW,CAAC;AAKnB,OAAO,EACL,aAAa,GAId,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,oBAAoB,GAGrB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/agent-v2.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @agntk/core - V2 Agent Factory
+ *
+ * A fully-equipped agent that shows up ready. No roles, no tool presets,
+ * no feature flags. You give it a name, tell it what it's doing, and
+ * point it at a task. It figures out the rest.
+ *
+ * Every capability is auto-detected from the environment:
+ * - Tools: ALL tools, always
+ * - Memory: always on, stored at ~/.agntk/agents/{name}/
+ * - Durability: auto-detected (workflow package installed → on)
+ * - Telemetry: auto-detected (LANGFUSE_PUBLIC_KEY set → on)
+ * - Skills: auto-discovered from standard directories
+ * - Sub-agents: always enabled with team coordination
+ * - Reflection: always on (reflact strategy)
+ * - Approval: always on for dangerous tools
+ * - Model: auto-selected from available API keys
+ */
+import type { AgentOptionsV2, AgentV2 } from './types/agent-v2.js';
+/**
+ * Create a v2 agent — fully equipped, zero config.
+ *
+ * @example
+ * ```typescript
+ * const agent = createAgentV2({
+ *   name: 'deploy-bot',
+ *   instructions: 'You manage deployments for our k8s cluster.',
+ * });
+ *
+ * const result = await agent.stream({ prompt: 'Roll back staging to yesterday' });
+ * for await (const chunk of result.fullStream) {
+ *   if (chunk.type === 'text-delta') process.stdout.write(chunk.text ?? '');
+ * }
+ * ```
+ */
+/**
+ * Internal options not exposed in the public API.
+ * Used by the factory when recursively creating sub-agents.
+ */
+interface InternalV2Options {
+    /** Current spawn depth. 0 = top-level agent. */
+    _spawnDepth?: number;
+    /** Parent agent name, for naming sub-agents. */
+    _parentName?: string;
+}
+export declare function createAgentV2(options: AgentOptionsV2, _internal?: InternalV2Options): AgentV2;
+export default createAgentV2;
+//# sourceMappingURL=agent-v2.d.ts.map

package/dist/agent-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-v2.d.ts","sourceRoot":"","sources":["../src/agent-v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAuB,MAAM,kBAAkB,CAAC;AAuGrF;;;;;;;;;;;;;;;GAeG;AACH;;;GAGG;AACH,UAAU,iBAAiB;IACzB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,GAAE,iBAAsB,GAAG,OAAO,CAkTjG;AAED,eAAe,aAAa,CAAC"}