@agimon-ai/po-core 0.0.0-alpha.0

package/dist/src/constants/voiceTools.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceTools.cjs","names":[],"sources":["../../../src/constants/voiceTools.ts"],"sourcesContent":["export const DOOM_VOICE_TOOLS_SERVICE = 'doom/voice-tools';\nexport const VOICE_DESCRIBE_TOOL_NAME = 'describe_voice_tools' as const;\nexport const VOICE_USE_TOOL_NAME = 'use_voice_tools' as const;\nexport const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME] as const;\nexport const VOICE_NARRATE_TOOL_NAME = 'narrate' as const;\nexport const VOICE_MODE_TOOL_NAMES = [...VOICE_FACADE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME] as const;\nexport const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 10_000;\nexport const VOICE_TOOL_MAX_TIMEOUT_MS = 30_000;\nexport const VOICE_TOOL_MAX_BATCH_ITEMS = 16;\nexport const VOICE_TOOL_MAX_INPUT_BYTES = 64 * 1024;\nexport const VOICE_TOOL_MAX_BATCH_BYTES = 256 * 1024;\nexport const VOICE_TOOL_MAX_SCHEMA_BYTES = 32 * 1024;\nexport const VOICE_TOOL_MAX_JSON_DEPTH = 16;\nexport const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;\nexport const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;\nexport const VOICE_TOOL_MAX_LABEL_LENGTH = 96;\nexport const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;\nexport const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;\nexport const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;\nexport const SAFE_IDENTIFIER = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;\nexport const SAFE_NAME = /^[a-z][a-z0-9_:-]*$/u;\nexport const MAX_ORDER = 1_000;\nexport const VOICE_TOOL_ERROR_CODE = {\n  hostUnavailable: 'VOICE_TOOL_HOST_UNAVAILABLE',\n  inactive: 'VOICE_TOOL_INACTIVE',\n  staleSession: 'VOICE_TOOL_STALE_SESSION',\n  staleCatalog: 'VOICE_TOOL_STALE_CATALOG',\n  notFound: 'VOICE_TOOL_NOT_FOUND',\n  nameConflict: 'VOICE_TOOL_NAME_CONFLICT',\n  invalidInput: 'VOICE_TOOL_INVALID_INPUT',\n  invalidResult: 'VOICE_TOOL_INVALID_RESULT',\n  executionFailed: 'VOICE_TOOL_EXECUTION_FAILED',\n  timeout: 'VOICE_TOOL_TIMEOUT',\n  aborted: 'VOICE_TOOL_ABORTED',\n  cancelled: 'VOICE_TOOL_CANCELLED',\n  registrationDisposed: 'VOICE_TOOL_REGISTRATION_DISPOSED',\n  sessionShutdown: 'VOICE_TOOL_SESSION_SHUTDOWN',\n  batchStopped: 'VOICE_TOOL_BATCH_STOPPED',\n  reloadQueued: 'VOICE_TOOL_RELOAD_QUEUED',\n  invalidRequest: 'VOICE_TOOL_INVALID_REQUEST',\n} as const;\nexport const VOICE_TOOL_HOST_UNAVAILABLE = VOICE_TOOL_ERROR_CODE.hostUnavailable;\nexport const VOICE_TOOL_INACTIVE = VOICE_TOOL_ERROR_CODE.inactive;\nexport const VOICE_TOOL_STALE_SESSION = VOICE_TOOL_ERROR_CODE.staleSession;\nexport const VOICE_TOOL_STALE_CATALOG = VOICE_TOOL_ERROR_CODE.staleCatalog;\nexport const VOICE_TOOL_NOT_FOUND = VOICE_TOOL_ERROR_CODE.notFound;\nexport const VOICE_TOOL_NAME_CONFLICT = VOICE_TOOL_ERROR_CODE.nameConflict;\nexport const VOICE_TOOL_INVALID_INPUT = VOICE_TOOL_ERROR_CODE.invalidInput;\nexport const VOICE_TOOL_INVALID_RESULT = VOICE_TOOL_ERROR_CODE.invalidResult;\nexport const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;\nexport const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;\nexport const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;\nexport const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;\n\nexport const DOOM_VOICE_SOURCE = '@agimon-ai/po-voice';\nexport const DOOM_VOICE_AUTO_MODE_ID = 'voice-auto';\n"],"mappings":";AAAA,MAAa,2BAA2B;AACxC,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,0BAA0B,CAAC,0BAA0B,mBAAmB;AACrF,MAAa,0BAA0B;AACvC,MAAa,wBAAwB,CAAC,GAAG,yBAAyB,uBAAuB;AACzF,MAAa,gCAAgC;AAC7C,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,sCAAsC;AACnD,MAAa,mCAAmC;AAChD,MAAa,8BAA8B;AAC3C,MAAa,oCAAoC;AACjD,MAAa,sCAAsC;AACnD,MAAa,8BAA8B;AAC3C,MAAa,kBAAkB;AAC/B,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,wBAAwB;CACnC,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,SAAS;CACT,SAAS;CACT,WAAW;CACX,sBAAsB;CACtB,iBAAiB;CACjB,cAAc;CACd,cAAc;CACd,gBAAgB;AAClB;AACA,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,sBAAsB,sBAAsB;AACzD,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,uBAAuB,sBAAsB;AAC1D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,4BAA4B,sBAAsB;AAC/D,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,2BAA2B,sBAAsB;AAE9D,MAAa,oBAAoB;AACjC,MAAa,0BAA0B"}

package/dist/src/constants/voiceTools.d.mts

@@ -0,0 +1,58 @@
+//#region src/constants/voiceTools.d.ts
+export declare const DOOM_VOICE_TOOLS_SERVICE = "doom/voice-tools";
+export declare const VOICE_DESCRIBE_TOOL_NAME: 'describe_voice_tools';
+export declare const VOICE_USE_TOOL_NAME: 'use_voice_tools';
+export declare const VOICE_FACADE_TOOL_NAMES: readonly ["describe_voice_tools", "use_voice_tools"];
+export declare const VOICE_NARRATE_TOOL_NAME: 'narrate';
+export declare const VOICE_MODE_TOOL_NAMES: readonly ["describe_voice_tools", "use_voice_tools", "narrate"];
+export declare const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 10000;
+export declare const VOICE_TOOL_MAX_TIMEOUT_MS = 30000;
+export declare const VOICE_TOOL_MAX_BATCH_ITEMS = 16;
+export declare const VOICE_TOOL_MAX_INPUT_BYTES: number;
+export declare const VOICE_TOOL_MAX_BATCH_BYTES: number;
+export declare const VOICE_TOOL_MAX_SCHEMA_BYTES: number;
+export declare const VOICE_TOOL_MAX_JSON_DEPTH = 16;
+export declare const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;
+export declare const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;
+export declare const VOICE_TOOL_MAX_LABEL_LENGTH = 96;
+export declare const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;
+export declare const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;
+export declare const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;
+export declare const SAFE_IDENTIFIER: RegExp;
+export declare const SAFE_NAME: RegExp;
+export declare const MAX_ORDER = 1000;
+export declare const VOICE_TOOL_ERROR_CODE: {
+  readonly hostUnavailable: 'VOICE_TOOL_HOST_UNAVAILABLE';
+  readonly inactive: 'VOICE_TOOL_INACTIVE';
+  readonly staleSession: 'VOICE_TOOL_STALE_SESSION';
+  readonly staleCatalog: 'VOICE_TOOL_STALE_CATALOG';
+  readonly notFound: 'VOICE_TOOL_NOT_FOUND';
+  readonly nameConflict: 'VOICE_TOOL_NAME_CONFLICT';
+  readonly invalidInput: 'VOICE_TOOL_INVALID_INPUT';
+  readonly invalidResult: 'VOICE_TOOL_INVALID_RESULT';
+  readonly executionFailed: 'VOICE_TOOL_EXECUTION_FAILED';
+  readonly timeout: 'VOICE_TOOL_TIMEOUT';
+  readonly aborted: 'VOICE_TOOL_ABORTED';
+  readonly cancelled: 'VOICE_TOOL_CANCELLED';
+  readonly registrationDisposed: 'VOICE_TOOL_REGISTRATION_DISPOSED';
+  readonly sessionShutdown: 'VOICE_TOOL_SESSION_SHUTDOWN';
+  readonly batchStopped: 'VOICE_TOOL_BATCH_STOPPED';
+  readonly reloadQueued: 'VOICE_TOOL_RELOAD_QUEUED';
+  readonly invalidRequest: 'VOICE_TOOL_INVALID_REQUEST';
+};
+export declare const VOICE_TOOL_HOST_UNAVAILABLE: "VOICE_TOOL_HOST_UNAVAILABLE";
+export declare const VOICE_TOOL_INACTIVE: "VOICE_TOOL_INACTIVE";
+export declare const VOICE_TOOL_STALE_SESSION: "VOICE_TOOL_STALE_SESSION";
+export declare const VOICE_TOOL_STALE_CATALOG: "VOICE_TOOL_STALE_CATALOG";
+export declare const VOICE_TOOL_NOT_FOUND: "VOICE_TOOL_NOT_FOUND";
+export declare const VOICE_TOOL_NAME_CONFLICT: "VOICE_TOOL_NAME_CONFLICT";
+export declare const VOICE_TOOL_INVALID_INPUT: "VOICE_TOOL_INVALID_INPUT";
+export declare const VOICE_TOOL_INVALID_RESULT: "VOICE_TOOL_INVALID_RESULT";
+export declare const VOICE_TOOL_TIMEOUT: "VOICE_TOOL_TIMEOUT";
+export declare const VOICE_TOOL_ABORTED: "VOICE_TOOL_ABORTED";
+export declare const VOICE_TOOL_EXECUTION_FAILED: "VOICE_TOOL_EXECUTION_FAILED";
+export declare const VOICE_TOOL_BATCH_STOPPED: "VOICE_TOOL_BATCH_STOPPED";
+export declare const DOOM_VOICE_SOURCE = "@agimon-ai/po-voice";
+export declare const DOOM_VOICE_AUTO_MODE_ID = "voice-auto";
+//#endregion
+//# sourceMappingURL=voiceTools.d.mts.map

package/dist/src/constants/voiceTools.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceTools.d.mts","names":[],"sources":["../../../src/constants/voiceTools.ts"],"mappings":";qBAAa;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA,iBAAe;qBACf,WAAS;qBACT;qBACA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;qBAEW;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBACA;qBAEA;qBACA"}

package/dist/src/constants/voiceTools.mjs

@@ -0,0 +1,60 @@
+//#region src/constants/voiceTools.ts
+const DOOM_VOICE_TOOLS_SERVICE = "doom/voice-tools";
+const VOICE_DESCRIBE_TOOL_NAME = "describe_voice_tools";
+const VOICE_USE_TOOL_NAME = "use_voice_tools";
+const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME];
+const VOICE_NARRATE_TOOL_NAME = "narrate";
+const VOICE_MODE_TOOL_NAMES = [...VOICE_FACADE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME];
+const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 1e4;
+const VOICE_TOOL_MAX_TIMEOUT_MS = 3e4;
+const VOICE_TOOL_MAX_BATCH_ITEMS = 16;
+const VOICE_TOOL_MAX_INPUT_BYTES = 65536;
+const VOICE_TOOL_MAX_BATCH_BYTES = 262144;
+const VOICE_TOOL_MAX_SCHEMA_BYTES = 32768;
+const VOICE_TOOL_MAX_JSON_DEPTH = 16;
+const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;
+const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;
+const VOICE_TOOL_MAX_LABEL_LENGTH = 96;
+const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;
+const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;
+const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;
+const SAFE_IDENTIFIER = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;
+const SAFE_NAME = /^[a-z][a-z0-9_:-]*$/u;
+const MAX_ORDER = 1e3;
+const VOICE_TOOL_ERROR_CODE = {
+	hostUnavailable: "VOICE_TOOL_HOST_UNAVAILABLE",
+	inactive: "VOICE_TOOL_INACTIVE",
+	staleSession: "VOICE_TOOL_STALE_SESSION",
+	staleCatalog: "VOICE_TOOL_STALE_CATALOG",
+	notFound: "VOICE_TOOL_NOT_FOUND",
+	nameConflict: "VOICE_TOOL_NAME_CONFLICT",
+	invalidInput: "VOICE_TOOL_INVALID_INPUT",
+	invalidResult: "VOICE_TOOL_INVALID_RESULT",
+	executionFailed: "VOICE_TOOL_EXECUTION_FAILED",
+	timeout: "VOICE_TOOL_TIMEOUT",
+	aborted: "VOICE_TOOL_ABORTED",
+	cancelled: "VOICE_TOOL_CANCELLED",
+	registrationDisposed: "VOICE_TOOL_REGISTRATION_DISPOSED",
+	sessionShutdown: "VOICE_TOOL_SESSION_SHUTDOWN",
+	batchStopped: "VOICE_TOOL_BATCH_STOPPED",
+	reloadQueued: "VOICE_TOOL_RELOAD_QUEUED",
+	invalidRequest: "VOICE_TOOL_INVALID_REQUEST"
+};
+const VOICE_TOOL_HOST_UNAVAILABLE = VOICE_TOOL_ERROR_CODE.hostUnavailable;
+const VOICE_TOOL_INACTIVE = VOICE_TOOL_ERROR_CODE.inactive;
+const VOICE_TOOL_STALE_SESSION = VOICE_TOOL_ERROR_CODE.staleSession;
+const VOICE_TOOL_STALE_CATALOG = VOICE_TOOL_ERROR_CODE.staleCatalog;
+const VOICE_TOOL_NOT_FOUND = VOICE_TOOL_ERROR_CODE.notFound;
+const VOICE_TOOL_NAME_CONFLICT = VOICE_TOOL_ERROR_CODE.nameConflict;
+const VOICE_TOOL_INVALID_INPUT = VOICE_TOOL_ERROR_CODE.invalidInput;
+const VOICE_TOOL_INVALID_RESULT = VOICE_TOOL_ERROR_CODE.invalidResult;
+const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;
+const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;
+const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;
+const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;
+const DOOM_VOICE_SOURCE = "@agimon-ai/po-voice";
+const DOOM_VOICE_AUTO_MODE_ID = "voice-auto";
+//#endregion
+export { DOOM_VOICE_AUTO_MODE_ID, DOOM_VOICE_SOURCE, DOOM_VOICE_TOOLS_SERVICE, MAX_ORDER, SAFE_IDENTIFIER, SAFE_NAME, VOICE_DESCRIBE_TOOL_NAME, VOICE_FACADE_TOOL_NAMES, VOICE_MODE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME, VOICE_TOOL_ABORTED, VOICE_TOOL_BATCH_STOPPED, VOICE_TOOL_DEFAULT_TIMEOUT_MS, VOICE_TOOL_ERROR_CODE, VOICE_TOOL_EXECUTION_FAILED, VOICE_TOOL_HOST_UNAVAILABLE, VOICE_TOOL_INACTIVE, VOICE_TOOL_INVALID_INPUT, VOICE_TOOL_INVALID_RESULT, VOICE_TOOL_MAX_BATCH_BYTES, VOICE_TOOL_MAX_BATCH_ITEMS, VOICE_TOOL_MAX_DESCRIPTION_LENGTH, VOICE_TOOL_MAX_DOMAIN_COUNT, VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH, VOICE_TOOL_MAX_IDENTIFIER_LENGTH, VOICE_TOOL_MAX_INPUT_BYTES, VOICE_TOOL_MAX_JSON_DEPTH, VOICE_TOOL_MAX_LABEL_LENGTH, VOICE_TOOL_MAX_SCHEMA_BYTES, VOICE_TOOL_MAX_TIMEOUT_MS, VOICE_TOOL_NAME_CONFLICT, VOICE_TOOL_NOT_FOUND, VOICE_TOOL_STALE_CATALOG, VOICE_TOOL_STALE_SESSION, VOICE_TOOL_TERMINAL_OPERATION_LIMIT, VOICE_TOOL_TIMEOUT, VOICE_USE_TOOL_NAME };
+
+//# sourceMappingURL=voiceTools.mjs.map

package/dist/src/constants/voiceTools.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceTools.mjs","names":[],"sources":["../../../src/constants/voiceTools.ts"],"sourcesContent":["export const DOOM_VOICE_TOOLS_SERVICE = 'doom/voice-tools';\nexport const VOICE_DESCRIBE_TOOL_NAME = 'describe_voice_tools' as const;\nexport const VOICE_USE_TOOL_NAME = 'use_voice_tools' as const;\nexport const VOICE_FACADE_TOOL_NAMES = [VOICE_DESCRIBE_TOOL_NAME, VOICE_USE_TOOL_NAME] as const;\nexport const VOICE_NARRATE_TOOL_NAME = 'narrate' as const;\nexport const VOICE_MODE_TOOL_NAMES = [...VOICE_FACADE_TOOL_NAMES, VOICE_NARRATE_TOOL_NAME] as const;\nexport const VOICE_TOOL_DEFAULT_TIMEOUT_MS = 10_000;\nexport const VOICE_TOOL_MAX_TIMEOUT_MS = 30_000;\nexport const VOICE_TOOL_MAX_BATCH_ITEMS = 16;\nexport const VOICE_TOOL_MAX_INPUT_BYTES = 64 * 1024;\nexport const VOICE_TOOL_MAX_BATCH_BYTES = 256 * 1024;\nexport const VOICE_TOOL_MAX_SCHEMA_BYTES = 32 * 1024;\nexport const VOICE_TOOL_MAX_JSON_DEPTH = 16;\nexport const VOICE_TOOL_TERMINAL_OPERATION_LIMIT = 256;\nexport const VOICE_TOOL_MAX_IDENTIFIER_LENGTH = 128;\nexport const VOICE_TOOL_MAX_LABEL_LENGTH = 96;\nexport const VOICE_TOOL_MAX_DESCRIPTION_LENGTH = 240;\nexport const VOICE_TOOL_MAX_ERROR_MESSAGE_LENGTH = 240;\nexport const VOICE_TOOL_MAX_DOMAIN_COUNT = 32;\nexport const SAFE_IDENTIFIER = /^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$/u;\nexport const SAFE_NAME = /^[a-z][a-z0-9_:-]*$/u;\nexport const MAX_ORDER = 1_000;\nexport const VOICE_TOOL_ERROR_CODE = {\n  hostUnavailable: 'VOICE_TOOL_HOST_UNAVAILABLE',\n  inactive: 'VOICE_TOOL_INACTIVE',\n  staleSession: 'VOICE_TOOL_STALE_SESSION',\n  staleCatalog: 'VOICE_TOOL_STALE_CATALOG',\n  notFound: 'VOICE_TOOL_NOT_FOUND',\n  nameConflict: 'VOICE_TOOL_NAME_CONFLICT',\n  invalidInput: 'VOICE_TOOL_INVALID_INPUT',\n  invalidResult: 'VOICE_TOOL_INVALID_RESULT',\n  executionFailed: 'VOICE_TOOL_EXECUTION_FAILED',\n  timeout: 'VOICE_TOOL_TIMEOUT',\n  aborted: 'VOICE_TOOL_ABORTED',\n  cancelled: 'VOICE_TOOL_CANCELLED',\n  registrationDisposed: 'VOICE_TOOL_REGISTRATION_DISPOSED',\n  sessionShutdown: 'VOICE_TOOL_SESSION_SHUTDOWN',\n  batchStopped: 'VOICE_TOOL_BATCH_STOPPED',\n  reloadQueued: 'VOICE_TOOL_RELOAD_QUEUED',\n  invalidRequest: 'VOICE_TOOL_INVALID_REQUEST',\n} as const;\nexport const VOICE_TOOL_HOST_UNAVAILABLE = VOICE_TOOL_ERROR_CODE.hostUnavailable;\nexport const VOICE_TOOL_INACTIVE = VOICE_TOOL_ERROR_CODE.inactive;\nexport const VOICE_TOOL_STALE_SESSION = VOICE_TOOL_ERROR_CODE.staleSession;\nexport const VOICE_TOOL_STALE_CATALOG = VOICE_TOOL_ERROR_CODE.staleCatalog;\nexport const VOICE_TOOL_NOT_FOUND = VOICE_TOOL_ERROR_CODE.notFound;\nexport const VOICE_TOOL_NAME_CONFLICT = VOICE_TOOL_ERROR_CODE.nameConflict;\nexport const VOICE_TOOL_INVALID_INPUT = VOICE_TOOL_ERROR_CODE.invalidInput;\nexport const VOICE_TOOL_INVALID_RESULT = VOICE_TOOL_ERROR_CODE.invalidResult;\nexport const VOICE_TOOL_TIMEOUT = VOICE_TOOL_ERROR_CODE.timeout;\nexport const VOICE_TOOL_ABORTED = VOICE_TOOL_ERROR_CODE.aborted;\nexport const VOICE_TOOL_EXECUTION_FAILED = VOICE_TOOL_ERROR_CODE.executionFailed;\nexport const VOICE_TOOL_BATCH_STOPPED = VOICE_TOOL_ERROR_CODE.batchStopped;\n\nexport const DOOM_VOICE_SOURCE = '@agimon-ai/po-voice';\nexport const DOOM_VOICE_AUTO_MODE_ID = 'voice-auto';\n"],"mappings":";AAAA,MAAa,2BAA2B;AACxC,MAAa,2BAA2B;AACxC,MAAa,sBAAsB;AACnC,MAAa,0BAA0B,CAAC,0BAA0B,mBAAmB;AACrF,MAAa,0BAA0B;AACvC,MAAa,wBAAwB,CAAC,GAAG,yBAAyB,uBAAuB;AACzF,MAAa,gCAAgC;AAC7C,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,6BAA6B;AAC1C,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,sCAAsC;AACnD,MAAa,mCAAmC;AAChD,MAAa,8BAA8B;AAC3C,MAAa,oCAAoC;AACjD,MAAa,sCAAsC;AACnD,MAAa,8BAA8B;AAC3C,MAAa,kBAAkB;AAC/B,MAAa,YAAY;AACzB,MAAa,YAAY;AACzB,MAAa,wBAAwB;CACnC,iBAAiB;CACjB,UAAU;CACV,cAAc;CACd,cAAc;CACd,UAAU;CACV,cAAc;CACd,cAAc;CACd,eAAe;CACf,iBAAiB;CACjB,SAAS;CACT,SAAS;CACT,WAAW;CACX,sBAAsB;CACtB,iBAAiB;CACjB,cAAc;CACd,cAAc;CACd,gBAAgB;AAClB;AACA,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,sBAAsB,sBAAsB;AACzD,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,uBAAuB,sBAAsB;AAC1D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,2BAA2B,sBAAsB;AAC9D,MAAa,4BAA4B,sBAAsB;AAC/D,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,qBAAqB,sBAAsB;AACxD,MAAa,8BAA8B,sBAAsB;AACjE,MAAa,2BAA2B,sBAAsB;AAE9D,MAAa,oBAAoB;AACjC,MAAa,0BAA0B"}

package/dist/src/extensions/extensionFile.cjs

@@ -0,0 +1,140 @@
+//#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>.server.ts`. Declares one native provider contribution. */
+function defineProvider(file) {
+	return file;
+}
+/** `resource/<name>.ts`. Declares one package resource. */
+function defineResource(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;
+}
+/** `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);
+		}
+	};
+}
+/** `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>.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.defineCommand = defineCommand;
+exports.defineHook = defineHook;
+exports.defineMethod = defineMethod;
+exports.defineMode = defineMode;
+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.defineTool = defineTool;
+exports.defineToolRestriction = defineToolRestriction;
+
+//# sourceMappingURL=extensionFile.cjs.map

package/dist/src/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  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"}

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

@@ -0,0 +1,69 @@
+import { PluginLifecycleHooks } from "../services/pluginLifecycle/index.mjs";
+import { DoomHeadlessEventName } from "../schemas/headless.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
+/**
+ * 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>.server.ts`. Declares one native provider contribution. */
+export declare function defineProvider<T>(file: T): T;
+/** `resource/<name>.ts`. Declares one package resource. */
+export declare function defineResource<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;
+/** `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>>;
+/** `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>.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/src/extensions/extensionFile.d.mts.map

@@ -0,0 +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"}

package/dist/src/extensions/extensionFile.mjs

@@ -0,0 +1,124 @@
+//#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>.server.ts`. Declares one native provider contribution. */
+function defineProvider(file) {
+	return file;
+}
+/** `resource/<name>.ts`. Declares one package resource. */
+function defineResource(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;
+}
+/** `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);
+		}
+	};
+}
+/** `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>.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, 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

@@ -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  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"}

package/dist/src/extensions/serverPlugin.cjs

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