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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionProtocol.cjs","names":["defineService"],"sources":["../../../src/schemas/sessionProtocol.ts"],"sourcesContent":["import { defineService, type Context, type ReplicatedState } from '@earendil-works/chord';\n\nimport type { DoomSessionUpdateEvent } from './sessionUpdates';\n\nexport const DOOM_SESSION_SERVICE_ID = 'doompi.session.v2';\nexport const DOOM_SESSION_MANAGEMENT_SERVICE_ID = 'doompi.session-management.v1';\nexport const DOOM_COCKPIT_SERVER_ID = '646f6f6d-7069-4000-8000-000000000001';\n\nexport type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };\nexport type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';\nexport type SessionPhase = 'idle' | 'turn' | 'compaction' | 'retry';\n\n/** Native execution ownership plus DoomPi's durable pending-input policy. */\nexport interface SessionLifecycle {\n  revision: number;\n  operation: { id: string; kind: 'run' | 'compaction' | 'navigation'; status: 'open' | 'aborting' } | null;\n  paused: boolean;\n  queue: Array<{\n    id: string;\n    text: string;\n    images?: ImageContentPart[];\n    delivery: 'steer' | 'followUp' | 'nextRun';\n    scheduling: 'automatic' | 'held';\n    disposition: 'pending' | 'handoff' | 'uncertain';\n  }>;\n}\n\nexport interface ModelRef {\n  provider: string;\n  id: string;\n}\n\nexport interface TextContentPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ImageContentPart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport interface ThinkingContentPart {\n  type: 'thinking';\n  thinking: string;\n  redacted?: true;\n}\n\nexport interface ToolCallContentPart {\n  type: 'toolCall';\n  toolCallId: string;\n  toolName: string;\n  input: JsonValue;\n}\n\nexport interface UserTranscriptItem {\n  id: string;\n  role: 'user';\n  content: Array<TextContentPart | ImageContentPart>;\n  timestamp: number;\n}\n\nexport interface AssistantTranscriptItem {\n  id: string;\n  role: 'assistant';\n  content: Array<TextContentPart | ThinkingContentPart | ToolCallContentPart>;\n  model: ModelRef;\n  status: 'streaming' | 'complete' | 'aborted' | 'error';\n  stopReason?: 'stop' | 'length' | 'toolUse' | 'aborted' | 'error';\n  errorMessage?: string;\n  timestamp: number;\n}\n\nexport interface ToolTranscriptItem {\n  id: string;\n  role: 'tool';\n  toolCallId: string;\n  toolName: string;\n  input: JsonValue;\n  content: Array<TextContentPart | ImageContentPart>;\n  details?: JsonValue;\n  status: 'running' | 'complete' | 'error';\n  isError: boolean;\n  timestamp: number;\n}\n\nexport type TranscriptItem = UserTranscriptItem | AssistantTranscriptItem | ToolTranscriptItem;\n\nexport type TranscriptProgress =\n  | { type: 'item_started'; item: TranscriptItem }\n  | { type: 'item_updated'; item: TranscriptItem }\n  | { type: 'item_finished'; item: TranscriptItem };\n\nexport interface SessionSnapshot {\n  id: string;\n  cwd: string;\n  name?: string;\n  createdAt: number;\n  updatedAt: number;\n  phase: SessionPhase;\n  model: ModelRef;\n  thinkingLevel: ThinkingLevel;\n  attached: boolean;\n  locked: boolean;\n  revision: number;\n  transcript: TranscriptItem[];\n  queuedSteer: UserTranscriptItem[];\n  queuedSteerCount: number;\n  /** Authoritative execution and queue state, independent of transcript replay. */\n  lifecycle?: SessionLifecycle;\n}\n\nexport interface ProtocolEvent {\n  sequence: number;\n  frame: { type: string; [key: string]: JsonValue };\n}\n\nexport interface SessionPresentation {\n  revision: number;\n  dropped: number;\n  /** A branch replacement invalidates earlier presentation state, even without ring overflow. */\n  resetRevision?: number;\n  events: ProtocolEvent[];\n  projections: ProtocolEvent[];\n}\n\nexport interface HubService {\n  readonly state: ReplicatedState<{ events: ProtocolEvent[] }>;\n  send(frame: { type: string; [key: string]: JsonValue }, context: Context): Promise<void>;\n}\n\nexport const DoomHubService = defineService<HubService>('doompi.hub.v1');\n\nexport interface SessionServiceState {\n  snapshot: Omit<SessionSnapshot, 'transcript'>;\n  progress: TranscriptProgress | null;\n  /** ACP v2-shaped agent events, replayed in sequence across fresh bindings. */\n  updates?: DoomSessionUpdateEvent[];\n  presentation?: SessionPresentation;\n  /** Current concurrent drafts/tools, so a fresh attachment does not depend on missed progress events. */\n  inFlight?: TranscriptItem[];\n}\n\nexport interface TranscriptPageRequest {\n  cursor?: string;\n  direction?: 'older' | 'newer';\n  limit?: number;\n  threadId?: string;\n}\n\nexport interface TranscriptPage {\n  entries: JsonValue[];\n  startCursor: string | null;\n  endCursor: string | null;\n  olderCursor: string | null;\n  newerCursor: string | null;\n  generation: number;\n  revision: number;\n  /** Profile and other context preceding this page. */\n  context: JsonValue[];\n  /** Current drafts are separate from committed history. */\n  drafts: TranscriptItem[];\n}\n\nexport interface SessionMessageArgs {\n  text: string;\n  images?: ImageContentPart[];\n}\n\nexport interface PromptArgs extends SessionMessageArgs {\n  /** Interactive clients acknowledge preflight without owning the supervised turn's lifetime. */\n  waitFor?: 'accepted' | 'settled';\n}\nexport type SteerArgs = SessionMessageArgs;\nexport type FollowUpArgs = SessionMessageArgs;\nexport interface QueuedItemArgs {\n  id: string;\n}\nexport interface PromoteQueuedArgs extends QueuedItemArgs {\n  operationId: string;\n}\n\nexport interface ClearQueueResult {\n  steering: string[];\n  followUp: string[];\n}\n\nexport interface RewindArgs {\n  itemId: string;\n  summarize?: boolean;\n  customInstructions?: string;\n  replaceInstructions?: boolean;\n  label?: string;\n}\n\nexport interface SessionUsage {\n  input: number;\n  output: number;\n  cacheRead: number;\n  cacheWrite: number;\n  total: number;\n}\n\nexport interface RewindSummaryEntry {\n  id: string;\n  parentId: string | null;\n  timestamp: string;\n  fromId: string;\n  summary: string;\n  details?: JsonValue;\n  usage?: SessionUsage;\n  fromHook?: boolean;\n}\n\nexport interface RewindResult {\n  editorText?: string;\n  cancelled: boolean;\n  aborted?: boolean;\n  summaryEntry?: RewindSummaryEntry;\n}\n\nexport type ExtensionUiResponse =\n  | { id: string; value: string }\n  | { id: string; confirmed: boolean }\n  | { id: string; cancelled: true };\n\nexport interface SessionStateInfo {\n  model?: ModelRef;\n  thinkingLevel: ThinkingLevel;\n  isStreaming: boolean;\n  isCompacting: boolean;\n  steeringMode: 'all' | 'one-at-a-time';\n  followUpMode: 'all' | 'one-at-a-time';\n  sessionFile?: string;\n  sessionId: string;\n  sessionName?: string;\n  autoCompactionEnabled: boolean;\n  messageCount: number;\n  pendingMessageCount: number;\n  operationId?: string;\n  executionStatus?: 'open' | 'aborting';\n  queuePaused?: boolean;\n  queueRevision?: number;\n}\n\nexport interface SessionStats {\n  sessionFile?: string;\n  sessionId: string;\n  totalMessages: number;\n  tokens: SessionUsage;\n  cost: number;\n  contextUsage?: {\n    tokens: number | null;\n    contextWindow: number;\n    percent: number | null;\n  };\n}\n\nexport interface SessionCommandSourceInfo {\n  path: string;\n  source: string;\n  scope: 'user' | 'project' | 'temporary';\n  origin: 'package' | 'top-level';\n  baseDir?: string;\n}\n\nexport interface SessionCommand {\n  name: string;\n  description?: string;\n  source: 'extension' | 'prompt' | 'skill';\n  sourceInfo?: SessionCommandSourceInfo;\n}\n\nexport interface SessionService {\n  readonly state: ReplicatedState<SessionServiceState>;\n  readTranscriptPage(args: TranscriptPageRequest, context: Context): Promise<TranscriptPage>;\n  prompt(text: string, context: Context): Promise<void>;\n  prompt(args: PromptArgs, context: Context): Promise<void>;\n  steer(text: string, context: Context): Promise<void>;\n  steer(args: SteerArgs, context: Context): Promise<void>;\n  abort(context: Context): Promise<void>;\n  abortOperation(args: { operationId: string }, context: Context): Promise<void>;\n  setModel(model: ModelRef, context: Context): Promise<void>;\n  setThinking(thinkingLevel: ThinkingLevel, context: Context): Promise<void>;\n  followUp(args: FollowUpArgs, context: Context): Promise<void>;\n  enqueueAutomatic(args: FollowUpArgs, context: Context): Promise<{ id: string }>;\n  removeQueued(\n    args: QueuedItemArgs,\n    context: Context,\n  ): Promise<'removed' | 'in_flight' | 'already_consumed' | 'not_found'>;\n  promoteQueued(\n    args: PromoteQueuedArgs,\n    context: Context,\n  ): Promise<'promoted' | 'in_flight' | 'target_changed' | 'not_found'>;\n  resumeQueue(context: Context): Promise<void>;\n  clearQueue(context: Context): Promise<ClearQueueResult>;\n  rewind(args: RewindArgs, context: Context): Promise<RewindResult>;\n  extensionUiResponse(response: ExtensionUiResponse, context: Context): Promise<void>;\n  getState(context: Context): Promise<SessionStateInfo>;\n  getSessionStats(context: Context): Promise<SessionStats>;\n  getCommands(context: Context): Promise<SessionCommand[]>;\n  getAvailableModels(context: Context): Promise<ModelRef[]>;\n  getAvailableThinkingLevels(context: Context): Promise<ThinkingLevel[]>;\n  compact(args: { customInstructions?: string }, context: Context): Promise<JsonValue>;\n  setName(name: string, context: Context): Promise<void>;\n}\n\nexport interface SessionManagementService {\n  attach(sessionId: string, context: Context): Promise<void>;\n  detach(context: Context): Promise<void>;\n}\n\nexport const DoomSessionService = defineService<SessionService>(DOOM_SESSION_SERVICE_ID);\nexport const DoomSessionManagementService = defineService<SessionManagementService>(DOOM_SESSION_MANAGEMENT_SERVICE_ID);\n"],"mappings":";;AAIA,MAAa,0BAA0B;AACvC,MAAa,qCAAqC;AAClD,MAAa,yBAAyB;AA8HtC,MAAa,kBAAA,GAAiBA,sBAAAA,cAAAA,CAA0B,eAAe;AAqLvE,MAAa,sBAAA,GAAqBA,sBAAAA,cAAAA,CAA8B,uBAAuB;AACvF,MAAa,gCAAA,GAA+BA,sBAAAA,cAAAA,CAAwC,kCAAkC"}

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

@@ -0,0 +1,308 @@
+import { DoomSessionUpdateEvent } from "./sessionUpdates.mjs";
+import { Context, ReplicatedState } from "@earendil-works/chord";
+//#region src/schemas/sessionProtocol.d.ts
+export declare const DOOM_SESSION_SERVICE_ID = "doompi.session.v2";
+export declare const DOOM_SESSION_MANAGEMENT_SERVICE_ID = "doompi.session-management.v1";
+export declare const DOOM_COCKPIT_SERVER_ID = "646f6f6d-7069-4000-8000-000000000001";
+type JsonValue$1 = null | boolean | number | string | JsonValue$1[] | {
+  [key: string]: JsonValue$1;
+};
+export type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+export type SessionPhase = 'idle' | 'turn' | 'compaction' | 'retry';
+/** Native execution ownership plus DoomPi's durable pending-input policy. */
+export interface SessionLifecycle {
+  revision: number;
+  operation: {
+    id: string;
+    kind: 'run' | 'compaction' | 'navigation';
+    status: 'open' | 'aborting';
+  } | null;
+  paused: boolean;
+  queue: Array<{
+    id: string;
+    text: string;
+    images?: ImageContentPart[];
+    delivery: 'steer' | 'followUp' | 'nextRun';
+    scheduling: 'automatic' | 'held';
+    disposition: 'pending' | 'handoff' | 'uncertain';
+  }>;
+}
+export interface ModelRef {
+  provider: string;
+  id: string;
+}
+export interface TextContentPart {
+  type: 'text';
+  text: string;
+}
+export interface ImageContentPart {
+  type: 'image';
+  data: string;
+  mimeType: string;
+}
+export interface ThinkingContentPart {
+  type: 'thinking';
+  thinking: string;
+  redacted?: true;
+}
+export interface ToolCallContentPart {
+  type: 'toolCall';
+  toolCallId: string;
+  toolName: string;
+  input: JsonValue$1;
+}
+export interface UserTranscriptItem {
+  id: string;
+  role: 'user';
+  content: Array<TextContentPart | ImageContentPart>;
+  timestamp: number;
+}
+export interface AssistantTranscriptItem {
+  id: string;
+  role: 'assistant';
+  content: Array<TextContentPart | ThinkingContentPart | ToolCallContentPart>;
+  model: ModelRef;
+  status: 'streaming' | 'complete' | 'aborted' | 'error';
+  stopReason?: 'stop' | 'length' | 'toolUse' | 'aborted' | 'error';
+  errorMessage?: string;
+  timestamp: number;
+}
+export interface ToolTranscriptItem {
+  id: string;
+  role: 'tool';
+  toolCallId: string;
+  toolName: string;
+  input: JsonValue$1;
+  content: Array<TextContentPart | ImageContentPart>;
+  details?: JsonValue$1;
+  status: 'running' | 'complete' | 'error';
+  isError: boolean;
+  timestamp: number;
+}
+export type TranscriptItem = UserTranscriptItem | AssistantTranscriptItem | ToolTranscriptItem;
+export type TranscriptProgress = {
+  type: 'item_started';
+  item: TranscriptItem;
+} | {
+  type: 'item_updated';
+  item: TranscriptItem;
+} | {
+  type: 'item_finished';
+  item: TranscriptItem;
+};
+export interface SessionSnapshot {
+  id: string;
+  cwd: string;
+  name?: string;
+  createdAt: number;
+  updatedAt: number;
+  phase: SessionPhase;
+  model: ModelRef;
+  thinkingLevel: ThinkingLevel;
+  attached: boolean;
+  locked: boolean;
+  revision: number;
+  transcript: TranscriptItem[];
+  queuedSteer: UserTranscriptItem[];
+  queuedSteerCount: number;
+  /** Authoritative execution and queue state, independent of transcript replay. */
+  lifecycle?: SessionLifecycle;
+}
+export interface ProtocolEvent {
+  sequence: number;
+  frame: {
+    type: string;
+    [key: string]: JsonValue$1;
+  };
+}
+export interface SessionPresentation {
+  revision: number;
+  dropped: number;
+  /** A branch replacement invalidates earlier presentation state, even without ring overflow. */
+  resetRevision?: number;
+  events: ProtocolEvent[];
+  projections: ProtocolEvent[];
+}
+export interface HubService {
+  readonly state: ReplicatedState<{
+    events: ProtocolEvent[];
+  }>;
+  send(frame: {
+    type: string;
+    [key: string]: JsonValue$1;
+  }, context: Context): Promise<void>;
+}
+export declare const DoomHubService: import("@earendil-works/chord").Service<HubService>;
+export interface SessionServiceState {
+  snapshot: Omit<SessionSnapshot, 'transcript'>;
+  progress: TranscriptProgress | null;
+  /** ACP v2-shaped agent events, replayed in sequence across fresh bindings. */
+  updates?: DoomSessionUpdateEvent[];
+  presentation?: SessionPresentation;
+  /** Current concurrent drafts/tools, so a fresh attachment does not depend on missed progress events. */
+  inFlight?: TranscriptItem[];
+}
+export interface TranscriptPageRequest {
+  cursor?: string;
+  direction?: 'older' | 'newer';
+  limit?: number;
+  threadId?: string;
+}
+export interface TranscriptPage {
+  entries: JsonValue$1[];
+  startCursor: string | null;
+  endCursor: string | null;
+  olderCursor: string | null;
+  newerCursor: string | null;
+  generation: number;
+  revision: number;
+  /** Profile and other context preceding this page. */
+  context: JsonValue$1[];
+  /** Current drafts are separate from committed history. */
+  drafts: TranscriptItem[];
+}
+export interface SessionMessageArgs {
+  text: string;
+  images?: ImageContentPart[];
+}
+export interface PromptArgs extends SessionMessageArgs {
+  /** Interactive clients acknowledge preflight without owning the supervised turn's lifetime. */
+  waitFor?: 'accepted' | 'settled';
+}
+export type SteerArgs = SessionMessageArgs;
+export type FollowUpArgs = SessionMessageArgs;
+export interface QueuedItemArgs {
+  id: string;
+}
+export interface PromoteQueuedArgs extends QueuedItemArgs {
+  operationId: string;
+}
+export interface ClearQueueResult {
+  steering: string[];
+  followUp: string[];
+}
+export interface RewindArgs {
+  itemId: string;
+  summarize?: boolean;
+  customInstructions?: string;
+  replaceInstructions?: boolean;
+  label?: string;
+}
+export interface SessionUsage {
+  input: number;
+  output: number;
+  cacheRead: number;
+  cacheWrite: number;
+  total: number;
+}
+export interface RewindSummaryEntry {
+  id: string;
+  parentId: string | null;
+  timestamp: string;
+  fromId: string;
+  summary: string;
+  details?: JsonValue$1;
+  usage?: SessionUsage;
+  fromHook?: boolean;
+}
+export interface RewindResult {
+  editorText?: string;
+  cancelled: boolean;
+  aborted?: boolean;
+  summaryEntry?: RewindSummaryEntry;
+}
+export type ExtensionUiResponse = {
+  id: string;
+  value: string;
+} | {
+  id: string;
+  confirmed: boolean;
+} | {
+  id: string;
+  cancelled: true;
+};
+export interface SessionStateInfo {
+  model?: ModelRef;
+  thinkingLevel: ThinkingLevel;
+  isStreaming: boolean;
+  isCompacting: boolean;
+  steeringMode: 'all' | 'one-at-a-time';
+  followUpMode: 'all' | 'one-at-a-time';
+  sessionFile?: string;
+  sessionId: string;
+  sessionName?: string;
+  autoCompactionEnabled: boolean;
+  messageCount: number;
+  pendingMessageCount: number;
+  operationId?: string;
+  executionStatus?: 'open' | 'aborting';
+  queuePaused?: boolean;
+  queueRevision?: number;
+}
+export interface SessionStats {
+  sessionFile?: string;
+  sessionId: string;
+  totalMessages: number;
+  tokens: SessionUsage;
+  cost: number;
+  contextUsage?: {
+    tokens: number | null;
+    contextWindow: number;
+    percent: number | null;
+  };
+}
+export interface SessionCommandSourceInfo {
+  path: string;
+  source: string;
+  scope: 'user' | 'project' | 'temporary';
+  origin: 'package' | 'top-level';
+  baseDir?: string;
+}
+export interface SessionCommand {
+  name: string;
+  description?: string;
+  source: 'extension' | 'prompt' | 'skill';
+  sourceInfo?: SessionCommandSourceInfo;
+}
+export interface SessionService {
+  readonly state: ReplicatedState<SessionServiceState>;
+  readTranscriptPage(args: TranscriptPageRequest, context: Context): Promise<TranscriptPage>;
+  prompt(text: string, context: Context): Promise<void>;
+  prompt(args: PromptArgs, context: Context): Promise<void>;
+  steer(text: string, context: Context): Promise<void>;
+  steer(args: SteerArgs, context: Context): Promise<void>;
+  abort(context: Context): Promise<void>;
+  abortOperation(args: {
+    operationId: string;
+  }, context: Context): Promise<void>;
+  setModel(model: ModelRef, context: Context): Promise<void>;
+  setThinking(thinkingLevel: ThinkingLevel, context: Context): Promise<void>;
+  followUp(args: FollowUpArgs, context: Context): Promise<void>;
+  enqueueAutomatic(args: FollowUpArgs, context: Context): Promise<{
+    id: string;
+  }>;
+  removeQueued(args: QueuedItemArgs, context: Context): Promise<'removed' | 'in_flight' | 'already_consumed' | 'not_found'>;
+  promoteQueued(args: PromoteQueuedArgs, context: Context): Promise<'promoted' | 'in_flight' | 'target_changed' | 'not_found'>;
+  resumeQueue(context: Context): Promise<void>;
+  clearQueue(context: Context): Promise<ClearQueueResult>;
+  rewind(args: RewindArgs, context: Context): Promise<RewindResult>;
+  extensionUiResponse(response: ExtensionUiResponse, context: Context): Promise<void>;
+  getState(context: Context): Promise<SessionStateInfo>;
+  getSessionStats(context: Context): Promise<SessionStats>;
+  getCommands(context: Context): Promise<SessionCommand[]>;
+  getAvailableModels(context: Context): Promise<ModelRef[]>;
+  getAvailableThinkingLevels(context: Context): Promise<ThinkingLevel[]>;
+  compact(args: {
+    customInstructions?: string;
+  }, context: Context): Promise<JsonValue$1>;
+  setName(name: string, context: Context): Promise<void>;
+}
+export interface SessionManagementService {
+  attach(sessionId: string, context: Context): Promise<void>;
+  detach(context: Context): Promise<void>;
+}
+export declare const DoomSessionService: import("@earendil-works/chord").Service<SessionService>;
+export declare const DoomSessionManagementService: import("@earendil-works/chord").Service<SessionManagementService>;
+//#endregion
+export { JsonValue$1 as JsonValue };
+//# sourceMappingURL=sessionProtocol.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionProtocol.d.mts","names":[],"sources":["../../../src/schemas/sessionProtocol.ts"],"mappings":"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"}

package/dist/src/schemas/sessionProtocol.mjs

@@ -0,0 +1,12 @@
+import { defineService } from "@earendil-works/chord";
+//#region src/schemas/sessionProtocol.ts
+const DOOM_SESSION_SERVICE_ID = "doompi.session.v2";
+const DOOM_SESSION_MANAGEMENT_SERVICE_ID = "doompi.session-management.v1";
+const DOOM_COCKPIT_SERVER_ID = "646f6f6d-7069-4000-8000-000000000001";
+const DoomHubService = defineService("doompi.hub.v1");
+const DoomSessionService = defineService(DOOM_SESSION_SERVICE_ID);
+const DoomSessionManagementService = defineService(DOOM_SESSION_MANAGEMENT_SERVICE_ID);
+//#endregion
+export { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService };
+
+//# sourceMappingURL=sessionProtocol.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionProtocol.mjs","names":[],"sources":["../../../src/schemas/sessionProtocol.ts"],"sourcesContent":["import { defineService, type Context, type ReplicatedState } from '@earendil-works/chord';\n\nimport type { DoomSessionUpdateEvent } from './sessionUpdates';\n\nexport const DOOM_SESSION_SERVICE_ID = 'doompi.session.v2';\nexport const DOOM_SESSION_MANAGEMENT_SERVICE_ID = 'doompi.session-management.v1';\nexport const DOOM_COCKPIT_SERVER_ID = '646f6f6d-7069-4000-8000-000000000001';\n\nexport type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };\nexport type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';\nexport type SessionPhase = 'idle' | 'turn' | 'compaction' | 'retry';\n\n/** Native execution ownership plus DoomPi's durable pending-input policy. */\nexport interface SessionLifecycle {\n  revision: number;\n  operation: { id: string; kind: 'run' | 'compaction' | 'navigation'; status: 'open' | 'aborting' } | null;\n  paused: boolean;\n  queue: Array<{\n    id: string;\n    text: string;\n    images?: ImageContentPart[];\n    delivery: 'steer' | 'followUp' | 'nextRun';\n    scheduling: 'automatic' | 'held';\n    disposition: 'pending' | 'handoff' | 'uncertain';\n  }>;\n}\n\nexport interface ModelRef {\n  provider: string;\n  id: string;\n}\n\nexport interface TextContentPart {\n  type: 'text';\n  text: string;\n}\n\nexport interface ImageContentPart {\n  type: 'image';\n  data: string;\n  mimeType: string;\n}\n\nexport interface ThinkingContentPart {\n  type: 'thinking';\n  thinking: string;\n  redacted?: true;\n}\n\nexport interface ToolCallContentPart {\n  type: 'toolCall';\n  toolCallId: string;\n  toolName: string;\n  input: JsonValue;\n}\n\nexport interface UserTranscriptItem {\n  id: string;\n  role: 'user';\n  content: Array<TextContentPart | ImageContentPart>;\n  timestamp: number;\n}\n\nexport interface AssistantTranscriptItem {\n  id: string;\n  role: 'assistant';\n  content: Array<TextContentPart | ThinkingContentPart | ToolCallContentPart>;\n  model: ModelRef;\n  status: 'streaming' | 'complete' | 'aborted' | 'error';\n  stopReason?: 'stop' | 'length' | 'toolUse' | 'aborted' | 'error';\n  errorMessage?: string;\n  timestamp: number;\n}\n\nexport interface ToolTranscriptItem {\n  id: string;\n  role: 'tool';\n  toolCallId: string;\n  toolName: string;\n  input: JsonValue;\n  content: Array<TextContentPart | ImageContentPart>;\n  details?: JsonValue;\n  status: 'running' | 'complete' | 'error';\n  isError: boolean;\n  timestamp: number;\n}\n\nexport type TranscriptItem = UserTranscriptItem | AssistantTranscriptItem | ToolTranscriptItem;\n\nexport type TranscriptProgress =\n  | { type: 'item_started'; item: TranscriptItem }\n  | { type: 'item_updated'; item: TranscriptItem }\n  | { type: 'item_finished'; item: TranscriptItem };\n\nexport interface SessionSnapshot {\n  id: string;\n  cwd: string;\n  name?: string;\n  createdAt: number;\n  updatedAt: number;\n  phase: SessionPhase;\n  model: ModelRef;\n  thinkingLevel: ThinkingLevel;\n  attached: boolean;\n  locked: boolean;\n  revision: number;\n  transcript: TranscriptItem[];\n  queuedSteer: UserTranscriptItem[];\n  queuedSteerCount: number;\n  /** Authoritative execution and queue state, independent of transcript replay. */\n  lifecycle?: SessionLifecycle;\n}\n\nexport interface ProtocolEvent {\n  sequence: number;\n  frame: { type: string; [key: string]: JsonValue };\n}\n\nexport interface SessionPresentation {\n  revision: number;\n  dropped: number;\n  /** A branch replacement invalidates earlier presentation state, even without ring overflow. */\n  resetRevision?: number;\n  events: ProtocolEvent[];\n  projections: ProtocolEvent[];\n}\n\nexport interface HubService {\n  readonly state: ReplicatedState<{ events: ProtocolEvent[] }>;\n  send(frame: { type: string; [key: string]: JsonValue }, context: Context): Promise<void>;\n}\n\nexport const DoomHubService = defineService<HubService>('doompi.hub.v1');\n\nexport interface SessionServiceState {\n  snapshot: Omit<SessionSnapshot, 'transcript'>;\n  progress: TranscriptProgress | null;\n  /** ACP v2-shaped agent events, replayed in sequence across fresh bindings. */\n  updates?: DoomSessionUpdateEvent[];\n  presentation?: SessionPresentation;\n  /** Current concurrent drafts/tools, so a fresh attachment does not depend on missed progress events. */\n  inFlight?: TranscriptItem[];\n}\n\nexport interface TranscriptPageRequest {\n  cursor?: string;\n  direction?: 'older' | 'newer';\n  limit?: number;\n  threadId?: string;\n}\n\nexport interface TranscriptPage {\n  entries: JsonValue[];\n  startCursor: string | null;\n  endCursor: string | null;\n  olderCursor: string | null;\n  newerCursor: string | null;\n  generation: number;\n  revision: number;\n  /** Profile and other context preceding this page. */\n  context: JsonValue[];\n  /** Current drafts are separate from committed history. */\n  drafts: TranscriptItem[];\n}\n\nexport interface SessionMessageArgs {\n  text: string;\n  images?: ImageContentPart[];\n}\n\nexport interface PromptArgs extends SessionMessageArgs {\n  /** Interactive clients acknowledge preflight without owning the supervised turn's lifetime. */\n  waitFor?: 'accepted' | 'settled';\n}\nexport type SteerArgs = SessionMessageArgs;\nexport type FollowUpArgs = SessionMessageArgs;\nexport interface QueuedItemArgs {\n  id: string;\n}\nexport interface PromoteQueuedArgs extends QueuedItemArgs {\n  operationId: string;\n}\n\nexport interface ClearQueueResult {\n  steering: string[];\n  followUp: string[];\n}\n\nexport interface RewindArgs {\n  itemId: string;\n  summarize?: boolean;\n  customInstructions?: string;\n  replaceInstructions?: boolean;\n  label?: string;\n}\n\nexport interface SessionUsage {\n  input: number;\n  output: number;\n  cacheRead: number;\n  cacheWrite: number;\n  total: number;\n}\n\nexport interface RewindSummaryEntry {\n  id: string;\n  parentId: string | null;\n  timestamp: string;\n  fromId: string;\n  summary: string;\n  details?: JsonValue;\n  usage?: SessionUsage;\n  fromHook?: boolean;\n}\n\nexport interface RewindResult {\n  editorText?: string;\n  cancelled: boolean;\n  aborted?: boolean;\n  summaryEntry?: RewindSummaryEntry;\n}\n\nexport type ExtensionUiResponse =\n  | { id: string; value: string }\n  | { id: string; confirmed: boolean }\n  | { id: string; cancelled: true };\n\nexport interface SessionStateInfo {\n  model?: ModelRef;\n  thinkingLevel: ThinkingLevel;\n  isStreaming: boolean;\n  isCompacting: boolean;\n  steeringMode: 'all' | 'one-at-a-time';\n  followUpMode: 'all' | 'one-at-a-time';\n  sessionFile?: string;\n  sessionId: string;\n  sessionName?: string;\n  autoCompactionEnabled: boolean;\n  messageCount: number;\n  pendingMessageCount: number;\n  operationId?: string;\n  executionStatus?: 'open' | 'aborting';\n  queuePaused?: boolean;\n  queueRevision?: number;\n}\n\nexport interface SessionStats {\n  sessionFile?: string;\n  sessionId: string;\n  totalMessages: number;\n  tokens: SessionUsage;\n  cost: number;\n  contextUsage?: {\n    tokens: number | null;\n    contextWindow: number;\n    percent: number | null;\n  };\n}\n\nexport interface SessionCommandSourceInfo {\n  path: string;\n  source: string;\n  scope: 'user' | 'project' | 'temporary';\n  origin: 'package' | 'top-level';\n  baseDir?: string;\n}\n\nexport interface SessionCommand {\n  name: string;\n  description?: string;\n  source: 'extension' | 'prompt' | 'skill';\n  sourceInfo?: SessionCommandSourceInfo;\n}\n\nexport interface SessionService {\n  readonly state: ReplicatedState<SessionServiceState>;\n  readTranscriptPage(args: TranscriptPageRequest, context: Context): Promise<TranscriptPage>;\n  prompt(text: string, context: Context): Promise<void>;\n  prompt(args: PromptArgs, context: Context): Promise<void>;\n  steer(text: string, context: Context): Promise<void>;\n  steer(args: SteerArgs, context: Context): Promise<void>;\n  abort(context: Context): Promise<void>;\n  abortOperation(args: { operationId: string }, context: Context): Promise<void>;\n  setModel(model: ModelRef, context: Context): Promise<void>;\n  setThinking(thinkingLevel: ThinkingLevel, context: Context): Promise<void>;\n  followUp(args: FollowUpArgs, context: Context): Promise<void>;\n  enqueueAutomatic(args: FollowUpArgs, context: Context): Promise<{ id: string }>;\n  removeQueued(\n    args: QueuedItemArgs,\n    context: Context,\n  ): Promise<'removed' | 'in_flight' | 'already_consumed' | 'not_found'>;\n  promoteQueued(\n    args: PromoteQueuedArgs,\n    context: Context,\n  ): Promise<'promoted' | 'in_flight' | 'target_changed' | 'not_found'>;\n  resumeQueue(context: Context): Promise<void>;\n  clearQueue(context: Context): Promise<ClearQueueResult>;\n  rewind(args: RewindArgs, context: Context): Promise<RewindResult>;\n  extensionUiResponse(response: ExtensionUiResponse, context: Context): Promise<void>;\n  getState(context: Context): Promise<SessionStateInfo>;\n  getSessionStats(context: Context): Promise<SessionStats>;\n  getCommands(context: Context): Promise<SessionCommand[]>;\n  getAvailableModels(context: Context): Promise<ModelRef[]>;\n  getAvailableThinkingLevels(context: Context): Promise<ThinkingLevel[]>;\n  compact(args: { customInstructions?: string }, context: Context): Promise<JsonValue>;\n  setName(name: string, context: Context): Promise<void>;\n}\n\nexport interface SessionManagementService {\n  attach(sessionId: string, context: Context): Promise<void>;\n  detach(context: Context): Promise<void>;\n}\n\nexport const DoomSessionService = defineService<SessionService>(DOOM_SESSION_SERVICE_ID);\nexport const DoomSessionManagementService = defineService<SessionManagementService>(DOOM_SESSION_MANAGEMENT_SERVICE_ID);\n"],"mappings":";;AAIA,MAAa,0BAA0B;AACvC,MAAa,qCAAqC;AAClD,MAAa,yBAAyB;AA8HtC,MAAa,iBAAiB,cAA0B,eAAe;AAqLvE,MAAa,qBAAqB,cAA8B,uBAAuB;AACvF,MAAa,+BAA+B,cAAwC,kCAAkC"}

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

@@ -0,0 +1,34 @@
+import { ImageContentPart, JsonValue, TextContentPart } from "./sessionProtocol.mjs";
+//#region src/schemas/sessionUpdates.d.ts
+/** ACP v2 content and update names used by Doompi's agent presentation. */
+export type DoomContentBlock = TextContentPart | ImageContentPart;
+export type DoomToolCallStatus = 'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled';
+export type DoomSessionStopReason = 'end_turn' | 'max_tokens' | 'max_turn_requests' | 'refusal' | 'cancelled' | `_${string}`;
+export type DoomSessionUpdate = {
+  sessionUpdate: 'user_message' | 'agent_message' | 'agent_thought';
+  messageId: string;
+  content: DoomContentBlock[];
+} | {
+  sessionUpdate: 'tool_call_update';
+  toolCallId: string;
+  title?: string;
+  kind?: string;
+  status?: DoomToolCallStatus;
+  content?: Array<{
+    type: 'content';
+    content: DoomContentBlock;
+  }>;
+  rawInput?: JsonValue;
+  rawOutput?: JsonValue;
+} | {
+  sessionUpdate: 'state_update';
+  state: 'running' | 'idle' | 'requires_action';
+  stopReason?: DoomSessionStopReason;
+};
+/** A bounded Chord replay window. Its sequence is per session and strictly increasing. */
+export interface DoomSessionUpdateEvent {
+  sequence: number;
+  update: DoomSessionUpdate;
+}
+//#endregion
+//# sourceMappingURL=sessionUpdates.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionUpdates.d.mts","names":[],"sources":["../../../src/schemas/sessionUpdates.ts"],"mappings":";;;YAGY,mBAAmB,kBAAkB;YACrC;YACA;YAQA;EAEN;EACA;EACA,SAAS;;EAGT;EACA;EACA;EACA;EACA,SAAS;EACT,UAAU;IAAQ;IAAiB,SAAS;;EAC5C,WAAW;EACX,YAAY;;EAGZ;EACA;EACA,aAAa;;;iBAIF;EACf;EACA,QAAQ"}

package/dist/src/schemas/skills.cjs

@@ -0,0 +1,115 @@
+let typebox = require("typebox");
+let typebox_value = require("typebox/value");
+//#region src/schemas/skills.ts
+/** Provider-owned Cordis service for live skill-directory contributions. */
+const DOOM_SKILL_SOURCES_SERVICE = "doom/skill-sources";
+/**
+* The custom session entry journaled once Pi has rebuilt its resource catalog
+* for a reload.
+*
+* A reload is the only thing that changes which skills exist, and Pi publishes
+* nothing for it: the whole wire record of a `/domains` switch is the single
+* `response:prompt` for the command that triggered it. An RPC client therefore
+* has no way to learn that the `get_commands` answer it cached, which is what
+* the web cockpit completes `$` from, now describes the previous domains.
+*
+* This entry is that missing signal. It rides Pi's `entry_appended` frames the
+* way the minor-mode catalog projection does, so it needs no new protocol, and
+* a custom entry with no registered renderer is invisible in the TUI.
+*/
+const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+const MAX_GENERATION_LENGTH = 256;
+const SkillSourceNameSchema = typebox.Type.String({
+	minLength: 1,
+	maxLength: 128,
+	pattern: "^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$"
+});
+const SkillSourceContributionSchema = typebox.Type.Object({
+	source: SkillSourceNameSchema,
+	/** Absolute directories, the same ones the source hands `resources_discover`. */
+	directories: typebox.Type.Array(typebox.Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+function cloneContribution(contribution) {
+	return {
+		source: contribution.source,
+		directories: [...contribution.directories]
+	};
+}
+function validateContribution(contribution) {
+	if ((0, typebox_value.Check)(SkillSourceContributionSchema, contribution)) return cloneContribution(contribution);
+	const [first] = (0, typebox_value.Errors)(SkillSourceContributionSchema, contribution);
+	throw new TypeError(`Invalid Doom skill-source contribution${first ? ` at ${first.instancePath || "/"}: ${first.message}` : ""}.`);
+}
+/** Creates the provider-owned skill-source registry for one Cordis session. */
+function createDoomSkillSourcesService(generation) {
+	if (generation.length === 0 || generation.length > MAX_GENERATION_LENGTH) throw new TypeError("Doom skill sources require a valid generation.");
+	const registrations = /* @__PURE__ */ new Map();
+	const listeners = /* @__PURE__ */ new Set();
+	let sequence = 0;
+	let disposed = false;
+	const ensureActive = () => {
+		if (disposed) throw new Error("The Doom skill-sources service is disposed.");
+	};
+	const list = () => [...registrations.values()].map(({ contribution }) => cloneContribution(contribution)).sort((left, right) => left.source.localeCompare(right.source));
+	const notify = () => {
+		const contributions = list();
+		for (const listener of listeners) listener(contributions);
+	};
+	return Object.freeze({
+		generation,
+		register(contribution) {
+			ensureActive();
+			const validated = validateContribution(contribution);
+			sequence += 1;
+			const token = Symbol(validated.source);
+			const registrationGeneration = `${generation}:skill-source:${sequence}`;
+			registrations.set(validated.source, {
+				token,
+				contribution: validated
+			});
+			notify();
+			let registrationDisposed = false;
+			return Object.freeze({
+				source: validated.source,
+				generation: registrationGeneration,
+				dispose() {
+					if (registrationDisposed) return;
+					registrationDisposed = true;
+					if (registrations.get(validated.source)?.token !== token) return;
+					registrations.delete(validated.source);
+					notify();
+				}
+			});
+		},
+		list,
+		subscribe(listener) {
+			ensureActive();
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		dispose() {
+			if (disposed) return;
+			disposed = true;
+			registrations.clear();
+			listeners.clear();
+		}
+	});
+}
+function readDoomSkillSourcesService(context) {
+	return context.get(DOOM_SKILL_SOURCES_SERVICE);
+}
+function requireDoomSkillSourcesService(context) {
+	const service = readDoomSkillSourcesService(context);
+	if (!service) throw new Error("Doom skill sources are unavailable. Load @agimon-ai/doompi-skill.");
+	return service;
+}
+//#endregion
+exports.DOOM_RESOURCE_CATALOG_ENTRY_TYPE = DOOM_RESOURCE_CATALOG_ENTRY_TYPE;
+exports.DOOM_SKILL_SOURCES_SERVICE = DOOM_SKILL_SOURCES_SERVICE;
+exports.SkillSourceContributionSchema = SkillSourceContributionSchema;
+exports.SkillSourceNameSchema = SkillSourceNameSchema;
+exports.createDoomSkillSourcesService = createDoomSkillSourcesService;
+exports.readDoomSkillSourcesService = readDoomSkillSourcesService;
+exports.requireDoomSkillSourcesService = requireDoomSkillSourcesService;
+
+//# sourceMappingURL=skills.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.cjs","names":["Type","Check","Errors"],"sources":["../../../src/schemas/skills.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport { Type } from 'typebox';\nimport { Check, Errors } from 'typebox/value';\n\n/** Provider-owned Cordis service for live skill-directory contributions. */\nexport const DOOM_SKILL_SOURCES_SERVICE = 'doom/skill-sources';\n\n/**\n * The custom session entry journaled once Pi has rebuilt its resource catalog\n * for a reload.\n *\n * A reload is the only thing that changes which skills exist, and Pi publishes\n * nothing for it: the whole wire record of a `/domains` switch is the single\n * `response:prompt` for the command that triggered it. An RPC client therefore\n * has no way to learn that the `get_commands` answer it cached, which is what\n * the web cockpit completes `$` from, now describes the previous domains.\n *\n * This entry is that missing signal. It rides Pi's `entry_appended` frames the\n * way the minor-mode catalog projection does, so it needs no new protocol, and\n * a custom entry with no registered renderer is invisible in the TUI.\n */\nexport const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = 'doom-resource-catalog';\n\n/**\n * The payload of a resource-catalog entry.\n *\n * Arrival is the signal; a client re-reads the catalog rather than diffing\n * this. The revision only distinguishes one rebuild from the next in a journal\n * a human is reading.\n */\nexport interface ResourceCatalogProjection {\n  readonly version: 1;\n  readonly revision: number;\n}\n\nconst MAX_GENERATION_LENGTH = 256;\n\nexport const SkillSourceNameSchema = Type.String({\n  minLength: 1,\n  maxLength: 128,\n  pattern: '^[A-Za-z0-9@][A-Za-z0-9@/._:-]*$',\n});\n\nexport const SkillSourceContributionSchema = Type.Object(\n  {\n    source: SkillSourceNameSchema,\n    /** Absolute directories, the same ones the source hands `resources_discover`. */\n    directories: Type.Array(Type.String({ minLength: 1 })),\n  },\n  { additionalProperties: false },\n);\n\nexport interface SkillSourceContribution {\n  readonly source: string;\n  readonly directories: readonly string[];\n}\n\nexport interface SkillSourceContributionHandle {\n  readonly source: string;\n  readonly generation: string;\n  dispose(): void;\n}\n\n/** Direct registrar/query/subscription seam owned by doompi-skill. */\nexport interface DoomSkillSourcesService {\n  readonly generation: string;\n  register(contribution: SkillSourceContribution): SkillSourceContributionHandle;\n  list(): readonly SkillSourceContribution[];\n  subscribe(listener: (contributions: readonly SkillSourceContribution[]) => void): () => void;\n  dispose(): void;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/skill-sources': DoomSkillSourcesService;\n  }\n}\n\ninterface RegisteredSkillSource {\n  readonly token: symbol;\n  readonly contribution: SkillSourceContribution;\n}\n\nfunction cloneContribution(contribution: SkillSourceContribution): SkillSourceContribution {\n  return { source: contribution.source, directories: [...contribution.directories] };\n}\n\nfunction validateContribution(contribution: SkillSourceContribution): SkillSourceContribution {\n  if (Check(SkillSourceContributionSchema, contribution)) return cloneContribution(contribution);\n  const [first] = Errors(SkillSourceContributionSchema, contribution);\n  throw new TypeError(\n    `Invalid Doom skill-source contribution${first ? ` at ${first.instancePath || '/'}: ${first.message}` : ''}.`,\n  );\n}\n\n/** Creates the provider-owned skill-source registry for one Cordis session. */\nexport function createDoomSkillSourcesService(generation: string): DoomSkillSourcesService {\n  if (generation.length === 0 || generation.length > MAX_GENERATION_LENGTH) {\n    throw new TypeError('Doom skill sources require a valid generation.');\n  }\n\n  const registrations = new Map<string, RegisteredSkillSource>();\n  const listeners = new Set<(contributions: readonly SkillSourceContribution[]) => void>();\n  let sequence = 0;\n  let disposed = false;\n\n  const ensureActive = (): void => {\n    if (disposed) throw new Error('The Doom skill-sources service is disposed.');\n  };\n  const list = (): readonly SkillSourceContribution[] =>\n    [...registrations.values()]\n      .map(({ contribution }) => cloneContribution(contribution))\n      .sort((left, right) => left.source.localeCompare(right.source));\n  const notify = (): void => {\n    const contributions = list();\n    for (const listener of listeners) listener(contributions);\n  };\n\n  const service: DoomSkillSourcesService = {\n    generation,\n    register(contribution) {\n      ensureActive();\n      const validated = validateContribution(contribution);\n      sequence += 1;\n      const token = Symbol(validated.source);\n      const registrationGeneration = `${generation}:skill-source:${sequence}`;\n      registrations.set(validated.source, { token, contribution: validated });\n      notify();\n      let registrationDisposed = false;\n      return Object.freeze({\n        source: validated.source,\n        generation: registrationGeneration,\n        dispose() {\n          if (registrationDisposed) return;\n          registrationDisposed = true;\n          if (registrations.get(validated.source)?.token !== token) return;\n          registrations.delete(validated.source);\n          notify();\n        },\n      });\n    },\n    list,\n    subscribe(listener) {\n      ensureActive();\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    dispose() {\n      if (disposed) return;\n      disposed = true;\n      registrations.clear();\n      listeners.clear();\n    },\n  };\n  return Object.freeze(service);\n}\n\nexport function readDoomSkillSourcesService(context: Context): DoomSkillSourcesService | undefined {\n  return context.get(DOOM_SKILL_SOURCES_SERVICE) as DoomSkillSourcesService | undefined;\n}\n\nexport function requireDoomSkillSourcesService(context: Context): DoomSkillSourcesService {\n  const service = readDoomSkillSourcesService(context);\n  if (!service) throw new Error('Doom skill sources are unavailable. Load @agimon-ai/doompi-skill.');\n  return service;\n}\n"],"mappings":";;;;AAKA,MAAa,6BAA6B;;;;;;;;;;;;;;;AAgB1C,MAAa,mCAAmC;AAchD,MAAM,wBAAwB;AAE9B,MAAa,wBAAwBA,QAAAA,KAAK,OAAO;CAC/C,WAAW;CACX,WAAW;CACX,SAAS;AACX,CAAC;AAED,MAAa,gCAAgCA,QAAAA,KAAK,OAChD;CACE,QAAQ;;CAER,aAAaA,QAAAA,KAAK,MAAMA,QAAAA,KAAK,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;AACvD,GACA,EAAE,sBAAsB,MAAM,CAChC;AAiCA,SAAS,kBAAkB,cAAgE;CACzF,OAAO;EAAE,QAAQ,aAAa;EAAQ,aAAa,CAAC,GAAG,aAAa,WAAW;CAAE;AACnF;AAEA,SAAS,qBAAqB,cAAgE;CAC5F,KAAA,GAAIC,cAAAA,MAAAA,CAAM,+BAA+B,YAAY,GAAG,OAAO,kBAAkB,YAAY;CAC7F,MAAM,CAAC,UAAA,GAASC,cAAAA,OAAAA,CAAO,+BAA+B,YAAY;CAClE,MAAM,IAAI,UACR,yCAAyC,QAAQ,OAAO,MAAM,gBAAgB,IAAI,IAAI,MAAM,YAAY,GAAG,EAC7G;AACF;;AAGA,SAAgB,8BAA8B,YAA6C;CACzF,IAAI,WAAW,WAAW,KAAK,WAAW,SAAS,uBACjD,MAAM,IAAI,UAAU,gDAAgD;CAGtE,MAAM,gCAAgB,IAAI,IAAmC;CAC7D,MAAM,4BAAY,IAAI,IAAiE;CACvF,IAAI,WAAW;CACf,IAAI,WAAW;CAEf,MAAM,qBAA2B;EAC/B,IAAI,UAAU,MAAM,IAAI,MAAM,6CAA6C;CAC7E;CACA,MAAM,aACJ,CAAC,GAAG,cAAc,OAAO,CAAC,CAAC,CACxB,KAAK,EAAE,mBAAmB,kBAAkB,YAAY,CAAC,CAAC,CAC1D,MAAM,MAAM,UAAU,KAAK,OAAO,cAAc,MAAM,MAAM,CAAC;CAClE,MAAM,eAAqB;EACzB,MAAM,gBAAgB,KAAK;EAC3B,KAAK,MAAM,YAAY,WAAW,SAAS,aAAa;CAC1D;CAsCA,OAAO,OAAO,OAAO;EAnCnB;EACA,SAAS,cAAc;GACrB,aAAa;GACb,MAAM,YAAY,qBAAqB,YAAY;GACnD,YAAY;GACZ,MAAM,QAAQ,OAAO,UAAU,MAAM;GACrC,MAAM,yBAAyB,GAAG,WAAW,gBAAgB;GAC7D,cAAc,IAAI,UAAU,QAAQ;IAAE;IAAO,cAAc;GAAU,CAAC;GACtE,OAAO;GACP,IAAI,uBAAuB;GAC3B,OAAO,OAAO,OAAO;IACnB,QAAQ,UAAU;IAClB,YAAY;IACZ,UAAU;KACR,IAAI,sBAAsB;KAC1B,uBAAuB;KACvB,IAAI,cAAc,IAAI,UAAU,MAAM,CAAC,EAAE,UAAU,OAAO;KAC1D,cAAc,OAAO,UAAU,MAAM;KACrC,OAAO;IACT;GACF,CAAC;EACH;EACA;EACA,UAAU,UAAU;GAClB,aAAa;GACb,UAAU,IAAI,QAAQ;GACtB,aAAa,UAAU,OAAO,QAAQ;EACxC;EACA,UAAU;GACR,IAAI,UAAU;GACd,WAAW;GACX,cAAc,MAAM;GACpB,UAAU,MAAM;EAClB;CAEyB,CAAC;AAC9B;AAEA,SAAgB,4BAA4B,SAAuD;CACjG,OAAO,QAAQ,IAAI,0BAA0B;AAC/C;AAEA,SAAgB,+BAA+B,SAA2C;CACxF,MAAM,UAAU,4BAA4B,OAAO;CACnD,IAAI,CAAC,SAAS,MAAM,IAAI,MAAM,mEAAmE;CACjG,OAAO;AACT"}

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

@@ -0,0 +1,65 @@
+import { Type } from "typebox";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/schemas/skills.d.ts
+/** Provider-owned Cordis service for live skill-directory contributions. */
+export declare const DOOM_SKILL_SOURCES_SERVICE = "doom/skill-sources";
+/**
+ * The custom session entry journaled once Pi has rebuilt its resource catalog
+ * for a reload.
+ *
+ * A reload is the only thing that changes which skills exist, and Pi publishes
+ * nothing for it: the whole wire record of a `/domains` switch is the single
+ * `response:prompt` for the command that triggered it. An RPC client therefore
+ * has no way to learn that the `get_commands` answer it cached, which is what
+ * the web cockpit completes `$` from, now describes the previous domains.
+ *
+ * This entry is that missing signal. It rides Pi's `entry_appended` frames the
+ * way the minor-mode catalog projection does, so it needs no new protocol, and
+ * a custom entry with no registered renderer is invisible in the TUI.
+ */
+export declare const DOOM_RESOURCE_CATALOG_ENTRY_TYPE = "doom-resource-catalog";
+/**
+ * The payload of a resource-catalog entry.
+ *
+ * Arrival is the signal; a client re-reads the catalog rather than diffing
+ * this. The revision only distinguishes one rebuild from the next in a journal
+ * a human is reading.
+ */
+export interface ResourceCatalogProjection {
+  readonly version: 1;
+  readonly revision: number;
+}
+export declare const SkillSourceNameSchema: Type.TString;
+export declare const SkillSourceContributionSchema: Type.TObject<{
+  source: Type.TString;
+  /** Absolute directories, the same ones the source hands `resources_discover`. */
+  directories: Type.TArray<Type.TString>;
+}>;
+export interface SkillSourceContribution {
+  readonly source: string;
+  readonly directories: readonly string[];
+}
+export interface SkillSourceContributionHandle {
+  readonly source: string;
+  readonly generation: string;
+  dispose(): void;
+}
+/** Direct registrar/query/subscription seam owned by doompi-skill. */
+export interface DoomSkillSourcesService {
+  readonly generation: string;
+  register(contribution: SkillSourceContribution): SkillSourceContributionHandle;
+  list(): readonly SkillSourceContribution[];
+  subscribe(listener: (contributions: readonly SkillSourceContribution[]) => void): () => void;
+  dispose(): void;
+}
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    'doom/skill-sources': DoomSkillSourcesService;
+  }
+}
+/** Creates the provider-owned skill-source registry for one Cordis session. */
+export declare function createDoomSkillSourcesService(generation: string): DoomSkillSourcesService;
+export declare function readDoomSkillSourcesService(context: Context): DoomSkillSourcesService | undefined;
+export declare function requireDoomSkillSourcesService(context: Context): DoomSkillSourcesService;
+//#endregion
+//# sourceMappingURL=skills.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.mts","names":[],"sources":["../../../src/schemas/skills.ts"],"mappings":";;;;qBAKa;;;;;;;;;;;;;;;qBAgBA;;;;;;;;iBASI;WACN;WACA;;qBAKE,uBAAqB,KAAA;qBAMrB,+BAA6B,KAAA;;;;;iBASzB;WACN;WACA;;iBAGM;WACN;WACA;EACT;;;iBAIe;WACN;EACT,SAAS,cAAc,0BAA0B;EACjD,iBAAiB;EACjB,UAAU,WAAW,wBAAwB;EAC7C;;;YAIU;IACR,sBAAsB;;;;wBAsBV,8BAA8B,qBAAqB;wBA6DnD,4BAA4B,SAAS,UAAU;wBAI/C,+BAA+B,SAAS,UAAU"}