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

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

@@ -0,0 +1 @@
+{"version":3,"file":"serverFacet.mjs","names":[],"sources":["../../../src/schemas/serverFacet.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\n/**\n * The server facet a package installs into a headless host.\n *\n * A package already ships a Pi extension facet for the agent process. This is\n * the second facet: one cordis plugin that a session server or the cockpit hub\n * installs, through which the package contributes its HTTP surface and any\n * behaviour that has to run outside the agent.\n *\n * A facet is installed and disposed like every other Doom contribution. It\n * registers its API from inside that lifecycle, so server behaviour has a clear\n * owner and disposer.\n */\nimport type { Static, TSchema } from 'typebox';\n\nimport type { DoomHeadlessHostService, DoomHeadlessToolRestriction } from './headless';\nimport type { DoomHeadlessTool, DoomHeadlessCommand } from './headless';\nimport type { DoomHubChannel } from './hubChannel';\nimport type { DoomApi, DoomApiContext, DoomApiScope } from './packageApi';\nimport type { DoomPluginTool, DoomPluginCommand } from './pluginContributions';\nimport type { DoomPluginCaller, DoomPluginMethod } from './pluginProtocol';\nimport type { DoomToolRestrictionDefinition } from './toolSurface';\n\n/** The host a server facet contributes to. */\nexport const DOOM_SERVER_HOST_SERVICE = 'doom/server-host';\n\nexport interface DoomServerRegistration {\n  /** Whether the API was mounted. A refused registration is a no-op handle. */\n  readonly mounted?: boolean;\n  /** Unmount the surface and close its handler. Idempotent. */\n  dispose(): void;\n}\n\n/**\n * What a facet is handed when it installs.\n *\n * `scope` is fixed for the life of the host: a session server never becomes a\n * hub. A facet that only makes sense in one scope returns early in the other\n * rather than declaring itself twice.\n */\nexport interface DoomServerHostService {\n  readonly scope: DoomApiScope;\n  /** Identity and host-lent capabilities, the same record an API is started with. */\n  readonly context: DoomApiContext;\n  /**\n   * Mount an API under its own base path. A base path already claimed by an\n   * earlier facet is refused with a notice and a no-op handle. The same\n   * failure posture applies when the API cannot start or the host is disposed.\n   */\n  registerApi(api: DoomApi): DoomServerRegistration;\n  /** Register a live event source under this host's lifecycle. */\n  registerChannel(channel: DoomHubChannel): DoomServerRegistration;\n  /** Mount a typed call at this host's exact scope. */\n  registerMethod<TInput extends TSchema, TOutput extends TSchema>(\n    definition: DoomPluginMethod<TInput, TOutput>,\n    handler: (input: Static<TInput>, caller: DoomPluginCaller) => Static<TOutput> | Promise<Static<TOutput>>,\n  ): DoomServerRegistration;\n  /** Base paths currently mounted, in mount order. */\n  mounted(): readonly string[];\n  /** Channel frame types currently mounted, in mount order. */\n  mountedChannels(): readonly string[];\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/server-host': DoomServerHostService;\n  }\n}\n\nexport function readDoomServerHost(context: Context): DoomServerHostService | undefined {\n  return context.get(DOOM_SERVER_HOST_SERVICE) as DoomServerHostService | undefined;\n}\n\nexport function requireDoomServerHost(context: Context): DoomServerHostService {\n  const service = readDoomServerHost(context);\n  if (!service) throw new Error('The Doom server host is unavailable. Start a Doom server first.');\n  return service;\n}\n\n/** The package.json field a package declares its server facet under. */\nexport const DOOM_SERVER_FACET_MANIFEST_FIELD = 'poServer';\n\n/** The default export a facet module must provide, so a host can install it. */\nexport const DOOM_SERVER_FACET_EXPORT = 'default';\n\n/**\n * One package's server contributions, as a Cordis object plugin.\n *\n * The object form rather than a bare function, because it is the only shape\n * that declares its own `inject`. That matters to a host: a plugin carrying\n * its dependencies is a single fiber, so `fiber.await()` settles once `apply`\n * has run, and the host can decide whether to open a listener from a mount\n * table it knows is complete. A function facet calling `ctx.inject` inside\n * itself mounts a child fiber that the host has no handle on.\n *\n * A returned function is the disposer, run when the host's root unwinds.\n */\nexport interface DoomServerProviderOverride {\n  readonly name: string;\n  readonly baseUrl: string;\n}\nexport type DoomServerProviderOverrides = (context: {\n  readonly environment: Readonly<Record<string, string | undefined>>;\n}) => readonly DoomServerProviderOverride[];\n\n/** Read pure root metadata without initializing or mounting the root. */\nexport function composeServerProviderOverrides(...roots: readonly unknown[]): DoomServerProviderOverrides {\n  return (context) =>\n    roots.flatMap((root) => {\n      if ((typeof root !== 'function' && typeof root !== 'object') || root === null) return [];\n      const callback = (root as { providerOverrides?: DoomServerProviderOverrides }).providerOverrides;\n      return typeof callback === 'function' ? callback(context) : [];\n    });\n}\n\nexport interface DoomServerFacet {\n  readonly providerOverrides?: DoomServerProviderOverrides;\n  readonly inject?: readonly string[];\n  apply(context: Context): void | (() => void | Promise<void>) | Promise<void | (() => void | Promise<void>)>;\n}\n\n/** One instance belongs to one mounted server scope. */\nexport interface DoomServerPluginContext {\n  readonly context: Context;\n  readonly host: DoomServerHostService;\n  readonly agent?: DoomHeadlessHostService;\n  readonly signal: AbortSignal;\n}\n\nexport interface DoomServerMethod {\n  register(host: DoomServerHostService): DoomServerRegistration;\n}\n\n/** Capture schema inference before heterogeneous methods enter a contribution array. */\nexport function defineServerMethod<TInput extends TSchema, TOutput extends TSchema>(\n  definition: DoomPluginMethod<TInput, TOutput>,\n  handler: (input: Static<TInput>, caller: DoomPluginCaller) => Static<TOutput> | Promise<Static<TOutput>>,\n): DoomServerMethod {\n  return { register: (host) => host.registerMethod(definition, handler) };\n}\n\nexport interface DoomServerPluginScope {\n  readonly services?: readonly Parameters<Context['plugin']>[0][];\n  readonly channels?: readonly (() => DoomHubChannel)[];\n  readonly api?: readonly DoomApi[];\n  readonly methods?: readonly DoomServerMethod[];\n  readonly onStart?: (context: DoomServerPluginContext) => void | Promise<void>;\n  readonly onStop?: (context: DoomServerPluginContext) => void | Promise<void>;\n  readonly onDispose?: (context: DoomServerPluginContext) => void | Promise<void>;\n}\n\nexport interface DoomServerSessionPlugin extends DoomServerPluginScope {\n  readonly tools?: readonly (DoomHeadlessTool | DoomPluginTool)[];\n  readonly commands?: readonly (DoomHeadlessCommand | DoomPluginCommand)[];\n  readonly resources?: readonly Parameters<DoomHeadlessHostService['registerResource']>[0][];\n  readonly hooks?: readonly Parameters<DoomHeadlessHostService['registerHook']>[0][];\n  readonly toolRestrictions?: readonly (\n    | DoomHeadlessToolRestriction\n    | DoomToolRestrictionDefinition<() => DoomHeadlessToolRestriction>\n  )[];\n  readonly activities?: readonly Parameters<DoomHeadlessHostService['registerActivity']>[0][];\n}\n\ntype ScopeDeclaration<TScope> = TScope | ((context: DoomServerPluginContext) => TScope | Promise<TScope>);\n// Explicitly forbid session contributions even when a factory returns an inferred object.\ntype NonSessionScope = DoomServerPluginScope & {\n  readonly [K in Exclude<keyof DoomServerSessionPlugin, keyof DoomServerPluginScope>]?: never;\n};\nexport interface DoomServerPluginDefinition {\n  readonly providerOverrides?: DoomServerProviderOverrides;\n  readonly name: string;\n  readonly inject?: readonly string[];\n  readonly global?: ScopeDeclaration<NonSessionScope>;\n  readonly workspace?: ScopeDeclaration<NonSessionScope>;\n  readonly session?: ScopeDeclaration<DoomServerSessionPlugin>;\n}\n\n/** One package's validated declaration. */\nexport interface DeclaredServerFacet {\n  packageName: string;\n  packageDir: string;\n  /** Package-relative ./path to the source entry. */\n  entry: string;\n  /** Package-relative ./path to the built entry, which is what a host imports. */\n  dist: string;\n  /** Scopes this facet is installed into; both when the package names neither. */\n  scopes: readonly DoomApiScope[];\n  /** A selected host cannot be ready without this package's runtime capability. */\n  required?: boolean;\n}\n\nexport class DoomServerFacetManifestError extends Error {\n  constructor(packageDir: string, message: string) {\n    super(`${DOOM_SERVER_FACET_MANIFEST_FIELD} manifest in ${packageDir}: ${message}`);\n    this.name = 'DoomServerFacetManifestError';\n  }\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/** Narrows a module's default export, so a broken package is a notice rather than a crash. */\nexport function isDoomServerFacet(value: unknown): value is DoomServerFacet {\n  return isRecord(value) && typeof value.apply === 'function';\n}\n\nfunction normalizePath(packageDir: string, field: string, value: unknown): string {\n  if (typeof value !== 'string' || !value.startsWith('./') || value.includes('..')) {\n    throw new DoomServerFacetManifestError(packageDir, `${field} must be a package-relative ./path with no '..'.`);\n  }\n  return value;\n}\n\nfunction normalizeScopes(packageDir: string, value: unknown): readonly DoomApiScope[] {\n  if (value === undefined) throw new DoomServerFacetManifestError(packageDir, 'scopes must be declared explicitly.');\n  if (!Array.isArray(value) || value.length === 0) {\n    throw new DoomServerFacetManifestError(packageDir, \"scopes must name 'global', 'workspace', or 'session'.\");\n  }\n  const scopes: DoomApiScope[] = [];\n  for (const scope of value) {\n    if (scope !== 'session' && scope !== 'global' && scope !== 'workspace') {\n      throw new DoomServerFacetManifestError(\n        packageDir,\n        `Unknown scope '${String(scope)}'; resync for the three-level host.`,\n      );\n    }\n    if (!scopes.includes(scope)) scopes.push(scope);\n  }\n  return scopes;\n}\n\n/**\n * Validates one package.json's `poServer` block.\n *\n * `dist` is required because a host imports the built entry the package ships,\n * never its source.\n */\nexport function declaredServerFacetsOf(packageDir: string, manifest: Record<string, unknown>): DeclaredServerFacet[] {\n  const declared = manifest[DOOM_SERVER_FACET_MANIFEST_FIELD];\n  if (declared === undefined) return [];\n  if (!isRecord(declared)) {\n    throw new DoomServerFacetManifestError(packageDir, 'the block must be an object naming entry and dist.');\n  }\n  const entry = normalizePath(packageDir, 'entry', declared.entry);\n  if (declared.dist === undefined) {\n    throw new DoomServerFacetManifestError(\n      packageDir,\n      'dist is required: a host imports the built entry the package ships, never its source.',\n    );\n  }\n  const dist = normalizePath(packageDir, 'dist', declared.dist);\n  if (declared.required !== undefined && typeof declared.required !== 'boolean') {\n    throw new DoomServerFacetManifestError(packageDir, 'required must be a boolean.');\n  }\n  return [\n    {\n      packageName: typeof manifest.name === 'string' ? manifest.name : packageDir,\n      packageDir,\n      entry,\n      dist,\n      scopes: normalizeScopes(packageDir, declared.scopes),\n      ...(typeof declared.required === 'boolean' ? { required: declared.required } : {}),\n    },\n  ];\n}\n\n/**\n * The deterministic order hosts install in. A package appears once: the first\n * directory claiming a package name keeps it and the later one is dropped with\n * a notice, so a duplicated install never installs a facet twice.\n */\nexport function orderServerFacets(\n  facets: readonly DeclaredServerFacet[],\n  onNotice: (message: string) => void = () => undefined,\n): DeclaredServerFacet[] {\n  const sorted = [...facets].sort(\n    (left, right) =>\n      left.packageName.localeCompare(right.packageName) || left.packageDir.localeCompare(right.packageDir),\n  );\n  const owners = new Map<string, DeclaredServerFacet>();\n  const kept: DeclaredServerFacet[] = [];\n  for (const facet of sorted) {\n    const holder = owners.get(facet.packageName);\n    if (holder !== undefined) {\n      onNotice(\n        `server facet '${facet.packageName}' from ${facet.packageDir} is skipped: ${holder.packageDir} already claims it.`,\n      );\n      continue;\n    }\n    owners.set(facet.packageName, facet);\n    kept.push(facet);\n  }\n  return kept;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,47 @@
+//#region src/schemas/sessionMcpActivity.d.ts
+export type SessionMcpCallStatus = 'running' | 'succeeded' | 'failed' | 'cancelled' | 'interrupted';
+/** Host-only activity data. Never part of the remote agent's conversation or tool context. */
+export interface SessionMcpCall {
+  sequence: number;
+  id: string;
+  toolName: string;
+  clientName: string;
+  startedAt: number;
+  finishedAt?: number;
+  status: SessionMcpCallStatus;
+  input: string;
+  output?: string;
+}
+export interface SessionMcpAvailableTool {
+  name: string;
+  label: string;
+  description: string;
+  inputSchema: object;
+  connections: string[];
+}
+export interface SessionMcpActivitySnapshot {
+  enabled: boolean;
+  available: boolean;
+  /** Internal names. Remote names are `${toolPrefix}_${name}` when toolPrefix is set. */
+  tools: SessionMcpAvailableTool[];
+  toolPrefix?: string;
+  calls: SessionMcpCall[];
+  total: number;
+  nextBefore?: number;
+}
+/** Internal lifecycle event. Authentication credentials and transport metadata are deliberately absent. */
+export interface SessionMcpInvocation {
+  id: string;
+  parentSessionId: string;
+  sessionId?: string;
+  clientId: string;
+  conversationDigest?: string;
+  toolName: string;
+  startedAt: number;
+  finishedAt?: number;
+  status: SessionMcpCallStatus;
+  input: unknown;
+  output?: unknown;
+}
+//#endregion
+//# sourceMappingURL=sessionMcpActivity.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sessionMcpActivity.d.mts","names":[],"sources":["../../../src/schemas/sessionMcpActivity.ts"],"mappings":";YAAY;;iBAGK;EACf;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;;EAEA,OAAO;EACP;EACA,OAAO;EACP;EACA;;;iBAIe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA"}

package/dist/src/schemas/sessionProtocol.cjs

@@ -0,0 +1,17 @@
+let _earendil_works_chord = require("@earendil-works/chord");
+//#region src/schemas/sessionProtocol.ts
+const DOOM_SESSION_SERVICE_ID = "po.session.v2";
+const DOOM_SESSION_MANAGEMENT_SERVICE_ID = "po.session-management.v1";
+const DOOM_COCKPIT_SERVER_ID = "646f6f6d-7069-4000-8000-000000000001";
+const DoomHubService = (0, _earendil_works_chord.defineService)("po.hub.v1");
+const DoomSessionService = (0, _earendil_works_chord.defineService)(DOOM_SESSION_SERVICE_ID);
+const DoomSessionManagementService = (0, _earendil_works_chord.defineService)(DOOM_SESSION_MANAGEMENT_SERVICE_ID);
+//#endregion
+exports.DOOM_COCKPIT_SERVER_ID = DOOM_COCKPIT_SERVER_ID;
+exports.DOOM_SESSION_MANAGEMENT_SERVICE_ID = DOOM_SESSION_MANAGEMENT_SERVICE_ID;
+exports.DOOM_SESSION_SERVICE_ID = DOOM_SESSION_SERVICE_ID;
+exports.DoomHubService = DoomHubService;
+exports.DoomSessionManagementService = DoomSessionManagementService;
+exports.DoomSessionService = DoomSessionService;
+
+//# sourceMappingURL=sessionProtocol.cjs.map

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 = 'po.session.v2';\nexport const DOOM_SESSION_MANAGEMENT_SERVICE_ID = 'po.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 Po'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  fastMode: boolean;\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>('po.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  fastMode: boolean;\n  agentLocked?: boolean;\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  setFastMode(enabled: boolean, context: Context): Promise<void>;\n  setAgentLock(locked: boolean, 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;AA+HtC,MAAa,kBAAA,GAAiBA,sBAAAA,cAAAA,CAA0B,WAAW;AAyLnE,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,313 @@
+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 = "po.session.v2";
+export declare const DOOM_SESSION_MANAGEMENT_SERVICE_ID = "po.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 Po'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;
+  fastMode: boolean;
+  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;
+  fastMode: boolean;
+  agentLocked?: boolean;
+  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>;
+  setFastMode(enabled: boolean, context: Context): Promise<void>;
+  setAgentLock(locked: boolean, 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":["JsonValue"],"sources":["../../../src/schemas/sessionProtocol.ts"],"mappings":";;;qBAIa;qBACA;qBACA;KAEDA,iDAA+CA;GAAiB,cAAcA;;YAC9E;YACA;;iBAGK;EACf;EACA;IAAa;IAAY;IAA2C;;EACpE;EACA,OAAO;IACL;IACA;IACA,SAAS;IACT;IACA;IACA;;;iBAIa;EACf;EACA;;iBAGe;EACf;EACA;;iBAGe;EACf;EACA;EACA;;iBAGe;EACf;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA,OAAOA;;iBAGQ;EACf;EACA;EACA,SAAS,MAAM,kBAAkB;EACjC;;iBAGe;EACf;EACA;EACA,SAAS,MAAM,kBAAkB,sBAAsB;EACvD,OAAO;EACP;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA,OAAOA;EACP,SAAS,MAAM,kBAAkB;EACjC,UAAUA;EACV;EACA;EACA;;YAGU,iBAAiB,qBAAqB,0BAA0B;YAEhE;EACN;EAAsB,MAAM;;EAC5B;EAAsB,MAAM;;EAC5B;EAAuB,MAAM;;iBAElB;EACf;EACA;EACA;EACA;EACA;EACA,OAAO;EACP,OAAO;EACP,eAAe;EACf;EACA;EACA;EACA;EACA,YAAY;EACZ,aAAa;EACb;;EAEA,YAAY;;iBAGG;EACf;EACA;IAAS;KAAe,cAAcA;;;iBAGvB;EACf;EACA;;EAEA;EACA,QAAQ;EACR,aAAa;;iBAGE;WACN,OAAO;IAAkB,QAAQ;;EAC1C,KAAK;IAAS;KAAe,cAAcA;KAAa,SAAS,UAAU;;qBAGhE,gDAAc,QAAA;iBAEV;EACf,UAAU,KAAK;EACf,UAAU;;EAEV,UAAU;EACV,eAAe;;EAEf,WAAW;;iBAGI;EACf;EACA;EACA;EACA;;iBAGe;EACf,SAASA;EACT;EACA;EACA;EACA;EACA;EACA;;EAEA,SAASA;;EAET,QAAQ;;iBAGO;EACf;EACA,SAAS;;iBAGM,mBAAmB;;EAElC;;YAEU,YAAY;YACZ,eAAe;iBACV;EACf;;iBAEe,0BAA0B;EACzC;;iBAGe;EACf;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA,UAAUA;EACV,QAAQ;EACR;;iBAGe;EACf;EACA;EACA;EACA,eAAe;;YAGL;EACN;EAAY;;EACZ;EAAY;;EACZ;EAAY;;iBAED;EACf,QAAQ;EACR,eAAe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA,QAAQ;EACR;EACA;IACE;IACA;IACA;;;iBAIa;EACf;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA,aAAa;;iBAGE;WACN,OAAO,gBAAgB;EAChC,mBAAmB,MAAM,uBAAuB,SAAS,UAAU,QAAQ;EAC3E,OAAO,cAAc,SAAS,UAAU;EACxC,OAAO,MAAM,YAAY,SAAS,UAAU;EAC5C,MAAM,cAAc,SAAS,UAAU;EACvC,MAAM,MAAM,WAAW,SAAS,UAAU;EAC1C,MAAM,SAAS,UAAU;EACzB,eAAe;IAAQ;KAAuB,SAAS,UAAU;EACjE,SAAS,OAAO,UAAU,SAAS,UAAU;EAC7C,YAAY,eAAe,eAAe,SAAS,UAAU;EAC7D,YAAY,kBAAkB,SAAS,UAAU;EACjD,aAAa,iBAAiB,SAAS,UAAU;EACjD,SAAS,MAAM,cAAc,SAAS,UAAU;EAChD,iBAAiB,MAAM,cAAc,SAAS,UAAU;IAAU;;EAClE,aACE,MAAM,gBACN,SAAS,UACR;EACH,cACE,MAAM,mBACN,SAAS,UACR;EACH,YAAY,SAAS,UAAU;EAC/B,WAAW,SAAS,UAAU,QAAQ;EACtC,OAAO,MAAM,YAAY,SAAS,UAAU,QAAQ;EACpD,oBAAoB,UAAU,qBAAqB,SAAS,UAAU;EACtE,SAAS,SAAS,UAAU,QAAQ;EACpC,gBAAgB,SAAS,UAAU,QAAQ;EAC3C,YAAY,SAAS,UAAU,QAAQ;EACvC,mBAAmB,SAAS,UAAU,QAAQ;EAC9C,2BAA2B,SAAS,UAAU,QAAQ;EACtD,QAAQ;IAAQ;KAA+B,SAAS,UAAU,QAAQA;EAC1E,QAAQ,cAAc,SAAS,UAAU;;iBAG1B;EACf,OAAO,mBAAmB,SAAS,UAAU;EAC7C,OAAO,SAAS,UAAU;;qBAGf,oDAAkB,QAAA;qBAClB,8DAA4B,QAAA"}

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 = "po.session.v2";
+const DOOM_SESSION_MANAGEMENT_SERVICE_ID = "po.session-management.v1";
+const DOOM_COCKPIT_SERVER_ID = "646f6f6d-7069-4000-8000-000000000001";
+const DoomHubService = defineService("po.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 = 'po.session.v2';\nexport const DOOM_SESSION_MANAGEMENT_SERVICE_ID = 'po.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 Po'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  fastMode: boolean;\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>('po.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  fastMode: boolean;\n  agentLocked?: boolean;\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  setFastMode(enabled: boolean, context: Context): Promise<void>;\n  setAgentLock(locked: boolean, 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;AA+HtC,MAAa,iBAAiB,cAA0B,WAAW;AAyLnE,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 Po'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/po-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