@databricks/appkit 0.31.0 → 0.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/CLAUDE.md +1 -0
  2. package/NOTICE.md +1 -0
  3. package/dist/appkit/package.js +1 -1
  4. package/dist/beta.d.ts +14 -1
  5. package/dist/beta.js +12 -1
  6. package/dist/connectors/index.js +3 -0
  7. package/dist/connectors/mcp/client.d.ts +60 -0
  8. package/dist/connectors/mcp/client.d.ts.map +1 -0
  9. package/dist/connectors/mcp/client.js +197 -0
  10. package/dist/connectors/mcp/client.js.map +1 -0
  11. package/dist/connectors/mcp/host-policy.d.ts +51 -0
  12. package/dist/connectors/mcp/host-policy.d.ts.map +1 -0
  13. package/dist/connectors/mcp/host-policy.js +168 -0
  14. package/dist/connectors/mcp/host-policy.js.map +1 -0
  15. package/dist/connectors/mcp/index.d.ts +3 -0
  16. package/dist/connectors/mcp/index.js +4 -0
  17. package/dist/connectors/mcp/types.d.ts +16 -0
  18. package/dist/connectors/mcp/types.d.ts.map +1 -0
  19. package/dist/context/index.js +1 -1
  20. package/dist/core/agent/build-toolkit.d.ts +2 -0
  21. package/dist/core/agent/build-toolkit.js +50 -0
  22. package/dist/core/agent/build-toolkit.js.map +1 -0
  23. package/dist/core/agent/consume-adapter-stream.js +33 -0
  24. package/dist/core/agent/consume-adapter-stream.js.map +1 -0
  25. package/dist/core/agent/create-agent.d.ts +27 -0
  26. package/dist/core/agent/create-agent.d.ts.map +1 -0
  27. package/dist/core/agent/create-agent.js +50 -0
  28. package/dist/core/agent/create-agent.js.map +1 -0
  29. package/dist/core/agent/load-agents.d.ts +67 -0
  30. package/dist/core/agent/load-agents.d.ts.map +1 -0
  31. package/dist/core/agent/load-agents.js +228 -0
  32. package/dist/core/agent/load-agents.js.map +1 -0
  33. package/dist/core/agent/normalize-result.js +39 -0
  34. package/dist/core/agent/normalize-result.js.map +1 -0
  35. package/dist/core/agent/run-agent.d.ts +34 -0
  36. package/dist/core/agent/run-agent.d.ts.map +1 -0
  37. package/dist/core/agent/run-agent.js +146 -0
  38. package/dist/core/agent/run-agent.js.map +1 -0
  39. package/dist/core/agent/system-prompt.js +38 -0
  40. package/dist/core/agent/system-prompt.js.map +1 -0
  41. package/dist/core/agent/tools/define-tool.d.ts +54 -0
  42. package/dist/core/agent/tools/define-tool.d.ts.map +1 -0
  43. package/dist/core/agent/tools/define-tool.js +50 -0
  44. package/dist/core/agent/tools/define-tool.js.map +1 -0
  45. package/dist/core/agent/tools/function-tool.d.ts +27 -0
  46. package/dist/core/agent/tools/function-tool.d.ts.map +1 -0
  47. package/dist/core/agent/tools/function-tool.js +21 -0
  48. package/dist/core/agent/tools/function-tool.js.map +1 -0
  49. package/dist/core/agent/tools/hosted-tools.d.ts +47 -0
  50. package/dist/core/agent/tools/hosted-tools.d.ts.map +1 -0
  51. package/dist/core/agent/tools/hosted-tools.js +67 -0
  52. package/dist/core/agent/tools/hosted-tools.js.map +1 -0
  53. package/dist/core/agent/tools/index.d.ts +5 -0
  54. package/dist/core/agent/tools/index.js +7 -0
  55. package/dist/core/agent/tools/json-schema.js +24 -0
  56. package/dist/core/agent/tools/json-schema.js.map +1 -0
  57. package/dist/core/agent/tools/sql-policy.js +256 -0
  58. package/dist/core/agent/tools/sql-policy.js.map +1 -0
  59. package/dist/core/agent/tools/tool.d.ts +34 -0
  60. package/dist/core/agent/tools/tool.d.ts.map +1 -0
  61. package/dist/core/agent/tools/tool.js +41 -0
  62. package/dist/core/agent/tools/tool.js.map +1 -0
  63. package/dist/core/agent/types.d.ts +214 -0
  64. package/dist/core/agent/types.d.ts.map +1 -0
  65. package/dist/core/agent/types.js +12 -0
  66. package/dist/core/agent/types.js.map +1 -0
  67. package/dist/core/appkit.d.ts +1 -0
  68. package/dist/core/appkit.d.ts.map +1 -1
  69. package/dist/core/appkit.js +31 -4
  70. package/dist/core/appkit.js.map +1 -1
  71. package/dist/core/plugin-context.d.ts +133 -0
  72. package/dist/core/plugin-context.d.ts.map +1 -0
  73. package/dist/core/plugin-context.js +220 -0
  74. package/dist/core/plugin-context.js.map +1 -0
  75. package/dist/index.d.ts +11 -11
  76. package/dist/internal-telemetry/appkit-log.js +19 -0
  77. package/dist/internal-telemetry/appkit-log.js.map +1 -0
  78. package/dist/internal-telemetry/config.js +15 -0
  79. package/dist/internal-telemetry/config.js.map +1 -0
  80. package/dist/internal-telemetry/index.js +4 -0
  81. package/dist/internal-telemetry/reporter.js +132 -0
  82. package/dist/internal-telemetry/reporter.js.map +1 -0
  83. package/dist/plugin/index.d.ts +1 -1
  84. package/dist/plugin/plugin.d.ts +18 -3
  85. package/dist/plugin/plugin.d.ts.map +1 -1
  86. package/dist/plugin/plugin.js +26 -2
  87. package/dist/plugin/plugin.js.map +1 -1
  88. package/dist/plugin/to-plugin.d.ts +15 -4
  89. package/dist/plugin/to-plugin.d.ts.map +1 -1
  90. package/dist/plugin/to-plugin.js +14 -4
  91. package/dist/plugin/to-plugin.js.map +1 -1
  92. package/dist/plugins/agents/agents.d.ts +4 -0
  93. package/dist/plugins/agents/agents.js +882 -0
  94. package/dist/plugins/agents/agents.js.map +1 -0
  95. package/dist/plugins/agents/defaults.js +13 -0
  96. package/dist/plugins/agents/defaults.js.map +1 -0
  97. package/dist/plugins/agents/event-channel.js +64 -0
  98. package/dist/plugins/agents/event-channel.js.map +1 -0
  99. package/dist/plugins/agents/event-translator.js +224 -0
  100. package/dist/plugins/agents/event-translator.js.map +1 -0
  101. package/dist/plugins/agents/index.d.ts +4 -0
  102. package/dist/plugins/agents/index.js +6 -0
  103. package/dist/plugins/agents/manifest.js +27 -0
  104. package/dist/plugins/agents/manifest.js.map +1 -0
  105. package/dist/plugins/agents/schemas.js +51 -0
  106. package/dist/plugins/agents/schemas.js.map +1 -0
  107. package/dist/plugins/agents/thread-store.js +58 -0
  108. package/dist/plugins/agents/thread-store.js.map +1 -0
  109. package/dist/plugins/agents/tool-approval-gate.js +75 -0
  110. package/dist/plugins/agents/tool-approval-gate.js.map +1 -0
  111. package/dist/plugins/analytics/analytics.d.ts +17 -2
  112. package/dist/plugins/analytics/analytics.d.ts.map +1 -1
  113. package/dist/plugins/analytics/analytics.js +33 -0
  114. package/dist/plugins/analytics/analytics.js.map +1 -1
  115. package/dist/plugins/files/plugin.d.ts +22 -3
  116. package/dist/plugins/files/plugin.d.ts.map +1 -1
  117. package/dist/plugins/files/plugin.js +102 -2
  118. package/dist/plugins/files/plugin.js.map +1 -1
  119. package/dist/plugins/genie/genie.d.ts +15 -2
  120. package/dist/plugins/genie/genie.d.ts.map +1 -1
  121. package/dist/plugins/genie/genie.js +45 -0
  122. package/dist/plugins/genie/genie.js.map +1 -1
  123. package/dist/plugins/jobs/plugin.d.ts +2 -1
  124. package/dist/plugins/jobs/plugin.d.ts.map +1 -1
  125. package/dist/plugins/jobs/plugin.js +1 -1
  126. package/dist/plugins/lakebase/index.d.ts +2 -2
  127. package/dist/plugins/lakebase/index.js +1 -1
  128. package/dist/plugins/lakebase/lakebase.d.ts +33 -4
  129. package/dist/plugins/lakebase/lakebase.d.ts.map +1 -1
  130. package/dist/plugins/lakebase/lakebase.js +77 -5
  131. package/dist/plugins/lakebase/lakebase.js.map +1 -1
  132. package/dist/plugins/lakebase/types.d.ts +38 -1
  133. package/dist/plugins/lakebase/types.d.ts.map +1 -1
  134. package/dist/plugins/server/index.d.ts +12 -1
  135. package/dist/plugins/server/index.d.ts.map +1 -1
  136. package/dist/plugins/server/index.js +39 -5
  137. package/dist/plugins/server/index.js.map +1 -1
  138. package/dist/plugins/server/types.d.ts +0 -3
  139. package/dist/plugins/server/types.d.ts.map +1 -1
  140. package/dist/plugins/serving/serving.d.ts +2 -1
  141. package/dist/plugins/serving/serving.d.ts.map +1 -1
  142. package/dist/shared/src/agent.d.ts +63 -1
  143. package/dist/shared/src/agent.d.ts.map +1 -1
  144. package/dist/shared/src/index.d.ts +1 -1
  145. package/dist/shared/src/plugin.d.ts +8 -0
  146. package/dist/shared/src/plugin.d.ts.map +1 -1
  147. package/docs/api/appkit/Class.Plugin.md +65 -23
  148. package/docs/api/appkit/Function.createApp.md +10 -8
  149. package/docs/privacy.md +41 -0
  150. package/llms.txt +1 -0
  151. package/package.json +4 -2
  152. package/sbom.cdx.json +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agents.js","names":["manifest"],"sources":["../../../src/plugins/agents/agents.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport path from \"node:path\";\nimport type express from \"express\";\nimport pc from \"picocolors\";\nimport type {\n AgentAdapter,\n AgentEvent,\n AgentRunContext,\n AgentToolDefinition,\n IAppRouter,\n Message,\n PluginPhase,\n ResponseStreamEvent,\n Thread,\n ToolAnnotations,\n ToolProvider,\n} from \"shared\";\nimport { AppKitMcpClient, buildMcpHostPolicy } from \"../../connectors/mcp\";\nimport { consumeAdapterStream } from \"../../core/agent/consume-adapter-stream\";\nimport { loadAgentsFromDir } from \"../../core/agent/load-agents\";\nimport { normalizeToolResult } from \"../../core/agent/normalize-result\";\nimport {\n buildBaseSystemPrompt,\n composeSystemPrompt,\n} from \"../../core/agent/system-prompt\";\nimport {\n functionToolToDefinition,\n isFunctionTool,\n isHostedTool,\n resolveHostedTools,\n} from \"../../core/agent/tools\";\nimport type {\n AgentDefinition,\n AgentsPluginConfig,\n BaseSystemPromptOption,\n PromptContext,\n RegisteredAgent,\n ResolvedToolEntry,\n} from \"../../core/agent/types\";\nimport { isToolkitEntry } from \"../../core/agent/types\";\nimport { createLogger } from \"../../logging/logger\";\nimport { Plugin, toPlugin } from \"../../plugin\";\nimport type { PluginManifest } from \"../../registry\";\nimport { agentStreamDefaults } from \"./defaults\";\nimport { EventChannel } from \"./event-channel\";\nimport { AgentEventTranslator } from \"./event-translator\";\nimport manifest from \"./manifest.json\";\nimport {\n approvalRequestSchema,\n cancelRequestSchema,\n chatRequestSchema,\n invocationsRequestSchema,\n} from \"./schemas\";\nimport { InMemoryThreadStore } from \"./thread-store\";\nimport { ToolApprovalGate } from \"./tool-approval-gate\";\n\nconst logger = createLogger(\"agents\");\n\nconst DEFAULT_AGENTS_DIR = \"./config/agents\";\n\n/**\n * Context flag recorded on the in-memory AgentDefinition to indicate whether\n * it came from markdown (file) or from user code. Drives the asymmetric\n * `autoInheritTools` default.\n */\ninterface AgentSource {\n origin: \"file\" | \"code\";\n}\n\n/**\n * Decide whether a tool call must traverse the approval gate. Honours both\n * the modern `effect` field (mutating values: write / update / destructive)\n * and the legacy `destructive: true` boolean. The contract is documented on\n * `ToolAnnotations.effect` in shared/agent.ts.\n *\n * Without this, a tool authored only with `effect: \"destructive\"` (the\n * preferred API) bypassed the gate entirely.\n */\nfunction requiresApproval(annotations: ToolAnnotations | undefined): boolean {\n if (!annotations) return false;\n if (annotations.destructive === true) return true;\n switch (annotations.effect) {\n case \"write\":\n case \"update\":\n case \"destructive\":\n return true;\n case \"read\":\n case undefined:\n return false;\n default: {\n const _exhaustive: never = annotations.effect;\n return false;\n }\n }\n}\n\n/**\n * Per-stream state shared between the top-level `executeTool` and any\n * `runSubAgent` calls below it. Carrying the budget counter, abort signal,\n * approval policy, and event-channel through one object is what lets the\n * sub-agent path enforce the same limits and approval gate as the parent.\n *\n * Without this shared state the sub-agent path silently bypassed both the\n * tool-call budget and the destructive-tool approval gate.\n */\ninterface RunState {\n req: express.Request;\n userId: string;\n requestId: string;\n abortController: AbortController;\n signal: AbortSignal;\n approvalPolicy: { requireForDestructive: boolean; timeoutMs: number };\n limits: {\n maxConcurrentStreamsPerUser: number;\n maxToolCalls: number;\n maxSubAgentDepth: number;\n toolCallTimeoutMs: number;\n };\n translator: AgentEventTranslator;\n outboundEvents: EventChannel<ResponseStreamEvent>;\n /** Boxed mutable counter shared across parent + all sub-agent dispatches. */\n toolCallsUsed: { count: number };\n}\n\nexport class AgentsPlugin extends Plugin implements ToolProvider {\n static manifest = manifest as PluginManifest;\n static phase: PluginPhase = \"deferred\";\n\n protected declare config: AgentsPluginConfig;\n\n private agents = new Map<string, RegisteredAgent>();\n private defaultAgentName: string | null = null;\n private activeStreams = new Map<\n string,\n { controller: AbortController; userId: string }\n >();\n private mcpClient: AppKitMcpClient | null = null;\n private threadStore;\n private approvalGate = new ToolApprovalGate();\n\n constructor(config: AgentsPluginConfig) {\n super(config);\n this.config = config;\n if (config.threadStore) {\n this.threadStore = config.threadStore;\n } else {\n this.threadStore = new InMemoryThreadStore();\n if (process.env.NODE_ENV === \"production\") {\n logger.warn(\n \"InMemoryThreadStore is in use in a production build (NODE_ENV=production). \" +\n \"Thread history is unbounded and lost on restart. \" +\n \"Pass agents({ threadStore: <persistent impl> }) for real deployments.\",\n );\n } else {\n logger.info(\n \"Using default InMemoryThreadStore (dev-only — threads are lost on restart and grow without bound).\",\n );\n }\n }\n }\n\n /** Effective approval policy with defaults applied. */\n private get resolvedApprovalPolicy(): {\n requireForDestructive: boolean;\n timeoutMs: number;\n } {\n const cfg = this.config.approval ?? {};\n return {\n requireForDestructive: cfg.requireForDestructive ?? true,\n timeoutMs: cfg.timeoutMs ?? 60_000,\n };\n }\n\n /** Effective DoS limits with defaults applied. */\n private get resolvedLimits(): {\n maxConcurrentStreamsPerUser: number;\n maxToolCalls: number;\n maxSubAgentDepth: number;\n toolCallTimeoutMs: number;\n } {\n const cfg = this.config.limits ?? {};\n return {\n maxConcurrentStreamsPerUser: cfg.maxConcurrentStreamsPerUser ?? 5,\n maxToolCalls: cfg.maxToolCalls ?? 50,\n maxSubAgentDepth: cfg.maxSubAgentDepth ?? 3,\n // 5 minutes is the floor for cold SQL Warehouse / long Genie /\n // long Lakebase calls. The previous PluginContext default of 30s\n // truncated legitimate analytics queries on cold compute.\n toolCallTimeoutMs: cfg.toolCallTimeoutMs ?? 300_000,\n };\n }\n\n /** Count active streams owned by a given user. */\n private countUserStreams(userId: string): number {\n let n = 0;\n for (const entry of this.activeStreams.values()) {\n if (entry.userId === userId) n++;\n }\n return n;\n }\n\n async setup() {\n const { agents, defaultAgentName } = await this.buildAgentRegistry();\n this.agents = agents;\n this.defaultAgentName = defaultAgentName;\n this.mountInvocationsRoute();\n this.printRegistry();\n }\n\n /**\n * Reload agents from the configured directory, preserving code-defined\n * agents. Builds a fresh registry first and only swaps on success — if\n * `loadAgents` throws (malformed markdown, missing tool reference) the\n * existing live registry stays in place and serving requests keep working.\n */\n async reload(): Promise<void> {\n const next = await this.buildAgentRegistry();\n if (this.mcpClient) {\n await this.mcpClient.close();\n this.mcpClient = null;\n }\n this.agents = next.agents;\n this.defaultAgentName = next.defaultAgentName;\n }\n\n /**\n * Builds the agent registry into a fresh `Map` without touching live state.\n * Called by both `setup` and `reload`; the latter only swaps the live\n * registry once this resolves successfully (atomic reload).\n */\n private async buildAgentRegistry(): Promise<{\n agents: Map<string, RegisteredAgent>;\n defaultAgentName: string | null;\n }> {\n const { defs: fileDefs, defaultAgent: fileDefault } =\n await this.loadFileDefinitions();\n\n const codeDefs = this.config.agents ?? {};\n\n for (const name of Object.keys(fileDefs)) {\n if (codeDefs[name]) {\n logger.warn(\n \"Agent '%s' defined in both code and a markdown file. Code definition takes precedence.\",\n name,\n );\n }\n }\n\n const merged: Record<string, { def: AgentDefinition; src: AgentSource }> =\n {};\n for (const [name, def] of Object.entries(fileDefs)) {\n merged[name] = { def, src: { origin: \"file\" } };\n }\n for (const [name, def] of Object.entries(codeDefs)) {\n merged[name] = { def, src: { origin: \"code\" } };\n }\n\n const agents = new Map<string, RegisteredAgent>();\n let defaultAgentName: string | null = null;\n\n if (Object.keys(merged).length === 0) {\n logger.info(\n \"No agents registered (no files in %s, no code-defined agents)\",\n this.resolvedAgentsDir() ?? \"<disabled>\",\n );\n return { agents, defaultAgentName };\n }\n\n for (const [name, { def, src }] of Object.entries(merged)) {\n try {\n const registered = await this.buildRegisteredAgent(name, def, src);\n agents.set(name, registered);\n if (!defaultAgentName) defaultAgentName = name;\n } catch (err) {\n throw new Error(\n `Failed to register agent '${name}' (${src.origin}): ${\n err instanceof Error ? err.message : String(err)\n }`,\n { cause: err instanceof Error ? err : undefined },\n );\n }\n }\n\n if (this.config.defaultAgent) {\n if (!agents.has(this.config.defaultAgent)) {\n throw new Error(\n `defaultAgent '${this.config.defaultAgent}' is not registered. Available: ${Array.from(agents.keys()).join(\", \")}`,\n );\n }\n defaultAgentName = this.config.defaultAgent;\n } else if (fileDefault && agents.has(fileDefault)) {\n defaultAgentName = fileDefault;\n }\n\n return { agents, defaultAgentName };\n }\n\n private resolvedAgentsDir(): string | null {\n if (this.config.dir === false) return null;\n const dir = this.config.dir ?? DEFAULT_AGENTS_DIR;\n return path.isAbsolute(dir) ? dir : path.resolve(process.cwd(), dir);\n }\n\n private async loadFileDefinitions(): Promise<{\n defs: Record<string, AgentDefinition>;\n defaultAgent: string | null;\n }> {\n const dir = this.resolvedAgentsDir();\n if (!dir) return { defs: {}, defaultAgent: null };\n\n const pluginToolProviders = this.pluginProviderIndex();\n const ambient = this.config.tools ?? {};\n\n const result = await loadAgentsFromDir(dir, {\n defaultModel: this.config.defaultModel,\n availableTools: ambient,\n plugins: pluginToolProviders,\n codeAgents: this.config.agents,\n });\n\n return result;\n }\n\n /**\n * Builds the map of plugin-name → toolkit that the markdown loader consults\n * when resolving `toolkits:` frontmatter entries.\n */\n private pluginProviderIndex(): Map<\n string,\n { toolkit: (opts?: unknown) => Record<string, unknown> }\n > {\n const out = new Map();\n if (!this.context) return out;\n for (const { name, provider } of this.context.getToolProviders()) {\n const withToolkit = provider as ToolProvider & {\n toolkit?: (opts?: unknown) => Record<string, unknown>;\n };\n if (typeof withToolkit.toolkit === \"function\") {\n out.set(name, {\n toolkit: withToolkit.toolkit.bind(withToolkit),\n });\n }\n }\n return out;\n }\n\n private async buildRegisteredAgent(\n name: string,\n def: AgentDefinition,\n src: AgentSource,\n ): Promise<RegisteredAgent> {\n const adapter = await this.resolveAdapter(def, name);\n const toolIndex = await this.buildToolIndex(name, def, src);\n\n return {\n name,\n instructions: def.instructions,\n adapter,\n toolIndex,\n baseSystemPrompt: def.baseSystemPrompt,\n maxSteps: def.maxSteps,\n maxTokens: def.maxTokens,\n ephemeral: def.ephemeral,\n };\n }\n\n private async resolveAdapter(\n def: AgentDefinition,\n name: string,\n ): Promise<AgentAdapter> {\n const source = def.model ?? this.config.defaultModel;\n // Per-agent adapter knobs from `AgentDefinition` / markdown frontmatter.\n // Only applied when AppKit builds the adapter itself (string or omitted\n // model). Users who pass a pre-built `AgentAdapter` own these settings.\n const adapterOptions: { maxSteps?: number; maxTokens?: number } = {};\n if (def.maxSteps !== undefined) adapterOptions.maxSteps = def.maxSteps;\n if (def.maxTokens !== undefined) adapterOptions.maxTokens = def.maxTokens;\n\n if (!source) {\n const { DatabricksAdapter } = await import(\"../../agents/databricks\");\n try {\n return await DatabricksAdapter.fromModelServing(\n undefined,\n adapterOptions,\n );\n } catch (err) {\n throw new Error(\n `Agent '${name}' has no model configured and no DATABRICKS_AGENT_ENDPOINT default available`,\n { cause: err instanceof Error ? err : undefined },\n );\n }\n }\n if (typeof source === \"string\") {\n const { DatabricksAdapter } = await import(\"../../agents/databricks\");\n return DatabricksAdapter.fromModelServing(source, adapterOptions);\n }\n return await source;\n }\n\n /**\n * Resolves an agent's tool record into a per-agent dispatch index. Connects\n * hosted tools via MCP client. Applies `autoInheritTools` defaults when the\n * definition has no declared tools/agents.\n */\n private async buildToolIndex(\n agentName: string,\n def: AgentDefinition,\n src: AgentSource,\n ): Promise<Map<string, ResolvedToolEntry>> {\n const index = new Map<string, ResolvedToolEntry>();\n const hasExplicitTools = def.tools && Object.keys(def.tools).length > 0;\n const hasExplicitSubAgents =\n def.agents && Object.keys(def.agents).length > 0;\n\n const inheritDefaults = normalizeAutoInherit(this.config.autoInheritTools);\n const shouldInherit =\n !hasExplicitTools &&\n !hasExplicitSubAgents &&\n (src.origin === \"file\" ? inheritDefaults.file : inheritDefaults.code);\n\n if (shouldInherit) {\n await this.applyAutoInherit(agentName, index);\n }\n\n // 1. Sub-agents → agent-<key>\n for (const [childKey, childDef] of Object.entries(def.agents ?? {})) {\n const toolName = `agent-${childKey}`;\n index.set(toolName, {\n source: \"subagent\",\n agentName: childDef.name ?? childKey,\n def: {\n name: toolName,\n description:\n childDef.instructions.slice(0, 120) ||\n `Delegate to the ${childKey} sub-agent`,\n parameters: {\n type: \"object\",\n properties: {\n input: {\n type: \"string\",\n description: \"Message to send to the sub-agent.\",\n },\n },\n required: [\"input\"],\n },\n },\n });\n }\n\n // 2. Explicit tools (toolkit entries, function tools, hosted tools)\n const hostedToCollect: import(\"../../core/agent/tools/hosted-tools\").HostedTool[] =\n [];\n for (const [key, tool] of Object.entries(def.tools ?? {})) {\n if (isToolkitEntry(tool)) {\n index.set(key, {\n source: \"toolkit\",\n pluginName: tool.pluginName,\n localName: tool.localName,\n def: { ...tool.def, name: key },\n });\n continue;\n }\n if (isFunctionTool(tool)) {\n index.set(key, {\n source: \"function\",\n functionTool: tool,\n def: { ...functionToolToDefinition(tool), name: key },\n });\n continue;\n }\n if (isHostedTool(tool)) {\n hostedToCollect.push(tool);\n continue;\n }\n throw new Error(\n `Agent '${agentName}' tool '${key}' has an unrecognized shape`,\n );\n }\n\n if (hostedToCollect.length > 0) {\n await this.connectHostedTools(hostedToCollect, index);\n }\n\n return index;\n }\n\n private async applyAutoInherit(\n agentName: string,\n index: Map<string, ResolvedToolEntry>,\n ): Promise<void> {\n if (!this.context) return;\n const inherited: string[] = [];\n const skippedByPlugin = new Map<string, string[]>();\n const recordSkip = (pluginName: string, localName: string) => {\n const list = skippedByPlugin.get(pluginName) ?? [];\n list.push(localName);\n skippedByPlugin.set(pluginName, list);\n };\n\n for (const {\n name: pluginName,\n provider,\n } of this.context.getToolProviders()) {\n if (pluginName === this.name) continue;\n const withToolkit = provider as ToolProvider & {\n toolkit?: (opts?: unknown) => Record<string, unknown>;\n };\n if (typeof withToolkit.toolkit === \"function\") {\n const entries = withToolkit.toolkit() as Record<string, unknown>;\n for (const [key, maybeEntry] of Object.entries(entries)) {\n if (!isToolkitEntry(maybeEntry)) continue;\n if (maybeEntry.autoInheritable !== true) {\n recordSkip(maybeEntry.pluginName, maybeEntry.localName);\n continue;\n }\n index.set(key, {\n source: \"toolkit\",\n pluginName: maybeEntry.pluginName,\n localName: maybeEntry.localName,\n def: { ...maybeEntry.def, name: key },\n });\n inherited.push(key);\n }\n continue;\n }\n // Fallback: providers without a toolkit() still expose getAgentTools().\n // These cannot be selectively opted in per tool, so we conservatively\n // skip them during auto-inherit and require explicit `tools:` wiring.\n for (const tool of provider.getAgentTools()) {\n recordSkip(pluginName, tool.name);\n }\n }\n\n if (inherited.length > 0) {\n logger.info(\n \"[agent %s] auto-inherited %d tool(s): %s\",\n agentName,\n inherited.length,\n inherited.join(\", \"),\n );\n }\n if (skippedByPlugin.size > 0) {\n const summary = Array.from(skippedByPlugin.entries())\n .map(([p, tools]) => `${p}(${tools.length})`)\n .join(\", \");\n logger.info(\n \"[agent %s] auto-inherit skipped %d tool(s) not marked autoInheritable: %s. Wire them explicitly via `tools:` if needed.\",\n agentName,\n Array.from(skippedByPlugin.values()).reduce(\n (n, list) => n + list.length,\n 0,\n ),\n summary,\n );\n }\n }\n\n private async connectHostedTools(\n hostedTools: import(\"../../core/agent/tools/hosted-tools\").HostedTool[],\n index: Map<string, ResolvedToolEntry>,\n ): Promise<void> {\n let host: string | undefined;\n let authenticate: () => Promise<Record<string, string>>;\n\n try {\n const { getWorkspaceClient } = await import(\"../../context\");\n const wsClient = getWorkspaceClient();\n await wsClient.config.ensureResolved();\n host = wsClient.config.host;\n authenticate = async () => {\n const headers = new Headers();\n await wsClient.config.authenticate(headers);\n return Object.fromEntries(headers.entries());\n };\n } catch {\n host = process.env.DATABRICKS_HOST;\n authenticate = async (): Promise<Record<string, string>> => {\n const token = process.env.DATABRICKS_TOKEN;\n return token ? { Authorization: `Bearer ${token}` } : {};\n };\n }\n\n if (!host) {\n logger.warn(\n \"No Databricks host available — skipping %d hosted tool(s)\",\n hostedTools.length,\n );\n return;\n }\n\n if (!this.mcpClient) {\n const policy = buildMcpHostPolicy(this.config.mcp, host);\n this.mcpClient = new AppKitMcpClient(host, authenticate, policy);\n }\n\n const endpoints = resolveHostedTools(hostedTools);\n await this.mcpClient.connectAll(endpoints);\n\n for (const def of this.mcpClient.getAllToolDefinitions()) {\n index.set(def.name, {\n source: \"mcp\",\n mcpToolName: def.name,\n def,\n });\n }\n }\n\n // ----------------- ToolProvider (no tools of our own) --------------------\n\n getAgentTools(): AgentToolDefinition[] {\n return [];\n }\n\n async executeAgentTool(): Promise<unknown> {\n throw new Error(\"AgentsPlugin does not expose executeAgentTool directly\");\n }\n\n // ----------------- Route mounting and handlers ---------------------------\n\n private mountInvocationsRoute() {\n if (!this.context) return;\n this.context.addRoute(\n \"post\",\n \"/invocations\",\n (req: express.Request, res: express.Response) => {\n this._handleInvocations(req, res);\n },\n );\n }\n\n injectRoutes(router: IAppRouter) {\n this.route(router, {\n name: \"chat\",\n method: \"post\",\n path: \"/chat\",\n handler: async (req, res) => this._handleChat(req, res),\n });\n this.route(router, {\n name: \"cancel\",\n method: \"post\",\n path: \"/cancel\",\n handler: async (req, res) => this._handleCancel(req, res),\n });\n this.route(router, {\n name: \"approve\",\n method: \"post\",\n path: \"/approve\",\n handler: async (req, res) => this._handleApprove(req, res),\n });\n this.route(router, {\n name: \"threads\",\n method: \"get\",\n path: \"/threads\",\n handler: async (req, res) => this._handleListThreads(req, res),\n });\n this.route(router, {\n name: \"thread\",\n method: \"get\",\n path: \"/threads/:threadId\",\n handler: async (req, res) => this._handleGetThread(req, res),\n });\n this.route(router, {\n name: \"deleteThread\",\n method: \"delete\",\n path: \"/threads/:threadId\",\n handler: async (req, res) => this._handleDeleteThread(req, res),\n });\n this.route(router, {\n name: \"info\",\n method: \"get\",\n path: \"/info\",\n handler: async (_req, res) => {\n res.json({\n agents: Array.from(this.agents.keys()),\n defaultAgent: this.defaultAgentName,\n });\n },\n });\n }\n\n clientConfig(): Record<string, unknown> {\n return {\n agents: Array.from(this.agents.keys()),\n defaultAgent: this.defaultAgentName,\n };\n }\n\n private async _handleChat(req: express.Request, res: express.Response) {\n const parsed = chatRequestSchema.safeParse(req.body);\n if (!parsed.success) {\n res.status(400).json({\n error: \"Invalid request\",\n details: parsed.error.flatten().fieldErrors,\n });\n return;\n }\n const { message, threadId, agent: agentName } = parsed.data;\n\n const registered = this.resolveAgent(agentName);\n if (!registered) {\n res.status(400).json({\n error: agentName\n ? `Agent \"${agentName}\" not found`\n : \"No agent registered\",\n });\n return;\n }\n\n const userId = this.resolveUserId(req);\n\n // Reject early (before allocating a thread) when the user is already at\n // their concurrent-stream limit. Prevents a misbehaving client from\n // churning thread rows while being denied elsewhere.\n const limits = this.resolvedLimits;\n if (this.countUserStreams(userId) >= limits.maxConcurrentStreamsPerUser) {\n res.setHeader(\"Retry-After\", \"5\");\n res.status(429).json({\n error: `Too many concurrent streams for this user (limit ${limits.maxConcurrentStreamsPerUser}). Wait for an existing stream to complete before starting another.`,\n });\n return;\n }\n\n let thread = threadId ? await this.threadStore.get(threadId, userId) : null;\n if (threadId && !thread) {\n res.status(404).json({ error: `Thread ${threadId} not found` });\n return;\n }\n if (!thread) {\n thread = await this.threadStore.create(userId);\n }\n\n const userMessage: Message = {\n id: randomUUID(),\n role: \"user\",\n content: message,\n createdAt: new Date(),\n };\n await this.threadStore.addMessage(thread.id, userId, userMessage);\n return this._streamAgent(req, res, registered, thread, userId);\n }\n\n private async _handleInvocations(\n req: express.Request,\n res: express.Response,\n ) {\n const parsed = invocationsRequestSchema.safeParse(req.body);\n if (!parsed.success) {\n res.status(400).json({\n error: \"Invalid request\",\n details: parsed.error.flatten().fieldErrors,\n });\n return;\n }\n const { input } = parsed.data;\n const registered = this.resolveAgent();\n if (!registered) {\n res.status(400).json({ error: \"No agent registered\" });\n return;\n }\n const userId = this.resolveUserId(req);\n\n // Match the rate-limit gate on /chat. Without this, a client can bypass\n // `limits.maxConcurrentStreamsPerUser` by hitting /invocations instead.\n const limits = this.resolvedLimits;\n if (this.countUserStreams(userId) >= limits.maxConcurrentStreamsPerUser) {\n res.setHeader(\"Retry-After\", \"5\");\n res.status(429).json({\n error: `Too many concurrent streams for this user (limit ${limits.maxConcurrentStreamsPerUser}). Wait for an existing stream to complete before starting another.`,\n });\n return;\n }\n\n const thread = await this.threadStore.create(userId);\n\n if (typeof input === \"string\") {\n await this.threadStore.addMessage(thread.id, userId, {\n id: randomUUID(),\n role: \"user\",\n content: input,\n createdAt: new Date(),\n });\n } else {\n for (const item of input) {\n const role = (item.role ?? \"user\") as Message[\"role\"];\n const content =\n typeof item.content === \"string\"\n ? item.content\n : JSON.stringify(item.content ?? \"\");\n if (!content) continue;\n await this.threadStore.addMessage(thread.id, userId, {\n id: randomUUID(),\n role,\n content,\n createdAt: new Date(),\n });\n }\n }\n\n return this._streamAgent(req, res, registered, thread, userId);\n }\n\n private async _streamAgent(\n req: express.Request,\n res: express.Response,\n registered: RegisteredAgent,\n thread: Thread,\n userId: string,\n ): Promise<void> {\n const abortController = new AbortController();\n const signal = abortController.signal;\n const requestId = randomUUID();\n this.activeStreams.set(requestId, { controller: abortController, userId });\n\n const tools = Array.from(registered.toolIndex.values()).map((e) => e.def);\n const approvalPolicy = this.resolvedApprovalPolicy;\n const limits = this.resolvedLimits;\n const outboundEvents = new EventChannel<ResponseStreamEvent>();\n const translator = new AgentEventTranslator();\n\n // Per-run state shared with any sub-agents this run invokes. The boxed\n // tool-call counter, approval policy, and outbound event channel must\n // travel through the sub-agent path so it enforces the same budget and\n // approval gate as the top-level executeTool.\n const runState: RunState = {\n req,\n userId,\n requestId,\n abortController,\n signal,\n approvalPolicy,\n limits,\n translator,\n outboundEvents,\n toolCallsUsed: { count: 0 },\n };\n\n const executeTool = (name: string, args: unknown): Promise<unknown> =>\n this.dispatchToolCall(runState, registered.toolIndex, name, args, 0);\n\n // Drive the adapter and the approval-event side-channel concurrently.\n // Outbound events from both sources flow through `outboundEvents`; the\n // generator below drains the channel in order. executeTool pushes\n // approval-pending events into the same channel before awaiting the gate.\n const driver = (async () => {\n try {\n for (const evt of translator.translate({\n type: \"metadata\",\n data: { threadId: thread.id },\n })) {\n outboundEvents.push(evt);\n }\n\n const pluginNames = this.context\n ? this.context\n .getPluginNames()\n .filter((n) => n !== this.name && n !== \"server\")\n : [];\n const fullPrompt = composePromptForAgent(\n registered,\n this.config.baseSystemPrompt,\n {\n agentName: registered.name,\n pluginNames,\n toolNames: tools.map((t) => t.name),\n },\n );\n\n const messagesWithSystem: Message[] = [\n {\n id: \"system\",\n role: \"system\",\n content: fullPrompt,\n createdAt: new Date(),\n },\n ...thread.messages,\n ];\n\n const stream = registered.adapter.run(\n {\n messages: messagesWithSystem,\n tools,\n threadId: thread.id,\n signal,\n },\n { executeTool, signal },\n );\n\n // The accumulation rule (deltas append, `message` replaces) is shared\n // with `runAgent` and `runSubAgent`; see `consumeAdapterStream` for\n // the rationale.\n const fullContent = await consumeAdapterStream(stream, {\n signal,\n onEvent: (event) => {\n for (const translated of translator.translate(event)) {\n outboundEvents.push(translated);\n }\n },\n });\n\n if (fullContent) {\n await this.threadStore.addMessage(thread.id, userId, {\n id: randomUUID(),\n role: \"assistant\",\n content: fullContent,\n createdAt: new Date(),\n });\n }\n\n for (const evt of translator.finalize()) outboundEvents.push(evt);\n } catch (error) {\n if (signal.aborted) {\n outboundEvents.close();\n return;\n }\n logger.error(\"Agent chat error: %O\", error);\n outboundEvents.close(error);\n return;\n } finally {\n // Any pending approval gates for this stream are auto-denied so the\n // adapter can unwind if it was still waiting.\n this.approvalGate.abortStream(requestId);\n this.activeStreams.delete(requestId);\n // Stateless agents (e.g. autocomplete) don't persist history; drop\n // the thread so `InMemoryThreadStore` doesn't accumulate one record\n // per request. Swallow delete errors — the stream has already\n // finished and the client has the response.\n if (registered.ephemeral) {\n try {\n await this.threadStore.delete(thread.id, userId);\n } catch (err) {\n logger.warn(\n \"Failed to delete ephemeral thread %s: %O\",\n thread.id,\n err,\n );\n }\n }\n }\n outboundEvents.close();\n })();\n\n await this.executeStream<ResponseStreamEvent>(\n res,\n async function* () {\n try {\n for await (const ev of outboundEvents) {\n yield ev;\n }\n } finally {\n await driver.catch(() => undefined);\n }\n },\n {\n ...agentStreamDefaults,\n stream: { ...agentStreamDefaults.stream, streamId: requestId },\n },\n );\n }\n\n /**\n * Dispatch a single tool call from either the top-level adapter or a\n * sub-agent. Centralising this in one method is what makes the budget\n * counter, approval gate, and abort signal observe sub-agent activity:\n * `runSubAgent` reuses the same `runState` and so increments the same\n * counter and emits approval events through the same channel.\n *\n * `depth` is the current sub-agent recursion depth (0 at the top level).\n * It is forwarded to `runSubAgent` when the dispatched entry is itself a\n * sub-agent, so depth limits remain enforced.\n */\n private async dispatchToolCall(\n runState: RunState,\n toolIndex: Map<string, ResolvedToolEntry>,\n name: string,\n args: unknown,\n depth: number,\n ): Promise<unknown> {\n if (runState.toolCallsUsed.count >= runState.limits.maxToolCalls) {\n runState.abortController.abort(\n new Error(\n `Tool-call budget exhausted (limit ${runState.limits.maxToolCalls}).`,\n ),\n );\n throw new Error(\n `Tool-call budget exhausted (limit ${runState.limits.maxToolCalls}). Raise agents({ limits: { maxToolCalls } }) or review the agent's tool-selection logic.`,\n );\n }\n runState.toolCallsUsed.count++;\n\n const entry = toolIndex.get(name);\n if (!entry) throw new Error(`Unknown tool: ${name}`);\n\n if (\n runState.approvalPolicy.requireForDestructive &&\n requiresApproval(entry.def.annotations)\n ) {\n const approvalId = randomUUID();\n for (const ev of runState.translator.translate({\n type: \"approval_pending\",\n approvalId,\n streamId: runState.requestId,\n toolName: name,\n args,\n annotations: entry.def.annotations,\n })) {\n runState.outboundEvents.push(ev);\n }\n const decision = await this.approvalGate.wait({\n approvalId,\n streamId: runState.requestId,\n userId: runState.userId,\n timeoutMs: runState.approvalPolicy.timeoutMs,\n });\n if (decision === \"deny\") {\n return `Tool execution denied by user approval gate (tool: ${name}).`;\n }\n }\n\n let result: unknown;\n if (entry.source === \"toolkit\") {\n if (!this.context) {\n throw new Error(\n \"Plugin tool execution requires PluginContext; this should never happen through createApp\",\n );\n }\n result = await this.context.executeTool(\n runState.req,\n entry.pluginName,\n entry.localName,\n args,\n runState.signal,\n runState.limits.toolCallTimeoutMs,\n );\n } else if (entry.source === \"function\") {\n result = await entry.functionTool.execute(\n args as Record<string, unknown>,\n );\n } else if (entry.source === \"mcp\") {\n if (!this.mcpClient) throw new Error(\"MCP client not connected\");\n const oboToken = runState.req.headers[\"x-forwarded-access-token\"];\n const mcpAuth =\n typeof oboToken === \"string\"\n ? { Authorization: `Bearer ${oboToken}` }\n : undefined;\n result = await this.mcpClient.callTool(entry.mcpToolName, args, mcpAuth);\n } else if (entry.source === \"subagent\") {\n const childAgent = this.agents.get(entry.agentName);\n if (!childAgent)\n throw new Error(`Sub-agent not found: ${entry.agentName}`);\n result = await this.runSubAgent(runState, childAgent, args, depth + 1);\n }\n\n return normalizeToolResult(result);\n }\n\n /**\n * Runs a sub-agent in response to an `agent-<key>` tool call. Returns the\n * concatenated text output to hand back to the parent adapter as the tool\n * result.\n *\n * `depth` starts at 1 for a top-level sub-agent invocation (i.e. the\n * outer `_streamAgent` calls `runSubAgent(..., 1)`) and increments on\n * each nested `runSubAgent` call. Depths exceeding\n * `limits.maxSubAgentDepth` are rejected before any adapter work.\n *\n * Sub-agent tool calls run through `dispatchToolCall` with the same\n * `runState` as the parent — the budget counter and approval gate are\n * therefore enforced for every nested call, not only at the top level.\n */\n private async runSubAgent(\n runState: RunState,\n child: RegisteredAgent,\n args: unknown,\n depth: number,\n ): Promise<string> {\n if (depth > runState.limits.maxSubAgentDepth) {\n throw new Error(\n `Sub-agent depth exceeded (limit ${runState.limits.maxSubAgentDepth}). ` +\n `Raise agents({ limits: { maxSubAgentDepth } }) or break the delegation cycle.`,\n );\n }\n\n const input =\n typeof args === \"object\" &&\n args !== null &&\n typeof (args as { input?: unknown }).input === \"string\"\n ? (args as { input: string }).input\n : JSON.stringify(args);\n const childTools = Array.from(child.toolIndex.values()).map((e) => e.def);\n\n const childExecute = (name: string, childArgs: unknown): Promise<unknown> =>\n this.dispatchToolCall(runState, child.toolIndex, name, childArgs, depth);\n\n const runContext: AgentRunContext = {\n executeTool: childExecute,\n signal: runState.signal,\n };\n\n const pluginNames = this.context\n ? this.context\n .getPluginNames()\n .filter((n) => n !== this.name && n !== \"server\")\n : [];\n const systemPrompt = composePromptForAgent(\n child,\n this.config.baseSystemPrompt,\n {\n agentName: child.name,\n pluginNames,\n toolNames: childTools.map((t) => t.name),\n },\n );\n\n const messages: Message[] = [\n {\n id: \"system\",\n role: \"system\",\n content: systemPrompt,\n createdAt: new Date(),\n },\n {\n id: randomUUID(),\n role: \"user\",\n content: input,\n createdAt: new Date(),\n },\n ];\n\n return consumeAdapterStream(\n child.adapter.run(\n {\n messages,\n tools: childTools,\n threadId: randomUUID(),\n signal: runState.signal,\n },\n runContext,\n ),\n {\n signal: runState.signal,\n // Forward every sub-agent event into the parent's outbound SSE\n // stream so the client sees nested tool_call / tool_result events\n // (UI-action tools like apply_filter / highlight_period rely on\n // this) and the sub-agent's streaming text as it's generated.\n //\n // `metadata` is the one exception: sub-agents have their own\n // threadId, and forwarding it would overwrite the parent's\n // thread state on the client and break multi-turn continuity.\n // Approval-pending events emitted by `dispatchToolCall` already\n // reach `outboundEvents` directly, so they are not routed here.\n onEvent: (event) => {\n if (event.type === \"metadata\") return;\n for (const translated of runState.translator.translate(event)) {\n runState.outboundEvents.push(translated);\n }\n },\n },\n );\n }\n\n private async _handleCancel(req: express.Request, res: express.Response) {\n const parsed = cancelRequestSchema.safeParse(req.body);\n if (!parsed.success) {\n res.status(400).json({\n error: \"Invalid request\",\n details: parsed.error.flatten().fieldErrors,\n });\n return;\n }\n const { streamId } = parsed.data;\n const entry = this.activeStreams.get(streamId);\n if (!entry) {\n // Stream is unknown or already completed — idempotent no-op.\n res.json({ cancelled: true });\n return;\n }\n const userId = this.resolveUserId(req);\n if (entry.userId !== userId) {\n res.status(403).json({ error: \"Forbidden\" });\n return;\n }\n entry.controller.abort(\"Cancelled by user\");\n this.activeStreams.delete(streamId);\n this.approvalGate.abortStream(streamId);\n res.json({ cancelled: true });\n }\n\n private async _handleApprove(req: express.Request, res: express.Response) {\n const parsed = approvalRequestSchema.safeParse(req.body);\n if (!parsed.success) {\n res.status(400).json({\n error: \"Invalid request\",\n details: parsed.error.flatten().fieldErrors,\n });\n return;\n }\n const { streamId, approvalId, decision } = parsed.data;\n\n const streamEntry = this.activeStreams.get(streamId);\n if (!streamEntry) {\n // Stream has already completed or never existed. Return 404 so the UI\n // knows the approval token is no longer valid (the waiter, if any, has\n // already been timed out or aborted).\n res.status(404).json({ error: \"Stream not found or already completed\" });\n return;\n }\n\n const userId = this.resolveUserId(req);\n if (streamEntry.userId !== userId) {\n res.status(403).json({ error: \"Forbidden\" });\n return;\n }\n\n const result = this.approvalGate.submit({ approvalId, userId, decision });\n if (!result.ok) {\n if (result.reason === \"forbidden\") {\n res.status(403).json({ error: \"Forbidden\" });\n return;\n }\n res.status(404).json({ error: \"Approval not found or already settled\" });\n return;\n }\n\n res.json({ decision });\n }\n\n private async _handleListThreads(\n req: express.Request,\n res: express.Response,\n ) {\n const userId = this.resolveUserId(req);\n const threads = await this.threadStore.list(userId);\n res.json({ threads });\n }\n\n private async _handleGetThread(req: express.Request, res: express.Response) {\n const userId = this.resolveUserId(req);\n const thread = await this.threadStore.get(req.params.threadId, userId);\n if (!thread) {\n res.status(404).json({ error: \"Thread not found\" });\n return;\n }\n res.json(thread);\n }\n\n private async _handleDeleteThread(\n req: express.Request,\n res: express.Response,\n ) {\n const userId = this.resolveUserId(req);\n const deleted = await this.threadStore.delete(req.params.threadId, userId);\n if (!deleted) {\n res.status(404).json({ error: \"Thread not found\" });\n return;\n }\n res.json({ deleted: true });\n }\n\n private resolveAgent(name?: string): RegisteredAgent | null {\n if (name) return this.agents.get(name) ?? null;\n if (this.defaultAgentName) {\n return this.agents.get(this.defaultAgentName) ?? null;\n }\n const first = this.agents.values().next();\n return first.done ? null : first.value;\n }\n\n private printRegistry(): void {\n if (this.agents.size === 0) return;\n console.log(\"\");\n console.log(` ${pc.bold(\"Agents\")} ${pc.dim(`(${this.agents.size})`)}`);\n console.log(` ${pc.dim(\"─\".repeat(60))}`);\n for (const [name, reg] of this.agents) {\n const tools = reg.toolIndex.size;\n const marker = name === this.defaultAgentName ? pc.green(\"●\") : \" \";\n console.log(\n ` ${marker} ${pc.bold(name.padEnd(24))} ${pc.dim(`${tools} tools`)}`,\n );\n }\n console.log(` ${pc.dim(\"─\".repeat(60))}`);\n console.log(\"\");\n }\n\n async shutdown(): Promise<void> {\n this.approvalGate.abortAll();\n if (this.mcpClient) {\n await this.mcpClient.close();\n this.mcpClient = null;\n }\n }\n\n exports() {\n return {\n register: (name: string, def: AgentDefinition) =>\n this.registerCodeAgent(name, def),\n list: () => Array.from(this.agents.keys()),\n get: (name: string) => this.agents.get(name) ?? null,\n reload: () => this.reload(),\n getDefault: () => this.defaultAgentName,\n getThreads: (userId: string) => this.threadStore.list(userId),\n };\n }\n\n private async registerCodeAgent(\n name: string,\n def: AgentDefinition,\n ): Promise<void> {\n const registered = await this.buildRegisteredAgent(name, def, {\n origin: \"code\",\n });\n this.agents.set(name, registered);\n if (!this.defaultAgentName) this.defaultAgentName = name;\n }\n}\n\nfunction normalizeAutoInherit(value: AgentsPluginConfig[\"autoInheritTools\"]): {\n file: boolean;\n code: boolean;\n} {\n // Default is opt-out for both origins. A markdown agent or code-defined\n // agent with no declared `tools:` gets an empty tool index unless the\n // developer explicitly flips `autoInheritTools` on. Even then, only tools\n // whose plugin author marked `autoInheritable: true` are spread — see\n // `applyAutoInherit` for the filter.\n if (value === undefined) return { file: false, code: false };\n if (typeof value === \"boolean\") return { file: value, code: value };\n return { file: value.file ?? false, code: value.code ?? false };\n}\n\nfunction composePromptForAgent(\n registered: RegisteredAgent,\n pluginLevel: BaseSystemPromptOption | undefined,\n ctx: PromptContext,\n): string {\n const perAgent = registered.baseSystemPrompt;\n const resolved = perAgent !== undefined ? perAgent : pluginLevel;\n\n let base = \"\";\n if (resolved === false) {\n base = \"\";\n } else if (typeof resolved === \"string\") {\n base = resolved;\n } else if (typeof resolved === \"function\") {\n base = resolved(ctx);\n } else {\n base = buildBaseSystemPrompt(ctx);\n }\n\n return composeSystemPrompt(base, registered.instructions);\n}\n\n/**\n * Plugin factory for the agents plugin. Reads `config/agents/*.md` by default,\n * resolves toolkits/tools from registered plugins, exposes `appkit.agents.*`\n * runtime API and mounts `/invocations`.\n *\n * @example\n * ```ts\n * import { agents, analytics, createApp, server } from \"@databricks/appkit\";\n *\n * await createApp({\n * plugins: [server(), analytics(), agents()],\n * });\n * ```\n */\nexport const agents = toPlugin(AgentsPlugin);\n"],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ //#region src/plugins/agents/defaults.ts
2
+ const agentStreamDefaults = {
3
+ default: {
4
+ cache: { enabled: false },
5
+ retry: { enabled: false },
6
+ timeout: 3e5
7
+ },
8
+ stream: { bufferSize: 200 }
9
+ };
10
+
11
+ //#endregion
12
+ export { agentStreamDefaults };
13
+ //# sourceMappingURL=defaults.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"defaults.js","names":[],"sources":["../../../src/plugins/agents/defaults.ts"],"sourcesContent":["import type { StreamExecutionSettings } from \"shared\";\n\nexport const agentStreamDefaults: StreamExecutionSettings = {\n default: {\n cache: { enabled: false },\n retry: { enabled: false },\n timeout: 300_000,\n },\n stream: {\n bufferSize: 200,\n },\n};\n"],"mappings":";AAEA,MAAa,sBAA+C;CAC1D,SAAS;EACP,OAAO,EAAE,SAAS,OAAO;EACzB,OAAO,EAAE,SAAS,OAAO;EACzB,SAAS;EACV;CACD,QAAQ,EACN,YAAY,KACb;CACF"}
@@ -0,0 +1,64 @@
1
+ //#region src/plugins/agents/event-channel.ts
2
+ var EventChannel = class {
3
+ queue = [];
4
+ waiters = [];
5
+ closed = false;
6
+ error = void 0;
7
+ /** Synchronously enqueue an event. Safe to call from non-async contexts. */
8
+ push(value) {
9
+ if (this.closed) return;
10
+ const waiter = this.waiters.shift();
11
+ if (waiter) waiter.resolve({
12
+ value,
13
+ done: false
14
+ });
15
+ else this.queue.push(value);
16
+ }
17
+ /**
18
+ * Close the channel. Any pending `next()` calls resolve with `done: true`.
19
+ * If `error` is supplied, pending `next()` calls reject with it and future
20
+ * calls do the same.
21
+ */
22
+ close(error) {
23
+ if (this.closed) return;
24
+ this.closed = true;
25
+ this.error = error;
26
+ while (this.waiters.length > 0) {
27
+ const waiter = this.waiters.shift();
28
+ if (!waiter) break;
29
+ if (error) waiter.reject(error);
30
+ else waiter.resolve({
31
+ value: void 0,
32
+ done: true
33
+ });
34
+ }
35
+ }
36
+ [Symbol.asyncIterator]() {
37
+ return { next: () => {
38
+ if (this.queue.length > 0) {
39
+ const value = this.queue.shift();
40
+ return Promise.resolve({
41
+ value,
42
+ done: false
43
+ });
44
+ }
45
+ if (this.closed) {
46
+ if (this.error) return Promise.reject(this.error);
47
+ return Promise.resolve({
48
+ value: void 0,
49
+ done: true
50
+ });
51
+ }
52
+ return new Promise((resolve, reject) => {
53
+ this.waiters.push({
54
+ resolve,
55
+ reject
56
+ });
57
+ });
58
+ } };
59
+ }
60
+ };
61
+
62
+ //#endregion
63
+ export { EventChannel };
64
+ //# sourceMappingURL=event-channel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-channel.js","names":[],"sources":["../../../src/plugins/agents/event-channel.ts"],"sourcesContent":["/**\n * Single-producer/single-consumer async queue used by the agents plugin to\n * merge streams of SSE events from two concurrent sources: the adapter's\n * `run()` generator, and out-of-band events emitted by `executeTool` (e.g.\n * human-approval requests).\n *\n * The consumer drains the channel as an async iterable; the producer pushes\n * events synchronously and closes the channel when the source has completed\n * or errored.\n */\ninterface Waiter<T> {\n resolve: (value: IteratorResult<T>) => void;\n reject: (error: unknown) => void;\n}\n\nexport class EventChannel<T> {\n private queue: T[] = [];\n private waiters: Array<Waiter<T>> = [];\n private closed = false;\n private error: unknown = undefined;\n\n /** Synchronously enqueue an event. Safe to call from non-async contexts. */\n push(value: T): void {\n if (this.closed) return;\n const waiter = this.waiters.shift();\n if (waiter) {\n waiter.resolve({ value, done: false });\n } else {\n this.queue.push(value);\n }\n }\n\n /**\n * Close the channel. Any pending `next()` calls resolve with `done: true`.\n * If `error` is supplied, pending `next()` calls reject with it and future\n * calls do the same.\n */\n close(error?: unknown): void {\n if (this.closed) return;\n this.closed = true;\n this.error = error;\n while (this.waiters.length > 0) {\n const waiter = this.waiters.shift();\n if (!waiter) break;\n if (error) {\n waiter.reject(error);\n } else {\n waiter.resolve({ value: undefined as never, done: true });\n }\n }\n }\n\n [Symbol.asyncIterator](): AsyncIterator<T> {\n return {\n next: (): Promise<IteratorResult<T>> => {\n if (this.queue.length > 0) {\n const value = this.queue.shift() as T;\n return Promise.resolve({ value, done: false });\n }\n if (this.closed) {\n if (this.error) return Promise.reject(this.error);\n return Promise.resolve({ value: undefined as never, done: true });\n }\n return new Promise((resolve, reject) => {\n this.waiters.push({ resolve, reject });\n });\n },\n };\n }\n}\n"],"mappings":";AAeA,IAAa,eAAb,MAA6B;CAC3B,AAAQ,QAAa,EAAE;CACvB,AAAQ,UAA4B,EAAE;CACtC,AAAQ,SAAS;CACjB,AAAQ,QAAiB;;CAGzB,KAAK,OAAgB;AACnB,MAAI,KAAK,OAAQ;EACjB,MAAM,SAAS,KAAK,QAAQ,OAAO;AACnC,MAAI,OACF,QAAO,QAAQ;GAAE;GAAO,MAAM;GAAO,CAAC;MAEtC,MAAK,MAAM,KAAK,MAAM;;;;;;;CAS1B,MAAM,OAAuB;AAC3B,MAAI,KAAK,OAAQ;AACjB,OAAK,SAAS;AACd,OAAK,QAAQ;AACb,SAAO,KAAK,QAAQ,SAAS,GAAG;GAC9B,MAAM,SAAS,KAAK,QAAQ,OAAO;AACnC,OAAI,CAAC,OAAQ;AACb,OAAI,MACF,QAAO,OAAO,MAAM;OAEpB,QAAO,QAAQ;IAAE,OAAO;IAAoB,MAAM;IAAM,CAAC;;;CAK/D,CAAC,OAAO,iBAAmC;AACzC,SAAO,EACL,YAAwC;AACtC,OAAI,KAAK,MAAM,SAAS,GAAG;IACzB,MAAM,QAAQ,KAAK,MAAM,OAAO;AAChC,WAAO,QAAQ,QAAQ;KAAE;KAAO,MAAM;KAAO,CAAC;;AAEhD,OAAI,KAAK,QAAQ;AACf,QAAI,KAAK,MAAO,QAAO,QAAQ,OAAO,KAAK,MAAM;AACjD,WAAO,QAAQ,QAAQ;KAAE,OAAO;KAAoB,MAAM;KAAM,CAAC;;AAEnE,UAAO,IAAI,SAAS,SAAS,WAAW;AACtC,SAAK,QAAQ,KAAK;KAAE;KAAS;KAAQ,CAAC;KACtC;KAEL"}
@@ -0,0 +1,224 @@
1
+ import { randomUUID } from "node:crypto";
2
+
3
+ //#region src/plugins/agents/event-translator.ts
4
+ /**
5
+ * Translates internal `AgentEvent` stream into Responses API SSE events.
6
+ *
7
+ * Stateful: one instance per streaming request. Tracks sequence numbers and
8
+ * allocates `output_index` strictly monotonically — each emitted output
9
+ * item (message, function call, function call output) claims the next
10
+ * available index and, once claimed, never reuses an earlier one. This is a
11
+ * Responses-API contract that OpenAI's own SDK parsers enforce.
12
+ *
13
+ * A message is opened lazily on the first `message_delta` or `message`
14
+ * event. If a `tool_call` or `tool_result` arrives while a message is open
15
+ * (common ReAct flow: partial text → tool call → more text), the open
16
+ * message is closed (`response.output_item.done`) BEFORE the tool item is
17
+ * added, so subsequent text resumes as a new message item at a strictly
18
+ * later index.
19
+ */
20
+ var AgentEventTranslator = class {
21
+ seqNum = 0;
22
+ nextOutputIndex = 0;
23
+ currentMessage = null;
24
+ finalized = false;
25
+ translate(event) {
26
+ switch (event.type) {
27
+ case "message_delta": return this.handleMessageDelta(event.content);
28
+ case "message": return this.handleFullMessage(event.content);
29
+ case "tool_call": return this.handleToolCall(event.callId, event.name, event.args);
30
+ case "tool_result": return this.handleToolResult(event.callId, event.result, event.error);
31
+ case "thinking": return [{
32
+ type: "appkit.thinking",
33
+ content: event.content,
34
+ sequence_number: this.seqNum++
35
+ }];
36
+ case "metadata": return [{
37
+ type: "appkit.metadata",
38
+ data: event.data,
39
+ sequence_number: this.seqNum++
40
+ }];
41
+ case "approval_pending": return [{
42
+ type: "appkit.approval_pending",
43
+ approval_id: event.approvalId,
44
+ stream_id: event.streamId,
45
+ tool_name: event.toolName,
46
+ args: event.args,
47
+ annotations: event.annotations,
48
+ sequence_number: this.seqNum++
49
+ }];
50
+ case "status": return this.handleStatus(event.status, event.error);
51
+ }
52
+ }
53
+ finalize() {
54
+ if (this.finalized) return [];
55
+ this.finalized = true;
56
+ const events = [];
57
+ const closeEvent = this.closeCurrentMessage();
58
+ if (closeEvent) events.push(closeEvent);
59
+ events.push({
60
+ type: "response.completed",
61
+ sequence_number: this.seqNum++,
62
+ response: {}
63
+ });
64
+ return events;
65
+ }
66
+ handleMessageDelta(content) {
67
+ const events = [];
68
+ if (!this.currentMessage) {
69
+ const id = `msg_${randomUUID()}`;
70
+ const outputIndex = this.nextOutputIndex++;
71
+ this.currentMessage = {
72
+ id,
73
+ text: content,
74
+ outputIndex
75
+ };
76
+ const item = {
77
+ type: "message",
78
+ id,
79
+ status: "in_progress",
80
+ role: "assistant",
81
+ content: []
82
+ };
83
+ events.push({
84
+ type: "response.output_item.added",
85
+ output_index: outputIndex,
86
+ item,
87
+ sequence_number: this.seqNum++
88
+ });
89
+ } else this.currentMessage.text += content;
90
+ events.push({
91
+ type: "response.output_text.delta",
92
+ item_id: this.currentMessage.id,
93
+ output_index: this.currentMessage.outputIndex,
94
+ content_index: 0,
95
+ delta: content,
96
+ sequence_number: this.seqNum++
97
+ });
98
+ return events;
99
+ }
100
+ handleFullMessage(content) {
101
+ const events = [];
102
+ if (!this.currentMessage) {
103
+ const id = `msg_${randomUUID()}`;
104
+ const outputIndex = this.nextOutputIndex++;
105
+ this.currentMessage = {
106
+ id,
107
+ text: content,
108
+ outputIndex
109
+ };
110
+ const addedItem = {
111
+ type: "message",
112
+ id,
113
+ status: "in_progress",
114
+ role: "assistant",
115
+ content: []
116
+ };
117
+ events.push({
118
+ type: "response.output_item.added",
119
+ output_index: outputIndex,
120
+ item: addedItem,
121
+ sequence_number: this.seqNum++
122
+ });
123
+ } else this.currentMessage.text = content;
124
+ const closeEvent = this.closeCurrentMessage();
125
+ if (closeEvent) events.push(closeEvent);
126
+ return events;
127
+ }
128
+ handleToolCall(callId, name, args) {
129
+ const events = [];
130
+ const closeEvent = this.closeCurrentMessage();
131
+ if (closeEvent) events.push(closeEvent);
132
+ const outputIndex = this.nextOutputIndex++;
133
+ const item = {
134
+ type: "function_call",
135
+ id: `fc_${randomUUID()}`,
136
+ call_id: callId,
137
+ name,
138
+ arguments: typeof args === "string" ? args : JSON.stringify(args)
139
+ };
140
+ events.push({
141
+ type: "response.output_item.added",
142
+ output_index: outputIndex,
143
+ item,
144
+ sequence_number: this.seqNum++
145
+ }, {
146
+ type: "response.output_item.done",
147
+ output_index: outputIndex,
148
+ item,
149
+ sequence_number: this.seqNum++
150
+ });
151
+ return events;
152
+ }
153
+ handleToolResult(callId, result, error) {
154
+ const events = [];
155
+ const closeEvent = this.closeCurrentMessage();
156
+ if (closeEvent) events.push(closeEvent);
157
+ const outputIndex = this.nextOutputIndex++;
158
+ let output;
159
+ if (error !== void 0) output = error;
160
+ else if (typeof result === "string") output = result;
161
+ else if (result === void 0) output = "";
162
+ else output = JSON.stringify(result);
163
+ const item = {
164
+ type: "function_call_output",
165
+ id: `fc_output_${randomUUID()}`,
166
+ call_id: callId,
167
+ output
168
+ };
169
+ events.push({
170
+ type: "response.output_item.added",
171
+ output_index: outputIndex,
172
+ item,
173
+ sequence_number: this.seqNum++
174
+ }, {
175
+ type: "response.output_item.done",
176
+ output_index: outputIndex,
177
+ item,
178
+ sequence_number: this.seqNum++
179
+ });
180
+ return events;
181
+ }
182
+ /**
183
+ * Emit an `response.output_item.done` for the currently-open message, if
184
+ * any, and clear the state. Returns the event to the caller so it can be
185
+ * pushed at the right moment in the sequence. Returns `null` when there
186
+ * is no open message.
187
+ */
188
+ closeCurrentMessage() {
189
+ if (!this.currentMessage) return null;
190
+ const { id, text, outputIndex } = this.currentMessage;
191
+ this.currentMessage = null;
192
+ return {
193
+ type: "response.output_item.done",
194
+ output_index: outputIndex,
195
+ item: {
196
+ type: "message",
197
+ id,
198
+ status: "completed",
199
+ role: "assistant",
200
+ content: [{
201
+ type: "output_text",
202
+ text
203
+ }]
204
+ },
205
+ sequence_number: this.seqNum++
206
+ };
207
+ }
208
+ handleStatus(status, error) {
209
+ if (status === "error") return [{
210
+ type: "error",
211
+ error: error ?? "Unknown error",
212
+ sequence_number: this.seqNum++
213
+ }, {
214
+ type: "response.failed",
215
+ sequence_number: this.seqNum++
216
+ }];
217
+ if (status === "complete") return this.finalize();
218
+ return [];
219
+ }
220
+ };
221
+
222
+ //#endregion
223
+ export { AgentEventTranslator };
224
+ //# sourceMappingURL=event-translator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-translator.js","names":[],"sources":["../../../src/plugins/agents/event-translator.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport type {\n AgentEvent,\n ResponseFunctionCallOutput,\n ResponseFunctionToolCall,\n ResponseOutputMessage,\n ResponseStreamEvent,\n} from \"shared\";\n\n/**\n * Translates internal `AgentEvent` stream into Responses API SSE events.\n *\n * Stateful: one instance per streaming request. Tracks sequence numbers and\n * allocates `output_index` strictly monotonically — each emitted output\n * item (message, function call, function call output) claims the next\n * available index and, once claimed, never reuses an earlier one. This is a\n * Responses-API contract that OpenAI's own SDK parsers enforce.\n *\n * A message is opened lazily on the first `message_delta` or `message`\n * event. If a `tool_call` or `tool_result` arrives while a message is open\n * (common ReAct flow: partial text → tool call → more text), the open\n * message is closed (`response.output_item.done`) BEFORE the tool item is\n * added, so subsequent text resumes as a new message item at a strictly\n * later index.\n */\nexport class AgentEventTranslator {\n private seqNum = 0;\n private nextOutputIndex = 0;\n private currentMessage: {\n id: string;\n text: string;\n outputIndex: number;\n } | null = null;\n private finalized = false;\n\n translate(event: AgentEvent): ResponseStreamEvent[] {\n switch (event.type) {\n case \"message_delta\":\n return this.handleMessageDelta(event.content);\n case \"message\":\n return this.handleFullMessage(event.content);\n case \"tool_call\":\n return this.handleToolCall(event.callId, event.name, event.args);\n case \"tool_result\":\n return this.handleToolResult(event.callId, event.result, event.error);\n case \"thinking\":\n return [\n {\n type: \"appkit.thinking\",\n content: event.content,\n sequence_number: this.seqNum++,\n },\n ];\n case \"metadata\":\n return [\n {\n type: \"appkit.metadata\",\n data: event.data,\n sequence_number: this.seqNum++,\n },\n ];\n case \"approval_pending\":\n return [\n {\n type: \"appkit.approval_pending\",\n approval_id: event.approvalId,\n stream_id: event.streamId,\n tool_name: event.toolName,\n args: event.args,\n annotations: event.annotations,\n sequence_number: this.seqNum++,\n },\n ];\n case \"status\":\n return this.handleStatus(event.status, event.error);\n }\n }\n\n finalize(): ResponseStreamEvent[] {\n if (this.finalized) return [];\n this.finalized = true;\n\n const events: ResponseStreamEvent[] = [];\n const closeEvent = this.closeCurrentMessage();\n if (closeEvent) events.push(closeEvent);\n\n events.push({\n type: \"response.completed\",\n sequence_number: this.seqNum++,\n response: {},\n });\n\n return events;\n }\n\n private handleMessageDelta(content: string): ResponseStreamEvent[] {\n const events: ResponseStreamEvent[] = [];\n\n if (!this.currentMessage) {\n const id = `msg_${randomUUID()}`;\n const outputIndex = this.nextOutputIndex++;\n this.currentMessage = { id, text: content, outputIndex };\n const item: ResponseOutputMessage = {\n type: \"message\",\n id,\n status: \"in_progress\",\n role: \"assistant\",\n content: [],\n };\n events.push({\n type: \"response.output_item.added\",\n output_index: outputIndex,\n item,\n sequence_number: this.seqNum++,\n });\n } else {\n this.currentMessage.text += content;\n }\n\n events.push({\n type: \"response.output_text.delta\",\n item_id: this.currentMessage.id,\n output_index: this.currentMessage.outputIndex,\n content_index: 0,\n delta: content,\n sequence_number: this.seqNum++,\n });\n\n return events;\n }\n\n private handleFullMessage(content: string): ResponseStreamEvent[] {\n const events: ResponseStreamEvent[] = [];\n\n if (!this.currentMessage) {\n // No prior deltas — open and immediately close.\n const id = `msg_${randomUUID()}`;\n const outputIndex = this.nextOutputIndex++;\n this.currentMessage = { id, text: content, outputIndex };\n const addedItem: ResponseOutputMessage = {\n type: \"message\",\n id,\n status: \"in_progress\",\n role: \"assistant\",\n content: [],\n };\n events.push({\n type: \"response.output_item.added\",\n output_index: outputIndex,\n item: addedItem,\n sequence_number: this.seqNum++,\n });\n } else {\n // Deltas already opened the item; `message` overrides the accumulated\n // text (per adapter contract) and closes it.\n this.currentMessage.text = content;\n }\n\n const closeEvent = this.closeCurrentMessage();\n if (closeEvent) events.push(closeEvent);\n return events;\n }\n\n private handleToolCall(\n callId: string,\n name: string,\n args: unknown,\n ): ResponseStreamEvent[] {\n const events: ResponseStreamEvent[] = [];\n const closeEvent = this.closeCurrentMessage();\n if (closeEvent) events.push(closeEvent);\n\n const outputIndex = this.nextOutputIndex++;\n const item: ResponseFunctionToolCall = {\n type: \"function_call\",\n id: `fc_${randomUUID()}`,\n call_id: callId,\n name,\n arguments: typeof args === \"string\" ? args : JSON.stringify(args),\n };\n\n events.push(\n {\n type: \"response.output_item.added\",\n output_index: outputIndex,\n item,\n sequence_number: this.seqNum++,\n },\n {\n type: \"response.output_item.done\",\n output_index: outputIndex,\n item,\n sequence_number: this.seqNum++,\n },\n );\n return events;\n }\n\n private handleToolResult(\n callId: string,\n result: unknown,\n error?: string,\n ): ResponseStreamEvent[] {\n const events: ResponseStreamEvent[] = [];\n const closeEvent = this.closeCurrentMessage();\n if (closeEvent) events.push(closeEvent);\n\n const outputIndex = this.nextOutputIndex++;\n // Coalesce `undefined` → \"\" so the wire shape is always a string (the\n // Responses API contract). Non-string results are JSON-serialised.\n let output: string;\n if (error !== undefined) {\n output = error;\n } else if (typeof result === \"string\") {\n output = result;\n } else if (result === undefined) {\n output = \"\";\n } else {\n output = JSON.stringify(result);\n }\n const item: ResponseFunctionCallOutput = {\n type: \"function_call_output\",\n id: `fc_output_${randomUUID()}`,\n call_id: callId,\n output,\n };\n\n events.push(\n {\n type: \"response.output_item.added\",\n output_index: outputIndex,\n item,\n sequence_number: this.seqNum++,\n },\n {\n type: \"response.output_item.done\",\n output_index: outputIndex,\n item,\n sequence_number: this.seqNum++,\n },\n );\n return events;\n }\n\n /**\n * Emit an `response.output_item.done` for the currently-open message, if\n * any, and clear the state. Returns the event to the caller so it can be\n * pushed at the right moment in the sequence. Returns `null` when there\n * is no open message.\n */\n private closeCurrentMessage(): ResponseStreamEvent | null {\n if (!this.currentMessage) return null;\n const { id, text, outputIndex } = this.currentMessage;\n this.currentMessage = null;\n const doneItem: ResponseOutputMessage = {\n type: \"message\",\n id,\n status: \"completed\",\n role: \"assistant\",\n content: [{ type: \"output_text\", text }],\n };\n return {\n type: \"response.output_item.done\",\n output_index: outputIndex,\n item: doneItem,\n sequence_number: this.seqNum++,\n };\n }\n\n private handleStatus(status: string, error?: string): ResponseStreamEvent[] {\n if (status === \"error\") {\n return [\n {\n type: \"error\",\n error: error ?? \"Unknown error\",\n sequence_number: this.seqNum++,\n },\n {\n type: \"response.failed\",\n sequence_number: this.seqNum++,\n },\n ];\n }\n\n if (status === \"complete\") {\n return this.finalize();\n }\n\n return [];\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import { AgentDefinition, AgentTool, AgentsPluginConfig, AutoInheritToolsConfig, BaseSystemPromptOption, PromptContext, RegisteredAgent, ResolvedToolEntry, ToolkitEntry, ToolkitOptions, isToolkitEntry } from "../../core/agent/types.js";
2
+ import "../../core/agent/build-toolkit.js";
3
+ import { LoadContext, LoadResult, agentIdFromMarkdownPath, loadAgentFromFile, loadAgentsFromDir } from "../../core/agent/load-agents.js";
4
+ import "./agents.js";
@@ -0,0 +1,6 @@
1
+ import { buildToolkitEntries } from "../../core/agent/build-toolkit.js";
2
+ import { isToolkitEntry } from "../../core/agent/types.js";
3
+ import { agentIdFromMarkdownPath, loadAgentFromFile, loadAgentsFromDir, parseFrontmatter } from "../../core/agent/load-agents.js";
4
+ import { AgentsPlugin } from "./agents.js";
5
+
6
+ export { };
@@ -0,0 +1,27 @@
1
+ //#region src/plugins/agents/manifest.json
2
+ var manifest_default = {
3
+ $schema: "https://databricks.github.io/appkit/schemas/plugin-manifest.schema.json",
4
+ name: "agents",
5
+ displayName: "Agents Plugin",
6
+ stability: "beta",
7
+ hidden: true,
8
+ description: "AI agents driven by markdown configs or code, with auto-tool-discovery from registered plugins",
9
+ resources: {
10
+ "required": [],
11
+ "optional": [{
12
+ "type": "serving_endpoint",
13
+ "alias": "Model Serving (agents)",
14
+ "resourceKey": "agents-serving-endpoint",
15
+ "description": "Databricks Model Serving endpoint for agents using workspace-hosted models (`DatabricksAdapter.fromModelServing`). Wire the same endpoint name AppKit reads from `DATABRICKS_AGENT_ENDPOINT` when no per-agent model is configured. Omit when agents use only external adapters.",
16
+ "permission": "CAN_QUERY",
17
+ "fields": { "name": {
18
+ "env": "DATABRICKS_AGENT_ENDPOINT",
19
+ "description": "Endpoint name passed to Model Serving when agents default to `DatabricksAdapter.fromModelServing()`"
20
+ } }
21
+ }]
22
+ }
23
+ };
24
+
25
+ //#endregion
26
+ export { manifest_default as default };
27
+ //# sourceMappingURL=manifest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"manifest.js","names":[],"sources":["../../../src/plugins/agents/manifest.json"],"sourcesContent":[""],"mappings":""}
@@ -0,0 +1,51 @@
1
+ import { z } from "zod";
2
+
3
+ //#region src/plugins/agents/schemas.ts
4
+ /**
5
+ * Static body cap for the `message` field on `POST /chat`. 64 000 characters
6
+ * is well above any legitimate chat turn (~16k tokens at 4 chars/token) and
7
+ * bounds the per-request cost of appending to `InMemoryThreadStore` without
8
+ * requiring per-deployment configuration.
9
+ */
10
+ const MAX_MESSAGE_CHARS = 64e3;
11
+ /** Cap applied to `/invocations` when `input` is a raw string. */
12
+ const MAX_INVOCATIONS_INPUT_CHARS = 64e3;
13
+ /**
14
+ * Cap on the number of items accepted in an `/invocations` `input` array
15
+ * (one element per seeded message). Protects against a single request
16
+ * seeding hundreds of messages into the thread store.
17
+ */
18
+ const MAX_INVOCATIONS_INPUT_ITEMS = 100;
19
+ /** Per-message `content` size cap (string form). */
20
+ const MAX_INVOCATIONS_ITEM_CHARS = 64e3;
21
+ /** Per-message `content` size cap (array form). */
22
+ const MAX_INVOCATIONS_ITEM_ARRAY_ITEMS = 100;
23
+ const chatRequestSchema = z.object({
24
+ message: z.string().min(1, "message must not be empty").max(MAX_MESSAGE_CHARS, `message exceeds the ${MAX_MESSAGE_CHARS}-character limit`),
25
+ threadId: z.string().optional(),
26
+ agent: z.string().optional()
27
+ });
28
+ const messageItemSchema = z.object({
29
+ role: z.enum([
30
+ "user",
31
+ "assistant",
32
+ "system"
33
+ ]).optional(),
34
+ content: z.union([z.string().max(MAX_INVOCATIONS_ITEM_CHARS), z.array(z.any()).max(MAX_INVOCATIONS_ITEM_ARRAY_ITEMS)]).optional(),
35
+ type: z.string().optional()
36
+ });
37
+ const invocationsRequestSchema = z.object({
38
+ input: z.union([z.string().min(1).max(MAX_INVOCATIONS_INPUT_CHARS), z.array(messageItemSchema).min(1).max(MAX_INVOCATIONS_INPUT_ITEMS, `input array exceeds the ${MAX_INVOCATIONS_INPUT_ITEMS}-item limit`)]),
39
+ stream: z.boolean().optional().default(true),
40
+ model: z.string().optional()
41
+ });
42
+ const approvalRequestSchema = z.object({
43
+ streamId: z.string().min(1, "streamId is required"),
44
+ approvalId: z.string().min(1, "approvalId is required"),
45
+ decision: z.enum(["approve", "deny"])
46
+ });
47
+ const cancelRequestSchema = z.object({ streamId: z.string().min(1, "streamId is required") });
48
+
49
+ //#endregion
50
+ export { approvalRequestSchema, cancelRequestSchema, chatRequestSchema, invocationsRequestSchema };
51
+ //# sourceMappingURL=schemas.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schemas.js","names":[],"sources":["../../../src/plugins/agents/schemas.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Static body cap for the `message` field on `POST /chat`. 64 000 characters\n * is well above any legitimate chat turn (~16k tokens at 4 chars/token) and\n * bounds the per-request cost of appending to `InMemoryThreadStore` without\n * requiring per-deployment configuration.\n */\nconst MAX_MESSAGE_CHARS = 64_000;\n\n/** Cap applied to `/invocations` when `input` is a raw string. */\nconst MAX_INVOCATIONS_INPUT_CHARS = 64_000;\n\n/**\n * Cap on the number of items accepted in an `/invocations` `input` array\n * (one element per seeded message). Protects against a single request\n * seeding hundreds of messages into the thread store.\n */\nconst MAX_INVOCATIONS_INPUT_ITEMS = 100;\n\n/** Per-message `content` size cap (string form). */\nconst MAX_INVOCATIONS_ITEM_CHARS = 64_000;\n\n/** Per-message `content` size cap (array form). */\nconst MAX_INVOCATIONS_ITEM_ARRAY_ITEMS = 100;\n\nexport const chatRequestSchema = z.object({\n message: z\n .string()\n .min(1, \"message must not be empty\")\n .max(\n MAX_MESSAGE_CHARS,\n `message exceeds the ${MAX_MESSAGE_CHARS}-character limit`,\n ),\n threadId: z.string().optional(),\n agent: z.string().optional(),\n});\n\nconst messageItemSchema = z.object({\n role: z.enum([\"user\", \"assistant\", \"system\"]).optional(),\n content: z\n .union([\n z.string().max(MAX_INVOCATIONS_ITEM_CHARS),\n z.array(z.any()).max(MAX_INVOCATIONS_ITEM_ARRAY_ITEMS),\n ])\n .optional(),\n type: z.string().optional(),\n});\n\nexport const invocationsRequestSchema = z.object({\n input: z.union([\n z.string().min(1).max(MAX_INVOCATIONS_INPUT_CHARS),\n z\n .array(messageItemSchema)\n .min(1)\n .max(\n MAX_INVOCATIONS_INPUT_ITEMS,\n `input array exceeds the ${MAX_INVOCATIONS_INPUT_ITEMS}-item limit`,\n ),\n ]),\n stream: z.boolean().optional().default(true),\n model: z.string().optional(),\n});\n\nexport const approvalRequestSchema = z.object({\n streamId: z.string().min(1, \"streamId is required\"),\n approvalId: z.string().min(1, \"approvalId is required\"),\n decision: z.enum([\"approve\", \"deny\"]),\n});\n\nexport const cancelRequestSchema = z.object({\n streamId: z.string().min(1, \"streamId is required\"),\n});\n"],"mappings":";;;;;;;;;AAQA,MAAM,oBAAoB;;AAG1B,MAAM,8BAA8B;;;;;;AAOpC,MAAM,8BAA8B;;AAGpC,MAAM,6BAA6B;;AAGnC,MAAM,mCAAmC;AAEzC,MAAa,oBAAoB,EAAE,OAAO;CACxC,SAAS,EACN,QAAQ,CACR,IAAI,GAAG,4BAA4B,CACnC,IACC,mBACA,uBAAuB,kBAAkB,kBAC1C;CACH,UAAU,EAAE,QAAQ,CAAC,UAAU;CAC/B,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC7B,CAAC;AAEF,MAAM,oBAAoB,EAAE,OAAO;CACjC,MAAM,EAAE,KAAK;EAAC;EAAQ;EAAa;EAAS,CAAC,CAAC,UAAU;CACxD,SAAS,EACN,MAAM,CACL,EAAE,QAAQ,CAAC,IAAI,2BAA2B,EAC1C,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,iCAAiC,CACvD,CAAC,CACD,UAAU;CACb,MAAM,EAAE,QAAQ,CAAC,UAAU;CAC5B,CAAC;AAEF,MAAa,2BAA2B,EAAE,OAAO;CAC/C,OAAO,EAAE,MAAM,CACb,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,4BAA4B,EAClD,EACG,MAAM,kBAAkB,CACxB,IAAI,EAAE,CACN,IACC,6BACA,2BAA2B,4BAA4B,aACxD,CACJ,CAAC;CACF,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,QAAQ,KAAK;CAC5C,OAAO,EAAE,QAAQ,CAAC,UAAU;CAC7B,CAAC;AAEF,MAAa,wBAAwB,EAAE,OAAO;CAC5C,UAAU,EAAE,QAAQ,CAAC,IAAI,GAAG,uBAAuB;CACnD,YAAY,EAAE,QAAQ,CAAC,IAAI,GAAG,yBAAyB;CACvD,UAAU,EAAE,KAAK,CAAC,WAAW,OAAO,CAAC;CACtC,CAAC;AAEF,MAAa,sBAAsB,EAAE,OAAO,EAC1C,UAAU,EAAE,QAAQ,CAAC,IAAI,GAAG,uBAAuB,EACpD,CAAC"}