@goondocks/myco 0.19.4 → 0.19.6

package/dist/{executor-4TJOZN32.js → executor-NXNSUEMQ.js}

@@ -40,9 +40,10 @@ import {
   updateSkillRecord,
   upsertDigestExtract,
   validateSkillContent
-} from "./chunk-RTNLDAIC.js";
+} from "./chunk-P5VNHGVZ.js";
 import {
-  fullTextSearch
+  fullTextSearch,
+  hydrateSearchResults
 } from "./chunk-7ONVLO43.js";
 import "./chunk-KYH4V4ML.js";
 import {
@@ -50,8 +51,9 @@ import {
   loadSystemPrompt
 } from "./chunk-Q4QD6LJT.js";
 import {
-  insertTurn
-} from "./chunk-QLCD77AN.js";
+  insertTurn,
+  updateTurn
+} from "./chunk-6RFZWV4R.js";
 import {
   insertResolutionEvent
 } from "./chunk-VQF5E4ZX.js";
@@ -65,6 +67,7 @@ import {
 import "./chunk-POEPHBQK.js";
 import {
   DEFAULT_IMPORTANCE,
+  getSpore,
   insertSpore,
   listSpores,
   updateSporeStatus
@@ -80,7 +83,7 @@ import {
   CANDIDATE_STATUS,
   createSchema
 } from "./chunk-6DDRJQ4X.js";
-import "./chunk-3C4LT4BW.js";
+import "./chunk-NKQZ73LL.js";
 import {
   getDatabase,
   initDatabase,
@@ -88,7 +91,7 @@ import {
 } from "./chunk-MYX5NCRH.js";
 import {
   getPluginVersion
-} from "./chunk-NTWJR6KH.js";
+} from "./chunk-ST2D3SGM.js";
 import {
   findPackageRoot
 } from "./chunk-LPUQPDC2.js";
@@ -132,7 +135,7 @@ var DEFAULT_SEARCH_LIMIT = 10;
 var DEFAULT_ENTITIES_LIMIT = 50;
 var DEFAULT_EDGES_LIMIT = 50;
 function createReadTools(deps) {
-  const { agentId, embeddingManager, teamClient, machineId, recordTurn } = deps;
+  const { agentId, embeddingManager, teamClient, machineId } = deps;
   const vaultUnprocessed = tool(
     "vault_unprocessed",
     "Get unprocessed prompt batches, ordered by id ASC. Supports cursor-based pagination. Batches from in-flight sessions are excluded by default so intelligence tasks only process settled work; pass include_active=true only if you specifically need live data (e.g., title-summary).",
@@ -142,7 +145,6 @@ function createReadTools(deps) {
       include_active: external_exports.boolean().optional().describe("Include batches from sessions still in active status (default: false)")
     },
     async (args) => {
-      recordTurn("vault_unprocessed", args);
       const batches = getUnprocessedBatches({
         after_id: args.after_id,
         limit: args.limit ?? DEFAULT_UNPROCESSED_LIMIT,
@@ -154,8 +156,9 @@ function createReadTools(deps) {
   );
   const vaultSpores = tool(
     "vault_spores",
-    "List spores with optional filters (agent, observation type, status, session). Spores from in-flight sessions are excluded by default; passing a specific session_id bypasses this filter. Pass include_active=true to bulk-read live work.",
+    "List spores with optional filters (agent, observation type, status, session), or fetch exact spores by id for full-content inspection after a semantic shortlist. Spores from in-flight sessions are excluded by default; passing a specific session_id or ids bypasses this filter. Pass include_active=true to bulk-read live work.",
     {
+      ids: external_exports.array(external_exports.string()).optional().describe("Fetch exact spores by id in the given order; bypasses active-session gating"),
       agent_id: external_exports.string().optional().describe("Filter by agent ID"),
       observation_type: external_exports.string().optional().describe("Filter by observation type (e.g., gotcha, decision)"),
       status: external_exports.enum(["active", "superseded", "archived"]).optional().describe("Filter by status"),
@@ -164,7 +167,10 @@ function createReadTools(deps) {
       include_active: external_exports.boolean().optional().describe("Include spores from sessions still in active status (default: false)")
     },
     async (args) => {
-      recordTurn("vault_spores", args);
+      if (args.ids && args.ids.length > 0) {
+        const spores2 = args.ids.map((id) => getSpore(id)).filter((spore) => spore !== null);
+        return textResult(spores2);
+      }
       const spores = listSpores({
         agent_id: args.agent_id,
         observation_type: args.observation_type,
@@ -186,7 +192,6 @@ function createReadTools(deps) {
       include_active: external_exports.boolean().optional().describe("Include sessions still in active status (default: false)")
     },
     async (args) => {
-      recordTurn("vault_sessions", args);
       const sessions = listSessions({
         limit: args.limit ?? DEFAULT_SESSIONS_LIMIT,
         status: args.status,
@@ -206,7 +211,6 @@ function createReadTools(deps) {
       include_active: external_exports.boolean().optional().describe("Include results from sessions still in active status (default: false)")
     },
     async (args) => {
-      recordTurn("vault_search_fts", args);
       try {
         const results = fullTextSearch(args.query, {
           type: args.type,
@@ -230,7 +234,6 @@ function createReadTools(deps) {
       include_active: external_exports.boolean().optional().describe("Include results from sessions still in active status (default: false)")
     },
     async (args) => {
-      recordTurn("vault_search_semantic", args);
       if (!embeddingManager) {
         return textResult({ results: [], message: "Embedding provider unavailable" });
       }
@@ -241,7 +244,8 @@ function createReadTools(deps) {
         }
         const searchLimit = args.limit ?? DEFAULT_SEARCH_LIMIT;
         const excludeActive = args.include_active !== true;
-        const [localResults, teamResults] = await Promise.all([
+        const activeIds = excludeActive ? getActiveSessionIds() : /* @__PURE__ */ new Set();
+        const [rawLocalResults, teamResults] = await Promise.all([
           Promise.resolve(
             embeddingManager.searchVectors(queryVector, {
               namespace: args.namespace,
@@ -251,21 +255,26 @@ function createReadTools(deps) {
           ),
           teamClient ? teamClient.search(args.query, { limit: searchLimit }).then((res) => res.results.map((r) => ({ ...r, source: `${TEAM_SOURCE_PREFIX}${r.machine_id}` }))).catch(() => []) : Promise.resolve([])
         ]);
-        const dedupedTeam = machineId ? teamResults.filter((r) => r.machine_id !== machineId) : teamResults;
-        let merged = [
-          ...localResults.map((r) => ({ ...r, score: r.similarity })),
-          ...dedupedTeam
-        ].sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
-        if (excludeActive) {
-          const activeIds = getActiveSessionIds();
-          if (activeIds.size > 0) {
-            merged = merged.filter((r) => {
-              const sid = r.metadata?.session_id;
-              return typeof sid !== "string" || !activeIds.has(sid);
-            });
-          }
+        const localResults = activeIds.size > 0 ? rawLocalResults.filter((r) => {
+          const sid = r.metadata?.session_id;
+          return typeof sid !== "string" || !activeIds.has(sid);
+        }) : rawLocalResults;
+        const hydratedLocalResults = hydrateSearchResults(localResults).map((r) => ({
+          ...r,
+          source: "local"
+        }));
+        let dedupedTeam = machineId ? teamResults.filter((r) => r.machine_id !== machineId) : teamResults;
+        if (activeIds.size > 0) {
+          dedupedTeam = dedupedTeam.filter((r) => {
+            const sid = r.metadata?.session_id;
+            return typeof sid !== "string" || !activeIds.has(sid);
+          });
         }
-        return textResult({ results: merged.slice(0, searchLimit) });
+        const merged = [
+          ...hydratedLocalResults,
+          ...dedupedTeam
+        ].sort((a, b) => (b.score ?? 0) - (a.score ?? 0)).slice(0, searchLimit);
+        return textResult({ results: merged });
       } catch {
         return textResult({ results: [], message: "Semantic search unavailable" });
       }
@@ -277,7 +286,6 @@ function createReadTools(deps) {
     "Get all state key-value pairs for the current agent.",
     {},
     async () => {
-      recordTurn("vault_state", {});
       const states = getStatesForAgent(agentId);
       return textResult(states);
     },
@@ -292,7 +300,6 @@ function createReadTools(deps) {
       limit: external_exports.number().optional().describe("Maximum entities to return")
     },
     async (args) => {
-      recordTurn("vault_entities", args);
       const entities = listEntities({
         agent_id: agentId,
         type: args.type,
@@ -313,7 +320,6 @@ function createReadTools(deps) {
       limit: external_exports.number().optional().describe("Maximum edges to return")
     },
     async (args) => {
-      recordTurn("vault_edges", args);
       const edges = listGraphEdges({
         sourceId: args.source_id,
         targetId: args.target_id,
@@ -341,7 +347,7 @@ function createReadTools(deps) {
 import crypto from "crypto";
 import { tool as tool2 } from "@anthropic-ai/claude-agent-sdk";
 function createWriteTools(deps) {
-  const { agentId, embeddingManager, machineId, recordTurn } = deps;
+  const { agentId, embeddingManager, machineId } = deps;
   const vaultCreateSpore = tool2(
     "vault_create_spore",
     "Create a new spore (observation) in the vault. The agent_id is set automatically.",
@@ -384,7 +390,6 @@ function createWriteTools(deps) {
         session_id: args.session_id
       }).catch(() => {
       });
-      recordTurn("vault_create_spore", args);
       return textResult(spore);
     },
     { annotations: { openWorldHint: true } }
@@ -411,7 +416,6 @@ function createWriteTools(deps) {
         first_seen: now,
         last_seen: now
       });
-      recordTurn("vault_create_entity", args);
       return textResult(entity);
     },
     { annotations: { idempotentHint: true } }
@@ -445,7 +449,6 @@ function createWriteTools(deps) {
         properties: props,
         created_at: now
       });
-      recordTurn("vault_create_edge", args);
       return textResult(edge);
     },
     { annotations: { idempotentHint: true } }
@@ -489,7 +492,6 @@ function createWriteTools(deps) {
         } catch {
         }
       }
-      recordTurn("vault_resolve_spore", args);
       return textResult({ spore: updatedSpore, resolution_event_id: eventId });
     },
     { annotations: { destructiveHint: true } }
@@ -511,7 +513,6 @@ function createWriteTools(deps) {
         embeddingManager?.onContentWritten("sessions", args.session_id, args.summary, {}).catch(() => {
         });
       }
-      recordTurn("vault_update_session", args);
       return textResult(session);
     },
     { annotations: { idempotentHint: true } }
@@ -526,7 +527,6 @@ function createWriteTools(deps) {
     async (args) => {
       const now = epochSeconds();
       const state = setState(agentId, args.key, args.value, now);
-      recordTurn("vault_set_state", args);
       return textResult(state);
     },
     { annotations: { idempotentHint: true } }
@@ -538,7 +538,6 @@ function createWriteTools(deps) {
       tier: external_exports.number().optional().describe("Specific tier to read in full (e.g., 1500, 5000, 10000). Omit to get summary of all tiers.")
     },
     async (args) => {
-      recordTurn("vault_read_digest", args);
       const extracts = listDigestExtracts(agentId);
       if (args.tier !== void 0) {
         const extract = extracts.find((e) => e.tier === args.tier);
@@ -568,7 +567,6 @@ function createWriteTools(deps) {
         content: args.content,
         generated_at: now
       });
-      recordTurn("vault_write_digest", args);
       return textResult(extract);
     },
     { annotations: { idempotentHint: true } }
@@ -581,7 +579,6 @@ function createWriteTools(deps) {
     },
     async (args) => {
       const batch = markBatchProcessed(args.batch_id);
-      recordTurn("vault_mark_processed", args);
       return textResult(batch);
     },
     { annotations: { destructiveHint: true } }
@@ -602,7 +599,7 @@ function createWriteTools(deps) {
 // src/agent/tools/observability-tools.ts
 import { tool as tool3 } from "@anthropic-ai/claude-agent-sdk";
 function createObservabilityTools(deps) {
-  const { runId, agentId, recordTurn } = deps;
+  const { runId, agentId } = deps;
   const vaultReport = tool3(
     "vault_report",
     'Record an observability report for the current run. Use action "skip" when skipping expected operations (e.g., not updating a session summary) with reasoning in the summary field.',
@@ -612,7 +609,6 @@ function createObservabilityTools(deps) {
       details: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("Structured details as key-value pairs")
     },
     async (args) => {
-      recordTurn("vault_report", args);
       const now = epochSeconds();
       const report = insertReport({
         run_id: runId,
@@ -635,7 +631,7 @@ import { readFileSync, writeFileSync, mkdirSync, rmSync, existsSync } from "fs";
 import { resolve } from "path";
 import { tool as tool4 } from "@anthropic-ai/claude-agent-sdk";
 function createSkillTools(deps) {
-  const { agentId, machineId, projectRoot, vaultDir, recordTurn, embeddingManager } = deps;
+  const { agentId, machineId, projectRoot, vaultDir, embeddingManager } = deps;
   function findOverlappingCandidate(newTopic, existing) {
     let best = null;
     for (const candidate of existing) {
@@ -754,7 +750,7 @@ function createSkillTools(deps) {
         );
       }
       try {
-        const { syncSkillSymlinks } = await import("./installer-BWJED3ED.js");
+        const { syncSkillSymlinks } = await import("./installer-WMTB4NCX.js");
         syncSkillSymlinks(root, params.name, { remove: true });
       } catch (rollbackErr) {
         console.warn(
@@ -772,7 +768,7 @@ function createSkillTools(deps) {
       };
     }
     try {
-      const { syncSkillSymlinks } = await import("./installer-BWJED3ED.js");
+      const { syncSkillSymlinks } = await import("./installer-WMTB4NCX.js");
       syncSkillSymlinks(root, params.name);
     } catch (err) {
       console.warn(
@@ -853,7 +849,6 @@ function createSkillTools(deps) {
       limit: external_exports.number().optional().describe("Maximum candidates to return (for list)")
     },
     async (args) => {
-      recordTurn("vault_skill_candidates", args);
       switch (args.action) {
         case "list": {
           const candidates = listCandidates({
@@ -986,7 +981,6 @@ function createSkillTools(deps) {
       limit: external_exports.number().optional().describe("Maximum records to return (for list)")
     },
     async (args) => {
-      recordTurn("vault_skill_records", args);
       switch (args.action) {
         case "list": {
           const records = listSkillRecords({
@@ -1041,7 +1035,7 @@ function createSkillTools(deps) {
               console.warn("[vault_skill_records] Failed to remove skill directory:", err instanceof Error ? err.message : err);
             }
             try {
-              const { syncSkillSymlinks } = await import("./installer-BWJED3ED.js");
+              const { syncSkillSymlinks } = await import("./installer-WMTB4NCX.js");
               syncSkillSymlinks(root, result.name, { remove: true });
             } catch (err) {
               console.warn("[vault_skill_records] Failed to remove symlinks:", err instanceof Error ? err.message : err);
@@ -1070,14 +1064,12 @@ function createSkillTools(deps) {
     async (args) => {
       const validationErrors = validateSkillContent(args.content, args.name);
       if (validationErrors.length > 0) {
-        recordTurn("vault_write_skill", args);
         return textResult({
           error: "Skill validation failed. Fix these issues and try again.",
           issues: validationErrors
         });
       }
       if (!args.name || /[/\\]|\.\./.test(args.name)) {
-        recordTurn("vault_write_skill", args);
         return textResult({
           error: 'Invalid skill name: must be a simple directory name without path separators or ".."'
         });
@@ -1088,7 +1080,6 @@ function createSkillTools(deps) {
         description: args.description
       });
       if (dedupError) {
-        recordTurn("vault_write_skill", args);
         return textResult(dedupError);
       }
       const existing = getSkillRecordByName(args.name);
@@ -1098,7 +1089,6 @@ function createSkillTools(deps) {
         const existingContent = readFileSync(skillPath, "utf-8");
         const violations = checkFrontmatterPreservation(existingContent, args.content);
         if (violations.length > 0) {
-          recordTurn("vault_write_skill", args);
           return textResult({
             error: "Skill update rejected: protected frontmatter fields were changed. Read the existing skill and preserve these values exactly.",
             violations
@@ -1109,7 +1099,6 @@ function createSkillTools(deps) {
         if (args.candidate_id) {
           const candidateError = requireApprovedCandidate(args.candidate_id);
           if (candidateError) {
-            recordTurn("vault_write_skill", args);
             return textResult(candidateError);
           }
         }
@@ -1142,7 +1131,6 @@ function createSkillTools(deps) {
           linkCandidate,
           label: "vault_write_skill"
         });
-        recordTurn("vault_write_skill", args);
         if ("error" in result) return textResult(result);
         emitSkillNotification("created", {
           name: result.name,
@@ -1165,7 +1153,7 @@ function createSkillTools(deps) {
         return textResult({ error: `Failed to write skill file: ${err instanceof Error ? err.message : String(err)}` });
       }
       try {
-        const { syncSkillSymlinks } = await import("./installer-BWJED3ED.js");
+        const { syncSkillSymlinks } = await import("./installer-WMTB4NCX.js");
         syncSkillSymlinks(root, args.name);
       } catch (err) {
         console.warn("[vault_write_skill] syncSkillSymlinks failed:", err instanceof Error ? err.message : err);
@@ -1205,7 +1193,6 @@ function createSkillTools(deps) {
             rollbackErr instanceof Error ? rollbackErr.message : rollbackErr
           );
         }
-        recordTurn("vault_write_skill", args);
         return textResult({
           error: `Skill write aborted: database transaction failed and on-disk state was rolled back. ${err instanceof Error ? err.message : String(err)}`
         });
@@ -1222,7 +1209,6 @@ function createSkillTools(deps) {
         name: args.name
       }).catch(() => {
       });
-      recordTurn("vault_write_skill", args);
       return textResult({
         id: recordId,
         name: args.name,
@@ -1247,7 +1233,6 @@ function createSkillTools(deps) {
       rationale: external_exports.string().optional().describe("Why this skill is being created \u2014 stored in lineage after finalize")
     },
     async (args) => {
-      recordTurn("vault_stage_skill", args);
       if (!vaultDir) {
         return textResult({
           error: "vault_stage_skill requires vaultDir on the tool deps \u2014 staging has no location otherwise"
@@ -1306,7 +1291,6 @@ function createSkillTools(deps) {
       candidate_id: external_exports.string().describe("Candidate ID whose staged skill should be promoted. Must match a previous vault_stage_skill call.")
     },
     async (args) => {
-      recordTurn("vault_finalize_skill", args);
       if (!vaultDir) {
         return textResult({
           error: "vault_finalize_skill requires vaultDir on the tool deps"
@@ -1409,6 +1393,7 @@ var SKILL_TOOL_NAMES = /* @__PURE__ */ new Set([
   "vault_stage_skill",
   "vault_finalize_skill"
 ]);
+var TOOL_OUTPUT_SUMMARY_LIMIT = 240;
 var VAULT_TOOL_COUNT = READ_TOOL_NAMES.size + WRITE_TOOL_NAMES.size + OBSERVABILITY_TOOL_NAMES.size + SKILL_TOOL_NAMES.size;
 function setsOverlap(a, b) {
   for (const item of a) {
@@ -1416,13 +1401,31 @@ function setsOverlap(a, b) {
   }
   return false;
 }
+function truncateSummary(text) {
+  if (!text) return null;
+  return text.length > TOOL_OUTPUT_SUMMARY_LIMIT ? `${text.slice(0, TOOL_OUTPUT_SUMMARY_LIMIT - 1)}\u2026` : text;
+}
+function summarizeToolResult(result) {
+  if (!result || typeof result !== "object") return null;
+  const content = result.content;
+  if (!Array.isArray(content) || content.length === 0) return null;
+  const first = content[0];
+  if (!first || first.type !== "text" || typeof first.text !== "string") return null;
+  return truncateSummary(first.text.replace(/\s+/g, " ").trim());
+}
+function summarizeToolError(error) {
+  if (error instanceof Error && error.message) {
+    return truncateSummary(error.message) ?? "Tool failed";
+  }
+  return truncateSummary(String(error)) ?? "Tool failed";
+}
 function createVaultTools(agentId, runId, options) {
   const { turnOffset = 0, embeddingManager, teamClient, machineId, projectRoot, vaultDir, onlyNames } = options ?? {};
   let turnCounter = turnOffset;
   function recordTurn(toolName, toolInput) {
     turnCounter++;
     try {
-      insertTurn({
+      const turn = insertTurn({
         run_id: runId,
         agent_id: agentId,
         turn_number: turnCounter,
@@ -1430,7 +1433,9 @@ function createVaultTools(agentId, runId, options) {
         tool_input: JSON.stringify(toolInput),
         started_at: epochSeconds()
       });
+      return turn.id;
     } catch {
+      return null;
     }
   }
   const deps = {
@@ -1444,12 +1449,46 @@ function createVaultTools(agentId, runId, options) {
     recordTurn
   };
   const needsAll = !onlyNames;
-  return [
+  const tools = [
     ...needsAll || setsOverlap(onlyNames, READ_TOOL_NAMES) ? createReadTools(deps) : [],
     ...needsAll || setsOverlap(onlyNames, WRITE_TOOL_NAMES) ? createWriteTools(deps) : [],
     ...needsAll || setsOverlap(onlyNames, OBSERVABILITY_TOOL_NAMES) ? createObservabilityTools(deps) : [],
     ...needsAll || setsOverlap(onlyNames, SKILL_TOOL_NAMES) ? createSkillTools(deps) : []
   ];
+  return tools.map((toolDef) => wrapToolWithAudit(toolDef));
+  function wrapToolWithAudit(toolDef) {
+    const originalHandler = toolDef.handler;
+    return {
+      ...toolDef,
+      handler: async (args, extra) => {
+        const turnId = recordTurn(toolDef.name, args);
+        try {
+          const result = await originalHandler(args, extra);
+          if (turnId !== null) {
+            try {
+              updateTurn(turnId, {
+                tool_output_summary: summarizeToolResult(result),
+                completed_at: epochSeconds()
+              });
+            } catch {
+            }
+          }
+          return result;
+        } catch (error) {
+          if (turnId !== null) {
+            try {
+              updateTurn(turnId, {
+                tool_output_summary: summarizeToolError(error),
+                completed_at: epochSeconds()
+              });
+            } catch {
+            }
+          }
+          throw error;
+        }
+      }
+    };
+  }
 }
 function createVaultToolServer(agentId, runId, options) {
   const tools = createVaultTools(agentId, runId, options);
@@ -2431,4 +2470,4 @@ export {
   computeWaves,
   runAgent
 };
-//# sourceMappingURL=executor-4TJOZN32.js.map
+//# sourceMappingURL=executor-NXNSUEMQ.js.map