@agimon-ai/doompi-core 0.0.1-alpha.100

package/dist/src/extensions/extensionFile.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionFile.d.mts","names":[],"sources":["../../../src/extensions/extensionFile.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;wBA0CgB,yBAAyB,GAAG,MAAM,GAAG,UAAU,oBAAoB;;wBAKnE,eAAe,GAAG,MAAM,IAAI;;wBAK5B,eAAe,GAAG,MAAM,IAAI;;wBAK5B,eAAe,GAAG,MAAM,IAAI;;wBAK5B,sBAAsB,GAAG,MAAM,IAAI;;wBAKnC,WAAW,GAAG,MAAM,IAAI;;wBAKxB,cAAc,UAAU,aAAa,MAAM,IAAI;;wBAI/C,WAAW,oBAAoB,MAAM,SAAS,YAAY,iBAAiB;;wBAO3E,iBAAiB,oBAAoB,UAAU,SAAS,oBACtE,MAAM,eAAe,aAAa,YACjC,eAAe,aAAa;;;;;;;;;;wBAaf,WAAW,QAAQ,oBAAoB,MAAM,SAAS,QAAQ,YAAY,SAAS,QAAQ;;;;;;;;wBAW3F,iBAAiB,aAC5B,gBAAgB,qBAAqB,cACvC,SAAS,qBAAqB;;wBAgBjB,cAAc,oBAAoB,MAAM,YAAY,YAAY,YAAY;;wBAK5E,iBAAiB,oBAAoB,MAAM,eAAe,YAAY,eAAe;;wBAKrF,oBAAoB,oBAClC,MAAM,kBAAkB,YACvB,kBAAkB;;wBAKL,cAAc,oBAAoB,MAAM,YAAY,YAAY,oBAAoB;;wBAOpF,cAAc,UAAU,iBAAiB,gBACvD,OAAO,SAAS,aAAa,WAC5B,YAAY,UAAU;;wBAKT,WAAW,eAAe,wBAAwB,uBAAuB,oBACvF,MAAM,SAAS,QAAQ,YACtB,SAAS,QAAQ;;wBAKJ,cAAc,oBAAoB,MAAM,YAAY,YAAY,YAAY;;wBAK5E,cAAc,MAAM,cAAc;;wBAKlC,YAAY,oBAAoB,MAAM,UAAU,YAAY,UAAU;;wBAKtE,aAAa,oBAAoB,MAAM,WAAW,YAAY,WAAW;;wBAKzE,eAAe,oBAAoB,MAAM,aAAa,YAAY,aAAa"}

package/dist/src/extensions/extensionFile.mjs

@@ -0,0 +1,144 @@
+//#region src/extensions/extensionFile.ts
+/**
+* Identity helpers for folder-routed backend files, one per surface.
+*
+* A routed file's default export is its whole contract with the host, and
+* nothing else validates it: the generated entry merges the path's identity in
+* and hands the result to a contribution array, where an excess or misspelled
+* key is invisible. These make the shape checkable at the point it is written,
+* and give the factory form a typed context instead of an implicit any.
+*
+* Most return their argument unchanged, so the value is entirely in the
+* position they check and the inference they supply. The two that do not,
+* `defineTool` and `defineCommand`, add the discriminant the host reads to
+* tell a portable contribution from a raw host declaration.
+*/
+/** Declares non-default route cardinality while preserving the routed surface's inferred host type. */
+function defineRoutedContribution(file, _options) {
+	return file;
+}
+/** `provider/<name>.cli.ts`. Declares one Pi provider tuple. */
+function defineProvider(file) {
+	return file;
+}
+/** `resource/<name>.ts`. Declares one package resource. */
+function defineResource(file) {
+	return file;
+}
+/** `shortcut/<name>.cli.ts`. Declares one Pi keyboard shortcut. */
+function defineShortcut(file) {
+	return file;
+}
+/** `tool-restriction/<name>.ts`. Declares one tool restriction. */
+function defineToolRestriction(file) {
+	return file;
+}
+/** Declares one mode when it is not represented by a mode gate file. */
+function defineMode(file) {
+	return file;
+}
+/** `overlay/<name>.cli.ts`. A terminal view opened directly by a command. */
+function defineOverlay(file) {
+	return file;
+}
+/** `tool/<name>.ts`. Adds the discriminant the contribution array expects. */
+function defineTool(file) {
+	return typeof file === "function" ? (context) => ({
+		kind: "tool",
+		...file(context)
+	}) : {
+		kind: "tool",
+		...file
+	};
+}
+/** `tool/<name>.server.ts`. A native headless tool, handed to the host untouched. */
+function defineServerTool(file) {
+	return file;
+}
+/**
+* `root.ts`. Constructs one scope and names what its subtree shares.
+*
+* The answer to a package whose surfaces all read one per-mount object graph.
+* The root builds that graph once, and every routed file beneath it receives
+* it as `context.root`, so the package decomposes into a file per surface
+* without either rebuilding the graph per file or reaching for a module-level
+* singleton.
+*/
+function defineRoot(file) {
+	return file;
+}
+/**
+* Folds every root in a scope chain into one set of lifecycle hooks.
+*
+* Start outermost first and tear down innermost first, which is the order the
+* roots were constructed in and the only order in which an inner scope can
+* still rely on its outer one while stopping.
+*/
+function composeRootHooks(...roots) {
+	const reversed = [...roots].reverse();
+	return {
+		async onStart(context) {
+			for (const root of roots) await root.onStart?.(context);
+		},
+		async onStop(context) {
+			for (const root of reversed) await root.onStop?.(context);
+		},
+		async onDispose(context) {
+			for (const root of reversed) await root.onDispose?.(context);
+		}
+	};
+}
+/** `tool/<name>.cli.ts`. A native interactive tool, handed to Pi untouched. */
+function defineCliTool(file) {
+	return file;
+}
+/** `command/<name>.cli.ts`. A native Pi command or portable Doom command. */
+function defineCliCommand(file) {
+	return file;
+}
+/** `command/<name>.server.ts`. A native headless or portable Doom command. */
+function defineServerCommand(file) {
+	return file;
+}
+/** `command/<name>.ts`. Adds the discriminant the contribution array expects. */
+function defineCommand(file) {
+	return typeof file === "function" ? (context) => ({
+		kind: "command",
+		...file(context)
+	}) : {
+		kind: "command",
+		...file
+	};
+}
+/** `hook/<event>.cli.ts`. A native Pi event handler factory. */
+function defineCliHook(file) {
+	return file;
+}
+/** `hook/<event>.ts`. Name the event here too when the handler needs a precise payload. */
+function defineHook(file) {
+	return file;
+}
+/** A Cordis service factory for a scope root. */
+function defineService(file) {
+	return file;
+}
+/** `channel/<frameType>.ts`. The contribution array holds factories, so this is one. */
+function defineChannel(file) {
+	return file;
+}
+/** `api/<segments>/route.ts`. The folder path is the route. */
+function defineRoute(file) {
+	return file;
+}
+/** `method/<member>.ts`. Build the value with `defineServerMethod` to keep schema inference. */
+function defineMethod(file) {
+	return file;
+}
+/** A server activity declaration for a session root. */
+function defineActivity(file) {
+	return file;
+}
+//#endregion
+export { composeRootHooks, defineActivity, defineChannel, defineCliCommand, defineCliHook, defineCliTool, defineCommand, defineHook, defineMethod, defineMode, defineOverlay, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineShortcut, defineTool, defineToolRestriction };
+
+//# sourceMappingURL=extensionFile.mjs.map

package/dist/src/extensions/extensionFile.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionFile.mjs","names":[],"sources":["../../../src/extensions/extensionFile.ts"],"sourcesContent":["import type { TSchema } from 'typebox';\n\nimport type {\n  ActivityFile,\n  ChannelFile,\n  CliCommandFile,\n  CliHookFile,\n  CliHookHandler,\n  CliToolFile,\n  CommandContribution,\n  CommandFile,\n  HookFile,\n  MethodFile,\n  OverlayFile,\n  RootFile,\n  RoutedFileOptions,\n  RouteFile,\n  ServerCommandFile,\n  ServerToolFile,\n  ServiceFile,\n  ToolContribution,\n  ToolFile,\n} from '../schemas/extensionFile';\nimport type { DoomHeadlessEventName } from '../schemas/headless';\nimport type { PluginLifecycleHooks } from '../services/pluginLifecycle';\n\n/**\n * Identity helpers for folder-routed backend files, one per surface.\n *\n * A routed file's default export is its whole contract with the host, and\n * nothing else validates it: the generated entry merges the path's identity in\n * and hands the result to a contribution array, where an excess or misspelled\n * key is invisible. These make the shape checkable at the point it is written,\n * and give the factory form a typed context instead of an implicit any.\n *\n * Most return their argument unchanged, so the value is entirely in the\n * position they check and the inference they supply. The two that do not,\n * `defineTool` and `defineCommand`, add the discriminant the host reads to\n * tell a portable contribution from a raw host declaration.\n */\n\n/** Declares non-default route cardinality while preserving the routed surface's inferred host type. */\nexport function defineRoutedContribution<T>(file: T, _options: RoutedFileOptions): T {\n  return file;\n}\n\n/** `provider/<name>.cli.ts`. Declares one Pi provider tuple. */\nexport function defineProvider<T>(file: T): T {\n  return file;\n}\n\n/** `resource/<name>.ts`. Declares one package resource. */\nexport function defineResource<T>(file: T): T {\n  return file;\n}\n\n/** `shortcut/<name>.cli.ts`. Declares one Pi keyboard shortcut. */\nexport function defineShortcut<T>(file: T): T {\n  return file;\n}\n\n/** `tool-restriction/<name>.ts`. Declares one tool restriction. */\nexport function defineToolRestriction<T>(file: T): T {\n  return file;\n}\n\n/** Declares one mode when it is not represented by a mode gate file. */\nexport function defineMode<T>(file: T): T {\n  return file;\n}\n\n/** `overlay/<name>.cli.ts`. A terminal view opened directly by a command. */\nexport function defineOverlay<T extends OverlayFile>(file: T): T {\n  return file;\n}\n/** `tool/<name>.ts`. Adds the discriminant the contribution array expects. */\nexport function defineTool<TContext = unknown>(file: ToolFile<TContext>): ToolContribution<TContext> {\n  return typeof file === 'function'\n    ? (context) => ({ kind: 'tool' as const, ...file(context) })\n    : { kind: 'tool' as const, ...file };\n}\n\n/** `tool/<name>.server.ts`. A native headless tool, handed to the host untouched. */\nexport function defineServerTool<TParameters extends TSchema = TSchema, TContext = unknown>(\n  file: ServerToolFile<TParameters, TContext>,\n): ServerToolFile<TParameters, TContext> {\n  return file;\n}\n\n/**\n * `root.ts`. Constructs one scope and names what its subtree shares.\n *\n * The answer to a package whose surfaces all read one per-mount object graph.\n * The root builds that graph once, and every routed file beneath it receives\n * it as `context.root`, so the package decomposes into a file per surface\n * without either rebuilding the graph per file or reaching for a module-level\n * singleton.\n */\nexport function defineRoot<TValue, TContext = unknown>(file: RootFile<TValue, TContext>): RootFile<TValue, TContext> {\n  return file;\n}\n\n/**\n * Folds every root in a scope chain into one set of lifecycle hooks.\n *\n * Start outermost first and tear down innermost first, which is the order the\n * roots were constructed in and the only order in which an inner scope can\n * still rely on its outer one while stopping.\n */\nexport function composeRootHooks<TContext>(\n  ...roots: readonly PluginLifecycleHooks<TContext>[]\n): Required<PluginLifecycleHooks<TContext>> {\n  const reversed = [...roots].reverse();\n  return {\n    async onStart(context) {\n      for (const root of roots) await root.onStart?.(context);\n    },\n    async onStop(context) {\n      for (const root of reversed) await root.onStop?.(context);\n    },\n    async onDispose(context) {\n      for (const root of reversed) await root.onDispose?.(context);\n    },\n  };\n}\n\n/** `tool/<name>.cli.ts`. A native interactive tool, handed to Pi untouched. */\nexport function defineCliTool<TContext = unknown>(file: CliToolFile<TContext>): CliToolFile<TContext> {\n  return file;\n}\n\n/** `command/<name>.cli.ts`. A native Pi command or portable Doom command. */\nexport function defineCliCommand<TContext = unknown>(file: CliCommandFile<TContext>): CliCommandFile<TContext> {\n  return file;\n}\n\n/** `command/<name>.server.ts`. A native headless or portable Doom command. */\nexport function defineServerCommand<TContext = unknown>(\n  file: ServerCommandFile<TContext>,\n): ServerCommandFile<TContext> {\n  return file;\n}\n\n/** `command/<name>.ts`. Adds the discriminant the contribution array expects. */\nexport function defineCommand<TContext = unknown>(file: CommandFile<TContext>): CommandContribution<TContext> {\n  return typeof file === 'function'\n    ? (context) => ({ kind: 'command' as const, ...file(context) })\n    : { kind: 'command' as const, ...file };\n}\n\n/** `hook/<event>.cli.ts`. A native Pi event handler factory. */\nexport function defineCliHook<TContext, THandler extends CliHookHandler>(\n  file: (context: TContext) => THandler,\n): CliHookFile<TContext, CliHookHandler> {\n  return file;\n}\n\n/** `hook/<event>.ts`. Name the event here too when the handler needs a precise payload. */\nexport function defineHook<TEvent extends DoomHeadlessEventName = DoomHeadlessEventName, TContext = unknown>(\n  file: HookFile<TEvent, TContext>,\n): HookFile<TEvent, TContext> {\n  return file;\n}\n\n/** A Cordis service factory for a scope root. */\nexport function defineService<TContext = unknown>(file: ServiceFile<TContext>): ServiceFile<TContext> {\n  return file;\n}\n\n/** `channel/<frameType>.ts`. The contribution array holds factories, so this is one. */\nexport function defineChannel(file: ChannelFile): ChannelFile {\n  return file;\n}\n\n/** `api/<segments>/route.ts`. The folder path is the route. */\nexport function defineRoute<TContext = unknown>(file: RouteFile<TContext>): RouteFile<TContext> {\n  return file;\n}\n\n/** `method/<member>.ts`. Build the value with `defineServerMethod` to keep schema inference. */\nexport function defineMethod<TContext = unknown>(file: MethodFile<TContext>): MethodFile<TContext> {\n  return file;\n}\n\n/** A server activity declaration for a session root. */\nexport function defineActivity<TContext = unknown>(file: ActivityFile<TContext>): ActivityFile<TContext> {\n  return file;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA0CA,SAAgB,yBAA4B,MAAS,UAAgC;CACnF,OAAO;AACT;;AAGA,SAAgB,eAAkB,MAAY;CAC5C,OAAO;AACT;;AAGA,SAAgB,eAAkB,MAAY;CAC5C,OAAO;AACT;;AAGA,SAAgB,eAAkB,MAAY;CAC5C,OAAO;AACT;;AAGA,SAAgB,sBAAyB,MAAY;CACnD,OAAO;AACT;;AAGA,SAAgB,WAAc,MAAY;CACxC,OAAO;AACT;;AAGA,SAAgB,cAAqC,MAAY;CAC/D,OAAO;AACT;;AAEA,SAAgB,WAA+B,MAAsD;CACnG,OAAO,OAAO,SAAS,cAClB,aAAa;EAAE,MAAM;EAAiB,GAAG,KAAK,OAAO;CAAE,KACxD;EAAE,MAAM;EAAiB,GAAG;CAAK;AACvC;;AAGA,SAAgB,iBACd,MACuC;CACvC,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,WAAuC,MAA8D;CACnH,OAAO;AACT;;;;;;;;AASA,SAAgB,iBACd,GAAG,OACuC;CAC1C,MAAM,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ;CACpC,OAAO;EACL,MAAM,QAAQ,SAAS;GACrB,KAAK,MAAM,QAAQ,OAAO,MAAM,KAAK,UAAU,OAAO;EACxD;EACA,MAAM,OAAO,SAAS;GACpB,KAAK,MAAM,QAAQ,UAAU,MAAM,KAAK,SAAS,OAAO;EAC1D;EACA,MAAM,UAAU,SAAS;GACvB,KAAK,MAAM,QAAQ,UAAU,MAAM,KAAK,YAAY,OAAO;EAC7D;CACF;AACF;;AAGA,SAAgB,cAAkC,MAAoD;CACpG,OAAO;AACT;;AAGA,SAAgB,iBAAqC,MAA0D;CAC7G,OAAO;AACT;;AAGA,SAAgB,oBACd,MAC6B;CAC7B,OAAO;AACT;;AAGA,SAAgB,cAAkC,MAA4D;CAC5G,OAAO,OAAO,SAAS,cAClB,aAAa;EAAE,MAAM;EAAoB,GAAG,KAAK,OAAO;CAAE,KAC3D;EAAE,MAAM;EAAoB,GAAG;CAAK;AAC1C;;AAGA,SAAgB,cACd,MACuC;CACvC,OAAO;AACT;;AAGA,SAAgB,WACd,MAC4B;CAC5B,OAAO;AACT;;AAGA,SAAgB,cAAkC,MAAoD;CACpG,OAAO;AACT;;AAGA,SAAgB,cAAc,MAAgC;CAC5D,OAAO;AACT;;AAGA,SAAgB,YAAgC,MAAgD;CAC9F,OAAO;AACT;;AAGA,SAAgB,aAAiC,MAAkD;CACjG,OAAO;AACT;;AAGA,SAAgB,eAAmC,MAAsD;CACvG,OAAO;AACT"}

package/dist/src/extensions/serverPlugin.cjs

@@ -0,0 +1,106 @@
+const require_headless = require("../schemas/headless.cjs");
+const require_serverFacet = require("../schemas/serverFacet.cjs");
+const require_index = require("../services/pluginLifecycle/index.cjs");
+//#region src/extensions/serverPlugin.ts
+function defineServerPlugin(plugin) {
+	return {
+		inject: [.../* @__PURE__ */ new Set([require_serverFacet.DOOM_SERVER_HOST_SERVICE, ...plugin.inject ?? []])],
+		async apply(context) {
+			const host = require_serverFacet.requireDoomServerHost(context);
+			const declaration = plugin[host.scope];
+			if (!declaration) return;
+			const agent = host.scope === "session" ? require_headless.readDoomHeadlessHost(context) : void 0;
+			const lifecycle = require_index.createPluginLifecycle((signal) => ({
+				context,
+				host,
+				agent,
+				signal
+			}));
+			context.effect(() => () => lifecycle.dispose());
+			const own = (registration) => {
+				lifecycle.own(() => registration.dispose());
+				if ("mounted" in registration && registration.mounted === false) throw new Error("Server plugin registration was refused.");
+			};
+			await lifecycle.mount(() => typeof declaration === "function" ? declaration(lifecycle.context) : declaration, async (scope) => {
+				for (const service of scope.services ?? []) {
+					const fiber = context.plugin(service);
+					lifecycle.own(() => fiber.dispose());
+					await fiber;
+				}
+				for (const channel of scope.channels ?? []) own(host.registerChannel(channel()));
+				for (const api of scope.api ?? []) own(host.registerApi(api));
+				for (const method of scope.methods ?? []) own(method.register(host));
+				if (!agent) return;
+				const session = scope;
+				for (const restriction of session.toolRestrictions ?? []) {
+					if (!("restrict" in restriction)) {
+						own(agent.registerToolRestriction(restriction));
+						continue;
+					}
+					let registration;
+					lifecycle.own(() => {
+						const current = registration;
+						registration = void 0;
+						return current?.dispose();
+					});
+					const refresh = () => {
+						if (lifecycle.context.signal.aborted) return;
+						const previous = registration;
+						registration = void 0;
+						previous?.dispose();
+						registration = agent.registerToolRestriction(restriction.restrict());
+						if ("mounted" in registration && registration.mounted === false) throw new Error(`Server tool restriction ${restriction.source} was refused.`);
+					};
+					refresh();
+					const unsubscribe = restriction.subscribe?.(refresh);
+					if (unsubscribe) lifecycle.own(unsubscribe);
+				}
+				for (const resource of session.resources ?? []) if (resource !== void 0) own(agent.registerResource(resource));
+				for (const tool of session.tools ?? []) if ("kind" in tool) own(agent.registerTool({
+					...tool,
+					async execute(toolCallId, input, signal, update, execution) {
+						const invocationSignal = signal ? AbortSignal.any([signal, lifecycle.context.signal]) : lifecycle.context.signal;
+						invocationSignal.throwIfAborted();
+						try {
+							return await tool.execute(input, {
+								toolCallId,
+								signal: invocationSignal,
+								cwd: execution.cwd,
+								update: (result) => update?.(result),
+								notify: (request) => execution.client.notify(request)
+							});
+						} catch (error) {
+							return {
+								content: [{
+									type: "text",
+									text: error instanceof Error ? error.message : String(error)
+								}],
+								isError: true
+							};
+						}
+					}
+				}));
+				else own(agent.registerTool(tool));
+				for (const command of session.commands ?? []) if ("kind" in command) own(agent.registerCommand({
+					...command,
+					execute: (args, execution) => {
+						lifecycle.context.signal.throwIfAborted();
+						return command.execute(args, {
+							cwd: execution.cwd,
+							signal: lifecycle.context.signal,
+							notify: (request) => execution.client.notify(request)
+						});
+					}
+				}));
+				else own(agent.registerCommand(command));
+				for (const hook of session.hooks ?? []) own(agent.registerHook(hook));
+				for (const activity of session.activities ?? []) own(agent.registerActivity(activity));
+			});
+			return () => lifecycle.dispose();
+		}
+	};
+}
+//#endregion
+exports.defineServerPlugin = defineServerPlugin;
+
+//# sourceMappingURL=serverPlugin.cjs.map

package/dist/src/extensions/serverPlugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverPlugin.cjs","names":["DOOM_SERVER_HOST_SERVICE","requireDoomServerHost","readDoomHeadlessHost","createPluginLifecycle"],"sources":["../../../src/extensions/serverPlugin.ts"],"sourcesContent":["import { readDoomHeadlessHost } from '../schemas/headless';\nimport {\n  DOOM_SERVER_HOST_SERVICE,\n  requireDoomServerHost,\n  type DoomServerFacet,\n  type DoomServerPluginDefinition,\n  type DoomServerPluginContext,\n  type DoomServerSessionPlugin,\n} from '../schemas/serverFacet';\nimport { createPluginLifecycle } from '../services/pluginLifecycle';\n\nexport function defineServerPlugin(plugin: DoomServerPluginDefinition): DoomServerFacet {\n  return {\n    inject: [...new Set([DOOM_SERVER_HOST_SERVICE, ...(plugin.inject ?? [])])],\n    async apply(context) {\n      const host = requireDoomServerHost(context);\n      const declaration = plugin[host.scope];\n      if (!declaration) return;\n      const agent = host.scope === 'session' ? readDoomHeadlessHost(context) : undefined;\n      const lifecycle = createPluginLifecycle<DoomServerPluginContext>((signal) => ({ context, host, agent, signal }));\n      context.effect(() => () => lifecycle.dispose());\n      const own = <T extends { dispose(): void | Promise<void>; mounted?: boolean }>(registration: T): void => {\n        lifecycle.own(() => registration.dispose());\n        if ('mounted' in registration && registration.mounted === false)\n          throw new Error('Server plugin registration was refused.');\n      };\n      await lifecycle.mount(\n        () => (typeof declaration === 'function' ? declaration(lifecycle.context) : declaration),\n        async (scope) => {\n          for (const service of scope.services ?? []) {\n            const fiber = context.plugin(service);\n            lifecycle.own(() => fiber.dispose());\n            await fiber;\n          }\n          for (const channel of scope.channels ?? []) own(host.registerChannel(channel()));\n          for (const api of scope.api ?? []) own(host.registerApi(api));\n          for (const method of scope.methods ?? []) own(method.register(host));\n          if (!agent) return;\n          const session: DoomServerSessionPlugin = scope;\n          for (const restriction of session.toolRestrictions ?? []) {\n            if (!('restrict' in restriction)) {\n              own(agent.registerToolRestriction(restriction));\n              continue;\n            }\n            let registration: ReturnType<typeof agent.registerToolRestriction> | undefined;\n            lifecycle.own(() => {\n              const current = registration;\n              registration = undefined;\n              return current?.dispose();\n            });\n            const refresh = (): void => {\n              if (lifecycle.context.signal.aborted) return;\n              const previous = registration;\n              registration = undefined;\n              previous?.dispose();\n              registration = agent.registerToolRestriction(restriction.restrict());\n              if ('mounted' in registration && registration.mounted === false)\n                throw new Error(`Server tool restriction ${restriction.source} was refused.`);\n            };\n            refresh();\n            const unsubscribe = restriction.subscribe?.(refresh);\n            if (unsubscribe) lifecycle.own(unsubscribe);\n          }\n          for (const resource of session.resources ?? []) {\n            // Generated optional and many-valued contributions can leave an undefined\n            // member when a package has no resource for the current runtime.\n            if (resource !== undefined) own(agent.registerResource(resource));\n          }\n          for (const tool of session.tools ?? []) {\n            if ('kind' in tool) {\n              own(\n                agent.registerTool({\n                  ...tool,\n                  async execute(toolCallId, input, signal, update, execution) {\n                    const invocationSignal = signal\n                      ? AbortSignal.any([signal, lifecycle.context.signal])\n                      : lifecycle.context.signal;\n                    invocationSignal.throwIfAborted();\n                    try {\n                      return await tool.execute(input, {\n                        toolCallId,\n                        signal: invocationSignal,\n                        cwd: execution.cwd,\n                        update: (result) => update?.(result),\n                        notify: (request) => execution.client.notify(request),\n                      });\n                    } catch (error) {\n                      return {\n                        content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }],\n                        isError: true,\n                      };\n                    }\n                  },\n                }),\n              );\n            } else own(agent.registerTool(tool));\n          }\n          for (const command of session.commands ?? []) {\n            if ('kind' in command) {\n              own(\n                agent.registerCommand({\n                  ...command,\n                  execute: (args, execution) => {\n                    lifecycle.context.signal.throwIfAborted();\n                    return command.execute(args, {\n                      cwd: execution.cwd,\n                      signal: lifecycle.context.signal,\n                      notify: (request) => execution.client.notify(request),\n                    });\n                  },\n                }),\n              );\n            } else own(agent.registerCommand(command));\n          }\n          for (const hook of session.hooks ?? []) own(agent.registerHook(hook));\n          for (const activity of session.activities ?? []) own(agent.registerActivity(activity));\n        },\n      );\n      return () => lifecycle.dispose();\n    },\n  };\n}\n"],"mappings":";;;;AAWA,SAAgB,mBAAmB,QAAqD;CACtF,OAAO;EACL,QAAQ,CAAC,mBAAG,IAAI,IAAI,CAACA,oBAAAA,0BAA0B,GAAI,OAAO,UAAU,CAAC,CAAE,CAAC,CAAC;EACzE,MAAM,MAAM,SAAS;GACnB,MAAM,OAAOC,oBAAAA,sBAAsB,OAAO;GAC1C,MAAM,cAAc,OAAO,KAAK;GAChC,IAAI,CAAC,aAAa;GAClB,MAAM,QAAQ,KAAK,UAAU,YAAYC,iBAAAA,qBAAqB,OAAO,IAAI,KAAA;GACzE,MAAM,YAAYC,cAAAA,uBAAgD,YAAY;IAAE;IAAS;IAAM;IAAO;GAAO,EAAE;GAC/G,QAAQ,mBAAmB,UAAU,QAAQ,CAAC;GAC9C,MAAM,OAAyE,iBAA0B;IACvG,UAAU,UAAU,aAAa,QAAQ,CAAC;IAC1C,IAAI,aAAa,gBAAgB,aAAa,YAAY,OACxD,MAAM,IAAI,MAAM,yCAAyC;GAC7D;GACA,MAAM,UAAU,YACP,OAAO,gBAAgB,aAAa,YAAY,UAAU,OAAO,IAAI,aAC5E,OAAO,UAAU;IACf,KAAK,MAAM,WAAW,MAAM,YAAY,CAAC,GAAG;KAC1C,MAAM,QAAQ,QAAQ,OAAO,OAAO;KACpC,UAAU,UAAU,MAAM,QAAQ,CAAC;KACnC,MAAM;IACR;IACA,KAAK,MAAM,WAAW,MAAM,YAAY,CAAC,GAAG,IAAI,KAAK,gBAAgB,QAAQ,CAAC,CAAC;IAC/E,KAAK,MAAM,OAAO,MAAM,OAAO,CAAC,GAAG,IAAI,KAAK,YAAY,GAAG,CAAC;IAC5D,KAAK,MAAM,UAAU,MAAM,WAAW,CAAC,GAAG,IAAI,OAAO,SAAS,IAAI,CAAC;IACnE,IAAI,CAAC,OAAO;IACZ,MAAM,UAAmC;IACzC,KAAK,MAAM,eAAe,QAAQ,oBAAoB,CAAC,GAAG;KACxD,IAAI,EAAE,cAAc,cAAc;MAChC,IAAI,MAAM,wBAAwB,WAAW,CAAC;MAC9C;KACF;KACA,IAAI;KACJ,UAAU,UAAU;MAClB,MAAM,UAAU;MAChB,eAAe,KAAA;MACf,OAAO,SAAS,QAAQ;KAC1B,CAAC;KACD,MAAM,gBAAsB;MAC1B,IAAI,UAAU,QAAQ,OAAO,SAAS;MACtC,MAAM,WAAW;MACjB,eAAe,KAAA;MACf,UAAU,QAAQ;MAClB,eAAe,MAAM,wBAAwB,YAAY,SAAS,CAAC;MACnE,IAAI,aAAa,gBAAgB,aAAa,YAAY,OACxD,MAAM,IAAI,MAAM,2BAA2B,YAAY,OAAO,cAAc;KAChF;KACA,QAAQ;KACR,MAAM,cAAc,YAAY,YAAY,OAAO;KACnD,IAAI,aAAa,UAAU,IAAI,WAAW;IAC5C;IACA,KAAK,MAAM,YAAY,QAAQ,aAAa,CAAC,GAG3C,IAAI,aAAa,KAAA,GAAW,IAAI,MAAM,iBAAiB,QAAQ,CAAC;IAElE,KAAK,MAAM,QAAQ,QAAQ,SAAS,CAAC,GACnC,IAAI,UAAU,MACZ,IACE,MAAM,aAAa;KACjB,GAAG;KACH,MAAM,QAAQ,YAAY,OAAO,QAAQ,QAAQ,WAAW;MAC1D,MAAM,mBAAmB,SACrB,YAAY,IAAI,CAAC,QAAQ,UAAU,QAAQ,MAAM,CAAC,IAClD,UAAU,QAAQ;MACtB,iBAAiB,eAAe;MAChC,IAAI;OACF,OAAO,MAAM,KAAK,QAAQ,OAAO;QAC/B;QACA,QAAQ;QACR,KAAK,UAAU;QACf,SAAS,WAAW,SAAS,MAAM;QACnC,SAAS,YAAY,UAAU,OAAO,OAAO,OAAO;OACtD,CAAC;MACH,SAAS,OAAO;OACd,OAAO;QACL,SAAS,CAAC;SAAE,MAAM;SAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;QAAE,CAAC;QACxF,SAAS;OACX;MACF;KACF;IACF,CAAC,CACH;SACK,IAAI,MAAM,aAAa,IAAI,CAAC;IAErC,KAAK,MAAM,WAAW,QAAQ,YAAY,CAAC,GACzC,IAAI,UAAU,SACZ,IACE,MAAM,gBAAgB;KACpB,GAAG;KACH,UAAU,MAAM,cAAc;MAC5B,UAAU,QAAQ,OAAO,eAAe;MACxC,OAAO,QAAQ,QAAQ,MAAM;OAC3B,KAAK,UAAU;OACf,QAAQ,UAAU,QAAQ;OAC1B,SAAS,YAAY,UAAU,OAAO,OAAO,OAAO;MACtD,CAAC;KACH;IACF,CAAC,CACH;SACK,IAAI,MAAM,gBAAgB,OAAO,CAAC;IAE3C,KAAK,MAAM,QAAQ,QAAQ,SAAS,CAAC,GAAG,IAAI,MAAM,aAAa,IAAI,CAAC;IACpE,KAAK,MAAM,YAAY,QAAQ,cAAc,CAAC,GAAG,IAAI,MAAM,iBAAiB,QAAQ,CAAC;GACvF,CACF;GACA,aAAa,UAAU,QAAQ;EACjC;CACF;AACF"}

package/dist/src/extensions/serverPlugin.d.mts

@@ -0,0 +1,5 @@
+import { DoomServerFacet, DoomServerPluginDefinition } from "../schemas/serverFacet.mjs";
+//#region src/extensions/serverPlugin.d.ts
+export declare function defineServerPlugin(plugin: DoomServerPluginDefinition): DoomServerFacet;
+//#endregion
+//# sourceMappingURL=serverPlugin.d.mts.map

package/dist/src/extensions/serverPlugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverPlugin.d.mts","names":[],"sources":["../../../src/extensions/serverPlugin.ts"],"mappings":";;wBAWgB,mBAAmB,QAAQ,6BAA6B"}

package/dist/src/extensions/serverPlugin.mjs

@@ -0,0 +1,106 @@
+import { readDoomHeadlessHost } from "../schemas/headless.mjs";
+import { DOOM_SERVER_HOST_SERVICE, requireDoomServerHost } from "../schemas/serverFacet.mjs";
+import { createPluginLifecycle } from "../services/pluginLifecycle/index.mjs";
+//#region src/extensions/serverPlugin.ts
+function defineServerPlugin(plugin) {
+	return {
+		inject: [.../* @__PURE__ */ new Set([DOOM_SERVER_HOST_SERVICE, ...plugin.inject ?? []])],
+		async apply(context) {
+			const host = requireDoomServerHost(context);
+			const declaration = plugin[host.scope];
+			if (!declaration) return;
+			const agent = host.scope === "session" ? readDoomHeadlessHost(context) : void 0;
+			const lifecycle = createPluginLifecycle((signal) => ({
+				context,
+				host,
+				agent,
+				signal
+			}));
+			context.effect(() => () => lifecycle.dispose());
+			const own = (registration) => {
+				lifecycle.own(() => registration.dispose());
+				if ("mounted" in registration && registration.mounted === false) throw new Error("Server plugin registration was refused.");
+			};
+			await lifecycle.mount(() => typeof declaration === "function" ? declaration(lifecycle.context) : declaration, async (scope) => {
+				for (const service of scope.services ?? []) {
+					const fiber = context.plugin(service);
+					lifecycle.own(() => fiber.dispose());
+					await fiber;
+				}
+				for (const channel of scope.channels ?? []) own(host.registerChannel(channel()));
+				for (const api of scope.api ?? []) own(host.registerApi(api));
+				for (const method of scope.methods ?? []) own(method.register(host));
+				if (!agent) return;
+				const session = scope;
+				for (const restriction of session.toolRestrictions ?? []) {
+					if (!("restrict" in restriction)) {
+						own(agent.registerToolRestriction(restriction));
+						continue;
+					}
+					let registration;
+					lifecycle.own(() => {
+						const current = registration;
+						registration = void 0;
+						return current?.dispose();
+					});
+					const refresh = () => {
+						if (lifecycle.context.signal.aborted) return;
+						const previous = registration;
+						registration = void 0;
+						previous?.dispose();
+						registration = agent.registerToolRestriction(restriction.restrict());
+						if ("mounted" in registration && registration.mounted === false) throw new Error(`Server tool restriction ${restriction.source} was refused.`);
+					};
+					refresh();
+					const unsubscribe = restriction.subscribe?.(refresh);
+					if (unsubscribe) lifecycle.own(unsubscribe);
+				}
+				for (const resource of session.resources ?? []) if (resource !== void 0) own(agent.registerResource(resource));
+				for (const tool of session.tools ?? []) if ("kind" in tool) own(agent.registerTool({
+					...tool,
+					async execute(toolCallId, input, signal, update, execution) {
+						const invocationSignal = signal ? AbortSignal.any([signal, lifecycle.context.signal]) : lifecycle.context.signal;
+						invocationSignal.throwIfAborted();
+						try {
+							return await tool.execute(input, {
+								toolCallId,
+								signal: invocationSignal,
+								cwd: execution.cwd,
+								update: (result) => update?.(result),
+								notify: (request) => execution.client.notify(request)
+							});
+						} catch (error) {
+							return {
+								content: [{
+									type: "text",
+									text: error instanceof Error ? error.message : String(error)
+								}],
+								isError: true
+							};
+						}
+					}
+				}));
+				else own(agent.registerTool(tool));
+				for (const command of session.commands ?? []) if ("kind" in command) own(agent.registerCommand({
+					...command,
+					execute: (args, execution) => {
+						lifecycle.context.signal.throwIfAborted();
+						return command.execute(args, {
+							cwd: execution.cwd,
+							signal: lifecycle.context.signal,
+							notify: (request) => execution.client.notify(request)
+						});
+					}
+				}));
+				else own(agent.registerCommand(command));
+				for (const hook of session.hooks ?? []) own(agent.registerHook(hook));
+				for (const activity of session.activities ?? []) own(agent.registerActivity(activity));
+			});
+			return () => lifecycle.dispose();
+		}
+	};
+}
+//#endregion
+export { defineServerPlugin };
+
+//# sourceMappingURL=serverPlugin.mjs.map

package/dist/src/extensions/serverPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverPlugin.mjs","names":[],"sources":["../../../src/extensions/serverPlugin.ts"],"sourcesContent":["import { readDoomHeadlessHost } from '../schemas/headless';\nimport {\n  DOOM_SERVER_HOST_SERVICE,\n  requireDoomServerHost,\n  type DoomServerFacet,\n  type DoomServerPluginDefinition,\n  type DoomServerPluginContext,\n  type DoomServerSessionPlugin,\n} from '../schemas/serverFacet';\nimport { createPluginLifecycle } from '../services/pluginLifecycle';\n\nexport function defineServerPlugin(plugin: DoomServerPluginDefinition): DoomServerFacet {\n  return {\n    inject: [...new Set([DOOM_SERVER_HOST_SERVICE, ...(plugin.inject ?? [])])],\n    async apply(context) {\n      const host = requireDoomServerHost(context);\n      const declaration = plugin[host.scope];\n      if (!declaration) return;\n      const agent = host.scope === 'session' ? readDoomHeadlessHost(context) : undefined;\n      const lifecycle = createPluginLifecycle<DoomServerPluginContext>((signal) => ({ context, host, agent, signal }));\n      context.effect(() => () => lifecycle.dispose());\n      const own = <T extends { dispose(): void | Promise<void>; mounted?: boolean }>(registration: T): void => {\n        lifecycle.own(() => registration.dispose());\n        if ('mounted' in registration && registration.mounted === false)\n          throw new Error('Server plugin registration was refused.');\n      };\n      await lifecycle.mount(\n        () => (typeof declaration === 'function' ? declaration(lifecycle.context) : declaration),\n        async (scope) => {\n          for (const service of scope.services ?? []) {\n            const fiber = context.plugin(service);\n            lifecycle.own(() => fiber.dispose());\n            await fiber;\n          }\n          for (const channel of scope.channels ?? []) own(host.registerChannel(channel()));\n          for (const api of scope.api ?? []) own(host.registerApi(api));\n          for (const method of scope.methods ?? []) own(method.register(host));\n          if (!agent) return;\n          const session: DoomServerSessionPlugin = scope;\n          for (const restriction of session.toolRestrictions ?? []) {\n            if (!('restrict' in restriction)) {\n              own(agent.registerToolRestriction(restriction));\n              continue;\n            }\n            let registration: ReturnType<typeof agent.registerToolRestriction> | undefined;\n            lifecycle.own(() => {\n              const current = registration;\n              registration = undefined;\n              return current?.dispose();\n            });\n            const refresh = (): void => {\n              if (lifecycle.context.signal.aborted) return;\n              const previous = registration;\n              registration = undefined;\n              previous?.dispose();\n              registration = agent.registerToolRestriction(restriction.restrict());\n              if ('mounted' in registration && registration.mounted === false)\n                throw new Error(`Server tool restriction ${restriction.source} was refused.`);\n            };\n            refresh();\n            const unsubscribe = restriction.subscribe?.(refresh);\n            if (unsubscribe) lifecycle.own(unsubscribe);\n          }\n          for (const resource of session.resources ?? []) {\n            // Generated optional and many-valued contributions can leave an undefined\n            // member when a package has no resource for the current runtime.\n            if (resource !== undefined) own(agent.registerResource(resource));\n          }\n          for (const tool of session.tools ?? []) {\n            if ('kind' in tool) {\n              own(\n                agent.registerTool({\n                  ...tool,\n                  async execute(toolCallId, input, signal, update, execution) {\n                    const invocationSignal = signal\n                      ? AbortSignal.any([signal, lifecycle.context.signal])\n                      : lifecycle.context.signal;\n                    invocationSignal.throwIfAborted();\n                    try {\n                      return await tool.execute(input, {\n                        toolCallId,\n                        signal: invocationSignal,\n                        cwd: execution.cwd,\n                        update: (result) => update?.(result),\n                        notify: (request) => execution.client.notify(request),\n                      });\n                    } catch (error) {\n                      return {\n                        content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }],\n                        isError: true,\n                      };\n                    }\n                  },\n                }),\n              );\n            } else own(agent.registerTool(tool));\n          }\n          for (const command of session.commands ?? []) {\n            if ('kind' in command) {\n              own(\n                agent.registerCommand({\n                  ...command,\n                  execute: (args, execution) => {\n                    lifecycle.context.signal.throwIfAborted();\n                    return command.execute(args, {\n                      cwd: execution.cwd,\n                      signal: lifecycle.context.signal,\n                      notify: (request) => execution.client.notify(request),\n                    });\n                  },\n                }),\n              );\n            } else own(agent.registerCommand(command));\n          }\n          for (const hook of session.hooks ?? []) own(agent.registerHook(hook));\n          for (const activity of session.activities ?? []) own(agent.registerActivity(activity));\n        },\n      );\n      return () => lifecycle.dispose();\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/extensions/webPlugin.cjs

@@ -0,0 +1,131 @@
+//#region src/extensions/webPlugin.ts
+/** Identity helper so plugin modules get checked literals without a type annotation. */
+function defineWebPlugin(plugin) {
+	return plugin;
+}
+/**
+* The one audited erasure from Payload to unknown. Channels are stored
+* untyped in the host registry; the payload type lives entirely inside the
+* plugin, behind its own parse gate.
+*/
+function defineSessionChannel(channel) {
+	return channel;
+}
+/**
+* Identity helper for a typed slot handle: the owner keeps the
+* SlotDeclaration<Data> to read its fills back through slotData, and the
+* plugin's `slots` array holds it erased. No cast is needed because Data only
+* appears in the parse gate's return position.
+*/
+function defineSlot(slot) {
+	return slot;
+}
+/**
+* Identity helpers for folder-routed frontend files, one per surface.
+*
+* Each returns its argument unchanged. The value is the position they check
+* and the inference they supply, which is otherwise absent: a routed file's
+* default export reaches a contribution array through a generated entry that
+* types it as unknown.
+*/
+/** `tool/<name>.tsx`. The filename names the tool this renders. */
+function defineToolRenderer(file) {
+	return file;
+}
+/** `command/<name>.tsx`. */
+function definePaletteCommand(file) {
+	return file;
+}
+/** `tab/<Name>.tsx`. */
+function defineTab(file) {
+	return file;
+}
+/** `template/<name>.web.ts`. Declares a selectable browser layout. */
+function defineWebTemplate(file) {
+	return file;
+}
+/** `dock/<Name>.tsx`. */
+function defineDockFace(file) {
+	return file;
+}
+/** `setting/<name>.tsx` declaring fields the host renders. */
+function defineSettingsSection(file) {
+	return file;
+}
+/** `setting/<name>.tsx` drawing its own page. */
+function defineSettingsPanel(file) {
+	return file;
+}
+/** `slot/<name>.ts`. The slot is namespaced as `<pluginId>.<name>`. */
+function defineSlotFile(file) {
+	return file;
+}
+/** `fill/<Name>.<target>.tsx`. */
+function defineFill(file) {
+	return file;
+}
+/** `action/<name>.ts` for a context item kind. */
+function defineContextAction(file) {
+	return file;
+}
+/** `action/<name>.ts` for a user timeline message. */
+function defineUserMessageAction(file) {
+	return file;
+}
+/** `mode/<name>/mode.ts`. */
+function defineMinorModeFile(file) {
+	return file;
+}
+/** `activity-group/<name>.ts`. The filename names the group and its slot. */
+function defineActivityGroup(file) {
+	return file;
+}
+/** `leader/<name>.ts`. */
+function defineLeaderBinding(file) {
+	return file;
+}
+/** `channel/<frameType>.ts`. */
+function defineChannelFile(file) {
+	return file;
+}
+/** `file-links/<name>.ts`. Declares the scope's singleton file-link source. */
+function defineFileLinks(file) {
+	return file;
+}
+/** `repository-settings-panel/<name>.tsx`. Declares the workspace settings panel. */
+function defineRepositorySettingsPanel(file) {
+	return file;
+}
+/** `selection-axis/<name>.ts`. */
+function defineSelectionAxis(file) {
+	return file;
+}
+/** `lifecycle/start.ts`. Declares the frontend start lifecycle. */
+function defineWebLifecycle(file) {
+	return file;
+}
+//#endregion
+exports.defineActivityGroup = defineActivityGroup;
+exports.defineChannelFile = defineChannelFile;
+exports.defineContextAction = defineContextAction;
+exports.defineDockFace = defineDockFace;
+exports.defineFileLinks = defineFileLinks;
+exports.defineFill = defineFill;
+exports.defineLeaderBinding = defineLeaderBinding;
+exports.defineMinorModeFile = defineMinorModeFile;
+exports.definePaletteCommand = definePaletteCommand;
+exports.defineRepositorySettingsPanel = defineRepositorySettingsPanel;
+exports.defineSelectionAxis = defineSelectionAxis;
+exports.defineSessionChannel = defineSessionChannel;
+exports.defineSettingsPanel = defineSettingsPanel;
+exports.defineSettingsSection = defineSettingsSection;
+exports.defineSlot = defineSlot;
+exports.defineSlotFile = defineSlotFile;
+exports.defineTab = defineTab;
+exports.defineToolRenderer = defineToolRenderer;
+exports.defineUserMessageAction = defineUserMessageAction;
+exports.defineWebLifecycle = defineWebLifecycle;
+exports.defineWebPlugin = defineWebPlugin;
+exports.defineWebTemplate = defineWebTemplate;
+
+//# sourceMappingURL=webPlugin.cjs.map

package/dist/src/extensions/webPlugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPlugin.cjs","names":[],"sources":["../../../src/extensions/webPlugin.ts"],"sourcesContent":["import type {\n  ActivityGroupFile,\n  ChannelFile,\n  ContextActionFile,\n  DockFaceFile,\n  FillFile,\n  LeaderBindingFile,\n  MinorModeFile,\n  PaletteCommandFile,\n  SelectionAxisFile,\n  SettingsPanelFile,\n  SettingsSectionFile,\n  SlotFile,\n  TabFile,\n  ToolRendererFile,\n  UserMessageActionFile,\n  WebTemplateFile,\n} from '../web/types/extensionFile';\nimport type {\n  FileLinkSource,\n  RepositorySettingsPanelContribution,\n  SessionChannelContribution,\n  SlotDeclaration,\n  WebPluginContributions,\n  WebPluginDefinition,\n} from '../web/types/webPlugin';\n\n/** Identity helper so plugin modules get checked literals without a type annotation. */\nexport function defineWebPlugin(plugin: WebPluginDefinition): WebPluginDefinition {\n  return plugin;\n}\n\n/**\n * The one audited erasure from Payload to unknown. Channels are stored\n * untyped in the host registry; the payload type lives entirely inside the\n * plugin, behind its own parse gate.\n */\nexport function defineSessionChannel<Payload>(\n  channel: SessionChannelContribution<Payload>,\n): SessionChannelContribution {\n  return channel as SessionChannelContribution;\n}\n\n/**\n * Identity helper for a typed slot handle: the owner keeps the\n * SlotDeclaration<Data> to read its fills back through slotData, and the\n * plugin's `slots` array holds it erased. No cast is needed because Data only\n * appears in the parse gate's return position.\n */\nexport function defineSlot<Data>(slot: SlotDeclaration<Data>): SlotDeclaration<Data> {\n  return slot;\n}\n\n/**\n * Identity helpers for folder-routed frontend files, one per surface.\n *\n * Each returns its argument unchanged. The value is the position they check\n * and the inference they supply, which is otherwise absent: a routed file's\n * default export reaches a contribution array through a generated entry that\n * types it as unknown.\n */\n\n/** `tool/<name>.tsx`. The filename names the tool this renders. */\nexport function defineToolRenderer(file: ToolRendererFile): ToolRendererFile {\n  return file;\n}\n\n/** `command/<name>.tsx`. */\nexport function definePaletteCommand(file: PaletteCommandFile): PaletteCommandFile {\n  return file;\n}\n\n/** `tab/<Name>.tsx`. */\nexport function defineTab(file: TabFile): TabFile {\n  return file;\n}\n\n/** `template/<name>.web.ts`. Declares a selectable browser layout. */\nexport function defineWebTemplate(file: WebTemplateFile): WebTemplateFile {\n  return file;\n}\n/** `dock/<Name>.tsx`. */\nexport function defineDockFace(file: DockFaceFile): DockFaceFile {\n  return file;\n}\n\n/** `setting/<name>.tsx` declaring fields the host renders. */\nexport function defineSettingsSection(file: SettingsSectionFile): SettingsSectionFile {\n  return file;\n}\n\n/** `setting/<name>.tsx` drawing its own page. */\nexport function defineSettingsPanel(file: SettingsPanelFile): SettingsPanelFile {\n  return file;\n}\n\n/** `slot/<name>.ts`. The slot is namespaced as `<pluginId>.<name>`. */\nexport function defineSlotFile<Data = unknown>(file: SlotFile<Data>): SlotFile<Data> {\n  return file;\n}\n\n/** `fill/<Name>.<target>.tsx`. */\nexport function defineFill(file: FillFile): FillFile {\n  return file;\n}\n\n/** `action/<name>.ts` for a context item kind. */\nexport function defineContextAction(file: ContextActionFile): ContextActionFile {\n  return file;\n}\n\n/** `action/<name>.ts` for a user timeline message. */\nexport function defineUserMessageAction(file: UserMessageActionFile): UserMessageActionFile {\n  return file;\n}\n\n/** `mode/<name>/mode.ts`. */\nexport function defineMinorModeFile(file: MinorModeFile): MinorModeFile {\n  return file;\n}\n\n/** `activity-group/<name>.ts`. The filename names the group and its slot. */\nexport function defineActivityGroup(file: ActivityGroupFile): ActivityGroupFile {\n  return file;\n}\n\n/** `leader/<name>.ts`. */\nexport function defineLeaderBinding(file: LeaderBindingFile): LeaderBindingFile {\n  return file;\n}\n\n/** `channel/<frameType>.ts`. */\nexport function defineChannelFile<Payload = unknown>(file: ChannelFile<Payload>): ChannelFile<Payload> {\n  return file;\n}\n\n/** `file-links/<name>.ts`. Declares the scope's singleton file-link source. */\nexport function defineFileLinks(file: FileLinkSource): FileLinkSource {\n  return file;\n}\n\n/** `repository-settings-panel/<name>.tsx`. Declares the workspace settings panel. */\nexport function defineRepositorySettingsPanel(\n  file: RepositorySettingsPanelContribution,\n): RepositorySettingsPanelContribution {\n  return file;\n}\n\n/** `selection-axis/<name>.ts`. */\nexport function defineSelectionAxis(file: SelectionAxisFile): SelectionAxisFile {\n  return file;\n}\n\n/** `lifecycle/start.ts`. Declares the frontend start lifecycle. */\nexport function defineWebLifecycle(\n  file: NonNullable<WebPluginContributions['start']>,\n): NonNullable<WebPluginContributions['start']> {\n  return file;\n}\n"],"mappings":";;AA4BA,SAAgB,gBAAgB,QAAkD;CAChF,OAAO;AACT;;;;;;AAOA,SAAgB,qBACd,SAC4B;CAC5B,OAAO;AACT;;;;;;;AAQA,SAAgB,WAAiB,MAAoD;CACnF,OAAO;AACT;;;;;;;;;;AAYA,SAAgB,mBAAmB,MAA0C;CAC3E,OAAO;AACT;;AAGA,SAAgB,qBAAqB,MAA8C;CACjF,OAAO;AACT;;AAGA,SAAgB,UAAU,MAAwB;CAChD,OAAO;AACT;;AAGA,SAAgB,kBAAkB,MAAwC;CACxE,OAAO;AACT;;AAEA,SAAgB,eAAe,MAAkC;CAC/D,OAAO;AACT;;AAGA,SAAgB,sBAAsB,MAAgD;CACpF,OAAO;AACT;;AAGA,SAAgB,oBAAoB,MAA4C;CAC9E,OAAO;AACT;;AAGA,SAAgB,eAA+B,MAAsC;CACnF,OAAO;AACT;;AAGA,SAAgB,WAAW,MAA0B;CACnD,OAAO;AACT;;AAGA,SAAgB,oBAAoB,MAA4C;CAC9E,OAAO;AACT;;AAGA,SAAgB,wBAAwB,MAAoD;CAC1F,OAAO;AACT;;AAGA,SAAgB,oBAAoB,MAAoC;CACtE,OAAO;AACT;;AAGA,SAAgB,oBAAoB,MAA4C;CAC9E,OAAO;AACT;;AAGA,SAAgB,oBAAoB,MAA4C;CAC9E,OAAO;AACT;;AAGA,SAAgB,kBAAqC,MAAkD;CACrG,OAAO;AACT;;AAGA,SAAgB,gBAAgB,MAAsC;CACpE,OAAO;AACT;;AAGA,SAAgB,8BACd,MACqC;CACrC,OAAO;AACT;;AAGA,SAAgB,oBAAoB,MAA4C;CAC9E,OAAO;AACT;;AAGA,SAAgB,mBACd,MAC8C;CAC9C,OAAO;AACT"}

package/dist/src/extensions/webPlugin.d.mts

@@ -0,0 +1,66 @@
+import { FileLinkSource, RepositorySettingsPanelContribution, SessionChannelContribution, SlotDeclaration, WebPluginContributions, WebPluginDefinition } from "../web/types/webPlugin.mjs";
+import { ActivityGroupFile, ChannelFile, ContextActionFile, DockFaceFile, FillFile, LeaderBindingFile, MinorModeFile, PaletteCommandFile, SelectionAxisFile, SettingsPanelFile, SettingsSectionFile, SlotFile, TabFile, ToolRendererFile, UserMessageActionFile, WebTemplateFile } from "../web/types/extensionFile.mjs";
+//#region src/extensions/webPlugin.d.ts
+/** Identity helper so plugin modules get checked literals without a type annotation. */
+export declare function defineWebPlugin(plugin: WebPluginDefinition): WebPluginDefinition;
+/**
+ * The one audited erasure from Payload to unknown. Channels are stored
+ * untyped in the host registry; the payload type lives entirely inside the
+ * plugin, behind its own parse gate.
+ */
+export declare function defineSessionChannel<Payload>(channel: SessionChannelContribution<Payload>): SessionChannelContribution;
+/**
+ * Identity helper for a typed slot handle: the owner keeps the
+ * SlotDeclaration<Data> to read its fills back through slotData, and the
+ * plugin's `slots` array holds it erased. No cast is needed because Data only
+ * appears in the parse gate's return position.
+ */
+export declare function defineSlot<Data>(slot: SlotDeclaration<Data>): SlotDeclaration<Data>;
+/**
+ * Identity helpers for folder-routed frontend files, one per surface.
+ *
+ * Each returns its argument unchanged. The value is the position they check
+ * and the inference they supply, which is otherwise absent: a routed file's
+ * default export reaches a contribution array through a generated entry that
+ * types it as unknown.
+ */
+/** `tool/<name>.tsx`. The filename names the tool this renders. */
+export declare function defineToolRenderer(file: ToolRendererFile): ToolRendererFile;
+/** `command/<name>.tsx`. */
+export declare function definePaletteCommand(file: PaletteCommandFile): PaletteCommandFile;
+/** `tab/<Name>.tsx`. */
+export declare function defineTab(file: TabFile): TabFile;
+/** `template/<name>.web.ts`. Declares a selectable browser layout. */
+export declare function defineWebTemplate(file: WebTemplateFile): WebTemplateFile;
+/** `dock/<Name>.tsx`. */
+export declare function defineDockFace(file: DockFaceFile): DockFaceFile;
+/** `setting/<name>.tsx` declaring fields the host renders. */
+export declare function defineSettingsSection(file: SettingsSectionFile): SettingsSectionFile;
+/** `setting/<name>.tsx` drawing its own page. */
+export declare function defineSettingsPanel(file: SettingsPanelFile): SettingsPanelFile;
+/** `slot/<name>.ts`. The slot is namespaced as `<pluginId>.<name>`. */
+export declare function defineSlotFile<Data = unknown>(file: SlotFile<Data>): SlotFile<Data>;
+/** `fill/<Name>.<target>.tsx`. */
+export declare function defineFill(file: FillFile): FillFile;
+/** `action/<name>.ts` for a context item kind. */
+export declare function defineContextAction(file: ContextActionFile): ContextActionFile;
+/** `action/<name>.ts` for a user timeline message. */
+export declare function defineUserMessageAction(file: UserMessageActionFile): UserMessageActionFile;
+/** `mode/<name>/mode.ts`. */
+export declare function defineMinorModeFile(file: MinorModeFile): MinorModeFile;
+/** `activity-group/<name>.ts`. The filename names the group and its slot. */
+export declare function defineActivityGroup(file: ActivityGroupFile): ActivityGroupFile;
+/** `leader/<name>.ts`. */
+export declare function defineLeaderBinding(file: LeaderBindingFile): LeaderBindingFile;
+/** `channel/<frameType>.ts`. */
+export declare function defineChannelFile<Payload = unknown>(file: ChannelFile<Payload>): ChannelFile<Payload>;
+/** `file-links/<name>.ts`. Declares the scope's singleton file-link source. */
+export declare function defineFileLinks(file: FileLinkSource): FileLinkSource;
+/** `repository-settings-panel/<name>.tsx`. Declares the workspace settings panel. */
+export declare function defineRepositorySettingsPanel(file: RepositorySettingsPanelContribution): RepositorySettingsPanelContribution;
+/** `selection-axis/<name>.ts`. */
+export declare function defineSelectionAxis(file: SelectionAxisFile): SelectionAxisFile;
+/** `lifecycle/start.ts`. Declares the frontend start lifecycle. */
+export declare function defineWebLifecycle(file: NonNullable<WebPluginContributions['start']>): NonNullable<WebPluginContributions['start']>;
+//#endregion
+//# sourceMappingURL=webPlugin.d.mts.map

package/dist/src/extensions/webPlugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webPlugin.d.mts","names":[],"sources":["../../../src/extensions/webPlugin.ts"],"mappings":";;;;wBA4BgB,gBAAgB,QAAQ,sBAAsB;;;;;;wBAS9C,qBAAqB,SACnC,SAAS,2BAA2B,WACnC;;;;;;;wBAUa,WAAW,MAAM,MAAM,gBAAgB,QAAQ,gBAAgB;;;;;;;;;;wBAc/D,mBAAmB,MAAM,mBAAmB;;wBAK5C,qBAAqB,MAAM,qBAAqB;;wBAKhD,UAAU,MAAM,UAAU;;wBAK1B,kBAAkB,MAAM,kBAAkB;;wBAI1C,eAAe,MAAM,eAAe;;wBAKpC,sBAAsB,MAAM,sBAAsB;;wBAKlD,oBAAoB,MAAM,oBAAoB;;wBAK9C,eAAe,gBAAgB,MAAM,SAAS,QAAQ,SAAS;;wBAK/D,WAAW,MAAM,WAAW;;wBAK5B,oBAAoB,MAAM,oBAAoB;;wBAK9C,wBAAwB,MAAM,wBAAwB;;wBAKtD,oBAAoB,MAAM,gBAAgB;;wBAK1C,oBAAoB,MAAM,oBAAoB;;wBAK9C,oBAAoB,MAAM,oBAAoB;;wBAK9C,kBAAkB,mBAAmB,MAAM,YAAY,WAAW,YAAY;;wBAK9E,gBAAgB,MAAM,iBAAiB;;wBAKvC,8BACd,MAAM,sCACL;;wBAKa,oBAAoB,MAAM,oBAAoB;;wBAK9C,mBACd,MAAM,YAAY,mCACjB,YAAY"}