@virtualkitchenco/multiverse-sdk 0.0.1

package/dist/adapters/langchain.d.ts

@@ -0,0 +1,65 @@
+/**
+ * LangChain Adapter
+ *
+ * Provides wrap() integration for LangChain Runnables.
+ */
+import type { EffectsFn, Invariant, ZodLikeSchema } from '@virtualkitchenco/multiverse-types';
+/**
+ * Registry of tool configurations for simulation
+ * Maps tool name -> config with output schema, effects, invariants
+ */
+export declare const toolConfigRegistry: Map<string, {
+    outputSchema?: ZodLikeSchema;
+    effects?: EffectsFn<unknown>;
+    invariants?: Invariant[];
+}>;
+/**
+ * Configuration for wrapping a Runnable.
+ * TOutput is inferred from the Runnable being wrapped.
+ */
+export interface WrapConfig<TOutput = unknown> {
+    /** Name for the runnable (used in traces and simulation) */
+    name: string;
+    /** Description of what this runnable does */
+    description: string;
+    /** Zod-like schema for the output (helps simulation generate valid responses) */
+    outputSchema?: ZodLikeSchema;
+    /** Function to derive world state mutations from output */
+    effects?: EffectsFn<TOutput>;
+    /** Invariants to check after mutations */
+    invariants?: Invariant[];
+}
+/**
+ * Wrap any LangChain Runnable (tool, retriever, chain, etc.) for Multiverse simulation.
+ *
+ * During tests, calls are intercepted and simulated based on world state.
+ * In production, calls pass through to the real implementation.
+ *
+ * @example
+ * ```typescript
+ * import { wrap } from 'multiverse';
+ *
+ * // Wrap a retriever
+ * const wrappedRetriever = wrap(vectorStore.asRetriever(), {
+ *   name: 'documentRetriever',
+ *   description: 'Retrieves relevant documents from the knowledge base',
+ * });
+ *
+ * // Wrap a tool with effects
+ * const wrappedSearch = wrap(searchFlights, {
+ *   name: 'searchFlights',
+ *   description: 'Search for available flights',
+ *   outputSchema: SearchResultSchema,
+ *   effects: (output) => output.flights.map(f => ({
+ *     operation: 'create',
+ *     collection: 'flights',
+ *     id: f.id,
+ *     data: f,
+ *   })),
+ * });
+ * ```
+ */
+export declare function wrap<R extends {
+    invoke(input: unknown, ...rest: unknown[]): Promise<unknown>;
+}, TOutput = unknown>(runnable: R, config: WrapConfig<TOutput>): R;
+//# sourceMappingURL=langchain.d.ts.map

package/dist/adapters/langchain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.d.ts","sourceRoot":"","sources":["../../src/adapters/langchain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAG9F;;;GAGG;AACH,eAAO,MAAM,kBAAkB;mBACd,aAAa;cAClB,SAAS,CAAC,OAAO,CAAC;iBACf,SAAS,EAAE;EACtB,CAAC;AAEL;;;GAGG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO,GAAG,OAAO;IAC3C,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,IAAI,CAClB,CAAC,SAAS;IAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,EAC1E,OAAO,GAAG,OAAO,EAEjB,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,GAC1B,CAAC,CA4CH"}

package/dist/adapters/langchain.js

@@ -0,0 +1,80 @@
+/**
+ * LangChain Adapter
+ *
+ * Provides wrap() integration for LangChain Runnables.
+ */
+import { tool, registeredTools } from '../multiverse.js';
+/**
+ * Registry of tool configurations for simulation
+ * Maps tool name -> config with output schema, effects, invariants
+ */
+export const toolConfigRegistry = new Map();
+/**
+ * Wrap any LangChain Runnable (tool, retriever, chain, etc.) for Multiverse simulation.
+ *
+ * During tests, calls are intercepted and simulated based on world state.
+ * In production, calls pass through to the real implementation.
+ *
+ * @example
+ * ```typescript
+ * import { wrap } from 'multiverse';
+ *
+ * // Wrap a retriever
+ * const wrappedRetriever = wrap(vectorStore.asRetriever(), {
+ *   name: 'documentRetriever',
+ *   description: 'Retrieves relevant documents from the knowledge base',
+ * });
+ *
+ * // Wrap a tool with effects
+ * const wrappedSearch = wrap(searchFlights, {
+ *   name: 'searchFlights',
+ *   description: 'Search for available flights',
+ *   outputSchema: SearchResultSchema,
+ *   effects: (output) => output.flights.map(f => ({
+ *     operation: 'create',
+ *     collection: 'flights',
+ *     id: f.id,
+ *     data: f,
+ *   })),
+ * });
+ * ```
+ */
+export function wrap(runnable, config) {
+    const { name, description, outputSchema, effects, invariants } = config;
+    // Store in registry for simulation to access
+    if (outputSchema || effects) {
+        toolConfigRegistry.set(name, {
+            outputSchema,
+            effects: effects,
+            invariants,
+        });
+    }
+    // Create the wrapped invoke function using the core tool() infrastructure
+    const wrappedInvoke = tool(async (input) => runnable.invoke(input), {
+        name,
+        description,
+        outputSchema,
+        effects: effects,
+        invariants,
+    });
+    // Register the tool so it appears in getTools() and scenario generation
+    registeredTools.set(name, {
+        name,
+        description,
+        fn: wrappedInvoke,
+        outputSchema,
+        effects: effects,
+        invariants,
+    });
+    // Create a proxy that intercepts invoke() but preserves everything else
+    return new Proxy(runnable, {
+        get(target, prop, receiver) {
+            if (prop === 'invoke') {
+                return wrappedInvoke;
+            }
+            // Preserve all other properties/methods
+            return Reflect.get(target, prop, receiver);
+        },
+    });
+}
+//# sourceMappingURL=langchain.js.map

package/dist/adapters/langchain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.js","sourceRoot":"","sources":["../../src/adapters/langchain.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAIrC,CAAC;AAmBL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,IAAI,CAIlB,QAAW,EACX,MAA2B;IAE3B,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;IAExE,6CAA6C;IAC7C,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;QAC5B,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAE;YAC3B,YAAY;YACZ,OAAO,EAAE,OAA6B;YACtC,UAAU;SACX,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,MAAM,aAAa,GAAG,IAAI,CACxB,KAAK,EAAE,KAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAChD;QACE,IAAI;QACJ,WAAW;QACX,YAAY;QACZ,OAAO,EAAE,OAA6B;QACtC,UAAU;KACX,CACF,CAAC;IAEF,wEAAwE;IACxE,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE;QACxB,IAAI;QACJ,WAAW;QACX,EAAE,EAAE,aAAqD;QACzD,YAAY;QACZ,OAAO,EAAE,OAA6B;QACtC,UAAU;KACX,CAAC,CAAC;IAEH,wEAAwE;IACxE,OAAO,IAAI,KAAK,CAAC,QAAkB,EAAE;QACnC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtB,OAAO,aAAa,CAAC;YACvB,CAAC;YACD,wCAAwC;YACxC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7C,CAAC;KACF,CAAM,CAAC;AACV,CAAC"}

package/dist/ci.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CI Environment Detection
+ *
+ * Detects CI environment (CircleCI, GitHub Actions, etc.)
+ * and extracts PR/repo information.
+ */
+export interface CIContext {
+    provider: 'circleci' | 'github-actions' | 'unknown';
+    isCI: boolean;
+    isPR: boolean;
+    prNumber: number | null;
+    repo: {
+        owner: string;
+        name: string;
+    } | null;
+    branch: string | null;
+    sha: string | null;
+}
+/**
+ * Detect CI environment and extract context
+ */
+export declare function detectCI(): CIContext;
+/**
+ * Check if GitHub token is available
+ */
+export declare function hasGitHubToken(): boolean;
+/**
+ * Get GitHub token
+ */
+export declare function getGitHubToken(): string | null;
+//# sourceMappingURL=ci.d.ts.map

package/dist/ci.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.d.ts","sourceRoot":"","sources":["../src/ci.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,UAAU,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACpD,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,SAAS,CA2CpC;AAiDD;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,IAAI,CAE9C"}

package/dist/ci.js

@@ -0,0 +1,105 @@
+/**
+ * CI Environment Detection
+ *
+ * Detects CI environment (CircleCI, GitHub Actions, etc.)
+ * and extracts PR/repo information.
+ */
+/**
+ * Detect CI environment and extract context
+ */
+export function detectCI() {
+    // CircleCI
+    if (process.env.CIRCLECI === 'true') {
+        return {
+            provider: 'circleci',
+            isCI: true,
+            isPR: !!process.env.CIRCLE_PULL_REQUEST,
+            prNumber: extractCircleCIPRNumber(),
+            repo: extractCircleCIRepo(),
+            branch: process.env.CIRCLE_BRANCH || null,
+            sha: process.env.CIRCLE_SHA1 || null,
+        };
+    }
+    // GitHub Actions
+    if (process.env.GITHUB_ACTIONS === 'true') {
+        return {
+            provider: 'github-actions',
+            isCI: true,
+            isPR: process.env.GITHUB_EVENT_NAME === 'pull_request',
+            prNumber: extractGitHubActionsPRNumber(),
+            repo: extractGitHubActionsRepo(),
+            branch: process.env.GITHUB_HEAD_REF || process.env.GITHUB_REF_NAME || null,
+            sha: process.env.GITHUB_SHA || null,
+        };
+    }
+    // Generic CI detection
+    const isCI = !!(process.env.CI ||
+        process.env.CONTINUOUS_INTEGRATION ||
+        process.env.BUILD_NUMBER);
+    return {
+        provider: 'unknown',
+        isCI,
+        isPR: false,
+        prNumber: null,
+        repo: null,
+        branch: null,
+        sha: null,
+    };
+}
+/**
+ * Extract PR number from CircleCI environment
+ */
+function extractCircleCIPRNumber() {
+    const prUrl = process.env.CIRCLE_PULL_REQUEST;
+    if (!prUrl)
+        return null;
+    const match = prUrl.match(/\/pull\/(\d+)$/);
+    return match ? parseInt(match[1], 10) : null;
+}
+/**
+ * Extract repo info from CircleCI environment
+ */
+function extractCircleCIRepo() {
+    const owner = process.env.CIRCLE_PROJECT_USERNAME;
+    const name = process.env.CIRCLE_PROJECT_REPONAME;
+    if (!owner || !name)
+        return null;
+    return { owner, name };
+}
+/**
+ * Extract PR number from GitHub Actions environment
+ */
+function extractGitHubActionsPRNumber() {
+    // GITHUB_REF format for PRs: refs/pull/123/merge
+    const ref = process.env.GITHUB_REF;
+    if (!ref)
+        return null;
+    const match = ref.match(/^refs\/pull\/(\d+)\/merge$/);
+    return match ? parseInt(match[1], 10) : null;
+}
+/**
+ * Extract repo info from GitHub Actions environment
+ */
+function extractGitHubActionsRepo() {
+    // GITHUB_REPOSITORY format: owner/repo
+    const repo = process.env.GITHUB_REPOSITORY;
+    if (!repo)
+        return null;
+    const [owner, name] = repo.split('/');
+    if (!owner || !name)
+        return null;
+    return { owner, name };
+}
+/**
+ * Check if GitHub token is available
+ */
+export function hasGitHubToken() {
+    return !!process.env.GITHUB_TOKEN;
+}
+/**
+ * Get GitHub token
+ */
+export function getGitHubToken() {
+    return process.env.GITHUB_TOKEN || null;
+}
+//# sourceMappingURL=ci.js.map

package/dist/ci.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci.js","sourceRoot":"","sources":["../src/ci.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,WAAW;IACX,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QACpC,OAAO;YACL,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB;YACvC,QAAQ,EAAE,uBAAuB,EAAE;YACnC,IAAI,EAAE,mBAAmB,EAAE;YAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI;YACzC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,IAAI;SACrC,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,cAAc;YACtD,QAAQ,EAAE,4BAA4B,EAAE;YACxC,IAAI,EAAE,wBAAwB,EAAE;YAChC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI;YAC1E,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI;SACpC,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,MAAM,IAAI,GAAG,CAAC,CAAC,CACb,OAAO,CAAC,GAAG,CAAC,EAAE;QACd,OAAO,CAAC,GAAG,CAAC,sBAAsB;QAClC,OAAO,CAAC,GAAG,CAAC,YAAY,CACzB,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,IAAI;QACJ,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,IAAI;QACd,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,IAAI;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IAEjD,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,4BAA4B;IACnC,iDAAiD;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACnC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtD,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB;IAC/B,uCAAuC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC;AAC1C,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Multiverse API Client
+ *
+ * Thin client that calls the Multiverse API for all simulation logic.
+ */
+import type { Scenario, Trace, QualityResult } from '@virtualkitchenco/multiverse-types';
+export interface APIClientConfig {
+    baseUrl: string;
+    apiKey?: string;
+}
+export interface CreateSessionRequest {
+    task: string;
+    tools: Array<{
+        name: string;
+        description: string;
+    }>;
+    scenarioConfig?: {
+        count?: number;
+    };
+    seed?: Record<string, Record<string, unknown>>;
+    llmConfig: {
+        provider: string;
+        model?: string;
+    };
+}
+export interface SimulateRequest {
+    tool: string;
+    input: unknown;
+    description: string;
+    outputSchema?: unknown;
+    /** If true, client will compute effects - server should not apply LLM mutations */
+    hasClientEffects?: boolean;
+}
+export interface SimulateResponse {
+    output: unknown;
+    mutations: Array<{
+        operation: string;
+        collection: string;
+        id: string;
+        data?: Record<string, unknown>;
+    }>;
+    worldState: Record<string, unknown>;
+    analysis?: {
+        action: string;
+        matches: string[];
+        gaps: string[];
+        reasoning: string;
+    };
+}
+/**
+ * Multiverse API Client
+ */
+export declare class MultiverseClient {
+    private baseUrl;
+    private apiKey?;
+    constructor(config: APIClientConfig);
+    private request;
+    /**
+     * Create a new test session
+     */
+    createSession(request: CreateSessionRequest): Promise<{
+        sessionId: string;
+        scenarios: Scenario[];
+    }>;
+    /**
+     * Start a new run
+     */
+    createRun(sessionId: string, scenarioId: string, runIndex?: number): Promise<{
+        runId: string;
+        initialUserMessage: string;
+        worldState: Record<string, unknown>;
+    }>;
+    /**
+     * Simulate a tool call
+     */
+    simulate(sessionId: string, runId: string, request: SimulateRequest): Promise<SimulateResponse>;
+    /**
+     * Record a trace entry
+     */
+    recordTrace(sessionId: string, runId: string, type: 'user' | 'agent', message: string): Promise<void>;
+    /**
+     * Get user response (multi-turn)
+     */
+    getUserResponse(sessionId: string, runId: string, agentMessage: string): Promise<{
+        userMessage: string;
+        conversationComplete: boolean;
+        mood: number;
+    }>;
+    /**
+     * Get run state
+     */
+    getState(sessionId: string, runId: string): Promise<{
+        worldState: Record<string, unknown>;
+        trace: Trace;
+    }>;
+    /**
+     * Judge a run
+     */
+    judge(sessionId: string, runId: string, taskCompleted: boolean): Promise<QualityResult>;
+    /**
+     * Apply mutations to world state
+     */
+    applyMutations(sessionId: string, runId: string, mutations: Array<{
+        operation: 'create' | 'update' | 'delete';
+        collection: string;
+        id: string;
+        data?: Record<string, unknown>;
+    }>, tool?: string): Promise<void>;
+    /**
+     * Sync test results to server for dashboard
+     */
+    sync(results: {
+        id: string;
+        runs: Array<{
+            id: string;
+            runId: string;
+            testId: string;
+            scenario: Scenario;
+            trace: Trace;
+            taskCompleted: boolean;
+            quality: QualityResult;
+            passed: boolean;
+            duration: number;
+        }>;
+        passRate: number;
+        weakSpots: Array<{
+            scenario: string;
+            passRate: number;
+        }>;
+        duration: number;
+    }): Promise<{
+        success: boolean;
+        url: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,92 @@
+/**
+ * Multiverse API Client
+ *
+ * Thin client that calls the Multiverse API for all simulation logic.
+ */
+/**
+ * Multiverse API Client
+ */
+export class MultiverseClient {
+    baseUrl;
+    apiKey;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, ''); // Remove trailing slash
+        this.apiKey = config.apiKey;
+    }
+    async request(method, path, body) {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.apiKey) {
+            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`API error ${response.status}: ${error}`);
+        }
+        return response.json();
+    }
+    /**
+     * Create a new test session
+     */
+    async createSession(request) {
+        return this.request('POST', '/api/sessions', request);
+    }
+    /**
+     * Start a new run
+     */
+    async createRun(sessionId, scenarioId, runIndex = 0) {
+        return this.request('POST', `/api/sessions/${sessionId}/runs`, {
+            scenarioId,
+            runIndex,
+        });
+    }
+    /**
+     * Simulate a tool call
+     */
+    async simulate(sessionId, runId, request) {
+        return this.request('POST', `/api/sessions/${sessionId}/runs/${runId}/simulate`, request);
+    }
+    /**
+     * Record a trace entry
+     */
+    async recordTrace(sessionId, runId, type, message) {
+        await this.request('POST', `/api/sessions/${sessionId}/runs/${runId}/trace`, { type, message });
+    }
+    /**
+     * Get user response (multi-turn)
+     */
+    async getUserResponse(sessionId, runId, agentMessage) {
+        return this.request('POST', `/api/sessions/${sessionId}/runs/${runId}/user-respond`, { agentMessage });
+    }
+    /**
+     * Get run state
+     */
+    async getState(sessionId, runId) {
+        return this.request('GET', `/api/sessions/${sessionId}/runs/${runId}/state`);
+    }
+    /**
+     * Judge a run
+     */
+    async judge(sessionId, runId, taskCompleted) {
+        return this.request('POST', `/api/sessions/${sessionId}/runs/${runId}/judge`, { taskCompleted });
+    }
+    /**
+     * Apply mutations to world state
+     */
+    async applyMutations(sessionId, runId, mutations, tool) {
+        await this.request('POST', `/api/sessions/${sessionId}/runs/${runId}/mutations`, { mutations, tool });
+    }
+    /**
+     * Sync test results to server for dashboard
+     */
+    async sync(results) {
+        return this.request('POST', '/api/sync', results);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/github.d.ts

@@ -0,0 +1,35 @@
+/**
+ * GitHub PR Integration
+ *
+ * Posts report cards to GitHub PRs via the GitHub API.
+ */
+import type { CIContext } from './ci.js';
+export interface GitHubOptions {
+    token: string;
+    owner: string;
+    repo: string;
+    prNumber: number;
+}
+/**
+ * Post or update a comment on a GitHub PR
+ *
+ * Uses a marker comment to find and update existing comments
+ * instead of creating duplicates on each run.
+ */
+export declare function postToPR(markdown: string, options: GitHubOptions): Promise<{
+    commentId: number;
+    url: string;
+}>;
+/**
+ * Build GitHub options from CI context
+ */
+export declare function buildGitHubOptions(ci: CIContext, token: string): GitHubOptions | null;
+/**
+ * Post report to PR if running in CI with appropriate context
+ */
+export declare function postReportToPR(markdown: string, ci: CIContext): Promise<{
+    posted: boolean;
+    url?: string;
+    error?: string;
+}>;
+//# sourceMappingURL=github.d.ts.map

package/dist/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../src/github.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAuD7C;AAsCD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,MAAM,GACZ,aAAa,GAAG,IAAI,CAWtB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,SAAS,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB5D"}