@delofarag/ai-utils 1.7.1 → 1.7.2

package/dist/heart/tools/ToolRegistry.d.ts

@@ -1,6 +1,12 @@
 import { DynamicStructuredTool } from "@langchain/core/tools";
-import type { ExtractToolNames } from "./zodios/CombinedRegistry";
 import { z } from "zod/v4";
+export type ExtractToolNames<T extends readonly {
+    name: string;
+}[]> = {
+    [K in keyof T]: T[K] extends {
+        name: string;
+    } ? T[K]['name'] : never;
+}[number];
 export interface Tool {
     name: string;
     description: string;

package/dist/heart/tools/ToolRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/heart/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,MAAM,WAAW,IAAI;IACjB,IAAI,EAAC,MAAM,CAAA;IACX,WAAW,EAAC,MAAM,CAAA;IAClB,MAAM,EAAC,CAAC,CAAC,SAAS,CAAA;IAClB,IAAI,EAAC,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAA;CAC3B;AAED,KAAK,0BAA0B,CAAC,KAAK,SAAS,MAAM,IAAI,qBAAqB,GAAG;IAC5E,IAAI,EAAE,KAAK,CAAA;CACd,CAAA;AAED,KAAK,aAAa,CAAC,CAAC,SAAS,SAAS,IAAI,EAAE,IAAI;KAC3C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,KAAK,SAAS,MAAM,CAAA;KAAE,GAC3D,0BAA0B,CAAC,KAAK,CAAC,GACjC,KAAK;CACd,CAAA;AAED,qBAAa,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,IAAI,EAAE;IAC5C,OAAO,CAAC,KAAK,CAAiB;gBAClB,KAAK,EAAC,CAAC;IAOZ,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAW5D,QAAQ,CAAC,GAAG,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;IAI5E,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,oBAAoB;IAO5B,IAAW,QAAQ,IAAG,aAAa,CAAC,CAAC,CAAC,CAErC;CACJ"}
+{"version":3,"file":"ToolRegistry.d.ts","sourceRoot":"","sources":["../../../src/heart/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,SAAS;IAAC,IAAI,EAAC,MAAM,CAAA;CAAC,EAAE,IAAI;KAC9D,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAC,IAAI,EAAC,MAAM,CAAA;KAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,KAAK;CACpE,CAAC,MAAM,CAAC,CAAA;AAET,MAAM,WAAW,IAAI;IACjB,IAAI,EAAC,MAAM,CAAA;IACX,WAAW,EAAC,MAAM,CAAA;IAClB,MAAM,EAAC,CAAC,CAAC,SAAS,CAAA;IAClB,IAAI,EAAC,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAA;CAC3B;AAED,KAAK,0BAA0B,CAAC,KAAK,SAAS,MAAM,IAAI,qBAAqB,GAAG;IAC5E,IAAI,EAAE,KAAK,CAAA;CACd,CAAA;AAED,KAAK,aAAa,CAAC,CAAC,SAAS,SAAS,IAAI,EAAE,IAAI;KAC3C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,KAAK,SAAS,MAAM,CAAA;KAAE,GAC3D,0BAA0B,CAAC,KAAK,CAAC,GACjC,KAAK;CACd,CAAA;AAED,qBAAa,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,IAAI,EAAE;IAC5C,OAAO,CAAC,KAAK,CAAiB;gBAClB,KAAK,EAAC,CAAC;IAOZ,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAW5D,QAAQ,CAAC,GAAG,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;IAI5E,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,oBAAoB;IAO5B,IAAW,QAAQ,IAAG,aAAa,CAAC,CAAC,CAAC,CAErC;CACJ"}

package/dist/heart/tools/ToolRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../../src/heart/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAmB1B,MAAM,OAAO,YAAY;IACb,KAAK,CAAiB;IAC9B,YAAY,KAAO;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAqB,CAAA;QACxH,IAAI,IAAI,CAAC,oBAAoB,EAAE,EAAC,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACxF,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,IAAyB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACvF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,eAAe,CAAC,CAAA;QAChG,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,2BAA2B,CAAC,CAAA;QAC7D,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAA6B,CAAA;IAC/C,CAAC;IAEM,QAAQ,CAAC,GAAG,KAA4B;QAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAChD,CAAC;IAEO,UAAU,CAAC,IAAS;QACxB,OAAO,IAAI,qBAAqB,CAAC;YAC7B,IAAI,EAAC,IAAI,CAAC,IAAI;YACd,WAAW,EAAC,IAAI,CAAC,WAAW;YAC5B,MAAM,EAAC,IAAI,CAAC,MAAM;YAClB,IAAI,EAAC,IAAI,CAAC,IAAI;SACjB,CAAC,CAAA;IAEN,CAAC;IAEO,oBAAoB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAC,KAAK,EAAC,EAAE;YAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAA;QAC7C,CAAC,CAAC,CAAA;QACF,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IAC9C,CAAC;IAED,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,KAAK,CAAA;IACrB,CAAC;CACJ;AAED,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC;IACvB;QACI,IAAI,EAAC,aAAa;QAClB,WAAW,EAAC,2BAA2B;QACvC,MAAM,EAAC,CAAC,CAAC,MAAM,CAAC;YACZ,IAAI,EAAC,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC;QACF,IAAI,EAAC,KAAK,EAAC,EAAC,IAAI,EAAe,EAAC,EAAE;YAC9B,OAAO,kBAAkB,IAAI,WAAW,CAAA;QAC5C,CAAC;KACJ;IACD;QACI,IAAI,EAAC,UAAU;QACf,WAAW,EAAC,cAAc;QAC1B,MAAM,EAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,IAAI,EAAC,KAAK,IAAE,EAAE;YACV,OAAO,eAAe,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAA;QAC3D,CAAC;KACJ;CACJ,CAAC,CAAA;AAEF,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA"}
+{"version":3,"file":"ToolRegistry.js","sourceRoot":"","sources":["../../../src/heart/tools/ToolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAuB1B,MAAM,OAAO,YAAY;IACb,KAAK,CAAiB;IAC9B,YAAY,KAAO;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,YAAY,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAqB,CAAA;QACxH,IAAI,IAAI,CAAC,oBAAoB,EAAE,EAAC,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAA;QACxF,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,IAAyB;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;QACvF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wDAAwD,IAAI,eAAe,CAAC,CAAA;QAChG,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,2BAA2B,CAAC,CAAA;QAC7D,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAA6B,CAAA;IAC/C,CAAC;IAEM,QAAQ,CAAC,GAAG,KAA4B;QAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;IAChD,CAAC;IAEO,UAAU,CAAC,IAAS;QACxB,OAAO,IAAI,qBAAqB,CAAC;YAC7B,IAAI,EAAC,IAAI,CAAC,IAAI;YACd,WAAW,EAAC,IAAI,CAAC,WAAW;YAC5B,MAAM,EAAC,IAAI,CAAC,MAAM;YAClB,IAAI,EAAC,IAAI,CAAC,IAAI;SACjB,CAAC,CAAA;IAEN,CAAC;IAEO,oBAAoB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAC,KAAK,EAAC,EAAE;YAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,CAAA;QAC7C,CAAC,CAAC,CAAA;QACF,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IAC9C,CAAC;IAED,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,KAAK,CAAA;IACrB,CAAC;CACJ;AAED,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC;IACvB;QACI,IAAI,EAAC,aAAa;QAClB,WAAW,EAAC,2BAA2B;QACvC,MAAM,EAAC,CAAC,CAAC,MAAM,CAAC;YACZ,IAAI,EAAC,CAAC,CAAC,MAAM,EAAE;SAClB,CAAC;QACF,IAAI,EAAC,KAAK,EAAC,EAAC,IAAI,EAAe,EAAC,EAAE;YAC9B,OAAO,kBAAkB,IAAI,WAAW,CAAA;QAC5C,CAAC;KACJ;IACD;QACI,IAAI,EAAC,UAAU;QACf,WAAW,EAAC,cAAc;QAC1B,MAAM,EAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACnB,IAAI,EAAC,KAAK,IAAE,EAAE;YACV,OAAO,eAAe,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,EAAE,CAAA;QAC3D,CAAC;KACJ;CACJ,CAAC,CAAA;AAEF,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA"}

package/dist/helpers/cli-llms.d.ts

@@ -0,0 +1,192 @@
+import { BaseChatModel, type BaseChatModelParams, type BaseChatModelCallOptions, type BindToolsInput, type BaseLanguageModelInput, Runnable, BaseMessage, AIMessageChunk, ChatGenerationChunk, type ChatResult, type CallbackManagerForLLMRun } from "../imports";
+import type { AutoComplete } from "./llms";
+export interface CLIErrorOptions {
+    provider: string;
+    /** Exit-Code des Subprozesses (falls vorhanden). */
+    exitCode?: number | null;
+    /** HTTP-Status, den die CLI gemeldet hat (z.B. 429). */
+    status?: number;
+    /** Roh-Ausgabe/JSON, das den Fehler ausgelöst hat. */
+    raw?: unknown;
+}
+/** Basis-Fehler für jeden Fehlschlag eines CLI-Aufrufs (`claude`, `codex`). */
+export declare class CLIError extends Error {
+    readonly provider: string;
+    readonly exitCode?: number | null;
+    readonly status?: number;
+    readonly raw?: unknown;
+    constructor(message: string, opts: CLIErrorOptions);
+}
+/**
+ * Wird geworfen, wenn die CLI ein Usage-/Rate-Limit gemeldet hat (Abo-Limit,
+ * HTTP 429, Token-Quota oder Billing). So kann man im try/catch gezielt prüfen,
+ * WARUM der Aufruf fehlschlug:
+ *
+ * ```ts
+ * try { await llm.invoke(msgs) }
+ * catch (e) {
+ *   if (e instanceof CLIUsageLimitError) {
+ *     console.log(`Limit erreicht (${e.limitType}); reset:`, e.resetsAt)
+ *   }
+ * }
+ * ```
+ */
+export declare class CLIUsageLimitError extends CLIError {
+    /** Art des Limits, z.B. "five_hour" | "weekly" | "rate_limit" | "quota" | "billing" | "usage_limit". */
+    readonly limitType?: string;
+    /** Zeitpunkt, zu dem das Limit laut CLI zurückgesetzt wird (falls bekannt). */
+    readonly resetsAt?: Date;
+    constructor(message: string, opts: CLIErrorOptions & {
+        limitType?: string;
+        resetsAt?: Date;
+    });
+}
+/** Normalisierte Tool-Definition (Name + Beschreibung + JSON-Schema der Argumente). */
+export interface CLIToolSpec {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+/** Call-Optionen inkl. der via `bindTools` gebundenen Tools. */
+export interface CLILLMCallOptions extends BaseChatModelCallOptions {
+    tools?: CLIToolSpec[];
+}
+export interface CliUsage {
+    input_tokens: number;
+    output_tokens: number;
+    total_tokens: number;
+}
+/** Ergebnis von `parseFinal` (non-streaming, ein kompletter stdout). */
+export interface ParsedCliFinal {
+    text: string;
+    usage?: CliUsage;
+    responseMetadata?: Record<string, unknown>;
+    raw?: unknown;
+}
+/** Ergebnis von `parseStreamLine` (eine NDJSON-Zeile). */
+export interface ParsedCliStreamLine {
+    text?: string;
+    usage?: CliUsage;
+    responseMetadata?: Record<string, unknown>;
+    done?: boolean;
+    /**
+     * Fehlersignal (z.B. Claude `result` mit `is_error`, Codex `turn.failed`).
+     * Der Generator baut daraus via `buildCliError` den passenden (ggf. Usage-Limit-)Fehler und wirft ihn.
+     */
+    error?: {
+        message: string;
+        status?: number;
+        limitType?: string;
+        resetsAt?: Date;
+    };
+    /**
+     * Rate-Limit-Metadaten (z.B. Claude `rate_limit_event` / `api_retry`) zur Anreicherung
+     * eines späteren Fehlers — kein Fehler an sich.
+     */
+    rateLimit?: {
+        limitType?: string;
+        resetsAt?: Date;
+    };
+}
+/** Provider-spezifische Defaults, die die Subklasse an `super()` reicht. */
+interface CLIDefaults {
+    model: string;
+    cliPath: string;
+    provider: string;
+}
+export interface CLILLMParams extends BaseChatModelParams {
+    /** Model-Name, der per `--model`/`-m` an die CLI gereicht wird. */
+    model?: string;
+    /** System-Prompt. Default `""` → ersetzt den Default-(Coding-)Systemprompt der CLI. */
+    systemPrompt?: string;
+    /** Arbeitsverzeichnis des Subprozesses. Default: neutrales Temp-Verzeichnis. */
+    cwd?: string;
+    /** Pfad/Name des CLI-Binaries (Default je Subklasse). */
+    cliPath?: string;
+    /** Zusätzliche CLI-Flags (Escape-Hatch). */
+    extraArgs?: string[];
+    /** Timeout in ms; danach wird der Subprozess gekillt. */
+    timeoutMs?: number;
+    /** Zusätzliche Env-Variablen für den Subprozess. */
+    env?: Record<string, string>;
+}
+/**
+ * Abstrakte Basisklasse. Subklassen (`ClaudeCLI_LLM`, `OpenAICLI_LLM`) definieren
+ * nur das CLI-spezifische: Binary, Args, und das Parsen von Output/Stream.
+ */
+export declare abstract class CLI_LLM extends BaseChatModel<CLILLMCallOptions> {
+    model: string;
+    systemPrompt: string;
+    cwd: string;
+    cliPath: string;
+    extraArgs: string[];
+    timeoutMs?: number;
+    env?: Record<string, string>;
+    /** Provider-Tag, analog zu `getLLM()`-Rückgaben (`"claude-cli"`, `"openai-cli"`). */
+    provider: string;
+    /** Baut die CLI-Argumente. `systemPrompt` ist der effektive (ggf. aus Messages stammende). */
+    protected abstract buildArgs(stream: boolean, systemPrompt: string): string[];
+    /** Parst den kompletten stdout eines non-streaming Laufs. */
+    protected abstract parseFinal(stdout: string): ParsedCliFinal;
+    /** Parst eine einzelne NDJSON-Zeile eines Streams (undefined = ignorieren). */
+    protected abstract parseStreamLine(line: string): ParsedCliStreamLine | undefined;
+    /**
+     * Wie der Prompt an stdin übergeben wird. Default: nur der User-Prompt.
+     * Codex hat z.B. kein `--system-prompt`-Flag → überschreibt das, um den
+     * System-Prompt als Präambel voranzustellen.
+     */
+    protected composeStdin(_systemPrompt: string, userPrompt: string): string;
+    constructor(fields: CLILLMParams, defaults: CLIDefaults);
+    _llmType(): string;
+    /**
+     * Macht das Model in LangGraph-React-Agents nutzbar. Da die CLI keine nativen
+     * `tool_calls` liefert, werden die Tools als Spezifikationen gebunden und in
+     * `_generate` per Prompt-Protokoll emuliert (siehe `parseToolDecision`).
+     */
+    bindTools(tools: BindToolsInput[], kwargs?: Partial<CLILLMCallOptions>): Runnable<BaseLanguageModelInput, AIMessageChunk, CLILLMCallOptions>;
+    /** Baut die Tool-Anweisung, die dem System-Prompt angehängt wird. */
+    protected buildToolInstruction(tools: CLIToolSpec[]): string;
+    /** Messages → `{ systemPrompt, userPrompt }`. SystemMessages überschreiben `this.systemPrompt`. */
+    protected messagesToCliInput(messages: BaseMessage[]): {
+        systemPrompt: string;
+        userPrompt: string;
+    };
+    _generate(messages: BaseMessage[], options: this["ParsedCallOptions"], _runManager?: CallbackManagerForLLMRun): Promise<ChatResult>;
+    _streamResponseChunks(messages: BaseMessage[], options: this["ParsedCallOptions"], runManager?: CallbackManagerForLLMRun): AsyncGenerator<ChatGenerationChunk>;
+    /** Startet die CLI, schreibt stdin, sammelt stdout. Wirft bei Exit≠0, Timeout oder Abort. */
+    protected runCli(args: string[], stdin: string, signal?: AbortSignal): Promise<string>;
+    /** Wie `runCli`, liefert stdout aber zeilenweise als Async-Iterator (für Streaming). */
+    protected runCliStreaming(args: string[], stdin: string, signal?: AbortSignal): AsyncGenerator<string>;
+}
+/**
+ * Volle, versionierte Model-IDs, die `claude --model` akzeptiert (aktuelle Modelle, Stand 2026-06).
+ * Aliasse wie "opus"/"sonnet"/"haiku"/"fable" funktionieren via `AutoComplete` ebenfalls,
+ * zeigen aber immer auf das jeweils neueste Modell — daher hier bewusst die genauen IDs.
+ */
+export type ClaudeCLIModel = AutoComplete<"claude-fable-5" | "claude-opus-4-8" | "claude-opus-4-7" | "claude-opus-4-6" | "claude-opus-4-5" | "claude-sonnet-4-6" | "claude-haiku-4-5">;
+export interface ClaudeCLILLMParams extends CLILLMParams {
+    model?: ClaudeCLIModel;
+}
+export declare class ClaudeCLI_LLM extends CLI_LLM {
+    static lc_name(): string;
+    constructor(fields?: ClaudeCLILLMParams);
+    protected buildArgs(stream: boolean, systemPrompt: string): string[];
+    protected parseFinal(stdout: string): ParsedCliFinal;
+    protected parseStreamLine(line: string): ParsedCliStreamLine | undefined;
+}
+/** Von `codex -m/--model` akzeptiert (siehe developers.openai.com/codex/models). */
+export type OpenAICLIModel = AutoComplete<"gpt-5.5" | "gpt-5.4" | "gpt-5.4-mini" | "gpt-5.3-codex-spark">;
+export interface OpenAICLILLMParams extends CLILLMParams {
+    model?: OpenAICLIModel;
+}
+export declare class OpenAICLI_LLM extends CLI_LLM {
+    static lc_name(): string;
+    constructor(fields?: OpenAICLILLMParams);
+    protected buildArgs(_stream: boolean, _systemPrompt: string): string[];
+    /** Codex hat kein `--system-prompt` → als Präambel voranstellen. */
+    protected composeStdin(systemPrompt: string, userPrompt: string): string;
+    protected parseFinal(stdout: string): ParsedCliFinal;
+    protected parseStreamLine(line: string): ParsedCliStreamLine | undefined;
+}
+export {};
+//# sourceMappingURL=cli-llms.d.ts.map

package/dist/helpers/cli-llms.d.ts.map

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