@devframes/hub 0.9.18 → 0.9.20

package/dist/{assemble-B-ISfDe5.mjs → assemble-C_sd1y1C.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveClientModuleSpecifier } from "./remote-url-UClKLQ5_.mjs";
-import { v as prepareDevframe, y as diagnostics } from "./context-C7AFekjP.mjs";
+import { v as prepareDevframe, y as diagnostics } from "./context-BqvN40CU.mjs";
 import { joinURL, withTrailingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE, DEVFRAME_WS_ROUTE } from "devframe/constants";
 import { existsSync } from "node:fs";

package/dist/client/index.mjs

@@ -36,6 +36,15 @@ function resolveResourceUrl(value, connection) {
 }
 function resolveIconUrl(value, connection) {
 	const url = value.trim();
+	if (url.startsWith("mask:")) {
+		const maskUrl = url.slice(5).trim();
+		if (!maskUrl) return "mask:";
+		try {
+			return `mask:${new URL(maskUrl, connection.metaBaseUrl).href}`;
+		} catch {
+			return url;
+		}
+	}
 	if (!url || URL_SCHEME_RE.test(url) || url.startsWith("//")) return url;
 	if (!url.includes("/") && !url.includes(".")) return url;
 	try {

package/dist/{context-C7AFekjP.mjs → context-BqvN40CU.mjs}

@@ -5,7 +5,7 @@ import { joinURL, withTrailingSlash } from "ufo";
 import { createEventEmitter } from "devframe/utils/events";
 import { existsSync } from "node:fs";
 import process from "node:process";
-import { coerceAgentPositionalArgs, resolveClientAssets } from "devframe/internal";
+import { resolveClientAssets, toolInputToCommandArgs } from "devframe/internal";
 import { basename, dirname, isAbsolute, join, resolve } from "pathe";
 import { defineDiagnostics } from "devframe/utils/nostics";
 import { getInternalContext, resolveBasePath } from "devframe/node/hub-internals";
@@ -371,7 +371,7 @@ var DevframeCommandsHost = class {
 				* A command handler's positional parameters come solely from its
 				* declared `agent.args` schemas; undeclared payload is dropped.
 				*/
-				handler: async (args) => this.execute(command.id, ...coerceAgentPositionalArgs(args, agent.args, "drop"))
+				handler: async (args) => this.execute(command.id, ...toolInputToCommandArgs(args, agent.args?.length))
 			});
 			for (const child of command.children ?? []) walk(child);
 		};

package/dist/node/build.mjs

@@ -1,6 +1,6 @@
 import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY } from "../constants-Da23JxCZ.mjs";
-import { t as createHubContext, y as diagnostics } from "../context-C7AFekjP.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-B-ISfDe5.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-BqvN40CU.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-C_sd1y1C.mjs";
 import { joinURL } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME } from "devframe/constants";
 import { existsSync } from "node:fs";

package/dist/node/index.d.mts

@@ -144,21 +144,7 @@ export declare class DevframeTerminalsHost implements DevframeTerminalsHost$1 {
  * Pairs with the `devframe:commands` shared state: clients read the list
  * from the shared state and dispatch by id via this RPC.
  */
-export declare const hubCommandsExecute: {
-  name: "hub:commands:execute";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, ...args: any[]], Promise<unknown>>>) | undefined;
-  handler?: ((id: string, ...args: any[]) => Promise<unknown>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string, ...args: any[]], Promise<unknown>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, ...args: any[]], Promise<unknown>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, ...args: any[]], Promise<unknown>>> | undefined;
-};
+export declare const hubCommandsExecute: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:commands:execute", "action", [id: string, ...args: any[]], Promise<unknown>, undefined, undefined, DevframeHubContext>;
 /**
  * `hub:messages:add`: Add a message from a browser client into the hub's
  * messages subsystem. Marked `from: 'browser'`. Returns the serializable
@@ -168,166 +154,40 @@ export declare const hubCommandsExecute: {
  * context, whose `messages` client dispatches through these built-ins so a
  * dock client script can report into the same feed the server writes to.
  */
-export declare const hubMessagesAdd: {
-  name: "hub:messages:add";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>>) | undefined;
-  handler?: ((input: DevframeMessageEntryInput) => Promise<DevframeMessageEntry>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>>> | undefined;
-};
+export declare const hubMessagesAdd: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:messages:add", "action", [input: DevframeMessageEntryInput], Promise<DevframeMessageEntry>, undefined, undefined, DevframeHubContext>;
 /** `hub:messages:update`: Patch a message by id; returns the updated entry (or `undefined`). */
-export declare const hubMessagesUpdate: {
-  name: "hub:messages:update";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>>) | undefined;
-  handler?: ((id: string, patch: Partial<DevframeMessageEntryInput>) => Promise<DevframeMessageEntry | undefined>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>>> | undefined;
-};
+export declare const hubMessagesUpdate: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:messages:update", "action", [id: string, patch: Partial<DevframeMessageEntryInput>], Promise<DevframeMessageEntry | undefined>, undefined, undefined, DevframeHubContext>;
 /** `hub:messages:remove`: Remove a message by id. */
-export declare const hubMessagesRemove: {
-  name: "hub:messages:remove";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>) | undefined;
-  handler?: ((id: string) => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
-};
+export declare const hubMessagesRemove: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:messages:remove", "action", [id: string], Promise<void>, undefined, undefined, DevframeHubContext>;
 /** `hub:messages:clear`: Remove every message. */
-export declare const hubMessagesClear: {
-  name: "hub:messages:clear";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], Promise<void>>>) | undefined;
-  handler?: (() => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], Promise<void>>> | undefined;
-};
+export declare const hubMessagesClear: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:messages:clear", "action", [], Promise<void>, undefined, undefined, DevframeHubContext>;
 /**
  * `hub:terminals:write`: Send input to an interactive PTY session spawned
  * via `ctx.terminals.startPtySession`. Lets a hub-aware terminal UI (e.g. the
  * terminals plugin) drive a session owned by another plugin.
  */
-export declare const hubTerminalsWrite: {
-  name: "hub:terminals:write";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, data: string], Promise<void>>>) | undefined;
-  handler?: ((id: string, data: string) => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string, data: string], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, data: string], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, data: string], Promise<void>>> | undefined;
-};
+export declare const hubTerminalsWrite: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:terminals:write", "action", [id: string, data: string], Promise<void>, undefined, undefined, DevframeHubContext>;
 /** `hub:terminals:resize`: Resize an interactive PTY session by id. */
-export declare const hubTerminalsResize: {
-  name: "hub:terminals:resize";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, cols: number, rows: number], Promise<void>>>) | undefined;
-  handler?: ((id: string, cols: number, rows: number) => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string, cols: number, rows: number], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, cols: number, rows: number], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string, cols: number, rows: number], Promise<void>>> | undefined;
-};
+export declare const hubTerminalsResize: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:terminals:resize", "action", [id: string, cols: number, rows: number], Promise<void>, undefined, undefined, DevframeHubContext>;
 /**
  * `hub:terminals:terminate`: Kill a session's process while keeping the
  * session registered (its output/scrollback stays). Works for both read-only
  * child-process and interactive PTY sessions, letting a hub-aware terminal UI
  * force-kill a session owned by another plugin.
  */
-export declare const hubTerminalsTerminate: {
-  name: "hub:terminals:terminate";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>) | undefined;
-  handler?: ((id: string) => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
-};
+export declare const hubTerminalsTerminate: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:terminals:terminate", "action", [id: string], Promise<void>, undefined, undefined, DevframeHubContext>;
 /**
  * `hub:terminals:restart`: Re-run a session's command in place. Rejected for
  * sessions registered with `restartable: false`, whose lifecycle is owned
  * elsewhere.
  */
-export declare const hubTerminalsRestart: {
-  name: "hub:terminals:restart";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>) | undefined;
-  handler?: ((id: string) => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
-};
+export declare const hubTerminalsRestart: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:terminals:restart", "action", [id: string], Promise<void>, undefined, undefined, DevframeHubContext>;
 /**
  * `hub:terminals:remove`: Kill a session's process (when it still owns one)
  * and drop it from the registry, disposing its output stream. Lets a hub-aware
  * terminal UI discard a stopped aggregated session.
  */
-export declare const hubTerminalsRemove: {
-  name: "hub:terminals:remove";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>) | undefined;
-  handler?: ((id: string) => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[id: string], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[id: string], Promise<void>>> | undefined;
-};
+export declare const hubTerminalsRemove: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:terminals:remove", "action", [id: string], Promise<void>, undefined, undefined, DevframeHubContext>;
 /**
  * `hub:docks:activate`: Ask the active viewer to switch its focused dock to
  * `dockId`, optionally carrying `params` for the target dock to interpret
@@ -340,36 +200,10 @@ export declare const hubTerminalsRemove: {
  * and mirrors it into the `devframe:docks:active` shared state (a dock that
  * mounts in response still converges on it).
  */
-export declare const hubDocksActivate: {
-  name: "hub:docks:activate";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args?: undefined;
-  returns?: undefined;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeHubContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: {
-    dockId: string;
-    params?: Record<string, unknown>;
-  }], Promise<void>>>) | undefined;
-  handler?: ((input: {
-    dockId: string;
-    params?: Record<string, unknown>;
-  }) => Promise<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[input: {
-    dockId: string;
-    params?: Record<string, unknown>;
-  }], Promise<void>, DevframeHubContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: {
-    dockId: string;
-    params?: Record<string, unknown>;
-  }], Promise<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[input: {
-    dockId: string;
-    params?: Record<string, unknown>;
-  }], Promise<void>>> | undefined;
-};
+export declare const hubDocksActivate: import("devframe/rpc").RpcFunctionDefinitionWithoutSchemas<"hub:docks:activate", "action", [input: {
+  dockId: string;
+  params?: Record<string, unknown>;
+}], Promise<void>, undefined, undefined, DevframeHubContext>;
 /**
  * Framework-neutral RPC declarations auto-registered by
  * {@link createHubContext}. Provide additional RPCs by passing your own

package/dist/node/index.mjs

@@ -1,4 +1,4 @@
-import { _ as DevframeCommandsHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeDocksHost, h as DevframeMessagesHost, i as hubDocksActivate, l as hubTerminalsRemove, m as DevframeTerminalsHost, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize } from "../context-C7AFekjP.mjs";
+import { _ as DevframeCommandsHost, a as hubMessagesAdd, c as hubMessagesUpdate, d as hubTerminalsRestart, f as hubTerminalsTerminate, g as DevframeDocksHost, h as DevframeMessagesHost, i as hubDocksActivate, l as hubTerminalsRemove, m as DevframeTerminalsHost, n as builtinHubRpcDeclarations, o as hubMessagesClear, p as hubTerminalsWrite, r as hubCommandsExecute, s as hubMessagesRemove, t as createHubContext, u as hubTerminalsResize } from "../context-BqvN40CU.mjs";
 import "ufo";
 import "node:fs";
 import "node:process";

package/dist/node/initiate.mjs

@@ -1,6 +1,6 @@
 import { a as normalizeHubBase, i as DOCK_RENDERERS_STATE_KEY, r as DEVFRAMES_HUB_BASE } from "../constants-Da23JxCZ.mjs";
-import { t as createHubContext, y as diagnostics } from "../context-C7AFekjP.mjs";
-import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-B-ISfDe5.mjs";
+import { t as createHubContext, y as diagnostics } from "../context-BqvN40CU.mjs";
+import { i as resolveRendererRegistrations, n as renderClientImportsModule, r as resolveDevframesInput, t as mountDevframes } from "../assemble-C_sd1y1C.mjs";
 import { joinURL, withoutLeadingSlash } from "ufo";
 import { DEVFRAME_CONNECTION_META_FILENAME, DEVFRAME_DOCK_IMPORTS_FILENAME, DEVFRAME_MCP_ROUTE } from "devframe/constants";
 import { readFile } from "node:fs/promises";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.9.18",
+  "version": "0.9.20",
   "description": "Hub layer that orchestrates devframe docks, terminals, messages, and commands on any host.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -35,7 +35,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.9.18"
+    "devframe": "0.9.20"
   },
   "dependencies": {
     "@standard-schema/spec": "^1.1.0",
@@ -48,12 +48,12 @@
     "zigpty": "^0.2.1"
   },
   "devDependencies": {
-    "@types/node": "^26.5.0",
-    "devframe": "0.9.18",
+    "@types/node": "^26.5.1",
+    "devframe": "0.9.20",
     "get-port-please": "^3.2.0",
     "mlly": "^1.8.2",
     "tsdown": "^0.23.0",
-    "valibot": "^1.4.2"
+    "valibot": "^1.5.0"
   },
   "scripts": {
     "build": "tsdown",