gesso-framework 0.4.2 → 0.5.0

package/dist/webmcp-CJVFvAHe.js

@@ -0,0 +1,77 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { r as remoteSurface, t as AGENT_PORT } from "./remote-xxij8zXe.js";
+//#region src/agent/webmcp.ts
+var webmcp_exports = /* @__PURE__ */ __exportAll({
+	confirmInWindow: () => confirmInWindow,
+	connectWebMcp: () => connectWebMcp,
+	pageModelContext: () => pageModelContext,
+	registerWebMcpTools: () => registerWebMcpTools
+});
+/** The page's model context, if the browser has one. */
+function pageModelContext() {
+	return globalThis.document?.modelContext ?? globalThis.navigator?.modelContext;
+}
+/**
+* Registers every tool a surface offers, and returns what removes them.
+*
+* A tool the browser refuses, a name already taken by something else on
+* the page, is reported on the console and skipped rather than taking
+* the rest down with it. Resolves to a no-op when there is no model
+* context to register with.
+*/
+async function registerWebMcpTools(surface, modelContext = pageModelContext()) {
+	if (modelContext === void 0) return () => {};
+	const registration = new AbortController();
+	for (const tool of await surface.tools()) try {
+		await modelContext.registerTool({
+			name: tool.name,
+			...tool.title === void 0 ? {} : { title: tool.title },
+			description: tool.description,
+			inputSchema: tool.inputSchema,
+			annotations: {
+				readOnlyHint: tool.annotations.readOnlyHint,
+				consequentialHint: tool.annotations.destructiveHint === true
+			},
+			execute: async (input) => answerOf(await surface.call(tool.name, input ?? {}))
+		}, { signal: registration.signal });
+	} catch (error) {
+		console.warn(`[gesso] WebMCP refused the tool ${tool.name}:`, error);
+	}
+	return () => registration.abort();
+}
+/**
+* Registers an application's channels once it is mounted.
+*
+* Reaches them the way the development bridge does, through an agent
+* port to the render worker, so every channel the page can reach is
+* offered, wherever it is served.
+*/
+async function connectWebMcp(app, options = {}) {
+	const modelContext = options.modelContext ?? pageModelContext();
+	if (modelContext === void 0) return () => {};
+	const port = app.openRenderPort(AGENT_PORT);
+	if (port === void 0) throw new Error("connectWebMcp needs a mounted app: call it after app.mount().");
+	const unregister = await registerWebMcpTools(remoteSurface(port, { confirm: options.confirm ?? confirmInWindow }), modelContext);
+	return () => {
+		unregister();
+		port.close();
+	};
+}
+/** The browser's own dialog, worded for a person who did not ask for anything. */
+function confirmInWindow(request) {
+	const lines = [`An AI agent wants to ${request.command} in ${request.channel}.`];
+	if (request.description !== void 0) lines.push(request.description);
+	if (Object.keys(request.arguments).length > 0) lines.push(JSON.stringify(request.arguments, null, 2));
+	if (request.destructive) lines.push("This cannot be undone.");
+	return window.confirm(lines.join("\n\n"));
+}
+/** What a call hands back to WebMCP: the view it left, or a rejection that says why. */
+function answerOf(result) {
+	const text = result.content.map((part) => part.text).join("\n");
+	if (result.isError) throw new Error(text);
+	return result.structuredContent ?? text;
+}
+//#endregion
+export { webmcp_exports as a, registerWebMcpTools as i, connectWebMcp as n, pageModelContext as r, confirmInWindow as t };
+
+//# sourceMappingURL=webmcp-CJVFvAHe.js.map

package/dist/webmcp-CJVFvAHe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp-CJVFvAHe.js","names":[],"sources":["../src/agent/webmcp.ts"],"sourcesContent":["import type { AgentConfirmation, AgentSurfaceLike, AgentToolResult } from './AgentSurface';\nimport { AGENT_PORT, remoteSurface, type AgentConfirm } from './remote';\n\n/**\n * An application's channels, offered to an agent in the browser.\n *\n * WebMCP (https://webmachinelearning.github.io/webmcp/) is a page\n * registering tools with the browser, `document.modelContext.registerTool`,\n * for an agent the browser runs or hosts to call. It is MCP without\n * the server: no port, no process, and the tools live exactly as long\n * as the page does. The channel surface is already a list of tools\n * with JSON Schema inputs and an answer per call, so this registers\n * each one and routes its calls back through the render worker.\n *\n * What the spec gives a tool that a channel does not, and the reverse:\n *\n *   - `readOnlyHint` is a channel's view tool; `consequentialHint`, the\n *     spec's \"significant, real-world, or non-reversible\", is a command\n *     marked `@destructive`. `untrustedContentHint` is never set: a\n *     channel's view is the application's own data.\n *   - There is no output schema. The result of a call is serialized to\n *     JSON for the agent, so a call answers with the view it left.\n *   - There is no way to ask the person. A command marked `@confirm`\n *     asks through `confirm`, `window.confirm` unless told otherwise.\n *   - A failed call rejects, which the spec turns into a failed\n *     `executeTool` the agent reads, with the sentence that says why.\n *\n * The API is behind an origin trial in Chrome 149 to 156, and was\n * `navigator.modelContext` until Chrome 150; the old name is read when\n * the new one is missing. Where neither exists, nothing is registered\n * and nothing fails: a page offering tools to a browser that takes\n * none is an ordinary page.\n */\n\n/** The part of `ModelContext` this uses. */\nexport interface ModelContextLike {\n  registerTool(\n    tool: {\n      name: string;\n      title?: string;\n      description: string;\n      inputSchema?: object;\n      annotations?: { readOnlyHint?: boolean; consequentialHint?: boolean };\n      execute: (input: Record<string, unknown>, options?: { signal?: AbortSignal }) => Promise<unknown>;\n    },\n    options?: { signal?: AbortSignal }\n  ): Promise<void>;\n}\n\nexport interface WebMcpOptions {\n  /**\n   * Asks the person whether a `@confirm` command may be sent. Defaults to\n   * the browser's own `window.confirm`, which an application with its\n   * own dialogs will want to replace.\n   */\n  confirm?: AgentConfirm;\n  /** Where to register. Defaults to the page's own `modelContext`. */\n  modelContext?: ModelContextLike;\n}\n\n/** The page's model context, if the browser has one. */\nexport function pageModelContext(): ModelContextLike | undefined {\n  const fromDocument = (globalThis.document as { modelContext?: ModelContextLike } | undefined)?.modelContext;\n  return fromDocument ?? (globalThis.navigator as { modelContext?: ModelContextLike } | undefined)?.modelContext;\n}\n\n/**\n * Registers every tool a surface offers, and returns what removes them.\n *\n * A tool the browser refuses, a name already taken by something else on\n * the page, is reported on the console and skipped rather than taking\n * the rest down with it. Resolves to a no-op when there is no model\n * context to register with.\n */\nexport async function registerWebMcpTools(\n  surface: AgentSurfaceLike,\n  modelContext: ModelContextLike | undefined = pageModelContext()\n): Promise<() => void> {\n  if (modelContext === undefined) {\n    return () => {};\n  }\n  const registration = new AbortController();\n  for (const tool of await surface.tools()) {\n    try {\n      await modelContext.registerTool(\n        {\n          name: tool.name,\n          ...(tool.title === undefined ? {} : { title: tool.title }),\n          description: tool.description,\n          inputSchema: tool.inputSchema,\n          annotations: {\n            readOnlyHint: tool.annotations.readOnlyHint,\n            consequentialHint: tool.annotations.destructiveHint === true\n          },\n          execute: async input => answerOf(await surface.call(tool.name, input ?? {}))\n        },\n        { signal: registration.signal }\n      );\n    } catch (error) {\n      console.warn(`[gesso] WebMCP refused the tool ${tool.name}:`, error);\n    }\n  }\n  return () => registration.abort();\n}\n\n/**\n * Registers an application's channels once it is mounted.\n *\n * Reaches them the way the development bridge does, through an agent\n * port to the render worker, so every channel the page can reach is\n * offered, wherever it is served.\n */\nexport async function connectWebMcp(\n  app: { openRenderPort(key: string): MessagePort | undefined },\n  options: WebMcpOptions = {}\n): Promise<() => void> {\n  const modelContext = options.modelContext ?? pageModelContext();\n  if (modelContext === undefined) {\n    return () => {};\n  }\n  const port = app.openRenderPort(AGENT_PORT);\n  if (port === undefined) {\n    throw new Error('connectWebMcp needs a mounted app: call it after app.mount().');\n  }\n  const surface = remoteSurface(port, { confirm: options.confirm ?? confirmInWindow });\n  const unregister = await registerWebMcpTools(surface, modelContext);\n  return () => {\n    unregister();\n    port.close();\n  };\n}\n\n/** The browser's own dialog, worded for a person who did not ask for anything. */\nexport function confirmInWindow(request: AgentConfirmation): boolean {\n  const lines = [`An AI agent wants to ${request.command} in ${request.channel}.`];\n  if (request.description !== undefined) {\n    lines.push(request.description);\n  }\n  if (Object.keys(request.arguments).length > 0) {\n    lines.push(JSON.stringify(request.arguments, null, 2));\n  }\n  if (request.destructive) {\n    lines.push('This cannot be undone.');\n  }\n  return window.confirm(lines.join('\\n\\n'));\n}\n\n/** What a call hands back to WebMCP: the view it left, or a rejection that says why. */\nfunction answerOf(result: AgentToolResult): unknown {\n  const text = result.content.map(part => part.text).join('\\n');\n  if (result.isError) {\n    throw new Error(text);\n  }\n  return result.structuredContent ?? text;\n}\n"],"mappings":";;;;;;;;;;AA6DA,SAAgB,mBAAiD;CAE/D,OADsB,WAAW,UAA8D,gBACvE,WAAW,WAA+D;AACpG;;;;;;;;;AAUA,eAAsB,oBACpB,SACA,eAA6C,iBAAiB,GACzC;CACrB,IAAI,iBAAiB,KAAA,GACnB,aAAa,CAAC;CAEhB,MAAM,eAAe,IAAI,gBAAgB;CACzC,KAAK,MAAM,QAAQ,MAAM,QAAQ,MAAM,GACrC,IAAI;EACF,MAAM,aAAa,aACjB;GACE,MAAM,KAAK;GACX,GAAI,KAAK,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM;GACxD,aAAa,KAAK;GAClB,aAAa,KAAK;GAClB,aAAa;IACX,cAAc,KAAK,YAAY;IAC/B,mBAAmB,KAAK,YAAY,oBAAoB;GAC1D;GACA,SAAS,OAAM,UAAS,SAAS,MAAM,QAAQ,KAAK,KAAK,MAAM,SAAS,CAAC,CAAC,CAAC;EAC7E,GACA,EAAE,QAAQ,aAAa,OAAO,CAChC;CACF,SAAS,OAAO;EACd,QAAQ,KAAK,mCAAmC,KAAK,KAAK,IAAI,KAAK;CACrE;CAEF,aAAa,aAAa,MAAM;AAClC;;;;;;;;AASA,eAAsB,cACpB,KACA,UAAyB,CAAC,GACL;CACrB,MAAM,eAAe,QAAQ,gBAAgB,iBAAiB;CAC9D,IAAI,iBAAiB,KAAA,GACnB,aAAa,CAAC;CAEhB,MAAM,OAAO,IAAI,eAAe,UAAU;CAC1C,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MAAM,+DAA+D;CAGjF,MAAM,aAAa,MAAM,oBADT,cAAc,MAAM,EAAE,SAAS,QAAQ,WAAW,gBAAgB,CAC/B,GAAG,YAAY;CAClE,aAAa;EACX,WAAW;EACX,KAAK,MAAM;CACb;AACF;;AAGA,SAAgB,gBAAgB,SAAqC;CACnE,MAAM,QAAQ,CAAC,wBAAwB,QAAQ,QAAQ,MAAM,QAAQ,QAAQ,EAAE;CAC/E,IAAI,QAAQ,gBAAgB,KAAA,GAC1B,MAAM,KAAK,QAAQ,WAAW;CAEhC,IAAI,OAAO,KAAK,QAAQ,SAAS,CAAC,CAAC,SAAS,GAC1C,MAAM,KAAK,KAAK,UAAU,QAAQ,WAAW,MAAM,CAAC,CAAC;CAEvD,IAAI,QAAQ,aACV,MAAM,KAAK,wBAAwB;CAErC,OAAO,OAAO,QAAQ,MAAM,KAAK,MAAM,CAAC;AAC1C;;AAGA,SAAS,SAAS,QAAkC;CAClD,MAAM,OAAO,OAAO,QAAQ,KAAI,SAAQ,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI;CAC5D,IAAI,OAAO,SACT,MAAM,IAAI,MAAM,IAAI;CAEtB,OAAO,OAAO,qBAAqB;AACrC"}

package/dist/worker/index.d.ts

@@ -1,5 +1,7 @@
-import { C as CommandMap, D as defineChannel, E as channel, H as internalState, I as ReadableCell, O as viewKeys, S as Command, T as ViewOf, V as InternalState, b as ChannelSpec, d as ChannelHostMessage, f as ChannelPort, m as isChannelHostMessage, p as isChannelClientMessage, u as ChannelClientMessage, w as CommandsOf, x as ChannelToken } from "../FunctionComponent-CgwLKE5d.js";
-import { $ as StorageOutcome, Ai as Equality, Ar as PortHost, B as PersistedState, Cr as serveChannels, Di as ReadSource, Dr as APPLICATION_WORKER, Ei as ComputedOptions, Fr as portHandle, G as IndexedDbStorageOptions, Hr as ProvidedChannel, Ir as servePorts, J as OpfsStorage, K as OpfsDirectory, Mt as ConsoleEntry, Nr as isPortErrorMessage, Oi as computed, Or as MessageEndpoint, Pr as isPortHandshake, Q as StorageAdapter, Rr as findUnplainPath, Sr as serve, Ti as ComputedCell, Ur as provide, V as persisted, Vr as ChannelSource, W as IndexedDbStorage, X as OpfsWritable, Y as OpfsStorageOptions, Z as MemoryStorage, _i as resource, br as pickKeys, ci as debounced, ct as undoable, di as Mutation, dt as UndoTransaction, et as StorageRead, fi as mutate, gi as ResourceStatus, hi as ResourceState, it as storageReadValue, ji as derive, ki as DeriveOptions, li as throttled, lt as UndoStack, mi as ResourceOptions, nt as storageErrorMessage, pi as Resource, q as OpfsFileHandle, rt as storageReadFailure, st as UndoableOptions, tt as classifyStorageError, ui as MutateOptions, ut as UndoStackOptions, vi as SelectOptions, vr as structurallyEqual, xr as ServedChannel, yi as select, yr as pick, z as PersistedOptions, zr as requirePlainData } from "../index-C9FAI_Kt.js";
+import { _ as channel, a as isChannelHostMessage, d as ChannelSpec, f as ChannelToken, g as ViewOf, h as CommandsOf, i as isChannelClientMessage, m as CommandMap, n as ChannelHostMessage, p as Command, r as ChannelPort, t as ChannelClientMessage, v as defineChannel, y as viewKeys } from "../ChannelProtocol-ByNoHujM.js";
+import { A as portHandle, C as MessageEndpoint, O as isPortErrorMessage, S as APPLICATION_WORKER, T as PortHost, _ as serve, b as ProvidedChannel, g as ServedChannel, j as servePorts, k as isPortHandshake, v as serveChannels, x as provide, y as ChannelSource } from "../ui-U39HjNFA.js";
+import { C as internalState, S as InternalState, _ as ReadableCell } from "../FunctionComponent-fYMdePtH.js";
+import { $ as StorageAdapter, $r as ResourceOptions, B as PersistedOptions, Dr as requirePlainData, Er as findUnplainPath, G as IndexedDbStorage, H as persisted, J as OpfsFileHandle, Jr as throttled, K as IndexedDbStorageOptions, Pt as ConsoleEntry, Q as MemoryStorage, Qr as Resource, Sr as pickKeys, V as PersistedState, X as OpfsStorageOptions, Xr as Mutation, Y as OpfsStorage, Yr as MutateOptions, Z as OpfsWritable, Zr as mutate, at as storageReadValue, br as structurallyEqual, ct as UndoableOptions, di as ComputedOptions, dt as UndoStackOptions, ei as ResourceState, et as StorageOutcome, fi as ReadSource, ft as UndoTransaction, gi as derive, hi as Equality, ii as select, it as storageReadFailure, lt as undoable, mi as DeriveOptions, ni as resource, nt as classifyStorageError, pi as computed, q as OpfsDirectory, qr as debounced, ri as SelectOptions, rt as storageErrorMessage, ti as ResourceStatus, tt as StorageRead, ui as ComputedCell, ut as UndoStack, xr as pick } from "../index-BDM_gzzZ.js";
 //#region src/worker/captureConsole.d.ts
 /**
  * Forwarding a worker's `console.*`.

package/dist/worker/index.js

@@ -1,2 +1,2 @@
-import { $ as structurallyEqual, B as channel, C as captureConsole, G as mutate, H as viewKeys, J as select, K as Resource, M as provide, N as findUnplainPath, P as requirePlainData, R as isChannelClientMessage, U as debounced, V as defineChannel, W as throttled, X as computed, Y as ComputedCell, Z as derive, a as undoable, b as portHandle, c as classifyStorageError, d as storageReadValue, et as InternalState, f as pick, g as APPLICATION_WORKER, h as serveChannels, i as OpfsStorage, j as ProvidedChannel, l as storageErrorMessage, m as serve, n as persisted, o as UndoStack, p as pickKeys, q as resource, r as IndexedDbStorage, s as MemoryStorage, t as PersistedState, tt as internalState, u as storageReadFailure, v as isPortErrorMessage, x as servePorts, y as isPortHandshake, z as isChannelHostMessage } from "../persisted-CsTPnjkc.js";
+import { $ as structurallyEqual, B as channel, C as captureConsole, G as mutate, H as viewKeys, J as select, K as Resource, M as provide, N as findUnplainPath, P as requirePlainData, R as isChannelClientMessage, U as debounced, V as defineChannel, W as throttled, X as computed, Y as ComputedCell, Z as derive, a as undoable, b as portHandle, c as classifyStorageError, d as storageReadValue, et as InternalState, f as pick, g as APPLICATION_WORKER, h as serveChannels, i as OpfsStorage, j as ProvidedChannel, l as storageErrorMessage, m as serve, n as persisted, o as UndoStack, p as pickKeys, q as resource, r as IndexedDbStorage, s as MemoryStorage, t as PersistedState, tt as internalState, u as storageReadFailure, v as isPortErrorMessage, x as servePorts, y as isPortHandshake, z as isChannelHostMessage } from "../persisted-pix1fS1D.js";
 export { APPLICATION_WORKER, ComputedCell, IndexedDbStorage, InternalState, MemoryStorage, OpfsStorage, PersistedState, ProvidedChannel, Resource, UndoStack, captureConsole, channel, classifyStorageError, computed, debounced, defineChannel, derive, findUnplainPath, internalState, isChannelClientMessage, isChannelHostMessage, isPortErrorMessage, isPortHandshake, mutate, persisted, pick, pickKeys, portHandle, provide, requirePlainData, resource, select, serve, serveChannels, servePorts, storageErrorMessage, storageReadFailure, storageReadValue, structurallyEqual, throttled, undoable, viewKeys };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gesso-framework",
-  "version": "0.4.2",
-  "description": "Components, stores, the frame runtime and the worker barrier over gesso-core.",
+  "version": "0.5.0",
+  "description": "SwiftUI and Compose, for the web: declarative components, stores and a frame runtime that keeps the whole interface off the main thread.",
   "license": "MIT",
   "author": "Kevin Baker",
   "homepage": "https://gesso-docs.vercel.app",
@@ -25,7 +25,11 @@
     "web-worker",
     "offscreencanvas",
     "jsx",
-    "state-management"
+    "state-management",
+    "declarative-ui",
+    "swiftui",
+    "jetpack-compose",
+    "native-apps"
   ],
   "type": "module",
   "sideEffects": false,
@@ -45,6 +49,10 @@
     "./jsx-dev-runtime": {
       "types": "./dist/jsx/jsx-dev-runtime.d.ts",
       "default": "./dist/jsx/jsx-dev-runtime.js"
+    },
+    "./agent": {
+      "types": "./dist/agent/index.d.ts",
+      "default": "./dist/agent/index.js"
     }
   },
   "publishConfig": {
@@ -57,7 +65,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "gesso-core": "^0.4.2"
+    "gesso-core": "^0.5.0"
   },
   "peerDependencies": {
     "rxjs": "^7.8.2"