@aotui/mobile-ai-native 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/demo/inbox/InboxTUI.d.ts

@@ -1,3 +1,3 @@
-import type { ToolDefinition } from "../../core/types";
-import type { InboxState } from "./state";
-export declare function createInboxSnapshotBundle(state: InboxState, visibleTools: readonly ToolDefinition[]): import("../..").SnapshotBundle;
+import type { ToolAvailability, ToolDefinition } from "../../core/types.js";
+import type { InboxState } from "./state.js";
+export declare function createInboxSnapshotBundle(state: InboxState, tools: readonly ToolDefinition[], toolAvailability: Readonly<Record<string, ToolAvailability>>): import("../..").SnapshotBundle;

package/dist/demo/inbox/InboxTUI.js

@@ -1,13 +1,32 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "preact/jsx-runtime";
 /** @jsxImportSource preact */
 import renderToString from "preact-render-to-string";
-import { createRefCollector } from "../../core/ref/ref-index";
-import { createSnapshotAssembler } from "../../projection/tui/createSnapshotAssembler";
-import { renderViewFragment } from "../../projection/tui/renderViewFragment";
-import { RefProvider } from "../../ref/RefContext";
-import { useDataRef } from "../../ref/useDataRef";
-import { useArrayRef } from "../../ref/useArrayRef";
-import { isInboxSearchActive, } from "./state";
+import { createRefCollector } from "../../core/ref/ref-index.js";
+import { createSnapshotAssembler } from "../../projection/tui/createSnapshotAssembler.js";
+import { renderViewFragment } from "../../projection/tui/renderViewFragment.js";
+import { RefProvider } from "../../ref/RefContext.js";
+import { useDataRef } from "../../ref/useDataRef.js";
+import { useArrayRef } from "../../ref/useArrayRef.js";
+import { isInboxSearchActive, } from "./state.js";
+function describeToolAvailability(availability) {
+    if (!availability) {
+        return "unknown";
+    }
+    if (availability.ok) {
+        return "available";
+    }
+    return `${availability.code}: ${availability.message}`;
+}
+function renderToolManifest(tools, toolAvailability) {
+    return tools
+        .map((tool) => {
+        const preconditions = tool.preconditions.length
+            ? tool.preconditions.join("; ")
+            : "none";
+        return `<item>${tool.name}: ${tool.description} | exposure=${tool.exposure} | availability=${describeToolAvailability(toolAvailability[tool.name])} | preconditions=${preconditions}</item>`;
+    })
+        .join("");
+}
 function InboxRootContent() {
     return (_jsxs(_Fragment, { children: [_jsx("text", { children: "App Navigation" }), _jsx("text", { children: "Semantic view graph" }), _jsx("item", { children: "Inbox: primary message list view." }), _jsx("item", { children: "Enter Inbox: mounted by default when the app opens." }), _jsx("item", { children: "Inbox actions: openMessage." }), _jsx("item", { children: "InboxSearch: focused search/results view for inbox queries." }), _jsx("item", { children: "Enter InboxSearch: use searchMessages when inbox search is relevant." }), _jsx("item", { children: "InboxSearch actions: searchMessages." }), _jsx("item", { children: "MessageDetail: opened message detail view." }), _jsx("item", { children: "Enter MessageDetail: use openMessage from Inbox." }), _jsx("item", { children: "MessageDetail actions: inspect the opened message state." })] }));
 }
@@ -33,14 +52,16 @@ function renderFragmentMarkup(children, collector) {
         markup: renderToString(_jsx(RefProvider, { registry: collector, children: children })),
     };
 }
-export function createInboxSnapshotBundle(state, visibleTools) {
+export function createInboxSnapshotBundle(state, tools, toolAvailability) {
     const collector = createRefCollector();
     const rootMarkup = renderFragmentMarkup(_jsx(InboxRootContent, {}), collector);
     const rootView = renderViewFragment({
         id: "root",
         type: "Root",
         name: "Navigation",
-        markup: rootMarkup.markup,
+        markup: rootMarkup.markup +
+            "<text>Tool manifest is stable; runtime validation decides whether a tool is currently executable.</text>" +
+            renderToolManifest(tools, toolAvailability),
     });
     const inboxMarkup = renderFragmentMarkup(_jsx(InboxListContent, { state: state }), collector);
     const mountedViews = [
@@ -73,6 +94,7 @@ export function createInboxSnapshotBundle(state, visibleTools) {
         rootView,
         mountedViews,
         refIndex: collector.snapshot(),
-        visibleTools,
+        tools,
+        toolAvailability,
     });
 }

package/dist/demo/inbox/actions.d.ts

@@ -1,15 +1,15 @@
 import { z } from "zod";
-import type { InboxEvent, InboxState } from "./state";
+import type { InboxEvent, InboxState } from "./state.js";
 declare const inboxMessageSchema: z.ZodObject<{
     id: z.ZodString;
     subject: z.ZodString;
     opened: z.ZodBoolean;
 }, z.core.$strip>;
 export declare function createInboxActions(): {
-    openMessage: import("../..").ViewTypeToolActionDefinition<InboxState, InboxEvent, {
+    openMessage: import("../..").ActionDefinition<InboxState, InboxEvent, {
         message: z.infer<typeof inboxMessageSchema>;
     }>;
-    searchMessages: import("../..").ViewTypeToolActionDefinition<InboxState, InboxEvent, {
+    searchMessages: import("../..").ActionDefinition<InboxState, InboxEvent, {
         query: string;
     }>;
 };

package/dist/demo/inbox/actions.js

@@ -1,24 +1,55 @@
 import { z } from "zod";
-import { defineViewTypeTool } from "../../core/action/defineViewTypeTool";
-import { isInboxSearchActive, isInboxSearchRelevant } from "./state";
+import { defineAction } from "../../core/action/defineAction.js";
 const inboxMessageSchema = z.object({
     id: z.string(),
     subject: z.string(),
     opened: z.boolean(),
 });
+function inboxTabNotAvailable() {
+    return {
+        ok: false,
+        code: "PRECONDITION_NOT_MET",
+        message: "Inbox tools are only available when the inbox tab is active.",
+        reason: "current_tab_is_not_inbox",
+        requiredState: {
+            currentTab: "inbox",
+        },
+    };
+}
 export function createInboxActions() {
-    const openMessage = defineViewTypeTool({
+    const openMessage = defineAction({
         name: "openMessage",
         description: "Open a message from the inbox.",
         schema: z.object({
             message: inboxMessageSchema,
         }),
-        viewType: "Inbox",
         meta: {
             supportsRefs: true,
         },
-        visibility(state) {
-            return state.shell.currentTab === "inbox";
+        exposure: "static",
+        preconditions: [
+            "Inbox tab is active",
+            "The message ref points to a message in the current inbox snapshot",
+        ],
+        getAvailability(state) {
+            if (state.shell.currentTab !== "inbox") {
+                return inboxTabNotAvailable();
+            }
+            if (state.inbox.items.length === 0) {
+                return {
+                    ok: false,
+                    code: "PRECONDITION_NOT_MET",
+                    message: "No inbox messages are available to open.",
+                    reason: "no_inbox_messages",
+                    requiredState: {
+                        currentTab: "inbox",
+                        messageCount: 1,
+                    },
+                };
+            }
+            return {
+                ok: true,
+            };
         },
         handler(ctx, input) {
             ctx.emit({ type: "MessageOpened", messageId: input.message.id });
@@ -34,16 +65,24 @@ export function createInboxActions() {
             };
         },
     });
-    const searchMessages = defineViewTypeTool({
+    const searchMessages = defineAction({
         name: "searchMessages",
         description: "Search inbox messages.",
         schema: z.object({
             query: z.string().min(1),
         }),
-        viewType: "Inbox",
-        visibility(state) {
-            return (state.shell.currentTab === "inbox" &&
-                (isInboxSearchRelevant(state) || isInboxSearchActive(state)));
+        exposure: "static",
+        preconditions: [
+            "Inbox tab is active",
+            "The query input is a non-empty string",
+        ],
+        getAvailability(state) {
+            if (state.shell.currentTab !== "inbox") {
+                return inboxTabNotAvailable();
+            }
+            return {
+                ok: true,
+            };
         },
         async handler(ctx, input) {
             ctx.emit({ type: "SearchStarted", query: input.query });

package/dist/demo/inbox/createInboxApp.d.ts

@@ -1,10 +1,10 @@
-import { type InboxMessage } from "./state";
+import { type InboxMessage } from "./state.js";
 export declare function createInboxApp(config: {
     initialMessages: InboxMessage[];
 }): {
     store: import("../../core/types").Store<import("./state").InboxState, import("./state").InboxEvent>;
     bridge: {
-        listTools(): import("../..").ToolDefinition[];
+        listTools(): readonly import("../..").ToolDefinition[];
         getSnapshotBundle(): import("../..").SnapshotBundle;
         executeTool(name: string, input: Record<string, unknown>, snapshotId: string): Promise<import("../../core/types").ActionResult>;
     };

package/dist/demo/inbox/createInboxApp.js

@@ -1,15 +1,15 @@
 import { jsx as _jsx } from "preact/jsx-runtime";
 /** @jsxImportSource preact */
 import renderToString from "preact-render-to-string";
-import { createActionRuntime } from "../../core/action/createActionRuntime";
-import { createStore } from "../../core/state/createStore";
-import { AppProvider } from "../../projection/gui/AppProvider";
-import { createToolBridge } from "../../tool/createToolBridge";
-import { createInboxActions } from "./actions";
-import { createInboxEffects } from "./effects";
-import { InboxGUI } from "./InboxGUI";
-import { createInboxSnapshotBundle, } from "./InboxTUI";
-import { createInitialInboxState, getInboxRelevantViewTypes, reduceInboxState, } from "./state";
+import { createActionRuntime } from "../../core/action/createActionRuntime.js";
+import { createStore } from "../../core/state/createStore.js";
+import { AppProvider } from "../../projection/gui/AppProvider.js";
+import { createToolBridge } from "../../tool/createToolBridge.js";
+import { createInboxActions } from "./actions.js";
+import { createInboxEffects } from "./effects.js";
+import { InboxGUI } from "./InboxGUI.js";
+import { createInboxSnapshotBundle, } from "./InboxTUI.js";
+import { createInitialInboxState, getInboxRelevantViewTypes, reduceInboxState, } from "./state.js";
 export function createInboxApp(config) {
     const store = createStore({
         initialState: createInitialInboxState(config.initialMessages),
@@ -25,7 +25,8 @@ export function createInboxApp(config) {
     const bridge = createToolBridge({
         actionRuntime,
         renderCurrentSnapshot() {
-            return createInboxSnapshotBundle(store.getState(), actionRuntime.listVisibleTools());
+            const toolSurface = actionRuntime.getToolSurface();
+            return createInboxSnapshotBundle(store.getState(), toolSurface.tools, toolSurface.toolAvailability);
         },
     });
     function renderGUI() {

package/dist/demo/inbox/effects.d.ts

@@ -1,5 +1,5 @@
-import type { InboxEvent, InboxMessage, InboxState } from "./state";
-import type { EffectContext, EffectResult } from "../../core/effect/types";
+import type { InboxEvent, InboxMessage, InboxState } from "./state.js";
+import type { EffectContext, EffectResult } from "../../core/effect/types.js";
 export declare function createInboxEffects(allMessages: InboxMessage[]): {
     searchMessages(ctx: EffectContext<InboxState, InboxEvent>, input: {
         query: string;

package/dist/index.d.ts

@@ -1,25 +1,25 @@
-import { createSnapshotBundle } from "./core/snapshot/createSnapshotBundle";
-import { VERSION } from "./version";
+import { createSnapshotBundle } from "./core/snapshot/createSnapshotBundle.js";
+import { VERSION } from "./version.js";
 export { VERSION };
-export { createStore } from "./core/state/createStore";
+export { createStore } from "./core/state/createStore.js";
 export { createSnapshotBundle };
-export type { RefIndexEntry, MountedViewDescriptor, SnapshotBundle, TraceState, ToolDefinition, StaticViewCatalogEntry, SnapshotAssemblerInput, ViewFragment, } from "./core/types";
-export type { EffectContext, EffectFailure, EffectHandler, EffectMap, EffectResult, EffectSuccess, EffectTrace, } from "./core/effect/types";
-export type { ActionContext, ActionDefinition, } from "./core/action/defineAction";
-export type { ViewTypeToolActionDefinition, } from "./core/action/defineViewTypeTool";
-export { defineAction } from "./core/action/defineAction";
-export { defineViewTypeTool } from "./core/action/defineViewTypeTool";
-export { createActionRuntime } from "./core/action/createActionRuntime";
-export { createToolBridge } from "./tool/createToolBridge";
-export { useDataRef } from "./ref/useDataRef";
-export { useArrayRef } from "./ref/useArrayRef";
-export { View } from "./projection/tui/View";
-export { createSnapshotAssembler } from "./projection/tui/createSnapshotAssembler";
-export { renderTUI } from "./projection/tui/renderTUI";
-export { createReactAppRuntime } from "./projection/react/createReactAppRuntime";
-export type { ReactAppDefinition, ReactAppRuntime, RuntimeTrace, } from "./projection/react/createReactAppRuntime";
-export { AppRuntimeProvider } from "./projection/react/AppRuntimeProvider";
-export { useAppRuntime, useRuntimeActions, useRuntimeState, useRuntimeTrace } from "./projection/react/hooks";
-export { AppProvider } from "./projection/gui/AppProvider";
-export { useAppState, useActions } from "./projection/gui/hooks";
-export { createInboxApp } from "./demo/inbox/createInboxApp";
+export type { RefIndexEntry, MountedViewDescriptor, SnapshotBundle, ToolAvailability, ToolExposure, TraceState, ToolDefinition, StaticViewCatalogEntry, SnapshotAssemblerInput, ViewFragment, } from "./core/types.js";
+export type { EffectContext, EffectFailure, EffectHandler, EffectMap, EffectResult, EffectSuccess, EffectTrace, } from "./core/effect/types.js";
+export type { ActionContext, ActionDefinition, } from "./core/action/defineAction.js";
+export type { ViewTypeToolActionDefinition, } from "./core/action/defineViewTypeTool.js";
+export { defineAction } from "./core/action/defineAction.js";
+export { defineViewTypeTool } from "./core/action/defineViewTypeTool.js";
+export { createActionRuntime } from "./core/action/createActionRuntime.js";
+export { createToolBridge } from "./tool/createToolBridge.js";
+export { useDataRef } from "./ref/useDataRef.js";
+export { useArrayRef } from "./ref/useArrayRef.js";
+export { View } from "./projection/tui/View.js";
+export { createSnapshotAssembler } from "./projection/tui/createSnapshotAssembler.js";
+export { renderTUI } from "./projection/tui/renderTUI.js";
+export { createReactAppRuntime } from "./projection/react/createReactAppRuntime.js";
+export type { ReactAppDefinition, ReactAppRuntime, RuntimeTrace, } from "./projection/react/createReactAppRuntime.js";
+export { AppRuntimeProvider } from "./projection/react/AppRuntimeProvider.js";
+export { useAppRuntime, useRuntimeActions, useRuntimeState, useRuntimeTrace } from "./projection/react/hooks.js";
+export { AppProvider } from "./projection/gui/AppProvider.js";
+export { useAppState, useActions } from "./projection/gui/hooks.js";
+export { createInboxApp } from "./demo/inbox/createInboxApp.js";

package/dist/index.js

@@ -1,20 +1,20 @@
-import { createSnapshotBundle } from "./core/snapshot/createSnapshotBundle";
-import { VERSION } from "./version";
+import { createSnapshotBundle } from "./core/snapshot/createSnapshotBundle.js";
+import { VERSION } from "./version.js";
 export { VERSION };
-export { createStore } from "./core/state/createStore";
+export { createStore } from "./core/state/createStore.js";
 export { createSnapshotBundle };
-export { defineAction } from "./core/action/defineAction";
-export { defineViewTypeTool } from "./core/action/defineViewTypeTool";
-export { createActionRuntime } from "./core/action/createActionRuntime";
-export { createToolBridge } from "./tool/createToolBridge";
-export { useDataRef } from "./ref/useDataRef";
-export { useArrayRef } from "./ref/useArrayRef";
-export { View } from "./projection/tui/View";
-export { createSnapshotAssembler } from "./projection/tui/createSnapshotAssembler";
-export { renderTUI } from "./projection/tui/renderTUI";
-export { createReactAppRuntime } from "./projection/react/createReactAppRuntime";
-export { AppRuntimeProvider } from "./projection/react/AppRuntimeProvider";
-export { useAppRuntime, useRuntimeActions, useRuntimeState, useRuntimeTrace } from "./projection/react/hooks";
-export { AppProvider } from "./projection/gui/AppProvider";
-export { useAppState, useActions } from "./projection/gui/hooks";
-export { createInboxApp } from "./demo/inbox/createInboxApp";
+export { defineAction } from "./core/action/defineAction.js";
+export { defineViewTypeTool } from "./core/action/defineViewTypeTool.js";
+export { createActionRuntime } from "./core/action/createActionRuntime.js";
+export { createToolBridge } from "./tool/createToolBridge.js";
+export { useDataRef } from "./ref/useDataRef.js";
+export { useArrayRef } from "./ref/useArrayRef.js";
+export { View } from "./projection/tui/View.js";
+export { createSnapshotAssembler } from "./projection/tui/createSnapshotAssembler.js";
+export { renderTUI } from "./projection/tui/renderTUI.js";
+export { createReactAppRuntime } from "./projection/react/createReactAppRuntime.js";
+export { AppRuntimeProvider } from "./projection/react/AppRuntimeProvider.js";
+export { useAppRuntime, useRuntimeActions, useRuntimeState, useRuntimeTrace } from "./projection/react/hooks.js";
+export { AppProvider } from "./projection/gui/AppProvider.js";
+export { useAppState, useActions } from "./projection/gui/hooks.js";
+export { createInboxApp } from "./demo/inbox/createInboxApp.js";

package/dist/projection/gui/AppProvider.d.ts

@@ -1,10 +1,11 @@
 import type { ComponentChildren } from "preact";
-import type { ActionResult, Store, ToolDefinition } from "../../core/types";
+import type { ActionResult, Store, ToolAvailability, ToolDefinition } from "../../core/types.js";
 type LegacyAppContextValue = {
     store: Store<unknown, unknown>;
     actionRuntime: {
         executeAction(name: string, input: Record<string, unknown>): Promise<ActionResult>;
-        listVisibleTools(): ToolDefinition[];
+        listTools(): readonly ToolDefinition[];
+        getToolAvailability(): Readonly<Record<string, ToolAvailability>>;
     };
 };
 export declare function AppProvider(props: {

package/dist/projection/gui/AppProvider.js

@@ -2,13 +2,29 @@ import { jsx as _jsx } from "preact/jsx-runtime";
 /** @jsxImportSource preact */
 import { createContext } from "preact";
 import { useContext, useMemo } from "preact/hooks";
-import { AppRuntimeProvider } from "../react/AppRuntimeProvider";
+import { AppRuntimeProvider } from "../react/AppRuntimeProvider.js";
 const AppContext = createContext(null);
 function createCompatibilityRuntime(value) {
     let nextTraceId = 1;
     return {
         store: value.store,
-        actionRuntime: value.actionRuntime,
+        actionRuntime: {
+            executeAction(name, input) {
+                return value.actionRuntime.executeAction(name, input);
+            },
+            listTools() {
+                return value.actionRuntime.listTools();
+            },
+            getToolAvailability() {
+                return value.actionRuntime.getToolAvailability();
+            },
+            getToolSurface() {
+                return {
+                    tools: value.actionRuntime.listTools(),
+                    toolAvailability: value.actionRuntime.getToolAvailability(),
+                };
+            },
+        },
         traceStore: {
             getState() {
                 return {
@@ -57,7 +73,7 @@ function createCompatibilityRuntime(value) {
         },
         toolBridge: {
             listTools() {
-                return value.actionRuntime.listVisibleTools();
+                return value.actionRuntime.listTools();
             },
             getSnapshotBundle() {
                 throw new Error("Snapshot rendering is not available through AppProvider");
@@ -67,11 +83,14 @@ function createCompatibilityRuntime(value) {
             },
         },
         actions: {
-            callAction(name, input) {
+            executeAction(name, input) {
                 return value.actionRuntime.executeAction(name, input);
             },
-            getVisibleTools() {
-                return value.actionRuntime.listVisibleTools();
+            listTools() {
+                return value.actionRuntime.listTools();
+            },
+            getToolAvailability() {
+                return value.actionRuntime.getToolAvailability();
             },
         },
     };

package/dist/projection/gui/hooks.d.ts

@@ -2,6 +2,7 @@ export declare function useAppState<State>(): {
     state: State;
 };
 export declare function useActions(): {
-    callAction(name: string, input: Record<string, unknown>): Promise<import("../../core/types").ActionResult>;
-    getVisibleTools(): import("../..").ToolDefinition[];
+    executeAction(name: string, input: Record<string, unknown>): Promise<import("../../core/types").ActionResult>;
+    listTools(): readonly import("../..").ToolDefinition[];
+    getToolAvailability(): Readonly<Record<string, import("../..").ToolAvailability>>;
 };

package/dist/projection/gui/hooks.js

@@ -1,4 +1,4 @@
-import { useRuntimeActions, useRuntimeState } from "../react/hooks";
+import { useRuntimeActions, useRuntimeState } from "../react/hooks.js";
 export function useAppState() {
     return {
         state: useRuntimeState((state) => state),

package/dist/projection/react/AppRuntimeProvider.d.ts

@@ -1,5 +1,5 @@
 import type { ComponentChildren } from "preact";
-import type { ReactAppRuntime, RuntimeTrace } from "./createReactAppRuntime";
+import type { ReactAppRuntime, RuntimeTrace } from "./createReactAppRuntime.js";
 export type AppRuntime<State = unknown, Event = unknown> = ReactAppRuntime<State, Event> & {
     trace: RuntimeTrace;
 };

package/dist/projection/react/createReactAppRuntime.d.ts

@@ -1,8 +1,8 @@
-import { createActionRuntime } from "../../core/action/createActionRuntime";
-import type { ActionDefinition } from "../../core/action/defineAction";
-import type { EffectMap } from "../../core/effect/types";
-import type { ActionResult, SnapshotBundle, SnapshotRegistry, StateReducer, Store, ToolDefinition, TraceRecord, TraceState, TraceStore } from "../../core/types";
-import { createToolBridge } from "../../tool/createToolBridge";
+import { createActionRuntime } from "../../core/action/createActionRuntime.js";
+import type { ActionDefinition } from "../../core/action/defineAction.js";
+import type { EffectMap } from "../../core/effect/types.js";
+import type { ActionResult, SnapshotBundle, SnapshotRegistry, StateReducer, Store, ToolAvailability, ToolDefinition, TraceRecord, TraceState, TraceStore } from "../../core/types.js";
+import { createToolBridge } from "../../tool/createToolBridge.js";
 export type ReactAppDefinition<State, Event> = {
     initialState: State;
     reduce: StateReducer<State, Event>;
@@ -11,7 +11,8 @@ export type ReactAppDefinition<State, Event> = {
     getRelevantViewTypes?: (state: State) => readonly string[];
     renderCurrentSnapshot?: (context: {
         state: State;
-        visibleTools: readonly ToolDefinition[];
+        tools: readonly ToolDefinition[];
+        toolAvailability: Readonly<Record<string, ToolAvailability>>;
     }) => SnapshotBundle;
 };
 export type ReactAppRuntime<State, Event> = {
@@ -22,8 +23,9 @@ export type ReactAppRuntime<State, Event> = {
     snapshotRegistry: SnapshotRegistry;
     toolBridge: ReturnType<typeof createToolBridge>;
     actions: {
-        callAction(name: string, input: Record<string, unknown>): Promise<ActionResult>;
-        getVisibleTools(): ToolDefinition[];
+        executeAction(name: string, input: Record<string, unknown>): Promise<ActionResult>;
+        listTools(): readonly ToolDefinition[];
+        getToolAvailability(): Readonly<Record<string, ToolAvailability>>;
     };
 };
 export type RuntimeTrace = {

package/dist/projection/react/createReactAppRuntime.js

@@ -1,10 +1,10 @@
-import { createActionRuntime } from "../../core/action/createActionRuntime";
-import { createSnapshotRegistry } from "../../core/snapshot/createSnapshotRegistry";
-import { createStore } from "../../core/state/createStore";
-import { createTraceStore } from "../../core/trace/createTraceStore";
-import { createSnapshotAssembler } from "../tui/createSnapshotAssembler";
-import { renderViewFragment } from "../tui/renderViewFragment";
-import { createToolBridge } from "../../tool/createToolBridge";
+import { createActionRuntime } from "../../core/action/createActionRuntime.js";
+import { createSnapshotRegistry } from "../../core/snapshot/createSnapshotRegistry.js";
+import { createStore } from "../../core/state/createStore.js";
+import { createTraceStore } from "../../core/trace/createTraceStore.js";
+import { createSnapshotAssembler } from "../tui/createSnapshotAssembler.js";
+import { renderViewFragment } from "../tui/renderViewFragment.js";
+import { createToolBridge } from "../../tool/createToolBridge.js";
 export function createReactAppRuntime(app) {
     const store = createStore({
         initialState: app.initialState,
@@ -23,24 +23,30 @@ export function createReactAppRuntime(app) {
     });
     const snapshotRegistry = createSnapshotRegistry({ maxEntries: 2 });
     const renderCurrentSnapshot = app.renderCurrentSnapshot ??
-        (() => createSnapshotAssembler({
-            rootView: renderViewFragment({
-                id: "root",
-                type: "Root",
-                name: "Navigation",
-                children: "No custom snapshot renderer configured.",
-            }),
-            mountedViews: [],
-            refIndex: {},
-            visibleTools: actionRuntime.listVisibleTools(),
-        }));
+        (() => {
+            const toolSurface = actionRuntime.getToolSurface();
+            return createSnapshotAssembler({
+                rootView: renderViewFragment({
+                    id: "root",
+                    type: "Root",
+                    name: "Navigation",
+                    children: "No custom snapshot renderer configured.",
+                }),
+                mountedViews: [],
+                refIndex: {},
+                tools: toolSurface.tools,
+                toolAvailability: toolSurface.toolAvailability,
+            });
+        });
     const toolBridge = createToolBridge({
         actionRuntime,
         snapshotRegistry,
         renderCurrentSnapshot() {
+            const toolSurface = actionRuntime.getToolSurface();
             return renderCurrentSnapshot({
                 state: store.getState(),
-                visibleTools: actionRuntime.listVisibleTools(),
+                tools: toolSurface.tools,
+                toolAvailability: toolSurface.toolAvailability,
             });
         },
     });
@@ -65,15 +71,18 @@ export function createReactAppRuntime(app) {
         snapshotRegistry,
         toolBridge,
         actions: {
-            async callAction(name, input) {
+            async executeAction(name, input) {
                 const result = await actionRuntime.executeAction(name, input);
                 if (result.mutated) {
                     snapshotRegistry.markAllStale?.();
                 }
                 return result;
             },
-            getVisibleTools() {
-                return actionRuntime.listVisibleTools();
+            listTools() {
+                return actionRuntime.listTools();
+            },
+            getToolAvailability() {
+                return actionRuntime.getToolAvailability();
             },
         },
     };

package/dist/projection/react/hooks.d.ts

@@ -1,8 +1,9 @@
-import type { TraceState } from "../../core/types";
+import type { TraceState } from "../../core/types.js";
 export declare function useAppRuntime(): import("./AppRuntimeProvider").AppRuntime<unknown, unknown>;
 export declare function useRuntimeState<State, Selected>(selector: (state: State) => Selected): Selected;
 export declare function useRuntimeActions(): {
-    callAction(name: string, input: Record<string, unknown>): Promise<import("../../core/types").ActionResult>;
-    getVisibleTools(): import("../..").ToolDefinition[];
+    executeAction(name: string, input: Record<string, unknown>): Promise<import("../../core/types").ActionResult>;
+    listTools(): readonly import("../..").ToolDefinition[];
+    getToolAvailability(): Readonly<Record<string, import("../..").ToolAvailability>>;
 };
 export declare function useRuntimeTrace<Selected>(selector: (trace: TraceState) => Selected): Selected;

package/dist/projection/react/hooks.js

@@ -1,5 +1,5 @@
 import { useSyncExternalStore } from "preact/compat";
-import { useAppRuntimeContext } from "./AppRuntimeProvider";
+import { useAppRuntimeContext } from "./AppRuntimeProvider.js";
 export function useAppRuntime() {
     return useAppRuntimeContext();
 }

package/dist/projection/tui/createSnapshotAssembler.d.ts

@@ -1,2 +1,2 @@
-import type { SnapshotAssemblerInput, SnapshotBundle } from "../../core/types";
+import type { SnapshotAssemblerInput, SnapshotBundle } from "../../core/types.js";
 export declare function createSnapshotAssembler<State>(input: SnapshotAssemblerInput<State>): SnapshotBundle;

package/dist/projection/tui/createSnapshotAssembler.js

@@ -1,5 +1,5 @@
-import { createSnapshotBundle } from "../../core/snapshot/createSnapshotBundle";
-import { renderSnapshotDocument } from "./renderSnapshotDocument";
+import { createSnapshotBundle } from "../../core/snapshot/createSnapshotBundle.js";
+import { renderSnapshotDocument } from "./renderSnapshotDocument.js";
 export function createSnapshotAssembler(input) {
     const views = [input.rootView, ...input.mountedViews];
     const markup = renderSnapshotDocument(views);
@@ -7,7 +7,8 @@ export function createSnapshotAssembler(input) {
         markup,
         views,
         refIndex: input.refIndex,
-        visibleTools: input.visibleTools,
+        tools: input.tools,
+        toolAvailability: input.toolAvailability,
         ...(input.tui === undefined ? {} : { tui: input.tui }),
     };
     return createSnapshotBundle(bundleInput);

package/dist/projection/tui/renderSnapshotDocument.d.ts

@@ -1,2 +1,2 @@
-import type { ViewFragment } from "../../core/types";
+import type { ViewFragment } from "../../core/types.js";
 export declare function renderSnapshotDocument(views: readonly ViewFragment[]): string;

package/dist/projection/tui/renderTUI.d.ts

@@ -1,6 +1,7 @@
 /** @jsxImportSource preact */
 import type { ComponentChild } from "preact";
-import type { ToolDefinition } from "../../core/types";
+import type { ToolAvailability, ToolDefinition } from "../../core/types.js";
 export declare function renderTUI(node: ComponentChild, options: {
-    visibleTools: ToolDefinition[];
+    tools: ToolDefinition[];
+    toolAvailability?: Readonly<Record<string, ToolAvailability>>;
 }): import("../..").SnapshotBundle;