experimental-ash 0.26.0 → 0.27.0

package/dist/src/public/sandbox/vercel-sandbox.js

@@ -1 +1 @@
-export {};
+export{};

package/dist/src/public/schedules/index.js

@@ -1,4 +1 @@
-/**
- * Schedule authoring helpers for `agent/schedules/*` files.
- */
-export { defineSchedule, } from "#public/definitions/schedule.js";
+import{defineSchedule}from"#public/definitions/schedule.js";export{defineSchedule};

package/dist/src/public/skills/index.js

@@ -1,5 +1 @@
-/**
- * Skill authoring helpers and runtime accessors.
- */
-export { getSkill } from "#context/accessors.js";
-export { defineSkill, } from "#public/definitions/skill.js";
+import{defineSkill}from"#public/definitions/skill.js";import{getSkill}from"#context/accessors.js";export{defineSkill,getSkill};

package/dist/src/public/tool-result-narrowing.js

@@ -1,87 +1 @@
-/**
- * Cross-instance symbol for reading the stable definition key stamped
- * by `defineTool` / `defineMcpClientConnection`. `Symbol.for` ensures
- * both the resolution pipeline's module copy and the user's import
- * share the same property key.
- */
-const DEFINITION_KEY = Symbol.for("experimental-ash.definition-source-key");
-/**
- * Global registry mapping definition keys to their resolved runtime
- * names. Rooted on `globalThis` via `Symbol.for` so every module
- * copy shares one registry — same pattern as `context/key.ts`
- * (`KEY_REGISTRY_GLOBAL_KEY`).
- */
-const REGISTRY_SYMBOL = Symbol.for("experimental-ash.definition-source-registry");
-const registryContainer = globalThis;
-if (registryContainer[REGISTRY_SYMBOL] === undefined) {
-    registryContainer[REGISTRY_SYMBOL] = new Map();
-}
-const definitionSourceRegistry = registryContainer[REGISTRY_SYMBOL];
-/**
- * Stamps a stable content-derived key on the definition so it can be
- * identified across module instances. Called by `defineTool` and
- * `defineMcpClientConnection` at definition time.
- */
-export function stampDefinitionKey(definition, key) {
-    Object.defineProperty(definition, DEFINITION_KEY, { value: key });
-}
-/**
- * Reads the stable key from a definition, or `undefined` if unstamped.
- */
-function readDefinitionKey(definition) {
-    if (DEFINITION_KEY in definition) {
-        return definition[DEFINITION_KEY];
-    }
-    return undefined;
-}
-/**
- * Registers a definition key → source entry mapping in the global
- * registry. Called by the resolution pipeline after loading the
- * authored module.
- */
-export function registerDefinitionSource(key, entry) {
-    definitionSourceRegistry.set(key, entry);
-}
-const CONNECTION_TOOL_SEPARATOR = "__";
-/**
- * Narrows a {@link RuntimeActionResult} to a typed tool or connection
- * result by matching against an authored definition object.
- *
- * Pass a `ToolDefinition` to get a typed `output`; pass a
- * `McpClientConnectionDefinition` to match any tool from that
- * connection (`output` stays `unknown`).
- *
- * Returns `undefined` when the result doesn't match, or when
- * `isError` is `true`.
- */
-export const toolResultFrom = toolResultFromImpl;
-function toolResultFromImpl(result, source) {
-    if (result.kind !== "tool-result")
-        return undefined;
-    if (result.isError === true)
-        return undefined;
-    const key = readDefinitionKey(source);
-    if (key === undefined)
-        return undefined;
-    const entry = definitionSourceRegistry.get(key);
-    if (entry === undefined)
-        return undefined;
-    if (entry.kind === "tool") {
-        if (result.toolName !== entry.name)
-            return undefined;
-        return {
-            callId: result.callId,
-            output: result.output,
-            toolName: result.toolName,
-        };
-    }
-    const prefix = entry.name + CONNECTION_TOOL_SEPARATOR;
-    if (!result.toolName.startsWith(prefix))
-        return undefined;
-    return {
-        callId: result.callId,
-        connectionToolName: result.toolName.slice(prefix.length),
-        output: result.output,
-        toolName: result.toolName,
-    };
-}
+var DEFINITION_KEY=Symbol.for(`experimental-ash.definition-source-key`),REGISTRY_SYMBOL=Symbol.for(`experimental-ash.definition-source-registry`),registryContainer=globalThis;registryContainer[REGISTRY_SYMBOL]===void 0&&(registryContainer[REGISTRY_SYMBOL]=new Map);var definitionSourceRegistry=registryContainer[REGISTRY_SYMBOL];function stampDefinitionKey(t,n){Object.defineProperty(t,DEFINITION_KEY,{value:n})}function readDefinitionKey(t){if(DEFINITION_KEY in t)return t[DEFINITION_KEY]}function registerDefinitionSource(e,t){definitionSourceRegistry.set(e,t)}var CONNECTION_TOOL_SEPARATOR=`__`,toolResultFrom=toolResultFromImpl;function toolResultFromImpl(e,t){if(e.kind!==`tool-result`||e.isError===!0)return;let n=readDefinitionKey(t);if(n===void 0)return;let r=definitionSourceRegistry.get(n);if(r===void 0)return;if(r.kind===`tool`)return e.toolName===r.name?{callId:e.callId,output:e.output,toolName:e.toolName}:void 0;let i=r.name+CONNECTION_TOOL_SEPARATOR;if(e.toolName.startsWith(i))return{callId:e.callId,connectionToolName:e.toolName.slice(i.length),output:e.output,toolName:e.toolName}}export{registerDefinitionSource,stampDefinitionKey,toolResultFrom};

package/dist/src/public/tools/approval/approval-helpers.js

@@ -1,22 +1 @@
-/**
- * Returns a `needsApproval` callback that always requires user approval before
- * the tool executes.
- */
-export function always() {
-    return () => true;
-}
-/**
- * Returns a `needsApproval` callback that never requires user approval before
- * the tool executes.
- */
-export function never() {
-    return () => false;
-}
-/**
- * Returns a `needsApproval` callback that requires approval only the first
- * time the tool is used in a session. Subsequent calls within the same session
- * are allowed automatically.
- */
-export function once() {
-    return ({ approvedTools, toolName }) => !approvedTools.has(toolName);
-}
+function always(){return()=>!0}function never(){return()=>!1}function once(){return({approvedTools:e,toolName:t})=>!e.has(t)}export{always,never,once};

package/dist/src/public/tools/approval/index.js

@@ -1,4 +1 @@
-/**
- * Per-tool approval helpers used inside `agent/tools/*.ts` files.
- */
-export { always, never, once } from "#public/tools/approval/approval-helpers.js";
+import{always,never,once}from"#public/tools/approval/approval-helpers.js";export{always,never,once};

package/dist/src/public/tools/defaults.js

@@ -1,70 +1 @@
-/**
- * Framework-provided tool definitions exposed as plain {@link ToolDefinition}
- * values so authors can spread, wrap, or patch them inside their own
- * `agent/tools/*.ts` files.
- */
-import { BASH_TOOL_DEFINITION } from "#runtime/framework-tools/bash.js";
-import { GLOB_TOOL_DEFINITION } from "#runtime/framework-tools/glob.js";
-import { GREP_TOOL_DEFINITION } from "#runtime/framework-tools/grep.js";
-import { READ_FILE_TOOL_DEFINITION } from "#runtime/framework-tools/read-file.js";
-import { SKILL_TOOL_DEFINITION } from "#runtime/framework-tools/skill.js";
-import { TODO_TOOL_DEFINITION } from "#runtime/framework-tools/todo.js";
-import { WEB_FETCH_TOOL_DEFINITION } from "#runtime/framework-tools/web-fetch.js";
-import { WEB_SEARCH_TOOL_DEFINITION } from "#runtime/framework-tools/web-search.js";
-import { WRITE_FILE_TOOL_DEFINITION } from "#runtime/framework-tools/write-file.js";
-import { toPublicToolDefinition } from "#public/tools/internal.js";
-/**
- * Framework-provided shell execution tool. Spread or wrap to customize.
- */
-export const bash = toPublicToolDefinition(BASH_TOOL_DEFINITION);
-/**
- * Framework-provided file search tool. Finds files by glob pattern. Spread
- * or wrap to customize.
- */
-export const glob = toPublicToolDefinition(GLOB_TOOL_DEFINITION);
-/**
- * Framework-provided content search tool. Searches file contents by regex
- * pattern. Spread or wrap to customize.
- */
-export const grep = toPublicToolDefinition(GREP_TOOL_DEFINITION);
-/**
- * Framework-provided file reader tool. Spread or wrap to customize. Carries
- * compaction state-reset behavior so a wrapped replacement still clears the
- * durable read-file stamps on context compaction.
- */
-export const readFile = toPublicToolDefinition(READ_FILE_TOOL_DEFINITION);
-/**
- * Framework-provided file writer tool. Spread or wrap to customize.
- * Enforces read-before-write for existing files and stale-read detection.
- */
-export const writeFile = toPublicToolDefinition(WRITE_FILE_TOOL_DEFINITION);
-/**
- * Framework-provided HTTP fetch tool. Spread or wrap to customize.
- */
-export const webFetch = toPublicToolDefinition(WEB_FETCH_TOOL_DEFINITION);
-/**
- * Framework-provided durable todo list tool. Spreading the default carries
- * its closure-bound state behavior — the executor still reads and writes the
- * framework's internal todo state. Replace with a fully custom executor (and
- * your own `ContextKey`) if you need different state semantics.
- */
-export const todo = toPublicToolDefinition(TODO_TOOL_DEFINITION);
-/**
- * Framework-provided skill loading tool. Only effective when the agent has
- * skills declared (the framework otherwise omits it from the default tool
- * list).
- */
-export const loadSkill = toPublicToolDefinition(SKILL_TOOL_DEFINITION);
-/**
- * Framework-provided web search tool. The actual implementation is resolved
- * at runtime based on the model provider — there is no local execute.
- * Override with `defineTool()` to provide a custom implementation.
- */
-export const webSearch = {
-    description: WEB_SEARCH_TOOL_DEFINITION.description,
-    inputSchema: {},
-    execute() {
-        throw new Error("web_search is provider-managed and has no local execute. " +
-            "Override with defineTool() to provide a custom implementation.");
-    },
-};
+import{WEB_SEARCH_TOOL_DEFINITION}from"#runtime/framework-tools/web-search.js";import{BASH_TOOL_DEFINITION}from"#runtime/framework-tools/bash.js";import{GLOB_TOOL_DEFINITION}from"#runtime/framework-tools/glob.js";import{GREP_TOOL_DEFINITION}from"#runtime/framework-tools/grep.js";import{READ_FILE_TOOL_DEFINITION}from"#runtime/framework-tools/read-file.js";import{SKILL_TOOL_DEFINITION}from"#runtime/framework-tools/skill.js";import{TODO_TOOL_DEFINITION}from"#runtime/framework-tools/todo.js";import{WEB_FETCH_TOOL_DEFINITION}from"#runtime/framework-tools/web-fetch.js";import{WRITE_FILE_TOOL_DEFINITION}from"#runtime/framework-tools/write-file.js";import{toPublicToolDefinition}from"#public/tools/internal.js";var bash=toPublicToolDefinition(BASH_TOOL_DEFINITION),glob=toPublicToolDefinition(GLOB_TOOL_DEFINITION),grep=toPublicToolDefinition(GREP_TOOL_DEFINITION),readFile=toPublicToolDefinition(READ_FILE_TOOL_DEFINITION),writeFile=toPublicToolDefinition(WRITE_FILE_TOOL_DEFINITION),webFetch=toPublicToolDefinition(WEB_FETCH_TOOL_DEFINITION),todo=toPublicToolDefinition(TODO_TOOL_DEFINITION),loadSkill=toPublicToolDefinition(SKILL_TOOL_DEFINITION),webSearch={description:WEB_SEARCH_TOOL_DEFINITION.description,inputSchema:{},execute(){throw Error(`web_search is provider-managed and has no local execute. Override with defineTool() to provide a custom implementation.`)}};export{bash,glob,grep,loadSkill,readFile,todo,webFetch,webSearch,writeFile};

package/dist/src/public/tools/define-bash-tool.js

@@ -1,14 +1 @@
-import { executeBashOnSandbox } from "#execution/sandbox/bash-tool.js";
-import { BASH_INPUT_SCHEMA } from "#runtime/framework-tools/bash.js";
-/**
- * Defines a model-visible shell-runner tool for the agent sandbox.
- */
-export function defineBashTool(input = {}) {
-    return {
-        description: input.description ?? "Execute a shell command in the workspace sandbox.",
-        async execute(args) {
-            return executeBashOnSandbox(args);
-        },
-        inputSchema: BASH_INPUT_SCHEMA,
-    };
-}
+import{BASH_INPUT_SCHEMA}from"#runtime/framework-tools/bash.js";import{executeBashOnSandbox}from"#execution/sandbox/bash-tool.js";function defineBashTool(t={}){return{description:t.description??`Execute a shell command in the workspace sandbox.`,async execute(e){return executeBashOnSandbox(e)},inputSchema:BASH_INPUT_SCHEMA}}export{defineBashTool};

package/dist/src/public/tools/define-glob-tool.js

@@ -1,21 +1 @@
-import { executeGlobOnSandbox } from "#execution/sandbox/glob-tool.js";
-import { GLOB_INPUT_SCHEMA } from "#runtime/framework-tools/glob.js";
-/**
- * Defines a model-visible file-search tool that discovers files by
- * glob pattern inside the agent's sandbox. Uses the same executor core
- * as the framework `glob` tool, so input schema, error messages, and
- * result shape are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/find_files.ts` becomes a tool named
- * `find_files`.
- */
-export function defineGlobTool(input = {}) {
-    return {
-        description: input.description ?? "Search for files by glob pattern in the workspace sandbox.",
-        async execute(args) {
-            return executeGlobOnSandbox(args);
-        },
-        inputSchema: GLOB_INPUT_SCHEMA,
-    };
-}
+import{GLOB_INPUT_SCHEMA}from"#runtime/framework-tools/glob.js";import{executeGlobOnSandbox}from"#execution/sandbox/glob-tool.js";function defineGlobTool(t={}){return{description:t.description??`Search for files by glob pattern in the workspace sandbox.`,async execute(e){return executeGlobOnSandbox(e)},inputSchema:GLOB_INPUT_SCHEMA}}export{defineGlobTool};

package/dist/src/public/tools/define-grep-tool.js

@@ -1,21 +1 @@
-import { executeGrepOnSandbox } from "#execution/sandbox/grep-tool.js";
-import { GREP_INPUT_SCHEMA } from "#runtime/framework-tools/grep.js";
-/**
- * Defines a model-visible content-search tool that searches file
- * contents by pattern inside the agent's sandbox. Uses the same
- * executor core as the framework `grep` tool, so input schema, error
- * messages, and result shape are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/search_code.ts` becomes a tool named
- * `search_code`.
- */
-export function defineGrepTool(input = {}) {
-    return {
-        description: input.description ?? "Search file contents by pattern in the workspace sandbox.",
-        async execute(args) {
-            return executeGrepOnSandbox(args);
-        },
-        inputSchema: GREP_INPUT_SCHEMA,
-    };
-}
+import{GREP_INPUT_SCHEMA}from"#runtime/framework-tools/grep.js";import{executeGrepOnSandbox}from"#execution/sandbox/grep-tool.js";function defineGrepTool(t={}){return{description:t.description??`Search file contents by pattern in the workspace sandbox.`,async execute(e){return executeGrepOnSandbox(e)},inputSchema:GREP_INPUT_SCHEMA}}export{defineGrepTool};

package/dist/src/public/tools/define-read-file-tool.js

@@ -1,27 +1 @@
-import { executeReadFileOnSandbox } from "#execution/sandbox/read-file-tool.js";
-import { clearReadFileState } from "#runtime/framework-tools/file-state.js";
-import { READ_FILE_INPUT_SCHEMA } from "#runtime/framework-tools/read-file.js";
-/**
- * Defines a model-visible file-reader tool that reads files from the
- * agent's sandbox. Uses the same executor core as the framework
- * `read_file` tool, so input schema, error messages, and result shape
- * are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/read_file.ts` becomes a tool named `read_file`.
- */
-export function defineReadFileTool(input = {}) {
-    const onCompact = input.onCompact ??
-        (({ ctx }) => {
-            clearReadFileState(ctx);
-            return {};
-        });
-    return {
-        description: input.description ?? "Read a file from the workspace sandbox.",
-        async execute(args) {
-            return executeReadFileOnSandbox(args);
-        },
-        inputSchema: READ_FILE_INPUT_SCHEMA,
-        onCompact,
-    };
-}
+import{clearReadFileState}from"#runtime/framework-tools/file-state.js";import{READ_FILE_INPUT_SCHEMA}from"#runtime/framework-tools/read-file.js";import{executeReadFileOnSandbox}from"#execution/sandbox/read-file-tool.js";function defineReadFileTool(n={}){let r=n.onCompact??(({ctx:t})=>(clearReadFileState(t),{}));return{description:n.description??`Read a file from the workspace sandbox.`,async execute(e){return executeReadFileOnSandbox(e)},inputSchema:READ_FILE_INPUT_SCHEMA,onCompact:r}}export{defineReadFileTool};

package/dist/src/public/tools/define-write-file-tool.js

@@ -1,21 +1 @@
-import { executeWriteFileOnSandbox, } from "#execution/sandbox/write-file-tool.js";
-import { WRITE_FILE_INPUT_SCHEMA } from "#runtime/framework-tools/write-file.js";
-/**
- * Defines a model-visible file-writer tool that writes files to the
- * agent's sandbox. Uses the same executor core as the framework
- * `write_file` tool, so input schema, error messages, and result shape
- * are identical.
- *
- * The tool's runtime name comes from the authored file's slug — for
- * example `agent/tools/write_file.ts` becomes a tool named
- * `write_file`.
- */
-export function defineWriteFileTool(input = {}) {
-    return {
-        description: input.description ?? "Write a file to the workspace sandbox.",
-        async execute(args) {
-            return executeWriteFileOnSandbox(args);
-        },
-        inputSchema: WRITE_FILE_INPUT_SCHEMA,
-    };
-}
+import{WRITE_FILE_INPUT_SCHEMA}from"#runtime/framework-tools/write-file.js";import{executeWriteFileOnSandbox}from"#execution/sandbox/write-file-tool.js";function defineWriteFileTool(t={}){return{description:t.description??`Write a file to the workspace sandbox.`,async execute(e){return executeWriteFileOnSandbox(e)},inputSchema:WRITE_FILE_INPUT_SCHEMA}}export{defineWriteFileTool};

package/dist/src/public/tools/index.js

@@ -1,10 +1 @@
-/**
- * Tool authoring helpers for `agent/tools/*.ts` files.
- */
-export { defineTool, disableTool, isDisabledToolSentinel, } from "#public/definitions/tool.js";
-export { toolResultFrom, } from "#public/tool-result-narrowing.js";
-export { defineBashTool } from "#public/tools/define-bash-tool.js";
-export { defineGlobTool } from "#public/tools/define-glob-tool.js";
-export { defineGrepTool } from "#public/tools/define-grep-tool.js";
-export { defineReadFileTool, } from "#public/tools/define-read-file-tool.js";
-export { defineWriteFileTool, } from "#public/tools/define-write-file-tool.js";
+import{defineTool,disableTool,isDisabledToolSentinel}from"#public/definitions/tool.js";import{toolResultFrom}from"#public/tool-result-narrowing.js";import{defineBashTool}from"#public/tools/define-bash-tool.js";import{defineGlobTool}from"#public/tools/define-glob-tool.js";import{defineGrepTool}from"#public/tools/define-grep-tool.js";import{defineReadFileTool}from"#public/tools/define-read-file-tool.js";import{defineWriteFileTool}from"#public/tools/define-write-file-tool.js";export{defineBashTool,defineGlobTool,defineGrepTool,defineReadFileTool,defineTool,defineWriteFileTool,disableTool,isDisabledToolSentinel,toolResultFrom};

package/dist/src/public/tools/internal.js

@@ -1,24 +1 @@
-/**
- * Converter that strips internal identity fields from a framework
- * {@link ResolvedToolDefinition} so it can be re-exported as a public
- * {@link ToolDefinition}.
- */
-export function toPublicToolDefinition(definition) {
-    if (!definition.execute) {
-        throw new Error(`Tool "${definition.name}" is client-side and cannot be re-exported publicly.`);
-    }
-    const execute = definition.execute;
-    const inputSchema = definition.inputSchema;
-    const publicDefinition = {
-        description: definition.description,
-        execute,
-        inputSchema: (inputSchema ?? {}),
-    };
-    if (definition.needsApproval !== undefined) {
-        publicDefinition.needsApproval = definition.needsApproval;
-    }
-    if (definition.onCompact !== undefined) {
-        publicDefinition.onCompact = definition.onCompact;
-    }
-    return publicDefinition;
-}
+function toPublicToolDefinition(e){if(!e.execute)throw Error(`Tool "${e.name}" is client-side and cannot be re-exported publicly.`);let t=e.execute,n=e.inputSchema,r={description:e.description,execute:t,inputSchema:n??{}};return e.needsApproval!==void 0&&(r.needsApproval=e.needsApproval),e.onCompact!==void 0&&(r.onCompact=e.onCompact),r}export{toPublicToolDefinition};

package/dist/src/public/types/json.js

@@ -1,13 +1 @@
-/**
- * Shared JSON primitive used by public Ash APIs that need to declare
- * author-supplied values as JSON-serializable.
- *
- * The canonical use site is {@link AuthorizationDefinition}, whose
- * `State` type is constrained to {@link JsonValue} so that state
- * journaled by WDK between `startAuthorization` and
- * `completeAuthorization` is guaranteed round-trippable through a
- * serializer. Kept in a dedicated module so any future public
- * interface with the same serialization requirement can reuse it
- * without depending on a connection-specific module.
- */
-export {};
+export{};

package/dist/src/react/index.js

@@ -1,3 +1 @@
-export { useAshAgent, } from "#react/use-ash-agent.js";
-export {} from "#client/reducer.js";
-export { defaultMessageReducer, } from "#client/message-reducer.js";
+import{defaultMessageReducer}from"#client/message-reducer.js";import{useAshAgent}from"#react/use-ash-agent.js";export{defaultMessageReducer,useAshAgent};