@goondocks/myco 0.21.1 → 0.21.2

package/dist/chunk-DMPCC7V6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vault/types.ts","../src/mcp/tool-definitions.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const SessionFrontmatterSchema = z.object({\n  type: z.literal('session'),\n  id: z.string(),\n  agent: z.string(),\n  user: z.string(),\n  started: z.string(),\n  ended: z.string().optional(),\n  parent: z.string().optional(),\n  parent_reason: z.string().optional(),\n  plan: z.string().optional(),          // backward compat read path\n  plans: z.array(z.string()).optional(), // new: multiple plans\n  branch: z.string().optional(),\n  tags: z.array(z.string()).default([]),\n  tools_used: z.number().int().optional(),\n  files_changed: z.number().int().optional(),\n});\n\nexport const PLAN_STATUSES = ['active', 'in_progress', 'completed', 'abandoned'] as const;\n\nexport const PlanFrontmatterSchema = z.object({\n  type: z.literal('plan'),\n  id: z.string(),\n  status: z.enum(PLAN_STATUSES).default('active'),\n  created: z.string(),\n  author: z.string().optional(),\n  tags: z.array(z.string()).default([]),\n});\n\nexport const OBSERVATION_TYPES = ['gotcha', 'bug_fix', 'decision', 'discovery', 'trade_off', 'cross-cutting'] as const;\n\nexport const SPORE_STATUSES = ['active', 'superseded', 'archived'] as const;\nexport type SporeStatus = (typeof SPORE_STATUSES)[number];\n\nexport const SporeFrontmatterSchema = z.object({\n  type: z.literal('spore'),\n  id: z.string(),\n  observation_type: z.string(),\n  status: z.enum(SPORE_STATUSES).default('active'),\n  session: z.string().optional(),\n  plan: z.string().optional(),\n  superseded_by: z.string().optional(),\n  consolidated_from: z.array(z.string()).optional(),\n  created: z.string(),\n  tags: z.array(z.string()).default([]),\n});\n\nexport const ARTIFACT_TYPES = ['spec', 'plan', 'rfc', 'doc', 'other'] as const;\nexport type ArtifactType = (typeof ARTIFACT_TYPES)[number];\n\nexport const ArtifactFrontmatterSchema = z.object({\n  type: z.literal('artifact'),\n  id: z.string(),\n  artifact_type: z.enum(ARTIFACT_TYPES).default('other'),\n  source_path: z.string(),\n  title: z.string(),\n  last_captured_by: z.string(),\n  created: z.string(),\n  updated: z.string(),\n  tags: z.array(z.string()).default([]),\n});\n\nexport const TeamMemberFrontmatterSchema = z.object({\n  type: z.literal('team-member'),\n  user: z.string(),\n  joined: z.string(),\n  role: z.string().optional(),\n  tags: z.array(z.string()).default([]),\n});\n\nexport type SessionFrontmatter = z.infer<typeof SessionFrontmatterSchema>;\nexport type PlanFrontmatter = z.infer<typeof PlanFrontmatterSchema>;\nexport type SporeFrontmatter = z.infer<typeof SporeFrontmatterSchema>;\nexport type ObservationType = SporeFrontmatter['observation_type'];\nexport type ArtifactFrontmatter = z.infer<typeof ArtifactFrontmatterSchema>;\nexport type TeamMemberFrontmatter = z.infer<typeof TeamMemberFrontmatterSchema>;\n\nexport type NoteFrontmatter =\n  | SessionFrontmatter\n  | PlanFrontmatter\n  | SporeFrontmatter\n  | ArtifactFrontmatter\n  | TeamMemberFrontmatter;\n\nexport interface VaultNote<T extends NoteFrontmatter = NoteFrontmatter> {\n  path: string;\n  frontmatter: T;\n  content: string;\n}\n\nconst schemasByType: Record<string, z.ZodSchema> = {\n  session: SessionFrontmatterSchema,\n  plan: PlanFrontmatterSchema,\n  spore: SporeFrontmatterSchema,\n  artifact: ArtifactFrontmatterSchema,\n  'team-member': TeamMemberFrontmatterSchema,\n};\n\nexport function parseNoteFrontmatter(data: Record<string, unknown>): NoteFrontmatter {\n  const type = data.type as string;\n  const schema = schemasByType[type];\n  if (!schema) {\n    throw new Error(`Unknown note type: ${type}. Known types: ${Object.keys(schemasByType).join(', ')}`);\n  }\n  // gray-matter and YAML.parse return Date objects for ISO date strings.\n  // Coerce them to strings before Zod validation.\n  const coerced = coerceDatesToStrings(data);\n  return schema.parse(coerced) as NoteFrontmatter;\n}\n\nfunction coerceDatesToStrings(obj: Record<string, unknown>): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(obj)) {\n    if (value instanceof Date) {\n      result[key] = value.toISOString();\n    } else if (Array.isArray(value)) {\n      result[key] = value.map((item) => item instanceof Date ? item.toISOString() : item);\n    } else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {\n      result[key] = coerceDatesToStrings(value as Record<string, unknown>);\n    } else {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n","/**\n * MCP tool names, descriptions, and schema definitions.\n * Single source of truth for all tool metadata — referenced by the MCP server\n * and available to tests, logging, and documentation generators.\n */\nimport { OBSERVATION_TYPES, PLAN_STATUSES } from '../vault/types.js';\nimport { MCP_SEARCH_DEFAULT_LIMIT, MCP_SESSIONS_DEFAULT_LIMIT, MCP_SKILLS_DEFAULT_LIMIT } from '../constants.js';\n\n/** Plan statuses plus 'all' for filtering. */\nconst PLAN_STATUS_FILTER = [...PLAN_STATUSES, 'all'] as const;\nconst DEFAULT_CORTEX_PRIORITY = 100;\n\ninterface ToolInputSchema {\n  type: 'object';\n  properties: Record<string, unknown>;\n  required?: string[];\n}\n\nexport interface ToolCortexMetadata {\n  guidance: string;\n  priority?: number;\n  requiresTeam?: boolean;\n  requiresCollective?: boolean;\n}\n\n/**\n * MCP tool annotations. These follow the MCP spec's `annotations` envelope\n * so clients can show the right UI affordances (confirm-before-run for\n * destructive tools, quiet auto-run for read-only ones, etc.). Bundle D\n * makes these mandatory for every Myco-registered tool.\n */\nexport interface ToolAnnotations {\n  /** True if the tool never mutates state. */\n  readOnlyHint: boolean;\n  /**\n   * True if the tool can destroy data or start work that's hard to undo.\n   * For multi-op tools, set true if ANY op is destructive and describe\n   * the op matrix in the tool description.\n   */\n  destructiveHint: boolean;\n  /** True if calling the tool twice with the same input is safe. */\n  idempotentHint: boolean;\n  /** True if the tool reaches outside the local vault (network, other machines). */\n  openWorldHint: boolean;\n}\n\nexport interface ToolDefinition {\n  name: string;\n  description: string;\n  inputSchema: ToolInputSchema;\n  annotations?: ToolAnnotations;\n  cortex?: ToolCortexMetadata;\n}\n\nexport function getToolCortexPriority(tool: Pick<ToolDefinition, 'cortex'>): number {\n  return tool.cortex?.priority ?? DEFAULT_CORTEX_PRIORITY;\n}\n\n// --- Tool names ---\nexport const TOOL_SEARCH = 'myco_search';\nexport const TOOL_RECALL = 'myco_recall';\nexport const TOOL_REMEMBER = 'myco_remember';\nexport const TOOL_PLANS = 'myco_plans';\nexport const TOOL_SAVE_PLAN = 'myco_save_plan';\nexport const TOOL_SESSIONS = 'myco_sessions';\nexport const TOOL_TEAM = 'myco_team';\nexport const TOOL_GRAPH = 'myco_graph';\nexport const TOOL_SUPERSEDE = 'myco_supersede';\nexport const TOOL_CONSOLIDATE = 'myco_consolidate';\nexport const TOOL_CONTEXT = 'myco_context';\nexport const TOOL_SKILLS = 'myco_skills';\nexport const TOOL_SKILL_CANDIDATES = 'myco_skill_candidates';\nexport const TOOL_COLLECTIVE_SEARCH = 'collective_search';\nexport const TOOL_COLLECTIVE_PROJECTS = 'collective_projects';\nexport const TOOL_COLLECTIVE_PROJECT = 'collective_project';\nexport const TOOL_CORTEX = 'myco_cortex';\nexport const TOOL_RUNS = 'myco_runs';\nexport const TOOL_EVALUATIONS = 'myco_evaluations';\nexport const TOOL_WRITE_INTENTS = 'myco_write_intents';\nexport const TOOL_PHASE_AUDIT = 'myco_phase_audit';\nexport const TOOL_RESUME_RUN = 'myco_resume_run';\nexport const TOOL_DIGEST_REVISIONS = 'myco_digest_revisions';\n\n// --- Shared property descriptions (used by multiple tools) ---\nconst PROP_BRANCH = 'Git branch name to find related sessions and plans';\nconst PROP_SINCE = 'ISO timestamp — entries after this date';\nconst PROP_TAGS = 'Tags for discoverability — component names, technologies, concepts';\n\n// --- Tool definitions ---\nexport const TOOL_DEFINITIONS: ToolDefinition[] = [\n  {\n    name: TOOL_SEARCH,\n    description: 'Search the vault for prior sessions, spores, plans, and artifacts. Use before making design decisions, when debugging non-obvious issues, or when wondering why code is structured a certain way.',\n    cortex: {\n      guidance: 'Use for prior decisions, bugs, and rationale when you know the topic but not the exact note.',\n      priority: 20,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: { type: 'string', description: 'Natural language search query — describe what you are looking for' },\n        type: { type: 'string', enum: ['session', 'plan', 'spore', 'all'], description: 'Filter by note type (default: all)' },\n        limit: { type: 'number', description: `Max results (default: ${MCP_SEARCH_DEFAULT_LIMIT})` },\n        observation_type: { type: 'string', description: 'Optional semantic filter for spore observation type (decision, gotcha, discovery, etc.)' },\n        status: { type: 'string', description: 'Optional semantic filter for record status (for example active)' },\n        since: { type: 'number', description: 'Optional created_at lower bound in epoch seconds' },\n        until: { type: 'number', description: 'Optional created_at upper bound in epoch seconds' },\n      },\n      required: ['query'],\n    },\n  },\n  {\n    name: TOOL_RECALL,\n    description: 'Look up a specific vault note by ID — returns the full content of a session, spore, or plan. Use when you have a note ID from search results or graph traversal and need the complete details.',\n    cortex: {\n      guidance: 'Use after search finds a promising result and you need the full note.',\n      priority: 30,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        note_id: { type: 'string', description: 'Note ID to look up (e.g., \"session-abc123\", \"decision-xyz789\", \"plan-feature-x\")' },\n      },\n      required: ['note_id'],\n    },\n  },\n  {\n    name: TOOL_REMEMBER,\n    description: 'Save a decision, gotcha, bug fix, discovery, or trade-off as a permanent spore. Use after making a key decision, fixing a tricky bug, discovering something non-obvious, or encountering a gotcha. Session association is derived by the daemon — the MCP client does not pass it.',\n    cortex: {\n      guidance: 'Use to save durable decisions, gotchas, discoveries, or bug fixes from this work.',\n      priority: 90,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        content: { type: 'string', description: 'The observation — include context, reasoning, and what someone encountering this in the future needs to know' },\n        type: { type: 'string', enum: OBSERVATION_TYPES, description: `Observation type: ${OBSERVATION_TYPES.join(', ')}` },\n        tags: { type: 'array', items: { type: 'string' }, description: PROP_TAGS },\n      },\n      required: ['content', 'type'],\n    },\n  },\n  {\n    name: TOOL_PLANS,\n    description: 'List or delete implementation plans. op: \"list\" (default) returns plan summaries — filter by status, session, or a single id. op: \"delete\" removes a plan by id; cross-machine rows require force_remote: true. Use list to check what work is in flight before starting new tasks; use delete when retiring obsolete plans.',\n    annotations: {\n      // Destructive because op: \"delete\" removes a plan and enqueues a tombstone.\n      // Consumers should confirm before running this tool with op: \"delete\".\n      readOnlyHint: false,\n      destructiveHint: true,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use op: \"list\" before implementation when approved plans or specs may already exist; pass session to scope to the current work, or id to fetch a single plan with content.',\n      priority: 50,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        op: { type: 'string', enum: ['list', 'delete'], description: 'Operation (default: \"list\")' },\n        status: { type: 'string', enum: PLAN_STATUS_FILTER, description: 'Filter by status (default: all statuses); ignored for op: \"delete\"' },\n        id: { type: 'string', description: 'Plan id. Required for op: \"delete\". For op: \"list\" returns that plan with content.' },\n        session: { type: 'string', description: 'Filter list to plans belonging to this session; mutually exclusive with id.' },\n        limit: { type: 'number', description: 'Max results for op: \"list\"' },\n        force_remote: { type: 'boolean', description: 'Allow op: \"delete\" to remove a plan belonging to another machine. Enqueues a tombstone for team sync.' },\n      },\n    },\n  },\n  {\n    name: TOOL_SAVE_PLAN,\n    description: 'Persist a plan directly into Myco for a session. Use this when you generated or revised a plan and want it captured reliably. Pass exactly one of `source_path` or `plan_key` — `source_path` when the plan is also written to disk (so direct persistence and file capture reconcile to one logical plan), or `plan_key` for non-file-backed plans. The daemon rejects requests that set neither or both. Note: plan_key creates a stable namespace (session:<id>:key:<name>) distinct from transcript <tag> capture (session:<id>:tag:<name>) — the two do not merge. Dropping the transcript tag while also calling myco_save_plan with plan_key=tag will produce two separate rows.',\n    cortex: {\n      guidance: 'Use when you create or materially revise a plan and want it persisted to Myco. Pass `source_path` when the plan is also written to disk; otherwise use a stable `plan_key`. Note: `plan_key` rows are a separate namespace from transcript `<tag>` capture — reusing the same name in both channels creates two rows, not one.',\n      priority: 60,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        session_id: { type: 'string', description: 'Session id the plan belongs to' },\n        content: { type: 'string', description: 'Markdown plan content to persist' },\n        source_path: { type: 'string', description: 'Path to the plan file when the plan is also written to disk. Pass this OR plan_key, never both.' },\n        plan_key: { type: 'string', description: 'Stable key for non-file-backed plans (for example: primary). Pass this OR source_path, never both.' },\n        title: { type: 'string', description: 'Optional explicit title. Defaults to the first Markdown H1, then file name or humanized plan_key.' },\n        status: { type: 'string', enum: PLAN_STATUSES, description: `Plan status: ${PLAN_STATUSES.join(', ')}` },\n        tags: { type: 'array', items: { type: 'string' }, description: PROP_TAGS },\n      },\n      required: ['session_id', 'content'],\n    },\n  },\n  {\n    name: TOOL_SESSIONS,\n    description: 'Browse past coding sessions with summaries, tools used, and linked spores. Use to understand what work has been done on a feature or branch.',\n    cortex: {\n      guidance: 'Use when continuing related work or recovering recent implementation context.',\n      priority: 40,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        plan: { type: 'string', description: 'Filter to the session linked to this plan id' },\n        branch: { type: 'string', description: PROP_BRANCH },\n        user: { type: 'string', description: 'Filter sessions by user' },\n        since: { type: 'string', description: PROP_SINCE },\n        status: { type: 'string', description: 'Filter by session status (e.g., active, completed)' },\n        limit: { type: 'number', description: `Max results (default: ${MCP_SESSIONS_DEFAULT_LIMIT})` },\n      },\n    },\n  },\n  {\n    name: TOOL_TEAM,\n    description: 'List team members registered in the vault. Returns id, user, role, joined, and tags per member. Phase-1 scope: no filters.',\n    cortex: {\n      guidance: 'Use for current team topology and shared project context.',\n      priority: 70,\n      requiresTeam: true,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {},\n    },\n  },\n  {\n    name: TOOL_GRAPH,\n    description: 'Traverse connections between records via graph edges — explore how sessions, spores, and plans relate to each other.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        note_id: { type: 'string', description: 'Note ID to start from (e.g., \"session-abc123\" or \"decision-xyz789\")' },\n        direction: { type: 'string', enum: ['incoming', 'outgoing', 'both'], description: 'Link direction to follow (default: both)' },\n        depth: { type: 'number', description: 'How many hops to traverse, 1-3 (default: 1)' },\n      },\n      required: ['note_id'],\n    },\n  },\n  {\n    name: TOOL_SUPERSEDE,\n    description: 'Mark a spore as outdated and replaced by a newer one. Use when a decision was reversed, a gotcha was fixed, a discovery was wrong, or the codebase changed and an observation no longer applies. The old spore is preserved but marked superseded.',\n    cortex: {\n      guidance: 'Use when existing knowledge is outdated and should stop guiding future runs.',\n      priority: 100,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        old_spore_id: { type: 'string', description: 'ID of the outdated spore (e.g., \"decision-abc123\")' },\n        new_spore_id: { type: 'string', description: 'ID of the replacement spore' },\n        reason: { type: 'string', description: 'Why the old spore is being superseded' },\n      },\n      required: ['old_spore_id', 'new_spore_id'],\n    },\n  },\n  {\n    name: TOOL_CONSOLIDATE,\n    description: 'Merge 2+ related spores into a single comprehensive wisdom note. Inserts a new spore with the consolidated content; each source spore is marked superseded with a resolution_events row linking it to the new wisdom spore. Use when multiple observations describe aspects of the same insight, share a root cause, or would be more useful as one reference.',\n    cortex: {\n      guidance: 'Use when several related learnings should become one durable wisdom artifact.',\n      priority: 110,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        source_spore_ids: { type: 'array', items: { type: 'string' }, description: 'IDs of the spores to merge (minimum 2)' },\n        consolidated_content: { type: 'string', description: 'The merged, comprehensive content — synthesize, do not just concatenate' },\n        observation_type: { type: 'string', enum: OBSERVATION_TYPES, description: `Type for the consolidated wisdom note: ${OBSERVATION_TYPES.join(', ')}` },\n        tags: { type: 'array', items: { type: 'string' }, description: PROP_TAGS },\n        reason: { type: 'string', description: 'Optional reason recorded on each resolution event' },\n      },\n      required: ['source_spore_ids', 'consolidated_content', 'observation_type'],\n    },\n  },\n  {\n    name: TOOL_CONTEXT,\n    description: \"Retrieve Myco's pre-computed project digest — a rich, always-current synthesis of project history, decisions, patterns, active work, and institutional knowledge. Call this at the start of a new task or session to orient yourself on the project before taking action; call it again after long interruptions or when switching contexts. This is NOT a search — it's the project's accumulated understanding, served instantly. Available tiers: 1500 (executive briefing, one-screen overview), 5000 (deep onboarding, default), 10000 (comprehensive institutional knowledge). Prefer this over myco_search when you need broad project orientation; use myco_search when you need to find specific prior decisions or bug fixes.\",\n    cortex: {\n      guidance: 'Use for broad project orientation or when you want the current digest before planning changes.',\n      priority: 10,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        tier: {\n          type: 'number',\n          enum: [1500, 5000, 10000],\n          description: 'Token budget tier. Larger tiers include more detail. Default: 5000.',\n        },\n      },\n    },\n  },\n  {\n    name: TOOL_SKILLS,\n    description: 'List and inspect skills generated by Myco. Use to see what skills are active, check skill details, or find skills by status.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        id: { type: 'string', description: 'Get a specific skill by ID or name' },\n        status: { type: 'string', description: 'Filter by status: active, stale, retired' },\n        limit: { type: 'number', description: `Max results (default: ${MCP_SKILLS_DEFAULT_LIMIT})` },\n      },\n    },\n  },\n  {\n    name: TOOL_SKILL_CANDIDATES,\n    description: 'List and manage skill candidates — observations identified as potential skills. Use to see pending candidates, approve, or dismiss them.',\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        id: { type: 'string', description: 'Get a specific candidate by ID' },\n        action: { type: 'string', enum: ['list', 'approve', 'dismiss'], description: \"Action to perform (default: 'list')\" },\n        status: { type: 'string', description: 'Filter by status: identified, approved, generated, dismissed' },\n        limit: { type: 'number', description: `Max results (default: ${MCP_SKILLS_DEFAULT_LIMIT})` },\n      },\n    },\n  },\n  {\n    name: TOOL_CORTEX,\n    description: 'Cortex instruction + prompt-builder surface. op: \"get\" returns the current session-start instructions snapshot. op: \"refresh\" triggers the cortex-instructions task to regenerate them. op: \"build_prompt\" starts the cortex-prompt-builder task for a goal (required) and optional symbiont. op: \"get_prompt_result\" polls a prompt-builder run by run_id. Refresh and build_prompt are not read-only — they start background runs.',\n    annotations: {\n      // Mixed: get/get_prompt_result are read-only, refresh/build_prompt kick\n      // off background work. Mark conservatively — consumers should not silently\n      // auto-run this tool.\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use op: \"get\" to read your own session-start Cortex instructions; use op: \"build_prompt\" + \"get_prompt_result\" when you need the prompt-builder to draft a prompt for a specific goal.',\n      priority: 95,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        op: { type: 'string', enum: ['get', 'refresh', 'build_prompt', 'get_prompt_result'], description: 'Cortex operation' },\n        run_id: { type: 'string', description: 'Required for op: \"get_prompt_result\"' },\n        goal: { type: 'string', description: 'Required for op: \"build_prompt\" — the task the prompt will be built for' },\n        symbiont: { type: 'string', description: 'Optional symbiont/agent name the prompt should be tuned for; defaults to the first enabled symbiont' },\n      },\n      required: ['op'],\n    },\n  },\n  {\n    name: TOOL_RUNS,\n    description: 'Read agent run history. op: \"list\" (default) returns recent runs with runtime/provider/model/token/cost/reasoning fields — filter by task, agent_id, limit. op: \"get\" with id returns a single run including write_intents totals and duration_ms. Use after a run completes to check your own token budget, cost, and reasoning level — particularly useful when debugging a run that exhausted context.',\n    annotations: {\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use op: \"get\" with your run id to check your own token budget, cost, and reasoning level — especially after a run that exhausted context or failed. Use op: \"list\" to browse recent runs for a task.',\n      priority: 85,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        op: { type: 'string', enum: ['list', 'get'], description: 'Operation (default: \"list\")' },\n        id: { type: 'string', description: 'Required for op: \"get\" — the run id' },\n        task: { type: 'string', description: 'Filter op: \"list\" by task name' },\n        agent_id: { type: 'string', description: 'Filter op: \"list\" by agent id' },\n        limit: { type: 'number', description: 'Max results for op: \"list\" (default: 50)' },\n      },\n    },\n  },\n  {\n    name: TOOL_EVALUATIONS,\n    description: 'Create, list, or fetch agent evaluations. An evaluation fans out a single task across a cartesian product of (runtime × reasoning × model) cells so outputs can be compared side by side. op: \"list\" (default) returns newest-first summaries with an optional limit. op: \"get\" with id returns the evaluation + child runs + aggregate stats. op: \"create\" requires task_id and matrix; cells execute sequentially in the background — the response returns the evaluationId + cellCount. op: \"create\" is NOT read-only; it starts background runs.',\n    annotations: {\n      // Mixed ops: list/get are read-only, create kicks off background runs.\n      // Mark conservatively so clients confirm before auto-running with op: \"create\".\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use op: \"list\" to see recent matrix evaluations, op: \"get\" to inspect cells + aggregate stats, and op: \"create\" to fan a task out across runtime/reasoning/model cells for side-by-side comparison.',\n      priority: 88,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        op: { type: 'string', enum: ['list', 'get', 'create'], description: 'Operation (default: \"list\")' },\n        status: { type: 'string', description: 'Filter op: \"list\" by status (reserved; currently ignored by the route)' },\n        limit: { type: 'number', description: 'Max results for op: \"list\" (default: 50)' },\n        id: { type: 'string', description: 'Required for op: \"get\" — the evaluation id' },\n        task_id: { type: 'string', description: 'Required for op: \"create\" — id of the agent task to evaluate' },\n        matrix: {\n          type: 'object',\n          description: 'Required for op: \"create\". Matrix payload: { runtimes?, reasoningLevels?, models?, dryRun?, notes?, phases? }. Empty arrays expand to defaults. See /api/agent/evaluations POST body for full shape.',\n        },\n        notes: { type: 'string', description: 'Optional notes stored alongside the evaluation row (op: \"create\" only)' },\n      },\n    },\n  },\n  {\n    name: TOOL_WRITE_INTENTS,\n    description: 'Inspect the write-intents recorded during a dry-run — what the agent would have done (tool_name, tool_input, synthetic_output) without actually writing. Paginated via limit (default 500, max 5000) and offset. Use with myco_runs to verify safety before re-running the same task without dry_run.',\n    annotations: {\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use after a dry-run to inspect what writes the agent would have performed — close the \"dry-run → verify → real-run\" loop before repeating the task without dry_run.',\n      priority: 86,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        run_id: { type: 'string', description: 'The run id whose write-intents you want to inspect' },\n        limit: { type: 'number', description: 'Max results (default: 500, max: 5000)' },\n        offset: { type: 'number', description: 'Pagination offset (default: 0)' },\n      },\n      required: ['run_id'],\n    },\n  },\n  {\n    name: TOOL_PHASE_AUDIT,\n    description: 'Read the per-phase audit trail for an agent run — what each phase did, its cost, tool-call counts, reasoning level, and any write intents. Returns a joined view over agent_runs, agent_reports, agent_turns, usage_data, checkpoints, and (for dry runs) agent_run_write_intents. Essential for debugging a failed or mis-executing run.',\n    annotations: {\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use when debugging a failed or mis-executing run — returns the per-phase cost, tool counts, reasoning level, and write intents in one payload.',\n      priority: 87,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        run_id: { type: 'string', description: 'The run id whose phase audit you want to inspect' },\n      },\n      required: ['run_id'],\n    },\n  },\n  {\n    name: TOOL_RESUME_RUN,\n    description: 'Resume a paused or interrupted agent run. The run must be in a resumable state (resumable=1 AND status=\"failed\" per the route) — check status via myco_runs first. The resume starts a new background phase and returns immediately with {ok, message, runId}. NOT idempotent: each successful call starts a fresh phase.',\n    annotations: {\n      // Starts a new background phase; mark as mutating + non-idempotent so\n      // clients confirm before repeating. Not \"destructive\" (no data is\n      // removed) but also not \"read-only\".\n      readOnlyHint: false,\n      destructiveHint: false,\n      idempotentHint: false,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use to resume a paused or interrupted agent run after verifying (via myco_runs) that its resumable flag is set and its status is \"failed\".',\n      priority: 89,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        id: { type: 'string', description: 'The run id to resume' },\n        mode: { type: 'string', enum: ['manual', 'scheduled'], description: 'Resume mode (default: \"manual\"). Scheduled is reserved for the daemon scheduler.' },\n      },\n      required: ['id'],\n    },\n  },\n  {\n    name: TOOL_DIGEST_REVISIONS,\n    description: 'List historical digest revisions for the given (agent_id, tier). Revisions are append-only, so this surface shows how the project\\'s digest has evolved over time. tier is required; agent_id defaults to the primary agent on the daemon side. Restore (rolling a past revision back into the live digest) is intentionally UI-only and is NOT exposed via MCP.',\n    annotations: {\n      readOnlyHint: true,\n      destructiveHint: false,\n      idempotentHint: true,\n      openWorldHint: false,\n    },\n    cortex: {\n      guidance: 'Use to see how the project digest has evolved for a given tier — restore is UI-only.',\n      priority: 92,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        agent_id: { type: 'string', description: 'Optional — defaults to the primary agent on the daemon side' },\n        tier: { type: 'number', description: 'Required — the digest tier (for example 1500, 5000, 10000)' },\n        limit: { type: 'number', description: 'Max results (default: 50)' },\n      },\n      required: ['tier'],\n    },\n  },\n];\n\nexport const COLLECTIVE_TOOL_DEFINITIONS: ToolDefinition[] = [\n  {\n    name: TOOL_COLLECTIVE_SEARCH,\n    description: 'Search across connected projects in the active Myco Collective. Results include project attribution.',\n    cortex: {\n      guidance: 'Use for cross-project knowledge across the connected collective.',\n      priority: 80,\n      requiresCollective: true,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        query: { type: 'string', description: 'Natural language search query across the connected Collective projects' },\n        project: { type: 'string', description: 'Optional project id or project name filter' },\n        limit: { type: 'number', description: `Max results (default: ${MCP_SEARCH_DEFAULT_LIMIT})` },\n        types: { type: 'array', items: { type: 'string' }, description: 'Optional content type filter for remote semantic search' },\n        observation_type: { type: 'string', description: 'Optional spore observation type filter for remote semantic search' },\n        status: { type: 'string', description: 'Optional record status filter for remote semantic search' },\n        since: { type: 'number', description: 'Optional created_at lower bound in epoch seconds' },\n        until: { type: 'number', description: 'Optional created_at upper bound in epoch seconds' },\n        session_id: { type: 'string', description: 'Optional session id metadata filter' },\n        source_path: { type: 'string', description: 'Optional source path metadata filter' },\n        name: { type: 'string', description: 'Optional name metadata filter' },\n      },\n      required: ['query'],\n    },\n  },\n  {\n    name: TOOL_COLLECTIVE_PROJECTS,\n    description: 'List the projects connected to the active Myco Collective.',\n    cortex: {\n      guidance: 'Use to discover relevant collective projects before drilling deeper.',\n      priority: 81,\n      requiresCollective: true,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {},\n    },\n  },\n  {\n    name: TOOL_COLLECTIVE_PROJECT,\n    description: 'Get metadata for a single project connected to the active Myco Collective.',\n    cortex: {\n      guidance: 'Use when you know the collective project and need its focused context.',\n      priority: 82,\n      requiresCollective: true,\n    },\n    inputSchema: {\n      type: 'object' as const,\n      properties: {\n        project: { type: 'string', description: 'Project id or project name' },\n        include_digest: { type: 'boolean', description: 'Request digest information when available' },\n      },\n      required: ['project'],\n    },\n  },\n] as const;\n"],"mappings":";;;;;;;;;;;AAEO,IAAM,2BAA2B,iBAAE,OAAO;AAAA,EAC/C,MAAM,iBAAE,QAAQ,SAAS;AAAA,EACzB,IAAI,iBAAE,OAAO;AAAA,EACb,OAAO,iBAAE,OAAO;AAAA,EAChB,MAAM,iBAAE,OAAO;AAAA,EACf,SAAS,iBAAE,OAAO;AAAA,EAClB,OAAO,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC3B,QAAQ,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,eAAe,iBAAE,OAAO,EAAE,SAAS;AAAA,EACnC,MAAM,iBAAE,OAAO,EAAE,SAAS;AAAA;AAAA,EAC1B,OAAO,iBAAE,MAAM,iBAAE,OAAO,CAAC,EAAE,SAAS;AAAA;AAAA,EACpC,QAAQ,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,MAAM,iBAAE,MAAM,iBAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA,EACpC,YAAY,iBAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAAA,EACtC,eAAe,iBAAE,OAAO,EAAE,IAAI,EAAE,SAAS;AAC3C,CAAC;AAEM,IAAM,gBAAgB,CAAC,UAAU,eAAe,aAAa,WAAW;AAExE,IAAM,wBAAwB,iBAAE,OAAO;AAAA,EAC5C,MAAM,iBAAE,QAAQ,MAAM;AAAA,EACtB,IAAI,iBAAE,OAAO;AAAA,EACb,QAAQ,iBAAE,KAAK,aAAa,EAAE,QAAQ,QAAQ;AAAA,EAC9C,SAAS,iBAAE,OAAO;AAAA,EAClB,QAAQ,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,MAAM,iBAAE,MAAM,iBAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAEM,IAAM,oBAAoB,CAAC,UAAU,WAAW,YAAY,aAAa,aAAa,eAAe;AAErG,IAAM,iBAAiB,CAAC,UAAU,cAAc,UAAU;AAG1D,IAAM,yBAAyB,iBAAE,OAAO;AAAA,EAC7C,MAAM,iBAAE,QAAQ,OAAO;AAAA,EACvB,IAAI,iBAAE,OAAO;AAAA,EACb,kBAAkB,iBAAE,OAAO;AAAA,EAC3B,QAAQ,iBAAE,KAAK,cAAc,EAAE,QAAQ,QAAQ;AAAA,EAC/C,SAAS,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,MAAM,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,eAAe,iBAAE,OAAO,EAAE,SAAS;AAAA,EACnC,mBAAmB,iBAAE,MAAM,iBAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EAChD,SAAS,iBAAE,OAAO;AAAA,EAClB,MAAM,iBAAE,MAAM,iBAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAEM,IAAM,iBAAiB,CAAC,QAAQ,QAAQ,OAAO,OAAO,OAAO;AAG7D,IAAM,4BAA4B,iBAAE,OAAO;AAAA,EAChD,MAAM,iBAAE,QAAQ,UAAU;AAAA,EAC1B,IAAI,iBAAE,OAAO;AAAA,EACb,eAAe,iBAAE,KAAK,cAAc,EAAE,QAAQ,OAAO;AAAA,EACrD,aAAa,iBAAE,OAAO;AAAA,EACtB,OAAO,iBAAE,OAAO;AAAA,EAChB,kBAAkB,iBAAE,OAAO;AAAA,EAC3B,SAAS,iBAAE,OAAO;AAAA,EAClB,SAAS,iBAAE,OAAO;AAAA,EAClB,MAAM,iBAAE,MAAM,iBAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;AAEM,IAAM,8BAA8B,iBAAE,OAAO;AAAA,EAClD,MAAM,iBAAE,QAAQ,aAAa;AAAA,EAC7B,MAAM,iBAAE,OAAO;AAAA,EACf,QAAQ,iBAAE,OAAO;AAAA,EACjB,MAAM,iBAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,MAAM,iBAAE,MAAM,iBAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC;;;AC5DD,IAAM,qBAAqB,CAAC,GAAG,eAAe,KAAK;AACnD,IAAM,0BAA0B;AA4CzB,SAAS,sBAAsB,MAA8C;AAClF,SAAO,KAAK,QAAQ,YAAY;AAClC;AAGO,IAAM,cAAc;AACpB,IAAM,cAAc;AACpB,IAAM,gBAAgB;AACtB,IAAM,aAAa;AACnB,IAAM,iBAAiB;AACvB,IAAM,gBAAgB;AACtB,IAAM,YAAY;AAClB,IAAM,aAAa;AACnB,IAAM,iBAAiB;AACvB,IAAM,mBAAmB;AACzB,IAAM,eAAe;AACrB,IAAM,cAAc;AACpB,IAAM,wBAAwB;AAC9B,IAAM,yBAAyB;AAC/B,IAAM,2BAA2B;AACjC,IAAM,0BAA0B;AAChC,IAAM,cAAc;AACpB,IAAM,YAAY;AAClB,IAAM,mBAAmB;AACzB,IAAM,qBAAqB;AAC3B,IAAM,mBAAmB;AACzB,IAAM,kBAAkB;AACxB,IAAM,wBAAwB;AAGrC,IAAM,cAAc;AACpB,IAAM,aAAa;AACnB,IAAM,YAAY;AAGX,IAAM,mBAAqC;AAAA,EAChD;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,OAAO,EAAE,MAAM,UAAU,aAAa,yEAAoE;AAAA,QAC1G,MAAM,EAAE,MAAM,UAAU,MAAM,CAAC,WAAW,QAAQ,SAAS,KAAK,GAAG,aAAa,qCAAqC;AAAA,QACrH,OAAO,EAAE,MAAM,UAAU,aAAa,yBAAyB,wBAAwB,IAAI;AAAA,QAC3F,kBAAkB,EAAE,MAAM,UAAU,aAAa,0FAA0F;AAAA,QAC3I,QAAQ,EAAE,MAAM,UAAU,aAAa,kEAAkE;AAAA,QACzG,OAAO,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,QACzF,OAAO,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,MAC3F;AAAA,MACA,UAAU,CAAC,OAAO;AAAA,IACpB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,SAAS,EAAE,MAAM,UAAU,aAAa,mFAAmF;AAAA,MAC7H;AAAA,MACA,UAAU,CAAC,SAAS;AAAA,IACtB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,SAAS,EAAE,MAAM,UAAU,aAAa,oHAA+G;AAAA,QACvJ,MAAM,EAAE,MAAM,UAAU,MAAM,mBAAmB,aAAa,qBAAqB,kBAAkB,KAAK,IAAI,CAAC,GAAG;AAAA,QAClH,MAAM,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,GAAG,aAAa,UAAU;AAAA,MAC3E;AAAA,MACA,UAAU,CAAC,WAAW,MAAM;AAAA,IAC9B;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA;AAAA;AAAA,MAGX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU,MAAM,CAAC,QAAQ,QAAQ,GAAG,aAAa,8BAA8B;AAAA,QAC3F,QAAQ,EAAE,MAAM,UAAU,MAAM,oBAAoB,aAAa,qEAAqE;AAAA,QACtI,IAAI,EAAE,MAAM,UAAU,aAAa,qFAAqF;AAAA,QACxH,SAAS,EAAE,MAAM,UAAU,aAAa,8EAA8E;AAAA,QACtH,OAAO,EAAE,MAAM,UAAU,aAAa,6BAA6B;AAAA,QACnE,cAAc,EAAE,MAAM,WAAW,aAAa,wGAAwG;AAAA,MACxJ;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,YAAY,EAAE,MAAM,UAAU,aAAa,iCAAiC;AAAA,QAC5E,SAAS,EAAE,MAAM,UAAU,aAAa,mCAAmC;AAAA,QAC3E,aAAa,EAAE,MAAM,UAAU,aAAa,kGAAkG;AAAA,QAC9I,UAAU,EAAE,MAAM,UAAU,aAAa,qGAAqG;AAAA,QAC9I,OAAO,EAAE,MAAM,UAAU,aAAa,oGAAoG;AAAA,QAC1I,QAAQ,EAAE,MAAM,UAAU,MAAM,eAAe,aAAa,gBAAgB,cAAc,KAAK,IAAI,CAAC,GAAG;AAAA,QACvG,MAAM,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,GAAG,aAAa,UAAU;AAAA,MAC3E;AAAA,MACA,UAAU,CAAC,cAAc,SAAS;AAAA,IACpC;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,MAAM,EAAE,MAAM,UAAU,aAAa,+CAA+C;AAAA,QACpF,QAAQ,EAAE,MAAM,UAAU,aAAa,YAAY;AAAA,QACnD,MAAM,EAAE,MAAM,UAAU,aAAa,0BAA0B;AAAA,QAC/D,OAAO,EAAE,MAAM,UAAU,aAAa,WAAW;AAAA,QACjD,QAAQ,EAAE,MAAM,UAAU,aAAa,qDAAqD;AAAA,QAC5F,OAAO,EAAE,MAAM,UAAU,aAAa,yBAAyB,0BAA0B,IAAI;AAAA,MAC/F;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,MACV,cAAc;AAAA,IAChB;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY,CAAC;AAAA,IACf;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,SAAS,EAAE,MAAM,UAAU,aAAa,sEAAsE;AAAA,QAC9G,WAAW,EAAE,MAAM,UAAU,MAAM,CAAC,YAAY,YAAY,MAAM,GAAG,aAAa,2CAA2C;AAAA,QAC7H,OAAO,EAAE,MAAM,UAAU,aAAa,8CAA8C;AAAA,MACtF;AAAA,MACA,UAAU,CAAC,SAAS;AAAA,IACtB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,cAAc,EAAE,MAAM,UAAU,aAAa,qDAAqD;AAAA,QAClG,cAAc,EAAE,MAAM,UAAU,aAAa,8BAA8B;AAAA,QAC3E,QAAQ,EAAE,MAAM,UAAU,aAAa,wCAAwC;AAAA,MACjF;AAAA,MACA,UAAU,CAAC,gBAAgB,cAAc;AAAA,IAC3C;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,kBAAkB,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,GAAG,aAAa,yCAAyC;AAAA,QACpH,sBAAsB,EAAE,MAAM,UAAU,aAAa,+EAA0E;AAAA,QAC/H,kBAAkB,EAAE,MAAM,UAAU,MAAM,mBAAmB,aAAa,0CAA0C,kBAAkB,KAAK,IAAI,CAAC,GAAG;AAAA,QACnJ,MAAM,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,GAAG,aAAa,UAAU;AAAA,QACzE,QAAQ,EAAE,MAAM,UAAU,aAAa,oDAAoD;AAAA,MAC7F;AAAA,MACA,UAAU,CAAC,oBAAoB,wBAAwB,kBAAkB;AAAA,IAC3E;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,MAAM;AAAA,UACJ,MAAM;AAAA,UACN,MAAM,CAAC,MAAM,KAAM,GAAK;AAAA,UACxB,aAAa;AAAA,QACf;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU,aAAa,qCAAqC;AAAA,QACxE,QAAQ,EAAE,MAAM,UAAU,aAAa,2CAA2C;AAAA,QAClF,OAAO,EAAE,MAAM,UAAU,aAAa,yBAAyB,wBAAwB,IAAI;AAAA,MAC7F;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU,aAAa,iCAAiC;AAAA,QACpE,QAAQ,EAAE,MAAM,UAAU,MAAM,CAAC,QAAQ,WAAW,SAAS,GAAG,aAAa,sCAAsC;AAAA,QACnH,QAAQ,EAAE,MAAM,UAAU,aAAa,+DAA+D;AAAA,QACtG,OAAO,EAAE,MAAM,UAAU,aAAa,yBAAyB,wBAAwB,IAAI;AAAA,MAC7F;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA;AAAA;AAAA;AAAA,MAIX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU,MAAM,CAAC,OAAO,WAAW,gBAAgB,mBAAmB,GAAG,aAAa,mBAAmB;AAAA,QACrH,QAAQ,EAAE,MAAM,UAAU,aAAa,uCAAuC;AAAA,QAC9E,MAAM,EAAE,MAAM,UAAU,aAAa,+EAA0E;AAAA,QAC/G,UAAU,EAAE,MAAM,UAAU,aAAa,sGAAsG;AAAA,MACjJ;AAAA,MACA,UAAU,CAAC,IAAI;AAAA,IACjB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU,MAAM,CAAC,QAAQ,KAAK,GAAG,aAAa,8BAA8B;AAAA,QACxF,IAAI,EAAE,MAAM,UAAU,aAAa,2CAAsC;AAAA,QACzE,MAAM,EAAE,MAAM,UAAU,aAAa,iCAAiC;AAAA,QACtE,UAAU,EAAE,MAAM,UAAU,aAAa,gCAAgC;AAAA,QACzE,OAAO,EAAE,MAAM,UAAU,aAAa,2CAA2C;AAAA,MACnF;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA;AAAA;AAAA,MAGX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU,MAAM,CAAC,QAAQ,OAAO,QAAQ,GAAG,aAAa,8BAA8B;AAAA,QAClG,QAAQ,EAAE,MAAM,UAAU,aAAa,yEAAyE;AAAA,QAChH,OAAO,EAAE,MAAM,UAAU,aAAa,2CAA2C;AAAA,QACjF,IAAI,EAAE,MAAM,UAAU,aAAa,kDAA6C;AAAA,QAChF,SAAS,EAAE,MAAM,UAAU,aAAa,oEAA+D;AAAA,QACvG,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,QACA,OAAO,EAAE,MAAM,UAAU,aAAa,yEAAyE;AAAA,MACjH;AAAA,IACF;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,QAAQ,EAAE,MAAM,UAAU,aAAa,qDAAqD;AAAA,QAC5F,OAAO,EAAE,MAAM,UAAU,aAAa,wCAAwC;AAAA,QAC9E,QAAQ,EAAE,MAAM,UAAU,aAAa,iCAAiC;AAAA,MAC1E;AAAA,MACA,UAAU,CAAC,QAAQ;AAAA,IACrB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,QAAQ,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,MAC5F;AAAA,MACA,UAAU,CAAC,QAAQ;AAAA,IACrB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA;AAAA;AAAA;AAAA,MAIX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,IAAI,EAAE,MAAM,UAAU,aAAa,uBAAuB;AAAA,QAC1D,MAAM,EAAE,MAAM,UAAU,MAAM,CAAC,UAAU,WAAW,GAAG,aAAa,mFAAmF;AAAA,MACzJ;AAAA,MACA,UAAU,CAAC,IAAI;AAAA,IACjB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,aAAa;AAAA,MACX,cAAc;AAAA,MACd,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,eAAe;AAAA,IACjB;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,IACZ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,UAAU,EAAE,MAAM,UAAU,aAAa,mEAA8D;AAAA,QACvG,MAAM,EAAE,MAAM,UAAU,aAAa,kEAA6D;AAAA,QAClG,OAAO,EAAE,MAAM,UAAU,aAAa,4BAA4B;AAAA,MACpE;AAAA,MACA,UAAU,CAAC,MAAM;AAAA,IACnB;AAAA,EACF;AACF;AAEO,IAAM,8BAAgD;AAAA,EAC3D;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,MACV,oBAAoB;AAAA,IACtB;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,OAAO,EAAE,MAAM,UAAU,aAAa,yEAAyE;AAAA,QAC/G,SAAS,EAAE,MAAM,UAAU,aAAa,6CAA6C;AAAA,QACrF,OAAO,EAAE,MAAM,UAAU,aAAa,yBAAyB,wBAAwB,IAAI;AAAA,QAC3F,OAAO,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,GAAG,aAAa,0DAA0D;AAAA,QAC1H,kBAAkB,EAAE,MAAM,UAAU,aAAa,oEAAoE;AAAA,QACrH,QAAQ,EAAE,MAAM,UAAU,aAAa,2DAA2D;AAAA,QAClG,OAAO,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,QACzF,OAAO,EAAE,MAAM,UAAU,aAAa,mDAAmD;AAAA,QACzF,YAAY,EAAE,MAAM,UAAU,aAAa,sCAAsC;AAAA,QACjF,aAAa,EAAE,MAAM,UAAU,aAAa,uCAAuC;AAAA,QACnF,MAAM,EAAE,MAAM,UAAU,aAAa,gCAAgC;AAAA,MACvE;AAAA,MACA,UAAU,CAAC,OAAO;AAAA,IACpB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,MACV,oBAAoB;AAAA,IACtB;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY,CAAC;AAAA,IACf;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aAAa;AAAA,IACb,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,UAAU;AAAA,MACV,oBAAoB;AAAA,IACtB;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,SAAS,EAAE,MAAM,UAAU,aAAa,6BAA6B;AAAA,QACrE,gBAAgB,EAAE,MAAM,WAAW,aAAa,4CAA4C;AAAA,MAC9F;AAAA,MACA,UAAU,CAAC,SAAS;AAAA,IACtB;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-XL75KZGI.js → chunk-EKZG2MCD.js}

@@ -2,6 +2,9 @@ import { createRequire as __cr } from 'node:module'; const require = __cr(import
 import {
   getAtPath
 } from "./chunk-ZXZPJJN3.js";
+import {
+  DEFAULT_SYMBIONT_NAME
+} from "./chunk-6C6QZ4PM.js";
 
 // src/hooks/capture-rules.ts
 function evaluateUserPromptRules(manifests, detectedAgent, ctx) {
@@ -34,8 +37,9 @@ function evaluateSessionCaptureRules(manifests, detectedAgent, ctx) {
   return evaluateSessionStartRules(manifests, detectedAgent, ctx);
 }
 function scopePermits(rule, owningAgent, detectedAgent) {
-  if (rule.scope === "any_agent") return true;
-  return owningAgent === detectedAgent;
+  if (owningAgent === detectedAgent) return true;
+  if (rule.scope !== "any_agent") return false;
+  return detectedAgent === DEFAULT_SYMBIONT_NAME;
 }
 function whenMatches(rule, ctx) {
   const {
@@ -114,4 +118,4 @@ export {
   evaluateSessionCaptureRules,
   readTranscriptMeta
 };
-//# sourceMappingURL=chunk-XL75KZGI.js.map
+//# sourceMappingURL=chunk-EKZG2MCD.js.map

package/dist/chunk-EKZG2MCD.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';\nimport { getAtPath } from '../utils/dot-path.js';\nimport { DEFAULT_SYMBIONT_NAME } from '../constants.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 capture 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\n/**\n * Evaluate whether a session should be materialized at a lifecycle boundary.\n *\n * SessionStart uses this before registering a session row. Stop processing uses\n * the same decision before transcript-backed capture or stop-driven\n * auto-registration. Keeping both boundaries on the same manifest-driven\n * evaluator makes the rule sustainable for every symbiont, not just the one\n * that first exposed the gap.\n */\nexport function evaluateSessionCaptureRules(\n  manifests: SymbiontManifest[],\n  detectedAgent: string,\n  ctx: SessionStartRuleContext,\n): SessionStartDecision {\n  return evaluateSessionStartRules(manifests, detectedAgent, ctx);\n}\n\n/**\n * `any_agent` scope lets a manifest's rule fire even when its own agent isn't\n * the detected one — designed for phantom sub-invocations that arrive with\n * ambiguous attribution. Detection falls back to `DEFAULT_SYMBIONT_NAME` when\n * it fails (see normalize.ts and event-dispatch.ts), so `any_agent` only\n * crosses the agent boundary in that exact case. Events carrying a specific\n * non-default agent (e.g., plugin-delivered `agent: \"opencode\"`) are trusted\n * attribution and must not be touched by another manifest's `any_agent` rules\n * — otherwise codex's phantom-drop rule contaminates opencode, silently\n * dropping every event for any opencode session whose registry was lost.\n */\nfunction scopePermits(rule: CaptureRule, owningAgent: string, detectedAgent: string): boolean {\n  if (owningAgent === detectedAgent) return true;\n  if (rule.scope !== 'any_agent') return false;\n  return detectedAgent === DEFAULT_SYMBIONT_NAME;\n}\n\nfunction whenMatches(rule: CaptureRule, ctx: UserPromptRuleContext): boolean {\n  const {\n    prompt_starts_with,\n    prompt_contains,\n    transcript_path_missing,\n    transcript_meta_field_exists,\n    transcript_meta_field_equals,\n  } = 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    transcript_meta_field_equals !== 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 (!getAtPath(ctx.transcriptMeta, transcript_meta_field_exists)) return false;\n  }\n\n  if (transcript_meta_field_equals !== undefined) {\n    if (!ctx.transcriptMeta) return false;\n    if (getAtPath(ctx.transcriptMeta, transcript_meta_field_equals.path) !== transcript_meta_field_equals.value) {\n      return false;\n    }\n  }\n\n  return true;\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":[]}

package/dist/{chunk-X2IRGXGF.js → chunk-HCT7RMM2.js}

@@ -63,12 +63,11 @@ import {
   getSpore,
   insertSpore,
   listDigestExtracts,
-  listSporeIdsSince,
   listSpores,
   updateSporeStatus,
   upsertCortexInstructions,
   upsertDigestExtract
-} from "./chunk-N7Z3LUEZ.js";
+} from "./chunk-DBBO6FHE.js";
 import {
   countSessions,
   getActiveSessionIds,
@@ -93,7 +92,7 @@ import {
 } from "./chunk-MYX5NCRH.js";
 import {
   getPluginVersion
-} from "./chunk-ENZR5NG7.js";
+} from "./chunk-Z55WGA2J.js";
 import {
   findPackageRoot
 } from "./chunk-LPUQPDC2.js";
@@ -1257,6 +1256,32 @@ function deleteSkillRecordCascade(idOrName) {
   return { id: record.id, name: record.name };
 }
 
+// src/agent/semantic-shortlist.ts
+async function shortlistSemanticIds(options) {
+  const {
+    provider,
+    namespace,
+    query: query2,
+    candidateIds,
+    maxResults,
+    overFetch,
+    threshold,
+    filters
+  } = options;
+  if (!provider || maxResults <= 0) return [];
+  const queryVector = await provider.embedQuery(query2);
+  if (!queryVector) return [];
+  const results = provider.searchVectors(queryVector, {
+    namespace,
+    limit: Math.max(maxResults, maxResults * overFetch),
+    threshold,
+    filters
+  });
+  const shortlisted = candidateIds ? results.filter((result) => candidateIds.has(result.id)) : results;
+  shortlisted.sort((a, b) => b.similarity - a.similarity);
+  return shortlisted.slice(0, maxResults).map((result) => result.id);
+}
+
 // src/agent/tools/skill-validator.ts
 var import_yaml = __toESM(require_dist(), 1);
 var MAX_SKILL_LINES = 800;
@@ -1712,7 +1737,57 @@ function buildSkillSurveyInstruction(agentId) {
   return { instruction: parts.join("\n") };
 }
 var SKILL_EVOLVE_DEFAULT_ASSESS_INTERVAL_HOURS = 24;
-var SKILL_EVOLVE_DEFAULT_MAX_SKILLS_PER_RUN = 8;
+var SKILL_EVOLVE_DEFAULT_MAX_SKILLS_PER_RUN = 3;
+var SKILL_EVOLVE_RECENT_SPORE_SCAN_LIMIT = 40;
+var SKILL_EVOLVE_RELEVANT_SPORE_LIMIT = 10;
+var SKILL_EVOLVE_SEMANTIC_OVERFETCH = 4;
+var SKILL_EVOLVE_SEMANTIC_THRESHOLD = 0;
+function normalizeSkillName(name) {
+  return name.replace(/[-_:]+/g, " ");
+}
+function buildSporeSearchText(spore) {
+  return [spore.observation_type, spore.content, spore.context, spore.tags, spore.file_path].filter(Boolean).join(" ");
+}
+function selectRelevantSporeIdsByLexicalOverlap(skill, recentSpores) {
+  if (recentSpores.length === 0) return [];
+  const skillName = normalizeSkillName(skill.name);
+  const skillQuery = `${skillName} ${skill.description}`;
+  return recentSpores.map((spore) => {
+    const sporeText = buildSporeSearchText(spore);
+    const descriptionScore = descriptionSimilarity(skillQuery, sporeText);
+    const nameScore = descriptionSimilarity(skillName, sporeText);
+    const totalScore = descriptionScore + nameScore * 1.5;
+    return { id: spore.id, totalScore, createdAt: spore.created_at, importance: spore.importance };
+  }).filter((candidate) => candidate.totalScore > 0).sort((a, b) => {
+    if (b.totalScore !== a.totalScore) return b.totalScore - a.totalScore;
+    if (b.importance !== a.importance) return b.importance - a.importance;
+    return b.createdAt - a.createdAt;
+  }).slice(0, SKILL_EVOLVE_RELEVANT_SPORE_LIMIT).map((candidate) => candidate.id);
+}
+async function selectRelevantSporeIdsForSkill(skill, sinceEpoch, retrievalProvider) {
+  const recentSpores = listSpores({
+    status: "active",
+    since: sinceEpoch,
+    includeActive: false,
+    limit: SKILL_EVOLVE_RECENT_SPORE_SCAN_LIMIT
+  });
+  if (recentSpores.length === 0) return [];
+  const semanticIds = await shortlistSemanticIds({
+    provider: retrievalProvider,
+    namespace: "spores",
+    query: `${normalizeSkillName(skill.name)} ${skill.description}`,
+    candidateIds: new Set(recentSpores.map((spore) => spore.id)),
+    maxResults: SKILL_EVOLVE_RELEVANT_SPORE_LIMIT,
+    overFetch: SKILL_EVOLVE_SEMANTIC_OVERFETCH,
+    threshold: SKILL_EVOLVE_SEMANTIC_THRESHOLD,
+    filters: {
+      status: "active",
+      created_at_gte: sinceEpoch
+    }
+  });
+  if (semanticIds.length > 0) return semanticIds;
+  return selectRelevantSporeIdsByLexicalOverlap(skill, recentSpores);
+}
 var MIN_SECTIONS_FOR_STANDALONE = 2;
 function extractHeadings(content) {
   const bodyMatch = content.match(/^---[\s\S]*?---\n([\s\S]*)$/);
@@ -1739,7 +1814,7 @@ function headingOverlap(headingsA, headingsB) {
   const smaller = Math.min(headingsA.length, headingsB.length);
   return { score: smaller > 0 ? shared.length / smaller : 0, shared };
 }
-function buildSkillEvolveInstruction(params, projectRoot, similarityProvider) {
+async function buildSkillEvolveInstruction(params, projectRoot, retrievalProvider) {
   const assessIntervalHours = Number(params?.assess_interval_hours ?? SKILL_EVOLVE_DEFAULT_ASSESS_INTERVAL_HOURS);
   const maxSkillsPerRun = Number(params?.max_skills_per_run ?? SKILL_EVOLVE_DEFAULT_MAX_SKILLS_PER_RUN);
   const now = epochSeconds();
@@ -1756,20 +1831,20 @@ function buildSkillEvolveInstruction(params, projectRoot, similarityProvider) {
     const lastAssessedAt = typeof props.last_assessed_at === "number" ? props.last_assessed_at : 0;
     const knowledgeWatermark = typeof props.knowledge_watermark === "number" ? props.knowledge_watermark : 0;
     if (lastAssessedAt > 0 && now - lastAssessedAt < intervalSeconds) continue;
-    const newSporeIds = listSporeIdsSince(knowledgeWatermark, 10);
+    const newSporeIds = await selectRelevantSporeIdsForSkill(skill, knowledgeWatermark, retrievalProvider);
     if (newSporeIds.length === 0) continue;
     needsAssessment.push({
       id: skill.id,
       name: skill.name,
       generation: skill.generation,
       description: skill.description,
-      newSporeIds
+      newSporeIds,
+      lastAssessedAt
     });
-    if (needsAssessment.length >= maxSkillsPerRun) {
-      break;
-    }
   }
-  if (needsAssessment.length === 0) {
+  needsAssessment.sort((a, b) => a.lastAssessedAt - b.lastAssessedAt);
+  const selectedSkills = needsAssessment.slice(0, maxSkillsPerRun);
+  if (selectedSkills.length === 0) {
     return "No skills need assessment. All active skills are current or were recently assessed. Report skip via vault_report and finish.";
   }
   const structures = [];
@@ -1815,11 +1890,11 @@ function buildSkillEvolveInstruction(params, projectRoot, similarityProvider) {
     }
   }
   const parts = [
-    `${needsAssessment.length} skill(s) need assessment.`,
+    `${selectedSkills.length} skill(s) need assessment.`,
     `assess_interval_hours: ${assessIntervalHours}`,
     `max_skills_per_run: ${maxSkillsPerRun}`
   ];
-  for (const skill of needsAssessment) {
+  for (const skill of selectedSkills) {
     parts.push("");
     parts.push("---");
     parts.push(`## Skill: ${skill.name} (gen ${skill.generation})`);
@@ -1858,10 +1933,10 @@ function buildSkillEvolveInstruction(params, projectRoot, similarityProvider) {
       }
     }
   }
-  if (similarityProvider) {
+  if (retrievalProvider) {
     const idToName = new Map(allSkills.map((s) => [s.id, s.name]));
     try {
-      const semanticPairs = similarityProvider.pairwiseSimilarity("skill_records", 0.65);
+      const semanticPairs = retrievalProvider.pairwiseSimilarity("skill_records", 0.65);
       if (semanticPairs.length > 0) {
         parts.push("");
         parts.push("## Semantic Similarity (embedding cosine distance)");
@@ -1878,14 +1953,14 @@ function buildSkillEvolveInstruction(params, projectRoot, similarityProvider) {
   }
   return parts.join("\n");
 }
-async function buildTaskInstruction(taskName, taskParams, agentId, projectRoot, similarityProvider, config, getTeamClient) {
+async function buildTaskInstruction(taskName, taskParams, agentId, projectRoot, retrievalProvider, config, getTeamClient) {
   switch (taskName) {
     case SKILL_GENERATE_TASK:
       return buildSkillGenerateInstruction();
     case SKILL_SURVEY_TASK:
       return agentId ? buildSkillSurveyInstruction(agentId) : void 0;
     case SKILL_EVOLVE_TASK: {
-      const instruction = buildSkillEvolveInstruction(taskParams, projectRoot, similarityProvider);
+      const instruction = await buildSkillEvolveInstruction(taskParams, projectRoot, retrievalProvider);
       return instruction ? { instruction } : void 0;
     }
     case CORTEX_INSTRUCTIONS_TASK: {
@@ -3068,6 +3143,27 @@ function countWriteIntentsByToolForEvaluation(evaluationId) {
 // src/agent/tools/read-tools.ts
 import { tool } from "@anthropic-ai/claude-agent-sdk";
 
+// src/semantic-search-filters.ts
+function hasSemanticSearchFilters(filters) {
+  if (!filters) return false;
+  return Object.values(filters).some((value) => value !== void 0);
+}
+function matchesSemanticSearchFilters(metadata, filters) {
+  if (!filters) return true;
+  if (filters.status !== void 0 && metadata?.status !== filters.status) return false;
+  if (filters.session_id !== void 0 && metadata?.session_id !== filters.session_id) return false;
+  if (filters.observation_type !== void 0 && metadata?.observation_type !== filters.observation_type) return false;
+  if (filters.project_root !== void 0 && metadata?.project_root !== filters.project_root) return false;
+  if (filters.name !== void 0 && metadata?.name !== filters.name) return false;
+  if (filters.source_path !== void 0 && metadata?.source_path !== filters.source_path) return false;
+  const createdAt = typeof metadata?.created_at === "number" ? metadata.created_at : void 0;
+  if (filters.created_at_gte !== void 0 && (createdAt === void 0 || createdAt < filters.created_at_gte)) return false;
+  if (filters.created_at_lte !== void 0 && (createdAt === void 0 || createdAt > filters.created_at_lte)) return false;
+  if (filters.created_at_gt !== void 0 && (createdAt === void 0 || createdAt <= filters.created_at_gt)) return false;
+  if (filters.created_at_lt !== void 0 && (createdAt === void 0 || createdAt >= filters.created_at_lt)) return false;
+  return true;
+}
+
 // src/db/queries/graph-edges.ts
 import crypto3 from "crypto";
 var DEFAULT_BFS_DEPTH = 2;
@@ -3409,7 +3505,12 @@ function createReadTools(deps) {
       query: external_exports.string().describe("Search query text"),
       namespace: external_exports.string().optional().describe("Restrict to a content type: spores, sessions, plans, artifacts, skill_records. Omit to search all."),
       limit: external_exports.number().optional().describe("Maximum results to return"),
-      include_active: external_exports.boolean().optional().describe("Include results from sessions still in active status (default: false)")
+      include_active: external_exports.boolean().optional().describe("Include results from sessions still in active status (default: false)"),
+      status: external_exports.string().optional().describe("Optional metadata filter, e.g. active/superseded for spores and skill_records."),
+      session_id: external_exports.string().optional().describe("Optional metadata filter for a linked session id."),
+      observation_type: external_exports.string().optional().describe("Optional metadata filter for spore observation type."),
+      since: external_exports.number().optional().describe("Optional created_at lower bound (epoch seconds)."),
+      until: external_exports.number().optional().describe("Optional created_at upper bound (epoch seconds).")
     },
     async (args) => {
       if (!embeddingManager) {
@@ -3423,21 +3524,39 @@ function createReadTools(deps) {
         const searchLimit = args.limit ?? DEFAULT_SEARCH_LIMIT;
         const excludeActive = args.include_active !== true;
         const activeIds = excludeActive ? getActiveSessionIds() : /* @__PURE__ */ new Set();
+        const metadataFilters = {
+          ...args.status !== void 0 ? { status: args.status } : {},
+          ...args.session_id !== void 0 ? { session_id: args.session_id } : {},
+          ...args.observation_type !== void 0 ? { observation_type: args.observation_type } : {},
+          ...args.since !== void 0 ? { created_at_gte: args.since } : {},
+          ...args.until !== void 0 ? { created_at_lte: args.until } : {}
+        };
+        const vectorFilters = hasSemanticSearchFilters(metadataFilters) ? metadataFilters : void 0;
         const [rawLocalResults, teamResults] = await Promise.all([
           Promise.resolve(
             embeddingManager.searchVectors(queryVector, {
               namespace: args.namespace,
               limit: searchLimit,
-              threshold: SEARCH_SIMILARITY_THRESHOLD
+              threshold: SEARCH_SIMILARITY_THRESHOLD,
+              filters: vectorFilters
             }).map((r) => ({ ...r, source: "local" }))
           ),
-          teamClient ? teamClient.search(args.query, { limit: searchLimit }).then((res) => res.results.map((r) => ({ ...r, source: `${TEAM_SOURCE_PREFIX}${r.machine_id}` }))).catch(() => []) : Promise.resolve([])
+          teamClient ? teamClient.search(args.query, {
+            limit: searchLimit,
+            tables: args.namespace ? [args.namespace] : void 0,
+            status: args.status,
+            observation_type: args.observation_type,
+            since: args.since,
+            until: args.until,
+            session_id: args.session_id
+          }).then((res) => res.results.map((r) => ({ ...r, source: `${TEAM_SOURCE_PREFIX}${r.machine_id}` }))).catch(() => []) : Promise.resolve([])
         ]);
         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) => ({
+        const filteredLocalResults = vectorFilters ? localResults.filter((r) => matchesSemanticSearchFilters(r.metadata, metadataFilters)) : localResults;
+        const hydratedLocalResults = hydrateSearchResults(filteredLocalResults).map((r) => ({
           ...r,
           source: "local"
         }));
@@ -3448,6 +3567,12 @@ function createReadTools(deps) {
             return typeof sid !== "string" || !activeIds.has(sid);
           });
         }
+        if (vectorFilters) {
+          dedupedTeam = dedupedTeam.filter((r) => matchesSemanticSearchFilters(
+            r.metadata,
+            metadataFilters
+          ));
+        }
         const merged = [
           ...hydratedLocalResults,
           ...dedupedTeam
@@ -3676,7 +3801,8 @@ function createWriteTools(deps) {
       embeddingManager?.onContentWritten("spores", spore.id, args.content, {
         status: "active",
         observation_type: args.observation_type,
-        session_id: args.session_id
+        session_id: args.session_id,
+        created_at: now
       }).catch(() => {
       });
       return textResult(spore);
@@ -13874,7 +14000,8 @@ async function runAgent(vaultDir, options) {
       agentId,
       runId,
       runContext: options?.runContext,
-      instruction: options?.instruction
+      instruction: options?.instruction,
+      dryRun: options?.dryRun
     });
     const completedAt = epochSeconds();
     updateRunStatus(runId, STATUS_COMPLETED, {
@@ -14001,6 +14128,7 @@ async function cleanupOnTaskFailure(args) {
 }
 async function finalizeOnTaskSuccess(args) {
   if (args.taskName !== CORTEX_INSTRUCTIONS_TASK) return;
+  if (args.dryRun) return;
   const reports = listReports(args.runId);
   let report;
   for (let i = reports.length - 1; i >= 0; i -= 1) {
@@ -14091,6 +14219,8 @@ export {
   countWriteIntents,
   countWriteIntentsByTool,
   countWriteIntentsByToolForEvaluation,
+  hasSemanticSearchFilters,
+  matchesSemanticSearchFilters,
   getGraphForNode,
   createBatchLineage,
   insertResolutionEvent,
@@ -14100,4 +14230,4 @@ export {
   cleanupOnTaskFailure,
   finalizeOnTaskSuccess
 };
-//# sourceMappingURL=chunk-X2IRGXGF.js.map
+//# sourceMappingURL=chunk-HCT7RMM2.js.map