agentx-sdk 0.1.0

package/dist/core/message-normalize.js

@@ -0,0 +1,69 @@
+/**
+ * Message normalization for API submission.
+ *
+ * Ensures messages respect LLM API constraints:
+ * - tool_result must follow an assistant message with matching tool_calls
+ * - Orphaned tool results (no matching tool_call) are removed
+ * - Assistant messages with orphaned tool_calls (no matching result) get tool_calls stripped
+ * - Empty assistant messages without tool_calls are removed
+ *
+ * Ported from old_src/utils/messages.ts normalizeMessagesForAPI() — simplified for SDK.
+ */
+/**
+ * Normalize messages before sending to the LLM API.
+ * Removes orphaned tool results/calls and empty messages.
+ */
+export function normalizeMessagesForAPI(messages) {
+    if (messages.length === 0)
+        return [];
+    // Collect all tool_call IDs from assistant messages
+    const declaredToolCallIds = new Set();
+    for (const msg of messages) {
+        if (msg.role === 'assistant' && msg.tool_calls) {
+            for (const tc of msg.tool_calls) {
+                declaredToolCallIds.add(tc.id);
+            }
+        }
+    }
+    // Collect all tool_result IDs from tool messages
+    const presentToolResultIds = new Set();
+    for (const msg of messages) {
+        if (msg.role === 'tool' && msg.tool_call_id) {
+            presentToolResultIds.add(msg.tool_call_id);
+        }
+    }
+    const result = [];
+    for (const msg of messages) {
+        // Remove orphaned tool results (no matching tool_call in any assistant message)
+        if (msg.role === 'tool' && msg.tool_call_id) {
+            if (!declaredToolCallIds.has(msg.tool_call_id))
+                continue;
+        }
+        // Strip orphaned tool_calls from assistant (no matching tool result)
+        if (msg.role === 'assistant' && msg.tool_calls) {
+            const validCalls = msg.tool_calls.filter(tc => presentToolResultIds.has(tc.id));
+            if (validCalls.length === 0) {
+                // No valid tool_calls — keep as text-only if has content
+                if (msg.content && typeof msg.content === 'string' && msg.content.trim()) {
+                    result.push({ ...msg, tool_calls: undefined });
+                }
+                // Otherwise skip empty assistant with no valid tool_calls
+                continue;
+            }
+            if (validCalls.length < msg.tool_calls.length) {
+                // Partial: keep only valid tool_calls
+                result.push({ ...msg, tool_calls: validCalls });
+                continue;
+            }
+        }
+        // Remove empty assistant messages without tool_calls
+        if (msg.role === 'assistant' &&
+            !msg.tool_calls &&
+            (!msg.content || (typeof msg.content === 'string' && !msg.content.trim()))) {
+            continue;
+        }
+        result.push(msg);
+    }
+    return result;
+}
+//# sourceMappingURL=message-normalize.js.map

package/dist/core/message-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-normalize.js","sourceRoot":"","sources":["../../src/core/message-normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAsC;IAC5E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAErC,oDAAoD;IACpD,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC/C,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;gBAChC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YAC5C,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,gFAAgF;QAChF,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;YAC5C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC;gBAAE,SAAS;QAC3D,CAAC;QAED,qEAAqE;QACrE,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAChF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5B,yDAAyD;gBACzD,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;oBACzE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;gBACjD,CAAC;gBACD,0DAA0D;gBAC1D,SAAS;YACX,CAAC;YACD,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;gBAC9C,sCAAsC;gBACtC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;gBAChD,SAAS;YACX,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,IACE,GAAG,CAAC,IAAI,KAAK,WAAW;YACxB,CAAC,GAAG,CAAC,UAAU;YACf,CAAC,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,EAC1E,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/prompt-builders.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Prompt builders for tool usage guidance and environment info.
+ *
+ * These generate cognitive scaffolding that helps the LLM use tools
+ * effectively. Ported from old_src/constants/prompts.ts patterns,
+ * adapted for SDK context.
+ */
+import type { AgentTool } from '../contracts/entities/agent-tool.js';
+/**
+ * Build intelligent tool usage instructions for the model.
+ * Goes beyond a simple list — teaches the model WHEN and HOW to use tools,
+ * how to handle errors, and how to combine tools effectively.
+ */
+export declare function buildToolUsagePrompt(tools: AgentTool[]): string;
+export interface EnvironmentInfo {
+    /** Current working directory */
+    cwd?: string;
+    /** Operating system platform */
+    platform?: string;
+    /** Model being used */
+    model?: string;
+    /** Current date (ISO format) */
+    date?: string;
+    /** Whether this is a git repository */
+    isGitRepo?: boolean;
+    /** Git branch */
+    gitBranch?: string;
+    /** Additional custom context entries */
+    custom?: Record<string, string>;
+}
+/**
+ * Build environment information prompt for the model.
+ * Gives the LLM awareness of its execution context.
+ */
+export declare function buildEnvironmentPrompt(info: EnvironmentInfo): string;
+//# sourceMappingURL=prompt-builders.d.ts.map

package/dist/core/prompt-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builders.d.ts","sourceRoot":"","sources":["../../src/core/prompt-builders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAMrE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAsD/D;AAMD,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAmBpE"}

package/dist/core/prompt-builders.js

@@ -0,0 +1,89 @@
+/**
+ * Prompt builders for tool usage guidance and environment info.
+ *
+ * These generate cognitive scaffolding that helps the LLM use tools
+ * effectively. Ported from old_src/constants/prompts.ts patterns,
+ * adapted for SDK context.
+ */
+// ---------------------------------------------------------------------------
+// Tool usage prompt
+// ---------------------------------------------------------------------------
+/**
+ * Build intelligent tool usage instructions for the model.
+ * Goes beyond a simple list — teaches the model WHEN and HOW to use tools,
+ * how to handle errors, and how to combine tools effectively.
+ */
+export function buildToolUsagePrompt(tools) {
+    if (tools.length === 0)
+        return '';
+    const lines = [
+        '# Available Tools',
+        '',
+        'You have access to the following tools. Use them proactively when the user asks for data, actions, or analysis — do not describe what you would do, just do it.',
+        '',
+    ];
+    // Categorize tools
+    const destructive = [];
+    for (const tool of tools) {
+        const dest = typeof tool.isDestructive === 'function' ? false : tool.isDestructive === true;
+        if (dest)
+            destructive.push(tool);
+    }
+    // List all tools with descriptions
+    for (const tool of tools) {
+        lines.push(`- **${tool.name}**: ${tool.description}`);
+    }
+    lines.push('');
+    lines.push('## Tool Usage Guidelines');
+    lines.push('');
+    lines.push('- Call tools when you need data or need to perform actions — do not guess or make up answers when a tool can provide the real answer.');
+    lines.push('- If multiple independent pieces of information are needed, call multiple tools in parallel for efficiency.');
+    lines.push('- If one tool call depends on the result of another, call them sequentially.');
+    lines.push('- When a tool returns an error, analyze the error message and adjust your approach — do not retry the exact same call blindly.');
+    // Safety guidance for destructive tools
+    if (destructive.length > 0) {
+        lines.push('');
+        lines.push('## Caution: Destructive Tools');
+        lines.push('');
+        lines.push('The following tools perform irreversible operations. Use them carefully:');
+        for (const tool of destructive) {
+            lines.push(`- **${tool.name}** — confirm with the user before performing destructive actions unless explicitly instructed.`);
+        }
+    }
+    // Concurrency hints
+    const safeConcurrent = tools.filter(t => typeof t.isConcurrencySafe === 'function' ? false : t.isConcurrencySafe === true);
+    if (safeConcurrent.length > 0 && safeConcurrent.length < tools.length) {
+        lines.push('');
+        lines.push('## Concurrency');
+        lines.push('');
+        lines.push(`The following tools are safe to call in parallel: ${safeConcurrent.map(t => t.name).join(', ')}. Other tools should be called one at a time.`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Build environment information prompt for the model.
+ * Gives the LLM awareness of its execution context.
+ */
+export function buildEnvironmentPrompt(info) {
+    const lines = ['# Environment'];
+    if (info.cwd)
+        lines.push(`- Working directory: \`${info.cwd}\``);
+    if (info.platform)
+        lines.push(`- Platform: ${info.platform}`);
+    if (info.model)
+        lines.push(`- Model: ${info.model}`);
+    if (info.date)
+        lines.push(`- Date: ${info.date}`);
+    if (info.isGitRepo !== undefined) {
+        lines.push(`- Git repository: ${info.isGitRepo ? 'yes' : 'no'}`);
+        if (info.gitBranch)
+            lines.push(`- Branch: ${info.gitBranch}`);
+    }
+    if (info.custom) {
+        for (const [key, value] of Object.entries(info.custom)) {
+            lines.push(`- ${key}: ${value}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=prompt-builders.js.map

package/dist/core/prompt-builders.js.map

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

package/dist/core/prompt-cache.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Prompt section cache — avoids rebuilding identical sections every turn.
+ *
+ * Sections like memory instructions, tool listing, and environment info
+ * don't change between turns. Caching them avoids redundant computation
+ * and improves prompt cache hit rates on the API side.
+ */
+interface CachedSection {
+    content: string;
+    tokens: number;
+}
+export declare class PromptSectionCache {
+    private readonly cache;
+    /**
+     * Get a cached section or build it.
+     * Builder is only called on cache miss.
+     */
+    getOrBuild(key: string, builder: () => string): CachedSection;
+    /** Invalidate a specific section (forces rebuild on next getOrBuild). */
+    invalidate(key: string): void;
+    /** Clear all cached sections. */
+    clear(): void;
+}
+export {};
+//# sourceMappingURL=prompt-cache.d.ts.map

package/dist/core/prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../src/core/prompt-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAE1D;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,MAAM,GAAG,aAAa;IAW7D,yEAAyE;IACzE,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,iCAAiC;IACjC,KAAK,IAAI,IAAI;CAGd"}

package/dist/core/prompt-cache.js

@@ -0,0 +1,34 @@
+/**
+ * Prompt section cache — avoids rebuilding identical sections every turn.
+ *
+ * Sections like memory instructions, tool listing, and environment info
+ * don't change between turns. Caching them avoids redundant computation
+ * and improves prompt cache hit rates on the API side.
+ */
+import { estimateTokens } from '../utils/token-counter.js';
+export class PromptSectionCache {
+    cache = new Map();
+    /**
+     * Get a cached section or build it.
+     * Builder is only called on cache miss.
+     */
+    getOrBuild(key, builder) {
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        const content = builder();
+        const tokens = estimateTokens(content);
+        const entry = { content, tokens };
+        this.cache.set(key, entry);
+        return entry;
+    }
+    /** Invalidate a specific section (forces rebuild on next getOrBuild). */
+    invalidate(key) {
+        this.cache.delete(key);
+    }
+    /** Clear all cached sections. */
+    clear() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=prompt-cache.js.map

package/dist/core/prompt-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.js","sourceRoot":"","sources":["../../src/core/prompt-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAO3D,MAAM,OAAO,kBAAkB;IACZ,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE1D;;;OAGG;IACH,UAAU,CAAC,GAAW,EAAE,OAAqB;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yEAAyE;IACzE,UAAU,CAAC,GAAW;QACpB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,iCAAiC;IACjC,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/core/react-loop.d.ts

@@ -0,0 +1,43 @@
+import type { OpenRouterClient } from '../llm/openrouter-client.js';
+import type { ToolExecutor } from '../tools/tool-executor.js';
+import type { OpenRouterMessage } from '../llm/message-types.js';
+import type { AgentEvent } from '../contracts/entities/agent-event.js';
+import type { OnToolError } from '../contracts/enums/index.js';
+import type { Terminal } from './loop-types.js';
+import type { StopHook } from './stop-hooks.js';
+import type { LoopDeps } from './loop-deps.js';
+export interface TokenBudgetConfig {
+    total: number;
+    outputThreshold: number;
+}
+export interface ReactLoopConfig {
+    client: OpenRouterClient;
+    toolExecutor: ToolExecutor;
+    model: string;
+    maxIterations: number;
+    maxConsecutiveErrors: number;
+    onToolError: OnToolError;
+    costPolicy?: {
+        maxTokensPerExecution?: number;
+        onLimitReached: 'stop' | 'warn';
+    };
+    signal?: AbortSignal;
+    maxContextTokens?: number;
+    compactionThreshold?: number;
+    fallbackModel?: string;
+    maxOutputTokens?: number;
+    escalatedMaxOutputTokens?: number;
+    stopHooks?: StopHook[];
+    deps?: Partial<LoopDeps>;
+    tokenBudget?: TokenBudgetConfig;
+    /** Called after tool execution with file paths extracted from tool results.
+     *  Returns newly activated skill names (e.g., for conditional skill activation). */
+    onFilePathsTouched?: (paths: string[]) => string[];
+}
+/**
+ * ReAct loop as AsyncGenerator.
+ * Yields AgentEvent, returns Terminal.
+ * State is immutable — replaced atomically at each continue site.
+ */
+export declare function executeReactLoop(initialMessages: OpenRouterMessage[], config: ReactLoopConfig): AsyncGenerator<AgentEvent, Terminal>;
+//# sourceMappingURL=react-loop.d.ts.map

package/dist/core/react-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-loop.d.ts","sourceRoot":"","sources":["../../src/core/react-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,sCAAsC,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,QAAQ,EAAa,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAmB/C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,CAAC,EAAE;QACX,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC;KACjC,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAElC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;wFACoF;IACpF,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;CACpD;AAED;;;;GAIG;AACH,wBAAuB,gBAAgB,CACrC,eAAe,EAAE,iBAAiB,EAAE,EACpC,MAAM,EAAE,eAAe,GACtB,cAAc,CAAC,UAAU,EAAE,QAAQ,CAAC,CA2btC"}