@posthog/agent 2.3.349 → 2.3.351

package/dist/agent.js

@@ -3164,7 +3164,7 @@ import { v7 as uuidv7 } from "uuid";
 // package.json
 var package_default = {
   name: "@posthog/agent",
-  version: "2.3.349",
+  version: "2.3.351",
   repository: "https://github.com/PostHog/code",
   description: "TypeScript agent framework wrapping Claude Agent SDK with Git-based task execution for PostHog",
   exports: {
@@ -6994,7 +6994,7 @@ var createPostToolUseHook = ({ onModeChange, logger }) => async (input, toolUseI
 var SUBAGENT_REWRITES = {
   Explore: "ph-explore"
 };
-var createSubagentRewriteHook = (logger) => async (input, _toolUseID) => {
+var createSubagentRewriteHook = (logger, registeredAgents) => async (input, _toolUseID) => {
   if (input.hook_event_name !== "PreToolUse") {
     return { continue: true };
   }
@@ -7007,6 +7007,12 @@ var createSubagentRewriteHook = (logger) => async (input, _toolUseID) => {
     return { continue: true };
   }
   const target = SUBAGENT_REWRITES[subagentType];
+  if (!registeredAgents.has(target)) {
+    logger.warn(
+      `[SubagentRewriteHook] Skipping rewrite ${subagentType} \u2192 ${target}: target agent not registered for this session. Falling back to built-in ${subagentType}.`
+    );
+    return { continue: true };
+  }
   logger.info(
     `[SubagentRewriteHook] Rewriting subagent_type: ${subagentType} \u2192 ${target}`
   );
@@ -9120,7 +9126,7 @@ function buildEnvironment() {
     CLAUDE_CODE_EMIT_SESSION_STATE_EVENTS: "1"
   };
 }
-function buildHooks(userHooks, onModeChange, settingsManager, logger, enrichmentDeps, enrichedReadCache) {
+function buildHooks(userHooks, onModeChange, settingsManager, logger, enrichmentDeps, enrichedReadCache, registeredAgents) {
   const postToolUseHooks = [createPostToolUseHook({ onModeChange, logger })];
   if (enrichmentDeps && enrichedReadCache) {
     postToolUseHooks.push(
@@ -9138,12 +9144,49 @@ function buildHooks(userHooks, onModeChange, settingsManager, logger, enrichment
       {
         hooks: [
           createPreToolUseHook(settingsManager, logger),
-          createSubagentRewriteHook(logger)
+          createSubagentRewriteHook(logger, registeredAgents)
         ]
       }
     ]
   };
 }
+var PH_EXPLORE_AGENT = {
+  description: 'Fast agent for exploring and understanding codebases. Use this when you need to find files by pattern (eg. "src/components/**/*.tsx"), search for code or keywords (eg. "where is the auth middleware?"), or answer questions about how the codebase works (eg. "how does the session service handle reconnects?"). When calling this agent, specify a thoroughness level: "quick" for targeted lookups, "medium" for broader exploration, or "very thorough" for comprehensive analysis across multiple locations.',
+  model: "haiku",
+  prompt: `You are a fast, read-only codebase exploration agent.
+
+Your job is to find files, search code, read the most relevant sources, and report findings clearly.
+
+Rules:
+- Never create, modify, delete, move, or copy files.
+- Never use shell redirection or any command that changes system state.
+- Use Glob for broad file pattern matching.
+- Use Grep for searching file contents.
+- Use Read when you know the exact file path to inspect.
+- Use Bash only for safe read-only commands like ls, git status, git log, git diff, find, cat, head, and tail.
+- Adapt your search approach based on the thoroughness level specified by the caller.
+- Return file paths as absolute paths in your final response.
+- Avoid using emojis.
+- Wherever possible, spawn multiple parallel tool calls for grepping and reading files.
+- Search efficiently, then read only the most relevant files.
+- Return findings directly in your final response \u2014 do not create files.`,
+  tools: [
+    "Bash",
+    "Glob",
+    "Grep",
+    "Read",
+    "WebFetch",
+    "WebSearch",
+    "NotebookRead",
+    "TodoWrite"
+  ]
+};
+function buildAgents(userAgents) {
+  return {
+    "ph-explore": PH_EXPLORE_AGENT,
+    ...userAgents || {}
+  };
+}
 function getAbortController(userProvidedController) {
   const controller = userProvidedController ?? new AbortController();
   if (controller.signal.aborted) {
@@ -9229,6 +9272,8 @@ function ensureLocalSettings(cwd) {
 function buildSessionOptions(params) {
   ensureLocalSettings(params.cwd);
   const tools = params.userProvidedOptions?.tools ?? (params.disableBuiltInTools ? [] : { type: "preset", preset: "claude_code" });
+  const agents = buildAgents(params.userProvidedOptions?.agents);
+  const registeredAgentNames = new Set(Object.keys(agents));
   const options = {
     ...params.userProvidedOptions,
     betas: ["context-1m-2025-08-07"],
@@ -9242,6 +9287,7 @@ function buildSessionOptions(params) {
     canUseTool: params.canUseTool,
     executable: "node",
     tools,
+    agents,
     extraArgs: {
       ...params.userProvidedOptions?.extraArgs,
       "replay-user-messages": ""
@@ -9257,7 +9303,8 @@ function buildSessionOptions(params) {
       params.settingsManager,
       params.logger,
       params.enrichmentDeps,
-      params.enrichedReadCache
+      params.enrichedReadCache,
+      registeredAgentNames
     ),
     outputFormat: params.outputFormat,
     abortController: getAbortController(