@agntk/core 0.1.1 → 0.1.2

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"}

package/dist/streaming/transient.d.ts

@@ -1,136 +0,0 @@
-/**
- * @agntk/core - Transient Streaming Infrastructure
- *
- * Enables tools to stream data to the UI without persisting to conversation context.
- * This keeps the context window lean while providing rich UI feedback.
- */
-import type { Tool } from 'ai';
-import type { ToolContext } from '../types/lifecycle.js';
-import type { AgentDataParts } from './data-parts.js';
-/**
- * Interface for UI stream writer.
- * Compatible with AI SDK's DataStreamWriter.
- */
-export interface TransientStreamWriter {
-    writeData(data: unknown): void;
-}
-/**
- * Enhanced tool context with transient streaming capabilities.
- * Uses intersection type to extend ToolContext without conflicts.
- */
-export type TransientToolContext = ToolContext & {
-    /** Helper to stream typed transient data */
-    stream: <K extends keyof AgentDataParts>(type: K, data: AgentDataParts[K]) => void;
-};
-/**
- * Tool set is a record of tools keyed by name.
- */
-type ToolSet = Record<string, Tool>;
-/**
- * Wrap tools to enable transient streaming.
- *
- * Tools wrapped with this function will have access to a `stream()` helper
- * in their context that allows streaming data to the UI without adding
- * it to the conversation context.
- *
- * @param tools - Record of tools to wrap
- * @param writer - Stream writer for sending data to the client
- * @returns Wrapped tools with transient streaming enabled
- *
- * @example
- * ```typescript
- * const wrappedTools = withTransientStreaming(myTools, dataStream);
- *
- * // Inside a tool's execute function:
- * execute: async (input, ctx) => {
- *   ctx.stream('file-content', {
- *     path: input.path,
- *     content: fileContent,
- *     truncated: false,
- *   });
- *   return `Read ${input.path}`;
- * }
- * ```
- */
-export declare function withTransientStreaming(tools: ToolSet, writer: TransientStreamWriter): ToolSet;
-/**
- * Stream typed transient data to the UI.
- *
- * @param writer - Stream writer instance
- * @param type - Data part type
- * @param data - Data to stream
- */
-export declare function writeTransient<K extends keyof AgentDataParts>(writer: TransientStreamWriter, type: K, data: AgentDataParts[K]): void;
-/**
- * Helper for tools to stream transient data from within their execute function.
- *
- * @param ctx - Tool context (must have writer)
- * @param type - Data part type
- * @param data - Data to stream
- *
- * @example
- * ```typescript
- * // Inside a tool's execute function:
- * streamTransient(ctx, 'shell-output', {
- *   command: 'npm test',
- *   output: result.stdout,
- *   exitCode: result.code,
- * });
- * ```
- */
-export declare function streamTransient<K extends keyof AgentDataParts>(ctx: ToolContext, type: K, data: AgentDataParts[K]): void;
-/**
- * Stream file content transiently.
- */
-export declare function streamFileContent(ctx: ToolContext, path: string, content: string, options?: {
-    truncated?: boolean;
-    totalBytes?: number;
-    language?: string;
-    lineRange?: {
-        start: number;
-        end: number;
-    };
-}): void;
-/**
- * Stream shell output transiently.
- */
-export declare function streamShellOutput(ctx: ToolContext, command: string, output: string, exitCode: number, options?: {
-    cwd?: string;
-    truncated?: boolean;
-    durationMs?: number;
-}): void;
-/**
- * Stream search results transiently.
- */
-export declare function streamSearchResult(ctx: ToolContext, path: string, content: string, matches: number, options?: {
-    line?: number;
-    pattern?: string;
-}): void;
-/**
- * Stream tool progress update transiently.
- */
-export declare function streamProgress(ctx: ToolContext, toolName: string, progress: number, message: string, options?: {
-    estimatedRemaining?: number;
-    step?: {
-        current: number;
-        total: number;
-    };
-}): void;
-/**
- * Stream reasoning step transiently.
- *
- * @internal Forward-designed for CLI streaming feature. No production callers yet.
- */
-export declare function streamReasoningStep(ctx: ToolContext, stepNumber: number, totalSteps: number, thought: string, options?: {
-    isRevision?: boolean;
-    revisesThought?: number;
-    branchId?: string;
-}): void;
-/**
- * Stream sub-agent output transiently.
- *
- * @internal Forward-designed for CLI streaming feature. No production callers yet.
- */
-export declare function streamSubAgent(ctx: ToolContext, agentId: string, role: string, text: string, status: 'streaming' | 'complete' | 'error', error?: string): void;
-export {};
-//# sourceMappingURL=transient.d.ts.map

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

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

package/dist/streaming/transient.js

@@ -1,201 +0,0 @@
-/**
- * @agntk/core - Transient Streaming Infrastructure
- *
- * Enables tools to stream data to the UI without persisting to conversation context.
- * This keeps the context window lean while providing rich UI feedback.
- */
-import { createLogger } from '@agntk/logger';
-const log = createLogger('@agntk/core:streaming');
-// ============================================================================
-// Main API: withTransientStreaming
-// ============================================================================
-/**
- * Wrap tools to enable transient streaming.
- *
- * Tools wrapped with this function will have access to a `stream()` helper
- * in their context that allows streaming data to the UI without adding
- * it to the conversation context.
- *
- * @param tools - Record of tools to wrap
- * @param writer - Stream writer for sending data to the client
- * @returns Wrapped tools with transient streaming enabled
- *
- * @example
- * ```typescript
- * const wrappedTools = withTransientStreaming(myTools, dataStream);
- *
- * // Inside a tool's execute function:
- * execute: async (input, ctx) => {
- *   ctx.stream('file-content', {
- *     path: input.path,
- *     content: fileContent,
- *     truncated: false,
- *   });
- *   return `Read ${input.path}`;
- * }
- * ```
- */
-export function withTransientStreaming(tools, writer) {
-    const wrappedTools = {};
-    for (const [name, tool] of Object.entries(tools)) {
-        wrappedTools[name] = wrapToolWithTransient(tool, writer, name);
-    }
-    return wrappedTools;
-}
-// ============================================================================
-// Tool Wrapping
-// ============================================================================
-/**
- * Wrap a single tool with transient streaming capabilities.
- */
-function wrapToolWithTransient(tool, writer, toolName) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const originalExecute = tool.execute;
-    if (!originalExecute) {
-        return tool;
-    }
-    return {
-        ...tool,
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        execute: async (input, options) => {
-            // Create enhanced context with streaming helper
-            const enhancedContext = {
-                ...(options || {}),
-                agentId: options?.agentId || 'unknown',
-                stepNumber: options?.stepNumber || 0,
-                writer,
-                stream: (type, data) => {
-                    writeTransient(writer, type, data);
-                },
-            };
-            return originalExecute(input, enhancedContext);
-        },
-    };
-}
-// ============================================================================
-// Transient Data Writers
-// ============================================================================
-/**
- * Stream typed transient data to the UI.
- *
- * @param writer - Stream writer instance
- * @param type - Data part type
- * @param data - Data to stream
- */
-export function writeTransient(writer, type, data) {
-    const dataPart = {
-        type,
-        data,
-    };
-    writer.writeData({
-        ...dataPart,
-        transient: true,
-    });
-}
-/**
- * Helper for tools to stream transient data from within their execute function.
- *
- * @param ctx - Tool context (must have writer)
- * @param type - Data part type
- * @param data - Data to stream
- *
- * @example
- * ```typescript
- * // Inside a tool's execute function:
- * streamTransient(ctx, 'shell-output', {
- *   command: 'npm test',
- *   output: result.stdout,
- *   exitCode: result.code,
- * });
- * ```
- */
-export function streamTransient(ctx, type, data) {
-    // Cast to TransientStreamWriter - they have compatible interfaces
-    const writer = ctx.writer;
-    if (writer) {
-        writeTransient(writer, type, data);
-    }
-}
-// ============================================================================
-// Specialized Streamers
-// ============================================================================
-/**
- * Stream file content transiently.
- */
-export function streamFileContent(ctx, path, content, options = {}) {
-    streamTransient(ctx, 'file-content', {
-        path,
-        content,
-        truncated: options.truncated ?? false,
-        totalBytes: options.totalBytes,
-        language: options.language,
-        lineRange: options.lineRange,
-    });
-}
-/**
- * Stream shell output transiently.
- */
-export function streamShellOutput(ctx, command, output, exitCode, options = {}) {
-    streamTransient(ctx, 'shell-output', {
-        command,
-        output,
-        exitCode,
-        cwd: options.cwd,
-        truncated: options.truncated,
-        durationMs: options.durationMs,
-    });
-}
-/**
- * Stream search results transiently.
- */
-export function streamSearchResult(ctx, path, content, matches, options = {}) {
-    streamTransient(ctx, 'search-result', {
-        path,
-        content,
-        matches,
-        line: options.line,
-        pattern: options.pattern,
-    });
-}
-/**
- * Stream tool progress update transiently.
- */
-export function streamProgress(ctx, toolName, progress, message, options = {}) {
-    streamTransient(ctx, 'tool-progress', {
-        toolName,
-        progress,
-        message,
-        estimatedRemaining: options.estimatedRemaining,
-        step: options.step,
-    });
-}
-/**
- * Stream reasoning step transiently.
- *
- * @internal Forward-designed for CLI streaming feature. No production callers yet.
- */
-export function streamReasoningStep(ctx, stepNumber, totalSteps, thought, options = {}) {
-    streamTransient(ctx, 'reasoning-step', {
-        stepNumber,
-        totalSteps,
-        thought,
-        isRevision: options.isRevision,
-        revisesThought: options.revisesThought,
-        branchId: options.branchId,
-    });
-}
-/**
- * Stream sub-agent output transiently.
- *
- * @internal Forward-designed for CLI streaming feature. No production callers yet.
- */
-export function streamSubAgent(ctx, agentId, role, text, status, error) {
-    streamTransient(ctx, 'sub-agent-stream', {
-        agentId,
-        role,
-        text,
-        status,
-        error,
-    });
-}
-//# sourceMappingURL=transient.js.map