@tickernelz/paperclip-pro-adapter-kimi-local 2026.925.0

package/dist/server/acp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp.test.d.ts","sourceRoot":"","sources":["../../src/server/acp.test.ts"],"names":[],"mappings":""}

package/dist/server/acp.test.js

@@ -0,0 +1,57 @@
+import { describe, expect, it } from "vitest";
+import { buildKimiAcpConfig, nodeVersionMeetsKimiAcpMinimum, resolveKimiExecutionEngine, } from "./acp.js";
+describe("resolveKimiExecutionEngine", () => {
+    it("defaults to ACP (non-explicit) when engine is unset", () => {
+        expect(resolveKimiExecutionEngine({})).toEqual({ engine: "acp", explicit: false });
+    });
+    it("honors an explicit engine=acp", () => {
+        expect(resolveKimiExecutionEngine({ engine: "acp" })).toEqual({ engine: "acp", explicit: true });
+    });
+    it("honors an explicit engine=cli", () => {
+        expect(resolveKimiExecutionEngine({ engine: "CLI" })).toEqual({ engine: "cli", explicit: true });
+    });
+    it("treats unknown values as the non-explicit ACP default", () => {
+        expect(resolveKimiExecutionEngine({ engine: "nonsense" })).toEqual({ engine: "acp", explicit: false });
+    });
+});
+describe("buildKimiAcpConfig", () => {
+    it("targets the kimi agent and derives the `kimi acp` server command from `command`", () => {
+        const out = buildKimiAcpConfig({ command: "kimi", cwd: "/work" });
+        expect(out.agent).toBe("kimi");
+        expect(out.agentCommand).toBe("kimi acp");
+        expect(out.mode).toBe("persistent");
+        expect(out.cwd).toBe("/work");
+    });
+    it("prefers an explicit agentCommand override", () => {
+        const out = buildKimiAcpConfig({ command: "kimi", agentCommand: "/opt/kimi acp --foo" });
+        expect(out.agentCommand).toBe("/opt/kimi acp --foo");
+    });
+    it("drops the model when it equals the default so ACP uses the agent default", () => {
+        const out = buildKimiAcpConfig({ model: "kimi-code/kimi-for-coding" });
+        expect("model" in out).toBe(false);
+    });
+    it("keeps a non-default model", () => {
+        const out = buildKimiAcpConfig({ model: "kimi-code/k3" });
+        expect(out.model).toBe("kimi-code/k3");
+    });
+    it("strips CLI-lane effort so ACP is not sent the unsupported `effort` control", () => {
+        const out = buildKimiAcpConfig({ model: "kimi-code/k3", effort: "high", thinkingEffort: "high" });
+        expect("effort" in out).toBe(false);
+        expect("thinkingEffort" in out).toBe(false);
+    });
+    it("opts into the shared engine's verbose-backend handling", () => {
+        const out = buildKimiAcpConfig({ command: "kimi" });
+        expect(out.summaryStrategy).toBe("lastOutputSegment");
+        expect(out.coalescePlaceholderToolUpdates).toBe(true);
+    });
+});
+describe("nodeVersionMeetsKimiAcpMinimum", () => {
+    it("accepts Node >= 20", () => {
+        expect(nodeVersionMeetsKimiAcpMinimum("v22.0.0")).toBe(true);
+        expect(nodeVersionMeetsKimiAcpMinimum("v20.0.0")).toBe(true);
+    });
+    it("rejects Node < 20", () => {
+        expect(nodeVersionMeetsKimiAcpMinimum("v18.19.0")).toBe(false);
+    });
+});
+//# sourceMappingURL=acp.test.js.map

package/dist/server/acp.test.js.map

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

package/dist/server/engine-availability.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=engine-availability.test.d.ts.map

package/dist/server/engine-availability.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-availability.test.d.ts","sourceRoot":"","sources":["../../src/server/engine-availability.test.ts"],"names":[],"mappings":""}

package/dist/server/engine-availability.test.js

@@ -0,0 +1,41 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { resolveKimiExecutionEngineForRun } from "./acp.js";
+import { execute } from "./execute.js";
+import { testEnvironment } from "./test.js";
+const originalVersion = process.version;
+afterEach(() => Object.defineProperty(process, "version", { value: originalVersion }));
+describe("kimi engine availability", () => {
+    it.each([undefined, "auto", "acp"])("reports a setup failure for engine=%s without starting a process", async (engine) => {
+        Object.defineProperty(process, "version", { value: "v18.0.0" });
+        const config = { engine };
+        const onSpawn = vi.fn();
+        const result = await execute({ config, onSpawn });
+        expect(result).toMatchObject({
+            exitCode: 1,
+            errorCode: "adapter_engine_unavailable",
+            errorMessage: expect.stringContaining("Node v18.0.0"),
+            resultJson: { executionRecovery: { kind: "bootstrap", providerWorkStarted: false } },
+        });
+        expect(result.errorMessage).toContain(process.execPath);
+        expect(onSpawn).not.toHaveBeenCalled();
+        const diagnostic = await testEnvironment({ config });
+        expect(diagnostic.status).toBe("fail");
+        expect(diagnostic.checks).toContainEqual(expect.objectContaining({
+            code: "adapter_engine_unavailable", level: "error",
+        }));
+    });
+    it("does not apply ACP prerequisites to explicitly selected CLI", async () => {
+        Object.defineProperty(process, "version", { value: "v18.0.0" });
+        await expect(resolveKimiExecutionEngineForRun({ config: { engine: "cli" } }))
+            .resolves.toEqual({ engine: "cli", explicit: true });
+    });
+    it("keeps an unavailable ACP command as a failure, not a CLI selection", async () => {
+        Object.defineProperty(process, "version", { value: "v24.11.0" });
+        const result = await resolveKimiExecutionEngineForRun({
+            config: { agentCommand: "/nonexistent/paperclip-test/acp", command: "/nonexistent/paperclip-test/acp" },
+        });
+        expect(result.engine).toBe("acp");
+        expect(result.unavailableReason).toContain("not available");
+    });
+});
+//# sourceMappingURL=engine-availability.test.js.map

package/dist/server/engine-availability.test.js.map

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

package/dist/server/execute.acp-failure.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execute.acp-failure.test.d.ts.map

package/dist/server/execute.acp-failure.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.acp-failure.test.d.ts","sourceRoot":"","sources":["../../src/server/execute.acp-failure.test.ts"],"names":[],"mappings":""}

package/dist/server/execute.acp-failure.test.js

@@ -0,0 +1,22 @@
+import { describe, expect, it, vi } from "vitest";
+const { executeAcp, runProcess } = vi.hoisted(() => ({
+    executeAcp: vi.fn(async () => { throw new Error("ACP session startup failed"); }),
+    runProcess: vi.fn(),
+}));
+vi.mock("./acp.js", () => ({
+    createKimiAcpExecutor: () => executeAcp,
+    resolveKimiExecutionEngineForRun: async () => ({ engine: "acp", explicit: false }),
+}));
+vi.mock("@tickernelz/paperclip-pro-adapter-utils/execution-target", async (importOriginal) => ({
+    ...await importOriginal(),
+    runAdapterExecutionTargetProcess: runProcess,
+}));
+import { execute } from "./execute.js";
+describe("Kimi ACP failure handling", () => {
+    it("does not replay a failed default ACP invocation through CLI", async () => {
+        await expect(execute({ config: {} })).rejects.toThrow("ACP session startup failed");
+        expect(executeAcp).toHaveBeenCalledTimes(1);
+        expect(runProcess).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=execute.acp-failure.test.js.map

package/dist/server/execute.acp-failure.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.acp-failure.test.js","sourceRoot":"","sources":["../../src/server/execute.acp-failure.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACnD,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;CACpB,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;IACzB,qBAAqB,EAAE,GAAG,EAAE,CAAC,UAAU;IACvC,gCAAgC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;CACnF,CAAC,CAAC,CAAC;AACJ,EAAE,CAAC,IAAI,CAAC,0DAA0D,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;IAC7F,GAAG,MAAM,cAAc,EAA6E;IACpG,gCAAgC,EAAE,UAAU;CAC7C,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAW,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC7F,MAAM,CAAC,UAAU,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/server/execute.d.ts

@@ -0,0 +1,3 @@
+import type { AdapterExecutionContext, AdapterExecutionResult } from "@tickernelz/paperclip-pro-adapter-utils";
+export declare function execute(ctx: AdapterExecutionContext): Promise<AdapterExecutionResult>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/server/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/server/execute.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAuL/G,wBAAsB,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAujB3F"}