@scotthuang/agent-knock-knock-deepseek-harness 0.1.0-rc.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Knock Knock contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# Agent Knock Knock for DeepSeek Harness
+
+This package is the native DeepSeek Harness Web connector for Agent Knock
+Knock (AKK). Installing the bundle adds `/akk` and the 16 AKK semantic tools to
+every live Agent immediately. There is no `/akk-bind` step and no session id for
+the user to copy.
+
+The connector is developed in the AKK repository but is an independent npm
+package. It does not modify DeepSeek Harness and has its own version, build,
+tests, lockfile, bundle manifest, and future release tag.
+
+## Compatibility
+
+The first release intentionally supports exactly DeepSeek Harness
+`0.1.1-rc.2` on the resident Web Host and Node.js `>=22.19.0`. Activation locates
+the real `@deepseek-ai/dsh` launcher and requires that launcher plus its
+`dsh-agent`, `dsh-commands`, `dsh-llm`, and `dsh-tools` package set to be exact
+`0.1.1-rc.2`; an unsupported, missing, or split Host fails before mounting.
+
+Headless/one-shot Harness processes, Host-exit callback continuity, and Windows
+named pipes are not supported in this release.
+
+## Installation
+
+Once this connector has been published, add its bundle to the Web profile:
+
+```sh
+dsh plugin --profile web add @scotthuang/agent-knock-knock-deepseek-harness@next
+```
+
+For development in this repository, build the AKK root package and this child
+package, then add the child directory with the DeepSeek Harness plugin command.
+The published connector depends on the exact AKK runtime version `0.12.16` so
+the Host Adapter API it was tested against cannot drift unexpectedly.
+
+The optional bundle patch mounts only the Host plugin:
+
+```yaml
+- insert:
+    - id: agent-knock-knock-deepseek-harness
+      name: '@scotthuang/agent-knock-knock-deepseek-harness'
+```
+
+## Runtime model
+
+- A slash-command invocation receives the exact DSH `Agent` from the command
+  service; a tool invocation receives the exact `exec.agent` from the tools
+  service.
+- The connector validates `ctx.agents.get(agent.id) === agent` and creates a
+  private controller id containing a Host-instance nonce, an Agent-incarnation
+  nonce, and that Agent's id. Replacing an Agent with the same session id does
+  not inherit its route.
+- One shared AKK lifecycle service runs per DSH Host. The root AKK Host Adapter
+  retains one private tool/command authority registry per exact Agent object.
+- DSH receives a discovery schema projected into its enforced rc.2 subset.
+  Before a tool can reach the Host Adapter, the connector validates its input
+  against the complete original AKK JSON Schema, including conditional,
+  pattern, and numeric constraints that DSH discovery cannot represent.
+- A private `0700` temporary directory contains the route-bound Host Profile
+  and Unix socket. The callback helper is launched with `process.execPath`; its
+  socket path and random token are inherited through an allowlisted environment
+  and never placed in command arguments.
+- Completion callbacks go to the initiating Agent's route. A running Agent
+  receives `inject()` and an idle Agent receives `followup()`.
+- The synchronous callback acknowledgement means the message was admitted to
+  the DSH inbox/session log. It does not claim that the model consumed the
+  message or that asynchronous persistence reached stable storage. AKK
+  `watch`/`status` remain the recovery path.
+- A Host restart creates a new private Profile revision. A Terminal Watch
+  persists its complete initiating route, so callbacks owned by the previous
+  Host incarnation fail closed instead of being redirected to a new Agent.
+  There is deliberately no cross-restart callback continuity in this release;
+  inspect it with `status`, or `unwatch` it and create a fresh `watch` under
+  the new Host incarnation.
+- Exact, process-lifetime idempotency records return the original acceptance id
+  for a duplicate. Reusing one idempotency key for different callback content
+  is rejected.
+
+## Configuration
+
+The connector accepts an optional lifecycle cadence and the existing AKK plugin
+configuration object:
+
+```yaml
+- id: agent-knock-knock-deepseek-harness
+  name: '@scotthuang/agent-knock-knock-deepseek-harness'
+  config:
+    lifecycleIntervalMs: 5000
+    pluginConfig:
+      storeDir: /absolute/path/to/akk-store
+```
+
+## Development
+
+Only the fast test tier is used during development:
+
+```sh
+npm install
+npm run typecheck
+npm run test:fast
+npm run pack:check
+```
+
+No connector package is published by these commands.
+
+## Release safety
+
+`npm run release:check` is check-only. The script rejects a dirty tree, a
+non-`main` branch, an unsynchronized upstream, an existing npm version, and any
+runtime `file:`, `link:`, or `workspace:` dependency.
+
+Publishing additionally requires both explicit flags:
+
+```sh
+npm run release:check -- --publish --confirm-version 0.1.0-rc.1
+```
+
+Prereleases use npm tag `next`; stable versions use `latest`. Repository tags
+and GitHub Releases use the connector-specific namespace
+`deepseek-harness-v<version>` and are created separately after npm verification.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# Optional Web Profile bundle: mount the AKK native connector on the Host plane.
+- insert:
+    - id: agent-knock-knock-deepseek-harness
+      name: '@scotthuang/agent-knock-knock-deepseek-harness'

package/lib/callback-helper.d.ts

@@ -0,0 +1,14 @@
+import type { CallbackAcknowledgement } from "./routes.js";
+export interface CallbackHelperArguments {
+    readonly controllerId: string;
+    readonly deliveryId: string;
+    readonly messageId: string;
+    readonly idempotencyKey: string;
+}
+/** Execute the Profile callback helper without exposing IPC authority in argv. */
+export declare function runCallbackHelper(options: {
+    readonly arguments: CallbackHelperArguments;
+    readonly body: string;
+    readonly environment: Readonly<NodeJS.ProcessEnv>;
+}): Promise<CallbackAcknowledgement>;
+export declare function parseCallbackHelperArguments(argv: readonly string[]): CallbackHelperArguments;

package/lib/callback-helper.js

@@ -0,0 +1,122 @@
+import fs from "node:fs";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { CALLBACK_MAX_REQUEST_BYTES, CALLBACK_SOCKET_ENV, CALLBACK_TOKEN_ENV, } from "./constants.js";
+import { sendCallbackOverIpc } from "./ipc.js";
+/** Execute the Profile callback helper without exposing IPC authority in argv. */
+export async function runCallbackHelper(options) {
+    const socketPath = requiredEnvironment(options.environment[CALLBACK_SOCKET_ENV], CALLBACK_SOCKET_ENV);
+    const token = requiredEnvironment(options.environment[CALLBACK_TOKEN_ENV], CALLBACK_TOKEN_ENV);
+    const request = {
+        ...options.arguments,
+        body: options.body,
+        token,
+    };
+    const response = await sendCallbackOverIpc({ socketPath, request });
+    return {
+        request: {
+            delivery_id: options.arguments.deliveryId,
+            message_id: options.arguments.messageId,
+        },
+        result: {
+            status: response.status,
+            ...(response.acceptanceId ? { acceptance_id: response.acceptanceId } : {}),
+            ...(response.errorCode ? { error_code: response.errorCode } : {}),
+        },
+    };
+}
+export function parseCallbackHelperArguments(argv) {
+    const values = new Map();
+    const supported = new Set([
+        "--controller-id",
+        "--delivery-id",
+        "--message-id",
+        "--idempotency-key",
+    ]);
+    for (let index = 0; index < argv.length; index += 2) {
+        const flag = argv[index];
+        const value = argv[index + 1];
+        if (!flag || !supported.has(flag) || !value || values.has(flag)) {
+            throw new Error("invalid AKK callback helper arguments");
+        }
+        values.set(flag, value);
+    }
+    return {
+        controllerId: requiredArgument(values, "--controller-id"),
+        deliveryId: requiredArgument(values, "--delivery-id"),
+        messageId: requiredArgument(values, "--message-id"),
+        idempotencyKey: requiredArgument(values, "--idempotency-key"),
+    };
+}
+async function main() {
+    let parsed;
+    try {
+        parsed = parseCallbackHelperArguments(process.argv.slice(2));
+        const body = await readStandardInput();
+        const acknowledgement = await runCallbackHelper({
+            arguments: parsed,
+            body,
+            environment: process.env,
+        });
+        process.stdout.write(`${JSON.stringify(acknowledgement)}\n`);
+    }
+    catch {
+        if (parsed) {
+            const fallback = {
+                request: {
+                    delivery_id: parsed.deliveryId,
+                    message_id: parsed.messageId,
+                },
+                result: {
+                    status: "retry",
+                    error_code: "callback_ipc_unavailable",
+                },
+            };
+            process.stdout.write(`${JSON.stringify(fallback)}\n`);
+            return;
+        }
+        process.stderr.write("agent-knock-knock callback helper configuration is invalid\n");
+        process.exitCode = 2;
+    }
+}
+async function readStandardInput() {
+    const chunks = [];
+    let bytes = 0;
+    for await (const chunk of process.stdin) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        bytes += buffer.length;
+        if (bytes > CALLBACK_MAX_REQUEST_BYTES) {
+            throw new Error("AKK callback body exceeded its limit");
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+}
+function requiredArgument(values, flag) {
+    const value = values.get(flag);
+    if (!value || value.trim() !== value) {
+        throw new Error(`missing ${flag}`);
+    }
+    return value;
+}
+function requiredEnvironment(value, name) {
+    if (!value || value.trim() !== value) {
+        throw new Error(`missing ${name}`);
+    }
+    return value;
+}
+if (isDirectExecution()) {
+    void main();
+}
+function isDirectExecution() {
+    if (!process.argv[1])
+        return false;
+    try {
+        return fs.realpathSync(fileURLToPath(import.meta.url)) ===
+            fs.realpathSync(process.argv[1]);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=callback-helper.js.map

package/lib/callback-helper.js.map

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

package/lib/constants.d.ts

@@ -0,0 +1,20 @@
+export declare const CONNECTOR_NAME = "agent-knock-knock-deepseek-harness";
+export declare const CONNECTOR_PACKAGE = "@scotthuang/agent-knock-knock-deepseek-harness";
+export declare const CONNECTOR_VERSION = "0.1.0-rc.1";
+export declare const DSH_LAUNCHER_PACKAGE = "@deepseek-ai/dsh";
+export declare const SUPPORTED_DSH_VERSION = "0.1.1-rc.2";
+export declare const SUPPORTED_DSH_RUNTIME_PACKAGES: readonly ["@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-tools"];
+export declare const SUPPORTED_DSH_AGENT_VERSION = "0.1.1-rc.2";
+export declare const DSH_HOST_ID = "deepseek-harness";
+export declare const DSH_HOST_VERSION = "0.1.1-rc.2";
+export declare const CONTROLLER_ID_ENV = "AKK_DSH_CONTROLLER_ID";
+export declare const CALLBACK_SOCKET_ENV = "AKK_DSH_CALLBACK_SOCKET";
+export declare const CALLBACK_TOKEN_ENV = "AKK_DSH_CALLBACK_TOKEN";
+export declare const HOST_PROFILE_SELECTION_ENV = "AKK_HOST_PROFILE_SELECTION";
+export declare const HOST_PROFILE_SOURCE_ENV = "AKK_HOST_PROFILE_SOURCE";
+export declare const HOST_PROFILE_FINGERPRINT_ENV = "AKK_HOST_PROFILE_FINGERPRINT";
+export declare const HOST_PROFILE_HOST_ENV = "AKK_HOST_PROFILE_HOST";
+export declare const HOST_PROFILE_HOST_VERSION_ENV = "AKK_HOST_PROFILE_HOST_VERSION";
+export declare const CALLBACK_MAX_REQUEST_BYTES: number;
+export declare const CALLBACK_MAX_RESPONSE_BYTES: number;
+export declare const CALLBACK_TIMEOUT_MS = 8000;

package/lib/constants.js

@@ -0,0 +1,26 @@
+export const CONNECTOR_NAME = "agent-knock-knock-deepseek-harness";
+export const CONNECTOR_PACKAGE = "@scotthuang/agent-knock-knock-deepseek-harness";
+export const CONNECTOR_VERSION = "0.1.0-rc.1";
+export const DSH_LAUNCHER_PACKAGE = "@deepseek-ai/dsh";
+export const SUPPORTED_DSH_VERSION = "0.1.1-rc.2";
+export const SUPPORTED_DSH_RUNTIME_PACKAGES = Object.freeze([
+    "@deepseek-ai/dsh-agent",
+    "@deepseek-ai/dsh-commands",
+    "@deepseek-ai/dsh-llm",
+    "@deepseek-ai/dsh-tools",
+]);
+export const SUPPORTED_DSH_AGENT_VERSION = SUPPORTED_DSH_VERSION;
+export const DSH_HOST_ID = "deepseek-harness";
+export const DSH_HOST_VERSION = SUPPORTED_DSH_VERSION;
+export const CONTROLLER_ID_ENV = "AKK_DSH_CONTROLLER_ID";
+export const CALLBACK_SOCKET_ENV = "AKK_DSH_CALLBACK_SOCKET";
+export const CALLBACK_TOKEN_ENV = "AKK_DSH_CALLBACK_TOKEN";
+export const HOST_PROFILE_SELECTION_ENV = "AKK_HOST_PROFILE_SELECTION";
+export const HOST_PROFILE_SOURCE_ENV = "AKK_HOST_PROFILE_SOURCE";
+export const HOST_PROFILE_FINGERPRINT_ENV = "AKK_HOST_PROFILE_FINGERPRINT";
+export const HOST_PROFILE_HOST_ENV = "AKK_HOST_PROFILE_HOST";
+export const HOST_PROFILE_HOST_VERSION_ENV = "AKK_HOST_PROFILE_HOST_VERSION";
+export const CALLBACK_MAX_REQUEST_BYTES = 2 * 1024 * 1024;
+export const CALLBACK_MAX_RESPONSE_BYTES = 64 * 1024;
+export const CALLBACK_TIMEOUT_MS = 8_000;
+//# sourceMappingURL=constants.js.map

package/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,oCAAoC,CAAC;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAC5B,gDAAgD,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAClD,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1D,wBAAwB;IACxB,2BAA2B;IAC3B,sBAAsB;IACtB,wBAAwB;CAChB,CAAC,CAAC;AACZ,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAAC;AACjE,MAAM,CAAC,MAAM,WAAW,GAAG,kBAAkB,CAAC;AAC9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAEtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AACzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAC7D,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAE3D,MAAM,CAAC,MAAM,0BAA0B,GAAG,4BAA4B,CAAC;AACvE,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AACjE,MAAM,CAAC,MAAM,4BAA4B,GAAG,8BAA8B,CAAC;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,+BAA+B,CAAC;AAE7E,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1D,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,GAAG,IAAI,CAAC;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,38 @@
+/** Native, no-bind Agent Knock Knock integration for DeepSeek Harness Web. */
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+import { createHostAdapter } from "@scotthuang/agent-knock-knock/host-adapter";
+import { createCallbackIpcServer } from "./ipc.js";
+import { createConnectorProfileResources } from "./profile.js";
+export declare const name = "agent-knock-knock-deepseek-harness";
+export declare const inject: string[];
+export interface Config {
+    /** AKK reconciliation cadence for the one shared Host lifecycle service. */
+    lifecycleIntervalMs?: number;
+    /** Existing AKK plugin options such as storeDir or executor timeouts. */
+    pluginConfig?: Record<string, unknown>;
+}
+export declare const Config: z<Config>;
+/**
+ * Mount `/akk`, all 16 semantic AKK tools, one callback route table, and one
+ * Host-owned lifecycle service. No explicit bind command or per-session setup
+ * exists: the exact command/tool Agent becomes the callback owner lazily.
+ */
+export declare function apply(ctx: Context, config?: Config): Promise<() => Promise<void>>;
+/** @internal Strict dependency seam used by the connector's native wiring tests. */
+export interface ConnectorDependencies {
+    readonly assertSupportedDeepSeekHarness: () => void;
+    readonly createConnectorProfileResources: typeof createConnectorProfileResources;
+    readonly createCallbackIpcServer: typeof createCallbackIpcServer;
+    readonly createHostAdapter: typeof createHostAdapter;
+}
+/** @internal Mount with replaceable process/IPC seams for deterministic tests. */
+export declare function applyWithDependencies(ctx: Context, config?: Config, dependencies?: Partial<ConnectorDependencies>): Promise<() => Promise<void>>;
+export interface DeepSeekHarnessManifestResolver {
+    launcherManifest(): unknown;
+    runtimePackageManifest(packageName: string): unknown;
+}
+/** @internal Resolve compatibility evidence only from the real DSH launcher tree. */
+export declare function createDeepSeekHarnessManifestResolver(launcherEntryPath?: string | undefined): DeepSeekHarnessManifestResolver;
+/** @internal Fail before mounting if the launcher-owned DSH package set split. */
+export declare function assertSupportedDeepSeekHarness(resolver?: DeepSeekHarnessManifestResolver): void;