@agent-native/core 0.130.2 → 0.131.3

package/dist/agent/tool-search.d.ts

@@ -18,6 +18,10 @@ type ToolSearchResult = {
     source?: string;
     description: string;
     score: number;
+    /** Whether this result can be loaded and called in the current registry. */
+    callable: boolean;
+    /** How the action behaves while the agent is in Plan mode. */
+    planAvailability: "read" | "conditional" | "act-only";
     parameters: ToolParameterSummary[];
     inputSchema?: unknown;
 };

package/dist/agent/tool-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAKF,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC9C,OAAO,GAAE,iBAAsB,GAC9B,WAAW,CA8Bb;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrC,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM7B;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrC,IAAI,GAAE,cAAmB,EACzB,OAAO,GAAE,iBAAsB,GAC9B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B,CA0HA"}
+{"version":3,"file":"tool-search.d.ts","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,KAAK,cAAc,GAAG;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,QAAQ,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;IACtD,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAKF,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAC9C,OAAO,GAAE,iBAAsB,GAC9B,WAAW,CA8Bb;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrC,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAM7B;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACrC,IAAI,GAAE,cAAmB,EACzB,OAAO,GAAE,iBAAsB,GAC9B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B,CAkIA"}

package/dist/agent/tool-search.js

@@ -65,6 +65,8 @@ export function searchToolRegistry(registry, args = {}, options = {}) {
                 name,
                 kind: parseMcpToolName(name) ? "mcp" : "action",
                 score: 0,
+                callable: registry[name]?.allowInPlanMode !== false,
+                planAvailability: getPlanAvailability(name, registry[name]),
                 description: "Already returned by an earlier identical tool-search call.",
                 parameters: [],
             })),
@@ -86,6 +88,8 @@ export function searchToolRegistry(registry, args = {}, options = {}) {
         const parsedMcp = parseMcpToolName(name);
         const kind = parsedMcp ? "mcp" : "action";
         const source = parsedMcp?.serverId;
+        const callable = entry.allowInPlanMode !== false;
+        const planAvailability = getPlanAvailability(name, entry);
         if (listAll) {
             candidates.push({
                 name,
@@ -93,6 +97,8 @@ export function searchToolRegistry(registry, args = {}, options = {}) {
                 ...(source ? { source } : {}),
                 description: truncate(description, 140),
                 score: 0,
+                callable,
+                planAvailability,
                 parameters: [],
             });
             continue;
@@ -115,6 +121,8 @@ export function searchToolRegistry(registry, args = {}, options = {}) {
             ...(source ? { source } : {}),
             description,
             score,
+            callable,
+            planAvailability,
             parameters,
             ...(includeSchemas ? { inputSchema: entry.tool.parameters ?? {} } : {}),
         });
@@ -146,6 +154,28 @@ export function searchToolRegistry(registry, args = {}, options = {}) {
         rememberToolSearchResult(cacheKey, result);
     return result;
 }
+const PLAN_MODE_BLOCKED_DISCOVERY_TOOLS = new Set([
+    "refresh-screen",
+    "set-search-params",
+    "set-url-path",
+]);
+function getPlanAvailability(name, entry) {
+    if (!entry || entry.allowInPlanMode === false)
+        return "act-only";
+    if (PLAN_MODE_BLOCKED_DISCOVERY_TOOLS.has(name))
+        return "act-only";
+    if (name === "bash")
+        return "conditional";
+    if (typeof entry.planMode?.effect === "function")
+        return "conditional";
+    if (entry.planMode?.effect === "read")
+        return "read";
+    if (entry.planMode?.effect === "write" ||
+        entry.planMode?.effect === "unknown") {
+        return "act-only";
+    }
+    return entry.readOnly === true ? "read" : "act-only";
+}
 function normalizeToolSearchCacheKey(options) {
     return JSON.stringify({
         query: options.query.trim().toLowerCase(),

package/dist/agent/tool-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseMcpToolName } from \"../mcp-client/manager.js\";\nimport { isMcpToolAllowedForRequest } from \"../mcp-client/visibility.js\";\nimport { getRequestRunContext } from \"../server/request-context.js\";\nimport type { ActionEntry } from \"./production-agent.js\";\n\nexport const TOOL_SEARCH_ACTION_NAME = \"tool-search\";\n\ntype ToolSearchArgs = {\n  query?: unknown;\n  limit?: unknown;\n  includeSchemas?: unknown;\n};\n\ntype ToolParameterSummary = {\n  name: string;\n  type?: string;\n  required: boolean;\n  description?: string;\n  enum?: string[];\n};\n\ntype ToolSearchResult = {\n  name: string;\n  kind: \"action\" | \"mcp\";\n  source?: string;\n  description: string;\n  score: number;\n  parameters: ToolParameterSummary[];\n  inputSchema?: unknown;\n};\n\ntype ToolSearchOptions = {\n  defaultLimit?: number;\n  maxLimit?: number;\n};\n\nconst DEFAULT_LIMIT = 8;\nconst MAX_LIMIT = 25;\n\nexport function createToolSearchEntry(\n  getRegistry: () => Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): ActionEntry {\n  return {\n    tool: {\n      description:\n        \"Discover callable tools/actions, including connected MCP server tools named `mcp__<server>__<tool>`. Call it with NO query to list every available tool by name with a one-line description (cheap — no input schemas); names from that menu are not loaded for calling yet, so call tool-search again with a specific query for the tool/capability before invoking it. Use this whenever you need a capability but aren't sure which tool to call — most tools are not loaded into context up front, so this is how you find and then call them.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          query: {\n            type: \"string\",\n            description:\n              \"What capability to find, e.g. `send slack message`, `create calendar event`, `zapier gmail`, or `browser screenshot`. Omit to list every available tool name (the full menu) with one-line descriptions; then call tool-search again with a specific query before calling a tool from that menu.\",\n          },\n          limit: {\n            type: \"number\",\n            description: `Maximum results to return for a query. Defaults to ${options.defaultLimit ?? DEFAULT_LIMIT}. Ignored when listing the full menu (no query).`,\n          },\n          includeSchemas: {\n            type: \"boolean\",\n            description:\n              \"When true, include each matching tool's full input schema. Default false.\",\n          },\n        },\n      },\n    },\n    http: false,\n    readOnly: true,\n    run: async (args: Record<string, string>) =>\n      searchToolRegistry(getRegistry(), args, options),\n  };\n}\n\nexport function attachToolSearch(\n  registry: Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): Record<string, ActionEntry> {\n  registry[TOOL_SEARCH_ACTION_NAME] = createToolSearchEntry(\n    () => registry,\n    options,\n  );\n  return registry;\n}\n\nexport function searchToolRegistry(\n  registry: Record<string, ActionEntry>,\n  args: ToolSearchArgs = {},\n  options: ToolSearchOptions = {},\n): {\n  query: string;\n  totalTools: number;\n  count: number;\n  repeated?: boolean;\n  message?: string;\n  results: ToolSearchResult[];\n} {\n  const query = String(args.query ?? \"\").trim();\n  // No query → \"menu\" mode: list every available tool by name + a terse\n  // description, with no parameter summaries or input schemas. This is the\n  // cheap, non-opaque counterpart to the compact catalog: the agent can see\n  // the full set of tools for a small token cost, then search/load the few it\n  // actually needs. A query switches to ranked search with parameter details.\n  const listAll = query.length === 0;\n  const includeSchemas = !listAll && parseBoolean(args.includeSchemas);\n  const limit = parseLimit(\n    args.limit,\n    options.defaultLimit ?? DEFAULT_LIMIT,\n    options.maxLimit ?? MAX_LIMIT,\n  );\n  const cacheKey = normalizeToolSearchCacheKey({\n    query,\n    limit,\n    includeSchemas,\n  });\n  const runCtx = getRequestRunContext();\n  const priorSearch = includeSchemas\n    ? undefined\n    : runCtx?.toolSearchReads?.[cacheKey];\n  if (priorSearch) {\n    return {\n      query,\n      totalTools: priorSearch.totalTools,\n      count: priorSearch.resultNames.length,\n      repeated: true,\n      message:\n        \"This exact tool-search query already ran in this agent run. Use the previously returned schemas/details instead of searching again.\",\n      results: priorSearch.resultNames.map((name) => ({\n        name,\n        kind: parseMcpToolName(name) ? (\"mcp\" as const) : (\"action\" as const),\n        score: 0,\n        description:\n          \"Already returned by an earlier identical tool-search call.\",\n        parameters: [],\n      })),\n    };\n  }\n  const queryTokens = tokenize(query);\n\n  const candidates: ToolSearchResult[] = [];\n  let totalTools = 0;\n\n  for (const [name, entry] of Object.entries(registry)) {\n    if (!entry?.tool || name === TOOL_SEARCH_ACTION_NAME) continue;\n    if (entry.agentTool === false) continue;\n    if (name.startsWith(\"mcp__\") && !isMcpToolAllowedForRequest(name)) {\n      continue;\n    }\n\n    totalTools++;\n    const description = normalizeWhitespace(entry.tool.description ?? \"\");\n    const parsedMcp = parseMcpToolName(name);\n    const kind = parsedMcp ? \"mcp\" : \"action\";\n    const source = parsedMcp?.serverId;\n\n    if (listAll) {\n      candidates.push({\n        name,\n        kind,\n        ...(source ? { source } : {}),\n        description: truncate(description, 140),\n        score: 0,\n        parameters: [],\n      });\n      continue;\n    }\n\n    const parameters = summarizeParameters(entry.tool.parameters);\n    const score = scoreTool({\n      query,\n      queryTokens,\n      name,\n      source,\n      description,\n      parameters,\n      kind,\n    });\n\n    if (score <= 0) continue;\n\n    candidates.push({\n      name,\n      kind,\n      ...(source ? { source } : {}),\n      description,\n      score,\n      parameters,\n      ...(includeSchemas ? { inputSchema: entry.tool.parameters ?? {} } : {}),\n    });\n  }\n\n  if (listAll) {\n    candidates.sort((a, b) => a.name.localeCompare(b.name));\n    const result = {\n      query,\n      totalTools,\n      count: candidates.length,\n      message:\n        'Menu mode lists tool names only; it does not load schemas for calling. Before invoking a tool found here, call tool-search again with a specific query such as the tool name or capability (for example, { \"query\": \"hubspot-deals\" }).',\n      results: candidates,\n    };\n    rememberToolSearchResult(cacheKey, result);\n    return result;\n  }\n\n  candidates.sort((a, b) => {\n    if (b.score !== a.score) return b.score - a.score;\n    return a.name.localeCompare(b.name);\n  });\n\n  const result = {\n    query,\n    totalTools,\n    count: Math.min(candidates.length, limit),\n    results: candidates.slice(0, limit),\n  };\n  if (!includeSchemas) rememberToolSearchResult(cacheKey, result);\n  return result;\n}\n\nfunction normalizeToolSearchCacheKey(options: {\n  query: string;\n  limit: number;\n  includeSchemas: boolean;\n}): string {\n  return JSON.stringify({\n    query: options.query.trim().toLowerCase(),\n    limit: options.limit,\n    includeSchemas: options.includeSchemas,\n  });\n}\n\nfunction rememberToolSearchResult(\n  cacheKey: string,\n  result: { totalTools: number; results: Array<{ name: string }> },\n) {\n  const runCtx = getRequestRunContext();\n  if (!runCtx) return;\n  const reads = (runCtx.toolSearchReads ??= {});\n  reads[cacheKey] = {\n    totalTools: result.totalTools,\n    resultNames: result.results.map((item) => item.name),\n  };\n}\n\nfunction truncate(value: string, max: number): string {\n  if (value.length <= max) return value;\n  return `${value.slice(0, max - 1).trimEnd()}…`;\n}\n\nfunction parseLimit(value: unknown, fallback: number, max: number): number {\n  const n =\n    typeof value === \"number\"\n      ? value\n      : typeof value === \"string\" && value.trim()\n        ? Number(value)\n        : fallback;\n  if (!Number.isFinite(n) || n <= 0) return fallback;\n  return Math.max(1, Math.min(max, Math.floor(n)));\n}\n\nfunction parseBoolean(value: unknown): boolean {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value !== \"string\") return false;\n  const normalized = value.trim().toLowerCase();\n  return normalized === \"true\" || normalized === \"1\" || normalized === \"yes\";\n}\n\nfunction summarizeParameters(schema: unknown): ToolParameterSummary[] {\n  if (!schema || typeof schema !== \"object\") return [];\n  const obj = schema as {\n    properties?: Record<string, unknown>;\n    required?: unknown;\n  };\n  const properties = obj.properties;\n  if (!properties || typeof properties !== \"object\") return [];\n  const required = new Set(\n    Array.isArray(obj.required)\n      ? obj.required.filter(\n          (value): value is string => typeof value === \"string\",\n        )\n      : [],\n  );\n\n  return Object.entries(properties).map(([name, raw]) => {\n    const prop =\n      raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n    const enumValues = Array.isArray(prop.enum)\n      ? prop.enum.map((value) => String(value)).slice(0, 20)\n      : undefined;\n    return {\n      name,\n      type: summarizeType(prop.type),\n      required: required.has(name),\n      description:\n        typeof prop.description === \"string\"\n          ? normalizeWhitespace(prop.description)\n          : undefined,\n      ...(enumValues && enumValues.length > 0 ? { enum: enumValues } : {}),\n    };\n  });\n}\n\nfunction summarizeType(value: unknown): string | undefined {\n  if (typeof value === \"string\") return value;\n  if (Array.isArray(value)) {\n    const parts = value.filter((v): v is string => typeof v === \"string\");\n    return parts.length > 0 ? parts.join(\" | \") : undefined;\n  }\n  return undefined;\n}\n\nfunction scoreTool(input: {\n  query: string;\n  queryTokens: string[];\n  name: string;\n  source?: string;\n  description: string;\n  parameters: ToolParameterSummary[];\n  kind: \"action\" | \"mcp\";\n}): number {\n  if (input.queryTokens.length === 0) return 1;\n\n  const name = searchableText(input.name);\n  const source = searchableText(input.source ?? \"\");\n  const description = searchableText(input.description);\n  const params = searchableText(\n    input.parameters\n      .map((p) => `${p.name} ${p.type ?? \"\"} ${p.description ?? \"\"}`)\n      .join(\" \"),\n  );\n  const all = `${name} ${source} ${description} ${params} ${input.kind}`;\n  const phrase = searchableText(input.query);\n\n  let score = 0;\n  if (name.includes(phrase)) score += 14;\n  if (source && source.includes(phrase)) score += 10;\n  if (description.includes(phrase)) score += 8;\n  if (params.includes(phrase)) score += 5;\n\n  for (const token of input.queryTokens) {\n    if (name.split(\" \").includes(token)) score += 9;\n    else if (name.includes(token)) score += 6;\n\n    if (source) {\n      if (source.split(\" \").includes(token)) score += 6;\n      else if (source.includes(token)) score += 3;\n    }\n\n    if (description.includes(token)) score += 3;\n    if (params.includes(token)) score += 2;\n    if (all.includes(token)) score += 1;\n  }\n\n  return score;\n}\n\nfunction tokenize(value: string): string[] {\n  const seen = new Set<string>();\n  for (const token of searchableText(value).split(\" \")) {\n    if (token.length > 0) seen.add(token);\n  }\n  return Array.from(seen);\n}\n\nfunction searchableText(value: string): string {\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .trim();\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/g, \" \").trim();\n}\n"]}
+{"version":3,"file":"tool-search.js","sourceRoot":"","sources":["../../src/agent/tool-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AAmCrD,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,MAAM,UAAU,qBAAqB,CACnC,WAA8C,EAC9C,OAAO,GAAsB,EAAE;IAE/B,OAAO;QACL,IAAI,EAAE;YACJ,WAAW,EACT,ohBAAohB;YACthB,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,kSAAkS;qBACrS;oBACD,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,sDAAsD,OAAO,CAAC,YAAY,IAAI,aAAa,kDAAkD;qBAC3J;oBACD,cAAc,EAAE;wBACd,IAAI,EAAE,SAAS;wBACf,WAAW,EACT,2EAA2E;qBAC9E;iBACF;aACF;SACF;QACD,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,KAAK,EAAE,IAA4B,EAAE,EAAE,CAC1C,kBAAkB,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAqC,EACrC,OAAO,GAAsB,EAAE;IAE/B,QAAQ,CAAC,uBAAuB,CAAC,GAAG,qBAAqB,CACvD,GAAG,EAAE,CAAC,QAAQ,EACd,OAAO,CACR,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAqC,EACrC,IAAI,GAAmB,EAAE,EACzB,OAAO,GAAsB,EAAE;IAS/B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,sEAAsE;IACtE,yEAAyE;IACzE,0EAA0E;IAC1E,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACnC,MAAM,cAAc,GAAG,CAAC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,UAAU,CACtB,IAAI,CAAC,KAAK,EACV,OAAO,CAAC,YAAY,IAAI,aAAa,EACrC,OAAO,CAAC,QAAQ,IAAI,SAAS,CAC9B,CAAC;IACF,MAAM,QAAQ,GAAG,2BAA2B,CAAC;QAC3C,KAAK;QACL,KAAK;QACL,cAAc;KACf,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,cAAc;QAChC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO;YACL,KAAK;YACL,UAAU,EAAE,WAAW,CAAC,UAAU;YAClC,KAAK,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM;YACrC,QAAQ,EAAE,IAAI;YACd,OAAO,EACL,qIAAqI;YACvI,OAAO,EAAE,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI;gBACJ,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,KAAe,CAAC,CAAC,CAAE,QAAkB;gBACrE,KAAK,EAAE,CAAC;gBACR,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,KAAK,KAAK;gBACnD,gBAAgB,EAAE,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC3D,WAAW,EACT,4DAA4D;gBAC9D,UAAU,EAAE,EAAE;aACf,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpC,MAAM,UAAU,GAAuB,EAAE,CAAC;IAC1C,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,IAAI,KAAK,uBAAuB;YAAE,SAAS;QAC/D,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK;YAAE,SAAS;QACxC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC;YAClE,SAAS;QACX,CAAC;QAED,UAAU,EAAE,CAAC;QACb,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1C,MAAM,MAAM,GAAG,SAAS,EAAE,QAAQ,CAAC;QACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC;QACjD,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE1D,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI;gBACJ,IAAI;gBACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC;gBACvC,KAAK,EAAE,CAAC;gBACR,QAAQ;gBACR,gBAAgB;gBAChB,UAAU,EAAE,EAAE;aACf,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,SAAS,CAAC;YACtB,KAAK;YACL,WAAW;YACX,IAAI;YACJ,MAAM;YACN,WAAW;YACX,UAAU;YACV,IAAI;SACL,CAAC,CAAC;QAEH,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QAEzB,UAAU,CAAC,IAAI,CAAC;YACd,IAAI;YACJ,IAAI;YACJ,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,WAAW;YACX,KAAK;YACL,QAAQ;YACR,gBAAgB;YAChB,UAAU;YACV,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,MAAM,MAAM,GAAG;YACb,KAAK;YACL,UAAU;YACV,KAAK,EAAE,UAAU,CAAC,MAAM;YACxB,OAAO,EACL,yOAAyO;YAC3O,OAAO,EAAE,UAAU;SACpB,CAAC;QACF,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACvB,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;YAAE,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAClD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG;QACb,KAAK;QACL,UAAU;QACV,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC;QACzC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;KACpC,CAAC;IACF,IAAI,CAAC,cAAc;QAAE,wBAAwB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,iCAAiC,GAAG,IAAI,GAAG,CAAC;IAChD,gBAAgB;IAChB,mBAAmB;IACnB,cAAc;CACf,CAAC,CAAC;AAEH,SAAS,mBAAmB,CAC1B,IAAY,EACZ,KAA8B;IAE9B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,eAAe,KAAK,KAAK;QAAE,OAAO,UAAU,CAAC;IACjE,IAAI,iCAAiC,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,UAAU,CAAC;IACnE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,aAAa,CAAC;IAC1C,IAAI,OAAO,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,UAAU;QAAE,OAAO,aAAa,CAAC;IACvE,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACrD,IACE,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO;QAClC,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,SAAS,EACpC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;AACvD,CAAC;AAED,SAAS,2BAA2B,CAAC,OAIpC;IACC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;QACzC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAC/B,QAAgB,EAChB,MAAgE;IAEhE,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;IAC9C,KAAK,CAAC,QAAQ,CAAC,GAAG;QAChB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa,EAAE,GAAW;IAC1C,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AACjD,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,QAAgB,EAAE,GAAW;IAC/D,MAAM,CAAC,GACL,OAAO,KAAK,KAAK,QAAQ;QACvB,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;YACzC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;YACf,CAAC,CAAC,QAAQ,CAAC;IACjB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,KAAK,CAAC;AAC7E,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAe;IAC1C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,MAGX,CAAC;IACF,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;IAClC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CACjB,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CACtD;QACH,CAAC,CAAC,EAAE,CACP,CAAC;IAEF,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE;QACpD,MAAM,IAAI,GACR,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAE,GAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACzC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACtD,CAAC,CAAC,SAAS,CAAC;QACd,OAAO;YACL,IAAI;YACJ,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAC5B,WAAW,EACT,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;gBAClC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC;gBACvC,CAAC,CAAC,SAAS;YACf,GAAG,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrE,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,KAQlB;IACC,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,cAAc,CAC3B,KAAK,CAAC,UAAU;SACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;SAC9D,IAAI,CAAC,GAAG,CAAC,CACb,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,MAAM,IAAI,WAAW,IAAI,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;IACvE,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAE3C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,IAAI,EAAE,CAAC;IACvC,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,IAAI,EAAE,CAAC;IACnD,IAAI,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;aAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAE1C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;iBAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QACvC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC","sourcesContent":["import { parseMcpToolName } from \"../mcp-client/manager.js\";\nimport { isMcpToolAllowedForRequest } from \"../mcp-client/visibility.js\";\nimport { getRequestRunContext } from \"../server/request-context.js\";\nimport type { ActionEntry } from \"./production-agent.js\";\n\nexport const TOOL_SEARCH_ACTION_NAME = \"tool-search\";\n\ntype ToolSearchArgs = {\n  query?: unknown;\n  limit?: unknown;\n  includeSchemas?: unknown;\n};\n\ntype ToolParameterSummary = {\n  name: string;\n  type?: string;\n  required: boolean;\n  description?: string;\n  enum?: string[];\n};\n\ntype ToolSearchResult = {\n  name: string;\n  kind: \"action\" | \"mcp\";\n  source?: string;\n  description: string;\n  score: number;\n  /** Whether this result can be loaded and called in the current registry. */\n  callable: boolean;\n  /** How the action behaves while the agent is in Plan mode. */\n  planAvailability: \"read\" | \"conditional\" | \"act-only\";\n  parameters: ToolParameterSummary[];\n  inputSchema?: unknown;\n};\n\ntype ToolSearchOptions = {\n  defaultLimit?: number;\n  maxLimit?: number;\n};\n\nconst DEFAULT_LIMIT = 8;\nconst MAX_LIMIT = 25;\n\nexport function createToolSearchEntry(\n  getRegistry: () => Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): ActionEntry {\n  return {\n    tool: {\n      description:\n        \"Discover callable tools/actions, including connected MCP server tools named `mcp__<server>__<tool>`. Call it with NO query to list every available tool by name with a one-line description (cheap — no input schemas); names from that menu are not loaded for calling yet, so call tool-search again with a specific query for the tool/capability before invoking it. Use this whenever you need a capability but aren't sure which tool to call — most tools are not loaded into context up front, so this is how you find and then call them.\",\n      parameters: {\n        type: \"object\",\n        properties: {\n          query: {\n            type: \"string\",\n            description:\n              \"What capability to find, e.g. `send slack message`, `create calendar event`, `zapier gmail`, or `browser screenshot`. Omit to list every available tool name (the full menu) with one-line descriptions; then call tool-search again with a specific query before calling a tool from that menu.\",\n          },\n          limit: {\n            type: \"number\",\n            description: `Maximum results to return for a query. Defaults to ${options.defaultLimit ?? DEFAULT_LIMIT}. Ignored when listing the full menu (no query).`,\n          },\n          includeSchemas: {\n            type: \"boolean\",\n            description:\n              \"When true, include each matching tool's full input schema. Default false.\",\n          },\n        },\n      },\n    },\n    http: false,\n    readOnly: true,\n    run: async (args: Record<string, string>) =>\n      searchToolRegistry(getRegistry(), args, options),\n  };\n}\n\nexport function attachToolSearch(\n  registry: Record<string, ActionEntry>,\n  options: ToolSearchOptions = {},\n): Record<string, ActionEntry> {\n  registry[TOOL_SEARCH_ACTION_NAME] = createToolSearchEntry(\n    () => registry,\n    options,\n  );\n  return registry;\n}\n\nexport function searchToolRegistry(\n  registry: Record<string, ActionEntry>,\n  args: ToolSearchArgs = {},\n  options: ToolSearchOptions = {},\n): {\n  query: string;\n  totalTools: number;\n  count: number;\n  repeated?: boolean;\n  message?: string;\n  results: ToolSearchResult[];\n} {\n  const query = String(args.query ?? \"\").trim();\n  // No query → \"menu\" mode: list every available tool by name + a terse\n  // description, with no parameter summaries or input schemas. This is the\n  // cheap, non-opaque counterpart to the compact catalog: the agent can see\n  // the full set of tools for a small token cost, then search/load the few it\n  // actually needs. A query switches to ranked search with parameter details.\n  const listAll = query.length === 0;\n  const includeSchemas = !listAll && parseBoolean(args.includeSchemas);\n  const limit = parseLimit(\n    args.limit,\n    options.defaultLimit ?? DEFAULT_LIMIT,\n    options.maxLimit ?? MAX_LIMIT,\n  );\n  const cacheKey = normalizeToolSearchCacheKey({\n    query,\n    limit,\n    includeSchemas,\n  });\n  const runCtx = getRequestRunContext();\n  const priorSearch = includeSchemas\n    ? undefined\n    : runCtx?.toolSearchReads?.[cacheKey];\n  if (priorSearch) {\n    return {\n      query,\n      totalTools: priorSearch.totalTools,\n      count: priorSearch.resultNames.length,\n      repeated: true,\n      message:\n        \"This exact tool-search query already ran in this agent run. Use the previously returned schemas/details instead of searching again.\",\n      results: priorSearch.resultNames.map((name) => ({\n        name,\n        kind: parseMcpToolName(name) ? (\"mcp\" as const) : (\"action\" as const),\n        score: 0,\n        callable: registry[name]?.allowInPlanMode !== false,\n        planAvailability: getPlanAvailability(name, registry[name]),\n        description:\n          \"Already returned by an earlier identical tool-search call.\",\n        parameters: [],\n      })),\n    };\n  }\n  const queryTokens = tokenize(query);\n\n  const candidates: ToolSearchResult[] = [];\n  let totalTools = 0;\n\n  for (const [name, entry] of Object.entries(registry)) {\n    if (!entry?.tool || name === TOOL_SEARCH_ACTION_NAME) continue;\n    if (entry.agentTool === false) continue;\n    if (name.startsWith(\"mcp__\") && !isMcpToolAllowedForRequest(name)) {\n      continue;\n    }\n\n    totalTools++;\n    const description = normalizeWhitespace(entry.tool.description ?? \"\");\n    const parsedMcp = parseMcpToolName(name);\n    const kind = parsedMcp ? \"mcp\" : \"action\";\n    const source = parsedMcp?.serverId;\n    const callable = entry.allowInPlanMode !== false;\n    const planAvailability = getPlanAvailability(name, entry);\n\n    if (listAll) {\n      candidates.push({\n        name,\n        kind,\n        ...(source ? { source } : {}),\n        description: truncate(description, 140),\n        score: 0,\n        callable,\n        planAvailability,\n        parameters: [],\n      });\n      continue;\n    }\n\n    const parameters = summarizeParameters(entry.tool.parameters);\n    const score = scoreTool({\n      query,\n      queryTokens,\n      name,\n      source,\n      description,\n      parameters,\n      kind,\n    });\n\n    if (score <= 0) continue;\n\n    candidates.push({\n      name,\n      kind,\n      ...(source ? { source } : {}),\n      description,\n      score,\n      callable,\n      planAvailability,\n      parameters,\n      ...(includeSchemas ? { inputSchema: entry.tool.parameters ?? {} } : {}),\n    });\n  }\n\n  if (listAll) {\n    candidates.sort((a, b) => a.name.localeCompare(b.name));\n    const result = {\n      query,\n      totalTools,\n      count: candidates.length,\n      message:\n        'Menu mode lists tool names only; it does not load schemas for calling. Before invoking a tool found here, call tool-search again with a specific query such as the tool name or capability (for example, { \"query\": \"hubspot-deals\" }).',\n      results: candidates,\n    };\n    rememberToolSearchResult(cacheKey, result);\n    return result;\n  }\n\n  candidates.sort((a, b) => {\n    if (b.score !== a.score) return b.score - a.score;\n    return a.name.localeCompare(b.name);\n  });\n\n  const result = {\n    query,\n    totalTools,\n    count: Math.min(candidates.length, limit),\n    results: candidates.slice(0, limit),\n  };\n  if (!includeSchemas) rememberToolSearchResult(cacheKey, result);\n  return result;\n}\n\nconst PLAN_MODE_BLOCKED_DISCOVERY_TOOLS = new Set([\n  \"refresh-screen\",\n  \"set-search-params\",\n  \"set-url-path\",\n]);\n\nfunction getPlanAvailability(\n  name: string,\n  entry: ActionEntry | undefined,\n): ToolSearchResult[\"planAvailability\"] {\n  if (!entry || entry.allowInPlanMode === false) return \"act-only\";\n  if (PLAN_MODE_BLOCKED_DISCOVERY_TOOLS.has(name)) return \"act-only\";\n  if (name === \"bash\") return \"conditional\";\n  if (typeof entry.planMode?.effect === \"function\") return \"conditional\";\n  if (entry.planMode?.effect === \"read\") return \"read\";\n  if (\n    entry.planMode?.effect === \"write\" ||\n    entry.planMode?.effect === \"unknown\"\n  ) {\n    return \"act-only\";\n  }\n  return entry.readOnly === true ? \"read\" : \"act-only\";\n}\n\nfunction normalizeToolSearchCacheKey(options: {\n  query: string;\n  limit: number;\n  includeSchemas: boolean;\n}): string {\n  return JSON.stringify({\n    query: options.query.trim().toLowerCase(),\n    limit: options.limit,\n    includeSchemas: options.includeSchemas,\n  });\n}\n\nfunction rememberToolSearchResult(\n  cacheKey: string,\n  result: { totalTools: number; results: Array<{ name: string }> },\n) {\n  const runCtx = getRequestRunContext();\n  if (!runCtx) return;\n  const reads = (runCtx.toolSearchReads ??= {});\n  reads[cacheKey] = {\n    totalTools: result.totalTools,\n    resultNames: result.results.map((item) => item.name),\n  };\n}\n\nfunction truncate(value: string, max: number): string {\n  if (value.length <= max) return value;\n  return `${value.slice(0, max - 1).trimEnd()}…`;\n}\n\nfunction parseLimit(value: unknown, fallback: number, max: number): number {\n  const n =\n    typeof value === \"number\"\n      ? value\n      : typeof value === \"string\" && value.trim()\n        ? Number(value)\n        : fallback;\n  if (!Number.isFinite(n) || n <= 0) return fallback;\n  return Math.max(1, Math.min(max, Math.floor(n)));\n}\n\nfunction parseBoolean(value: unknown): boolean {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value !== \"string\") return false;\n  const normalized = value.trim().toLowerCase();\n  return normalized === \"true\" || normalized === \"1\" || normalized === \"yes\";\n}\n\nfunction summarizeParameters(schema: unknown): ToolParameterSummary[] {\n  if (!schema || typeof schema !== \"object\") return [];\n  const obj = schema as {\n    properties?: Record<string, unknown>;\n    required?: unknown;\n  };\n  const properties = obj.properties;\n  if (!properties || typeof properties !== \"object\") return [];\n  const required = new Set(\n    Array.isArray(obj.required)\n      ? obj.required.filter(\n          (value): value is string => typeof value === \"string\",\n        )\n      : [],\n  );\n\n  return Object.entries(properties).map(([name, raw]) => {\n    const prop =\n      raw && typeof raw === \"object\" ? (raw as Record<string, unknown>) : {};\n    const enumValues = Array.isArray(prop.enum)\n      ? prop.enum.map((value) => String(value)).slice(0, 20)\n      : undefined;\n    return {\n      name,\n      type: summarizeType(prop.type),\n      required: required.has(name),\n      description:\n        typeof prop.description === \"string\"\n          ? normalizeWhitespace(prop.description)\n          : undefined,\n      ...(enumValues && enumValues.length > 0 ? { enum: enumValues } : {}),\n    };\n  });\n}\n\nfunction summarizeType(value: unknown): string | undefined {\n  if (typeof value === \"string\") return value;\n  if (Array.isArray(value)) {\n    const parts = value.filter((v): v is string => typeof v === \"string\");\n    return parts.length > 0 ? parts.join(\" | \") : undefined;\n  }\n  return undefined;\n}\n\nfunction scoreTool(input: {\n  query: string;\n  queryTokens: string[];\n  name: string;\n  source?: string;\n  description: string;\n  parameters: ToolParameterSummary[];\n  kind: \"action\" | \"mcp\";\n}): number {\n  if (input.queryTokens.length === 0) return 1;\n\n  const name = searchableText(input.name);\n  const source = searchableText(input.source ?? \"\");\n  const description = searchableText(input.description);\n  const params = searchableText(\n    input.parameters\n      .map((p) => `${p.name} ${p.type ?? \"\"} ${p.description ?? \"\"}`)\n      .join(\" \"),\n  );\n  const all = `${name} ${source} ${description} ${params} ${input.kind}`;\n  const phrase = searchableText(input.query);\n\n  let score = 0;\n  if (name.includes(phrase)) score += 14;\n  if (source && source.includes(phrase)) score += 10;\n  if (description.includes(phrase)) score += 8;\n  if (params.includes(phrase)) score += 5;\n\n  for (const token of input.queryTokens) {\n    if (name.split(\" \").includes(token)) score += 9;\n    else if (name.includes(token)) score += 6;\n\n    if (source) {\n      if (source.split(\" \").includes(token)) score += 6;\n      else if (source.includes(token)) score += 3;\n    }\n\n    if (description.includes(token)) score += 3;\n    if (params.includes(token)) score += 2;\n    if (all.includes(token)) score += 1;\n  }\n\n  return score;\n}\n\nfunction tokenize(value: string): string[] {\n  const seen = new Set<string>();\n  for (const token of searchableText(value).split(\" \")) {\n    if (token.length > 0) seen.add(token);\n  }\n  return Array.from(seen);\n}\n\nfunction searchableText(value: string): string {\n  return value\n    .replace(/([a-z0-9])([A-Z])/g, \"$1 $2\")\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \" \")\n    .trim();\n}\n\nfunction normalizeWhitespace(value: string): string {\n  return value.replace(/\\s+/g, \" \").trim();\n}\n"]}

package/dist/automations/service.d.ts

@@ -0,0 +1,85 @@
+import { type JobFrontmatter } from "../jobs/frontmatter.js";
+import { type Resource } from "../resources/store.js";
+export type AutomationScope = "personal" | "organization";
+export interface AutomationActor {
+    userEmail: string;
+    orgId?: string | null;
+}
+export interface AutomationDefinition {
+    resource: Resource;
+    name: string;
+    scope: AutomationScope;
+    meta: JobFrontmatter & {
+        triggerType: "schedule" | "event";
+        mode: "agentic" | "deterministic";
+    };
+    body: string;
+    canUpdate: boolean;
+}
+export interface AutomationDelivery {
+    originScopeId?: string;
+    platform?: string;
+    destination?: string;
+    threadRef?: string;
+    tenantId?: string;
+}
+export interface DefineAutomationInput {
+    name: string;
+    scope: AutomationScope;
+    triggerType: "schedule" | "event";
+    body: string;
+    schedule?: string;
+    event?: string;
+    condition?: string;
+    domain?: string;
+    delegatedPolicyId?: string;
+    model?: string;
+    mcpTools?: unknown;
+    delivery?: AutomationDelivery;
+}
+export type DefinedAutomation = Omit<AutomationDefinition, "resource">;
+export interface UpdateAutomationInput {
+    name: string;
+    scope: AutomationScope;
+    enabled?: boolean;
+    body?: string;
+    condition?: string | null;
+    delegatedPolicyId?: string | null;
+    schedule?: string;
+    model?: string | null;
+    mcpTools?: unknown;
+}
+/**
+ * Compatibility adapters may expose both explicit automations and legacy
+ * scheduled jobs. Keep their mutation authorization on the same boundary as
+ * the canonical service without forcing legacy resources through the explicit
+ * automation classifier.
+ */
+export declare function canUpdateAutomationResource(actorInput: AutomationActor, resource: Resource): Promise<boolean>;
+export declare function listAutomationDefinitions(actorInput: AutomationActor, scope: AutomationScope): Promise<AutomationDefinition[]>;
+export declare function defineAutomation(actorInput: AutomationActor, input: DefineAutomationInput): Promise<DefinedAutomation>;
+export declare function updateAutomation(actorInput: AutomationActor, input: UpdateAutomationInput): Promise<AutomationDefinition>;
+export declare function deleteAutomation(actorInput: AutomationActor, scope: AutomationScope, name: string): Promise<void>;
+export interface AutomationExecutionIdentity {
+    userEmail: string;
+    orgId?: string;
+    eventOwner: string;
+}
+export type AutomationExecutionIdentityResult = {
+    ok: true;
+    identity: AutomationExecutionIdentity;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Resolve the identity used by an explicit automation run.
+ *
+ * Organization automations are visible through their organization owner, but
+ * always execute as their immutable creator. Event dispatchers must also
+ * require EventMeta.owner to equal `eventOwner`; organization visibility does
+ * not make an event organization-wide.
+ */
+export declare function resolveAutomationExecutionIdentity(resourceOwner: string, meta: JobFrontmatter): Promise<AutomationExecutionIdentityResult>;
+export declare function automationMatchesEventOwner(identity: AutomationExecutionIdentity, eventOwner: string | undefined): boolean;
+//# sourceMappingURL=service.d.ts.map

package/dist/automations/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/automations/service.ts"],"names":[],"mappings":"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"}

package/dist/automations/service.js

@@ -0,0 +1,332 @@
+import { getDbExec } from "../db/client.js";
+import { isValidCron, nextOccurrence } from "../jobs/cron.js";
+import { buildJobResourceContent, normalizeJobMcpTools, parseJobResource, } from "../jobs/frontmatter.js";
+import { organizationIdFromResourceOwner, organizationResourceOwner, resourceDelete, resourceGetByPath, resourceList, resourcePut, } from "../resources/store.js";
+function httpError(message, statusCode) {
+    return Object.assign(new Error(message), { statusCode });
+}
+function normalizeActor(actor) {
+    const userEmail = actor.userEmail.trim().toLowerCase();
+    if (!userEmail)
+        throw httpError("Not authenticated.", 401);
+    return { userEmail, orgId: actor.orgId?.trim() || null };
+}
+function automationName(path) {
+    return path.replace(/^jobs\//, "").replace(/\.md$/, "");
+}
+function automationPath(name) {
+    const normalized = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-");
+    if (!normalized) {
+        throw httpError("Automation name is required (lowercase, hyphens).", 400);
+    }
+    return `jobs/${normalized}.md`;
+}
+function ownerForScope(actor, scope) {
+    if (scope === "personal")
+        return actor.userEmail;
+    if (!actor.orgId) {
+        throw httpError("An organization is required for organization automations.", 400);
+    }
+    return organizationResourceOwner(actor.orgId);
+}
+async function readOrganizationMembership(orgId, email) {
+    const result = await getDbExec().execute({
+        sql: "SELECT role FROM org_members WHERE org_id = ? AND LOWER(email) = ? LIMIT 1",
+        args: [orgId, email.toLowerCase()],
+    });
+    if (!result.rows.length)
+        return null;
+    return { role: String(result.rows[0]?.role ?? "").toLowerCase() };
+}
+async function requireOrganizationMembership(actor) {
+    if (!actor.orgId) {
+        throw httpError("An organization is required for organization automations.", 400);
+    }
+    const membership = await readOrganizationMembership(actor.orgId, actor.userEmail);
+    if (!membership) {
+        throw httpError("You are no longer a member of this organization.", 403);
+    }
+    return membership;
+}
+function isOrganizationAdmin(membership) {
+    return membership.role === "owner" || membership.role === "admin";
+}
+async function mutationAccess(actorInput, resource, meta) {
+    const actor = normalizeActor(actorInput);
+    const resourceOrgId = organizationIdFromResourceOwner(resource.owner);
+    if (!resourceOrgId) {
+        return {
+            actor,
+            canUpdate: resource.owner.toLowerCase() === actor.userEmail,
+        };
+    }
+    if (actor.orgId !== resourceOrgId) {
+        return { actor, canUpdate: false };
+    }
+    const membership = await requireOrganizationMembership(actor);
+    const isCreator = meta.createdBy?.trim().toLowerCase() === actor.userEmail.toLowerCase();
+    return {
+        actor,
+        canUpdate: isCreator || isOrganizationAdmin(membership),
+    };
+}
+/**
+ * Compatibility adapters may expose both explicit automations and legacy
+ * scheduled jobs. Keep their mutation authorization on the same boundary as
+ * the canonical service without forcing legacy resources through the explicit
+ * automation classifier.
+ */
+export async function canUpdateAutomationResource(actorInput, resource) {
+    const { meta } = parseJobResource(resource.content);
+    return (await mutationAccess(actorInput, resource, meta)).canUpdate;
+}
+function assertExplicitAutomation(resource) {
+    const parsed = parseJobResource(resource.content);
+    if (parsed.classification.kind !== "automation") {
+        throw httpError(`"${automationName(resource.path)}" is a legacy scheduled job. Use manage-jobs for compatibility.`, 400);
+    }
+    return {
+        resource,
+        meta: {
+            ...parsed.meta,
+            triggerType: parsed.classification.triggerType,
+            mode: parsed.meta.mode ?? "agentic",
+        },
+        body: parsed.body,
+    };
+}
+async function readDefinition(actorInput, scope, name) {
+    const actor = normalizeActor(actorInput);
+    if (scope === "organization")
+        await requireOrganizationMembership(actor);
+    const owner = ownerForScope(actor, scope);
+    const path = automationPath(name);
+    const resource = await resourceGetByPath(owner, path);
+    if (!resource) {
+        throw httpError(`Automation "${automationName(path)}" not found.`, 404);
+    }
+    const definition = assertExplicitAutomation(resource);
+    const access = await mutationAccess(actor, resource, definition.meta);
+    return {
+        ...definition,
+        name: automationName(resource.path),
+        scope,
+        canUpdate: access.canUpdate,
+    };
+}
+export async function listAutomationDefinitions(actorInput, scope) {
+    const actor = normalizeActor(actorInput);
+    const membership = scope === "organization"
+        ? await requireOrganizationMembership(actor)
+        : undefined;
+    const owner = ownerForScope(actor, scope);
+    const resources = await resourceList(owner, "jobs/");
+    const automations = [];
+    for (const resourceMeta of resources) {
+        if (!resourceMeta.path.endsWith(".md") ||
+            resourceMeta.path.endsWith(".keep")) {
+            continue;
+        }
+        const resource = await resourceGetByPath(owner, resourceMeta.path);
+        if (!resource)
+            continue;
+        const parsed = parseJobResource(resource.content);
+        if (parsed.classification.kind !== "automation")
+            continue;
+        const isCreator = parsed.meta.createdBy?.trim().toLowerCase() === actor.userEmail;
+        automations.push({
+            resource,
+            name: automationName(resource.path),
+            scope,
+            meta: {
+                ...parsed.meta,
+                triggerType: parsed.classification.triggerType,
+                mode: parsed.meta.mode ?? "agentic",
+            },
+            body: parsed.body,
+            canUpdate: scope === "personal" ||
+                isCreator ||
+                (membership ? isOrganizationAdmin(membership) : false),
+        });
+    }
+    return automations;
+}
+export async function defineAutomation(actorInput, input) {
+    const actor = normalizeActor(actorInput);
+    if (input.scope === "organization") {
+        await requireOrganizationMembership(actor);
+    }
+    const owner = ownerForScope(actor, input.scope);
+    const path = automationPath(input.name);
+    if (await resourceGetByPath(owner, path)) {
+        throw httpError(`An automation named "${automationName(path)}" already exists.`, 409);
+    }
+    const body = input.body.trim();
+    if (!body)
+        throw httpError("body is required.", 400);
+    const schedule = input.schedule?.trim() ?? "";
+    const event = input.event?.trim() ?? "";
+    if (input.triggerType === "schedule" && !isValidCron(schedule)) {
+        throw httpError(schedule
+            ? `invalid cron expression "${schedule}".`
+            : "schedule is required for scheduled automations.", 400);
+    }
+    if (input.triggerType === "event" && !event) {
+        throw httpError("event is required for event-triggered automations.", 400);
+    }
+    const mcpTools = normalizeJobMcpTools(input.mcpTools);
+    const meta = {
+        schedule: input.triggerType === "schedule" ? schedule : "",
+        enabled: true,
+        triggerType: input.triggerType,
+        event: input.triggerType === "event" ? event : undefined,
+        condition: input.condition?.trim() || undefined,
+        mode: "agentic",
+        domain: input.domain?.trim() || undefined,
+        delegatedPolicyId: input.delegatedPolicyId?.trim() || undefined,
+        createdBy: actor.userEmail,
+        orgId: input.scope === "organization" ? actor.orgId : undefined,
+        runAs: "creator",
+        nextRun: input.triggerType === "schedule"
+            ? nextOccurrence(schedule).toISOString()
+            : undefined,
+        model: input.model?.trim() || undefined,
+        mcpTools: mcpTools?.length ? mcpTools : undefined,
+        originScopeId: input.delivery?.originScopeId,
+        deliveryPlatform: input.delivery?.platform,
+        deliveryDestination: input.delivery?.destination,
+        deliveryThreadRef: input.delivery?.threadRef,
+        deliveryTenantId: input.delivery?.tenantId,
+    };
+    const content = buildJobResourceContent(meta, body);
+    await resourcePut(owner, path, content);
+    return {
+        name: automationName(path),
+        scope: input.scope,
+        meta: { ...meta, triggerType: input.triggerType, mode: "agentic" },
+        body,
+        canUpdate: true,
+    };
+}
+export async function updateAutomation(actorInput, input) {
+    const definition = await readDefinition(actorInput, input.scope, input.name);
+    if (!definition.canUpdate) {
+        throw httpError("Only the automation's creator or an organization admin can update it.", 403);
+    }
+    const { meta } = definition;
+    if (input.schedule !== undefined) {
+        if (meta.triggerType !== "schedule") {
+            throw httpError("Event automations do not have a cron schedule.", 400);
+        }
+        if (!isValidCron(input.schedule)) {
+            throw httpError(`Invalid cron expression "${input.schedule}".`, 400);
+        }
+        meta.schedule = input.schedule;
+        meta.nextRun = nextOccurrence(input.schedule).toISOString();
+    }
+    if (input.enabled !== undefined) {
+        meta.enabled = input.enabled;
+        if (input.enabled &&
+            meta.triggerType === "schedule" &&
+            isValidCron(meta.schedule)) {
+            meta.nextRun = nextOccurrence(meta.schedule).toISOString();
+        }
+    }
+    if (input.condition !== undefined) {
+        meta.condition = input.condition?.trim() || undefined;
+    }
+    if (input.delegatedPolicyId !== undefined) {
+        meta.delegatedPolicyId = input.delegatedPolicyId?.trim() || undefined;
+    }
+    if (input.model !== undefined) {
+        meta.model = input.model?.trim() || undefined;
+    }
+    if (input.mcpTools !== undefined) {
+        const mcpTools = normalizeJobMcpTools(input.mcpTools);
+        meta.mcpTools = mcpTools?.length ? mcpTools : undefined;
+    }
+    if (input.scope === "organization") {
+        meta.orgId = organizationIdFromResourceOwner(definition.resource.owner);
+        meta.runAs = "creator";
+    }
+    const body = input.body === undefined ? definition.body : input.body.trim();
+    if (!body)
+        throw httpError("Automation body is required.", 400);
+    await resourcePut(definition.resource.owner, definition.resource.path, buildJobResourceContent(meta, body));
+    return { ...definition, meta, body };
+}
+export async function deleteAutomation(actorInput, scope, name) {
+    const definition = await readDefinition(actorInput, scope, name);
+    if (!definition.canUpdate) {
+        throw httpError("Only the automation's creator or an organization admin can delete it.", 403);
+    }
+    await resourceDelete(definition.resource.id);
+}
+/**
+ * Resolve the identity used by an explicit automation run.
+ *
+ * Organization automations are visible through their organization owner, but
+ * always execute as their immutable creator. Event dispatchers must also
+ * require EventMeta.owner to equal `eventOwner`; organization visibility does
+ * not make an event organization-wide.
+ */
+export async function resolveAutomationExecutionIdentity(resourceOwner, meta) {
+    const orgId = organizationIdFromResourceOwner(resourceOwner);
+    if (!orgId) {
+        const userEmail = (meta.createdBy || resourceOwner).trim().toLowerCase();
+        if (!userEmail || userEmail !== resourceOwner.trim().toLowerCase()) {
+            return {
+                ok: false,
+                reason: "Personal automation creator does not match its owner.",
+            };
+        }
+        return { ok: true, identity: { userEmail, eventOwner: userEmail } };
+    }
+    const userEmail = meta.createdBy?.trim().toLowerCase();
+    if (!userEmail) {
+        return {
+            ok: false,
+            reason: "Organization automation has no creator identity.",
+        };
+    }
+    if (meta.runAs !== "creator") {
+        return {
+            ok: false,
+            reason: "Organization automations must run as their creator.",
+        };
+    }
+    if (meta.orgId && meta.orgId !== orgId) {
+        return {
+            ok: false,
+            reason: "Organization automation metadata does not match its owner.",
+        };
+    }
+    const user = await getDbExec().execute({
+        sql: `SELECT 1 FROM "user" WHERE LOWER(email) = ? LIMIT 1`,
+        args: [userEmail],
+    });
+    if (!user.rows.length) {
+        return {
+            ok: false,
+            reason: `Automation creator "${userEmail}" no longer exists.`,
+        };
+    }
+    if (!(await readOrganizationMembership(orgId, userEmail))) {
+        return {
+            ok: false,
+            reason: `Automation creator "${userEmail}" is no longer a member of organization "${orgId}".`,
+        };
+    }
+    return {
+        ok: true,
+        identity: { userEmail, orgId, eventOwner: userEmail },
+    };
+}
+export function automationMatchesEventOwner(identity, eventOwner) {
+    return (typeof eventOwner === "string" &&
+        eventOwner.trim().toLowerCase() === identity.eventOwner);
+}
+//# sourceMappingURL=service.js.map