@mzhub/promptc 0.1.0

package/dist/runtime/index.d.ts

@@ -0,0 +1,9 @@
+export { createConcurrencyManager } from "./concurrency.js";
+export type { ConcurrencyManager } from "./concurrency.js";
+export { CostTracker, estimateCost } from "./costTracker.js";
+export type { TokenUsage, CostEstimate } from "./costTracker.js";
+export { withRetry, createRetryWrapper } from "./retry.js";
+export type { RetryOptions } from "./retry.js";
+export { PromptCache, createCache } from "./cache.js";
+export type { CacheOptions } from "./cache.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,5 @@
+export { createConcurrencyManager } from "./concurrency.js";
+export { CostTracker, estimateCost } from "./costTracker.js";
+export { withRetry, createRetryWrapper } from "./retry.js";
+export { PromptCache, createCache } from "./cache.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/runtime/retry.d.ts

@@ -0,0 +1,10 @@
+export interface RetryOptions {
+    maxRetries?: number;
+    initialDelayMs?: number;
+    maxDelayMs?: number;
+    backoffMultiplier?: number;
+    retryOn?: (error: Error) => boolean;
+}
+export declare function withRetry<T>(fn: () => Promise<T>, options?: RetryOptions): Promise<T>;
+export declare function createRetryWrapper(options?: RetryOptions): <T>(fn: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/runtime/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/runtime/retry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC;CACrC;AAsBD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAqBZ;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,YAAiB,GACzB,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAEzC"}

package/dist/runtime/retry.js

@@ -0,0 +1,39 @@
+const defaultRetryOptions = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    retryOn: (error) => {
+        const message = error.message.toLowerCase();
+        return (message.includes("rate limit") ||
+            message.includes("429") ||
+            message.includes("503") ||
+            message.includes("timeout"));
+    },
+};
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function withRetry(fn, options = {}) {
+    const opts = { ...defaultRetryOptions, ...options };
+    let lastError = null;
+    let delay = opts.initialDelayMs;
+    for (let attempt = 0; attempt <= opts.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt === opts.maxRetries || !opts.retryOn(lastError)) {
+                throw lastError;
+            }
+            await sleep(delay);
+            delay = Math.min(delay * opts.backoffMultiplier, opts.maxDelayMs);
+        }
+    }
+    throw lastError;
+}
+export function createRetryWrapper(options = {}) {
+    return (fn) => withRetry(fn, options);
+}
+//# sourceMappingURL=retry.js.map

package/dist/runtime/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/runtime/retry.ts"],"names":[],"mappings":"AAQA,MAAM,mBAAmB,GAA2B;IAClD,UAAU,EAAE,CAAC;IACb,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,KAAK;IACjB,iBAAiB,EAAE,CAAC;IACpB,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5C,OAAO,CACL,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC5B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,EAAoB,EACpB,UAAwB,EAAE;IAE1B,MAAM,IAAI,GAAG,EAAE,GAAG,mBAAmB,EAAE,GAAG,OAAO,EAAE,CAAC;IACpD,IAAI,SAAS,GAAiB,IAAI,CAAC;IACnC,IAAI,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC;IAEhC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAEtE,IAAI,OAAO,KAAK,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC5D,MAAM,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;YACnB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,MAAM,SAAS,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,UAAwB,EAAE;IAE1B,OAAO,CAAI,EAAoB,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC"}

package/dist/schema/defineSchema.d.ts

@@ -0,0 +1,18 @@
+import { z, ZodObject, ZodRawShape } from "zod";
+export interface SchemaDefinition<I extends ZodRawShape, O extends ZodRawShape> {
+    description: string;
+    inputs: I;
+    outputs: O;
+}
+export declare class Schema<I extends ZodRawShape, O extends ZodRawShape> {
+    readonly inputSchema: ZodObject<I>;
+    readonly outputSchema: ZodObject<O>;
+    readonly description: string;
+    constructor(definition: SchemaDefinition<I, O>);
+    validateInput(input: unknown): z.infer<ZodObject<I>>;
+    validateOutput(output: unknown): z.infer<ZodObject<O>>;
+    getInputKeys(): string[];
+    getOutputKeys(): string[];
+}
+export declare function defineSchema<I extends ZodRawShape, O extends ZodRawShape>(definition: SchemaDefinition<I, O>): Schema<I, O>;
+//# sourceMappingURL=defineSchema.d.ts.map

package/dist/schema/defineSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSchema.d.ts","sourceRoot":"","sources":["../../src/schema/defineSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAEhD,MAAM,WAAW,gBAAgB,CAC/B,CAAC,SAAS,WAAW,EACrB,CAAC,SAAS,WAAW;IAErB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,qBAAa,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,WAAW;IAC9D,SAAgB,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1C,SAAgB,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3C,SAAgB,WAAW,EAAE,MAAM,CAAC;gBAExB,UAAU,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IAM9C,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAIpD,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAItD,YAAY,IAAI,MAAM,EAAE;IAIxB,aAAa,IAAI,MAAM,EAAE;CAG1B;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,WAAW,EACvE,UAAU,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,GACjC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAEd"}

package/dist/schema/defineSchema.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+export class Schema {
+    inputSchema;
+    outputSchema;
+    description;
+    constructor(definition) {
+        this.description = definition.description;
+        this.inputSchema = z.object(definition.inputs);
+        this.outputSchema = z.object(definition.outputs);
+    }
+    validateInput(input) {
+        return this.inputSchema.parse(input);
+    }
+    validateOutput(output) {
+        return this.outputSchema.parse(output);
+    }
+    getInputKeys() {
+        return Object.keys(this.inputSchema.shape);
+    }
+    getOutputKeys() {
+        return Object.keys(this.outputSchema.shape);
+    }
+}
+export function defineSchema(definition) {
+    return new Schema(definition);
+}
+//# sourceMappingURL=defineSchema.js.map

package/dist/schema/defineSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSchema.js","sourceRoot":"","sources":["../../src/schema/defineSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAA0B,MAAM,KAAK,CAAC;AAWhD,MAAM,OAAO,MAAM;IACD,WAAW,CAAe;IAC1B,YAAY,CAAe;IAC3B,WAAW,CAAS;IAEpC,YAAY,UAAkC;QAC5C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,aAAa,CAAC,KAAc;QAC1B,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,cAAc,CAAC,MAAe;QAC5B,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,YAAY;QACV,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,aAAa;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAC1B,UAAkC;IAElC,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC"}

package/dist/schema/index.d.ts

@@ -0,0 +1,3 @@
+export { Schema, defineSchema } from "./defineSchema.js";
+export type { SchemaDefinition } from "./defineSchema.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/schema/index.js

@@ -0,0 +1,2 @@
+export { Schema, defineSchema } from "./defineSchema.js";
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/examples/README.md

@@ -0,0 +1,42 @@
+# Examples
+
+These examples show how to use promptc for various tasks.
+
+## Prerequisites
+
+```bash
+# Install dependencies
+npm install promptc openai
+
+# Set your API key
+export OPENAI_API_KEY="sk-..."
+```
+
+## Running Examples
+
+```bash
+# Run with tsx (recommended)
+npx tsx examples/name-extractor.ts
+
+# Or compile first
+npx tsc examples/name-extractor.ts
+node examples/name-extractor.js
+```
+
+## Examples
+
+### 1. Name Extractor (`name-extractor.ts`)
+
+Complete workflow: define schema → compile → save → use
+
+### 2. QA System (`qa-system.ts`)
+
+Chain of Thought reasoning for question answering
+
+### 3. Multi-Provider (`multi-provider.ts`)
+
+Test the same program across different LLM providers
+
+### 4. Load Compiled (`load-compiled.ts`)
+
+Load a previously compiled program from JSON

package/examples/load-compiled.ts

@@ -0,0 +1,62 @@
+/**
+ * Load Compiled Program Example
+ *
+ * Shows how to load a previously compiled program from JSON
+ */
+
+import { readFileSync } from "fs";
+import {
+  defineSchema,
+  ChainOfThought,
+  loadCompiledProgram,
+  createProvider,
+  z,
+} from "@mzhub/promptc";
+
+// Must match the schema used during compilation
+const NameExtractor = defineSchema({
+  description: "Extract proper names of people from text",
+  inputs: { text: z.string() },
+  outputs: { names: z.array(z.string()) },
+});
+
+async function main() {
+  // 1. Load the saved config
+  const savedJson = readFileSync("name-extractor.json", "utf-8");
+
+  // 2. Create the same program (schema + provider)
+  const provider = createProvider("openai", {
+    apiKey: process.env.OPENAI_API_KEY,
+  });
+  const program = new ChainOfThought(NameExtractor, provider);
+
+  // 3. Load the compiled program
+  const compiled = loadCompiledProgram(savedJson, program);
+
+  console.log("Loaded compiled program:");
+  console.log(`  Strategy: ${compiled.meta.strategy}`);
+  console.log(`  Score: ${(compiled.meta.score * 100).toFixed(1)}%`);
+  console.log(`  Examples: ${compiled.config.fewShotExamples.length}`);
+
+  // 4. Use it in production
+  const testCases = [
+    "Warren Buffett is a legendary investor.",
+    "The meeting with Sarah and John went well.",
+    "No specific people were mentioned.",
+  ];
+
+  console.log("\nRunning inference:");
+  for (const text of testCases) {
+    const result = await compiled.run({ text });
+    console.log(`\n  Input: "${text}"`);
+    console.log(
+      `  Names: ${
+        result.result.names.length > 0
+          ? result.result.names.join(", ")
+          : "(none)"
+      }`
+    );
+  }
+}
+
+main().catch(console.error);

package/examples/multi-provider.ts

@@ -0,0 +1,77 @@
+/**
+ * Multi-Provider Example
+ *
+ * Shows how to use different LLM providers with the same program
+ */
+
+import { defineSchema, Predict, createProvider, z } from "@mzhub/promptc";
+
+const SentimentAnalyzer = defineSchema({
+  description:
+    "Analyze the sentiment of text as positive, negative, or neutral",
+  inputs: { text: z.string() },
+  outputs: {
+    sentiment: z.enum(["positive", "negative", "neutral"]),
+    confidence: z.number(),
+  },
+});
+
+async function testProvider(providerName: string, apiKeyEnv: string) {
+  const apiKey = process.env[apiKeyEnv];
+  if (!apiKey) {
+    console.log(`⏭️ Skipping ${providerName} (no ${apiKeyEnv})`);
+    return;
+  }
+
+  try {
+    const provider = createProvider(providerName as any, { apiKey });
+    const program = new Predict(SentimentAnalyzer, provider);
+
+    const start = Date.now();
+    const result = await program.run({
+      text: "I absolutely love this product!",
+    });
+    const latency = Date.now() - start;
+
+    console.log(`\n✅ ${providerName}`);
+    console.log(`   Sentiment: ${result.result.sentiment}`);
+    console.log(
+      `   Confidence: ${(result.result.confidence * 100).toFixed(0)}%`
+    );
+    console.log(`   Latency: ${latency}ms`);
+    console.log(
+      `   Tokens: ${
+        result.trace.usage.inputTokens + result.trace.usage.outputTokens
+      }`
+    );
+  } catch (error: any) {
+    console.log(`\n❌ ${providerName}: ${error.message}`);
+  }
+}
+
+async function main() {
+  console.log("Testing sentiment analysis across providers...");
+
+  await testProvider("openai", "OPENAI_API_KEY");
+  await testProvider("anthropic", "ANTHROPIC_API_KEY");
+  await testProvider("google", "GOOGLE_API_KEY");
+  await testProvider("groq", "GROQ_API_KEY");
+  await testProvider("cerebras", "CEREBRAS_API_KEY");
+
+  // Ollama (local, no API key)
+  try {
+    const provider = createProvider("ollama");
+    const program = new Predict(SentimentAnalyzer, provider);
+    const start = Date.now();
+    const result = await program.run({
+      text: "I absolutely love this product!",
+    });
+    console.log(`\n✅ ollama (local)`);
+    console.log(`   Sentiment: ${result.result.sentiment}`);
+    console.log(`   Latency: ${Date.now() - start}ms`);
+  } catch {
+    console.log(`\n⏭️ Skipping ollama (not running locally)`);
+  }
+}
+
+main().catch(console.error);

package/examples/name-extractor.ts

@@ -0,0 +1,113 @@
+/**
+ * Name Extractor Example
+ *
+ * This example shows how to:
+ * 1. Define a schema
+ * 2. Create a program
+ * 3. Compile with BootstrapFewShot
+ * 4. Save and use the compiled program
+ */
+
+import { writeFileSync } from "fs";
+import {
+  defineSchema,
+  ChainOfThought,
+  BootstrapFewShot,
+  exactMatch,
+  createProvider,
+  createCompiledProgram,
+  z,
+} from "@mzhub/promptc";
+
+// 1. Define the schema
+const NameExtractor = defineSchema({
+  description: "Extract proper names of people from text",
+  inputs: { text: z.string() },
+  outputs: { names: z.array(z.string()) },
+});
+
+// 2. Create a provider (uses OPENAI_API_KEY env var)
+const provider = createProvider("openai", {
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+// 3. Create the program
+const program = new ChainOfThought(NameExtractor, provider);
+
+// 4. Training data
+const trainset = [
+  {
+    input: { text: "Bill Gates founded Microsoft with Paul Allen." },
+    output: { names: ["Bill Gates", "Paul Allen"] },
+  },
+  {
+    input: { text: "Elon Musk runs Tesla and SpaceX." },
+    output: { names: ["Elon Musk"] },
+  },
+  {
+    input: { text: "Jeff Bezos started Amazon in his garage." },
+    output: { names: ["Jeff Bezos"] },
+  },
+  {
+    input: { text: "Satya Nadella is the CEO of Microsoft." },
+    output: { names: ["Satya Nadella"] },
+  },
+  {
+    input: { text: "Tim Cook leads Apple after Steve Jobs." },
+    output: { names: ["Tim Cook", "Steve Jobs"] },
+  },
+  {
+    input: { text: "Mark Zuckerberg created Facebook." },
+    output: { names: ["Mark Zuckerberg"] },
+  },
+  {
+    input: { text: "Sundar Pichai runs Google and Alphabet." },
+    output: { names: ["Sundar Pichai"] },
+  },
+];
+
+async function main() {
+  console.log("Starting compilation...\n");
+
+  // 5. Create compiler with evaluator
+  const compiler = new BootstrapFewShot(exactMatch<{ names: string[] }>());
+
+  // 6. Compile with progress tracking
+  const result = await compiler.compile(program, trainset, {
+    candidates: 10,
+    concurrency: 3,
+    onProgress: ({
+      candidatesEvaluated,
+      totalCandidates,
+      currentBestScore,
+    }) => {
+      console.log(
+        `Progress: ${candidatesEvaluated}/${totalCandidates} | Best: ${(
+          currentBestScore * 100
+        ).toFixed(1)}%`
+      );
+    },
+  });
+
+  console.log("\nCompilation complete!");
+  console.log(`Best score: ${(result.meta.score * 100).toFixed(1)}%`);
+  console.log(`Tokens used: ${result.meta.tokenUsage.totalTokens}`);
+  console.log(`API calls: ${result.meta.tokenUsage.calls}`);
+
+  // 7. Save the compiled config
+  writeFileSync("name-extractor.json", JSON.stringify(result, null, 2));
+  console.log("\nSaved to name-extractor.json");
+
+  // 8. Create a production-ready compiled program
+  const compiled = createCompiledProgram(program, result);
+
+  // 9. Test it
+  console.log("\nTesting compiled program:");
+  const testResult = await compiled.run({
+    text: "Jensen Huang founded NVIDIA.",
+  });
+  console.log("Input: 'Jensen Huang founded NVIDIA.'");
+  console.log("Output:", testResult.result.names);
+}
+
+main().catch(console.error);

package/examples/qa-system.ts

@@ -0,0 +1,98 @@
+/**
+ * QA System with Chain of Thought
+ *
+ * Shows how to build a question-answering system
+ * that shows its reasoning before answering
+ */
+
+import {
+  defineSchema,
+  ChainOfThought,
+  BootstrapFewShot,
+  partialMatch,
+  createProvider,
+  z,
+} from "@mzhub/promptc";
+
+const QASchema = defineSchema({
+  description:
+    "Answer questions based on provided context. Think step by step.",
+  inputs: {
+    context: z.string().describe("The text containing information"),
+    question: z.string().describe("The question to answer"),
+  },
+  outputs: {
+    answer: z.string().describe("The answer extracted from context"),
+    confidence: z.number().min(0).max(1).describe("Confidence in the answer"),
+  },
+});
+
+const provider = createProvider("openai", {
+  apiKey: process.env.OPENAI_API_KEY,
+});
+
+const qaProgram = new ChainOfThought(QASchema, provider);
+
+const trainset = [
+  {
+    input: {
+      context:
+        "The Eiffel Tower was completed in 1889. It stands 330 meters tall and is located in Paris, France.",
+      question: "When was the Eiffel Tower completed?",
+    },
+    output: { answer: "1889", confidence: 0.95 },
+  },
+  {
+    input: {
+      context:
+        "Apple Inc. was founded by Steve Jobs, Steve Wozniak, and Ronald Wayne in 1976.",
+      question: "Who founded Apple?",
+    },
+    output: {
+      answer: "Steve Jobs, Steve Wozniak, and Ronald Wayne",
+      confidence: 0.95,
+    },
+  },
+  {
+    input: {
+      context:
+        "The speed of light is approximately 299,792 kilometers per second in a vacuum.",
+      question: "What is the speed of light?",
+    },
+    output: {
+      answer: "approximately 299,792 kilometers per second",
+      confidence: 0.9,
+    },
+  },
+];
+
+async function main() {
+  console.log("Building QA System with Chain of Thought...\n");
+
+  // Single inference to see the reasoning
+  const result = await qaProgram.run({
+    context:
+      "Python was created by Guido van Rossum and first released in 1991. It emphasizes code readability.",
+    question: "Who created Python?",
+  });
+
+  console.log("Question: Who created Python?");
+  console.log("\nReasoning:", result.trace.reasoning);
+  console.log("Answer:", result.result.answer);
+  console.log("Confidence:", `${(result.result.confidence * 100).toFixed(0)}%`);
+
+  // Optional: Compile for better accuracy
+  console.log("\n--- Compiling for better accuracy ---\n");
+
+  const compiler = new BootstrapFewShot(
+    partialMatch<{ answer: string; confidence: number }>()
+  );
+  const compiled = await compiler.compile(qaProgram, trainset, {
+    candidates: 5,
+    concurrency: 2,
+  });
+
+  console.log(`Compilation score: ${(compiled.meta.score * 100).toFixed(1)}%`);
+}
+
+main().catch(console.error);

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@mzhub/promptc",
+  "version": "0.1.0",
+  "description": "Type-safe LLM program compiler for JavaScript",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "promptc": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest"
+  },
+  "keywords": [
+    "llm",
+    "prompt",
+    "compiler",
+    "dspy",
+    "openai",
+    "anthropic",
+    "ai"
+  ],
+  "author": "Mudia Zuwa <mudiaosazuwa@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.24.0",
+    "p-limit": "^6.1.0"
+  },
+  "peerDependencies": {
+    "openai": "^4.0.0",
+    "@anthropic-ai/sdk": "^0.30.0",
+    "@google/generative-ai": "^0.21.0",
+    "ollama": "^0.5.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@google/generative-ai": {
+      "optional": true
+    },
+    "ollama": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "vitest": "^2.0.0"
+  }
+}