experimental-ash 0.2.0-alpha.2 → 0.2.0-alpha.21

package/dist/src/runtime/connections/mcp-client.js

@@ -0,0 +1,182 @@
+import { createMCPClient } from "@ai-sdk/mcp";
+/**
+ * Wraps one `MCPClient` from `@ai-sdk/mcp` for a single connection.
+ *
+ * Created lazily per-connection per-session. Caches tool metadata after
+ * the first `getToolMetadata()` call.
+ */
+export class McpConnectionClient {
+    #clientPromise;
+    #client;
+    #toolsPromise;
+    #tools;
+    #connection;
+    constructor(connection) {
+        this.#connection = connection;
+    }
+    /**
+     * Connects to the MCP server, trying Streamable HTTP first and
+     * falling back to SSE if the server returns a 404 (indicating it
+     * only supports the older SSE transport).
+     *
+     * Concurrent callers share the same connection promise to avoid
+     * duplicate connections.
+     */
+    async connect() {
+        if (this.#client !== undefined) {
+            return this.#client;
+        }
+        if (this.#clientPromise !== undefined) {
+            return this.#clientPromise;
+        }
+        this.#clientPromise = this.#createClient();
+        try {
+            this.#client = await this.#clientPromise;
+            return this.#client;
+        }
+        catch (error) {
+            this.#clientPromise = undefined;
+            throw error;
+        }
+    }
+    async #createClient() {
+        const headers = await resolveHeaders(this.#connection);
+        const url = this.#connection.url;
+        try {
+            return await createMCPClient({
+                transport: { type: "http", url, headers },
+            });
+        }
+        catch {
+            return await createMCPClient({
+                transport: { type: "sse", url, headers },
+            });
+        }
+    }
+    /**
+     * Returns cached tool metadata for all tools this connection exposes,
+     * after applying any configured tool filter.
+     *
+     * The first call fetches tools from the server via `listTools()` and
+     * creates the AI SDK tool set in parallel. Subsequent calls return
+     * the cached result. Concurrent callers share the same in-flight
+     * promise.
+     */
+    async getToolMetadata() {
+        const tools = await this.#ensureTools();
+        return tools.metadata;
+    }
+    /**
+     * Executes a named tool through the AI SDK's tool executor, which
+     * handles the JSON-RPC `tools/call` internally.
+     */
+    async executeTool(toolName, args) {
+        const { executors } = await this.#ensureTools();
+        const executor = executors.get(toolName);
+        if (executor === undefined) {
+            throw new Error(`Tool "${toolName}" not found in connection "${this.#connection.connectionName}".`);
+        }
+        return executor(args);
+    }
+    async #ensureTools() {
+        if (this.#tools !== undefined) {
+            return this.#tools;
+        }
+        if (this.#toolsPromise !== undefined) {
+            return this.#toolsPromise;
+        }
+        this.#toolsPromise = this.#fetchTools();
+        try {
+            this.#tools = await this.#toolsPromise;
+            return this.#tools;
+        }
+        catch (error) {
+            this.#toolsPromise = undefined;
+            throw error;
+        }
+    }
+    async #fetchTools() {
+        const client = await this.connect();
+        const listResult = await client.listTools();
+        const filter = this.#connection.tools;
+        const filteredTools = filter !== undefined
+            ? listResult.tools.filter((t) => passesToolFilter(t.name, filter))
+            : listResult.tools;
+        const toolSet = client.toolsFromDefinitions({ tools: filteredTools });
+        const metadata = [];
+        const executors = new Map();
+        for (const tool of filteredTools) {
+            metadata.push({
+                annotations: tool.annotations,
+                description: tool.description ?? "",
+                inputSchema: (tool.inputSchema ?? {}),
+                name: tool.name,
+            });
+            const sdkTool = toolSet[tool.name];
+            if (sdkTool !== undefined) {
+                executors.set(tool.name, sdkTool.execute);
+            }
+        }
+        return { executors, metadata };
+    }
+    async close() {
+        if (this.#client !== undefined) {
+            await this.#client.close();
+            this.#client = undefined;
+        }
+        this.#clientPromise = undefined;
+        this.#toolsPromise = undefined;
+        this.#tools = undefined;
+    }
+}
+/**
+ * Returns `true` when a tool name passes the configured filter.
+ */
+export function passesToolFilter(toolName, filter) {
+    if (filter === undefined) {
+        return true;
+    }
+    if ("allow" in filter) {
+        return filter.allow.includes(toolName);
+    }
+    return !filter.block.includes(toolName);
+}
+/**
+ * Merges `authorization` (Bearer token) and `headers` into one
+ * flat `Record<string, string>` for the transport layer.
+ */
+export async function resolveHeaders(connection) {
+    const merged = {};
+    if (connection.authorization !== undefined) {
+        const token = await resolveHeaderValue(connection.authorization.token);
+        merged.Authorization = `Bearer ${token}`;
+    }
+    if (connection.headers !== undefined) {
+        const resolved = await resolveHeadersDefinition(connection.headers);
+        for (const [key, value] of Object.entries(resolved)) {
+            if (connection.authorization !== undefined && key.toLowerCase() === "authorization") {
+                throw new Error(`Connection "${connection.connectionName}" headers must not include an "Authorization" key when "authorization" is also provided.`);
+            }
+            merged[key] = value;
+        }
+    }
+    return merged;
+}
+async function resolveHeadersDefinition(headers) {
+    if (typeof headers === "function") {
+        return await headers();
+    }
+    const result = {};
+    const entries = Object.entries(headers);
+    for (const [key, value] of entries) {
+        result[key] = await resolveHeaderValue(value);
+    }
+    return result;
+}
+async function resolveHeaderValue(value) {
+    if (typeof value === "function") {
+        return await value();
+    }
+    return await value;
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/src/runtime/connections/mcp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.js","sourceRoot":"","sources":["../../../../src/runtime/connections/mcp-client.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/connections/registry.d.ts

@@ -0,0 +1,33 @@
+import type { ResolvedConnectionDefinition } from "../types.js";
+import { McpConnectionClient } from "./mcp-client.js";
+import type { ConnectionRegistry } from "./types.js";
+/**
+ * Per-session container mapping connection names to lazily-initialized
+ * client wrappers.
+ *
+ * Currently all connections use MCP, but the registry is protocol-agnostic
+ * and will dispatch to the appropriate client type when additional
+ * protocols (e.g. OpenAPI) are supported.
+ */
+export declare class ConnectionRegistryImpl implements ConnectionRegistry {
+    #private;
+    constructor(connections: readonly ResolvedConnectionDefinition[]);
+    /**
+     * Returns the client for the named connection, creating it on first
+     * access.
+     */
+    getClient(connectionName: string): McpConnectionClient;
+    /**
+     * Returns all registered connection names.
+     */
+    getConnectionNames(): readonly string[];
+    /**
+     * Returns the resolved definitions for all connections.
+     */
+    getConnections(): readonly ResolvedConnectionDefinition[];
+    /**
+     * Closes all active client connections.
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/runtime/connections/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/runtime/connections/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;;gBAInD,WAAW,EAAE,SAAS,4BAA4B,EAAE;IAIhE;;;OAGG;IACH,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,mBAAmB;IAgBtD;;OAEG;IACH,kBAAkB,IAAI,SAAS,MAAM,EAAE;IAIvC;;OAEG;IACH,cAAc,IAAI,SAAS,4BAA4B,EAAE;IAIzD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/src/runtime/connections/registry.js

@@ -0,0 +1,54 @@
+import { McpConnectionClient } from "./mcp-client.js";
+/**
+ * Per-session container mapping connection names to lazily-initialized
+ * client wrappers.
+ *
+ * Currently all connections use MCP, but the registry is protocol-agnostic
+ * and will dispatch to the appropriate client type when additional
+ * protocols (e.g. OpenAPI) are supported.
+ */
+export class ConnectionRegistryImpl {
+    #clients = new Map();
+    #connections;
+    constructor(connections) {
+        this.#connections = connections;
+    }
+    /**
+     * Returns the client for the named connection, creating it on first
+     * access.
+     */
+    getClient(connectionName) {
+        const existing = this.#clients.get(connectionName);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const connection = this.#connections.find((c) => c.connectionName === connectionName);
+        if (connection === undefined) {
+            throw new Error(`Connection "${connectionName}" is not registered.`);
+        }
+        const client = new McpConnectionClient(connection);
+        this.#clients.set(connectionName, client);
+        return client;
+    }
+    /**
+     * Returns all registered connection names.
+     */
+    getConnectionNames() {
+        return this.#connections.map((c) => c.connectionName);
+    }
+    /**
+     * Returns the resolved definitions for all connections.
+     */
+    getConnections() {
+        return this.#connections;
+    }
+    /**
+     * Closes all active client connections.
+     */
+    async dispose() {
+        const closePromises = [...this.#clients.values()].map((client) => client.close());
+        await Promise.allSettled(closePromises);
+        this.#clients.clear();
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/runtime/connections/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/runtime/connections/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IACjC,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAClD,YAAY,CAA0C;IAEtD,YAAY,WAAoD;QAC9D,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,cAAsB;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACnD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,cAAc,CAAC,CAAC;QACtF,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,eAAe,cAAc,sBAAsB,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAClF,MAAM,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/src/runtime/connections/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Protocol-agnostic interfaces for the connection system.
+ *
+ * Framework tools (`connection_search`, `connection_execute`) and the
+ * context provider depend only on these interfaces, not on any
+ * protocol-specific implementation such as MCP.
+ */
+import type { ResolvedConnectionDefinition } from "../types.js";
+/** A single header value, supporting static strings and dynamic resolution. */
+export type HeaderValue = string | Promise<string> | (() => string | Promise<string>);
+/**
+ * Arbitrary HTTP headers sent with every request to a connection server.
+ *
+ * Static form: key-value pairs where each value may be a string, Promise,
+ * or function. Function form: a callback returning the full headers map,
+ * useful when multiple headers must be resolved together.
+ */
+export type HeadersDefinition = Readonly<Record<string, HeaderValue>> | (() => Record<string, string> | Promise<Record<string, string>>);
+/**
+ * Client-side tool filter applied after `listTools()`.
+ *
+ * Exactly one of `allow` or `block` must be specified:
+ * - `allow` — only named tools are surfaced to the model.
+ * - `block` — named tools are hidden; all others are surfaced.
+ */
+export type ToolFilterDefinition = {
+    readonly allow: readonly string[];
+} | {
+    readonly block: readonly string[];
+};
+/**
+ * Credentials for authenticating with a connection server.
+ *
+ * The `token` field is flexible: it accepts a plain string for static
+ * credentials, a `Promise` for one-time async resolution, or a function
+ * for per-request token refresh. The runtime normalizes all forms into
+ * a resolved string before sending the `Authorization: Bearer <token>`
+ * header.
+ *
+ * Shared across all connection types (MCP, future OpenAPI, etc.).
+ */
+export interface AuthorizationDefinition {
+    /**
+     * Bearer token used to authenticate with the connection server.
+     *
+     * Accepted forms:
+     * - `string` — static token, e.g. an environment variable.
+     * - `Promise<string>` — resolved once at connection time.
+     * - `() => string | Promise<string>` — called per-request for
+     *   dynamic or refreshable tokens.
+     */
+    token: string | Promise<string> | (() => string | Promise<string>);
+}
+/** Metadata for a single tool exposed by a connection. */
+export interface ConnectionToolMetadata {
+    readonly annotations?: Record<string, unknown>;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly name: string;
+}
+/** A live client for a single connection. */
+export interface ConnectionClient {
+    close(): Promise<void>;
+    connect(): Promise<unknown>;
+    executeTool(toolName: string, args: unknown): Promise<unknown>;
+    getToolMetadata(): Promise<readonly ConnectionToolMetadata[]>;
+}
+/** Per-session container mapping connection names to clients. */
+export interface ConnectionRegistry {
+    dispose(): Promise<void>;
+    getClient(connectionName: string): ConnectionClient;
+    getConnectionNames(): readonly string[];
+    getConnections(): readonly ResolvedConnectionDefinition[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/runtime/connections/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/runtime/connections/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAEhE,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GACrC,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACrC;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CACpE;AAED,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,eAAe,IAAI,OAAO,CAAC,SAAS,sBAAsB,EAAE,CAAC,CAAC;CAC/D;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACpD,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAAC;IACxC,cAAc,IAAI,SAAS,4BAA4B,EAAE,CAAC;CAC3D"}

package/dist/src/runtime/connections/types.js

@@ -0,0 +1,9 @@
+/**
+ * Protocol-agnostic interfaces for the connection system.
+ *
+ * Framework tools (`connection_search`, `connection_execute`) and the
+ * context provider depend only on these interfaces, not on any
+ * protocol-specific implementation such as MCP.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/runtime/connections/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/runtime/connections/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/src/runtime/framework-channels/index.d.ts

@@ -6,17 +6,17 @@ import type { ResolvedChannelDefinition } from "../types.js";
  */
 export declare const HTTP_MESSAGE_CHANNEL_NAME = ".well-known/ash/v1/message";
 /**
- * Logical name of the framework-shipped HTTP run-stream channel. Authors
+ * Logical name of the framework-shipped HTTP session-stream channel. Authors
  * who want to override or disable it create a file at the matching logical
- * filesystem path: `agent/channels/.well-known/ash/v1/runs/[runId]/stream.ts`.
+ * filesystem path: `agent/channels/.well-known/ash/v1/sessions/[sessionId]/stream.ts`.
  */
-export declare const HTTP_RUN_STREAM_CHANNEL_NAME = ".well-known/ash/v1/runs/[runId]/stream";
+export declare const HTTP_SESSION_STREAM_CHANNEL_NAME = ".well-known/ash/v1/sessions/[sessionId]/stream";
 /**
  * Returns the framework-shipped channel definitions that mount by default.
  *
- * Authors override one of these by creating an authored channel at the same
+ * Authors override one of these by creating an authored route at the same
  * logical filesystem path (filename collision wins) or remove one by
- * exporting `disableChannel()` from such a file. Both interactions are
+ * exporting `disableRoute()` from such a file. Both interactions are
  * resolved in `resolve-agent-graph.ts` before the channels reach the Nitro
  * mounting loop.
  *
@@ -42,7 +42,7 @@ export declare const HTTP_RUN_STREAM_CHANNEL_NAME = ".well-known/ash/v1/runs/[ru
 export declare function getFrameworkChannelDefinitions(): readonly ResolvedChannelDefinition[];
 /**
  * Returns the set of all known framework channel logical names. Used by
- * `resolve-agent-graph.ts` to validate `disableChannel()` targets against
+ * `resolve-agent-graph.ts` to validate `disableRoute()` targets against
  * the framework default set so unknown disable names produce a diagnostic.
  */
 export declare function getAllFrameworkChannelNames(): ReadonlySet<string>;

package/dist/src/runtime/framework-channels/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-channels/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,2CAA2C,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,8BAA8B,IAAI,SAAS,yBAAyB,EAAE,CAwBrF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,WAAW,CAAC,MAAM,CAAC,CAEjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-channels/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,+BAA+B,CAAC;AAEtE;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,mDAAmD,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,8BAA8B,IAAI,SAAS,yBAAyB,EAAE,CA0BrF;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,WAAW,CAAC,MAAM,CAAC,CAEjE"}

package/dist/src/runtime/framework-channels/index.js

@@ -1,5 +1,5 @@
 import { none, vercelOidc } from "../../public/channels/auth.js";
-import { httpMessageChannel, httpRunStreamChannel } from "../../public/channels/http.js";
+import { httpRoute, httpRunStreamRoute } from "../../public/channels/http.js";
 /**
  * Logical name of the framework-shipped HTTP message channel. Authors who
  * want to override or disable it create a file at the matching logical
@@ -7,17 +7,17 @@ import { httpMessageChannel, httpRunStreamChannel } from "../../public/channels/
  */
 export const HTTP_MESSAGE_CHANNEL_NAME = ".well-known/ash/v1/message";
 /**
- * Logical name of the framework-shipped HTTP run-stream channel. Authors
+ * Logical name of the framework-shipped HTTP session-stream channel. Authors
  * who want to override or disable it create a file at the matching logical
- * filesystem path: `agent/channels/.well-known/ash/v1/runs/[runId]/stream.ts`.
+ * filesystem path: `agent/channels/.well-known/ash/v1/sessions/[sessionId]/stream.ts`.
  */
-export const HTTP_RUN_STREAM_CHANNEL_NAME = ".well-known/ash/v1/runs/[runId]/stream";
+export const HTTP_SESSION_STREAM_CHANNEL_NAME = ".well-known/ash/v1/sessions/[sessionId]/stream";
 /**
  * Returns the framework-shipped channel definitions that mount by default.
  *
- * Authors override one of these by creating an authored channel at the same
+ * Authors override one of these by creating an authored route at the same
  * logical filesystem path (filename collision wins) or remove one by
- * exporting `disableChannel()` from such a file. Both interactions are
+ * exporting `disableRoute()` from such a file. Both interactions are
  * resolved in `resolve-agent-graph.ts` before the channels reach the Nitro
  * mounting loop.
  *
@@ -42,36 +42,38 @@ export const HTTP_RUN_STREAM_CHANNEL_NAME = ".well-known/ash/v1/runs/[runId]/str
  */
 export function getFrameworkChannelDefinitions() {
     const auth = resolveFrameworkHttpAuth();
-    const message = httpMessageChannel({ auth });
-    const stream = httpRunStreamChannel({ auth });
+    const message = httpRoute({ auth });
+    const stream = httpRunStreamRoute({ auth });
     return [
         {
             name: HTTP_MESSAGE_CHANNEL_NAME,
             method: message.method ?? "POST",
             urlPath: "/.well-known/ash/v1/message",
             fetch: message.fetch,
+            serializableChannels: message.serializableChannels,
             logicalPath: `framework://channels/${HTTP_MESSAGE_CHANNEL_NAME}`,
             sourceId: "ash:framework:http-message",
             sourceKind: "module",
         },
         {
-            name: HTTP_RUN_STREAM_CHANNEL_NAME,
+            name: HTTP_SESSION_STREAM_CHANNEL_NAME,
             method: stream.method ?? "GET",
-            urlPath: "/.well-known/ash/v1/runs/:runId/stream",
+            urlPath: "/.well-known/ash/v1/sessions/:sessionId/stream",
             fetch: stream.fetch,
-            logicalPath: `framework://channels/${HTTP_RUN_STREAM_CHANNEL_NAME}`,
-            sourceId: "ash:framework:http-run-stream",
+            serializableChannels: stream.serializableChannels,
+            logicalPath: `framework://channels/${HTTP_SESSION_STREAM_CHANNEL_NAME}`,
+            sourceId: "ash:framework:http-session-stream",
             sourceKind: "module",
         },
     ];
 }
 /**
  * Returns the set of all known framework channel logical names. Used by
- * `resolve-agent-graph.ts` to validate `disableChannel()` targets against
+ * `resolve-agent-graph.ts` to validate `disableRoute()` targets against
  * the framework default set so unknown disable names produce a diagnostic.
  */
 export function getAllFrameworkChannelNames() {
-    return new Set([HTTP_MESSAGE_CHANNEL_NAME, HTTP_RUN_STREAM_CHANNEL_NAME]);
+    return new Set([HTTP_MESSAGE_CHANNEL_NAME, HTTP_SESSION_STREAM_CHANNEL_NAME]);
 }
 /**
  * Returns the inbound `AuthFn` used by the framework-shipped HTTP

package/dist/src/runtime/framework-channels/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/framework-channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGzF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,4BAA4B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,wCAAwC,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO;QACL;YACE,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;YAChC,OAAO,EAAE,6BAA6B;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,wBAAwB,yBAAyB,EAAE;YAChE,QAAQ,EAAE,4BAA4B;YACtC,UAAU,EAAE,QAAQ;SACrB;QACD;YACE,IAAI,EAAE,4BAA4B;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,KAAK;YAC9B,OAAO,EAAE,wCAAwC;YACjD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,wBAAwB,4BAA4B,EAAE;YACnE,QAAQ,EAAE,+BAA+B;YACzC,UAAU,EAAE,QAAQ;SACrB;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,GAAG,CAAC,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB;IAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/framework-channels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAG9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,4BAA4B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,gDAAgD,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,8BAA8B;IAC5C,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,OAAO;QACL;YACE,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;YAChC,OAAO,EAAE,6BAA6B;YACtC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;YAClD,WAAW,EAAE,wBAAwB,yBAAyB,EAAE;YAChE,QAAQ,EAAE,4BAA4B;YACtC,UAAU,EAAE,QAAQ;SACrB;QACD;YACE,IAAI,EAAE,gCAAgC;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,KAAK;YAC9B,OAAO,EAAE,gDAAgD;YACzD,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;YACjD,WAAW,EAAE,wBAAwB,gCAAgC,EAAE;YACvE,QAAQ,EAAE,mCAAmC;YAC7C,UAAU,EAAE,QAAQ;SACrB;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,GAAG,CAAC,CAAC,yBAAyB,EAAE,gCAAgC,CAAC,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;GAMG;AACH,SAAS,wBAAwB;IAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,UAAU,EAAE,CAAC;IACtB,CAAC;IACD,OAAO,IAAI,EAAE,CAAC;AAChB,CAAC"}

package/dist/src/runtime/framework-tools/ask-question.js

@@ -1,13 +1,13 @@
 import { z } from "zod";
-import { runtimeQuestionInputRequestSchema } from "../input/types.js";
+import { inputRequestSchema } from "../input/types.js";
 /**
  * Stable model-visible name for the framework question tool.
  */
 export const ASK_QUESTION_TOOL_NAME = "ask_question";
-const askQuestionToolInputSchema = runtimeQuestionInputRequestSchema.omit({
+const askQuestionToolInputSchema = inputRequestSchema.omit({
     action: true,
-    kind: true,
-    toolName: true,
+    display: true,
+    requestId: true,
 });
 const { $schema: _jsonSchemaVersion, ...askQuestionInputSchema } = z.toJSONSchema(askQuestionToolInputSchema);
 /**

package/dist/src/runtime/framework-tools/ask-question.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-question.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/ask-question.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iCAAiC,EAAE,MAAM,mBAAmB,CAAC;AAGtE;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC;AAErD,MAAM,0BAA0B,GAAG,iCAAiC,CAAC,IAAI,CAAC;IACxE,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,QAAQ,EAAE,IAAI;CACf,CAAC,CAAC;AACH,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,sBAAsB,EAAE,GAAG,CAAC,CAAC,YAAY,CAC/E,0BAA0B,CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAiD,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA2B;IAClE,WAAW,EACT,wIAAwI;IAC1I,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,4BAA4B;IACzC,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE,QAAQ;CACrB,CAAC"}
+{"version":3,"file":"ask-question.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/ask-question.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAAC;AAErD,MAAM,0BAA0B,GAAG,kBAAkB,CAAC,IAAI,CAAC;IACzD,MAAM,EAAE,IAAI;IACZ,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AACH,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,sBAAsB,EAAE,GAAG,CAAC,CAAC,YAAY,CAC/E,0BAA0B,CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,sBAAiD,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAA2B;IAClE,WAAW,EACT,wIAAwI;IAC1I,WAAW,EAAE,yBAAyB;IACtC,WAAW,EAAE,4BAA4B;IACzC,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE,QAAQ;CACrB,CAAC"}

package/dist/src/runtime/framework-tools/connection-execute.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedToolDefinition } from "../types.js";
+/**
+ * Framework-provided `connection_execute` tool.
+ *
+ * Executes a specific tool from a connection. The model must use the
+ * search tool first to discover the exact tool name, connection name,
+ * and input schema.
+ */
+export declare const CONNECTION_EXECUTE_TOOL_DEFINITION: ResolvedToolDefinition;
+//# sourceMappingURL=connection-execute.d.ts.map

package/dist/src/runtime/framework-tools/connection-execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-execute.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/connection-execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAW1D;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,EAAE,sBA8BhD,CAAC"}

package/dist/src/runtime/framework-tools/connection-execute.js

@@ -0,0 +1,50 @@
+import { requireContext } from "../../context/container.js";
+import { CONNECTION_SEARCH_TOOL_DEFINITION, ConnectionRegistryKey } from "./connection-search.js";
+const SEARCH_NAME = CONNECTION_SEARCH_TOOL_DEFINITION.name;
+/**
+ * Framework-provided `connection_execute` tool.
+ *
+ * Executes a specific tool from a connection. The model must use the
+ * search tool first to discover the exact tool name, connection name,
+ * and input schema.
+ */
+export const CONNECTION_EXECUTE_TOOL_DEFINITION = {
+    description: `Call a tool from a connection. Use ${SEARCH_NAME} first to find the tool.`,
+    execute: async (input) => executeConnectionExecute(input),
+    inputSchema: {
+        additionalProperties: false,
+        properties: {
+            connection: {
+                description: `Exact connection name string from the ${SEARCH_NAME} result.`,
+                type: "string",
+            },
+            parameters: {
+                description: `Object matching the inputSchema from the ${SEARCH_NAME} result. Pass {} if no parameters are needed.`,
+                type: "object",
+            },
+            tool: {
+                description: `Exact tool name string from the ${SEARCH_NAME} result (e.g. 'list_projects', not 'list projects').`,
+                type: "string",
+            },
+        },
+        required: ["connection", "tool", "parameters"],
+        type: "object",
+    },
+    logicalPath: "ash:framework/connection-execute",
+    name: "connection_execute",
+    // TODO: This approves all connection tools once `connection_execute` is
+    // approved once. NeedsApprovalContext needs toolInput so we can scope
+    // approval per connection/remote-tool pair.
+    needsApproval: ({ approvedTools, toolName }) => !approvedTools.has(toolName),
+    sourceId: "ash:connection-execute-tool",
+    sourceKind: "module",
+};
+async function executeConnectionExecute(input) {
+    const registry = requireContext().tryGet(ConnectionRegistryKey);
+    if (registry === undefined) {
+        throw new Error("No connection registry available.");
+    }
+    const client = registry.getClient(input.connection);
+    return client.executeTool(input.tool, input.parameters ?? {});
+}
+//# sourceMappingURL=connection-execute.js.map

package/dist/src/runtime/framework-tools/connection-execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-execute.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/connection-execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,OAAO,EAAE,iCAAiC,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAQlG,MAAM,WAAW,GAAG,iCAAiC,CAAC,IAAI,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAA2B;IACxE,WAAW,EAAE,sCAAsC,WAAW,0BAA0B;IACxF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAA+B,CAAC;IACnF,WAAW,EAAE;QACX,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,WAAW,EAAE,yCAAyC,WAAW,UAAU;gBAC3E,IAAI,EAAE,QAAQ;aACf;YACD,UAAU,EAAE;gBACV,WAAW,EAAE,4CAA4C,WAAW,+CAA+C;gBACnH,IAAI,EAAE,QAAQ;aACf;YACD,IAAI,EAAE;gBACJ,WAAW,EAAE,mCAAmC,WAAW,sDAAsD;gBACjH,IAAI,EAAE,QAAQ;aACf;SACF;QACD,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC;QAC9C,IAAI,EAAE,QAAQ;KACf;IACD,WAAW,EAAE,kCAAkC;IAC/C,IAAI,EAAE,oBAAoB;IAC1B,wEAAwE;IACxE,sEAAsE;IACtE,4CAA4C;IAC5C,aAAa,EAAE,CAAC,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC5E,QAAQ,EAAE,6BAA6B;IACvC,UAAU,EAAE,QAAQ;CACrB,CAAC;AAEF,KAAK,UAAU,wBAAwB,CAAC,KAA6B;IACnE,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAChE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC"}