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

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

@@ -0,0 +1,43 @@
+import { RuntimeContextKey } from "../../context/key.js";
+import type { ConnectionRegistry, ConnectionToolMetadata } from "../connections/types.js";
+import type { ResolvedToolDefinition } from "../types.js";
+/**
+ * Context key for the per-session connection registry.
+ *
+ * Created as a derived key (no codec) because the registry holds live
+ * client instances that cannot be serialized across step boundaries.
+ * The `connectionProvider` reconstructs it each step.
+ */
+export declare const ConnectionRegistryKey: RuntimeContextKey<ConnectionRegistry>;
+interface ConnectionSearchInput {
+    readonly connection?: string;
+    readonly keywords: string;
+    readonly limit?: number;
+}
+interface ConnectionSearchResultItem {
+    readonly connection: string;
+    readonly description: string;
+    readonly error?: string;
+    readonly inputSchema?: Record<string, unknown>;
+    readonly tool?: string;
+}
+/**
+ * Framework-provided `connection_search` tool.
+ *
+ * Searches for tools across all connections by matching a
+ * natural-language query against tool names and descriptions.
+ *
+ * When a connection's server is unreachable, or when no tools match
+ * the query, the result still includes the connection name and
+ * description so the model knows the connection exists.
+ *
+ * The `description` field is dynamically composed at registration time
+ * in `resolve-agent-graph.ts` to include the list of available
+ * connections.
+ */
+export declare const CONNECTION_SEARCH_TOOL_DEFINITION: ResolvedToolDefinition;
+export declare function executeConnectionSearch(input: ConnectionSearchInput): Promise<ConnectionSearchResultItem[]>;
+export declare function tokenize(text: string): string[];
+export declare function scoreMatch(queryTokens: string[], tool: ConnectionToolMetadata): number;
+export {};
+//# sourceMappingURL=connection-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection-search.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/connection-search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,uCAEjC,CAAC;AAEF,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,0BAA0B;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iCAAiC,EAAE,sBA2B/C,CAAC;AAEF,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAiEvC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,sBAAsB,GAAG,MAAM,CAmBtF"}

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

@@ -0,0 +1,135 @@
+import { requireContext } from "../../context/container.js";
+import { RuntimeContextKey } from "../../context/key.js";
+/**
+ * Context key for the per-session connection registry.
+ *
+ * Created as a derived key (no codec) because the registry holds live
+ * client instances that cannot be serialized across step boundaries.
+ * The `connectionProvider` reconstructs it each step.
+ */
+export const ConnectionRegistryKey = new RuntimeContextKey("ash.connectionRegistry");
+/**
+ * Framework-provided `connection_search` tool.
+ *
+ * Searches for tools across all connections by matching a
+ * natural-language query against tool names and descriptions.
+ *
+ * When a connection's server is unreachable, or when no tools match
+ * the query, the result still includes the connection name and
+ * description so the model knows the connection exists.
+ *
+ * The `description` field is dynamically composed at registration time
+ * in `resolve-agent-graph.ts` to include the list of available
+ * connections.
+ */
+export const CONNECTION_SEARCH_TOOL_DEFINITION = {
+    description: "Search for tools across your connections.",
+    execute: async (input) => executeConnectionSearch(input),
+    inputSchema: {
+        additionalProperties: false,
+        properties: {
+            connection: {
+                description: "Optional: limit search to a specific connection name.",
+                type: "string",
+            },
+            limit: {
+                description: "Max results to return. Default 10.",
+                type: "number",
+            },
+            keywords: {
+                description: "Search keywords and expanded aliases. Distill intent into keywords; avoid stop words like 'a', 'the', 'in'.",
+                type: "string",
+            },
+        },
+        required: ["keywords"],
+        type: "object",
+    },
+    logicalPath: "ash:framework/connection-search",
+    name: "connection_search",
+    sourceId: "ash:connection-search-tool",
+    sourceKind: "module",
+};
+export async function executeConnectionSearch(input) {
+    const registry = requireContext().tryGet(ConnectionRegistryKey);
+    if (registry === undefined) {
+        return [];
+    }
+    const limit = input.limit ?? 10;
+    const queryTokens = tokenize(input.keywords);
+    const results = [];
+    const failedConnections = [];
+    const targetConnections = input.connection !== undefined && input.connection !== ""
+        ? registry.getConnections().filter((c) => c.connectionName === input.connection)
+        : registry.getConnections();
+    for (const conn of targetConnections) {
+        let tools;
+        try {
+            const client = registry.getClient(conn.connectionName);
+            tools = await client.getToolMetadata();
+        }
+        catch (err) {
+            failedConnections.push({
+                connection: conn.connectionName,
+                description: conn.description,
+                error: `Could not reach ${conn.connectionName} server: ${err instanceof Error ? err.message : "unknown error"}`,
+            });
+            continue;
+        }
+        for (const tool of tools) {
+            const score = scoreMatch(queryTokens, tool);
+            if (score > 0) {
+                results.push({
+                    item: {
+                        connection: conn.connectionName,
+                        description: tool.description,
+                        inputSchema: tool.inputSchema,
+                        tool: tool.name,
+                    },
+                    score,
+                });
+            }
+        }
+    }
+    results.sort((a, b) => b.score - a.score);
+    const matched = results.slice(0, limit).map((r) => r.item);
+    if (matched.length > 0) {
+        return [...matched, ...failedConnections];
+    }
+    // No keyword matches — return connection summaries so the model
+    // knows which connections exist even when the query is vague.
+    const summaries = targetConnections.map((c) => {
+        const failed = failedConnections.find((f) => f.connection === c.connectionName);
+        if (failed)
+            return failed;
+        return {
+            connection: c.connectionName,
+            description: c.description,
+        };
+    });
+    return summaries;
+}
+export function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[\s_\-./]+/)
+        .filter((t) => t.length > 1);
+}
+export function scoreMatch(queryTokens, tool) {
+    const nameTokens = tokenize(tool.name);
+    const descTokens = tokenize(tool.description);
+    let score = 0;
+    for (const qt of queryTokens) {
+        for (const nt of nameTokens) {
+            if (nt.includes(qt) || qt.includes(nt)) {
+                score += 3;
+            }
+        }
+        for (const dt of descTokens) {
+            if (dt.includes(qt) || qt.includes(dt)) {
+                score += 1;
+            }
+        }
+    }
+    return score;
+}
+//# sourceMappingURL=connection-search.js.map

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

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

package/dist/src/runtime/framework-tools/file-state.d.ts

@@ -11,14 +11,14 @@ export interface ReadFileStamp {
     readonly sandboxName: string;
 }
 /**
- * Durable session state holding read-file stamps keyed by
+ * Durable session context holding read-file stamps keyed by
  * `${sandboxName}:${normalizedPath}`.
  */
 export interface ReadFileState {
     readonly byTarget: Readonly<Record<string, ReadFileStamp>>;
 }
 /**
- * Durable context key for read-file stamps. Hydrated from session state at
+ * Durable context key for read-file stamps. Hydrated from session context at
  * step start, committed back at step end. Cleared on compaction via the
  * `read_file` tool's `onCompact` hook.
  */
@@ -35,7 +35,7 @@ export declare const ReadFileStateKey: ContextKey<ReadFileState>;
  */
 export declare function normalizeModelPath(path: string): string;
 /**
- * Builds the durable state key used to index a read-file stamp. Combines the
+ * Builds the durable context key used to index a read-file stamp. Combines the
  * sandbox name with the normalized absolute path so stamps from different
  * sandboxes never collide.
  *
@@ -54,10 +54,10 @@ export declare function createReadFileStamp(input: {
     sandboxName: string;
 }): ReadFileStamp;
 /**
- * Persists one read-file stamp into the durable context state.
+ * Persists one read-file stamp into the durable context.
  *
  * Centralizes the context read-update-write so callers in `read-file-tool`
- * and `write-file-tool` do not duplicate the state mutation pattern.
+ * and `write-file-tool` do not duplicate the context mutation pattern.
  */
 export declare function setReadFileStamp(ctx: AshContext, targetKey: string, stamp: ReadFileStamp): void;
 /**

package/dist/src/runtime/framework-tools/file-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-state.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/file-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOlD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,2BAE3B,CAAC;AAMH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAE1F;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,aAAa,CAQhB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAK/F;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAExD"}
+{"version":3,"file":"file-state.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/file-state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOlD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC5D;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,2BAAgD,CAAC;AAM9E;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAE1F;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,aAAa,CAQhB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAK/F;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAExD"}

package/dist/src/runtime/framework-tools/file-state.js

@@ -2,13 +2,11 @@ import { createHash } from "node:crypto";
 import { posix } from "node:path";
 import { ContextKey } from "../../context/key.js";
 /**
- * Durable context key for read-file stamps. Hydrated from session state at
+ * Durable context key for read-file stamps. Hydrated from session context at
  * step start, committed back at step end. Cleared on compaction via the
  * `read_file` tool's `onCompact` hook.
  */
-export const ReadFileStateKey = new ContextKey("ash.readFile", {
-    initial: () => ({ byTarget: {} }),
-});
+export const ReadFileStateKey = new ContextKey("ash.readFile");
 // ---------------------------------------------------------------------------
 // Path normalization
 // ---------------------------------------------------------------------------
@@ -26,7 +24,7 @@ export function normalizeModelPath(path) {
     return posix.normalize(path);
 }
 /**
- * Builds the durable state key used to index a read-file stamp. Combines the
+ * Builds the durable context key used to index a read-file stamp. Combines the
  * sandbox name with the normalized absolute path so stamps from different
  * sandboxes never collide.
  *
@@ -54,13 +52,13 @@ export function createReadFileStamp(input) {
     };
 }
 /**
- * Persists one read-file stamp into the durable context state.
+ * Persists one read-file stamp into the durable context.
  *
  * Centralizes the context read-update-write so callers in `read-file-tool`
- * and `write-file-tool` do not duplicate the state mutation pattern.
+ * and `write-file-tool` do not duplicate the context mutation pattern.
  */
 export function setReadFileStamp(ctx, targetKey, stamp) {
-    const state = ctx.get(ReadFileStateKey);
+    const state = ctx.ensure(ReadFileStateKey, () => ({ byTarget: {} }));
     ctx.set(ReadFileStateKey, {
         byTarget: { ...state.byTarget, [targetKey]: stamp },
     });

package/dist/src/runtime/framework-tools/file-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-state.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/file-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AA0BlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAgB,cAAc,EAAE;IAC5E,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;CAClC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,cAAsB;IAChF,OAAO,GAAG,WAAW,IAAI,cAAc,EAAE,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAInC;IACC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9E,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC;QACpD,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,SAAiB,EAAE,KAAoB;IACvF,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACxC,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE;QACxB,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE;KACpD,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAe;IAChD,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"file-state.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/file-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AA0BlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,UAAU,CAAgB,cAAc,CAAC,CAAC;AAE9E,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB,EAAE,cAAsB;IAChF,OAAO,GAAG,WAAW,IAAI,cAAc,EAAE,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAInC;IACC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9E,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC;QACpD,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,SAAiB,EAAE,KAAoB;IACvF,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IACrE,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE;QACxB,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE;KACpD,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAe;IAChD,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -1,3 +1,4 @@
+export { ConnectionRegistryKey } from "./connection-search.js";
 export type { ReadFileStamp, ReadFileState } from "./file-state.js";
 export { ReadFileStateKey } from "./file-state.js";
 export type { SkillToolState } from "./skill.js";
@@ -10,9 +11,10 @@ import type { ResolvedToolDefinition } from "../types.js";
  * alongside authored tools during graph resolution.
  *
  * The set of tools varies based on the agent configuration. For example,
- * `activate_skill` is only included when the agent has skills.
+ * `load_skill` is only included when the agent has skills.
  */
 export declare function getFrameworkToolDefinitions(config: {
+    readonly hasConnections: boolean;
     readonly hasSkills: boolean;
     readonly isRoot: boolean;
 }): readonly ResolvedToolDefinition[];

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/index.ts"],"names":[],"mappings":"AAWA,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GAAG,SAAS,sBAAsB,EAAE,CAsBpC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAAC,MAAM,CAAC,CAa9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GAAG,SAAS,sBAAsB,EAAE,CA2BpC;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,IAAI,WAAW,CAAC,MAAM,CAAC,CAe9D"}

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

@@ -1,5 +1,7 @@
 import { ASK_QUESTION_TOOL_DEFINITION } from "./ask-question.js";
 import { BASH_TOOL_DEFINITION } from "./bash.js";
+import { CONNECTION_EXECUTE_TOOL_DEFINITION } from "./connection-execute.js";
+import { CONNECTION_SEARCH_TOOL_DEFINITION } from "./connection-search.js";
 import { GLOB_TOOL_DEFINITION } from "./glob.js";
 import { GREP_TOOL_DEFINITION } from "./grep.js";
 import { READ_FILE_TOOL_DEFINITION } from "./read-file.js";
@@ -8,6 +10,7 @@ import { TODO_TOOL_DEFINITION } from "./todo.js";
 import { WEB_FETCH_TOOL_DEFINITION } from "./web-fetch.js";
 import { WEB_SEARCH_TOOL_DEFINITION } from "./web-search.js";
 import { WRITE_FILE_TOOL_DEFINITION } from "./write-file.js";
+export { ConnectionRegistryKey } from "./connection-search.js";
 export { ReadFileStateKey } from "./file-state.js";
 export { SkillStateKey } from "./skill.js";
 export { TodoStateKey } from "./todo.js";
@@ -16,7 +19,7 @@ export { TodoStateKey } from "./todo.js";
  * alongside authored tools during graph resolution.
  *
  * The set of tools varies based on the agent configuration. For example,
- * `activate_skill` is only included when the agent has skills.
+ * `load_skill` is only included when the agent has skills.
  */
 export function getFrameworkToolDefinitions(config) {
     const definitions = [
@@ -36,6 +39,10 @@ export function getFrameworkToolDefinitions(config) {
     if (config.hasSkills) {
         definitions.push(SKILL_TOOL_DEFINITION);
     }
+    if (config.hasConnections) {
+        definitions.push(CONNECTION_SEARCH_TOOL_DEFINITION);
+        definitions.push(CONNECTION_EXECUTE_TOOL_DEFINITION);
+    }
     return definitions;
 }
 /**
@@ -50,6 +57,8 @@ export function getAllFrameworkToolNames() {
     return new Set([
         ASK_QUESTION_TOOL_DEFINITION.name,
         BASH_TOOL_DEFINITION.name,
+        CONNECTION_EXECUTE_TOOL_DEFINITION.name,
+        CONNECTION_SEARCH_TOOL_DEFINITION.name,
         GLOB_TOOL_DEFINITION.name,
         GREP_TOOL_DEFINITION.name,
         READ_FILE_TOOL_DEFINITION.name,

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAIzC;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAG3C;IACC,MAAM,WAAW,GAA6B;QAC5C,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;QACpB,yBAAyB;QACzB,0BAA0B;QAC1B,oBAAoB;QACpB,yBAAyB;QACzB,0BAA0B;KAC3B,CAAC;IAEF,2DAA2D;IAC3D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,WAAW,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,GAAG,CAAC;QACb,4BAA4B,CAAC,IAAI;QACjC,oBAAoB,CAAC,IAAI;QACzB,oBAAoB,CAAC,IAAI;QACzB,oBAAoB,CAAC,IAAI;QACzB,yBAAyB,CAAC,IAAI;QAC9B,0BAA0B,CAAC,IAAI;QAC/B,oBAAoB,CAAC,IAAI;QACzB,yBAAyB,CAAC,IAAI;QAC9B,0BAA0B,CAAC,IAAI;QAC/B,qBAAqB,CAAC,IAAI;KAC3B,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAIzC;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAI3C;IACC,MAAM,WAAW,GAA6B;QAC5C,oBAAoB;QACpB,oBAAoB;QACpB,oBAAoB;QACpB,yBAAyB;QACzB,0BAA0B;QAC1B,oBAAoB;QACpB,yBAAyB;QACzB,0BAA0B;KAC3B,CAAC;IAEF,2DAA2D;IAC3D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,WAAW,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,WAAW,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACpD,WAAW,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,GAAG,CAAC;QACb,4BAA4B,CAAC,IAAI;QACjC,oBAAoB,CAAC,IAAI;QACzB,kCAAkC,CAAC,IAAI;QACvC,iCAAiC,CAAC,IAAI;QACtC,oBAAoB,CAAC,IAAI;QACzB,oBAAoB,CAAC,IAAI;QACzB,yBAAyB,CAAC,IAAI;QAC9B,0BAA0B,CAAC,IAAI;QAC/B,oBAAoB,CAAC,IAAI;QACzB,yBAAyB,CAAC,IAAI;QAC9B,0BAA0B,CAAC,IAAI;QAC/B,qBAAqB,CAAC,IAAI;KAC3B,CAAC,CAAC;AACL,CAAC"}

package/dist/src/runtime/framework-tools/skill.d.ts

@@ -8,19 +8,19 @@ export interface SkillToolState {
 }
 export declare const SkillStateKey: ContextKey<SkillToolState>;
 /**
- * Typed input accepted by {@link executeActivateSkillTool}.
+ * Typed input accepted by {@link executeLoadSkillTool}.
  */
-export interface ActivateSkillInput {
+export interface LoadSkillInput {
     readonly skill: string;
 }
 /**
- * Executes the `activate_skill` tool.
+ * Executes the `load_skill` tool.
  *
  * Reads the {@link SkillAccess} from the active unified context and
  * delegates to `skillAccess.activate()`. On successful activation,
  * persists the updated active skill IDs to {@link SkillStateKey} so
  * they survive workflow step boundaries and compaction.
  */
-export declare function executeActivateSkillTool(args: ActivateSkillInput): Promise<unknown>;
+export declare function executeLoadSkillTool(args: LoadSkillInput): Promise<unknown>;
 export declare const SKILL_TOOL_DEFINITION: ResolvedToolDefinition;
 //# sourceMappingURL=skill.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,eAAO,MAAM,aAAa,4BAExB,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBzF;AAMD,eAAO,MAAM,qBAAqB,EAAE,sBAwBnC,CAAC"}
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/skill.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED,eAAO,MAAM,aAAa,4BAA+C,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBjF;AAMD,eAAO,MAAM,qBAAqB,EAAE,sBA4BnC,CAAC"}

package/dist/src/runtime/framework-tools/skill.js

@@ -1,22 +1,20 @@
 import { requireContext } from "../../context/container.js";
 import { ContextKey } from "../../context/key.js";
 import { SkillKey } from "../../context/keys.js";
-export const SkillStateKey = new ContextKey("ash.skills", {
-    initial: () => ({ activeIds: [] }),
-});
+export const SkillStateKey = new ContextKey("ash.skills");
 /**
- * Executes the `activate_skill` tool.
+ * Executes the `load_skill` tool.
  *
  * Reads the {@link SkillAccess} from the active unified context and
  * delegates to `skillAccess.activate()`. On successful activation,
  * persists the updated active skill IDs to {@link SkillStateKey} so
  * they survive workflow step boundaries and compaction.
  */
-export async function executeActivateSkillTool(args) {
+export async function executeLoadSkillTool(args) {
     const ctx = requireContext();
     const skills = ctx.tryGet(SkillKey);
     if (skills === undefined) {
-        throw new Error("The activate_skill tool requires skill access on the runtime context. " +
+        throw new Error("The load_skill tool requires skill access on the runtime context. " +
             "Ensure the step is running inside a managed runtime context with skill support.");
     }
     const { skill } = args;
@@ -30,8 +28,13 @@ export async function executeActivateSkillTool(args) {
 // Tool definition
 // ---------------------------------------------------------------------------
 export const SKILL_TOOL_DEFINITION = {
-    description: "Load the full instructions for one available skill by name or id before relying on that skill.",
-    execute: (input) => executeActivateSkillTool(input),
+    description: [
+        "Load the full instructions for one available skill by name or id.",
+        "Use this tool when the request clearly matches a listed skill description or when the user explicitly asks for that skill.",
+        "Loading adds the skill instructions to the current turn.",
+        'Choose the "skill" value from the Available skills block.',
+    ].join(" "),
+    execute: (input) => executeLoadSkillTool(input),
     inputSchema: {
         additionalProperties: false,
         properties: {
@@ -43,14 +46,14 @@ export const SKILL_TOOL_DEFINITION = {
         required: ["skill"],
         type: "object",
     },
-    logicalPath: "ash:framework/activate-skill",
-    name: "activate_skill",
+    logicalPath: "ash:framework/load-skill",
+    name: "load_skill",
     onCompact({ ctx }) {
         // Wipe what the tool wrote so stale skill activations don't persist
         // across the compaction boundary.
         ctx.set(SkillStateKey, { activeIds: [] });
     },
-    sourceId: "ash:activate-skill-tool",
+    sourceId: "ash:load-skill-tool",
     sourceKind: "module",
 };
 //# sourceMappingURL=skill.js.map

package/dist/src/runtime/framework-tools/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAcjD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,UAAU,CAAiB,YAAY,EAAE;IACxE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;CACnC,CAAC,CAAC;AASH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAAwB;IACrE,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,wEAAwE;YACtE,iFAAiF,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,WAAW,EACT,gGAAgG;IAClG,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAA2B,CAAC;IACzE,WAAW,EAAE;QACX,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,WAAW,EAAE,6BAA6B;gBAC1C,IAAI,EAAE,QAAQ;aACf;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,IAAI,EAAE,QAAQ;KACf;IACD,WAAW,EAAE,8BAA8B;IAC3C,IAAI,EAAE,gBAAgB;IACtB,SAAS,CAAC,EAAE,GAAG,EAAE;QACf,oEAAoE;QACpE,kCAAkC;QAClC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,QAAQ,EAAE,yBAAyB;IACnC,UAAU,EAAE,QAAQ;CACrB,CAAC"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAcjD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,UAAU,CAAiB,YAAY,CAAC,CAAC;AAS1E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAoB;IAC7D,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,oEAAoE;YAClE,iFAAiF,CACpF,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IACvB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,WAAW,EAAE;QACX,mEAAmE;QACnE,4HAA4H;QAC5H,0DAA0D;QAC1D,2DAA2D;KAC5D,CAAC,IAAI,CAAC,GAAG,CAAC;IACX,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,KAAuB,CAAC;IACjE,WAAW,EAAE;QACX,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,WAAW,EAAE,6BAA6B;gBAC1C,IAAI,EAAE,QAAQ;aACf;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,IAAI,EAAE,QAAQ;KACf;IACD,WAAW,EAAE,0BAA0B;IACvC,IAAI,EAAE,YAAY;IAClB,SAAS,CAAC,EAAE,GAAG,EAAE;QACf,oEAAoE;QACpE,kCAAkC;QAClC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE,QAAQ;CACrB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/todo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,YAAY,uBAEvB,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACtC;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAY7D;AAMD,eAAO,MAAM,oBAAoB,EAAE,sBAmElC,CAAC"}
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../../../../src/runtime/framework-tools/todo.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,YAAY,uBAAwC,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAC;CACtC;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAY7D;AAMD,eAAO,MAAM,oBAAoB,EAAE,sBAmElC,CAAC"}

package/dist/src/runtime/framework-tools/todo.js

@@ -1,8 +1,6 @@
 import { requireContext } from "../../context/container.js";
 import { ContextKey } from "../../context/key.js";
-export const TodoStateKey = new ContextKey("ash.todo", {
-    initial: () => ({ items: [] }),
-});
+export const TodoStateKey = new ContextKey("ash.todo");
 function formatTodoSummary(state) {
     if (state.items.length === 0)
         return undefined;
@@ -46,7 +44,7 @@ export function executeTodoTool(input) {
         ctx.set(TodoStateKey, newState);
         return formatTodoResult(newState);
     }
-    const current = ctx.get(TodoStateKey);
+    const current = ctx.ensure(TodoStateKey, () => ({ items: [] }));
     return formatTodoResult(current);
 }
 // ---------------------------------------------------------------------------

package/dist/src/runtime/framework-tools/todo.js.map

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