devframe 0.8.2 → 0.9.0-beta.10

package/dist/{host-h3-D2hYZvDK.mjs → context-CEe4PBz1.mjs}

@@ -1,254 +1,20 @@
-import { t as devframeReporter } from "./diagnostics-reporter-CsIG85Q5.mjs";
-import { t as diagnostics } from "./diagnostics-hwjXp_UV.mjs";
+import { i as defineDiagnostics } from "./nostics-CzECRXpE.mjs";
+import { t as diagnostics } from "./diagnostics-CD8nlgll.mjs";
 import { RpcFunctionsCollectorBase } from "./rpc/index.mjs";
 import { defineRpcFunction } from "./index.mjs";
-import { t as diagnostics$1 } from "./diagnostics-D7wM2cwM.mjs";
-import { i as createEventEmitter, n as createSharedState, r as nanoid, t as createStorage } from "./storage-CTNVbuFB.mjs";
-import { defineDiagnostics } from "nostics";
-import { isatty } from "node:tty";
-import { formatWithOptions, inspect } from "node:util";
+import { t as diagnostics$1 } from "./diagnostics-DOQPnQmX.mjs";
+import { r as createEventEmitter, t as DevframeAgentHost } from "./host-agent-xLCSe65D.mjs";
+import { n as createDebug, t as resolveStaticAssetsSource } from "./remote-assets-nTTxY2MU.mjs";
+import { t as createStorage } from "./storage-CYye7P7L.mjs";
+import { createSharedState } from "devframe/utils/shared-state";
 import { existsSync } from "node:fs";
 import { join } from "pathe";
-import process$1 from "node:process";
-import { homedir } from "node:os";
-//#region src/node/agent-args.ts
-/**
-* Map the args payload an agent surface receives (MCP sends an object
-* keyed `arg0`/`arg1`/…, matching the schema the adapter advertises) onto
-* a handler's positional parameters. Shared by the agent host's RPC
-* bridge and the hub's command-derived tools so the coercion cannot
-* drift between them.
-*
-* - an array passes through as-is
-* - `null`/`undefined` become a zero-argument call
-* - with declared schemas, each schema reads its own `argN` key, in order
-* - without schemas, `arg0`/`arg1`/… keys are collected when present
-* - an empty object becomes a zero-argument call
-* - anything else follows the {@link AgentArgsFallback}
-*
-* @experimental
-*/
-function coerceAgentPositionalArgs(args, schemas, fallback = "wrap") {
-	if (Array.isArray(args)) return args;
-	if (args === void 0 || args === null) return [];
-	if (typeof args === "object") {
-		const obj = args;
-		if (schemas && schemas.length) return schemas.map((_, i) => obj[`arg${i}`]);
-		if ("arg0" in obj) {
-			const out = [];
-			let i = 0;
-			while (`arg${i}` in obj) {
-				out.push(obj[`arg${i}`]);
-				i++;
-			}
-			return out;
-		}
-		if (Object.keys(obj).length === 0) return [];
-	}
-	return fallback === "drop" ? [] : [args];
-}
-//#endregion
-//#region src/node/host-agent.ts
-/**
-* Framework-neutral host aggregating the agent-exposed surface of a
-* devframe. Auto-discovers RPC functions with an `agent` field from
-* `ctx.rpc.definitions`, and accepts plugin-registered tools /
-* resources via `registerTool` / `registerResource`.
-*
-* @experimental
-*/
-var DevframeAgentHost = class {
-	context;
-	events = createEventEmitter();
-	tools = /* @__PURE__ */ new Map();
-	resources = /* @__PURE__ */ new Map();
-	providers = /* @__PURE__ */ new Set();
-	_rpcUnsubscribe;
-	constructor(context) {
-		this.context = context;
-		this._rpcUnsubscribe = context.rpc.onChanged(() => {
-			this.events.emit("agent:manifest:changed");
-		});
-	}
-	registerTool(input) {
-		this._validateToolId(input.id);
-		const tool = this._projectTool(input);
-		this.tools.set(tool.id, {
-			tool,
-			handler: input.handler
-		});
-		this.events.emit("agent:tool:registered", tool);
-		this.events.emit("agent:manifest:changed");
-		return { unregister: () => this.unregisterTool(tool.id) };
-	}
-	unregisterTool(id) {
-		const existed = this.tools.delete(id);
-		if (existed) {
-			this.events.emit("agent:tool:unregistered", id);
-			this.events.emit("agent:manifest:changed");
-		}
-		return existed;
-	}
-	registerToolProvider(provider) {
-		this.providers.add(provider);
-		this.events.emit("agent:manifest:changed");
-		const notifyChanged = () => {
-			if (this.providers.has(provider)) this.events.emit("agent:manifest:changed");
-		};
-		return {
-			notifyChanged,
-			unregister: () => {
-				if (this.providers.delete(provider)) this.events.emit("agent:manifest:changed");
-			}
-		};
-	}
-	registerResource(input) {
-		if (this.resources.has(input.id)) throw diagnostics$1.DF0016({ id: input.id });
-		const resource = {
-			id: input.id,
-			name: input.name,
-			description: input.description,
-			mimeType: input.mimeType ?? "application/json",
-			uri: input.uri ?? `devframe://resource/${encodeURIComponent(input.id)}`
-		};
-		this.resources.set(resource.id, {
-			resource,
-			read: input.read
-		});
-		this.events.emit("agent:resource:registered", resource);
-		this.events.emit("agent:manifest:changed");
-		return { unregister: () => this.unregisterResource(resource.id) };
-	}
-	unregisterResource(id) {
-		const existed = this.resources.delete(id);
-		if (existed) {
-			this.events.emit("agent:resource:unregistered", id);
-			this.events.emit("agent:manifest:changed");
-		}
-		return existed;
-	}
-	list() {
-		const rpcTools = this._collectRpcTools();
-		const plainTools = Array.from(this.tools.values()).map((t) => t.tool);
-		const resources = Array.from(this.resources.values()).map((r) => r.resource);
-		const seen = new Set([...rpcTools, ...plainTools].map((t) => t.id));
-		const providerTools = [];
-		for (const { tool } of this._collectProviderTools()) {
-			if (seen.has(tool.id)) continue;
-			seen.add(tool.id);
-			providerTools.push(tool);
-		}
-		return {
-			tools: [
-				...rpcTools,
-				...plainTools,
-				...providerTools
-			],
-			resources
-		};
-	}
-	getTool(id) {
-		const plain = this.tools.get(id);
-		if (plain) return plain.tool;
-		const rpc = this._collectRpcTools().find((t) => t.id === id);
-		if (rpc) return rpc;
-		return this._collectProviderTools().find((t) => t.tool.id === id)?.tool;
-	}
-	getResource(id) {
-		return this.resources.get(id)?.resource;
-	}
-	async invoke(id, args) {
-		const plain = this.tools.get(id);
-		if (plain?.handler) return await plain.handler(args);
-		const rpcDef = this._findRpcDefinition(id);
-		if (rpcDef) {
-			const positional = coerceAgentPositionalArgs(args, rpcDef.args, "wrap");
-			return await this.context.rpc.invokeLocal(id, ...positional);
-		}
-		const provided = this._collectProviderTools().find((t) => t.tool.id === id);
-		if (provided) return await provided.input.handler(args);
-		throw new Error(`[devframe/agent] tool "${id}" not found`);
-	}
-	async read(id) {
-		const entry = this.resources.get(id);
-		if (!entry) throw new Error(`[devframe/agent] resource "${id}" not found`);
-		return await entry.read();
-	}
-	/** @internal */
-	_dispose() {
-		this._rpcUnsubscribe?.();
-		this._rpcUnsubscribe = void 0;
-	}
-	_validateToolId(id) {
-		if (this.tools.has(id)) throw diagnostics$1.DF0015({ id });
-		if (this.context.rpc.definitions.get(id)?.agent) throw diagnostics$1.DF0015({ id });
-	}
-	_projectTool(input) {
-		if (!input.description || typeof input.description !== "string") throw diagnostics$1.DF0014({ name: input.id });
-		return {
-			id: input.id,
-			kind: "tool",
-			title: input.title ?? input.id,
-			description: input.description,
-			safety: input.safety ?? "action",
-			tags: input.tags,
-			args: input.args,
-			inputSchema: input.inputSchema,
-			outputSchema: input.outputSchema,
-			examples: input.examples
-		};
-	}
-	/** Query every registered provider, projecting inputs to serializable tools. */
-	_collectProviderTools() {
-		const out = [];
-		for (const provider of this.providers) for (const input of provider()) out.push({
-			input,
-			tool: this._projectTool(input)
-		});
-		return out;
-	}
-	_collectRpcTools() {
-		const out = [];
-		for (const [name, def] of this.context.rpc.definitions) {
-			const agent = def.agent;
-			if (!agent) continue;
-			if (!agent.description || typeof agent.description !== "string") throw diagnostics$1.DF0014({ name });
-			const type = def.type ?? "query";
-			const safety = agent.safety ?? inferSafety(type);
-			out.push({
-				id: name,
-				kind: "rpc",
-				title: agent.title ?? name,
-				description: agent.description,
-				safety,
-				tags: agent.tags,
-				rpcName: name,
-				examples: agent.examples
-			});
-		}
-		return out;
-	}
-	_findRpcDefinition(id) {
-		const def = this.context.rpc.definitions.get(id);
-		if (def?.agent) return def;
-	}
-};
-function inferSafety(type) {
-	if (type === "static" || type === "query") return "read";
-	return "action";
-}
-//#endregion
 //#region src/node/host-diagnostics.ts
 var DevframeDiagnosticsHost = class {
 	context;
 	_registry = {};
 	logger = new Proxy({}, { get: (_, code) => this._registry[code] });
-	defineDiagnostics = (opts) => {
-		return defineDiagnostics({
-			...opts,
-			reporters: [devframeReporter, ...opts.reporters ?? []]
-		});
-	};
+	defineDiagnostics = defineDiagnostics;
 	constructor(context, initialDefinitions = []) {
 		this.context = context;
 		for (const d of initialDefinitions) this.register(d);
@@ -258,291 +24,6 @@ var DevframeDiagnosticsHost = class {
 	}
 };
 //#endregion
-//#region ../../node_modules/.pnpm/obug@2.1.4/node_modules/obug/dist/core.js
-/**
-* Coerce `value`.
-*/
-function coerce(value) {
-	if (value instanceof Error) return value.stack || value.message;
-	return value;
-}
-/**
-* Selects a color for a debug namespace
-* @return An ANSI color code for the given namespace
-*/
-function selectColor(colors, namespace) {
-	let hash = 0;
-	for (let i = 0; i < namespace.length; i++) {
-		hash = (hash << 5) - hash + namespace.charCodeAt(i);
-		hash |= 0;
-	}
-	return colors[Math.abs(hash) % colors.length];
-}
-/**
-* Checks if the given string matches a namespace template, honoring
-* asterisks as wildcards.
-*/
-function matchesTemplate(search, template) {
-	let searchIndex = 0;
-	let templateIndex = 0;
-	let starIndex = -1;
-	let matchIndex = 0;
-	while (searchIndex < search.length) if (templateIndex < template.length && (template[templateIndex] === search[searchIndex] || template[templateIndex] === "*")) if (template[templateIndex] === "*") {
-		starIndex = templateIndex;
-		matchIndex = searchIndex;
-		templateIndex++;
-	} else {
-		searchIndex++;
-		templateIndex++;
-	}
-	else if (starIndex !== -1) {
-		templateIndex = starIndex + 1;
-		matchIndex++;
-		searchIndex = matchIndex;
-	} else return false;
-	while (templateIndex < template.length && template[templateIndex] === "*") templateIndex++;
-	return templateIndex === template.length;
-}
-function humanize(value) {
-	if (value >= 1e3) return `${(value / 1e3).toFixed(1)}s`;
-	return `${value}ms`;
-}
-let globalNamespaces = "";
-function createDebug$1(namespace, options) {
-	let prevTime;
-	let enableOverride;
-	let namespacesCache;
-	let enabledCache;
-	const debug = (...args) => {
-		if (!debug.enabled) return;
-		const curr = Date.now();
-		const diff = curr - (prevTime || curr);
-		prevTime = curr;
-		args[0] = coerce(args[0]);
-		if (typeof args[0] !== "string") args.unshift("%O");
-		let index = 0;
-		args[0] = args[0].replace(/%([a-z%])/gi, (match, format) => {
-			if (match === "%%") return "%";
-			index++;
-			const formatter = options.formatters[format];
-			if (typeof formatter === "function") {
-				const value = args[index];
-				match = formatter.call(debug, value);
-				args.splice(index, 1);
-				index--;
-			}
-			return match;
-		});
-		options.formatArgs.call(debug, diff, args);
-		debug.log(...args);
-	};
-	debug.extend = function(namespace, delimiter = ":") {
-		return createDebug$1(this.namespace + delimiter + namespace, {
-			useColors: this.useColors,
-			color: this.color,
-			formatArgs: this.formatArgs,
-			formatters: this.formatters,
-			inspectOpts: this.inspectOpts,
-			log: this.log,
-			humanize: this.humanize
-		});
-	};
-	Object.assign(debug, options);
-	debug.namespace = namespace;
-	Object.defineProperty(debug, "enabled", {
-		enumerable: true,
-		configurable: false,
-		get: () => {
-			if (enableOverride != null) return enableOverride;
-			if (namespacesCache !== globalNamespaces) {
-				namespacesCache = globalNamespaces;
-				enabledCache = enabled(namespace);
-			}
-			return enabledCache;
-		},
-		set: (v) => {
-			enableOverride = v;
-		}
-	});
-	return debug;
-}
-let names = [];
-let skips = [];
-function enable(namespaces) {
-	globalNamespaces = namespaces;
-	names = [];
-	skips = [];
-	const split = globalNamespaces.trim().replace(/\s+/g, ",").split(",").filter(Boolean);
-	for (const ns of split) if (ns[0] === "-") skips.push(ns.slice(1));
-	else names.push(ns);
-}
-/**
-* Returns true if the given mode name is enabled, false otherwise.
-*/
-function enabled(name) {
-	for (const skip of skips) if (matchesTemplate(name, skip)) return false;
-	for (const ns of names) if (matchesTemplate(name, ns)) return true;
-	return false;
-}
-//#endregion
-//#region ../../node_modules/.pnpm/obug@2.1.4/node_modules/obug/dist/node.js
-let env = {};
-try {
-	process.env.DEBUG;
-	env = process.env;
-} catch (_unused) {}
-const colors = process.stderr.getColorDepth && process.stderr.getColorDepth(env) > 2 ? [
-	20,
-	21,
-	26,
-	27,
-	32,
-	33,
-	38,
-	39,
-	40,
-	41,
-	42,
-	43,
-	44,
-	45,
-	56,
-	57,
-	62,
-	63,
-	68,
-	69,
-	74,
-	75,
-	76,
-	77,
-	78,
-	79,
-	80,
-	81,
-	92,
-	93,
-	98,
-	99,
-	112,
-	113,
-	128,
-	129,
-	134,
-	135,
-	148,
-	149,
-	160,
-	161,
-	162,
-	163,
-	164,
-	165,
-	166,
-	167,
-	168,
-	169,
-	170,
-	171,
-	172,
-	173,
-	178,
-	179,
-	184,
-	185,
-	196,
-	197,
-	198,
-	199,
-	200,
-	201,
-	202,
-	203,
-	204,
-	205,
-	206,
-	207,
-	208,
-	209,
-	214,
-	215,
-	220,
-	221
-] : [
-	6,
-	2,
-	3,
-	4,
-	5,
-	1
-];
-const inspectOpts = Object.keys(env).filter((key) => /^debug_/i.test(key)).reduce((obj, key) => {
-	const prop = key.slice(6).toLowerCase().replace(/_([a-z])/g, (_, k) => k.toUpperCase());
-	let value = env[key];
-	const lowerCase = typeof value === "string" && value.toLowerCase();
-	if (value === "null") value = null;
-	else if (lowerCase === "yes" || lowerCase === "on" || lowerCase === "true" || lowerCase === "enabled") value = true;
-	else if (lowerCase === "no" || lowerCase === "off" || lowerCase === "false" || lowerCase === "disabled") value = false;
-	else value = Number(value);
-	obj[prop] = value;
-	return obj;
-}, Object.create(null));
-/**
-* Is stdout a TTY? Colored output is enabled when `true`.
-*/
-function useColors() {
-	return "colors" in inspectOpts ? Boolean(inspectOpts.colors) : isatty(process.stderr.fd);
-}
-function getDate() {
-	if (inspectOpts.hideDate) return "";
-	return `${(/* @__PURE__ */ new Date()).toISOString()} `;
-}
-/**
-* Adds ANSI color escape codes if enabled.
-*/
-function formatArgs(diff, args) {
-	const { namespace: name, useColors } = this;
-	if (useColors) {
-		const c = this.color;
-		const colorCode = `\u001B[3${c < 8 ? c : `8;5;${c}`}`;
-		const prefix = `  ${colorCode};1m${name} \u001B[0m`;
-		args[0] = prefix + args[0].split("\n").join(`\n${prefix}`);
-		args.push(`${colorCode}m+${this.humanize(diff)}\u001B[0m`);
-	} else args[0] = `${getDate()}${name} ${args[0]}`;
-}
-function log(...args) {
-	process.stderr.write(`${formatWithOptions(this.inspectOpts, ...args)}\n`);
-}
-const defaultOptions = {
-	useColors: useColors(),
-	formatArgs,
-	formatters: {
-		/**
-		* Map %o to `util.inspect()`, all on a single line.
-		*/
-		o(v) {
-			this.inspectOpts.colors = this.useColors;
-			return inspect(v, this.inspectOpts).split("\n").map((str) => str.trim()).join(" ");
-		},
-		/**
-		* Map %O to `util.inspect()`, allowing multiple lines if needed.
-		*/
-		O(v) {
-			this.inspectOpts.colors = this.useColors;
-			return inspect(v, this.inspectOpts);
-		}
-	},
-	inspectOpts,
-	log,
-	humanize
-};
-function createDebug(namespace, options) {
-	var _ref;
-	const color = (_ref = options && options.color) !== null && _ref !== void 0 ? _ref : selectColor(colors, namespace);
-	return createDebug$1(namespace, Object.assign(defaultOptions, { color }, options));
-}
-enable(env.DEBUG || "");
-//#endregion
 //#region src/node/rpc-shared-state.ts
 const debug$1 = createDebug("devframe:rpc:state:changed");
 const debugSubscribe = createDebug("devframe:rpc:state:subscribe");
@@ -659,6 +140,15 @@ function createRpcSharedStateServerHost(rpc) {
 	return host;
 }
 //#endregion
+//#region src/utils/nanoid.ts
+const urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+function nanoid(size = 21) {
+	let id = "";
+	let i = size;
+	while (i--) id += urlAlphabet[Math.random() * 64 | 0];
+	return id;
+}
+//#endregion
 //#region src/utils/streaming-channel.ts
 const DEFAULT_HIGH_WATER_MARK = 256;
 var StreamClosedError = class extends Error {
@@ -1217,7 +707,7 @@ const debugBroadcast = createDebug("devframe:rpc:broadcast");
 * Concrete implementation backing `ctx.rpc`. Internal: consumers should
 * depend on the structural {@link RpcFunctionsHost} type, never this class.
 * Its `@internal` members (`_rpcGroup`, `_asyncStorage`,
-* `_emitSessionDisconnected`) are wired by `startHttpAndWs` and must not
+* `_emitSessionDisconnected`) are wired by `createContextRpcServer` and must not
 * widen the public surface.
 *
 * @internal
@@ -1321,13 +811,14 @@ var DevframeViewHost = class {
 	constructor(context) {
 		this.context = context;
 	}
-	hostStatic(baseUrl, distDir) {
-		if (!existsSync(distDir)) throw diagnostics$1.DF0008({ distDir });
+	hostStatic(baseUrl, source) {
+		const resolved = resolveStaticAssetsSource(source, this.context.host.getStorageDir("project"));
+		if (typeof resolved === "string" && !existsSync(resolved)) throw diagnostics$1.DF0008({ distDir: resolved });
 		this.buildStaticDirs.push({
 			baseUrl,
-			distDir
+			source
 		});
-		this.context.host.mountStatic(baseUrl, distDir);
+		this.context.host.mountStatic(baseUrl, resolved);
 	}
 };
 //#endregion
@@ -1359,8 +850,6 @@ const agentListResources = defineRpcFunction({
 * Built-in agent introspection RPC functions. Registered automatically
 * by `createHostContext`. Not themselves agent-exposed (no `agent`
 * field) — they power the MCP adapter and any future agent CLI.
-*
-* @experimental
 */
 const BUILTIN_AGENT_RPC = [
 	defineRpcFunction({
@@ -1525,6 +1014,7 @@ async function createHostContext(options) {
 		diagnostics: void 0,
 		agent: void 0,
 		services: void 0,
+		staticConfig: {},
 		scope: void 0
 	};
 	const rpcHost = new RpcFunctionsHostImpl(context);
@@ -1550,26 +1040,4 @@ async function createHostContext(options) {
 	return context;
 }
 //#endregion
-//#region src/node/host-h3.ts
-/**
-* h3-backed {@link DevframeHost} — used by the standalone CLI adapter.
-*/
-function createH3DevframeHost(options) {
-	const workspaceRoot = options.workspaceRoot ?? process$1.cwd();
-	return {
-		mountStatic(base, distDir) {
-			return options.mount?.(base, distDir);
-		},
-		resolveOrigin() {
-			return options.origin;
-		},
-		getStorageDir(scope) {
-			const namespace = `.${options.appName}/devframe`;
-			if (scope === "workspace") return join(workspaceRoot, ".devframe");
-			if (scope === "project") return join(workspaceRoot, "node_modules", namespace);
-			return join(homedir(), namespace);
-		}
-	};
-}
-//#endregion
-export { DevframeViewHost as a, createRpcSharedStateServerHost as c, coerceAgentPositionalArgs as d, createNodeSettings as i, DevframeDiagnosticsHost as l, createHostContext as n, DevframeServicesHostImpl as o, createScopedNodeContext as r, createRpcStreamingServerHost as s, createH3DevframeHost as t, DevframeAgentHost as u };
+export { createHostContext as t };

package/dist/{context-CBg8iRbQ.mjs → context-xdynGSLP.mjs}

@@ -1,5 +1,5 @@
 import { n as randomToken } from "./crypto-token-XCqTSMg9.mjs";
-import { t as createStorage } from "./storage-CTNVbuFB.mjs";
+import { t as createStorage } from "./storage-CYye7P7L.mjs";
 import { n as revokeAuthToken, t as revokeActiveConnectionsForToken } from "./revoke-DZbJ7Cl0.mjs";
 import { join } from "pathe";
 //#region src/node/hub-internals/context.ts
@@ -11,6 +11,7 @@ function getInternalContext(context) {
 			initialValue: { trusted: {} }
 		});
 		const remoteTokens = /* @__PURE__ */ new Map();
+		const wsEndpointListeners = /* @__PURE__ */ new Set();
 		function revokeRemoteToken(token) {
 			if (!remoteTokens.delete(token)) return;
 			revokeActiveConnectionsForToken(context, token);
@@ -18,6 +19,14 @@ function getInternalContext(context) {
 		const internalContext = {
 			storage: { auth: storage },
 			revokeAuthToken: (token) => revokeAuthToken(context, storage, token),
+			setWsEndpoint(endpoint) {
+				internalContext.wsEndpoint = endpoint;
+				for (const listener of wsEndpointListeners) listener();
+			},
+			onWsEndpointChange(cb) {
+				wsEndpointListeners.add(cb);
+				return () => wsEndpointListeners.delete(cb);
+			},
 			remoteTokens,
 			allocateRemoteToken(dockId, origin, originLock) {
 				const token = randomToken();