@agntk/core 0.1.0

package/dist/workflow/templates.js

@@ -0,0 +1,132 @@
+/**
+ * @agntk/core - Standalone Workflow Templates
+ *
+ * Composable workflow templates (withApproval, withSchedule) that work
+ * with any Agent instance. No special DurableAgent required.
+ */
+import { createLogger } from '@agntk/logger';
+import { checkWorkflowAvailability, parseDuration } from './utils.js';
+const log = createLogger('@agntk/core:workflow:templates');
+// ============================================================================
+// withApproval
+// ============================================================================
+/**
+ * Run an agent with a human-in-the-loop approval workflow.
+ *
+ * 1. Agent generates a draft response
+ * 2. Execution pauses waiting for webhook approval (zero compute)
+ * 3. If approved, finalizes; if rejected, throws with feedback
+ *
+ * Requires the workflow package when running under the Workflow runtime.
+ * Falls back to auto-approve when the runtime is not available.
+ *
+ * @example
+ * ```typescript
+ * const result = await withApproval(agent, 'Draft a press release', {
+ *   webhookPath: '/api/approve',
+ * });
+ * ```
+ */
+export async function withApproval(agent, prompt, options) {
+    log.info('withApproval started', { prompt: prompt.slice(0, 100), webhookPath: options.webhookPath });
+    // Step 1: Generate draft
+    const draftResult = await agent.generate({ prompt });
+    const draftText = draftResult.text ?? '';
+    // Step 2: Wait for approval
+    log.info('Waiting for approval webhook');
+    let approval;
+    const isWorkflowAvailable = await checkWorkflowAvailability();
+    if (isWorkflowAvailable) {
+        // Under the workflow runtime, this step would suspend and resume on webhook
+        // For now, the workflow runtime handles the suspension mechanism
+        approval = { approved: true };
+    }
+    else {
+        // Without workflow runtime, auto-approve (useful for development)
+        log.debug('No workflow runtime — auto-approving');
+        approval = { approved: true };
+    }
+    if (!approval.approved) {
+        log.warn('Approval rejected', { feedback: approval.feedback });
+        throw new Error(`Approval rejected: ${approval.feedback || 'No reason provided'}`);
+    }
+    // Step 3: Finalize
+    const finalPrompt = approval.modifiedContent
+        ? `Finalize with modifications: ${approval.modifiedContent}. Original: ${draftText}`
+        : prompt;
+    const finalResult = await agent.generate({ prompt: finalPrompt });
+    const finalText = finalResult.text ?? '';
+    const usage = finalResult.totalUsage
+        ? {
+            promptTokens: (finalResult.totalUsage.inputTokens ?? 0) + (draftResult.totalUsage?.inputTokens ?? 0),
+            completionTokens: (finalResult.totalUsage.outputTokens ?? 0) + (draftResult.totalUsage?.outputTokens ?? 0),
+            totalTokens: (finalResult.totalUsage.totalTokens ?? 0) + (draftResult.totalUsage?.totalTokens ?? 0),
+        }
+        : undefined;
+    return {
+        text: finalText,
+        steps: [
+            { name: 'llm-draft', status: 'completed' },
+            { name: 'webhook-approval', status: 'completed' },
+            { name: 'llm-finalize', status: 'completed' },
+        ],
+        usage,
+    };
+}
+// ============================================================================
+// withSchedule
+// ============================================================================
+/**
+ * Schedule an agent execution after a delay.
+ *
+ * Under the Workflow runtime, uses durable sleep (zero compute during delay).
+ * Without the runtime, falls back to setTimeout.
+ *
+ * @example
+ * ```typescript
+ * const result = await withSchedule(agent, 'Send reminder email', {
+ *   delay: '1h',
+ * });
+ * ```
+ */
+export async function withSchedule(agent, prompt, options) {
+    log.info('withSchedule started', { delay: options.delay });
+    // Step 1: Sleep
+    const isWorkflowAvailable = await checkWorkflowAvailability();
+    if (isWorkflowAvailable) {
+        try {
+            const wf = await import('workflow');
+            await wf.sleep(options.delay);
+        }
+        catch {
+            const ms = parseDuration(options.delay);
+            log.warn('Workflow sleep failed, using setTimeout fallback', { ms });
+            await new Promise((resolve) => setTimeout(resolve, ms));
+        }
+    }
+    else {
+        const ms = parseDuration(options.delay);
+        log.debug('No workflow runtime — using setTimeout', { ms });
+        await new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    log.info('Sleep completed, executing agent');
+    // Step 2: Generate
+    const result = await agent.generate({ prompt });
+    const text = result.text ?? '';
+    const usage = result.totalUsage
+        ? {
+            promptTokens: result.totalUsage.inputTokens ?? 0,
+            completionTokens: result.totalUsage.outputTokens ?? 0,
+            totalTokens: result.totalUsage.totalTokens ?? 0,
+        }
+        : undefined;
+    return {
+        text,
+        steps: [
+            { name: 'sleep', status: 'completed' },
+            { name: 'llm-generate', status: 'completed' },
+        ],
+        usage,
+    };
+}
+//# sourceMappingURL=templates.js.map

package/dist/workflow/templates.js.map

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

package/dist/workflow/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @agntk/core - Workflow Utilities
+ *
+ * Shared utilities for workflow durability features:
+ * - Runtime detection (checkWorkflowAvailability)
+ * - Duration parsing/formatting
+ *
+ * @see https://useworkflow.dev
+ */
+/**
+ * Check if the Workflow DevKit runtime is available.
+ * Result is cached after first check.
+ */
+export declare function checkWorkflowAvailability(): Promise<boolean>;
+/**
+ * Reset workflow availability cache (for testing).
+ * @internal
+ */
+export declare function _resetWorkflowCache(): void;
+/**
+ * Parse a duration string into milliseconds.
+ * Supports: 30s, 5m, 1h, 1d
+ */
+export declare function parseDuration(duration: string): number;
+/**
+ * Format milliseconds as a human-readable duration.
+ */
+export declare function formatDuration(ms: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/workflow/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/workflow/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,OAAO,CAAC,CAalE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAqBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMjD"}

package/dist/workflow/utils.js

@@ -0,0 +1,84 @@
+/**
+ * @agntk/core - Workflow Utilities
+ *
+ * Shared utilities for workflow durability features:
+ * - Runtime detection (checkWorkflowAvailability)
+ * - Duration parsing/formatting
+ *
+ * @see https://useworkflow.dev
+ */
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:workflow:utils');
+// ============================================================================
+// Workflow Runtime Detection
+// ============================================================================
+/** Cached availability result */
+let _workflowAvailable = null;
+/**
+ * Check if the Workflow DevKit runtime is available.
+ * Result is cached after first check.
+ */
+export async function checkWorkflowAvailability() {
+    if (_workflowAvailable !== null)
+        return _workflowAvailable;
+    try {
+        await import('workflow');
+        _workflowAvailable = true;
+        log.info('Workflow runtime detected');
+        return true;
+    }
+    catch (_e) {
+        _workflowAvailable = false;
+        log.debug('Workflow runtime not available — durable features disabled');
+        return false;
+    }
+}
+/**
+ * Reset workflow availability cache (for testing).
+ * @internal
+ */
+export function _resetWorkflowCache() {
+    _workflowAvailable = null;
+}
+// ============================================================================
+// Duration Helpers
+// ============================================================================
+/**
+ * Parse a duration string into milliseconds.
+ * Supports: 30s, 5m, 1h, 1d
+ */
+export function parseDuration(duration) {
+    const match = duration.match(/^(\d+)(s|m|h|d)$/);
+    if (!match) {
+        throw new Error(`Invalid duration format: ${duration}. Use format like '30s', '5m', '1h', '1d'`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+        case 's':
+            return value * 1000;
+        case 'm':
+            return value * 60 * 1000;
+        case 'h':
+            return value * 60 * 60 * 1000;
+        case 'd':
+            return value * 24 * 60 * 60 * 1000;
+        default:
+            throw new Error(`Unknown duration unit: ${unit}`);
+    }
+}
+/**
+ * Format milliseconds as a human-readable duration.
+ */
+export function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    if (ms < 60000)
+        return `${Math.round(ms / 1000)}s`;
+    if (ms < 3600000)
+        return `${Math.round(ms / 60000)}m`;
+    if (ms < 86400000)
+        return `${Math.round(ms / 3600000)}h`;
+    return `${Math.round(ms / 86400000)}d`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/workflow/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/workflow/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,GAAG,GAAG,YAAY,CAAC,4BAA4B,CAAC,CAAC;AAEvD,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E,iCAAiC;AACjC,IAAI,kBAAkB,GAAmB,IAAI,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,IAAI,kBAAkB,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,kBAAkB,GAAG,IAAI,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,EAAW,EAAE,CAAC;QACrB,kBAAkB,GAAG,KAAK,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,kBAAkB,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,2CAA2C,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEtB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,IAAI,CAAC;QACtB,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC;QAC3B,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAChC,KAAK,GAAG;YACN,OAAO,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrC;YACE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,GAAG,EAAE,IAAI,CAAC;IAChC,IAAI,EAAE,GAAG,KAAK;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC;IACnD,IAAI,EAAE,GAAG,OAAO;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC;IACtD,IAAI,EAAE,GAAG,QAAQ;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IACzD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC;AACzC,CAAC"}

package/dist/wrappers/best-of-n.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @agntk/core - Best-of-N Test-Time Scaling
+ *
+ * Run an agent N times and pick the best output via LLM judge.
+ * Supports parallel/sequential execution, list-wise/pair-wise judging,
+ * and budget caps via UsageLimits.
+ */
+import type { LanguageModel } from 'ai';
+import type { Agent } from '../agent.js';
+import type { UsageLimits } from '../usage-limits.js';
+export interface BestOfNConfig {
+    /** Number of times to run the agent. */
+    n: number;
+    /** Judge model for ranking outputs. */
+    judgeModel: LanguageModel;
+    /** Judging strategy. 'list-wise' ranks all at once; 'pair-wise' does tournament. Default: 'list-wise'. */
+    strategy?: 'list-wise' | 'pair-wise';
+    /** Run agent instances in parallel or sequentially. Default: 'parallel'. */
+    execution?: 'parallel' | 'sequential';
+    /** Criteria for the judge to evaluate outputs against. */
+    criteria: string;
+    /** Optional budget cap. Stops early if total tokens across all runs exceed this. */
+    budget?: UsageLimits;
+}
+export interface BestOfNCandidate {
+    /** The output text from this run. */
+    text: string;
+    /** The score assigned by the judge (higher is better). */
+    score: number;
+    /** Index of this candidate (0-based). */
+    index: number;
+    /** Token usage for this run. */
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+}
+export interface BestOfNResult {
+    /** The winning candidate. */
+    best: BestOfNCandidate;
+    /** All candidates with scores. */
+    candidates: BestOfNCandidate[];
+    /** Total token usage across all agent runs. */
+    totalUsage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    /** Whether the run was stopped early due to budget. */
+    budgetExceeded: boolean;
+    /** Number of candidates actually generated (may be < n if budget exceeded). */
+    runsCompleted: number;
+}
+/**
+ * Run an agent N times and pick the best output via LLM judge.
+ *
+ * @example
+ * ```typescript
+ * const result = await withBestOfN(agent, 'Write a haiku about coding', {
+ *   n: 3,
+ *   judgeModel: myModel,
+ *   criteria: 'Quality, creativity, and adherence to haiku format',
+ * });
+ * console.log(result.best.text); // Best haiku
+ * ```
+ */
+export declare function withBestOfN(agent: Agent, prompt: string, config: BestOfNConfig): Promise<BestOfNResult>;
+//# sourceMappingURL=best-of-n.d.ts.map

package/dist/wrappers/best-of-n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"best-of-n.d.ts","sourceRoot":"","sources":["../../src/wrappers/best-of-n.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAQnD,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,CAAC,EAAE,MAAM,CAAC;IACV,uCAAuC;IACvC,UAAU,EAAE,aAAa,CAAC;IAC1B,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,CAAC;IACrC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5E;AAED,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,IAAI,EAAE,gBAAgB,CAAC;IACvB,kCAAkC;IAClC,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,+CAA+C;IAC/C,UAAU,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,uDAAuD;IACvD,cAAc,EAAE,OAAO,CAAC;IACxB,+EAA+E;IAC/E,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CA+FxB"}

package/dist/wrappers/best-of-n.js

@@ -0,0 +1,242 @@
+/**
+ * @agntk/core - Best-of-N Test-Time Scaling
+ *
+ * Run an agent N times and pick the best output via LLM judge.
+ * Supports parallel/sequential execution, list-wise/pair-wise judging,
+ * and budget caps via UsageLimits.
+ */
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:best-of-n');
+// ============================================================================
+// Core Implementation
+// ============================================================================
+/**
+ * Run an agent N times and pick the best output via LLM judge.
+ *
+ * @example
+ * ```typescript
+ * const result = await withBestOfN(agent, 'Write a haiku about coding', {
+ *   n: 3,
+ *   judgeModel: myModel,
+ *   criteria: 'Quality, creativity, and adherence to haiku format',
+ * });
+ * console.log(result.best.text); // Best haiku
+ * ```
+ */
+export async function withBestOfN(agent, prompt, config) {
+    const { n, judgeModel, strategy = 'list-wise', execution = 'parallel', criteria, budget, } = config;
+    log.info('Starting best-of-N', { n, strategy, execution, criteria: criteria.slice(0, 50) });
+    // Generate candidates
+    const candidates = [];
+    const totalUsage = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+    let budgetExceeded = false;
+    if (execution === 'parallel') {
+        const promises = Array.from({ length: n }, (_, i) => generateCandidate(agent, prompt, i));
+        const results = await Promise.allSettled(promises);
+        for (const result of results) {
+            if (result.status === 'fulfilled' && result.value) {
+                candidates.push(result.value);
+                if (result.value.usage) {
+                    totalUsage.inputTokens += result.value.usage.inputTokens;
+                    totalUsage.outputTokens += result.value.usage.outputTokens;
+                    totalUsage.totalTokens += result.value.usage.totalTokens;
+                }
+            }
+        }
+    }
+    else {
+        // Sequential with budget check
+        for (let i = 0; i < n; i++) {
+            if (budget && isOverBudget(totalUsage, budget)) {
+                budgetExceeded = true;
+                log.info('Budget exceeded, stopping early', { runsCompleted: i, totalUsage });
+                break;
+            }
+            const candidate = await generateCandidate(agent, prompt, i);
+            if (candidate) {
+                candidates.push(candidate);
+                if (candidate.usage) {
+                    totalUsage.inputTokens += candidate.usage.inputTokens;
+                    totalUsage.outputTokens += candidate.usage.outputTokens;
+                    totalUsage.totalTokens += candidate.usage.totalTokens;
+                }
+            }
+        }
+    }
+    if (candidates.length === 0) {
+        throw new Error('All agent runs failed — no candidates generated');
+    }
+    if (candidates.length === 1) {
+        candidates[0].score = 1;
+        return {
+            best: candidates[0],
+            candidates,
+            totalUsage,
+            budgetExceeded,
+            runsCompleted: candidates.length,
+        };
+    }
+    // Judge candidates
+    log.info('Judging candidates', { count: candidates.length, strategy });
+    let scoredCandidates;
+    if (strategy === 'pair-wise') {
+        scoredCandidates = await pairWiseJudge(candidates, judgeModel, criteria);
+    }
+    else {
+        scoredCandidates = await listWiseJudge(candidates, judgeModel, criteria);
+    }
+    // Sort by score descending
+    scoredCandidates.sort((a, b) => b.score - a.score);
+    const result = {
+        best: scoredCandidates[0],
+        candidates: scoredCandidates,
+        totalUsage,
+        budgetExceeded,
+        runsCompleted: candidates.length,
+    };
+    log.info('Best-of-N complete', {
+        bestIndex: result.best.index,
+        bestScore: result.best.score,
+        runsCompleted: result.runsCompleted,
+    });
+    return result;
+}
+// ============================================================================
+// Candidate Generation
+// ============================================================================
+async function generateCandidate(agent, prompt, index) {
+    try {
+        const result = await agent.generate({ prompt });
+        return {
+            text: result.text ?? '',
+            score: 0,
+            index,
+            usage: result.totalUsage
+                ? {
+                    inputTokens: result.totalUsage.inputTokens ?? 0,
+                    outputTokens: result.totalUsage.outputTokens ?? 0,
+                    totalTokens: result.totalUsage.totalTokens ?? 0,
+                }
+                : undefined,
+        };
+    }
+    catch (error) {
+        log.error('Candidate generation failed', { index, error: String(error) });
+        return null;
+    }
+}
+// ============================================================================
+// List-Wise Judge
+// ============================================================================
+/**
+ * Rank all candidates at once using a single LLM call.
+ * Returns candidates with scores assigned.
+ */
+async function listWiseJudge(candidates, model, criteria) {
+    const { generateText } = await import('ai');
+    const outputList = candidates
+        .map((c, i) => `--- Output ${i + 1} ---\n${c.text.slice(0, 2000)}\n`)
+        .join('\n');
+    const judgePrompt = `You are a judge evaluating ${candidates.length} outputs for the same task.
+
+Criteria: ${criteria}
+
+${outputList}
+
+Rank ALL outputs from best to worst. Respond with EXACTLY one line per output in the format:
+OUTPUT_NUMBER:SCORE
+
+Where SCORE is 1-10 (10 = best). Example for 3 outputs:
+2:9
+1:7
+3:4`;
+    try {
+        const result = await generateText({
+            model,
+            prompt: judgePrompt,
+            maxOutputTokens: 500,
+        });
+        const scored = [...candidates];
+        const lines = result.text.trim().split('\n');
+        for (const line of lines) {
+            const match = line.match(/(\d+)\s*:\s*(\d+)/);
+            if (match) {
+                const outputNum = parseInt(match[1], 10) - 1; // 0-indexed
+                const score = parseInt(match[2], 10);
+                if (outputNum >= 0 && outputNum < scored.length) {
+                    scored[outputNum].score = score;
+                }
+            }
+        }
+        return scored;
+    }
+    catch (error) {
+        log.error('List-wise judge failed', { error: String(error) });
+        // Fallback: assign equal scores
+        return candidates.map((c) => ({ ...c, score: 5 }));
+    }
+}
+// ============================================================================
+// Pair-Wise Judge
+// ============================================================================
+/**
+ * Tournament-style judging: compare pairs and accumulate wins as scores.
+ */
+async function pairWiseJudge(candidates, model, criteria) {
+    const { generateText } = await import('ai');
+    const scores = new Array(candidates.length).fill(0);
+    // Compare all pairs
+    const comparisons = [];
+    for (let i = 0; i < candidates.length; i++) {
+        for (let j = i + 1; j < candidates.length; j++) {
+            comparisons.push([i, j]);
+        }
+    }
+    // Run comparisons in parallel
+    await Promise.all(comparisons.map(async ([i, j]) => {
+        try {
+            const result = await generateText({
+                model,
+                prompt: `You are a judge comparing two outputs for the same task.
+
+Criteria: ${criteria}
+
+--- Output A ---
+${candidates[i].text.slice(0, 2000)}
+
+--- Output B ---
+${candidates[j].text.slice(0, 2000)}
+
+Which output is better based on the criteria? Respond with EXACTLY one word: "A" or "B"`,
+                maxOutputTokens: 10,
+            });
+            const verdict = result.text.trim().toUpperCase();
+            if (verdict === 'A' || verdict.startsWith('A')) {
+                scores[i]++;
+            }
+            else {
+                scores[j]++;
+            }
+        }
+        catch (error) {
+            log.error('Pair-wise comparison failed', { i, j, error: String(error) });
+            // Tie — both get a point
+            scores[i] += 0.5;
+            scores[j] += 0.5;
+        }
+    }));
+    return candidates.map((c, i) => ({ ...c, score: scores[i] }));
+}
+// ============================================================================
+// Budget Check
+// ============================================================================
+function isOverBudget(usage, limits) {
+    if (limits.maxTotalTokens && usage.totalTokens >= limits.maxTotalTokens)
+        return true;
+    if (limits.maxInputTokens && usage.inputTokens >= limits.maxInputTokens)
+        return true;
+    if (limits.maxOutputTokens && usage.outputTokens >= limits.maxOutputTokens)
+        return true;
+    return false;
+}
+//# sourceMappingURL=best-of-n.js.map

package/dist/wrappers/best-of-n.js.map

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