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

package/dist/runtime-config.d.mts

@@ -0,0 +1,313 @@
+import { Static, Type } from "typebox";
+//#region src/schemas/config.d.ts
+/** Canonical Cordis key for the session-owned Doom configuration service. */
+export declare const DOOM_CONFIG_SERVICE = "doom/config";
+/** Matches the leader contract's source rule: package names, addressable and spoof-checkable. */
+export declare const ConfigSourceSchema: Type.TString;
+/**
+ * How ready a value is to be used, as opposed to whether it is merely set.
+ * `blocked` covers a choice that needs something else first, such as a model
+ * whose engine is not installed.
+ */
+export declare const ConfigStatusSchema: Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>;
+export type ConfigStatus = Static<typeof ConfigStatusSchema>;
+export declare const ConfigFieldKindSchema: Type.TUnion<[Type.TLiteral<"text">, Type.TLiteral<"enum">, Type.TLiteral<"choice">, Type.TLiteral<"info">]>;
+export type ConfigFieldKind = Static<typeof ConfigFieldKindSchema>;
+/**
+ * A key the renderer offers on the focused field, sent back verbatim as an
+ * action. Owners use this for confirmations, so the pending question survives a
+ * panel that is closed and reopened.
+ */
+export declare const ConfigActionSchema: Type.TObject<{
+  key: Type.TString;
+  label: Type.TString;
+  action: Type.TString;
+}>;
+export type ConfigAction = Static<typeof ConfigActionSchema>;
+export declare const ConfigChoiceSchema: Type.TObject<{
+  id: Type.TString;
+  label: Type.TString;
+  /** Right-aligned by the renderer. Sizes, ids, anything narrow. */
+  detail: Type.TOptional<Type.TString>;
+  /** Groups entries under a heading the cursor skips over. */
+  group: Type.TOptional<Type.TString>;
+  status: Type.TOptional<Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>>;
+  statusText: Type.TOptional<Type.TString>;
+  /**
+   * What enter does on this entry. Carrying it per-entry is what lets one list
+   * hold both an installed model that only needs selecting and an absent one
+   * that needs fetching, without the renderer knowing the difference.
+   */
+  action: Type.TOptional<Type.TString>;
+}>;
+export type ConfigChoice = Static<typeof ConfigChoiceSchema>;
+/**
+ * One line of a multi-step operation.
+ *
+ * Published as a list rather than a single "current step" string so the panel can
+ * show what already ran alongside what is left. During an install that is the
+ * difference between "something is happening" and knowing a package manager
+ * already finished and a download is now underway.
+ */
+export declare const ConfigStepSchema: Type.TObject<{
+  label: Type.TString;
+  state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"satisfied">, Type.TLiteral<"running">, Type.TLiteral<"done">, Type.TLiteral<"failed">]>;
+  detail: Type.TOptional<Type.TString>;
+}>;
+export type ConfigStep = Static<typeof ConfigStepSchema>;
+export declare const ConfigProgressSchema: Type.TObject<{
+  label: Type.TString;
+  /** 0 to 1. Omitted when the work has no measurable total. */
+  ratio: Type.TOptional<Type.TNumber>;
+}>;
+export type ConfigProgress = Static<typeof ConfigProgressSchema>;
+export declare const ConfigFieldSchema: Type.TObject<{
+  id: Type.TString;
+  label: Type.TString;
+  kind: Type.TUnion<[Type.TLiteral<"text">, Type.TLiteral<"enum">, Type.TLiteral<"choice">, Type.TLiteral<"info">]>;
+  /** Absent means unset; the renderer shows `placeholder` instead. */
+  value: Type.TOptional<Type.TString>;
+  placeholder: Type.TOptional<Type.TString>;
+  /** One line of help for the focused field. */
+  detail: Type.TOptional<Type.TString>;
+  /** The config key this writes, shown under the focused field so the file stays legible. */
+  keyPath: Type.TOptional<Type.TString>;
+  status: Type.TOptional<Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>>;
+  /** Doubles as the error line: a rejected edit comes back as the old value plus this. */
+  statusText: Type.TOptional<Type.TString>;
+  choices: Type.TOptional<Type.TArray<Type.TObject<{
+    id: Type.TString;
+    label: Type.TString;
+    /** Right-aligned by the renderer. Sizes, ids, anything narrow. */
+    detail: Type.TOptional<Type.TString>;
+    /** Groups entries under a heading the cursor skips over. */
+    group: Type.TOptional<Type.TString>;
+    status: Type.TOptional<Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>>;
+    statusText: Type.TOptional<Type.TString>;
+    /**
+     * What enter does on this entry. Carrying it per-entry is what lets one list
+     * hold both an installed model that only needs selecting and an absent one
+     * that needs fetching, without the renderer knowing the difference.
+     */
+    action: Type.TOptional<Type.TString>;
+  }>>>;
+  actions: Type.TOptional<Type.TArray<Type.TObject<{
+    key: Type.TString;
+    label: Type.TString;
+    action: Type.TString;
+  }>>>;
+  /** Work is running; the renderer dims the field and offers abort. */
+  busy: Type.TOptional<Type.TBoolean>;
+  progress: Type.TOptional<Type.TObject<{
+    label: Type.TString;
+    /** 0 to 1. Omitted when the work has no measurable total. */
+    ratio: Type.TOptional<Type.TNumber>;
+  }>>;
+  steps: Type.TOptional<Type.TArray<Type.TObject<{
+    label: Type.TString;
+    state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"satisfied">, Type.TLiteral<"running">, Type.TLiteral<"done">, Type.TLiteral<"failed">]>;
+    detail: Type.TOptional<Type.TString>;
+  }>>>;
+  /**
+   * The tail of a running command's terminal output.
+   *
+   * A tail rather than the whole scrollback: the field is a few rows of a
+   * shared pane, and what matters is the question a package manager just
+   * asked, not what it printed a minute ago.
+   */
+  output: Type.TOptional<Type.TArray<Type.TString>>;
+  /**
+   * The command is waiting on the user. The renderer offers a line to type
+   * into, which comes back as an owner-defined action carrying the text.
+   */
+  awaitingInput: Type.TOptional<Type.TBoolean>;
+}>;
+export type ConfigField = Static<typeof ConfigFieldSchema>;
+export declare const ConfigSectionSchema: Type.TObject<{
+  id: Type.TString;
+  title: Type.TString;
+  detail: Type.TOptional<Type.TString>;
+  order: Type.TInteger;
+  /** Section-wide state: readiness, or why a write failed. */
+  notice: Type.TOptional<Type.TString>;
+  noticeLevel: Type.TOptional<Type.TUnion<[Type.TLiteral<"info">, Type.TLiteral<"error">]>>;
+  fields: Type.TArray<Type.TObject<{
+    id: Type.TString;
+    label: Type.TString;
+    kind: Type.TUnion<[Type.TLiteral<"text">, Type.TLiteral<"enum">, Type.TLiteral<"choice">, Type.TLiteral<"info">]>;
+    /** Absent means unset; the renderer shows `placeholder` instead. */
+    value: Type.TOptional<Type.TString>;
+    placeholder: Type.TOptional<Type.TString>;
+    /** One line of help for the focused field. */
+    detail: Type.TOptional<Type.TString>;
+    /** The config key this writes, shown under the focused field so the file stays legible. */
+    keyPath: Type.TOptional<Type.TString>;
+    status: Type.TOptional<Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>>;
+    /** Doubles as the error line: a rejected edit comes back as the old value plus this. */
+    statusText: Type.TOptional<Type.TString>;
+    choices: Type.TOptional<Type.TArray<Type.TObject<{
+      id: Type.TString;
+      label: Type.TString;
+      /** Right-aligned by the renderer. Sizes, ids, anything narrow. */
+      detail: Type.TOptional<Type.TString>;
+      /** Groups entries under a heading the cursor skips over. */
+      group: Type.TOptional<Type.TString>;
+      status: Type.TOptional<Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>>;
+      statusText: Type.TOptional<Type.TString>;
+      /**
+       * What enter does on this entry. Carrying it per-entry is what lets one list
+       * hold both an installed model that only needs selecting and an absent one
+       * that needs fetching, without the renderer knowing the difference.
+       */
+      action: Type.TOptional<Type.TString>;
+    }>>>;
+    actions: Type.TOptional<Type.TArray<Type.TObject<{
+      key: Type.TString;
+      label: Type.TString;
+      action: Type.TString;
+    }>>>;
+    /** Work is running; the renderer dims the field and offers abort. */
+    busy: Type.TOptional<Type.TBoolean>;
+    progress: Type.TOptional<Type.TObject<{
+      label: Type.TString;
+      /** 0 to 1. Omitted when the work has no measurable total. */
+      ratio: Type.TOptional<Type.TNumber>;
+    }>>;
+    steps: Type.TOptional<Type.TArray<Type.TObject<{
+      label: Type.TString;
+      state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"satisfied">, Type.TLiteral<"running">, Type.TLiteral<"done">, Type.TLiteral<"failed">]>;
+      detail: Type.TOptional<Type.TString>;
+    }>>>;
+    /**
+     * The tail of a running command's terminal output.
+     *
+     * A tail rather than the whole scrollback: the field is a few rows of a
+     * shared pane, and what matters is the question a package manager just
+     * asked, not what it printed a minute ago.
+     */
+    output: Type.TOptional<Type.TArray<Type.TString>>;
+    /**
+     * The command is waiting on the user. The renderer offers a line to type
+     * into, which comes back as an owner-defined action carrying the text.
+     */
+    awaitingInput: Type.TOptional<Type.TBoolean>;
+  }>>;
+}>;
+export type ConfigSection = Static<typeof ConfigSectionSchema>;
+declare const ConfigSourceRefSchema: Type.TObject<{
+  source: Type.TString;
+  generation: Type.TString;
+}>;
+declare const ConfigSnapshotSchema: Type.TObject<{
+  source: Type.TString;
+  generation: Type.TString;
+  sections: Type.TArray<Type.TObject<{
+    id: Type.TString;
+    title: Type.TString;
+    detail: Type.TOptional<Type.TString>;
+    order: Type.TInteger;
+    /** Section-wide state: readiness, or why a write failed. */
+    notice: Type.TOptional<Type.TString>;
+    noticeLevel: Type.TOptional<Type.TUnion<[Type.TLiteral<"info">, Type.TLiteral<"error">]>>;
+    fields: Type.TArray<Type.TObject<{
+      id: Type.TString;
+      label: Type.TString;
+      kind: Type.TUnion<[Type.TLiteral<"text">, Type.TLiteral<"enum">, Type.TLiteral<"choice">, Type.TLiteral<"info">]>;
+      /** Absent means unset; the renderer shows `placeholder` instead. */
+      value: Type.TOptional<Type.TString>;
+      placeholder: Type.TOptional<Type.TString>;
+      /** One line of help for the focused field. */
+      detail: Type.TOptional<Type.TString>;
+      /** The config key this writes, shown under the focused field so the file stays legible. */
+      keyPath: Type.TOptional<Type.TString>;
+      status: Type.TOptional<Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>>;
+      /** Doubles as the error line: a rejected edit comes back as the old value plus this. */
+      statusText: Type.TOptional<Type.TString>;
+      choices: Type.TOptional<Type.TArray<Type.TObject<{
+        id: Type.TString;
+        label: Type.TString;
+        /** Right-aligned by the renderer. Sizes, ids, anything narrow. */
+        detail: Type.TOptional<Type.TString>;
+        /** Groups entries under a heading the cursor skips over. */
+        group: Type.TOptional<Type.TString>;
+        status: Type.TOptional<Type.TUnion<[Type.TLiteral<"ready">, Type.TLiteral<"available">, Type.TLiteral<"blocked">]>>;
+        statusText: Type.TOptional<Type.TString>;
+        /**
+         * What enter does on this entry. Carrying it per-entry is what lets one list
+         * hold both an installed model that only needs selecting and an absent one
+         * that needs fetching, without the renderer knowing the difference.
+         */
+        action: Type.TOptional<Type.TString>;
+      }>>>;
+      actions: Type.TOptional<Type.TArray<Type.TObject<{
+        key: Type.TString;
+        label: Type.TString;
+        action: Type.TString;
+      }>>>;
+      /** Work is running; the renderer dims the field and offers abort. */
+      busy: Type.TOptional<Type.TBoolean>;
+      progress: Type.TOptional<Type.TObject<{
+        label: Type.TString;
+        /** 0 to 1. Omitted when the work has no measurable total. */
+        ratio: Type.TOptional<Type.TNumber>;
+      }>>;
+      steps: Type.TOptional<Type.TArray<Type.TObject<{
+        label: Type.TString;
+        state: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"satisfied">, Type.TLiteral<"running">, Type.TLiteral<"done">, Type.TLiteral<"failed">]>;
+        detail: Type.TOptional<Type.TString>;
+      }>>>;
+      /**
+       * The tail of a running command's terminal output.
+       *
+       * A tail rather than the whole scrollback: the field is a few rows of a
+       * shared pane, and what matters is the question a package manager just
+       * asked, not what it printed a minute ago.
+       */
+      output: Type.TOptional<Type.TArray<Type.TString>>;
+      /**
+       * The command is waiting on the user. The renderer offers a line to type
+       * into, which comes back as an owner-defined action carrying the text.
+       */
+      awaitingInput: Type.TOptional<Type.TBoolean>;
+    }>>;
+  }>>;
+}>;
+export type ConfigSnapshot = Static<typeof ConfigSnapshotSchema>;
+export type ConfigSourceRef = Static<typeof ConfigSourceRefSchema>;
+export declare const CONFIG_ACTION: {
+  readonly set: 'set';
+  readonly clear: 'clear';
+};
+export interface DoomExtensionContext {
+  sessionManager: {
+    getSessionId(): string;
+  };
+}
+export interface DoomConfigSectionView extends ConfigSection {
+  source: string;
+}
+export interface DoomConfigInvocation {
+  source: string;
+  sectionId: string;
+  fieldId: string;
+  action: string;
+  value?: string;
+}
+export interface DoomConfigActionInput<Context extends DoomExtensionContext = DoomExtensionContext> {
+  ctx: Context;
+  sectionId: string;
+  fieldId: string;
+  value?: string;
+}
+export interface DoomConfigContributionOptions<Context extends DoomExtensionContext = DoomExtensionContext> {
+  source: string;
+  listSections: () => readonly ConfigSection[];
+  handlers: Readonly<Record<string, (input: DoomConfigActionInput<Context>) => void | Promise<void>>>;
+  onError: (error: unknown, actionName: string, ctx: Context) => void;
+}
+export interface DoomConfigContributionHandle {
+  update(): void;
+  dispose(): void;
+}
+//#endregion
+//# sourceMappingURL=runtime-config.d.mts.map

package/dist/runtime-config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.d.mts","names":[],"sources":["../src/schemas/config.ts"],"mappings":";;;qBAqBa;;qBAGA,oBAAkB,KAAA;;;;;;qBAalB,oBAAkB,KAAA,QAAA,KAAA,mBAAA,KAAA,uBAAA,KAAA;YAKnB,eAAe,cAAc;qBAE5B,uBAAqB,KAAA,QAAA,KAAA,kBAAA,KAAA,kBAAA,KAAA,oBAAA,KAAA;YAUtB,kBAAkB,cAAc;;;;;;qBAO/B,oBAAkB,KAAA;;;;;YAQnB,eAAe,cAAc;qBAE5B,oBAAkB,KAAA;;;;;;;;;;;;;;;;YAmBnB,eAAe,cAAc;;;;;;;;;qBAU5B,kBAAgB,KAAA;;;;;YAejB,aAAa,cAAc;qBAE1B,sBAAoB,KAAA;;;;;YAQrB,iBAAiB,cAAc;qBAE9B,mBAAiB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAqClB,cAAc,cAAc;qBAE3B,qBAAmB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAapB,gBAAgB,cAAc;cAEpC,uBAAqB,KAAA;;;;cAKrB,sBAAoB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAId,iBAAiB,cAAc;YAC/B,kBAAkB,cAAc;qBAE/B;WACX;WACA;;iBAGe;EACf;IAAkB;;;iBAGH,8BAA8B;EAC7C;;iBAGe;EACf;EACA;EACA;EACA;EACA;;iBAGe,sBAAsB,gBAAgB,uBAAuB;EAC5E,KAAK;EACL;EACA;EACA;;iBAGe,8BAA8B,gBAAgB,uBAAuB;EACpF;EACA,6BAA6B;EAC7B,UAAU,SAAS,gBAAgB,OAAO,sBAAsB,oBAAoB;EACpF,UAAU,gBAAgB,oBAAoB,KAAK;;iBAGpC;EACf;EACA"}

package/dist/runtime-config.mjs

@@ -0,0 +1,221 @@
+import { Type } from "typebox";
+//#region src/schemas/config.ts
+/**
+* Configuration surfaces, contributed by every extension that owns settings.
+*
+* Doom settings live in one YAML file but are owned by many extensions, and for
+* a long time the only way to change any of them was to edit that file by hand.
+* The one exception, an editor-command prompt, asked for a value with no way to
+* see what a valid one looked like.
+*
+* So configuration is published rather than centralised: an extension describes
+* its own fields, one renderer draws them all, and the extension still performs
+* every write. Nothing here knows what a voice model or an editor command is.
+*
+* Deliberately the same shape as the mode and footer contracts next door, since
+* the problem is the same one: several extensions sharing one surface. The UI
+* hub invokes an owner's registered action directly, because unlike a status
+* strip this surface is written to as well as read.
+*/
+/** Canonical Cordis key for the session-owned Doom configuration service. */
+const DOOM_CONFIG_SERVICE = "doom/config";
+/** Matches the leader contract's source rule: package names, addressable and spoof-checkable. */
+const ConfigSourceSchema = Type.String({
+	minLength: 1,
+	maxLength: 128,
+	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
+});
+const ConfigIdSchema = Type.String({
+	minLength: 1,
+	maxLength: 128,
+	pattern: "^[a-z0-9][a-z0-9._:-]*$"
+});
+/**
+* How ready a value is to be used, as opposed to whether it is merely set.
+* `blocked` covers a choice that needs something else first, such as a model
+* whose engine is not installed.
+*/
+const ConfigStatusSchema = Type.Union([
+	Type.Literal("ready"),
+	Type.Literal("available"),
+	Type.Literal("blocked")
+]);
+const ConfigFieldKindSchema = Type.Union([
+	Type.Literal("text"),
+	Type.Literal("enum"),
+	Type.Literal("choice"),
+	Type.Literal("info")
+]);
+/**
+* A key the renderer offers on the focused field, sent back verbatim as an
+* action. Owners use this for confirmations, so the pending question survives a
+* panel that is closed and reopened.
+*/
+const ConfigActionSchema = Type.Object({
+	key: Type.String({
+		minLength: 1,
+		maxLength: 1
+	}),
+	label: Type.String({
+		minLength: 1,
+		maxLength: 24
+	}),
+	action: ConfigIdSchema
+}, { additionalProperties: false });
+const ConfigChoiceSchema = Type.Object({
+	id: Type.String({
+		minLength: 1,
+		maxLength: 256
+	}),
+	label: Type.String({
+		minLength: 1,
+		maxLength: 96
+	}),
+	/** Right-aligned by the renderer. Sizes, ids, anything narrow. */
+	detail: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 96
+	})),
+	/** Groups entries under a heading the cursor skips over. */
+	group: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 48
+	})),
+	status: Type.Optional(ConfigStatusSchema),
+	statusText: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 96
+	})),
+	/**
+	* What enter does on this entry. Carrying it per-entry is what lets one list
+	* hold both an installed model that only needs selecting and an absent one
+	* that needs fetching, without the renderer knowing the difference.
+	*/
+	action: Type.Optional(ConfigIdSchema)
+}, { additionalProperties: false });
+/**
+* One line of a multi-step operation.
+*
+* Published as a list rather than a single "current step" string so the panel can
+* show what already ran alongside what is left. During an install that is the
+* difference between "something is happening" and knowing a package manager
+* already finished and a download is now underway.
+*/
+const ConfigStepSchema = Type.Object({
+	label: Type.String({
+		minLength: 1,
+		maxLength: 96
+	}),
+	state: Type.Union([
+		Type.Literal("pending"),
+		Type.Literal("satisfied"),
+		Type.Literal("running"),
+		Type.Literal("done"),
+		Type.Literal("failed")
+	]),
+	detail: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 160
+	}))
+}, { additionalProperties: false });
+const ConfigProgressSchema = Type.Object({
+	label: Type.String({
+		minLength: 1,
+		maxLength: 96
+	}),
+	/** 0 to 1. Omitted when the work has no measurable total. */
+	ratio: Type.Optional(Type.Number({
+		minimum: 0,
+		maximum: 1
+	}))
+}, { additionalProperties: false });
+const ConfigFieldSchema = Type.Object({
+	id: ConfigIdSchema,
+	label: Type.String({
+		minLength: 1,
+		maxLength: 48
+	}),
+	kind: ConfigFieldKindSchema,
+	/** Absent means unset; the renderer shows `placeholder` instead. */
+	value: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 4096
+	})),
+	placeholder: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 96
+	})),
+	/** One line of help for the focused field. */
+	detail: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 240
+	})),
+	/** The config key this writes, shown under the focused field so the file stays legible. */
+	keyPath: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 128
+	})),
+	status: Type.Optional(ConfigStatusSchema),
+	/** Doubles as the error line: a rejected edit comes back as the old value plus this. */
+	statusText: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 240
+	})),
+	choices: Type.Optional(Type.Array(ConfigChoiceSchema, { maxItems: 128 })),
+	actions: Type.Optional(Type.Array(ConfigActionSchema, { maxItems: 4 })),
+	/** Work is running; the renderer dims the field and offers abort. */
+	busy: Type.Optional(Type.Boolean()),
+	progress: Type.Optional(ConfigProgressSchema),
+	steps: Type.Optional(Type.Array(ConfigStepSchema, { maxItems: 24 })),
+	/**
+	* The tail of a running command's terminal output.
+	*
+	* A tail rather than the whole scrollback: the field is a few rows of a
+	* shared pane, and what matters is the question a package manager just
+	* asked, not what it printed a minute ago.
+	*/
+	output: Type.Optional(Type.Array(Type.String({ maxLength: 512 }), { maxItems: 64 })),
+	/**
+	* The command is waiting on the user. The renderer offers a line to type
+	* into, which comes back as an owner-defined action carrying the text.
+	*/
+	awaitingInput: Type.Optional(Type.Boolean())
+}, { additionalProperties: false });
+const ConfigSectionSchema = Type.Object({
+	id: ConfigIdSchema,
+	title: Type.String({
+		minLength: 1,
+		maxLength: 32
+	}),
+	detail: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 96
+	})),
+	order: Type.Integer({
+		minimum: 0,
+		maximum: 1e3
+	}),
+	/** Section-wide state: readiness, or why a write failed. */
+	notice: Type.Optional(Type.String({
+		minLength: 1,
+		maxLength: 240
+	})),
+	noticeLevel: Type.Optional(Type.Union([Type.Literal("info"), Type.Literal("error")])),
+	fields: Type.Array(ConfigFieldSchema, { maxItems: 64 })
+}, { additionalProperties: false });
+const ConfigSourceRefSchema = Type.Object({
+	source: ConfigSourceSchema,
+	generation: Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+Type.Object({
+	...ConfigSourceRefSchema.properties,
+	sections: Type.Array(ConfigSectionSchema, { maxItems: 32 })
+}, { additionalProperties: false });
+const CONFIG_ACTION = {
+	set: "set",
+	clear: "clear"
+};
+//#endregion
+export { CONFIG_ACTION, ConfigActionSchema, ConfigChoiceSchema, ConfigFieldKindSchema, ConfigFieldSchema, ConfigProgressSchema, ConfigSectionSchema, ConfigSourceSchema, ConfigStatusSchema, ConfigStepSchema, DOOM_CONFIG_SERVICE };
+
+//# sourceMappingURL=runtime-config.mjs.map

package/dist/runtime-config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-config.mjs","names":[],"sources":["../src/schemas/config.ts"],"sourcesContent":["/**\n * Configuration surfaces, contributed by every extension that owns settings.\n *\n * Doom settings live in one YAML file but are owned by many extensions, and for\n * a long time the only way to change any of them was to edit that file by hand.\n * The one exception, an editor-command prompt, asked for a value with no way to\n * see what a valid one looked like.\n *\n * So configuration is published rather than centralised: an extension describes\n * its own fields, one renderer draws them all, and the extension still performs\n * every write. Nothing here knows what a voice model or an editor command is.\n *\n * Deliberately the same shape as the mode and footer contracts next door, since\n * the problem is the same one: several extensions sharing one surface. The UI\n * hub invokes an owner's registered action directly, because unlike a status\n * strip this surface is written to as well as read.\n */\n\nimport { type Static, Type } from 'typebox';\n\n/** Canonical Cordis key for the session-owned Doom configuration service. */\nexport const DOOM_CONFIG_SERVICE = 'doom/config';\n\n/** Matches the leader contract's source rule: package names, addressable and spoof-checkable. */\nexport const ConfigSourceSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nconst ConfigIdSchema = Type.String({ minLength: 1, maxLength: 128, pattern: '^[a-z0-9][a-z0-9._:-]*$' });\n\n/**\n * How ready a value is to be used, as opposed to whether it is merely set.\n * `blocked` covers a choice that needs something else first, such as a model\n * whose engine is not installed.\n */\nexport const ConfigStatusSchema = Type.Union([\n  Type.Literal('ready'),\n  Type.Literal('available'),\n  Type.Literal('blocked'),\n]);\nexport type ConfigStatus = Static<typeof ConfigStatusSchema>;\n\nexport const ConfigFieldKindSchema = Type.Union([\n  /** Free text, edited in place. */\n  Type.Literal('text'),\n  /** A short closed set, cycled in place. */\n  Type.Literal('enum'),\n  /** A long set worth its own screen, with per-entry status and actions. */\n  Type.Literal('choice'),\n  /** Read-only. Resolution results, derived values, preflight checks. */\n  Type.Literal('info'),\n]);\nexport type ConfigFieldKind = Static<typeof ConfigFieldKindSchema>;\n\n/**\n * A key the renderer offers on the focused field, sent back verbatim as an\n * action. Owners use this for confirmations, so the pending question survives a\n * panel that is closed and reopened.\n */\nexport const ConfigActionSchema = Type.Object(\n  {\n    key: Type.String({ minLength: 1, maxLength: 1 }),\n    label: Type.String({ minLength: 1, maxLength: 24 }),\n    action: ConfigIdSchema,\n  },\n  { additionalProperties: false },\n);\nexport type ConfigAction = Static<typeof ConfigActionSchema>;\n\nexport const ConfigChoiceSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1, maxLength: 256 }),\n    label: Type.String({ minLength: 1, maxLength: 96 }),\n    /** Right-aligned by the renderer. Sizes, ids, anything narrow. */\n    detail: Type.Optional(Type.String({ minLength: 1, maxLength: 96 })),\n    /** Groups entries under a heading the cursor skips over. */\n    group: Type.Optional(Type.String({ minLength: 1, maxLength: 48 })),\n    status: Type.Optional(ConfigStatusSchema),\n    statusText: Type.Optional(Type.String({ minLength: 1, maxLength: 96 })),\n    /**\n     * What enter does on this entry. Carrying it per-entry is what lets one list\n     * hold both an installed model that only needs selecting and an absent one\n     * that needs fetching, without the renderer knowing the difference.\n     */\n    action: Type.Optional(ConfigIdSchema),\n  },\n  { additionalProperties: false },\n);\nexport type ConfigChoice = Static<typeof ConfigChoiceSchema>;\n\n/**\n * One line of a multi-step operation.\n *\n * Published as a list rather than a single \"current step\" string so the panel can\n * show what already ran alongside what is left. During an install that is the\n * difference between \"something is happening\" and knowing a package manager\n * already finished and a download is now underway.\n */\nexport const ConfigStepSchema = Type.Object(\n  {\n    label: Type.String({ minLength: 1, maxLength: 96 }),\n    state: Type.Union([\n      Type.Literal('pending'),\n      /** Already true of this machine, so nothing will run for it. */\n      Type.Literal('satisfied'),\n      Type.Literal('running'),\n      Type.Literal('done'),\n      Type.Literal('failed'),\n    ]),\n    detail: Type.Optional(Type.String({ minLength: 1, maxLength: 160 })),\n  },\n  { additionalProperties: false },\n);\nexport type ConfigStep = Static<typeof ConfigStepSchema>;\n\nexport const ConfigProgressSchema = Type.Object(\n  {\n    label: Type.String({ minLength: 1, maxLength: 96 }),\n    /** 0 to 1. Omitted when the work has no measurable total. */\n    ratio: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })),\n  },\n  { additionalProperties: false },\n);\nexport type ConfigProgress = Static<typeof ConfigProgressSchema>;\n\nexport const ConfigFieldSchema = Type.Object(\n  {\n    id: ConfigIdSchema,\n    label: Type.String({ minLength: 1, maxLength: 48 }),\n    kind: ConfigFieldKindSchema,\n    /** Absent means unset; the renderer shows `placeholder` instead. */\n    value: Type.Optional(Type.String({ minLength: 1, maxLength: 4096 })),\n    placeholder: Type.Optional(Type.String({ minLength: 1, maxLength: 96 })),\n    /** One line of help for the focused field. */\n    detail: Type.Optional(Type.String({ minLength: 1, maxLength: 240 })),\n    /** The config key this writes, shown under the focused field so the file stays legible. */\n    keyPath: Type.Optional(Type.String({ minLength: 1, maxLength: 128 })),\n    status: Type.Optional(ConfigStatusSchema),\n    /** Doubles as the error line: a rejected edit comes back as the old value plus this. */\n    statusText: Type.Optional(Type.String({ minLength: 1, maxLength: 240 })),\n    choices: Type.Optional(Type.Array(ConfigChoiceSchema, { maxItems: 128 })),\n    actions: Type.Optional(Type.Array(ConfigActionSchema, { maxItems: 4 })),\n    /** Work is running; the renderer dims the field and offers abort. */\n    busy: Type.Optional(Type.Boolean()),\n    progress: Type.Optional(ConfigProgressSchema),\n    steps: Type.Optional(Type.Array(ConfigStepSchema, { maxItems: 24 })),\n    /**\n     * The tail of a running command's terminal output.\n     *\n     * A tail rather than the whole scrollback: the field is a few rows of a\n     * shared pane, and what matters is the question a package manager just\n     * asked, not what it printed a minute ago.\n     */\n    output: Type.Optional(Type.Array(Type.String({ maxLength: 512 }), { maxItems: 64 })),\n    /**\n     * The command is waiting on the user. The renderer offers a line to type\n     * into, which comes back as an owner-defined action carrying the text.\n     */\n    awaitingInput: Type.Optional(Type.Boolean()),\n  },\n  { additionalProperties: false },\n);\nexport type ConfigField = Static<typeof ConfigFieldSchema>;\n\nexport const ConfigSectionSchema = Type.Object(\n  {\n    id: ConfigIdSchema,\n    title: Type.String({ minLength: 1, maxLength: 32 }),\n    detail: Type.Optional(Type.String({ minLength: 1, maxLength: 96 })),\n    order: Type.Integer({ minimum: 0, maximum: 1000 }),\n    /** Section-wide state: readiness, or why a write failed. */\n    notice: Type.Optional(Type.String({ minLength: 1, maxLength: 240 })),\n    noticeLevel: Type.Optional(Type.Union([Type.Literal('info'), Type.Literal('error')])),\n    fields: Type.Array(ConfigFieldSchema, { maxItems: 64 }),\n  },\n  { additionalProperties: false },\n);\nexport type ConfigSection = Static<typeof ConfigSectionSchema>;\n\nconst ConfigSourceRefSchema = Type.Object(\n  { source: ConfigSourceSchema, generation: Type.String({ minLength: 1 }) },\n  { additionalProperties: false },\n);\n\nconst ConfigSnapshotSchema = Type.Object(\n  { ...ConfigSourceRefSchema.properties, sections: Type.Array(ConfigSectionSchema, { maxItems: 32 }) },\n  { additionalProperties: false },\n);\nexport type ConfigSnapshot = Static<typeof ConfigSnapshotSchema>;\nexport type ConfigSourceRef = Static<typeof ConfigSourceRefSchema>;\n\nexport const CONFIG_ACTION = {\n  set: 'set',\n  clear: 'clear',\n} as const;\n\nexport interface DoomExtensionContext {\n  sessionManager: { getSessionId(): string };\n}\n\nexport interface DoomConfigSectionView extends ConfigSection {\n  source: string;\n}\n\nexport interface DoomConfigInvocation {\n  source: string;\n  sectionId: string;\n  fieldId: string;\n  action: string;\n  value?: string;\n}\n\nexport interface DoomConfigActionInput<Context extends DoomExtensionContext = DoomExtensionContext> {\n  ctx: Context;\n  sectionId: string;\n  fieldId: string;\n  value?: string;\n}\n\nexport interface DoomConfigContributionOptions<Context extends DoomExtensionContext = DoomExtensionContext> {\n  source: string;\n  listSections: () => readonly ConfigSection[];\n  handlers: Readonly<Record<string, (input: DoomConfigActionInput<Context>) => void | Promise<void>>>;\n  onError: (error: unknown, actionName: string, ctx: Context) => void;\n}\n\nexport interface DoomConfigContributionHandle {\n  update(): void;\n  dispose(): void;\n}\n"],"mappings":"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"}

package/dist/runtime-context-api.cjs

@@ -0,0 +1,64 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_contextApi = require("./constants/contextApi.cjs");
+const require_context_detail_store = require("./context-detail-store.cjs");
+//#region src/server/contextApi.ts
+/**
+* What one row of the composition actually is, on request.
+*
+* The context panel prices every tool and skill the session carries, and the
+* figure is only half an answer: the reader deciding whether a package earns
+* its thousand tokens wants the prose and the schema behind it. Those are too
+* large to push, and they are wanted one row at a time, so they are served
+* here instead and fetched on the click.
+*
+* The agent writes the store; this reads it. The two are separate processes
+* and the inventory only exists inside the agent, which is the same split
+* every other package-owned API in the repository lives with.
+*/
+function json(body, status) {
+	return new Response(JSON.stringify(body), {
+		status,
+		headers: { "content-type": "application/json; charset=utf-8" }
+	});
+}
+function isItemKind(value) {
+	return value === "tool" || value === "skill";
+}
+function createContextApi(options = {}) {
+	const readDetail = options.readDetail ?? require_context_detail_store.readContextDetail;
+	return {
+		fetch(request) {
+			const url = new URL(request.url);
+			if (url.pathname !== "/item") return json({ error: "No such route." }, 404);
+			if (request.method !== "GET") return json({ error: "Only GET is served here." }, 405);
+			if (options.sessionId === void 0) return json({ error: "This host serves no session." }, 404);
+			const itemKind = url.searchParams.get(require_contextApi.KIND_QUERY_PARAM);
+			const name = url.searchParams.get(require_contextApi.NAME_QUERY_PARAM);
+			if (!isItemKind(itemKind)) return json({ error: "Ask for a tool or a skill." }, 400);
+			if (name === null || name === "") return json({ error: "Name the item to describe." }, 400);
+			const file = options.readDetail ? options.readDetail(options.sessionId, options.environment) : options.environment === void 0 ? void 0 : readDetail(options.sessionId, options.environment);
+			if (file === void 0) return json({ error: "This session has not reported its composition yet." }, 404);
+			const item = require_context_detail_store.findContextItem(file, itemKind, name);
+			if (item === void 0) return json({ error: `The session carries no ${itemKind} called ${name}.` }, 404);
+			return json({
+				revision: file.revision,
+				item
+			}, 200);
+		},
+		close: () => {}
+	};
+}
+const api = {
+	basePath: require_contextApi.API_BASE_PATH,
+	start(context) {
+		return createContextApi({
+			...context.sessionId === void 0 ? {} : { sessionId: context.sessionId },
+			...context.environment === void 0 ? {} : { environment: context.environment }
+		});
+	}
+};
+//#endregion
+exports.api = api;
+exports.createContextApi = createContextApi;
+
+//# sourceMappingURL=runtime-context-api.cjs.map

package/dist/runtime-context-api.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context-api.cjs","names":["readContextDetail","KIND_QUERY_PARAM","NAME_QUERY_PARAM","findContextItem","API_BASE_PATH"],"sources":["../src/server/contextApi.ts"],"sourcesContent":["import { API_BASE_PATH, ITEM_ROUTE, KIND_QUERY_PARAM, NAME_QUERY_PARAM } from '../constants/contextApi';\nimport type { DoomApi, DoomApiContext, DoomApiHandler } from '../exports/packageApi';\nimport { findContextItem, readContextDetail } from '../services/contextDetailStore';\n\n/**\n * What one row of the composition actually is, on request.\n *\n * The context panel prices every tool and skill the session carries, and the\n * figure is only half an answer: the reader deciding whether a package earns\n * its thousand tokens wants the prose and the schema behind it. Those are too\n * large to push, and they are wanted one row at a time, so they are served\n * here instead and fetched on the click.\n *\n * The agent writes the store; this reads it. The two are separate processes\n * and the inventory only exists inside the agent, which is the same split\n * every other package-owned API in the repository lives with.\n */\n\nfunction json(body: unknown, status: number): Response {\n  return new Response(JSON.stringify(body), {\n    status,\n    headers: { 'content-type': 'application/json; charset=utf-8' },\n  });\n}\n\nfunction isItemKind(value: string | null): value is 'tool' | 'skill' {\n  return value === 'tool' || value === 'skill';\n}\n\nexport interface ContextApiOptions {\n  /** The session these routes answer for; absent when the host is the hub. */\n  sessionId?: string;\n  /** Session environment admitted by the host. */\n  environment?: Readonly<Record<string, string | undefined>>;\n  /** Injectable for tests; defaults to the file the agent writes. */\n  readDetail?: typeof readContextDetail;\n}\n\nexport function createContextApi(options: ContextApiOptions = {}): DoomApiHandler {\n  const readDetail = options.readDetail ?? readContextDetail;\n  return {\n    fetch(request: Request): Response {\n      const url = new URL(request.url);\n      if (url.pathname !== ITEM_ROUTE) return json({ error: 'No such route.' }, 404);\n      if (request.method !== 'GET') return json({ error: 'Only GET is served here.' }, 405);\n      if (options.sessionId === undefined) return json({ error: 'This host serves no session.' }, 404);\n\n      const itemKind = url.searchParams.get(KIND_QUERY_PARAM);\n      const name = url.searchParams.get(NAME_QUERY_PARAM);\n      if (!isItemKind(itemKind)) return json({ error: 'Ask for a tool or a skill.' }, 400);\n      if (name === null || name === '') return json({ error: 'Name the item to describe.' }, 400);\n\n      const file = options.readDetail\n        ? options.readDetail(options.sessionId, options.environment)\n        : options.environment === undefined\n          ? undefined\n          : readDetail(options.sessionId, options.environment);\n      // A session that has not published yet is the ordinary state for the\n      // first half-second of its life, and says so rather than looking broken.\n      if (file === undefined) {\n        return json({ error: 'This session has not reported its composition yet.' }, 404);\n      }\n      const item = findContextItem(file, itemKind, name);\n      if (item === undefined) return json({ error: `The session carries no ${itemKind} called ${name}.` }, 404);\n      return json({ revision: file.revision, item }, 200);\n    },\n    close: () => {},\n  };\n}\n\nexport const api: DoomApi = {\n  basePath: API_BASE_PATH,\n  start(context: DoomApiContext): DoomApiHandler {\n    return createContextApi({\n      ...(context.sessionId === undefined ? {} : { sessionId: context.sessionId }),\n      ...(context.environment === undefined ? {} : { environment: context.environment }),\n    });\n  },\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,SAAS,KAAK,MAAe,QAA0B;CACrD,OAAO,IAAI,SAAS,KAAK,UAAU,IAAI,GAAG;EACxC;EACA,SAAS,EAAE,gBAAgB,kCAAkC;CAC/D,CAAC;AACH;AAEA,SAAS,WAAW,OAAiD;CACnE,OAAO,UAAU,UAAU,UAAU;AACvC;AAWA,SAAgB,iBAAiB,UAA6B,CAAC,GAAmB;CAChF,MAAM,aAAa,QAAQ,cAAcA,6BAAAA;CACzC,OAAO;EACL,MAAM,SAA4B;GAChC,MAAM,MAAM,IAAI,IAAI,QAAQ,GAAG;GAC/B,IAAI,IAAI,aAAA,SAAyB,OAAO,KAAK,EAAE,OAAO,iBAAiB,GAAG,GAAG;GAC7E,IAAI,QAAQ,WAAW,OAAO,OAAO,KAAK,EAAE,OAAO,2BAA2B,GAAG,GAAG;GACpF,IAAI,QAAQ,cAAc,KAAA,GAAW,OAAO,KAAK,EAAE,OAAO,+BAA+B,GAAG,GAAG;GAE/F,MAAM,WAAW,IAAI,aAAa,IAAIC,mBAAAA,gBAAgB;GACtD,MAAM,OAAO,IAAI,aAAa,IAAIC,mBAAAA,gBAAgB;GAClD,IAAI,CAAC,WAAW,QAAQ,GAAG,OAAO,KAAK,EAAE,OAAO,6BAA6B,GAAG,GAAG;GACnF,IAAI,SAAS,QAAQ,SAAS,IAAI,OAAO,KAAK,EAAE,OAAO,6BAA6B,GAAG,GAAG;GAE1F,MAAM,OAAO,QAAQ,aACjB,QAAQ,WAAW,QAAQ,WAAW,QAAQ,WAAW,IACzD,QAAQ,gBAAgB,KAAA,IACtB,KAAA,IACA,WAAW,QAAQ,WAAW,QAAQ,WAAW;GAGvD,IAAI,SAAS,KAAA,GACX,OAAO,KAAK,EAAE,OAAO,qDAAqD,GAAG,GAAG;GAElF,MAAM,OAAOC,6BAAAA,gBAAgB,MAAM,UAAU,IAAI;GACjD,IAAI,SAAS,KAAA,GAAW,OAAO,KAAK,EAAE,OAAO,0BAA0B,SAAS,UAAU,KAAK,GAAG,GAAG,GAAG;GACxG,OAAO,KAAK;IAAE,UAAU,KAAK;IAAU;GAAK,GAAG,GAAG;EACpD;EACA,aAAa,CAAC;CAChB;AACF;AAEA,MAAa,MAAe;CAC1B,UAAUC,mBAAAA;CACV,MAAM,SAAyC;EAC7C,OAAO,iBAAiB;GACtB,GAAI,QAAQ,cAAc,KAAA,IAAY,CAAC,IAAI,EAAE,WAAW,QAAQ,UAAU;GAC1E,GAAI,QAAQ,gBAAgB,KAAA,IAAY,CAAC,IAAI,EAAE,aAAa,QAAQ,YAAY;EAClF,CAAC;CACH;AACF"}

package/dist/runtime-context-api.d.cts

@@ -0,0 +1,16 @@
+import { DoomApi, DoomApiHandler } from "./schemas/packageApi.cjs";
+import "./package-api.cjs";
+import { readContextDetail } from "./context-detail-store.cjs";
+//#region src/server/contextApi.d.ts
+export interface ContextApiOptions {
+  /** The session these routes answer for; absent when the host is the hub. */
+  sessionId?: string;
+  /** Session environment admitted by the host. */
+  environment?: Readonly<Record<string, string | undefined>>;
+  /** Injectable for tests; defaults to the file the agent writes. */
+  readDetail?: typeof readContextDetail;
+}
+export declare function createContextApi(options?: ContextApiOptions): DoomApiHandler;
+export declare const api: DoomApi;
+//#endregion
+//# sourceMappingURL=runtime-context-api.d.cts.map

package/dist/runtime-context-api.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context-api.d.cts","names":[],"sources":["../src/server/contextApi.ts"],"mappings":";;;;iBA6BiB;;EAEf;;EAEA,cAAc,SAAS;;EAEvB,oBAAoB;;wBAGN,iBAAiB,UAAS,oBAAyB;qBAgCtD,KAAK"}