@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

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

@@ -1,9 +1,10 @@
 import { PluginLifecycleHooks } from "../services/pluginLifecycle/index.mjs";
-import { DoomHubChannel } from "./hubChannel.mjs";
-import { DoomApi } from "./packageApi.mjs";
-import { DoomHeadlessActivity, DoomHeadlessCommand, DoomHeadlessEventName, DoomHeadlessHook, DoomHeadlessTool } from "./headless.mjs";
-import { DoomPluginCommand, DoomPluginTool } from "./pluginContributions.mjs";
-import { DoomServerMethod } from "./serverFacet.mjs";
+import { PoHubChannel } from "./hubChannel.mjs";
+import { PoApi } from "./packageApi.mjs";
+import { PoHeadlessActivity, PoHeadlessCommand, PoHeadlessEventName, PoHeadlessHook, PoHeadlessTool } from "./headless.mjs";
+import { PoPluginCommand, PoPluginTool } from "./pluginContributions.mjs";
+import { PoServiceContract } from "./serverScope.mjs";
+import { PoServerMethod } from "./serverPlugin.mjs";
 import { TSchema } from "typebox";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/schemas/extensionFile.d.ts
@@ -36,9 +37,9 @@ export type OrFactory<TDeclaration, TContext> = TDeclaration | ((context: TConte
  * `kind` is absent because the helper adds it, which is also what keeps this
  * distinct from the neutral `defineTool` a hand-written entry uses.
  */
-export type ToolFile<TContext = unknown> = OrFactory<PathSupplied<Omit<DoomPluginTool, 'kind'>, 'name'>, TContext>;
+export type ToolFile<TContext = unknown> = OrFactory<PathSupplied<Omit<PoPluginTool, 'kind'>, 'name'>, TContext>;
 /** What `defineTool` returns: the authored shape with the discriminant restored. */
-export type ToolContribution<TContext = unknown> = OrFactory<PathSupplied<DoomPluginTool, 'name'>, TContext>;
+export type ToolContribution<TContext = unknown> = OrFactory<PathSupplied<PoPluginTool, 'name'>, TContext>;
 /**
  * `tool/<name>.server.ts`. A tool the headless host registers directly.
  *
@@ -48,7 +49,7 @@ export type ToolContribution<TContext = unknown> = OrFactory<PathSupplied<DoomPl
  * between them is a real decision, so it is spelled by the helper rather than
  * inferred from the shape.
  */
-export type ServerToolFile<TParameters extends TSchema = TSchema, TContext = unknown> = OrFactory<PathSupplied<DoomHeadlessTool<TParameters>, 'name'>, TContext>;
+export type ServerToolFile<TParameters extends TSchema = TSchema, TContext = unknown> = OrFactory<PathSupplied<PoHeadlessTool<TParameters>, 'name'>, TContext>;
 /**
  * What a scope's `root.ts` returns: the value its subtree shares, its
  * injectable services, session startup work, and lifetime hooks.
@@ -61,26 +62,29 @@ export type ServerToolFile<TParameters extends TSchema = TSchema, TContext = unk
 export interface RootDeclaration<TValue, TContext = unknown> extends PluginLifecycleHooks<TContext> {
   readonly value: TValue;
   readonly services?: readonly Parameters<Context['plugin']>[0][];
-  readonly activities?: readonly DoomHeadlessActivity[];
+  readonly activities?: readonly PoHeadlessActivity[];
 }
 /**
  * `root.ts`. One per scope and side, as Next.js spells a layout.
  *
  * Always a factory: a scope is constructed from its mount, and building the
  * graph at module scope is the module-level singleton the Cordis ownership
- * rules exist to prevent.
+ * rules exist to prevent. `inject`, set through `defineRoot`, names the
+ * contracts the level waits for before it builds this root.
  */
-export type RootFile<TValue, TContext = unknown> = (context: TContext) => RootDeclaration<TValue, TContext> | Promise<RootDeclaration<TValue, TContext>>;
+export type RootFile<TValue, TContext = unknown> = ((context: TContext) => RootDeclaration<TValue, TContext> | Promise<RootDeclaration<TValue, TContext>>) & {
+  readonly inject?: readonly PoServiceContract<unknown>[];
+};
 /** A mount context with the nearest root's value attached, as a routed file sees it. */
 export type WithRoot<TContext, TValue> = TContext & {
   readonly root: TValue;
 };
 /** `command/<name>.ts`. The filename becomes the command name in kebab case. */
-export type CommandFile<TContext = unknown> = OrFactory<PathSupplied<Omit<DoomPluginCommand, 'kind'>, 'name'>, TContext>;
+export type CommandFile<TContext = unknown> = OrFactory<PathSupplied<Omit<PoPluginCommand, 'kind'>, 'name'>, TContext>;
 /** What `defineCommand` returns: the authored shape with the discriminant restored. */
-export type CommandContribution<TContext = unknown> = OrFactory<PathSupplied<DoomPluginCommand, 'name'>, TContext>;
+export type CommandContribution<TContext = unknown> = OrFactory<PathSupplied<PoPluginCommand, 'name'>, TContext>;
 /** `command/<name>.server.ts`. A command registered by the headless session host. */
-export type ServerCommandFile<TContext = unknown> = OrFactory<PathSupplied<DoomHeadlessCommand | DoomPluginCommand, 'name'>, TContext>;
+export type ServerCommandFile<TContext = unknown> = OrFactory<PathSupplied<PoHeadlessCommand | PoPluginCommand, 'name'>, TContext>;
 /**
  * `hook/<event>.ts`. The filename becomes the event in snake case.
  *
@@ -88,7 +92,7 @@ export type ServerCommandFile<TContext = unknown> = OrFactory<PathSupplied<DoomH
  * precise payload: the event is the discriminant, so leaving it to the path
  * widens the handler's argument to every event's union.
  */
-export type HookFile<TEvent extends DoomHeadlessEventName = DoomHeadlessEventName, TContext = unknown> = OrFactory<PathSupplied<DoomHeadlessHook<TEvent>, 'event'>, TContext>;
+export type HookFile<TEvent extends PoHeadlessEventName = PoHeadlessEventName, TContext = unknown> = OrFactory<PathSupplied<PoHeadlessHook<TEvent>, 'event'>, TContext>;
 /**
  * A scope root service factory returning a Cordis plugin.
  *
@@ -105,12 +109,12 @@ export type HookFile<TEvent extends DoomHeadlessEventName = DoomHeadlessEventNam
  */
 export type ServiceFile<TContext = unknown> = (context: TContext) => Parameters<Context['plugin']>[0];
 /** `channel/<frameType>.ts`. The array holds factories, so this is one. */
-export type ChannelFile = () => PathSupplied<DoomHubChannel, 'frameType'>;
+export type ChannelFile = () => PathSupplied<PoHubChannel, 'frameType'>;
 /** `api/<segments>/route.ts`. The folder path is the route; nothing is derived into the value. */
-export type RouteFile<TContext = unknown> = OrFactory<DoomApi, TContext>;
+export type RouteFile<TContext = unknown> = OrFactory<PoApi, TContext>;
 /** `method/<member>.ts`. Build it with `defineServerMethod` to keep schema inference. */
-export type MethodFile<TContext = unknown> = OrFactory<DoomServerMethod, TContext>;
+export type MethodFile<TContext = unknown> = OrFactory<PoServerMethod, TContext>;
 /** A session root activity. Activities name themselves. */
-export type ActivityFile<TContext = unknown> = OrFactory<DoomHeadlessActivity, TContext>;
+export type ActivityFile<TContext = unknown> = OrFactory<PoHeadlessActivity, TContext>;
 //#endregion
 //# sourceMappingURL=extensionFile.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"extensionFile.d.mts","names":[],"sources":["../../../src/schemas/extensionFile.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;YAiCY,aAAa,eAAe,oBAAoB,iBAAiB,gCACzE,KAAK,eAAe,SAAS,QAAQ,KAAK,eAAe;YAGjD;iBACK;WACN,aAAa;;;YAIZ,UAAU,cAAc,YAAY,iBAAiB,SAAS,aAAa;;;;;;;YAQ3E,SAAS,sBAAsB,UAAU,aAAa,KAAK,kCAAkC;;YAG7F,iBAAiB,sBAAsB,UAAU,aAAa,yBAAyB;;;;;;;;;;YAWvF,eAAe,oBAAoB,UAAU,SAAS,sBAAsB,UACtF,aAAa,iBAAiB,uBAC9B;;;;;;;;;;iBAYe,gBAAgB,QAAQ,4BAA4B,qBAAqB;WAC/E,OAAO;WACP,oBAAoB,WAAW;WAC/B,sBAAsB;;;;;;;;;YAUrB,SAAS,QAAQ,uBAC3B,SAAS,aACN,gBAAgB,QAAQ,YAAY,QAAQ,gBAAgB,QAAQ;;YAG7D,SAAS,UAAU,UAAU;WAAsB,MAAM;;;YAGzD,YAAY,sBAAsB,UAC5C,aAAa,KAAK,qCAClB;;YAIU,oBAAoB,sBAAsB,UAAU,aAAa,4BAA4B;;YAG7F,kBAAkB,sBAAsB,UAClD,aAAa,sBAAsB,4BACnC;;;;;;;;YAUU,SAAS,eAAe,wBAAwB,uBAAuB,sBAAsB,UACvG,aAAa,iBAAiB,mBAC9B;;;;;;;;;;;;;;;YAiBU,YAAY,uBAAuB,SAAS,aAAa,WAAW;;YAGpE,oBAAoB,aAAa;;YAGjC,UAAU,sBAAsB,UAAU,SAAS;;YAGnD,WAAW,sBAAsB,UAAU,kBAAkB;;YAG7D,aAAa,sBAAsB,UAAU,sBAAsB"}
+{"version":3,"file":"extensionFile.d.mts","names":[],"sources":["../../../src/schemas/extensionFile.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;YAkCY,aAAa,eAAe,oBAAoB,iBAAiB,gCACzE,KAAK,eAAe,SAAS,QAAQ,KAAK,eAAe;YAGjD;iBACK;WACN,aAAa;;;YAIZ,UAAU,cAAc,YAAY,iBAAiB,SAAS,aAAa;;;;;;;YAQ3E,SAAS,sBAAsB,UAAU,aAAa,KAAK,gCAAgC;;YAG3F,iBAAiB,sBAAsB,UAAU,aAAa,uBAAuB;;;;;;;;;;YAWrF,eAAe,oBAAoB,UAAU,SAAS,sBAAsB,UACtF,aAAa,eAAe,uBAC5B;;;;;;;;;;iBAYe,gBAAgB,QAAQ,4BAA4B,qBAAqB;WAC/E,OAAO;WACP,oBAAoB,WAAW;WAC/B,sBAAsB;;;;;;;;;;YAWrB,SAAS,QAAQ,wBAC3B,SAAS,aACN,gBAAgB,QAAQ,YAAY,QAAQ,gBAAgB,QAAQ;WAC9D,kBAAkB;;;YAIjB,SAAS,UAAU,UAAU;WAAsB,MAAM;;;YAGzD,YAAY,sBAAsB,UAAU,aAAa,KAAK,mCAAmC;;YAGjG,oBAAoB,sBAAsB,UAAU,aAAa,0BAA0B;;YAG3F,kBAAkB,sBAAsB,UAClD,aAAa,oBAAoB,0BACjC;;;;;;;;YAUU,SAAS,eAAe,sBAAsB,qBAAqB,sBAAsB,UACnG,aAAa,eAAe,mBAC5B;;;;;;;;;;;;;;;YAiBU,YAAY,uBAAuB,SAAS,aAAa,WAAW;;YAGpE,oBAAoB,aAAa;;YAGjC,UAAU,sBAAsB,UAAU,OAAO;;YAGjD,WAAW,sBAAsB,UAAU,gBAAgB;;YAG3D,aAAa,sBAAsB,UAAU,oBAAoB"}

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

@@ -1 +1 @@
-{"version":3,"file":"footer.cjs","names":["Type"],"sources":["../../../src/schemas/footer.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const FooterTextColorSchema = Type.Union([\n  Type.Literal('accent'),\n  Type.Literal('mdCode'),\n  Type.Literal('toolDiffAdded'),\n  Type.Literal('warning'),\n  Type.Literal('mdHeading'),\n  Type.Literal('syntaxNumber'),\n  Type.Literal('muted'),\n  Type.Literal('dim'),\n]);\nexport type FooterTextColor = Static<typeof FooterTextColorSchema>;\n\nexport const FooterStatusPlacementSchema = Type.Union([Type.Literal('modeline'), Type.Literal('beforeModel')]);\nexport type FooterStatusPlacement = Static<typeof FooterStatusPlacementSchema>;\n\nexport const FooterTextSegmentSchema = Type.Object(\n  {\n    text: Type.String({ minLength: 1, maxLength: 80 }),\n    color: Type.Optional(FooterTextColorSchema),\n  },\n  { additionalProperties: false },\n);\nexport type FooterTextSegment = Static<typeof FooterTextSegmentSchema>;\n\nexport const FooterStatusItemSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1, maxLength: 128 }),\n    fullText: Type.String({ minLength: 1, maxLength: 80 }),\n    compactText: Type.String({ minLength: 1, maxLength: 24 }),\n    fullSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 80 })),\n    compactSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 24 })),\n    placement: Type.Optional(FooterStatusPlacementSchema),\n    order: Type.Integer({ minimum: 0, maximum: 1000 }),\n  },\n  { additionalProperties: false },\n);\nexport type FooterStatusItem = Static<typeof FooterStatusItemSchema>;\n\nexport interface DoomFooterContributionDefinition {\n  source: string;\n  id: string;\n  order: number;\n  placement?: FooterStatusPlacement;\n}\n\nexport interface DoomFooterContributionValue {\n  fullText: string;\n  compactText: string;\n  fullSegments?: FooterTextSegment[];\n  compactSegments?: FooterTextSegment[];\n}\n\nexport interface DoomFooterContributionHandle {\n  update(value: DoomFooterContributionValue | undefined): void;\n  dispose(): void;\n}\n\nexport interface DoomFooterStatus extends FooterStatusItem {\n  source: string;\n}\n"],"mappings":";;AAEA,MAAa,wBAAwBA,QAAAA,KAAK,MAAM;CAC9CA,QAAAA,KAAK,QAAQ,QAAQ;CACrBA,QAAAA,KAAK,QAAQ,QAAQ;CACrBA,QAAAA,KAAK,QAAQ,eAAe;CAC5BA,QAAAA,KAAK,QAAQ,SAAS;CACtBA,QAAAA,KAAK,QAAQ,WAAW;CACxBA,QAAAA,KAAK,QAAQ,cAAc;CAC3BA,QAAAA,KAAK,QAAQ,OAAO;CACpBA,QAAAA,KAAK,QAAQ,KAAK;AACpB,CAAC;AAGD,MAAa,8BAA8BA,QAAAA,KAAK,MAAM,CAACA,QAAAA,KAAK,QAAQ,UAAU,GAAGA,QAAAA,KAAK,QAAQ,aAAa,CAAC,CAAC;AAG7G,MAAa,0BAA0BA,QAAAA,KAAK,OAC1C;CACE,MAAMA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACjD,OAAOA,QAAAA,KAAK,SAAS,qBAAqB;AAC5C,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,yBAAyBA,QAAAA,KAAK,OACzC;CACE,IAAIA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAI,CAAC;CAChD,UAAUA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACrD,aAAaA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACxD,cAAcA,QAAAA,KAAK,SAASA,QAAAA,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACjF,iBAAiBA,QAAAA,KAAK,SAASA,QAAAA,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACpF,WAAWA,QAAAA,KAAK,SAAS,2BAA2B;CACpD,OAAOA,QAAAA,KAAK,QAAQ;EAAE,SAAS;EAAG,SAAS;CAAK,CAAC;AACnD,GACA,EAAE,sBAAsB,MAAM,CAChC"}
+{"version":3,"file":"footer.cjs","names":["Type"],"sources":["../../../src/schemas/footer.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const FooterTextColorSchema = Type.Union([\n  Type.Literal('accent'),\n  Type.Literal('mdCode'),\n  Type.Literal('toolDiffAdded'),\n  Type.Literal('warning'),\n  Type.Literal('mdHeading'),\n  Type.Literal('syntaxNumber'),\n  Type.Literal('muted'),\n  Type.Literal('dim'),\n]);\nexport type FooterTextColor = Static<typeof FooterTextColorSchema>;\n\nexport const FooterStatusPlacementSchema = Type.Union([Type.Literal('modeline'), Type.Literal('beforeModel')]);\nexport type FooterStatusPlacement = Static<typeof FooterStatusPlacementSchema>;\n\nexport const FooterTextSegmentSchema = Type.Object(\n  {\n    text: Type.String({ minLength: 1, maxLength: 80 }),\n    color: Type.Optional(FooterTextColorSchema),\n  },\n  { additionalProperties: false },\n);\nexport type FooterTextSegment = Static<typeof FooterTextSegmentSchema>;\n\nexport const FooterStatusItemSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1, maxLength: 128 }),\n    fullText: Type.String({ minLength: 1, maxLength: 80 }),\n    compactText: Type.String({ minLength: 1, maxLength: 24 }),\n    fullSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 80 })),\n    compactSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 24 })),\n    placement: Type.Optional(FooterStatusPlacementSchema),\n    order: Type.Integer({ minimum: 0, maximum: 1000 }),\n  },\n  { additionalProperties: false },\n);\nexport type FooterStatusItem = Static<typeof FooterStatusItemSchema>;\n\nexport interface PoFooterContributionDefinition {\n  source: string;\n  id: string;\n  order: number;\n  placement?: FooterStatusPlacement;\n}\n\nexport interface PoFooterContributionValue {\n  fullText: string;\n  compactText: string;\n  fullSegments?: FooterTextSegment[];\n  compactSegments?: FooterTextSegment[];\n}\n\nexport interface PoFooterContributionHandle {\n  update(value: PoFooterContributionValue | undefined): void;\n  dispose(): void;\n}\n\nexport interface PoFooterStatus extends FooterStatusItem {\n  source: string;\n}\n"],"mappings":";;AAEA,MAAa,wBAAwBA,QAAAA,KAAK,MAAM;CAC9CA,QAAAA,KAAK,QAAQ,QAAQ;CACrBA,QAAAA,KAAK,QAAQ,QAAQ;CACrBA,QAAAA,KAAK,QAAQ,eAAe;CAC5BA,QAAAA,KAAK,QAAQ,SAAS;CACtBA,QAAAA,KAAK,QAAQ,WAAW;CACxBA,QAAAA,KAAK,QAAQ,cAAc;CAC3BA,QAAAA,KAAK,QAAQ,OAAO;CACpBA,QAAAA,KAAK,QAAQ,KAAK;AACpB,CAAC;AAGD,MAAa,8BAA8BA,QAAAA,KAAK,MAAM,CAACA,QAAAA,KAAK,QAAQ,UAAU,GAAGA,QAAAA,KAAK,QAAQ,aAAa,CAAC,CAAC;AAG7G,MAAa,0BAA0BA,QAAAA,KAAK,OAC1C;CACE,MAAMA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACjD,OAAOA,QAAAA,KAAK,SAAS,qBAAqB;AAC5C,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,yBAAyBA,QAAAA,KAAK,OACzC;CACE,IAAIA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAI,CAAC;CAChD,UAAUA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACrD,aAAaA,QAAAA,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACxD,cAAcA,QAAAA,KAAK,SAASA,QAAAA,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACjF,iBAAiBA,QAAAA,KAAK,SAASA,QAAAA,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACpF,WAAWA,QAAAA,KAAK,SAAS,2BAA2B;CACpD,OAAOA,QAAAA,KAAK,QAAQ;EAAE,SAAS;EAAG,SAAS;CAAK,CAAC;AACnD,GACA,EAAE,sBAAsB,MAAM,CAChC"}

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

@@ -25,23 +25,23 @@ export declare const FooterStatusItemSchema: Type.TObject<{
   order: Type.TInteger;
 }>;
 export type FooterStatusItem = Static<typeof FooterStatusItemSchema>;
-export interface DoomFooterContributionDefinition {
+export interface PoFooterContributionDefinition {
   source: string;
   id: string;
   order: number;
   placement?: FooterStatusPlacement;
 }
-export interface DoomFooterContributionValue {
+export interface PoFooterContributionValue {
   fullText: string;
   compactText: string;
   fullSegments?: FooterTextSegment[];
   compactSegments?: FooterTextSegment[];
 }
-export interface DoomFooterContributionHandle {
-  update(value: DoomFooterContributionValue | undefined): void;
+export interface PoFooterContributionHandle {
+  update(value: PoFooterContributionValue | undefined): void;
   dispose(): void;
 }
-export interface DoomFooterStatus extends FooterStatusItem {
+export interface PoFooterStatus extends FooterStatusItem {
   source: string;
 }
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"footer.d.mts","names":[],"sources":["../../../src/schemas/footer.ts"],"mappings":";;qBAEa,uBAAqB,KAAA,QAAA,KAAA,oBAAA,KAAA,oBAAA,KAAA,2BAAA,KAAA,qBAAA,KAAA,uBAAA,KAAA,0BAAA,KAAA,mBAAA,KAAA;YAUtB,kBAAkB,cAAc;qBAE/B,6BAA2B,KAAA,QAAA,KAAA,sBAAA,KAAA;YAC5B,wBAAwB,cAAc;qBAErC,yBAAuB,KAAA;;;;YAOxB,oBAAoB,cAAc;qBAEjC,wBAAsB,KAAA;;;;;;;;;;;;;;;YAYvB,mBAAmB,cAAc;iBAE5B;EACf;EACA;EACA;EACA,YAAY;;iBAGG;EACf;EACA;EACA,eAAe;EACf,kBAAkB;;iBAGH;EACf,OAAO,OAAO;EACd;;iBAGe,yBAAyB;EACxC"}
+{"version":3,"file":"footer.d.mts","names":[],"sources":["../../../src/schemas/footer.ts"],"mappings":";;qBAEa,uBAAqB,KAAA,QAAA,KAAA,oBAAA,KAAA,oBAAA,KAAA,2BAAA,KAAA,qBAAA,KAAA,uBAAA,KAAA,0BAAA,KAAA,mBAAA,KAAA;YAUtB,kBAAkB,cAAc;qBAE/B,6BAA2B,KAAA,QAAA,KAAA,sBAAA,KAAA;YAC5B,wBAAwB,cAAc;qBAErC,yBAAuB,KAAA;;;;YAOxB,oBAAoB,cAAc;qBAEjC,wBAAsB,KAAA;;;;;;;;;;;;;;;YAYvB,mBAAmB,cAAc;iBAE5B;EACf;EACA;EACA;EACA,YAAY;;iBAGG;EACf;EACA;EACA,eAAe;EACf,kBAAkB;;iBAGH;EACf,OAAO,OAAO;EACd;;iBAGe,uBAAuB;EACtC"}

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

@@ -1 +1 @@
-{"version":3,"file":"footer.mjs","names":[],"sources":["../../../src/schemas/footer.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const FooterTextColorSchema = Type.Union([\n  Type.Literal('accent'),\n  Type.Literal('mdCode'),\n  Type.Literal('toolDiffAdded'),\n  Type.Literal('warning'),\n  Type.Literal('mdHeading'),\n  Type.Literal('syntaxNumber'),\n  Type.Literal('muted'),\n  Type.Literal('dim'),\n]);\nexport type FooterTextColor = Static<typeof FooterTextColorSchema>;\n\nexport const FooterStatusPlacementSchema = Type.Union([Type.Literal('modeline'), Type.Literal('beforeModel')]);\nexport type FooterStatusPlacement = Static<typeof FooterStatusPlacementSchema>;\n\nexport const FooterTextSegmentSchema = Type.Object(\n  {\n    text: Type.String({ minLength: 1, maxLength: 80 }),\n    color: Type.Optional(FooterTextColorSchema),\n  },\n  { additionalProperties: false },\n);\nexport type FooterTextSegment = Static<typeof FooterTextSegmentSchema>;\n\nexport const FooterStatusItemSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1, maxLength: 128 }),\n    fullText: Type.String({ minLength: 1, maxLength: 80 }),\n    compactText: Type.String({ minLength: 1, maxLength: 24 }),\n    fullSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 80 })),\n    compactSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 24 })),\n    placement: Type.Optional(FooterStatusPlacementSchema),\n    order: Type.Integer({ minimum: 0, maximum: 1000 }),\n  },\n  { additionalProperties: false },\n);\nexport type FooterStatusItem = Static<typeof FooterStatusItemSchema>;\n\nexport interface DoomFooterContributionDefinition {\n  source: string;\n  id: string;\n  order: number;\n  placement?: FooterStatusPlacement;\n}\n\nexport interface DoomFooterContributionValue {\n  fullText: string;\n  compactText: string;\n  fullSegments?: FooterTextSegment[];\n  compactSegments?: FooterTextSegment[];\n}\n\nexport interface DoomFooterContributionHandle {\n  update(value: DoomFooterContributionValue | undefined): void;\n  dispose(): void;\n}\n\nexport interface DoomFooterStatus extends FooterStatusItem {\n  source: string;\n}\n"],"mappings":";;AAEA,MAAa,wBAAwB,KAAK,MAAM;CAC9C,KAAK,QAAQ,QAAQ;CACrB,KAAK,QAAQ,QAAQ;CACrB,KAAK,QAAQ,eAAe;CAC5B,KAAK,QAAQ,SAAS;CACtB,KAAK,QAAQ,WAAW;CACxB,KAAK,QAAQ,cAAc;CAC3B,KAAK,QAAQ,OAAO;CACpB,KAAK,QAAQ,KAAK;AACpB,CAAC;AAGD,MAAa,8BAA8B,KAAK,MAAM,CAAC,KAAK,QAAQ,UAAU,GAAG,KAAK,QAAQ,aAAa,CAAC,CAAC;AAG7G,MAAa,0BAA0B,KAAK,OAC1C;CACE,MAAM,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACjD,OAAO,KAAK,SAAS,qBAAqB;AAC5C,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,yBAAyB,KAAK,OACzC;CACE,IAAI,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAI,CAAC;CAChD,UAAU,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACrD,aAAa,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACxD,cAAc,KAAK,SAAS,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACjF,iBAAiB,KAAK,SAAS,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACpF,WAAW,KAAK,SAAS,2BAA2B;CACpD,OAAO,KAAK,QAAQ;EAAE,SAAS;EAAG,SAAS;CAAK,CAAC;AACnD,GACA,EAAE,sBAAsB,MAAM,CAChC"}
+{"version":3,"file":"footer.mjs","names":[],"sources":["../../../src/schemas/footer.ts"],"sourcesContent":["import { type Static, Type } from 'typebox';\n\nexport const FooterTextColorSchema = Type.Union([\n  Type.Literal('accent'),\n  Type.Literal('mdCode'),\n  Type.Literal('toolDiffAdded'),\n  Type.Literal('warning'),\n  Type.Literal('mdHeading'),\n  Type.Literal('syntaxNumber'),\n  Type.Literal('muted'),\n  Type.Literal('dim'),\n]);\nexport type FooterTextColor = Static<typeof FooterTextColorSchema>;\n\nexport const FooterStatusPlacementSchema = Type.Union([Type.Literal('modeline'), Type.Literal('beforeModel')]);\nexport type FooterStatusPlacement = Static<typeof FooterStatusPlacementSchema>;\n\nexport const FooterTextSegmentSchema = Type.Object(\n  {\n    text: Type.String({ minLength: 1, maxLength: 80 }),\n    color: Type.Optional(FooterTextColorSchema),\n  },\n  { additionalProperties: false },\n);\nexport type FooterTextSegment = Static<typeof FooterTextSegmentSchema>;\n\nexport const FooterStatusItemSchema = Type.Object(\n  {\n    id: Type.String({ minLength: 1, maxLength: 128 }),\n    fullText: Type.String({ minLength: 1, maxLength: 80 }),\n    compactText: Type.String({ minLength: 1, maxLength: 24 }),\n    fullSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 80 })),\n    compactSegments: Type.Optional(Type.Array(FooterTextSegmentSchema, { maxItems: 24 })),\n    placement: Type.Optional(FooterStatusPlacementSchema),\n    order: Type.Integer({ minimum: 0, maximum: 1000 }),\n  },\n  { additionalProperties: false },\n);\nexport type FooterStatusItem = Static<typeof FooterStatusItemSchema>;\n\nexport interface PoFooterContributionDefinition {\n  source: string;\n  id: string;\n  order: number;\n  placement?: FooterStatusPlacement;\n}\n\nexport interface PoFooterContributionValue {\n  fullText: string;\n  compactText: string;\n  fullSegments?: FooterTextSegment[];\n  compactSegments?: FooterTextSegment[];\n}\n\nexport interface PoFooterContributionHandle {\n  update(value: PoFooterContributionValue | undefined): void;\n  dispose(): void;\n}\n\nexport interface PoFooterStatus extends FooterStatusItem {\n  source: string;\n}\n"],"mappings":";;AAEA,MAAa,wBAAwB,KAAK,MAAM;CAC9C,KAAK,QAAQ,QAAQ;CACrB,KAAK,QAAQ,QAAQ;CACrB,KAAK,QAAQ,eAAe;CAC5B,KAAK,QAAQ,SAAS;CACtB,KAAK,QAAQ,WAAW;CACxB,KAAK,QAAQ,cAAc;CAC3B,KAAK,QAAQ,OAAO;CACpB,KAAK,QAAQ,KAAK;AACpB,CAAC;AAGD,MAAa,8BAA8B,KAAK,MAAM,CAAC,KAAK,QAAQ,UAAU,GAAG,KAAK,QAAQ,aAAa,CAAC,CAAC;AAG7G,MAAa,0BAA0B,KAAK,OAC1C;CACE,MAAM,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACjD,OAAO,KAAK,SAAS,qBAAqB;AAC5C,GACA,EAAE,sBAAsB,MAAM,CAChC;AAGA,MAAa,yBAAyB,KAAK,OACzC;CACE,IAAI,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAI,CAAC;CAChD,UAAU,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACrD,aAAa,KAAK,OAAO;EAAE,WAAW;EAAG,WAAW;CAAG,CAAC;CACxD,cAAc,KAAK,SAAS,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACjF,iBAAiB,KAAK,SAAS,KAAK,MAAM,yBAAyB,EAAE,UAAU,GAAG,CAAC,CAAC;CACpF,WAAW,KAAK,SAAS,2BAA2B;CACpD,OAAO,KAAK,QAAQ;EAAE,SAAS;EAAG,SAAS;CAAK,CAAC;AACnD,GACA,EAAE,sBAAsB,MAAM,CAChC"}

package/dist/src/schemas/headless.cjs

@@ -1,55 +1,55 @@
 //#region src/schemas/headless.ts
 /** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */
-const DOOM_HEADLESS_HOST_SERVICE = "doom/headless-host";
-const DOOM_HEADLESS_OWNER = Symbol.for("doom/headless-owner");
-const PROMPT_ADMISSION_ERROR = "DoomHeadlessPromptAdmissionError";
-/** Admission is a host boundary, not an advisory facet-hook failure. */
-var DoomHeadlessPromptAdmissionError = class extends Error {
+const PO_HEADLESS_HOST_SERVICE = "po/headless-host";
+const PO_HEADLESS_OWNER = Symbol.for("po/headless-owner");
+const PROMPT_ADMISSION_ERROR = "PoHeadlessPromptAdmissionError";
+/** Admission is a host boundary, not an advisory package-hook failure. */
+var PoHeadlessPromptAdmissionError = class extends Error {
 	constructor(cause) {
 		super(cause instanceof Error ? cause.message : String(cause), { cause });
 		this.name = PROMPT_ADMISSION_ERROR;
 	}
 };
-const SESSION_SETUP_ERROR = "DoomSessionSetupError";
+const SESSION_SETUP_ERROR = "PoSessionSetupError";
 /**
 * A session cannot start until the user fixes their setup, such as configuring a model.
 *
 * Its message is written for the user and says what to do, so a server returns it as is
 * rather than hiding it behind a generic internal error.
 */
-var DoomSessionSetupError = class extends Error {
+var PoSessionSetupError = class extends Error {
 	constructor(message) {
 		super(message);
 		this.name = SESSION_SETUP_ERROR;
 	}
 };
 /** Error identity must survive independently bundled server and extension graphs. */
-function isDoomSessionSetupError(error) {
+function isPoSessionSetupError(error) {
 	return error instanceof Error && error.name === SESSION_SETUP_ERROR;
 }
 /** Error identity must survive independently bundled server and extension graphs. */
-function isDoomHeadlessPromptAdmissionError(error) {
+function isPoHeadlessPromptAdmissionError(error) {
 	return error instanceof Error && error.name === PROMPT_ADMISSION_ERROR;
 }
-const TOOL_BUSY_ERROR = "DoomHeadlessToolBusyError";
+const TOOL_BUSY_ERROR = "PoHeadlessToolBusyError";
 /** The tool and its hooks have not started. */
-var DoomHeadlessToolBusyError = class extends Error {
+var PoHeadlessToolBusyError = class extends Error {
 	constructor() {
 		super("An operation is already running");
 		this.name = TOOL_BUSY_ERROR;
 	}
 };
-function isDoomHeadlessToolBusyError(error) {
+function isPoHeadlessToolBusyError(error) {
 	return error instanceof Error && error.name === TOOL_BUSY_ERROR;
 }
-function readDoomHeadlessOwner(context) {
-	return context[DOOM_HEADLESS_OWNER];
+function readPoHeadlessOwner(context) {
+	return context[PO_HEADLESS_OWNER];
 }
 /**
 * Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON
 * value, while MCP only accepts an object, so anything else is dropped rather than forwarded.
 */
-function toDoomHeadlessToolResult(result) {
+function toPoHeadlessToolResult(result) {
 	const { structuredContent } = result;
 	return {
 		content: result.content,
@@ -60,38 +60,38 @@ function toDoomHeadlessToolResult(result) {
 	};
 }
 /** Visibility controls model discovery only, never admission for external execution. */
-function isDoomHeadlessToolModelVisible(tool) {
+function isPoHeadlessToolModelVisible(tool) {
 	const visibility = tool._meta?.ui?.visibility;
 	return visibility === void 0 || visibility.includes("model");
 }
-/** Registrations inherit package ownership from the caller's Cordis facet. */
+/** Registrations inherit package ownership from the caller's Cordis fiber. */
 /**
 * The tool a server session loads skills through. When a session carries it, the prompt lists
 * every skill by name and points here, so a skill needs no file the agent could read.
 */
-const DOOM_LOAD_SKILL_TOOL = "load_skill";
-function readDoomHeadlessHost(context) {
-	return context.get(DOOM_HEADLESS_HOST_SERVICE);
+const PO_LOAD_SKILL_TOOL = "load_skill";
+function readPoHeadlessHost(context) {
+	return context.get(PO_HEADLESS_HOST_SERVICE);
 }
-function requireDoomHeadlessHost(context) {
-	const host = readDoomHeadlessHost(context);
-	if (!host) throw new Error("This contribution requires the Doom headless session host.");
+function requirePoHeadlessHost(context) {
+	const host = readPoHeadlessHost(context);
+	if (!host) throw new Error("This contribution requires the Po headless session host.");
 	return host;
 }
 //#endregion
-exports.DOOM_HEADLESS_HOST_SERVICE = DOOM_HEADLESS_HOST_SERVICE;
-exports.DOOM_HEADLESS_OWNER = DOOM_HEADLESS_OWNER;
-exports.DOOM_LOAD_SKILL_TOOL = DOOM_LOAD_SKILL_TOOL;
-exports.DoomHeadlessPromptAdmissionError = DoomHeadlessPromptAdmissionError;
-exports.DoomHeadlessToolBusyError = DoomHeadlessToolBusyError;
-exports.DoomSessionSetupError = DoomSessionSetupError;
-exports.isDoomHeadlessPromptAdmissionError = isDoomHeadlessPromptAdmissionError;
-exports.isDoomHeadlessToolBusyError = isDoomHeadlessToolBusyError;
-exports.isDoomHeadlessToolModelVisible = isDoomHeadlessToolModelVisible;
-exports.isDoomSessionSetupError = isDoomSessionSetupError;
-exports.readDoomHeadlessHost = readDoomHeadlessHost;
-exports.readDoomHeadlessOwner = readDoomHeadlessOwner;
-exports.requireDoomHeadlessHost = requireDoomHeadlessHost;
-exports.toDoomHeadlessToolResult = toDoomHeadlessToolResult;
+exports.PO_HEADLESS_HOST_SERVICE = PO_HEADLESS_HOST_SERVICE;
+exports.PO_HEADLESS_OWNER = PO_HEADLESS_OWNER;
+exports.PO_LOAD_SKILL_TOOL = PO_LOAD_SKILL_TOOL;
+exports.PoHeadlessPromptAdmissionError = PoHeadlessPromptAdmissionError;
+exports.PoHeadlessToolBusyError = PoHeadlessToolBusyError;
+exports.PoSessionSetupError = PoSessionSetupError;
+exports.isPoHeadlessPromptAdmissionError = isPoHeadlessPromptAdmissionError;
+exports.isPoHeadlessToolBusyError = isPoHeadlessToolBusyError;
+exports.isPoHeadlessToolModelVisible = isPoHeadlessToolModelVisible;
+exports.isPoSessionSetupError = isPoSessionSetupError;
+exports.readPoHeadlessHost = readPoHeadlessHost;
+exports.readPoHeadlessOwner = readPoHeadlessOwner;
+exports.requirePoHeadlessHost = requirePoHeadlessHost;
+exports.toPoHeadlessToolResult = toPoHeadlessToolResult;
 
 //# sourceMappingURL=headless.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"headless.cjs","names":[],"sources":["../../../src/schemas/headless.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { CallToolResult, Tool } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\n\nimport type { SessionToolSurface } from '../types/server/sessionToolSurface';\nimport type { DoomSessionContext } from './hubChannel';\nimport type { DoomNotificationRequest } from './notification';\nimport type { DoomServerBundleEntry } from './serverBundle';\n\n/** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */\nexport const DOOM_HEADLESS_HOST_SERVICE = 'doom/headless-host';\nexport const DOOM_HEADLESS_OWNER = Symbol.for('doom/headless-owner');\n\nconst PROMPT_ADMISSION_ERROR = 'DoomHeadlessPromptAdmissionError';\n\n/** Admission is a host boundary, not an advisory facet-hook failure. */\nexport class DoomHeadlessPromptAdmissionError extends Error {\n  constructor(cause: unknown) {\n    super(cause instanceof Error ? cause.message : String(cause), { cause });\n    this.name = PROMPT_ADMISSION_ERROR;\n  }\n}\n\nconst SESSION_SETUP_ERROR = 'DoomSessionSetupError';\n\n/**\n * A session cannot start until the user fixes their setup, such as configuring a model.\n *\n * Its message is written for the user and says what to do, so a server returns it as is\n * rather than hiding it behind a generic internal error.\n */\nexport class DoomSessionSetupError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = SESSION_SETUP_ERROR;\n  }\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isDoomSessionSetupError(error: unknown): error is Error {\n  return error instanceof Error && error.name === SESSION_SETUP_ERROR;\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isDoomHeadlessPromptAdmissionError(error: unknown): boolean {\n  return error instanceof Error && error.name === PROMPT_ADMISSION_ERROR;\n}\nconst TOOL_BUSY_ERROR = 'DoomHeadlessToolBusyError';\n\n/** The tool and its hooks have not started. */\nexport class DoomHeadlessToolBusyError extends Error {\n  constructor() {\n    super('An operation is already running');\n    this.name = TOOL_BUSY_ERROR;\n  }\n}\n\nexport function isDoomHeadlessToolBusyError(error: unknown): boolean {\n  return error instanceof Error && error.name === TOOL_BUSY_ERROR;\n}\n\nexport interface DoomHeadlessSelection {\n  readonly majorMode: string;\n  readonly activeLayers: readonly string[];\n  readonly domains: readonly string[];\n  readonly profile?: string;\n  /** Feature-owned activation sets, keyed by the contributing capability. */\n  readonly state?: Readonly<Record<string, readonly string[]>>;\n}\n\n/** One package-owned selection transition. Server facets change exactly one axis per operation. */\nexport type DoomHeadlessSelectionChange =\n  | { readonly axis: 'majorMode'; readonly majorMode: string }\n  | { readonly axis: 'domains'; readonly domains: readonly string[] }\n  | { readonly axis: 'profile'; readonly profile?: string }\n  | {\n      readonly axis: 'state';\n      readonly key: string;\n      readonly values: readonly string[];\n    };\n\nexport function readDoomHeadlessOwner(context: Context): DoomServerBundleEntry | undefined {\n  return (context as Context & { [DOOM_HEADLESS_OWNER]?: DoomServerBundleEntry })[DOOM_HEADLESS_OWNER];\n}\n\nexport interface DoomHeadlessRegistration {\n  dispose(): void;\n}\n\nexport type DoomHeadlessContent = { type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string };\n\nexport interface DoomHeadlessToolResult {\n  content: DoomHeadlessContent[];\n  /** Public MCP result data. Internal renderer details are not a remote result contract. */\n  structuredContent?: Record<string, unknown>;\n  /** Component-only MCP metadata, never inferred from internal renderer details. */\n  _meta?: CallToolResult['_meta'];\n  details?: unknown;\n  isError?: boolean;\n}\n\n/**\n * Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON\n * value, while MCP only accepts an object, so anything else is dropped rather than forwarded.\n */\nexport function toDoomHeadlessToolResult(result: {\n  readonly content: DoomHeadlessContent[];\n  readonly details?: unknown;\n  readonly structuredContent?: unknown;\n  readonly _meta?: CallToolResult['_meta'];\n  readonly isError?: boolean;\n}): DoomHeadlessToolResult {\n  const { structuredContent } = result;\n  return {\n    content: result.content,\n    details: result.details,\n    ...(result._meta === undefined ? {} : { _meta: result._meta }),\n    ...(typeof structuredContent === 'object' && structuredContent !== null && !Array.isArray(structuredContent)\n      ? { structuredContent: structuredContent as Record<string, unknown> }\n      : {}),\n    ...(result.isError === undefined ? {} : { isError: result.isError }),\n  };\n}\n\nexport interface DoomHeadlessClientRequest {\n  kind: 'confirm' | 'select' | 'input';\n  title: string;\n  message?: string;\n  options?: readonly { label: string; description?: string; value: string }[];\n  initialValue?: string;\n  multiline?: boolean;\n}\n\nexport interface DoomHeadlessClient {\n  /**\n   * Operator-facing surface only: the body is flattened to one line and capped at 4096 characters\n   * by schemas/notification.ts:73-83, and the model never sees it. Use session.admitPrompt to\n   * reach the model.\n   */\n  notify(request: DoomNotificationRequest): void | Promise<void>;\n  request(request: DoomHeadlessClientRequest, signal?: AbortSignal): Promise<unknown>;\n  setStatus(source: string, text: string | undefined): void;\n  appendComposerText?(text: string): void;\n}\n\nexport interface DoomHeadlessModelSettings {\n  model?: { provider: string; id: string };\n  thinkingLevel: ThinkingLevel;\n}\n\nexport interface DoomHeadlessSession {\n  readModelSettings?(): Promise<DoomHeadlessModelSettings>;\n  setFastMode?(enabled: boolean): Promise<void>;\n  setModelSettings?(settings: Partial<DoomHeadlessModelSettings>): Promise<void>;\n  /** Query durable history on demand; hosts do not retain the entire transcript. */\n  entries(query?: {\n    type?: 'custom' | 'message';\n    customType?: string;\n    limit?: number;\n  }): readonly Record<string, unknown>[] | Promise<readonly Record<string, unknown>[]>;\n  appendCustomEntry(type: string, data: unknown): Promise<void>;\n  /** Append a displayable informational message to history and model context, without admitting input or starting a turn. */\n  appendMessage?(message: { type: string; text: string; display?: boolean; details?: unknown }): Promise<string | void>;\n  /**\n   * Admit one custom message without awaiting its turn, using environmental input policy.\n   * Defaults to followUp. Reusing requestId deduplicates normal Durable admission retries;\n   * locked-agent appends and deferred operator admission do not provide that guarantee.\n   */\n  admitMessage?(\n    message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    },\n    delivery?: 'steer' | 'followUp',\n    requestId?: string,\n  ): Promise<void>;\n  /** Register a checkpoint flush before the next tool-turn request. Idle writes return undefined instead of queueing when busy. */\n  registerCheckpointBoundary?(\n    callback: (boundary: {\n      signal?: AbortSignal;\n      appendMessage(message: {\n        type: string;\n        text: string;\n        display?: boolean;\n        details?: unknown;\n      }): Promise<string | undefined>;\n    }) => Promise<void>,\n  ): {\n    appendMessage(message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    }): Promise<string | undefined>;\n    dispose(): void;\n  };\n  /** Detached canonical model context before facet transformations, with context edits applied and no system message. */\n  contextMessages?(): Promise<readonly Record<string, unknown>[]>;\n  /** The latest measured assistant usage and the selected model's context window. */\n  contextUsage?(): Promise<{ tokens: number | null; contextWindow: number } | undefined>;\n  /** Label a durable entry without admitting input or starting a turn. */\n  setLabel?(entryId: string, label: string | undefined): Promise<void>;\n  /**\n   * Delivers operator input through prompt preflight and awaits its turn.\n   * Environmental input uses admitPrompt with origin omitted instead.\n   * An idle agent is woken; busy delivery uses Durable steering or follow-up.\n   */\n  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /**\n   * Admits input without awaiting its turn. Environmental input omits origin and never\n   * changes the operator queue. Operator origin uses prompt preflight, including voice\n   * capture; 'interrupt' cancels the active run and admits operator input while preserving\n   * retained queued work. Environmental callers may reuse requestId when retrying the same input.\n   */\n  admitPrompt?(\n    text: string,\n    delivery?: 'prompt' | 'steer' | 'followUp' | 'interrupt',\n    origin?: 'operator',\n    requestId?: string,\n  ): Promise<void>;\n  abort(): Promise<void>;\n  compact(instructions?: string): Promise<void>;\n  activity(): Promise<{ hasPendingMessages: boolean; isIdle: boolean }>;\n  /** Renames the durable session and publishes the updated title to presentation clients. */\n  setName?(name: string): Promise<void>;\n  /** Capture the current persisted branch for an in-process child fork. */\n  forkSource?(): Promise<{\n    kind: 'v4-fork';\n    sessionFile: string;\n    branch: string;\n    entryId?: string;\n  }>;\n}\n\n/** A grant-filtered skill view available only during one remote MCP tool invocation. */\nexport interface DoomMcpSkillAccess {\n  list(): Promise<readonly { name: string; description: string }[]>;\n  read(name: string): Promise<string>;\n}\n\n/** A stateless auxiliary request. These tools are private to this request, never registered on the agent. */\nexport interface DoomHeadlessToolCompletionRequest {\n  systemPrompt: string;\n  input: string;\n  maxTokens: number;\n  cacheRetention?: 'none' | 'short' | 'long';\n  signal?: AbortSignal;\n  tools: readonly Pick<DoomHeadlessTool, 'name' | 'description' | 'parameters'>[];\n}\n\nexport interface DoomHeadlessToolCompletionResult {\n  toolCalls: readonly { id: string; name: string; arguments: unknown }[];\n  usage: { totalTokens: number };\n}\n\n/** Credential-free catalog metadata. Facets cannot obtain auth, headers, or a mutable registry. */\nexport interface DoomHeadlessModelMetadata {\n  readonly provider: string;\n  readonly id: string;\n  readonly api?: string;\n  readonly baseUrl?: string;\n  readonly name?: string;\n  readonly compat?: Readonly<Record<string, boolean | string>>;\n}\n\nexport interface DoomHeadlessExecutionContext {\n  readonly cwd: string;\n  /** The checkout the session runs in, distinct from the tool execution directory. */\n  readonly repoRoot: string;\n  readonly sessionId: string;\n  /** The session's baseline context, when its host knows its workspace. */\n  readonly sessionContext?: DoomSessionContext;\n  /** Immutable session configuration. Facets must not read or mutate process.env. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  readonly client: DoomHeadlessClient;\n  readonly session: DoomHeadlessSession;\n  readonly model?: DoomHeadlessModelMetadata;\n  /** Lookup in this session's catalog, including physical models named by finalized messages. */\n  readonly getModel?: (provider: string, id: string) => DoomHeadlessModelMetadata | undefined;\n  /** Detached credential-free authenticated chat catalog snapshot, without refreshing providers. */\n  readonly getAvailableModels?: () => readonly {\n    readonly provider: string;\n    readonly id: string;\n  }[];\n  /** Operation cancellation, supplied only for an active invocation. */\n  readonly signal?: AbortSignal;\n  readonly textCompletion?: {\n    available(reference: string): boolean;\n    /** Tool-less conversation summary through the host's guarded session provider. */\n    summarize?(\n      reference: string,\n      request: {\n        messages: readonly Record<string, unknown>[];\n        instructions: string;\n        previousSummary?: string;\n        thinkingLevel?: ThinkingLevel;\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n    complete(\n      reference: string,\n      request: {\n        systemPrompt: string;\n        input: string;\n        maxTokens: number;\n        cacheRetention?: 'none' | 'short' | 'long';\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n  };\n  readonly toolCompletion?: {\n    complete(reference: string, request: DoomHeadlessToolCompletionRequest): Promise<DoomHeadlessToolCompletionResult>;\n  };\n  /** Guarded image operation. Credentials and transport configuration remain host-owned. */\n  readonly imageGeneration?: {\n    available(): boolean;\n    generate(request: {\n      prompt: string;\n      transparentBackground?: boolean;\n      images?: readonly { data: string; mimeType: string }[];\n      correlationId: string;\n      signal?: AbortSignal;\n    }): Promise<{ data: string; mimeType: 'image/png'; requestId?: string; generationId?: string }>;\n  };\n  /**\n   * Guarded web search. Credentials, endpoint, model choice, session identity and transport remain host-owned.\n   * `commands` follows a schema owned by the calling package; the host only bounds it.\n   */\n  readonly webSearch?: {\n    available(): boolean;\n    search(request: {\n      commands: Readonly<Record<string, unknown>>;\n      /** Optional plain-text excerpt, oldest first. Omit to send no conversation content. */\n      conversation?: readonly { role: 'user' | 'assistant'; text: string }[];\n      access: 'cached' | 'indexed' | 'live';\n      signal?: AbortSignal;\n    }): Promise<{ output: string; results?: readonly Record<string, unknown>[] }>;\n  };\n  readonly selection: DoomHeadlessSelection;\n  /** Present only while an authenticated remote MCP tool is running. */\n  readonly mcpSkills?: DoomMcpSkillAccess;\n  shutdown(): void;\n}\n\n/** Conditions narrow an eligible owner's contributions; they can never restore a disabled owner. */\nexport interface DoomHeadlessCondition {\n  state?: Readonly<Record<string, string>>;\n  attribution?: { kind: 'minor' | 'domain'; mode: string; label?: string };\n  domain?: string;\n}\n\nexport interface DoomHeadlessToolRestriction {\n  when?: DoomHeadlessCondition;\n  /** Optional capability ceiling. An empty list disables every tool. */\n  allowedTools?: readonly string[];\n  /**\n   * Narrow exclusions without disabling unrelated tools. Exclude a tool your package owns, or a\n   * specific foreign tool the mode exists to withdraw. Never enumerate an allowlist here.\n   */\n  excludedTools?: readonly string[];\n}\n\nexport interface DoomHeadlessTool<TParameters extends TSchema = TSchema> {\n  when?: DoomHeadlessCondition;\n  name: string;\n  label?: string;\n  description: string;\n  parameters: TParameters;\n  annotations?: Tool['annotations'];\n  outputSchema?: Tool['outputSchema'];\n  /** Remote presentation only. Component tool access must be explicitly opted into. */\n  _meta?: Tool['_meta'] & {\n    ui?: { resourceUri?: string; visibility?: ('model' | 'app')[] };\n  };\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  executionMode?: 'parallel' | 'serial';\n  execute(\n    toolCallId: string,\n    parameters: Static<TParameters>,\n    signal: AbortSignal | undefined,\n    onUpdate: ((result: DoomHeadlessToolResult) => void) | undefined,\n    context: DoomHeadlessExecutionContext,\n  ): Promise<DoomHeadlessToolResult>;\n}\n\n/**\n * One package contribution to the session's resource surface.\n *\n * `kind` decides what the model is billed for, and the difference is large:\n * - `context` is EAGER. `read()` runs on every prompt build and the text is pasted\n *   into the system prompt verbatim. Reserve it for small live session state that\n *   exists nowhere on disk. Never use it for a file the package ships: a README\n *   registered this way costs its full length on every single turn.\n * - `skill` is LAZY. Only `name`, `description` and `path` reach the prompt; the\n *   agent reads the file itself when the description matches the task.\n * - `prompt` is inert until the user invokes it by name.\n *\n * The rule in one line: if it is a file the package ships, it is a `skill`.\n */\nexport interface DoomHeadlessResource {\n  when?: DoomHeadlessCondition;\n  name: string;\n  /** Model-visible selection signal. A `skill` without one tells the agent nothing. */\n  description?: string;\n  /** Absolute path of the file `read()` returns, so an advertised skill is one the agent can open. */\n  path?: string;\n  kind: 'prompt' | 'skill' | 'context';\n  read(context: DoomHeadlessExecutionContext): string | Promise<string>;\n}\n\nexport interface DoomHeadlessCommand {\n  when?: DoomHeadlessCondition;\n  name: string;\n  description: string;\n  /** Selection-only control allowed after a coherent selection fails admission. */\n  selectionRecovery?: boolean;\n  execute(args: string, context: DoomHeadlessExecutionContext): void | Promise<void>;\n}\n\nexport type DoomHeadlessEventName =\n  | 'session_start'\n  | 'session_shutdown'\n  | 'session_tree'\n  | 'before_agent_start'\n  | 'agent_start'\n  | 'agent_end'\n  | 'agent_settled'\n  | 'turn_start'\n  | 'turn_end'\n  | 'context'\n  | 'before_provider_request'\n  | 'message_start'\n  | 'message_update'\n  | 'message_end'\n  | 'tool_call'\n  | 'tool_execution_start'\n  | 'tool_execution_update'\n  | 'tool_execution_end'\n  | 'tool_result'\n  | 'model_select'\n  | 'session_before_compact'\n  | 'session_compact';\n\nexport type DoomHeadlessHookEvent<E extends DoomHeadlessEventName> = E extends 'before_provider_request'\n  ? {\n      lane: string;\n      runId: string;\n      model: { provider: string; id: string; api?: string };\n      payload: unknown;\n    }\n  : E extends 'session_before_compact'\n    ? {\n        reason: string;\n        preparation: unknown;\n        instructions?: string;\n        customInstructions?: string;\n      }\n    : E extends 'model_select'\n      ? { model: { provider: string; id: string } }\n      : Readonly<Record<string, unknown>>;\n\nexport interface DoomHeadlessCompactionResult {\n  summary: string;\n  tokensBefore: number;\n  retainedTail: Record<string, unknown>[];\n  usage?: Record<string, unknown>;\n  details?: unknown;\n}\n\nexport type DoomHeadlessHookResult<E extends DoomHeadlessEventName> = E extends 'before_provider_request'\n  ? { payload: unknown } | void\n  : E extends 'session_before_compact'\n    ? {\n        cancel?: boolean;\n        decline?: boolean;\n        compaction?: DoomHeadlessCompactionResult;\n      } | void\n    : E extends 'context'\n      ? { messages?: unknown[]; systemPrompt?: string } | void\n      : E extends 'before_agent_start'\n        ? { systemPrompt?: string } | void\n        : E extends 'tool_call'\n          ? {\n              args?: Record<string, unknown>;\n              block?: { reason: string; terminate?: boolean };\n            } | void\n          : E extends 'tool_result'\n            ? {\n                content?: DoomHeadlessContent[];\n                details?: unknown;\n                isError?: boolean;\n                usage?: Record<string, unknown>;\n                terminate?: boolean;\n              } | void\n            : unknown;\n\nexport type DoomHeadlessHook<E extends DoomHeadlessEventName = DoomHeadlessEventName> = E extends DoomHeadlessEventName\n  ? {\n      when?: DoomHeadlessCondition;\n      event: E;\n      handle(\n        event: Readonly<DoomHeadlessHookEvent<E>>,\n        context: DoomHeadlessExecutionContext,\n      ): DoomHeadlessHookResult<E> | Promise<DoomHeadlessHookResult<E>>;\n    }\n  : never;\n\n/** A retained facet can register activity without starting disabled watchers or services. */\nexport interface DoomHeadlessActivity {\n  when?: DoomHeadlessCondition;\n  name: string;\n  start(context: DoomHeadlessExecutionContext): (() => void | Promise<void>) | Promise<() => void | Promise<void>>;\n}\n\n/** Read-only metadata for the currently applied session, never executable declarations or resource bodies. */\nexport interface DoomHeadlessCapability {\n  readonly source: string;\n  readonly name: string;\n  readonly kind: 'tool' | 'skill';\n  readonly when?: DoomHeadlessCondition;\n  readonly active: boolean;\n  readonly discoverable: boolean;\n  readonly reason?: 'inactive' | 'restricted' | 'shadowed' | 'unavailable' | 'not-discoverable';\n}\n\n/** Visibility controls model discovery only, never admission for external execution. */\nexport function isDoomHeadlessToolModelVisible(tool: Pick<DoomHeadlessTool, '_meta'>): boolean {\n  const visibility = tool._meta?.ui?.visibility;\n  return visibility === undefined || visibility.includes('model');\n}\n\nexport interface DoomHeadlessCapabilitySnapshot {\n  readonly revision: number;\n  readonly ready: boolean;\n  readonly capabilities: readonly DoomHeadlessCapability[];\n}\n\n/** Registrations inherit package ownership from the caller's Cordis facet. */\n/**\n * The tool a server session loads skills through. When a session carries it, the prompt lists\n * every skill by name and points here, so a skill needs no file the agent could read.\n */\nexport const DOOM_LOAD_SKILL_TOOL = 'load_skill';\n\nexport interface DoomHeadlessHostService {\n  readonly context: DoomHeadlessExecutionContext;\n  /** Admitted external execution, sharing native hooks, restrictions and session lifetime. */\n  readonly toolSurface?: Pick<SessionToolSurface, 'readSurface' | 'invokeTool'>;\n  /** The instructions of an applied skill by exact name, or undefined when none is applied. */\n  readSkill(name: string): string | undefined;\n  changeSelection(change: DoomHeadlessSelectionChange): Promise<void>;\n  assertActive(source?: string): void;\n  subscribeSelection(listener: (selection: DoomHeadlessSelection) => void | Promise<void>): () => void;\n  /** Inspect only a coherently applied generation. A transition returns ready=false and no partial inventory. */\n  inspectCapabilities(): DoomHeadlessCapabilitySnapshot;\n  registerToolRestriction(restriction: DoomHeadlessToolRestriction): DoomHeadlessRegistration;\n  registerTool<TParameters extends TSchema>(tool: DoomHeadlessTool<TParameters>): DoomHeadlessRegistration;\n  registerResource(resource: DoomHeadlessResource): DoomHeadlessRegistration;\n  registerCommand(command: DoomHeadlessCommand): DoomHeadlessRegistration;\n  registerHook(hook: DoomHeadlessHook): DoomHeadlessRegistration;\n  registerActivity(activity: DoomHeadlessActivity): DoomHeadlessRegistration;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'doom/headless-host': DoomHeadlessHostService;\n  }\n}\n\nexport function readDoomHeadlessHost(context: Context): DoomHeadlessHostService | undefined {\n  return context.get(DOOM_HEADLESS_HOST_SERVICE) as DoomHeadlessHostService | undefined;\n}\n\nexport function requireDoomHeadlessHost(context: Context): DoomHeadlessHostService {\n  const host = readDoomHeadlessHost(context);\n  if (!host) throw new Error('This contribution requires the Doom headless session host.');\n  return host;\n}\n"],"mappings":";;AAWA,MAAa,6BAA6B;AAC1C,MAAa,sBAAsB,OAAO,IAAI,qBAAqB;AAEnE,MAAM,yBAAyB;;AAG/B,IAAa,mCAAb,cAAsD,MAAM;CAC1D,YAAY,OAAgB;EAC1B,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EAAE,MAAM,CAAC;EACvE,KAAK,OAAO;CACd;AACF;AAEA,MAAM,sBAAsB;;;;;;;AAQ5B,IAAa,wBAAb,cAA2C,MAAM;CAC/C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,wBAAwB,OAAgC;CACtE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;;AAGA,SAAgB,mCAAmC,OAAyB;CAC1E,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AACA,MAAM,kBAAkB;;AAGxB,IAAa,4BAAb,cAA+C,MAAM;CACnD,cAAc;EACZ,MAAM,iCAAiC;EACvC,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,4BAA4B,OAAyB;CACnE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AAsBA,SAAgB,sBAAsB,SAAqD;CACzF,OAAQ,QAAwE;AAClF;;;;;AAsBA,SAAgB,yBAAyB,QAMd;CACzB,MAAM,EAAE,sBAAsB;CAC9B,OAAO;EACL,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,GAAI,OAAO,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,OAAO,MAAM;EAC5D,GAAI,OAAO,sBAAsB,YAAY,sBAAsB,QAAQ,CAAC,MAAM,QAAQ,iBAAiB,IACvG,EAAqB,kBAA6C,IAClE,CAAC;EACL,GAAI,OAAO,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,OAAO,QAAQ;CACpE;AACF;;AAuZA,SAAgB,+BAA+B,MAAgD;CAC7F,MAAM,aAAa,KAAK,OAAO,IAAI;CACnC,OAAO,eAAe,KAAA,KAAa,WAAW,SAAS,OAAO;AAChE;;;;;;AAaA,MAAa,uBAAuB;AA2BpC,SAAgB,qBAAqB,SAAuD;CAC1F,OAAO,QAAQ,IAAI,0BAA0B;AAC/C;AAEA,SAAgB,wBAAwB,SAA2C;CACjF,MAAM,OAAO,qBAAqB,OAAO;CACzC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,4DAA4D;CACvF,OAAO;AACT"}
+{"version":3,"file":"headless.cjs","names":[],"sources":["../../../src/schemas/headless.ts"],"sourcesContent":["import type { Context } from '@deepseek-ai/cordis';\nimport type { ThinkingLevel } from '@earendil-works/pi-agent-core';\nimport type { CallToolResult, Tool } from '@modelcontextprotocol/server';\nimport type { Static, TSchema } from 'typebox';\n\nimport type { SessionToolSurface } from '../types/server/sessionToolSurface';\nimport type { PoSessionContext } from './hubChannel';\nimport type { PoNotificationRequest } from './notification';\nimport type { PoServerBundleEntry } from './serverBundle';\n\n/** Session-only contributions. This is not a Pi ExtensionAPI or a TUI adapter. */\nexport const PO_HEADLESS_HOST_SERVICE = 'po/headless-host';\nexport const PO_HEADLESS_OWNER = Symbol.for('po/headless-owner');\n\nconst PROMPT_ADMISSION_ERROR = 'PoHeadlessPromptAdmissionError';\n\n/** Admission is a host boundary, not an advisory package-hook failure. */\nexport class PoHeadlessPromptAdmissionError extends Error {\n  constructor(cause: unknown) {\n    super(cause instanceof Error ? cause.message : String(cause), { cause });\n    this.name = PROMPT_ADMISSION_ERROR;\n  }\n}\n\nconst SESSION_SETUP_ERROR = 'PoSessionSetupError';\n\n/**\n * A session cannot start until the user fixes their setup, such as configuring a model.\n *\n * Its message is written for the user and says what to do, so a server returns it as is\n * rather than hiding it behind a generic internal error.\n */\nexport class PoSessionSetupError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = SESSION_SETUP_ERROR;\n  }\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isPoSessionSetupError(error: unknown): error is Error {\n  return error instanceof Error && error.name === SESSION_SETUP_ERROR;\n}\n\n/** Error identity must survive independently bundled server and extension graphs. */\nexport function isPoHeadlessPromptAdmissionError(error: unknown): boolean {\n  return error instanceof Error && error.name === PROMPT_ADMISSION_ERROR;\n}\nconst TOOL_BUSY_ERROR = 'PoHeadlessToolBusyError';\n\n/** The tool and its hooks have not started. */\nexport class PoHeadlessToolBusyError extends Error {\n  constructor() {\n    super('An operation is already running');\n    this.name = TOOL_BUSY_ERROR;\n  }\n}\n\nexport function isPoHeadlessToolBusyError(error: unknown): boolean {\n  return error instanceof Error && error.name === TOOL_BUSY_ERROR;\n}\n\nexport interface PoHeadlessSelection {\n  readonly majorMode: string;\n  readonly activeLayers: readonly string[];\n  readonly domains: readonly string[];\n  readonly profile?: string;\n  /** Feature-owned activation sets, keyed by the contributing capability. */\n  readonly state?: Readonly<Record<string, readonly string[]>>;\n}\n\n/** One package-owned selection transition. Server packages change exactly one axis per operation. */\nexport type PoHeadlessSelectionChange =\n  | { readonly axis: 'majorMode'; readonly majorMode: string }\n  | { readonly axis: 'domains'; readonly domains: readonly string[] }\n  | { readonly axis: 'profile'; readonly profile?: string }\n  | {\n      readonly axis: 'state';\n      readonly key: string;\n      readonly values: readonly string[];\n    };\n\nexport function readPoHeadlessOwner(context: Context): PoServerBundleEntry | undefined {\n  return (context as Context & { [PO_HEADLESS_OWNER]?: PoServerBundleEntry })[PO_HEADLESS_OWNER];\n}\n\nexport interface PoHeadlessRegistration {\n  dispose(): void;\n}\n\nexport type PoHeadlessContent = { type: 'text'; text: string } | { type: 'image'; data: string; mimeType: string };\n\nexport interface PoHeadlessToolResult {\n  content: PoHeadlessContent[];\n  /** Public MCP result data. Internal renderer details are not a remote result contract. */\n  structuredContent?: Record<string, unknown>;\n  /** Component-only MCP metadata, never inferred from internal renderer details. */\n  _meta?: CallToolResult['_meta'];\n  details?: unknown;\n  isError?: boolean;\n}\n\n/**\n * Narrows a Pi tool result to the headless contract. Pi types `structuredContent` as any JSON\n * value, while MCP only accepts an object, so anything else is dropped rather than forwarded.\n */\nexport function toPoHeadlessToolResult(result: {\n  readonly content: PoHeadlessContent[];\n  readonly details?: unknown;\n  readonly structuredContent?: unknown;\n  readonly _meta?: CallToolResult['_meta'];\n  readonly isError?: boolean;\n}): PoHeadlessToolResult {\n  const { structuredContent } = result;\n  return {\n    content: result.content,\n    details: result.details,\n    ...(result._meta === undefined ? {} : { _meta: result._meta }),\n    ...(typeof structuredContent === 'object' && structuredContent !== null && !Array.isArray(structuredContent)\n      ? { structuredContent: structuredContent as Record<string, unknown> }\n      : {}),\n    ...(result.isError === undefined ? {} : { isError: result.isError }),\n  };\n}\n\nexport interface PoHeadlessClientRequest {\n  kind: 'confirm' | 'select' | 'input';\n  title: string;\n  message?: string;\n  options?: readonly { label: string; description?: string; value: string }[];\n  initialValue?: string;\n  multiline?: boolean;\n}\n\nexport interface PoHeadlessClient {\n  /**\n   * Operator-facing surface only: the body is flattened to one line and capped at 4096 characters\n   * by schemas/notification.ts:73-83, and the model never sees it. Use session.admitPrompt to\n   * reach the model.\n   */\n  notify(request: PoNotificationRequest): void | Promise<void>;\n  request(request: PoHeadlessClientRequest, signal?: AbortSignal): Promise<unknown>;\n  /** Ignored once the session has closed, so a package can clear its status while it unwinds. */\n  setStatus(source: string, text: string | undefined): void;\n  appendComposerText?(text: string): void;\n}\n\nexport interface PoHeadlessModelSettings {\n  model?: { provider: string; id: string };\n  thinkingLevel: ThinkingLevel;\n}\n\nexport interface PoHeadlessSession {\n  readModelSettings?(): Promise<PoHeadlessModelSettings>;\n  setFastMode?(enabled: boolean): Promise<void>;\n  setModelSettings?(settings: Partial<PoHeadlessModelSettings>): Promise<void>;\n  /** Query durable history on demand; hosts do not retain the entire transcript. */\n  entries(query?: {\n    type?: 'custom' | 'message';\n    customType?: string;\n    limit?: number;\n  }): readonly Record<string, unknown>[] | Promise<readonly Record<string, unknown>[]>;\n  appendCustomEntry(type: string, data: unknown): Promise<void>;\n  /** Append a displayable informational message to history and model context, without admitting input or starting a turn. */\n  appendMessage?(message: { type: string; text: string; display?: boolean; details?: unknown }): Promise<string | void>;\n  /**\n   * Admit one custom message without awaiting its turn, using environmental input policy.\n   * Defaults to followUp. Reusing requestId deduplicates normal Durable admission retries;\n   * locked-agent appends and deferred operator admission do not provide that guarantee.\n   */\n  admitMessage?(\n    message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    },\n    delivery?: 'steer' | 'followUp',\n    requestId?: string,\n  ): Promise<void>;\n  /** Register a checkpoint flush before the next tool-turn request. Idle writes return undefined instead of queueing when busy. */\n  registerCheckpointBoundary?(\n    callback: (boundary: {\n      signal?: AbortSignal;\n      appendMessage(message: {\n        type: string;\n        text: string;\n        display?: boolean;\n        details?: unknown;\n      }): Promise<string | undefined>;\n    }) => Promise<void>,\n  ): {\n    appendMessage(message: {\n      type: string;\n      text: string;\n      display?: boolean;\n      details?: unknown;\n    }): Promise<string | undefined>;\n    dispose(): void;\n  };\n  /** Detached canonical model context before package transformations, with context edits applied and no system message. */\n  contextMessages?(): Promise<readonly Record<string, unknown>[]>;\n  /** The latest measured assistant usage and the selected model's context window. */\n  contextUsage?(): Promise<{ tokens: number | null; contextWindow: number } | undefined>;\n  /** Label a durable entry without admitting input or starting a turn. */\n  setLabel?(entryId: string, label: string | undefined): Promise<void>;\n  /**\n   * Delivers operator input through prompt preflight and awaits its turn.\n   * Environmental input uses admitPrompt with origin omitted instead.\n   * An idle agent is woken; busy delivery uses Durable steering or follow-up.\n   */\n  prompt(text: string, delivery?: 'prompt' | 'steer' | 'followUp'): Promise<void>;\n  /**\n   * Admits input without awaiting its turn. Environmental input omits origin and never\n   * changes the operator queue. Operator origin uses prompt preflight, including voice\n   * capture; 'interrupt' cancels the active run and admits operator input while preserving\n   * retained queued work. Environmental callers may reuse requestId when retrying the same input.\n   */\n  admitPrompt?(\n    text: string,\n    delivery?: 'prompt' | 'steer' | 'followUp' | 'interrupt',\n    origin?: 'operator',\n    requestId?: string,\n  ): Promise<void>;\n  abort(): Promise<void>;\n  compact(instructions?: string): Promise<void>;\n  activity(): Promise<{ hasPendingMessages: boolean; isIdle: boolean }>;\n  /** Renames the durable session and publishes the updated title to presentation clients. */\n  setName?(name: string): Promise<void>;\n  /** The current branch's newest entry, for a child that starts from this session's history. */\n  forkSource?(): Promise<{\n    kind: 'fork';\n    entryId?: string;\n  }>;\n}\n\n/** A grant-filtered skill view available only during one remote MCP tool invocation. */\nexport interface PoMcpSkillAccess {\n  list(): Promise<readonly { name: string; description: string }[]>;\n  read(name: string): Promise<string>;\n}\n\n/** A stateless auxiliary request. These tools are private to this request, never registered on the agent. */\nexport interface PoHeadlessToolCompletionRequest {\n  systemPrompt: string;\n  input: string;\n  maxTokens: number;\n  cacheRetention?: 'none' | 'short' | 'long';\n  signal?: AbortSignal;\n  tools: readonly Pick<PoHeadlessTool, 'name' | 'description' | 'parameters'>[];\n}\n\nexport interface PoHeadlessToolCompletionResult {\n  toolCalls: readonly { id: string; name: string; arguments: unknown }[];\n  usage: { totalTokens: number };\n}\n\n/** Credential-free catalog metadata. Packages cannot obtain auth, headers, or a mutable registry. */\nexport interface PoHeadlessModelMetadata {\n  readonly provider: string;\n  readonly id: string;\n  readonly api?: string;\n  readonly baseUrl?: string;\n  readonly name?: string;\n  readonly compat?: Readonly<Record<string, boolean | string>>;\n}\n\nexport interface PoHeadlessExecutionContext {\n  readonly cwd: string;\n  /** The checkout the session runs in, distinct from the tool execution directory. */\n  readonly repoRoot: string;\n  readonly sessionId: string;\n  /** The session's baseline context, when its host knows its workspace. */\n  readonly sessionContext?: PoSessionContext;\n  /** Immutable session configuration. Packages must not read or mutate process.env. */\n  readonly environment: Readonly<Record<string, string | undefined>>;\n  readonly client: PoHeadlessClient;\n  readonly session: PoHeadlessSession;\n  readonly model?: PoHeadlessModelMetadata;\n  /** Lookup in this session's catalog, including physical models named by finalized messages. */\n  readonly getModel?: (provider: string, id: string) => PoHeadlessModelMetadata | undefined;\n  /** Detached credential-free authenticated chat catalog, read after refreshing provider availability. */\n  readonly getAvailableModels?: () => Promise<\n    readonly {\n      readonly provider: string;\n      readonly id: string;\n    }[]\n  >;\n  /** Operation cancellation, supplied only for an active invocation. */\n  readonly signal?: AbortSignal;\n  readonly textCompletion?: {\n    available(reference: string): boolean;\n    /** Tool-less conversation summary through the host's guarded session provider. */\n    summarize?(\n      reference: string,\n      request: {\n        messages: readonly Record<string, unknown>[];\n        instructions: string;\n        previousSummary?: string;\n        thinkingLevel?: ThinkingLevel;\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n    complete(\n      reference: string,\n      request: {\n        systemPrompt: string;\n        input: string;\n        maxTokens: number;\n        cacheRetention?: 'none' | 'short' | 'long';\n        signal?: AbortSignal;\n      },\n    ): Promise<string>;\n  };\n  readonly toolCompletion?: {\n    complete(reference: string, request: PoHeadlessToolCompletionRequest): Promise<PoHeadlessToolCompletionResult>;\n  };\n  /** Guarded image operation. Credentials and transport configuration remain host-owned. */\n  readonly imageGeneration?: {\n    available(): boolean;\n    generate(request: {\n      prompt: string;\n      transparentBackground?: boolean;\n      images?: readonly { data: string; mimeType: string }[];\n      correlationId: string;\n      signal?: AbortSignal;\n    }): Promise<{ data: string; mimeType: 'image/png'; requestId?: string; generationId?: string }>;\n  };\n  /**\n   * Guarded web search. Credentials, endpoint, model choice, session identity and transport remain host-owned.\n   * `commands` follows a schema owned by the calling package; the host only bounds it.\n   */\n  readonly webSearch?: {\n    available(): boolean;\n    search(request: {\n      commands: Readonly<Record<string, unknown>>;\n      /** Optional plain-text excerpt, oldest first. Omit to send no conversation content. */\n      conversation?: readonly { role: 'user' | 'assistant'; text: string }[];\n      access: 'cached' | 'indexed' | 'live';\n      signal?: AbortSignal;\n    }): Promise<{ output: string; results?: readonly Record<string, unknown>[] }>;\n  };\n  readonly selection: PoHeadlessSelection;\n  /** Present only while an authenticated remote MCP tool is running. */\n  readonly mcpSkills?: PoMcpSkillAccess;\n  shutdown(): void;\n}\n\n/** Conditions narrow an eligible owner's contributions; they can never restore a disabled owner. */\nexport interface PoHeadlessCondition {\n  state?: Readonly<Record<string, string>>;\n  attribution?: { kind: 'minor' | 'domain'; mode: string; label?: string };\n  domain?: string;\n}\n\nexport interface PoHeadlessToolRestriction {\n  when?: PoHeadlessCondition;\n  /** Optional capability ceiling. An empty list disables every tool. */\n  allowedTools?: readonly string[];\n  /**\n   * Narrow exclusions without disabling unrelated tools. Exclude a tool your package owns, or a\n   * specific foreign tool the mode exists to withdraw. Never enumerate an allowlist here.\n   */\n  excludedTools?: readonly string[];\n}\n\nexport interface PoHeadlessTool<TParameters extends TSchema = TSchema> {\n  when?: PoHeadlessCondition;\n  name: string;\n  label?: string;\n  description: string;\n  parameters: TParameters;\n  annotations?: Tool['annotations'];\n  outputSchema?: Tool['outputSchema'];\n  /** Remote presentation only. Component tool access must be explicitly opted into. */\n  _meta?: Tool['_meta'] & {\n    ui?: { resourceUri?: string; visibility?: ('model' | 'app')[] };\n  };\n  promptSnippet?: string;\n  promptGuidelines?: readonly string[];\n  executionMode?: 'parallel' | 'serial';\n  execute(\n    toolCallId: string,\n    parameters: Static<TParameters>,\n    signal: AbortSignal | undefined,\n    onUpdate: ((result: PoHeadlessToolResult) => void) | undefined,\n    context: PoHeadlessExecutionContext,\n  ): Promise<PoHeadlessToolResult>;\n}\n\n/**\n * One package contribution to the session's resource surface.\n *\n * `kind` decides what the model is billed for, and the difference is large:\n * - `context` is EAGER. `read()` runs on every prompt build and the text is pasted\n *   into the system prompt verbatim. Reserve it for small live session state that\n *   exists nowhere on disk. Never use it for a file the package ships: a README\n *   registered this way costs its full length on every single turn.\n * - `skill` is LAZY. Only `name`, `description` and `path` reach the prompt; the\n *   agent reads the file itself when the description matches the task.\n * - `prompt` is inert until the user invokes it by name.\n *\n * The rule in one line: if it is a file the package ships, it is a `skill`.\n */\nexport interface PoHeadlessResource {\n  when?: PoHeadlessCondition;\n  name: string;\n  /** Model-visible selection signal. A `skill` without one tells the agent nothing. */\n  description?: string;\n  /** Absolute path of the file `read()` returns, so an advertised skill is one the agent can open. */\n  path?: string;\n  kind: 'prompt' | 'skill' | 'context';\n  read(context: PoHeadlessExecutionContext): string | Promise<string>;\n}\n\nexport interface PoHeadlessCommand {\n  when?: PoHeadlessCondition;\n  name: string;\n  description: string;\n  /** Selection-only control allowed after a coherent selection fails admission. */\n  selectionRecovery?: boolean;\n  execute(args: string, context: PoHeadlessExecutionContext): void | Promise<void>;\n}\n\nexport type PoHeadlessEventName =\n  | 'session_start'\n  | 'session_shutdown'\n  | 'session_tree'\n  | 'before_agent_start'\n  | 'agent_start'\n  | 'agent_end'\n  | 'agent_settled'\n  | 'turn_start'\n  | 'turn_end'\n  | 'context'\n  | 'before_provider_request'\n  | 'message_start'\n  | 'message_update'\n  | 'message_end'\n  | 'tool_call'\n  | 'tool_execution_start'\n  | 'tool_execution_update'\n  | 'tool_execution_end'\n  | 'tool_result'\n  | 'model_select'\n  | 'session_before_compact'\n  | 'session_compact';\n\nexport type PoHeadlessHookEvent<E extends PoHeadlessEventName> = E extends 'before_provider_request'\n  ? {\n      lane: string;\n      runId: string;\n      model: { provider: string; id: string; api?: string };\n      payload: unknown;\n    }\n  : E extends 'session_before_compact'\n    ? {\n        reason: string;\n        preparation: unknown;\n        instructions?: string;\n        customInstructions?: string;\n      }\n    : E extends 'model_select'\n      ? { model: { provider: string; id: string } }\n      : Readonly<Record<string, unknown>>;\n\nexport interface PoHeadlessCompactionResult {\n  summary: string;\n  tokensBefore: number;\n  retainedTail: Record<string, unknown>[];\n  usage?: Record<string, unknown>;\n  details?: unknown;\n}\n\nexport type PoHeadlessHookResult<E extends PoHeadlessEventName> = E extends 'before_provider_request'\n  ? { payload: unknown } | void\n  : E extends 'session_before_compact'\n    ? {\n        cancel?: boolean;\n        decline?: boolean;\n        compaction?: PoHeadlessCompactionResult;\n      } | void\n    : E extends 'context'\n      ? { messages?: unknown[]; systemPrompt?: string } | void\n      : E extends 'before_agent_start'\n        ? { systemPrompt?: string } | void\n        : E extends 'tool_call'\n          ? {\n              args?: Record<string, unknown>;\n              block?: { reason: string; terminate?: boolean };\n            } | void\n          : E extends 'tool_result'\n            ? {\n                content?: PoHeadlessContent[];\n                details?: unknown;\n                isError?: boolean;\n                usage?: Record<string, unknown>;\n                terminate?: boolean;\n              } | void\n            : unknown;\n\nexport type PoHeadlessHook<E extends PoHeadlessEventName = PoHeadlessEventName> = E extends PoHeadlessEventName\n  ? {\n      when?: PoHeadlessCondition;\n      event: E;\n      handle(\n        event: Readonly<PoHeadlessHookEvent<E>>,\n        context: PoHeadlessExecutionContext,\n      ): PoHeadlessHookResult<E> | Promise<PoHeadlessHookResult<E>>;\n    }\n  : never;\n\n/** A retained package can register activity without starting disabled watchers or services. */\nexport interface PoHeadlessActivity {\n  when?: PoHeadlessCondition;\n  name: string;\n  start(context: PoHeadlessExecutionContext): (() => void | Promise<void>) | Promise<() => void | Promise<void>>;\n}\n\n/** Read-only metadata for the currently applied session, never executable declarations or resource bodies. */\nexport interface PoHeadlessCapability {\n  readonly source: string;\n  readonly name: string;\n  readonly kind: 'tool' | 'skill';\n  readonly when?: PoHeadlessCondition;\n  readonly active: boolean;\n  readonly discoverable: boolean;\n  readonly reason?: 'inactive' | 'restricted' | 'shadowed' | 'unavailable' | 'not-discoverable';\n}\n\n/** Visibility controls model discovery only, never admission for external execution. */\nexport function isPoHeadlessToolModelVisible(tool: Pick<PoHeadlessTool, '_meta'>): boolean {\n  const visibility = tool._meta?.ui?.visibility;\n  return visibility === undefined || visibility.includes('model');\n}\n\nexport interface PoHeadlessCapabilitySnapshot {\n  readonly revision: number;\n  readonly ready: boolean;\n  readonly capabilities: readonly PoHeadlessCapability[];\n}\n\n/** Registrations inherit package ownership from the caller's Cordis fiber. */\n/**\n * The tool a server session loads skills through. When a session carries it, the prompt lists\n * every skill by name and points here, so a skill needs no file the agent could read.\n */\nexport const PO_LOAD_SKILL_TOOL = 'load_skill';\n\nexport interface PoHeadlessHostService {\n  readonly context: PoHeadlessExecutionContext;\n  /** Admitted external execution, sharing native hooks, restrictions and session lifetime. */\n  readonly toolSurface?: Pick<SessionToolSurface, 'readSurface' | 'invokeTool'>;\n  /** The instructions of an applied skill by exact name, or undefined when none is applied. */\n  readSkill(name: string): string | undefined;\n  changeSelection(change: PoHeadlessSelectionChange): Promise<void>;\n  assertActive(source?: string): void;\n  subscribeSelection(listener: (selection: PoHeadlessSelection) => void | Promise<void>): () => void;\n  /** Inspect only a coherently applied generation. A transition returns ready=false and no partial inventory. */\n  inspectCapabilities(): PoHeadlessCapabilitySnapshot;\n  registerToolRestriction(restriction: PoHeadlessToolRestriction): PoHeadlessRegistration;\n  registerTool<TParameters extends TSchema>(tool: PoHeadlessTool<TParameters>): PoHeadlessRegistration;\n  registerResource(resource: PoHeadlessResource): PoHeadlessRegistration;\n  registerCommand(command: PoHeadlessCommand): PoHeadlessRegistration;\n  registerHook(hook: PoHeadlessHook): PoHeadlessRegistration;\n  registerActivity(activity: PoHeadlessActivity): PoHeadlessRegistration;\n}\n\ndeclare module '@deepseek-ai/cordis' {\n  interface Context {\n    'po/headless-host': PoHeadlessHostService;\n  }\n}\n\nexport function readPoHeadlessHost(context: Context): PoHeadlessHostService | undefined {\n  return context.get(PO_HEADLESS_HOST_SERVICE) as PoHeadlessHostService | undefined;\n}\n\nexport function requirePoHeadlessHost(context: Context): PoHeadlessHostService {\n  const host = readPoHeadlessHost(context);\n  if (!host) throw new Error('This contribution requires the Po headless session host.');\n  return host;\n}\n"],"mappings":";;AAWA,MAAa,2BAA2B;AACxC,MAAa,oBAAoB,OAAO,IAAI,mBAAmB;AAE/D,MAAM,yBAAyB;;AAG/B,IAAa,iCAAb,cAAoD,MAAM;CACxD,YAAY,OAAgB;EAC1B,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GAAG,EAAE,MAAM,CAAC;EACvE,KAAK,OAAO;CACd;AACF;AAEA,MAAM,sBAAsB;;;;;;;AAQ5B,IAAa,sBAAb,cAAyC,MAAM;CAC7C,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;;AAGA,SAAgB,sBAAsB,OAAgC;CACpE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;;AAGA,SAAgB,iCAAiC,OAAyB;CACxE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AACA,MAAM,kBAAkB;;AAGxB,IAAa,0BAAb,cAA6C,MAAM;CACjD,cAAc;EACZ,MAAM,iCAAiC;EACvC,KAAK,OAAO;CACd;AACF;AAEA,SAAgB,0BAA0B,OAAyB;CACjE,OAAO,iBAAiB,SAAS,MAAM,SAAS;AAClD;AAsBA,SAAgB,oBAAoB,SAAmD;CACrF,OAAQ,QAAoE;AAC9E;;;;;AAsBA,SAAgB,uBAAuB,QAMd;CACvB,MAAM,EAAE,sBAAsB;CAC9B,OAAO;EACL,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,GAAI,OAAO,UAAU,KAAA,IAAY,CAAC,IAAI,EAAE,OAAO,OAAO,MAAM;EAC5D,GAAI,OAAO,sBAAsB,YAAY,sBAAsB,QAAQ,CAAC,MAAM,QAAQ,iBAAiB,IACvG,EAAqB,kBAA6C,IAClE,CAAC;EACL,GAAI,OAAO,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,SAAS,OAAO,QAAQ;CACpE;AACF;;AAwZA,SAAgB,6BAA6B,MAA8C;CACzF,MAAM,aAAa,KAAK,OAAO,IAAI;CACnC,OAAO,eAAe,KAAA,KAAa,WAAW,SAAS,OAAO;AAChE;;;;;;AAaA,MAAa,qBAAqB;AA2BlC,SAAgB,mBAAmB,SAAqD;CACtF,OAAO,QAAQ,IAAI,wBAAwB;AAC7C;AAEA,SAAgB,sBAAsB,SAAyC;CAC7E,MAAM,OAAO,mBAAmB,OAAO;CACvC,IAAI,CAAC,MAAM,MAAM,IAAI,MAAM,0DAA0D;CACrF,OAAO;AACT"}