Solution for long term memory for agent coding CLIs and to facilitate handoff between different agent vendors
Rust
feat(workstream): support kimi-cli alias
AkitaOnRailsaf29f57a61af
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 39302b0a..eae27522 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -34,7 +34,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0for what it can contain and where it flows. Script-fallback installs cannotsanitize the field and drop the whole Stop event instead; move to a nativeinstall to capture it.-- Managed workstreams now support Kimi Code through `ai-memory run kimi`.+- Managed workstreams now support Kimi Code through `ai-memory run kimi`;+ `kimi-code` and `kimi-cli` are accepted aliases for the installed `kimi`+ executable.Returning runs resume the linked native session with `--session <id>`;fresh sessions are discovered post-exit by exact checkout match through`state.json`'s `workDir` (the session bucket name is a one-way hash and is@@ -43,7 +45,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0messages and compaction summaries from `agents/main/wire.jsonl`, excludingsystem prompts, hidden reasoning, hook-injected context (`hook_result` andrelated origins), and subagent transcripts. Wrapper `--yolo` maps to Kimi- Code's `--yolo`, and kimi joins the automatic bare-run harness pool.+ Code's `--yolo`, and kimi joins the automatic bare-run harness pool. The+ deterministic and opt-in real-harness acceptance paths cover Kimi creation,+ transcript import, cross-harness delivery, and returning native resume; the+ native contract was live-verified against Kimi Code v0.29.0.### Fixed- Native hook spool retries now reuse a per-entry idempotency key, so a lostdiff --git a/README.md b/README.mdindex 12f14aea..7d8275dd 100644--- a/README.md+++ b/README.md@@ -64,14 +64,16 @@ priors are at the [bottom](#influences-and-prior-art).sanitized prompt, tool-lifecycle, and session-boundary observations. Directlaunches keep this lightweight path; it is not a complete native transcript.- **Opt-in managed workstreams.** `ai-memory run claude`, then `ai-memory run- codex --yolo`, transparently resumes one logical workstream with native- per-harness sessions, a portable visible-event ledger, and full-ledger search.+ codex --yolo`, then `ai-memory run kimi`, transparently resumes one logical+ workstream with native per-harness sessions, a portable visible-event ledger,+ and full-ledger search.`ai-memory run` with no harness continues the newest usable Claude Code,Codex, OpenCode, Pi, Crush, or Kimi Code session for this checkout. On firstexplicit use, an interactive launcher can adopt a previous session from thesame checkout; later switches cannot select unrelated native history. Nativearguments pass through unchanged except the wrapper-owned `--yolo`; direct- commands are unaffected.+ commands are unaffected. `kimi-code` and `kimi-cli` are accepted aliases for+ the installed `kimi` command.- **Per-repository capture exclusions.** A nearest-marker `[capture]``ignore_paths` policy drops matching recognized file-tool events before theyreach the local spool or server. See [the capture policy reference](docs/marker-file.md#capture-exclusions).diff --git a/crates/ai-memory-cli/src/cli.rs b/crates/ai-memory-cli/src/cli.rsindex 4ed71685..10ba9150 100644--- a/crates/ai-memory-cli/src/cli.rs+++ b/crates/ai-memory-cli/src/cli.rs@@ -217,7 +217,7 @@ pub enum RunHarnessChoice {#[value(alias = "oh-my-pi")]Omp,/// Moonshot AI Kimi Code.- #[value(name = "kimi", alias = "kimi-code")]+ #[value(name = "kimi", alias = "kimi-code", alias = "kimi-cli")]Kimi,}diff --git a/crates/ai-memory-cli/src/commands/run.rs b/crates/ai-memory-cli/src/commands/run.rsindex 9b1d4507..731d152d 100644--- a/crates/ai-memory-cli/src/commands/run.rs+++ b/crates/ai-memory-cli/src/commands/run.rs@@ -1236,6 +1236,29 @@ mod tests {);}+ #[test]+ fn kimi_cli_alias_selects_the_kimi_adapter() {+ let cli = Cli::try_parse_from([+ OsStr::new("ai-memory"),+ OsStr::new("run"),+ OsStr::new("kimi-cli"),+ OsStr::new("--model"),+ OsStr::new("kimi-for-coding"),+ ])+ .unwrap();+ let CliCommand::Run(args) = cli.command else {+ panic!("expected run command");+ };+ assert!(matches!(+ args.harness,+ Some(crate::cli::RunHarnessChoice::Kimi)+ ));+ assert_eq!(+ args.native_args,+ ["--model", "kimi-for-coding"].map(OsString::from).to_vec()+ );+ }+#[test]fn bare_run_and_wrapper_yolo_parse_without_a_harness() {let cli = Cli::try_parse_from(["ai-memory", "run", "--yolo"]).unwrap();diff --git a/crates/ai-memory-workstream/src/harness.rs b/crates/ai-memory-workstream/src/harness.rsindex 7fbab186..642c9d5d 100644--- a/crates/ai-memory-workstream/src/harness.rs+++ b/crates/ai-memory-workstream/src/harness.rs@@ -37,7 +37,7 @@ impl ManagedHarness {"pi" => Some(Self::Pi),"crush" => Some(Self::Crush),"omp" | "oh-my-pi" => Some(Self::Omp),- "kimi" | "kimi-code" => Some(Self::Kimi),+ "kimi" | "kimi-code" | "kimi-cli" => Some(Self::Kimi),_ => None,}}@@ -906,6 +906,13 @@ mod tests {assert_eq!(plan.mode, LaunchMode::Session);}+ #[test]+ fn kimi_cli_name_is_an_alias_for_kimi_code() {+ for name in ["kimi", "kimi-code", "kimi-cli"] {+ assert_eq!(ManagedHarness::from_name(name), Some(ManagedHarness::Kimi));+ }+ }+#[test]fn kimi_resume_appends_session_selector_after_user_arguments() {let plan = build_launch_plan(diff --git a/docs/managed-workstreams.md b/docs/managed-workstreams.mdindex e4e5fc72..e17b91a0 100644--- a/docs/managed-workstreams.md+++ b/docs/managed-workstreams.md@@ -15,6 +15,8 @@ ai-memory run claudeai-memory run codex --yolo# return to Claude Code later; ai-memory supplies Claude's native --resumeai-memory run claude --model opus+# Kimi Code installs `kimi`; `kimi-cli` is accepted as a launcher alias+ai-memory run kimi-cli# or omit the harness and continue the newest usable session automaticallyai-memory run```@@ -197,7 +199,9 @@ workstream.Legacy sessions that keep `wire.jsonl` directly in the session directory(the pre-`agents/` layout the kimi session-store still reads through itsstat fallback) are neither discovered nor imported in v1. The native-contract was verified against Kimi Code v0.28.1.+contract was verified against Kimi Code v0.29.0. The managed launcher accepts+`kimi`, `kimi-code`, and `kimi-cli`; all three resolve the installed `kimi`+executable.Crush needs no ai-memory hook installation for managed mode. The launcher readsits one-time context from the server, copies the existing global Crush JSON into@@ -296,6 +300,8 @@ against obsolete sessions. Native session creation, read-only extraction,cross-harness injection, and returning resume paths are all exercised. Dockerwrapper host execution and remote URL preservation are covered separately bythe `ai-memory-cli` packaging tests. Set-`AI_MEMORY_ACCEPTANCE_HARNESSES="claude codex"` to select-a subset, `AI_MEMORY_ACCEPTANCE_DETERMINISTIC_ONLY=1` to skip model calls, or+`AI_MEMORY_ACCEPTANCE_HARNESSES="kimi-cli codex"` to select a+Kimi-to-Codex-to-Kimi round trip (Kimi aliases normalize to the installed+`kimi` executable), `AI_MEMORY_ACCEPTANCE_DETERMINISTIC_ONLY=1` to skip model+calls, or`AI_MEMORY_ACCEPTANCE_KEEP=1` to retain all temporary logs and data.diff --git a/scripts/managed-workstream-acceptance.sh b/scripts/managed-workstream-acceptance.shindex 7896572f..5a68a8d3 100755--- a/scripts/managed-workstream-acceptance.sh+++ b/scripts/managed-workstream-acceptance.sh@@ -396,7 +396,7 @@ jq -e --arg id "$kimi_session_id" \AI_MEMORY_ACCEPTANCE_ARGV_LOG="$TMP/kimi-second-argv.log" \AI_MEMORY_ACCEPTANCE_SENTINEL="AMWS-FAKE-KIMI-TWO" \"$BIN" --data-dir "$DATA" run --workstream edge-kimi --executable "$FAKE" \- kimi >"$LOGS/edge-kimi-second.log" 2>&1+ kimi-cli >"$LOGS/edge-kimi-second.log" 2>&1)diff -u <(printf '%s\n' --session "$kimi_session_id") "$TMP/kimi-second-argv.log"kimi_second_hits=$("$BIN" --data-dir "$DATA" workstream-search \@@ -481,11 +481,15 @@ firead -r -a requested_harnesses <<<"$HARNESS_WORDS"harnesses=()-for harness in "${requested_harnesses[@]}"; do+for requested_harness in "${requested_harnesses[@]}"; do+ case "$requested_harness" in+ kimi-code | kimi-cli) harness=kimi ;;+ *) harness=$requested_harness ;;+ esacif command -v "$harness" >/dev/null 2>&1; thenharnesses+=("$harness")else- printf 'skipping unavailable harness: %s\n' "$harness" >&2+ printf 'skipping unavailable harness: %s\n' "$requested_harness" >&2fidone[ "${#harnesses[@]}" -ge 2 ] || {@@ -628,7 +632,7 @@ run_harness() {if [ -z "$previous" ]; thenprompt="Do not use tools. Reply with exactly: $current"else- prompt="Do not use tools. From the injected ai-memory managed-workstream context, identify the most recent assistant sentinel beginning with AMWS-. Reply on one line with that prior sentinel, then $current."+ prompt="Do not use tools. In the newest assistant event from the injected ai-memory managed-workstream context, find the final whitespace-delimited token beginning with AMWS-. Reply with exactly that token, one space, then $current."fiif [ "$first_run" = 1 ]; thenwrapper_args=(--new "$WORKSTREAM_NAME")