@agntk/core 0.1.2 → 0.3.0

package/README.md

@@ -14,49 +14,39 @@ pnpm add @agntk/core
 import { createAgent } from '@agntk/core';
 
 const agent = createAgent({
-  role: 'coder',
-  toolPreset: 'standard',
+  name: 'my-agent',
+  instructions: 'You are a helpful coding assistant.',
   workspaceRoot: process.cwd(),
 });
 
-// Generate (waits for full response)
-const result = await agent.generate({
+const result = await agent.stream({
   prompt: 'Read package.json and summarize the dependencies',
 });
-console.log(result.text);
-console.log(result.steps);  // Array of tool calls and results
 
-// Stream (real-time chunks)
-const stream = await agent.stream({ prompt: 'Explain this codebase' });
-for await (const chunk of stream.fullStream) {
-  if (chunk.type === 'text-delta') process.stdout.write(chunk.textDelta);
+for await (const chunk of result.fullStream) {
+  if (chunk.type === 'text-delta') process.stdout.write(chunk.text ?? '');
 }
-// Or just get the text after the stream finishes:
-const text = await stream.text;
+
+const text = await result.text;
 ```
 
 ## Agent Interface
 
 ```typescript
 interface Agent {
-  agentId: string;
-  role: string;
+  readonly name: string;
 
-  generate(input: { prompt: string }): Promise<GenerateResult>;
-  stream(input: { prompt: string }): Promise<StreamResult>;
+  init(): Promise<void>;              // Called automatically by stream()
+  stream(input: { prompt: string }): Promise<AgentStreamResult>;
 
   getSystemPrompt(): string;
-  getToolLoopAgent(): ToolLoopAgent;
-}
-
-interface GenerateResult {
-  text: string;
-  steps: StepResult[];  // Each step contains toolCalls and toolResults
+  getToolNames(): string[];
 }
 
-interface StreamResult {
-  fullStream: AsyncIterable<StreamChunk>;  // All event types
-  text: Promise<string>;                   // Final accumulated text
+interface AgentStreamResult {
+  fullStream: AsyncIterable<StreamChunk>;   // All event types
+  text: PromiseLike<string>;                // Final accumulated text
+  usage: PromiseLike<LanguageModelUsage>;   // Token usage
 }
 ```
 
@@ -64,50 +54,42 @@ interface StreamResult {
 
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `role` | `'generic' \| 'coder' \| 'researcher' \| 'analyst'` | `'generic'` | Predefined role with system prompt |
-| `systemPrompt` | `string` | Role default | Override system prompt |
-| `systemPromptPrefix` | `string` | None | Prepend context without replacing role prompt |
-| `agentId` | `string` | Auto-generated | Unique identifier |
-| `maxSteps` | `number` | `10` | Max tool-loop iterations |
-| `model` | `LanguageModel` | Auto-resolved | AI SDK model instance |
-| `modelProvider` | `string` | Config default | `'openrouter' \| 'openai' \| 'ollama'` (extensible) |
-| `modelName` | `string` | Tier default | Specific model name |
-| `toolPreset` | `string` | `'standard'` | `'none' \| 'minimal' \| 'standard' \| 'full'` |
-| `tools` | `Record<string, Tool>` | `{}` | Custom tools (merged with preset) |
-| `enableTools` | `string[]` | All | Whitelist — only these tools active |
-| `disableTools` | `string[]` | None | Blacklist — remove from preset |
-| `enableSubAgents` | `boolean` | `false` | Adds `spawn_agent` tool |
-| `maxSpawnDepth` | `number` | `2` | Max sub-agent nesting |
-| `durable` | `boolean` | `false` | Wrap as DurableAgent |
-| `enableMemory` | `boolean` | `false` | Markdown-based persistent memory |
-| `brain` | `BrainInstance` | None | Knowledge graph (auto-injects tools) |
-| `skills` | `SkillsConfig` | None | Auto-discover SKILL.md files |
+| `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 |
-| `enableTransientStreaming` | `boolean` | `true` | Stream tool data without context |
-| `onStepFinish` | `(step, index) => void` | None | After each step |
-| `askUserHandler` | `(question) => Promise<string>` | None | Human-in-the-loop input |
-
-## Tool Presets
-
-| Preset | Tools |
-|--------|-------|
-| `none` | No tools |
-| `minimal` | `glob` |
-| `standard` | `glob`, `grep`, `file_read`, `file_create`, `file_edit`, `shell`, `background`, `plan`, `deep_reasoning`, `search_skills` |
-| `full` | All standard tools + `ast_grep_search`, `ast_grep_replace`, `progress`, `browser` |
+| `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) |
+
+## 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` |
 
 ```typescript
-import { createToolPreset } from '@agntk/core';
-
-// Get tools without creating an agent
-const tools = createToolPreset('standard', { workspaceRoot: '/my/project' });
+const agent = createAgent({
+  name: 'my-agent',
+  tools: { myCustomTool },  // Custom tools merge with built-in tools
+});
 ```
 
 ## Configuration
 
 ### Config File
 
-Place `agntk.config.json` in your project root:
+Place `agent-sdk.config.yaml` (or `.json`) in your project root:
 
 ```json
 {
@@ -120,13 +102,6 @@ Place `agntk.config.json` in your project root:
       "powerful": "anthropic/claude-sonnet-4"
     }
   },
-  "roles": {
-    "debugger": {
-      "systemPrompt": "You are a debugging specialist.",
-      "recommendedModel": "reasoning",
-      "defaultTools": ["shell", "grep", "glob"]
-    }
-  },
   "tools": {
     "shell": { "timeout": 30000 },
     "glob": { "maxFiles": 100 }
@@ -139,7 +114,7 @@ Place `agntk.config.json` in your project root:
 ```typescript
 import { loadConfig, configure, getConfig, defineConfig, resolveModel } from '@agntk/core';
 
-loadConfig('./agntk.config.json');
+loadConfig('./agent-sdk.config.yaml');
 configure({ models: { defaultProvider: 'openrouter' } });
 
 const model = resolveModel({ tier: 'powerful' });
@@ -166,22 +141,20 @@ All providers use `@ai-sdk/openai-compatible` for unified access:
 | `reasoning` | Complex logic, chain-of-thought |
 | `powerful` | Best quality, highest cost |
 
-## Durable Agents
-
-```typescript
-const agent = createAgent({ durable: true, toolPreset: 'standard' });
+## Memory
 
-// Standard methods still work
-const result = await agent.generate({ prompt: 'Refactor utils.ts' });
+Memory is always enabled. State is stored at `~/.agntk/agents/{name}/`:
 
-// Durable methods (crash recovery, checkpointing)
-const durableResult = await (agent as DurableAgent).durableGenerate('Complex task');
+```typescript
+const agent = createAgent({ name: 'my-agent' });
+// Memory tools are always available: remember, recall, update_context, forget
+// Memory context is auto-loaded into the system prompt on first stream()
 ```
 
 ## Workflow Hooks
 
 ```typescript
-import { defineHook, getHookRegistry } from '@agntk/core';
+import { defineHook, getHookRegistry } from '@agntk/core/advanced';
 
 const hook = defineHook<{ amount: number }, boolean>({
   name: 'purchase-approval',
@@ -192,18 +165,10 @@ const hook = defineHook<{ amount: number }, boolean>({
 const approved = await hook.wait({ amount: 5000 });
 ```
 
-## Scheduled Workflows
+## Duration Utilities
 
 ```typescript
-import { createScheduledWorkflow, parseDuration, formatDuration } from '@agntk/core';
-
-const schedule = createScheduledWorkflow({
-  name: 'hourly-check',
-  interval: '1h',
-  task: async (i) => `Check #${i}`,
-  maxIterations: 24,
-});
-await schedule.start();
+import { parseDuration, formatDuration } from '@agntk/core/advanced';
 
 parseDuration('2h');      // 7200000
 formatDuration(7200000);  // "2h"
@@ -212,10 +177,11 @@ formatDuration(7200000);  // "2h"
 ## Skills
 
 ```typescript
-import { createAgent, discoverSkills, buildSkillsSystemPrompt } from '@agntk/core';
+import { createAgent, discoverSkills } from '@agntk/core';
+import { buildSkillsSystemPrompt } from '@agntk/core/advanced';
 
-// Auto-discover:
-const agent = createAgent({ skills: { directories: ['.agents/skills'] } });
+// Auto-discover from default directories:
+const agent = createAgent({ name: 'my-agent' });
 
 // Manual:
 const skills = await discoverSkills('./.agents/skills');

package/dist/advanced/index.d.ts

@@ -25,11 +25,18 @@ export type { StreamEventType, StreamEventDataMap, SessionStartData, StepStartDa
 export type { ToolLifecycle, ToolContext, ToolError, ToolErrorType } from '../types/lifecycle.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 type { SkillSearchResult } from '../skills/index.js';
 export type { UsageSnapshot } from '../usage-limits.js';
-export { SpecialistPool, createPoolTools, createSpawnSpecialistTool, createListSpecialistsTool } from '../pool/index.js';
-export type { SpecialistPoolConfig, SpecialistConfig, CachedSpecialist, ConversationMessage, SpecialistAgent, HistoryStrategy, } from '../pool/index.js';
+export { createMemoryTools } from '../memory/tools.js';
+export type { MemoryToolsOptions } from '../memory/tools.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":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC7G,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAM1E,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;AAC5D,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzH,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC3G,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAM1F,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAM5F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpF,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM9G,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC7H,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM/F,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,cAAc,EACd,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACZ,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAM5B,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAM/F,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAC5G,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AACjG,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAMjE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC9H,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAYnD,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAChH,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/advanced/index.ts"],"names":[],"mappings":"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"}

package/dist/advanced/index.js

@@ -38,6 +38,12 @@ export { initObservability, createTelemetrySettings, isObservabilityEnabled, shu
 // ═══════════════════════════════════════════════════════════════════════════════
 export { buildSystemContext, formatSystemContextBlock, buildDynamicSystemPrompt } from '../prompts/context.js';
 // ═══════════════════════════════════════════════════════════════════════════════
+// Workflow Hooks & Durability
+// ═══════════════════════════════════════════════════════════════════════════════
+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';
@@ -46,7 +52,12 @@ export { subAgentConfigs, getSubAgentConfig, subAgentRoles } from '../presets/su
 // ═══════════════════════════════════════════════════════════════════════════════
 export { loadSkillsFromPaths, buildSkillsSystemPrompt, searchSkills, filterEligibleSkills, isSkillEligible } from '../skills/index.js';
 // ═══════════════════════════════════════════════════════════════════════════════
-// Pool (SpecialistPool)
+// Memory Tools
+// ═══════════════════════════════════════════════════════════════════════════════
+export { createMemoryTools } from '../memory/tools.js';
+// ═══════════════════════════════════════════════════════════════════════════════
+// Search Skills Tool
 // ═══════════════════════════════════════════════════════════════════════════════
-export { SpecialistPool, createPoolTools, createSpawnSpecialistTool, createListSpecialistsTool } from '../pool/index.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,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,wBAAwB;AACxB,kFAAkF;AAElF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC"}
+{"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"}

package/dist/agent.d.ts

@@ -1,46 +1,42 @@
 /**
- * @agntk/core - Core Agent Factory
+ * @agntk/core - Agent Factory
  *
- * Creates agents using AI SDK's ToolLoopAgent pattern.
- * Provides opinionated defaults for tools, roles, and streaming.
+ * 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 (plus any custom tools you pass)
+ * - 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)
+ * - Guardrails: always on (output: PII content filter)
+ * - Model: auto-selected from available API keys
  */
-import { ToolLoopAgent } from 'ai';
-import type { AgentOptions, AgentRole } from './types/agent.js';
-export interface Agent {
-    /** Unique identifier for this agent instance */
-    agentId: string;
-    /** Role of this agent */
-    role: AgentRole;
-    /** Initialize async resources (memory context loading). Called automatically by generate(). */
-    init: () => Promise<void>;
-    /** Stream a response (returns the ToolLoopAgent's stream result) */
-    stream: (input: {
-        prompt: string;
-    }) => ReturnType<ToolLoopAgent['stream']>;
-    /** Generate a non-streaming response */
-    generate: (input: {
-        prompt: string;
-    }) => ReturnType<ToolLoopAgent['generate']>;
-    /** Get the underlying ToolLoopAgent instance */
-    getToolLoopAgent: () => ToolLoopAgent;
-    /** Get the system prompt */
-    getSystemPrompt: () => string;
+import type { AgentOptions, Agent } from './types/agent.js';
+/** @internal */
+export interface InternalOptions {
+    _spawnDepth?: number;
 }
 /**
- * Creates an agent with the given options.
+ * Create an agent — fully equipped, zero config.
  *
  * @example
  * ```typescript
  * const agent = createAgent({
- *   role: 'coder',
- *   workspaceRoot: '/my/project',
- *   toolPreset: 'standard',
+ *   name: 'deploy-bot',
+ *   instructions: 'You manage deployments for our k8s cluster.',
  * });
  *
- * const result = await agent.generate({ prompt: 'Create a hello world function' });
- * console.log(result.text);
+ * 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 ?? '');
+ * }
  * ```
  */
-export declare function createAgent(options?: AgentOptions): Agent;
+export declare function createAgent(options: AgentOptions, _internal?: InternalOptions): Agent;
 export default createAgent;
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,aAAa,EAAe,MAAM,IAAI,CAAC;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AA4BzE,MAAM,WAAW,KAAK;IACpB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAEhB,yBAAyB;IACzB,IAAI,EAAE,SAAS,CAAC;IAEhB,+FAA+F;IAC/F,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,oEAAoE;IACpE,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE3E,wCAAwC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IAE/E,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,aAAa,CAAC;IAEtC,4BAA4B;IAC5B,eAAe,EAAE,MAAM,MAAM,CAAC;CAC/B;AA2CD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,YAAiB,GAAG,KAAK,CAqW7D;AAED,eAAe,WAAW,CAAC"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAC;AAmG5E,gBAAgB;AAChB,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,GAAE,eAAoB,GAAG,KAAK,CAuRzF;AAED,eAAe,WAAW,CAAC"}