@bluecopa/harness 0.1.0-snapshot.99 → 2.0.0

package/dist/arc/profile-builder.d.ts

@@ -1,49 +0,0 @@
-import { P as ProfileConfig, d as ProfileDeclaration, e as AnyTool, f as ProcessProfile } from '../types-g-3DvSSE.js';
-import 'zod';
-import 'ai';
-
-/**
- * Profile builder — generates prompts and resolves tools from ProfileDeclarations.
- *
- * The core idea: profiles declare WHAT (signature, tools, background).
- * This module generates the HOW (system prompts, tool objects).
- */
-
-/**
- * Generate a thread system prompt from a ProfileDeclaration.
- *
- * The prompt tells the thread:
- * - What it is (name)
- * - What it produces (signature)
- * - What tools it has (enforced, not suggested)
- * - Domain knowledge (background)
- */
-declare function buildProfilePrompt(decl: ProfileDeclaration): string;
-/**
- * Generate an orchestrator system prompt from a set of profile declarations.
- *
- * The orchestrator sees profile names, signatures, and tool counts —
- * enough to route correctly. No tool names, no delivery methods.
- *
- * @param profiles - The registered profiles
- * @param preamble - Optional strategy preamble (phasing, rules, context).
- *                   Composed with the auto-generated profile catalog.
- */
-declare function buildOrchestratorPrompt(profiles: Record<string, ProfileConfig>, preamble?: string): string;
-/**
- * Resolve tool names to tool objects from the global tool registry.
- * Returns only the tools listed in the declaration.
- */
-declare function resolveProfileTools(toolNames: string[], globalTools: Record<string, AnyTool>): Record<string, AnyTool>;
-/**
- * Build a runtime ProcessProfile from a ProfileDeclaration.
- * Generates the system prompt and resolves tool objects.
- */
-declare function buildProcessProfile(decl: ProfileDeclaration, globalTools: Record<string, AnyTool>): ProcessProfile;
-/**
- * Resolve a ProfileConfig (declaration or legacy) into a ProcessProfile.
- * Declarations are built; legacy profiles are passed through.
- */
-declare function resolveProfile(config: ProfileConfig, globalTools: Record<string, AnyTool>): ProcessProfile;
-
-export { buildOrchestratorPrompt, buildProcessProfile, buildProfilePrompt, resolveProfile, resolveProfileTools };

package/dist/arc/profile-builder.js

@@ -1,163 +0,0 @@
-import { z } from 'zod';
-
-// src/arc/types.ts
-function isProfileDeclaration(p) {
-  return "signature" in p && typeof p.signature === "string";
-}
-var FIELD_RE = /^(\w+)(?::(\w+)(\[\])?)(\?)?(?:\s*\(([^)]+)\))?$/;
-function parseField(raw) {
-  const trimmed = raw.trim();
-  const match = trimmed.match(FIELD_RE);
-  if (!match) {
-    const name2 = trimmed.replace(/\?$/, "");
-    return {
-      name: name2,
-      type: "string",
-      isArray: false,
-      isOptional: trimmed.endsWith("?")
-    };
-  }
-  const [, name, typeStr, arrayMark, optionalMark, desc] = match;
-  const type = ["string", "number", "boolean"].includes(typeStr) ? typeStr : "string";
-  const field = {
-    name,
-    type,
-    isArray: arrayMark === "[]",
-    isOptional: optionalMark === "?"
-  };
-  if (desc) field.description = desc.trim();
-  return field;
-}
-function parseSignature(sig) {
-  const arrowIdx = sig.indexOf("->");
-  if (arrowIdx < 0) {
-    throw new Error(`Invalid signature: missing "->". Got: "${sig}"`);
-  }
-  const inputStr = sig.slice(0, arrowIdx).trim();
-  const outputStr = sig.slice(arrowIdx + 2).trim();
-  const inputs = inputStr.split(",").map((s) => s.trim()).filter(Boolean).map(parseField);
-  const outputs = outputStr.split(",").map((s) => s.trim()).filter(Boolean).map(parseField);
-  return { inputs, outputs };
-}
-function signatureToSchema(sig) {
-  const shape = {};
-  for (const field of sig.outputs) {
-    let base;
-    switch (field.type) {
-      case "number":
-        base = z.number();
-        break;
-      case "boolean":
-        base = z.boolean();
-        break;
-      default:
-        base = z.string();
-        break;
-    }
-    if (field.isArray) base = z.array(base);
-    if (field.description) base = base.describe(field.description);
-    if (field.isOptional) base = base.optional();
-    shape[field.name] = base;
-  }
-  return z.object(shape);
-}
-function isTypedSignature(sig) {
-  return /\b\w+:\w+/.test(sig);
-}
-
-// src/arc/profile-builder.ts
-function buildProfilePrompt(decl) {
-  const [input, output] = decl.signature.split("->").map((s) => s.trim());
-  const lines = [
-    `You are a ${decl.name} thread.`,
-    `Your task: take ${input} and produce ${output}.`,
-    "",
-    `## Available tools`,
-    `You have access to: ${decl.tools.join(", ")}`,
-    "Use ONLY these tools. You cannot use any other tools.",
-    "If you have Skill Instructions below, follow them for delivery method and style."
-  ];
-  if (decl.background) {
-    lines.push("", "## Background", decl.background);
-  }
-  return lines.join("\n");
-}
-function buildOrchestratorPrompt(profiles, preamble) {
-  const profileList = Object.entries(profiles).map(([name, p]) => {
-    if (isProfileDeclaration(p)) {
-      return `- **${name}** \u2014 ${p.signature} (tools: ${p.tools.length}, ${p.model || "medium"})`;
-    }
-    return `- **${name}**`;
-  }).join("\n");
-  const sections = [
-    "You are an orchestrator. Accomplish tasks by decomposing them into focused threads, delegating each to the right profile, and synthesizing results.",
-    "",
-    "## Workflow: Decompose \u2192 Delegate \u2192 Synthesize",
-    "",
-    "1. **Decompose**: Break the request into independent, focused sub-tasks.",
-    "2. **Delegate**: Dispatch each sub-task as a Thread call with the appropriate profile. Independent sub-tasks go in the SAME turn (parallel).",
-    "3. **Synthesize**: Combine thread results into a coherent response.",
-    "",
-    "## Profiles",
-    profileList,
-    "",
-    "## Thread actions",
-    "Describe WHAT to produce, not HOW. 2-5 sentences. Threads have tools and skill instructions \u2014 they know delivery methods.",
-    "ALWAYS set the profile parameter on every Thread call.",
-    "",
-    "## Concurrency",
-    "Dispatch at most 3 threads per turn. If more are needed, batch them.",
-    "",
-    "## Context passing",
-    "Threads automatically receive the user's current message and attachments as seed context. Focus action text on WHAT to produce \u2014 threads already know what the user asked and what files are available.",
-    "Use contextEpisodeIds to chain dependent threads: research threads first (parallel), then implementation threads with their episodeIds."
-  ];
-  if (preamble) {
-    sections.splice(1, 0, "", preamble);
-  }
-  return sections.join("\n");
-}
-function resolveProfileTools(toolNames, globalTools) {
-  const resolved = {};
-  for (const name of toolNames) {
-    if (globalTools[name]) {
-      resolved[name] = globalTools[name];
-    }
-  }
-  return resolved;
-}
-function buildProcessProfile(decl, globalTools) {
-  const profile = {
-    systemPrompt: buildProfilePrompt(decl),
-    tools: resolveProfileTools(decl.tools, globalTools),
-    allowedToolNames: decl.tools
-  };
-  if (decl.model) profile.model = decl.model;
-  if (decl.maxSteps) profile.maxSteps = decl.maxSteps;
-  if (isTypedSignature(decl.signature)) {
-    const parsed = parseSignature(decl.signature);
-    if (parsed.outputs.length > 0) {
-      profile.outputSchema = signatureToSchema(parsed);
-    }
-  }
-  if (decl.demos && decl.demos.length > 0) {
-    profile.demoMessages = decl.demos.flatMap((demo) => [
-      { role: "user", content: Object.entries(demo.input).map(([k, v]) => `${k}: ${v}`).join("\n") },
-      { role: "assistant", content: JSON.stringify(demo.output, null, 2) }
-    ]);
-  }
-  return profile;
-}
-function resolveProfile(config, globalTools) {
-  if (isProfileDeclaration(config)) {
-    return buildProcessProfile(config, globalTools);
-  }
-  if (config.tools && !config.allowedToolNames) {
-    return { ...config, allowedToolNames: Object.keys(config.tools) };
-  }
-  return config;
-}
-
-export { buildOrchestratorPrompt, buildProcessProfile, buildProfilePrompt, resolveProfile, resolveProfileTools };
-//# sourceMappingURL=profile-builder.js.map
-//# sourceMappingURL=profile-builder.js.map

package/dist/arc/profile-builder.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/arc/types.ts","../../src/arc/sig.ts","../../src/arc/profile-builder.ts"],"names":["name"],"mappings":"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","file":"profile-builder.js","sourcesContent":["// ── Re-exports from shared types ──\n\nexport type {\n  Episode,\n  EpisodeTrace,\n  SessionMemo,\n  LongTermMemory,\n  EpisodeStore,\n  SessionMemoStore,\n  LongTermStore,\n  AnyTool,\n} from './arc-types';\n\nexport { DEFAULT_MODEL_MAP, resolveModel } from './arc-types';\nexport type { ModelTier } from './arc-types';\n\nexport type {\n  AgentMessage,\n  ToolCallAction,\n  ToolCallInfo,\n  ToolResultInfo,\n  ContentPart,\n  AgentRunResult,\n  StepUsage,\n} from '../agent/types';\nexport { getTextContent } from '../agent/types';\n\nexport type { ToolProvider, ToolResult } from '../interfaces/tool-provider';\nexport type { SandboxProvider } from '../interfaces/sandbox-provider';\nexport type { HarnessTelemetry } from '../observability/otel';\nexport type { HookRunner } from '../hooks/hook-runner';\nexport type { PermissionManager } from '../permissions/permission-manager';\nexport type { SkillManager } from '../skills/skill-manager';\n\n// ── Episode artifacts ──\n\nexport interface EpisodeArtifact {\n  key: string;    // e.g. 'error_output', 'modified_code', 'test_result'\n  content: string; // verbatim extracted content\n}\n\n// ── Model factory ──\n\n/** Creates an ai-sdk LanguageModel from a model ID string. Defaults to anthropic(). */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type ModelFactory = (modelId: string) => any;\n\n// ── Tool choice ──\n\n/** Static tool choice value for LLM calls. */\nexport type ToolChoiceValue = 'auto' | 'required' | 'none' | { type: 'tool'; toolName: string };\n\n/**\n * Tool choice configuration — static value or per-turn callback.\n *\n * As a callback, receives the turn/step number (0-indexed) and returns the choice for that turn.\n * This enables patterns like forcing tool use on the first turn only:\n *   `(turn) => turn === 0 ? 'required' : 'auto'`\n */\nexport type ToolChoiceConfig = ToolChoiceValue | ((turn: number) => ToolChoiceValue);\n\n/** Resolve a ToolChoiceConfig to a concrete value for a given turn. */\nexport function resolveToolChoice(config: ToolChoiceConfig | undefined, turn: number): ToolChoiceValue {\n  if (!config) return 'auto';\n  return typeof config === 'function' ? config(turn) : config;\n}\n\n// ── ArcLoop v2 Config ──\n\nexport interface ArcLoopConfig {\n  // Orchestrator\n  /** Orchestrator model (default: 'claude-opus-4-6'). Accepts a model ID or tier name. */\n  model?: string;\n  /** Model tier mapping. Override to use different models for fast/medium/strong. */\n  modelMap?: Record<import('./arc-types').ModelTier, string>;\n  /** Model factory — creates an ai-sdk LanguageModel from a model ID. Defaults to anthropic(). */\n  createModel?: ModelFactory;\n  /** @deprecated Use createModel instead. Anthropic API key (set via ANTHROPIC_API_KEY env var). */\n  apiKey?: string;\n  /** Custom orchestrator system prompt */\n  systemPrompt?: string;\n  /** Max orchestrator turns before stopping (default: 30) */\n  maxTurns?: number;\n  /** Extra orchestrator tools beyond Thread/Check/Cancel/Remember */\n  extraOrchestratorTools?: Record<string, import('./arc-types').AnyTool>;\n  /** Handler for extra orchestrator tools. Return an AgentAction (typically FinalAction with directive). */\n  onOrchestratorTool?: (name: string, args: Record<string, unknown>) => Promise<import('../agent/types').AgentAction>;\n  /** Optional resilience policy applied to LLM calls (retry, circuit breaker, timeout, etc.). */\n  resilience?: import('./resilience/types').ResiliencePolicy;\n\n  /** Tool choice for orchestrator LLM calls. Supports per-turn callbacks. Default: 'auto'. */\n  orchestratorToolChoice?: ToolChoiceConfig;\n  /** Default tool choice for all processes. Individual profiles can override. Default: 'auto'. */\n  processToolChoice?: ToolChoiceConfig;\n\n  /** ResultPager for storing large tool results externally in processes. */\n  resultPager?: import('./result-pager').ResultPager;\n  /** Character threshold above which tool results are paged. Default: 4000. */\n  resultPageThreshold?: number;\n  /** Tool names to never page (e.g., ['Read', 'Edit']). */\n  pagingExclude?: string[];\n  /** Hard cap on tool result length (chars) when no resultPager is configured. Truncates with a note. */\n  maxToolResultLength?: number;\n  /** Structured facts injected into process system prompts (e.g., from long-term memory). */\n  contextFacts?: string[];\n  /** Max context tokens for worker threads. When set, stubs old tool results to keep within budget. */\n  maxContextTokens?: number;\n  /**\n   * Seed context injected into every process as a system message.\n   * Use this to pass the user's original request, attachment metadata,\n   * or other context that threads need but the orchestrator may not include\n   * in the Thread action text.\n   */\n  processSeedContext?: string | import('../agent/types').AgentMessage[];\n\n  // Processes\n  /** Per-process timeout in ms (default: 120_000) */\n  processTimeout?: number;\n  /** Per-process max steps (default: 20) */\n  processMaxSteps?: number;\n  /** Default system prompt for all processes (overrides the built-in default) */\n  processSystemPrompt?: string;\n  /** Named process profiles. Accepts ProfileDeclaration (new, declarative) or ProcessProfile (legacy). */\n  processProfiles?: Record<string, ProfileConfig>;\n  /** Tools available inside processes (default: builtinTools) */\n  processTools?: Record<string, import('./arc-types').AnyTool>;\n\n  // Context\n  /** Context window size in tokens (default: 200_000) */\n  contextWindowSize?: number;\n  /** Tokens reserved for output (default: 20_000) */\n  outputReserve?: number;\n  /**\n   * Enable dynamic context window detection via OpenRouter API.\n   * When true, fetches model-specific context_length from OpenRouter.\n   * Falls back to 128K tokens for unknown models.\n   * Overrides contextWindowSize if both are set.\n   * @default false\n   */\n  dynamicContextWindow?: boolean;\n\n  // Stores (required)\n  episodeStore: import('./arc-types').EpisodeStore;\n  sessionMemoStore: import('./arc-types').SessionMemoStore;\n  longTermStore: import('./arc-types').LongTermStore;\n\n  // Identity (required)\n  taskId: string;\n  sessionId: string;\n\n  // Memory\n  /** Enable auto-memory detection and promotion (default: true) */\n  autoMemory?: boolean;\n\n  // Dependency injection\n  /** Pre-built SkillResolver instance. If omitted, one is created from skillIndexPath (if provided). */\n  skillResolver?: import('./skill-resolver').SkillResolver;\n\n  // Tools & providers\n  toolProvider: import('../interfaces/tool-provider').ToolProvider;\n  /** Tool provider for skill-matched processes (sandbox) */\n  skillToolProvider?: import('../interfaces/tool-provider').ToolProvider;\n  /** Local directory to sync sandbox output artifacts to (default: './outputs') */\n  localOutputDir?: string;\n\n  // Runtime (passed through to processes)\n  sandboxProvider?: import('../interfaces/sandbox-provider').SandboxProvider;\n  skillManager?: import('../skills/skill-manager').SkillManager;\n  skillIndexPath?: string;\n  telemetry?: import('../observability/otel').HarnessTelemetry;\n  hookRunner?: import('../hooks/hook-runner').HookRunner;\n  permissionManager?: import('../permissions/permission-manager').PermissionManager;\n  executeToolAction?: (action: import('../agent/types').ToolCallAction) => Promise<import('../interfaces/tool-provider').ToolResult | null>;\n}\n\n// ── Process types ──\n\nexport interface Process {\n  id: string;\n  action: string;\n  model: string;\n  status: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';\n\n  /** Outbox: observable stream of events from this process. */\n  outbox: AsyncIterable<ProcessEvent>;\n\n  /** Inbox: send messages or signals to a running process. */\n  inbox: {\n    send(message: import('../agent/types').AgentMessage): void;\n    cancel(): void;\n  };\n\n  /** Result (available after completion). */\n  result?: ProcessResult;\n}\n\nexport type ProcessEvent =\n  | { type: 'activity'; activity: Activity }\n  | { type: 'text_delta'; text: string }\n  | { type: 'step_start'; step: number }\n  | { type: 'step_end'; step: number; usage?: import('../agent/types').StepUsage }\n  | { type: 'episode'; episode: import('./arc-types').Episode }\n  | { type: 'done'; result: ProcessResult }\n  | { type: 'failed'; error: string };\n\nexport interface ProcessResult {\n  episode: import('./arc-types').Episode;\n  trace: import('./arc-types').EpisodeTrace;\n  artifacts: EpisodeArtifact[];\n  success: boolean;\n  durationMs: number;\n  resolvedModel: string;\n  error?: string;\n}\n\nexport interface ProcessRequest {\n  action: string;\n  contextEpisodeIds?: string[];\n  model?: import('./arc-types').ModelTier;\n  maxSteps?: number;\n  label?: string;\n  /** Named profile to use for this process (looked up from ArcLoopConfig.processProfiles). */\n  profile?: string;\n}\n\n/**\n * ProfileDeclaration — typed, declarative profile definition.\n *\n * Replaces hand-written system prompts with structured declarations.\n * The system generates prompts from the declaration and enforces tool constraints.\n *\n * @example\n *   const visual: ProfileDeclaration = {\n *     name: 'visual',\n *     signature: 'description -> compiledArtifact',\n *     tools: ['CompileJsx', 'Read', 'ListFiles'],\n *     skills: ['visual-explainer'],\n *   };\n */\nexport interface ProfileDeclaration {\n  /** Profile name (matches the Thread tool's profile parameter). */\n  name: string;\n  /** Typed signature: \"input -> output\". Describes what this profile produces. */\n  signature: string;\n  /** Tool names this profile can use. Only these tools are available — enforced at schema + executor level. */\n  tools: string[];\n  /** Domain knowledge injected into system prompt (skill content, color systems, etc.). */\n  background?: string;\n  /** Default model tier. */\n  model?: import('./arc-types').ModelTier;\n  /** Max LLM steps. */\n  maxSteps?: number;\n  /** Skill names this profile can use. SkillRouter is constrained to this set. Omit for all skills. */\n  skills?: string[];\n  /** Few-shot demonstration examples. Rendered as user/assistant message pairs in the prompt. */\n  demos?: Array<{\n    input: Record<string, string>;\n    output: Record<string, unknown>;\n  }>;\n}\n\n/** A named process profile — runtime form with resolved prompt and tools. */\nexport interface ProcessProfile {\n  /** System prompt for processes using this profile. */\n  systemPrompt: string;\n  /** Tools available to processes using this profile (overrides processTools). */\n  tools?: Record<string, import('./arc-types').AnyTool>;\n  /** Default model tier for this profile (Thread tool's explicit model overrides this). */\n  model?: import('./arc-types').ModelTier;\n  /** Max steps for this profile (Thread tool's explicit maxSteps overrides this). */\n  maxSteps?: number;\n  /** Allowed tool names for executor-level validation (populated from ProfileDeclaration.tools). */\n  allowedToolNames?: string[];\n  /** Zod schema for structured output on the terminal step (generated from typed signatures). */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  outputSchema?: import('zod').ZodObject<any>;\n  /** Few-shot demo messages rendered before the task prompt. */\n  demoMessages?: import('../agent/types').AgentMessage[];\n}\n\n/** A profile config can be either a declaration (new) or a raw ProcessProfile (backward compat). */\nexport type ProfileConfig = ProfileDeclaration | ProcessProfile;\n\n/** Type guard: check if a profile config is a declaration. */\nexport function isProfileDeclaration(p: ProfileConfig): p is ProfileDeclaration {\n  return 'signature' in p && typeof (p as ProfileDeclaration).signature === 'string';\n}\n\nexport type Activity =\n  | { type: 'tool_start'; name: string; args: Record<string, unknown>; ts: number }\n  | { type: 'tool_end'; name: string; ok: boolean; ms: number; preview?: string; ts: number };\n\n// ── Context window types ──\n\nexport interface Turn {\n  role: 'orchestrator' | 'process_result' | 'user';\n  messages: import('../agent/types').AgentMessage[];\n  tokenEstimate: number;\n  timestamp: number;\n}\n\nexport interface TokenBudget {\n  limit: number;\n  used: number;\n  layers: {\n    system: number;\n    memories: number;\n    episodes: number;\n    conversation: number;\n  };\n}\n\nexport interface PreparedContext {\n  messages: import('../agent/types').AgentMessage[];\n  budget: TokenBudget;\n}\n\n// ── Compression types ──\n\nexport interface CompressInput {\n  taskId: string;\n  sessionId: string;\n  index: number;\n  threadAction: string;\n  messages: import('../agent/types').AgentMessage[];\n  model: string;\n  parentEpisodeIds: string[];\n  success: boolean;\n}\n\nexport interface CompressOutput {\n  episode: import('./arc-types').Episode;\n  trace: import('./arc-types').EpisodeTrace;\n  artifacts: EpisodeArtifact[];\n}\n\n// ── Event protocol ──\n\nexport type ArcEvent =\n  | { type: 'text_delta'; text: string }\n  | { type: 'turn_start'; turn: number }\n  | { type: 'turn_end'; turn: number }\n  | { type: 'process_dispatched'; id: string; action: string; model: string; label?: string; profile?: string }\n  | { type: 'thread_rejected'; action: string; reason: string }\n  | { type: 'skill_resolved'; processId: string; skillName: string; skillPath: string }\n  | { type: 'process_activity'; id: string; activity: Activity }\n  | { type: 'process_text_delta'; id: string; text: string }\n  | { type: 'process_step_start'; id: string; step: number }\n  | { type: 'process_step_end'; id: string; step: number; usage?: import('../agent/types').StepUsage }\n  | { type: 'process_completed'; id: string; episodeId: string; summary: string; durationMs: number }\n  | { type: 'process_failed'; id: string; error: string }\n  | { type: 'process_cancelled'; id: string }\n  | { type: 'memory_stored'; id: string; content: string }\n  | { type: 'context_compressed'; tier: 'template' | 'episode_group' | 'llm'; tokensSaved: number }\n  | { type: 'done'; output: string; stats: RunStats };\n\nexport interface RunStats {\n  turns: number;\n  processes: number;\n  durationMs: number;\n}\n\nexport interface ArcRunResult {\n  output: string;\n  events: ArcEvent[];\n}\n\n// ── Trace types (for Stateright verification bridge) ──\n\nexport interface TraceEvent {\n  ts: number;\n  kind: TraceEventKind;\n}\n\nexport type TraceEventKind =\n  | { type: 'turn_start'; turn: number }\n  | { type: 'turn_end'; turn: number }\n  | { type: 'llm_call_start' }\n  | { type: 'llm_call_end'; response_type: string }\n  | { type: 'process_created'; id: string; status: string }\n  | { type: 'process_transition'; id: string; from: string; to: string }\n  | { type: 'tool_call'; tool: string; process_id?: string }\n  | { type: 'context_prepare'; used: number; limit: number; compression_tier: string }\n  | { type: 'abort_signal'; target?: string }\n  | { type: 'done' };\n","/**\n * DSPy-style signature parsing and schema generation.\n *\n * Parses signature strings like \"question:string -> evidence:string[], confidence:number\"\n * into typed field definitions, and generates Zod schemas for structured output.\n */\n\nimport { z } from 'zod';\n\n// ── Types ──\n\nexport interface SignatureField {\n  name: string;\n  type: 'string' | 'number' | 'boolean';\n  isArray: boolean;\n  isOptional: boolean;\n  description?: string;\n}\n\nexport interface ParsedSignature {\n  inputs: SignatureField[];\n  outputs: SignatureField[];\n}\n\n// ── Parser ──\n\nconst FIELD_RE = /^(\\w+)(?::(\\w+)(\\[\\])?)(\\?)?(?:\\s*\\(([^)]+)\\))?$/;\n\nfunction parseField(raw: string): SignatureField {\n  const trimmed = raw.trim();\n  const match = trimmed.match(FIELD_RE);\n\n  if (!match) {\n    // Bare field name — default to string\n    const name = trimmed.replace(/\\?$/, '');\n    return {\n      name,\n      type: 'string',\n      isArray: false,\n      isOptional: trimmed.endsWith('?'),\n    };\n  }\n\n  const [, name, typeStr, arrayMark, optionalMark, desc] = match;\n  const type = (['string', 'number', 'boolean'].includes(typeStr!) ? typeStr : 'string') as SignatureField['type'];\n\n  const field: SignatureField = {\n    name: name!,\n    type,\n    isArray: arrayMark === '[]',\n    isOptional: optionalMark === '?',\n  };\n  if (desc) field.description = desc.trim();\n  return field;\n}\n\n/**\n * Parse a signature string into typed input/output fields.\n *\n * @example\n *   parseSignature('question:string -> evidence:string[], confidence:number')\n *   // { inputs: [{ name: 'question', type: 'string', ... }],\n *   //   outputs: [{ name: 'evidence', type: 'string', isArray: true, ... },\n *   //             { name: 'confidence', type: 'number', ... }] }\n *\n *   parseSignature('query -> findings')\n *   // All fields default to type 'string', isArray false\n */\nexport function parseSignature(sig: string): ParsedSignature {\n  const arrowIdx = sig.indexOf('->');\n  if (arrowIdx < 0) {\n    throw new Error(`Invalid signature: missing \"->\". Got: \"${sig}\"`);\n  }\n\n  const inputStr = sig.slice(0, arrowIdx).trim();\n  const outputStr = sig.slice(arrowIdx + 2).trim();\n\n  const inputs = inputStr.split(',').map(s => s.trim()).filter(Boolean).map(parseField);\n  const outputs = outputStr.split(',').map(s => s.trim()).filter(Boolean).map(parseField);\n\n  return { inputs, outputs };\n}\n\n// ── Schema generation ──\n\n/**\n * Convert a parsed signature's output fields into a Zod schema.\n * Used with ai-sdk's generateObject() for structured output extraction.\n */\nexport function signatureToSchema(sig: ParsedSignature): z.ZodObject<Record<string, z.ZodTypeAny>> {\n  const shape: Record<string, z.ZodTypeAny> = {};\n\n  for (const field of sig.outputs) {\n    let base: z.ZodTypeAny;\n    switch (field.type) {\n      case 'number': base = z.number(); break;\n      case 'boolean': base = z.boolean(); break;\n      default: base = z.string(); break;\n    }\n    if (field.isArray) base = z.array(base);\n    if (field.description) base = base.describe(field.description);\n    if (field.isOptional) base = base.optional();\n    shape[field.name] = base;\n  }\n\n  return z.object(shape);\n}\n\n/**\n * Check if a signature string has typed fields (contains ':').\n * Untyped signatures like 'query -> findings' are treated as cosmetic labels.\n */\nexport function isTypedSignature(sig: string): boolean {\n  return /\\b\\w+:\\w+/.test(sig);\n}\n","/**\n * Profile builder — generates prompts and resolves tools from ProfileDeclarations.\n *\n * The core idea: profiles declare WHAT (signature, tools, background).\n * This module generates the HOW (system prompts, tool objects).\n */\n\nimport type { AnyTool } from './arc-types';\nimport type { ProfileDeclaration, ProcessProfile, ProfileConfig } from './types';\nimport { isProfileDeclaration } from './types';\nimport { parseSignature, signatureToSchema, isTypedSignature } from './sig';\n\n// ── Thread prompt generation ────────────────────────────────────\n\n/**\n * Generate a thread system prompt from a ProfileDeclaration.\n *\n * The prompt tells the thread:\n * - What it is (name)\n * - What it produces (signature)\n * - What tools it has (enforced, not suggested)\n * - Domain knowledge (background)\n */\nexport function buildProfilePrompt(decl: ProfileDeclaration): string {\n  const [input, output] = decl.signature.split('->').map(s => s.trim());\n  const lines = [\n    `You are a ${decl.name} thread.`,\n    `Your task: take ${input} and produce ${output}.`,\n    '',\n    `## Available tools`,\n    `You have access to: ${decl.tools.join(', ')}`,\n    'Use ONLY these tools. You cannot use any other tools.',\n    'If you have Skill Instructions below, follow them for delivery method and style.',\n  ];\n\n  if (decl.background) {\n    lines.push('', '## Background', decl.background);\n  }\n\n  return lines.join('\\n');\n}\n\n// ── Orchestrator prompt generation ──────────────────────────────\n\n/**\n * Generate an orchestrator system prompt from a set of profile declarations.\n *\n * The orchestrator sees profile names, signatures, and tool counts —\n * enough to route correctly. No tool names, no delivery methods.\n *\n * @param profiles - The registered profiles\n * @param preamble - Optional strategy preamble (phasing, rules, context).\n *                   Composed with the auto-generated profile catalog.\n */\nexport function buildOrchestratorPrompt(\n  profiles: Record<string, ProfileConfig>,\n  preamble?: string,\n): string {\n  const profileList = Object.entries(profiles)\n    .map(([name, p]) => {\n      if (isProfileDeclaration(p)) {\n        return `- **${name}** — ${p.signature} (tools: ${p.tools.length}, ${p.model || 'medium'})`;\n      }\n      // Legacy ProcessProfile — show name only\n      return `- **${name}**`;\n    })\n    .join('\\n');\n\n  const sections = [\n    'You are an orchestrator. Accomplish tasks by decomposing them into focused threads, delegating each to the right profile, and synthesizing results.',\n    '',\n    '## Workflow: Decompose → Delegate → Synthesize',\n    '',\n    '1. **Decompose**: Break the request into independent, focused sub-tasks.',\n    '2. **Delegate**: Dispatch each sub-task as a Thread call with the appropriate profile. Independent sub-tasks go in the SAME turn (parallel).',\n    '3. **Synthesize**: Combine thread results into a coherent response.',\n    '',\n    '## Profiles',\n    profileList,\n    '',\n    '## Thread actions',\n    'Describe WHAT to produce, not HOW. 2-5 sentences. Threads have tools and skill instructions — they know delivery methods.',\n    'ALWAYS set the profile parameter on every Thread call.',\n    '',\n    '## Concurrency',\n    'Dispatch at most 3 threads per turn. If more are needed, batch them.',\n    '',\n    '## Context passing',\n    'Threads automatically receive the user\\'s current message and attachments as seed context. Focus action text on WHAT to produce — threads already know what the user asked and what files are available.',\n    'Use contextEpisodeIds to chain dependent threads: research threads first (parallel), then implementation threads with their episodeIds.',\n  ];\n\n  if (preamble) {\n    // Insert preamble after the identity line\n    sections.splice(1, 0, '', preamble);\n  }\n\n  return sections.join('\\n');\n}\n\n// ── Tool resolution ─────────────────────────────────────────────\n\n/**\n * Resolve tool names to tool objects from the global tool registry.\n * Returns only the tools listed in the declaration.\n */\nexport function resolveProfileTools(\n  toolNames: string[],\n  globalTools: Record<string, AnyTool>,\n): Record<string, AnyTool> {\n  const resolved: Record<string, AnyTool> = {};\n  for (const name of toolNames) {\n    if (globalTools[name]) {\n      resolved[name] = globalTools[name];\n    }\n  }\n  return resolved;\n}\n\n// ── ProfileDeclaration → ProcessProfile conversion ──────────────\n\n/**\n * Build a runtime ProcessProfile from a ProfileDeclaration.\n * Generates the system prompt and resolves tool objects.\n */\nexport function buildProcessProfile(\n  decl: ProfileDeclaration,\n  globalTools: Record<string, AnyTool>,\n): ProcessProfile {\n  const profile: ProcessProfile = {\n    systemPrompt: buildProfilePrompt(decl),\n    tools: resolveProfileTools(decl.tools, globalTools),\n    allowedToolNames: decl.tools,\n  };\n  if (decl.model) profile.model = decl.model;\n  if (decl.maxSteps) profile.maxSteps = decl.maxSteps;\n  // Generate output schema from typed signatures (e.g., 'question:string -> evidence:string[]')\n  if (isTypedSignature(decl.signature)) {\n    const parsed = parseSignature(decl.signature);\n    if (parsed.outputs.length > 0) {\n      profile.outputSchema = signatureToSchema(parsed);\n    }\n  }\n  // Render demos as user/assistant message pairs\n  if (decl.demos && decl.demos.length > 0) {\n    profile.demoMessages = decl.demos.flatMap(demo => [\n      { role: 'user' as const, content: Object.entries(demo.input).map(([k, v]) => `${k}: ${v}`).join('\\n') },\n      { role: 'assistant' as const, content: JSON.stringify(demo.output, null, 2) },\n    ]);\n  }\n  return profile;\n}\n\n/**\n * Resolve a ProfileConfig (declaration or legacy) into a ProcessProfile.\n * Declarations are built; legacy profiles are passed through.\n */\nexport function resolveProfile(\n  config: ProfileConfig,\n  globalTools: Record<string, AnyTool>,\n): ProcessProfile {\n  if (isProfileDeclaration(config)) {\n    return buildProcessProfile(config, globalTools);\n  }\n  // Backfill allowedToolNames for legacy profiles when tools are defined\n  if (config.tools && !config.allowedToolNames) {\n    return { ...config, allowedToolNames: Object.keys(config.tools) };\n  }\n  return config;\n}\n"]}

package/dist/loop/vercel-agent-loop.d.ts

@@ -1,99 +0,0 @@
-import { Tool } from 'ai';
-import { g as AgentLoop, S as StepUsage, M as ModelFactory, h as ToolChoiceConfig, i as PrepareStepContext, j as PrepareStepResult, b as AgentMessage, k as AgentAction, l as AgentStreamEvent } from '../types-g-3DvSSE.js';
-import 'zod';
-
-type AnyTool = Tool<any, any>;
-/** Built-in tool schemas. Merge with custom tools: `{ ...builtinTools, ...myTools }` */
-declare const builtinTools: {
-    Bash: Tool<{
-        command: string;
-        cwd?: string | undefined;
-        timeout?: number | undefined;
-    }, never>;
-    Read: Tool<{
-        path: string;
-    }, never>;
-    Write: Tool<{
-        path: string;
-        content: string;
-    }, never>;
-    Edit: Tool<{
-        path: string;
-        old_text: string;
-        new_text: string;
-    }, never>;
-    Glob: Tool<{
-        pattern: string;
-    }, never>;
-    Grep: Tool<{
-        pattern: string;
-        path?: string | undefined;
-    }, never>;
-    WebFetch: Tool<{
-        url: string;
-        selector?: string | undefined;
-        maxContentLength?: number | undefined;
-    }, never>;
-    WebSearch: Tool<{
-        query: string;
-    }, never>;
-    AskUser: Tool<{
-        question: string;
-        options?: string[] | undefined;
-    }, never>;
-    TellUser: Tool<{
-        message: string;
-    }, never>;
-    DownloadRawFile: Tool<{
-        path: string;
-    }, never>;
-};
-/** A system prompt block with optional Anthropic cache control. */
-interface SystemPromptBlock {
-    text: string;
-    cacheControl?: {
-        type: 'ephemeral';
-    };
-}
-interface VercelAgentLoopConfig {
-    model?: string;
-    /** System prompt — string or structured blocks with cache control markers. */
-    systemPrompt?: string | SystemPromptBlock[];
-    createModel?: ModelFactory;
-    /** @deprecated Prefer createModel. */
-    apiKey?: string;
-    /** Custom tool definitions. If provided, replaces built-in agentTools for LLM calls. */
-    tools?: Record<string, AnyTool>;
-    /** Tool choice for LLM calls. Supports per-turn callbacks. Default: 'auto'. */
-    toolChoice?: ToolChoiceConfig;
-    /** Provider options passed to generateText/streamText (e.g. anthropic thinking config). */
-    providerOptions?: Record<string, unknown>;
-    /** Per-step callback to override model and active tools before each LLM call. */
-    prepareStep?: (context: PrepareStepContext) => PrepareStepResult | void;
-}
-declare class VercelAgentLoop implements AgentLoop {
-    private readonly model;
-    private readonly createModel;
-    private readonly systemPrompt;
-    private readonly tools;
-    private readonly validToolNames;
-    private readonly toolChoiceConfig;
-    private readonly providerOptions;
-    private readonly prepareStep;
-    /** Track tool names called across steps for prepareStep context. */
-    private toolCallHistory;
-    private step;
-    /** Last step's token usage — read after nextAction/streamAction completes. */
-    lastUsage: StepUsage | undefined;
-    constructor(config?: VercelAgentLoopConfig);
-    /** Build the `system` parameter for generateText/streamText. */
-    private buildSystemParam;
-    /** Resolve model + tools for this step via prepareStep callback. */
-    private resolveStep;
-    /** Extract StepUsage from AI SDK usage object. */
-    private static extractUsage;
-    nextAction(messages: AgentMessage[]): Promise<AgentAction>;
-    streamAction(messages: AgentMessage[]): AsyncGenerator<AgentStreamEvent>;
-}
-
-export { type SystemPromptBlock, VercelAgentLoop, type VercelAgentLoopConfig, builtinTools };