@tangle-network/agent-runtime 0.91.0 → 0.92.1

package/README.md

@@ -68,13 +68,15 @@ const result = await supervise(
 
 ### Improve an agent
 
-`improve` optimizes one part of an agent (its prompt, skills, or code) and **only ships a change if it beats the current agent on tasks it never practiced on**. Registering an agent for self-improvement cannot ship a worse candidate unless the caller supplies a bad measurement.
+`improve` optimizes one part of an agent and **only ships a change if it beats the current agent on tasks it never practiced on**.
+It accepts prompt, skill document, tool, MCP, hook, subagent, workflow, rollout-policy, whole-profile, and code surfaces through one call.
+Prompt and skill-document optimization have built-in generators; structured surfaces take an explicit generator, and code runs from isolated incumbent and candidate checkouts.
 
 ```ts
 import { improve } from '@tangle-network/agent-runtime'
 
 const { profile, shipped, lift } = await improve(baseProfile, findings, {
-  surface: 'prompt',        // what to optimize: prompt | skills | code
+  surface: 'prompt',        // or skills/tools/mcp/hooks/subagents/workflow/agent-profile/code
   gate: 'holdout',          // certified on a held-back exam, never the practice set
   scenarios, judge, agent,  // how to measure a candidate
 })

package/dist/agent.d.ts

@@ -1,9 +1,9 @@
 import * as _tangle_network_agent_eval from '@tangle-network/agent-eval';
 import { TraceAnalystKindSpec, AnalystFinding } from '@tangle-network/agent-eval';
 import { A as ArtifactKind, C as CandidateGenerator, P as PromotionGate } from './generator-YkAQrOoD.js';
-import { b as RuntimeStreamEvent, S as SandboxClient, c as OutputAdapter, A as AgentRunSpec } from './types-SyuwunY_.js';
-import { A as AgentSurfaces } from './improvement-adapter-CDR8QNVM.js';
-export { C as CreateSurfaceImprovementAdapterOpts, D as DraftPatchInput, a as DraftPatchOutput, R as ResolvedSurface, S as SurfaceImprovementEdit, b as SurfaceValidationIssue, c as createSurfaceImprovementAdapter, r as renderSurfaceIssues, d as resolveSubjectPath, v as validateSurfaces } from './improvement-adapter-CDR8QNVM.js';
+import { b as RuntimeStreamEvent, S as SandboxClient, d as OutputAdapter, e as AgentRunSpec } from './types-B00NtbCs.js';
+import { A as AgentSurfaces } from './improvement-adapter-BieWeK5J.js';
+export { C as CreateSurfaceImprovementAdapterOpts, D as DraftPatchInput, a as DraftPatchOutput, R as ResolvedSurface, S as SurfaceImprovementEdit, b as SurfaceValidationIssue, c as createSurfaceImprovementAdapter, r as renderSurfaceIssues, d as resolveSubjectPath, v as validateSurfaces } from './improvement-adapter-BieWeK5J.js';
 import { K as KnowledgeAdapter, a as RunAnalystLoopResult } from './types-BC3bZpH0.js';
 import { AgentProfile, AgentProfileFileMount, AgentProfileMcpServer } from '@tangle-network/agent-interface';
 import { SandboxEvent } from '@tangle-network/sandbox';

package/dist/agent.js

@@ -1,10 +1,13 @@
-import "./chunk-AD7JW4QG.js";
+import "./chunk-BVVRQ4YC.js";
+import "./chunk-FDJ7AHXG.js";
 import {
   createSandboxForSpec
-} from "./chunk-NC66AM3S.js";
+} from "./chunk-UO2L5VTP.js";
 import "./chunk-DPEUKJRO.js";
-import "./chunk-IVGYLCFH.js";
-import "./chunk-BZF3KQ6G.js";
+import "./chunk-J2K6WIG6.js";
+import "./chunk-3D2RHC4K.js";
+import "./chunk-VSWBYWFK.js";
+import "./chunk-3MDZX7YU.js";
 import {
   mapSandboxEvent
 } from "./chunk-FVJ7M3DA.js";
@@ -17,8 +20,8 @@ import {
 } from "./chunk-DGUM43GV.js";
 
 // src/agent/surfaces.ts
-import { existsSync } from "fs";
-import { isAbsolute, join } from "path";
+import { existsSync, statSync } from "fs";
+import { isAbsolute, join, relative, resolve, sep } from "path";
 function resolveSubjectPath(subject, surfaces, repoRoot) {
   const candidates = candidatePathsForSubject(subject, surfaces);
   if (candidates.length === 0) return null;
@@ -41,38 +44,80 @@ function candidatePathsForSubject(subject, surfaces) {
   switch (subject.kind) {
     case "knowledge.wiki":
     case "knowledge.stale":
-      return [join(surfaces.knowledge, `${subject.slug}.md`)];
+      return optionalPath(safeJoin(surfaces.knowledge, `${subject.slug}.md`));
     case "knowledge.claim":
-      return [join(surfaces.knowledge, "claims", `${slugify(subject.topic)}.md`)];
+      return optionalPath(safeJoin(surfaces.knowledge, "claims", `${slugify(subject.topic)}.md`));
     case "knowledge.raw":
-      return [join(surfaces.knowledge, "raw", `${subject.sourceId}.md`)];
+      return optionalPath(safeJoin(surfaces.knowledge, "raw", `${subject.sourceId}.md`));
     case "system-prompt": {
       const slug = slugify(subject.section);
       return [
-        join(surfaces.systemPrompt, `${slug}.md`),
-        join(surfaces.systemPrompt, slug, "SKILL.md"),
-        join(surfaces.systemPrompt, slug, "index.md")
-      ];
+        safeJoin(surfaces.systemPrompt, `${slug}.md`),
+        safeJoin(surfaces.systemPrompt, slug, "SKILL.md"),
+        safeJoin(surfaces.systemPrompt, slug, "index.md")
+      ].filter((path) => path !== null);
+    }
+    case "skill": {
+      if (!surfaces.skills) return [];
+      return [
+        safeJoin(surfaces.skills, subject.name, "SKILL.md"),
+        safeJoin(surfaces.skills, `${subject.name}.md`)
+      ].filter((path) => path !== null);
     }
     case "tool-doc":
       if (subject.aspect) {
-        return [join(surfaces.tools, subject.tool, `${slugify(subject.aspect)}.md`)];
+        return optionalPath(safeJoin(surfaces.tools, subject.tool, `${slugify(subject.aspect)}.md`));
       }
       return [
-        join(surfaces.tools, subject.tool, "README.md"),
-        join(surfaces.tools, `${subject.tool}.md`)
-      ];
+        safeJoin(surfaces.tools, subject.tool, "README.md"),
+        safeJoin(surfaces.tools, `${subject.tool}.md`)
+      ].filter((path) => path !== null);
     case "new-tool":
-      return [join(surfaces.tools, subject.name, "README.md")];
+      return optionalPath(safeJoin(surfaces.tools, subject.name, "README.md"));
+    case "mcp":
+      if (!surfaces.mcp) return [];
+      return subject.tool ? optionalPath(safeJoin(surfaces.mcp, subject.server, `${subject.tool}.md`)) : [
+        safeJoin(surfaces.mcp, `${subject.server}.json`),
+        safeJoin(surfaces.mcp, subject.server, "README.md")
+      ].filter((path) => path !== null);
+    case "hook":
+      if (!surfaces.hooks) return [];
+      return [
+        safeJoin(surfaces.hooks, `${subject.name}.md`),
+        safeJoin(surfaces.hooks, `${subject.name}.json`)
+      ].filter((path) => path !== null);
+    case "subagent":
+      if (!surfaces.subagents) return [];
+      return [
+        safeJoin(surfaces.subagents, `${subject.name}.md`),
+        safeJoin(surfaces.subagents, `${subject.name}.yaml`),
+        safeJoin(surfaces.subagents, `${subject.name}.json`)
+      ].filter((path) => path !== null);
+    case "workflow":
+      if (!surfaces.workflows) return [];
+      return [
+        safeJoin(surfaces.workflows, `${subject.name}.md`),
+        safeJoin(surfaces.workflows, `${subject.name}.yaml`),
+        safeJoin(surfaces.workflows, `${subject.name}.json`)
+      ].filter((path) => path !== null);
+    case "rollout-policy":
+      return surfaces.rolloutPolicy ? [surfaces.rolloutPolicy] : [];
+    case "agent-profile":
+      return surfaces.agentProfile ? [surfaces.agentProfile] : [];
+    case "code": {
+      if (!surfaces.code) return [];
+      const path = safeJoin(surfaces.code, subject.path);
+      return path ? [path] : [];
+    }
     case "rag":
       if (!surfaces.rag) return [];
-      return [join(surfaces.rag, subject.corpus, `${subject.docId}.md`)];
+      return optionalPath(safeJoin(surfaces.rag, subject.corpus, `${subject.docId}.md`));
     case "memory":
       if (!surfaces.memory) return [];
-      return [join(surfaces.memory, `${slugify(subject.key)}.json`)];
+      return optionalPath(safeJoin(surfaces.memory, `${slugify(subject.key)}.json`));
     case "scaffolding":
       if (!surfaces.scaffolding) return [];
-      return [join(surfaces.scaffolding, `${slugify(subject.concern)}.md`)];
+      return optionalPath(safeJoin(surfaces.scaffolding, `${slugify(subject.concern)}.md`));
     case "output-schema":
       if (!surfaces.outputSchema) return [];
       return [surfaces.outputSchema];
@@ -83,6 +128,17 @@ function candidatePathsForSubject(subject, surfaces) {
       return [];
   }
 }
+function safeJoin(root, ...children) {
+  if (children.some((child) => child.includes("\0") || isAbsolute(child))) return null;
+  const rootAbsolute = resolve(root);
+  const targetAbsolute = resolve(rootAbsolute, ...children);
+  const escaped = relative(rootAbsolute, targetAbsolute);
+  if (escaped === ".." || escaped.startsWith(`..${sep}`) || isAbsolute(escaped)) return null;
+  return join(root, ...children);
+}
+function optionalPath(path) {
+  return path ? [path] : [];
+}
 function slugify(s) {
   return s.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 200) || "untitled";
 }
@@ -95,8 +151,22 @@ function validateSurfaces(surfaces, repoRoot) {
     "knowledge"
   ];
   const fileSurfaces = ["rubric"];
-  const optionalDirSurfaces = ["scaffolding", "memory", "rag"];
-  const optionalFileSurfaces = ["outputSchema"];
+  const optionalDirSurfaces = [
+    "scaffolding",
+    "memory",
+    "rag",
+    "skills",
+    "mcp",
+    "hooks",
+    "subagents",
+    "workflows",
+    "code"
+  ];
+  const optionalFileSurfaces = [
+    "outputSchema",
+    "rolloutPolicy",
+    "agentProfile"
+  ];
   for (const key of dirSurfaces) {
     const p = surfaces[key];
     if (!p) {
@@ -106,6 +176,8 @@ function validateSurfaces(surfaces, repoRoot) {
     const abs = isAbsolute(p) ? p : join(repoRoot, p);
     if (!existsSync(abs)) {
       issues.push({ surface: key, path: p, reason: "missing" });
+    } else if (!statSync(abs).isDirectory()) {
+      issues.push({ surface: key, path: p, reason: "not-directory" });
     }
   }
   for (const key of fileSurfaces) {
@@ -117,6 +189,8 @@ function validateSurfaces(surfaces, repoRoot) {
     const abs = isAbsolute(p) ? p : join(repoRoot, p);
     if (!existsSync(abs)) {
       issues.push({ surface: key, path: p, reason: "missing" });
+    } else if (!statSync(abs).isFile()) {
+      issues.push({ surface: key, path: p, reason: "not-file" });
     }
   }
   for (const key of [...optionalDirSurfaces, ...optionalFileSurfaces]) {
@@ -125,6 +199,13 @@ function validateSurfaces(surfaces, repoRoot) {
     const abs = isAbsolute(p) ? p : join(repoRoot, p);
     if (!existsSync(abs)) {
       issues.push({ surface: key, path: p, reason: "missing" });
+      continue;
+    }
+    const expectedDirectory = optionalDirSurfaces.includes(key);
+    if (expectedDirectory && !statSync(abs).isDirectory()) {
+      issues.push({ surface: key, path: p, reason: "not-directory" });
+    } else if (!expectedDirectory && !statSync(abs).isFile()) {
+      issues.push({ surface: key, path: p, reason: "not-file" });
     }
   }
   return issues;
@@ -669,8 +750,8 @@ function createSandboxAct(options) {
     const raw = [];
     let settle;
     let fail;
-    const output = new Promise((resolve, reject) => {
-      settle = resolve;
+    const output = new Promise((resolve2, reject) => {
+      settle = resolve2;
       fail = reject;
     });
     output.catch(() => {