@goondocks/myco 0.18.0 → 0.18.1

package/dist/{agent-run-2NFYMQXW.js → agent-run-I4O2K2CK.js}

@@ -1,13 +1,13 @@
 import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
 import {
   connectToDaemon
-} from "./chunk-55QEICRO.js";
+} from "./chunk-TLK46KKD.js";
 import "./chunk-SAKJMNSR.js";
 import "./chunk-WYOE4IAX.js";
 import "./chunk-CML4MCYF.js";
 import "./chunk-MYX5NCRH.js";
-import "./chunk-BUIR3JWM.js";
-import "./chunk-EO2RQW4S.js";
+import "./chunk-XWOQL4XN.js";
+import "./chunk-W7WENJ6F.js";
 import "./chunk-LPUQPDC2.js";
 import "./chunk-CKJAWZQE.js";
 import "./chunk-E7NUADTQ.js";
@@ -32,4 +32,4 @@ async function run(args, vaultDir) {
 export {
   run
 };
-//# sourceMappingURL=agent-run-2NFYMQXW.js.map
+//# sourceMappingURL=agent-run-I4O2K2CK.js.map

package/dist/{agent-tasks-MEIYLXGN.js → agent-tasks-UOW5BQIB.js}

@@ -1,13 +1,13 @@
 import { createRequire as __cr } from 'node:module'; const require = __cr(import.meta.url);
 import {
   connectToDaemon
-} from "./chunk-55QEICRO.js";
+} from "./chunk-TLK46KKD.js";
 import "./chunk-SAKJMNSR.js";
 import "./chunk-WYOE4IAX.js";
 import "./chunk-CML4MCYF.js";
 import "./chunk-MYX5NCRH.js";
-import "./chunk-BUIR3JWM.js";
-import "./chunk-EO2RQW4S.js";
+import "./chunk-XWOQL4XN.js";
+import "./chunk-W7WENJ6F.js";
 import "./chunk-LPUQPDC2.js";
 import "./chunk-CKJAWZQE.js";
 import "./chunk-E7NUADTQ.js";
@@ -178,4 +178,4 @@ async function run(args, vaultDir) {
 export {
   run
 };
-//# sourceMappingURL=agent-tasks-MEIYLXGN.js.map
+//# sourceMappingURL=agent-tasks-UOW5BQIB.js.map

package/dist/{chunk-JMOUFG6Y.js → chunk-44PZCAYS.js}

@@ -19,7 +19,7 @@ function evaluateSessionStartRules(manifests, detectedAgent, ctx) {
     for (const rule of rules) {
       if (rule.event !== "session_start") continue;
       if (!scopePermits(rule, manifest.name, detectedAgent)) continue;
-      if (!whenMatches(rule, { prompt: "", transcriptPath: ctx.transcriptPath })) continue;
+      if (!whenMatches(rule, { prompt: "", transcriptPath: ctx.transcriptPath, transcriptMeta: ctx.transcriptMeta })) continue;
       if (rule.action === "drop") {
         return { action: "drop", reason: rule.reason };
       }
@@ -32,8 +32,8 @@ function scopePermits(rule, owningAgent, detectedAgent) {
   return owningAgent === detectedAgent;
 }
 function whenMatches(rule, ctx) {
-  const { prompt_starts_with, prompt_contains, transcript_path_missing } = rule.when;
-  const hasAnyCondition = prompt_starts_with !== void 0 || prompt_contains !== void 0 || transcript_path_missing !== void 0;
+  const { prompt_starts_with, prompt_contains, transcript_path_missing, transcript_meta_field_exists } = rule.when;
+  const hasAnyCondition = prompt_starts_with !== void 0 || prompt_contains !== void 0 || transcript_path_missing !== void 0 || transcript_meta_field_exists !== void 0;
   if (!hasAnyCondition) return false;
   if (prompt_starts_with && !ctx.prompt.startsWith(prompt_starts_with)) return false;
   if (prompt_contains && !ctx.prompt.includes(prompt_contains)) return false;
@@ -42,8 +42,20 @@ function whenMatches(rule, ctx) {
     if (transcript_path_missing && !missing) return false;
     if (!transcript_path_missing && missing) return false;
   }
+  if (transcript_meta_field_exists !== void 0) {
+    if (!ctx.transcriptMeta) return false;
+    if (!resolveMetaField(ctx.transcriptMeta, transcript_meta_field_exists)) return false;
+  }
   return true;
 }
+function resolveMetaField(meta, fieldPath) {
+  let current = meta;
+  for (const part of fieldPath.split(".")) {
+    if (current === null || current === void 0 || typeof current !== "object") return void 0;
+    current = current[part];
+  }
+  return current;
+}
 function applyAction(rule, ctx) {
   if (rule.action === "drop") {
     return { action: "drop", reason: rule.reason };
@@ -58,8 +70,38 @@ function applyAction(rule, ctx) {
   return { action: "rewrite", prompt: next, reason: rule.reason };
 }
 
+// src/hooks/transcript-meta.ts
+import fs from "fs";
+function readTranscriptMeta(transcriptPath) {
+  try {
+    const fd = fs.openSync(transcriptPath, "r");
+    try {
+      const buf = Buffer.alloc(131072);
+      const bytesRead = fs.readSync(fd, buf, 0, buf.length, 0);
+      if (bytesRead === 0) return null;
+      const chunk = buf.toString("utf-8", 0, bytesRead);
+      const newlineIdx = chunk.indexOf("\n");
+      const firstLine = newlineIdx >= 0 ? chunk.slice(0, newlineIdx) : chunk;
+      if (!firstLine) return null;
+      const entry = JSON.parse(firstLine);
+      if (entry?.type === "session_meta" && typeof entry.payload === "object") {
+        return entry.payload;
+      }
+      if (typeof entry === "object" && entry !== null) {
+        return entry;
+      }
+      return null;
+    } finally {
+      fs.closeSync(fd);
+    }
+  } catch {
+    return null;
+  }
+}
+
 export {
   evaluateUserPromptRules,
-  evaluateSessionStartRules
+  evaluateSessionStartRules,
+  readTranscriptMeta
 };
-//# sourceMappingURL=chunk-JMOUFG6Y.js.map
+//# sourceMappingURL=chunk-44PZCAYS.js.map

package/dist/chunk-44PZCAYS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/capture-rules.ts","../src/hooks/transcript-meta.ts"],"sourcesContent":["/**\n * Generic capture-rule evaluator.\n *\n * Each symbiont manifest declares `capture.rules` — a list of `{ event,\n * when, action }` records that describe how Myco should filter captured\n * events for that agent. This module loads rules from every manifest\n * in one place and exposes a pure evaluator the hook handlers call\n * without knowing anything symbiont-specific.\n *\n * Adding a new symbiont's capture behavior is a YAML-only change: edit\n * that agent's manifest file, no hook or evaluator changes needed.\n *\n * Rule scope (`this_agent` vs `any_agent`) lets rules opt into running\n * even when agent detection itself fails — useful for ephemeral\n * sub-invocations that legitimately lack the signals we key on.\n *\n * Conditions should prefer structural signals (e.g.,\n * `transcript_path_missing`) over text matching so rules stay robust\n * across upstream agent updates.\n */\n\nimport type { CaptureRule, SymbiontManifest } from '../symbionts/manifest-schema.js';\n\n/** Structured context a rule can match against at UserPromptSubmit time. */\nexport interface UserPromptRuleContext {\n  /** The user prompt text as received from the hook. */\n  prompt: string;\n  /** Transcript path from the hook payload, if any. Empty/undefined signals an ephemeral session. */\n  transcriptPath?: string;\n  /** Parsed first JSON line (session_meta) from the transcript, if available. */\n  transcriptMeta?: Record<string, unknown>;\n}\n\n/** Structured context a rule can match against at SessionStart time. */\nexport interface SessionStartRuleContext {\n  /** Transcript path from the hook payload, if any. Empty/undefined signals an ephemeral session. */\n  transcriptPath?: string;\n  /** Parsed first JSON line (session_meta) from the transcript, if available. */\n  transcriptMeta?: Record<string, unknown>;\n}\n\n/** Outcome of evaluating user_prompt rules. */\nexport type UserPromptDecision =\n  | { action: 'pass'; prompt: string }\n  | { action: 'rewrite'; prompt: string; reason?: string }\n  | { action: 'drop'; reason?: string };\n\n/** Outcome of evaluating session_start rules. No rewrite — there's no prompt text yet. */\nexport type SessionStartDecision =\n  | { action: 'pass' }\n  | { action: 'drop'; reason?: string };\n\n/**\n * Evaluate all user_prompt rules from every manifest against one context.\n *\n * Rules are checked in declaration order, first-match-wins. A rule only\n * fires when:\n *   1. its `event` is `user_prompt`,\n *   2. its scope permits it (see scope semantics in manifest-schema.ts),\n *   3. every condition in its `when` block matches the context.\n *\n * If no rule matches, the prompt passes through unchanged.\n */\nexport function evaluateUserPromptRules(\n  manifests: SymbiontManifest[],\n  detectedAgent: string,\n  ctx: UserPromptRuleContext,\n): UserPromptDecision {\n  for (const manifest of manifests) {\n    const rules = manifest.capture?.rules ?? [];\n    for (const rule of rules) {\n      if (rule.event !== 'user_prompt') continue;\n      if (!scopePermits(rule, manifest.name, detectedAgent)) continue;\n      if (!whenMatches(rule, ctx)) continue;\n      return applyAction(rule, ctx);\n    }\n  }\n  return { action: 'pass', prompt: ctx.prompt };\n}\n\n/**\n * Evaluate all session_start rules from every manifest.\n *\n * Same first-match-wins semantics as user_prompt rules. The only action\n * session_start rules can take is `drop` — text rewriting doesn't apply\n * because there's no prompt text at SessionStart time. Rules that\n * specify prompt-based conditions (prompt_starts_with / prompt_contains)\n * match against an empty prompt here, so they'll never fire on the\n * session_start pass.\n *\n * Callers should skip session registration when the result is `drop`.\n */\nexport function evaluateSessionStartRules(\n  manifests: SymbiontManifest[],\n  detectedAgent: string,\n  ctx: SessionStartRuleContext,\n): SessionStartDecision {\n  for (const manifest of manifests) {\n    const rules = manifest.capture?.rules ?? [];\n    for (const rule of rules) {\n      if (rule.event !== 'session_start') continue;\n      if (!scopePermits(rule, manifest.name, detectedAgent)) continue;\n      if (!whenMatches(rule, { prompt: '', transcriptPath: ctx.transcriptPath, transcriptMeta: ctx.transcriptMeta })) continue;\n      if (rule.action === 'drop') {\n        return { action: 'drop', reason: rule.reason };\n      }\n      // rewrite_prompt is meaningless at session_start — skip and let\n      // later rules have a chance to match.\n    }\n  }\n  return { action: 'pass' };\n}\n\nfunction scopePermits(rule: CaptureRule, owningAgent: string, detectedAgent: string): boolean {\n  if (rule.scope === 'any_agent') return true;\n  return owningAgent === detectedAgent;\n}\n\nfunction whenMatches(rule: CaptureRule, ctx: UserPromptRuleContext): boolean {\n  const { prompt_starts_with, prompt_contains, transcript_path_missing, transcript_meta_field_exists } = rule.when;\n\n  // Refuse rules with no conditions — prevents a mistyped YAML file from\n  // accidentally creating a blanket \"drop everything\" rule.\n  const hasAnyCondition =\n    prompt_starts_with !== undefined ||\n    prompt_contains !== undefined ||\n    transcript_path_missing !== undefined ||\n    transcript_meta_field_exists !== undefined;\n  if (!hasAnyCondition) return false;\n\n  if (prompt_starts_with && !ctx.prompt.startsWith(prompt_starts_with)) return false;\n  if (prompt_contains && !ctx.prompt.includes(prompt_contains)) return false;\n\n  if (transcript_path_missing !== undefined) {\n    const missing = !ctx.transcriptPath || ctx.transcriptPath.length === 0;\n    if (transcript_path_missing && !missing) return false;\n    if (!transcript_path_missing && missing) return false;\n  }\n\n  if (transcript_meta_field_exists !== undefined) {\n    if (!ctx.transcriptMeta) return false;\n    if (!resolveMetaField(ctx.transcriptMeta, transcript_meta_field_exists)) return false;\n  }\n\n  return true;\n}\n\n/**\n * Navigate a dot-path (e.g. \"source.subagent\") into a nested object.\n * Returns the value if it exists and is truthy, undefined otherwise.\n */\nfunction resolveMetaField(meta: Record<string, unknown>, fieldPath: string): unknown {\n  let current: unknown = meta;\n  for (const part of fieldPath.split('.')) {\n    if (current === null || current === undefined || typeof current !== 'object') return undefined;\n    current = (current as Record<string, unknown>)[part];\n  }\n  return current;\n}\n\nfunction applyAction(rule: CaptureRule, ctx: UserPromptRuleContext): UserPromptDecision {\n  if (rule.action === 'drop') {\n    return { action: 'drop', reason: rule.reason };\n  }\n  // rewrite_prompt — keep only the substring after the extract_after marker.\n  // If the marker isn't in the prompt, fall through to `pass` so we don't\n  // accidentally blank out a prompt that turned out not to match after all.\n  const marker = rule.extract_after;\n  if (!marker) return { action: 'pass', prompt: ctx.prompt };\n  const idx = ctx.prompt.indexOf(marker);\n  if (idx === -1) return { action: 'pass', prompt: ctx.prompt };\n  const after = ctx.prompt.slice(idx + marker.length);\n  const next = rule.trim ? after.trim() : after;\n  if (!next) return { action: 'pass', prompt: ctx.prompt };\n  return { action: 'rewrite', prompt: next, reason: rule.reason };\n}\n","/**\n * Read the first JSON line (session_meta) from an agent's transcript file.\n *\n * Every supported agent writes a JSONL transcript where the first entry\n * is a `session_meta` record containing session identity, source info,\n * model, and other structural signals. This reader extracts that record\n * so capture rules can make decisions based on it — e.g., detecting\n * sub-agent thread spawns that have real transcript files but aren't\n * user-initiated sessions.\n *\n * Returns the parsed `payload` object from the session_meta entry, or\n * null if the file doesn't exist, isn't readable, or doesn't contain\n * valid session_meta JSON.\n */\n\nimport fs from 'node:fs';\n\n/**\n * Read and parse the session_meta payload from a transcript file.\n *\n * @param transcriptPath - Absolute path to the JSONL transcript.\n * @returns The session_meta payload object, or null on any failure.\n */\nexport function readTranscriptMeta(transcriptPath: string): Record<string, unknown> | null {\n  try {\n    const fd = fs.openSync(transcriptPath, 'r');\n    try {\n      // Read enough bytes for the first line. Session meta can be large\n      // when it embeds the full system prompt (base_instructions) — Codex\n      // sessions routinely exceed 16 KB. 128 KB covers all known cases.\n      const buf = Buffer.alloc(131072);\n      const bytesRead = fs.readSync(fd, buf, 0, buf.length, 0);\n      if (bytesRead === 0) return null;\n\n      const chunk = buf.toString('utf-8', 0, bytesRead);\n      const newlineIdx = chunk.indexOf('\\n');\n      const firstLine = newlineIdx >= 0 ? chunk.slice(0, newlineIdx) : chunk;\n      if (!firstLine) return null;\n\n      const entry = JSON.parse(firstLine);\n\n      // session_meta entries have { type: \"session_meta\", payload: {...} }\n      if (entry?.type === 'session_meta' && typeof entry.payload === 'object') {\n        return entry.payload as Record<string, unknown>;\n      }\n\n      // Some agents may write the meta directly without the wrapper\n      if (typeof entry === 'object' && entry !== null) {\n        return entry as Record<string, unknown>;\n      }\n\n      return null;\n    } finally {\n      fs.closeSync(fd);\n    }\n  } catch {\n    return null;\n  }\n}\n"],"mappings":"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","names":[]}