@agimon-ai/doompi-core 0.0.1-alpha.72 → 0.0.1-alpha.73

package/dist/extension-file.cjs

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_extensionFile = require("./extensions/extensionFile.cjs");
+exports.composeRootHooks = require_extensionFile.composeRootHooks;
+exports.defineActivity = require_extensionFile.defineActivity;
+exports.defineChannel = require_extensionFile.defineChannel;
+exports.defineCliCommand = require_extensionFile.defineCliCommand;
+exports.defineCliHook = require_extensionFile.defineCliHook;
+exports.defineCliTool = require_extensionFile.defineCliTool;
+exports.defineCommand = require_extensionFile.defineCommand;
+exports.defineHook = require_extensionFile.defineHook;
+exports.defineMethod = require_extensionFile.defineMethod;
+exports.defineMode = require_extensionFile.defineMode;
+exports.defineOverlay = require_extensionFile.defineOverlay;
+exports.defineProvider = require_extensionFile.defineProvider;
+exports.defineResource = require_extensionFile.defineResource;
+exports.defineRoot = require_extensionFile.defineRoot;
+exports.defineRoute = require_extensionFile.defineRoute;
+exports.defineRoutedContribution = require_extensionFile.defineRoutedContribution;
+exports.defineServerCommand = require_extensionFile.defineServerCommand;
+exports.defineServerTool = require_extensionFile.defineServerTool;
+exports.defineService = require_extensionFile.defineService;
+exports.defineShortcut = require_extensionFile.defineShortcut;
+exports.defineTool = require_extensionFile.defineTool;
+exports.defineToolRestriction = require_extensionFile.defineToolRestriction;

package/dist/extension-file.d.cts

@@ -0,0 +1,3 @@
+import { ActivityFile, ChannelFile, CliCommandFile, CliHookFile, CliHookHandler, CliToolFile, CommandContribution, CommandFile, HookFile, MethodFile, OrFactory, OverlayFile, PathSupplied, RootDeclaration, RootFile, RouteFile, RoutedCardinality, RoutedFileOptions, ServerCommandFile, ServerToolFile, ServiceFile, ToolContribution, ToolFile, WithRoot } from "./schemas/extensionFile.cjs";
+import { composeRootHooks, defineActivity, defineChannel, defineCliCommand, defineCliHook, defineCliTool, defineCommand, defineHook, defineMethod, defineMode, defineOverlay, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineShortcut, defineTool, defineToolRestriction } from "./extensions/extensionFile.cjs";
+export { type ActivityFile, type ChannelFile, type CliCommandFile, type CliHookFile, type CliHookHandler, type CliToolFile, type CommandContribution, type CommandFile, type HookFile, type MethodFile, type OrFactory, type OverlayFile, type PathSupplied, type RootDeclaration, type RootFile, type RouteFile, type RoutedCardinality, type RoutedFileOptions, type ServerCommandFile, type ServerToolFile, type ServiceFile, type ToolContribution, type ToolFile, type WithRoot, composeRootHooks, defineActivity, defineChannel, defineCliCommand, defineCliHook, defineCliTool, defineCommand, defineHook, defineMethod, defineMode, defineOverlay, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineShortcut, defineTool, defineToolRestriction };

package/dist/extension-file.d.mts

@@ -0,0 +1,3 @@
+import { ActivityFile, ChannelFile, CliCommandFile, CliHookFile, CliHookHandler, CliToolFile, CommandContribution, CommandFile, HookFile, MethodFile, OrFactory, OverlayFile, PathSupplied, RootDeclaration, RootFile, RouteFile, RoutedCardinality, RoutedFileOptions, ServerCommandFile, ServerToolFile, ServiceFile, ToolContribution, ToolFile, WithRoot } from "./schemas/extensionFile.mjs";
+import { composeRootHooks, defineActivity, defineChannel, defineCliCommand, defineCliHook, defineCliTool, defineCommand, defineHook, defineMethod, defineMode, defineOverlay, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineShortcut, defineTool, defineToolRestriction } from "./extensions/extensionFile.mjs";
+export { type ActivityFile, type ChannelFile, type CliCommandFile, type CliHookFile, type CliHookHandler, type CliToolFile, type CommandContribution, type CommandFile, type HookFile, type MethodFile, type OrFactory, type OverlayFile, type PathSupplied, type RootDeclaration, type RootFile, type RouteFile, type RoutedCardinality, type RoutedFileOptions, type ServerCommandFile, type ServerToolFile, type ServiceFile, type ToolContribution, type ToolFile, type WithRoot, composeRootHooks, defineActivity, defineChannel, defineCliCommand, defineCliHook, defineCliTool, defineCommand, defineHook, defineMethod, defineMode, defineOverlay, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineShortcut, defineTool, defineToolRestriction };

package/dist/extension-file.mjs

@@ -0,0 +1,2 @@
+import { composeRootHooks, defineActivity, defineChannel, defineCliCommand, defineCliHook, defineCliTool, defineCommand, defineHook, defineMethod, defineMode, defineOverlay, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineShortcut, defineTool, defineToolRestriction } from "./extensions/extensionFile.mjs";
+export { composeRootHooks, defineActivity, defineChannel, defineCliCommand, defineCliHook, defineCliTool, defineCommand, defineHook, defineMethod, defineMode, defineOverlay, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineShortcut, defineTool, defineToolRestriction };

package/dist/extensions/extensionFile.cjs

@@ -0,0 +1,165 @@
+//#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
+exports.composeRootHooks = composeRootHooks;
+exports.defineActivity = defineActivity;
+exports.defineChannel = defineChannel;
+exports.defineCliCommand = defineCliCommand;
+exports.defineCliHook = defineCliHook;
+exports.defineCliTool = defineCliTool;
+exports.defineCommand = defineCommand;
+exports.defineHook = defineHook;
+exports.defineMethod = defineMethod;
+exports.defineMode = defineMode;
+exports.defineOverlay = defineOverlay;
+exports.defineProvider = defineProvider;
+exports.defineResource = defineResource;
+exports.defineRoot = defineRoot;
+exports.defineRoute = defineRoute;
+exports.defineRoutedContribution = defineRoutedContribution;
+exports.defineServerCommand = defineServerCommand;
+exports.defineServerTool = defineServerTool;
+exports.defineService = defineService;
+exports.defineShortcut = defineShortcut;
+exports.defineTool = defineTool;
+exports.defineToolRestriction = defineToolRestriction;
+
+//# sourceMappingURL=extensionFile.cjs.map

package/dist/extensions/extensionFile.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionFile.cjs","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/extensions/extensionFile.d.cts

@@ -0,0 +1,79 @@
+import { PluginLifecycleHooks } from "../services/pluginLifecycle/index.cjs";
+import { DoomHeadlessEventName } from "../schemas/headless.cjs";
+import { ActivityFile, ChannelFile, CliCommandFile, CliHookFile, CliHookHandler, CliToolFile, CommandContribution, CommandFile, HookFile, MethodFile, OverlayFile, RootFile, RouteFile, RoutedFileOptions, ServerCommandFile, ServerToolFile, ServiceFile, ToolContribution, ToolFile } from "../schemas/extensionFile.cjs";
+import { TSchema } from "typebox";
+//#region src/extensions/extensionFile.d.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. */
+export declare function defineRoutedContribution<T>(file: T, _options: RoutedFileOptions): T;
+/** `provider/<name>.cli.ts`. Declares one Pi provider tuple. */
+export declare function defineProvider<T>(file: T): T;
+/** `resource/<name>.ts`. Declares one package resource. */
+export declare function defineResource<T>(file: T): T;
+/** `shortcut/<name>.cli.ts`. Declares one Pi keyboard shortcut. */
+export declare function defineShortcut<T>(file: T): T;
+/** `tool-restriction/<name>.ts`. Declares one tool restriction. */
+export declare function defineToolRestriction<T>(file: T): T;
+/** Declares one mode when it is not represented by a mode gate file. */
+export declare function defineMode<T>(file: T): T;
+/** `overlay/<name>.cli.ts`. A terminal view opened directly by a command. */
+export declare function defineOverlay<T extends OverlayFile>(file: T): T;
+/** `tool/<name>.ts`. Adds the discriminant the contribution array expects. */
+export declare function defineTool<TContext = unknown>(file: ToolFile<TContext>): ToolContribution<TContext>;
+/** `tool/<name>.server.ts`. A native headless tool, handed to the host untouched. */
+export declare function defineServerTool<TParameters extends TSchema = TSchema, TContext = unknown>(file: ServerToolFile<TParameters, TContext>): ServerToolFile<TParameters, TContext>;
+/**
+ * `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.
+ */
+export declare function defineRoot<TValue, TContext = unknown>(file: RootFile<TValue, TContext>): RootFile<TValue, TContext>;
+/**
+ * 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.
+ */
+export declare function composeRootHooks<TContext>(...roots: readonly PluginLifecycleHooks<TContext>[]): Required<PluginLifecycleHooks<TContext>>;
+/** `tool/<name>.cli.ts`. A native interactive tool, handed to Pi untouched. */
+export declare function defineCliTool<TContext = unknown>(file: CliToolFile<TContext>): CliToolFile<TContext>;
+/** `command/<name>.cli.ts`. A native Pi command or portable Doom command. */
+export declare function defineCliCommand<TContext = unknown>(file: CliCommandFile<TContext>): CliCommandFile<TContext>;
+/** `command/<name>.server.ts`. A native headless or portable Doom command. */
+export declare function defineServerCommand<TContext = unknown>(file: ServerCommandFile<TContext>): ServerCommandFile<TContext>;
+/** `command/<name>.ts`. Adds the discriminant the contribution array expects. */
+export declare function defineCommand<TContext = unknown>(file: CommandFile<TContext>): CommandContribution<TContext>;
+/** `hook/<event>.cli.ts`. A native Pi event handler factory. */
+export declare function defineCliHook<TContext, THandler extends CliHookHandler>(file: (context: TContext) => THandler): CliHookFile<TContext, CliHookHandler>;
+/** `hook/<event>.ts`. Name the event here too when the handler needs a precise payload. */
+export declare function defineHook<TEvent extends DoomHeadlessEventName = DoomHeadlessEventName, TContext = unknown>(file: HookFile<TEvent, TContext>): HookFile<TEvent, TContext>;
+/** A Cordis service factory for a scope root. */
+export declare function defineService<TContext = unknown>(file: ServiceFile<TContext>): ServiceFile<TContext>;
+/** `channel/<frameType>.ts`. The contribution array holds factories, so this is one. */
+export declare function defineChannel(file: ChannelFile): ChannelFile;
+/** `api/<segments>/route.ts`. The folder path is the route. */
+export declare function defineRoute<TContext = unknown>(file: RouteFile<TContext>): RouteFile<TContext>;
+/** `method/<member>.ts`. Build the value with `defineServerMethod` to keep schema inference. */
+export declare function defineMethod<TContext = unknown>(file: MethodFile<TContext>): MethodFile<TContext>;
+/** A server activity declaration for a session root. */
+export declare function defineActivity<TContext = unknown>(file: ActivityFile<TContext>): ActivityFile<TContext>;
+//#endregion
+//# sourceMappingURL=extensionFile.d.cts.map

package/dist/extensions/extensionFile.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensionFile.d.cts","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/extensions/extensionFile.d.mts

@@ -0,0 +1,79 @@
+import { PluginLifecycleHooks } from "../services/pluginLifecycle/index.mjs";
+import { DoomHeadlessEventName } from "../schemas/headless.mjs";
+import { ActivityFile, ChannelFile, CliCommandFile, CliHookFile, CliHookHandler, CliToolFile, CommandContribution, CommandFile, HookFile, MethodFile, OverlayFile, RootFile, RouteFile, RoutedFileOptions, ServerCommandFile, ServerToolFile, ServiceFile, ToolContribution, ToolFile } from "../schemas/extensionFile.mjs";
+import { TSchema } from "typebox";
+//#region src/extensions/extensionFile.d.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. */
+export declare function defineRoutedContribution<T>(file: T, _options: RoutedFileOptions): T;
+/** `provider/<name>.cli.ts`. Declares one Pi provider tuple. */
+export declare function defineProvider<T>(file: T): T;
+/** `resource/<name>.ts`. Declares one package resource. */
+export declare function defineResource<T>(file: T): T;
+/** `shortcut/<name>.cli.ts`. Declares one Pi keyboard shortcut. */
+export declare function defineShortcut<T>(file: T): T;
+/** `tool-restriction/<name>.ts`. Declares one tool restriction. */
+export declare function defineToolRestriction<T>(file: T): T;
+/** Declares one mode when it is not represented by a mode gate file. */
+export declare function defineMode<T>(file: T): T;
+/** `overlay/<name>.cli.ts`. A terminal view opened directly by a command. */
+export declare function defineOverlay<T extends OverlayFile>(file: T): T;
+/** `tool/<name>.ts`. Adds the discriminant the contribution array expects. */
+export declare function defineTool<TContext = unknown>(file: ToolFile<TContext>): ToolContribution<TContext>;
+/** `tool/<name>.server.ts`. A native headless tool, handed to the host untouched. */
+export declare function defineServerTool<TParameters extends TSchema = TSchema, TContext = unknown>(file: ServerToolFile<TParameters, TContext>): ServerToolFile<TParameters, TContext>;
+/**
+ * `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.
+ */
+export declare function defineRoot<TValue, TContext = unknown>(file: RootFile<TValue, TContext>): RootFile<TValue, TContext>;
+/**
+ * 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.
+ */
+export declare function composeRootHooks<TContext>(...roots: readonly PluginLifecycleHooks<TContext>[]): Required<PluginLifecycleHooks<TContext>>;
+/** `tool/<name>.cli.ts`. A native interactive tool, handed to Pi untouched. */
+export declare function defineCliTool<TContext = unknown>(file: CliToolFile<TContext>): CliToolFile<TContext>;
+/** `command/<name>.cli.ts`. A native Pi command or portable Doom command. */
+export declare function defineCliCommand<TContext = unknown>(file: CliCommandFile<TContext>): CliCommandFile<TContext>;
+/** `command/<name>.server.ts`. A native headless or portable Doom command. */
+export declare function defineServerCommand<TContext = unknown>(file: ServerCommandFile<TContext>): ServerCommandFile<TContext>;
+/** `command/<name>.ts`. Adds the discriminant the contribution array expects. */
+export declare function defineCommand<TContext = unknown>(file: CommandFile<TContext>): CommandContribution<TContext>;
+/** `hook/<event>.cli.ts`. A native Pi event handler factory. */
+export declare function defineCliHook<TContext, THandler extends CliHookHandler>(file: (context: TContext) => THandler): CliHookFile<TContext, CliHookHandler>;
+/** `hook/<event>.ts`. Name the event here too when the handler needs a precise payload. */
+export declare function defineHook<TEvent extends DoomHeadlessEventName = DoomHeadlessEventName, TContext = unknown>(file: HookFile<TEvent, TContext>): HookFile<TEvent, TContext>;
+/** A Cordis service factory for a scope root. */
+export declare function defineService<TContext = unknown>(file: ServiceFile<TContext>): ServiceFile<TContext>;
+/** `channel/<frameType>.ts`. The contribution array holds factories, so this is one. */
+export declare function defineChannel(file: ChannelFile): ChannelFile;
+/** `api/<segments>/route.ts`. The folder path is the route. */
+export declare function defineRoute<TContext = unknown>(file: RouteFile<TContext>): RouteFile<TContext>;
+/** `method/<member>.ts`. Build the value with `defineServerMethod` to keep schema inference. */
+export declare function defineMethod<TContext = unknown>(file: MethodFile<TContext>): MethodFile<TContext>;
+/** A server activity declaration for a session root. */
+export declare function defineActivity<TContext = unknown>(file: ActivityFile<TContext>): ActivityFile<TContext>;
+//#endregion
+//# sourceMappingURL=extensionFile.d.mts.map

package/dist/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/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/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/extensions/serverPlugin.cjs

@@ -55,7 +55,7 @@ function defineServerPlugin(plugin) {
 					const unsubscribe = restriction.subscribe?.(refresh);
 					if (unsubscribe) lifecycle.own(unsubscribe);
 				}
-				for (const resource of session.resources ?? []) own(agent.registerResource(resource));
+				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) {

package/dist/extensions/serverPlugin.cjs.map

@@ -1 +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 ?? []) own(agent.registerResource(resource));\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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"}
+{"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":"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"}

package/dist/extensions/serverPlugin.mjs

@@ -55,7 +55,7 @@ function defineServerPlugin(plugin) {
 					const unsubscribe = restriction.subscribe?.(refresh);
 					if (unsubscribe) lifecycle.own(unsubscribe);
 				}
-				for (const resource of session.resources ?? []) own(agent.registerResource(resource));
+				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) {