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

package/dist/src/schemas/askUser.mjs

@@ -0,0 +1,37 @@
+import { Type } from "typebox";
+//#region src/schemas/askUser.ts
+/** Namespaced Cordis events emitted by the ask-user provider. */
+const DOOM_ASK_USER_PROMPT_EVENT = "doom/ask-user/prompt";
+const DOOM_ASK_USER_BLOCKED_EVENT = "doom/ask-user/blocked";
+const MAX_QUESTIONS = 3;
+const MAX_OPTIONS = 16;
+const MAX_TEXT_LENGTH = 4096;
+const AskUserPromptOptionSchema = Type.Object({
+	label: Type.String({
+		minLength: 1,
+		maxLength: MAX_TEXT_LENGTH
+	}),
+	description: Type.String({ maxLength: MAX_TEXT_LENGTH }),
+	hasPreview: Type.Boolean()
+}, { additionalProperties: false });
+const AskUserPromptQuestionSchema = Type.Object({
+	question: Type.String({
+		minLength: 1,
+		maxLength: MAX_TEXT_LENGTH
+	}),
+	header: Type.String({
+		minLength: 1,
+		maxLength: MAX_TEXT_LENGTH
+	}),
+	multiSelect: Type.Boolean(),
+	options: Type.Array(AskUserPromptOptionSchema, { maxItems: MAX_OPTIONS })
+}, { additionalProperties: false });
+const AskUserPromptEventSchema = Type.Object({ questions: Type.Array(AskUserPromptQuestionSchema, {
+	minItems: 1,
+	maxItems: MAX_QUESTIONS
+}) }, { additionalProperties: false });
+const AskUserBlockedEventSchema = Type.Object({ active: Type.Boolean() }, { additionalProperties: false });
+//#endregion
+export { AskUserBlockedEventSchema, AskUserPromptEventSchema, AskUserPromptOptionSchema, AskUserPromptQuestionSchema, DOOM_ASK_USER_BLOCKED_EVENT, DOOM_ASK_USER_PROMPT_EVENT };
+
+//# sourceMappingURL=askUser.mjs.map

package/dist/src/schemas/askUser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"askUser.mjs","names":[],"sources":["../../../src/schemas/askUser.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\n/** Namespaced Cordis events emitted by the ask-user provider. */\nexport const DOOM_ASK_USER_PROMPT_EVENT = 'doom/ask-user/prompt';\nexport const DOOM_ASK_USER_BLOCKED_EVENT = 'doom/ask-user/blocked';\n\nconst MAX_QUESTIONS = 3;\nconst MAX_OPTIONS = 16;\nconst MAX_TEXT_LENGTH = 4_096;\n\nexport const AskUserPromptOptionSchema = Type.Object(\n  {\n    label: Type.String({ minLength: 1, maxLength: MAX_TEXT_LENGTH }),\n    description: Type.String({ maxLength: MAX_TEXT_LENGTH }),\n    hasPreview: Type.Boolean(),\n  },\n  { additionalProperties: false },\n);\nexport type AskUserPromptOption = Static<typeof AskUserPromptOptionSchema>;\n\nexport const AskUserPromptQuestionSchema = Type.Object(\n  {\n    question: Type.String({ minLength: 1, maxLength: MAX_TEXT_LENGTH }),\n    header: Type.String({ minLength: 1, maxLength: MAX_TEXT_LENGTH }),\n    multiSelect: Type.Boolean(),\n    options: Type.Array(AskUserPromptOptionSchema, { maxItems: MAX_OPTIONS }),\n  },\n  { additionalProperties: false },\n);\nexport type AskUserPromptQuestion = Static<typeof AskUserPromptQuestionSchema>;\n\nexport const AskUserPromptEventSchema = Type.Object(\n  { questions: Type.Array(AskUserPromptQuestionSchema, { minItems: 1, maxItems: MAX_QUESTIONS }) },\n  { additionalProperties: false },\n);\nexport type AskUserPromptEvent = Static<typeof AskUserPromptEventSchema>;\n\nexport const AskUserBlockedEventSchema = Type.Object({ active: Type.Boolean() }, { additionalProperties: false });\nexport type AskUserBlockedEvent = Static<typeof AskUserBlockedEventSchema>;\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Events {\n    'doom/ask-user/prompt'(event: AskUserPromptEvent): void;\n    'doom/ask-user/blocked'(event: AskUserBlockedEvent): void;\n  }\n}\n"],"mappings":";;;AAGA,MAAa,6BAA6B;AAC1C,MAAa,8BAA8B;AAE3C,MAAM,gBAAgB;AACtB,MAAM,cAAc;AACpB,MAAM,kBAAkB;AAExB,MAAa,4BAA4B,KAAK,OAC5C;CACE,OAAO,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAgB,CAAC;CAC/D,aAAa,KAAK,OAAO,EAAE,WAAW,gBAAgB,CAAC;CACvD,YAAY,KAAK,QAAQ;AAC3B,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,8BAA8B,KAAK,OAC9C;CACE,UAAU,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAgB,CAAC;CAClE,QAAQ,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAgB,CAAC;CAChE,aAAa,KAAK,QAAQ;CAC1B,SAAS,KAAK,MAAM,2BAA2B,EAAE,UAAU,YAAY,CAAC;AAC1E,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,2BAA2B,KAAK,OAC3C,EAAE,WAAW,KAAK,MAAM,6BAA6B;CAAE,UAAU;CAAG,UAAU;AAAc,CAAC,EAAE,GAC/F,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,4BAA4B,KAAK,OAAO,EAAE,QAAQ,KAAK,QAAQ,EAAE,GAAG,EAAE,sBAAsB,MAAM,CAAC"}

package/dist/src/schemas/backgroundWork.cjs

@@ -0,0 +1,31 @@
+let typebox = require("typebox");
+//#region src/schemas/backgroundWork.ts
+/** Cordis service that owns pull-based background-work contributions for Pi sessions. */
+const DOOM_BACKGROUND_WORK_SERVICE = "doom/background-work";
+/**
+* Snapshot invalidation only. Consumers must reread the authoritative service snapshot
+* and must not infer current work from the event payload.
+*/
+const DOOM_BACKGROUND_WORK_CHANGED_EVENT = "doom/background-work/changed";
+const BackgroundProviderWorkItemSchema = typebox.Type.Object({
+	id: typebox.Type.String({ minLength: 1 }),
+	sessionId: typebox.Type.String({ minLength: 1 }),
+	label: typebox.Type.Optional(typebox.Type.String({ minLength: 1 })),
+	status: typebox.Type.Optional(typebox.Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+const BackgroundWorkItemSchema = typebox.Type.Object({
+	...BackgroundProviderWorkItemSchema.properties,
+	provider: typebox.Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+/** Reads the active host-owned background-work coordination service. */
+function readDoomBackgroundWorkService(ctx) {
+	return ctx.get(DOOM_BACKGROUND_WORK_SERVICE);
+}
+//#endregion
+exports.BackgroundProviderWorkItemSchema = BackgroundProviderWorkItemSchema;
+exports.BackgroundWorkItemSchema = BackgroundWorkItemSchema;
+exports.DOOM_BACKGROUND_WORK_CHANGED_EVENT = DOOM_BACKGROUND_WORK_CHANGED_EVENT;
+exports.DOOM_BACKGROUND_WORK_SERVICE = DOOM_BACKGROUND_WORK_SERVICE;
+exports.readDoomBackgroundWorkService = readDoomBackgroundWorkService;
+
+//# sourceMappingURL=backgroundWork.cjs.map

package/dist/src/schemas/backgroundWork.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundWork.cjs","names":["Type"],"sources":["../../../src/schemas/backgroundWork.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport { type Static, Type } from 'typebox';\n\n/** Cordis service that owns pull-based background-work contributions for Pi sessions. */\nexport const DOOM_BACKGROUND_WORK_SERVICE = 'doom/background-work';\n/**\n * Snapshot invalidation only. Consumers must reread the authoritative service snapshot\n * and must not infer current work from the event payload.\n */\nexport const DOOM_BACKGROUND_WORK_CHANGED_EVENT = 'doom/background-work/changed';\n\nexport const BackgroundProviderWorkItemSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1 }),\n    sessionId: Type.String({ minLength: 1 }),\n    label: Type.Optional(Type.String({ minLength: 1 })),\n    status: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\nexport type BackgroundProviderWorkItem = Static<typeof BackgroundProviderWorkItemSchema>;\n\nexport const BackgroundWorkItemSchema = Type.Object(\n  { ...BackgroundProviderWorkItemSchema.properties, provider: Type.String({ minLength: 1 }) },\n  { additionalProperties: false },\n);\nexport type BackgroundWorkItem = Static<typeof BackgroundWorkItemSchema>;\n\nexport interface BackgroundWorkProvider {\n  readonly provider: string;\n  /**\n   * Returns the current authoritative work set. Items must use their owning Pi session ID.\n   * Publish work before releasing asynchronous launch ownership, and retain terminal items\n   * until Pi accepts their completion handoff or a durable fallback owns delivery.\n   */\n  listActiveWork(): readonly BackgroundProviderWorkItem[];\n}\n\nexport interface BackgroundWorkProviderHandle {\n  readonly provider: string;\n  readonly generation: string;\n  /** Announces that the provider's pull-based snapshot changed. This carries no snapshot state. */\n  update(): void;\n  dispose(): void;\n}\n\nexport interface DoomBackgroundWorkSnapshot {\n  readonly items: readonly BackgroundWorkItem[];\n  readonly errors: readonly { readonly provider: string; readonly message: string }[];\n}\n\nexport interface DoomBackgroundWorkChanged {\n  readonly provider: string;\n  readonly generation: string;\n  readonly kind: 'registered' | 'updated' | 'unregistered';\n}\n\nexport interface DoomBackgroundWorkService {\n  /** Changes when the owning coordination service is replaced. */\n  readonly generation: string;\n  register(provider: BackgroundWorkProvider): BackgroundWorkProviderHandle;\n  /** Returns an authoritative snapshot, filtered to an exact session when supplied. */\n  snapshot(sessionId?: string): DoomBackgroundWorkSnapshot;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/background-work': DoomBackgroundWorkService;\n  }\n\n  interface Events {\n    'doom/background-work/changed'(event: DoomBackgroundWorkChanged): void;\n  }\n}\n\n/** Reads the active host-owned background-work coordination service. */\nexport function readDoomBackgroundWorkService(ctx: Context): DoomBackgroundWorkService | undefined {\n  return ctx.get(DOOM_BACKGROUND_WORK_SERVICE) as DoomBackgroundWorkService | undefined;\n}\n"],"mappings":";;;AAIA,MAAa,+BAA+B;;;;;AAK5C,MAAa,qCAAqC;AAElD,MAAa,mCAAmCA,QAAAA,KAAK,OACnD;CACE,IAAIA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAChC,WAAWA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CACvC,OAAOA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;CAClD,QAAQA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACrD,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,2BAA2BA,QAAAA,KAAK,OAC3C;CAAE,GAAG,iCAAiC;CAAY,UAAUA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;AAAE,GAC1F,EAAE,sBAAsB,MAAM,CAChC;;AAmDA,SAAgB,8BAA8B,KAAqD;CACjG,OAAO,IAAI,IAAI,4BAA4B;AAC7C"}

package/dist/src/schemas/backgroundWork.d.mts

@@ -0,0 +1,72 @@
+import { Static, Type } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/backgroundWork.d.ts
+/** Cordis service that owns pull-based background-work contributions for Pi sessions. */
+export declare const DOOM_BACKGROUND_WORK_SERVICE = "doom/background-work";
+/**
+ * Snapshot invalidation only. Consumers must reread the authoritative service snapshot
+ * and must not infer current work from the event payload.
+ */
+export declare const DOOM_BACKGROUND_WORK_CHANGED_EVENT = "doom/background-work/changed";
+export declare const BackgroundProviderWorkItemSchema: Type.TObject<{
+  id: Type.TString;
+  sessionId: Type.TString;
+  label: Type.TOptional<Type.TString>;
+  status: Type.TOptional<Type.TString>;
+}>;
+export type BackgroundProviderWorkItem = Static<typeof BackgroundProviderWorkItemSchema>;
+export declare const BackgroundWorkItemSchema: Type.TObject<{
+  id: Type.TString;
+  sessionId: Type.TString;
+  label: Type.TOptional<Type.TString>;
+  status: Type.TOptional<Type.TString>;
+  provider: Type.TString;
+}>;
+export type BackgroundWorkItem = Static<typeof BackgroundWorkItemSchema>;
+export interface BackgroundWorkProvider {
+  readonly provider: string;
+  /**
+   * Returns the current authoritative work set. Items must use their owning Pi session ID.
+   * Publish work before releasing asynchronous launch ownership, and retain terminal items
+   * until Pi accepts their completion handoff or a durable fallback owns delivery.
+   */
+  listActiveWork(): readonly BackgroundProviderWorkItem[];
+}
+export interface BackgroundWorkProviderHandle {
+  readonly provider: string;
+  readonly generation: string;
+  /** Announces that the provider's pull-based snapshot changed. This carries no snapshot state. */
+  update(): void;
+  dispose(): void;
+}
+export interface DoomBackgroundWorkSnapshot {
+  readonly items: readonly BackgroundWorkItem[];
+  readonly errors: readonly {
+    readonly provider: string;
+    readonly message: string;
+  }[];
+}
+export interface DoomBackgroundWorkChanged {
+  readonly provider: string;
+  readonly generation: string;
+  readonly kind: 'registered' | 'updated' | 'unregistered';
+}
+export interface DoomBackgroundWorkService {
+  /** Changes when the owning coordination service is replaced. */
+  readonly generation: string;
+  register(provider: BackgroundWorkProvider): BackgroundWorkProviderHandle;
+  /** Returns an authoritative snapshot, filtered to an exact session when supplied. */
+  snapshot(sessionId?: string): DoomBackgroundWorkSnapshot;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/background-work': DoomBackgroundWorkService;
+  }
+  interface Events {
+    'doom/background-work/changed'(event: DoomBackgroundWorkChanged): void;
+  }
+}
+/** Reads the active host-owned background-work coordination service. */
+export declare function readDoomBackgroundWorkService(ctx: Context): DoomBackgroundWorkService | undefined;
+//#endregion
+//# sourceMappingURL=backgroundWork.d.mts.map

package/dist/src/schemas/backgroundWork.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundWork.d.mts","names":[],"sources":["../../../src/schemas/backgroundWork.ts"],"mappings":";;;;qBAIa;;;;;qBAKA;qBAEA,kCAAgC,KAAA;;;;;;YASjC,6BAA6B,cAAc;qBAE1C,0BAAwB,KAAA;;;;;;;YAIzB,qBAAqB,cAAc;iBAE9B;WACN;;;;;;EAMT,2BAA2B;;iBAGZ;WACN;WACA;;EAET;EACA;;iBAGe;WACN,gBAAgB;WAChB;aAA4B;aAA2B;;;iBAGjD;WACN;WACA;WACA;;iBAGM;;WAEN;EACT,SAAS,UAAU,yBAAyB;;EAE5C,SAAS,qBAAqB;;;YAIpB;IACR,wBAAwB;;YAGhB;IACR,+BAA+B,OAAO;;;;wBAK1B,8BAA8B,KAAK,UAAU"}

package/dist/src/schemas/backgroundWork.mjs

@@ -0,0 +1,27 @@
+import { Type } from "typebox";
+//#region src/schemas/backgroundWork.ts
+/** Cordis service that owns pull-based background-work contributions for Pi sessions. */
+const DOOM_BACKGROUND_WORK_SERVICE = "doom/background-work";
+/**
+* Snapshot invalidation only. Consumers must reread the authoritative service snapshot
+* and must not infer current work from the event payload.
+*/
+const DOOM_BACKGROUND_WORK_CHANGED_EVENT = "doom/background-work/changed";
+const BackgroundProviderWorkItemSchema = Type.Object({
+	id: Type.String({ minLength: 1 }),
+	sessionId: Type.String({ minLength: 1 }),
+	label: Type.Optional(Type.String({ minLength: 1 })),
+	status: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+const BackgroundWorkItemSchema = Type.Object({
+	...BackgroundProviderWorkItemSchema.properties,
+	provider: Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+/** Reads the active host-owned background-work coordination service. */
+function readDoomBackgroundWorkService(ctx) {
+	return ctx.get(DOOM_BACKGROUND_WORK_SERVICE);
+}
+//#endregion
+export { BackgroundProviderWorkItemSchema, BackgroundWorkItemSchema, DOOM_BACKGROUND_WORK_CHANGED_EVENT, DOOM_BACKGROUND_WORK_SERVICE, readDoomBackgroundWorkService };
+
+//# sourceMappingURL=backgroundWork.mjs.map

package/dist/src/schemas/backgroundWork.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundWork.mjs","names":[],"sources":["../../../src/schemas/backgroundWork.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport { type Static, Type } from 'typebox';\n\n/** Cordis service that owns pull-based background-work contributions for Pi sessions. */\nexport const DOOM_BACKGROUND_WORK_SERVICE = 'doom/background-work';\n/**\n * Snapshot invalidation only. Consumers must reread the authoritative service snapshot\n * and must not infer current work from the event payload.\n */\nexport const DOOM_BACKGROUND_WORK_CHANGED_EVENT = 'doom/background-work/changed';\n\nexport const BackgroundProviderWorkItemSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1 }),\n    sessionId: Type.String({ minLength: 1 }),\n    label: Type.Optional(Type.String({ minLength: 1 })),\n    status: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\nexport type BackgroundProviderWorkItem = Static<typeof BackgroundProviderWorkItemSchema>;\n\nexport const BackgroundWorkItemSchema = Type.Object(\n  { ...BackgroundProviderWorkItemSchema.properties, provider: Type.String({ minLength: 1 }) },\n  { additionalProperties: false },\n);\nexport type BackgroundWorkItem = Static<typeof BackgroundWorkItemSchema>;\n\nexport interface BackgroundWorkProvider {\n  readonly provider: string;\n  /**\n   * Returns the current authoritative work set. Items must use their owning Pi session ID.\n   * Publish work before releasing asynchronous launch ownership, and retain terminal items\n   * until Pi accepts their completion handoff or a durable fallback owns delivery.\n   */\n  listActiveWork(): readonly BackgroundProviderWorkItem[];\n}\n\nexport interface BackgroundWorkProviderHandle {\n  readonly provider: string;\n  readonly generation: string;\n  /** Announces that the provider's pull-based snapshot changed. This carries no snapshot state. */\n  update(): void;\n  dispose(): void;\n}\n\nexport interface DoomBackgroundWorkSnapshot {\n  readonly items: readonly BackgroundWorkItem[];\n  readonly errors: readonly { readonly provider: string; readonly message: string }[];\n}\n\nexport interface DoomBackgroundWorkChanged {\n  readonly provider: string;\n  readonly generation: string;\n  readonly kind: 'registered' | 'updated' | 'unregistered';\n}\n\nexport interface DoomBackgroundWorkService {\n  /** Changes when the owning coordination service is replaced. */\n  readonly generation: string;\n  register(provider: BackgroundWorkProvider): BackgroundWorkProviderHandle;\n  /** Returns an authoritative snapshot, filtered to an exact session when supplied. */\n  snapshot(sessionId?: string): DoomBackgroundWorkSnapshot;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/background-work': DoomBackgroundWorkService;\n  }\n\n  interface Events {\n    'doom/background-work/changed'(event: DoomBackgroundWorkChanged): void;\n  }\n}\n\n/** Reads the active host-owned background-work coordination service. */\nexport function readDoomBackgroundWorkService(ctx: Context): DoomBackgroundWorkService | undefined {\n  return ctx.get(DOOM_BACKGROUND_WORK_SERVICE) as DoomBackgroundWorkService | undefined;\n}\n"],"mappings":";;;AAIA,MAAa,+BAA+B;;;;;AAK5C,MAAa,qCAAqC;AAElD,MAAa,mCAAmC,KAAK,OACnD;CACE,IAAI,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAChC,WAAW,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CACvC,OAAO,KAAK,SAAS,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;CAClD,QAAQ,KAAK,SAAS,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACrD,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,2BAA2B,KAAK,OAC3C;CAAE,GAAG,iCAAiC;CAAY,UAAU,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;AAAE,GAC1F,EAAE,sBAAsB,MAAM,CAChC;;AAmDA,SAAgB,8BAA8B,KAAqD;CACjG,OAAO,IAAI,IAAI,4BAA4B;AAC7C"}

package/dist/src/schemas/childProcess.cjs

@@ -0,0 +1,67 @@
+let typebox = require("typebox");
+let typebox_value = require("typebox/value");
+//#region src/schemas/childProcess.ts
+const SUBAGENT_CHILD_ENV = "PI_SUBAGENT_CHILD";
+const SUBAGENT_PARENT_SESSION_ENV = "PI_SUBAGENT_PARENT_SESSION";
+const SUBAGENT_ROOT_SESSION_ENV = "PI_SUBAGENT_ROOT_SESSION";
+const DOOM_CHILD_PROCESS_CONTEXT_ENV = "DOOM_CHILD_PROCESS_CONTEXT_V1";
+/** Marks a process whose caller already supplied its complete Doom extension set. */
+const DOOMPI_EXTENSIONS_PROVIDED_ENV = "DOOMPI_EXTENSIONS_PROVIDED";
+/** Marks a process that already composed its own extension set from the command line. */
+const DOOMPI_COMPOSED_ENV = "DOOMPI_COMPOSED";
+const COMPOSED_FLAG = "1";
+/**
+* True when this process already applied the command line, so a reload does not.
+*
+* Extensions read this to tell a synchronized session from a launcher one, which
+* changes what they can promise the user about a pending selection.
+*/
+function alreadyComposed(environment = process.env) {
+	return environment[DOOMPI_COMPOSED_ENV] === COMPOSED_FLAG;
+}
+function resolveRootSessionId(currentSessionId, environment) {
+	const inherited = environment[SUBAGENT_ROOT_SESSION_ENV]?.trim();
+	if (inherited) return inherited;
+	const current = currentSessionId.trim();
+	if (!current) throw new Error("A root session requires a non-empty current session id.");
+	return current;
+}
+const ChildProcessContextSchema = typebox.Type.Object({
+	parentSessionId: typebox.Type.String({ minLength: 1 }),
+	workingDirectory: typebox.Type.String({ minLength: 1 }),
+	mode: typebox.Type.Optional(typebox.Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+function encodeChildProcessContext(context) {
+	return JSON.stringify(context);
+}
+function decodeChildProcessContext(serialized) {
+	const parsed = JSON.parse(serialized);
+	if (!(0, typebox_value.Check)(ChildProcessContextSchema, parsed)) {
+		const details = (0, typebox_value.Errors)(ChildProcessContextSchema, parsed).map((error) => error.message).join("; ");
+		throw new Error(`Invalid child process context: ${details}`);
+	}
+	return parsed;
+}
+function childProcessContextEnvironment(context) {
+	return { [DOOM_CHILD_PROCESS_CONTEXT_ENV]: encodeChildProcessContext(context) };
+}
+function readChildProcessContext(environment) {
+	const serialized = environment[DOOM_CHILD_PROCESS_CONTEXT_ENV]?.trim();
+	return serialized ? decodeChildProcessContext(serialized) : void 0;
+}
+//#endregion
+exports.ChildProcessContextSchema = ChildProcessContextSchema;
+exports.DOOMPI_COMPOSED_ENV = DOOMPI_COMPOSED_ENV;
+exports.DOOMPI_EXTENSIONS_PROVIDED_ENV = DOOMPI_EXTENSIONS_PROVIDED_ENV;
+exports.DOOM_CHILD_PROCESS_CONTEXT_ENV = DOOM_CHILD_PROCESS_CONTEXT_ENV;
+exports.SUBAGENT_CHILD_ENV = SUBAGENT_CHILD_ENV;
+exports.SUBAGENT_PARENT_SESSION_ENV = SUBAGENT_PARENT_SESSION_ENV;
+exports.SUBAGENT_ROOT_SESSION_ENV = SUBAGENT_ROOT_SESSION_ENV;
+exports.alreadyComposed = alreadyComposed;
+exports.childProcessContextEnvironment = childProcessContextEnvironment;
+exports.decodeChildProcessContext = decodeChildProcessContext;
+exports.encodeChildProcessContext = encodeChildProcessContext;
+exports.readChildProcessContext = readChildProcessContext;
+exports.resolveRootSessionId = resolveRootSessionId;
+
+//# sourceMappingURL=childProcess.cjs.map

package/dist/src/schemas/childProcess.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"childProcess.cjs","names":["Type","Check","Errors"],"sources":["../../../src/schemas/childProcess.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\nexport const SUBAGENT_CHILD_ENV = 'PI_SUBAGENT_CHILD';\nexport const SUBAGENT_PARENT_SESSION_ENV = 'PI_SUBAGENT_PARENT_SESSION';\nexport const SUBAGENT_ROOT_SESSION_ENV = 'PI_SUBAGENT_ROOT_SESSION';\nexport const DOOM_CHILD_PROCESS_CONTEXT_ENV = 'DOOM_CHILD_PROCESS_CONTEXT_V1';\n/** Marks a process whose caller already supplied its complete Doom extension set. */\nexport const DOOMPI_EXTENSIONS_PROVIDED_ENV = 'DOOMPI_EXTENSIONS_PROVIDED';\n/** Marks a process that already composed its own extension set from the command line. */\nexport const DOOMPI_COMPOSED_ENV = 'DOOMPI_COMPOSED';\n\nconst COMPOSED_FLAG = '1';\n\n/**\n * True when this process already applied the command line, so a reload does not.\n *\n * Extensions read this to tell a synchronized session from a launcher one, which\n * changes what they can promise the user about a pending selection.\n */\nexport function alreadyComposed(environment: NodeJS.ProcessEnv = process.env): boolean {\n  return environment[DOOMPI_COMPOSED_ENV] === COMPOSED_FLAG;\n}\n\nexport function resolveRootSessionId(\n  currentSessionId: string,\n  environment: Readonly<Record<string, string | undefined>>,\n): string {\n  const inherited = environment[SUBAGENT_ROOT_SESSION_ENV]?.trim();\n  if (inherited) return inherited;\n  const current = currentSessionId.trim();\n  if (!current) throw new Error('A root session requires a non-empty current session id.');\n  return current;\n}\n\nexport const ChildProcessContextSchema = Type.Object(\n  {\n    parentSessionId: Type.String({ minLength: 1 }),\n    workingDirectory: Type.String({ minLength: 1 }),\n    mode: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\nexport type ChildProcessContext = Static<typeof ChildProcessContextSchema>;\n\nexport function encodeChildProcessContext(context: ChildProcessContext): string {\n  return JSON.stringify(context);\n}\n\nexport function decodeChildProcessContext(serialized: string): ChildProcessContext {\n  const parsed: unknown = JSON.parse(serialized);\n  if (!Check(ChildProcessContextSchema, parsed)) {\n    const details = Errors(ChildProcessContextSchema, parsed)\n      .map((error) => error.message)\n      .join('; ');\n    throw new Error(`Invalid child process context: ${details}`);\n  }\n  return parsed;\n}\n\nexport function childProcessContextEnvironment(context: ChildProcessContext): Record<string, string> {\n  return { [DOOM_CHILD_PROCESS_CONTEXT_ENV]: encodeChildProcessContext(context) };\n}\n\nexport function readChildProcessContext(\n  environment: Readonly<Record<string, string | undefined>>,\n): ChildProcessContext | undefined {\n  const serialized = environment[DOOM_CHILD_PROCESS_CONTEXT_ENV]?.trim();\n  return serialized ? decodeChildProcessContext(serialized) : undefined;\n}\n"],"mappings":";;;AAGA,MAAa,qBAAqB;AAClC,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,iCAAiC;;AAE9C,MAAa,iCAAiC;;AAE9C,MAAa,sBAAsB;AAEnC,MAAM,gBAAgB;;;;;;;AAQtB,SAAgB,gBAAgB,cAAiC,QAAQ,KAAc;CACrF,OAAO,YAAY,yBAAyB;AAC9C;AAEA,SAAgB,qBACd,kBACA,aACQ;CACR,MAAM,YAAY,YAAY,0BAA0B,EAAE,KAAK;CAC/D,IAAI,WAAW,OAAO;CACtB,MAAM,UAAU,iBAAiB,KAAK;CACtC,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,yDAAyD;CACvF,OAAO;AACT;AAEA,MAAa,4BAA4BA,QAAAA,KAAK,OAC5C;CACE,iBAAiBA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAC7C,kBAAkBA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAC9C,MAAMA,QAAAA,KAAK,SAASA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACnD,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,SAAgB,0BAA0B,SAAsC;CAC9E,OAAO,KAAK,UAAU,OAAO;AAC/B;AAEA,SAAgB,0BAA0B,YAAyC;CACjF,MAAM,SAAkB,KAAK,MAAM,UAAU;CAC7C,IAAI,EAAA,GAACC,cAAAA,MAAAA,CAAM,2BAA2B,MAAM,GAAG;EAC7C,MAAM,WAAA,GAAUC,cAAAA,OAAAA,CAAO,2BAA2B,MAAM,CAAC,CACtD,KAAK,UAAU,MAAM,OAAO,CAAC,CAC7B,KAAK,IAAI;EACZ,MAAM,IAAI,MAAM,kCAAkC,SAAS;CAC7D;CACA,OAAO;AACT;AAEA,SAAgB,+BAA+B,SAAsD;CACnG,OAAO,GAAG,iCAAiC,0BAA0B,OAAO,EAAE;AAChF;AAEA,SAAgB,wBACd,aACiC;CACjC,MAAM,aAAa,YAAY,+BAA+B,EAAE,KAAK;CACrE,OAAO,aAAa,0BAA0B,UAAU,IAAI,KAAA;AAC9D"}

package/dist/src/schemas/childProcess.d.mts

@@ -0,0 +1,30 @@
+import { Static, Type } from "typebox";
+//#region src/schemas/childProcess.d.ts
+export declare const SUBAGENT_CHILD_ENV = "PI_SUBAGENT_CHILD";
+export declare const SUBAGENT_PARENT_SESSION_ENV = "PI_SUBAGENT_PARENT_SESSION";
+export declare const SUBAGENT_ROOT_SESSION_ENV = "PI_SUBAGENT_ROOT_SESSION";
+export declare const DOOM_CHILD_PROCESS_CONTEXT_ENV = "DOOM_CHILD_PROCESS_CONTEXT_V1";
+/** Marks a process whose caller already supplied its complete Doom extension set. */
+export declare const DOOMPI_EXTENSIONS_PROVIDED_ENV = "DOOMPI_EXTENSIONS_PROVIDED";
+/** Marks a process that already composed its own extension set from the command line. */
+export declare const DOOMPI_COMPOSED_ENV = "DOOMPI_COMPOSED";
+/**
+ * True when this process already applied the command line, so a reload does not.
+ *
+ * Extensions read this to tell a synchronized session from a launcher one, which
+ * changes what they can promise the user about a pending selection.
+ */
+export declare function alreadyComposed(environment?: NodeJS.ProcessEnv): boolean;
+export declare function resolveRootSessionId(currentSessionId: string, environment: Readonly<Record<string, string | undefined>>): string;
+export declare const ChildProcessContextSchema: Type.TObject<{
+  parentSessionId: Type.TString;
+  workingDirectory: Type.TString;
+  mode: Type.TOptional<Type.TString>;
+}>;
+export type ChildProcessContext = Static<typeof ChildProcessContextSchema>;
+export declare function encodeChildProcessContext(context: ChildProcessContext): string;
+export declare function decodeChildProcessContext(serialized: string): ChildProcessContext;
+export declare function childProcessContextEnvironment(context: ChildProcessContext): Record<string, string>;
+export declare function readChildProcessContext(environment: Readonly<Record<string, string | undefined>>): ChildProcessContext | undefined;
+//#endregion
+//# sourceMappingURL=childProcess.d.mts.map

package/dist/src/schemas/childProcess.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"childProcess.d.mts","names":[],"sources":["../../../src/schemas/childProcess.ts"],"mappings":";;qBAGa;qBACA;qBACA;qBACA;;qBAEA;;qBAEA;;;;;;;wBAUG,gBAAgB,cAAa,OAAO;wBAIpC,qBACd,0BACA,aAAa,SAAS;qBASX,2BAAyB,KAAA;;;;;YAQ1B,sBAAsB,cAAc;wBAEhC,0BAA0B,SAAS;wBAInC,0BAA0B,qBAAqB;wBAW/C,+BAA+B,SAAS,sBAAsB;wBAI9D,wBACd,aAAa,SAAS,sCACrB"}

package/dist/src/schemas/childProcess.mjs

@@ -0,0 +1,55 @@
+import { Type } from "typebox";
+import { Check, Errors } from "typebox/value";
+//#region src/schemas/childProcess.ts
+const SUBAGENT_CHILD_ENV = "PI_SUBAGENT_CHILD";
+const SUBAGENT_PARENT_SESSION_ENV = "PI_SUBAGENT_PARENT_SESSION";
+const SUBAGENT_ROOT_SESSION_ENV = "PI_SUBAGENT_ROOT_SESSION";
+const DOOM_CHILD_PROCESS_CONTEXT_ENV = "DOOM_CHILD_PROCESS_CONTEXT_V1";
+/** Marks a process whose caller already supplied its complete Doom extension set. */
+const DOOMPI_EXTENSIONS_PROVIDED_ENV = "DOOMPI_EXTENSIONS_PROVIDED";
+/** Marks a process that already composed its own extension set from the command line. */
+const DOOMPI_COMPOSED_ENV = "DOOMPI_COMPOSED";
+const COMPOSED_FLAG = "1";
+/**
+* True when this process already applied the command line, so a reload does not.
+*
+* Extensions read this to tell a synchronized session from a launcher one, which
+* changes what they can promise the user about a pending selection.
+*/
+function alreadyComposed(environment = process.env) {
+	return environment[DOOMPI_COMPOSED_ENV] === COMPOSED_FLAG;
+}
+function resolveRootSessionId(currentSessionId, environment) {
+	const inherited = environment[SUBAGENT_ROOT_SESSION_ENV]?.trim();
+	if (inherited) return inherited;
+	const current = currentSessionId.trim();
+	if (!current) throw new Error("A root session requires a non-empty current session id.");
+	return current;
+}
+const ChildProcessContextSchema = Type.Object({
+	parentSessionId: Type.String({ minLength: 1 }),
+	workingDirectory: Type.String({ minLength: 1 }),
+	mode: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+function encodeChildProcessContext(context) {
+	return JSON.stringify(context);
+}
+function decodeChildProcessContext(serialized) {
+	const parsed = JSON.parse(serialized);
+	if (!Check(ChildProcessContextSchema, parsed)) {
+		const details = Errors(ChildProcessContextSchema, parsed).map((error) => error.message).join("; ");
+		throw new Error(`Invalid child process context: ${details}`);
+	}
+	return parsed;
+}
+function childProcessContextEnvironment(context) {
+	return { [DOOM_CHILD_PROCESS_CONTEXT_ENV]: encodeChildProcessContext(context) };
+}
+function readChildProcessContext(environment) {
+	const serialized = environment[DOOM_CHILD_PROCESS_CONTEXT_ENV]?.trim();
+	return serialized ? decodeChildProcessContext(serialized) : void 0;
+}
+//#endregion
+export { ChildProcessContextSchema, DOOMPI_COMPOSED_ENV, DOOMPI_EXTENSIONS_PROVIDED_ENV, DOOM_CHILD_PROCESS_CONTEXT_ENV, SUBAGENT_CHILD_ENV, SUBAGENT_PARENT_SESSION_ENV, SUBAGENT_ROOT_SESSION_ENV, alreadyComposed, childProcessContextEnvironment, decodeChildProcessContext, encodeChildProcessContext, readChildProcessContext, resolveRootSessionId };
+
+//# sourceMappingURL=childProcess.mjs.map

package/dist/src/schemas/childProcess.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"childProcess.mjs","names":[],"sources":["../../../src/schemas/childProcess.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\nexport const SUBAGENT_CHILD_ENV = 'PI_SUBAGENT_CHILD';\nexport const SUBAGENT_PARENT_SESSION_ENV = 'PI_SUBAGENT_PARENT_SESSION';\nexport const SUBAGENT_ROOT_SESSION_ENV = 'PI_SUBAGENT_ROOT_SESSION';\nexport const DOOM_CHILD_PROCESS_CONTEXT_ENV = 'DOOM_CHILD_PROCESS_CONTEXT_V1';\n/** Marks a process whose caller already supplied its complete Doom extension set. */\nexport const DOOMPI_EXTENSIONS_PROVIDED_ENV = 'DOOMPI_EXTENSIONS_PROVIDED';\n/** Marks a process that already composed its own extension set from the command line. */\nexport const DOOMPI_COMPOSED_ENV = 'DOOMPI_COMPOSED';\n\nconst COMPOSED_FLAG = '1';\n\n/**\n * True when this process already applied the command line, so a reload does not.\n *\n * Extensions read this to tell a synchronized session from a launcher one, which\n * changes what they can promise the user about a pending selection.\n */\nexport function alreadyComposed(environment: NodeJS.ProcessEnv = process.env): boolean {\n  return environment[DOOMPI_COMPOSED_ENV] === COMPOSED_FLAG;\n}\n\nexport function resolveRootSessionId(\n  currentSessionId: string,\n  environment: Readonly<Record<string, string | undefined>>,\n): string {\n  const inherited = environment[SUBAGENT_ROOT_SESSION_ENV]?.trim();\n  if (inherited) return inherited;\n  const current = currentSessionId.trim();\n  if (!current) throw new Error('A root session requires a non-empty current session id.');\n  return current;\n}\n\nexport const ChildProcessContextSchema = Type.Object(\n  {\n    parentSessionId: Type.String({ minLength: 1 }),\n    workingDirectory: Type.String({ minLength: 1 }),\n    mode: Type.Optional(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\nexport type ChildProcessContext = Static<typeof ChildProcessContextSchema>;\n\nexport function encodeChildProcessContext(context: ChildProcessContext): string {\n  return JSON.stringify(context);\n}\n\nexport function decodeChildProcessContext(serialized: string): ChildProcessContext {\n  const parsed: unknown = JSON.parse(serialized);\n  if (!Check(ChildProcessContextSchema, parsed)) {\n    const details = Errors(ChildProcessContextSchema, parsed)\n      .map((error) => error.message)\n      .join('; ');\n    throw new Error(`Invalid child process context: ${details}`);\n  }\n  return parsed;\n}\n\nexport function childProcessContextEnvironment(context: ChildProcessContext): Record<string, string> {\n  return { [DOOM_CHILD_PROCESS_CONTEXT_ENV]: encodeChildProcessContext(context) };\n}\n\nexport function readChildProcessContext(\n  environment: Readonly<Record<string, string | undefined>>,\n): ChildProcessContext | undefined {\n  const serialized = environment[DOOM_CHILD_PROCESS_CONTEXT_ENV]?.trim();\n  return serialized ? decodeChildProcessContext(serialized) : undefined;\n}\n"],"mappings":";;;AAGA,MAAa,qBAAqB;AAClC,MAAa,8BAA8B;AAC3C,MAAa,4BAA4B;AACzC,MAAa,iCAAiC;;AAE9C,MAAa,iCAAiC;;AAE9C,MAAa,sBAAsB;AAEnC,MAAM,gBAAgB;;;;;;;AAQtB,SAAgB,gBAAgB,cAAiC,QAAQ,KAAc;CACrF,OAAO,YAAY,yBAAyB;AAC9C;AAEA,SAAgB,qBACd,kBACA,aACQ;CACR,MAAM,YAAY,YAAY,0BAA0B,EAAE,KAAK;CAC/D,IAAI,WAAW,OAAO;CACtB,MAAM,UAAU,iBAAiB,KAAK;CACtC,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,yDAAyD;CACvF,OAAO;AACT;AAEA,MAAa,4BAA4B,KAAK,OAC5C;CACE,iBAAiB,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAC7C,kBAAkB,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC;CAC9C,MAAM,KAAK,SAAS,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACnD,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,SAAgB,0BAA0B,SAAsC;CAC9E,OAAO,KAAK,UAAU,OAAO;AAC/B;AAEA,SAAgB,0BAA0B,YAAyC;CACjF,MAAM,SAAkB,KAAK,MAAM,UAAU;CAC7C,IAAI,CAAC,MAAM,2BAA2B,MAAM,GAAG;EAC7C,MAAM,UAAU,OAAO,2BAA2B,MAAM,CAAC,CACtD,KAAK,UAAU,MAAM,OAAO,CAAC,CAC7B,KAAK,IAAI;EACZ,MAAM,IAAI,MAAM,kCAAkC,SAAS;CAC7D;CACA,OAAO;AACT;AAEA,SAAgB,+BAA+B,SAAsD;CACnG,OAAO,GAAG,iCAAiC,0BAA0B,OAAO,EAAE;AAChF;AAEA,SAAgB,wBACd,aACiC;CACjC,MAAM,aAAa,YAAY,+BAA+B,EAAE,KAAK;CACrE,OAAO,aAAa,0BAA0B,UAAU,IAAI,KAAA;AAC9D"}

package/dist/src/schemas/cockpitContainer.cjs

@@ -0,0 +1,31 @@
+//#region src/schemas/cockpitContainer.ts
+/**
+* Cockpit container harness contract.
+*
+* The sandbox harness next door provisions a container, runs one interactive
+* launch inside it, and reports the exit code. This is the other shape: a
+* detached container that outlives the call, holding the cockpit hub and every
+* session it goes on to spawn.
+*
+* The difference is worth its own contract rather than a flag. `launchSandbox`
+* returns `Promise<number>`, which cannot express "it is running, here is the
+* handle", and its credential broker is torn down as soon as that promise
+* settles. A detached cockpit needs both to outlive the call.
+*
+* Core and the cockpit resolve this dynamically from the selected composition,
+* exactly as they resolve the sandbox harness, so neither depends on a concrete
+* container technology.
+*/
+/** Exports subpath a layer package declares when it can host the cockpit. */
+const COCKPIT_HARNESS_EXPORT_SUBPATH = "./cockpit-harness";
+/** Narrowing guard for a dynamically imported cockpit harness entry. */
+function isCockpitContainerHarnessModule(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const candidate = value;
+	return typeof candidate.startCockpitContainer === "function" && typeof candidate.reapCockpitContainer === "function";
+}
+//#endregion
+exports.COCKPIT_HARNESS_EXPORT_SUBPATH = COCKPIT_HARNESS_EXPORT_SUBPATH;
+exports.isCockpitContainerHarnessModule = isCockpitContainerHarnessModule;
+
+//# sourceMappingURL=cockpitContainer.cjs.map

package/dist/src/schemas/cockpitContainer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpitContainer.cjs","names":[],"sources":["../../../src/schemas/cockpitContainer.ts"],"sourcesContent":["/**\n * Cockpit container harness contract.\n *\n * The sandbox harness next door provisions a container, runs one interactive\n * launch inside it, and reports the exit code. This is the other shape: a\n * detached container that outlives the call, holding the cockpit hub and every\n * session it goes on to spawn.\n *\n * The difference is worth its own contract rather than a flag. `launchSandbox`\n * returns `Promise<number>`, which cannot express \"it is running, here is the\n * handle\", and its credential broker is torn down as soon as that promise\n * settles. A detached cockpit needs both to outlive the call.\n *\n * Core and the cockpit resolve this dynamically from the selected composition,\n * exactly as they resolve the sandbox harness, so neither depends on a concrete\n * container technology.\n */\n\n/** Exports subpath a layer package declares when it can host the cockpit. */\nexport const COCKPIT_HARNESS_EXPORT_SUBPATH = './cockpit-harness';\n\n/** One host directory the cockpit may work in, bind-mounted at its own path. */\nexport interface CockpitWorkspace {\n  /**\n   * Absolute host path, mounted at the identical path inside the container so\n   * every absolute path the cockpit already holds keeps resolving.\n   */\n  path: string;\n}\n\nexport interface CockpitContainerRequest {\n  /**\n   * Directories the cockpit may create sessions in. This list is the boundary:\n   * a hub inside the container cannot reach a path that is not here, which is\n   * what makes \"sessions only start in mounted directories\" true by\n   * construction rather than by a check that can be weakened later.\n   */\n  workspaces: readonly CockpitWorkspace[];\n  /** Loopback port the cockpit is published on, and the port it binds inside. */\n  port: number;\n  /** Host environment the provider filters before any of it enters the container. */\n  environment: NodeJS.ProcessEnv;\n  /** Receives one human-readable line per provisioning decision, including image builds. */\n  onProgress?: (message: string) => void;\n}\n\nexport interface CockpitContainerHandle {\n  /** Engine-assigned id, recorded on the host so an orphan can be reaped later. */\n  readonly containerId: string;\n  /** Stops the container and releases everything provisioned alongside it. */\n  stop(): Promise<void>;\n  /**\n   * Whether the container is still running.\n   *\n   * The supervising process has no server of its own once it has handed over,\n   * so this is what it watches: a container that died has to end the supervisor\n   * with it, rather than leaving a process that owns nothing.\n   */\n  alive(): Promise<boolean>;\n}\n\nexport type CockpitContainerStart = { ok: true; handle: CockpitContainerHandle } | { ok: false; error: string };\n\nexport interface CockpitContainerHarnessModule {\n  /**\n   * Builds the image if it is missing, starts the container detached, and\n   * returns once the cockpit inside is answering.\n   */\n  startCockpitContainer(request: CockpitContainerRequest): Promise<CockpitContainerStart>;\n  /**\n   * Stops a container this harness started in an earlier process, named by id.\n   * Resolves true when one was found and stopped.\n   */\n  reapCockpitContainer(containerId: string): Promise<boolean>;\n}\n\n/** Narrowing guard for a dynamically imported cockpit harness entry. */\nexport function isCockpitContainerHarnessModule(value: unknown): value is CockpitContainerHarnessModule {\n  if (typeof value !== 'object' || value === null) return false;\n  const candidate = value as Partial<CockpitContainerHarnessModule>;\n  return typeof candidate.startCockpitContainer === 'function' && typeof candidate.reapCockpitContainer === 'function';\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,iCAAiC;;AA0D9C,SAAgB,gCAAgC,OAAwD;CACtG,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,YAAY;CAClB,OAAO,OAAO,UAAU,0BAA0B,cAAc,OAAO,UAAU,yBAAyB;AAC5G"}

package/dist/src/schemas/cockpitContainer.d.mts

@@ -0,0 +1,80 @@
+//#region src/schemas/cockpitContainer.d.ts
+/**
+ * Cockpit container harness contract.
+ *
+ * The sandbox harness next door provisions a container, runs one interactive
+ * launch inside it, and reports the exit code. This is the other shape: a
+ * detached container that outlives the call, holding the cockpit hub and every
+ * session it goes on to spawn.
+ *
+ * The difference is worth its own contract rather than a flag. `launchSandbox`
+ * returns `Promise<number>`, which cannot express "it is running, here is the
+ * handle", and its credential broker is torn down as soon as that promise
+ * settles. A detached cockpit needs both to outlive the call.
+ *
+ * Core and the cockpit resolve this dynamically from the selected composition,
+ * exactly as they resolve the sandbox harness, so neither depends on a concrete
+ * container technology.
+ */
+/** Exports subpath a layer package declares when it can host the cockpit. */
+export declare const COCKPIT_HARNESS_EXPORT_SUBPATH = "./cockpit-harness";
+/** One host directory the cockpit may work in, bind-mounted at its own path. */
+export interface CockpitWorkspace {
+  /**
+   * Absolute host path, mounted at the identical path inside the container so
+   * every absolute path the cockpit already holds keeps resolving.
+   */
+  path: string;
+}
+export interface CockpitContainerRequest {
+  /**
+   * Directories the cockpit may create sessions in. This list is the boundary:
+   * a hub inside the container cannot reach a path that is not here, which is
+   * what makes "sessions only start in mounted directories" true by
+   * construction rather than by a check that can be weakened later.
+   */
+  workspaces: readonly CockpitWorkspace[];
+  /** Loopback port the cockpit is published on, and the port it binds inside. */
+  port: number;
+  /** Host environment the provider filters before any of it enters the container. */
+  environment: NodeJS.ProcessEnv;
+  /** Receives one human-readable line per provisioning decision, including image builds. */
+  onProgress?: (message: string) => void;
+}
+export interface CockpitContainerHandle {
+  /** Engine-assigned id, recorded on the host so an orphan can be reaped later. */
+  readonly containerId: string;
+  /** Stops the container and releases everything provisioned alongside it. */
+  stop(): Promise<void>;
+  /**
+   * Whether the container is still running.
+   *
+   * The supervising process has no server of its own once it has handed over,
+   * so this is what it watches: a container that died has to end the supervisor
+   * with it, rather than leaving a process that owns nothing.
+   */
+  alive(): Promise<boolean>;
+}
+export type CockpitContainerStart = {
+  ok: true;
+  handle: CockpitContainerHandle;
+} | {
+  ok: false;
+  error: string;
+};
+export interface CockpitContainerHarnessModule {
+  /**
+   * Builds the image if it is missing, starts the container detached, and
+   * returns once the cockpit inside is answering.
+   */
+  startCockpitContainer(request: CockpitContainerRequest): Promise<CockpitContainerStart>;
+  /**
+   * Stops a container this harness started in an earlier process, named by id.
+   * Resolves true when one was found and stopped.
+   */
+  reapCockpitContainer(containerId: string): Promise<boolean>;
+}
+/** Narrowing guard for a dynamically imported cockpit harness entry. */
+export declare function isCockpitContainerHarnessModule(value: unknown): value is CockpitContainerHarnessModule;
+//#endregion
+//# sourceMappingURL=cockpitContainer.d.mts.map

package/dist/src/schemas/cockpitContainer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpitContainer.d.mts","names":[],"sources":["../../../src/schemas/cockpitContainer.ts"],"mappings":";;;;;;;;;;;;;;;;;;;qBAmBa;;iBAGI;;;;;EAKf;;iBAGe;;;;;;;EAOf,qBAAqB;;EAErB;;EAEA,aAAa,OAAO;;EAEpB,cAAc;;iBAGC;;WAEN;;EAET,QAAQ;;;;;;;;EAQR,SAAS;;YAGC;EAA0B;EAAU,QAAQ;;EAA6B;EAAW;;iBAE/E;;;;;EAKf,sBAAsB,SAAS,0BAA0B,QAAQ;;;;;EAKjE,qBAAqB,sBAAsB;;;wBAI7B,gCAAgC,iBAAiB,SAAS"}

package/dist/src/schemas/cockpitContainer.mjs

@@ -0,0 +1,30 @@
+//#region src/schemas/cockpitContainer.ts
+/**
+* Cockpit container harness contract.
+*
+* The sandbox harness next door provisions a container, runs one interactive
+* launch inside it, and reports the exit code. This is the other shape: a
+* detached container that outlives the call, holding the cockpit hub and every
+* session it goes on to spawn.
+*
+* The difference is worth its own contract rather than a flag. `launchSandbox`
+* returns `Promise<number>`, which cannot express "it is running, here is the
+* handle", and its credential broker is torn down as soon as that promise
+* settles. A detached cockpit needs both to outlive the call.
+*
+* Core and the cockpit resolve this dynamically from the selected composition,
+* exactly as they resolve the sandbox harness, so neither depends on a concrete
+* container technology.
+*/
+/** Exports subpath a layer package declares when it can host the cockpit. */
+const COCKPIT_HARNESS_EXPORT_SUBPATH = "./cockpit-harness";
+/** Narrowing guard for a dynamically imported cockpit harness entry. */
+function isCockpitContainerHarnessModule(value) {
+	if (typeof value !== "object" || value === null) return false;
+	const candidate = value;
+	return typeof candidate.startCockpitContainer === "function" && typeof candidate.reapCockpitContainer === "function";
+}
+//#endregion
+export { COCKPIT_HARNESS_EXPORT_SUBPATH, isCockpitContainerHarnessModule };
+
+//# sourceMappingURL=cockpitContainer.mjs.map

package/dist/src/schemas/cockpitContainer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cockpitContainer.mjs","names":[],"sources":["../../../src/schemas/cockpitContainer.ts"],"sourcesContent":["/**\n * Cockpit container harness contract.\n *\n * The sandbox harness next door provisions a container, runs one interactive\n * launch inside it, and reports the exit code. This is the other shape: a\n * detached container that outlives the call, holding the cockpit hub and every\n * session it goes on to spawn.\n *\n * The difference is worth its own contract rather than a flag. `launchSandbox`\n * returns `Promise<number>`, which cannot express \"it is running, here is the\n * handle\", and its credential broker is torn down as soon as that promise\n * settles. A detached cockpit needs both to outlive the call.\n *\n * Core and the cockpit resolve this dynamically from the selected composition,\n * exactly as they resolve the sandbox harness, so neither depends on a concrete\n * container technology.\n */\n\n/** Exports subpath a layer package declares when it can host the cockpit. */\nexport const COCKPIT_HARNESS_EXPORT_SUBPATH = './cockpit-harness';\n\n/** One host directory the cockpit may work in, bind-mounted at its own path. */\nexport interface CockpitWorkspace {\n  /**\n   * Absolute host path, mounted at the identical path inside the container so\n   * every absolute path the cockpit already holds keeps resolving.\n   */\n  path: string;\n}\n\nexport interface CockpitContainerRequest {\n  /**\n   * Directories the cockpit may create sessions in. This list is the boundary:\n   * a hub inside the container cannot reach a path that is not here, which is\n   * what makes \"sessions only start in mounted directories\" true by\n   * construction rather than by a check that can be weakened later.\n   */\n  workspaces: readonly CockpitWorkspace[];\n  /** Loopback port the cockpit is published on, and the port it binds inside. */\n  port: number;\n  /** Host environment the provider filters before any of it enters the container. */\n  environment: NodeJS.ProcessEnv;\n  /** Receives one human-readable line per provisioning decision, including image builds. */\n  onProgress?: (message: string) => void;\n}\n\nexport interface CockpitContainerHandle {\n  /** Engine-assigned id, recorded on the host so an orphan can be reaped later. */\n  readonly containerId: string;\n  /** Stops the container and releases everything provisioned alongside it. */\n  stop(): Promise<void>;\n  /**\n   * Whether the container is still running.\n   *\n   * The supervising process has no server of its own once it has handed over,\n   * so this is what it watches: a container that died has to end the supervisor\n   * with it, rather than leaving a process that owns nothing.\n   */\n  alive(): Promise<boolean>;\n}\n\nexport type CockpitContainerStart = { ok: true; handle: CockpitContainerHandle } | { ok: false; error: string };\n\nexport interface CockpitContainerHarnessModule {\n  /**\n   * Builds the image if it is missing, starts the container detached, and\n   * returns once the cockpit inside is answering.\n   */\n  startCockpitContainer(request: CockpitContainerRequest): Promise<CockpitContainerStart>;\n  /**\n   * Stops a container this harness started in an earlier process, named by id.\n   * Resolves true when one was found and stopped.\n   */\n  reapCockpitContainer(containerId: string): Promise<boolean>;\n}\n\n/** Narrowing guard for a dynamically imported cockpit harness entry. */\nexport function isCockpitContainerHarnessModule(value: unknown): value is CockpitContainerHarnessModule {\n  if (typeof value !== 'object' || value === null) return false;\n  const candidate = value as Partial<CockpitContainerHarnessModule>;\n  return typeof candidate.startCockpitContainer === 'function' && typeof candidate.reapCockpitContainer === 'function';\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,iCAAiC;;AA0D9C,SAAgB,gCAAgC,OAAwD;CACtG,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,YAAY;CAClB,OAAO,OAAO,UAAU,0BAA0B,cAAc,OAAO,UAAU,yBAAyB;AAC5G"}

package/dist/src/schemas/contextContributions.cjs

@@ -0,0 +1,17 @@
+//#region src/schemas/contextContributions.ts
+/** Session-scoped broker for bounded context rendered by optional Doom packages. */
+const DOOM_CONTEXT_CONTRIBUTIONS_SERVICE = "doom/context-contributions";
+function readDoomContextContributions(context) {
+	return context.get(DOOM_CONTEXT_CONTRIBUTIONS_SERVICE);
+}
+function requireDoomContextContributions(context) {
+	const service = readDoomContextContributions(context);
+	if (!service) throw new Error("Doom context contributions are unavailable. Start a Doom session first.");
+	return service;
+}
+//#endregion
+exports.DOOM_CONTEXT_CONTRIBUTIONS_SERVICE = DOOM_CONTEXT_CONTRIBUTIONS_SERVICE;
+exports.readDoomContextContributions = readDoomContextContributions;
+exports.requireDoomContextContributions = requireDoomContextContributions;
+
+//# sourceMappingURL=contextContributions.cjs.map

package/dist/src/schemas/contextContributions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextContributions.cjs","names":[],"sources":["../../../src/schemas/contextContributions.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n\n/** Session-scoped broker for bounded context rendered by optional Doom packages. */\nexport const DOOM_CONTEXT_CONTRIBUTIONS_SERVICE = 'doom/context-contributions';\n\nexport interface DoomContextContribution {\n  readonly source: string;\n  readonly id: string;\n  readonly label: string;\n  readonly order: number;\n  /** Returns provider-rendered, already-redacted text, or omits this contribution. */\n  snapshot(): string | undefined;\n}\n\nexport interface DoomContextContributionEntry {\n  readonly source: string;\n  readonly id: string;\n  readonly label: string;\n  readonly order: number;\n  readonly text: string;\n}\n\nexport interface DoomContextContributionError {\n  readonly source: string;\n  readonly id: string;\n  readonly label: string;\n  readonly order: number;\n  readonly message: string;\n}\n\nexport interface DoomContextContributionsSnapshot {\n  readonly entries: readonly DoomContextContributionEntry[];\n  readonly errors: readonly DoomContextContributionError[];\n}\n\nexport interface DoomContextContributionRegistration {\n  /** Removes the contribution. Repeated disposal is a no-op. */\n  dispose(): void;\n}\n\nexport interface DoomContextContributionsService {\n  /** Fences registrations and snapshots against a replaced Doom session. */\n  readonly generation: string;\n  register(contribution: DoomContextContribution): DoomContextContributionRegistration;\n  snapshot(): DoomContextContributionsSnapshot;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/context-contributions': DoomContextContributionsService;\n  }\n}\n\nexport function readDoomContextContributions(context: Context): DoomContextContributionsService | undefined {\n  return context.get(DOOM_CONTEXT_CONTRIBUTIONS_SERVICE) as DoomContextContributionsService | undefined;\n}\n\nexport function requireDoomContextContributions(context: Context): DoomContextContributionsService {\n  const service = readDoomContextContributions(context);\n  if (!service) throw new Error('Doom context contributions are unavailable. Start a Doom session first.');\n  return service;\n}\n"],"mappings":";;AAGA,MAAa,qCAAqC;AAkDlD,SAAgB,6BAA6B,SAA+D;CAC1G,OAAO,QAAQ,IAAI,kCAAkC;AACvD;AAEA,SAAgB,gCAAgC,SAAmD;CACjG,MAAM,UAAU,6BAA6B,OAAO;CACpD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,yEAAyE;CACvG,OAAO;AACT"}

package/dist/src/schemas/contextContributions.d.mts

@@ -0,0 +1,49 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/contextContributions.d.ts
+/** Session-scoped broker for bounded context rendered by optional Doom packages. */
+export declare const DOOM_CONTEXT_CONTRIBUTIONS_SERVICE = "doom/context-contributions";
+export interface DoomContextContribution {
+  readonly source: string;
+  readonly id: string;
+  readonly label: string;
+  readonly order: number;
+  /** Returns provider-rendered, already-redacted text, or omits this contribution. */
+  snapshot(): string | undefined;
+}
+export interface DoomContextContributionEntry {
+  readonly source: string;
+  readonly id: string;
+  readonly label: string;
+  readonly order: number;
+  readonly text: string;
+}
+export interface DoomContextContributionError {
+  readonly source: string;
+  readonly id: string;
+  readonly label: string;
+  readonly order: number;
+  readonly message: string;
+}
+export interface DoomContextContributionsSnapshot {
+  readonly entries: readonly DoomContextContributionEntry[];
+  readonly errors: readonly DoomContextContributionError[];
+}
+export interface DoomContextContributionRegistration {
+  /** Removes the contribution. Repeated disposal is a no-op. */
+  dispose(): void;
+}
+export interface DoomContextContributionsService {
+  /** Fences registrations and snapshots against a replaced Doom session. */
+  readonly generation: string;
+  register(contribution: DoomContextContribution): DoomContextContributionRegistration;
+  snapshot(): DoomContextContributionsSnapshot;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/context-contributions': DoomContextContributionsService;
+  }
+}
+export declare function readDoomContextContributions(context: Context): DoomContextContributionsService | undefined;
+export declare function requireDoomContextContributions(context: Context): DoomContextContributionsService;
+//#endregion
+//# sourceMappingURL=contextContributions.d.mts.map