@posthog/agent 2.0.0 → 2.0.2

package/dist/adapters/claude/permissions/permission-options.js

@@ -0,0 +1,117 @@
+// src/utils/common.ts
+var IS_ROOT = typeof process !== "undefined" && (process.geteuid?.() ?? process.getuid?.()) === 0;
+
+// src/adapters/claude/mcp/tool-metadata.ts
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+
+// src/adapters/claude/tools.ts
+var READ_TOOLS = /* @__PURE__ */ new Set(["Read", "NotebookRead"]);
+var WRITE_TOOLS = /* @__PURE__ */ new Set([
+  "Edit",
+  "Write",
+  "NotebookEdit"
+]);
+var BASH_TOOLS = /* @__PURE__ */ new Set([
+  "Bash",
+  "BashOutput",
+  "KillShell"
+]);
+var SEARCH_TOOLS = /* @__PURE__ */ new Set(["Glob", "Grep", "LS"]);
+var WEB_TOOLS = /* @__PURE__ */ new Set(["WebSearch", "WebFetch"]);
+var AGENT_TOOLS = /* @__PURE__ */ new Set(["Task", "TodoWrite"]);
+var BASE_ALLOWED_TOOLS = [
+  ...READ_TOOLS,
+  ...SEARCH_TOOLS,
+  ...WEB_TOOLS,
+  ...AGENT_TOOLS
+];
+var AUTO_ALLOWED_TOOLS = {
+  default: new Set(BASE_ALLOWED_TOOLS),
+  acceptEdits: /* @__PURE__ */ new Set([...BASE_ALLOWED_TOOLS, ...WRITE_TOOLS]),
+  plan: new Set(BASE_ALLOWED_TOOLS)
+};
+
+// src/adapters/claude/permissions/permission-options.ts
+function permissionOptions(allowAlwaysLabel) {
+  return [
+    { kind: "allow_once", name: "Yes", optionId: "allow" },
+    { kind: "allow_always", name: allowAlwaysLabel, optionId: "allow_always" },
+    {
+      kind: "reject_once",
+      name: "No, and tell the agent what to do differently",
+      optionId: "reject",
+      _meta: { customInput: true }
+    }
+  ];
+}
+function buildPermissionOptions(toolName, toolInput, cwd) {
+  if (BASH_TOOLS.has(toolName)) {
+    const command = toolInput?.command;
+    const cmdName = command?.split(/\s+/)[0] ?? "this command";
+    const cwdLabel = cwd ? ` in ${cwd}` : "";
+    return permissionOptions(
+      `Yes, and don't ask again for \`${cmdName}\` commands${cwdLabel}`
+    );
+  }
+  if (toolName === "BashOutput") {
+    return permissionOptions("Yes, allow all background process reads");
+  }
+  if (toolName === "KillShell") {
+    return permissionOptions("Yes, allow killing processes");
+  }
+  if (WRITE_TOOLS.has(toolName)) {
+    return permissionOptions("Yes, allow all edits during this session");
+  }
+  if (READ_TOOLS.has(toolName)) {
+    return permissionOptions("Yes, allow all reads during this session");
+  }
+  if (SEARCH_TOOLS.has(toolName)) {
+    return permissionOptions("Yes, allow all searches during this session");
+  }
+  if (toolName === "WebFetch") {
+    const url = toolInput?.url;
+    let domain = "";
+    try {
+      domain = url ? new URL(url).hostname : "";
+    } catch {
+    }
+    return permissionOptions(
+      domain ? `Yes, allow all fetches from ${domain}` : "Yes, allow all fetches"
+    );
+  }
+  if (toolName === "WebSearch") {
+    return permissionOptions("Yes, allow all web searches");
+  }
+  if (toolName === "Task") {
+    return permissionOptions("Yes, allow all sub-tasks");
+  }
+  if (toolName === "TodoWrite") {
+    return permissionOptions("Yes, allow all todo updates");
+  }
+  return permissionOptions("Yes, always allow");
+}
+function buildExitPlanModePermissionOptions() {
+  return [
+    {
+      kind: "allow_always",
+      name: "Yes, and auto-accept edits",
+      optionId: "acceptEdits"
+    },
+    {
+      kind: "allow_once",
+      name: "Yes, and manually approve edits",
+      optionId: "default"
+    },
+    {
+      kind: "reject_once",
+      name: "No, keep planning",
+      optionId: "plan"
+    }
+  ];
+}
+export {
+  buildExitPlanModePermissionOptions,
+  buildPermissionOptions
+};
+//# sourceMappingURL=permission-options.js.map

package/dist/adapters/claude/permissions/permission-options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/common.ts","../../../../src/adapters/claude/mcp/tool-metadata.ts","../../../../src/adapters/claude/tools.ts","../../../../src/adapters/claude/permissions/permission-options.ts"],"sourcesContent":["import type { Logger } from \"./logger.js\";\n\nexport const IS_ROOT =\n  typeof process !== \"undefined\" &&\n  (process.geteuid?.() ?? process.getuid?.()) === 0;\n\nexport function unreachable(value: never, logger: Logger): void {\n  let valueAsString: string;\n  try {\n    valueAsString = JSON.stringify(value);\n  } catch {\n    valueAsString = value;\n  }\n  logger.error(`Unexpected case: ${valueAsString}`);\n}\n","import type { McpServerConfig } from \"@anthropic-ai/claude-agent-sdk\";\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport { Logger } from \"../../../utils/logger.js\";\n\nexport interface McpToolMetadata {\n  readOnly: boolean;\n}\n\nconst mcpToolMetadataCache: Map<string, McpToolMetadata> = new Map();\n\nfunction buildToolKey(serverName: string, toolName: string): string {\n  return `mcp__${serverName}__${toolName}`;\n}\n\nfunction isHttpMcpServer(\n  config: McpServerConfig,\n): config is McpServerConfig & { type: \"http\"; url: string } {\n  return config.type === \"http\" && typeof (config as any).url === \"string\";\n}\n\nasync function fetchToolsFromHttpServer(\n  _serverName: string,\n  config: McpServerConfig & { type: \"http\"; url: string },\n): Promise<Tool[]> {\n  const transport = new StreamableHTTPClientTransport(new URL(config.url), {\n    requestInit: {\n      headers: (config as any).headers || {},\n    },\n  });\n\n  const client = new Client({\n    name: \"twig-metadata-fetcher\",\n    version: \"1.0.0\",\n  });\n\n  try {\n    await client.connect(transport);\n    const result = await client.listTools();\n    return result.tools;\n  } finally {\n    await client.close().catch(() => {});\n  }\n}\n\nfunction extractToolMetadata(tool: Tool): McpToolMetadata {\n  return {\n    readOnly: tool.annotations?.readOnlyHint === true,\n  };\n}\n\nexport async function fetchMcpToolMetadata(\n  mcpServers: Record<string, McpServerConfig>,\n  logger: Logger = new Logger({ debug: false, prefix: \"[McpToolMetadata]\" }),\n): Promise<void> {\n  const fetchPromises: Promise<void>[] = [];\n\n  for (const [serverName, config] of Object.entries(mcpServers)) {\n    if (!isHttpMcpServer(config)) {\n      continue;\n    }\n\n    const fetchPromise = fetchToolsFromHttpServer(serverName, config)\n      .then((tools) => {\n        const toolCount = tools.length;\n        const readOnlyCount = tools.filter(\n          (t) => t.annotations?.readOnlyHint === true,\n        ).length;\n\n        for (const tool of tools) {\n          const toolKey = buildToolKey(serverName, tool.name);\n          mcpToolMetadataCache.set(toolKey, extractToolMetadata(tool));\n        }\n\n        logger.info(\"Fetched MCP tool metadata\", {\n          serverName,\n          toolCount,\n          readOnlyCount,\n        });\n      })\n      .catch((error) => {\n        logger.error(\"Failed to fetch MCP tool metadata\", {\n          serverName,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      });\n\n    fetchPromises.push(fetchPromise);\n  }\n\n  await Promise.all(fetchPromises);\n}\n\nexport function isMcpToolReadOnly(toolName: string): boolean {\n  const metadata = mcpToolMetadataCache.get(toolName);\n  return metadata?.readOnly === true;\n}\n\nexport function clearMcpToolMetadataCache(): void {\n  mcpToolMetadataCache.clear();\n}\n","export {\n  getAvailableModes,\n  type ModeInfo,\n  TWIG_EXECUTION_MODES,\n  type TwigExecutionMode,\n} from \"../../execution-mode.js\";\n\nimport type { TwigExecutionMode } from \"../../execution-mode.js\";\nimport { isMcpToolReadOnly } from \"./mcp/tool-metadata.js\";\n\nexport const READ_TOOLS: Set<string> = new Set([\"Read\", \"NotebookRead\"]);\n\nexport const WRITE_TOOLS: Set<string> = new Set([\n  \"Edit\",\n  \"Write\",\n  \"NotebookEdit\",\n]);\n\nexport const BASH_TOOLS: Set<string> = new Set([\n  \"Bash\",\n  \"BashOutput\",\n  \"KillShell\",\n]);\n\nexport const SEARCH_TOOLS: Set<string> = new Set([\"Glob\", \"Grep\", \"LS\"]);\n\nexport const WEB_TOOLS: Set<string> = new Set([\"WebSearch\", \"WebFetch\"]);\n\nexport const AGENT_TOOLS: Set<string> = new Set([\"Task\", \"TodoWrite\"]);\n\nconst BASE_ALLOWED_TOOLS = [\n  ...READ_TOOLS,\n  ...SEARCH_TOOLS,\n  ...WEB_TOOLS,\n  ...AGENT_TOOLS,\n];\n\nconst AUTO_ALLOWED_TOOLS: Record<string, Set<string>> = {\n  default: new Set(BASE_ALLOWED_TOOLS),\n  acceptEdits: new Set([...BASE_ALLOWED_TOOLS, ...WRITE_TOOLS]),\n  plan: new Set(BASE_ALLOWED_TOOLS),\n};\n\nexport function isToolAllowedForMode(\n  toolName: string,\n  mode: TwigExecutionMode,\n): boolean {\n  if (mode === \"bypassPermissions\") {\n    return true;\n  }\n  if (AUTO_ALLOWED_TOOLS[mode]?.has(toolName) === true) {\n    return true;\n  }\n  if (isMcpToolReadOnly(toolName)) {\n    return true;\n  }\n  return false;\n}\n","import { BASH_TOOLS, READ_TOOLS, SEARCH_TOOLS, WRITE_TOOLS } from \"../tools.js\";\n\nexport interface PermissionOption {\n  kind: \"allow_once\" | \"allow_always\" | \"reject_once\" | \"reject_always\";\n  name: string;\n  optionId: string;\n  _meta?: { description?: string; customInput?: boolean };\n}\n\nfunction permissionOptions(allowAlwaysLabel: string): PermissionOption[] {\n  return [\n    { kind: \"allow_once\", name: \"Yes\", optionId: \"allow\" },\n    { kind: \"allow_always\", name: allowAlwaysLabel, optionId: \"allow_always\" },\n    {\n      kind: \"reject_once\",\n      name: \"No, and tell the agent what to do differently\",\n      optionId: \"reject\",\n      _meta: { customInput: true },\n    },\n  ];\n}\n\nexport function buildPermissionOptions(\n  toolName: string,\n  toolInput: Record<string, unknown>,\n  cwd?: string,\n): PermissionOption[] {\n  if (BASH_TOOLS.has(toolName)) {\n    const command = toolInput?.command as string | undefined;\n    const cmdName = command?.split(/\\s+/)[0] ?? \"this command\";\n    const cwdLabel = cwd ? ` in ${cwd}` : \"\";\n    return permissionOptions(\n      `Yes, and don't ask again for \\`${cmdName}\\` commands${cwdLabel}`,\n    );\n  }\n\n  if (toolName === \"BashOutput\") {\n    return permissionOptions(\"Yes, allow all background process reads\");\n  }\n\n  if (toolName === \"KillShell\") {\n    return permissionOptions(\"Yes, allow killing processes\");\n  }\n\n  if (WRITE_TOOLS.has(toolName)) {\n    return permissionOptions(\"Yes, allow all edits during this session\");\n  }\n\n  if (READ_TOOLS.has(toolName)) {\n    return permissionOptions(\"Yes, allow all reads during this session\");\n  }\n\n  if (SEARCH_TOOLS.has(toolName)) {\n    return permissionOptions(\"Yes, allow all searches during this session\");\n  }\n\n  if (toolName === \"WebFetch\") {\n    const url = toolInput?.url as string | undefined;\n    let domain = \"\";\n    try {\n      domain = url ? new URL(url).hostname : \"\";\n    } catch {}\n    return permissionOptions(\n      domain\n        ? `Yes, allow all fetches from ${domain}`\n        : \"Yes, allow all fetches\",\n    );\n  }\n\n  if (toolName === \"WebSearch\") {\n    return permissionOptions(\"Yes, allow all web searches\");\n  }\n\n  if (toolName === \"Task\") {\n    return permissionOptions(\"Yes, allow all sub-tasks\");\n  }\n\n  if (toolName === \"TodoWrite\") {\n    return permissionOptions(\"Yes, allow all todo updates\");\n  }\n\n  return permissionOptions(\"Yes, always allow\");\n}\n\nexport function buildExitPlanModePermissionOptions(): PermissionOption[] {\n  return [\n    {\n      kind: \"allow_always\",\n      name: \"Yes, and auto-accept edits\",\n      optionId: \"acceptEdits\",\n    },\n    {\n      kind: \"allow_once\",\n      name: \"Yes, and manually approve edits\",\n      optionId: \"default\",\n    },\n    {\n      kind: \"reject_once\",\n      name: \"No, keep planning\",\n      optionId: \"plan\",\n    },\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/adapters/claude/questions/utils.d.ts

@@ -0,0 +1,132 @@
+import { ToolKind, ToolCallContent } from '@agentclientprotocol/sdk';
+import { z } from 'zod';
+import { PermissionOption } from '../permissions/permission-options.js';
+
+declare const OPTION_PREFIX = "option_";
+declare const QuestionOptionSchema: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    description?: string | undefined;
+}, {
+    label: string;
+    description?: string | undefined;
+}>;
+declare const QuestionItemSchema: z.ZodObject<{
+    question: z.ZodString;
+    header: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        description?: string | undefined;
+    }, {
+        label: string;
+        description?: string | undefined;
+    }>, "many">;
+    multiSelect: z.ZodOptional<z.ZodBoolean>;
+    completed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    options: {
+        label: string;
+        description?: string | undefined;
+    }[];
+    question: string;
+    completed?: boolean | undefined;
+    header?: string | undefined;
+    multiSelect?: boolean | undefined;
+}, {
+    options: {
+        label: string;
+        description?: string | undefined;
+    }[];
+    question: string;
+    completed?: boolean | undefined;
+    header?: string | undefined;
+    multiSelect?: boolean | undefined;
+}>;
+declare const QuestionMetaSchema: z.ZodObject<{
+    questions: z.ZodArray<z.ZodObject<{
+        question: z.ZodString;
+        header: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            description?: string | undefined;
+        }, {
+            label: string;
+            description?: string | undefined;
+        }>, "many">;
+        multiSelect: z.ZodOptional<z.ZodBoolean>;
+        completed: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        options: {
+            label: string;
+            description?: string | undefined;
+        }[];
+        question: string;
+        completed?: boolean | undefined;
+        header?: string | undefined;
+        multiSelect?: boolean | undefined;
+    }, {
+        options: {
+            label: string;
+            description?: string | undefined;
+        }[];
+        question: string;
+        completed?: boolean | undefined;
+        header?: string | undefined;
+        multiSelect?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    questions: {
+        options: {
+            label: string;
+            description?: string | undefined;
+        }[];
+        question: string;
+        completed?: boolean | undefined;
+        header?: string | undefined;
+        multiSelect?: boolean | undefined;
+    }[];
+}, {
+    questions: {
+        options: {
+            label: string;
+            description?: string | undefined;
+        }[];
+        question: string;
+        completed?: boolean | undefined;
+        header?: string | undefined;
+        multiSelect?: boolean | undefined;
+    }[];
+}>;
+type QuestionOption = z.infer<typeof QuestionOptionSchema>;
+type QuestionItem = z.infer<typeof QuestionItemSchema>;
+type QuestionMeta = z.infer<typeof QuestionMetaSchema>;
+interface AskUserQuestionInput {
+    questions?: QuestionItem[];
+    question?: string;
+    header?: string;
+    options?: QuestionOption[];
+    multiSelect?: boolean;
+}
+declare function normalizeAskUserQuestionInput(input: AskUserQuestionInput): QuestionItem[] | null;
+interface QuestionToolCallData {
+    toolCallId: string;
+    title: string;
+    kind: ToolKind;
+    content: ToolCallContent[];
+    _meta: {
+        twigToolKind: "question";
+        questions: QuestionItem[];
+    };
+}
+declare function buildQuestionToolCallData(questions: QuestionItem[]): QuestionToolCallData;
+declare function buildQuestionOptions(question: QuestionItem): PermissionOption[];
+
+export { type AskUserQuestionInput, OPTION_PREFIX, type QuestionItem, QuestionItemSchema, type QuestionMeta, QuestionMetaSchema, type QuestionOption, QuestionOptionSchema, buildQuestionOptions, buildQuestionToolCallData, normalizeAskUserQuestionInput };

package/dist/adapters/claude/questions/utils.js

@@ -0,0 +1,63 @@
+// src/adapters/claude/questions/utils.ts
+import { z } from "zod";
+var OPTION_PREFIX = "option_";
+var QuestionOptionSchema = z.object({
+  label: z.string(),
+  description: z.string().optional()
+});
+var QuestionItemSchema = z.object({
+  question: z.string(),
+  header: z.string().optional(),
+  options: z.array(QuestionOptionSchema),
+  multiSelect: z.boolean().optional(),
+  completed: z.boolean().optional()
+});
+var QuestionMetaSchema = z.object({
+  questions: z.array(QuestionItemSchema)
+});
+function normalizeAskUserQuestionInput(input) {
+  if (input.questions && input.questions.length > 0) {
+    return input.questions;
+  }
+  if (input.question) {
+    return [
+      {
+        question: input.question,
+        header: input.header,
+        options: input.options || [],
+        multiSelect: input.multiSelect
+      }
+    ];
+  }
+  return null;
+}
+function buildQuestionToolCallData(questions) {
+  return {
+    toolCallId: `question-${Date.now()}`,
+    title: questions[0]?.question ?? "Question",
+    kind: "other",
+    content: [],
+    _meta: {
+      twigToolKind: "question",
+      questions
+    }
+  };
+}
+function buildQuestionOptions(question) {
+  return question.options.map((opt, idx) => ({
+    kind: "allow_once",
+    name: opt.label,
+    optionId: `${OPTION_PREFIX}${idx}`,
+    _meta: opt.description ? { description: opt.description } : void 0
+  }));
+}
+export {
+  OPTION_PREFIX,
+  QuestionItemSchema,
+  QuestionMetaSchema,
+  QuestionOptionSchema,
+  buildQuestionOptions,
+  buildQuestionToolCallData,
+  normalizeAskUserQuestionInput
+};
+//# sourceMappingURL=utils.js.map

package/dist/adapters/claude/questions/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/adapters/claude/questions/utils.ts"],"sourcesContent":["import type { ToolCallContent, ToolKind } from \"@agentclientprotocol/sdk\";\nimport { z } from \"zod\";\nimport type { PermissionOption } from \"../permissions/permission-options.js\";\n\nexport const OPTION_PREFIX = \"option_\";\n\nexport const QuestionOptionSchema = z.object({\n  label: z.string(),\n  description: z.string().optional(),\n});\n\nexport const QuestionItemSchema = z.object({\n  question: z.string(),\n  header: z.string().optional(),\n  options: z.array(QuestionOptionSchema),\n  multiSelect: z.boolean().optional(),\n  completed: z.boolean().optional(),\n});\n\nexport const QuestionMetaSchema = z.object({\n  questions: z.array(QuestionItemSchema),\n});\n\nexport type QuestionOption = z.infer<typeof QuestionOptionSchema>;\nexport type QuestionItem = z.infer<typeof QuestionItemSchema>;\nexport type QuestionMeta = z.infer<typeof QuestionMetaSchema>;\n\nexport interface AskUserQuestionInput {\n  questions?: QuestionItem[];\n  question?: string;\n  header?: string;\n  options?: QuestionOption[];\n  multiSelect?: boolean;\n}\n\nexport function normalizeAskUserQuestionInput(\n  input: AskUserQuestionInput,\n): QuestionItem[] | null {\n  if (input.questions && input.questions.length > 0) {\n    return input.questions;\n  }\n\n  if (input.question) {\n    return [\n      {\n        question: input.question,\n        header: input.header,\n        options: input.options || [],\n        multiSelect: input.multiSelect,\n      },\n    ];\n  }\n\n  return null;\n}\n\ninterface QuestionToolCallData {\n  toolCallId: string;\n  title: string;\n  kind: ToolKind;\n  content: ToolCallContent[];\n  _meta: {\n    twigToolKind: \"question\";\n    questions: QuestionItem[];\n  };\n}\n\nexport function buildQuestionToolCallData(\n  questions: QuestionItem[],\n): QuestionToolCallData {\n  return {\n    toolCallId: `question-${Date.now()}`,\n    title: questions[0]?.question ?? \"Question\",\n    kind: \"other\",\n    content: [],\n    _meta: {\n      twigToolKind: \"question\",\n      questions,\n    },\n  };\n}\n\nexport function buildQuestionOptions(\n  question: QuestionItem,\n): PermissionOption[] {\n  return question.options.map((opt, idx) => ({\n    kind: \"allow_once\" as const,\n    name: opt.label,\n    optionId: `${OPTION_PREFIX}${idx}`,\n    _meta: opt.description ? { description: opt.description } : undefined,\n  }));\n}\n"],"mappings":";AACA,SAAS,SAAS;AAGX,IAAM,gBAAgB;AAEtB,IAAM,uBAAuB,EAAE,OAAO;AAAA,EAC3C,OAAO,EAAE,OAAO;AAAA,EAChB,aAAa,EAAE,OAAO,EAAE,SAAS;AACnC,CAAC;AAEM,IAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,UAAU,EAAE,OAAO;AAAA,EACnB,QAAQ,EAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,SAAS,EAAE,MAAM,oBAAoB;AAAA,EACrC,aAAa,EAAE,QAAQ,EAAE,SAAS;AAAA,EAClC,WAAW,EAAE,QAAQ,EAAE,SAAS;AAClC,CAAC;AAEM,IAAM,qBAAqB,EAAE,OAAO;AAAA,EACzC,WAAW,EAAE,MAAM,kBAAkB;AACvC,CAAC;AAcM,SAAS,8BACd,OACuB;AACvB,MAAI,MAAM,aAAa,MAAM,UAAU,SAAS,GAAG;AACjD,WAAO,MAAM;AAAA,EACf;AAEA,MAAI,MAAM,UAAU;AAClB,WAAO;AAAA,MACL;AAAA,QACE,UAAU,MAAM;AAAA,QAChB,QAAQ,MAAM;AAAA,QACd,SAAS,MAAM,WAAW,CAAC;AAAA,QAC3B,aAAa,MAAM;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAaO,SAAS,0BACd,WACsB;AACtB,SAAO;AAAA,IACL,YAAY,YAAY,KAAK,IAAI,CAAC;AAAA,IAClC,OAAO,UAAU,CAAC,GAAG,YAAY;AAAA,IACjC,MAAM;AAAA,IACN,SAAS,CAAC;AAAA,IACV,OAAO;AAAA,MACL,cAAc;AAAA,MACd;AAAA,IACF;AAAA,EACF;AACF;AAEO,SAAS,qBACd,UACoB;AACpB,SAAO,SAAS,QAAQ,IAAI,CAAC,KAAK,SAAS;AAAA,IACzC,MAAM;AAAA,IACN,MAAM,IAAI;AAAA,IACV,UAAU,GAAG,aAAa,GAAG,GAAG;AAAA,IAChC,OAAO,IAAI,cAAc,EAAE,aAAa,IAAI,YAAY,IAAI;AAAA,EAC9D,EAAE;AACJ;","names":[]}

package/dist/adapters/claude/tools.d.ts

@@ -0,0 +1,18 @@
+interface ModeInfo {
+    id: TwigExecutionMode;
+    name: string;
+    description: string;
+}
+declare const TWIG_EXECUTION_MODES: readonly ["default", "acceptEdits", "plan", "bypassPermissions"];
+type TwigExecutionMode = (typeof TWIG_EXECUTION_MODES)[number];
+declare function getAvailableModes(): ModeInfo[];
+
+declare const READ_TOOLS: Set<string>;
+declare const WRITE_TOOLS: Set<string>;
+declare const BASH_TOOLS: Set<string>;
+declare const SEARCH_TOOLS: Set<string>;
+declare const WEB_TOOLS: Set<string>;
+declare const AGENT_TOOLS: Set<string>;
+declare function isToolAllowedForMode(toolName: string, mode: TwigExecutionMode): boolean;
+
+export { AGENT_TOOLS, BASH_TOOLS, type ModeInfo, READ_TOOLS, SEARCH_TOOLS, TWIG_EXECUTION_MODES, type TwigExecutionMode, WEB_TOOLS, WRITE_TOOLS, getAvailableModes, isToolAllowedForMode };

package/dist/adapters/claude/tools.js

@@ -0,0 +1,95 @@
+// src/utils/common.ts
+var IS_ROOT = typeof process !== "undefined" && (process.geteuid?.() ?? process.getuid?.()) === 0;
+
+// src/execution-mode.ts
+var MODES = [
+  {
+    id: "default",
+    name: "Always Ask",
+    description: "Prompts for permission on first use of each tool"
+  },
+  {
+    id: "acceptEdits",
+    name: "Accept Edits",
+    description: "Automatically accepts file edit permissions for the session"
+  },
+  {
+    id: "plan",
+    name: "Plan Mode",
+    description: "Claude can analyze but not modify files or execute commands"
+  },
+  {
+    id: "bypassPermissions",
+    name: "Bypass Permissions",
+    description: "Skips all permission prompts"
+  }
+];
+var TWIG_EXECUTION_MODES = [
+  "default",
+  "acceptEdits",
+  "plan",
+  "bypassPermissions"
+];
+function getAvailableModes() {
+  return IS_ROOT ? MODES.filter((m) => m.id !== "bypassPermissions") : MODES;
+}
+
+// src/adapters/claude/mcp/tool-metadata.ts
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+var mcpToolMetadataCache = /* @__PURE__ */ new Map();
+function isMcpToolReadOnly(toolName) {
+  const metadata = mcpToolMetadataCache.get(toolName);
+  return metadata?.readOnly === true;
+}
+
+// src/adapters/claude/tools.ts
+var READ_TOOLS = /* @__PURE__ */ new Set(["Read", "NotebookRead"]);
+var WRITE_TOOLS = /* @__PURE__ */ new Set([
+  "Edit",
+  "Write",
+  "NotebookEdit"
+]);
+var BASH_TOOLS = /* @__PURE__ */ new Set([
+  "Bash",
+  "BashOutput",
+  "KillShell"
+]);
+var SEARCH_TOOLS = /* @__PURE__ */ new Set(["Glob", "Grep", "LS"]);
+var WEB_TOOLS = /* @__PURE__ */ new Set(["WebSearch", "WebFetch"]);
+var AGENT_TOOLS = /* @__PURE__ */ new Set(["Task", "TodoWrite"]);
+var BASE_ALLOWED_TOOLS = [
+  ...READ_TOOLS,
+  ...SEARCH_TOOLS,
+  ...WEB_TOOLS,
+  ...AGENT_TOOLS
+];
+var AUTO_ALLOWED_TOOLS = {
+  default: new Set(BASE_ALLOWED_TOOLS),
+  acceptEdits: /* @__PURE__ */ new Set([...BASE_ALLOWED_TOOLS, ...WRITE_TOOLS]),
+  plan: new Set(BASE_ALLOWED_TOOLS)
+};
+function isToolAllowedForMode(toolName, mode) {
+  if (mode === "bypassPermissions") {
+    return true;
+  }
+  if (AUTO_ALLOWED_TOOLS[mode]?.has(toolName) === true) {
+    return true;
+  }
+  if (isMcpToolReadOnly(toolName)) {
+    return true;
+  }
+  return false;
+}
+export {
+  AGENT_TOOLS,
+  BASH_TOOLS,
+  READ_TOOLS,
+  SEARCH_TOOLS,
+  TWIG_EXECUTION_MODES,
+  WEB_TOOLS,
+  WRITE_TOOLS,
+  getAvailableModes,
+  isToolAllowedForMode
+};
+//# sourceMappingURL=tools.js.map

package/dist/adapters/claude/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/common.ts","../../../src/execution-mode.ts","../../../src/adapters/claude/mcp/tool-metadata.ts","../../../src/adapters/claude/tools.ts"],"sourcesContent":["import type { Logger } from \"./logger.js\";\n\nexport const IS_ROOT =\n  typeof process !== \"undefined\" &&\n  (process.geteuid?.() ?? process.getuid?.()) === 0;\n\nexport function unreachable(value: never, logger: Logger): void {\n  let valueAsString: string;\n  try {\n    valueAsString = JSON.stringify(value);\n  } catch {\n    valueAsString = value;\n  }\n  logger.error(`Unexpected case: ${valueAsString}`);\n}\n","import { IS_ROOT } from \"./utils/common.js\";\n\nexport interface ModeInfo {\n  id: TwigExecutionMode;\n  name: string;\n  description: string;\n}\n\nconst MODES: ModeInfo[] = [\n  {\n    id: \"default\",\n    name: \"Always Ask\",\n    description: \"Prompts for permission on first use of each tool\",\n  },\n  {\n    id: \"acceptEdits\",\n    name: \"Accept Edits\",\n    description: \"Automatically accepts file edit permissions for the session\",\n  },\n  {\n    id: \"plan\",\n    name: \"Plan Mode\",\n    description: \"Claude can analyze but not modify files or execute commands\",\n  },\n  {\n    id: \"bypassPermissions\",\n    name: \"Bypass Permissions\",\n    description: \"Skips all permission prompts\",\n  },\n];\n\nexport const TWIG_EXECUTION_MODES = [\n  \"default\",\n  \"acceptEdits\",\n  \"plan\",\n  \"bypassPermissions\",\n] as const;\n\nexport type TwigExecutionMode = (typeof TWIG_EXECUTION_MODES)[number];\n\nexport function getAvailableModes(): ModeInfo[] {\n  return IS_ROOT ? MODES.filter((m) => m.id !== \"bypassPermissions\") : MODES;\n}\n","import type { McpServerConfig } from \"@anthropic-ai/claude-agent-sdk\";\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StreamableHTTPClientTransport } from \"@modelcontextprotocol/sdk/client/streamableHttp.js\";\nimport type { Tool } from \"@modelcontextprotocol/sdk/types.js\";\nimport { Logger } from \"../../../utils/logger.js\";\n\nexport interface McpToolMetadata {\n  readOnly: boolean;\n}\n\nconst mcpToolMetadataCache: Map<string, McpToolMetadata> = new Map();\n\nfunction buildToolKey(serverName: string, toolName: string): string {\n  return `mcp__${serverName}__${toolName}`;\n}\n\nfunction isHttpMcpServer(\n  config: McpServerConfig,\n): config is McpServerConfig & { type: \"http\"; url: string } {\n  return config.type === \"http\" && typeof (config as any).url === \"string\";\n}\n\nasync function fetchToolsFromHttpServer(\n  _serverName: string,\n  config: McpServerConfig & { type: \"http\"; url: string },\n): Promise<Tool[]> {\n  const transport = new StreamableHTTPClientTransport(new URL(config.url), {\n    requestInit: {\n      headers: (config as any).headers || {},\n    },\n  });\n\n  const client = new Client({\n    name: \"twig-metadata-fetcher\",\n    version: \"1.0.0\",\n  });\n\n  try {\n    await client.connect(transport);\n    const result = await client.listTools();\n    return result.tools;\n  } finally {\n    await client.close().catch(() => {});\n  }\n}\n\nfunction extractToolMetadata(tool: Tool): McpToolMetadata {\n  return {\n    readOnly: tool.annotations?.readOnlyHint === true,\n  };\n}\n\nexport async function fetchMcpToolMetadata(\n  mcpServers: Record<string, McpServerConfig>,\n  logger: Logger = new Logger({ debug: false, prefix: \"[McpToolMetadata]\" }),\n): Promise<void> {\n  const fetchPromises: Promise<void>[] = [];\n\n  for (const [serverName, config] of Object.entries(mcpServers)) {\n    if (!isHttpMcpServer(config)) {\n      continue;\n    }\n\n    const fetchPromise = fetchToolsFromHttpServer(serverName, config)\n      .then((tools) => {\n        const toolCount = tools.length;\n        const readOnlyCount = tools.filter(\n          (t) => t.annotations?.readOnlyHint === true,\n        ).length;\n\n        for (const tool of tools) {\n          const toolKey = buildToolKey(serverName, tool.name);\n          mcpToolMetadataCache.set(toolKey, extractToolMetadata(tool));\n        }\n\n        logger.info(\"Fetched MCP tool metadata\", {\n          serverName,\n          toolCount,\n          readOnlyCount,\n        });\n      })\n      .catch((error) => {\n        logger.error(\"Failed to fetch MCP tool metadata\", {\n          serverName,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      });\n\n    fetchPromises.push(fetchPromise);\n  }\n\n  await Promise.all(fetchPromises);\n}\n\nexport function isMcpToolReadOnly(toolName: string): boolean {\n  const metadata = mcpToolMetadataCache.get(toolName);\n  return metadata?.readOnly === true;\n}\n\nexport function clearMcpToolMetadataCache(): void {\n  mcpToolMetadataCache.clear();\n}\n","export {\n  getAvailableModes,\n  type ModeInfo,\n  TWIG_EXECUTION_MODES,\n  type TwigExecutionMode,\n} from \"../../execution-mode.js\";\n\nimport type { TwigExecutionMode } from \"../../execution-mode.js\";\nimport { isMcpToolReadOnly } from \"./mcp/tool-metadata.js\";\n\nexport const READ_TOOLS: Set<string> = new Set([\"Read\", \"NotebookRead\"]);\n\nexport const WRITE_TOOLS: Set<string> = new Set([\n  \"Edit\",\n  \"Write\",\n  \"NotebookEdit\",\n]);\n\nexport const BASH_TOOLS: Set<string> = new Set([\n  \"Bash\",\n  \"BashOutput\",\n  \"KillShell\",\n]);\n\nexport const SEARCH_TOOLS: Set<string> = new Set([\"Glob\", \"Grep\", \"LS\"]);\n\nexport const WEB_TOOLS: Set<string> = new Set([\"WebSearch\", \"WebFetch\"]);\n\nexport const AGENT_TOOLS: Set<string> = new Set([\"Task\", \"TodoWrite\"]);\n\nconst BASE_ALLOWED_TOOLS = [\n  ...READ_TOOLS,\n  ...SEARCH_TOOLS,\n  ...WEB_TOOLS,\n  ...AGENT_TOOLS,\n];\n\nconst AUTO_ALLOWED_TOOLS: Record<string, Set<string>> = {\n  default: new Set(BASE_ALLOWED_TOOLS),\n  acceptEdits: new Set([...BASE_ALLOWED_TOOLS, ...WRITE_TOOLS]),\n  plan: new Set(BASE_ALLOWED_TOOLS),\n};\n\nexport function isToolAllowedForMode(\n  toolName: string,\n  mode: TwigExecutionMode,\n): boolean {\n  if (mode === \"bypassPermissions\") {\n    return true;\n  }\n  if (AUTO_ALLOWED_TOOLS[mode]?.has(toolName) === true) {\n    return true;\n  }\n  if (isMcpToolReadOnly(toolName)) {\n    return true;\n  }\n  return false;\n}\n"],"mappings":";AAEO,IAAM,UACX,OAAO,YAAY,gBAClB,QAAQ,UAAU,KAAK,QAAQ,SAAS,OAAO;;;ACIlD,IAAM,QAAoB;AAAA,EACxB;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,IAAI;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA,EACf;AACF;AAEO,IAAM,uBAAuB;AAAA,EAClC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAIO,SAAS,oBAAgC;AAC9C,SAAO,UAAU,MAAM,OAAO,CAAC,MAAM,EAAE,OAAO,mBAAmB,IAAI;AACvE;;;ACzCA,SAAS,cAAc;AACvB,SAAS,qCAAqC;AAQ9C,IAAM,uBAAqD,oBAAI,IAAI;AAoF5D,SAAS,kBAAkB,UAA2B;AAC3D,QAAM,WAAW,qBAAqB,IAAI,QAAQ;AAClD,SAAO,UAAU,aAAa;AAChC;;;ACvFO,IAAM,aAA0B,oBAAI,IAAI,CAAC,QAAQ,cAAc,CAAC;AAEhE,IAAM,cAA2B,oBAAI,IAAI;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,aAA0B,oBAAI,IAAI;AAAA,EAC7C;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,IAAM,eAA4B,oBAAI,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC;AAEhE,IAAM,YAAyB,oBAAI,IAAI,CAAC,aAAa,UAAU,CAAC;AAEhE,IAAM,cAA2B,oBAAI,IAAI,CAAC,QAAQ,WAAW,CAAC;AAErE,IAAM,qBAAqB;AAAA,EACzB,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL;AAEA,IAAM,qBAAkD;AAAA,EACtD,SAAS,IAAI,IAAI,kBAAkB;AAAA,EACnC,aAAa,oBAAI,IAAI,CAAC,GAAG,oBAAoB,GAAG,WAAW,CAAC;AAAA,EAC5D,MAAM,IAAI,IAAI,kBAAkB;AAClC;AAEO,SAAS,qBACd,UACA,MACS;AACT,MAAI,SAAS,qBAAqB;AAChC,WAAO;AAAA,EACT;AACA,MAAI,mBAAmB,IAAI,GAAG,IAAI,QAAQ,MAAM,MAAM;AACpD,WAAO;AAAA,EACT;AACA,MAAI,kBAAkB,QAAQ,GAAG;AAC/B,WAAO;AAAA,EACT;AACA,SAAO;AACT;","names":[]}

package/dist/agent-DBQY1BfC.d.ts

@@ -0,0 +1,123 @@
+import { AgentSideConnection } from '@agentclientprotocol/sdk';
+import { StoredNotification, ProcessSpawnedCallback, AgentConfig, TaskExecutionOptions } from './types.js';
+import { L as Logger } from './logger-DDBiMOOD.js';
+import { PostHogAPIClient } from './posthog-api.js';
+
+interface OtelLogConfig {
+    /** PostHog ingest host, e.g., "https://us.i.posthog.com" */
+    posthogHost: string;
+    /** Project API key, e.g., "phc_xxx" */
+    apiKey: string;
+    /** Batch flush interval in ms (default: 500) */
+    flushIntervalMs?: number;
+    /** Override the logs endpoint path (default: /i/v1/agent-logs) */
+    logsPath?: string;
+}
+/**
+ * Session context for resource attributes.
+ * These are set once per OTEL logger instance and indexed via resource_fingerprint
+ */
+interface SessionContext {
+    /** Parent task grouping - all runs for a task share this */
+    taskId: string;
+    /** Primary conversation identifier - all events in a run share this */
+    runId: string;
+    /** Deployment environment - "local" for desktop, "cloud" for cloud sandbox */
+    deviceType?: "local" | "cloud";
+}
+declare class OtelLogWriter {
+    private loggerProvider;
+    private logger;
+    constructor(config: OtelLogConfig, sessionContext: SessionContext, _debugLogger?: Logger);
+    /**
+     * Emit an agent event to PostHog Logs via OTEL.
+     */
+    emit(entry: {
+        notification: StoredNotification;
+    }): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+
+interface SessionLogWriterOptions {
+    /** OTEL config for creating writers per session */
+    otelConfig?: OtelLogConfig;
+    /** PostHog API client for S3 log persistence */
+    posthogAPI?: PostHogAPIClient;
+    /** Logger instance */
+    logger?: Logger;
+}
+declare class SessionLogWriter {
+    private posthogAPI?;
+    private otelConfig?;
+    private pendingEntries;
+    private flushTimeouts;
+    private sessions;
+    private logger;
+    constructor(options?: SessionLogWriterOptions);
+    flushAll(): Promise<void>;
+    register(sessionId: string, context: SessionContext): void;
+    isRegistered(sessionId: string): boolean;
+    appendRawLine(sessionId: string, line: string): void;
+    flush(sessionId: string): Promise<void>;
+    private scheduleFlush;
+}
+
+type StreamPair = {
+    readable: globalThis.ReadableStream<Uint8Array>;
+    writable: globalThis.WritableStream<Uint8Array>;
+};
+
+interface CodexProcessOptions {
+    cwd?: string;
+    apiBaseUrl?: string;
+    apiKey?: string;
+    model?: string;
+    binaryPath?: string;
+    logger?: Logger;
+    processCallbacks?: ProcessSpawnedCallback;
+}
+
+type AgentAdapter = "claude" | "codex";
+type AcpConnectionConfig = {
+    adapter?: AgentAdapter;
+    logWriter?: SessionLogWriter;
+    taskRunId?: string;
+    taskId?: string;
+    /** Deployment environment - "local" for desktop, "cloud" for cloud sandbox */
+    deviceType?: "local" | "cloud";
+    logger?: Logger;
+    processCallbacks?: ProcessSpawnedCallback;
+    codexOptions?: CodexProcessOptions;
+    allowedModelIds?: Set<string>;
+};
+type AcpConnection = {
+    agentConnection?: AgentSideConnection;
+    clientStreams: StreamPair;
+    cleanup: () => Promise<void>;
+};
+type InProcessAcpConnection = AcpConnection;
+/**
+ * Creates an ACP connection with the specified agent framework.
+ *
+ * @param config - Configuration including framework selection
+ * @returns Connection with agent and client streams
+ */
+declare function createAcpConnection(config?: AcpConnectionConfig): AcpConnection;
+
+declare class Agent {
+    private posthogAPI?;
+    private logger;
+    private acpConnection?;
+    private taskRunId?;
+    private sessionLogWriter?;
+    debug: boolean;
+    constructor(config: AgentConfig);
+    private _configureLlmGateway;
+    run(taskId: string, taskRunId: string, options?: TaskExecutionOptions): Promise<InProcessAcpConnection>;
+    attachPullRequestToTask(taskId: string, prUrl: string, branchName?: string): Promise<void>;
+    flushAllLogs(): Promise<void>;
+    cleanup(): Promise<void>;
+}
+
+export { type AcpConnection as A, type CodexProcessOptions as C, type InProcessAcpConnection as I, type OtelLogConfig as O, type SessionContext as S, type AcpConnectionConfig as a, Agent as b, type AgentAdapter as c, OtelLogWriter as d, SessionLogWriter as e, type SessionLogWriterOptions as f, createAcpConnection as g };

package/dist/agent.d.ts

@@ -0,0 +1,5 @@
+export { b as Agent } from './agent-DBQY1BfC.js';
+import './types.js';
+import '@agentclientprotocol/sdk';
+import './logger-DDBiMOOD.js';
+import './posthog-api.js';