@cleocode/adapters 2026.4.41 → 2026.4.43

package/dist/cant-context.d.ts

@@ -41,6 +41,17 @@ export interface BuildCantEnrichedPromptOptions {
     basePrompt: string;
     /** Agent name for mental model injection. Omit to skip mental model fetch. */
     agentName?: string;
+    /**
+     * When true, prepend the CleoOS identity bootstrap from CLEOOS-IDENTITY.md.
+     * Intended for the main session agent only — sub-agents get identity via CANT bundle.
+     */
+    isMainAgent?: boolean;
+    /**
+     * Pre-compiled CANT bundle string (from a session-level cache).
+     * When provided, steps 1–3 (discovery + compile + render) are skipped.
+     * Use this to avoid double-compilation when the Pi bridge already compiled the bundle.
+     */
+    compiledBundle?: string;
 }
 /**
  * Recursively discover `.cant` files in a directory.
@@ -105,6 +116,30 @@ export declare function buildMemoryBridgeBlock(content: string): string;
  *          or empty string when `observations` is empty.
  */
 export declare function buildMentalModelInjection(agentName: string, observations: MentalModelObservation[]): string;
+/**
+ * Read CLEOOS-IDENTITY.md from the project or global XDG location.
+ *
+ * Search order:
+ * 1. `<projectDir>/.cleo/CLEOOS-IDENTITY.md` (project-level, deployed by init)
+ * 2. `$XDG_DATA_HOME/cleo/CLEOOS-IDENTITY.md` (global XDG default)
+ *
+ * @param projectDir - The project root directory.
+ * @returns The identity file content, or null if not found.
+ */
+export declare function readIdentityFile(projectDir: string): string | null;
+/**
+ * Build the CleoOS identity bootstrap block for the main session agent.
+ *
+ * Reads CLEOOS-IDENTITY.md from disk and appends live operational context
+ * (current session briefing, next tasks, recent brain decisions) gathered
+ * via best-effort CLI calls with an 8-second timeout each.
+ *
+ * Returns an empty string on any failure — never throws.
+ *
+ * @param projectDir - The project root directory (used for CWD and file lookup).
+ * @returns The fully assembled identity block, or "" if unavailable.
+ */
+export declare function buildIdentityBootstrap(projectDir: string): Promise<string>;
 /**
  * Build an enriched prompt with CANT context, memory bridge, and mental model.
  *

package/dist/cant-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cant-context.d.ts","sourceRoot":"","sources":["../src/cant-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,8BAA8B;IAC7C,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAmCA;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,sBAAsB,EAAE,GACrC,MAAM,CAaR;AAyDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,CAyDjB"}
+{"version":3,"file":"cant-context.d.ts","sourceRoot":"","sources":["../src/cant-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAcH,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,8BAA8B;IAC7C,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAUA;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG;IAC9D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,kBAAkB,CAAC;CAC3B,CAmCA;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ9D;AAMD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,sBAAsB,EAAE,GACrC,MAAM,CAaR;AAyDD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBlE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqGhF;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,MAAM,CAAC,CA6EjB"}

package/dist/index.js

@@ -12,16 +12,20 @@ var __export = (target, all) => {
 var cant_context_exports = {};
 __export(cant_context_exports, {
   buildCantEnrichedPrompt: () => buildCantEnrichedPrompt,
+  buildIdentityBootstrap: () => buildIdentityBootstrap,
   buildMemoryBridgeBlock: () => buildMemoryBridgeBlock,
   buildMentalModelInjection: () => buildMentalModelInjection,
   discoverCantFiles: () => discoverCantFiles,
   discoverCantFilesMultiTier: () => discoverCantFilesMultiTier,
+  readIdentityFile: () => readIdentityFile,
   readMemoryBridge: () => readMemoryBridge,
   resolveThreeTierPaths: () => resolveThreeTierPaths
 });
+import { execFile } from "node:child_process";
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, join } from "node:path";
+import { promisify } from "node:util";
 function discoverCantFiles(dir) {
   try {
     const entries = readdirSync(dir, { recursive: true, withFileTypes: true });
@@ -121,24 +125,139 @@ async function fetchMentalModelInjection(agentName, projectRoot) {
     return "";
   }
 }
+function readIdentityFile(projectDir) {
+  const projectPath = join(projectDir, ".cleo", "CLEOOS-IDENTITY.md");
+  if (existsSync(projectPath)) {
+    try {
+      const content = readFileSync(projectPath, "utf-8");
+      return content.length > 0 ? content : null;
+    } catch {
+    }
+  }
+  const home = homedir();
+  const xdgData = process.env["XDG_DATA_HOME"] ?? join(home, ".local", "share");
+  const globalPath = join(xdgData, "cleo", "CLEOOS-IDENTITY.md");
+  if (existsSync(globalPath)) {
+    try {
+      const content = readFileSync(globalPath, "utf-8");
+      return content.length > 0 ? content : null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+async function buildIdentityBootstrap(projectDir) {
+  const identityContent = readIdentityFile(projectDir);
+  if (!identityContent) return "";
+  const [briefingResult, nextResult, memoryResult] = await Promise.allSettled([
+    execFileAsync("cleo", ["session", "briefing", "--json"], {
+      timeout: 8e3,
+      cwd: projectDir || void 0
+    }),
+    execFileAsync("cleo", ["next", "--json", "--limit", "3"], {
+      timeout: 8e3,
+      cwd: projectDir || void 0
+    }),
+    execFileAsync("cleo", ["memory", "find", "decision", "--json", "--limit", "5"], {
+      timeout: 8e3,
+      cwd: projectDir || void 0
+    })
+  ]);
+  const dynamicLines = [];
+  if (briefingResult.status === "fulfilled") {
+    try {
+      const briefing = JSON.parse(briefingResult.value.stdout);
+      const data = briefing?.data ?? briefing;
+      if (data?.currentTask) {
+        dynamicLines.push("## Current Task");
+        dynamicLines.push(
+          `- **${data.currentTask.id}**: ${data.currentTask.title} (${data.currentTask.status})`
+        );
+        dynamicLines.push("");
+      }
+      if (data?.handoff?.note) {
+        dynamicLines.push("## Last Session Handoff");
+        dynamicLines.push(data.handoff.note);
+        dynamicLines.push("");
+      }
+    } catch {
+    }
+  }
+  if (nextResult.status === "fulfilled") {
+    try {
+      const next = JSON.parse(nextResult.value.stdout);
+      const tasks = next?.data?.tasks ?? [];
+      if (Array.isArray(tasks) && tasks.length > 0) {
+        dynamicLines.push("## Next Tasks");
+        for (const t of tasks.slice(0, 3)) {
+          dynamicLines.push(`- **${t.id}**: ${t.title} (${t.priority ?? "medium"})`);
+        }
+        dynamicLines.push("");
+      }
+    } catch {
+    }
+  }
+  if (memoryResult.status === "fulfilled") {
+    try {
+      const mem = JSON.parse(memoryResult.value.stdout);
+      const results = mem?.data?.results ?? [];
+      if (Array.isArray(results) && results.length > 0) {
+        dynamicLines.push("## Recent Brain Context");
+        for (const r of results.slice(0, 5)) {
+          dynamicLines.push(`- [${r.id}] ${r.title} (${r.date ?? ""})`);
+        }
+        dynamicLines.push("");
+      }
+    } catch {
+    }
+  }
+  const sections = [
+    "",
+    "===== CLEOOS IDENTITY BOOTSTRAP =====",
+    "",
+    identityContent.trim()
+  ];
+  if (dynamicLines.length > 0) {
+    sections.push("");
+    sections.push(...dynamicLines);
+  }
+  sections.push("===== END IDENTITY BOOTSTRAP =====");
+  return sections.join("\n");
+}
 async function buildCantEnrichedPrompt(options) {
-  const { projectDir, basePrompt, agentName } = options;
+  const { projectDir, basePrompt, agentName, isMainAgent, compiledBundle } = options;
   let appendix = "";
+  if (isMainAgent) {
+    try {
+      const identityBlock = await buildIdentityBootstrap(projectDir);
+      if (identityBlock) {
+        appendix += identityBlock;
+      }
+    } catch {
+    }
+  }
   try {
-    const { files } = discoverCantFilesMultiTier(projectDir);
-    if (files.length > 0) {
-      const cantModule = await import(
-        /* webpackIgnore: true */
-        "@cleocode/cant"
-      );
-      if (typeof cantModule.compileBundle === "function") {
-        const bundle = await cantModule.compileBundle(files);
-        if (bundle.valid) {
-          const rendered = bundle.renderSystemPrompt();
-          if (rendered) {
-            appendix += `
+    if (compiledBundle) {
+      appendix += `
+
+${compiledBundle}`;
+    } else {
+      const { files } = discoverCantFilesMultiTier(projectDir);
+      if (files.length > 0) {
+        const cantModule = await import(
+          /* webpackIgnore: true */
+          "@cleocode/cant"
+        );
+        if (typeof cantModule.compileBundle === "function") {
+          const bundle = await cantModule.compileBundle(files);
+          if (bundle.valid) {
+            const rendered = bundle.renderSystemPrompt();
+            if (rendered) {
+              appendix += `
 
 ${rendered}`;
+            }
           }
         }
       }
@@ -165,10 +284,11 @@ ${mentalModel}`;
   }
   return appendix ? basePrompt + appendix : basePrompt;
 }
-var VALIDATE_ON_LOAD_PREAMBLE;
+var execFileAsync, VALIDATE_ON_LOAD_PREAMBLE;
 var init_cant_context = __esm({
   "packages/adapters/src/cant-context.ts"() {
     "use strict";
+    execFileAsync = promisify(execFile);
     VALIDATE_ON_LOAD_PREAMBLE = "===== MENTAL MODEL (validate-on-load) =====\nThese are your prior observations, patterns, and learnings for this project.\nBefore acting, you MUST re-evaluate each entry against current project state.\nIf an entry is stale, note it and proceed with fresh understanding.";
   }
 });
@@ -980,13 +1100,13 @@ var init_src = __esm({
 // packages/adapters/src/providers/claude-code/spawn.ts
 import { exec, spawn as nodeSpawn } from "node:child_process";
 import { unlink, writeFile } from "node:fs/promises";
-import { promisify } from "node:util";
+import { promisify as promisify2 } from "node:util";
 var execAsync, ClaudeCodeSpawnProvider;
 var init_spawn = __esm({
   "packages/adapters/src/providers/claude-code/spawn.ts"() {
     "use strict";
     init_src();
-    execAsync = promisify(exec);
+    execAsync = promisify2(exec);
     ClaudeCodeSpawnProvider = class {
       /** Map of instance IDs to tracked process info. */
       processMap = /* @__PURE__ */ new Map();
@@ -1231,7 +1351,7 @@ import { exec as exec2 } from "node:child_process";
 import { existsSync as existsSync5 } from "node:fs";
 import { homedir as homedir6 } from "node:os";
 import { join as join7 } from "node:path";
-import { promisify as promisify2 } from "node:util";
+import { promisify as promisify3 } from "node:util";
 var execAsync2, ClaudeCodeAdapter;
 var init_adapter = __esm({
   "packages/adapters/src/providers/claude-code/adapter.ts"() {
@@ -1243,7 +1363,7 @@ var init_adapter = __esm({
     init_spawn();
     init_task_sync();
     init_transport();
-    execAsync2 = promisify2(exec2);
+    execAsync2 = promisify3(exec2);
     ClaudeCodeAdapter = class {
       /** Unique provider identifier. */
       id = "claude-code";
@@ -2197,7 +2317,7 @@ var init_install3 = __esm({
 import { exec as exec6, spawn as nodeSpawn2 } from "node:child_process";
 import { mkdir as mkdir2, readFile as readFile4, writeFile as writeFile2 } from "node:fs/promises";
 import { join as join21 } from "node:path";
-import { promisify as promisify6 } from "node:util";
+import { promisify as promisify7 } from "node:util";
 function buildOpenCodeAgentMarkdown(description, instructions) {
   const normalizedDesc = description.replace(/\s+/g, " ").trim();
   return [
@@ -2240,7 +2360,7 @@ var execAsync6, OPENCODE_SUBAGENT_NAME, OPENCODE_FALLBACK_AGENT, OpenCodeSpawnPr
 var init_spawn2 = __esm({
   "packages/adapters/src/providers/opencode/spawn.ts"() {
     "use strict";
-    execAsync6 = promisify6(exec6);
+    execAsync6 = promisify7(exec6);
     OPENCODE_SUBAGENT_NAME = "cleo-subagent";
     OPENCODE_FALLBACK_AGENT = "general";
     OpenCodeSpawnProvider = class {
@@ -2388,7 +2508,7 @@ var init_spawn2 = __esm({
 import { exec as exec7 } from "node:child_process";
 import { existsSync as existsSync16 } from "node:fs";
 import { join as join22 } from "node:path";
-import { promisify as promisify7 } from "node:util";
+import { promisify as promisify8 } from "node:util";
 var execAsync7, OpenCodeAdapter;
 var init_adapter3 = __esm({
   "packages/adapters/src/providers/opencode/adapter.ts"() {
@@ -2396,7 +2516,7 @@ var init_adapter3 = __esm({
     init_hooks3();
     init_install3();
     init_spawn2();
-    execAsync7 = promisify7(exec7);
+    execAsync7 = promisify8(exec7);
     OpenCodeAdapter = class {
       /** Unique provider identifier. */
       id = "opencode";
@@ -2844,7 +2964,7 @@ var init_install4 = __esm({
 // packages/adapters/src/providers/pi/spawn.ts
 import { exec as exec8, spawn as nodeSpawn3 } from "node:child_process";
 import { unlink as unlink2, writeFile as writeFile3 } from "node:fs/promises";
-import { promisify as promisify8 } from "node:util";
+import { promisify as promisify9 } from "node:util";
 function getPiCliPath() {
   return process.env["PI_CLI_PATH"] ?? "pi";
 }
@@ -2853,7 +2973,7 @@ var init_spawn3 = __esm({
   "packages/adapters/src/providers/pi/spawn.ts"() {
     "use strict";
     init_src();
-    execAsync8 = promisify8(exec8);
+    execAsync8 = promisify9(exec8);
     PiSpawnProvider = class {
       /** Map of instance IDs to tracked process info. */
       processMap = /* @__PURE__ */ new Map();
@@ -2997,7 +3117,7 @@ import { exec as exec9 } from "node:child_process";
 import { existsSync as existsSync18 } from "node:fs";
 import { homedir as homedir14 } from "node:os";
 import { join as join24 } from "node:path";
-import { promisify as promisify9 } from "node:util";
+import { promisify as promisify10 } from "node:util";
 function getPiAgentDir2() {
   const env = process.env["PI_CODING_AGENT_DIR"];
   if (env !== void 0 && env.length > 0) {
@@ -3018,7 +3138,7 @@ var init_adapter4 = __esm({
     init_hooks4();
     init_install4();
     init_spawn3();
-    execAsync9 = promisify9(exec9);
+    execAsync9 = promisify10(exec9);
     PiAdapter = class {
       /** Unique provider identifier. */
       id = "pi";
@@ -3196,7 +3316,7 @@ import { exec as exec3 } from "node:child_process";
 import { existsSync as existsSync8 } from "node:fs";
 import { homedir as homedir9 } from "node:os";
 import { join as join12 } from "node:path";
-import { promisify as promisify3 } from "node:util";
+import { promisify as promisify4 } from "node:util";
 
 // packages/adapters/src/providers/codex/hooks.ts
 import { homedir as homedir8 } from "node:os";
@@ -3420,7 +3540,7 @@ var CodexInstallProvider = class {
 };
 
 // packages/adapters/src/providers/codex/adapter.ts
-var execAsync3 = promisify3(exec3);
+var execAsync3 = promisify4(exec3);
 var CodexAdapter = class {
   /** Unique provider identifier. */
   id = "codex";
@@ -3544,7 +3664,7 @@ import { exec as exec4 } from "node:child_process";
 import { existsSync as existsSync12 } from "node:fs";
 import { homedir as homedir11 } from "node:os";
 import { join as join17 } from "node:path";
-import { promisify as promisify4 } from "node:util";
+import { promisify as promisify5 } from "node:util";
 
 // packages/adapters/src/providers/gemini-cli/hooks.ts
 import { homedir as homedir10 } from "node:os";
@@ -3727,7 +3847,7 @@ var GeminiCliInstallProvider = class {
 };
 
 // packages/adapters/src/providers/gemini-cli/adapter.ts
-var execAsync4 = promisify4(exec4);
+var execAsync4 = promisify5(exec4);
 var GeminiCliAdapter = class {
   /** Unique provider identifier. */
   id = "gemini-cli";
@@ -3859,7 +3979,7 @@ import { exec as exec5 } from "node:child_process";
 import { existsSync as existsSync14 } from "node:fs";
 import { homedir as homedir12 } from "node:os";
 import { join as join19 } from "node:path";
-import { promisify as promisify5 } from "node:util";
+import { promisify as promisify6 } from "node:util";
 
 // packages/adapters/src/providers/kimi/hooks.ts
 var KimiHookProvider = class {
@@ -4013,7 +4133,7 @@ var KimiInstallProvider = class {
 };
 
 // packages/adapters/src/providers/kimi/adapter.ts
-var execAsync5 = promisify5(exec5);
+var execAsync5 = promisify6(exec5);
 var KimiAdapter = class {
   /** Unique provider identifier. */
   id = "kimi";