@manifesto-ai/compiler 1.0.0

package/dist/__tests__/telemetry.test.js

@@ -0,0 +1,207 @@
+import { describe, it, expect, vi } from "vitest";
+import { createCompiler } from "../api/factory.js";
+import { createSuccessMockAdapter, createResolutionMockAdapter, createInvalidDraftMockAdapter, createSegmentFailMockAdapter, } from "./helpers/mock-adapter.js";
+describe("CompilerTelemetry", () => {
+    describe("onPhaseChange", () => {
+        it("should call onPhaseChange for each status transition", async () => {
+            const onPhaseChange = vi.fn();
+            const telemetry = { onPhaseChange };
+            const adapter = createSuccessMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+            });
+            await compiler.start({ text: "Create a counter" });
+            // Should have been called for transitions
+            expect(onPhaseChange).toHaveBeenCalled();
+            // Verify specific transitions
+            const calls = onPhaseChange.mock.calls;
+            const transitions = calls.map(([from, to]) => `${from}→${to}`);
+            expect(transitions).toContain("idle→segmenting");
+            expect(transitions).toContain("segmenting→normalizing");
+            expect(transitions).toContain("normalizing→proposing");
+            expect(transitions).toContain("proposing→validating");
+            // Final transition to success
+            expect(transitions.some((t) => t.endsWith("→success"))).toBe(true);
+        });
+    });
+    describe("onComplete", () => {
+        it("should call onComplete on success", async () => {
+            const onComplete = vi.fn();
+            const telemetry = { onComplete };
+            const adapter = createSuccessMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+            });
+            await compiler.start({ text: "Create a counter" });
+            expect(onComplete).toHaveBeenCalledTimes(1);
+            expect(onComplete).toHaveBeenCalledWith(expect.objectContaining({
+                status: "success",
+                isTerminal: true,
+                result: expect.anything(),
+            }));
+        });
+        it("should call onComplete on discard", async () => {
+            const onComplete = vi.fn();
+            const telemetry = { onComplete };
+            const adapter = createSegmentFailMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+            });
+            await compiler.start({ text: "Something" });
+            expect(onComplete).toHaveBeenCalledTimes(1);
+            expect(onComplete).toHaveBeenCalledWith(expect.objectContaining({
+                status: "discarded",
+                isTerminal: true,
+            }));
+        });
+    });
+    describe("onAttempt", () => {
+        // Note: The current domain implementation increments attemptCount but
+        // doesn't populate the attempts array. onAttempt would be called if
+        // attempts were recorded. This test documents the current behavior.
+        it("should track attempt count on retries (attempts array not implemented)", async () => {
+            const onAttempt = vi.fn();
+            const onPhaseChange = vi.fn();
+            const telemetry = { onAttempt, onPhaseChange };
+            const adapter = createInvalidDraftMockAdapter(2);
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+                traceDrafts: true,
+                maxRetries: 5,
+            });
+            await compiler.start({ text: "Create a counter" });
+            // Verify retries happened via phase changes (proposing appears multiple times)
+            const proposingCount = onPhaseChange.mock.calls
+                .filter(([, to]) => to === "proposing").length;
+            expect(proposingCount).toBeGreaterThan(1); // At least initial + 1 retry
+            // onAttempt is not called because attempts array is not populated
+            // This is expected behavior of current implementation
+            expect(onAttempt).not.toHaveBeenCalled();
+        });
+        it("should not call onAttempt when traceDrafts is false", async () => {
+            const onAttempt = vi.fn();
+            const telemetry = { onAttempt };
+            const adapter = createSuccessMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+                traceDrafts: false,
+            });
+            await compiler.start({ text: "Create a counter" });
+            expect(onAttempt).not.toHaveBeenCalled();
+        });
+    });
+    describe("onResolutionRequested", () => {
+        it("should call onResolutionRequested when resolution is needed", async () => {
+            const onResolutionRequested = vi.fn();
+            const telemetry = { onResolutionRequested };
+            const adapter = createResolutionMockAdapter("Ambiguous input");
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+                resolutionPolicy: { onResolutionRequired: "await" },
+            });
+            await compiler.start({ text: "Track items" });
+            expect(onResolutionRequested).toHaveBeenCalledTimes(1);
+            expect(onResolutionRequested).toHaveBeenCalledWith("Ambiguous input", expect.arrayContaining([
+                expect.objectContaining({ id: "option1" }),
+                expect.objectContaining({ id: "option2" }),
+            ]));
+        });
+    });
+    describe("onEffectStart and onEffectEnd", () => {
+        it("should call onEffectStart before each effect", async () => {
+            const onEffectStart = vi.fn();
+            const telemetry = { onEffectStart };
+            const adapter = createSuccessMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+            });
+            await compiler.start({ text: "Create a counter" });
+            expect(onEffectStart).toHaveBeenCalled();
+            // Check that all effect types were started
+            const effectTypes = onEffectStart.mock.calls.map(([type]) => type);
+            expect(effectTypes).toContain("llm:segment");
+            expect(effectTypes).toContain("llm:normalize");
+            expect(effectTypes).toContain("llm:propose");
+            expect(effectTypes).toContain("builder:validate");
+        });
+        it("should call onEffectEnd after each effect", async () => {
+            const onEffectEnd = vi.fn();
+            const telemetry = { onEffectEnd };
+            const adapter = createSuccessMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+            });
+            await compiler.start({ text: "Create a counter" });
+            expect(onEffectEnd).toHaveBeenCalled();
+            // Check that effects completed with results
+            const effectResults = onEffectEnd.mock.calls.map(([type, result]) => ({
+                type,
+                action: result.action,
+            }));
+            expect(effectResults).toContainEqual({
+                type: "llm:segment",
+                action: "receiveSegments",
+            });
+        });
+    });
+    describe("onError", () => {
+        it("should call onError on effect failure", async () => {
+            const onError = vi.fn();
+            const telemetry = { onError };
+            // Create adapter that throws an error
+            const adapter = {
+                segment: vi.fn().mockRejectedValue(new Error("Network failure")),
+                normalize: vi.fn(),
+                propose: vi.fn(),
+            };
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+            });
+            await expect(compiler.start({ text: "Create a counter" })).rejects.toThrow("Network failure");
+            expect(onError).toHaveBeenCalled();
+            expect(onError).toHaveBeenCalledWith(expect.objectContaining({ message: "Network failure" }), expect.stringContaining("effect:llm:segment"));
+        });
+    });
+    describe("full telemetry integration", () => {
+        it("should call all telemetry hooks in a successful flow", async () => {
+            const telemetry = {
+                onPhaseChange: vi.fn(),
+                onComplete: vi.fn(),
+                onEffectStart: vi.fn(),
+                onEffectEnd: vi.fn(),
+            };
+            const adapter = createSuccessMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                telemetry,
+            });
+            await compiler.start({ text: "Create a counter" });
+            // All hooks should have been called
+            expect(telemetry.onPhaseChange).toHaveBeenCalled();
+            expect(telemetry.onComplete).toHaveBeenCalled();
+            expect(telemetry.onEffectStart).toHaveBeenCalled();
+            expect(telemetry.onEffectEnd).toHaveBeenCalled();
+        });
+        it("should work without telemetry (telemetry is optional)", async () => {
+            const adapter = createSuccessMockAdapter();
+            const compiler = createCompiler({
+                llmAdapter: adapter,
+                // No telemetry provided
+            });
+            // Should not throw
+            await compiler.start({ text: "Create a counter" });
+            const snapshot = await compiler.getSnapshot();
+            expect(snapshot.status).toBe("success");
+        });
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

package/dist/__tests__/telemetry.test.js.map

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

package/dist/api/compiler.d.ts

@@ -0,0 +1,86 @@
+import type { Compiler, CompilerSnapshot, CompileInput, Unsubscribe, DiscardReason, LLMAdapter, CompilerResolutionPolicy, CompilerTelemetry } from "../domain/types.js";
+/**
+ * ManifestoCompiler - Implementation of the Compiler interface
+ *
+ * Per FDR-C001: Compiler is implemented as a Manifesto Application.
+ * This class wraps the CompilerDomain Host and provides the public API.
+ */
+export declare class ManifestoCompiler implements Compiler {
+    private host;
+    private listeners;
+    private effectHandlers;
+    private policy;
+    private telemetry?;
+    private previousStatus;
+    constructor(adapter: LLMAdapter, options?: {
+        maxRetries?: number;
+        traceDrafts?: boolean;
+        resolutionPolicy?: CompilerResolutionPolicy;
+        telemetry?: CompilerTelemetry;
+    });
+    /**
+     * Start compilation with input
+     */
+    start(input: CompileInput): Promise<void>;
+    /**
+     * Get current snapshot
+     */
+    getSnapshot(): Promise<CompilerSnapshot>;
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(callback: (state: CompilerSnapshot) => void): Unsubscribe;
+    /**
+     * Dispatch an action
+     */
+    dispatch(action: string, input?: unknown): Promise<void>;
+    /**
+     * Resolve ambiguity
+     */
+    resolve(selectedOptionId: string): Promise<void>;
+    /**
+     * Discard compilation
+     */
+    discard(reason?: DiscardReason): Promise<void>;
+    /**
+     * Reset to idle
+     */
+    reset(): Promise<void>;
+    /**
+     * Dispatch intent and handle effects in a loop
+     *
+     * This implements the effect execution loop that the Host normally handles.
+     * We need custom logic because our effect handlers return actions to dispatch.
+     */
+    private dispatchWithEffectLoop;
+    /**
+     * Check if snapshot has pending effects
+     */
+    private hasPendingEffects;
+    /**
+     * Extract pending effects from snapshot
+     */
+    private extractPendingEffects;
+    /**
+     * Notify all listeners of state change
+     */
+    private notifyListeners;
+    /**
+     * Emit telemetry for phase changes
+     * Per SPEC §15.2
+     */
+    private emitPhaseChange;
+    /**
+     * Execute effect with telemetry
+     */
+    private executeEffect;
+    /**
+     * Emit attempt telemetry
+     */
+    private emitAttempt;
+    /**
+     * Convert Host Snapshot to CompilerSnapshot
+     */
+    private toCompilerSnapshot;
+}
+//# sourceMappingURL=compiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/api/compiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAGhB,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,wBAAwB,EACxB,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAO5B;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAChD,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,cAAc,CAAuF;IAC7G,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,SAAS,CAAC,CAAoB;IACtC,OAAO,CAAC,cAAc,CAA0B;gBAG9C,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE;QACP,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;QAC5C,SAAS,CAAC,EAAE,iBAAiB,CAAC;KAC1B;IAoCR;;OAEG;IACG,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAQ9C;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,GAAG,WAAW;IAKnE;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D;;OAEG;IACG,OAAO,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;OAEG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;;;OAKG;YACW,sBAAsB;IA6DpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+C7B;;OAEG;YACW,eAAe;IAW7B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAuBvB;;OAEG;YACW,aAAa;IA0B3B;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAoB3B"}

package/dist/api/compiler.js

@@ -0,0 +1,302 @@
+import { createHost, createIntent } from "@manifesto-ai/host";
+import { CompilerDomain, INITIAL_STATE } from "../domain/domain.js";
+import { createLLMEffectHandlers, createBuilderValidateHandler, } from "../effects/index.js";
+/**
+ * ManifestoCompiler - Implementation of the Compiler interface
+ *
+ * Per FDR-C001: Compiler is implemented as a Manifesto Application.
+ * This class wraps the CompilerDomain Host and provides the public API.
+ */
+export class ManifestoCompiler {
+    host;
+    listeners = new Set();
+    effectHandlers;
+    policy;
+    telemetry;
+    previousStatus = "idle";
+    constructor(adapter, options = {}) {
+        this.policy = options.resolutionPolicy ?? { onResolutionRequired: "discard" };
+        this.telemetry = options.telemetry;
+        // Create effect handlers
+        const llmHandlers = createLLMEffectHandlers(adapter, this.policy);
+        const builderHandler = createBuilderValidateHandler();
+        this.effectHandlers = {
+            ...llmHandlers,
+            "builder:validate": builderHandler,
+        };
+        // Create Host with CompilerDomain
+        this.host = createHost(CompilerDomain.schema, {
+            initialData: {
+                ...INITIAL_STATE,
+                maxRetries: options.maxRetries ?? INITIAL_STATE.maxRetries,
+                traceDrafts: options.traceDrafts ?? INITIAL_STATE.traceDrafts,
+            },
+        });
+        // Register effect handlers with Host
+        for (const [type, handler] of Object.entries(this.effectHandlers)) {
+            this.host.registerEffect(type, async (effectType, params) => {
+                // Execute the handler
+                const result = await handler(params);
+                // Return patches that schedule the next action
+                // The Host will apply these and continue the loop
+                return [];
+            });
+        }
+    }
+    /**
+     * Start compilation with input
+     */
+    async start(input) {
+        const intent = createIntent("start", {
+            text: input.text,
+            schema: input.schema,
+            context: input.context,
+            maxRetries: input.maxRetries,
+            traceDrafts: input.traceDrafts,
+        });
+        await this.dispatchWithEffectLoop(intent);
+    }
+    /**
+     * Get current snapshot
+     */
+    async getSnapshot() {
+        const snapshot = await this.host.getSnapshot();
+        if (!snapshot) {
+            throw new Error("Host not initialized");
+        }
+        return this.toCompilerSnapshot(snapshot);
+    }
+    /**
+     * Subscribe to state changes
+     */
+    subscribe(callback) {
+        this.listeners.add(callback);
+        return () => this.listeners.delete(callback);
+    }
+    /**
+     * Dispatch an action
+     */
+    async dispatch(action, input) {
+        const intent = createIntent(action, input ?? {});
+        await this.dispatchWithEffectLoop(intent);
+    }
+    /**
+     * Resolve ambiguity
+     */
+    async resolve(selectedOptionId) {
+        await this.dispatch("resolve", { selectedOptionId });
+    }
+    /**
+     * Discard compilation
+     */
+    async discard(reason) {
+        await this.dispatch("discard", { reason: reason ?? "RESOLUTION_REQUIRED_BUT_DISABLED" });
+    }
+    /**
+     * Reset to idle
+     */
+    async reset() {
+        await this.dispatch("reset", {});
+    }
+    /**
+     * Dispatch intent and handle effects in a loop
+     *
+     * This implements the effect execution loop that the Host normally handles.
+     * We need custom logic because our effect handlers return actions to dispatch.
+     */
+    async dispatchWithEffectLoop(intent) {
+        // Track previous attempt count to detect new attempts
+        let previousAttemptCount = 0;
+        try {
+            // Dispatch the initial intent
+            const result = await this.host.dispatch(intent);
+            // Debug: Check dispatch result
+            if (process.env.DEBUG) {
+                console.log("[Compiler] Dispatch result:", {
+                    action: intent.type,
+                    hostStatus: result.status,
+                    error: result.error,
+                    stateStatus: result.snapshot.data.status,
+                    traces: result.traces?.length ?? 0,
+                });
+            }
+            // Get the current snapshot to check for pending effects
+            let snapshot = result.snapshot;
+            let compilerSnapshot = this.toCompilerSnapshot(snapshot);
+            // Emit initial phase change
+            this.emitPhaseChange(compilerSnapshot);
+            previousAttemptCount = compilerSnapshot.attemptCount;
+            // Process pending effects
+            while (this.hasPendingEffects(snapshot)) {
+                const effects = this.extractPendingEffects(snapshot);
+                for (const effect of effects) {
+                    // Execute effect with telemetry
+                    const handlerResult = await this.executeEffect(effect.type, effect.params);
+                    // Dispatch the resulting action
+                    const nextIntent = createIntent(handlerResult.action, handlerResult.input);
+                    const nextResult = await this.host.dispatch(nextIntent);
+                    snapshot = nextResult.snapshot;
+                    compilerSnapshot = this.toCompilerSnapshot(snapshot);
+                    // Emit phase change
+                    this.emitPhaseChange(compilerSnapshot);
+                    // Emit attempt if new attempt was recorded
+                    if (compilerSnapshot.attemptCount > previousAttemptCount) {
+                        this.emitAttempt(compilerSnapshot);
+                        previousAttemptCount = compilerSnapshot.attemptCount;
+                    }
+                }
+            }
+            // Notify listeners
+            await this.notifyListeners();
+        }
+        catch (error) {
+            // Emit error telemetry
+            this.telemetry?.onError?.(error, `dispatch:${intent.type}`);
+            throw error;
+        }
+    }
+    /**
+     * Check if snapshot has pending effects
+     */
+    hasPendingEffects(snapshot) {
+        // Check trace for effect nodes
+        const data = snapshot.data;
+        const status = data.status;
+        // Effects are triggered during state transitions
+        // We detect pending effects by checking if we're in a transitional state
+        return (status === "segmenting" ||
+            status === "normalizing" ||
+            status === "proposing" ||
+            status === "validating");
+    }
+    /**
+     * Extract pending effects from snapshot
+     */
+    extractPendingEffects(snapshot) {
+        const data = snapshot.data;
+        const status = data.status;
+        // Map status to effect type
+        switch (status) {
+            case "segmenting":
+                return [{ type: "llm:segment", params: { text: data.input } }];
+            case "normalizing":
+                return [
+                    {
+                        type: "llm:normalize",
+                        params: {
+                            segments: data.segments,
+                            schema: data.targetSchema,
+                            context: data.context,
+                        },
+                    },
+                ];
+            case "proposing":
+                return [
+                    {
+                        type: "llm:propose",
+                        params: {
+                            schema: data.targetSchema,
+                            intents: data.intents,
+                            history: data.attempts,
+                            context: data.context,
+                        },
+                    },
+                ];
+            case "validating":
+                return [
+                    {
+                        type: "builder:validate",
+                        params: { draft: data.currentDraft },
+                    },
+                ];
+            default:
+                return [];
+        }
+    }
+    /**
+     * Notify all listeners of state change
+     */
+    async notifyListeners() {
+        const snapshot = await this.getSnapshot();
+        for (const listener of this.listeners) {
+            try {
+                listener(snapshot);
+            }
+            catch (error) {
+                console.error("Listener error:", error);
+            }
+        }
+    }
+    /**
+     * Emit telemetry for phase changes
+     * Per SPEC §15.2
+     */
+    emitPhaseChange(snapshot) {
+        const newStatus = snapshot.status;
+        // Emit phase change if status changed
+        if (this.previousStatus !== newStatus) {
+            this.telemetry?.onPhaseChange?.(this.previousStatus, newStatus);
+            this.previousStatus = newStatus;
+        }
+        // Emit resolution requested if awaiting resolution
+        if (newStatus === "awaiting_resolution" && snapshot.resolutionReason) {
+            this.telemetry?.onResolutionRequested?.(snapshot.resolutionReason, snapshot.resolutionOptions);
+        }
+        // Emit complete if terminal
+        if (snapshot.isTerminal) {
+            this.telemetry?.onComplete?.(snapshot);
+        }
+    }
+    /**
+     * Execute effect with telemetry
+     */
+    async executeEffect(effectType, params) {
+        const handler = this.effectHandlers[effectType];
+        if (!handler) {
+            throw new Error(`No handler for effect type: ${effectType}`);
+        }
+        // Emit effect start
+        this.telemetry?.onEffectStart?.(effectType, params);
+        try {
+            const result = await handler(params);
+            // Emit effect end
+            this.telemetry?.onEffectEnd?.(effectType, result);
+            return result;
+        }
+        catch (error) {
+            // Emit error
+            this.telemetry?.onError?.(error, `effect:${effectType}`);
+            throw error;
+        }
+    }
+    /**
+     * Emit attempt telemetry
+     */
+    emitAttempt(snapshot) {
+        if (snapshot.traceDrafts && snapshot.attempts.length > 0) {
+            const latestAttempt = snapshot.attempts[snapshot.attempts.length - 1];
+            this.telemetry?.onAttempt?.(latestAttempt);
+        }
+    }
+    /**
+     * Convert Host Snapshot to CompilerSnapshot
+     */
+    toCompilerSnapshot(snapshot) {
+        const data = snapshot.data;
+        const computed = snapshot.computed ?? {};
+        return {
+            ...data,
+            // Computed values
+            isIdle: computed["computed.isIdle"] ?? data.status === "idle",
+            isSegmenting: computed["computed.isSegmenting"] ?? data.status === "segmenting",
+            isNormalizing: computed["computed.isNormalizing"] ?? data.status === "normalizing",
+            isProposing: computed["computed.isProposing"] ?? data.status === "proposing",
+            isValidating: computed["computed.isValidating"] ?? data.status === "validating",
+            isAwaitingResolution: computed["computed.isAwaitingResolution"] ?? data.status === "awaiting_resolution",
+            isTerminal: computed["computed.isTerminal"] ??
+                (data.status === "success" || data.status === "discarded"),
+            canRetry: computed["computed.canRetry"] ?? data.attemptCount < data.maxRetries,
+        };
+    }
+}
+//# sourceMappingURL=compiler.js.map

package/dist/api/compiler.js.map

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

package/dist/api/factory.d.ts

@@ -0,0 +1,27 @@
+import type { Compiler, CompilerOptions } from "../domain/types.js";
+/**
+ * Create a new Compiler instance
+ *
+ * @param options - Compiler configuration options
+ * @returns Compiler instance
+ *
+ * @example
+ * ```typescript
+ * // With Anthropic (default)
+ * const compiler = createCompiler({
+ *   anthropic: { apiKey: process.env.ANTHROPIC_API_KEY },
+ * });
+ *
+ * // With OpenAI
+ * const compiler = createCompiler({
+ *   openai: { apiKey: process.env.OPENAI_API_KEY },
+ * });
+ *
+ * // With custom LLM adapter
+ * const compiler = createCompiler({
+ *   llmAdapter: myCustomAdapter,
+ * });
+ * ```
+ */
+export declare function createCompiler(options?: CompilerOptions): Compiler;
+//# sourceMappingURL=factory.d.ts.map

package/dist/api/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/api/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAwC,MAAM,oBAAoB,CAAC;AA+B1G;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CAStE"}