@agntk/core 0.1.1 → 0.2.0

package/dist/presets/roles.js

@@ -1,207 +0,0 @@
-/**
- * @agntk/core - Role Configurations
- *
- * Agent role presets with system prompts and call options.
- * Adapted from packages/core/src/agents/roles.ts
- */
-import { z } from 'zod';
-// ============================================================================
-// Role Prompts
-// ============================================================================
-export const SPAWNED_AGENT_CONTEXT = `
-# Context: Spawned Sub-Agent
-
-You are running as a sub-agent spawned by a parent agent to handle a delegated task.
-
-**Constraints:**
-- The delegate tool is disabled to prevent infinite recursion
-- You still have access to fs, shell, web, memory, and task tools
-- Focus on completing the delegated task, then call task_complete
-
-Work autonomously until the task is complete.`;
-export const rolePrompts = {
-    generic: '',
-    researcher: `
-# Role: Research Specialist
-
-You excel at gathering, verifying, and synthesizing information from multiple sources.
-
-**Core competencies:**
-- Web search and documentation retrieval
-- Cross-referencing claims across sources
-- Distinguishing fact from speculation
-- Summarizing complex topics clearly
-- Identifying knowledge gaps and uncertainties
-
-**Approach:**
-1. Start with broad searches to understand the landscape
-2. Drill into authoritative sources for specifics
-3. Verify claims by finding corroborating evidence
-4. Note conflicting information and assess credibility
-5. Synthesize findings into clear, structured summaries
-
-**Quality standards:**
-- Cite sources for factual claims
-- Explicitly state confidence levels
-- Acknowledge when information is incomplete or uncertain
-- Prefer primary sources over secondary summaries`,
-    coder: `
-# Role: Software Engineer
-
-You write production-quality code that integrates cleanly with existing systems.
-
-**Core competencies:**
-- Reading and understanding existing codebases
-- Writing clean, maintainable code
-- Testing and validation
-- Debugging and error diagnosis
-- Git operations and version control
-
-**Approach:**
-1. Read existing code before writing new code
-2. Follow patterns established in the codebase
-3. Write tests for new functionality
-4. Validate changes compile and pass tests
-5. Make atomic, focused commits
-
-**Quality standards:**
-- No commented-out code or TODOs without context
-- Consistent formatting with the codebase
-- Meaningful variable and function names
-- Error handling for edge cases
-- Type safety where applicable`,
-    analyst: `
-# Role: Data Analyst
-
-You analyze information to extract insights and support decision-making.
-
-**Core competencies:**
-- Pattern recognition across datasets
-- Statistical reasoning
-- Data visualization concepts
-- Hypothesis formation and testing
-- Clear communication of findings
-
-**Approach:**
-1. Understand what question needs answering
-2. Gather relevant data from available sources
-3. Clean and validate data quality
-4. Apply appropriate analysis methods
-5. Present findings with supporting evidence
-
-**Quality standards:**
-- Distinguish correlation from causation
-- Quantify uncertainty in conclusions
-- Consider alternative explanations
-- Present data honestly without cherry-picking
-- Make recommendations actionable`,
-};
-// ============================================================================
-// Base System Prompt (standalone version)
-// ============================================================================
-const baseSystemPrompt = `You are an autonomous AI agent operating in a software development workspace. You have access to tools for reading, writing, and searching files, running shell commands, browsing the web, and delegating to sub-agents. You are in a multi-step execution loop — you will keep working until the task is complete.
-
-# Identity and Approach
-
-You are a hands-on agent. When given a task, you use your tools to accomplish it directly rather than explaining what the user could do. You think through problems step by step, writing out your reasoning before each tool call so your decision-making is transparent. When a task requires multiple steps, you persist through all of them — you do not stop partway or ask for permission to continue unless the request is genuinely ambiguous.
-
-CRITICAL RULES:
-- Never say "I can't", "I don't have access", or "I don't know" without trying a tool first.
-- If you don't know how to answer something, your default action is to use a tool — not to give up.
-- Always prefer action over asking for clarification.
-
-# Working with Code
-
-Before modifying any file, you read it first to understand its current state and context. You make targeted, minimal edits rather than rewriting entire files. After making changes, you verify they work by running builds, tests, or other validation as appropriate. When exploring an unfamiliar codebase, you start broad (glob for file patterns, grep for content) and narrow down progressively.
-
-# Tool Awareness
-
-Your tool calls and their results are displayed directly to the user. Because of this, you do not echo or restate tool output in your text responses. Instead, you provide brief interpretation — what the results mean, what you noticed, or what you plan to do next. This keeps the conversation focused and avoids redundancy.
-
-# Problem Solving
-
-When something goes wrong — a failed command, an unexpected error, a tool call that returns nothing useful — you read the error output, reason about what happened, and try a different approach. You never give up after one failure. If one path doesn't work, you try alternative approaches before concluding something isn't possible. When the user asks you to do something and you're not sure how, try the most obvious approach first — action beats deliberation.
-
-# Communication
-
-You are direct and concise. You lead with actions and results rather than preamble. After completing work, you briefly summarize what you did and why. If you're uncertain about something, you say so clearly rather than guessing. Never ask the user to clarify something you could figure out by using your tools.`;
-// ============================================================================
-// Combined System Prompts
-// ============================================================================
-export const systemPrompts = {
-    generic: baseSystemPrompt,
-    researcher: `${baseSystemPrompt}\n${rolePrompts.researcher}`,
-    coder: `${baseSystemPrompt}\n${rolePrompts.coder}`,
-    analyst: `${baseSystemPrompt}\n${rolePrompts.analyst}`,
-};
-export const AGENT_ROLES = ['generic', 'researcher', 'coder', 'analyst'];
-// ============================================================================
-// Call Options Schema per Role
-// ============================================================================
-export const roleCallOptionsSchemas = {
-    generic: z.object({
-        userId: z.string().optional(),
-        sessionId: z.string().optional(),
-        workspaceRoot: z.string().optional(),
-    }),
-    researcher: z.object({
-        userId: z.string().optional(),
-        sessionId: z.string().optional(),
-        workspaceRoot: z.string().optional(),
-        searchDepth: z.enum(['shallow', 'deep']).optional(),
-        sourceTypes: z.array(z.string()).optional(),
-    }),
-    coder: z.object({
-        userId: z.string().optional(),
-        sessionId: z.string().optional(),
-        workspaceRoot: z.string().optional(),
-        language: z.string().optional(),
-        testingStrategy: z.enum(['unit', 'integration', 'both', 'none']).optional(),
-    }),
-    analyst: z.object({
-        userId: z.string().optional(),
-        sessionId: z.string().optional(),
-        workspaceRoot: z.string().optional(),
-        analysisType: z.enum(['exploratory', 'confirmatory']).optional(),
-        outputFormat: z.enum(['summary', 'detailed', 'visual']).optional(),
-    }),
-};
-export const roleConfigs = {
-    generic: {
-        systemPrompt: systemPrompts.generic,
-        callOptionsSchema: roleCallOptionsSchemas.generic,
-        defaultTools: ['fs', 'shell', 'web'],
-        recommendedModel: 'standard',
-    },
-    researcher: {
-        systemPrompt: systemPrompts.researcher,
-        callOptionsSchema: roleCallOptionsSchemas.researcher,
-        defaultTools: ['web', 'fs', 'reasoning'],
-        recommendedModel: 'standard',
-    },
-    coder: {
-        systemPrompt: systemPrompts.coder,
-        callOptionsSchema: roleCallOptionsSchemas.coder,
-        defaultTools: ['fs', 'shell', 'grep', 'glob'],
-        recommendedModel: 'powerful',
-    },
-    analyst: {
-        systemPrompt: systemPrompts.analyst,
-        callOptionsSchema: roleCallOptionsSchemas.analyst,
-        defaultTools: ['fs', 'reasoning', 'shell'],
-        recommendedModel: 'standard',
-    },
-};
-// ============================================================================
-// Helpers
-// ============================================================================
-export function buildSpawnedAgentPrompt(role) {
-    return `${systemPrompts[role]}\n${SPAWNED_AGENT_CONTEXT}`;
-}
-export function getRoleSystemPrompt(role) {
-    return systemPrompts[role];
-}
-export function getRoleCallOptionsSchema(role) {
-    return roleCallOptionsSchemas[role];
-}
-//# sourceMappingURL=roles.js.map

package/dist/presets/roles.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"roles.js","sourceRoot":"","sources":["../../src/presets/roles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;8CAUS,CAAC;AAE/C,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,EAAE;IAEX,UAAU,EAAE;;;;;;;;;;;;;;;;;;;;;;;kDAuBoC;IAEhD,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;;;;+BAwBsB;IAE7B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;kCAwBuB;CACjC,CAAC;AAEF,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;uTAyB8R,CAAA;AAGvT,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,gBAAgB;IACzB,UAAU,EAAE,GAAG,gBAAgB,KAAK,WAAW,CAAC,UAAU,EAAE;IAC5D,KAAK,EAAE,GAAG,gBAAgB,KAAK,WAAW,CAAC,KAAK,EAAE;IAClD,OAAO,EAAE,GAAG,gBAAgB,KAAK,WAAW,CAAC,OAAO,EAAE;CACvD,CAAC;AAOF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAElF,+EAA+E;AAC/E,+BAA+B;AAC/B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACrC,CAAC;IAEF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;QACnD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;KAC5C,CAAC;IAEF,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC/B,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC5E,CAAC;IAEF,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACpC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE;QAChE,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;KACnE,CAAC;CACH,CAAC;AAaF,MAAM,CAAC,MAAM,WAAW,GAAkC;IACxD,OAAO,EAAE;QACP,YAAY,EAAE,aAAa,CAAC,OAAO;QACnC,iBAAiB,EAAE,sBAAsB,CAAC,OAAO;QACjD,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC;QACpC,gBAAgB,EAAE,UAAU;KAC7B;IACD,UAAU,EAAE;QACV,YAAY,EAAE,aAAa,CAAC,UAAU;QACtC,iBAAiB,EAAE,sBAAsB,CAAC,UAAU;QACpD,YAAY,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC;QACxC,gBAAgB,EAAE,UAAU;KAC7B;IACD,KAAK,EAAE;QACL,YAAY,EAAE,aAAa,CAAC,KAAK;QACjC,iBAAiB,EAAE,sBAAsB,CAAC,KAAK;QAC/C,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;QAC7C,gBAAgB,EAAE,UAAU;KAC7B;IACD,OAAO,EAAE;QACP,YAAY,EAAE,aAAa,CAAC,OAAO;QACnC,iBAAiB,EAAE,sBAAsB,CAAC,OAAO;QACjD,YAAY,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC;QAC1C,gBAAgB,EAAE,UAAU;KAC7B;CACF,CAAC;AAEF,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,UAAU,uBAAuB,CAAC,IAAe;IACrD,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,qBAAqB,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAe;IACtD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/prompts/templates.d.ts

@@ -1,11 +0,0 @@
-/**
- * @agntk/core - System Prompt Templates
- * Core system prompts for agent behavior
- *
- * @deprecated Use `presets/role-registry.ts` instead. That module is the canonical
- * source of truth for role prompts, used by `createAgent()` via `getRole()`.
- * This file is kept for backward compatibility of public exports only.
- */
-export declare const systemPrompt = "You are an autonomous agent. Your purpose is to accomplish the user's goal using whatever approach makes sense.\n\n# Philosophy\n\nYou have a mind and you have tools. Tools extend your thinking - use them fluidly as part of reasoning, not as separate mechanical steps.\n\nThere is no single correct workflow. Match your approach to the problem:\n- Reason through it, gather information, reason more, then act\n- Act immediately if the path is obvious\n- Start one approach, realize it's wrong, switch to another\n- Call multiple tools in parallel when they don't depend on each other\n\nWhen something doesn't work, adapt. When you need information, go get it. When uncertain, reason carefully. When clear, act directly.\n\nWhen errors occur, read them carefully. The error message usually points to the fix.\n\n# Action\n\nDo things, don't announce them. Instead of \"I'll search for X\", just search.\n\nBe autonomous. Complete tasks without asking permission at every step. Only ask the user when you genuinely need information only they can provide.\n\n# Thinking Out Loud\n\nBefore each action, briefly state:\n- **Goal**: What am I trying to accomplish?\n- **Approach**: Why is this the right tool/action?\n- **Risk**: What could go wrong?\n\nKeep it concise (1-2 sentences each). This helps the user understand your decisions.\n\n# Efficiency\n\nComplete tasks in the fewest steps possible:\n- Think first: What's the most direct path to the goal?\n- Use the right tool: Each tool's description explains when to use it\n- Chain when independent: Call multiple tools in parallel when they don't depend on each other\n- No random exploration: Every action should have a purpose\n\n# Tools\n\nYou have access to consolidated tools with multiple actions. Use the action parameter to specify what to do:\n\n**fs** - All file operations (read, write, edit, list, glob, grep, move, delete, info, mkdir)\n**shell** - Execute shell commands (with allowlisting for repeated commands)\n**web** - Search the internet (search) or fetch page content (fetch)\n**memory** - Knowledge graph operations (add, search, episodes, fact, entity, related)\n\n**delegate** - Parallel work: tool chains (steps), sub-agents (agent), or background processes (background)\n**task** - Manage background tasks (status, output, cancel, list, cleanup)\n\nAdditional tools: plan, ask_user, task_complete\n\nEach tool's description provides detailed guidance on when and how to use it. Read the descriptions to understand capabilities and constraints.\n\n# Delegation\n\nFor complex work, use the delegate tool:\n- **steps**: Execute multiple tool calls in sequence with dependency handling\n- **agent**: Spawn a specialized sub-agent (coder/researcher/analyst)\n- **background**: Start a long-running shell command\n\nAfter delegating, use the task tool to monitor progress and retrieve output.\n\n# Completion\n\nCall task_complete when you have fully accomplished what the user asked for.\n\nOnly call task_complete when truly done - not planned, not partially done, but actually complete.\n";
-export declare const rolePrompts: Record<string, string>;
-//# sourceMappingURL=templates.d.ts.map

package/dist/prompts/templates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,YAAY,+/FAqExB,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsC9C,CAAC"}

package/dist/prompts/templates.js

@@ -1,115 +0,0 @@
-/**
- * @agntk/core - System Prompt Templates
- * Core system prompts for agent behavior
- *
- * @deprecated Use `presets/role-registry.ts` instead. That module is the canonical
- * source of truth for role prompts, used by `createAgent()` via `getRole()`.
- * This file is kept for backward compatibility of public exports only.
- */
-export const systemPrompt = `You are an autonomous agent. Your purpose is to accomplish the user's goal using whatever approach makes sense.
-
-# Philosophy
-
-You have a mind and you have tools. Tools extend your thinking - use them fluidly as part of reasoning, not as separate mechanical steps.
-
-There is no single correct workflow. Match your approach to the problem:
-- Reason through it, gather information, reason more, then act
-- Act immediately if the path is obvious
-- Start one approach, realize it's wrong, switch to another
-- Call multiple tools in parallel when they don't depend on each other
-
-When something doesn't work, adapt. When you need information, go get it. When uncertain, reason carefully. When clear, act directly.
-
-When errors occur, read them carefully. The error message usually points to the fix.
-
-# Action
-
-Do things, don't announce them. Instead of "I'll search for X", just search.
-
-Be autonomous. Complete tasks without asking permission at every step. Only ask the user when you genuinely need information only they can provide.
-
-# Thinking Out Loud
-
-Before each action, briefly state:
-- **Goal**: What am I trying to accomplish?
-- **Approach**: Why is this the right tool/action?
-- **Risk**: What could go wrong?
-
-Keep it concise (1-2 sentences each). This helps the user understand your decisions.
-
-# Efficiency
-
-Complete tasks in the fewest steps possible:
-- Think first: What's the most direct path to the goal?
-- Use the right tool: Each tool's description explains when to use it
-- Chain when independent: Call multiple tools in parallel when they don't depend on each other
-- No random exploration: Every action should have a purpose
-
-# Tools
-
-You have access to consolidated tools with multiple actions. Use the action parameter to specify what to do:
-
-**fs** - All file operations (read, write, edit, list, glob, grep, move, delete, info, mkdir)
-**shell** - Execute shell commands (with allowlisting for repeated commands)
-**web** - Search the internet (search) or fetch page content (fetch)
-**memory** - Knowledge graph operations (add, search, episodes, fact, entity, related)
-
-**delegate** - Parallel work: tool chains (steps), sub-agents (agent), or background processes (background)
-**task** - Manage background tasks (status, output, cancel, list, cleanup)
-
-Additional tools: plan, ask_user, task_complete
-
-Each tool's description provides detailed guidance on when and how to use it. Read the descriptions to understand capabilities and constraints.
-
-# Delegation
-
-For complex work, use the delegate tool:
-- **steps**: Execute multiple tool calls in sequence with dependency handling
-- **agent**: Spawn a specialized sub-agent (coder/researcher/analyst)
-- **background**: Start a long-running shell command
-
-After delegating, use the task tool to monitor progress and retrieve output.
-
-# Completion
-
-Call task_complete when you have fully accomplished what the user asked for.
-
-Only call task_complete when truly done - not planned, not partially done, but actually complete.
-`;
-export const rolePrompts = {
-    generic: systemPrompt,
-    coder: `${systemPrompt}
-
-# Specialized Role: Code Implementation
-
-You are a code implementation specialist. Your focus areas:
-- Writing clean, maintainable code
-- Following existing patterns in the codebase
-- Making minimal, targeted changes
-- Running tests to verify your changes work
-
-Always read relevant code before making changes. Match the existing style.`,
-    researcher: `${systemPrompt}
-
-# Specialized Role: Research
-
-You are a research specialist. Your focus areas:
-- Gathering comprehensive information on topics
-- Evaluating source credibility
-- Synthesizing findings into clear summaries
-- Identifying key insights and patterns
-
-Be thorough but efficient. Focus on actionable information.`,
-    analyst: `${systemPrompt}
-
-# Specialized Role: Analysis
-
-You are an analysis specialist. Your focus areas:
-- Breaking down complex problems
-- Identifying patterns and relationships
-- Evaluating trade-offs and options
-- Providing data-driven recommendations
-
-Be systematic and logical. Support conclusions with evidence.`,
-};
-//# sourceMappingURL=templates.js.map

package/dist/prompts/templates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/prompts/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqE3B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAA2B;IACjD,OAAO,EAAE,YAAY;IAErB,KAAK,EAAE,GAAG,YAAY;;;;;;;;;;2EAUmD;IAEzE,UAAU,EAAE,GAAG,YAAY;;;;;;;;;;4DAU+B;IAE1D,OAAO,EAAE,GAAG,YAAY;;;;;;;;;;8DAUoC;CAC7D,CAAC"}

package/dist/streaming/data-parts.d.ts

@@ -1,163 +0,0 @@
-/**
- * @fileoverview Custom data part types for AI SDK streaming.
- * These types define the shape of transient data streamed during agent execution.
- *
- * Usage with AI SDK:
- * ```typescript
- * import type { DataStreamWriter } from 'ai';
- *
- * const writer: DataStreamWriter = ...;
- * writer.writeData({ type: 'file-content', data: { path: '/foo.ts', content: '...', truncated: false } });
- * ```
- */
-/**
- * Union type of all custom data parts supported by the agent SDK.
- * These are streamed transiently and not persisted to conversation context.
- */
-export type AgentDataParts = {
-    /**
-     * Streaming output from a spawned sub-agent.
-     * Displayed as nested collapsible in UI.
-     */
-    'sub-agent-stream': SubAgentStreamData;
-    /**
-     * Search results from grep/glob/codebase search.
-     */
-    'search-result': SearchResultData;
-    /**
-     * File content streamed transiently (not added to context).
-     */
-    'file-content': FileContentData;
-    /**
-     * Shell command execution output.
-     */
-    'shell-output': ShellOutputData;
-    /**
-     * Progress indicator for long-running tools.
-     */
-    'tool-progress': ToolProgressData;
-    /**
-     * Reasoning/thinking step from deep reasoning tool.
-     */
-    'reasoning-step': ReasoningStepData;
-    /**
-     * Memory retrieval results.
-     */
-    'memory-result': MemoryResultData;
-};
-/** Sub-agent streaming data. */
-export interface SubAgentStreamData {
-    /** Unique identifier for the sub-agent instance. */
-    agentId: string;
-    /** Role of the sub-agent. */
-    role: string;
-    /** Streamed text content. */
-    text: string;
-    /** Status of the sub-agent stream. */
-    status: 'streaming' | 'complete' | 'error';
-    /** Error message if status is 'error'. */
-    error?: string;
-}
-/** Search result data from file/code search. */
-export interface SearchResultData {
-    /** File path relative to workspace root. */
-    path: string;
-    /** Matched content snippet. */
-    content: string;
-    /** Number of matches in the file. */
-    matches: number;
-    /** Line number of the first match. */
-    line?: number;
-    /** Search pattern used. */
-    pattern?: string;
-}
-/** File content data for transient streaming. */
-export interface FileContentData {
-    /** Absolute or relative file path. */
-    path: string;
-    /** File content. */
-    content: string;
-    /** Whether content was truncated due to size limits. */
-    truncated: boolean;
-    /** Total file size in bytes. */
-    totalBytes?: number;
-    /** MIME type of the file. */
-    mimeType?: string;
-    /** Language identifier for syntax highlighting. */
-    language?: string;
-    /** Line range if partial content. */
-    lineRange?: {
-        start: number;
-        end: number;
-    };
-}
-/** Shell command output data. */
-export interface ShellOutputData {
-    /** Command that was executed. */
-    command: string;
-    /** Command output (stdout + stderr). */
-    output: string;
-    /** Exit code of the command. */
-    exitCode: number;
-    /** Working directory where command was executed. */
-    cwd?: string;
-    /** Whether output was truncated. */
-    truncated?: boolean;
-    /** Execution duration in milliseconds. */
-    durationMs?: number;
-}
-/** Tool progress indicator data. */
-export interface ToolProgressData {
-    /** Name of the tool being executed. */
-    toolName: string;
-    /** Progress percentage (0-100). */
-    progress: number;
-    /** Human-readable progress message. */
-    message: string;
-    /** Estimated time remaining in milliseconds. */
-    estimatedRemaining?: number;
-    /** Current step/total steps format. */
-    step?: {
-        current: number;
-        total: number;
-    };
-}
-/** Reasoning step from deep reasoning tool. */
-export interface ReasoningStepData {
-    /** Step number in the reasoning chain. */
-    stepNumber: number;
-    /** Total estimated steps. */
-    totalSteps: number;
-    /** The reasoning thought content. */
-    thought: string;
-    /** Whether this is a revision of a previous thought. */
-    isRevision?: boolean;
-    /** Which thought number is being revised. */
-    revisesThought?: number;
-    /** Branch identifier for alternative reasoning paths. */
-    branchId?: string;
-}
-/** Memory retrieval result data. */
-export interface MemoryResultData {
-    /** Memory entry content. */
-    content: string;
-    /** Similarity score (0-1). */
-    score: number;
-    /** Metadata associated with the memory. */
-    metadata?: Record<string, unknown>;
-    /** When the memory was stored. */
-    timestamp?: string;
-}
-/** Type helper to get data type for a specific part type. */
-export type DataPartType<K extends keyof AgentDataParts> = AgentDataParts[K];
-/** Type helper for creating typed data parts. */
-export interface TypedDataPart<K extends keyof AgentDataParts> {
-    type: K;
-    id?: string;
-    data: AgentDataParts[K];
-}
-/** Union of all possible data parts. */
-export type AnyDataPart = {
-    [K in keyof AgentDataParts]: TypedDataPart<K>;
-}[keyof AgentDataParts];
-//# sourceMappingURL=data-parts.d.ts.map

package/dist/streaming/data-parts.d.ts.map

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

package/dist/streaming/data-parts.js

@@ -1,14 +0,0 @@
-/**
- * @fileoverview Custom data part types for AI SDK streaming.
- * These types define the shape of transient data streamed during agent execution.
- *
- * Usage with AI SDK:
- * ```typescript
- * import type { DataStreamWriter } from 'ai';
- *
- * const writer: DataStreamWriter = ...;
- * writer.writeData({ type: 'file-content', data: { path: '/foo.ts', content: '...', truncated: false } });
- * ```
- */
-export {};
-//# sourceMappingURL=data-parts.js.map

package/dist/streaming/data-parts.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"data-parts.js","sourceRoot":"","sources":["../../src/streaming/data-parts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/streaming/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * @agntk/core - Streaming Module
- *
- * Exports for transient streaming and custom data parts.
- */
-export { type AgentDataParts, type SubAgentStreamData, type SearchResultData, type FileContentData, type ShellOutputData, type ToolProgressData, type ReasoningStepData, type MemoryResultData, type DataPartType, type TypedDataPart, type AnyDataPart, } from './data-parts.js';
-export { withTransientStreaming, writeTransient, streamTransient, streamFileContent, streamShellOutput, streamSearchResult, streamProgress, streamReasoningStep, streamSubAgent, type TransientStreamWriter, type TransientToolContext, } from './transient.js';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,GAC1B,MAAM,aAAa,CAAC"}

package/dist/streaming/index.js

@@ -1,10 +0,0 @@
-/**
- * @agntk/core - Streaming Module
- *
- * Exports for transient streaming and custom data parts.
- */
-// Data part types
-export {} from './data-parts.js';
-// Transient streaming
-export { withTransientStreaming, writeTransient, streamTransient, streamFileContent, streamShellOutput, streamSearchResult, streamProgress, streamReasoningStep, streamSubAgent, } from './transient.js';
-//# sourceMappingURL=index.js.map

package/dist/streaming/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/streaming/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,kBAAkB;AAClB,OAAO,EAYN,MAAM,cAAc,CAAC;AAEtB,sBAAsB;AACtB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,cAAc,GAGf,MAAM,aAAa,CAAC"}