@halofy/agent-connect 0.2.0 → 0.3.0

package/README.md

@@ -19,7 +19,7 @@ agent connections:
 There is one setup path for every packaged client:
 
 ```bash
-npx --yes @halofy/agent-connect@0.2.0 install <client-kind> \
+npx --yes @halofy/agent-connect@0.3.0 install <client-kind> \
   --server https://app.halofy.ai \
   --claim '<one-time-claim>'
 ```
@@ -32,6 +32,7 @@ permits only these reviewed client kinds:
 | `claude-code` | complete for declared text/tool lifecycle hooks | image bodies, artifact bodies, context-use evidence |
 | `cursor` | complete for declared text/tool lifecycle hooks | image bodies, artifact bodies, context-use evidence |
 | `gemini-cli` | complete for declared text/tool lifecycle hooks | image bodies, artifact bodies, subagents, context-use evidence |
+| `kimi-cli` | partial | assistant responses, image and artifact bodies, context-use evidence |
 | `codex` | partial | assistant responses, tool failures, session end, binary bodies |
 | `vscode` | partial | assistant responses, binary bodies, context-use evidence |
 | `cline` | partial | assistant responses, tool failures, subagents, compaction, session end, binary bodies |
@@ -60,7 +61,7 @@ and query rules. Publication is fail-closed until the package tarball, current
 Claude fixtures, cross-implementation signature fixtures, and deployed server
 protocol have all passed for the exact version. Server versions configured
 with the Claude-only `0.1.x` artifact keep every additional client fenced as
-`Not supported yet`.
+`Not supported yet`; `0.2.x` keeps Kimi fenced until its `0.3.x` adapter.
 
 Every packaged adapter advertises archive protocol v1 explicitly. The Claude
 adapter's current

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@halofy/agent-connect",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Signed Halofy lifecycle installer and runtime for supported agents",
   "bin": {

package/src/client-registry.mjs

@@ -5,6 +5,7 @@ export const CLIENT_KINDS = Object.freeze([
   "vscode",
   "cline",
   "gemini-cli",
+  "kimi-cli",
 ]);
 
 const BASE_CAPABILITIES = Object.freeze({
@@ -80,6 +81,21 @@ export const CLIENT_REGISTRY = Object.freeze({
       compactionCheckpoints: true, contextRecalled: true,
     }),
   }),
+  "kimi-cli": Object.freeze({
+    clientKind: "kimi-cli",
+    label: "Kimi Code CLI",
+    command: "kimi",
+    coverage: "partial",
+    reason: "assistant_message_hook_unavailable",
+    capabilities: capabilities({
+      sessionStart: true, userPromptSubmit: true, stop: true, preCompact: true,
+      sessionEnd: true, subagentStart: true, subagentStop: true,
+      postToolUse: true, postToolUseFailure: true, userMessages: true,
+      toolInputs: true, toolOutputs: true, toolFailures: true,
+      artifactReferences: true, subagents: true, compactionCheckpoints: true,
+      contextRecalled: true,
+    }),
+  }),
   vscode: Object.freeze({
     clientKind: "vscode",
     label: "VS Code",

package/src/host-config.mjs

@@ -137,6 +137,68 @@ export async function configureGemini({
   return { configuredPaths: [settingsPath], hookEvents: Object.keys(GEMINI_HOOKS), replacedLegacyMcpEntries };
 }
 
+const KIMI_HOOKS = Object.freeze({
+  SessionStart: "SessionStart",
+  UserPromptSubmit: "UserPromptSubmit",
+  Stop: "Stop",
+  PostToolUse: "PostToolUse",
+  PostToolUseFailure: "PostToolUseFailure",
+  PreCompact: "PreCompact",
+  SessionEnd: "SessionEnd",
+  SubagentStart: "SubagentStart",
+  SubagentStop: "SubagentStop",
+});
+
+const KIMI_MANAGED_BEGIN = "# BEGIN HALOFY LIFECYCLE";
+const KIMI_MANAGED_END = "# END HALOFY LIFECYCLE";
+
+function replaceKimiManagedHooks(source, replacement) {
+  const text = String(source || "");
+  const start = text.indexOf(KIMI_MANAGED_BEGIN);
+  const end = text.indexOf(KIMI_MANAGED_END);
+  if ((start === -1) !== (end === -1) || (start !== -1 && end < start)) {
+    throw new Error("existing Halofy Kimi hook configuration is malformed");
+  }
+  const withoutManaged = start === -1
+    ? text
+    : `${text.slice(0, start)}${text.slice(end + KIMI_MANAGED_END.length)}`;
+  const body = withoutManaged.trimEnd();
+  return `${body ? `${body}\n\n` : ""}${replacement}\n`;
+}
+
+export async function configureKimi({
+  installationId,
+  nodePath = process.execPath,
+  runtimePath,
+  kimiRoot = process.env.KIMI_CODE_HOME || join(homedir(), ".kimi-code"),
+}) {
+  validateInputs({ installationId, runtimePath });
+  const configPath = join(kimiRoot, "config.toml");
+  let source = "";
+  try { source = await readFile(configPath, "utf8"); } catch (error) { if (error?.code !== "ENOENT") throw error; }
+  const hookBlock = [
+    KIMI_MANAGED_BEGIN,
+    ...Object.entries(KIMI_HOOKS).flatMap(([hostEvent, runtimeEvent]) => [
+      "[[hooks]]",
+      `event = ${JSON.stringify(hostEvent)}`,
+      `command = ${JSON.stringify(managedCommand(nodePath, runtimePath, runtimeEvent, installationId))}`,
+      "timeout = 20",
+      "",
+    ]),
+    KIMI_MANAGED_END,
+  ].join("\n");
+  const mcpPath = join(kimiRoot, "mcp.json");
+  const mcp = await readJson(mcpPath, {});
+  mcp.mcpServers = mcp.mcpServers && typeof mcp.mcpServers === "object" ? mcp.mcpServers : {};
+  const replacedLegacyMcpEntries = replaceHalofyMcpEntries(
+    mcp.mcpServers,
+    managedMcp(nodePath, runtimePath, installationId),
+  );
+  await writePrivateFile(configPath, replaceKimiManagedHooks(source, hookBlock));
+  await writePrivateFile(mcpPath, `${JSON.stringify(mcp, null, 2)}\n`);
+  return { configuredPaths: [configPath, mcpPath], hookEvents: Object.keys(KIMI_HOOKS), replacedLegacyMcpEntries };
+}
+
 const VSCODE_HOOKS = Object.freeze({
   SessionStart: "SessionStart",
   UserPromptSubmit: "UserPromptSubmit",

package/src/installer-cli.mjs

@@ -10,7 +10,7 @@ import {
   localMcpSnippet,
 } from "./install.mjs";
 import { configureClaudeProject } from "./claude-config.mjs";
-import { configureCline, configureCodex, configureCursor, configureGemini, configureVscode } from "./host-config.mjs";
+import { configureCline, configureCodex, configureCursor, configureGemini, configureKimi, configureVscode } from "./host-config.mjs";
 import { CLIENT_KINDS, lifecycleClient } from "./client-registry.mjs";
 import { defaultRuntimeDirectory } from "./storage.mjs";
 import { DISCLOSURE_VERSION, INSTALLER_VERSION } from "./version.mjs";
@@ -172,13 +172,15 @@ export async function runInstaller(argv, {
       ? await configureCursor(common)
       : input.clientKind === "gemini-cli"
         ? await configureGemini(common)
-        : input.clientKind === "vscode"
-          ? await configureVscode(common)
-          : input.clientKind === "codex"
-            ? await configureCodex(common)
-            : input.clientKind === "cline"
-              ? await configureCline(common)
-              : (() => { throw new Error("the selected adapter is not packaged yet"); })();
+        : input.clientKind === "kimi-cli"
+          ? await configureKimi(common)
+          : input.clientKind === "vscode"
+            ? await configureVscode(common)
+            : input.clientKind === "codex"
+              ? await configureCodex(common)
+              : input.clientKind === "cline"
+                ? await configureCline(common)
+                : (() => { throw new Error("the selected adapter is not packaged yet"); })();
   let heartbeat = false;
   try {
     heartbeat = await heartbeatInstalledConnection({

package/src/runtime.mjs

@@ -4,6 +4,7 @@ import { BoundedEncryptedQueue } from "./queue.mjs";
 import { CursorStore, deriveSessionHash, readClaudeTranscriptSuffix } from "./session.mjs";
 import { SignedRuntimeTransport } from "./transport.mjs";
 import { withFileLock } from "./storage.mjs";
+import { RUNTIME_VERSION } from "./version.mjs";
 
 export class LifecycleRuntime {
   constructor(connection, {
@@ -255,7 +256,7 @@ export class LifecycleRuntime {
   async heartbeat(capabilities) {
     const queue = await this.queue.diagnostics();
     return this.transport.heartbeat(capabilities, {
-      pluginVersion: this.connection.pluginVersion || "0.2.0-local",
+      pluginVersion: this.connection.pluginVersion || `${RUNTIME_VERSION}-local`,
       proofStorage: this.connection.proofStorage || "unknown",
       diagnostics: {
         queueDepth: queue.depth,

package/src/version.mjs

@@ -1,4 +1,4 @@
 export const PACKAGE_NAME = "@halofy/agent-connect";
-export const INSTALLER_VERSION = "0.2.0";
-export const RUNTIME_VERSION = "0.2.0";
+export const INSTALLER_VERSION = "0.3.0";
+export const RUNTIME_VERSION = "0.3.0";
 export const DISCLOSURE_VERSION = "halofy-agent-lifecycle-2026-08-29";