@xrkseek/harness-cli 0.0.1

package/node_modules/@xrkseek/server-face/dist/context.d.ts

@@ -0,0 +1,151 @@
+import type { AttachmentStore } from "@xrkseek/attachment";
+import type { AgentHandle } from "@xrkseek/core-agent";
+import type { SessionRecord, SessionStore } from "@xrkseek/core-session";
+import type { ToolDefinition } from "@xrkseek/core-tools";
+import type { JobView } from "./adapt/job-view.js";
+import type { ProviderRegistry } from "@xrkseek/llm-registry";
+import type { PolicyEngine } from "@xrkseek/policy";
+import type { FaceBus } from "./bus.js";
+import type { FaceSeqClock } from "./seq.js";
+import type { FaceProjectionRegistry, FaceTitleController } from "./projections/index.js";
+import type { FaceProcessPlugin, FaceWebPlugin } from "./plugin-inventory.js";
+import type { SlashRecipesLoader } from "./slash.js";
+import type { FaceCredentialVault, FaceHostPublicSettings, FaceMcpServerDraft, FaceSettingsNamespaces, FaceUiSettings } from "./settings-credentials.js";
+import type { FaceApprovalBroker } from "./approvals.js";
+import type { FaceQuestionBroker } from "./questions.js";
+import type { FaceWorkspaceRegistry } from "./workspace-registry.js";
+import type { FaceSubagentRegistry } from "./subagent-registry.js";
+import type { FaceMessageFeedbackStore } from "./message-feedback.js";
+import type { FaceGoalStore } from "./goal-store.js";
+import type { FaceWireIdMaps } from "./adapt/wire-ids.js";
+import type { FaceInboxWireMaps } from "./adapt/inbox-wire.js";
+/** @deprecated use FACE_AGENT_PRESET_IDS */
+export declare const U1_AGENT_PRESETS: Set<string>;
+export interface FaceDrain {
+    wake(sessionId: string): void;
+    cancel(sessionId: string): Promise<void>;
+    isActive(sessionId: string): boolean;
+}
+export interface FaceRuntime {
+    /** Durable image blobs; omit → image prompt / session.attachment unavailable. */
+    readonly attachments?: AttachmentStore;
+    /**
+     * Declared input modalities for Host precheck (DSH-aligned).
+     * Default `["text"]` — images rejected before save unless `"image"` is listed.
+     */
+    readonly inputModalities?: readonly ("text" | "image")[];
+    readonly store: SessionStore;
+    ensureSession(id?: string): string;
+    resolveAgent(sessionId: string): Promise<AgentHandle>;
+    readonly drain: FaceDrain;
+    readonly registry: ProviderRegistry;
+    readonly workspaceRoot: string;
+    /** Product inject dir override for tests; Host leaves unset → `{workspace}/.xrk`. Settings/creds use `resolveHarnessHome` (`~/.xrk`). */
+    readonly productDir?: string;
+    /**
+     * Named seed templates for `workspace.syncSeeds({ template })`.
+     * Values are absolute directories (e.g. office-agent template path).
+     */
+    readonly seedTemplateDirs?: Readonly<Record<string, string>>;
+    readonly version: string;
+    readonly defaultAgentPreset?: string;
+    readonly bus: FaceBus;
+    readonly seq: FaceSeqClock;
+    readonly projections: FaceProjectionRegistry;
+    readonly titles: FaceTitleController;
+    /** rpcId (unary) → admitId */
+    readonly rpcAdmitMap: Map<string, string>;
+    /** admitId → rpcId (reverse for queue / stamp) */
+    readonly admitRpcMap: Map<string, string>;
+    /** Next user/message for session should carry this rpcId */
+    readonly pendingUserRpc: Map<string, string>;
+    readonly sessionModels: Map<string, {
+        provider: string;
+        model: string;
+        reasoningEffort?: string;
+    }>;
+    /** sessionId → agentPreset id */
+    readonly sessionAgentPresets: Map<string, string>;
+    /** sessionId → project cwd (DSH session.list / blank reuse). */
+    readonly sessionCwds: Map<string, string>;
+    /** In-memory workspace registry for the product shell. */
+    readonly workspaces: FaceWorkspaceRegistry;
+    /** Direct subagent children (fork / create-with-parent). */
+    readonly subagents: FaceSubagentRegistry;
+    /** Per-session assistant-message ratings (process-local CAS). */
+    readonly messageFeedback: FaceMessageFeedbackStore;
+    /** Per-session Goal sidecar (projection key `goal`). */
+    readonly goals: FaceGoalStore;
+    /** Session-scoped turn/step numbers for DSH wire events. */
+    readonly wireIds: FaceWireIdMaps;
+    /** Session-scoped inbox splice projectors for live mux. */
+    readonly inboxWire: FaceInboxWireMaps;
+    readonly loadSlashRecipes?: SlashRecipesLoader;
+    /** Process plugins (`XRK_PLUGINS_DIR` / MCP) for inventory + slash. */
+    readonly plugins?: readonly FaceProcessPlugin[];
+    /**
+     * Host live-applies Face `mcp.servers` when MCP is sourced from
+     * host-settings.json (env empty). Absent → mutate stays `applies: restart`.
+     * Returns per-server connect failures (other servers may still mount).
+     */
+    readonly syncMcpServers?: (servers: readonly FaceMcpServerDraft[]) => Promise<{
+        readonly failures: readonly {
+            readonly serverName: string;
+            readonly message: string;
+        }[];
+    }>;
+    /** Standing / remembered tool presenters (wire tools get). */
+    readonly getTool?: (sessionId: string, name: string) => Pick<ToolDefinition, "presentCall" | "presentResult"> | undefined;
+    /** Product-shell `boot.json` entries (assembled client plugins). */
+    readonly webPlugins?: readonly FaceWebPlugin[];
+    /** Mutable UI prefs (theme/locale) — not secrets. */
+    readonly uiSettings: FaceUiSettings;
+    /** Read-only host public snapshot (from host spawn). */
+    readonly hostPublic?: FaceHostPublicSettings;
+    /** In-memory credential overrides — never session-logged. */
+    readonly credentials: FaceCredentialVault;
+    /** Face settings namespaces (welcome notice, etc.). */
+    readonly settingsNamespaces: FaceSettingsNamespaces;
+    /** Bootstrap Host API key from env/config (before vault override). */
+    readonly bootstrapApiKey?: string;
+    /** Optional policy engine (e.g. from XRK_POLICY_FILE) for provider.use gates. */
+    readonly policy?: PolicyEngine;
+    /**
+     * Absolute path to a local settings/policy document.
+     * Opened by `settings.openDocument` — request carries no filesystem path.
+     */
+    readonly settingsDocumentPath?: string;
+    /** Native opener; default platform `openNativePath`. */
+    openNativePath?(target: string): Promise<void>;
+    /** Native folder chooser; default platform `pickNativeDirectory`. Cancel → `null`. */
+    pickNativeDirectory?(signal: AbortSignal): Promise<string | null>;
+    /** Human approval waiters (tool policy `ask`). */
+    readonly approvals: FaceApprovalBroker;
+    /** DSH user-questions (`question/requested` + `/api/respond`). */
+    readonly questions: FaceQuestionBroker;
+    /** Drop cached agent when preset changes (host wires). May be async (compose dispose). */
+    invalidateAgent?(sessionId: string): void | Promise<void>;
+    /**
+     * When true, `/permission` refuses sandbox mode changes while PTY sessions
+     * are open or spawning (CV DSH terminal-bash sandbox fence).
+     */
+    hasPtyActivity?(): boolean;
+    /** Publish store appends as mux session/event. */
+    watchSession(sessionId: string): void;
+    publishQueue(sessionId: string): void;
+    publishApprovals(sessionId: string): void;
+    /**
+     * DSH `session/jobs`. `undefined` = no registry (emit nothing).
+     * Empty array is a live set that just cleared (still pushed on change).
+     */
+    jobViewsFor(sessionId: string): JobView[] | undefined;
+    publishJobs(sessionId: string, opts?: {
+        baseline?: boolean;
+    }): void;
+    /**
+     * Copy parent log into a new session without inventing title/fallback rows
+     * (replay path).
+     */
+    forkSession(sourceId: string, boundaryIndex?: number, childId?: string): SessionRecord;
+}
+//# sourceMappingURL=context.d.ts.map

package/node_modules/@xrkseek/server-face/dist/context.d.ts.map

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

package/node_modules/@xrkseek/server-face/dist/context.js

@@ -0,0 +1,4 @@
+import { FACE_AGENT_PRESET_IDS } from "./presets-catalog.js";
+/** @deprecated use FACE_AGENT_PRESET_IDS */
+export const U1_AGENT_PRESETS = FACE_AGENT_PRESET_IDS;
+//# sourceMappingURL=context.js.map

package/node_modules/@xrkseek/server-face/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAiB7D,4CAA4C;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC"}

package/node_modules/@xrkseek/server-face/dist/dispatch.d.ts

@@ -0,0 +1,6 @@
+import type { FaceRuntime } from "./context.js";
+import type { FaceRpcResponse } from "./types.js";
+import { type FaceHandler } from "./handlers/types.js";
+export declare function getHandler(method: string): FaceHandler | undefined;
+export declare function dispatchFaceMethod(runtime: FaceRuntime, method: string, rpcId: string, payload: unknown): Promise<FaceRpcResponse>;
+//# sourceMappingURL=dispatch.d.ts.map

package/node_modules/@xrkseek/server-face/dist/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AA4BlD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AA4I7B,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAElE;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,eAAe,CAAC,CAkB1B"}

package/node_modules/@xrkseek/server-face/dist/dispatch.js

@@ -0,0 +1,108 @@
+import { errResponse, okResponse } from "./wire/envelope.js";
+import { workspaceArchiveSessionFace, workspaceCreateFace, workspaceDeleteFace, workspaceDescribe, workspaceInsertBeforeFace, workspaceInsertSessionBeforeFace, workspaceListFace, workspaceListProduct, workspacePreviewInject, workspaceRenameFace, workspaceSyncSeeds, } from "./workspace-face.js";
+import { credentialsDescribe, credentialsList, credentialsSet, credentialsUnset, settingsDescribeFace, settingsGet, settingsMutateFace, settingsReplaceFace, settingsOpenDocument, settingsSet, settingsUpdateFace, } from "./settings-credentials.js";
+import { skillList } from "./skill-list.js";
+import { bindPayload, bindRuntime, notImplemented, } from "./handlers/types.js";
+import { hostCreateDirectoryHandler, hostDescribe, hostListDirectoryHandler, hostOpenPathHandler, hostPickDirectory, } from "./handlers/host.js";
+import { sessionCancel, sessionCreate, sessionFork, sessionHistory, sessionList, sessionModels, sessionPrompt, sessionRename, sessionRespondApproval, sessionSearch, sessionSelectModel, sessionUpdateQueue, } from "./handlers/session.js";
+import { agentPresetList, agentPresetRead, agentPresetReadOnly, agentPresetSelect, llmDiscoverModels, llmModels, llmProviders, sessionAttachment, } from "./handlers/catalog.js";
+import { subagentHistory, subagentInterrupt, subagentList, subagentPrompt, } from "./handlers/subagent.js";
+import { commandsExecute, commandsList, messageFeedbackDelete, messageFeedbackList, messageFeedbackPut, pluginInventoryList, } from "./handlers/remotes.js";
+import { goalsClear, goalsComplete, goalsCreate, goalsEdit, goalsPause, goalsResume, } from "./handlers/goals.js";
+import { cordisRunnerHandler } from "./handlers/cordis-stub.js";
+const HANDLERS = {
+    "host.describe": hostDescribe,
+    "host.pickDirectory": hostPickDirectory,
+    "host.listDirectory": hostListDirectoryHandler,
+    "host.createDirectory": hostCreateDirectoryHandler,
+    "host.openPath": hostOpenPathHandler,
+    "session.create": sessionCreate,
+    "session.list": sessionList,
+    "session.history": sessionHistory,
+    "session.search": sessionSearch,
+    "session.prompt": sessionPrompt,
+    "session.cancel": sessionCancel,
+    "session.models": sessionModels,
+    "session.selectModel": sessionSelectModel,
+    "session.rename": sessionRename,
+    "session.updateQueue": sessionUpdateQueue,
+    "session.fork": sessionFork,
+    "session.respondApproval": sessionRespondApproval,
+    "session.attachment": sessionAttachment,
+    "agentPreset.list": agentPresetList,
+    "agentPreset.select": agentPresetSelect,
+    "agentPreset.read": agentPresetRead,
+    "agentPreset.copy": agentPresetReadOnly,
+    "agentPreset.openDocument": agentPresetReadOnly,
+    "agentPreset.remove": agentPresetReadOnly,
+    "llm.providers": llmProviders,
+    "llm.models": llmModels,
+    "llm.discoverModels": llmDiscoverModels,
+    "workspace.describe": bindRuntime(workspaceDescribe),
+    "workspace.listProduct": bindRuntime(workspaceListProduct),
+    "workspace.list": bindRuntime(workspaceListFace),
+    "workspace.create": bindPayload(workspaceCreateFace),
+    "workspace.rename": bindPayload(workspaceRenameFace),
+    "workspace.archiveSession": bindPayload(workspaceArchiveSessionFace),
+    "workspace.delete": bindPayload(workspaceDeleteFace),
+    "workspace.insertBefore": bindPayload(workspaceInsertBeforeFace),
+    "workspace.insertSessionBefore": bindPayload(workspaceInsertSessionBeforeFace),
+    "workspace.previewInject": bindPayload(workspacePreviewInject),
+    "workspace.syncSeeds": bindPayload(workspaceSyncSeeds),
+    "settings.get": bindPayload(settingsGet),
+    "settings.describe": bindRuntime(settingsDescribeFace),
+    "settings.mutate": bindPayload(settingsMutateFace),
+    "settings.update": bindPayload(settingsUpdateFace),
+    "settings.replace": bindPayload(settingsReplaceFace),
+    "settings.set": bindPayload(settingsSet),
+    "settings.openDocument": bindRuntime(settingsOpenDocument),
+    "credentials.list": bindRuntime(credentialsList),
+    "credentials.describe": bindPayload(credentialsDescribe),
+    "credentials.set": bindPayload(credentialsSet),
+    "credentials.unset": bindPayload(credentialsUnset),
+    "skill.list": bindPayload((runtime, payload) => {
+        const sessionId = String(payload?.sessionId ?? "").trim();
+        const root = (sessionId ? runtime.sessionCwds.get(sessionId) : undefined) ??
+            runtime.workspaceRoot;
+        return skillList(root, payload);
+    }),
+    "subagent.list": subagentList,
+    "subagent.history": subagentHistory,
+    "subagent.prompt": subagentPrompt,
+    "subagent.interrupt": subagentInterrupt,
+    "commands/list": commandsList,
+    "commands/execute": commandsExecute,
+    "pluginInventory/list": pluginInventoryList,
+    "messageFeedback/list": messageFeedbackList,
+    "messageFeedback/put": messageFeedbackPut,
+    "messageFeedback/delete": messageFeedbackDelete,
+    "goals/create": goalsCreate,
+    "goals/edit": goalsEdit,
+    "goals/pause": goalsPause,
+    "goals/resume": goalsResume,
+    "goals/complete": goalsComplete,
+    "goals/clear": goalsClear,
+    // DSH connection.api.goals.* posts dotted unary (shell remotes still use goals/).
+    "goal.create": goalsCreate,
+    "goal.edit": goalsEdit,
+    "goal.pause": goalsPause,
+    "goal.resume": goalsResume,
+    "goal.complete": goalsComplete,
+    "goal.clear": goalsClear,
+};
+export function getHandler(method) {
+    return HANDLERS[method] ?? cordisRunnerHandler(method);
+}
+export async function dispatchFaceMethod(runtime, method, rpcId, payload) {
+    const handler = getHandler(method) ?? notImplemented;
+    try {
+        const result = await handler(runtime, rpcId, payload);
+        if (result.ok)
+            return okResponse(rpcId, result.value);
+        return errResponse(rpcId, result.error.code, result.error.message, result.error.details);
+    }
+    catch (err) {
+        return errResponse(rpcId, "internal", err instanceof Error ? err.message : String(err));
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/node_modules/@xrkseek/server-face/dist/dispatch.js.map

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

package/node_modules/@xrkseek/server-face/dist/dsh-schema.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Compact schemastery envelopes (`schema.toJSON()`) for Face `settings.describe`.
+ * The captured DSH Web rehydrates these; JSON Schema will not parse.
+ */
+export interface DshSchemaNode {
+    readonly type: string;
+    readonly value?: unknown;
+    readonly list?: readonly number[];
+    readonly dict?: Readonly<Record<string, number>>;
+    readonly inner?: number;
+    readonly meta?: {
+        readonly description?: string;
+    };
+}
+export interface DshSchemaEnvelope {
+    readonly uid: number;
+    readonly refs: Readonly<Record<number, DshSchemaNode>>;
+}
+export declare const DSH_EMPTY_OBJECT_SCHEMA: DshSchemaEnvelope;
+export declare const DSH_ONBOARDING_SCHEMA: DshSchemaEnvelope;
+export declare const DSH_LOCALE_SCHEMA: DshSchemaEnvelope;
+export declare const DSH_THEME_SCHEMA: DshSchemaEnvelope;
+/** Same preset ids as DSH permission-presets (settings row enum). */
+export declare const FACE_PERMISSION_PRESETS: readonly ["read-only", "workspace-write", "danger-full-access"];
+export type FacePermissionPreset = (typeof FACE_PERMISSION_PRESETS)[number];
+export declare const DSH_PERMISSION_SCHEMA: DshSchemaEnvelope;
+/**
+ * Face MCP desired servers. `connected` is overlay from live plugins.
+ * Applies on next Host spawn (not a live supervisor).
+ */
+export declare const DSH_MCP_SCHEMA: DshSchemaEnvelope;
+/** `providers` is a dict so models page can probe `providers/<route>/api`. */
+export declare const DSH_LLM_SCHEMA: DshSchemaEnvelope;
+export declare function isFacePermissionPreset(value: unknown): value is FacePermissionPreset;
+//# sourceMappingURL=dsh-schema.d.ts.map

package/node_modules/@xrkseek/server-face/dist/dsh-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-schema.d.ts","sourceRoot":"","sources":["../src/dsh-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CACxD;AAED,eAAO,MAAM,uBAAuB,EAAE,iBAGrC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,iBAMnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAQ/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,iBAS9B,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,iEAI1B,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,qBAAqB,EAAE,iBAqBnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,iBA4B5B,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,cAAc,EAAE,iBAc5B,CAAC;AAEF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,oBAAoB,CAK/B"}

package/node_modules/@xrkseek/server-face/dist/dsh-schema.js

@@ -0,0 +1,116 @@
+/**
+ * Compact schemastery envelopes (`schema.toJSON()`) for Face `settings.describe`.
+ * The captured DSH Web rehydrates these; JSON Schema will not parse.
+ */
+export const DSH_EMPTY_OBJECT_SCHEMA = {
+    uid: 1,
+    refs: { 1: { type: "object" } },
+};
+export const DSH_ONBOARDING_SCHEMA = {
+    uid: 2,
+    refs: {
+        1: { type: "string" },
+        2: { type: "object", dict: { welcomeNoticeVersion: 1 } },
+    },
+};
+export const DSH_LOCALE_SCHEMA = {
+    uid: 4,
+    refs: {
+        1: { type: "const", value: "zh" },
+        2: { type: "const", value: "en" },
+        3: { type: "union", list: [1, 2] },
+        4: { type: "object", dict: { preference: 3 } },
+    },
+};
+export const DSH_THEME_SCHEMA = {
+    uid: 5,
+    refs: {
+        1: { type: "const", value: "system" },
+        2: { type: "const", value: "light" },
+        3: { type: "const", value: "dark" },
+        4: { type: "union", list: [1, 2, 3] },
+        5: { type: "object", dict: { preference: 4 } },
+    },
+};
+/** Same preset ids as DSH permission-presets (settings row enum). */
+export const FACE_PERMISSION_PRESETS = [
+    "read-only",
+    "workspace-write",
+    "danger-full-access",
+];
+export const DSH_PERMISSION_SCHEMA = {
+    uid: 5,
+    refs: {
+        1: {
+            type: "const",
+            meta: { description: "Read only" },
+            value: "read-only",
+        },
+        2: {
+            type: "const",
+            meta: { description: "Workspace write" },
+            value: "workspace-write",
+        },
+        3: {
+            type: "const",
+            meta: { description: "Full access" },
+            value: "danger-full-access",
+        },
+        4: { type: "union", list: [1, 2, 3] },
+        5: { type: "object", dict: { defaultPreset: 4 } },
+    },
+};
+/**
+ * Face MCP desired servers. `connected` is overlay from live plugins.
+ * Applies on next Host spawn (not a live supervisor).
+ */
+export const DSH_MCP_SCHEMA = {
+    uid: 9,
+    refs: {
+        1: { type: "string" },
+        2: { type: "array", inner: 1 },
+        3: {
+            type: "object",
+            dict: {
+                serverName: 1,
+                command: 1,
+                url: 1,
+                args: 2,
+                cwd: 1,
+            },
+        },
+        4: { type: "array", inner: 3 },
+        5: { type: "string" },
+        6: {
+            type: "object",
+            dict: { id: 1, serverName: 1, kind: 1, toolCount: 5 },
+        },
+        7: { type: "array", inner: 6 },
+        8: { type: "string" },
+        9: {
+            type: "object",
+            dict: { servers: 4, connected: 7, note: 8 },
+        },
+    },
+};
+/** `providers` is a dict so models page can probe `providers/<route>/api`. */
+export const DSH_LLM_SCHEMA = {
+    uid: 8,
+    refs: {
+        1: { type: "const", value: "openai-chat" },
+        2: { type: "union", list: [1] },
+        3: { type: "string" },
+        4: { type: "string" },
+        5: {
+            type: "object",
+            dict: { api: 2, apiKeyEnv: 3, baseURL: 4 },
+        },
+        6: { type: "dict", inner: 5 },
+        8: { type: "object", dict: { providers: 6 } },
+    },
+};
+export function isFacePermissionPreset(value) {
+    return (typeof value === "string" &&
+        FACE_PERMISSION_PRESETS.includes(value));
+}
+//# sourceMappingURL=dsh-schema.js.map

package/node_modules/@xrkseek/server-face/dist/dsh-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsh-schema.js","sourceRoot":"","sources":["../src/dsh-schema.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-face/dist/durable-prompt.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Face prompt content → durable ContentBlock[] (DSH-aligned).
+ * Wire may carry temporary base64; session log only stores ImageAttachmentRef.
+ */
+import type { AttachmentStore } from "@xrkseek/attachment";
+import type { MessageContent } from "@xrkseek/protocol";
+export type PromptWirePart = {
+    readonly type: "text";
+    readonly text: string;
+} | {
+    readonly type: "image";
+    readonly mediaType: string;
+    readonly data: string;
+    readonly name?: string;
+};
+export type DurablePromptResult = {
+    readonly ok: true;
+    readonly content: MessageContent;
+} | {
+    readonly ok: false;
+    readonly code: string;
+    readonly message: string;
+};
+/**
+ * Build durable message content from Face `session.prompt` parts.
+ * - all text → string (legacy-friendly)
+ * - any image → ContentBlock[] after AttachmentStore.saveImages
+ */
+export declare function durablePromptContent(parts: readonly PromptWirePart[], attachments: AttachmentStore): Promise<DurablePromptResult>;
+//# sourceMappingURL=durable-prompt.d.ts.map

package/node_modules/@xrkseek/server-face/dist/durable-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-prompt.d.ts","sourceRoot":"","sources":["../src/durable-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,mBAAmB,CAAC;AAG3B,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEN,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GACvD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAYN;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,SAAS,cAAc,EAAE,EAChC,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CAuG9B"}

package/node_modules/@xrkseek/server-face/dist/durable-prompt.js

@@ -0,0 +1,113 @@
+/**
+ * Face prompt content → durable ContentBlock[] (DSH-aligned).
+ * Wire may carry temporary base64; session log only stores ImageAttachmentRef.
+ */
+import { AttachmentError, isAttachmentError } from "@xrkseek/attachment";
+import { isImageMediaType } from "@xrkseek/protocol";
+function decodeBase64(data) {
+    try {
+        const buf = Buffer.from(data, "base64");
+        if (buf.byteLength === 0 && data.length > 0)
+            return undefined;
+        return new Uint8Array(buf);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Build durable message content from Face `session.prompt` parts.
+ * - all text → string (legacy-friendly)
+ * - any image → ContentBlock[] after AttachmentStore.saveImages
+ */
+export async function durablePromptContent(parts, attachments) {
+    if (parts.length === 0) {
+        return { ok: false, code: "invalid-payload", message: "content required" };
+    }
+    const hasImage = parts.some((p) => p.type === "image");
+    if (!hasImage) {
+        const text = parts
+            .filter((p) => p.type === "text")
+            .map((p) => p.text)
+            .join("");
+        if (!text) {
+            return { ok: false, code: "invalid-payload", message: "empty text" };
+        }
+        return { ok: true, content: text };
+    }
+    const pending = [];
+    for (const part of parts) {
+        if (part.type === "text") {
+            pending.push({ kind: "text", text: part.text });
+            continue;
+        }
+        if (part.type !== "image") {
+            return {
+                ok: false,
+                code: "invalid-payload",
+                message: "unknown content part",
+            };
+        }
+        if (!isImageMediaType(part.mediaType)) {
+            return {
+                ok: false,
+                code: "unsupported-image-type",
+                message: `unsupported mediaType: ${part.mediaType}`,
+            };
+        }
+        const data = decodeBase64(part.data);
+        if (!data || data.byteLength === 0) {
+            return {
+                ok: false,
+                code: "invalid-payload",
+                message: "image data must be non-empty base64",
+            };
+        }
+        pending.push({
+            kind: "image",
+            mediaType: part.mediaType,
+            data,
+            ...(part.name !== undefined ? { name: part.name } : {}),
+        });
+    }
+    const imageInputs = pending
+        .filter((p) => p.kind === "image")
+        .map((p) => ({
+        data: p.data,
+        mediaType: p.mediaType,
+        ...(p.name !== undefined ? { name: p.name } : {}),
+    }));
+    let refs;
+    try {
+        refs = await attachments.saveImages(imageInputs);
+    }
+    catch (err) {
+        if (isAttachmentError(err)) {
+            return {
+                ok: false,
+                code: err.code.toLowerCase().replaceAll("_", "-"),
+                message: err.message,
+            };
+        }
+        if (err instanceof AttachmentError) {
+            return { ok: false, code: "attachment-error", message: err.message };
+        }
+        throw err;
+    }
+    const blocks = [];
+    let imageIndex = 0;
+    for (const p of pending) {
+        if (p.kind === "text") {
+            if (p.text.length > 0)
+                blocks.push({ type: "text", text: p.text });
+            continue;
+        }
+        const ref = refs[imageIndex++];
+        blocks.push({ type: "image", attachment: ref });
+    }
+    if (blocks.length === 0) {
+        return { ok: false, code: "invalid-payload", message: "empty content" };
+    }
+    return { ok: true, content: blocks };
+}
+//# sourceMappingURL=durable-prompt.js.map

package/node_modules/@xrkseek/server-face/dist/durable-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-prompt.js","sourceRoot":"","sources":["../src/durable-prompt.ts"],"names":[],"mappings":"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"}

package/node_modules/@xrkseek/server-face/dist/envelope.d.ts

@@ -0,0 +1,23 @@
+import type { FaceRpcRequest, FaceRpcResponse, RpcId } from "./types.js";
+/**
+ * Parse Face unary body. Accepts DeepSeek wire (`type: client-request`) and
+ * the thinner XRK shape (`rpcId` + `payload` only).
+ */
+export declare function parseFaceRpcRequest(body: unknown): FaceRpcRequest;
+/** DeepSeek-compatible unary success envelope. */
+export declare function okResponse<T>(rpcId: RpcId, value: T): FaceRpcResponse<T>;
+/**
+ * DeepSeek-compatible unary error envelope.
+ * Always includes `details` (DSH client Zod requires it).
+ */
+export declare function errResponse(rpcId: RpcId, code: string, message: string, details?: unknown): FaceRpcResponse<never>;
+/** DeepSeek WS downlink frame (`server-request` + method = payload.type). */
+export declare function serverRequestFrame(rpcId: RpcId, payload: {
+    readonly type: string;
+} & Record<string, unknown>): {
+    readonly type: "server-request";
+    readonly rpcId: RpcId;
+    readonly method: string;
+    readonly payload: typeof payload;
+};
+//# sourceMappingURL=envelope.d.ts.map