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

package/dist/schemas/packageApi.d.mts

@@ -0,0 +1,149 @@
+import { DoomDirectEventBus, DoomHubSessionService } from "./hubChannel.mjs";
+import { DoomMcpProjection } from "./mcpProjection.mjs";
+//#region src/schemas/packageApi.d.ts
+/** The host-owned sync view a repository-scoped package API may inspect. */
+export interface DoomRepositorySyncView {
+  fresh: boolean;
+  reasons: string[];
+  mcpProjection?: DoomMcpProjection;
+}
+/** Where an API runs: inside one session's server, or in the machine-wide hub. */
+export type DoomApiScope = 'global' | 'workspace' | 'session';
+export declare const DOOM_API_SCOPES: readonly DoomApiScope[];
+/** Identity of an independently mounted plugin host. */
+export type DoomApiMount = {
+  scope: 'global';
+} | {
+  scope: 'workspace';
+  workspaceId: string;
+} | {
+  scope: 'session';
+  sessionId: string;
+};
+/** Immutable browser contribution generation paired with a server mount. */
+export interface DoomWebComposition {
+  id: string;
+  scope: DoomApiScope;
+  revision: number;
+  manifestUrl: string;
+  rawAssetBaseUrl: string;
+  verifiedAssetBaseUrl: string;
+  entryPath: string;
+  stylePaths: string[];
+  channels: string[];
+}
+/** Canonical public prefix. Scope selection never falls through to a parent. */
+export declare function doomApiMountPath(mount: DoomApiMount): string;
+/** The segment an API is mounted under, below this prefix. */
+export declare const DOOM_API_ROUTE_PREFIX = "/api/plugin";
+/** Selects the hub API bundle that owns the named cockpit session. */
+export declare const DOOM_HUB_API_SESSION_QUERY_PARAM = "hubSession";
+/** Trusted caller headers written only by the cockpit-to-session proxy. */
+export declare const DOOM_API_CALLER_LOCALITY_HEADER = "x-doompi-api-caller-locality";
+export declare const DOOM_API_CALLER_DEVICE_ID_HEADER = "x-doompi-api-caller-device-id";
+export declare const DOOM_API_CALLER_STEP_UP_HEADER = "x-doompi-api-caller-step-up";
+export declare const DOOM_API_CALLER_HEADERS: readonly ["x-doompi-api-caller-locality", "x-doompi-api-caller-device-id", "x-doompi-api-caller-step-up"];
+export type DoomApiCallerStepUp = 'not-required' | 'verified' | 'unavailable';
+export type DoomApiCaller = {
+  locality: 'local';
+  stepUp: 'not-required';
+} | {
+  locality: 'remote';
+  deviceId: string;
+  stepUp: DoomApiCallerStepUp;
+};
+/** Reads the proxy-authenticated caller identity, rejecting partial or contradictory stamps. */
+export declare function doomApiCallerFrom(headers: Headers): DoomApiCaller | undefined;
+/**
+ * A browser-reachable OAuth redirect the host serves on its own listener.
+ *
+ * A package brokering third-party OAuth cannot use a loopback redirect when the
+ * operator's browser is on another machine: `127.0.0.1` resolves to whichever
+ * machine the browser runs on. The host owns a listener that is reachable from
+ * wherever the cockpit is being used, so it lends that instead of the package
+ * opening a port of its own.
+ */
+export interface DoomOAuthRedirect {
+  /** Absolute URL to register as the redirect target, already origin-correct. */
+  readonly redirectUri: string;
+  /**
+   * Accept redirects carrying this state. Must complete before the
+   * authorization URL is surfaced, or the redirect races its own reservation.
+   */
+  reserve(state: string, timeoutMs?: number): Promise<void>;
+  /** Resolves once the redirect carrying this state arrives. */
+  wait(state: string, timeoutMs?: number): Promise<{
+    code: string;
+    state: string;
+  }>;
+  /** Drops a reservation whose flow ended without a redirect. */
+  cancel(state: string): void;
+}
+/** What the host tells an API about itself when it starts. */
+export interface DoomApiContext {
+  scope: DoomApiScope;
+  /** Stable, opaque identity shared by sessions in one canonical worktree. */
+  workspaceId?: string;
+  /** Canonical admitted workspace root, absent from global mounts. */
+  workspaceRoot?: string;
+  /** Explicit host home, never selected by a remote request. */
+  homeDirectory?: string;
+  /** The session this host serves; absent for a hub-scoped API. */
+  sessionId?: string;
+  /** The session's working directory; absent for a hub-scoped API. */
+  cwd?: string;
+  /** Session environment admitted by the server, never supplied by remote clients. */
+  environment?: Readonly<Record<string, string | undefined>>;
+  /** Shared only with child processes in this session, never with remote API clients. */
+  internalToken?: string;
+  /** Shared only with the cockpit hub for privileged cross-session coordination. */
+  hubToken?: string;
+  /**
+   * Resolves a hub-issued opaque repository id to an admitted canonical root.
+   * Hub APIs must never accept a browser-supplied filesystem path instead.
+   */
+  resolveRepository?(repositoryId: string): string | undefined;
+  /** Reads the admitted repository's sync projection without exposing its state path. */
+  readRepositorySync?(repositoryId: string): DoomRepositorySyncView | undefined;
+  /** Admitted workspaces available to this mount. */
+  repositories?(): readonly {
+    id: string;
+    name: string;
+    path: string;
+    active: boolean;
+  }[];
+  /** Publish a successful config write to the owning mount's refresh lifecycle. */
+  configurationChanged?(): void;
+  /**
+   * Borrows the hub's OAuth redirect surface. Undefined when the hub cannot
+   * currently serve one, in which case the package keeps its own behaviour.
+   */
+  oauthRedirect?(): DoomOAuthRedirect | undefined;
+  /** Canonical in-process lifecycle for sessions created by this host. */
+  sessionService?: DoomHubSessionService;
+  /** Same-process events shared by session APIs and hub channels. */
+  directEvents?: DoomDirectEventBus;
+  /** Deliver a typed method to a channel on this exact hub mount, retaining the caller's connection identity. */
+  receiveChannel?(sessionId: string, frameType: string, payload: unknown, connectionId: string): boolean;
+  /** Machine-owned Remote Control service, mounted only by the global core facet. */
+  remoteControl?: {
+    fetch(request: Request): Promise<Response>;
+  };
+  onNotice(message: string): void;
+}
+/**
+ * One running surface. The host strips the mount prefix before calling, so
+ * routes are declared relative ('/runners/:id/log') and a package never
+ * repeats where it was mounted.
+ */
+export interface DoomApiHandler {
+  fetch(request: Request): Response | Promise<Response>;
+  close(): void;
+}
+export interface DoomApi {
+  /** Segment under /api/plugin/; globally unique across loaded packages. */
+  basePath: string;
+  start(context: DoomApiContext): DoomApiHandler;
+}
+//#endregion
+//# sourceMappingURL=packageApi.d.mts.map

package/dist/schemas/packageApi.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageApi.d.mts","names":[],"sources":["../../src/schemas/packageApi.ts"],"mappings":";;;;iBAaiB;EACf;EACA;EACA,gBAAgB;;;YAIN;qBAEC,0BAA0B;;YAG3B;EACN;;EACA;EAAoB;;EACpB;EAAkB;;;iBAGP;EACf;EACA,OAAO;EACP;EACA;EACA;EACA;EACA;EACA;EACA;;;wBAIc,iBAAiB,OAAO;;qBAO3B;;qBAEA;;qBAGA;qBACA;qBACA;qBACA;YAMD;YACA;EACN;EAAmB;;EACnB;EAAoB;EAAkB,QAAQ;;;wBAGpC,kBAAkB,SAAS,UAAU;;;;;;;;;;iBA0BpC;;WAEN;;;;;EAKT,QAAQ,eAAe,qBAAqB;;EAE5C,KAAK,eAAe,qBAAqB;IAAU;IAAc;;;EAEjE,OAAO;;;iBAIQ;EACf,OAAO;;EAEP;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA,cAAc,SAAS;;EAEvB;;EAEA;;;;;EAKA,mBAAmB;;EAEnB,oBAAoB,uBAAuB;;EAE3C;IAA4B;IAAY;IAAc;IAAc;;;EAEpE;;;;;EAKA,kBAAkB;;EAElB,iBAAiB;;EAEjB,eAAe;;EAEf,gBAAgB,mBAAmB,mBAAmB,kBAAkB;;EAExE;IAAkB,MAAM,SAAS,UAAU,QAAQ;;EACnD,SAAS;;;;;;;iBAQM;EACf,MAAM,SAAS,UAAU,WAAW,QAAQ;EAC5C;;iBAGe;;EAEf;EACA,MAAM,SAAS,iBAAiB"}

package/dist/schemas/packageApi.mjs

@@ -0,0 +1,44 @@
+//#region src/schemas/packageApi.ts
+const DOOM_API_SCOPES = [
+	"global",
+	"workspace",
+	"session"
+];
+/** Canonical public prefix. Scope selection never falls through to a parent. */
+function doomApiMountPath(mount) {
+	if (mount.scope === "global") return "/api/global/plugin";
+	if (mount.scope === "workspace") return `/api/workspaces/${encodeURIComponent(mount.workspaceId)}/plugin`;
+	return `/api/sessions/${encodeURIComponent(mount.sessionId)}/plugin`;
+}
+/** The segment an API is mounted under, below this prefix. */
+const DOOM_API_ROUTE_PREFIX = "/api/plugin";
+/** Selects the hub API bundle that owns the named cockpit session. */
+const DOOM_HUB_API_SESSION_QUERY_PARAM = "hubSession";
+/** Trusted caller headers written only by the cockpit-to-session proxy. */
+const DOOM_API_CALLER_LOCALITY_HEADER = "x-doompi-api-caller-locality";
+const DOOM_API_CALLER_DEVICE_ID_HEADER = "x-doompi-api-caller-device-id";
+const DOOM_API_CALLER_STEP_UP_HEADER = "x-doompi-api-caller-step-up";
+const DOOM_API_CALLER_HEADERS = [
+	DOOM_API_CALLER_LOCALITY_HEADER,
+	DOOM_API_CALLER_DEVICE_ID_HEADER,
+	DOOM_API_CALLER_STEP_UP_HEADER
+];
+/** Reads the proxy-authenticated caller identity, rejecting partial or contradictory stamps. */
+function doomApiCallerFrom(headers) {
+	const locality = headers.get(DOOM_API_CALLER_LOCALITY_HEADER);
+	const deviceId = headers.get(DOOM_API_CALLER_DEVICE_ID_HEADER);
+	const stepUp = headers.get(DOOM_API_CALLER_STEP_UP_HEADER);
+	if (locality === "local") return deviceId === null && stepUp === "not-required" ? {
+		locality,
+		stepUp
+	} : void 0;
+	if (locality === "remote" && deviceId !== null && deviceId !== "" && (stepUp === "not-required" || stepUp === "verified" || stepUp === "unavailable")) return {
+		locality,
+		deviceId,
+		stepUp
+	};
+}
+//#endregion
+export { DOOM_API_CALLER_DEVICE_ID_HEADER, DOOM_API_CALLER_HEADERS, DOOM_API_CALLER_LOCALITY_HEADER, DOOM_API_CALLER_STEP_UP_HEADER, DOOM_API_ROUTE_PREFIX, DOOM_API_SCOPES, DOOM_HUB_API_SESSION_QUERY_PARAM, doomApiCallerFrom, doomApiMountPath };
+
+//# sourceMappingURL=packageApi.mjs.map

package/dist/schemas/packageApi.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageApi.mjs","names":[],"sources":["../../src/schemas/packageApi.ts"],"sourcesContent":["/**\n * The HTTP surface a package offers its host.\n *\n * A server facet registers one with its host. The host mounts it under the API\n * route prefix, and the package writes routes relative to that mount.\n *\n * The handler is a plain fetch callback so no host and no package is committed\n * to one HTTP framework; a Hono app satisfies it through `app.fetch`.\n */\n\nimport type { DoomDirectEventBus, DoomHubSessionService } from './hubChannel';\nimport type { DoomMcpProjection } from './mcpProjection';\n/** The host-owned sync view a repository-scoped package API may inspect. */\nexport interface DoomRepositorySyncView {\n  fresh: boolean;\n  reasons: string[];\n  mcpProjection?: DoomMcpProjection;\n}\n\n/** Where an API runs: inside one session's server, or in the machine-wide hub. */\nexport type DoomApiScope = 'global' | 'workspace' | 'session';\n\nexport const DOOM_API_SCOPES: readonly DoomApiScope[] = ['global', 'workspace', 'session'];\n\n/** Identity of an independently mounted plugin host. */\nexport type DoomApiMount =\n  | { scope: 'global' }\n  | { scope: 'workspace'; workspaceId: string }\n  | { scope: 'session'; sessionId: string };\n\n/** Immutable browser contribution generation paired with a server mount. */\nexport interface DoomWebComposition {\n  id: string;\n  scope: DoomApiScope;\n  revision: number;\n  manifestUrl: string;\n  rawAssetBaseUrl: string;\n  verifiedAssetBaseUrl: string;\n  entryPath: string;\n  stylePaths: string[];\n  channels: string[];\n}\n\n/** Canonical public prefix. Scope selection never falls through to a parent. */\nexport function doomApiMountPath(mount: DoomApiMount): string {\n  if (mount.scope === 'global') return '/api/global/plugin';\n  if (mount.scope === 'workspace') return `/api/workspaces/${encodeURIComponent(mount.workspaceId)}/plugin`;\n  return `/api/sessions/${encodeURIComponent(mount.sessionId)}/plugin`;\n}\n\n/** The segment an API is mounted under, below this prefix. */\nexport const DOOM_API_ROUTE_PREFIX = '/api/plugin';\n/** Selects the hub API bundle that owns the named cockpit session. */\nexport const DOOM_HUB_API_SESSION_QUERY_PARAM = 'hubSession';\n\n/** Trusted caller headers written only by the cockpit-to-session proxy. */\nexport const DOOM_API_CALLER_LOCALITY_HEADER = 'x-doompi-api-caller-locality';\nexport const DOOM_API_CALLER_DEVICE_ID_HEADER = 'x-doompi-api-caller-device-id';\nexport const DOOM_API_CALLER_STEP_UP_HEADER = 'x-doompi-api-caller-step-up';\nexport const DOOM_API_CALLER_HEADERS = [\n  DOOM_API_CALLER_LOCALITY_HEADER,\n  DOOM_API_CALLER_DEVICE_ID_HEADER,\n  DOOM_API_CALLER_STEP_UP_HEADER,\n] as const;\n\nexport type DoomApiCallerStepUp = 'not-required' | 'verified' | 'unavailable';\nexport type DoomApiCaller =\n  | { locality: 'local'; stepUp: 'not-required' }\n  | { locality: 'remote'; deviceId: string; stepUp: DoomApiCallerStepUp };\n\n/** Reads the proxy-authenticated caller identity, rejecting partial or contradictory stamps. */\nexport function doomApiCallerFrom(headers: Headers): DoomApiCaller | undefined {\n  const locality = headers.get(DOOM_API_CALLER_LOCALITY_HEADER);\n  const deviceId = headers.get(DOOM_API_CALLER_DEVICE_ID_HEADER);\n  const stepUp = headers.get(DOOM_API_CALLER_STEP_UP_HEADER);\n  if (locality === 'local') {\n    return deviceId === null && stepUp === 'not-required' ? { locality, stepUp } : undefined;\n  }\n  if (\n    locality === 'remote' &&\n    deviceId !== null &&\n    deviceId !== '' &&\n    (stepUp === 'not-required' || stepUp === 'verified' || stepUp === 'unavailable')\n  ) {\n    return { locality, deviceId, stepUp };\n  }\n  return undefined;\n}\n/**\n * A browser-reachable OAuth redirect the host serves on its own listener.\n *\n * A package brokering third-party OAuth cannot use a loopback redirect when the\n * operator's browser is on another machine: `127.0.0.1` resolves to whichever\n * machine the browser runs on. The host owns a listener that is reachable from\n * wherever the cockpit is being used, so it lends that instead of the package\n * opening a port of its own.\n */\nexport interface DoomOAuthRedirect {\n  /** Absolute URL to register as the redirect target, already origin-correct. */\n  readonly redirectUri: string;\n  /**\n   * Accept redirects carrying this state. Must complete before the\n   * authorization URL is surfaced, or the redirect races its own reservation.\n   */\n  reserve(state: string, timeoutMs?: number): Promise<void>;\n  /** Resolves once the redirect carrying this state arrives. */\n  wait(state: string, timeoutMs?: number): Promise<{ code: string; state: string }>;\n  /** Drops a reservation whose flow ended without a redirect. */\n  cancel(state: string): void;\n}\n\n/** What the host tells an API about itself when it starts. */\nexport interface DoomApiContext {\n  scope: DoomApiScope;\n  /** Stable, opaque identity shared by sessions in one canonical worktree. */\n  workspaceId?: string;\n  /** Canonical admitted workspace root, absent from global mounts. */\n  workspaceRoot?: string;\n  /** Explicit host home, never selected by a remote request. */\n  homeDirectory?: string;\n  /** The session this host serves; absent for a hub-scoped API. */\n  sessionId?: string;\n  /** The session's working directory; absent for a hub-scoped API. */\n  cwd?: string;\n  /** Session environment admitted by the server, never supplied by remote clients. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** Shared only with child processes in this session, never with remote API clients. */\n  internalToken?: string;\n  /** Shared only with the cockpit hub for privileged cross-session coordination. */\n  hubToken?: string;\n  /**\n   * Resolves a hub-issued opaque repository id to an admitted canonical root.\n   * Hub APIs must never accept a browser-supplied filesystem path instead.\n   */\n  resolveRepository?(repositoryId: string): string | undefined;\n  /** Reads the admitted repository's sync projection without exposing its state path. */\n  readRepositorySync?(repositoryId: string): DoomRepositorySyncView | undefined;\n  /** Admitted workspaces available to this mount. */\n  repositories?(): readonly { id: string; name: string; path: string; active: boolean }[];\n  /** Publish a successful config write to the owning mount's refresh lifecycle. */\n  configurationChanged?(): void;\n  /**\n   * Borrows the hub's OAuth redirect surface. Undefined when the hub cannot\n   * currently serve one, in which case the package keeps its own behaviour.\n   */\n  oauthRedirect?(): DoomOAuthRedirect | undefined;\n  /** Canonical in-process lifecycle for sessions created by this host. */\n  sessionService?: DoomHubSessionService;\n  /** Same-process events shared by session APIs and hub channels. */\n  directEvents?: DoomDirectEventBus;\n  /** Deliver a typed method to a channel on this exact hub mount, retaining the caller's connection identity. */\n  receiveChannel?(sessionId: string, frameType: string, payload: unknown, connectionId: string): boolean;\n  /** Machine-owned Remote Control service, mounted only by the global core facet. */\n  remoteControl?: { fetch(request: Request): Promise<Response> };\n  onNotice(message: string): void;\n}\n\n/**\n * One running surface. The host strips the mount prefix before calling, so\n * routes are declared relative ('/runners/:id/log') and a package never\n * repeats where it was mounted.\n */\nexport interface DoomApiHandler {\n  fetch(request: Request): Response | Promise<Response>;\n  close(): void;\n}\n\nexport interface DoomApi {\n  /** Segment under /api/plugin/; globally unique across loaded packages. */\n  basePath: string;\n  start(context: DoomApiContext): DoomApiHandler;\n}\n"],"mappings":";AAsBA,MAAa,kBAA2C;CAAC;CAAU;CAAa;AAAS;;AAsBzF,SAAgB,iBAAiB,OAA6B;CAC5D,IAAI,MAAM,UAAU,UAAU,OAAO;CACrC,IAAI,MAAM,UAAU,aAAa,OAAO,mBAAmB,mBAAmB,MAAM,WAAW,EAAE;CACjG,OAAO,iBAAiB,mBAAmB,MAAM,SAAS,EAAE;AAC9D;;AAGA,MAAa,wBAAwB;;AAErC,MAAa,mCAAmC;;AAGhD,MAAa,kCAAkC;AAC/C,MAAa,mCAAmC;AAChD,MAAa,iCAAiC;AAC9C,MAAa,0BAA0B;CACrC;CACA;CACA;AACF;;AAQA,SAAgB,kBAAkB,SAA6C;CAC7E,MAAM,WAAW,QAAQ,IAAI,+BAA+B;CAC5D,MAAM,WAAW,QAAQ,IAAI,gCAAgC;CAC7D,MAAM,SAAS,QAAQ,IAAI,8BAA8B;CACzD,IAAI,aAAa,SACf,OAAO,aAAa,QAAQ,WAAW,iBAAiB;EAAE;EAAU;CAAO,IAAI,KAAA;CAEjF,IACE,aAAa,YACb,aAAa,QACb,aAAa,OACZ,WAAW,kBAAkB,WAAW,cAAc,WAAW,gBAElE,OAAO;EAAE;EAAU;EAAU;CAAO;AAGxC"}

package/dist/schemas/piTool.cjs

@@ -0,0 +1,25 @@
+//#region src/schemas/piTool.ts
+function definePiTool(definition) {
+	return {
+		kind: "pi-tool",
+		name: definition.name,
+		register(pi, executionSignal) {
+			if (!executionSignal) {
+				pi.registerTool(definition);
+				return;
+			}
+			pi.registerTool({
+				...definition,
+				async execute(toolCallId, input, signal, update, context) {
+					const current = executionSignal();
+					current.throwIfAborted();
+					return definition.execute(toolCallId, input, signal ? AbortSignal.any([signal, current]) : current, update, context);
+				}
+			});
+		}
+	};
+}
+//#endregion
+exports.definePiTool = definePiTool;
+
+//# sourceMappingURL=piTool.cjs.map

package/dist/schemas/piTool.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"piTool.cjs","names":[],"sources":["../../src/schemas/piTool.ts"],"sourcesContent":["import type { ExtensionAPI, ToolDefinition } from '@earendil-works/pi-coding-agent';\nimport type { TSchema } from 'typebox';\n\n/** A schema-checked native tool whose concrete input/details types stay inside its registration closure. */\nexport interface PiToolDeclaration {\n  readonly kind: 'pi-tool';\n  readonly name: string;\n  register(pi: Pick<ExtensionAPI, 'registerTool'>, executionSignal?: () => AbortSignal): void;\n}\n\nexport function definePiTool<TParameters extends TSchema, TDetails, TState>(\n  definition: ToolDefinition<TParameters, TDetails, TState>,\n): PiToolDeclaration {\n  return {\n    kind: 'pi-tool',\n    name: definition.name,\n    register(pi, executionSignal) {\n      if (!executionSignal) {\n        pi.registerTool(definition);\n        return;\n      }\n      pi.registerTool({\n        ...definition,\n        async execute(toolCallId, input, signal, update, context) {\n          const current = executionSignal();\n          current.throwIfAborted();\n          return definition.execute(\n            toolCallId,\n            input,\n            signal ? AbortSignal.any([signal, current]) : current,\n            update,\n            context,\n          );\n        },\n      });\n    },\n  };\n}\n"],"mappings":";AAUA,SAAgB,aACd,YACmB;CACnB,OAAO;EACL,MAAM;EACN,MAAM,WAAW;EACjB,SAAS,IAAI,iBAAiB;GAC5B,IAAI,CAAC,iBAAiB;IACpB,GAAG,aAAa,UAAU;IAC1B;GACF;GACA,GAAG,aAAa;IACd,GAAG;IACH,MAAM,QAAQ,YAAY,OAAO,QAAQ,QAAQ,SAAS;KACxD,MAAM,UAAU,gBAAgB;KAChC,QAAQ,eAAe;KACvB,OAAO,WAAW,QAChB,YACA,OACA,SAAS,YAAY,IAAI,CAAC,QAAQ,OAAO,CAAC,IAAI,SAC9C,QACA,OACF;IACF;GACF,CAAC;EACH;CACF;AACF"}

package/dist/schemas/piTool.d.cts

@@ -0,0 +1,12 @@
+import { TSchema } from "typebox";
+import { ExtensionAPI, ToolDefinition } from "@earendil-works/pi-coding-agent";
+//#region src/schemas/piTool.d.ts
+/** A schema-checked native tool whose concrete input/details types stay inside its registration closure. */
+export interface PiToolDeclaration {
+  readonly kind: 'pi-tool';
+  readonly name: string;
+  register(pi: Pick<ExtensionAPI, 'registerTool'>, executionSignal?: () => AbortSignal): void;
+}
+export declare function definePiTool<TParameters extends TSchema, TDetails, TState>(definition: ToolDefinition<TParameters, TDetails, TState>): PiToolDeclaration;
+//#endregion
+//# sourceMappingURL=piTool.d.cts.map

package/dist/schemas/piTool.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"piTool.d.cts","names":[],"sources":["../../src/schemas/piTool.ts"],"mappings":";;;;iBAIiB;WACN;WACA;EACT,SAAS,IAAI,KAAK,+BAA+B,wBAAwB;;wBAG3D,aAAa,oBAAoB,SAAS,UAAU,QAClE,YAAY,eAAe,aAAa,UAAU,UACjD"}

package/dist/schemas/piTool.d.mts

@@ -0,0 +1,12 @@
+import { TSchema } from "typebox";
+import { ExtensionAPI, ToolDefinition } from "@earendil-works/pi-coding-agent";
+//#region src/schemas/piTool.d.ts
+/** A schema-checked native tool whose concrete input/details types stay inside its registration closure. */
+export interface PiToolDeclaration {
+  readonly kind: 'pi-tool';
+  readonly name: string;
+  register(pi: Pick<ExtensionAPI, 'registerTool'>, executionSignal?: () => AbortSignal): void;
+}
+export declare function definePiTool<TParameters extends TSchema, TDetails, TState>(definition: ToolDefinition<TParameters, TDetails, TState>): PiToolDeclaration;
+//#endregion
+//# sourceMappingURL=piTool.d.mts.map

package/dist/schemas/piTool.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"piTool.d.mts","names":[],"sources":["../../src/schemas/piTool.ts"],"mappings":";;;;iBAIiB;WACN;WACA;EACT,SAAS,IAAI,KAAK,+BAA+B,wBAAwB;;wBAG3D,aAAa,oBAAoB,SAAS,UAAU,QAClE,YAAY,eAAe,aAAa,UAAU,UACjD"}

package/dist/schemas/piTool.mjs

@@ -0,0 +1,25 @@
+//#region src/schemas/piTool.ts
+function definePiTool(definition) {
+	return {
+		kind: "pi-tool",
+		name: definition.name,
+		register(pi, executionSignal) {
+			if (!executionSignal) {
+				pi.registerTool(definition);
+				return;
+			}
+			pi.registerTool({
+				...definition,
+				async execute(toolCallId, input, signal, update, context) {
+					const current = executionSignal();
+					current.throwIfAborted();
+					return definition.execute(toolCallId, input, signal ? AbortSignal.any([signal, current]) : current, update, context);
+				}
+			});
+		}
+	};
+}
+//#endregion
+export { definePiTool };
+
+//# sourceMappingURL=piTool.mjs.map

package/dist/schemas/piTool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"piTool.mjs","names":[],"sources":["../../src/schemas/piTool.ts"],"sourcesContent":["import type { ExtensionAPI, ToolDefinition } from '@earendil-works/pi-coding-agent';\nimport type { TSchema } from 'typebox';\n\n/** A schema-checked native tool whose concrete input/details types stay inside its registration closure. */\nexport interface PiToolDeclaration {\n  readonly kind: 'pi-tool';\n  readonly name: string;\n  register(pi: Pick<ExtensionAPI, 'registerTool'>, executionSignal?: () => AbortSignal): void;\n}\n\nexport function definePiTool<TParameters extends TSchema, TDetails, TState>(\n  definition: ToolDefinition<TParameters, TDetails, TState>,\n): PiToolDeclaration {\n  return {\n    kind: 'pi-tool',\n    name: definition.name,\n    register(pi, executionSignal) {\n      if (!executionSignal) {\n        pi.registerTool(definition);\n        return;\n      }\n      pi.registerTool({\n        ...definition,\n        async execute(toolCallId, input, signal, update, context) {\n          const current = executionSignal();\n          current.throwIfAborted();\n          return definition.execute(\n            toolCallId,\n            input,\n            signal ? AbortSignal.any([signal, current]) : current,\n            update,\n            context,\n          );\n        },\n      });\n    },\n  };\n}\n"],"mappings":";AAUA,SAAgB,aACd,YACmB;CACnB,OAAO;EACL,MAAM;EACN,MAAM,WAAW;EACjB,SAAS,IAAI,iBAAiB;GAC5B,IAAI,CAAC,iBAAiB;IACpB,GAAG,aAAa,UAAU;IAC1B;GACF;GACA,GAAG,aAAa;IACd,GAAG;IACH,MAAM,QAAQ,YAAY,OAAO,QAAQ,QAAQ,SAAS;KACxD,MAAM,UAAU,gBAAgB;KAChC,QAAQ,eAAe;KACvB,OAAO,WAAW,QAChB,YACA,OACA,SAAS,YAAY,IAAI,CAAC,QAAQ,OAAO,CAAC,IAAI,SAC9C,QACA,OACF;IACF;GACF,CAAC;EACH;CACF;AACF"}

package/dist/schemas/pluginContributions.cjs

@@ -0,0 +1,19 @@
+//#region src/schemas/pluginContributions.ts
+/** Preserve schema inference at the declaration, before heterogeneous composition. */
+function defineTool(tool) {
+	return {
+		...tool,
+		kind: "tool"
+	};
+}
+function defineCommand(command) {
+	return {
+		...command,
+		kind: "command"
+	};
+}
+//#endregion
+exports.defineCommand = defineCommand;
+exports.defineTool = defineTool;
+
+//# sourceMappingURL=pluginContributions.cjs.map

package/dist/schemas/pluginContributions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContributions.cjs","names":[],"sources":["../../src/schemas/pluginContributions.ts"],"sourcesContent":["import type { Static, TSchema } from 'typebox';\n\nimport type { DoomNotificationRequest } from './notification';\n\n/** Capabilities available to portable commands on both agent hosts. */\nexport interface DoomPluginExecution {\n  readonly cwd: string;\n  readonly signal?: AbortSignal;\n  notify(request: DoomNotificationRequest): void | Promise<void>;\n}\n\nexport interface DoomPluginToolResult {\n  content: ({ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string })[];\n  details?: unknown;\n  isError?: boolean;\n}\n\nexport interface DoomPluginToolExecution extends DoomPluginExecution {\n  readonly toolCallId: string;\n  update(result: DoomPluginToolResult): void;\n}\n\nexport interface DoomPluginTool<TParameters extends TSchema = TSchema> {\n  readonly kind: 'tool';\n  readonly when?: {\n    readonly state?: Readonly<Record<string, string>>;\n    attribution?: { kind: 'minor' | 'domain'; mode: string; label?: string };\n    readonly domain?: string;\n  };\n  readonly name: string;\n  readonly label?: string;\n  readonly description: string;\n  readonly parameters: TParameters;\n  readonly promptSnippet?: string;\n  readonly promptGuidelines?: readonly string[];\n  readonly executionMode?: 'parallel' | 'serial';\n  execute(input: Static<TParameters>, execution: DoomPluginToolExecution): Promise<DoomPluginToolResult>;\n}\n\nexport interface DoomPluginCommand {\n  readonly kind: 'command';\n  readonly name: string;\n  readonly description: string;\n  execute(args: string, execution: DoomPluginExecution): void | Promise<void>;\n}\n\n/** Preserve schema inference at the declaration, before heterogeneous composition. */\nexport function defineTool<TParameters extends TSchema>(\n  tool: Omit<DoomPluginTool<TParameters>, 'kind'>,\n): DoomPluginTool<TParameters> {\n  return { ...tool, kind: 'tool' };\n}\n\nexport function defineCommand(command: Omit<DoomPluginCommand, 'kind'>): DoomPluginCommand {\n  return { ...command, kind: 'command' };\n}\n"],"mappings":";;AA+CA,SAAgB,WACd,MAC6B;CAC7B,OAAO;EAAE,GAAG;EAAM,MAAM;CAAO;AACjC;AAEA,SAAgB,cAAc,SAA6D;CACzF,OAAO;EAAE,GAAG;EAAS,MAAM;CAAU;AACvC"}

package/dist/schemas/pluginContributions.d.cts

@@ -0,0 +1,56 @@
+import { DoomNotificationRequest } from "./notification.cjs";
+import { Static, TSchema } from "typebox";
+//#region src/schemas/pluginContributions.d.ts
+/** Capabilities available to portable commands on both agent hosts. */
+export interface DoomPluginExecution {
+  readonly cwd: string;
+  readonly signal?: AbortSignal;
+  notify(request: DoomNotificationRequest): void | Promise<void>;
+}
+export interface DoomPluginToolResult {
+  content: ({
+    type: 'text';
+    text: string;
+  } | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+  })[];
+  details?: unknown;
+  isError?: boolean;
+}
+export interface DoomPluginToolExecution extends DoomPluginExecution {
+  readonly toolCallId: string;
+  update(result: DoomPluginToolResult): void;
+}
+export interface DoomPluginTool<TParameters extends TSchema = TSchema> {
+  readonly kind: 'tool';
+  readonly when?: {
+    readonly state?: Readonly<Record<string, string>>;
+    attribution?: {
+      kind: 'minor' | 'domain';
+      mode: string;
+      label?: string;
+    };
+    readonly domain?: string;
+  };
+  readonly name: string;
+  readonly label?: string;
+  readonly description: string;
+  readonly parameters: TParameters;
+  readonly promptSnippet?: string;
+  readonly promptGuidelines?: readonly string[];
+  readonly executionMode?: 'parallel' | 'serial';
+  execute(input: Static<TParameters>, execution: DoomPluginToolExecution): Promise<DoomPluginToolResult>;
+}
+export interface DoomPluginCommand {
+  readonly kind: 'command';
+  readonly name: string;
+  readonly description: string;
+  execute(args: string, execution: DoomPluginExecution): void | Promise<void>;
+}
+/** Preserve schema inference at the declaration, before heterogeneous composition. */
+export declare function defineTool<TParameters extends TSchema>(tool: Omit<DoomPluginTool<TParameters>, 'kind'>): DoomPluginTool<TParameters>;
+export declare function defineCommand(command: Omit<DoomPluginCommand, 'kind'>): DoomPluginCommand;
+//#endregion
+//# sourceMappingURL=pluginContributions.d.cts.map

package/dist/schemas/pluginContributions.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContributions.d.cts","names":[],"sources":["../../src/schemas/pluginContributions.ts"],"mappings":";;;;iBAKiB;WACN;WACA,SAAS;EAClB,OAAO,SAAS,iCAAiC;;iBAGlC;EACf;IAAY;IAAc;;IAAmB;IAAe;IAAc;;EAC1E;EACA;;iBAGe,gCAAgC;WACtC;EACT,OAAO,QAAQ;;iBAGA,eAAe,oBAAoB,UAAU;WACnD;WACA;aACE,QAAQ,SAAS;IAC1B;MAAgB;MAA0B;MAAc;;aAC/C;;WAEF;WACA;WACA;WACA,YAAY;WACZ;WACA;WACA;EACT,QAAQ,OAAO,OAAO,cAAc,WAAW,0BAA0B,QAAQ;;iBAGlE;WACN;WACA;WACA;EACT,QAAQ,cAAc,WAAW,6BAA6B;;;wBAIhD,WAAW,oBAAoB,SAC7C,MAAM,KAAK,eAAe,wBACzB,eAAe;wBAIF,cAAc,SAAS,KAAK,6BAA6B"}

package/dist/schemas/pluginContributions.d.mts

@@ -0,0 +1,56 @@
+import { DoomNotificationRequest } from "./notification.mjs";
+import { Static, TSchema } from "typebox";
+//#region src/schemas/pluginContributions.d.ts
+/** Capabilities available to portable commands on both agent hosts. */
+export interface DoomPluginExecution {
+  readonly cwd: string;
+  readonly signal?: AbortSignal;
+  notify(request: DoomNotificationRequest): void | Promise<void>;
+}
+export interface DoomPluginToolResult {
+  content: ({
+    type: 'text';
+    text: string;
+  } | {
+    type: 'image';
+    data: string;
+    mimeType: string;
+  })[];
+  details?: unknown;
+  isError?: boolean;
+}
+export interface DoomPluginToolExecution extends DoomPluginExecution {
+  readonly toolCallId: string;
+  update(result: DoomPluginToolResult): void;
+}
+export interface DoomPluginTool<TParameters extends TSchema = TSchema> {
+  readonly kind: 'tool';
+  readonly when?: {
+    readonly state?: Readonly<Record<string, string>>;
+    attribution?: {
+      kind: 'minor' | 'domain';
+      mode: string;
+      label?: string;
+    };
+    readonly domain?: string;
+  };
+  readonly name: string;
+  readonly label?: string;
+  readonly description: string;
+  readonly parameters: TParameters;
+  readonly promptSnippet?: string;
+  readonly promptGuidelines?: readonly string[];
+  readonly executionMode?: 'parallel' | 'serial';
+  execute(input: Static<TParameters>, execution: DoomPluginToolExecution): Promise<DoomPluginToolResult>;
+}
+export interface DoomPluginCommand {
+  readonly kind: 'command';
+  readonly name: string;
+  readonly description: string;
+  execute(args: string, execution: DoomPluginExecution): void | Promise<void>;
+}
+/** Preserve schema inference at the declaration, before heterogeneous composition. */
+export declare function defineTool<TParameters extends TSchema>(tool: Omit<DoomPluginTool<TParameters>, 'kind'>): DoomPluginTool<TParameters>;
+export declare function defineCommand(command: Omit<DoomPluginCommand, 'kind'>): DoomPluginCommand;
+//#endregion
+//# sourceMappingURL=pluginContributions.d.mts.map

package/dist/schemas/pluginContributions.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContributions.d.mts","names":[],"sources":["../../src/schemas/pluginContributions.ts"],"mappings":";;;;iBAKiB;WACN;WACA,SAAS;EAClB,OAAO,SAAS,iCAAiC;;iBAGlC;EACf;IAAY;IAAc;;IAAmB;IAAe;IAAc;;EAC1E;EACA;;iBAGe,gCAAgC;WACtC;EACT,OAAO,QAAQ;;iBAGA,eAAe,oBAAoB,UAAU;WACnD;WACA;aACE,QAAQ,SAAS;IAC1B;MAAgB;MAA0B;MAAc;;aAC/C;;WAEF;WACA;WACA;WACA,YAAY;WACZ;WACA;WACA;EACT,QAAQ,OAAO,OAAO,cAAc,WAAW,0BAA0B,QAAQ;;iBAGlE;WACN;WACA;WACA;EACT,QAAQ,cAAc,WAAW,6BAA6B;;;wBAIhD,WAAW,oBAAoB,SAC7C,MAAM,KAAK,eAAe,wBACzB,eAAe;wBAIF,cAAc,SAAS,KAAK,6BAA6B"}

package/dist/schemas/pluginContributions.mjs

@@ -0,0 +1,18 @@
+//#region src/schemas/pluginContributions.ts
+/** Preserve schema inference at the declaration, before heterogeneous composition. */
+function defineTool(tool) {
+	return {
+		...tool,
+		kind: "tool"
+	};
+}
+function defineCommand(command) {
+	return {
+		...command,
+		kind: "command"
+	};
+}
+//#endregion
+export { defineCommand, defineTool };
+
+//# sourceMappingURL=pluginContributions.mjs.map

package/dist/schemas/pluginContributions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginContributions.mjs","names":[],"sources":["../../src/schemas/pluginContributions.ts"],"sourcesContent":["import type { Static, TSchema } from 'typebox';\n\nimport type { DoomNotificationRequest } from './notification';\n\n/** Capabilities available to portable commands on both agent hosts. */\nexport interface DoomPluginExecution {\n  readonly cwd: string;\n  readonly signal?: AbortSignal;\n  notify(request: DoomNotificationRequest): void | Promise<void>;\n}\n\nexport interface DoomPluginToolResult {\n  content: ({ type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string })[];\n  details?: unknown;\n  isError?: boolean;\n}\n\nexport interface DoomPluginToolExecution extends DoomPluginExecution {\n  readonly toolCallId: string;\n  update(result: DoomPluginToolResult): void;\n}\n\nexport interface DoomPluginTool<TParameters extends TSchema = TSchema> {\n  readonly kind: 'tool';\n  readonly when?: {\n    readonly state?: Readonly<Record<string, string>>;\n    attribution?: { kind: 'minor' | 'domain'; mode: string; label?: string };\n    readonly domain?: string;\n  };\n  readonly name: string;\n  readonly label?: string;\n  readonly description: string;\n  readonly parameters: TParameters;\n  readonly promptSnippet?: string;\n  readonly promptGuidelines?: readonly string[];\n  readonly executionMode?: 'parallel' | 'serial';\n  execute(input: Static<TParameters>, execution: DoomPluginToolExecution): Promise<DoomPluginToolResult>;\n}\n\nexport interface DoomPluginCommand {\n  readonly kind: 'command';\n  readonly name: string;\n  readonly description: string;\n  execute(args: string, execution: DoomPluginExecution): void | Promise<void>;\n}\n\n/** Preserve schema inference at the declaration, before heterogeneous composition. */\nexport function defineTool<TParameters extends TSchema>(\n  tool: Omit<DoomPluginTool<TParameters>, 'kind'>,\n): DoomPluginTool<TParameters> {\n  return { ...tool, kind: 'tool' };\n}\n\nexport function defineCommand(command: Omit<DoomPluginCommand, 'kind'>): DoomPluginCommand {\n  return { ...command, kind: 'command' };\n}\n"],"mappings":";;AA+CA,SAAgB,WACd,MAC6B;CAC7B,OAAO;EAAE,GAAG;EAAM,MAAM;CAAO;AACjC;AAEA,SAAgB,cAAc,SAA6D;CACzF,OAAO;EAAE,GAAG;EAAS,MAAM;CAAU;AACvC"}

package/dist/schemas/pluginProtocol.cjs

@@ -0,0 +1,103 @@
+let typebox = require("typebox");
+let typebox_value = require("typebox/value");
+let _earendil_works_chord = require("@earendil-works/chord");
+//#region src/schemas/pluginProtocol.ts
+/** The address is always exact. A workspace call never resolves to a global service. */
+const DoomPluginMountSchema = typebox.Type.Union([
+	typebox.Type.Object({ scope: typebox.Type.Literal("global") }, { additionalProperties: false }),
+	typebox.Type.Object({
+		scope: typebox.Type.Literal("workspace"),
+		workspaceId: typebox.Type.String({ minLength: 1 })
+	}, { additionalProperties: false }),
+	typebox.Type.Object({
+		scope: typebox.Type.Literal("session"),
+		sessionId: typebox.Type.String({ minLength: 1 })
+	}, { additionalProperties: false })
+]);
+const DoomPluginCallSchema = typebox.Type.Object({
+	mount: DoomPluginMountSchema,
+	service: typebox.Type.String({ minLength: 1 }),
+	method: typebox.Type.String({ minLength: 1 }),
+	input: typebox.Type.Unknown()
+}, { additionalProperties: false });
+const DoomPluginService = (0, _earendil_works_chord.defineService)("doompi.plugin.v1");
+function defineDoomPluginMethod(definition) {
+	if (!definition.service || !definition.method) throw new Error("Plugin service and method must be named.");
+	return definition;
+}
+function doomPluginMountKey(mount) {
+	if (!(0, typebox_value.Check)(DoomPluginMountSchema, mount)) throw new Error("Invalid plugin mount.");
+	switch (mount.scope) {
+		case "global": return "global";
+		case "workspace": return `workspace:${mount.workspaceId}`;
+		case "session": return `session:${mount.sessionId}`;
+	}
+}
+var DoomPluginCallError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+		this.name = "DoomPluginCallError";
+	}
+};
+/** Transport-neutral dispatch, shared by Chord server services and client capability hosts. */
+function createDoomPluginRegistry() {
+	const handlers = /* @__PURE__ */ new Map();
+	let disposed = false;
+	const keyOf = (mount, service, method, direction) => `${doomPluginMountKey(mount)}\0${direction}\0${service}\0${method}`;
+	return {
+		register(mount, definition, handler) {
+			if (disposed) throw new Error("Plugin registry is disposed.");
+			if (mount.scope !== definition.scope) throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);
+			const key = keyOf(mount, definition.service, definition.method, definition.direction);
+			if (handlers.has(key)) throw new Error(`Plugin method '${definition.service}.${definition.method}' is already mounted.`);
+			const entry = {
+				definition,
+				handler
+			};
+			handlers.set(key, entry);
+			return () => {
+				if (handlers.get(key) === entry) handlers.delete(key);
+			};
+		},
+		async invoke(value, direction, caller = {}) {
+			if (disposed) throw new Error("Plugin registry is disposed.");
+			if (!(0, typebox_value.Check)(DoomPluginCallSchema, value)) throw new DoomPluginCallError("INVALID_CALL", "Invalid plugin call.");
+			const call = value;
+			const entry = handlers.get(keyOf(call.mount, call.service, call.method, direction));
+			if (!entry) throw new DoomPluginCallError("METHOD_NOT_FOUND", `Plugin method '${call.service}.${call.method}' is not mounted at this scope.`);
+			if (!(0, typebox_value.Check)(entry.definition.input, call.input)) throw new DoomPluginCallError("INVALID_INPUT", `Invalid input for '${call.service}.${call.method}'.`);
+			const output = await entry.handler(call.input, caller);
+			if (!(0, typebox_value.Check)(entry.definition.output, output)) throw new DoomPluginCallError("INVALID_OUTPUT", `Invalid output from '${call.service}.${call.method}'.`);
+			return output;
+		},
+		dispose() {
+			disposed = true;
+			handlers.clear();
+		}
+	};
+}
+async function invokeDoomPluginMethod(transport, mount, definition, input) {
+	if (mount.scope !== definition.scope) throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);
+	if (!(0, typebox_value.Check)(definition.input, input)) throw new DoomPluginCallError("INVALID_INPUT", `Invalid input for '${definition.service}.${definition.method}'.`);
+	const output = await transport({
+		mount,
+		service: definition.service,
+		method: definition.method,
+		input
+	});
+	if (!(0, typebox_value.Check)(definition.output, output)) throw new DoomPluginCallError("INVALID_OUTPUT", `Invalid output from '${definition.service}.${definition.method}'.`);
+	return output;
+}
+//#endregion
+exports.DoomPluginCallError = DoomPluginCallError;
+exports.DoomPluginCallSchema = DoomPluginCallSchema;
+exports.DoomPluginMountSchema = DoomPluginMountSchema;
+exports.DoomPluginService = DoomPluginService;
+exports.createDoomPluginRegistry = createDoomPluginRegistry;
+exports.defineDoomPluginMethod = defineDoomPluginMethod;
+exports.doomPluginMountKey = doomPluginMountKey;
+exports.invokeDoomPluginMethod = invokeDoomPluginMethod;
+
+//# sourceMappingURL=pluginProtocol.cjs.map

package/dist/schemas/pluginProtocol.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginProtocol.cjs","names":["Type","defineService","Check"],"sources":["../../src/schemas/pluginProtocol.ts"],"sourcesContent":["import { defineService, type Context, type JsonValue } from '@earendil-works/chord';\nimport { type Static, type TSchema, Type } from 'typebox';\nimport { Check } from 'typebox/value';\n\nimport type { DoomApiMount, DoomApiScope } from './packageApi';\n\n/** The address is always exact. A workspace call never resolves to a global service. */\nexport const DoomPluginMountSchema = Type.Union([\n  Type.Object({ scope: Type.Literal('global') }, { additionalProperties: false }),\n  Type.Object(\n    { scope: Type.Literal('workspace'), workspaceId: Type.String({ minLength: 1 }) },\n    { additionalProperties: false },\n  ),\n  Type.Object(\n    { scope: Type.Literal('session'), sessionId: Type.String({ minLength: 1 }) },\n    { additionalProperties: false },\n  ),\n]);\n\nexport const DoomPluginCallSchema = Type.Object(\n  {\n    mount: DoomPluginMountSchema,\n    service: Type.String({ minLength: 1 }),\n    method: Type.String({ minLength: 1 }),\n    input: Type.Unknown(),\n  },\n  { additionalProperties: false },\n);\n\nexport type DoomPluginCall = Static<typeof DoomPluginCallSchema>;\nexport type DoomPluginDirection = 'client-to-server' | 'server-to-client';\nexport interface DoomPluginCaller {\n  /** Authenticated connection that owns client capabilities and leases. */\n  connectionId?: string;\n}\n\n/** Chord method shared by all authenticated Doompi clients. */\nexport interface DoomPluginService {\n  invoke(\n    call: {\n      mount: DoomApiMount;\n      service: string;\n      method: string;\n      input: JsonValue;\n    },\n    context: Context,\n  ): Promise<JsonValue>;\n}\n\nexport const DoomPluginService = defineService<DoomPluginService>('doompi.plugin.v1');\n\nexport interface DoomPluginMethod<TInput extends TSchema, TOutput extends TSchema> {\n  readonly service: string;\n  readonly method: string;\n  readonly scope: DoomApiScope;\n  readonly direction: DoomPluginDirection;\n  readonly input: TInput;\n  readonly output: TOutput;\n}\n\nexport function defineDoomPluginMethod<TInput extends TSchema, TOutput extends TSchema>(\n  definition: DoomPluginMethod<TInput, TOutput>,\n): DoomPluginMethod<TInput, TOutput> {\n  if (!definition.service || !definition.method) throw new Error('Plugin service and method must be named.');\n  return definition;\n}\n\nexport function doomPluginMountKey(mount: DoomApiMount): string {\n  if (!Check(DoomPluginMountSchema, mount)) throw new Error('Invalid plugin mount.');\n  switch (mount.scope) {\n    case 'global':\n      return 'global';\n    case 'workspace':\n      return `workspace:${mount.workspaceId}`;\n    case 'session':\n      return `session:${mount.sessionId}`;\n  }\n}\n\nexport class DoomPluginCallError extends Error {\n  constructor(\n    readonly code: 'INVALID_CALL' | 'METHOD_NOT_FOUND' | 'INVALID_INPUT' | 'INVALID_OUTPUT',\n    message: string,\n  ) {\n    super(message);\n    this.name = 'DoomPluginCallError';\n  }\n}\n\nexport interface DoomPluginRegistry {\n  register<TInput extends TSchema, TOutput extends TSchema>(\n    mount: DoomApiMount,\n    definition: DoomPluginMethod<TInput, TOutput>,\n    handler: (input: Static<TInput>, caller: DoomPluginCaller) => Static<TOutput> | Promise<Static<TOutput>>,\n  ): () => void;\n  invoke(call: unknown, direction: DoomPluginDirection, caller?: DoomPluginCaller): Promise<unknown>;\n  dispose(): void;\n}\n\n/** Transport-neutral dispatch, shared by Chord server services and client capability hosts. */\nexport function createDoomPluginRegistry(): DoomPluginRegistry {\n  const handlers = new Map<\n    string,\n    {\n      definition: DoomPluginMethod<TSchema, TSchema>;\n      handler: (input: never, caller: DoomPluginCaller) => unknown;\n    }\n  >();\n  let disposed = false;\n  const keyOf = (mount: DoomApiMount, service: string, method: string, direction: DoomPluginDirection): string =>\n    `${doomPluginMountKey(mount)}\\0${direction}\\0${service}\\0${method}`;\n  return {\n    register(mount, definition, handler) {\n      if (disposed) throw new Error('Plugin registry is disposed.');\n      if (mount.scope !== definition.scope)\n        throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);\n      const key = keyOf(mount, definition.service, definition.method, definition.direction);\n      if (handlers.has(key))\n        throw new Error(`Plugin method '${definition.service}.${definition.method}' is already mounted.`);\n      const entry = { definition, handler } as typeof handlers extends Map<string, infer TValue> ? TValue : never;\n      handlers.set(key, entry);\n      return () => {\n        if (handlers.get(key) === entry) handlers.delete(key);\n      };\n    },\n    async invoke(value, direction, caller = {}) {\n      if (disposed) throw new Error('Plugin registry is disposed.');\n      if (!Check(DoomPluginCallSchema, value)) throw new DoomPluginCallError('INVALID_CALL', 'Invalid plugin call.');\n      const call = value as DoomPluginCall;\n      const entry = handlers.get(keyOf(call.mount, call.service, call.method, direction));\n      if (!entry)\n        throw new DoomPluginCallError(\n          'METHOD_NOT_FOUND',\n          `Plugin method '${call.service}.${call.method}' is not mounted at this scope.`,\n        );\n      if (!Check(entry.definition.input, call.input))\n        throw new DoomPluginCallError('INVALID_INPUT', `Invalid input for '${call.service}.${call.method}'.`);\n      const output = await entry.handler(call.input as never, caller);\n      if (!Check(entry.definition.output, output))\n        throw new DoomPluginCallError('INVALID_OUTPUT', `Invalid output from '${call.service}.${call.method}'.`);\n      return output;\n    },\n    dispose() {\n      disposed = true;\n      handlers.clear();\n    },\n  };\n}\n\nexport async function invokeDoomPluginMethod<TInput extends TSchema, TOutput extends TSchema>(\n  transport: (call: DoomPluginCall) => Promise<unknown>,\n  mount: DoomApiMount,\n  definition: DoomPluginMethod<TInput, TOutput>,\n  input: Static<TInput>,\n): Promise<Static<TOutput>> {\n  if (mount.scope !== definition.scope)\n    throw new Error(`Method '${definition.service}.${definition.method}' requires ${definition.scope} scope.`);\n  if (!Check(definition.input, input))\n    throw new DoomPluginCallError('INVALID_INPUT', `Invalid input for '${definition.service}.${definition.method}'.`);\n  const output = await transport({ mount, service: definition.service, method: definition.method, input });\n  if (!Check(definition.output, output))\n    throw new DoomPluginCallError(\n      'INVALID_OUTPUT',\n      `Invalid output from '${definition.service}.${definition.method}'.`,\n    );\n  return output;\n}\n"],"mappings":"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"}