context-guardian-deepseek-harness 0.1.0

package/README.md

@@ -0,0 +1,99 @@
+# Context Guardian for DeepSeek Harness
+
+[English](README.md) · [简体中文](README.zh-CN.md)
+
+This adapter adds a human review step before DeepSeek Harness's native context compaction:
+
+```text
+Harness history → Context Guardian inspection → Keep / Drop review → native Harness summary
+```
+
+It is a decorator over `dsh-compaction-basic`. DeepSeek Harness continues to own compaction range selection, token accounting, durable session events, summary framing, persistence, and the `/compact` command. If Python, the bridge, model extraction, or human review is unavailable, the adapter logs a warning and continues with native compaction.
+
+## Install
+
+DeepSeek Harness is currently a developer preview, so this adapter is pinned to the `0.1.5-rc.x` API family.
+
+The package is not published yet. Install the current checkout into the Web profile:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/ContextGuardian/adapters/deepseek-harness
+```
+
+This checkout command installs the local adapter tarball into the profile. After npm
+publishing, the argument can be replaced with `context-guardian-deepseek-harness`.
+
+After publishing, the intended end-user command is:
+
+```bash
+dsh plugin --profile web add context-guardian-deepseek-harness
+```
+
+Because DeepSeek Harness Web composes compaction inside the selected agent preset,
+installing the package alone does not replace the `standard` preset's nested native
+backend. Create a user preset based on `standard`, replace its `compaction-basic` row
+with `context-guardian-deepseek-harness`, and select that preset (or make it the
+default). The preset must contain this compaction group:
+
+```yaml
+- id: compaction
+  name: cordis:group
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: context-guardian-compaction
+      name: context-guardian-deepseek-harness
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+```
+
+Keep the rest of the copied `standard` preset unchanged. This is required because
+DeepSeek Harness mounts the preset in a per-session scope; a profile-level plugin row
+cannot override the preset's own `compaction-basic` row.
+
+Install the Python core in the same environment used by `dsh`, or point the adapter at an interpreter explicitly:
+
+```bash
+python3 -m pip install -e /absolute/path/to/ContextGuardian
+export CONTEXT_GUARDIAN_PYTHON=/absolute/path/to/python
+```
+
+The adapter does not receive or forward `DEEPSEEK_API_KEY`. Structured inspection calls go back through DeepSeek Harness's active `ctx.llm` route, so Harness remains the only process that resolves provider credentials.
+
+Start the web profile and use a sufficiently long session or `/compact`:
+
+```bash
+dsh --profile web
+```
+
+Review candidates appear through Harness's user-question UI. In headless compositions without an answerer, uncertain candidates are conservatively kept. For deterministic local testing, `CONTEXT_GUARDIAN_REVIEW_MODE=keep` or `drop` bypasses the question UI.
+
+For a repeatable end-to-end UI test that does not require a long real conversation:
+
+```bash
+env PATH="/path/to/node-22.19/bin:$PATH" npm run dsh-fixture-smoke
+```
+
+The fixture creates an isolated Web profile, seeds a sufficiently large conversation,
+opens the Harness UI, and pauses on a reviewable SQLite candidate. Select Keep or Drop,
+then confirm the native `/compact` result. It uses a replay model, so no DeepSeek API
+key is required. Exit the temporary Web process with Ctrl-C when finished.
+
+## Local development
+
+```bash
+npm install
+npm --workspace adapters/deepseek-harness run typecheck
+```
+
+To test a checkout before publishing, install the adapter into a Harness profile from the repository directory:
+
+```bash
+dsh plugin --profile web add /absolute/path/to/ContextGuardian/adapters/deepseek-harness
+```
+
+The profile bundle disables the stock `compaction-basic` row and inserts the decorated backend. The adapter is intentionally separate from the Python distribution and from the Pi adapter, so each host can evolve against its own lifecycle and UI contract.

package/README.zh-CN.md

@@ -0,0 +1,94 @@
+# Context Guardian for DeepSeek Harness
+
+[English](README.md) · 简体中文
+
+这个适配器在 DeepSeek Harness 原生上下文压缩前增加人工审查：
+
+```text
+Harness 历史 → Context Guardian 检查 → Keep / Drop 审查 → Harness 原生摘要
+```
+
+它是 `dsh-compaction-basic` 的装饰器。DeepSeek Harness 继续负责压缩范围、
+token 统计、会话事件、摘要格式、持久化和 `/compact` 命令。如果 Python、桥接、
+模型抽取或人工审查不可用，适配器会记录 warning 并继续原生 compaction。
+
+## 安装
+
+DeepSeek Harness 目前仍是 developer preview，适配器锁定 `0.1.5-rc.x` API 系列。
+当前包还没有发布，请从仓库安装本地适配器：
+
+```bash
+dsh plugin --profile web add /absolute/path/to/ContextGuardian/adapters/deepseek-harness
+```
+
+正式发布后，目标命令是：
+
+```bash
+dsh plugin --profile web add context-guardian-deepseek-harness
+```
+
+由于 DeepSeek Harness Web 会在选中的 agent preset 内组合 compaction，仅安装包
+还不够。请复制 `standard` preset，保持其他内容不变，把其中的
+`compaction-basic` 行替换为 `context-guardian-deepseek-harness`，然后选择该
+preset 或将它设为默认。compaction 分组应包含：
+
+```yaml
+- id: compaction
+  name: cordis:group
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: context-guardian-compaction
+      name: context-guardian-deepseek-harness
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+```
+
+这是必须步骤，因为 Harness 会在每个 session scope 内挂载 preset，profile 级别
+的插件行不能覆盖 preset 自己的 `compaction-basic` 行。
+
+Python 核心需要安装在 `dsh` 使用的环境中，也可以显式指定解释器：
+
+```bash
+python3 -m pip install -e /absolute/path/to/ContextGuardian
+export CONTEXT_GUARDIAN_PYTHON=/absolute/path/to/python
+```
+
+适配器不会接收或转发 `DEEPSEEK_API_KEY`。结构化检查会通过 Harness 当前的
+`ctx.llm` 路由执行，由 Harness 负责解析 Provider 凭证。
+
+## 交互式验证
+
+启动 Web profile：
+
+```bash
+dsh --profile web
+```
+
+要验证完整流程而不进行很长的真实对话，在仓库根目录运行：
+
+```bash
+env PATH="/path/to/node-22.19/bin:$PATH" npm run dsh-fixture-smoke
+```
+
+fixture 会创建隔离的 Web profile，预置足够长的会话，打开 Harness UI，并在
+SQLite 候选上暂停，让你选择 Keep 或 Drop，随后确认原生 `/compact` 成功。它
+使用 replay model，不需要 DeepSeek API Key。结束临时 Web 进程时按 Ctrl-C。
+
+在没有 answerer 的无头模式中，未决候选会保守地 Keep；也可以用
+`CONTEXT_GUARDIAN_REVIEW_MODE=keep` 或 `drop` 绕过询问 UI。
+
+## 本地开发
+
+```bash
+npm install
+npm --workspace adapters/deepseek-harness run typecheck
+npm --workspace adapters/deepseek-harness run test
+```
+
+这个适配器与 Python distribution、Pi 适配器分别发布，因此每个宿主可以按自己
+的生命周期和 UI 合同独立演进。

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# Replace DeepSeek Harness's basic backend with Context Guardian's decorated
+# backend. The native selection, transaction, persistence, and summary format
+# remain owned by dsh-compaction-basic.
+- id: compaction-basic
+  disabled: true
+
+- insert:
+    - id: context-guardian-compaction
+      name: 'context-guardian-deepseek-harness'

package/lib/bridge.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from "@deepseek-ai/cordis";
+import type { Agent } from "@deepseek-ai/dsh-agent";
+import type { Guidance, GuardianMessage, InspectionResult, MemoryCandidate } from "./types.js";
+export declare class GuardianBridgeError extends Error {
+}
+export declare function normalizeDeepSeekMessages(_system: string | undefined, messages: readonly any[]): GuardianMessage[];
+export declare class GuardianBridge {
+    inspect(ctx: Context, agent: Agent, messages: GuardianMessage[], signal: AbortSignal): Promise<InspectionResult>;
+    guidance(ctx: Context, agent: Agent, candidates: MemoryCandidate[], decisions: Array<{
+        candidate_id: string;
+        action: "keep" | "drop";
+    }>, signal: AbortSignal): Promise<Guidance>;
+    private request;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/lib/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAiB,MAAM,YAAY,CAAC;AAK9G,qBAAa,mBAAoB,SAAQ,KAAK;CAAG;AAsBjD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,QAAQ,EAAE,SAAS,GAAG,EAAE,GACvB,eAAe,EAAE,CA8BnB;AAED,qBAAa,cAAc;IACnB,OAAO,CACX,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,eAAe,EAAE,EAC3B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAKtB,QAAQ,CACZ,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,eAAe,EAAE,EAC7B,SAAS,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,EACnE,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,QAAQ,CAAC;YASN,OAAO;CAmFtB"}

package/lib/bridge.js

@@ -0,0 +1,155 @@
+import { createInterface } from "node:readline";
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { generateStructuredWithHost } from "./host-model.js";
+const PROTOCOL_VERSION = 1;
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class GuardianBridgeError extends Error {
+}
+function pythonCommand() {
+    return process.env.CONTEXT_GUARDIAN_PYTHON || "python3";
+}
+function timeoutMs() {
+    const value = Number(process.env.CONTEXT_GUARDIAN_TIMEOUT_MS ?? DEFAULT_TIMEOUT_MS);
+    return Number.isFinite(value) && value > 0 ? Math.min(Math.floor(value), 120_000) : DEFAULT_TIMEOUT_MS;
+}
+function pythonEnvironment() {
+    const environment = {};
+    for (const name of ["PATH", "LANG", "LC_ALL", "TMPDIR", "TMP", "TEMP"]) {
+        const value = process.env[name];
+        if (value !== undefined)
+            environment[name] = value;
+    }
+    const pythonPath = process.env.CONTEXT_GUARDIAN_PYTHONPATH;
+    if (pythonPath !== undefined)
+        environment.PYTHONPATH = pythonPath;
+    return environment;
+}
+export function normalizeDeepSeekMessages(_system, messages) {
+    const result = [];
+    for (const [index, message] of messages.entries()) {
+        if (message.role === "system")
+            continue;
+        const sourceKind = message.source?.kind;
+        const role = sourceKind === "tool" ? "tool" : String(message.role ?? "unknown");
+        const blocks = Array.isArray(message.content) ? message.content : [message.content];
+        const content = blocks.map((block) => {
+            if (typeof block === "string")
+                return block;
+            if (block?.type === "text" || block?.type === "reasoning")
+                return String(block.text ?? "");
+            if (block?.type === "tool-call")
+                return `Tool call ${String(block.name ?? "")}: ${String(block.arguments ?? "")}`;
+            if (block?.type === "tool-result") {
+                const inner = Array.isArray(block.content) ? block.content : [];
+                return inner.map((item) => item?.type === "text" ? String(item.text ?? "") : "").join("\n");
+            }
+            return "";
+        }).filter(Boolean).join("\n").trim();
+        if (!content)
+            continue;
+        const error = blocks.some((block) => block?.type === "tool-result" && block.isError === true);
+        result.push({
+            role,
+            content,
+            id: String(message.id ?? `dsh_message_${String(index + 1).padStart(4, "0")}`),
+            is_error: error,
+            metadata: { source: sourceKind },
+        });
+    }
+    return result;
+}
+export class GuardianBridge {
+    async inspect(ctx, agent, messages, signal) {
+        const result = await this.request(ctx, agent, "inspect", { messages, provider: "host" }, signal);
+        return result;
+    }
+    async guidance(ctx, agent, candidates, decisions, signal) {
+        const result = await this.request(ctx, agent, "guidance", {
+            candidates,
+            decisions,
+            provider: "rules",
+        }, signal);
+        return result;
+    }
+    async request(ctx, agent, operation, body, signal) {
+        const child = spawn(pythonCommand(), ["-m", "context_guardian", "bridge", "--stdio"], {
+            cwd: agent.session.header.cwd ?? process.cwd(),
+            shell: false,
+            env: pythonEnvironment(),
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const requestId = randomUUID();
+        const readline = createInterface({ input: child.stdout });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => { stderr = `${stderr}${String(chunk)}`.slice(-4000); });
+        const abort = () => child.kill("SIGTERM");
+        signal.addEventListener("abort", abort, { once: true });
+        const timer = setTimeout(() => child.kill("SIGTERM"), timeoutMs());
+        try {
+            child.stdin.write(JSON.stringify({
+                protocol_version: PROTOCOL_VERSION,
+                type: "request",
+                request_id: requestId,
+                operation,
+                ...body,
+            }) + "\n");
+            for await (const line of readline) {
+                if (!line.trim())
+                    continue;
+                let frame;
+                try {
+                    frame = JSON.parse(line);
+                }
+                catch {
+                    throw new GuardianBridgeError("Context Guardian returned invalid JSON");
+                }
+                if (frame.protocol_version !== PROTOCOL_VERSION) {
+                    throw new GuardianBridgeError("Context Guardian returned an unsupported protocol version");
+                }
+                if (frame.type === "error")
+                    throw new GuardianBridgeError(frame.error ?? "Context Guardian protocol error");
+                if (frame.type === "provider_request") {
+                    if (!frame.request_id || !frame.prompt || !frame.schema) {
+                        throw new GuardianBridgeError("Context Guardian provider request is malformed");
+                    }
+                    try {
+                        const data = await generateStructuredWithHost(ctx, agent, frame.prompt, frame.schema, signal);
+                        child.stdin.write(JSON.stringify({
+                            protocol_version: PROTOCOL_VERSION,
+                            type: "provider_response",
+                            request_id: frame.request_id,
+                            ok: true,
+                            data,
+                        }) + "\n");
+                    }
+                    catch (error) {
+                        child.stdin.write(JSON.stringify({
+                            protocol_version: PROTOCOL_VERSION,
+                            type: "provider_response",
+                            request_id: frame.request_id,
+                            ok: false,
+                            error: error instanceof Error ? error.message : String(error),
+                        }) + "\n");
+                    }
+                    continue;
+                }
+                if (frame.type !== "result" || frame.request_id !== requestId) {
+                    throw new GuardianBridgeError("Context Guardian returned an unrelated response");
+                }
+                if (!frame.ok)
+                    throw new GuardianBridgeError(frame.error ?? "Context Guardian request failed");
+                return frame.result;
+            }
+            throw new GuardianBridgeError(stderr || "Context Guardian process exited without a result");
+        }
+        finally {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", abort);
+            readline.close();
+            if (!child.killed)
+                child.kill("SIGTERM");
+        }
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/lib/bridge.js.map

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

package/lib/host-model.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from "@deepseek-ai/cordis";
+import type { Agent } from "@deepseek-ai/dsh-agent";
+export declare function generateStructuredWithHost(ctx: Context, agent: Agent, prompt: string, schema: Record<string, unknown>, signal: AbortSignal): Promise<unknown>;
+//# sourceMappingURL=host-model.d.ts.map

package/lib/host-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-model.d.ts","sourceRoot":"","sources":["../src/host-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAyBpD,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,OAAO,CAAC,CAgClB"}

package/lib/host-model.js

@@ -0,0 +1,54 @@
+import { BlockAssembler, createUserMessage, LlmError } from "@deepseek-ai/dsh-llm";
+function extractJson(text) {
+    const trimmed = text.trim();
+    const fenced = trimmed.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
+    return JSON.parse(fenced?.[1] ?? trimmed);
+}
+function routeFor(agent) {
+    const config = agent.session.requestHeader()?.config;
+    if (config === undefined || config.provider.length === 0 || config.model.length === 0) {
+        throw new Error("DeepSeek Harness has no active provider/model route");
+    }
+    return { provider: config.provider, model: config.model };
+}
+function textFromBlocks(blocks) {
+    return blocks
+        .filter((block) => block.type === "text" || block.type === "reasoning")
+        .map((block) => block.text ?? "")
+        .join("\n")
+        .trim();
+}
+export async function generateStructuredWithHost(ctx, agent, prompt, schema, signal) {
+    const route = routeFor(agent);
+    const assembler = new BlockAssembler();
+    const request = ctx.llm.stream({
+        provider: route.provider,
+        model: route.model,
+        system: "You are a structured extraction service. Return only valid JSON matching the supplied JSON Schema. Do not use tools.",
+        messages: [createUserMessage({
+                content: [{
+                        type: "text",
+                        text: `${prompt}\n\nJSON Schema:\n${JSON.stringify(schema)}`,
+                    }],
+                source: { kind: "plugin", plugin: "context-guardian-deepseek-harness" },
+            })],
+        maxTokens: 4096,
+        sessionId: agent.session.id,
+        purpose: "compaction",
+        signal,
+    });
+    for await (const chunk of request)
+        assembler.push(chunk);
+    const finish = assembler.finish;
+    if (finish.kind === "error" || finish.kind === "aborted") {
+        throw new LlmError(finish.failure.message, finish.failure.code);
+    }
+    if (finish.kind === "max-tokens") {
+        throw new Error("structured Context Guardian extraction reached the token cap");
+    }
+    const text = textFromBlocks(assembler.blocks());
+    if (text.length === 0)
+        throw new Error("DeepSeek Harness returned no structured extraction text");
+    return extractJson(text);
+}
+//# sourceMappingURL=host-model.js.map

package/lib/host-model.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,16 @@
+import { BasicCompactionEngine } from "@deepseek-ai/dsh-compaction-basic";
+import type { Agent } from "@deepseek-ai/dsh-agent";
+export declare const name = "context-guardian-deepseek-harness";
+type NativeSummarize = BasicCompactionEngine["summarize"];
+type NativeSummarizeInput = Parameters<NativeSummarize>[0];
+type NativeSummarizeResult = Awaited<ReturnType<NativeSummarize>>;
+/**
+ * Decorates DeepSeek Harness's native backend with Context Guardian review.
+ * The inherited engine still owns selection, shrink checks, durable markers,
+ * session replacement, and the final structured checkpoint summary.
+ */
+export declare class ContextGuardianCompactionEngine extends BasicCompactionEngine {
+    protected summarize(input: NativeSummarizeInput, agent: Agent, signal?: AbortSignal): Promise<NativeSummarizeResult>;
+}
+export default ContextGuardianCompactionEngine;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAMpD,eAAO,MAAM,IAAI,sCAAsC,CAAC;AAMxD,KAAK,eAAe,GAAG,qBAAqB,CAAC,WAAW,CAAC,CAAC;AAC1D,KAAK,oBAAoB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,KAAK,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;AAkGlE;;;;GAIG;AACH,qBAAa,+BAAgC,SAAQ,qBAAqB;cAC/C,SAAS,CAChC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,KAAK,EACZ,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC;CA+BlC;AAED,eAAe,+BAA+B,CAAC"}

package/lib/index.js

@@ -0,0 +1,126 @@
+import { BasicCompactionEngine } from "@deepseek-ai/dsh-compaction-basic";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { GuardianBridge, normalizeDeepSeekMessages } from "./bridge.js";
+export const name = "context-guardian-deepseek-harness";
+if (process.env.CONTEXT_GUARDIAN_DEBUG === "1") {
+    console.error("context guardian: adapter module loaded");
+}
+const bridge = new GuardianBridge();
+const KEEP = "Keep";
+const DROP = "Drop";
+function debug(ctx, message) {
+    if (process.env.CONTEXT_GUARDIAN_DEBUG === "1") {
+        const line = `context guardian: ${message}`;
+        console.error(line);
+        ctx.logger.info(line);
+    }
+}
+function candidateDetail(candidate) {
+    const reason = candidate.reason ? `\n\nReason: ${candidate.reason}` : "";
+    return `Category: ${candidate.category}\nImportance: ${candidate.importance.toFixed(2)} · Confidence: ${candidate.confidence.toFixed(2)}\n\n${candidate.content}${reason}`;
+}
+function reviewQuestions(candidates) {
+    return candidates.map((candidate) => ({
+        id: candidate.id,
+        header: `Context Guardian · ${candidate.category}`,
+        question: "Keep this memory in the compaction guidance?",
+        detail: candidateDetail(candidate),
+        options: [
+            { label: KEEP, description: "Tell the native compactor to preserve this item." },
+            { label: DROP, description: "Tell the native compactor this item may be discarded." },
+        ],
+    }));
+}
+function keepAll(candidates) {
+    return candidates.map((candidate) => ({ candidate_id: candidate.id, action: "keep" }));
+}
+function errorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : undefined;
+}
+async function review(ctx, agent, candidates, signal) {
+    if (candidates.length === 0)
+        return [];
+    const mode = process.env.CONTEXT_GUARDIAN_REVIEW_MODE;
+    if (mode === "keep")
+        return keepAll(candidates);
+    if (mode === "drop")
+        return candidates.map((candidate) => ({ candidate_id: candidate.id, action: "drop" }));
+    const interaction = ctx.get("userQuestions");
+    debug(ctx, `reviewing ${String(candidates.length)} candidate(s); userQuestions=${interaction === undefined ? "unavailable" : "available"}`);
+    if (interaction === undefined)
+        return keepAll(candidates);
+    try {
+        const answer = await interaction.ask({
+            questions: reviewQuestions(candidates),
+            agent,
+            signal,
+        });
+        const byId = new Map(answer.answers.map((item) => [item.id, item]));
+        return candidates.map((candidate) => {
+            const item = byId.get(candidate.id);
+            if (item?.custom !== undefined || item?.selected.length !== 1) {
+                throw new Error(`Context Guardian received an invalid answer for ${candidate.id}`);
+            }
+            if (item.selected[0] === KEEP)
+                return { candidate_id: candidate.id, action: "keep" };
+            if (item.selected[0] === DROP)
+                return { candidate_id: candidate.id, action: "drop" };
+            throw new Error(`Context Guardian received an unknown answer for ${candidate.id}`);
+        });
+    }
+    catch (error) {
+        debug(ctx, `userQuestions failed with ${errorCode(error) ?? (error instanceof Error ? error.message : String(error))}`);
+        // Headless compositions commonly provide the service seam without a UI
+        // answerer. Treat that case conservatively; an explicit cancellation or
+        // protocol failure is allowed to fail open to native compaction below.
+        if (errorCode(error) === "NO_PROVIDER")
+            return keepAll(candidates);
+        throw error;
+    }
+}
+function nativeInputWithGuidance(input, text) {
+    const guidanceMessage = createUserMessage({
+        content: [{ type: "text", text }],
+        source: { kind: "plugin", plugin: name },
+    });
+    return {
+        ...input,
+        messages: [...input.messages, guidanceMessage],
+    };
+}
+function normalizeInput(input) {
+    const candidate = input;
+    return normalizeDeepSeekMessages(candidate.system, input.messages);
+}
+/**
+ * Decorates DeepSeek Harness's native backend with Context Guardian review.
+ * The inherited engine still owns selection, shrink checks, durable markers,
+ * session replacement, and the final structured checkpoint summary.
+ */
+export class ContextGuardianCompactionEngine extends BasicCompactionEngine {
+    async summarize(input, agent, signal) {
+        let guidedInput;
+        try {
+            const operationSignal = signal ?? new AbortController().signal;
+            const inspection = await bridge.inspect(this.ctx, agent, normalizeInput(input), operationSignal);
+            debug(this.ctx, `inspection returned ${String(inspection.candidates.length)} candidate(s), ${String(inspection.review.length)} for review`);
+            const decisions = [
+                ...keepAll(inspection.auto_keep),
+                ...inspection.auto_drop.map((candidate) => ({ candidate_id: candidate.id, action: "drop" })),
+                ...await review(this.ctx, agent, inspection.review, operationSignal),
+            ];
+            const guidance = await bridge.guidance(this.ctx, agent, inspection.candidates, decisions, operationSignal);
+            guidedInput = nativeInputWithGuidance(input, guidance.text);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.ctx.logger.warn(`context guardian unavailable; continuing native compaction: ${message}`);
+            return super.summarize(input, agent, signal);
+        }
+        return super.summarize(guidedInput, agent, signal);
+    }
+}
+export default ContextGuardianCompactionEngine;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/types.d.ts

@@ -0,0 +1,43 @@
+export interface GuardianMessage {
+    role: string;
+    content: string;
+    id: string;
+    tool_name?: string;
+    is_error?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface MemoryCandidate {
+    id: string;
+    content: string;
+    category: string;
+    importance: number;
+    confidence: number;
+    suggested_action: "keep" | "drop" | "review";
+    reason?: string | null;
+    source_message_ids: string[];
+}
+export interface InspectionResult {
+    candidates: MemoryCandidate[];
+    auto_keep: MemoryCandidate[];
+    auto_drop: MemoryCandidate[];
+    review: MemoryCandidate[];
+    mode: "rules" | "provider";
+    policy_version: string;
+}
+export interface Guidance {
+    must_preserve: string[];
+    can_discard: string[];
+    unresolved: string[];
+    text: string;
+}
+export interface ProtocolFrame {
+    protocol_version?: number;
+    type?: string;
+    request_id?: string;
+    ok?: boolean;
+    error?: string;
+    result?: unknown;
+    prompt?: string;
+    schema?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "context-guardian-deepseek-harness",
+  "version": "0.1.0",
+  "description": "Human review before DeepSeek Harness context compaction",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deulofeu1/context-guardian.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh-CN.md",
+    "tsconfig.json"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": ">=4.0.2 <5",
+    "@deepseek-ai/dsh-agent": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-compaction-basic": ">=0.1.5-rc.1 <0.1.6",
+    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.1 <0.1.6"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-agent": { "optional": false },
+    "@deepseek-ai/dsh-llm": { "optional": false }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test scripts/bridge.test.mjs",
+    "fixture-smoke": "node scripts/interactive-fixture-smoke.mjs"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-agent": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-compaction-basic": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm-replay": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session-persistence": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-user-questions": "0.1.5-rc.2",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.6.0"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*.ts"]
+}