@jshookmcp/jshook 0.1.2

package/dist/server/workflows/WorkflowContract.d.ts

@@ -0,0 +1,67 @@
+export interface RetryPolicy {
+    maxAttempts: number;
+    backoffMs: number;
+    multiplier?: number;
+}
+export type WorkflowNodeType = 'tool' | 'sequence' | 'parallel' | 'branch';
+export interface ToolNode {
+    readonly kind: 'tool';
+    readonly id: string;
+    readonly toolName: string;
+    readonly input?: Record<string, unknown>;
+    readonly timeoutMs?: number;
+    readonly retry?: RetryPolicy;
+}
+export interface SequenceNode {
+    readonly kind: 'sequence';
+    readonly id: string;
+    readonly steps: WorkflowNode[];
+}
+export interface ParallelNode {
+    readonly kind: 'parallel';
+    readonly id: string;
+    readonly steps: WorkflowNode[];
+    readonly maxConcurrency?: number;
+    readonly failFast?: boolean;
+}
+export interface BranchNode {
+    readonly kind: 'branch';
+    readonly id: string;
+    readonly predicateId: string;
+    readonly predicateFn?: (ctx: WorkflowExecutionContext) => boolean | Promise<boolean>;
+    readonly whenTrue: WorkflowNode;
+    readonly whenFalse?: WorkflowNode;
+}
+export type WorkflowNode = ToolNode | SequenceNode | ParallelNode | BranchNode;
+export interface WorkflowExecutionContext {
+    readonly workflowRunId: string;
+    readonly profile: string;
+    invokeTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+    emitSpan(name: string, attrs?: Record<string, unknown>): void;
+    emitMetric(name: string, value: number, type: 'counter' | 'gauge' | 'histogram', attrs?: Record<string, unknown>): void;
+    getConfig<T = unknown>(path: string, fallback?: T): T;
+}
+export interface WorkflowContract {
+    readonly kind: 'workflow-contract';
+    readonly version: 1;
+    readonly id: string;
+    readonly displayName: string;
+    readonly description?: string;
+    readonly tags?: string[];
+    readonly timeoutMs?: number;
+    readonly defaultMaxConcurrency?: number;
+    build(ctx: WorkflowExecutionContext): WorkflowNode;
+    onStart?(ctx: WorkflowExecutionContext): Promise<void> | void;
+    onFinish?(ctx: WorkflowExecutionContext, result: unknown): Promise<void> | void;
+    onError?(ctx: WorkflowExecutionContext, error: Error): Promise<void> | void;
+}
+export interface ToolNodeOptions {
+    input?: Record<string, unknown>;
+    retry?: RetryPolicy;
+    timeoutMs?: number;
+}
+export declare function toolNode(id: string, toolName: string, options?: ToolNodeOptions): ToolNode;
+export declare function sequenceNode(id: string, steps: WorkflowNode[]): SequenceNode;
+export declare function parallelNode(id: string, steps: WorkflowNode[], maxConcurrency?: number, failFast?: boolean): ParallelNode;
+export declare function branchNode(id: string, predicateId: string, whenTrue: WorkflowNode, whenFalse?: WorkflowNode, predicateFn?: (ctx: WorkflowExecutionContext) => boolean | Promise<boolean>): BranchNode;
+//# sourceMappingURL=WorkflowContract.d.ts.map

package/dist/server/workflows/WorkflowContract.d.ts.map

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

package/dist/server/workflows/WorkflowContract.js

@@ -0,0 +1,13 @@
+export function toolNode(id, toolName, options) {
+    return { kind: 'tool', id, toolName, input: options?.input, retry: options?.retry, timeoutMs: options?.timeoutMs };
+}
+export function sequenceNode(id, steps) {
+    return { kind: 'sequence', id, steps };
+}
+export function parallelNode(id, steps, maxConcurrency = 4, failFast = false) {
+    return { kind: 'parallel', id, steps, maxConcurrency, failFast };
+}
+export function branchNode(id, predicateId, whenTrue, whenFalse, predicateFn) {
+    return { kind: 'branch', id, predicateId, predicateFn, whenTrue, whenFalse };
+}
+//# sourceMappingURL=WorkflowContract.js.map

package/dist/server/workflows/WorkflowContract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowContract.js","sourceRoot":"","sources":["../../../src/server/workflows/WorkflowContract.ts"],"names":[],"mappings":"AAmHA,MAAM,UAAU,QAAQ,CACtB,EAAU,EACV,QAAgB,EAChB,OAAyB;IAEzB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAqB;IAC5D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,EAAU,EACV,KAAqB,EACrB,cAAc,GAAG,CAAC,EAClB,QAAQ,GAAG,KAAK;IAEhB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,EAAU,EACV,WAAmB,EACnB,QAAsB,EACtB,SAAwB,EACxB,WAA2E;IAE3E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAC/E,CAAC"}

package/dist/server/workflows/WorkflowEngine.d.ts

@@ -0,0 +1,37 @@
+import type { MCPServerContext } from '../MCPServer.context.js';
+import type { WorkflowContract } from '../workflows/WorkflowContract.js';
+type JsonRecord = Record<string, unknown>;
+interface WorkflowMetric {
+    name: string;
+    value: number;
+    type: 'counter' | 'gauge' | 'histogram';
+    attrs?: Record<string, unknown>;
+    at: string;
+}
+interface WorkflowSpan {
+    name: string;
+    attrs?: Record<string, unknown>;
+    at: string;
+}
+export interface ExecuteWorkflowOptions {
+    profile?: string;
+    config?: JsonRecord;
+    nodeInputOverrides?: Record<string, Record<string, unknown>>;
+    timeoutMs?: number;
+}
+export interface ExecuteWorkflowResult {
+    workflowId: string;
+    displayName: string;
+    runId: string;
+    profile: string;
+    startedAt: string;
+    finishedAt: string;
+    durationMs: number;
+    result: unknown;
+    stepResults: Record<string, unknown>;
+    metrics: WorkflowMetric[];
+    spans: WorkflowSpan[];
+}
+export declare function executeExtensionWorkflow(ctx: MCPServerContext, workflow: WorkflowContract, options?: ExecuteWorkflowOptions): Promise<ExecuteWorkflowResult>;
+export {};
+//# sourceMappingURL=WorkflowEngine.d.ts.map

package/dist/server/workflows/WorkflowEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowEngine.d.ts","sourceRoot":"","sources":["../../../src/server/workflows/WorkflowEngine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,KAAK,EAKV,gBAAgB,EAGjB,MAAM,oCAAoC,CAAC;AAE5C,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AA4PD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,qBAAqB,CAAC,CAyDhC"}

package/dist/server/workflows/WorkflowEngine.js

@@ -0,0 +1,266 @@
+import { randomUUID } from 'node:crypto';
+function extractConfigValue(config, path, fallback) {
+    const segments = path.split('.').filter(Boolean);
+    let current = config;
+    for (const segment of segments) {
+        if (!current || typeof current !== 'object')
+            return fallback;
+        current = current[segment];
+    }
+    return current ?? fallback;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withTimeout(promise, timeoutMs, label) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        return promise;
+    }
+    return new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => reject(new Error(`${label} timed out after ${timeoutMs}ms`)), timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timeoutId);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timeoutId);
+            reject(error);
+        });
+    });
+}
+function parseToolPayload(response) {
+    if (!response || typeof response !== 'object')
+        return undefined;
+    const toolResponse = response;
+    const text = toolResponse.content?.find((item) => item.type === 'text')?.text;
+    if (typeof text !== 'string')
+        return undefined;
+    try {
+        const parsed = JSON.parse(text);
+        return parsed && typeof parsed === 'object' ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function responseIndicatesFailure(response) {
+    if (!response || typeof response !== 'object')
+        return undefined;
+    const toolResponse = response;
+    if (toolResponse.isError) {
+        return 'Tool returned MCP error response';
+    }
+    const payload = parseToolPayload(response);
+    if (payload?.success === false) {
+        return typeof payload.error === 'string' ? payload.error : 'Tool reported success=false';
+    }
+    return undefined;
+}
+function collectSuccessStats(value) {
+    if (Array.isArray(value)) {
+        return value.reduce((acc, item) => {
+            const next = collectSuccessStats(item);
+            acc.success += next.success;
+            acc.failure += next.failure;
+            return acc;
+        }, { success: 0, failure: 0 });
+    }
+    if (!value || typeof value !== 'object') {
+        return { success: 0, failure: 0 };
+    }
+    const payload = parseToolPayload(value);
+    if (payload?.success === true)
+        return { success: 1, failure: 0 };
+    if (payload?.success === false)
+        return { success: 0, failure: 1 };
+    if ('error' in value) {
+        return { success: 0, failure: 1 };
+    }
+    return { success: 0, failure: 0 };
+}
+async function runToolNode(ctx, node, overrides) {
+    const mergedInput = {
+        ...(node.input ?? {}),
+        ...(overrides?.[node.id] ?? {}),
+    };
+    const runAttempt = async () => {
+        const response = await withTimeout(ctx.executeToolWithTracking(node.toolName, mergedInput), node.timeoutMs ?? 0, `Workflow tool node "${node.id}"`);
+        const failure = responseIndicatesFailure(response);
+        if (failure) {
+            throw new Error(failure);
+        }
+        return response;
+    };
+    const retry = node.retry;
+    if (!retry) {
+        return runAttempt();
+    }
+    let attempt = 0;
+    let backoffMs = retry.backoffMs;
+    while (attempt < retry.maxAttempts) {
+        try {
+            return await runAttempt();
+        }
+        catch (error) {
+            attempt += 1;
+            if (attempt >= retry.maxAttempts) {
+                throw error;
+            }
+            await sleep(backoffMs);
+            backoffMs = Math.max(0, Math.floor(backoffMs * (retry.multiplier ?? 1)));
+        }
+    }
+    throw new Error(`Workflow tool node "${node.id}" exhausted retries`);
+}
+async function runParallelNode(ctx, node, executionContext, options) {
+    const concurrency = Math.max(1, node.maxConcurrency ?? 4);
+    const results = new Array(node.steps.length);
+    let nextIndex = 0;
+    let stopped = false;
+    const worker = async () => {
+        while (true) {
+            if (stopped)
+                return;
+            const currentIndex = nextIndex;
+            nextIndex += 1;
+            if (currentIndex >= node.steps.length)
+                return;
+            const step = node.steps[currentIndex];
+            if (!step)
+                return;
+            try {
+                results[currentIndex] = await executeNode(ctx, step, executionContext, options);
+            }
+            catch (error) {
+                if (node.failFast) {
+                    stopped = true;
+                    throw error;
+                }
+                results[currentIndex] = {
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(concurrency, node.steps.length) }, () => worker()));
+    return results;
+}
+async function evaluatePredicate(node, ctx) {
+    if (node.predicateFn) {
+        return await node.predicateFn(ctx);
+    }
+    if (node.predicateId === 'always_true')
+        return true;
+    if (node.predicateId === 'always_false')
+        return false;
+    if (node.predicateId === 'any_step_failed') {
+        return [...ctx.stepResults.values()].some((value) => collectSuccessStats(value).failure > 0);
+    }
+    const successRateMatch = node.predicateId.match(/success_rate_gte_(\d+)/i);
+    if (successRateMatch) {
+        const threshold = Number(successRateMatch[1]);
+        const aggregate = [...ctx.stepResults.values()].reduce((acc, value) => {
+            const next = collectSuccessStats(value);
+            acc.success += next.success;
+            acc.failure += next.failure;
+            return acc;
+        }, { success: 0, failure: 0 });
+        const total = aggregate.success + aggregate.failure;
+        if (total === 0)
+            return false;
+        return aggregate.success / total >= threshold / 100;
+    }
+    throw new Error(`Unknown workflow predicateId "${node.predicateId}"`);
+}
+async function executeNode(ctx, node, executionContext, options) {
+    executionContext.emitSpan('workflow.node.start', { nodeId: node.id, kind: node.kind });
+    let result;
+    switch (node.kind) {
+        case 'tool':
+            result = await runToolNode(ctx, node, options.nodeInputOverrides);
+            break;
+        case 'sequence': {
+            const sequenceNode = node;
+            const items = [];
+            for (const step of sequenceNode.steps) {
+                items.push(await executeNode(ctx, step, executionContext, options));
+            }
+            result = items;
+            break;
+        }
+        case 'parallel':
+            result = await runParallelNode(ctx, node, executionContext, options);
+            break;
+        case 'branch': {
+            const branchNode = node;
+            const predicate = await evaluatePredicate(branchNode, executionContext);
+            const selected = predicate ? branchNode.whenTrue : branchNode.whenFalse;
+            if (selected) {
+                result = await executeNode(ctx, selected, executionContext, options);
+            }
+            else {
+                result = undefined;
+            }
+            break;
+        }
+        default:
+            throw new Error(`Unsupported workflow node kind: ${node.kind}`);
+    }
+    executionContext.stepResults.set(node.id, result);
+    executionContext.emitSpan('workflow.node.finish', { nodeId: node.id, kind: node.kind });
+    return result;
+}
+export async function executeExtensionWorkflow(ctx, workflow, options = {}) {
+    const runId = randomUUID();
+    const profile = options.profile ?? String(ctx.currentTier ?? 'workflow');
+    const startedAt = new Date().toISOString();
+    const startedAtMs = Date.now();
+    const metrics = [];
+    const spans = [];
+    const stepResults = new Map();
+    const mergedConfig = options.config
+        ? { ...ctx.config, ...options.config }
+        : ctx.config;
+    const executionContext = {
+        workflowRunId: runId,
+        profile,
+        stepResults,
+        invokeTool(toolName, args) {
+            return ctx.executeToolWithTracking(toolName, args);
+        },
+        emitSpan(name, attrs) {
+            spans.push({ name, attrs, at: new Date().toISOString() });
+        },
+        emitMetric(name, value, type, attrs) {
+            metrics.push({ name, value, type, attrs, at: new Date().toISOString() });
+        },
+        getConfig(path, fallback) {
+            return extractConfigValue(mergedConfig, path, fallback);
+        },
+    };
+    try {
+        await workflow.onStart?.(executionContext);
+        const graph = workflow.build(executionContext);
+        const result = await withTimeout(executeNode(ctx, graph, executionContext, options), options.timeoutMs ?? workflow.timeoutMs ?? 0, `Workflow "${workflow.id}"`);
+        await workflow.onFinish?.(executionContext, result);
+        return {
+            workflowId: workflow.id,
+            displayName: workflow.displayName,
+            runId,
+            profile,
+            startedAt,
+            finishedAt: new Date().toISOString(),
+            durationMs: Date.now() - startedAtMs,
+            result,
+            stepResults: Object.fromEntries(stepResults.entries()),
+            metrics,
+            spans,
+        };
+    }
+    catch (error) {
+        const workflowError = error instanceof Error ? error : new Error(String(error));
+        await workflow.onError?.(executionContext, workflowError);
+        throw workflowError;
+    }
+}
+//# sourceMappingURL=WorkflowEngine.js.map

package/dist/server/workflows/WorkflowEngine.js.map

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

package/dist/server/workflows/examples/batch-register.workflow.d.ts

@@ -0,0 +1,4 @@
+import type { WorkflowContract } from '../../workflows/WorkflowContract.js';
+declare const batchRegisterWorkflow: WorkflowContract;
+export default batchRegisterWorkflow;
+//# sourceMappingURL=batch-register.workflow.d.ts.map

package/dist/server/workflows/examples/batch-register.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-register.workflow.d.ts","sourceRoot":"","sources":["../../../../src/server/workflows/examples/batch-register.workflow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAQ3E,QAAA,MAAM,qBAAqB,EAAE,gBAiG5B,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/server/workflows/examples/batch-register.workflow.js

@@ -0,0 +1,66 @@
+import { branchNode, parallelNode, sequenceNode, toolNode, } from '../../workflows/WorkflowContract.js';
+const batchRegisterWorkflow = {
+    kind: 'workflow-contract',
+    version: 1,
+    id: 'workflow.batch-register.v1',
+    displayName: 'Batch Register Accounts',
+    description: 'Run register_account_flow for multiple accounts with concurrency controls, ' +
+        'retry policies, and success rate gating.',
+    tags: ['workflow', 'registration', 'batch', 'automation'],
+    timeoutMs: 15 * 60_000,
+    defaultMaxConcurrency: 3,
+    build(ctx) {
+        const maxConcurrency = ctx.getConfig('workflows.batchRegister.maxConcurrency', 3);
+        const precheck = toolNode('precheck', 'web_api_capture_session', {
+            input: {
+                url: 'about:blank',
+                exportHar: false,
+                exportReport: false,
+            },
+        });
+        const registerSteps = parallelNode('register-parallel', [
+            toolNode('register-account-1', 'register_account_flow', {
+                input: {
+                    registerUrl: 'https://example.com/register',
+                    fields: { username: 'user1', email: 'user1@temp.mail', password: '{{PLACEHOLDER}}' },
+                },
+                retry: { maxAttempts: 2, backoffMs: 1000, multiplier: 2 },
+            }),
+            toolNode('register-account-2', 'register_account_flow', {
+                input: {
+                    registerUrl: 'https://example.com/register',
+                    fields: { username: 'user2', email: 'user2@temp.mail', password: '{{PLACEHOLDER}}' },
+                },
+                retry: { maxAttempts: 2, backoffMs: 1000, multiplier: 2 },
+            }),
+        ], maxConcurrency, false);
+        const summarize = branchNode('summary-branch', 'batch_success_rate_gte_80', toolNode('success-summary', 'console_execute', {
+            input: { expression: '({ status: "batch_complete", successRate: ">=80%" })' },
+        }), toolNode('failure-summary', 'console_execute', {
+            input: { expression: '({ status: "needs_retry", successRate: "<80%", suggestion: "Check captcha provider or increase timeout" })' },
+        }), (_ctx) => {
+            return true;
+        });
+        return sequenceNode('batch-register-root', [precheck, registerSteps, summarize]);
+    },
+    onStart(ctx) {
+        ctx.emitMetric('workflow_runs_total', 1, 'counter', {
+            workflowId: 'workflow.batch-register.v1',
+            stage: 'start',
+        });
+    },
+    onFinish(ctx) {
+        ctx.emitMetric('workflow_runs_total', 1, 'counter', {
+            workflowId: 'workflow.batch-register.v1',
+            stage: 'finish',
+        });
+    },
+    onError(ctx, error) {
+        ctx.emitMetric('workflow_errors_total', 1, 'counter', {
+            workflowId: 'workflow.batch-register.v1',
+            error: error.name,
+        });
+    },
+};
+export default batchRegisterWorkflow;
+//# sourceMappingURL=batch-register.workflow.js.map

package/dist/server/workflows/examples/batch-register.workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-register.workflow.js","sourceRoot":"","sources":["../../../../src/server/workflows/examples/batch-register.workflow.ts"],"names":[],"mappings":"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"}

package/dist/services/LLMService.d.ts

@@ -0,0 +1,38 @@
+import type { LLMConfig } from '../types/index.js';
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LLMResponse {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+export interface RetryOptions {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffMultiplier?: number;
+}
+export declare class LLMService {
+    private config;
+    private openai?;
+    private anthropic?;
+    private hasLoggedVisionModelWarning;
+    private retryOptions;
+    constructor(config: LLMConfig, retryOptions?: RetryOptions);
+    private initClients;
+    chat(messages: LLMMessage[], options?: {
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<LLMResponse>;
+    analyzeImage(imageInput: string, prompt: string, isFilePath?: boolean): Promise<string>;
+    private withRetry;
+    private shouldRetry;
+    private chatOpenAI;
+    private chatAnthropic;
+}
+//# sourceMappingURL=LLMService.d.ts.map

package/dist/services/LLMService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMService.d.ts","sourceRoot":"","sources":["../../src/services/LLMService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,2BAA2B,CAAS;IAC5C,OAAO,CAAC,YAAY,CAKlB;gBAEU,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,YAAY;IAQ1D,OAAO,CAAC,WAAW;IAkBb,IAAI,CACR,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC,WAAW,CAAC;IAiBjB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;YAkG7E,SAAS;IAyBvB,OAAO,CAAC,WAAW;YAkBL,UAAU;YAgCV,aAAa;CAoC5B"}