@soleri/forge 5.13.1 → 5.14.1

package/dist/templates/llm-types.js

@@ -1,161 +0,0 @@
-/**
- * Generate the LLM types file for a new agent.
- * Contains all types, LLMError class, and SecretString class.
- */
-export function generateLLMTypes() {
-    return `/**
- * LLM Module Types
- * Generated by Soleri — do not edit manually.
- */
-
-// =============================================================================
-// SECRET STRING
-// =============================================================================
-
-const REDACTED = '[REDACTED]';
-
-export class SecretString {
-  #value: string;
-
-  constructor(value: string) {
-    this.#value = value;
-  }
-
-  expose(): string {
-    return this.#value;
-  }
-
-  get isSet(): boolean {
-    return this.#value.length > 0;
-  }
-
-  toString(): string {
-    return REDACTED;
-  }
-  toJSON(): string {
-    return REDACTED;
-  }
-  [Symbol.toPrimitive](): string {
-    return REDACTED;
-  }
-  [Symbol.for('nodejs.util.inspect.custom')](): string {
-    return REDACTED;
-  }
-}
-
-// =============================================================================
-// LLM ERROR
-// =============================================================================
-
-export class LLMError extends Error {
-  retryable: boolean;
-  statusCode?: number;
-
-  constructor(message: string, options?: { retryable?: boolean; statusCode?: number }) {
-    super(message);
-    this.name = 'LLMError';
-    this.retryable = options?.retryable ?? false;
-    this.statusCode = options?.statusCode;
-    Object.setPrototypeOf(this, LLMError.prototype);
-  }
-}
-
-// =============================================================================
-// LLM CALL TYPES
-// =============================================================================
-
-export interface LLMCallOptions {
-  provider: 'openai' | 'anthropic';
-  model: string;
-  systemPrompt: string;
-  userPrompt: string;
-  temperature?: number;
-  maxTokens?: number;
-  caller: string;
-  task?: string;
-}
-
-export interface LLMCallResult {
-  text: string;
-  model: string;
-  provider: 'openai' | 'anthropic';
-  inputTokens?: number;
-  outputTokens?: number;
-  durationMs: number;
-}
-
-// =============================================================================
-// CIRCUIT BREAKER TYPES
-// =============================================================================
-
-export type CircuitState = 'closed' | 'open' | 'half-open';
-
-export interface CircuitBreakerConfig {
-  failureThreshold: number;
-  resetTimeoutMs: number;
-  name: string;
-}
-
-export interface CircuitBreakerSnapshot {
-  state: CircuitState;
-  failureCount: number;
-  lastFailureAt: number | null;
-}
-
-// =============================================================================
-// KEY POOL TYPES
-// =============================================================================
-
-export interface KeyPoolConfig {
-  keys: string[];
-  preemptiveThreshold?: number;
-}
-
-export interface KeyStatus {
-  index: number;
-  circuitState: CircuitBreakerSnapshot;
-  remainingQuota: number | null;
-}
-
-// =============================================================================
-// ROUTING TYPES
-// =============================================================================
-
-export interface RouteEntry {
-  caller: string;
-  task?: string;
-  model: string;
-  provider: 'openai' | 'anthropic';
-}
-
-export interface RoutingConfig {
-  routes: RouteEntry[];
-  defaultOpenAIModel: string;
-  defaultAnthropicModel: string;
-}
-
-// =============================================================================
-// RATE LIMIT TYPES
-// =============================================================================
-
-export interface RateLimitInfo {
-  remaining: number | null;
-  resetMs: number | null;
-  retryAfterMs: number | null;
-}
-
-// =============================================================================
-// RETRY TYPES
-// =============================================================================
-
-export interface RetryConfig {
-  maxAttempts: number;
-  baseDelayMs: number;
-  maxDelayMs: number;
-  jitter: number;
-  shouldRetry?: (error: unknown) => boolean;
-  onRetry?: (error: unknown, attempt: number, delayMs: number) => void;
-}
-`;
-}
-//# sourceMappingURL=llm-types.js.map

package/dist/templates/llm-types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"llm-types.js","sourceRoot":"","sources":["../../src/templates/llm-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyJR,CAAC;AACF,CAAC"}

package/dist/templates/llm-utils.d.ts

@@ -1,5 +0,0 @@
-/**
- * Generate the LLM utils file for a new agent.
- * Contains CircuitBreaker, retry with backoff+jitter, and rate limit header parser.
- */
-export declare function generateLLMUtils(): string;

package/dist/templates/llm-utils.js

@@ -1,260 +0,0 @@
-/**
- * Generate the LLM utils file for a new agent.
- * Contains CircuitBreaker, retry with backoff+jitter, and rate limit header parser.
- */
-export function generateLLMUtils() {
-    return `/**
- * LLM Utilities — Circuit Breaker, Retry, Rate Limit Parser
- * Generated by Soleri — do not edit manually.
- */
-
-import type {
-  CircuitBreakerConfig,
-  CircuitBreakerSnapshot,
-  CircuitState,
-  LLMError,
-  RateLimitInfo,
-  RetryConfig,
-} from './types.js';
-
-// =============================================================================
-// HELPERS
-// =============================================================================
-
-function isRetryable(error: unknown): boolean {
-  if (error && typeof error === 'object' && 'retryable' in error) {
-    return (error as { retryable: boolean }).retryable === true;
-  }
-  return false;
-}
-
-function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-
-// =============================================================================
-// CIRCUIT BREAKER
-// =============================================================================
-
-const DEFAULT_CB_CONFIG: CircuitBreakerConfig = {
-  failureThreshold: 5,
-  resetTimeoutMs: 60_000,
-  name: 'default',
-};
-
-export class CircuitOpenError extends Error {
-  retryable = false;
-  constructor(name: string) {
-    super(\`\${name} circuit breaker is open — calls are being rejected\`);
-    this.name = 'CircuitOpenError';
-    Object.setPrototypeOf(this, CircuitOpenError.prototype);
-  }
-}
-
-export class CircuitBreaker {
-  private state: CircuitState = 'closed';
-  private failureCount = 0;
-  private lastFailureAt: number | null = null;
-  private readonly config: CircuitBreakerConfig;
-
-  constructor(config?: Partial<CircuitBreakerConfig>) {
-    this.config = { ...DEFAULT_CB_CONFIG, ...config };
-  }
-
-  async call<T>(fn: () => Promise<T>): Promise<T> {
-    if (this.state === 'open') {
-      if (this.shouldProbe()) {
-        this.transitionTo('half-open');
-      } else {
-        throw new CircuitOpenError(this.config.name);
-      }
-    }
-
-    try {
-      const result = await fn();
-      this.onSuccess();
-      return result;
-    } catch (error) {
-      this.onFailure(error);
-      throw error;
-    }
-  }
-
-  getState(): CircuitBreakerSnapshot {
-    if (this.state === 'open' && this.shouldProbe()) {
-      this.transitionTo('half-open');
-    }
-    return {
-      state: this.state,
-      failureCount: this.failureCount,
-      lastFailureAt: this.lastFailureAt,
-    };
-  }
-
-  isOpen(): boolean {
-    return this.state === 'open' && !this.shouldProbe();
-  }
-
-  reset(): void {
-    this.transitionTo('closed');
-    this.failureCount = 0;
-    this.lastFailureAt = null;
-  }
-
-  /** Synchronously record a failure (used by KeyPool to trip breaker without async) */
-  recordFailure(): void {
-    this.failureCount++;
-    this.lastFailureAt = Date.now();
-    if (this.state === 'half-open') {
-      this.transitionTo('open');
-      return;
-    }
-    if (this.failureCount >= this.config.failureThreshold) {
-      console.error(\`[LLM] CircuitBreaker:\${this.config.name} threshold reached (\${this.failureCount}/\${this.config.failureThreshold}) — opening\`);
-      this.transitionTo('open');
-    }
-  }
-
-  private onSuccess(): void {
-    this.failureCount = 0;
-    this.transitionTo('closed');
-  }
-
-  private onFailure(error: unknown): void {
-    if (!isRetryable(error)) {
-      return;
-    }
-
-    this.failureCount++;
-    this.lastFailureAt = Date.now();
-
-    if (this.state === 'half-open') {
-      this.transitionTo('open');
-      return;
-    }
-
-    if (this.failureCount >= this.config.failureThreshold) {
-      console.error(\`[LLM] CircuitBreaker:\${this.config.name} threshold reached (\${this.failureCount}/\${this.config.failureThreshold}) — opening\`);
-      this.transitionTo('open');
-    }
-  }
-
-  private shouldProbe(): boolean {
-    if (this.lastFailureAt === null) return false;
-    return Date.now() - this.lastFailureAt >= this.config.resetTimeoutMs;
-  }
-
-  private transitionTo(newState: CircuitState): void {
-    if (this.state !== newState) {
-      this.state = newState;
-    }
-  }
-}
-
-// =============================================================================
-// RETRY
-// =============================================================================
-
-const DEFAULT_RETRY_CONFIG: RetryConfig = {
-  maxAttempts: 3,
-  baseDelayMs: 1000,
-  maxDelayMs: 30000,
-  jitter: 0.1,
-};
-
-export function computeDelay(
-  error: unknown,
-  attempt: number,
-  config: RetryConfig,
-): number {
-  const retryAfterMs = (error as Partial<LLMError> & { retryAfterMs?: number })?.retryAfterMs;
-  if (retryAfterMs !== undefined && retryAfterMs > 0) {
-    return Math.min(retryAfterMs, config.maxDelayMs);
-  }
-
-  const exponential = config.baseDelayMs * Math.pow(2, attempt);
-  const capped = Math.min(exponential, config.maxDelayMs);
-
-  const jitterRange = capped * config.jitter;
-  const jitterOffset = (Math.random() * 2 - 1) * jitterRange;
-
-  return Math.max(0, Math.round(capped + jitterOffset));
-}
-
-export async function retry<T>(
-  fn: () => Promise<T>,
-  config?: Partial<RetryConfig>,
-): Promise<T> {
-  const resolved: RetryConfig = { ...DEFAULT_RETRY_CONFIG, ...config };
-  const shouldRetry = resolved.shouldRetry ?? isRetryable;
-
-  let lastError: unknown;
-
-  for (let attempt = 0; attempt < resolved.maxAttempts; attempt++) {
-    try {
-      return await fn();
-    } catch (error) {
-      lastError = error;
-
-      if (attempt >= resolved.maxAttempts - 1 || !shouldRetry(error)) {
-        throw error;
-      }
-
-      const delay = computeDelay(error, attempt, resolved);
-      resolved.onRetry?.(error, attempt + 1, delay);
-
-      await sleep(delay);
-    }
-  }
-
-  throw lastError;
-}
-
-// =============================================================================
-// RATE LIMIT HEADER PARSER
-// =============================================================================
-
-export function parseRateLimitHeaders(headers: Headers): RateLimitInfo {
-  const remaining = headers.get('x-ratelimit-remaining-requests');
-  const reset = headers.get('x-ratelimit-reset-requests');
-  const retryAfter = headers.get('retry-after');
-
-  return {
-    remaining: remaining !== null ? parseInt(remaining, 10) : null,
-    resetMs: reset !== null ? parseResetDuration(reset) : null,
-    retryAfterMs: retryAfter !== null ? parseRetryAfter(retryAfter) : null,
-  };
-}
-
-function parseResetDuration(value: string): number | null {
-  let totalMs = 0;
-  let matched = false;
-
-  const minMatch = value.match(/(\\d+)m(?!\\s*s)/);
-  if (minMatch) {
-    totalMs += parseInt(minMatch[1], 10) * 60_000;
-    matched = true;
-  }
-
-  const msMatch = value.match(/(\\d+)ms/);
-  if (msMatch) {
-    totalMs += parseInt(msMatch[1], 10);
-    matched = true;
-  }
-
-  const secMatch = value.match(/(\\d+)(?<!m)s/);
-  if (secMatch) {
-    totalMs += parseInt(secMatch[1], 10) * 1000;
-    matched = true;
-  }
-
-  return matched ? totalMs : null;
-}
-
-function parseRetryAfter(value: string): number | null {
-  const seconds = parseFloat(value);
-  return isNaN(seconds) ? null : Math.ceil(seconds * 1000);
-}
-`;
-}
-//# sourceMappingURL=llm-utils.js.map

package/dist/templates/llm-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"llm-utils.js","sourceRoot":"","sources":["../../src/templates/llm-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4PR,CAAC;AACF,CAAC"}

package/dist/templates/planner.d.ts

@@ -1,5 +0,0 @@
-/**
- * Generates src/planning/planner.ts for a new agent.
- * The Planner provides JSON-file-backed plan management with state machine transitions.
- */
-export declare function generatePlanner(): string;

package/dist/templates/planner.js

@@ -1,150 +0,0 @@
-/**
- * Generates src/planning/planner.ts for a new agent.
- * The Planner provides JSON-file-backed plan management with state machine transitions.
- */
-export function generatePlanner() {
-    return PLANNER_TEMPLATE;
-}
-const PLANNER_TEMPLATE = [
-    "import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';",
-    "import { dirname } from 'node:path';",
-    '',
-    "export type PlanStatus = 'draft' | 'approved' | 'executing' | 'completed';",
-    "export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'skipped' | 'failed';",
-    '',
-    'export interface PlanTask {',
-    '  id: string;',
-    '  title: string;',
-    '  description: string;',
-    '  status: TaskStatus;',
-    '  updatedAt: number;',
-    '}',
-    '',
-    'export interface Plan {',
-    '  id: string;',
-    '  objective: string;',
-    '  scope: string;',
-    '  status: PlanStatus;',
-    '  decisions: string[];',
-    '  tasks: PlanTask[];',
-    '  createdAt: number;',
-    '  updatedAt: number;',
-    '}',
-    '',
-    'export interface PlanStore {',
-    '  version: string;',
-    '  plans: Plan[];',
-    '}',
-    '',
-    'export class Planner {',
-    '  private filePath: string;',
-    '  private store: PlanStore;',
-    '',
-    '  constructor(filePath: string) {',
-    '    this.filePath = filePath;',
-    '    this.store = this.load();',
-    '  }',
-    '',
-    '  private load(): PlanStore {',
-    '    if (!existsSync(this.filePath)) {',
-    "      return { version: '1.0', plans: [] };",
-    '    }',
-    '    try {',
-    "      const data = readFileSync(this.filePath, 'utf-8');",
-    '      return JSON.parse(data) as PlanStore;',
-    '    } catch {',
-    "      return { version: '1.0', plans: [] };",
-    '    }',
-    '  }',
-    '',
-    '  private save(): void {',
-    '    mkdirSync(dirname(this.filePath), { recursive: true });',
-    "    writeFileSync(this.filePath, JSON.stringify(this.store, null, 2), 'utf-8');",
-    '  }',
-    '',
-    '  create(params: { objective: string; scope: string; decisions?: string[]; tasks?: Array<{ title: string; description: string }> }): Plan {',
-    '    const now = Date.now();',
-    '    const plan: Plan = {',
-    '      id: `plan-${now}-${Math.random().toString(36).slice(2, 8)}`,',
-    '      objective: params.objective,',
-    '      scope: params.scope,',
-    "      status: 'draft',",
-    '      decisions: params.decisions ?? [],',
-    '      tasks: (params.tasks ?? []).map((t, i) => ({',
-    '        id: `task-${i + 1}`,',
-    '        title: t.title,',
-    '        description: t.description,',
-    "        status: 'pending' as TaskStatus,",
-    '        updatedAt: now,',
-    '      })),',
-    '      createdAt: now,',
-    '      updatedAt: now,',
-    '    };',
-    '    this.store.plans.push(plan);',
-    '    this.save();',
-    '    return plan;',
-    '  }',
-    '',
-    '  get(planId: string): Plan | null {',
-    '    return this.store.plans.find((p) => p.id === planId) ?? null;',
-    '  }',
-    '',
-    '  list(): Plan[] {',
-    '    return [...this.store.plans];',
-    '  }',
-    '',
-    '  approve(planId: string): Plan {',
-    '    const plan = this.get(planId);',
-    '    if (!plan) throw new Error(`Plan not found: ${planId}`);',
-    "    if (plan.status !== 'draft') throw new Error(`Cannot approve plan in '${plan.status}' status — must be 'draft'`);",
-    "    plan.status = 'approved';",
-    '    plan.updatedAt = Date.now();',
-    '    this.save();',
-    '    return plan;',
-    '  }',
-    '',
-    '  startExecution(planId: string): Plan {',
-    '    const plan = this.get(planId);',
-    '    if (!plan) throw new Error(`Plan not found: ${planId}`);',
-    "    if (plan.status !== 'approved') throw new Error(`Cannot execute plan in '${plan.status}' status — must be 'approved'`);",
-    "    plan.status = 'executing';",
-    '    plan.updatedAt = Date.now();',
-    '    this.save();',
-    '    return plan;',
-    '  }',
-    '',
-    '  updateTask(planId: string, taskId: string, status: TaskStatus): Plan {',
-    '    const plan = this.get(planId);',
-    '    if (!plan) throw new Error(`Plan not found: ${planId}`);',
-    "    if (plan.status !== 'executing') throw new Error(`Cannot update tasks on plan in '${plan.status}' status — must be 'executing'`);",
-    '    const task = plan.tasks.find((t) => t.id === taskId);',
-    '    if (!task) throw new Error(`Task not found: ${taskId}`);',
-    '    task.status = status;',
-    '    task.updatedAt = Date.now();',
-    '    plan.updatedAt = Date.now();',
-    "    // Auto-transition: if plan is executing and first task starts, that's fine",
-    '    // Auto-start execution when approving and updating first task',
-    '    this.save();',
-    '    return plan;',
-    '  }',
-    '',
-    '  complete(planId: string): Plan {',
-    '    const plan = this.get(planId);',
-    '    if (!plan) throw new Error(`Plan not found: ${planId}`);',
-    "    if (plan.status !== 'executing') throw new Error(`Cannot complete plan in '${plan.status}' status — must be 'executing'`);",
-    "    plan.status = 'completed';",
-    '    plan.updatedAt = Date.now();',
-    '    this.save();',
-    '    return plan;',
-    '  }',
-    '',
-    '  getExecuting(): Plan[] {',
-    "    return this.store.plans.filter((p) => p.status === 'executing');",
-    '  }',
-    '',
-    '  getActive(): Plan[] {',
-    "    return this.store.plans.filter((p) => p.status === 'draft' || p.status === 'approved' || p.status === 'executing');",
-    '  }',
-    '}',
-].join('\n');
-//# sourceMappingURL=planner.js.map

package/dist/templates/planner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/templates/planner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,MAAM,gBAAgB,GAAG;IACvB,+EAA+E;IAC/E,sCAAsC;IACtC,EAAE;IACF,4EAA4E;IAC5E,0FAA0F;IAC1F,EAAE;IACF,6BAA6B;IAC7B,eAAe;IACf,kBAAkB;IAClB,wBAAwB;IACxB,uBAAuB;IACvB,sBAAsB;IACtB,GAAG;IACH,EAAE;IACF,yBAAyB;IACzB,eAAe;IACf,sBAAsB;IACtB,kBAAkB;IAClB,uBAAuB;IACvB,wBAAwB;IACxB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,GAAG;IACH,EAAE;IACF,8BAA8B;IAC9B,oBAAoB;IACpB,kBAAkB;IAClB,GAAG;IACH,EAAE;IACF,wBAAwB;IACxB,6BAA6B;IAC7B,6BAA6B;IAC7B,EAAE;IACF,mCAAmC;IACnC,+BAA+B;IAC/B,+BAA+B;IAC/B,KAAK;IACL,EAAE;IACF,+BAA+B;IAC/B,uCAAuC;IACvC,6CAA6C;IAC7C,OAAO;IACP,WAAW;IACX,0DAA0D;IAC1D,6CAA6C;IAC7C,eAAe;IACf,6CAA6C;IAC7C,OAAO;IACP,KAAK;IACL,EAAE;IACF,0BAA0B;IAC1B,6DAA6D;IAC7D,iFAAiF;IACjF,KAAK;IACL,EAAE;IACF,6IAA6I;IAC7I,6BAA6B;IAC7B,0BAA0B;IAC1B,oEAAoE;IACpE,oCAAoC;IACpC,4BAA4B;IAC5B,wBAAwB;IACxB,0CAA0C;IAC1C,oDAAoD;IACpD,8BAA8B;IAC9B,yBAAyB;IACzB,qCAAqC;IACrC,0CAA0C;IAC1C,yBAAyB;IACzB,YAAY;IACZ,uBAAuB;IACvB,uBAAuB;IACvB,QAAQ;IACR,kCAAkC;IAClC,kBAAkB;IAClB,kBAAkB;IAClB,KAAK;IACL,EAAE;IACF,sCAAsC;IACtC,mEAAmE;IACnE,KAAK;IACL,EAAE;IACF,oBAAoB;IACpB,mCAAmC;IACnC,KAAK;IACL,EAAE;IACF,mCAAmC;IACnC,oCAAoC;IACpC,8DAA8D;IAC9D,uHAAuH;IACvH,+BAA+B;IAC/B,kCAAkC;IAClC,kBAAkB;IAClB,kBAAkB;IAClB,KAAK;IACL,EAAE;IACF,0CAA0C;IAC1C,oCAAoC;IACpC,8DAA8D;IAC9D,6HAA6H;IAC7H,gCAAgC;IAChC,kCAAkC;IAClC,kBAAkB;IAClB,kBAAkB;IAClB,KAAK;IACL,EAAE;IACF,0EAA0E;IAC1E,oCAAoC;IACpC,8DAA8D;IAC9D,uIAAuI;IACvI,2DAA2D;IAC3D,8DAA8D;IAC9D,2BAA2B;IAC3B,kCAAkC;IAClC,kCAAkC;IAClC,iFAAiF;IACjF,oEAAoE;IACpE,kBAAkB;IAClB,kBAAkB;IAClB,KAAK;IACL,EAAE;IACF,oCAAoC;IACpC,oCAAoC;IACpC,8DAA8D;IAC9D,gIAAgI;IAChI,gCAAgC;IAChC,kCAAkC;IAClC,kBAAkB;IAClB,kBAAkB;IAClB,KAAK;IACL,EAAE;IACF,4BAA4B;IAC5B,sEAAsE;IACtE,KAAK;IACL,EAAE;IACF,yBAAyB;IACzB,yHAAyH;IACzH,KAAK;IACL,GAAG;CACJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/templates/test-brain.d.ts

@@ -1,6 +0,0 @@
-/**
- * Generates brain test file for a new agent.
- * Tests cover: TF-IDF scoring, intelligent search, auto-tagging,
- * duplicate detection, feedback, adaptive weights, vocabulary.
- */
-export declare function generateBrainTest(): string;