@mzhub/promptc 0.1.0

package/dist/compiler/InstructionRewrite.js

@@ -0,0 +1,117 @@
+import { createConcurrencyManager } from "../runtime/concurrency.js";
+import { CostTracker } from "../runtime/costTracker.js";
+import { CandidatePool } from "./CandidatePool.js";
+export class InstructionRewrite {
+    evaluator;
+    constructor(evaluator) {
+        this.evaluator = evaluator;
+    }
+    async compile(program, trainset, options) {
+        const { candidates: candidateCount = 5, instructionVariations = 5, concurrency = 5, examplesPerCandidate = 3, validationSplit = 0.3, seed, budget, provider, } = options;
+        const baseDescription = program["schema"].description;
+        const pool = new CandidatePool(trainset, seed);
+        const validationSet = pool.getValidationSet(validationSplit);
+        const limiter = createConcurrencyManager(concurrency);
+        const costTracker = new CostTracker();
+        const instructionVariants = await this.generateInstructionVariants(provider, baseDescription, instructionVariations);
+        const fewShotCandidates = pool.generateFewShotCandidates(candidateCount, examplesPerCandidate);
+        const allCandidates = [];
+        for (const instruction of instructionVariants) {
+            for (const examples of fewShotCandidates) {
+                allCandidates.push({ instructions: instruction, examples });
+            }
+        }
+        const results = [];
+        const evaluationPromises = allCandidates.map((candidate) => limiter.run(async () => {
+            if (budget?.maxTokens && costTracker.exceedsBudget(budget.maxTokens)) {
+                budget.onBudgetWarning?.(costTracker.total.totalTokens, budget.maxTokens);
+                return { score: -1, ...candidate };
+            }
+            let totalScore = 0;
+            let validCount = 0;
+            for (const testCase of validationSet) {
+                try {
+                    const prediction = await program.run(testCase.input, {
+                        instructions: candidate.instructions,
+                        fewShotExamples: candidate.examples.map((ex) => ({
+                            input: ex.input,
+                            output: ex.output,
+                        })),
+                    });
+                    costTracker.record(prediction.trace.usage);
+                    const score = await this.evaluator(prediction.result, testCase.output);
+                    totalScore += score;
+                    validCount++;
+                }
+                catch {
+                    continue;
+                }
+            }
+            return {
+                score: validCount > 0 ? totalScore / validCount : 0,
+                ...candidate,
+            };
+        }));
+        const candidateResults = await Promise.all(evaluationPromises);
+        results.push(...candidateResults.filter((r) => r.score >= 0));
+        const winner = results.reduce((best, current) => (current.score > best.score ? current : best), {
+            score: -1,
+            instructions: baseDescription,
+            examples: [],
+        });
+        return {
+            meta: {
+                score: winner.score,
+                compiledAt: new Date().toISOString(),
+                strategy: "InstructionRewrite",
+                tokenUsage: costTracker.total,
+            },
+            config: {
+                instructions: winner.instructions,
+                fewShotExamples: winner.examples,
+            },
+        };
+    }
+    async generateInstructionVariants(provider, baseInstruction, count) {
+        const prompt = `You are an expert prompt engineer. Given a base instruction for an LLM task, generate ${count} different variations that might perform better.
+
+Base instruction: "${baseInstruction}"
+
+Requirements:
+- Each variation should convey the same task but with different wording, tone, or structure
+- Try variations like: more specific, more concise, role-based ("You are an expert..."), step-by-step, formal, casual
+- Output as a JSON array of strings
+
+Respond with ONLY a JSON array, no additional text:
+["variation 1", "variation 2", ...]`;
+        const response = await provider.complete({
+            prompt,
+            temperature: 0.8,
+            maxTokens: 1024,
+            responseFormat: "json",
+        });
+        try {
+            const jsonMatch = response.content.match(/\[[\s\S]*\]/);
+            if (!jsonMatch) {
+                return [baseInstruction];
+            }
+            const variations = JSON.parse(jsonMatch[0]);
+            return [baseInstruction, ...variations.slice(0, count)];
+        }
+        catch {
+            return [baseInstruction];
+        }
+    }
+    estimateCost(trainsetSize, options = {}) {
+        const { candidates = 5, instructionVariations = 5, validationSplit = 0.3, } = options;
+        const validationSize = Math.max(1, Math.floor(trainsetSize * validationSplit));
+        const totalCandidates = candidates * instructionVariations;
+        const estimatedCalls = totalCandidates * validationSize + 1;
+        const avgTokensPerCall = 500;
+        return {
+            estimatedCalls,
+            estimatedTokens: estimatedCalls * avgTokensPerCall,
+        };
+    }
+}
+//# sourceMappingURL=InstructionRewrite.js.map

package/dist/compiler/InstructionRewrite.js.map

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

package/dist/compiler/index.d.ts

@@ -0,0 +1,8 @@
+export { BootstrapFewShot } from "./BootstrapFewShot.js";
+export { InstructionRewrite } from "./InstructionRewrite.js";
+export type { InstructionRewriteOptions } from "./InstructionRewrite.js";
+export { CandidatePool } from "./CandidatePool.js";
+export { createCompiledProgram, loadCompiledProgram, } from "./CompiledProgram.js";
+export type { CompiledProgram, CompiledProgramMeta, SerializedCompiledProgram, } from "./CompiledProgram.js";
+export type { Evaluator, Example, CompilationResult, CompileOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/compiler/index.js

@@ -0,0 +1,5 @@
+export { BootstrapFewShot } from "./BootstrapFewShot.js";
+export { InstructionRewrite } from "./InstructionRewrite.js";
+export { CandidatePool } from "./CandidatePool.js";
+export { createCompiledProgram, loadCompiledProgram, } from "./CompiledProgram.js";
+//# sourceMappingURL=index.js.map

package/dist/compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/compiler/types.d.ts

@@ -0,0 +1,41 @@
+export type Evaluator<O> = (prediction: O, groundTruth: O) => number | Promise<number>;
+export interface Example<I, O> {
+    input: I;
+    output: O;
+}
+export interface CompilationResult<I, O> {
+    meta: {
+        score: number;
+        compiledAt: string;
+        strategy: string;
+        tokenUsage: {
+            inputTokens: number;
+            outputTokens: number;
+            totalTokens: number;
+            calls: number;
+        };
+    };
+    config: {
+        instructions: string;
+        fewShotExamples: Array<Example<I, O>>;
+    };
+}
+export interface CompileOptions {
+    candidates?: number;
+    concurrency?: number;
+    examplesPerCandidate?: number;
+    validationSplit?: number;
+    seed?: number;
+    earlyStopThreshold?: number;
+    budget?: {
+        maxTokens?: number;
+        onBudgetWarning?: (used: number, max: number) => void;
+    };
+    onProgress?: (progress: {
+        candidatesEvaluated: number;
+        totalCandidates: number;
+        currentBestScore: number;
+        tokensUsed: number;
+    }) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/compiler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CACzB,UAAU,EAAE,CAAC,EACb,WAAW,EAAE,CAAC,KACX,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9B,MAAM,WAAW,OAAO,CAAC,CAAC,EAAE,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,MAAM,EAAE,CAAC,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,EAAE,CAAC;IACrC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE;YACV,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,EAAE,MAAM,CAAC;YACrB,WAAW,EAAE,MAAM,CAAC;YACpB,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;IACF,MAAM,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;KACvD,CAAC;IACF,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QACtB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,UAAU,EAAE,MAAM,CAAC;KACpB,KAAK,IAAI,CAAC;CACZ"}

package/dist/compiler/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/compiler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/compiler/types.ts"],"names":[],"mappings":""}

package/dist/eval/exactMatch.d.ts

@@ -0,0 +1,5 @@
+import type { Evaluator } from "./types.js";
+export declare function exactMatch<O>(): Evaluator<O>;
+export declare function partialMatch<O extends Record<string, unknown>>(): Evaluator<O>;
+export declare function arrayOverlap<T>(): Evaluator<T[]>;
+//# sourceMappingURL=exactMatch.d.ts.map

package/dist/eval/exactMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exactMatch.d.ts","sourceRoot":"","sources":["../../src/eval/exactMatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyB5C,wBAAgB,UAAU,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAI5C;AAED,wBAAgB,YAAY,CAC1B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC9B,SAAS,CAAC,CAAC,CAAC,CAchB;AAED,wBAAgB,YAAY,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,EAAE,CAAC,CAehD"}

package/dist/eval/exactMatch.js

@@ -0,0 +1,58 @@
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (a === null || b === null)
+        return a === b;
+    if (Array.isArray(a) && Array.isArray(b)) {
+        if (a.length !== b.length)
+            return false;
+        return a.every((item, i) => deepEqual(item, b[i]));
+    }
+    if (typeof a === "object" && typeof b === "object") {
+        const aObj = a;
+        const bObj = b;
+        const aKeys = Object.keys(aObj);
+        const bKeys = Object.keys(bObj);
+        if (aKeys.length !== bKeys.length)
+            return false;
+        return aKeys.every((key) => deepEqual(aObj[key], bObj[key]));
+    }
+    return false;
+}
+export function exactMatch() {
+    return (prediction, groundTruth) => {
+        return deepEqual(prediction, groundTruth) ? 1.0 : 0.0;
+    };
+}
+export function partialMatch() {
+    return (prediction, groundTruth) => {
+        const keys = Object.keys(groundTruth);
+        if (keys.length === 0)
+            return 1.0;
+        let matchCount = 0;
+        for (const key of keys) {
+            if (deepEqual(prediction[key], groundTruth[key])) {
+                matchCount++;
+            }
+        }
+        return matchCount / keys.length;
+    };
+}
+export function arrayOverlap() {
+    return (prediction, groundTruth) => {
+        if (groundTruth.length === 0)
+            return prediction.length === 0 ? 1.0 : 0.0;
+        const predSet = new Set(prediction.map((x) => JSON.stringify(x)));
+        const truthSet = new Set(groundTruth.map((x) => JSON.stringify(x)));
+        let intersection = 0;
+        for (const item of predSet) {
+            if (truthSet.has(item))
+                intersection++;
+        }
+        const union = new Set([...predSet, ...truthSet]).size;
+        return union > 0 ? intersection / union : 0;
+    };
+}
+//# sourceMappingURL=exactMatch.js.map

package/dist/eval/exactMatch.js.map

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

package/dist/eval/index.d.ts

@@ -0,0 +1,5 @@
+export type { Evaluator } from "./types.js";
+export { exactMatch, partialMatch, arrayOverlap } from "./exactMatch.js";
+export { llmJudge } from "./llmJudge.js";
+export type { LLMJudgeConfig } from "./llmJudge.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/eval/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/eval/index.js

@@ -0,0 +1,3 @@
+export { exactMatch, partialMatch, arrayOverlap } from "./exactMatch.js";
+export { llmJudge } from "./llmJudge.js";
+//# sourceMappingURL=index.js.map

package/dist/eval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/eval/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/eval/llmJudge.d.ts

@@ -0,0 +1,9 @@
+import type { LLMProvider } from "../providers/types.js";
+import type { Evaluator } from "./types.js";
+export interface LLMJudgeConfig {
+    provider: LLMProvider;
+    criteria?: string;
+    model?: string;
+}
+export declare function llmJudge<O>(config: LLMJudgeConfig): Evaluator<O>;
+//# sourceMappingURL=llmJudge.d.ts.map

package/dist/eval/llmJudge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmJudge.d.ts","sourceRoot":"","sources":["../../src/eval/llmJudge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,CAmChE"}

package/dist/eval/llmJudge.js

@@ -0,0 +1,33 @@
+export function llmJudge(config) {
+    const { provider, criteria = "accuracy and completeness", model } = config;
+    return async (prediction, groundTruth) => {
+        const prompt = `You are evaluating the quality of an AI response.
+
+EXPECTED OUTPUT:
+${JSON.stringify(groundTruth, null, 2)}
+
+ACTUAL OUTPUT:
+${JSON.stringify(prediction, null, 2)}
+
+EVALUATION CRITERIA: ${criteria}
+
+Rate the actual output on a scale from 0.0 to 1.0, where:
+- 1.0 = Perfect match or equivalent
+- 0.5 = Partially correct
+- 0.0 = Completely wrong
+
+Respond with ONLY a number between 0.0 and 1.0, nothing else.`;
+        const response = await provider.complete({
+            prompt,
+            model,
+            temperature: 0,
+            maxTokens: 10,
+        });
+        const score = parseFloat(response.content.trim());
+        if (isNaN(score) || score < 0 || score > 1) {
+            return 0;
+        }
+        return score;
+    };
+}
+//# sourceMappingURL=llmJudge.js.map

package/dist/eval/llmJudge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmJudge.js","sourceRoot":"","sources":["../../src/eval/llmJudge.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,QAAQ,CAAI,MAAsB;IAChD,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,2BAA2B,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAE3E,OAAO,KAAK,EAAE,UAAa,EAAE,WAAc,EAAmB,EAAE;QAC9D,MAAM,MAAM,GAAG;;;EAGjB,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;;;EAGpC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;;uBAEd,QAAQ;;;;;;;8DAO+B,CAAC;QAE3D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC;YACvC,MAAM;YACN,KAAK;YACL,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAClD,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YAC3C,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/eval/types.d.ts

@@ -0,0 +1,2 @@
+export type Evaluator<O> = (prediction: O, groundTruth: O) => number | Promise<number>;
+//# sourceMappingURL=types.d.ts.map

package/dist/eval/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/eval/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CACzB,UAAU,EAAE,CAAC,EACb,WAAW,EAAE,CAAC,KACX,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC"}

package/dist/eval/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/eval/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/eval/types.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { z } from "zod";
+export { Schema, defineSchema } from "./schema/index.js";
+export type { SchemaDefinition } from "./schema/index.js";
+export { createProvider, OpenAIProvider, AnthropicProvider, GoogleProvider, OllamaProvider, GroqProvider, CerebrasProvider, } from "./providers/index.js";
+export type { LLMProvider, CompletionParams, CompletionResult, ProviderConfig, ProviderName, } from "./providers/index.js";
+export { Program, Predict, ChainOfThought } from "./program/index.js";
+export type { ProgramConfig, ProgramOutput, ProgramTrace, } from "./program/index.js";
+export { BootstrapFewShot, InstructionRewrite, CandidatePool, createCompiledProgram, loadCompiledProgram, } from "./compiler/index.js";
+export type { Evaluator, Example, CompilationResult, CompileOptions, CompiledProgram, CompiledProgramMeta, SerializedCompiledProgram, InstructionRewriteOptions, } from "./compiler/index.js";
+export { exactMatch, partialMatch, arrayOverlap, llmJudge, } from "./eval/index.js";
+export type { LLMJudgeConfig } from "./eval/index.js";
+export { createConcurrencyManager, CostTracker, estimateCost, withRetry, createRetryWrapper, PromptCache, createCache, } from "./runtime/index.js";
+export type { ConcurrencyManager, TokenUsage, CostEstimate, RetryOptions, CacheOptions, } from "./runtime/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACtE,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,SAAS,EACT,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,GACb,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { z } from "zod";
+export { Schema, defineSchema } from "./schema/index.js";
+export { createProvider, OpenAIProvider, AnthropicProvider, GoogleProvider, OllamaProvider, GroqProvider, CerebrasProvider, } from "./providers/index.js";
+export { Program, Predict, ChainOfThought } from "./program/index.js";
+export { BootstrapFewShot, InstructionRewrite, CandidatePool, createCompiledProgram, loadCompiledProgram, } from "./compiler/index.js";
+export { exactMatch, partialMatch, arrayOverlap, llmJudge, } from "./eval/index.js";
+export { createConcurrencyManager, CostTracker, estimateCost, withRetry, createRetryWrapper, PromptCache, createCache, } from "./runtime/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAOtE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAY7B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,QAAQ,GACT,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,wBAAwB,EACxB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC"}

package/dist/program/ChainOfThought.d.ts

@@ -0,0 +1,6 @@
+import { z, ZodRawShape, ZodObject } from "zod";
+import { Program, ProgramConfig, ProgramOutput } from "./Program.js";
+export declare class ChainOfThought<I extends ZodRawShape, O extends ZodRawShape> extends Program<I, O> {
+    run(input: z.infer<ZodObject<I>>, config?: ProgramConfig): Promise<ProgramOutput<z.infer<ZodObject<O>>>>;
+}
+//# sourceMappingURL=ChainOfThought.d.ts.map

package/dist/program/ChainOfThought.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainOfThought.d.ts","sourceRoot":"","sources":["../../src/program/ChainOfThought.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAErE,qBAAa,cAAc,CACzB,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,WAAW,CACrB,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACf,GAAG,CACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC5B,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAgDjD"}

package/dist/program/ChainOfThought.js

@@ -0,0 +1,44 @@
+import { Program } from "./Program.js";
+export class ChainOfThought extends Program {
+    async run(input, config = {}) {
+        const startTime = Date.now();
+        const validatedInput = this.schema.validateInput(input);
+        const instructions = config.instructions || this.schema.description;
+        const fewShotSection = this.buildFewShotString(config.fewShotExamples);
+        const outputKeys = this.schema.getOutputKeys();
+        const outputFormat = outputKeys
+            .map((k) => `"${k}": <value>`)
+            .join(",\n    ");
+        const prompt = `${instructions}
+
+${fewShotSection ? `Here are some examples:\n\n${fewShotSection}\n\n` : ""}Think through this step-by-step before providing your answer.
+
+Input: ${JSON.stringify(validatedInput)}
+
+Respond with valid JSON in this exact format:
+{
+  "reasoning": "Your step-by-step thinking process...",
+  ${outputFormat}
+}
+
+Respond ONLY with valid JSON, no additional text.`;
+        const response = await this.provider.complete({
+            prompt,
+            responseFormat: "json",
+        });
+        const parsed = this.parseJsonResponse(response.content);
+        const reasoning = parsed.reasoning;
+        delete parsed.reasoning;
+        const result = this.schema.validateOutput(parsed);
+        return {
+            result,
+            trace: {
+                promptUsed: prompt,
+                reasoning,
+                usage: response.usage,
+                latencyMs: Date.now() - startTime,
+            },
+        };
+    }
+}
+//# sourceMappingURL=ChainOfThought.js.map

package/dist/program/ChainOfThought.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainOfThought.js","sourceRoot":"","sources":["../../src/program/ChainOfThought.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAgC,MAAM,cAAc,CAAC;AAErE,MAAM,OAAO,cAGX,SAAQ,OAAa;IACrB,KAAK,CAAC,GAAG,CACP,KAA4B,EAC5B,SAAwB,EAAE;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAExD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACpE,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACvE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC/C,MAAM,YAAY,GAAG,UAAU;aAC5B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;aAC7B,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnB,MAAM,MAAM,GAAG,GAAG,YAAY;;EAGhC,cAAc,CAAC,CAAC,CAAC,8BAA8B,cAAc,MAAM,CAAC,CAAC,CAAC,EACxE;;SAES,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;;;;IAKnC,YAAY;;;kDAGkC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC5C,MAAM;YACN,cAAc,EAAE,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,MAAM,CAAC,SAA+B,CAAC;QACzD,OAAO,MAAM,CAAC,SAAS,CAAC;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAElD,OAAO;YACL,MAAM;YACN,KAAK,EAAE;gBACL,UAAU,EAAE,MAAM;gBAClB,SAAS;gBACT,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAClC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/program/Predict.d.ts

@@ -0,0 +1,6 @@
+import { z, ZodRawShape, ZodObject } from "zod";
+import { Program, ProgramConfig, ProgramOutput } from "./Program.js";
+export declare class Predict<I extends ZodRawShape, O extends ZodRawShape> extends Program<I, O> {
+    run(input: z.infer<ZodObject<I>>, config?: ProgramConfig): Promise<ProgramOutput<z.infer<ZodObject<O>>>>;
+}
+//# sourceMappingURL=Predict.d.ts.map

package/dist/program/Predict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Predict.d.ts","sourceRoot":"","sources":["../../src/program/Predict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAErE,qBAAa,OAAO,CAClB,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,WAAW,CACrB,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACf,GAAG,CACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC5B,MAAM,GAAE,aAAkB,GACzB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAoCjD"}

package/dist/program/Predict.js

@@ -0,0 +1,33 @@
+import { Program } from "./Program.js";
+export class Predict extends Program {
+    async run(input, config = {}) {
+        const startTime = Date.now();
+        const validatedInput = this.schema.validateInput(input);
+        const instructions = config.instructions || this.schema.description;
+        const fewShotSection = this.buildFewShotString(config.fewShotExamples);
+        const outputFormat = this.buildOutputFormat();
+        const prompt = `${instructions}
+
+${fewShotSection ? `Here are some examples:\n\n${fewShotSection}\n\n` : ""}Now process this input and respond with valid JSON matching this format:
+${outputFormat}
+
+Input: ${JSON.stringify(validatedInput)}
+
+Respond ONLY with valid JSON, no additional text.`;
+        const response = await this.provider.complete({
+            prompt,
+            responseFormat: "json",
+        });
+        const parsed = this.parseJsonResponse(response.content);
+        const result = this.schema.validateOutput(parsed);
+        return {
+            result,
+            trace: {
+                promptUsed: prompt,
+                usage: response.usage,
+                latencyMs: Date.now() - startTime,
+            },
+        };
+    }
+}
+//# sourceMappingURL=Predict.js.map

package/dist/program/Predict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Predict.js","sourceRoot":"","sources":["../../src/program/Predict.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAgC,MAAM,cAAc,CAAC;AAErE,MAAM,OAAO,OAGX,SAAQ,OAAa;IACrB,KAAK,CAAC,GAAG,CACP,KAA4B,EAC5B,SAAwB,EAAE;QAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAExD,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;QACpE,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACvE,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAE9C,MAAM,MAAM,GAAG,GAAG,YAAY;;EAGhC,cAAc,CAAC,CAAC,CAAC,8BAA8B,cAAc,MAAM,CAAC,CAAC,CAAC,EACxE;EACE,YAAY;;SAEL,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;kDAEW,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC5C,MAAM;YACN,cAAc,EAAE,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAElD,OAAO;YACL,MAAM;YACN,KAAK,EAAE;gBACL,UAAU,EAAE,MAAM;gBAClB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAClC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/program/Program.d.ts

@@ -0,0 +1,33 @@
+import { z, ZodRawShape, ZodObject } from "zod";
+import { Schema } from "../schema/defineSchema.js";
+import type { LLMProvider } from "../providers/types.js";
+export interface ProgramConfig {
+    instructions?: string;
+    fewShotExamples?: Array<{
+        input: Record<string, unknown>;
+        output: Record<string, unknown>;
+    }>;
+}
+export interface ProgramTrace {
+    promptUsed: string;
+    reasoning?: string;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    latencyMs: number;
+}
+export interface ProgramOutput<O> {
+    result: O;
+    trace: ProgramTrace;
+}
+export declare abstract class Program<I extends ZodRawShape, O extends ZodRawShape> {
+    protected schema: Schema<I, O>;
+    protected provider: LLMProvider;
+    constructor(schema: Schema<I, O>, provider: LLMProvider);
+    abstract run(input: z.infer<ZodObject<I>>, config?: ProgramConfig): Promise<ProgramOutput<z.infer<ZodObject<O>>>>;
+    protected buildFewShotString(examples: ProgramConfig["fewShotExamples"]): string;
+    protected buildOutputFormat(): string;
+    protected parseJsonResponse(content: string): Record<string, unknown>;
+}
+//# sourceMappingURL=Program.d.ts.map

package/dist/program/Program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Program.d.ts","sourceRoot":"","sources":["../../src/program/Program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,8BAAsB,OAAO,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,WAAW;IAEtE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9B,SAAS,CAAC,QAAQ,EAAE,WAAW;gBADrB,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,QAAQ,EAAE,WAAW;IAGjC,QAAQ,CAAC,GAAG,CACV,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAC5B,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhD,SAAS,CAAC,kBAAkB,CAC1B,QAAQ,EAAE,aAAa,CAAC,iBAAiB,CAAC,GACzC,MAAM;IAaT,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAMrC,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOtE"}

package/dist/program/Program.js

@@ -0,0 +1,28 @@
+export class Program {
+    schema;
+    provider;
+    constructor(schema, provider) {
+        this.schema = schema;
+        this.provider = provider;
+    }
+    buildFewShotString(examples) {
+        if (!examples || examples.length === 0)
+            return "";
+        return examples
+            .map((ex, i) => `Example ${i + 1}:\nInput: ${JSON.stringify(ex.input)}\nOutput: ${JSON.stringify(ex.output)}`)
+            .join("\n\n");
+    }
+    buildOutputFormat() {
+        const keys = this.schema.getOutputKeys();
+        const format = keys.map((k) => `"${k}": <value>`).join(",\n  ");
+        return `{\n  ${format}\n}`;
+    }
+    parseJsonResponse(content) {
+        const jsonMatch = content.match(/\{[\s\S]*\}/);
+        if (!jsonMatch) {
+            throw new Error("No JSON found in response");
+        }
+        return JSON.parse(jsonMatch[0]);
+    }
+}
+//# sourceMappingURL=Program.js.map

package/dist/program/Program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Program.js","sourceRoot":"","sources":["../../src/program/Program.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAgB,OAAO;IAEf;IACA;IAFZ,YACY,MAAoB,EACpB,QAAqB;QADrB,WAAM,GAAN,MAAM,CAAc;QACpB,aAAQ,GAAR,QAAQ,CAAa;IAC9B,CAAC;IAOM,kBAAkB,CAC1B,QAA0C;QAE1C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAElD,OAAO,QAAQ;aACZ,GAAG,CACF,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CACR,WAAW,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,SAAS,CACzC,EAAE,CAAC,KAAK,CACT,aAAa,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAC5C;aACA,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAES,iBAAiB;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChE,OAAO,QAAQ,MAAM,KAAK,CAAC;IAC7B,CAAC;IAES,iBAAiB,CAAC,OAAe;QACzC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;CACF"}

package/dist/program/index.d.ts

@@ -0,0 +1,5 @@
+export { Program } from "./Program.js";
+export type { ProgramConfig, ProgramOutput, ProgramTrace } from "./Program.js";
+export { Predict } from "./Predict.js";
+export { ChainOfThought } from "./ChainOfThought.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/program/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/program/index.js

@@ -0,0 +1,4 @@
+export { Program } from "./Program.js";
+export { Predict } from "./Predict.js";
+export { ChainOfThought } from "./ChainOfThought.js";
+//# sourceMappingURL=index.js.map

package/dist/program/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/program/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,10 @@
+import type { LLMProvider, CompletionParams, CompletionResult, ProviderConfig } from "./types.js";
+export declare class AnthropicProvider implements LLMProvider {
+    name: string;
+    defaultModel: string;
+    private apiKey;
+    private baseUrl;
+    constructor(config: ProviderConfig);
+    complete(params: CompletionParams): Promise<CompletionResult>;
+}
+//# sourceMappingURL=anthropic.d.ts.map