@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

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

@@ -1 +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  CommandContribution,\n  CommandFile,\n  HookFile,\n  MethodFile,\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>.server.ts`. Declares one native provider contribution. */\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/** `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/** `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/** `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>.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":";;;;;;;;;;;;;;;;AAqCA,SAAgB,yBAA4B,MAAS,UAAgC;CACnF,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,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,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,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"}
+{"version":3,"file":"extensionFile.cjs","names":["runCleanups"],"sources":["../../../src/extensions/extensionFile.ts"],"sourcesContent":["import type { TSchema } from 'typebox';\n\nimport type {\n  ActivityFile,\n  ChannelFile,\n  CommandContribution,\n  CommandFile,\n  HookFile,\n  MethodFile,\n  RootFile,\n  RoutedFileOptions,\n  RouteFile,\n  ServerCommandFile,\n  ServerToolFile,\n  ServiceFile,\n  ToolContribution,\n  ToolFile,\n} from '../schemas/extensionFile';\nimport type { PoHeadlessEventName } from '../schemas/headless';\nimport type { PoApiScope } from '../schemas/packageApi';\nimport type { PoServerContracts } from '../schemas/serverPlugin';\nimport type { PoServiceContract } from '../schemas/serverScope';\nimport { runCleanups, 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>.server.ts`. Declares one native provider contribution. */\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/** `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/** `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 *\n * `inject` names the contracts, from this package or another, that the level\n * waits for before it builds this root and restarts with when they change.\n */\nexport function defineRoot<TValue, TContext = unknown>(\n  file: RootFile<TValue, TContext>,\n  options?: { readonly inject?: readonly PoServiceContract<unknown>[] },\n): RootFile<TValue, TContext> {\n  // Assigned rather than wrapped, so other metadata the factory carries (provider overrides) stays.\n  return options?.inject === undefined ? file : Object.assign(file, { inject: options.inject });\n}\n\n/**\n * The contracts each level waits for: every contract injected by the roots that level builds or\n * reuses, once each. A level none of whose roots inject anything is left out.\n */\nexport function composeRootInjects(\n  levels: Readonly<Partial<Record<PoApiScope, readonly Pick<RootFile<unknown>, 'inject'>[]>>>,\n): PoServerContracts {\n  const injects: Partial<Record<PoApiScope, readonly PoServiceContract<unknown>[]>> = {};\n  for (const [level, roots] of Object.entries(levels) as [PoApiScope, readonly Pick<RootFile<unknown>, 'inject'>[]][]) {\n    const contracts = new Map(roots.flatMap((root) => root.inject ?? []).map((contract) => [contract.name, contract]));\n    if (contracts.size > 0) injects[level] = [...contracts.values()];\n  }\n  return injects;\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      await runCleanups(\n        reversed.map((root) => () => root.onStop?.(context)),\n        'Root stop failed.',\n      );\n    },\n    async onDispose(context) {\n      await runCleanups(\n        reversed.map((root) => () => root.onDispose?.(context)),\n        'Root cleanup failed.',\n      );\n    },\n  };\n}\n\n/** `command/<name>.server.ts`. A native headless or portable Po 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>.ts`. Name the event here too when the handler needs a precise payload. */\nexport function defineHook<TEvent extends PoHeadlessEventName = PoHeadlessEventName, 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":";;;;;;;;;;;;;;;;;AAwCA,SAAgB,yBAA4B,MAAS,UAAgC;CACnF,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,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;;;;;;;;;;;;;AAcA,SAAgB,WACd,MACA,SAC4B;CAE5B,OAAO,SAAS,WAAW,KAAA,IAAY,OAAO,OAAO,OAAO,MAAM,EAAE,QAAQ,QAAQ,OAAO,CAAC;AAC9F;;;;;AAMA,SAAgB,mBACd,QACmB;CACnB,MAAM,UAA8E,CAAC;CACrF,KAAK,MAAM,CAAC,OAAO,UAAU,OAAO,QAAQ,MAAM,GAAmE;EACnH,MAAM,YAAY,IAAI,IAAI,MAAM,SAAS,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,SAAS,MAAM,QAAQ,CAAC,CAAC;EACjH,IAAI,UAAU,OAAO,GAAG,QAAQ,SAAS,CAAC,GAAG,UAAU,OAAO,CAAC;CACjE;CACA,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,MAAMA,cAAAA,YACJ,SAAS,KAAK,eAAe,KAAK,SAAS,OAAO,CAAC,GACnD,mBACF;EACF;EACA,MAAM,UAAU,SAAS;GACvB,MAAMA,cAAAA,YACJ,SAAS,KAAK,eAAe,KAAK,YAAY,OAAO,CAAC,GACtD,sBACF;EACF;CACF;AACF;;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,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/extensionFile.d.mts

@@ -1,5 +1,8 @@
 import { PluginLifecycleHooks } from "../services/pluginLifecycle/index.mjs";
-import { DoomHeadlessEventName } from "../schemas/headless.mjs";
+import { PoApiScope } from "../schemas/packageApi.mjs";
+import { PoHeadlessEventName } from "../schemas/headless.mjs";
+import { PoServiceContract } from "../schemas/serverScope.mjs";
+import { PoServerContracts } from "../schemas/serverPlugin.mjs";
 import { ActivityFile, ChannelFile, CommandContribution, CommandFile, HookFile, MethodFile, RootFile, RouteFile, RoutedFileOptions, ServerCommandFile, ServerToolFile, ServiceFile, ToolContribution, ToolFile } from "../schemas/extensionFile.mjs";
 import { TSchema } from "typebox";
 //#region src/extensions/extensionFile.d.ts
@@ -39,8 +42,18 @@ export declare function defineServerTool<TParameters extends TSchema = TSchema,
  * 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.
+ *
+ * `inject` names the contracts, from this package or another, that the level
+ * waits for before it builds this root and restarts with when they change.
+ */
+export declare function defineRoot<TValue, TContext = unknown>(file: RootFile<TValue, TContext>, options?: {
+  readonly inject?: readonly PoServiceContract<unknown>[];
+}): RootFile<TValue, TContext>;
+/**
+ * The contracts each level waits for: every contract injected by the roots that level builds or
+ * reuses, once each. A level none of whose roots inject anything is left out.
  */
-export declare function defineRoot<TValue, TContext = unknown>(file: RootFile<TValue, TContext>): RootFile<TValue, TContext>;
+export declare function composeRootInjects(levels: Readonly<Partial<Record<PoApiScope, readonly Pick<RootFile<unknown>, 'inject'>[]>>>): PoServerContracts;
 /**
  * Folds every root in a scope chain into one set of lifecycle hooks.
  *
@@ -49,12 +62,12 @@ export declare function defineRoot<TValue, TContext = unknown>(file: RootFile<TV
  * still rely on its outer one while stopping.
  */
 export declare function composeRootHooks<TContext>(...roots: readonly PluginLifecycleHooks<TContext>[]): Required<PluginLifecycleHooks<TContext>>;
-/** `command/<name>.server.ts`. A native headless or portable Doom command. */
+/** `command/<name>.server.ts`. A native headless or portable Po 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>.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>;
+export declare function defineHook<TEvent extends PoHeadlessEventName = PoHeadlessEventName, 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. */

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

@@ -1 +1 @@
-{"version":3,"file":"extensionFile.d.mts","names":[],"sources":["../../../src/extensions/extensionFile.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;wBAqCgB,yBAAyB,GAAG,MAAM,GAAG,UAAU,oBAAoB;;wBAKnE,eAAe,GAAG,MAAM,IAAI;;wBAK5B,eAAe,GAAG,MAAM,IAAI;;wBAK5B,sBAAsB,GAAG,MAAM,IAAI;;wBAKnC,WAAW,GAAG,MAAM,IAAI;;wBAKxB,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,oBAAoB,oBAClC,MAAM,kBAAkB,YACvB,kBAAkB;;wBAKL,cAAc,oBAAoB,MAAM,YAAY,YAAY,oBAAoB;;wBAOpF,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"}
+{"version":3,"file":"extensionFile.d.mts","names":[],"sources":["../../../src/extensions/extensionFile.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;wBAwCgB,yBAAyB,GAAG,MAAM,GAAG,UAAU,oBAAoB;;wBAKnE,eAAe,GAAG,MAAM,IAAI;;wBAK5B,eAAe,GAAG,MAAM,IAAI;;wBAK5B,sBAAsB,GAAG,MAAM,IAAI;;wBAKnC,WAAW,GAAG,MAAM,IAAI;;wBAKxB,WAAW,oBAAoB,MAAM,SAAS,YAAY,iBAAiB;;wBAO3E,iBAAiB,oBAAoB,UAAU,SAAS,oBACtE,MAAM,eAAe,aAAa,YACjC,eAAe,aAAa;;;;;;;;;;;;;wBAgBf,WAAW,QAAQ,oBACjC,MAAM,SAAS,QAAQ,WACvB;WAAqB,kBAAkB;IACtC,SAAS,QAAQ;;;;;wBASJ,mBACd,QAAQ,SAAS,QAAQ,OAAO,qBAAqB,KAAK,oCACzD;;;;;;;;wBAgBa,iBAAiB,aAC5B,gBAAgB,qBAAqB,cACvC,SAAS,qBAAqB;;wBAsBjB,oBAAoB,oBAClC,MAAM,kBAAkB,YACvB,kBAAkB;;wBAKL,cAAc,oBAAoB,MAAM,YAAY,YAAY,oBAAoB;;wBAOpF,WAAW,eAAe,sBAAsB,qBAAqB,oBACnF,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

@@ -1,3 +1,4 @@
+import { runCleanups } from "../services/pluginLifecycle/index.mjs";
 //#region src/extensions/extensionFile.ts
 /**
 * Identity helpers for folder-routed backend files, one per surface.
@@ -55,9 +56,24 @@ function defineServerTool(file) {
 * 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.
+*
+* `inject` names the contracts, from this package or another, that the level
+* waits for before it builds this root and restarts with when they change.
 */
-function defineRoot(file) {
-	return file;
+function defineRoot(file, options) {
+	return options?.inject === void 0 ? file : Object.assign(file, { inject: options.inject });
+}
+/**
+* The contracts each level waits for: every contract injected by the roots that level builds or
+* reuses, once each. A level none of whose roots inject anything is left out.
+*/
+function composeRootInjects(levels) {
+	const injects = {};
+	for (const [level, roots] of Object.entries(levels)) {
+		const contracts = new Map(roots.flatMap((root) => root.inject ?? []).map((contract) => [contract.name, contract]));
+		if (contracts.size > 0) injects[level] = [...contracts.values()];
+	}
+	return injects;
 }
 /**
 * Folds every root in a scope chain into one set of lifecycle hooks.
@@ -73,14 +89,14 @@ function composeRootHooks(...roots) {
 			for (const root of roots) await root.onStart?.(context);
 		},
 		async onStop(context) {
-			for (const root of reversed) await root.onStop?.(context);
+			await runCleanups(reversed.map((root) => () => root.onStop?.(context)), "Root stop failed.");
 		},
 		async onDispose(context) {
-			for (const root of reversed) await root.onDispose?.(context);
+			await runCleanups(reversed.map((root) => () => root.onDispose?.(context)), "Root cleanup failed.");
 		}
 	};
 }
-/** `command/<name>.server.ts`. A native headless or portable Doom command. */
+/** `command/<name>.server.ts`. A native headless or portable Po command. */
 function defineServerCommand(file) {
 	return file;
 }
@@ -119,6 +135,6 @@ function defineActivity(file) {
 	return file;
 }
 //#endregion
-export { composeRootHooks, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineTool, defineToolRestriction };
+export { composeRootHooks, composeRootInjects, defineActivity, defineChannel, defineCommand, defineHook, defineMethod, defineMode, defineProvider, defineResource, defineRoot, defineRoute, defineRoutedContribution, defineServerCommand, defineServerTool, defineService, defineTool, defineToolRestriction };
 
 //# sourceMappingURL=extensionFile.mjs.map

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

@@ -1 +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  CommandContribution,\n  CommandFile,\n  HookFile,\n  MethodFile,\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>.server.ts`. Declares one native provider contribution. */\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/** `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/** `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/** `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>.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":";;;;;;;;;;;;;;;;AAqCA,SAAgB,yBAA4B,MAAS,UAAgC;CACnF,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,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,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,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"}
+{"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  CommandContribution,\n  CommandFile,\n  HookFile,\n  MethodFile,\n  RootFile,\n  RoutedFileOptions,\n  RouteFile,\n  ServerCommandFile,\n  ServerToolFile,\n  ServiceFile,\n  ToolContribution,\n  ToolFile,\n} from '../schemas/extensionFile';\nimport type { PoHeadlessEventName } from '../schemas/headless';\nimport type { PoApiScope } from '../schemas/packageApi';\nimport type { PoServerContracts } from '../schemas/serverPlugin';\nimport type { PoServiceContract } from '../schemas/serverScope';\nimport { runCleanups, 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>.server.ts`. Declares one native provider contribution. */\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/** `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/** `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 *\n * `inject` names the contracts, from this package or another, that the level\n * waits for before it builds this root and restarts with when they change.\n */\nexport function defineRoot<TValue, TContext = unknown>(\n  file: RootFile<TValue, TContext>,\n  options?: { readonly inject?: readonly PoServiceContract<unknown>[] },\n): RootFile<TValue, TContext> {\n  // Assigned rather than wrapped, so other metadata the factory carries (provider overrides) stays.\n  return options?.inject === undefined ? file : Object.assign(file, { inject: options.inject });\n}\n\n/**\n * The contracts each level waits for: every contract injected by the roots that level builds or\n * reuses, once each. A level none of whose roots inject anything is left out.\n */\nexport function composeRootInjects(\n  levels: Readonly<Partial<Record<PoApiScope, readonly Pick<RootFile<unknown>, 'inject'>[]>>>,\n): PoServerContracts {\n  const injects: Partial<Record<PoApiScope, readonly PoServiceContract<unknown>[]>> = {};\n  for (const [level, roots] of Object.entries(levels) as [PoApiScope, readonly Pick<RootFile<unknown>, 'inject'>[]][]) {\n    const contracts = new Map(roots.flatMap((root) => root.inject ?? []).map((contract) => [contract.name, contract]));\n    if (contracts.size > 0) injects[level] = [...contracts.values()];\n  }\n  return injects;\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      await runCleanups(\n        reversed.map((root) => () => root.onStop?.(context)),\n        'Root stop failed.',\n      );\n    },\n    async onDispose(context) {\n      await runCleanups(\n        reversed.map((root) => () => root.onDispose?.(context)),\n        'Root cleanup failed.',\n      );\n    },\n  };\n}\n\n/** `command/<name>.server.ts`. A native headless or portable Po 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>.ts`. Name the event here too when the handler needs a precise payload. */\nexport function defineHook<TEvent extends PoHeadlessEventName = PoHeadlessEventName, 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":";;;;;;;;;;;;;;;;;AAwCA,SAAgB,yBAA4B,MAAS,UAAgC;CACnF,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,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;;;;;;;;;;;;;AAcA,SAAgB,WACd,MACA,SAC4B;CAE5B,OAAO,SAAS,WAAW,KAAA,IAAY,OAAO,OAAO,OAAO,MAAM,EAAE,QAAQ,QAAQ,OAAO,CAAC;AAC9F;;;;;AAMA,SAAgB,mBACd,QACmB;CACnB,MAAM,UAA8E,CAAC;CACrF,KAAK,MAAM,CAAC,OAAO,UAAU,OAAO,QAAQ,MAAM,GAAmE;EACnH,MAAM,YAAY,IAAI,IAAI,MAAM,SAAS,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,SAAS,MAAM,QAAQ,CAAC,CAAC;EACjH,IAAI,UAAU,OAAO,GAAG,QAAQ,SAAS,CAAC,GAAG,UAAU,OAAO,CAAC;CACjE;CACA,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,MAAM,YACJ,SAAS,KAAK,eAAe,KAAK,SAAS,OAAO,CAAC,GACnD,mBACF;EACF;EACA,MAAM,UAAU,SAAS;GACvB,MAAM,YACJ,SAAS,KAAK,eAAe,KAAK,YAAY,OAAO,CAAC,GACtD,sBACF;EACF;CACF;AACF;;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,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

@@ -1,105 +1,244 @@
-const require_headless = require("../schemas/headless.cjs");
-const require_serverFacet = require("../schemas/serverFacet.cjs");
 const require_index = require("../services/pluginLifecycle/index.cjs");
+const require_serverScope = require("../schemas/serverScope.cjs");
+const require_headless = require("../schemas/headless.cjs");
+const require_serverPlugin = require("../schemas/serverPlugin.cjs");
 //#region src/extensions/serverPlugin.ts
+/**
+* Holds a built root's teardown for the levels that reuse it.
+*
+* The building level keeps the root's hooks in its own lifecycle, but each one runs only when no
+* inner level still holds a lease. Otherwise the last lease to be released runs what the building
+* level held back. So a reload of the building level installs the new build for itself and for every
+* level that mounts from then on, while a session already running keeps the root it mounted with
+* until it closes.
+*/
+function holdRoot(built) {
+	let leases = 0;
+	let owed = {
+		stop: false,
+		dispose: false
+	};
+	let stopped = false;
+	let disposed = false;
+	const stop = async (context) => {
+		if (stopped) return;
+		stopped = true;
+		await built.onStop?.(context);
+	};
+	const dispose = async (context) => {
+		if (disposed) return;
+		disposed = true;
+		await built.onDispose?.(context);
+	};
+	return {
+		held: {
+			value: built.value,
+			...built.activities === void 0 ? {} : { activities: built.activities },
+			acquire() {
+				leases += 1;
+				let released = false;
+				return async () => {
+					if (released) return;
+					released = true;
+					leases -= 1;
+					if (leases > 0 || owed.context === void 0) return;
+					const context = owed.context;
+					await require_index.runCleanups([owed.stop ? () => stop(context) : void 0, owed.dispose ? () => dispose(context) : void 0], "Shared root cleanup failed.");
+				};
+			}
+		},
+		declaration: {
+			...built,
+			onStop: async (context) => {
+				owed = {
+					...owed,
+					stop: true,
+					context
+				};
+				if (leases === 0) await stop(context);
+			},
+			onDispose: async (context) => {
+				owed = {
+					...owed,
+					dispose: true,
+					context
+				};
+				if (leases === 0) await dispose(context);
+			}
+		}
+	};
+}
+const depth = (level) => require_serverScope.PO_SERVER_SCOPE_LEVELS.indexOf(level);
+/** Throws for a contract listed where it cannot work, so a bad declaration fails at load, not at mount. */
+function checkContracts(plugin) {
+	for (const level of require_serverScope.PO_SERVER_SCOPE_LEVELS) {
+		const provided = plugin.provides?.[level] ?? [];
+		if (provided.length > 0 && plugin[level] === void 0) throw new Error(`Server plugin '${plugin.name}' provides contracts at the ${level} level but declares nothing there.`);
+		const names = /* @__PURE__ */ new Set();
+		for (const contract of provided) {
+			if (contract.scope !== level) throw new Error(`Server plugin '${plugin.name}' lists the ${contract.scope} contract '${contract.name}' as provided at the ${level} level.`);
+			if (names.has(contract.name)) throw new Error(`Server plugin '${plugin.name}' provides contract '${contract.name}' twice.`);
+			names.add(contract.name);
+		}
+		for (const contract of plugin.injects?.[level] ?? []) if (depth(contract.scope) > depth(level)) throw new Error(`Server plugin '${plugin.name}' cannot inject the ${contract.scope} contract '${contract.name}' at the ${level} level.`);
+	}
+}
 function defineServerPlugin(plugin) {
+	checkContracts(plugin);
 	return {
+		name: plugin.name,
 		...plugin.providerOverrides ? { providerOverrides: plugin.providerOverrides } : {},
-		inject: [.../* @__PURE__ */ new Set([require_serverFacet.DOOM_SERVER_HOST_SERVICE, ...plugin.inject ?? []])],
+		...plugin.provides ? { provides: plugin.provides } : {},
+		...plugin.injects ? { injects: plugin.injects } : {},
+		inject: [.../* @__PURE__ */ new Set([
+			require_serverPlugin.PO_SERVER_HOST_SERVICE,
+			require_serverScope.PO_SERVER_SCOPE_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.");
+			const level = require_serverPlugin.requirePoServerHost(context).scope;
+			const declaration = plugin[level];
+			if (!declaration) return void 0;
+			const required = (plugin.injects?.[level] ?? []).map((contract) => contract.name);
+			if (required.length === 0) return mount(plugin, declaration, context);
+			await context.inject(required, (inner) => mount(plugin, declaration, inner));
+		}
+	};
+}
+async function mount(owner, declaration, context) {
+	const host = require_serverPlugin.requirePoServerHost(context);
+	const level = host.scope;
+	const agent = level === "session" ? require_headless.readPoHeadlessHost(context) : void 0;
+	const share = require_serverScope.requirePoServerScope(context).plugin(owner);
+	/** Every root this level holds, built here or reused, for the levels inside it. */
+	const roots = {};
+	/** What this level holds of the build's shared values and outer roots, released once it has unwound. */
+	const leases = [];
+	let withdraw;
+	const lifecycle = require_index.createPluginLifecycle((signal) => ({
+		context,
+		host,
+		agent,
+		signal,
+		resources: { async acquire(key, create, dispose) {
+			signal.throwIfAborted();
+			const lease = await share.acquire(key, create, dispose);
+			if (signal.aborted) {
+				await lease.release();
+				signal.throwIfAborted();
+			}
+			leases.push(() => lease.release());
+			return lease.value;
+		} },
+		async scopeRoot(rootLevel, root, rootContext) {
+			const reused = share.outer(rootLevel).map((held) => held[rootLevel]).find((candidate) => candidate !== void 0);
+			if (reused !== void 0) {
+				leases.push(reused.acquire());
+				roots[rootLevel] = reused;
+				return {
+					value: reused.value,
+					...reused.activities === void 0 ? {} : { activities: reused.activities }
+				};
+			}
+			const { held, declaration: owned } = holdRoot(await root(rootContext));
+			roots[rootLevel] = held;
+			return owned;
+		},
+		hosted: (from) => share.outer(from).length > 0
+	}));
+	context.effect(() => async () => {
+		withdraw?.();
+		try {
+			await lifecycle.dispose();
+		} finally {
+			for (const release of leases.splice(0).reverse()) try {
+				await release();
+			} catch (error) {
+				host.context.onNotice(`server plugin '${owner.name}' could not release a shared value (${error instanceof Error ? error.message : String(error)})`);
+			}
+		}
+	});
+	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.`);
 			};
-			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();
+			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)
 					});
-					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.`);
+				} catch (error) {
+					return {
+						content: [{
+							type: "text",
+							text: error instanceof Error ? error.message : String(error)
+						}],
+						isError: true
 					};
-					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();
-		}
-	};
+			}
+		}));
+		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));
+	});
+	if (level !== "session") withdraw = share.run(roots);
+	return () => lifecycle.dispose();
 }
 //#endregion
 exports.defineServerPlugin = defineServerPlugin;

package/dist/src/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    ...(plugin.providerOverrides ? { providerOverrides: plugin.providerOverrides } : {}),\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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"}
+{"version":3,"file":"serverPlugin.cjs","names":["runCleanups","PO_SERVER_SCOPE_LEVELS","PO_SERVER_HOST_SERVICE","PO_SERVER_SCOPE_SERVICE","requirePoServerHost","readPoHeadlessHost","requirePoServerScope","createPluginLifecycle"],"sources":["../../../src/extensions/serverPlugin.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\nimport type { RootDeclaration } from '../schemas/extensionFile';\nimport { readPoHeadlessHost } from '../schemas/headless';\nimport type { PoApiScope } from '../schemas/packageApi';\nimport {\n  PO_SERVER_HOST_SERVICE,\n  requirePoServerHost,\n  type PoServerPlugin,\n  type PoServerPluginDefinition,\n  type PoServerPluginContext,\n  type PoServerSessionPlugin,\n} from '../schemas/serverPlugin';\nimport { PO_SERVER_SCOPE_LEVELS, PO_SERVER_SCOPE_SERVICE, requirePoServerScope } from '../schemas/serverScope';\nimport { createPluginLifecycle, runCleanups } from '../services/pluginLifecycle';\n\n/** A root one level built, as the levels inside it reuse it. */\ninterface HeldRoot {\n  readonly value: unknown;\n  readonly activities?: RootDeclaration<unknown>['activities'];\n  /** Takes a lease; the root's own stop and dispose hooks wait until every lease is released. */\n  acquire(): () => Promise<void>;\n}\n\n/** What a level running a plugin build holds for the levels inside it: every root it built or reused. */\ntype LevelRoots = Partial<Record<PoApiScope, HeldRoot>>;\n\n/**\n * Holds a built root's teardown for the levels that reuse it.\n *\n * The building level keeps the root's hooks in its own lifecycle, but each one runs only when no\n * inner level still holds a lease. Otherwise the last lease to be released runs what the building\n * level held back. So a reload of the building level installs the new build for itself and for every\n * level that mounts from then on, while a session already running keeps the root it mounted with\n * until it closes.\n */\nfunction holdRoot<TValue, TContext>(\n  built: RootDeclaration<TValue, TContext>,\n): { readonly held: HeldRoot; readonly declaration: RootDeclaration<TValue, TContext> } {\n  let leases = 0;\n  let owed: { stop: boolean; dispose: boolean; context?: TContext } = { stop: false, dispose: false };\n  let stopped = false;\n  let disposed = false;\n  const stop = async (context: TContext): Promise<void> => {\n    if (stopped) return;\n    stopped = true;\n    await built.onStop?.(context);\n  };\n  const dispose = async (context: TContext): Promise<void> => {\n    if (disposed) return;\n    disposed = true;\n    await built.onDispose?.(context);\n  };\n  const held: HeldRoot = {\n    value: built.value,\n    ...(built.activities === undefined ? {} : { activities: built.activities }),\n    acquire() {\n      leases += 1;\n      let released = false;\n      return async () => {\n        if (released) return;\n        released = true;\n        leases -= 1;\n        if (leases > 0 || owed.context === undefined) return;\n        const context = owed.context;\n        await runCleanups(\n          [owed.stop ? () => stop(context) : undefined, owed.dispose ? () => dispose(context) : undefined],\n          'Shared root cleanup failed.',\n        );\n      };\n    },\n  };\n  return {\n    held,\n    declaration: {\n      ...built,\n      onStop: async (context) => {\n        owed = { ...owed, stop: true, context };\n        if (leases === 0) await stop(context);\n      },\n      onDispose: async (context) => {\n        owed = { ...owed, dispose: true, context };\n        if (leases === 0) await dispose(context);\n      },\n    },\n  };\n}\n\nconst depth = (level: PoApiScope): number => PO_SERVER_SCOPE_LEVELS.indexOf(level);\n\n/** Throws for a contract listed where it cannot work, so a bad declaration fails at load, not at mount. */\nfunction checkContracts(plugin: PoServerPluginDefinition): void {\n  for (const level of PO_SERVER_SCOPE_LEVELS) {\n    const provided = plugin.provides?.[level] ?? [];\n    if (provided.length > 0 && plugin[level] === undefined)\n      throw new Error(\n        `Server plugin '${plugin.name}' provides contracts at the ${level} level but declares nothing there.`,\n      );\n    const names = new Set<string>();\n    for (const contract of provided) {\n      if (contract.scope !== level)\n        throw new Error(\n          `Server plugin '${plugin.name}' lists the ${contract.scope} contract '${contract.name}' as provided at the ${level} level.`,\n        );\n      if (names.has(contract.name))\n        throw new Error(`Server plugin '${plugin.name}' provides contract '${contract.name}' twice.`);\n      names.add(contract.name);\n    }\n    for (const contract of plugin.injects?.[level] ?? []) {\n      if (depth(contract.scope) > depth(level))\n        throw new Error(\n          `Server plugin '${plugin.name}' cannot inject the ${contract.scope} contract '${contract.name}' at the ${level} level.`,\n        );\n    }\n  }\n}\n\nexport function defineServerPlugin(plugin: PoServerPluginDefinition): PoServerPlugin {\n  checkContracts(plugin);\n  return {\n    name: plugin.name,\n    ...(plugin.providerOverrides ? { providerOverrides: plugin.providerOverrides } : {}),\n    ...(plugin.provides ? { provides: plugin.provides } : {}),\n    ...(plugin.injects ? { injects: plugin.injects } : {}),\n    inject: [...new Set([PO_SERVER_HOST_SERVICE, PO_SERVER_SCOPE_SERVICE, ...(plugin.inject ?? [])])],\n    async apply(context) {\n      const level = requirePoServerHost(context).scope;\n      const declaration = plugin[level];\n      if (!declaration) return undefined;\n      // What an outer level running this build holds is read once, when this level mounts, and what\n      // this level reuses from it is leased, so that level reloading never pulls a root from under a\n      // running session. The contracts this level injects it waits for, and restarts with.\n      const required = (plugin.injects?.[level] ?? []).map((contract) => contract.name);\n      if (required.length === 0) return mount(plugin, declaration, context);\n      // The inner fiber belongs to this one, so it unwinds with it.\n      await context.inject(required, (inner) => mount(plugin, declaration, inner));\n      return undefined;\n    },\n  };\n}\n\nasync function mount(\n  owner: PoServerPluginDefinition,\n  declaration: NonNullable<PoServerPluginDefinition[PoApiScope]>,\n  context: Context,\n): Promise<() => Promise<void>> {\n  const host = requirePoServerHost(context);\n  const level = host.scope;\n  const agent = level === 'session' ? readPoHeadlessHost(context) : undefined;\n  // The definition object is the build: a reload imports a new module, and so a new store.\n  const share = requirePoServerScope(context).plugin<LevelRoots>(owner);\n  /** Every root this level holds, built here or reused, for the levels inside it. */\n  const roots: LevelRoots = {};\n  /** What this level holds of the build's shared values and outer roots, released once it has unwound. */\n  const leases: (() => Promise<void>)[] = [];\n  let withdraw: (() => void) | undefined;\n  const lifecycle = createPluginLifecycle<PoServerPluginContext>((signal) => ({\n    context,\n    host,\n    agent,\n    signal,\n    resources: {\n      async acquire(key, create, dispose) {\n        signal.throwIfAborted();\n        const lease = await share.acquire(key, create, dispose);\n        if (signal.aborted) {\n          // This level unwound while the value was created, so it keeps no share of it.\n          await lease.release();\n          signal.throwIfAborted();\n        }\n        leases.push(() => lease.release());\n        return lease.value;\n      },\n    },\n    async scopeRoot(rootLevel, root, rootContext) {\n      // The innermost outer level holding this root built it, or reused it from further out.\n      const reused = share\n        .outer(rootLevel)\n        .map((held) => held[rootLevel])\n        .find((candidate) => candidate !== undefined);\n      if (reused !== undefined) {\n        leases.push(reused.acquire());\n        roots[rootLevel] = reused;\n        return {\n          value: reused.value as Awaited<ReturnType<typeof root>>['value'],\n          ...(reused.activities === undefined ? {} : { activities: reused.activities }),\n        };\n      }\n      const { held, declaration: owned } = holdRoot(await root(rootContext));\n      roots[rootLevel] = held;\n      return owned;\n    },\n    hosted: (from) => share.outer(from).length > 0,\n  }));\n  context.effect(() => async () => {\n    // First, so no level mounting from here on reuses what this one is about to tear down.\n    withdraw?.();\n    try {\n      await lifecycle.dispose();\n    } finally {\n      // Last, so a value or an outer root this level holds outlives everything here that could use it.\n      for (const release of leases.splice(0).reverse()) {\n        try {\n          await release();\n        } catch (error) {\n          host.context.onNotice(\n            `server plugin '${owner.name}' could not release a shared value (${error instanceof Error ? error.message : String(error)})`,\n          );\n        }\n      }\n    }\n  });\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: PoServerSessionPlugin = 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  // Published once mounted, so a level inside this one reuses its roots instead of building them again.\n  if (level !== 'session') withdraw = share.run(roots);\n  return () => lifecycle.dispose();\n}\n"],"mappings":"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"}

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

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

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

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