@agntk/core 0.3.0 → 0.3.2

package/dist/prompts/templates.js

@@ -0,0 +1,115 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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/provider-resolver.d.ts

@@ -16,6 +16,10 @@ export interface ResolvedProvider {
     isFree: boolean;
     /** When provider is 'ollama', hardware-aware model recommendations */
     ollamaModels?: OllamaModelRecommendation;
+    /** When provider is 'ollama', the list of models actually installed */
+    ollamaInstalledModels?: string[];
+    /** When Ollama was skipped despite running, explains why (for CLI display) */
+    ollamaSkipReason?: string;
 }
 /**
  * Resolve the best available provider.

package/dist/provider-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-resolver.d.ts","sourceRoot":"","sources":["../src/provider-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAuC,KAAK,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAQtG,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,YAAY,CAAC,EAAE,yBAAyB,CAAC;CAC1C;AA2FD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAejE;AASD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAUrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}
+{"version":3,"file":"provider-resolver.d.ts","sourceRoot":"","sources":["../src/provider-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAuC,KAAK,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAQtG,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC,uEAAuE;IACvE,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAoID;;;;;;;;GAQG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAiBjE;AASD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAUrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/provider-resolver.js

@@ -28,6 +28,10 @@ function checkBYOK() {
     return null;
 }
 // ============================================================================
+// Ollama Skip Reason (set by probeOllama, read by getFreeTier)
+// ============================================================================
+let _ollamaSkipReason = null;
+// ============================================================================
 // Ollama Detection
 // ============================================================================
 /**
@@ -45,11 +49,16 @@ function checkOllamaExplicit() {
 }
 /**
  * Probe Ollama at localhost:11434 with a fast health check.
- * If Ollama is running, detect system hardware and recommend models.
+ * If Ollama is running AND has at least one model pulled, detect system
+ * hardware and recommend the best available models.
  * Returns within 500ms regardless of whether Ollama is running.
  */
 async function probeOllama() {
-    const baseUrl = process.env['OLLAMA_BASE_URL'] || 'http://localhost:11434';
+    // Strip trailing path segments (/api, /v1, etc.) — the probe needs the raw Ollama host.
+    // Users may set OLLAMA_BASE_URL to "http://localhost:11434/api" or "/v1" for the AI SDK,
+    // but the native Ollama API lives at the root (e.g. /api/tags, not /api/api/tags).
+    const rawUrl = process.env['OLLAMA_BASE_URL'] || 'http://localhost:11434';
+    const baseUrl = rawUrl.replace(/\/(api|v1)\/?$/, '');
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), 500);
     try {
@@ -58,19 +67,41 @@ async function probeOllama() {
             method: 'GET',
         });
         clearTimeout(timeout);
-        if (response.ok) {
-            // Ollama is running — detect hardware and pick best model tier
-            const sysProfile = detectSystem();
-            const models = recommendOllamaModels(sysProfile);
-            log.info('Ollama detected', { baseUrl, tier: models.tier, reason: models.reason });
-            return {
-                provider: 'ollama',
-                source: `ollama (${baseUrl})`,
-                isFree: false,
-                ollamaModels: models,
-            };
+        if (!response.ok)
+            return null;
+        // Parse which models are actually installed
+        const data = (await response.json());
+        const installedModels = (data.models || []).map((m) => m.name.toLowerCase());
+        if (installedModels.length === 0) {
+            log.info('Ollama running but no models installed', { baseUrl });
+            return null;
         }
-        return null;
+        // Detect hardware and recommend the best model from what's actually installed
+        const sysProfile = detectSystem();
+        const recommendation = recommendOllamaModels(sysProfile, installedModels);
+        // If no usable models found (all sub-8b, no cloud), skip Ollama
+        if (recommendation.noUsableModels) {
+            _ollamaSkipReason =
+                'Ollama running but no 8b+ model found.\n' +
+                    '        Run `ollama pull qwen3-coder:30b` for local, or `ollama pull qwen3-coder:480b-cloud` for cloud.\n' +
+                    '        Using free tier for now.';
+            log.info('Ollama skipped — no usable models', { baseUrl, installed: installedModels });
+            return null;
+        }
+        log.info('Ollama detected', {
+            baseUrl,
+            tier: recommendation.tier,
+            standard: recommendation.standard,
+            installed: installedModels,
+            reason: recommendation.reason,
+        });
+        return {
+            provider: 'ollama',
+            source: `ollama (${baseUrl})`,
+            isFree: false,
+            ollamaModels: recommendation,
+            ollamaInstalledModels: installedModels,
+        };
     }
     catch {
         clearTimeout(timeout);
@@ -83,7 +114,11 @@ async function probeOllama() {
 // ============================================================================
 function getFreeTier() {
     log.info('Using agntk free tier');
-    return { provider: 'agntk-free', source: 'free tier (Cerebras)', isFree: true };
+    const result = { provider: 'agntk-free', source: 'free tier (Cerebras)', isFree: true };
+    if (_ollamaSkipReason) {
+        result.ollamaSkipReason = _ollamaSkipReason;
+    }
+    return result;
 }
 // ============================================================================
 // Main Cascade
@@ -98,6 +133,7 @@ function getFreeTier() {
  * 4. Free tier fallback (sync, instant)
  */
 export async function resolveProvider() {
+    _ollamaSkipReason = null;
     // 1. BYOK — instant
     const byok = checkBYOK();
     if (byok)

package/dist/provider-resolver.js.map

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

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

@@ -0,0 +1,163 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,14 @@
+/**
+ * @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

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

package/dist/streaming/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,10 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,136 @@
+/**
+ * @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

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