@db-lyon/flowkit 0.10.0 → 0.11.0

package/dist/task/json-schema.js

@@ -0,0 +1,223 @@
+/**
+ * Compact, dependency-free JSON Schema validator.
+ *
+ * Flowkit keeps its runtime dependencies to two (js-yaml, zod), so rather than
+ * pull in a full validator we implement the subset that LLM structured-output
+ * schemas actually use. The goal is not spec completeness — it is a precise,
+ * human-readable verdict that drives the structured-output repair loop in
+ * llm-runner (the error strings are fed back to the model).
+ *
+ * Supported keywords:
+ *   type (single or array), enum, const,
+ *   object: properties, required, additionalProperties (bool or schema),
+ *   array:  items, minItems, maxItems,
+ *   string: minLength, maxLength, pattern,
+ *   number: minimum, maximum, exclusiveMinimum, exclusiveMaximum,
+ *   composition: anyOf, oneOf, allOf, not,
+ *   nullable (OpenAPI-style — treated as "type may also be null").
+ *
+ * Anything unrecognized is ignored (treated as "no constraint"), so an
+ * over-rich schema validates leniently rather than throwing.
+ */
+const TYPE_OF = (v) => {
+    if (v === null)
+        return 'null';
+    if (Array.isArray(v))
+        return 'array';
+    return typeof v;
+};
+/** Does `value` satisfy the JSON Schema `type` token? Handles integer + null. */
+function matchesType(value, type) {
+    switch (type) {
+        case 'integer':
+            return typeof value === 'number' && Number.isInteger(value);
+        case 'number':
+            return typeof value === 'number';
+        case 'string':
+            return typeof value === 'string';
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'object':
+            return value !== null && typeof value === 'object' && !Array.isArray(value);
+        case 'array':
+            return Array.isArray(value);
+        case 'null':
+            return value === null;
+        default:
+            return true; // unknown type token — don't constrain
+    }
+}
+function validateNode(value, schema, path, errors) {
+    // Composition keywords are evaluated independently of type.
+    if (Array.isArray(schema.allOf)) {
+        for (const sub of schema.allOf)
+            validateNode(value, sub, path, errors);
+    }
+    if (Array.isArray(schema.anyOf)) {
+        const ok = schema.anyOf.some((sub) => isolatedValid(value, sub, path));
+        if (!ok)
+            errors.push({ path, message: 'does not match any schema in anyOf' });
+    }
+    if (Array.isArray(schema.oneOf)) {
+        const matches = schema.oneOf.filter((sub) => isolatedValid(value, sub, path)).length;
+        if (matches !== 1) {
+            errors.push({ path, message: `must match exactly one schema in oneOf (matched ${matches})` });
+        }
+    }
+    if (schema.not && typeof schema.not === 'object') {
+        if (isolatedValid(value, schema.not, path)) {
+            errors.push({ path, message: 'must not match the "not" schema' });
+        }
+    }
+    // const / enum
+    if ('const' in schema && !deepEqual(value, schema.const)) {
+        errors.push({ path, message: `must equal ${JSON.stringify(schema.const)}` });
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.some((e) => deepEqual(e, value))) {
+        errors.push({ path, message: `must be one of ${JSON.stringify(schema.enum)}` });
+    }
+    // type (with OpenAPI-style nullable support)
+    const types = normalizeTypes(schema);
+    if (types && !(schema.nullable === true && value === null)) {
+        if (!types.some((t) => matchesType(value, t))) {
+            errors.push({
+                path,
+                message: `expected type ${types.join(' | ')} but got ${TYPE_OF(value)}`,
+            });
+            return; // further keyword checks assume the type matched
+        }
+    }
+    if (matchesType(value, 'object') && value !== null) {
+        validateObject(value, schema, path, errors);
+    }
+    else if (Array.isArray(value)) {
+        validateArray(value, schema, path, errors);
+    }
+    else if (typeof value === 'string') {
+        validateString(value, schema, path, errors);
+    }
+    else if (typeof value === 'number') {
+        validateNumber(value, schema, path, errors);
+    }
+}
+function validateObject(value, schema, path, errors) {
+    const properties = schema.properties ?? {};
+    if (Array.isArray(schema.required)) {
+        for (const key of schema.required) {
+            if (!(key in value))
+                errors.push({ path: join(path, key), message: 'is required' });
+        }
+    }
+    for (const [key, sub] of Object.entries(properties)) {
+        if (key in value)
+            validateNode(value[key], sub, join(path, key), errors);
+    }
+    const additional = schema.additionalProperties;
+    if (additional === false) {
+        for (const key of Object.keys(value)) {
+            if (!(key in properties)) {
+                errors.push({ path: join(path, key), message: 'is not an allowed property' });
+            }
+        }
+    }
+    else if (additional && typeof additional === 'object') {
+        for (const key of Object.keys(value)) {
+            if (!(key in properties))
+                validateNode(value[key], additional, join(path, key), errors);
+        }
+    }
+}
+function validateArray(value, schema, path, errors) {
+    if (typeof schema.minItems === 'number' && value.length < schema.minItems) {
+        errors.push({ path, message: `must have at least ${schema.minItems} items` });
+    }
+    if (typeof schema.maxItems === 'number' && value.length > schema.maxItems) {
+        errors.push({ path, message: `must have at most ${schema.maxItems} items` });
+    }
+    if (schema.items && typeof schema.items === 'object' && !Array.isArray(schema.items)) {
+        value.forEach((item, i) => validateNode(item, schema.items, join(path, String(i)), errors));
+    }
+}
+function validateString(value, schema, path, errors) {
+    if (typeof schema.minLength === 'number' && value.length < schema.minLength) {
+        errors.push({ path, message: `must be at least ${schema.minLength} characters` });
+    }
+    if (typeof schema.maxLength === 'number' && value.length > schema.maxLength) {
+        errors.push({ path, message: `must be at most ${schema.maxLength} characters` });
+    }
+    if (typeof schema.pattern === 'string') {
+        let re = null;
+        try {
+            re = new RegExp(schema.pattern);
+        }
+        catch {
+            re = null; // invalid pattern in schema — skip rather than throw
+        }
+        if (re && !re.test(value))
+            errors.push({ path, message: `must match pattern ${schema.pattern}` });
+    }
+}
+function validateNumber(value, schema, path, errors) {
+    if (typeof schema.minimum === 'number' && value < schema.minimum) {
+        errors.push({ path, message: `must be >= ${schema.minimum}` });
+    }
+    if (typeof schema.maximum === 'number' && value > schema.maximum) {
+        errors.push({ path, message: `must be <= ${schema.maximum}` });
+    }
+    if (typeof schema.exclusiveMinimum === 'number' && value <= schema.exclusiveMinimum) {
+        errors.push({ path, message: `must be > ${schema.exclusiveMinimum}` });
+    }
+    if (typeof schema.exclusiveMaximum === 'number' && value >= schema.exclusiveMaximum) {
+        errors.push({ path, message: `must be < ${schema.exclusiveMaximum}` });
+    }
+}
+/** Validate against a sub-schema in isolation; used by anyOf/oneOf/not. */
+function isolatedValid(value, schema, path) {
+    const sub = [];
+    validateNode(value, schema, path, sub);
+    return sub.length === 0;
+}
+function normalizeTypes(schema) {
+    const t = schema.type;
+    if (typeof t === 'string')
+        return [t];
+    if (Array.isArray(t) && t.every((x) => typeof x === 'string'))
+        return t;
+    return null;
+}
+function join(path, key) {
+    return `${path}/${key}`;
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b || a === null || b === null)
+        return false;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        return a.length === b.length && a.every((v, i) => deepEqual(v, b[i]));
+    }
+    if (typeof a === 'object' && typeof b === 'object') {
+        const ka = Object.keys(a);
+        const kb = Object.keys(b);
+        if (ka.length !== kb.length)
+            return false;
+        return ka.every((k) => deepEqual(a[k], b[k]));
+    }
+    return false;
+}
+/** Validate a value against a JSON Schema. Always returns; never throws. */
+export function validateJson(value, schema) {
+    const errors = [];
+    try {
+        validateNode(value, schema, '', errors);
+    }
+    catch (err) {
+        errors.push({ path: '', message: `validator error: ${err.message}` });
+    }
+    return { valid: errors.length === 0, errors };
+}
+/** One-line, model-friendly summary of validation errors for the repair loop. */
+export function formatErrors(errors) {
+    return errors.map((e) => `${e.path || '(root)'}: ${e.message}`).join('; ');
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/task/json-schema.js.map

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

package/dist/task/llm-provider.d.ts

@@ -1,36 +1,109 @@
 /**
- * LLM provider interface. Flowkit itself has no SDK dependencies — the
- * consumer wires a concrete provider (Anthropic, OpenAI, local, a stub for
- * tests) into the task context under the `llm` key.
+ * LLM provider contract. Flowkit itself has no SDK dependencies — the consumer
+ * wires a concrete provider (Anthropic, OpenAI, local, a stub for tests) into
+ * the task context under the `llm` key. The provider's only job is to translate
+ * this neutral request/response shape to and from its own SDK, which keeps the
+ * engine model-agnostic.
+ *
+ * The contract is intentionally additive: a provider may ignore any field it
+ * does not support (`tools`, `schema`, `signal`, …) and a request that only
+ * sets `prompt` behaves exactly as it did before tool-calling existed.
  */
+export type LLMRole = 'system' | 'user' | 'assistant' | 'tool';
+/** A tool invocation the model asked for, surfaced on an assistant turn. */
+export interface LLMToolCall {
+    /** Provider-assigned id, echoed back on the matching tool-result message. */
+    id: string;
+    /** Name of the tool the model wants to run. */
+    name: string;
+    /** Arguments the model produced, already parsed from JSON. */
+    arguments: Record<string, unknown>;
+}
+export interface LLMMessage {
+    role: LLMRole;
+    /** Text content. Empty string is valid (e.g. an assistant turn that is purely tool calls). */
+    content: string;
+    /** Present on assistant turns that request tools. */
+    toolCalls?: LLMToolCall[];
+    /** On a `tool` message: the id of the tool call this result answers. */
+    toolCallId?: string;
+    /** On a `tool` message: the tool's name (some providers key results by name). */
+    name?: string;
+}
+/** A tool the model is allowed to call, described to the provider. */
+export interface LLMToolDefinition {
+    name: string;
+    description?: string;
+    /** JSON Schema for the tool's arguments. */
+    parameters: Record<string, unknown>;
+}
+/** How the model may use tools on a given turn. */
+export type LLMToolChoice = 'auto' | 'none' | 'required' | {
+    name: string;
+};
 export interface LLMCompletionRequest {
     /** System prompt / instructions. */
     system?: string;
-    /** User prompt. */
-    prompt: string;
+    /**
+     * Convenience single user message. When `messages` is set it takes
+     * precedence and `prompt` is ignored.
+     */
+    prompt?: string;
+    /** Full conversation. Overrides `prompt` when present. */
+    messages?: LLMMessage[];
     /** Model identifier — provider-specific. */
     model?: string;
     /** Max output tokens. */
     maxTokens?: number;
+    /** Sampling temperature, when the provider supports it. */
+    temperature?: number;
+    /** Stop sequences, when the provider supports them. */
+    stop?: string[];
     /**
-     * Optional JSON Schema. When provided, the provider should attempt to
-     * return a response that parses against the schema, populating `parsed`
-     * in the response.
+     * Optional JSON Schema. When provided, the provider should attempt to return
+     * output that parses against the schema and populate `parsed`. Flowkit
+     * validates and repairs structured output on top of this (see llm-runner).
      */
     schema?: Record<string, unknown>;
+    /** Tools the model may call this turn. */
+    tools?: LLMToolDefinition[];
+    /** Constrains tool use this turn. */
+    toolChoice?: LLMToolChoice;
+    /**
+     * Cancellation signal. Flowkit aborts this on timeout; well-behaved providers
+     * should pass it to their HTTP client so in-flight calls are cancelled.
+     */
+    signal?: AbortSignal;
 }
 export interface LLMCompletionResponse {
     /** Raw text returned by the model. */
     text: string;
     /** When a schema was provided and the output parsed, the structured value. */
     parsed?: unknown;
+    /** Tool calls the model requested, if any. */
+    toolCalls?: LLMToolCall[];
+    /**
+     * Why the model stopped: `'stop'` (natural end), `'tool_use'` (wants tools),
+     * `'length'` (hit token cap), or any provider-specific string. Absent is
+     * treated as a natural stop.
+     */
+    finishReason?: 'stop' | 'tool_use' | 'length' | (string & {});
     /** Token usage, if the provider reports it. */
     usage?: {
         inputTokens?: number;
         outputTokens?: number;
     };
+    /** The model that actually served the request, if the provider reports it. */
+    model?: string;
 }
 export interface LLMProvider {
     complete(req: LLMCompletionRequest): Promise<LLMCompletionResponse>;
 }
+/**
+ * A programmatic agent tool: a host-supplied function the model can call.
+ * Registered on the task context under `agentTools`, keyed by tool name, for
+ * tools that are not flowkit tasks. Receives the model's parsed arguments and
+ * returns any JSON-serializable result.
+ */
+export type LLMToolHandler = (args: Record<string, unknown>) => unknown | Promise<unknown>;
 //# sourceMappingURL=llm-provider.d.ts.map

package/dist/task/llm-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../../src/task/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrE"}
+{"version":3,"file":"llm-provider.d.ts","sourceRoot":"","sources":["../../src/task/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAE/D,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,8FAA8F;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,qCAAqC;IACrC,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAC9D,+CAA+C;IAC/C,KAAK,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrE;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/task/llm-provider.js

@@ -1,7 +1,13 @@
 /**
- * LLM provider interface. Flowkit itself has no SDK dependencies — the
- * consumer wires a concrete provider (Anthropic, OpenAI, local, a stub for
- * tests) into the task context under the `llm` key.
+ * LLM provider contract. Flowkit itself has no SDK dependencies — the consumer
+ * wires a concrete provider (Anthropic, OpenAI, local, a stub for tests) into
+ * the task context under the `llm` key. The provider's only job is to translate
+ * this neutral request/response shape to and from its own SDK, which keeps the
+ * engine model-agnostic.
+ *
+ * The contract is intentionally additive: a provider may ignore any field it
+ * does not support (`tools`, `schema`, `signal`, …) and a request that only
+ * sets `prompt` behaves exactly as it did before tool-calling existed.
  */
 export {};
 //# sourceMappingURL=llm-provider.js.map

package/dist/task/llm-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../../src/task/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}
+{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../../src/task/llm-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/task/llm-runner.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The single place every LLM call goes through.
+ *
+ * `runCompletion` wraps a raw provider with the cross-cutting concerns that make
+ * model calls production-safe — and does so once, so both the single-shot
+ * `AgentPromptTask` and the agentic `AgentTask` inherit identical behavior:
+ *
+ *   - timeout + abort  — bound every call; abort the provider's in-flight request
+ *   - retry + backoff  — exponential backoff on transient transport failures
+ *   - structured output — validate against the requested JSON Schema and, on a
+ *                         mismatch, re-prompt the model with the concrete errors
+ *                         (the "repair loop") before giving up
+ *   - output cap       — bound response text so a runaway generation can't blow
+ *                         up memory or downstream logs
+ */
+import type { Logger } from '../logger.js';
+import type { LLMProvider, LLMCompletionRequest, LLMCompletionResponse } from './llm-provider.js';
+export interface LLMRunOptions {
+    /** Per-call timeout in ms. Default 60000. `0` disables the timeout. */
+    timeout?: number;
+    /** Transport retries (in addition to the first attempt). Default 2. */
+    retries?: number;
+    /** Base backoff in ms; doubles each retry. Default 500. */
+    retryDelay?: number;
+    /** Decide whether a given error is retryable. Default: retry everything. */
+    retryOn?: (err: Error) => boolean;
+    /** Structured-output repair re-prompts before failing. Default 1. */
+    repairAttempts?: number;
+    /** Cap on response text length. Default 0 (unlimited). */
+    maxOutputChars?: number;
+}
+/** Response plus runner-added metadata. */
+export type LLMRunResult = LLMCompletionResponse & {
+    /** True when `maxOutputChars` clipped the text. */
+    truncated?: boolean;
+};
+/**
+ * The subset of `LLMRunOptions` that is plain data, so it can be declared in
+ * YAML task options. `retryOn` is excluded because it is a function. Both agent
+ * tasks mix these into their option shape; `pickRunOptions` extracts them.
+ */
+export interface AgentRunFields {
+    timeout?: number;
+    retries?: number;
+    retryDelay?: number;
+    repairAttempts?: number;
+    maxOutputChars?: number;
+}
+/** Lift the run-control fields out of a task's options into `LLMRunOptions`. */
+export declare function pickRunOptions(o: AgentRunFields): LLMRunOptions;
+/** A provider call exceeded its timeout. */
+export declare class LLMTimeoutError extends Error {
+    constructor(message: string);
+}
+/** Structured output never satisfied the schema, even after repair attempts. */
+export declare class StructuredOutputError extends Error {
+    readonly rawText: string;
+    readonly validationErrors: string;
+    constructor(message: string, rawText: string, validationErrors: string);
+}
+export declare function runCompletion(provider: LLMProvider, request: LLMCompletionRequest, options?: LLMRunOptions, logger?: Logger): Promise<LLMRunResult>;
+/**
+ * Coerce a response into a schema-conforming value: prefer the provider's
+ * `parsed`, else parse JSON out of the text. Returns `{ parsed }` when valid or
+ * `{ errors }` describing the mismatch. Exported so callers (e.g. the agent
+ * loop) can check conformance without forcing an extra model call.
+ */
+export declare function coerceStructured(resp: LLMCompletionResponse, schema: Record<string, unknown>): {
+    parsed?: unknown;
+    errors?: string;
+};
+//# sourceMappingURL=llm-runner.d.ts.map

package/dist/task/llm-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-runner.d.ts","sourceRoot":"","sources":["../../src/task/llm-runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,aAAa;IAC5B,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC;IAClC,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,2CAA2C;AAC3C,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG;IACjD,mDAAmD;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,CAAC,EAAE,cAAc,GAAG,aAAa,CAQ/D;AAED,4CAA4C;AAC5C,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,gFAAgF;AAChF,qBAAa,qBAAsB,SAAQ,KAAK;IAG5C,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACN,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM;CAKpC;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,oBAAoB,EAC7B,OAAO,GAAE,aAAkB,EAC3B,MAAM,GAAE,MAAmB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAuDvB;AA6ED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,qBAAqB,EAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAUvC"}