open-agent-sdk 0.1.0-alpha.0

package/dist/agent/agent-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-definition.d.ts","sourceRoot":"","sources":["../../src/agent/agent-definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,CAAC;AAEtF;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,qBAAqB;IAChC,6DAA6D;;IAG7D,8DAA8D;;IAG9D,kCAAkC;;IAGlC,6DAA6D;;IAG7D,kEAAkE;;IAGlE,4DAA4D;;;;;;;;;;;;;;;;EAE5D,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,OAAO,GAAG,eAAe,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,OAAO,GAClB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAOlF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,eAAe,CAKjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAE5E"}

package/dist/agent/agent-definition.js

@@ -0,0 +1,90 @@
+/**
+ * AgentDefinition types and validation
+ * Aligned with Claude Agent SDK
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for AgentDefinition validation
+ */
+export const AgentDefinitionSchema = z.object({
+    /** Natural language description of when to use this agent */
+    description: z.string().min(1, 'description is required'),
+    /** List of allowed tools (omit to inherit all from parent) */
+    tools: z.array(z.string()).optional(),
+    /** System prompt for the agent */
+    prompt: z.string().min(1, 'prompt is required'),
+    /** Model to use ('inherit' or omit to use parent's model) */
+    model: z.enum(['sonnet', 'opus', 'haiku', 'inherit']).optional(),
+    /** Maximum turns for the agent (omit to use parent's maxTurns) */
+    maxTurns: z.number().int().positive().optional(),
+    /** Permission mode (omit to use parent's permissionMode) */
+    permissionMode: z.enum(['default', 'acceptEdits', 'bypassPermissions', 'plan']).optional(),
+});
+/**
+ * Validate an agent definition
+ * @param definition The definition to validate
+ * @returns The validated definition
+ * @throws ZodError if validation fails
+ */
+export function validateAgentDefinition(definition) {
+    return AgentDefinitionSchema.parse(definition);
+}
+/**
+ * Safely validate an agent definition
+ * @param definition The definition to validate
+ * @returns Object with success flag and data or error
+ */
+export function safeValidateAgentDefinition(definition) {
+    const result = AgentDefinitionSchema.safeParse(definition);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    else {
+        return { success: false, error: result.error };
+    }
+}
+/**
+ * Create a minimal agent definition with required fields
+ * @param description When to use this agent
+ * @param prompt System prompt for the agent
+ * @returns AgentDefinition with required fields
+ */
+export function createAgentDefinition(description, prompt) {
+    return {
+        description,
+        prompt,
+    };
+}
+/**
+ * Check if an agent definition has custom tools
+ * @param definition The agent definition
+ * @returns true if tools are explicitly defined
+ */
+export function hasCustomTools(definition) {
+    return definition.tools !== undefined;
+}
+/**
+ * Check if an agent definition inherits parent's model
+ * @param definition The agent definition
+ * @returns true if model is 'inherit' or undefined
+ */
+export function inheritsModel(definition) {
+    return definition.model === undefined || definition.model === 'inherit';
+}
+/**
+ * Check if an agent definition has custom maxTurns
+ * @param definition The agent definition
+ * @returns true if maxTurns is explicitly defined
+ */
+export function hasCustomMaxTurns(definition) {
+    return definition.maxTurns !== undefined;
+}
+/**
+ * Check if an agent definition has custom permission mode
+ * @param definition The agent definition
+ * @returns true if permissionMode is explicitly defined
+ */
+export function hasCustomPermissionMode(definition) {
+    return definition.permissionMode !== undefined;
+}
+//# sourceMappingURL=agent-definition.js.map

package/dist/agent/agent-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-definition.js","sourceRoot":"","sources":["../../src/agent/agent-definition.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,6DAA6D;IAC7D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,yBAAyB,CAAC;IAEzD,8DAA8D;IAC9D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAErC,kCAAkC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,oBAAoB,CAAC;IAE/C,6DAA6D;IAC7D,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IAEhE,kEAAkE;IAClE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEhD,4DAA4D;IAC5D,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC3F,CAAC,CAAC;AAcH;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAmB;IACzD,OAAO,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B,CACzC,UAAmB;IAEnB,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAmB,EACnB,MAAc;IAEd,OAAO;QACL,WAAW;QACX,MAAM;KACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,UAA2B;IACxD,OAAO,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,UAA2B;IACvD,OAAO,UAAU,CAAC,KAAK,KAAK,SAAS,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA2B;IAC3D,OAAO,UAAU,CAAC,QAAQ,KAAK,SAAS,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAA2B;IACjE,OAAO,UAAU,CAAC,cAAc,KAAK,SAAS,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,117 @@
+/**
+ * ReAct (Reasoning + Acting) loop implementation
+ * Core agent logic for tool use and reasoning
+ */
+import type { LLMProvider } from '../providers/base';
+import type { ToolRegistry } from '../tools/registry';
+import { type SDKMessage, type SDKAssistantMessage, type SDKToolResultMessage } from '../types/messages';
+import { HookManager } from '../hooks/manager';
+import type { HooksConfig } from '../hooks/types';
+import { PermissionManager } from '../permissions/manager';
+import type { PermissionMode, CanUseTool } from '../permissions/types';
+export interface ReActLoopConfig {
+    maxTurns: number;
+    systemPrompt?: string;
+    allowedTools?: string[];
+    cwd?: string;
+    env?: Record<string, string>;
+    abortController?: AbortController;
+    apiKeySource?: 'env' | 'keychain' | 'custom';
+    /** Permission mode for tool execution (default: 'default') */
+    permissionMode?: PermissionMode;
+    /** Required to be true when using bypassPermissions mode */
+    allowDangerouslySkipPermissions?: boolean;
+    /** Custom callback for tool permission checks */
+    canUseTool?: CanUseTool;
+    /** MCP servers configuration */
+    mcpServers?: Record<string, unknown>;
+    /** Hooks manager or config */
+    hooks?: HookManager | HooksConfig;
+    /** Auto-compact threshold (token count), undefined means no auto-compaction */
+    autoCompactThreshold?: number;
+    /** Number of recent conversation rounds to preserve during compaction (default: 2) */
+    preserveRecentRounds?: number;
+}
+export interface ReActResult {
+    result: string;
+    messages: SDKMessage[];
+    turnCount: number;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+    /** Whether the execution resulted in an error or was aborted */
+    isError?: boolean;
+}
+/** Stream event types for ReActLoop.runStream() */
+export type ReActStreamEvent = {
+    type: 'assistant';
+    message: SDKAssistantMessage;
+} | {
+    type: 'tool_result';
+    message: SDKToolResultMessage;
+} | {
+    type: 'usage';
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+} | {
+    type: 'done';
+    result: string;
+};
+export declare class ReActLoop {
+    private provider;
+    private toolRegistry;
+    private config;
+    private sessionId;
+    private hookManager;
+    private permissionManager;
+    constructor(provider: LLMProvider, toolRegistry: ToolRegistry, config: ReActLoopConfig, sessionId?: string);
+    /**
+     * Get the permission manager instance
+     * Used for testing and inspection
+     */
+    getPermissionManager(): PermissionManager;
+    run(userPrompt: string): Promise<ReActResult>;
+    /**
+     * Run the ReAct loop with streaming output
+     * Yields events for assistant messages, tool results, usage stats, and completion
+     * @param userPrompt - The current user message content
+     * @param history - Previous conversation messages (optional)
+     */
+    runStream(userPrompt: string, history?: SDKMessage[]): AsyncGenerator<ReActStreamEvent>;
+    /**
+     * Get the hook manager instance
+     * Used for testing and inspection
+     */
+    getHookManager(): HookManager;
+    /**
+     * Compact conversation history to reduce token usage.
+     * Generates a summary of older messages and preserves recent rounds.
+     *
+     * @param messages - Current conversation messages
+     * @param trigger - What triggered the compaction ('manual' or 'auto')
+     * @param preTokens - Token count before compaction
+     * @returns Compacted messages and metadata
+     */
+    compact(messages: SDKMessage[], trigger: 'manual' | 'auto', preTokens: number): Promise<{
+        messages: SDKMessage[];
+        preTokens: number;
+        trigger: 'manual' | 'auto';
+        preservedRounds: number;
+        summaryGenerated: boolean;
+    }>;
+    /**
+     * Generate a summary of conversation messages using the LLM.
+     */
+    private generateSummary;
+    /**
+     * Emit the Stop hook and check if any handler requests continuation.
+     * Returns true if the loop should continue (hook returned { continue: true }).
+     */
+    private emitStopHook;
+    private callLLM;
+    private executeTool;
+}
+//# sourceMappingURL=react-loop.d.ts.map

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

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