@corbat-tech/coco 2.37.0 → 2.38.0

package/dist/index.js

@@ -19438,6 +19438,199 @@ z.string().regex(
 // src/cli/repl/agents/manager.ts
 init_logger();
 
+// src/runtime/multi-agent.ts
+var SharedWorkspaceState = class {
+  facts = /* @__PURE__ */ new Map();
+  decisions = /* @__PURE__ */ new Map();
+  risks = /* @__PURE__ */ new Map();
+  files = /* @__PURE__ */ new Map();
+  testResults = /* @__PURE__ */ new Map();
+  artifacts = [];
+  writeFact(key, value) {
+    this.facts.set(key, value);
+  }
+  recordDecision(key, value) {
+    this.decisions.set(key, value);
+  }
+  recordRisk(key, value) {
+    this.risks.set(key, value);
+  }
+  recordFile(path44, value) {
+    this.files.set(path44, value);
+  }
+  recordTestResult(key, value) {
+    this.testResults.set(key, value);
+  }
+  addArtifact(artifact) {
+    this.artifacts.push(cloneArtifact(artifact));
+  }
+  readForRole(role) {
+    const includeSensitive = role === "security" || role === "integrator" || role === "pm";
+    return {
+      facts: Object.fromEntries(this.facts),
+      decisions: Object.fromEntries(this.decisions),
+      risks: includeSensitive ? Object.fromEntries(this.risks) : {},
+      files: Object.fromEntries(this.files),
+      testResults: Object.fromEntries(this.testResults),
+      artifacts: this.artifacts.filter((artifact) => includeSensitive || artifact.kind !== "riskReport").map(cloneArtifact)
+    };
+  }
+  snapshot() {
+    return {
+      facts: Object.fromEntries(this.facts),
+      decisions: Object.fromEntries(this.decisions),
+      risks: Object.fromEntries(this.risks),
+      files: Object.fromEntries(this.files),
+      testResults: Object.fromEntries(this.testResults),
+      artifacts: this.artifacts.map(cloneArtifact)
+    };
+  }
+};
+function createAgentArtifact(input) {
+  return {
+    ...input,
+    id: input.id ?? `artifact-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
+    createdAt: input.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function createSummaryArtifact(output, metadata = {}) {
+  return createAgentArtifact({
+    kind: "summary",
+    content: output,
+    title: metadata.title ?? "Agent summary",
+    agentRunId: metadata.agentRunId,
+    taskId: metadata.taskId
+  });
+}
+function normalizeAgentRunResult(input) {
+  const completedAt = input.completedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+  const startedAt = input.startedAt ?? completedAt;
+  const status = input.status ?? (input.success ? "completed" : "failed");
+  const artifacts = input.artifacts && input.artifacts.length > 0 ? input.artifacts.map(cloneArtifact) : [createSummaryArtifact(input.output, { agentRunId: input.id, taskId: input.taskId })];
+  return {
+    id: input.id,
+    taskId: input.taskId,
+    role: input.role,
+    status,
+    success: input.success,
+    output: input.output,
+    artifacts,
+    toolsUsed: [...input.toolsUsed ?? []],
+    turns: input.turns ?? 0,
+    durationMs: input.durationMs ?? 0,
+    usage: input.usage,
+    error: input.error,
+    startedAt,
+    completedAt,
+    metadata: input.metadata
+  };
+}
+function validateAgentCapabilities(capability, requiredTools = []) {
+  const allowed = new Set(capability.allowedTools);
+  return requiredTools.filter((tool) => !allowed.has(tool)).map((tool) => ({
+    code: "missing-dependency",
+    message: `Tool '${tool}' is not allowed for agent role '${capability.role}'.`
+  }));
+}
+function validateAgentGraph(graph) {
+  const issues = [];
+  const nodeIds = /* @__PURE__ */ new Set();
+  const gateIds = new Set((graph.gates ?? []).map((gate) => gate.id));
+  if (graph.parallelism !== void 0 && graph.parallelism < 1) {
+    issues.push({
+      code: "invalid-parallelism",
+      message: "Graph parallelism must be greater than zero."
+    });
+  }
+  for (const node of graph.nodes) {
+    if (nodeIds.has(node.id)) {
+      issues.push({
+        code: "duplicate-node",
+        message: `Duplicate graph node '${node.id}'.`,
+        nodeId: node.id
+      });
+    }
+    nodeIds.add(node.id);
+    if (node.retryPolicy && node.retryPolicy.maxAttempts < 1) {
+      issues.push({
+        code: "invalid-retry-policy",
+        message: `Node '${node.id}' retry policy must allow at least one attempt.`,
+        nodeId: node.id
+      });
+    }
+    for (const dep of node.dependsOn ?? []) {
+      if (!nodeIds.has(dep) && !graph.nodes.some((candidate) => candidate.id === dep)) {
+        issues.push({
+          code: "missing-dependency",
+          message: `Node '${node.id}' depends on missing node '${dep}'.`,
+          nodeId: node.id
+        });
+      }
+    }
+    for (const gate of node.gates ?? []) {
+      if (!gateIds.has(gate)) {
+        issues.push({
+          code: "missing-gate",
+          message: `Node '${node.id}' references missing gate '${gate}'.`,
+          nodeId: node.id,
+          gateId: gate
+        });
+      }
+    }
+  }
+  for (const edge of graph.edges ?? []) {
+    if (!nodeIds.has(edge.from)) {
+      issues.push({
+        code: "missing-edge-node",
+        message: `Graph edge references missing source node '${edge.from}'.`,
+        nodeId: edge.from
+      });
+    }
+    if (!nodeIds.has(edge.to)) {
+      issues.push({
+        code: "missing-edge-node",
+        message: `Graph edge references missing target node '${edge.to}'.`,
+        nodeId: edge.to
+      });
+    }
+  }
+  const levels = buildExecutionLevels(graph, issues);
+  return { valid: issues.length === 0, issues, levels };
+}
+function buildExecutionLevels(graph, issues) {
+  const dependencies = /* @__PURE__ */ new Map();
+  for (const node of graph.nodes) {
+    dependencies.set(node.id, new Set(node.dependsOn ?? []));
+  }
+  for (const edge of graph.edges ?? []) {
+    if (dependencies.has(edge.to)) {
+      dependencies.get(edge.to).add(edge.from);
+    }
+  }
+  const completed = /* @__PURE__ */ new Set();
+  const levels = [];
+  while (completed.size < dependencies.size) {
+    const level = [...dependencies.entries()].filter(([id, deps]) => !completed.has(id) && [...deps].every((dep) => completed.has(dep))).map(([id]) => id);
+    if (level.length === 0) {
+      const remaining = [...dependencies.keys()].filter((id) => !completed.has(id));
+      issues.push({
+        code: "cycle",
+        message: `Graph contains a cycle involving: ${remaining.join(", ")}.`
+      });
+      return levels;
+    }
+    for (const id of level) completed.add(id);
+    levels.push(level);
+  }
+  return levels;
+}
+function cloneArtifact(artifact) {
+  return {
+    ...artifact,
+    metadata: artifact.metadata ? { ...artifact.metadata } : void 0
+  };
+}
+
 // src/cli/repl/agents/prompts.ts
 var EXPLORE_PROMPT = `You are an exploration agent for Corbat-Coco.
 Your purpose is to search the codebase to answer questions and gather information.
@@ -20018,11 +20211,15 @@ var AgentManager = class extends EventEmitter {
       failedAgent.status = "failed";
       failedAgent.error = error;
       failedAgent.completedAt = /* @__PURE__ */ new Date();
-      return {
+      return this.buildResult({
         agent: failedAgent,
         success: false,
-        output: error
-      };
+        output: error,
+        turns: 0,
+        toolsUsed: [],
+        startedAt: failedAgent.createdAt.toISOString(),
+        usage: { inputTokens: 0, outputTokens: 0 }
+      });
     }
     const agent = this.createAgent(type, task);
     this.activeAgents.set(agent.id, agent);
@@ -20074,11 +20271,15 @@ var AgentManager = class extends EventEmitter {
       options.onStatusChange?.(agent);
       this.logger.error(`Agent ${agent.id} failed unexpectedly`, { error: errorMessage });
       this.emitEvent("fail", agent);
-      return {
+      return this.buildResult({
         agent,
         success: false,
-        output: errorMessage
-      };
+        output: errorMessage,
+        turns: 0,
+        toolsUsed: [],
+        startedAt: agent.createdAt.toISOString(),
+        usage: { inputTokens: 0, outputTokens: 0 }
+      });
     }
   }
   /**
@@ -20199,6 +20400,8 @@ var AgentManager = class extends EventEmitter {
     let finalOutput = "";
     let iteration = 0;
     const maxTurns = config.maxTurns ?? 10;
+    const startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    const toolsUsed = /* @__PURE__ */ new Set();
     while (iteration < maxTurns) {
       iteration++;
       if (options.signal?.aborted) {
@@ -20207,12 +20410,15 @@ var AgentManager = class extends EventEmitter {
         agent.completedAt = /* @__PURE__ */ new Date();
         this.moveToCompleted(agent.id);
         options.onStatusChange?.(agent);
-        return {
+        return this.buildResult({
           agent,
           success: false,
           output: "Agent execution was aborted",
+          turns: iteration,
+          toolsUsed: Array.from(toolsUsed),
+          startedAt,
           usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens }
-        };
+        });
       }
       const response = await this.provider.chatWithTools(messages, {
         system: config.systemPrompt,
@@ -20229,7 +20435,7 @@ var AgentManager = class extends EventEmitter {
         messages.push({ role: "assistant", content: response.content });
         break;
       }
-      const toolResults = await this.executeToolCalls(response.toolCalls, config);
+      const toolResults = await this.executeToolCalls(response.toolCalls, config, toolsUsed);
       const toolUses = response.toolCalls.map((tc) => ({
         type: "tool_use",
         id: tc.id,
@@ -20253,12 +20459,15 @@ var AgentManager = class extends EventEmitter {
       iterations: iteration,
       outputLength: finalOutput.length
     });
-    return {
+    return this.buildResult({
       agent,
       success: true,
       output: finalOutput,
+      turns: iteration,
+      toolsUsed: Array.from(toolsUsed),
+      startedAt,
       usage: { inputTokens: totalInputTokens, outputTokens: totalOutputTokens }
-    };
+    });
   }
   /**
    * Get tool definitions filtered for the agent's allowed tools
@@ -20271,10 +20480,11 @@ var AgentManager = class extends EventEmitter {
   /**
    * Execute tool calls and return results
    */
-  async executeToolCalls(toolCalls, config) {
+  async executeToolCalls(toolCalls, config, toolsUsed) {
     const results = [];
     const allowedTools = new Set(config.tools);
     for (const toolCall of toolCalls) {
+      toolsUsed.add(toolCall.name);
       if (!allowedTools.has(toolCall.name)) {
         results.push({
           type: "tool_result",
@@ -20315,6 +20525,33 @@ var AgentManager = class extends EventEmitter {
       this.abortControllers.delete(agentId);
     }
   }
+  buildResult(input) {
+    const structuredResult = normalizeAgentRunResult({
+      id: `${input.agent.id}-run`,
+      taskId: input.agent.id,
+      role: agentTypeToRuntimeRole(input.agent.type),
+      success: input.success,
+      output: input.output,
+      turns: input.turns,
+      toolsUsed: input.toolsUsed,
+      usage: input.usage,
+      startedAt: input.startedAt,
+      durationMs: input.agent.completedAt ? input.agent.completedAt.getTime() - input.agent.createdAt.getTime() : 0,
+      status: input.success ? "completed" : "failed",
+      error: input.success ? void 0 : input.agent.error,
+      metadata: { agentType: input.agent.type }
+    });
+    return {
+      agent: input.agent,
+      success: input.success,
+      output: input.output,
+      artifacts: structuredResult.artifacts,
+      structuredResult,
+      toolsUsed: input.toolsUsed,
+      turns: input.turns,
+      usage: input.usage
+    };
+  }
   /**
    * Emit an agent event
    */
@@ -20324,6 +20561,31 @@ var AgentManager = class extends EventEmitter {
     this.emit("agent", event);
   }
 };
+function agentTypeToRuntimeRole(type) {
+  switch (type) {
+    case "explore":
+      return "researcher";
+    case "plan":
+      return "planner";
+    case "test":
+    case "e2e":
+    case "tdd":
+      return "tester";
+    case "debug":
+    case "refactor":
+      return "coder";
+    case "review":
+      return "reviewer";
+    case "architect":
+      return "architect";
+    case "security":
+      return "security";
+    case "docs":
+      return "docs";
+    case "database":
+      return "database";
+  }
+}
 
 // src/agents/provider-bridge.ts
 var agentProvider = null;
@@ -20355,6 +20617,140 @@ function getAgentManager() {
 
 // src/runtime/agent-runtime.ts
 init_env();
+var PUBLIC_WEB_TOOLS = /* @__PURE__ */ new Set(["search_public_docs", "list_public_services"]);
+var CUSTOMER_SUPPORT_TOOLS = /* @__PURE__ */ new Set([
+  "search_public_docs",
+  "knowledge_search",
+  "create_support_draft",
+  "request_human_escalation"
+]);
+function createNoToolRegistry() {
+  return new ToolRegistry();
+}
+function createCodingToolRegistry() {
+  return createFullToolRegistry();
+}
+function createPublicWebToolRegistry(source) {
+  return copyAllowedTools(PUBLIC_WEB_TOOLS, source);
+}
+function createCustomerSupportToolRegistry(source) {
+  return copyAllowedTools(CUSTOMER_SUPPORT_TOOLS, source);
+}
+function createSupportRagToolRegistry(options = {}) {
+  const registry = createRagToolRegistry(options.retriever);
+  if (options.supportDraft) {
+    registry.register(
+      defineTool({
+        name: "create_support_draft",
+        description: "Create a support response draft from the customer message and approved retrieved sources.",
+        category: "document",
+        parameters: z.object({
+          conversationId: z.string(),
+          customerMessage: z.string(),
+          retrievedSources: z.array(
+            z.object({
+              id: z.string(),
+              title: z.string(),
+              content: z.string(),
+              url: z.string().optional(),
+              score: z.number(),
+              metadata: z.record(z.string(), z.unknown()).optional()
+            })
+          ).optional()
+        }),
+        execute: options.supportDraft
+      })
+    );
+  }
+  if (options.humanEscalation) {
+    registry.register(
+      defineTool({
+        name: "request_human_escalation",
+        description: "Prepare a human escalation request. Runtime consumers must confirmation-gate this external action.",
+        category: "config",
+        parameters: z.object({
+          conversationId: z.string(),
+          summary: z.string(),
+          priority: z.enum(["low", "normal", "high", "urgent"]),
+          reason: z.string()
+        }),
+        execute: options.humanEscalation
+      })
+    );
+  }
+  return registry;
+}
+function createSalesIntakeToolRegistry(options = {}) {
+  const registry = new ToolRegistry();
+  if (options.leadSummary) {
+    registry.register(
+      defineTool({
+        name: "create_sales_lead_summary",
+        description: "Create a structured lead intake summary and recommended commercial next step.",
+        category: "document",
+        parameters: z.object({
+          conversationId: z.string(),
+          company: z.string().optional(),
+          contact: z.string().optional(),
+          problem: z.string(),
+          desiredOutcome: z.string().optional(),
+          urgency: z.enum(["low", "normal", "high"]).optional(),
+          budgetRange: z.string().optional(),
+          currentStack: z.string().optional()
+        }),
+        execute: options.leadSummary
+      })
+    );
+  }
+  return registry;
+}
+function createInternalOpsToolRegistry(options = {}) {
+  const registry = new ToolRegistry();
+  if (options.opsDraft) {
+    registry.register(
+      defineTool({
+        name: "create_internal_ops_draft",
+        description: "Prepare an internal operations action draft. This does not execute the operation.",
+        category: "document",
+        parameters: z.object({
+          requestId: z.string(),
+          requester: z.string().optional(),
+          workflow: z.string(),
+          requestedAction: z.string(),
+          context: z.string().optional()
+        }),
+        execute: options.opsDraft
+      })
+    );
+  }
+  return registry;
+}
+function createRagToolRegistry(retriever) {
+  const registry = new ToolRegistry();
+  if (!retriever) return registry;
+  registry.register(
+    defineTool({
+      name: "knowledge_search",
+      description: "Search the configured knowledge base and return ranked sources.",
+      category: "search",
+      parameters: z.object({
+        query: z.string(),
+        limit: z.number().optional()
+      }),
+      execute: async ({ query, limit }) => retriever.search(query, { limit })
+    })
+  );
+  return registry;
+}
+function copyAllowedTools(allowed, source) {
+  const registry = new ToolRegistry();
+  if (!source) return registry;
+  for (const name of allowed) {
+    const tool = source.get(name);
+    if (tool) registry.register(tool);
+  }
+  return registry;
+}
 init_errors();
 init_allowed_paths();
 function levenshtein(a, b) {
@@ -32316,7 +32712,8 @@ var DESTRUCTIVE_TOOL_NAMES = /* @__PURE__ */ new Set([
   "delete_file",
   "restore_checkpoint",
   "git_commit",
-  "git_push"
+  "git_push",
+  "request_human_escalation"
 ]);
 function riskForTool(tool) {
   if (READ_ONLY_TOOL_NAMES.has(tool.name)) return "read-only";
@@ -32543,7 +32940,32 @@ function cloneWorkflow(workflow) {
     steps: workflow.steps.map((step) => ({
       ...step,
       requiredTools: [...step.requiredTools]
-    }))
+    })),
+    nodes: workflow.nodes?.map((node) => ({
+      ...node,
+      dependsOn: node.dependsOn ? [...node.dependsOn] : void 0,
+      requiredTools: node.requiredTools ? [...node.requiredTools] : void 0,
+      gates: node.gates ? [...node.gates] : void 0,
+      retryPolicy: node.retryPolicy ? { ...node.retryPolicy } : void 0
+    })),
+    edges: workflow.edges?.map((edge) => ({ ...edge })),
+    gates: workflow.gates?.map((gate) => ({ ...gate })),
+    retryPolicy: workflow.retryPolicy ? { ...workflow.retryPolicy } : void 0
+  };
+}
+function workflowToAgentGraph(workflow) {
+  const nodes = workflow.nodes ?? workflow.steps.map((step, index) => ({
+    id: step.id,
+    description: step.description,
+    requiredTools: [...step.requiredTools],
+    risk: step.risk,
+    dependsOn: index > 0 ? [workflow.steps[index - 1].id] : []
+  }));
+  return {
+    nodes,
+    edges: workflow.edges,
+    gates: workflow.gates,
+    parallelism: workflow.parallelism
   };
 }
 var WorkflowCatalog = class {
@@ -32554,6 +32976,12 @@ var WorkflowCatalog = class {
     }
   }
   register(workflow) {
+    const validation = validateAgentGraph(workflowToAgentGraph(workflow));
+    if (!validation.valid) {
+      throw new Error(
+        `Invalid workflow graph for '${workflow.id}': ${validation.issues.map((issue) => issue.message).join("; ")}`
+      );
+    }
     this.workflows.set(workflow.id, cloneWorkflow(workflow));
   }
   get(id) {
@@ -32579,7 +33007,8 @@ var WorkflowCatalog = class {
       workflowId,
       planId: plan.id,
       replayable: workflow.replayable,
-      checks: workflow.checks
+      checks: workflow.checks,
+      graphLevels: validateAgentGraph(workflowToAgentGraph(workflow)).levels
     });
     return plan;
   }
@@ -33177,6 +33606,115 @@ async function createAgentRuntime(options) {
   await runtime.initialize();
   return runtime;
 }
+
+// src/runtime/tool-calling-turn-runner.ts
+function runtimeWithTools(runtime) {
+  if (runtime && typeof runtime === "object" && "executeTool" in runtime && typeof runtime.executeTool === "function") {
+    return runtime;
+  }
+  throw new Error("ToolCallingRuntimeTurnRunner requires a runtime with executeTool().");
+}
+function toolResultToContent(result) {
+  if (!result.success) {
+    return `Error: ${result.error ?? "Tool failed."}`;
+  }
+  if (typeof result.output === "string") return result.output;
+  return JSON.stringify(result.output ?? null);
+}
+var ToolCallingRuntimeTurnRunner = class {
+  maxToolIterations;
+  constructor(options = {}) {
+    this.maxToolIterations = options.maxToolIterations ?? 10;
+  }
+  async run(input, context) {
+    const runtime = runtimeWithTools(context.runtime);
+    const messages = [
+      ...context.session.messages,
+      {
+        role: "user",
+        content: input.content
+      }
+    ];
+    const tools = context.toolRegistry.getToolDefinitionsForLLM();
+    const confirmedTools = new Set(input.confirmedTools ?? []);
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let lastModel = input.options?.model ?? context.provider.id;
+    for (let iteration = 0; iteration < this.maxToolIterations; iteration++) {
+      const response = await context.provider.chatWithTools(messages, {
+        tools,
+        model: input.options?.model,
+        maxTokens: input.options?.maxTokens,
+        temperature: input.options?.temperature,
+        stopSequences: input.options?.stopSequences,
+        system: context.session.instructions ?? input.options?.system,
+        timeout: input.options?.timeout,
+        signal: input.options?.signal,
+        thinking: input.options?.thinking
+      });
+      inputTokens += response.usage.inputTokens;
+      outputTokens += response.usage.outputTokens;
+      lastModel = response.model;
+      if (response.stopReason !== "tool_use" || response.toolCalls.length === 0) {
+        return {
+          sessionId: context.session.id,
+          content: response.content,
+          usage: { inputTokens, outputTokens },
+          model: response.model,
+          mode: context.session.mode
+        };
+      }
+      const assistantContent = [];
+      if (response.content.trim().length > 0) {
+        assistantContent.push({ type: "text", text: response.content });
+      }
+      for (const toolCall of response.toolCalls) {
+        assistantContent.push({
+          type: "tool_use",
+          id: toolCall.id,
+          name: toolCall.name,
+          input: toolCall.input,
+          geminiThoughtSignature: toolCall.geminiThoughtSignature
+        });
+      }
+      messages.push({
+        role: "assistant",
+        content: assistantContent
+      });
+      const toolResults = [];
+      for (const toolCall of response.toolCalls) {
+        const result = await runtime.executeTool({
+          sessionId: context.session.id,
+          mode: context.session.mode,
+          toolName: toolCall.name,
+          input: toolCall.input,
+          confirmed: confirmedTools.has(toolCall.name),
+          metadata: input.metadata
+        });
+        toolResults.push({
+          type: "tool_result",
+          tool_use_id: toolCall.id,
+          content: toolResultToContent(result),
+          is_error: !result.success
+        });
+      }
+      messages.push({
+        role: "user",
+        content: toolResults
+      });
+    }
+    return {
+      sessionId: context.session.id,
+      content: "The tool-calling runtime reached its maximum tool iteration budget.",
+      usage: { inputTokens, outputTokens },
+      model: lastModel,
+      mode: context.session.mode
+    };
+  }
+};
+function createToolCallingRuntimeTurnRunner(options) {
+  return new ToolCallingRuntimeTurnRunner(options);
+}
 var HttpRequestError = class extends Error {
   constructor(message, status) {
     super(message);
@@ -33288,11 +33826,543 @@ function createMcpToolPolicy(server, tool, risk, allowedModes = ["ask", "plan",
   };
 }
 
+// src/runtime/guardrails.ts
+var DEFAULT_REDACTION = "[REDACTED]";
+var SECRET_PATTERNS = [
+  { id: "openai-api-key", pattern: /\bsk-[A-Za-z0-9_-]{20,}\b/g },
+  { id: "anthropic-api-key", pattern: /\bsk-ant-[A-Za-z0-9_-]{20,}\b/g },
+  { id: "github-token", pattern: /\bgh[pousr]_[A-Za-z0-9_]{20,}\b/g },
+  { id: "generic-bearer-token", pattern: /\bBearer\s+[A-Za-z0-9._~+/=-]{20,}\b/gi },
+  {
+    id: "private-key",
+    pattern: /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/g
+  }
+];
+var PROMPT_INJECTION_PATTERNS = [
+  {
+    id: "ignore-instructions",
+    pattern: /\b(ignore|forget|override)\b.{0,40}\b(instructions|system|developer)\b/i
+  },
+  {
+    id: "reveal-prompt",
+    pattern: /\b(reveal|print|show|dump)\b.{0,40}\b(system prompt|instructions|developer message)\b/i
+  },
+  {
+    id: "tool-exfiltration",
+    pattern: /\b(use|call|run)\b.{0,40}\b(tool|shell|filesystem|git)\b.{0,40}\b(secret|token|key)\b/i
+  }
+];
+var defaultPublicGuardrails = {
+  maxInputChars: 4e3,
+  maxOutputChars: 6e3,
+  secretRedaction: { enabled: true },
+  promptInjectionDetection: true
+};
+function redactSecrets(content, config = { enabled: true }) {
+  if (!config.enabled) return { content, findings: [] };
+  let redacted = content;
+  const findings = [];
+  const replacement = config.replacement ?? DEFAULT_REDACTION;
+  for (const { id, pattern } of SECRET_PATTERNS) {
+    const before = redacted;
+    redacted = redacted.replace(pattern, replacement);
+    if (before !== redacted) {
+      findings.push({
+        id,
+        stage: "input",
+        severity: "warning",
+        message: `Potential secret redacted: ${id}`,
+        redacted: true
+      });
+    }
+  }
+  return { content: redacted, findings };
+}
+function runGuardrails(stage, content, config = {}) {
+  const findings = [];
+  const maxChars = stage === "input" ? config.maxInputChars : config.maxOutputChars;
+  let checked = content;
+  if (typeof maxChars === "number" && checked.length > maxChars) {
+    findings.push({
+      id: `${stage}-too-long`,
+      stage,
+      severity: "blocked",
+      message: `${stage} exceeds ${maxChars} characters.`
+    });
+  }
+  const redaction = redactSecrets(checked, config.secretRedaction);
+  checked = redaction.content;
+  findings.push(...redaction.findings.map((finding) => ({ ...finding, stage })));
+  if (config.promptInjectionDetection) {
+    for (const { id, pattern } of PROMPT_INJECTION_PATTERNS) {
+      if (pattern.test(checked)) {
+        findings.push({
+          id,
+          stage,
+          severity: "warning",
+          message: `Potential prompt-injection pattern detected: ${id}`
+        });
+      }
+    }
+  }
+  const blockedTopics = config.topicBoundary?.blockedTopics ?? [];
+  for (const topic of blockedTopics) {
+    if (topic && checked.toLowerCase().includes(topic.toLowerCase())) {
+      findings.push({
+        id: "blocked-topic",
+        stage,
+        severity: "blocked",
+        message: `Content mentions blocked topic: ${topic}`
+      });
+    }
+  }
+  return {
+    allowed: !findings.some((finding) => finding.severity === "blocked"),
+    content: checked,
+    findings
+  };
+}
+function validateStructuredOutput(output, schema) {
+  if (!schema) return [];
+  const result = schema.safeParse(output);
+  if (result.success) return [];
+  return [
+    {
+      id: "invalid-structured-output",
+      stage: "output",
+      severity: "blocked",
+      message: result.error.issues.map((issue) => issue.message).join("; ")
+    }
+  ];
+}
+
+// src/runtime/blueprints.ts
+function mapActionModeToRuntimeMode(mode) {
+  if (mode === "act") return "build";
+  if (mode === "review") return "review";
+  return "ask";
+}
+function createSafeToolRegistry(allowedTools, source) {
+  const safe = new ToolRegistry();
+  if (!source) return safe;
+  for (const toolName of allowedTools) {
+    const tool = source.get(toolName);
+    if (tool) safe.register(tool);
+  }
+  return safe;
+}
+async function createAgentFromBlueprint(blueprint, options) {
+  const runtime = await createAgentRuntime({
+    providerType: options.providerType,
+    model: options.model,
+    providerConfig: options.providerConfig,
+    provider: options.provider,
+    eventLog: options.eventLog,
+    turnRunner: options.turnRunner,
+    toolRegistry: options.toolRegistry ?? createSafeToolRegistry(blueprint.allowedTools.length > 0 ? blueprint.allowedTools : []),
+    publishToGlobalBridge: false
+  });
+  return {
+    blueprint,
+    runtime,
+    createSession(metadata = {}) {
+      return runtime.createSession({
+        mode: mapActionModeToRuntimeMode(blueprint.defaultMode),
+        instructions: blueprint.instructions,
+        metadata: {
+          blueprintId: blueprint.id,
+          surface: blueprint.surface,
+          ...metadata
+        }
+      });
+    },
+    async runTurn(input) {
+      const guardrails = { ...defaultPublicGuardrails, ...blueprint.guardrails };
+      const checkedInput = runGuardrails("input", input.content, guardrails);
+      runtime.eventLog.record("guardrail.input", {
+        blueprintId: blueprint.id,
+        allowed: checkedInput.allowed,
+        findings: checkedInput.findings
+      });
+      if (!checkedInput.allowed) {
+        throw new Error(formatGuardrailBlock(checkedInput.findings));
+      }
+      const result = await runtime.runTurn({
+        ...input,
+        content: checkedInput.content,
+        mode: input.mode ?? mapActionModeToRuntimeMode(blueprint.defaultMode)
+      });
+      const checkedOutput = runGuardrails("output", result.content, guardrails);
+      runtime.eventLog.record("guardrail.output", {
+        blueprintId: blueprint.id,
+        allowed: checkedOutput.allowed,
+        findings: checkedOutput.findings
+      });
+      if (!checkedOutput.allowed) {
+        throw new Error(formatGuardrailBlock(checkedOutput.findings));
+      }
+      return { ...result, content: checkedOutput.content };
+    }
+  };
+}
+function formatGuardrailBlock(findings) {
+  const messages = findings.filter((finding) => finding.severity === "blocked").map((finding) => finding.message);
+  return messages.length > 0 ? messages.join("; ") : "Guardrail blocked the request.";
+}
+function createBaseBlueprint(input) {
+  return {
+    ...input,
+    guardrails: input.guardrails ?? defaultPublicGuardrails,
+    memory: input.memory ?? { enabled: true, retention: "session" },
+    approval: input.approval ?? { requireHumanForExternalActions: true },
+    observability: input.observability ?? { logEvents: true, redactSensitiveData: true }
+  };
+}
+
+// src/runtime/rag.ts
+var InMemoryKnowledgeRetriever = class {
+  constructor(documents) {
+    this.documents = documents;
+  }
+  documents;
+  async search(query, options = {}) {
+    const terms = tokenize(query);
+    const limit = options.limit ?? 5;
+    const minScore = options.minScore ?? 0;
+    return this.documents.map((document) => ({
+      ...document,
+      score: scoreDocument(document, terms)
+    })).filter((source) => source.score >= minScore && source.score > 0).sort((a, b) => b.score - a.score).slice(0, limit);
+  }
+};
+function createInMemoryKnowledgeRetriever(documents) {
+  return new InMemoryKnowledgeRetriever(documents);
+}
+function formatRetrievedSourcesForPrompt(sources) {
+  if (sources.length === 0) return "No retrieved sources.";
+  return sources.map((source, index) => {
+    const url = source.url ? `
+URL: ${source.url}` : "";
+    return `[${index + 1}] ${source.title}${url}
+${source.content}`;
+  }).join("\n\n");
+}
+function tokenize(text2) {
+  return text2.toLowerCase().split(/[^a-z0-9áéíóúüñ]+/i).map((term) => term.trim()).filter((term) => term.length > 2);
+}
+function scoreDocument(document, terms) {
+  const haystack = `${document.title}
+${document.content}`.toLowerCase();
+  if (terms.length === 0) return 0;
+  const matches = terms.filter((term) => haystack.includes(term)).length;
+  return matches / terms.length;
+}
+
+// src/presets/index.ts
+var publicWebsiteAssistantPreset = {
+  id: "public-website-assistant",
+  name: "Public Website Assistant",
+  createBlueprint(config) {
+    return createBaseBlueprint({
+      id: "public-website-assistant",
+      name: "Public Website Assistant",
+      description: "Safe public assistant for landing pages, FAQs, service explanation, and lead intake.",
+      surface: "web",
+      defaultMode: "ask",
+      maturity: "experimental",
+      instructions: [
+        `You are the public website assistant for ${config.brand}.`,
+        "Help visitors understand services, ask concise qualification questions, and suggest a safe next step.",
+        "Do not claim that you sent messages, changed systems, booked meetings, or created records unless a registered tool result proves it.",
+        "If you are unsure, say so and offer to route the visitor to a human.",
+        config.audience ? `Primary audience: ${config.audience}.` : "",
+        config.extraInstructions ?? ""
+      ].filter(Boolean).join("\n"),
+      allowedTools: []
+    });
+  },
+  async createRuntime(config) {
+    return createPresetRuntime(config, publicWebsiteAssistantPreset.createBlueprint(config));
+  }
+};
+var ragKnowledgeAssistantPreset = {
+  id: "rag-knowledge-assistant",
+  name: "RAG Knowledge Assistant",
+  createBlueprint(config) {
+    return createBaseBlueprint({
+      id: "rag-knowledge-assistant",
+      name: "RAG Knowledge Assistant",
+      description: "Assistant that answers from a configured knowledge base and cites retrieved sources.",
+      surface: "web",
+      defaultMode: "ask",
+      maturity: "experimental",
+      instructions: [
+        `You are a knowledge assistant for ${config.brand}.`,
+        "Answer only from retrieved or approved knowledge.",
+        "Cite source titles when using retrieved content.",
+        "If the answer is not in the available knowledge, say you do not know and suggest escalation.",
+        config.extraInstructions ?? ""
+      ].filter(Boolean).join("\n"),
+      allowedTools: config.retriever ? ["knowledge_search"] : []
+    });
+  },
+  async createRuntime(config) {
+    const blueprint = ragKnowledgeAssistantPreset.createBlueprint(config);
+    return createPresetRuntime(config, blueprint, createRagToolRegistry(config.retriever));
+  }
+};
+var supportRagAssistantPreset = {
+  id: "support-rag-assistant",
+  name: "Support RAG Assistant",
+  createBlueprint(config) {
+    const allowedTools = [];
+    if (config.retriever) allowedTools.push("knowledge_search");
+    if (config.supportDraft) allowedTools.push("create_support_draft");
+    if (config.humanEscalation) allowedTools.push("request_human_escalation");
+    return createBaseBlueprint({
+      id: "support-rag-assistant",
+      name: "Support RAG Assistant",
+      description: "Support assistant that answers from approved knowledge, drafts responses, and escalates uncertain cases.",
+      surface: "web",
+      defaultMode: "draft",
+      maturity: "experimental",
+      instructions: [
+        `You are a support assistant for ${config.brand}.`,
+        "Answer only from approved retrieved knowledge.",
+        "Cite source titles when using retrieved content.",
+        "If retrieval is weak or the case is sensitive, say you are unsure and prepare an escalation.",
+        "Never claim a ticket was created, closed, or escalated unless a registered tool result proves it.",
+        config.extraInstructions ?? ""
+      ].filter(Boolean).join("\n"),
+      allowedTools,
+      approval: { requireHumanForExternalActions: true, requireHumanForSensitiveData: true }
+    });
+  },
+  async createRuntime(config) {
+    const blueprint = supportRagAssistantPreset.createBlueprint(config);
+    return createPresetRuntime(
+      config,
+      blueprint,
+      createSupportRagToolRegistry({
+        retriever: config.retriever,
+        supportDraft: config.supportDraft,
+        humanEscalation: config.humanEscalation
+      }),
+      createToolCallingRuntimeTurnRunner()
+    );
+  }
+};
+var salesIntakeAssistantPreset = {
+  id: "sales-intake-assistant",
+  name: "Sales Intake Assistant",
+  createBlueprint(config) {
+    return createBaseBlueprint({
+      id: "sales-intake-assistant",
+      name: "Sales Intake Assistant",
+      description: "Assistant for lead qualification, project context, urgency, budget, and next step capture.",
+      surface: "web",
+      defaultMode: "ask",
+      maturity: "experimental",
+      instructions: [
+        `You are the sales intake assistant for ${config.brand}.`,
+        "Collect problem, desired outcome, urgency, approximate budget, current stack, decision process, and contact preference.",
+        "Keep the conversation concise and useful. Produce a clear summary and recommended next step when enough context is available.",
+        "Do not promise pricing, timelines, or delivery commitments.",
+        "Use create_sales_lead_summary only to prepare an internal summary; do not claim a CRM record was created.",
+        config.extraInstructions ?? ""
+      ].filter(Boolean).join("\n"),
+      allowedTools: config.leadSummary ? ["create_sales_lead_summary"] : []
+    });
+  },
+  async createRuntime(config) {
+    return createPresetRuntime(
+      config,
+      salesIntakeAssistantPreset.createBlueprint(config),
+      createSalesIntakeToolRegistry({ leadSummary: config.leadSummary }),
+      createToolCallingRuntimeTurnRunner()
+    );
+  }
+};
+var customerSupportAssistantPreset = {
+  id: "customer-support-assistant",
+  name: "Customer Support Assistant",
+  createBlueprint(config) {
+    return createBaseBlueprint({
+      id: "customer-support-assistant",
+      name: "Customer Support Assistant",
+      description: "Assistant for support triage, answer drafts, and escalation recommendations.",
+      surface: "web",
+      defaultMode: "draft",
+      maturity: "experimental",
+      instructions: [
+        `You are the customer support assistant for ${config.brand}.`,
+        "Classify the issue, suggest a helpful answer, and escalate sensitive or uncertain cases to a human.",
+        "Do not close tickets or make account changes without explicit approval and a registered tool result.",
+        config.extraInstructions ?? ""
+      ].filter(Boolean).join("\n"),
+      allowedTools: []
+    });
+  },
+  async createRuntime(config) {
+    return createPresetRuntime(
+      config,
+      customerSupportAssistantPreset.createBlueprint(config),
+      createCustomerSupportToolRegistry(config.toolRegistry)
+    );
+  }
+};
+var appointmentBookingAssistantPreset = {
+  id: "appointment-booking-assistant",
+  name: "Appointment Booking Assistant",
+  createBlueprint(config) {
+    return createBaseBlueprint({
+      id: "appointment-booking-assistant",
+      name: "Appointment Booking Assistant",
+      description: "Assistant for appointment intake, availability discussion, and confirmation-gated booking.",
+      surface: "web",
+      defaultMode: "draft",
+      maturity: "experimental",
+      instructions: [
+        `You are the appointment assistant for ${config.brand}.`,
+        config.businessHours ? `Business hours: ${config.businessHours}.` : "",
+        "Collect preferred time, timezone, purpose, and contact details.",
+        "Never book, cancel, or move an appointment without explicit user confirmation and an approved tool call.",
+        config.extraInstructions ?? ""
+      ].filter(Boolean).join("\n"),
+      allowedTools: []
+    });
+  },
+  async createRuntime(config) {
+    return createPresetRuntime(config, appointmentBookingAssistantPreset.createBlueprint(config));
+  }
+};
+var internalOpsAssistantPreset = {
+  id: "internal-ops-assistant",
+  name: "Internal Ops Assistant",
+  createBlueprint(config) {
+    return createBaseBlueprint({
+      id: "internal-ops-assistant",
+      name: "Internal Ops Assistant",
+      description: "Internal automation assistant for controlled operations workflows.",
+      surface: "internal",
+      defaultMode: "draft",
+      maturity: "experimental",
+      instructions: [
+        `You are an internal operations assistant for ${config.brand}.`,
+        "Prefer drafts and summaries before actions. Ask for confirmation before external side effects.",
+        "Use create_internal_ops_draft for controlled planning only. Do not execute ERP, CRM, billing, or account changes unless a separate allowlisted tool exists.",
+        "Follow the configured tool policy and record decisions for audit.",
+        config.extraInstructions ?? ""
+      ].filter(Boolean).join("\n"),
+      allowedTools: config.opsDraft ? ["create_internal_ops_draft"] : [],
+      approval: { requireHumanForExternalActions: true, requireHumanForSensitiveData: true }
+    });
+  },
+  async createRuntime(config) {
+    return createPresetRuntime(
+      config,
+      internalOpsAssistantPreset.createBlueprint(config),
+      createInternalOpsToolRegistry({ opsDraft: config.opsDraft }),
+      createToolCallingRuntimeTurnRunner()
+    );
+  }
+};
+var codingAgentPreset = {
+  id: "coding-agent",
+  name: "Coco Coding Agent",
+  createBlueprint(config) {
+    return createBaseBlueprint({
+      id: "coding-agent",
+      name: "Coco Coding Agent",
+      description: "Coco's full coding-agent surface for trusted developer environments.",
+      surface: "cli",
+      defaultMode: "act",
+      maturity: "beta",
+      instructions: config.extraInstructions ?? "You are Coco, a coding agent for trusted repositories.",
+      allowedTools: [],
+      guardrails: { secretRedaction: { enabled: true }, promptInjectionDetection: true },
+      approval: { requireHumanForExternalActions: true, requireHumanForSensitiveData: true }
+    });
+  },
+  async createRuntime(config) {
+    return createPresetRuntime(
+      config,
+      codingAgentPreset.createBlueprint(config),
+      createCodingToolRegistry()
+    );
+  }
+};
+async function createPresetRuntime(config, blueprint, fallbackToolRegistry = createNoToolRegistry(), fallbackTurnRunner = config.turnRunner) {
+  return createAgentRuntime({
+    providerType: config.providerType,
+    model: config.model,
+    providerConfig: config.providerConfig,
+    provider: config.provider,
+    eventLog: config.eventLog,
+    turnRunner: config.turnRunner ?? fallbackTurnRunner,
+    toolRegistry: blueprint.id === "coding-agent" ? config.toolRegistry ?? fallbackToolRegistry : config.toolRegistry ? createSafeToolRegistry(blueprint.allowedTools, config.toolRegistry) : fallbackToolRegistry,
+    publishToGlobalBridge: false
+  });
+}
+var AGENT_PRESETS = [
+  publicWebsiteAssistantPreset,
+  ragKnowledgeAssistantPreset,
+  supportRagAssistantPreset,
+  salesIntakeAssistantPreset,
+  customerSupportAssistantPreset,
+  appointmentBookingAssistantPreset,
+  internalOpsAssistantPreset,
+  codingAgentPreset
+];
+
+// src/adapters/index.ts
+function createHttpAssistantAdapter(runtime) {
+  return {
+    createSession(metadata = {}) {
+      const session = runtime.createSession({ mode: "ask", metadata });
+      return { sessionId: session.id };
+    },
+    async handleMessage(input) {
+      const sessionId = input.sessionId ?? runtime.createSession({ mode: "ask", metadata: input.metadata }).id;
+      const result = await runtime.runTurn({
+        sessionId,
+        content: input.content,
+        metadata: input.metadata
+      });
+      return { sessionId, content: result.content, metadata: { model: result.model } };
+    }
+  };
+}
+function createStreamingHttpAssistantAdapter(runtime) {
+  const base = createHttpAssistantAdapter(runtime);
+  return {
+    ...base,
+    async *streamMessage(input) {
+      const sessionId = input.sessionId ?? runtime.createSession({ mode: "ask", metadata: input.metadata }).id;
+      yield* runtime.streamTurn({
+        sessionId,
+        content: input.content,
+        metadata: input.metadata
+      });
+    }
+  };
+}
+function createWebhookAssistantAdapter(runtime, options = {}) {
+  return {
+    id: options.id ?? "webhook-assistant",
+    surface: options.surface ?? "api",
+    async handle(input) {
+      const adapter = createHttpAssistantAdapter(runtime);
+      return adapter.handleMessage(input);
+    }
+  };
+}
+
 // src/index.ts
 init_errors();
 init_logger();
 init_proxy();
 
-export { ADRGenerator, AGENT_MODES, AgentRuntime, AnthropicProvider, ArchitectureGenerator, BacklogGenerator, CICDGenerator, CocoError, CodeGenerator, CodeReviewer, CompleteExecutor, ConfigError, ConvergeExecutor, DEFAULT_WORKFLOWS, DefaultPermissionPolicy, DefaultRuntimeTurnRunner, DiscoveryEngine, DockerGenerator, DocsGenerator, FileEventLog, FileRuntimeSessionStore, InMemoryEventLog, InMemoryRuntimeSessionStore, OrchestrateExecutor, OutputExecutor, PhaseError, ProviderRegistry, SessionManager, SpecificationGenerator, TaskError, TaskIterator, ToolRegistry, VERSION, WorkflowCatalog, WorkflowEngine, WorkflowRegistry, configExists, createADRGenerator, createAgentRuntime, createAnthropicProvider, createArchitectureGenerator, createBacklogGenerator, createCICDGenerator, createCodeGenerator, createCodeReviewer, createCompleteExecutor, createConvergeExecutor, createDefaultConfig, createDefaultRuntimeTurnRunner, createDiscoveryEngine, createDockerGenerator, createDocsGenerator, createEventLog, createFileEventLog, createFileRuntimeSessionStore, createFullToolRegistry, createLogger, createMcpToolPolicy, createOrchestrateExecutor, createOrchestrator, createOutputExecutor, createPermissionPolicy, createProvider, createProviderRegistry, createRuntimeHttpServer, createRuntimeSessionStore, createSessionManager, createSpecificationGenerator, createTaskIterator, createToolRegistry, createWorkflowCatalog, createWorkflowEngine, createWorkflowRegistry, getAgentMode, installProxyDispatcher, isAgentMode, listAgentModes, loadConfig, registerAllTools, saveConfig };
+export { ADRGenerator, AGENT_MODES, AGENT_PRESETS, AgentRuntime, AnthropicProvider, ArchitectureGenerator, BacklogGenerator, CICDGenerator, CocoError, CodeGenerator, CodeReviewer, CompleteExecutor, ConfigError, ConvergeExecutor, DEFAULT_WORKFLOWS, DefaultPermissionPolicy, DefaultRuntimeTurnRunner, DiscoveryEngine, DockerGenerator, DocsGenerator, FileEventLog, FileRuntimeSessionStore, InMemoryEventLog, InMemoryKnowledgeRetriever, InMemoryRuntimeSessionStore, OrchestrateExecutor, OutputExecutor, PhaseError, ProviderRegistry, SessionManager, SharedWorkspaceState, SpecificationGenerator, TaskError, TaskIterator, ToolCallingRuntimeTurnRunner, ToolRegistry, VERSION, WorkflowCatalog, WorkflowEngine, WorkflowRegistry, appointmentBookingAssistantPreset, codingAgentPreset, configExists, createADRGenerator, createAgentArtifact, createAgentFromBlueprint, createAgentRuntime, createAnthropicProvider, createArchitectureGenerator, createBacklogGenerator, createBaseBlueprint, createCICDGenerator, createCodeGenerator, createCodeReviewer, createCodingToolRegistry, createCompleteExecutor, createConvergeExecutor, createCustomerSupportToolRegistry, createDefaultConfig, createDefaultRuntimeTurnRunner, createDiscoveryEngine, createDockerGenerator, createDocsGenerator, createEventLog, createFileEventLog, createFileRuntimeSessionStore, createFullToolRegistry, createHttpAssistantAdapter, createInMemoryKnowledgeRetriever, createLogger, createMcpToolPolicy, createNoToolRegistry, createOrchestrateExecutor, createOrchestrator, createOutputExecutor, createPermissionPolicy, createProvider, createProviderRegistry, createPublicWebToolRegistry, createRagToolRegistry, createRuntimeHttpServer, createRuntimeSessionStore, createSafeToolRegistry, createSessionManager, createSpecificationGenerator, createStreamingHttpAssistantAdapter, createSummaryArtifact, createSupportRagToolRegistry, createTaskIterator, createToolCallingRuntimeTurnRunner, createToolRegistry, createWebhookAssistantAdapter, createWorkflowCatalog, createWorkflowEngine, createWorkflowRegistry, customerSupportAssistantPreset, defaultPublicGuardrails, formatRetrievedSourcesForPrompt, getAgentMode, installProxyDispatcher, internalOpsAssistantPreset, isAgentMode, listAgentModes, loadConfig, mapActionModeToRuntimeMode, normalizeAgentRunResult, publicWebsiteAssistantPreset, ragKnowledgeAssistantPreset, redactSecrets, registerAllTools, runGuardrails, salesIntakeAssistantPreset, saveConfig, supportRagAssistantPreset, validateAgentCapabilities, validateAgentGraph, validateStructuredOutput, workflowToAgentGraph };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map