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

package/dist/types/server/directHarnessRuntime.d.mts

@@ -0,0 +1,156 @@
+import { HistoryOwnership, HistoryOwnershipLease } from "../../history-import.mjs";
+import { Context } from "@earendil-works/chord";
+import { AgentHarness, AgentHarnessOptions, AgentHarnessResources, AgentHarnessTool, AgentLane, AgentMessage, CompactionSettings, Entry, EntryProjector, HarnessEvent, HookMap, QueueMode, Session, SessionStats, ThinkingLevel } from "@earendil-works/pi-agent-core";
+import { Api, CredentialStore, ImageContent, Model, Models, MutableModels, Provider, RetryPolicy, Usage } from "@earendil-works/pi-ai";
+//#region src/types/server/directHarnessRuntime.d.ts
+export interface SqliteSessionStorage {
+  session: Session;
+  sessionFile: string;
+  repository: {
+    close(context: Context): Promise<void>;
+  };
+  historyLease: HistoryOwnershipLease;
+}
+/** The opaque frame shape consumed by the existing server compatibility facade. */
+export type DirectHarnessFrame = Record<string, unknown>;
+export type DirectHarnessModel = Model<Api> | {
+  provider: string;
+  id: string;
+};
+export interface DirectHarnessModelBoundary {
+  phase: 'turn' | 'request';
+  model?: Model<Api>;
+  prompt?: AgentMessage[];
+  resources: AgentHarnessResources;
+}
+export interface DirectHarnessRuntimeOptions<TContext extends object | undefined = object | undefined> {
+  /** Stable session identity. Existing session files are authoritative when omitted. */
+  sessionId?: string;
+  /** Working directory used by NodeExecutionEnv and newly-created sessions. */
+  cwd: string;
+  /** Stable lane identity. Defaults to `main`. */
+  lane?: string;
+  /** Stable host identity exposed to the parent orchestrator. */
+  harnessId?: string;
+  sessionName?: string;
+  /** Injecting a Session is supported for tests and hosts that already own storage. */
+  session?: Session;
+  /** Server hosts select SQLite; terminal hosts retain JSONL. */
+  storage?: 'jsonl' | 'sqlite';
+  /** Existing v4 JSONL session path. Requires historyOwnership for its lifetime. */
+  sessionPath?: string;
+  /** Existing v3 JSONL path. It is never opened for writing. */
+  legacySessionPath?: string;
+  /** Parent identity recorded on newly-created sessions. */
+  parentSessionId?: string;
+  sessionsRoot?: string;
+  /** Required when opening any existing session or importing legacy history. */
+  historyOwnership?: HistoryOwnership;
+  historyOriginalPath?: string;
+  historyStatePath?: string;
+  /** Public pi-ai model/provider/credential registries. */
+  models?: Models | MutableModels;
+  providers?: readonly Provider[];
+  credentials?: CredentialStore;
+  model?: DirectHarnessModel;
+  /** Public AgentHarness tools and resources are explicit, replaceable inputs. */
+  tools?: AgentHarnessTool<TContext>[];
+  resources?: AgentHarnessResources;
+  toolContext?: AgentHarnessOptions<TContext>['toolContext'];
+  systemPrompt?: AgentHarnessOptions<TContext>['systemPrompt'];
+  streamOptions?: AgentHarnessOptions<TContext>['streamOptions'];
+  retry?: RetryPolicy;
+  compaction?: CompactionSettings;
+  thinkingLevel?: ThinkingLevel;
+  activeToolNames?: string[];
+  steeringMode?: QueueMode;
+  followUpMode?: QueueMode;
+  toolExecution?: 'sequential' | 'parallel';
+  toProviderMessages?: AgentHarnessOptions<TContext>['toProviderMessages'];
+  entryProjectors?: Record<string, EntryProjector>;
+  context?: Context;
+  /** Synchronous admission check at the public Models dispatch boundary, before auth/provider work starts. */
+  guardModelRequest?: () => void;
+  beforeModelRequest?: (boundary: DirectHarnessModelBoundary, context: Context) => void | Promise<void>;
+  /** Active AgentHarness execution-hook bridges. */
+  transformContext?: (event: HookMap['transform_context']['event'], context: Context) => HookMap['transform_context']['result'] | Promise<HookMap['transform_context']['result']>;
+  beforePayload?: (event: HookMap['before_payload']['event'], context: Context) => HookMap['before_payload']['result'] | Promise<HookMap['before_payload']['result']>;
+  beforeTool?: (event: HookMap['before_tool']['event'], context: Context) => HookMap['before_tool']['result'] | Promise<HookMap['before_tool']['result']>;
+  afterTool?: (event: HookMap['after_tool']['event'], context: Context) => HookMap['after_tool']['result'] | Promise<HookMap['after_tool']['result']>;
+  beforeCompaction?: (event: HookMap['before_compaction']['event'], context: Context) => HookMap['before_compaction']['result'] | Promise<HookMap['before_compaction']['result']>;
+  /** Active package commands advertised through the compatibility protocol. */
+  listCommands?: () => readonly {
+    name: string;
+    description: string;
+  }[];
+  /** Returns false when the text is not an active package command, preserving normal prompt handling. */
+  dispatchCommand?: (text: string) => Promise<boolean>;
+}
+export interface DirectHarnessEventListener {
+  (event: HarnessEvent, context: Context): void | Promise<void>;
+}
+/** Direct, same-process AgentHarness runtime owned by one session host. */
+export interface DirectHarnessRuntime<TContext extends object | undefined = object | undefined> {
+  readonly sessionId: string;
+  readonly laneName: string;
+  readonly harnessId: string;
+  readonly session: Session;
+  readonly harness: AgentHarness<TContext>;
+  readonly lane: AgentLane;
+  readonly exited: Promise<number>;
+  readonly storageQuarantined: boolean;
+  onPresentationFrame(listener: (frame: DirectHarnessFrame) => void): () => void;
+  onEvent(listener: DirectHarnessEventListener): () => void;
+  stop(): void;
+  readState(): Promise<Record<string, unknown>>;
+  readEntries(): Promise<{
+    entries: Entry[];
+    leafId: string | null;
+  }>;
+  listCommands(): readonly {
+    name: string;
+    description: string;
+  }[];
+  setModel(model: {
+    provider: string;
+    id: string;
+  }): Promise<void>;
+  availableModels(): Promise<readonly Model<Api>[]>;
+  /** Shares the harness dispatch guards with host-owned auxiliary model requests. */
+  completeModel?: Models['complete'];
+  availableThinkingLevels(): Promise<ThinkingLevel[]>;
+  setThinkingLevel(level: ThinkingLevel): Promise<void>;
+  setSteeringMode(mode: QueueMode): Promise<void>;
+  setFollowUpMode(mode: QueueMode): Promise<void>;
+  navigateTree(targetId: string | null, options?: Record<string, unknown>): Promise<{
+    cancelled: boolean;
+    entries: Entry[];
+  }>;
+  clearQueue(): Promise<{
+    steering: never[];
+    followUp: never[];
+  }>;
+  setName(name: string): Promise<void>;
+  getSessionStats(): Promise<SessionStats>;
+  replaceTools(tools: AgentHarnessTool<TContext>[]): Promise<void>;
+  replaceResources(resources: AgentHarnessResources): Promise<void>;
+  readResources(): Promise<AgentHarnessResources>;
+  appendCustomEntry(customType: string, data?: unknown): Promise<string>;
+  recordUsage(usage: Usage, options?: {
+    entryId?: string;
+    details?: import('@earendil-works/pi-agent-core').JsonValue;
+  }): Promise<string>;
+  submitPrompt(text: string, images?: ImageContent[]): Promise<{
+    settled: Promise<void>;
+    handledCommand?: boolean;
+  }>;
+  prompt(text: string, images?: ImageContent[]): Promise<void>;
+  steer(text: string, images?: ImageContent[]): Promise<void>;
+  followUp(text: string, images?: ImageContent[]): Promise<void>;
+  abort(): Promise<void>;
+  compact(customInstructions?: string): Promise<void>;
+  resume(): Promise<void>;
+  dispose(): Promise<void>;
+}
+//#endregion
+//# sourceMappingURL=directHarnessRuntime.d.mts.map

package/dist/types/server/directHarnessRuntime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directHarnessRuntime.d.mts","names":[],"sources":["../../../src/types/server/directHarnessRuntime.ts"],"mappings":";;;;;iBAkCiB;EACf,SAAS;EACT;EACA;IAAc,MAAM,SAAS,UAAU;;EACvC,cAAc;;;YAIJ,qBAAqB;YAErB,qBAAqB,MAAM;EAAS;EAAkB;;iBAEjD;EACf;EACA,QAAQ,MAAM;EACd,SAAS;EACT,WAAW;;iBAGI,4BAA4B;;EAE3C;;EAEA;;EAEA;;EAEA;EACA;;EAGA,UAAU;;EAEV;;EAEA;;EAEA;;EAEA;EACA;;EAEA,mBAAmB;EACnB;EACA;;EAGA,SAAS,SAAS;EAClB,qBAAqB;EACrB,cAAc;EACd,QAAQ;;EAGR,QAAQ,iBAAiB;EACzB,YAAY;EACZ,cAAc,oBAAoB;EAClC,eAAe,oBAAoB;EACnC,gBAAgB,oBAAoB;EACpC,QAAQ;EACR,aAAa;EACb,gBAAgB;EAChB;EACA,eAAe;EACf,eAAe;EACf;EACA,qBAAqB,oBAAoB;EACzC,kBAAkB,eAAe;EACjC,UAAU;;EAEV;EACA,sBAAsB,UAAU,4BAA4B,SAAS,mBAAmB;;EAExF,oBACE,OAAO,uCACP,SAAS,YACN,yCAAyC,QAAQ;EACtD,iBACE,OAAO,oCACP,SAAS,YACN,sCAAsC,QAAQ;EACnD,cACE,OAAO,iCACP,SAAS,YACN,mCAAmC,QAAQ;EAChD,aACE,OAAO,gCACP,SAAS,YACN,kCAAkC,QAAQ;EAC/C,oBACE,OAAO,uCACP,SAAS,YACN,yCAAyC,QAAQ;;EAEtD;IAAgC;IAAc;;;EAE9C,mBAAmB,iBAAiB;;iBAGrB;GACd,OAAO,cAAc,SAAS,iBAAiB;;;iBAIjC,qBAAqB;WAC3B;WACA;WACA;WACA,SAAS;WACT,SAAS,aAAa;WACtB,MAAM;WACN,QAAQ;WACR;EAET,oBAAoB,WAAW,OAAO;EACtC,QAAQ,UAAU;EAClB;EAEA,aAAa,QAAQ;EACrB,eAAe;IAAU,SAAS;IAAS;;EAC3C;IAA2B;IAAc;;EACzC,SAAS;IAAS;IAAkB;MAAe;EACnD,mBAAmB,iBAAiB,MAAM;;EAE1C,gBAAgB;EAChB,2BAA2B,QAAQ;EACnC,iBAAiB,OAAO,gBAAgB;EACxC,gBAAgB,MAAM,YAAY;EAClC,gBAAgB,MAAM,YAAY;EAClC,aACE,yBACA,UAAU,0BACT;IAAU;IAAoB,SAAS;;EAC1C,cAAc;IAAU;IAAmB;;EAC3C,QAAQ,eAAe;EACvB,mBAAmB,QAAQ;EAC3B,aAAa,OAAO,iBAAiB,cAAc;EACnD,iBAAiB,WAAW,wBAAwB;EACpD,iBAAiB,QAAQ;EACzB,kBAAkB,oBAAoB,iBAAiB;EACvD,YACE,OAAO,OACP;IAAY;IAAkB,kDAAkD;MAC/E;EACH,aAAa,cAAc,SAAS,iBAAiB;IAAU,SAAS;IAAe;;EACvF,OAAO,cAAc,SAAS,iBAAiB;EAC/C,MAAM,cAAc,SAAS,iBAAiB;EAC9C,SAAS,cAAc,SAAS,iBAAiB;EACjD,SAAS;EACT,QAAQ,8BAA8B;EACtC,UAAU;EACV,WAAW"}

package/dist/types/server/session.d.cts

@@ -0,0 +1,5 @@
+//#region src/types/server/session.d.ts
+/** One newline-delimited JSON frame, kept opaque so Pi can evolve its protocol. */
+export type SessionFrame = Record<string, unknown>;
+//#endregion
+//# sourceMappingURL=session.d.cts.map

package/dist/types/server/session.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.cts","names":[],"sources":["../../../src/types/server/session.ts"],"mappings":";;YACY,eAAe"}

package/dist/types/server/session.d.mts

@@ -0,0 +1,5 @@
+//#region src/types/server/session.d.ts
+/** One newline-delimited JSON frame, kept opaque so Pi can evolve its protocol. */
+export type SessionFrame = Record<string, unknown>;
+//#endregion
+//# sourceMappingURL=session.d.mts.map

package/dist/types/server/session.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.mts","names":[],"sources":["../../../src/types/server/session.ts"],"mappings":";;YACY,eAAe"}

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

@@ -0,0 +1,48 @@
+import { ContextItemSource } from "./context-projection.cjs";
+//#region src/types/contextApi.d.ts
+export type ContextItemKind = 'tool' | 'skill';
+/** What a tool costs, split the way it is actually paid. */
+export interface ContextTokenBreakdown {
+  /** The JSON schema in the tool list. */
+  readonly schemaTokens: number;
+  /** The prose Pi folds into the system prompt. */
+  readonly promptTokens: number;
+  readonly totalTokens: number;
+}
+export interface ContextToolDetail {
+  readonly itemKind: 'tool';
+  readonly name: string;
+  readonly owner: string;
+  readonly source: ContextItemSource;
+  readonly active: boolean;
+  readonly tokens: ContextTokenBreakdown;
+  readonly description?: string;
+  /** The one-line snippet Pi keys by tool name in the system prompt. */
+  readonly promptSnippet?: string;
+  readonly promptGuidelines?: readonly string[];
+  /** The parameter schema as the model receives it. */
+  readonly parameters?: unknown;
+}
+export interface ContextSkillDetail {
+  readonly itemKind: 'skill';
+  readonly name: string;
+  readonly owner: string;
+  readonly source: ContextItemSource;
+  readonly active: true;
+  /** A skill has no schema half, so the figure is the prompt cost alone. */
+  readonly tokens: number;
+  readonly description: string;
+  readonly filePath?: string;
+  /** Whether the model may invoke it, as opposed to a human running it. */
+  readonly modelInvocable: boolean;
+}
+export type ContextItemDetail = ContextToolDetail | ContextSkillDetail;
+/** The file the agent writes and the session API reads back. */
+export interface ContextDetailFile {
+  readonly version: 1;
+  /** Matches the projection revision the panel is rendering. */
+  readonly revision: number;
+  readonly items: readonly ContextItemDetail[];
+}
+//#endregion
+//# sourceMappingURL=types-context-api.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types-context-api.d.cts","names":[],"sources":["../src/types/contextApi.ts"],"mappings":";;YAEY;;iBAGK;;WAEN;;WAEA;WACA;;iBAGM;WACN;WACA;WACA;WACA,QAAQ;WACR;WACA,QAAQ;WACR;;WAEA;WACA;;WAEA;;iBAGM;WACN;WACA;WACA;WACA,QAAQ;WACR;;WAEA;WACA;WACA;;WAEA;;YAGC,oBAAoB,oBAAoB;;iBAGnC;WACN;;WAEA;WACA,gBAAgB"}

package/dist/types-context-api.d.mts

@@ -0,0 +1,48 @@
+import { ContextItemSource } from "./context-projection.mjs";
+//#region src/types/contextApi.d.ts
+export type ContextItemKind = 'tool' | 'skill';
+/** What a tool costs, split the way it is actually paid. */
+export interface ContextTokenBreakdown {
+  /** The JSON schema in the tool list. */
+  readonly schemaTokens: number;
+  /** The prose Pi folds into the system prompt. */
+  readonly promptTokens: number;
+  readonly totalTokens: number;
+}
+export interface ContextToolDetail {
+  readonly itemKind: 'tool';
+  readonly name: string;
+  readonly owner: string;
+  readonly source: ContextItemSource;
+  readonly active: boolean;
+  readonly tokens: ContextTokenBreakdown;
+  readonly description?: string;
+  /** The one-line snippet Pi keys by tool name in the system prompt. */
+  readonly promptSnippet?: string;
+  readonly promptGuidelines?: readonly string[];
+  /** The parameter schema as the model receives it. */
+  readonly parameters?: unknown;
+}
+export interface ContextSkillDetail {
+  readonly itemKind: 'skill';
+  readonly name: string;
+  readonly owner: string;
+  readonly source: ContextItemSource;
+  readonly active: true;
+  /** A skill has no schema half, so the figure is the prompt cost alone. */
+  readonly tokens: number;
+  readonly description: string;
+  readonly filePath?: string;
+  /** Whether the model may invoke it, as opposed to a human running it. */
+  readonly modelInvocable: boolean;
+}
+export type ContextItemDetail = ContextToolDetail | ContextSkillDetail;
+/** The file the agent writes and the session API reads back. */
+export interface ContextDetailFile {
+  readonly version: 1;
+  /** Matches the projection revision the panel is rendering. */
+  readonly revision: number;
+  readonly items: readonly ContextItemDetail[];
+}
+//#endregion
+//# sourceMappingURL=types-context-api.d.mts.map

package/dist/types-context-api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-context-api.d.mts","names":[],"sources":["../src/types/contextApi.ts"],"mappings":";;YAEY;;iBAGK;;WAEN;;WAEA;WACA;;iBAGM;WACN;WACA;WACA;WACA,QAAQ;WACR;WACA,QAAQ;WACR;;WAEA;WACA;;WAEA;;iBAGM;WACN;WACA;WACA;WACA,QAAQ;WACR;;WAEA;WACA;WACA;;WAEA;;YAGC,oBAAoB,oBAAoB;;iBAGnC;WACN;;WAEA;WACA,gBAAgB"}

package/dist/types-context-api.mjs

@@ -0,0 +1 @@
+export {};

package/dist/ui-hub.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_uiHub = require("./schemas/uiHub.cjs");
+exports.DOOM_UI_HUB_SERVICE = require_uiHub.DOOM_UI_HUB_SERVICE;
+exports.readDoomUiHub = require_uiHub.readDoomUiHub;
+exports.requireDoomUiHub = require_uiHub.requireDoomUiHub;

package/dist/ui-hub.d.cts

@@ -0,0 +1,2 @@
+import { DOOM_UI_HUB_SERVICE, DoomUiHubService, readDoomUiHub, requireDoomUiHub } from "./schemas/uiHub.cjs";
+export { DOOM_UI_HUB_SERVICE, type DoomUiHubService, readDoomUiHub, requireDoomUiHub };

package/dist/ui-hub.d.mts

@@ -0,0 +1,2 @@
+import { DOOM_UI_HUB_SERVICE, DoomUiHubService, readDoomUiHub, requireDoomUiHub } from "./schemas/uiHub.mjs";
+export { DOOM_UI_HUB_SERVICE, type DoomUiHubService, readDoomUiHub, requireDoomUiHub };

package/dist/ui-hub.mjs

@@ -0,0 +1,2 @@
+import { DOOM_UI_HUB_SERVICE, readDoomUiHub, requireDoomUiHub } from "./schemas/uiHub.mjs";
+export { DOOM_UI_HUB_SERVICE, readDoomUiHub, requireDoomUiHub };