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

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

@@ -0,0 +1,10 @@
+import type { ComponentChildren } from "preact";
+import type { ViewFragment } from "../../core/types";
+export type RenderViewFragmentInput = {
+    readonly id: string;
+    readonly type: string;
+    readonly name: string;
+    readonly children?: ComponentChildren;
+    readonly markup?: string;
+};
+export declare function renderViewFragment(input: RenderViewFragmentInput): ViewFragment;

package/dist/projection/tui/renderViewFragment.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+/** @jsxImportSource preact */
+import renderToString from "preact-render-to-string";
+import { View } from "./View";
+export function renderViewFragment(input) {
+    const content = input.markup !== undefined
+        ? { dangerouslySetInnerHTML: { __html: input.markup } }
+        : { children: input.children };
+    return {
+        id: input.id,
+        type: input.type,
+        name: input.name,
+        markup: renderToString(_jsx(View, { id: input.id, type: input.type, name: input.name, ...content })),
+    };
+}

package/dist/tool/createToolBridge.d.ts

@@ -1,18 +1,13 @@
-import type { SnapshotBundle, ActionResult } from "../core/types";
+import type { SnapshotBundle, ActionResult, SnapshotRegistry, ToolDefinition } from "../core/types";
 export declare function createToolBridge(config: {
     actionRuntime: {
-        listVisibleTools(): Array<{
-            name: string;
-            description: string;
-        }>;
+        listVisibleTools(): ToolDefinition[];
         executeAction(name: string, input: Record<string, unknown>): Promise<ActionResult>;
     };
     renderCurrentSnapshot(): SnapshotBundle;
+    snapshotRegistry?: SnapshotRegistry;
 }): {
-    listTools(): {
-        name: string;
-        description: string;
-    }[];
+    listTools(): ToolDefinition[];
     getSnapshotBundle(): SnapshotBundle;
     executeTool(name: string, input: Record<string, unknown>, snapshotId: string): Promise<ActionResult>;
 };

package/dist/tool/createToolBridge.js

@@ -1,15 +1,36 @@
-function resolveRefArgs(input, refIndex) {
+import { createSnapshotRegistry } from "../core/snapshot/createSnapshotRegistry";
+const DATA_REF_MARKER_PATTERN = /^\((?:[\s\S]*)\)\[[^:\]]+:(.+)\]$/;
+const REF_ID_PATTERN = /^[A-Za-z0-9_.-]+(?:\[[^\]]+\])*$/;
+function getExplicitRefId(value) {
+    const markerMatch = value.match(DATA_REF_MARKER_PATTERN);
+    if (markerMatch) {
+        return markerMatch[1];
+    }
+    if (REF_ID_PATTERN.test(value)) {
+        return value;
+    }
+    return undefined;
+}
+function resolveRefArgs(input, refIndex, supportsRefs) {
     const resolved = {};
     for (const [key, value] of Object.entries(input)) {
+        if (!supportsRefs || typeof value !== "string") {
+            resolved[key] = value;
+            continue;
+        }
         if (typeof value === "string" && value in refIndex) {
             resolved[key] = refIndex[value].value;
             continue;
         }
-        if (typeof value === "string" &&
-            (value.includes("[") || value.includes("]"))) {
+        const explicitRefId = getExplicitRefId(value);
+        if (explicitRefId) {
+            if (explicitRefId in refIndex) {
+                resolved[key] = refIndex[explicitRefId].value;
+                continue;
+            }
             return {
                 success: false,
-                refId: value,
+                refId: explicitRefId,
             };
         }
         resolved[key] = value;
@@ -20,19 +41,21 @@ function resolveRefArgs(input, refIndex) {
     };
 }
 export function createToolBridge(config) {
-    const snapshots = new Map();
+    const snapshots = config.snapshotRegistry ??
+        createSnapshotRegistry({
+            maxEntries: 2,
+        });
     return {
         listTools() {
             return config.actionRuntime.listVisibleTools();
         },
         getSnapshotBundle() {
             const snapshot = config.renderCurrentSnapshot();
-            snapshots.set(snapshot.snapshotId, snapshot);
-            return snapshot;
+            return snapshots.create(snapshot);
         },
         async executeTool(name, input, snapshotId) {
-            const snapshot = snapshots.get(snapshotId);
-            if (!snapshot) {
+            const snapshotEntry = snapshots.lookup(snapshotId);
+            if (!snapshotEntry) {
                 return {
                     success: false,
                     error: {
@@ -41,7 +64,19 @@ export function createToolBridge(config) {
                     },
                 };
             }
-            const resolved = resolveRefArgs(input, snapshot.refIndex);
+            if (snapshotEntry.status === "stale") {
+                return {
+                    success: false,
+                    error: {
+                        code: "SNAPSHOT_STALE",
+                        message: `Snapshot ${snapshotId} is stale`,
+                    },
+                };
+            }
+            const toolDefinition = snapshotEntry.snapshot.visibleTools.find((tool) => tool.name === name) ??
+                config.actionRuntime.listVisibleTools().find((tool) => tool.name === name);
+            const supportsRefs = toolDefinition?.meta?.supportsRefs === true;
+            const resolved = resolveRefArgs(input, snapshotEntry.snapshot.refIndex, supportsRefs);
             if (!resolved.success) {
                 return {
                     success: false,
@@ -51,7 +86,16 @@ export function createToolBridge(config) {
                     },
                 };
             }
-            return config.actionRuntime.executeAction(name, resolved.data);
+            const result = await config.actionRuntime.executeAction(name, resolved.data);
+            if (result.mutated) {
+                if (snapshots.markAllStale) {
+                    snapshots.markAllStale();
+                }
+                else {
+                    snapshots.markStale(snapshotId);
+                }
+            }
+            return result;
         },
     };
 }

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.1.0-alpha.1";

package/dist/version.js

@@ -0,0 +1 @@
+export const VERSION = "0.1.0-alpha.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aotui/mobile-ai-native",
-  "version": "0.1.0-alpha.0",
+  "version": "0.1.0-alpha.1",
   "description": "Alpha host-agnostic core for building Agent Native mobile apps with shared GUI/TUI state and snapshot-scoped tool execution.",
   "license": "Apache-2.0",
   "type": "module",
@@ -12,13 +12,6 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "build": "pnpm run clean && tsc -p tsconfig.json",
-    "test": "vitest",
-    "test:run": "vitest --run",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "preact": "^10.28.1",
     "preact-render-to-string": "^6.6.6",
@@ -45,5 +38,11 @@
   ],
   "publishConfig": {
     "access": "public"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "test": "vitest",
+    "test:run": "vitest --run"
   }
-}
+}