@agntk/core 0.1.0

package/dist/prompts/context.js

@@ -0,0 +1,187 @@
+/**
+ * @agntk/core - System Context Builder
+ * Builds dynamic context information for agent system prompts
+ */
+import { createLogger } from '@agntk/logger';
+import { GEOLOCATION_API_URL, GEOLOCATION_ENABLED_DEFAULT } from '../constants.js';
+const log = createLogger('@agntk/core:context');
+// ============================================================================
+// Runtime Detection
+// ============================================================================
+const isNode = typeof process !== 'undefined' && process.versions?.node;
+async function getNodeInfo() {
+    if (!isNode) {
+        return {
+            platform: 'browser',
+            hostname: 'browser',
+            username: 'user',
+        };
+    }
+    const os = await import('node:os');
+    return {
+        platform: os.platform(),
+        hostname: os.hostname(),
+        username: os.userInfo().username,
+    };
+}
+function getLocale() {
+    if (typeof Intl !== 'undefined') {
+        return Intl.DateTimeFormat().resolvedOptions().locale;
+    }
+    return 'en-US';
+}
+// ============================================================================
+// Location (Optional)
+// ============================================================================
+async function fetchUserLocation() {
+    try {
+        const response = await fetch(GEOLOCATION_API_URL);
+        if (!response.ok)
+            return undefined;
+        const data = await response.json();
+        return {
+            city: data.city,
+            region: data.regionName,
+            country: data.country,
+            countryCode: data.countryCode,
+            timezone: data.timezone,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+// ============================================================================
+// Workspace Map
+// ============================================================================
+async function generateWorkspaceMap(workspaceRoot) {
+    if (!isNode)
+        return '';
+    try {
+        const fs = await import('node:fs');
+        const path = await import('node:path');
+        if (!fs.existsSync(workspaceRoot))
+            return '';
+        const entries = fs.readdirSync(workspaceRoot);
+        const topLevel = entries
+            .filter(e => !e.startsWith('.'))
+            .slice(0, 20)
+            .map(e => {
+            const fullPath = path.join(workspaceRoot, e);
+            const isDir = fs.statSync(fullPath).isDirectory();
+            if (isDir) {
+                const children = fs.readdirSync(fullPath).filter(c => !c.startsWith('.')).slice(0, 5);
+                return `${e}/: ${children.join(', ')}${children.length >= 5 ? '...' : ''}`;
+            }
+            return e;
+        });
+        return topLevel.join('\n');
+    }
+    catch {
+        return '';
+    }
+}
+// ============================================================================
+// Context Builder
+// ============================================================================
+export async function buildSystemContext(options = {}) {
+    const { workspaceRoot, includeWorkspaceMap = false, userLocation, userPreferences, fetchLocation = GEOLOCATION_ENABLED_DEFAULT, } = options;
+    const now = new Date();
+    const nodeInfo = await getNodeInfo();
+    // Optionally fetch location
+    let location = userLocation;
+    if (!location && fetchLocation) {
+        location = await fetchUserLocation();
+    }
+    const preferences = userPreferences;
+    const context = {
+        currentTime: now.toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit', hour12: true }),
+        currentDate: now.toLocaleDateString('en-US', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' }),
+        timezone: location?.timezone || Intl.DateTimeFormat().resolvedOptions().timeZone,
+        platform: nodeInfo.platform,
+        hostname: nodeInfo.hostname,
+        username: nodeInfo.username,
+        locale: getLocale(),
+        workspaceRoot,
+        userLocation: location,
+        userPreferences: preferences,
+    };
+    if (includeWorkspaceMap && workspaceRoot) {
+        context.workspaceMap = await generateWorkspaceMap(workspaceRoot);
+    }
+    return context;
+}
+// ============================================================================
+// Formatting
+// ============================================================================
+export function formatSystemContextBlock(context) {
+    const lines = [
+        '# Current Environment',
+        '',
+        `- **Date**: ${context.currentDate}`,
+        `- **Time**: ${context.currentTime} (${context.timezone})`,
+        `- **Locale**: ${context.locale}`,
+        `- **Platform**: ${context.platform}`,
+        `- **User**: ${context.username}`,
+    ];
+    // Location
+    if (context.userLocation) {
+        const loc = context.userLocation;
+        const locationParts = [loc.city, loc.region, loc.country].filter(Boolean);
+        if (locationParts.length > 0) {
+            lines.push(`- **Location**: ${locationParts.join(', ')}`);
+        }
+    }
+    // Workspace
+    if (context.workspaceRoot) {
+        lines.push(`- **Workspace**: ${context.workspaceRoot}`);
+    }
+    if (context.workspaceMap) {
+        lines.push('');
+        lines.push('## Workspace Structure');
+        lines.push('```');
+        lines.push(context.workspaceMap);
+        lines.push('```');
+    }
+    // User Preferences
+    if (context.userPreferences) {
+        const prefs = context.userPreferences;
+        lines.push('');
+        lines.push('## User Preferences');
+        if (prefs.name)
+            lines.push(`- **Name**: ${prefs.name}`);
+        if (prefs.language)
+            lines.push(`- **Preferred Language**: ${prefs.language}`);
+        if (prefs.communicationStyle)
+            lines.push(`- **Communication Style**: ${prefs.communicationStyle}`);
+        if (prefs.codeStyle) {
+            lines.push('- **Code Style**:');
+            if (prefs.codeStyle.indentation)
+                lines.push(`  - Indentation: ${prefs.codeStyle.indentation}`);
+            if (prefs.codeStyle.indentSize)
+                lines.push(`  - Indent Size: ${prefs.codeStyle.indentSize}`);
+            if (prefs.codeStyle.quoteStyle)
+                lines.push(`  - Quote Style: ${prefs.codeStyle.quoteStyle}`);
+        }
+        if (prefs.customPreferences && Object.keys(prefs.customPreferences).length > 0) {
+            for (const [key, value] of Object.entries(prefs.customPreferences)) {
+                lines.push(`- **${key}**: ${String(value)}`);
+            }
+        }
+    }
+    // Appended profile block (from memory system)
+    if (context.userProfileBlock) {
+        lines.push('');
+        lines.push(context.userProfileBlock);
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Convenience Function
+// ============================================================================
+export async function buildDynamicSystemPrompt(basePrompt, options = {}) {
+    const context = await buildSystemContext(options);
+    const contextBlock = formatSystemContextBlock(context);
+    return `${basePrompt}\n\n${contextBlock}`;
+}
+//# sourceMappingURL=context.js.map

package/dist/prompts/context.js.map

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

package/dist/prompts/template.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Template engine for variable substitution in prompts.
+ */
+interface TemplateContext {
+    [key: string]: string | number | boolean | undefined;
+}
+/**
+ * Apply template variables to a string.
+ * Replaces {{variableName}} with the value from context.
+ *
+ * @example
+ * applyTemplate('Hello {{name}}!', { name: 'World' })
+ * // => 'Hello World!'
+ */
+export declare function applyTemplate(template: string, context?: TemplateContext): string;
+export {};
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/prompts/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH,UAAU,eAAe;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CACtD;AAMD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAcrF"}

package/dist/prompts/template.js

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Template engine for variable substitution in prompts.
+ */
+import { createLogger } from '@agntk/logger';
+import { getConfig } from '../config/index.js';
+const log = createLogger('@agntk/core:templates');
+// ============================================================================
+// Template Engine
+// ============================================================================
+/**
+ * Apply template variables to a string.
+ * Replaces {{variableName}} with the value from context.
+ *
+ * @example
+ * applyTemplate('Hello {{name}}!', { name: 'World' })
+ * // => 'Hello World!'
+ */
+export function applyTemplate(template, context = {}) {
+    // Merge config variables with explicit context (explicit takes precedence)
+    const config = getConfig();
+    const configVars = config.templates;
+    const mergedContext = { ...configVars?.variables, ...context };
+    return template.replace(/\{\{(\w+)\}\}/g, (match, varName) => {
+        const value = mergedContext[varName];
+        if (value === undefined) {
+            log.debug('Template variable not found', { variable: varName });
+            return match; // Leave unreplaced if not found
+        }
+        return String(value);
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/prompts/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/prompts/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,GAAG,GAAG,YAAY,CAAC,uBAAuB,CAAC,CAAC;AAUlD,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,UAA2B,EAAE;IAC3E,2EAA2E;IAC3E,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAI,MAAkC,CAAC,SAAwD,CAAC;IAChH,MAAM,aAAa,GAAG,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC;IAE/D,OAAO,QAAQ,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,GAAG,CAAC,KAAK,CAAC,6BAA6B,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAChE,OAAO,KAAK,CAAC,CAAC,gCAAgC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/prompts/templates.d.ts

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

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

@@ -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/reflection.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @agntk/core - Reflection Strategies
+ *
+ * Implements reflection strategies that inject goal-state prompts between
+ * agent steps, improving multi-step task completion (+27.7% success in research).
+ *
+ * Uses the AI SDK's `prepareStep` hook to augment the system prompt with
+ * reflection instructions — no extra LLM calls required.
+ */
+import type { Tool, StepResult } from 'ai';
+/** Available reflection strategies. */
+export type ReflectionStrategy = 'none' | 'reflact' | 'periodic';
+/** Configuration for the reflection system. */
+export interface ReflectionConfig {
+    /** Which strategy to use. Default: 'none' */
+    strategy: ReflectionStrategy;
+    /** For 'periodic' strategy: reflect every N steps. Default: 3 */
+    frequency?: number;
+    /** Custom reflection prompt template. Uses {goal} placeholder. */
+    promptTemplate?: string;
+}
+/** Input to the prepareStep hook from the AI SDK. */
+export interface PrepareStepInput<TOOLS extends Record<string, Tool> = Record<string, Tool>> {
+    steps: Array<StepResult<TOOLS>>;
+    stepNumber: number;
+}
+/**
+ * Build a reflection prompt for the given step, or return undefined if
+ * no reflection should be injected at this step.
+ */
+export declare function buildReflectionPrompt(config: ReflectionConfig, stepNumber: number): string | undefined;
+/**
+ * Create a `prepareStep` function for the AI SDK that injects reflection
+ * prompts into the system message at appropriate steps.
+ *
+ * @param baseSystem - The original system prompt to augment.
+ * @param config - The reflection configuration.
+ * @returns A prepareStep function compatible with AI SDK's ToolLoopAgent.
+ */
+export declare function createReflectionPrepareStep<TOOLS extends Record<string, Tool> = Record<string, Tool>>(baseSystem: string, config: ReflectionConfig): (input: PrepareStepInput<TOOLS>) => {
+    system?: string;
+} | undefined;
+/**
+ * Estimate the token overhead of a reflection injection.
+ * Rough estimate: ~4 chars per token for English text.
+ */
+export declare function estimateReflectionTokens(config: ReflectionConfig): number;
+//# sourceMappingURL=reflection.d.ts.map

package/dist/reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection.d.ts","sourceRoot":"","sources":["../src/reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAM3C,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjE,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,QAAQ,EAAE,kBAAkB,CAAC;IAE7B,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qDAAqD;AACrD,MAAM,WAAW,gBAAgB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC;IACzF,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AA4BD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAqBpB;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EACnG,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,gBAAgB,GACvB,CAAC,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAerE;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAQzE"}

package/dist/reflection.js

@@ -0,0 +1,91 @@
+/**
+ * @agntk/core - Reflection Strategies
+ *
+ * Implements reflection strategies that inject goal-state prompts between
+ * agent steps, improving multi-step task completion (+27.7% success in research).
+ *
+ * Uses the AI SDK's `prepareStep` hook to augment the system prompt with
+ * reflection instructions — no extra LLM calls required.
+ */
+// ============================================================================
+// Defaults
+// ============================================================================
+const DEFAULT_FREQUENCY = 3;
+const DEFAULT_REFLACT_TEMPLATE = `<reflection>
+Before proceeding, reflect on your progress:
+1. What is the user's original goal?
+2. What have you accomplished so far?
+3. What is the most important next action to take?
+4. Are you on track, or do you need to adjust your approach?
+</reflection>`;
+const DEFAULT_PERIODIC_TEMPLATE = `<reflection>
+Checkpoint — pause and evaluate:
+1. Revisit the user's original request. Are you still aligned with their goal?
+2. Summarize what you have done so far.
+3. Identify any dead ends or wasted steps.
+4. Plan your next 2-3 actions to reach completion efficiently.
+</reflection>`;
+// ============================================================================
+// Reflection Builder
+// ============================================================================
+/**
+ * Build a reflection prompt for the given step, or return undefined if
+ * no reflection should be injected at this step.
+ */
+export function buildReflectionPrompt(config, stepNumber) {
+    const { strategy } = config;
+    if (strategy === 'none') {
+        return undefined;
+    }
+    if (strategy === 'reflact') {
+        // reflact: inject after every step except the first (step 0 = initial call)
+        if (stepNumber === 0)
+            return undefined;
+        return config.promptTemplate ?? DEFAULT_REFLACT_TEMPLATE;
+    }
+    if (strategy === 'periodic') {
+        const frequency = config.frequency ?? DEFAULT_FREQUENCY;
+        // Inject at step N, 2N, 3N... (never step 0)
+        if (stepNumber === 0 || stepNumber % frequency !== 0)
+            return undefined;
+        return config.promptTemplate ?? DEFAULT_PERIODIC_TEMPLATE;
+    }
+    return undefined;
+}
+/**
+ * Create a `prepareStep` function for the AI SDK that injects reflection
+ * prompts into the system message at appropriate steps.
+ *
+ * @param baseSystem - The original system prompt to augment.
+ * @param config - The reflection configuration.
+ * @returns A prepareStep function compatible with AI SDK's ToolLoopAgent.
+ */
+export function createReflectionPrepareStep(baseSystem, config) {
+    // If no reflection, return a no-op
+    if (config.strategy === 'none') {
+        return () => undefined;
+    }
+    return ({ stepNumber }) => {
+        const reflection = buildReflectionPrompt(config, stepNumber);
+        if (!reflection)
+            return undefined;
+        // Augment the system prompt with the reflection block
+        return {
+            system: `${baseSystem}\n\n${reflection}`,
+        };
+    };
+}
+/**
+ * Estimate the token overhead of a reflection injection.
+ * Rough estimate: ~4 chars per token for English text.
+ */
+export function estimateReflectionTokens(config) {
+    const template = config.strategy === 'reflact'
+        ? (config.promptTemplate ?? DEFAULT_REFLACT_TEMPLATE)
+        : config.strategy === 'periodic'
+            ? (config.promptTemplate ?? DEFAULT_PERIODIC_TEMPLATE)
+            : '';
+    // ~4 chars per token, rough estimate
+    return Math.ceil(template.length / 4);
+}
+//# sourceMappingURL=reflection.js.map

package/dist/reflection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflection.js","sourceRoot":"","sources":["../src/reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6BH,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B,MAAM,wBAAwB,GAAG;;;;;;cAMnB,CAAC;AAEf,MAAM,yBAAyB,GAAG;;;;;;cAMpB,CAAC;AAEf,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAwB,EACxB,UAAkB;IAElB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAE5B,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,4EAA4E;QAC5E,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACvC,OAAO,MAAM,CAAC,cAAc,IAAI,wBAAwB,CAAC;IAC3D,CAAC;IAED,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,iBAAiB,CAAC;QACxD,6CAA6C;QAC7C,IAAI,UAAU,KAAK,CAAC,IAAI,UAAU,GAAG,SAAS,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACvE,OAAO,MAAM,CAAC,cAAc,IAAI,yBAAyB,CAAC;IAC5D,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAkB,EAClB,MAAwB;IAExB,mCAAmC;IACnC,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QACxB,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU;YAAE,OAAO,SAAS,CAAC;QAElC,sDAAsD;QACtD,OAAO;YACL,MAAM,EAAE,GAAG,UAAU,OAAO,UAAU,EAAE;SACzC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAwB;IAC/D,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS;QAC5C,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,wBAAwB,CAAC;QACrD,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU;YAChC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,yBAAyB,CAAC;YACtD,CAAC,CAAC,EAAE,CAAC;IACP,qCAAqC;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC"}

package/dist/skills/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Skills module public API.
+ */
+export type { SkillMeta, SkillContent, SkillsConfig, SkillRequirements } from './types.js';
+export { type ParsedSkillFrontmatter, type SkillSearchResult, discoverSkills, loadSkillContent, loadSkills, loadSkillsFromPaths, parseSkillFrontmatter, buildSkillsSystemPrompt, searchSkills, filterEligibleSkills, isSkillEligible, } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Skills module public API.
+ */
+export { discoverSkills, loadSkillContent, loadSkills, loadSkillsFromPaths, parseSkillFrontmatter, buildSkillsSystemPrompt, searchSkills, filterEligibleSkills, isSkillEligible, } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAGL,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,oBAAoB,EACpB,eAAe,GAChB,MAAM,UAAU,CAAC"}

package/dist/skills/loader.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview Skills discovery and loading.
+ * Scans directories for SKILL.md files, parses YAML frontmatter,
+ * and builds system prompt injections.
+ */
+import type { SkillMeta, SkillContent, SkillsConfig, SkillRequirements } from './types.js';
+export interface ParsedSkillFrontmatter {
+    name?: string;
+    description?: string;
+    tags?: string[];
+    whenToUse?: string;
+    model?: 'fast' | 'standard' | 'reasoning' | 'powerful';
+    maxSteps?: number;
+    requires?: SkillRequirements;
+    license?: string;
+    compatibility?: string;
+    metadata?: Record<string, string>;
+    allowedTools?: string[];
+    toolsDeny?: string[];
+    extra?: Record<string, unknown>;
+    body: string;
+}
+/**
+ * Parse YAML frontmatter from a SKILL.md file.
+ * Accepts both native and skills.sh fields. Unknown fields are preserved in `extra`.
+ *
+ * Expects format:
+ * ---
+ * name: skill-name
+ * description: Short description
+ * license: MIT
+ * allowed-tools: [glob, grep, shell]
+ * ---
+ * ... markdown content ...
+ */
+export declare function parseSkillFrontmatter(content: string): ParsedSkillFrontmatter;
+/**
+ * Discover SKILL.md files in the given directories.
+ * Returns metadata for each discovered skill.
+ */
+export declare function discoverSkills(directories?: string[], basePath?: string): SkillMeta[];
+/**
+ * Load the full content of a skill, including the markdown body.
+ */
+export declare function loadSkillContent(meta: SkillMeta): SkillContent;
+/**
+ * Load skills based on configuration.
+ * Supports both explicit paths and auto-discovery.
+ */
+export declare function loadSkills(config: SkillsConfig, basePath?: string): SkillContent[];
+/**
+ * Load skills from explicit directory paths (each path IS the skill directory).
+ */
+export declare function loadSkillsFromPaths(paths: string[]): SkillContent[];
+/**
+ * Build a system prompt section from loaded skills.
+ * Injects skill descriptions and instructions for the LLM.
+ */
+export declare function buildSkillsSystemPrompt(skills: SkillContent[]): string;
+/** A skill search result with relevance score. */
+export interface SkillSearchResult {
+    skill: SkillMeta;
+    score: number;
+}
+/**
+ * Search skills by keyword against name, description, tags, and whenToUse.
+ * Returns top matches ranked by relevance score.
+ */
+export declare function searchSkills(skills: SkillMeta[], query: string, limit?: number): SkillSearchResult[];
+/**
+ * Filter skills to only those whose runtime requirements are met.
+ *
+ * Checks:
+ * - `requires.binaries`: each binary is found on PATH
+ * - `requires.env`: each env var is defined in process.env
+ *
+ * Skills with no requirements are always eligible.
+ */
+export declare function filterEligibleSkills(skills: SkillMeta[]): SkillMeta[];
+/**
+ * Check if a single skill's runtime requirements are met.
+ */
+export declare function isSkillEligible(skill: SkillMeta): boolean;
+//# sourceMappingURL=loader.d.ts.map