@databricks/appkit 0.66.0 → 0.67.0

package/dist/core/agent/skills/resolve-catalog.js

@@ -0,0 +1,78 @@
+import { createLogger } from "../../../logging/logger.js";
+
+//#region src/core/agent/skills/resolve-catalog.ts
+const logger = createLogger("agents:skills");
+/** Qualified-name scope prefix per source, used only on cross-source collision. */
+const SCOPE_BY_SOURCE = {
+	"bundle-agent": "agent",
+	"bundle-global": "bundle",
+	volume: "volume"
+};
+/**
+* Applies visibility (per-agent auto; global opt-in or auto-inherit) then
+* collision handling: a unique name is addressable bare; a name provided by
+* multiple sources becomes `<scope>:name` per source and the bare name is
+* marked ambiguous (addressing it errors with the alternatives). Two skills
+* with the same name from the *same* source is a fatal config error.
+*/
+function resolveSkillCatalog(input) {
+	const { agentName, agentSkillNames, perAgentSkills, globalSkills, autoInherit } = input;
+	const visible = [...perAgentSkills];
+	if (autoInherit) visible.push(...globalSkills);
+	else if (agentSkillNames && agentSkillNames.length > 0) {
+		const wanted = new Set(agentSkillNames);
+		for (const skill of globalSkills) if (wanted.has(skill.name)) visible.push(skill);
+		const localNames = new Set(perAgentSkills.map((s) => s.name));
+		const globalNames = new Set(globalSkills.map((s) => s.name));
+		for (const want of agentSkillNames) if (!globalNames.has(want) && !localNames.has(want)) logger.warn("Agent '%s' lists skill '%s' in 'skills:', but no global or per-agent skill with that name exists.", agentName, want);
+	}
+	const byName = /* @__PURE__ */ new Map();
+	for (const skill of visible) {
+		const group = byName.get(skill.name) ?? [];
+		group.push(skill);
+		byName.set(skill.name, group);
+	}
+	const byAddress = /* @__PURE__ */ new Map();
+	const ambiguous = /* @__PURE__ */ new Map();
+	for (const [name, group] of byName) {
+		if (group.length === 1) {
+			byAddress.set(name, group[0]);
+			continue;
+		}
+		const alternatives = [];
+		for (const skill of group) {
+			const qualified = `${SCOPE_BY_SOURCE[skill.source]}:${name}`;
+			const existing = byAddress.get(qualified);
+			if (existing) throw new Error(`Agent '${agentName}': two '${skill.source}' skills are both named '${name}' (${existing.dir} and ${skill.dir}). Skill names must be unique within a source.`);
+			byAddress.set(qualified, skill);
+			alternatives.push(qualified);
+		}
+		alternatives.sort();
+		ambiguous.set(name, alternatives);
+		logger.warn("Agent '%s': skill name '%s' is provided by multiple sources; address it as %s.", agentName, name, alternatives.join(" or "));
+	}
+	return {
+		byAddress,
+		ambiguous,
+		catalog: [...byAddress.entries()].map(([address, skill]) => ({
+			name: address,
+			description: skill.description
+		})).sort((a, b) => a.name.localeCompare(b.name))
+	};
+}
+/**
+* Resolves a requested skill name (bare or qualified) against a catalog.
+* Throws a helpful error on ambiguous or unknown names.
+*/
+function resolveSkill(catalog, requested) {
+	const direct = catalog.byAddress.get(requested);
+	if (direct) return direct;
+	const alternatives = catalog.ambiguous.get(requested);
+	if (alternatives) throw new Error(`Skill '${requested}' is ambiguous; specify one of: ${alternatives.join(", ")}.`);
+	const available = [...catalog.byAddress.keys()].sort().join(", ") || "<none>";
+	throw new Error(`Unknown skill '${requested}'. Available: ${available}.`);
+}
+
+//#endregion
+export { resolveSkill, resolveSkillCatalog };
+//# sourceMappingURL=resolve-catalog.js.map

package/dist/core/agent/skills/resolve-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-catalog.js","names":[],"sources":["../../../../src/core/agent/skills/resolve-catalog.ts"],"sourcesContent":["import { createLogger } from \"../../../logging/logger\";\nimport type {\n  ResolvedSkillCatalog,\n  SkillCatalogEntry,\n  SkillDefinition,\n  SkillSource,\n} from \"./types\";\n\nconst logger = createLogger(\"agents:skills\");\n\n/** Qualified-name scope prefix per source, used only on cross-source collision. */\nconst SCOPE_BY_SOURCE: Record<SkillSource, string> = {\n  \"bundle-agent\": \"agent\",\n  \"bundle-global\": \"bundle\",\n  volume: \"volume\",\n};\n\ninterface ResolveCatalogInput {\n  agentName: string;\n  /** The agent's `skills:` frontmatter — opt-in selection from the global pool. */\n  agentSkillNames?: string[];\n  /** Skills private to this agent (`<id>/skills/`), always visible. */\n  perAgentSkills: SkillDefinition[];\n  /** Shared pool (bundle-global + volume), visible only when opted in or inherited. */\n  globalSkills: SkillDefinition[];\n  /** When true, every global skill is visible without an explicit `skills:` list. */\n  autoInherit: boolean;\n}\n\n/**\n * Applies visibility (per-agent auto; global opt-in or auto-inherit) then\n * collision handling: a unique name is addressable bare; a name provided by\n * multiple sources becomes `<scope>:name` per source and the bare name is\n * marked ambiguous (addressing it errors with the alternatives). Two skills\n * with the same name from the *same* source is a fatal config error.\n */\nexport function resolveSkillCatalog(\n  input: ResolveCatalogInput,\n): ResolvedSkillCatalog {\n  const {\n    agentName,\n    agentSkillNames,\n    perAgentSkills,\n    globalSkills,\n    autoInherit,\n  } = input;\n\n  const visible: SkillDefinition[] = [...perAgentSkills];\n  if (autoInherit) {\n    visible.push(...globalSkills);\n  } else if (agentSkillNames && agentSkillNames.length > 0) {\n    const wanted = new Set(agentSkillNames);\n    for (const skill of globalSkills) {\n      if (wanted.has(skill.name)) visible.push(skill);\n    }\n    const localNames = new Set(perAgentSkills.map((s) => s.name));\n    const globalNames = new Set(globalSkills.map((s) => s.name));\n    for (const want of agentSkillNames) {\n      if (!globalNames.has(want) && !localNames.has(want)) {\n        logger.warn(\n          \"Agent '%s' lists skill '%s' in 'skills:', but no global or per-agent skill with that name exists.\",\n          agentName,\n          want,\n        );\n      }\n    }\n  }\n\n  const byName = new Map<string, SkillDefinition[]>();\n  for (const skill of visible) {\n    const group = byName.get(skill.name) ?? [];\n    group.push(skill);\n    byName.set(skill.name, group);\n  }\n\n  const byAddress = new Map<string, SkillDefinition>();\n  const ambiguous = new Map<string, string[]>();\n\n  for (const [name, group] of byName) {\n    if (group.length === 1) {\n      byAddress.set(name, group[0]);\n      continue;\n    }\n\n    const alternatives: string[] = [];\n    for (const skill of group) {\n      const qualified = `${SCOPE_BY_SOURCE[skill.source]}:${name}`;\n      const existing = byAddress.get(qualified);\n      if (existing) {\n        throw new Error(\n          `Agent '${agentName}': two '${skill.source}' skills are both named '${name}' ` +\n            `(${existing.dir} and ${skill.dir}). Skill names must be unique within a source.`,\n        );\n      }\n      byAddress.set(qualified, skill);\n      alternatives.push(qualified);\n    }\n    alternatives.sort();\n    ambiguous.set(name, alternatives);\n    logger.warn(\n      \"Agent '%s': skill name '%s' is provided by multiple sources; address it as %s.\",\n      agentName,\n      name,\n      alternatives.join(\" or \"),\n    );\n  }\n\n  const catalog: SkillCatalogEntry[] = [...byAddress.entries()]\n    .map(([address, skill]) => ({\n      name: address,\n      description: skill.description,\n    }))\n    .sort((a, b) => a.name.localeCompare(b.name));\n\n  return { byAddress, ambiguous, catalog };\n}\n\n/**\n * Resolves a requested skill name (bare or qualified) against a catalog.\n * Throws a helpful error on ambiguous or unknown names.\n */\nexport function resolveSkill(\n  catalog: ResolvedSkillCatalog,\n  requested: string,\n): SkillDefinition {\n  const direct = catalog.byAddress.get(requested);\n  if (direct) return direct;\n\n  const alternatives = catalog.ambiguous.get(requested);\n  if (alternatives) {\n    throw new Error(\n      `Skill '${requested}' is ambiguous; specify one of: ${alternatives.join(\", \")}.`,\n    );\n  }\n\n  const available = [...catalog.byAddress.keys()].sort().join(\", \") || \"<none>\";\n  throw new Error(`Unknown skill '${requested}'. Available: ${available}.`);\n}\n"],"mappings":";;;AAQA,MAAM,SAAS,aAAa,gBAAgB;;AAG5C,MAAM,kBAA+C;CACnD,gBAAgB;CAChB,iBAAiB;CACjB,QAAQ;CACT;;;;;;;;AAqBD,SAAgB,oBACd,OACsB;CACtB,MAAM,EACJ,WACA,iBACA,gBACA,cACA,gBACE;CAEJ,MAAM,UAA6B,CAAC,GAAG,eAAe;AACtD,KAAI,YACF,SAAQ,KAAK,GAAG,aAAa;UACpB,mBAAmB,gBAAgB,SAAS,GAAG;EACxD,MAAM,SAAS,IAAI,IAAI,gBAAgB;AACvC,OAAK,MAAM,SAAS,aAClB,KAAI,OAAO,IAAI,MAAM,KAAK,CAAE,SAAQ,KAAK,MAAM;EAEjD,MAAM,aAAa,IAAI,IAAI,eAAe,KAAK,MAAM,EAAE,KAAK,CAAC;EAC7D,MAAM,cAAc,IAAI,IAAI,aAAa,KAAK,MAAM,EAAE,KAAK,CAAC;AAC5D,OAAK,MAAM,QAAQ,gBACjB,KAAI,CAAC,YAAY,IAAI,KAAK,IAAI,CAAC,WAAW,IAAI,KAAK,CACjD,QAAO,KACL,qGACA,WACA,KACD;;CAKP,MAAM,yBAAS,IAAI,KAAgC;AACnD,MAAK,MAAM,SAAS,SAAS;EAC3B,MAAM,QAAQ,OAAO,IAAI,MAAM,KAAK,IAAI,EAAE;AAC1C,QAAM,KAAK,MAAM;AACjB,SAAO,IAAI,MAAM,MAAM,MAAM;;CAG/B,MAAM,4BAAY,IAAI,KAA8B;CACpD,MAAM,4BAAY,IAAI,KAAuB;AAE7C,MAAK,MAAM,CAAC,MAAM,UAAU,QAAQ;AAClC,MAAI,MAAM,WAAW,GAAG;AACtB,aAAU,IAAI,MAAM,MAAM,GAAG;AAC7B;;EAGF,MAAM,eAAyB,EAAE;AACjC,OAAK,MAAM,SAAS,OAAO;GACzB,MAAM,YAAY,GAAG,gBAAgB,MAAM,QAAQ,GAAG;GACtD,MAAM,WAAW,UAAU,IAAI,UAAU;AACzC,OAAI,SACF,OAAM,IAAI,MACR,UAAU,UAAU,UAAU,MAAM,OAAO,2BAA2B,KAAK,KACrE,SAAS,IAAI,OAAO,MAAM,IAAI,gDACrC;AAEH,aAAU,IAAI,WAAW,MAAM;AAC/B,gBAAa,KAAK,UAAU;;AAE9B,eAAa,MAAM;AACnB,YAAU,IAAI,MAAM,aAAa;AACjC,SAAO,KACL,kFACA,WACA,MACA,aAAa,KAAK,OAAO,CAC1B;;AAUH,QAAO;EAAE;EAAW;EAAW,SAPM,CAAC,GAAG,UAAU,SAAS,CAAC,CAC1D,KAAK,CAAC,SAAS,YAAY;GAC1B,MAAM;GACN,aAAa,MAAM;GACpB,EAAE,CACF,MAAM,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,CAAC;EAEP;;;;;;AAO1C,SAAgB,aACd,SACA,WACiB;CACjB,MAAM,SAAS,QAAQ,UAAU,IAAI,UAAU;AAC/C,KAAI,OAAQ,QAAO;CAEnB,MAAM,eAAe,QAAQ,UAAU,IAAI,UAAU;AACrD,KAAI,aACF,OAAM,IAAI,MACR,UAAU,UAAU,kCAAkC,aAAa,KAAK,KAAK,CAAC,GAC/E;CAGH,MAAM,YAAY,CAAC,GAAG,QAAQ,UAAU,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;AACrE,OAAM,IAAI,MAAM,kBAAkB,UAAU,gBAAgB,UAAU,GAAG"}

package/dist/core/agent/skills/types.d.ts

@@ -0,0 +1,50 @@
+//#region src/core/agent/skills/types.d.ts
+/** Where a skill was discovered. Drives the qualified name used on collision. */
+type SkillSource = "bundle-agent" | "bundle-global" | "volume";
+/**
+ * A single skill: a `SKILL.md` (frontmatter `name`+`description` + Markdown
+ * body) plus any bundled resource files in the same directory. The body is
+ * loaded into model context on demand (via the `load_skill` tool or a forced
+ * `/skill-name` invocation); only `name`+`description` are always-on in the
+ * prompt catalog.
+ */
+interface SkillDefinition {
+  /** Frontmatter `name`. The addressable skill id. */
+  name: string;
+  /** Frontmatter `description`. Injected into the always-on prompt catalog. */
+  description: string;
+  /** Markdown body — the instructions loaded on demand. */
+  body: string;
+  /** Where the skill came from. */
+  source: SkillSource;
+  /** Absolute directory containing `SKILL.md` and any bundled resources. */
+  dir: string;
+  /** Relative posix paths of bundled resource files (excludes `SKILL.md`). */
+  files: string[];
+  /**
+   * Optional advisory tool allowlist from frontmatter `allowed-tools`. Surfaced
+   * as a hint in v1 — NOT enforced (loading a skill does not restrict the
+   * agent's callable tools).
+   */
+  allowedTools?: string[];
+}
+/** The always-on prompt entry for a skill (what the model sees before loading). */
+interface SkillCatalogEntry {
+  /** Addressable name — bare when unique, `<scope>:name` when collided. */
+  name: string;
+  description: string;
+}
+/**
+ * Per-agent resolved skill catalog: visibility + collision rules applied.
+ * `byAddress` maps every addressable name (bare or qualified) to its skill;
+ * `ambiguous` maps a bare name shadowed by multiple sources to the qualified
+ * alternatives; `catalog` is the always-on prompt list (one entry per address).
+ */
+interface ResolvedSkillCatalog {
+  byAddress: Map<string, SkillDefinition>;
+  ambiguous: Map<string, string[]>;
+  catalog: SkillCatalogEntry[];
+}
+//#endregion
+export { ResolvedSkillCatalog };
+//# sourceMappingURL=types.d.ts.map

package/dist/core/agent/skills/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/core/agent/skills/types.ts"],"mappings":";;KACY,WAAA;;;;;AASZ;;;UAAiB,eAAA;EAEf;EAAA,IAAA;EAIA;EAFA,WAAA;EAIQ;EAFR,IAAA;EAMA;EAJA,MAAA,EAAQ,WAAA;EAUI;EARZ,GAAA;EAYe;EAVf,KAAA;;;;AAsBF;;EAhBE,YAAA;AAAA;;UAIe,iBAAA;EAeN;EAbT,IAAA;EACA,WAAA;AAAA;;;;;;;UASe,oBAAA;EACf,SAAA,EAAW,GAAA,SAAY,eAAA;EACvB,SAAA,EAAW,GAAA;EACX,OAAA,EAAS,iBAAA;AAAA"}

package/dist/core/agent/types.d.ts

@@ -5,6 +5,7 @@ import { HostedSupervisorTool, SupervisorTool } from "../../agents/supervisor-ap
 import { GenerationParams } from "../../agents/databricks.js";
 import { McpHostPolicyConfig } from "../../connectors/mcp/host-policy.js";
 import "../../connectors/mcp/index.js";
+import { ResolvedSkillCatalog } from "./skills/types.js";
 import { FunctionTool } from "./tools/function-tool.js";
 import { HostedTool } from "./tools/hosted-tools.js";
 
@@ -155,6 +156,13 @@ interface AgentDefinition {
   tools?: AgentTools | AgentToolsFn;
   /** Sub-agents, exposed as `agent-<key>` tools on this agent. */
   agents?: Record<string, AgentDefinition>;
+  /**
+   * Names of global skills (shared `skills/` pool or catalog volume) to make
+   * visible to this agent. Per-agent skills under `<id>/skills/` are always
+   * visible and need not be listed. Ignored when the plugin's
+   * `autoInheritSkills` makes every global skill visible.
+   */
+  skills?: string[];
   /** Override the plugin's baseSystemPrompt for this agent only. */
   baseSystemPrompt?: BaseSystemPromptOption;
   maxSteps?: number;
@@ -213,6 +221,28 @@ interface AgentsPluginConfig extends BasePluginConfig {
   tools?: Record<string, AgentTool>;
   /** Whether to auto-inherit every ToolProvider plugin's toolkit. Accepts a boolean shorthand. */
   autoInheritTools?: boolean | AutoInheritToolsConfig;
+  /**
+   * Whether every global skill (shared `skills/` pool or catalog volume) is
+   * visible to an agent without listing it in `skills:` frontmatter. Off by
+   * default so each agent's always-on skill catalog stays lean; accepts a
+   * boolean shorthand or a per-origin `{ file, code }` config, mirroring
+   * {@link autoInheritTools}.
+   */
+  autoInheritSkills?: boolean | AutoInheritToolsConfig;
+  /**
+   * Unity Catalog Volume path for catalog-sourced skills (e.g.
+   * `/Volumes/<catalog>/<schema>/<volume>`). Falls back to the
+   * `DATABRICKS_VOLUME_AGENT_SKILLS` env var. Skills at `<volume>/<name>/SKILL.md`
+   * are discovered at boot and on `reload()` and read as the service principal.
+   */
+  skillsVolume?: string;
+  /**
+   * Identity used to read catalog (volume) skills. v1 supports `"sp"` (default —
+   * a shared, service-principal-readable curated pool). `"obo"` is the reserved
+   * switch point for per-user skill volumes and is not wired yet (falls back to
+   * `"sp"` with a warning).
+   */
+  skillCredentialMode?: "sp" | "obo";
   /** Persistent thread store. Default: in-memory. */
   threadStore?: ThreadStore;
   /** Customize or disable the AppKit base system prompt. */
@@ -316,6 +346,17 @@ type ResolvedToolEntry = {
   source: "hosted-supervisor";
   spec: SupervisorTool;
   def: AgentToolDefinition;
+} | {
+  /**
+   * Built-in skill tools (`load_skill`, `read_skill_file`) injected into
+   * any agent that has a visible skill catalog. Executed in-process by the
+   * agents plugin against the agent's resolved catalog; read-only, so they
+   * bypass the approval gate.
+   */
+  source: "skill";
+  builtin: "load_skill" | "read_skill_file";
+  catalog: ResolvedSkillCatalog;
+  def: AgentToolDefinition;
 };
 interface RegisteredAgent {
   name: string;
@@ -329,6 +370,12 @@ interface RegisteredAgent {
   generationParams?: GenerationParams;
   /** Mirrors `AgentDefinition.ephemeral` — skip thread persistence. */
   ephemeral?: boolean;
+  /**
+   * Resolved per-agent skill catalog (visibility + collision rules applied).
+   * Present when any skill is visible to this agent; drives the always-on
+   * prompt catalog and `load_skill` dispatch.
+   */
+  skills?: ResolvedSkillCatalog;
 }
 /**
  * Type guard for `ToolkitEntry` — used by the agents plugin to differentiate

package/dist/core/agent/types.d.ts.map

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

package/dist/core/agent/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/core/agent/types.ts"],"sourcesContent":["import type {\n  AgentAdapter,\n  AgentToolDefinition,\n  BasePluginConfig,\n  ThreadStore,\n  ToolAnnotations,\n} from \"shared\";\n\nimport type { GenerationParams } from \"../../agents/databricks\";\nimport type { McpHostPolicyConfig } from \"../../connectors/mcp\";\nimport type { FunctionTool } from \"./tools/function-tool\";\nimport type { HostedTool } from \"./tools/hosted-tools\";\n\n/**\n * A tool reference produced by a plugin's `.toolkit()` call. The agents plugin\n * recognizes the `__toolkitRef` brand and dispatches tool invocations through\n * `PluginContext.executeTool(req, pluginName, localName, ...)`, preserving\n * OBO (asUser) and telemetry spans.\n */\nexport interface ToolkitEntry {\n  readonly __toolkitRef: true;\n  pluginName: string;\n  localName: string;\n  def: AgentToolDefinition;\n  annotations?: ToolAnnotations;\n  /**\n   * Whether this tool is eligible for `autoInheritTools` spreading. Mirrors\n   * {@link ToolEntry.autoInheritable} from the source registry so the agents\n   * plugin can filter auto-inherited tools without re-walking the provider's\n   * internal registry.\n   */\n  autoInheritable?: boolean;\n}\n\n/**\n * Any tool an agent can invoke: inline function tools (`tool()`), hosted MCP\n * tools (`mcpServer()` / raw hosted), toolkit references from plugins\n * (`analytics().toolkit()`), or adapter-hosted Supervisor-API tools\n * (`supervisorTools.*`).\n */\nexport type AgentTool =\n  | FunctionTool\n  | HostedTool\n  | ToolkitEntry\n  | import(\"../../agents/supervisor-api\").HostedSupervisorTool;\n\nexport interface ToolkitOptions {\n  /** Key prefix to prepend to each tool's local name. Defaults to `${pluginName}.`. */\n  prefix?: string;\n  /** Only include tools whose local name matches one of these. */\n  only?: string[];\n  /** Exclude tools whose local name matches one of these. */\n  except?: string[];\n  /** Remap specific local names to different keys (applied after prefix). */\n  rename?: Record<string, string>;\n}\n\n/**\n * Minimum shape every entry in the {@link Plugins} map must expose. Core\n * plugins (analytics, files, genie, lakebase) implement this directly via\n * their `.toolkit()` method. The agents plugin and standalone `runAgent`\n * synthesize this shape for any registered plugin that doesn't implement\n * `.toolkit()` directly (falling back to `getAgentTools()` walking).\n */\nexport interface PluginToolkitProvider {\n  toolkit(opts?: ToolkitOptions): Record<string, ToolkitEntry>;\n}\n\n/**\n * Plugin map passed to the function form of {@link AgentDefinition.tools}.\n * Each entry exposes a `.toolkit(opts?)` method that returns a record of\n * {@link ToolkitEntry} markers ready to be spread into a tool record.\n *\n * AppKit does not statically know which plugins the surrounding\n * `createApp` will register, so this is a plain string-keyed record.\n * Refer to plugins by the name used in `createApp({ plugins: [...] })`;\n * unknown names resolve to `undefined` at runtime.\n *\n * @example\n * ```ts\n * const support = createAgent({\n *   instructions: \"...\",\n *   tools(plugins) {\n *     return {\n *       get_weather: tool({ ... }),\n *       ...plugins.analytics.toolkit(),\n *       ...plugins.files.toolkit({ only: [\"uploads.read\"] }),\n *     };\n *   },\n * });\n * ```\n */\nexport type Plugins = Record<string, PluginToolkitProvider>;\n\n/**\n * Context passed to `baseSystemPrompt` callbacks.\n */\nexport interface PromptContext {\n  agentName: string;\n  pluginNames: string[];\n  toolNames: string[];\n}\n\nexport type BaseSystemPromptOption =\n  | false\n  | string\n  | ((ctx: PromptContext) => string);\n\n/**\n * Per-agent tool record. String keys map to inline tools, toolkit entries,\n * hosted tools, etc.\n */\nexport type AgentTools = Record<string, AgentTool>;\n\n/**\n * Function form of `AgentDefinition.tools`. Receives the typed\n * {@link Plugins} map and returns a tool record. Invoked exactly once at\n * setup (or once per `runAgent` call in standalone mode); the result is\n * cached as the agent's resolved tool record.\n *\n * Use the function form when an agent needs tools from registered plugins.\n * The bare object form is fine when an agent only uses inline tools.\n */\nexport type AgentToolsFn = (plugins: Plugins) => AgentTools;\n\nexport interface AgentDefinition {\n  /**\n   * Stable identifier for the agent. **Optional and informational** —\n   * when the definition is registered via `agents: { foo: def }` (code) or\n   * lives at `server/agents/<id>/agent.md` (markdown), the **registry key\n   * always wins** and `name` is ignored. The agent will be reachable as\n   * `foo` (or `<id>`) regardless of what this field contains.\n   *\n   * Set `name` when:\n   *   - Running standalone via `runAgent({ agent: def })`, where there is\n   *     no enclosing key. The runtime uses it for the agent's slot in\n   *     error messages and OTel spans.\n   *   - Building a definition that may be passed to either form and you\n   *     want a consistent fallback label.\n   *\n   * Setting `name` to a value that differs from the registry key is\n   * harmless but confusing — prefer keeping them aligned or omitting `name`\n   * entirely.\n   */\n  name?: string;\n  /**\n   * Marks this agent as the default one chosen when a client doesn't name an\n   * agent. Mirrors markdown frontmatter `default: true`. When several agents\n   * set it, a code (discovered) agent wins over a markdown one, then the\n   * lowest id; an explicit `agents({ defaultAgent })` always overrides it.\n   * Defaults to `false`.\n   */\n  default?: boolean;\n  /** System prompt body. For markdown-loaded agents this is the file body. */\n  instructions: string;\n  /**\n   * Model adapter (or endpoint-name string sugar for\n   * `DatabricksAdapter.fromServingEndpoint({ endpointName })`). Optional —\n   * falls back to the plugin's `defaultModel`.\n   */\n  model?: AgentAdapter | Promise<AgentAdapter> | string;\n  /**\n   * Per-agent tool record. Key is the LLM-visible tool-call name.\n   *\n   * Accepts either a plain record (for agents that only use inline tools)\n   * or a function `(plugins) => Record<string, AgentTool>` that receives\n   * the typed {@link Plugins} map and returns a tool record (for agents\n   * that pull tools from registered plugins).\n   *\n   * The function is invoked once at agent setup; the result is cached.\n   * Don't put per-request logic in there.\n   */\n  tools?: AgentTools | AgentToolsFn;\n  /** Sub-agents, exposed as `agent-<key>` tools on this agent. */\n  agents?: Record<string, AgentDefinition>;\n  /** Override the plugin's baseSystemPrompt for this agent only. */\n  baseSystemPrompt?: BaseSystemPromptOption;\n  maxSteps?: number;\n  maxTokens?: number;\n  /**\n   * Optional generation parameters (`temperature`, `top_p`, `stop`,\n   * `frequency_penalty`, `presence_penalty`) forwarded to the OpenAI-compatible\n   * serving request body. Only set keys are sent. Applied only when AppKit\n   * builds the adapter itself (string or omitted `model`); when you pass a\n   * pre-built `AgentAdapter`, configure generation params on it directly.\n   */\n  generationParams?: GenerationParams;\n  /**\n   * When true, the thread used for a chat request against this agent is\n   * deleted from `ThreadStore` after the stream completes (success or\n   * failure). Use for stateless one-shot agents — e.g. autocomplete, where\n   * each request is independent and retaining history would both poison\n   * future calls and accumulate unbounded state in the default\n   * `InMemoryThreadStore`. Defaults to `false`.\n   */\n  ephemeral?: boolean;\n}\n\n/**\n * Auto-inherit configuration. When enabled for a given agent origin, agents\n * with no explicit `tools:` declaration receive every registered ToolProvider\n * plugin tool whose author marked `autoInheritable: true`. Tools without that\n * flag — destructive, state-mutating, or privilege-sensitive — never spread\n * automatically and must be wired via `tools:` (object or function form in\n * code, `plugin:NAME` entries in markdown frontmatter).\n *\n * Defaults are `false` for both origins (safe-by-default): developers must\n * consciously opt an origin in to any auto-inherit behaviour.\n */\nexport interface AutoInheritToolsConfig {\n  /** Default for agents loaded from markdown files. Default: `false`. */\n  file?: boolean;\n  /** Default for code-defined agents (via `agents: { foo: createAgent(...) }`). Default: `false`. */\n  code?: boolean;\n}\n\nexport interface AgentsPluginConfig extends BasePluginConfig {\n  /**\n   * @deprecated Put each code agent in its own folder under\n   * `server/agents/<id>/agent.ts` (`export default createAgent({ ... })`); it is\n   * discovered automatically at startup and the call collapses to\n   * `agents({ ... })` with no map. Still honored for backward compatibility\n   * (emits a one-time deprecation warning) but will be removed in a future\n   * minor. If both discovery and this map define the same id, discovery wins\n   * and the map entry is ignored.\n   */\n  agents?: Record<string, AgentDefinition>;\n  /** Agent used when clients don't specify one. Precedence: this value, else a code agent with `default: true`, else a markdown agent with `default: true`, else the first-registered agent. */\n  defaultAgent?: string;\n  /** Default model for agents that don't specify their own (in code or frontmatter). */\n  defaultModel?: AgentAdapter | Promise<AgentAdapter> | string;\n  /** Ambient tool library. Keys may be referenced by markdown frontmatter via `tools: [key1, key2]`. */\n  tools?: Record<string, AgentTool>;\n  /** Whether to auto-inherit every ToolProvider plugin's toolkit. Accepts a boolean shorthand. */\n  autoInheritTools?: boolean | AutoInheritToolsConfig;\n  /** Persistent thread store. Default: in-memory. */\n  threadStore?: ThreadStore;\n  /** Customize or disable the AppKit base system prompt. */\n  baseSystemPrompt?: BaseSystemPromptOption;\n  /**\n   * MCP server host policy. By default only same-origin Databricks workspace\n   * URLs may be used as MCP endpoints; custom hosts must be explicitly\n   * allowlisted here. Workspace credentials (SP / OBO) are never forwarded\n   * to non-workspace hosts.\n   */\n  mcp?: McpHostPolicyConfig;\n  /**\n   * Human-in-the-loop approval gate for mutating tool calls. When enabled\n   * (the default), the agents plugin emits an `appkit.approval_pending` SSE\n   * event before executing any tool whose annotation flags it as mutating —\n   * `effect: \"write\" | \"update\" | \"destructive\"` (preferred) or the legacy\n   * `destructive: true` boolean — and waits for a `POST /api/agents/approve`\n   * decision from the same user who initiated the stream. A missing decision\n   * after `timeoutMs` auto-denies the call.\n   */\n  approval?: {\n    /**\n     * Require human approval for tools that mutate state. Triggered by\n     * `effect: \"write\" | \"update\" | \"destructive\"` (preferred) or the legacy\n     * `destructive: true` boolean. Default: `true`.\n     */\n    requireForDestructive?: boolean;\n    /** Milliseconds to wait before auto-denying. Default: 60_000. */\n    timeoutMs?: number;\n  };\n  /**\n   * Runtime resource limits applied during agent execution. Defaults are\n   * tuned to protect a single-instance deployment from a misbehaving user or\n   * a runaway prompt injection; tighten or relax as appropriate for the\n   * deployment's scale and trust model. Request-body caps (chat message\n   * size, invocations input size / length) are enforced statically by the\n   * Zod schemas and are not configurable here.\n   */\n  limits?: {\n    /**\n     * Max concurrent chat streams a single user may have open. Subsequent\n     * `POST /chat` requests from that user while at-limit are rejected with\n     * HTTP 429. Default: `5`.\n     */\n    maxConcurrentStreamsPerUser?: number;\n    /**\n     * Max tool invocations per agent run (across the full tool-call graph,\n     * including sub-agent invocations). A run that exceeds the budget is\n     * aborted with a terminal error event. Default: `50`.\n     */\n    maxToolCalls?: number;\n    /**\n     * Max sub-agent recursion depth. Protects against a prompt-injected\n     * agent that delegates to a sub-agent which in turn delegates back to\n     * itself (directly or transitively). Default: `3`.\n     */\n    maxSubAgentDepth?: number;\n    /**\n     * Per-call timeout for tools dispatched through `PluginContext`\n     * (toolkit-routed tools — analytics SQL warehouse queries, Genie\n     * messages, Lakebase queries). Independent of `maxToolCalls`: the\n     * budget caps how many tools fire per run, this caps how long any\n     * single tool call may run. The signal handed to plugin tool\n     * implementations combines this timeout with the parent stream's\n     * abort signal via `AbortSignal.any`. Function and MCP tools have\n     * their own timeouts in their respective adapters and ignore this\n     * setting. Default: `300_000` (5 minutes) — generous enough for cold\n     * SQL Warehouse round-trips and long Genie conversations.\n     */\n    toolCallTimeoutMs?: number;\n  };\n}\n\n/** Internal tool-index entry after a tool record has been resolved to a dispatchable form. */\nexport type ResolvedToolEntry =\n  | {\n      source: \"toolkit\";\n      pluginName: string;\n      localName: string;\n      def: AgentToolDefinition;\n    }\n  | {\n      source: \"function\";\n      functionTool: FunctionTool;\n      def: AgentToolDefinition;\n    }\n  | {\n      source: \"mcp\";\n      mcpToolName: string;\n      def: AgentToolDefinition;\n    }\n  | {\n      source: \"subagent\";\n      agentName: string;\n      def: AgentToolDefinition;\n    }\n  | {\n      /**\n       * Adapter-side hosted tool (executed by the model-host, not by the\n       * Node process). Today: Supervisor API hosted tools (Genie spaces,\n       * UC functions, etc.). The `spec` is opaque to the agents plugin —\n       * it routes the entry into `AgentInput.extensions` for the adapter\n       * that declared the matching `acceptsExtensions` key. `def` is a\n       * synthetic placeholder kept so the index has a uniform shape; it\n       * is intentionally NOT included in the `tools` array passed to\n       * `adapter.run()` (those entries are not callable functions).\n       */\n      source: \"hosted-supervisor\";\n      spec: import(\"../../agents/supervisor-api\").SupervisorTool;\n      def: AgentToolDefinition;\n    };\n\nexport interface RegisteredAgent {\n  name: string;\n  instructions: string;\n  adapter: AgentAdapter;\n  toolIndex: Map<string, ResolvedToolEntry>;\n  baseSystemPrompt?: BaseSystemPromptOption;\n  maxSteps?: number;\n  maxTokens?: number;\n  /** Mirrors `AgentDefinition.generationParams`. */\n  generationParams?: GenerationParams;\n  /** Mirrors `AgentDefinition.ephemeral` — skip thread persistence. */\n  ephemeral?: boolean;\n}\n\n/**\n * Type guard for `ToolkitEntry` — used by the agents plugin to differentiate\n * toolkit references from inline tools in a mixed `tools` record.\n */\nexport function isToolkitEntry(value: unknown): value is ToolkitEntry {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __toolkitRef?: unknown }).__toolkitRef === true\n  );\n}\n"],"mappings":";;;;;AA6WA,SAAgB,eAAe,OAAuC;AACpE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/core/agent/types.ts"],"sourcesContent":["import type {\n  AgentAdapter,\n  AgentToolDefinition,\n  BasePluginConfig,\n  ThreadStore,\n  ToolAnnotations,\n} from \"shared\";\n\nimport type { GenerationParams } from \"../../agents/databricks\";\nimport type { McpHostPolicyConfig } from \"../../connectors/mcp\";\nimport type { ResolvedSkillCatalog } from \"./skills/types\";\nimport type { FunctionTool } from \"./tools/function-tool\";\nimport type { HostedTool } from \"./tools/hosted-tools\";\n\n/**\n * A tool reference produced by a plugin's `.toolkit()` call. The agents plugin\n * recognizes the `__toolkitRef` brand and dispatches tool invocations through\n * `PluginContext.executeTool(req, pluginName, localName, ...)`, preserving\n * OBO (asUser) and telemetry spans.\n */\nexport interface ToolkitEntry {\n  readonly __toolkitRef: true;\n  pluginName: string;\n  localName: string;\n  def: AgentToolDefinition;\n  annotations?: ToolAnnotations;\n  /**\n   * Whether this tool is eligible for `autoInheritTools` spreading. Mirrors\n   * {@link ToolEntry.autoInheritable} from the source registry so the agents\n   * plugin can filter auto-inherited tools without re-walking the provider's\n   * internal registry.\n   */\n  autoInheritable?: boolean;\n}\n\n/**\n * Any tool an agent can invoke: inline function tools (`tool()`), hosted MCP\n * tools (`mcpServer()` / raw hosted), toolkit references from plugins\n * (`analytics().toolkit()`), or adapter-hosted Supervisor-API tools\n * (`supervisorTools.*`).\n */\nexport type AgentTool =\n  | FunctionTool\n  | HostedTool\n  | ToolkitEntry\n  | import(\"../../agents/supervisor-api\").HostedSupervisorTool;\n\nexport interface ToolkitOptions {\n  /** Key prefix to prepend to each tool's local name. Defaults to `${pluginName}.`. */\n  prefix?: string;\n  /** Only include tools whose local name matches one of these. */\n  only?: string[];\n  /** Exclude tools whose local name matches one of these. */\n  except?: string[];\n  /** Remap specific local names to different keys (applied after prefix). */\n  rename?: Record<string, string>;\n}\n\n/**\n * Minimum shape every entry in the {@link Plugins} map must expose. Core\n * plugins (analytics, files, genie, lakebase) implement this directly via\n * their `.toolkit()` method. The agents plugin and standalone `runAgent`\n * synthesize this shape for any registered plugin that doesn't implement\n * `.toolkit()` directly (falling back to `getAgentTools()` walking).\n */\nexport interface PluginToolkitProvider {\n  toolkit(opts?: ToolkitOptions): Record<string, ToolkitEntry>;\n}\n\n/**\n * Plugin map passed to the function form of {@link AgentDefinition.tools}.\n * Each entry exposes a `.toolkit(opts?)` method that returns a record of\n * {@link ToolkitEntry} markers ready to be spread into a tool record.\n *\n * AppKit does not statically know which plugins the surrounding\n * `createApp` will register, so this is a plain string-keyed record.\n * Refer to plugins by the name used in `createApp({ plugins: [...] })`;\n * unknown names resolve to `undefined` at runtime.\n *\n * @example\n * ```ts\n * const support = createAgent({\n *   instructions: \"...\",\n *   tools(plugins) {\n *     return {\n *       get_weather: tool({ ... }),\n *       ...plugins.analytics.toolkit(),\n *       ...plugins.files.toolkit({ only: [\"uploads.read\"] }),\n *     };\n *   },\n * });\n * ```\n */\nexport type Plugins = Record<string, PluginToolkitProvider>;\n\n/**\n * Context passed to `baseSystemPrompt` callbacks.\n */\nexport interface PromptContext {\n  agentName: string;\n  pluginNames: string[];\n  toolNames: string[];\n}\n\nexport type BaseSystemPromptOption =\n  | false\n  | string\n  | ((ctx: PromptContext) => string);\n\n/**\n * Per-agent tool record. String keys map to inline tools, toolkit entries,\n * hosted tools, etc.\n */\nexport type AgentTools = Record<string, AgentTool>;\n\n/**\n * Function form of `AgentDefinition.tools`. Receives the typed\n * {@link Plugins} map and returns a tool record. Invoked exactly once at\n * setup (or once per `runAgent` call in standalone mode); the result is\n * cached as the agent's resolved tool record.\n *\n * Use the function form when an agent needs tools from registered plugins.\n * The bare object form is fine when an agent only uses inline tools.\n */\nexport type AgentToolsFn = (plugins: Plugins) => AgentTools;\n\nexport interface AgentDefinition {\n  /**\n   * Stable identifier for the agent. **Optional and informational** —\n   * when the definition is registered via `agents: { foo: def }` (code) or\n   * lives at `server/agents/<id>/agent.md` (markdown), the **registry key\n   * always wins** and `name` is ignored. The agent will be reachable as\n   * `foo` (or `<id>`) regardless of what this field contains.\n   *\n   * Set `name` when:\n   *   - Running standalone via `runAgent({ agent: def })`, where there is\n   *     no enclosing key. The runtime uses it for the agent's slot in\n   *     error messages and OTel spans.\n   *   - Building a definition that may be passed to either form and you\n   *     want a consistent fallback label.\n   *\n   * Setting `name` to a value that differs from the registry key is\n   * harmless but confusing — prefer keeping them aligned or omitting `name`\n   * entirely.\n   */\n  name?: string;\n  /**\n   * Marks this agent as the default one chosen when a client doesn't name an\n   * agent. Mirrors markdown frontmatter `default: true`. When several agents\n   * set it, a code (discovered) agent wins over a markdown one, then the\n   * lowest id; an explicit `agents({ defaultAgent })` always overrides it.\n   * Defaults to `false`.\n   */\n  default?: boolean;\n  /** System prompt body. For markdown-loaded agents this is the file body. */\n  instructions: string;\n  /**\n   * Model adapter (or endpoint-name string sugar for\n   * `DatabricksAdapter.fromServingEndpoint({ endpointName })`). Optional —\n   * falls back to the plugin's `defaultModel`.\n   */\n  model?: AgentAdapter | Promise<AgentAdapter> | string;\n  /**\n   * Per-agent tool record. Key is the LLM-visible tool-call name.\n   *\n   * Accepts either a plain record (for agents that only use inline tools)\n   * or a function `(plugins) => Record<string, AgentTool>` that receives\n   * the typed {@link Plugins} map and returns a tool record (for agents\n   * that pull tools from registered plugins).\n   *\n   * The function is invoked once at agent setup; the result is cached.\n   * Don't put per-request logic in there.\n   */\n  tools?: AgentTools | AgentToolsFn;\n  /** Sub-agents, exposed as `agent-<key>` tools on this agent. */\n  agents?: Record<string, AgentDefinition>;\n  /**\n   * Names of global skills (shared `skills/` pool or catalog volume) to make\n   * visible to this agent. Per-agent skills under `<id>/skills/` are always\n   * visible and need not be listed. Ignored when the plugin's\n   * `autoInheritSkills` makes every global skill visible.\n   */\n  skills?: string[];\n  /** Override the plugin's baseSystemPrompt for this agent only. */\n  baseSystemPrompt?: BaseSystemPromptOption;\n  maxSteps?: number;\n  maxTokens?: number;\n  /**\n   * Optional generation parameters (`temperature`, `top_p`, `stop`,\n   * `frequency_penalty`, `presence_penalty`) forwarded to the OpenAI-compatible\n   * serving request body. Only set keys are sent. Applied only when AppKit\n   * builds the adapter itself (string or omitted `model`); when you pass a\n   * pre-built `AgentAdapter`, configure generation params on it directly.\n   */\n  generationParams?: GenerationParams;\n  /**\n   * When true, the thread used for a chat request against this agent is\n   * deleted from `ThreadStore` after the stream completes (success or\n   * failure). Use for stateless one-shot agents — e.g. autocomplete, where\n   * each request is independent and retaining history would both poison\n   * future calls and accumulate unbounded state in the default\n   * `InMemoryThreadStore`. Defaults to `false`.\n   */\n  ephemeral?: boolean;\n}\n\n/**\n * Auto-inherit configuration. When enabled for a given agent origin, agents\n * with no explicit `tools:` declaration receive every registered ToolProvider\n * plugin tool whose author marked `autoInheritable: true`. Tools without that\n * flag — destructive, state-mutating, or privilege-sensitive — never spread\n * automatically and must be wired via `tools:` (object or function form in\n * code, `plugin:NAME` entries in markdown frontmatter).\n *\n * Defaults are `false` for both origins (safe-by-default): developers must\n * consciously opt an origin in to any auto-inherit behaviour.\n */\nexport interface AutoInheritToolsConfig {\n  /** Default for agents loaded from markdown files. Default: `false`. */\n  file?: boolean;\n  /** Default for code-defined agents (via `agents: { foo: createAgent(...) }`). Default: `false`. */\n  code?: boolean;\n}\n\nexport interface AgentsPluginConfig extends BasePluginConfig {\n  /**\n   * @deprecated Put each code agent in its own folder under\n   * `server/agents/<id>/agent.ts` (`export default createAgent({ ... })`); it is\n   * discovered automatically at startup and the call collapses to\n   * `agents({ ... })` with no map. Still honored for backward compatibility\n   * (emits a one-time deprecation warning) but will be removed in a future\n   * minor. If both discovery and this map define the same id, discovery wins\n   * and the map entry is ignored.\n   */\n  agents?: Record<string, AgentDefinition>;\n  /** Agent used when clients don't specify one. Precedence: this value, else a code agent with `default: true`, else a markdown agent with `default: true`, else the first-registered agent. */\n  defaultAgent?: string;\n  /** Default model for agents that don't specify their own (in code or frontmatter). */\n  defaultModel?: AgentAdapter | Promise<AgentAdapter> | string;\n  /** Ambient tool library. Keys may be referenced by markdown frontmatter via `tools: [key1, key2]`. */\n  tools?: Record<string, AgentTool>;\n  /** Whether to auto-inherit every ToolProvider plugin's toolkit. Accepts a boolean shorthand. */\n  autoInheritTools?: boolean | AutoInheritToolsConfig;\n  /**\n   * Whether every global skill (shared `skills/` pool or catalog volume) is\n   * visible to an agent without listing it in `skills:` frontmatter. Off by\n   * default so each agent's always-on skill catalog stays lean; accepts a\n   * boolean shorthand or a per-origin `{ file, code }` config, mirroring\n   * {@link autoInheritTools}.\n   */\n  autoInheritSkills?: boolean | AutoInheritToolsConfig;\n  /**\n   * Unity Catalog Volume path for catalog-sourced skills (e.g.\n   * `/Volumes/<catalog>/<schema>/<volume>`). Falls back to the\n   * `DATABRICKS_VOLUME_AGENT_SKILLS` env var. Skills at `<volume>/<name>/SKILL.md`\n   * are discovered at boot and on `reload()` and read as the service principal.\n   */\n  skillsVolume?: string;\n  /**\n   * Identity used to read catalog (volume) skills. v1 supports `\"sp\"` (default —\n   * a shared, service-principal-readable curated pool). `\"obo\"` is the reserved\n   * switch point for per-user skill volumes and is not wired yet (falls back to\n   * `\"sp\"` with a warning).\n   */\n  skillCredentialMode?: \"sp\" | \"obo\";\n  /** Persistent thread store. Default: in-memory. */\n  threadStore?: ThreadStore;\n  /** Customize or disable the AppKit base system prompt. */\n  baseSystemPrompt?: BaseSystemPromptOption;\n  /**\n   * MCP server host policy. By default only same-origin Databricks workspace\n   * URLs may be used as MCP endpoints; custom hosts must be explicitly\n   * allowlisted here. Workspace credentials (SP / OBO) are never forwarded\n   * to non-workspace hosts.\n   */\n  mcp?: McpHostPolicyConfig;\n  /**\n   * Human-in-the-loop approval gate for mutating tool calls. When enabled\n   * (the default), the agents plugin emits an `appkit.approval_pending` SSE\n   * event before executing any tool whose annotation flags it as mutating —\n   * `effect: \"write\" | \"update\" | \"destructive\"` (preferred) or the legacy\n   * `destructive: true` boolean — and waits for a `POST /api/agents/approve`\n   * decision from the same user who initiated the stream. A missing decision\n   * after `timeoutMs` auto-denies the call.\n   */\n  approval?: {\n    /**\n     * Require human approval for tools that mutate state. Triggered by\n     * `effect: \"write\" | \"update\" | \"destructive\"` (preferred) or the legacy\n     * `destructive: true` boolean. Default: `true`.\n     */\n    requireForDestructive?: boolean;\n    /** Milliseconds to wait before auto-denying. Default: 60_000. */\n    timeoutMs?: number;\n  };\n  /**\n   * Runtime resource limits applied during agent execution. Defaults are\n   * tuned to protect a single-instance deployment from a misbehaving user or\n   * a runaway prompt injection; tighten or relax as appropriate for the\n   * deployment's scale and trust model. Request-body caps (chat message\n   * size, invocations input size / length) are enforced statically by the\n   * Zod schemas and are not configurable here.\n   */\n  limits?: {\n    /**\n     * Max concurrent chat streams a single user may have open. Subsequent\n     * `POST /chat` requests from that user while at-limit are rejected with\n     * HTTP 429. Default: `5`.\n     */\n    maxConcurrentStreamsPerUser?: number;\n    /**\n     * Max tool invocations per agent run (across the full tool-call graph,\n     * including sub-agent invocations). A run that exceeds the budget is\n     * aborted with a terminal error event. Default: `50`.\n     */\n    maxToolCalls?: number;\n    /**\n     * Max sub-agent recursion depth. Protects against a prompt-injected\n     * agent that delegates to a sub-agent which in turn delegates back to\n     * itself (directly or transitively). Default: `3`.\n     */\n    maxSubAgentDepth?: number;\n    /**\n     * Per-call timeout for tools dispatched through `PluginContext`\n     * (toolkit-routed tools — analytics SQL warehouse queries, Genie\n     * messages, Lakebase queries). Independent of `maxToolCalls`: the\n     * budget caps how many tools fire per run, this caps how long any\n     * single tool call may run. The signal handed to plugin tool\n     * implementations combines this timeout with the parent stream's\n     * abort signal via `AbortSignal.any`. Function and MCP tools have\n     * their own timeouts in their respective adapters and ignore this\n     * setting. Default: `300_000` (5 minutes) — generous enough for cold\n     * SQL Warehouse round-trips and long Genie conversations.\n     */\n    toolCallTimeoutMs?: number;\n  };\n}\n\n/** Internal tool-index entry after a tool record has been resolved to a dispatchable form. */\nexport type ResolvedToolEntry =\n  | {\n      source: \"toolkit\";\n      pluginName: string;\n      localName: string;\n      def: AgentToolDefinition;\n    }\n  | {\n      source: \"function\";\n      functionTool: FunctionTool;\n      def: AgentToolDefinition;\n    }\n  | {\n      source: \"mcp\";\n      mcpToolName: string;\n      def: AgentToolDefinition;\n    }\n  | {\n      source: \"subagent\";\n      agentName: string;\n      def: AgentToolDefinition;\n    }\n  | {\n      /**\n       * Adapter-side hosted tool (executed by the model-host, not by the\n       * Node process). Today: Supervisor API hosted tools (Genie spaces,\n       * UC functions, etc.). The `spec` is opaque to the agents plugin —\n       * it routes the entry into `AgentInput.extensions` for the adapter\n       * that declared the matching `acceptsExtensions` key. `def` is a\n       * synthetic placeholder kept so the index has a uniform shape; it\n       * is intentionally NOT included in the `tools` array passed to\n       * `adapter.run()` (those entries are not callable functions).\n       */\n      source: \"hosted-supervisor\";\n      spec: import(\"../../agents/supervisor-api\").SupervisorTool;\n      def: AgentToolDefinition;\n    }\n  | {\n      /**\n       * Built-in skill tools (`load_skill`, `read_skill_file`) injected into\n       * any agent that has a visible skill catalog. Executed in-process by the\n       * agents plugin against the agent's resolved catalog; read-only, so they\n       * bypass the approval gate.\n       */\n      source: \"skill\";\n      builtin: \"load_skill\" | \"read_skill_file\";\n      catalog: ResolvedSkillCatalog;\n      def: AgentToolDefinition;\n    };\n\nexport interface RegisteredAgent {\n  name: string;\n  instructions: string;\n  adapter: AgentAdapter;\n  toolIndex: Map<string, ResolvedToolEntry>;\n  baseSystemPrompt?: BaseSystemPromptOption;\n  maxSteps?: number;\n  maxTokens?: number;\n  /** Mirrors `AgentDefinition.generationParams`. */\n  generationParams?: GenerationParams;\n  /** Mirrors `AgentDefinition.ephemeral` — skip thread persistence. */\n  ephemeral?: boolean;\n  /**\n   * Resolved per-agent skill catalog (visibility + collision rules applied).\n   * Present when any skill is visible to this agent; drives the always-on\n   * prompt catalog and `load_skill` dispatch.\n   */\n  skills?: ResolvedSkillCatalog;\n}\n\n/**\n * Type guard for `ToolkitEntry` — used by the agents plugin to differentiate\n * toolkit references from inline tools in a mixed `tools` record.\n */\nexport function isToolkitEntry(value: unknown): value is ToolkitEntry {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    (value as { __toolkitRef?: unknown }).__toolkitRef === true\n  );\n}\n"],"mappings":";;;;;AA6ZA,SAAgB,eAAe,OAAuC;AACpE,QACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAqC,iBAAiB"}

package/dist/plugins/agents/agents.d.ts

@@ -40,6 +40,12 @@ declare class AgentsPlugin extends Plugin implements ToolProvider {
    * negative, or `NaN`) can't degrade into immediate auto-denial of every
    * mutating tool call.
    */
+  /**
+   * Shared global skill pool (bundle `skills/` + catalog volume), loaded once
+   * per registry build. Read by {@link buildRegisteredAgent} to resolve each
+   * agent's visible catalog and by the live `register` path.
+   */
+  private globalSkills;
   private cachedApprovalPolicy;
   private get resolvedApprovalPolicy();
   /** Effective DoS limits with defaults applied. */
@@ -108,6 +114,35 @@ declare class AgentsPlugin extends Plugin implements ToolProvider {
    */
   private pluginProviderIndex;
   private buildRegisteredAgent;
+  /** Loads the shared global skill pool from `<agentsDir>/skills/`. */
+  private loadGlobalSkills;
+  /** Configured catalog-skills volume path, or null when none is set. */
+  private resolveSkillsVolume;
+  /**
+   * Workspace client used to read catalog skills. v1 reads as the app service
+   * principal; `getWorkspaceClient()` resolves to SP outside a user scope
+   * (boot and skill-tool dispatch are both unscoped). This is the single
+   * switch point for a future OBO mode.
+   */
+  private skillWorkspaceClient;
+  /**
+   * Discovers catalog skills from the configured UC Volume, read as the
+   * service principal at boot (and on `reload()`). Each `<volume>/<name>/`
+   * folder with a `SKILL.md` becomes a `source: "volume"` skill. Best-effort:
+   * a missing volume, unavailable workspace client, or a malformed individual
+   * skill is logged and skipped rather than failing the whole registry build.
+   */
+  private loadVolumeSkills;
+  /** Lists a volume skill's resource files (one level, excluding SKILL.md). */
+  private listVolumeSkillFiles;
+  /**
+   * Resolves the per-agent skill catalog: loads this agent's private skills
+   * (`<agentsDir>/<id>/skills/`, file-origin only), then applies visibility
+   * (opt-in via `def.skills` or `autoInheritSkills`) and collision rules
+   * against the shared global pool. Returns `undefined` when nothing is
+   * visible so the prompt catalog and dispatch can cheaply skip skills.
+   */
+  private resolveAgentSkills;
   private resolveAdapter;
   /**
    * Resolves an agent's tool record into a per-agent dispatch index. Connects
@@ -214,6 +249,21 @@ declare class AgentsPlugin extends Plugin implements ToolProvider {
    * sub-agent, so depth limits remain enforced.
    */
   private dispatchToolCall;
+  /**
+   * Executes the built-in `load_skill` / `read_skill_file` tools against the
+   * agent's resolved skill catalog. `load_skill` returns a skill's body plus a
+   * manifest of bundled files; `read_skill_file` returns the contents of one
+   * of those files (bundle skills only in v1 — catalog-volume resource reads
+   * arrive with the volume source).
+   */
+  private dispatchSkillTool;
+  /**
+   * Renders the prompt addendum for a force-loaded skill (`/skill-name`).
+   * Returns null when the agent has no catalog or the name doesn't resolve —
+   * an unusable request shouldn't fail the whole turn, so it's logged and the
+   * model proceeds with the catalog + `load_skill` still available.
+   */
+  private renderForcedSkill;
   /**
    * Runs a sub-agent in response to an `agent-<key>` tool call. Returns the
    * concatenated text output to hand back to the parent adapter as the tool

package/dist/plugins/agents/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","names":[],"sources":["../../../src/plugins/agents/agents.ts"],"mappings":";;;;;;;;;;cAsJa,YAAA,SAAqB,MAAA,YAAkB,YAAA;EAAA,OAC3C,QAAA,EADiB,cAAA;EAAA,OAEjB,KAAA,EAAO,WAAA;EAAA,UAEI,MAAA,EAAQ,kBAAA;EAAA,QAElB,MAAA;EAAA,QACA,gBAAA;EAAA,QACA,aAAA;EARG;;;;;;EAAA,QAkBH,gBAAA;EAAA,QACA,SAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;EA+xBkB;EAAA,QA7xBlB,0BAAA;EAq2BQ;EAAA,QAn2BR,6BAAA;cAEI,MAAA,EAAQ,kBAAA;EAqxD6B;;;;;;;;;;EAAA,QAtvDzC,oBAAA;EAAA,YAKI,sBAAA,CAAA;EA9DG;EAAA,YAwFH,cAAA,CAAA;EAvFE;EAAA,QA0GN,gBAAA;EAxGkB;;;;;;EAAA,QAkHlB,WAAA;EAjGA;;;;;EAAA,QAkHA,aAAA;EAYF,KAAA,CAAA,GAAK,OAAA;EApFC;;;;;;EAmGN,MAAA,CAAA,GAAU,OAAA;EAAV;;;;;EAAA,QA0BQ,kBAAA;EA4JN;;;;;EAAA,QAvDA,mBAAA;EA0MM;;;;EAAA,QA5KN,uBAAA;EAgbM;;;;EAAA,QAjaN,0BAAA;EAAA,QAUA,iBAAA;EAkfR;;;;;;EAAA,QAxec,cAAA;EAqoBA;EAAA,QAxmBN,mBAAA;EAAA,QAeM,mBAAA;EAyjCA;;;;;;EAAA,QAtgCN,mBAAA;EAAA,QAmBM,oBAAA;EAAA,QAuBA,cAAA;EA2zCR;;;;;EAAA,QA/wCQ,cAAA;EAyxCa;;;;;;;;;;;EAAA,QAzqCnB,eAAA;EA+qCuB;;;;AA4JjC;;;;;;;;EA5JiC,QAnpCvB,eAAA;EAAA,QAkBM,gBAAA;EAAA,QA0DA,kBAAA;EAiEd,aAAA,CAAA,GAAiB,mBAAA;EAIX,gBAAA,CAAA,GAAoB,OAAA;;;;;;;UAYlB,iBAAA;EAUR,YAAA,CAAa,MAAA,EAAQ,UAAA;EAkDrB,YAAA,CAAA,GAAgB,MAAA;EAAA,QAOF,WAAA;;;;;;;;;;;;UA6EN,gCAAA;;;;;;;;;;;UAuBM,aAAA;EAAA,QA2FA,YAAA;;;;;;;;;;;;;;;;;;;;;;;;UA2NA,qBAAA;;;;;;;;;;;;UA0KA,gBAAA;;;;;;;;;;;;;;;UAmIA,WAAA;EAAA,QAiGA,aAAA;EAAA,QA2BA,cAAA;EAAA,QAuCA,kBAAA;EAAA,QASA,gBAAA;EAAA,QAUA,mBAAA;EAAA,QAaN,YAAA;EAAA,QASA,aAAA;EAgBF,QAAA,CAAA,GAAY,OAAA;EAQlB,OAAA,CAAA;6BAE2B,GAAA,EAAO,eAAA,KAAe,OAAA;;2BAG3B,eAAA;;;oCAGS,OAAA,CAAA,MAAA;EAAA;EAAA,QAIjB,iBAAA;AAAA;;;;;;;;;;;;;;;;;;cAwJH,MAAA,EAAM,QAAA,QAAA,YAAA,EAAA,kBAAA"}
+{"version":3,"file":"agents.d.ts","names":[],"sources":["../../../src/plugins/agents/agents.ts"],"mappings":";;;;;;;;;;cAoKa,YAAA,SAAqB,MAAA,YAAkB,YAAA;EAAA,OAC3C,QAAA,EADiB,cAAA;EAAA,OAEjB,KAAA,EAAO,WAAA;EAAA,UAEI,MAAA,EAAQ,kBAAA;EAAA,QAElB,MAAA;EAAA,QACA,gBAAA;EAAA,QACA,aAAA;EARG;;;;;;EAAA,QAkBH,gBAAA;EAAA,QACA,SAAA;EAAA,QACA,WAAA;EAAA,QACA,YAAA;EA89BkB;EAAA,QA59BlB,0BAAA;EAoiCQ;EAAA,QAliCR,6BAAA;cAEI,MAAA,EAAQ,kBAAA;EAikE6B;;;;;;;;;;EA5lEC;;;;;EAAA,QA+D1C,YAAA;EAAA,QAEA,oBAAA;EAAA,YAKI,sBAAA,CAAA;EA/DJ;EAAA,YAyFI,cAAA,CAAA;EA9EJ;EAAA,QAiGA,gBAAA;EA/FA;;;;;;EAAA,QAyGA,WAAA;EA9DA;;;;;EAAA,QA+EA,aAAA;EAYF,KAAA,CAAA,GAAK,OAAA;EAAL;;;;;;EAeA,MAAA,CAAA,GAAU,OAAA;EAoLR;;;;;EAAA,QA1JM,kBAAA;EAgSA;;;;;EAAA,QAnLN,mBAAA;EA4UM;;;;EAAA,QA9SN,uBAAA;EAsiBM;;;;EAAA,QAvhBN,0BAAA;EAAA,QAUA,iBAAA;EAwpBA;;;;;;EAAA,QA9oBM,cAAA;EAozBN;EAAA,QAvxBA,mBAAA;EAAA,QAeM,mBAAA;EA+lCA;;;;;;EAAA,QA5iCN,mBAAA;EAAA,QAmBM,oBAAA;EA+jDA;EAAA,QAriDA,gBAAA;EA4jDN;EAAA,QArjDA,mBAAA;EA8kDF;;;;;;EAAA,QAlkDE,oBAAA;EA4kDyC;;;;;;;EAAA,QAjkDnC,gBAAA;;UA0EA,oBAAA;EA6/CiB;;;;;AAyMjC;;EAzMiC,QAt+CjB,kBAAA;EAAA,QA4BA,cAAA;EAmpDG;;;;;EAAA,QAvmDH,cAAA;EAumDG;;;;;;;;;;;EAAA,QAr+CT,eAAA;;;;;;;;;;;;;UA4BA,eAAA;EAAA,QAkBM,gBAAA;EAAA,QA0DA,kBAAA;EAiEd,aAAA,CAAA,GAAiB,mBAAA;EAIX,gBAAA,CAAA,GAAoB,OAAA;;;;;;;UAYlB,iBAAA;EAUR,YAAA,CAAa,MAAA,EAAQ,UAAA;EAkDrB,YAAA,CAAA,GAAgB,MAAA;EAAA,QAeF,WAAA;;;;;;;;;;;;UA2FN,gCAAA;;;;;;;;;;;UAuBM,aAAA;EAAA,QA2FA,YAAA;;;;;;;;;;;;;;;;;;;;;;;;UAqOA,qBAAA;;;;;;;;;;;;UA0KA,gBAAA;;;;;;;;UA8HA,iBAAA;;;;;;;UAkDN,iBAAA;;;;;;;;;;;;;;;UAgCM,WAAA;EAAA,QAiGA,aAAA;EAAA,QA2BA,cAAA;EAAA,QAuCA,kBAAA;EAAA,QASA,gBAAA;EAAA,QAUA,mBAAA;EAAA,QAaN,YAAA;EAAA,QASA,aAAA;EAgBF,QAAA,CAAA,GAAY,OAAA;EAQlB,OAAA,CAAA;6BAE2B,GAAA,EAAO,eAAA,KAAe,OAAA;;2BAG3B,eAAA;;;oCAGS,OAAA,CAAA,MAAA;EAAA;EAAA,QAIjB,iBAAA;AAAA;;;;;;;;;;;;;;;;;;cAqMH,MAAA,EAAM,QAAA,QAAA,YAAA,EAAA,kBAAA"}