@roackb2/heddle 0.0.2

package/dist/src/cli/useChatRunState.js

@@ -0,0 +1,118 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { useInput } from 'ink';
+const WORKING_FRAMES = ['.', '..', '...'];
+export function useChatRunState(nextLocalId) {
+    const [status, setStatus] = useState('Idle');
+    const [isRunning, setIsRunning] = useState(false);
+    const [error, setError] = useState();
+    const [liveEvents, setLiveEvents] = useState([]);
+    const [workingFrame, setWorkingFrame] = useState(0);
+    const [elapsedSeconds, setElapsedSeconds] = useState(0);
+    const [pendingApproval, setPendingApproval] = useState();
+    const [approvalChoice, setApprovalChoice] = useState('approve');
+    const [interruptRequested, setInterruptRequested] = useState(false);
+    const interruptRequestedRef = useRef(false);
+    const abortControllerRef = useRef(undefined);
+    useInput((input, key) => {
+        if (!pendingApproval) {
+            if (isRunning && key.escape) {
+                interruptRequestedRef.current = true;
+                setInterruptRequested(true);
+                abortControllerRef.current?.abort();
+            }
+            return;
+        }
+        if (key.leftArrow || key.upArrow || key.tab) {
+            setApprovalChoice('approve');
+            return;
+        }
+        if (key.rightArrow || key.downArrow) {
+            setApprovalChoice('deny');
+            return;
+        }
+        if (key.return) {
+            const approved = approvalChoice === 'approve';
+            pendingApproval.resolve({
+                approved,
+                reason: approved ? 'Approved in chat UI' : 'Denied in chat UI',
+            });
+            setPendingApproval(undefined);
+            setApprovalChoice('approve');
+            return;
+        }
+        const normalized = input.toLowerCase();
+        if (normalized === 'y') {
+            setApprovalChoice('approve');
+            return;
+        }
+        if (normalized === 'n') {
+            setApprovalChoice('deny');
+            return;
+        }
+        if (key.escape) {
+            pendingApproval.resolve({ approved: false, reason: 'Denied in chat UI' });
+            setPendingApproval(undefined);
+            setApprovalChoice('approve');
+        }
+    }, { isActive: Boolean(pendingApproval) || isRunning });
+    useEffect(() => {
+        if (!isRunning) {
+            setWorkingFrame(0);
+            setElapsedSeconds(0);
+            return;
+        }
+        const startedAt = Date.now();
+        const timer = setInterval(() => {
+            setWorkingFrame((current) => (current + 1) % WORKING_FRAMES.length);
+            setElapsedSeconds(Math.floor((Date.now() - startedAt) / 1000));
+        }, 300);
+        return () => clearInterval(timer);
+    }, [isRunning]);
+    const resetRunState = (options) => {
+        if (options?.abortInFlight) {
+            abortControllerRef.current?.abort();
+        }
+        setStatus('Idle');
+        if (options?.clearError !== false) {
+            setError(undefined);
+        }
+        setLiveEvents([]);
+        setPendingApproval(undefined);
+        setApprovalChoice('approve');
+        setInterruptRequested(false);
+        interruptRequestedRef.current = false;
+        abortControllerRef.current = undefined;
+        setIsRunning(false);
+    };
+    const actionState = useMemo(() => ({
+        isRunning,
+        nextLocalId,
+        setError,
+        setStatus,
+        setIsRunning,
+        setInterruptRequested,
+        setLiveEvents,
+        setPendingApproval,
+        setApprovalChoice,
+        interruptRequestedRef,
+        abortControllerRef,
+    }), [isRunning, nextLocalId]);
+    return {
+        status,
+        setStatus,
+        isRunning,
+        error,
+        setError,
+        liveEvents,
+        workingFrame,
+        elapsedSeconds,
+        pendingApproval,
+        approvalChoice,
+        interruptRequested,
+        setLiveEvents,
+        resetRunState,
+        actionState,
+        workingFrames: WORKING_FRAMES,
+    };
+}
+//# sourceMappingURL=useChatRunState.js.map

package/dist/src/cli/useChatRunState.js.map

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

package/dist/src/cli/useChatSessions.d.ts

@@ -0,0 +1,21 @@
+import type { ChatSession } from './chat-types.js';
+type UseChatSessionsArgs = {
+    sessionsFile: string;
+    apiKeyPresent: boolean;
+};
+export declare function useChatSessions({ sessionsFile, apiKeyPresent }: UseChatSessionsArgs): {
+    sessions: ChatSession[];
+    activeSessionId: string;
+    setActiveSessionId: import("react").Dispatch<import("react").SetStateAction<string>>;
+    activeSession: ChatSession;
+    recentSessions: ChatSession[];
+    activeSessionSummary: string | undefined;
+    listRecentSessionsMessage: string[];
+    updateSessionById: (sessionId: string, updater: (session: ChatSession) => ChatSession) => void;
+    updateActiveSession: (updater: (session: ChatSession) => ChatSession) => void;
+    createSession: (name?: string) => ChatSession;
+    renameSession: (name: string) => void;
+    removeSession: (id: string) => boolean;
+};
+export {};
+//# sourceMappingURL=useChatSessions.d.ts.map

package/dist/src/cli/useChatSessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatSessions.d.ts","sourceRoot":"","sources":["../../../src/cli/useChatSessions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAUnD,KAAK,mBAAmB,GAAG;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,wBAAgB,eAAe,CAAC,EAAE,YAAY,EAAE,aAAa,EAAE,EAAE,mBAAmB;;;;;;;;mCA0D5C,MAAM,WAAW,CAAC,OAAO,EAAE,WAAW,KAAK,WAAW;mCAItD,CAAC,OAAO,EAAE,WAAW,KAAK,WAAW;2BAI7C,MAAM;0BAYP,MAAM;wBAIR,MAAM;EAwClC"}

package/dist/src/cli/useChatSessions.js

@@ -0,0 +1,111 @@
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { createChatSession, isGenericSessionName, loadChatSessions, saveChatSessions, summarizeSession, touchSession, } from './chat-storage.js';
+export function useChatSessions({ sessionsFile, apiKeyPresent }) {
+    const initialSessionsRef = useRef(undefined);
+    if (!initialSessionsRef.current) {
+        initialSessionsRef.current = loadChatSessions(sessionsFile, apiKeyPresent);
+    }
+    const nextSessionNumberRef = useRef(getNextSessionNumber(initialSessionsRef.current));
+    const [sessions, setSessions] = useState(initialSessionsRef.current);
+    const [activeSessionId, setActiveSessionId] = useState(initialSessionsRef.current[0]?.id ?? 'session-1');
+    useEffect(() => {
+        saveChatSessions(sessionsFile, sessions);
+    }, [sessionsFile, sessions]);
+    useEffect(() => {
+        if (!sessions.some((session) => session.id === activeSessionId) && sessions[0]) {
+            setActiveSessionId(sessions[0].id);
+        }
+    }, [activeSessionId, sessions]);
+    useEffect(() => {
+        if (sessions.length > 0) {
+            return;
+        }
+        const fallback = createChatSession({
+            id: 'session-1',
+            name: 'Session 1',
+            apiKeyPresent,
+        });
+        setSessions([fallback]);
+        setActiveSessionId(fallback.id);
+    }, [apiKeyPresent, sessions]);
+    const activeSession = useMemo(() => sessions.find((session) => session.id === activeSessionId) ?? sessions[0], [activeSessionId, sessions]);
+    const recentSessions = useMemo(() => [...sessions].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt)).slice(0, 8), [sessions]);
+    const activeSessionSummary = activeSession ? summarizeSession(activeSession) : undefined;
+    const listRecentSessionsMessage = recentSessions.length > 0 ?
+        [
+            'Recent sessions:',
+            ...recentSessions.map((session, index) => `${session.id === activeSessionId ? '*' : `${index + 1}.`} ${session.id} (${session.name})`),
+            '',
+            'Use /session switch <id> to jump to one, or /session continue <id> to switch and resume immediately.',
+        ]
+        : ['No saved sessions yet.'];
+    const updateSessionById = (sessionId, updater) => {
+        setSessions((current) => current.map((session) => (session.id === sessionId ? touchSession(updater(session)) : session)));
+    };
+    const updateActiveSession = (updater) => {
+        updateSessionById(activeSessionId, updater);
+    };
+    const createSession = (name) => {
+        const id = `session-${Date.now()}`;
+        const nextSession = createChatSession({
+            id,
+            name: name?.trim() || `Session ${nextSessionNumberRef.current++}`,
+            apiKeyPresent,
+        });
+        setSessions((current) => [touchSession(nextSession), ...current].slice(0, 24));
+        setActiveSessionId(id);
+        return nextSession;
+    };
+    const renameSession = (name) => {
+        updateActiveSession((session) => ({ ...session, name }));
+    };
+    const removeSession = (id) => {
+        const removedActive = id === activeSessionId;
+        const nextActiveSessionId = sessions.find((session) => session.id !== id)?.id ?? 'session-1';
+        setSessions((current) => {
+            const remaining = current.filter((session) => session.id !== id);
+            if (remaining.length > 0) {
+                return remaining;
+            }
+            return [
+                createChatSession({
+                    id: 'session-1',
+                    name: 'Session 1',
+                    apiKeyPresent,
+                }),
+            ];
+        });
+        if (removedActive) {
+            setActiveSessionId(nextActiveSessionId);
+        }
+        return removedActive;
+    };
+    return {
+        sessions,
+        activeSessionId,
+        setActiveSessionId,
+        activeSession,
+        recentSessions,
+        activeSessionSummary,
+        listRecentSessionsMessage,
+        updateSessionById,
+        updateActiveSession,
+        createSession,
+        renameSession,
+        removeSession,
+    };
+}
+function getNextSessionNumber(sessions) {
+    const highestGenericNumber = sessions.reduce((highest, session) => {
+        if (!isGenericSessionName(session.name)) {
+            return highest;
+        }
+        const parsed = Number.parseInt(session.name.replace(/^Session\s+/, ''), 10);
+        if (!Number.isFinite(parsed)) {
+            return highest;
+        }
+        return Math.max(highest, parsed);
+    }, 0);
+    return highestGenericNumber + 1;
+}
+//# sourceMappingURL=useChatSessions.js.map

package/dist/src/cli/useChatSessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChatSessions.js","sourceRoot":"","sources":["../../../src/cli/useChatSessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAO3B,MAAM,UAAU,eAAe,CAAC,EAAE,YAAY,EAAE,aAAa,EAAuB;IAClF,MAAM,kBAAkB,GAAG,MAAM,CAA4B,SAAS,CAAC,CAAC;IACxE,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;QAChC,kBAAkB,CAAC,OAAO,GAAG,gBAAgB,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACpF,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,QAAQ,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,WAAW,CAAC,CAAC;IAEzG,SAAS,CAAC,GAAG,EAAE;QACb,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,eAAe,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEhC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC;YACjC,EAAE,EAAE,WAAW;YACf,IAAI,EAAE,WAAW;YACjB,aAAa;SACd,CAAC,CAAC;QACH,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC,EAAE,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE9B,MAAM,aAAa,GAAG,OAAO,CAC3B,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,eAAe,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,EAC/E,CAAC,eAAe,EAAE,QAAQ,CAAC,CAC5B,CAAC;IAEF,MAAM,cAAc,GAAG,OAAO,CAC5B,GAAG,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EACpG,CAAC,QAAQ,CAAC,CACX,CAAC;IAEF,MAAM,oBAAoB,GAAG,aAAa,CAAC,CAAC,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,MAAM,yBAAyB,GAC7B,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzB;YACE,kBAAkB;YAClB,GAAG,cAAc,CAAC,GAAG,CACnB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CACjB,GAAG,OAAO,CAAC,EAAE,KAAK,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,GAAG,CAC9F;YACD,EAAE;YACF,sGAAsG;SACvG;QACH,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC;IAE/B,MAAM,iBAAiB,GAAG,CAAC,SAAiB,EAAE,OAA8C,EAAE,EAAE;QAC9F,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5H,CAAC,CAAC;IAEF,MAAM,mBAAmB,GAAG,CAAC,OAA8C,EAAE,EAAE;QAC7E,iBAAiB,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,IAAa,EAAE,EAAE;QACtC,MAAM,EAAE,GAAG,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,iBAAiB,CAAC;YACpC,EAAE;YACF,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,WAAW,oBAAoB,CAAC,OAAO,EAAE,EAAE;YACjE,aAAa;SACd,CAAC,CAAC;QACH,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/E,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE;QACrC,mBAAmB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,EAAU,EAAE,EAAE;QACnC,MAAM,aAAa,GAAG,EAAE,KAAK,eAAe,CAAC;QAC7C,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,IAAI,WAAW,CAAC;QAE7F,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO;gBACL,iBAAiB,CAAC;oBAChB,EAAE,EAAE,WAAW;oBACf,IAAI,EAAE,WAAW;oBACjB,aAAa;iBACd,CAAC;aACH,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,IAAI,aAAa,EAAE,CAAC;YAClB,kBAAkB,CAAC,mBAAmB,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,aAAa,CAAC;IACvB,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ;QACR,eAAe;QACf,kBAAkB;QAClB,aAAa;QACb,cAAc;QACd,oBAAoB;QACpB,yBAAyB;QACzB,iBAAiB;QACjB,mBAAmB;QACnB,aAAa;QACb,aAAa;QACb,aAAa;KACd,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,QAAuB;IACnD,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;QAChE,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEN,OAAO,oBAAoB,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,4 @@
+export declare const DEFAULT_LLM_PROVIDER = "openai";
+export declare const DEFAULT_OPENAI_MODEL = "gpt-5.1-codex";
+export declare const DEFAULT_ANTHROPIC_MODEL = "claude-sonnet-4-6";
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAC7C,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,uBAAuB,sBAAsB,CAAC"}

package/dist/src/config.js

@@ -0,0 +1,7 @@
+// ---------------------------------------------------------------------------
+// Shared runtime configuration
+// ---------------------------------------------------------------------------
+export const DEFAULT_LLM_PROVIDER = 'openai';
+export const DEFAULT_OPENAI_MODEL = 'gpt-5.1-codex';
+export const DEFAULT_ANTHROPIC_MODEL = 'claude-sonnet-4-6';
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAC7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,mBAAmB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,36 @@
+export { runAgent } from './run-agent.js';
+export type { RunAgentOptions } from './run-agent.js';
+export { DEFAULT_OPENAI_MODEL, DEFAULT_ANTHROPIC_MODEL } from './config.js';
+export type { RunInput, RunResult, ToolDefinition, ToolCall, ToolResult, TraceEvent, StopReason, } from './types.js';
+export type { LlmAdapter, ChatMessage, LlmResponse, LlmProvider, LlmAdapterCapabilities, LlmAdapterInfo, LlmUsage, } from './llm/types.js';
+export { createLlmAdapter, inferProviderFromModel, resolveLlmProvider } from './llm/factory.js';
+export type { CreateLlmAdapterOptions } from './llm/factory.js';
+export { createOpenAiAdapter } from './llm/openai.js';
+export type { OpenAiAdapterOptions } from './llm/openai.js';
+export { createAnthropicAdapter } from './llm/anthropic.js';
+export type { AnthropicAdapterOptions } from './llm/anthropic.js';
+export { OPENAI_MODEL_GROUPS, COMMON_OPENAI_MODELS, COMMON_BUILT_IN_MODELS, formatOpenAiModelGroups, formatBuiltInModelGroups, estimateOpenAiContextWindow, estimateBuiltInContextWindow, filterBuiltInModels, } from './llm/openai-models.js';
+export type { BuiltInModelGroup } from './llm/openai-models.js';
+export { createToolRegistry } from './tools/registry.js';
+export type { ToolRegistry } from './tools/registry.js';
+export { executeTool } from './tools/execute-tool.js';
+export { listFilesTool } from './tools/list-files.js';
+export { readFileTool } from './tools/read-file.js';
+export { editFileTool } from './tools/edit-file.js';
+export { searchFilesTool, createSearchFilesTool, DEFAULT_SEARCH_EXCLUDED_DIRS } from './tools/search-files.js';
+export type { SearchFilesOptions } from './tools/search-files.js';
+export { reportStateTool } from './tools/report-state.js';
+export { updatePlanTool } from './tools/update-plan.js';
+export type { PlanItem, PlanItemStatus } from './tools/update-plan.js';
+export { createRunShellInspectTool, createRunShellMutateTool } from './tools/run-shell.js';
+export { createRunShellTool } from './tools/run-shell.js';
+export type { RunShellOptions } from './tools/run-shell.js';
+export { createTraceRecorder } from './trace/recorder.js';
+export type { TraceRecorder } from './trace/recorder.js';
+export { formatTraceForConsole } from './trace/format.js';
+export { buildSystemPrompt } from './prompts/system-prompt.js';
+export { createBudget } from './utils/budget.js';
+export type { Budget } from './utils/budget.js';
+export { HeddleError, ToolExecutionError, LlmError, BudgetExhaustedError } from './utils/errors.js';
+export { createLogger, logger } from './utils/logger.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG5E,YAAY,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,QAAQ,GACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAChG,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAC/G,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAG1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,31 @@
+// ---------------------------------------------------------------------------
+// Heddle — Public API
+// ---------------------------------------------------------------------------
+// Core loop
+export { runAgent } from './run-agent.js';
+export { DEFAULT_OPENAI_MODEL, DEFAULT_ANTHROPIC_MODEL } from './config.js';
+export { createLlmAdapter, inferProviderFromModel, resolveLlmProvider } from './llm/factory.js';
+export { createOpenAiAdapter } from './llm/openai.js';
+export { createAnthropicAdapter } from './llm/anthropic.js';
+export { OPENAI_MODEL_GROUPS, COMMON_OPENAI_MODELS, COMMON_BUILT_IN_MODELS, formatOpenAiModelGroups, formatBuiltInModelGroups, estimateOpenAiContextWindow, estimateBuiltInContextWindow, filterBuiltInModels, } from './llm/openai-models.js';
+// Tools
+export { createToolRegistry } from './tools/registry.js';
+export { executeTool } from './tools/execute-tool.js';
+export { listFilesTool } from './tools/list-files.js';
+export { readFileTool } from './tools/read-file.js';
+export { editFileTool } from './tools/edit-file.js';
+export { searchFilesTool, createSearchFilesTool, DEFAULT_SEARCH_EXCLUDED_DIRS } from './tools/search-files.js';
+export { reportStateTool } from './tools/report-state.js';
+export { updatePlanTool } from './tools/update-plan.js';
+export { createRunShellInspectTool, createRunShellMutateTool } from './tools/run-shell.js';
+export { createRunShellTool } from './tools/run-shell.js';
+// Trace
+export { createTraceRecorder } from './trace/recorder.js';
+export { formatTraceForConsole } from './trace/format.js';
+// Prompts
+export { buildSystemPrompt } from './prompts/system-prompt.js';
+// Utils
+export { createBudget } from './utils/budget.js';
+export { HeddleError, ToolExecutionError, LlmError, BudgetExhaustedError } from './utils/errors.js';
+export { createLogger, logger } from './utils/logger.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAuB5E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEhG,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAGhC,QAAQ;AACR,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAE/G,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,QAAQ;AACR,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,QAAQ;AACR,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/llm/anthropic.d.ts

@@ -0,0 +1,7 @@
+import type { LlmAdapter } from './types.js';
+export type AnthropicAdapterOptions = {
+    apiKey?: string;
+    model?: string;
+};
+export declare function createAnthropicAdapter(options?: AnthropicAdapterOptions): LlmAdapter;
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/src/llm/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../../src/llm/anthropic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAA8D,MAAM,YAAY,CAAC;AAIzG,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CA2DxF"}

package/dist/src/llm/anthropic.js

@@ -0,0 +1,115 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { DEFAULT_ANTHROPIC_MODEL } from '../config.js';
+export function createAnthropicAdapter(options = {}) {
+    const client = new Anthropic({
+        apiKey: firstDefinedNonEmpty(options.apiKey, process.env.ANTHROPIC_API_KEY, process.env.PERSONAL_ANTHROPIC_API_KEY),
+    });
+    const model = options.model ?? DEFAULT_ANTHROPIC_MODEL;
+    const capabilities = {
+        toolCalls: true,
+        systemMessages: true,
+        reasoningSummaries: false,
+        parallelToolCalls: false,
+    };
+    return {
+        info: {
+            provider: 'anthropic',
+            model,
+            capabilities,
+        },
+        async chat(messages, tools, signal) {
+            const system = messages
+                .filter((message) => message.role === 'system')
+                .map((message) => message.content)
+                .join('\n\n');
+            const anthropicMessages = toAnthropicMessages(messages);
+            const response = await client.messages.create({
+                model,
+                system: system || undefined,
+                messages: anthropicMessages,
+                tools: tools.length > 0 ? tools.map(toAnthropicTool) : undefined,
+                max_tokens: 4096,
+            }, { signal });
+            const text = response.content
+                .flatMap((block) => (block.type === 'text' ? [block.text] : []))
+                .join('')
+                .trim();
+            const toolCalls = response.content.flatMap((block) => {
+                if (block.type !== 'tool_use') {
+                    return [];
+                }
+                return [{
+                        id: block.id,
+                        tool: block.name,
+                        input: block.input,
+                    }];
+            });
+            return {
+                content: text || undefined,
+                toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+                usage: extractUsage(response.usage),
+            };
+        },
+    };
+}
+function firstDefinedNonEmpty(...values) {
+    return values.find((value) => typeof value === 'string' && value.trim().length > 0);
+}
+function toAnthropicMessages(messages) {
+    const result = [];
+    for (const message of messages) {
+        switch (message.role) {
+            case 'system':
+                break;
+            case 'user':
+                result.push({ role: 'user', content: message.content });
+                break;
+            case 'assistant': {
+                const content = [];
+                if (message.content) {
+                    content.push({ type: 'text', text: message.content });
+                }
+                for (const call of message.toolCalls ?? []) {
+                    content.push({
+                        type: 'tool_use',
+                        id: call.id,
+                        name: call.tool,
+                        input: call.input,
+                    });
+                }
+                result.push({ role: 'assistant', content });
+                break;
+            }
+            case 'tool':
+                result.push({
+                    role: 'user',
+                    content: [{
+                            type: 'tool_result',
+                            tool_use_id: message.toolCallId,
+                            content: message.content,
+                        }],
+                });
+                break;
+        }
+    }
+    return result;
+}
+function toAnthropicTool(tool) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.parameters,
+    };
+}
+function extractUsage(usage) {
+    if (!usage) {
+        return undefined;
+    }
+    return {
+        inputTokens: usage.input_tokens,
+        outputTokens: usage.output_tokens,
+        totalTokens: usage.input_tokens + usage.output_tokens,
+        requests: 1,
+    };
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/src/llm/anthropic.js.map

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

package/dist/src/llm/factory.d.ts

@@ -0,0 +1,10 @@
+import type { LlmAdapter, LlmProvider } from './types.js';
+export type CreateLlmAdapterOptions = {
+    provider?: LlmProvider;
+    model?: string;
+    apiKey?: string;
+};
+export declare function createLlmAdapter(options?: CreateLlmAdapterOptions): LlmAdapter;
+export declare function resolveLlmProvider(options?: CreateLlmAdapterOptions): LlmProvider;
+export declare function inferProviderFromModel(model: string): LlmProvider;
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/llm/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/llm/factory.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,UAAU,CAmBlF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,uBAA4B,GAAG,WAAW,CAUrF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAyBjE"}

package/dist/src/llm/factory.js

@@ -0,0 +1,53 @@
+// ---------------------------------------------------------------------------
+// LLM Adapter Factory
+// Provider-neutral adapter selection and capability metadata.
+// ---------------------------------------------------------------------------
+import { DEFAULT_ANTHROPIC_MODEL, DEFAULT_LLM_PROVIDER, DEFAULT_OPENAI_MODEL } from '../config.js';
+import { createAnthropicAdapter } from './anthropic.js';
+import { createOpenAiAdapter } from './openai.js';
+export function createLlmAdapter(options = {}) {
+    const provider = resolveLlmProvider(options);
+    switch (provider) {
+        case 'openai':
+            return createOpenAiAdapter({
+                apiKey: options.apiKey,
+                model: options.model ?? DEFAULT_OPENAI_MODEL,
+            });
+        case 'anthropic':
+            return createAnthropicAdapter({
+                apiKey: options.apiKey,
+                model: options.model ?? DEFAULT_ANTHROPIC_MODEL,
+            });
+        case 'google':
+            throw new Error(`Model provider "google" is not wired yet. Add a Gemini adapter before using model ${JSON.stringify(options.model ?? 'gemini')}.`);
+    }
+}
+export function resolveLlmProvider(options = {}) {
+    if (options.provider) {
+        return options.provider;
+    }
+    if (options.model) {
+        return inferProviderFromModel(options.model);
+    }
+    return DEFAULT_LLM_PROVIDER;
+}
+export function inferProviderFromModel(model) {
+    const normalized = model.trim().toLowerCase();
+    if (!normalized) {
+        return DEFAULT_LLM_PROVIDER;
+    }
+    if (normalized.startsWith('gpt-') ||
+        normalized.startsWith('o1') ||
+        normalized.startsWith('o3') ||
+        normalized.startsWith('o4')) {
+        return 'openai';
+    }
+    if (normalized.startsWith('claude')) {
+        return 'anthropic';
+    }
+    if (normalized.startsWith('gemini')) {
+        return 'google';
+    }
+    return DEFAULT_LLM_PROVIDER;
+}
+//# sourceMappingURL=factory.js.map

package/dist/src/llm/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/llm/factory.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,sBAAsB;AACtB,8DAA8D;AAC9D,8EAA8E;AAE9E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASlD,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,QAAQ,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE7C,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,mBAAmB,CAAC;gBACzB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,oBAAoB;aAC7C,CAAC,CAAC;QACL,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,uBAAuB;aAChD,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,MAAM,IAAI,KAAK,CACb,qFAAqF,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,GAAG,CAClI,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAmC,EAAE;IACtE,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,OAAO,CAAC,QAAQ,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE9C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IACE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;QAC7B,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3B,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3B,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAC3B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/src/llm/openai-models.d.ts

@@ -0,0 +1,15 @@
+export type BuiltInModelGroup = {
+    label: string;
+    models: string[];
+};
+export declare const BUILT_IN_MODEL_GROUPS: BuiltInModelGroup[];
+export declare const OPENAI_MODEL_GROUPS: BuiltInModelGroup[];
+export declare const COMMON_BUILT_IN_MODELS: string[];
+export declare const COMMON_OPENAI_MODELS: string[];
+export declare function formatOpenAiModelGroups(): string;
+export declare function formatBuiltInModelGroups(): string;
+export declare function filterOpenAiModels(query: string): string[];
+export declare function filterBuiltInModels(query: string): string[];
+export declare function estimateOpenAiContextWindow(model: string): number | undefined;
+export declare function estimateBuiltInContextWindow(model: string): number | undefined;
+//# sourceMappingURL=openai-models.d.ts.map

package/dist/src/llm/openai-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-models.d.ts","sourceRoot":"","sources":["../../../src/llm/openai-models.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EAyCpD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAElD,CAAC;AAEF,eAAO,MAAM,sBAAsB,UAAyD,CAAC;AAC7F,eAAO,MAAM,oBAAoB,UAAuD,CAAC;AAMzF,wBAAgB,uBAAuB,IAAI,MAAM,CAOhD;AAED,wBAAgB,wBAAwB,IAAI,MAAM,CAOjD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAO1D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAO3D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAO9E"}