@cleocode/contracts 2026.5.67 → 2026.5.69

package/dist/memory/context-engine.js

@@ -0,0 +1,15 @@
+/**
+ * ContextEngine interface contract — canonical location.
+ *
+ * Defines the compression contract used by {@link LlmExecutor} to keep
+ * session history within the model's context budget. An engine is injected
+ * at executor construction time; when absent the executor silently skips
+ * all compression checks.
+ *
+ * @module memory/context-engine
+ * @task T9304
+ * @epic T9261 T-LLM-CRED-CENTRALIZATION
+ * @see ADR-072 §"LlmExecutor — agent-loop level"
+ */
+export {};
+//# sourceMappingURL=context-engine.js.map

package/dist/memory/context-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-engine.js","sourceRoot":"","sources":["../../src/memory/context-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/operations/llm.d.ts

@@ -173,15 +173,13 @@ export interface CredentialResultWire {
  * Resolution chain order:
  *   1. `role`               — `config.llm.roles[role]` (explicit override)
  *   2. `default`            — `config.llm.default` (canonical default)
- *   3. `daemon-legacy`      — `config.llm.daemon` (deprecated alias)
- *   4. `implicit-fallback`  — hard-coded fallback inside the resolver
+ *   3. `implicit-fallback`  — hard-coded fallback inside the resolver
  *
- * Useful for `cleo llm whoami` diagnostics and for migration tooling that
- * needs to identify call-sites still on the legacy `daemon` block.
+ * Useful for `cleo llm whoami` diagnostics.
  *
- * @task T9255
+ * @task T9306
  */
-export type ResolutionSource = 'role' | 'default' | 'daemon-legacy' | 'implicit-fallback';
+export type ResolutionSource = 'role' | 'default' | 'implicit-fallback';
 /**
  * Result envelope returned by `resolveLLMForRole(role)`.
  *
@@ -497,4 +495,43 @@ export interface LlmWhoamiResult {
     /** One entry per role resolved (filtered by `params.role` when set). */
     entries: LlmWhoamiEntry[];
 }
+/**
+ * Resolved credential source for a single LLM provider.
+ *
+ * Mirrors the subset of `CredentialSource` relevant for human-facing status
+ * output. `'none'` means no credential was found at any tier.
+ *
+ * @task T9323
+ */
+export type LlmProviderSourceWire = 'env' | 'cred-file' | 'claude-creds' | 'config' | 'none';
+/**
+ * Per-provider status entry emitted by `cleo memory llm-status`.
+ *
+ * @task T9323
+ */
+export interface LlmProviderStatusEntry {
+    /** Provider identifier (e.g. `'anthropic'`, `'kimi-code'`). */
+    provider: string;
+    /** Which credential tier resolved the key, or `'none'` if unavailable. */
+    resolvedSource: LlmProviderSourceWire;
+    /** `true` when a usable credential was found. */
+    hasCredential: boolean;
+}
+/**
+ * Result envelope for `memory.llm-status` (query).
+ *
+ * @task T9323
+ */
+export interface LlmStatusResult {
+    /** Legacy anthropic-only resolved source (kept for backward compat). */
+    resolvedSource: string;
+    /** `true` when an Anthropic credential is available (legacy compat field). */
+    extractionEnabled: boolean;
+    /** ISO timestamp of the most recent extraction run, or `null`. */
+    lastExtractionRun: string | null;
+    /** Suggested test command. */
+    testCommand: string;
+    /** Per-provider status for all known OAuth providers. */
+    providers: LlmProviderStatusEntry[];
+}
 //# sourceMappingURL=llm.d.ts.map

package/dist/operations/llm.d.ts.map

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

package/dist/operations/llm.js

@@ -9,8 +9,4 @@
  * @epic T1386
  */
 export {};
-// ProviderProfile interface lives in ./llm/provider-profile.ts (T9262).
-// The generated catalog (packages/core/src/llm/generated/provider-profiles.ts)
-// imports the canonical type from the contracts package and emits each
-// generated entry as a plain ProviderProfile literal.
 //# sourceMappingURL=llm.js.map

package/dist/operations/llm.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/operations/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;AA6iBH,wEAAwE;AACxE,+EAA+E;AAC/E,uEAAuE;AACvE,sDAAsD"}
+{"version":3,"file":"llm.js","sourceRoot":"","sources":["../../src/operations/llm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.5.67",
+  "version": "2026.5.69",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -65,6 +65,14 @@
     "./llm/*.js": {
       "types": "./dist/llm/*.d.ts",
       "import": "./dist/llm/*.js"
+    },
+    "./memory/*": {
+      "types": "./dist/memory/*.d.ts",
+      "import": "./dist/memory/*.js"
+    },
+    "./memory/*.js": {
+      "types": "./dist/memory/*.d.ts",
+      "import": "./dist/memory/*.js"
     }
   },
   "engines": {
@@ -90,7 +98,7 @@
   "dependencies": {
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.2",
-    "@cleocode/lafs": "2026.5.67"
+    "@cleocode/lafs": "2026.5.69"
   },
   "scripts": {
     "build": "tsc -b --force && node scripts/emit-schemas.mjs",

package/src/__tests__/credentials.test.ts

@@ -0,0 +1,122 @@
+/**
+ * Smoke tests for `parseClaudeCodeCredentials()` in @cleocode/contracts.
+ *
+ * Covers both OAuth-shaped and api-key-shaped JSON, plus edge cases
+ * (malformed input, expired tokens, missing fields).
+ *
+ * @task T9307
+ */
+
+import { describe, expect, it } from 'vitest';
+import { parseClaudeCodeCredentials } from '../credentials.js';
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+function makeCreds(overrides: Record<string, unknown> = {}): string {
+  return JSON.stringify({
+    claudeAiOauth: {
+      accessToken: 'sk-ant-oat-test-token',
+      expiresAt: Date.now() + 3_600_000,
+      ...overrides,
+    },
+  });
+}
+
+// ---------------------------------------------------------------------------
+// OAuth-shaped credentials
+// ---------------------------------------------------------------------------
+
+describe('OAuth-shaped credentials', () => {
+  it('returns accessToken for valid OAuth JSON', () => {
+    const result = parseClaudeCodeCredentials(makeCreds());
+    expect(result).not.toBeNull();
+    expect(result?.accessToken).toBe('sk-ant-oat-test-token');
+  });
+
+  it('returns expiresAt when present', () => {
+    const expiresAt = Date.now() + 7_200_000;
+    const result = parseClaudeCodeCredentials(makeCreds({ expiresAt }));
+    expect(result?.expiresAt).toBe(expiresAt);
+  });
+
+  it('returns refreshToken when present', () => {
+    const result = parseClaudeCodeCredentials(
+      makeCreds({ refreshToken: 'sk-ant-ort-refresh-token' }),
+    );
+    expect(result?.refreshToken).toBe('sk-ant-ort-refresh-token');
+  });
+
+  it('returns null for expired token', () => {
+    const result = parseClaudeCodeCredentials(makeCreds({ expiresAt: Date.now() - 1 }));
+    expect(result).toBeNull();
+  });
+
+  it('omits expiresAt when not provided', () => {
+    const raw = JSON.stringify({
+      claudeAiOauth: { accessToken: 'sk-ant-oat-no-expiry' },
+    });
+    const result = parseClaudeCodeCredentials(raw);
+    expect(result?.accessToken).toBe('sk-ant-oat-no-expiry');
+    expect(result?.expiresAt).toBeUndefined();
+  });
+
+  it('accepts a Buffer input', () => {
+    const buf = Buffer.from(makeCreds(), 'utf-8');
+    const result = parseClaudeCodeCredentials(buf);
+    expect(result?.accessToken).toBe('sk-ant-oat-test-token');
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Api-key-shaped / missing claudeAiOauth block
+// ---------------------------------------------------------------------------
+
+describe('Non-OAuth / missing block', () => {
+  it('returns null when claudeAiOauth block is absent', () => {
+    const raw = JSON.stringify({ someOtherKey: 'value' });
+    expect(parseClaudeCodeCredentials(raw)).toBeNull();
+  });
+
+  it('returns null when accessToken is empty string', () => {
+    const raw = JSON.stringify({ claudeAiOauth: { accessToken: '' } });
+    expect(parseClaudeCodeCredentials(raw)).toBeNull();
+  });
+
+  it('returns null when accessToken is whitespace only', () => {
+    const raw = JSON.stringify({ claudeAiOauth: { accessToken: '   ' } });
+    expect(parseClaudeCodeCredentials(raw)).toBeNull();
+  });
+
+  it('returns null when accessToken field is missing', () => {
+    const raw = JSON.stringify({ claudeAiOauth: { expiresAt: Date.now() + 3600 } });
+    expect(parseClaudeCodeCredentials(raw)).toBeNull();
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Malformed / edge-case input
+// ---------------------------------------------------------------------------
+
+describe('Malformed input', () => {
+  it('returns null for empty string', () => {
+    expect(parseClaudeCodeCredentials('')).toBeNull();
+  });
+
+  it('returns null for invalid JSON', () => {
+    expect(parseClaudeCodeCredentials('not-json')).toBeNull();
+  });
+
+  it('returns null for JSON null', () => {
+    expect(parseClaudeCodeCredentials('null')).toBeNull();
+  });
+
+  it('returns null for JSON array', () => {
+    expect(parseClaudeCodeCredentials('[]')).toBeNull();
+  });
+
+  it('returns null for empty Buffer', () => {
+    expect(parseClaudeCodeCredentials(Buffer.alloc(0))).toBeNull();
+  });
+});

package/src/__tests__/llm-config-schema.test.ts

@@ -3,27 +3,26 @@
  *
  * Asserts that:
  *
- * 1. A literal `LlmConfig` object containing the new `default`, `roles`, and
- *    the legacy `daemon` fields typechecks and survives a JSON
- *    serialize/deserialize cycle without structural loss.
+ * 1. A literal `LlmConfig` object containing the `default` and `roles` fields
+ *    typechecks and survives a JSON serialize/deserialize cycle without
+ *    structural loss.
  * 2. All five `RoleName` values (`extraction`, `consolidation`, `derivation`,
  *    `hygiene`, `judgement`) are accepted as keys of `roles`.
  * 3. Omitting `default` and/or `roles` still typechecks (both are optional).
  *
- * These tests guard the Phase 2 schema extension of
- * T-LLM-CRED-CENTRALIZATION against accidental regressions.
+ * These tests guard the Phase 4 schema cleanup of T-LLM-CRED-CENTRALIZATION
+ * (T9306 — daemon field removed) against accidental regressions.
  *
- * @task T9256
+ * @task T9306
  * @epic T-LLM-CRED-CENTRALIZATION
  */
 
 import { describe, expect, it } from 'vitest';
 import type { LlmConfig, LlmDefaultConfig, LlmRoleConfig, RoleName } from '../config.js';
 
-describe('LlmConfig — Phase 2 schema extension (T9256)', () => {
-  it('accepts a fully-populated config with default, roles, and legacy daemon', () => {
+describe('LlmConfig — Phase 4 schema cleanup (T9306)', () => {
+  it('accepts a fully-populated config with default and roles', () => {
     const cfg: LlmConfig = {
-      daemon: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
       providers: {
         anthropic: { apiKey: 'sk-test-anthropic' },
         openai: { apiKey: 'sk-test-openai' },
@@ -102,13 +101,10 @@ describe('LlmConfig — Phase 2 schema extension (T9256)', () => {
   });
 
   it('typechecks when default and roles are both omitted', () => {
-    const cfg: LlmConfig = {
-      daemon: { provider: 'anthropic', model: 'claude-sonnet-4-6' },
-    };
+    const cfg: LlmConfig = {};
 
     expect(cfg.default).toBeUndefined();
     expect(cfg.roles).toBeUndefined();
-    expect(cfg.daemon?.provider).toBe('anthropic');
   });
 
   it('typechecks an empty LlmConfig (all fields optional)', () => {

package/src/config.ts

@@ -374,30 +374,7 @@ export interface LlmProviderEntry {
 }
 
 /**
- * Daemon LLM configuration — which provider + model the CLEO daemon
- * (sentient tick, dream-cycle, BRAIN extraction, etc.) uses by default.
- *
- * Written via:
- *   cleo config llm.daemon.provider <provider>
- *   cleo config llm.daemon.model <model-id>
- *
- * @defaultValue { provider: 'anthropic', model: 'claude-sonnet-4-6' }
- */
-export interface DaemonLLMConfig {
-  /**
-   * LLM provider transport used by daemon loops.
-   * @defaultValue 'anthropic'
-   */
-  provider: ModelTransport;
-  /**
-   * Full model identifier for the selected provider.
-   * @defaultValue 'claude-sonnet-4-6'
-   */
-  model: string;
-}
-
-/**
- * Canonical model transport identifier — re-export of {@link ModelTransport}
+ * Config-layer transport identifier — re-export of {@link ModelTransport}
  * from `operations/llm.ts` so config-layer types stay in lock-step with the
  * operations layer with no risk of drift.
  *
@@ -405,33 +382,45 @@ export interface DaemonLLMConfig {
  * T-LLM-CRED Phase 2 DRY/SOLID review (P1-2). Adding a new transport now
  * requires editing only `operations/llm.ts`.
  *
+ * **Disambiguation**: This is the *config-level* alias for the
+ * `ModelTransport` string-literal union (`'anthropic' | 'openai' | ...`).
+ * It is intentionally distinct from the `LlmTransport` *interface* defined
+ * in `packages/contracts/src/llm/normalized-response.ts` (Phase 4 wire-level
+ * protocol). Renamed from `LlmTransport` → `LlmProviderTransport` in T9308
+ * to eliminate the name collision.
+ *
  * @task T-LLM-CRED-CENTRALIZATION Phase 2 — DRY review P1-2
+ * @see T9308 — disambiguation rename
  */
-export type LlmTransport = ModelTransport;
+export type LlmProviderTransport = ModelTransport;
 
 /**
  * Logical LLM role name used by role-aware resolvers (BRAIN, sentient, etc.).
  *
  * Each role can pin its own provider + model + credential label, with
- * resolution falling back to `LlmConfig.default` and finally to the legacy
- * `LlmConfig.daemon` block.
+ * resolution falling back to `LlmConfig.default`.
  *
- * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+ * @task T-LLM-CRED-CENTRALIZATION Phase 4 (T9306)
  */
-export type RoleName = 'extraction' | 'consolidation' | 'derivation' | 'hygiene' | 'judgement';
+export type RoleName =
+  | 'extraction'
+  | 'consolidation'
+  | 'derivation'
+  | 'hygiene'
+  | 'judgement'
+  /** Sandbox role for plugin-scoped single-turn calls (T9305). */
+  | 'plugin'
+  /** Context-compression role — uses a cheap model (haiku) for summarization (T9304). */
+  | 'compression';
 
 /**
  * Canonical default LLM target for unscoped (non-role) calls.
  *
- * Replaces the role previously played by `LlmConfig.daemon`. The `daemon`
- * field stays as a deprecated alias for one release cycle to give downstream
- * consumers time to migrate.
- *
- * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+ * @task T-LLM-CRED-CENTRALIZATION Phase 4 (T9306)
  */
 export interface LlmDefaultConfig {
   /** LLM provider transport for the default model. */
-  provider: LlmTransport;
+  provider: LlmProviderTransport;
   /** Full model identifier for the selected provider. */
   model: string;
 }
@@ -448,7 +437,7 @@ export interface LlmDefaultConfig {
  */
 export interface LlmRoleConfig {
   /** LLM provider transport for this role. */
-  provider: LlmTransport;
+  provider: LlmProviderTransport;
   /** Full model identifier for the selected provider. */
   model: string;
   /**
@@ -465,39 +454,32 @@ export interface LlmRoleConfig {
  * Stored at `llm` in config.json.
  *
  * Resolution order for role-scoped calls:
- *   `roles[role]` → `default` → `daemon` (legacy).
+ *   `roles[role]` → `default` → implicit fallback.
+ *
+ * Note: configs that still carry a `llm.daemon` key are silently ignored
+ * at parse time — they will not cause a crash. Migration: remove the key
+ * and add `llm.default` or `llm.roles.<role>` instead.
+ *
+ * @task T-LLM-CRED-CENTRALIZATION Phase 4 (T9306)
  */
 export interface LlmConfig {
-  /**
-   * Daemon LLM settings (provider + model for background loops).
-   *
-   * @deprecated Use `default` instead. Retained as a fallback alias for
-   * one release cycle (T-LLM-CRED-CENTRALIZATION Phase 2 · T9256). New
-   * code must read `default` first and only fall through to `daemon` when
-   * `default` is absent.
-   * @defaultValue { provider: 'anthropic', model: 'claude-sonnet-4-6' }
-   */
-  daemon?: DaemonLLMConfig;
   /**
    * Per-provider API key overrides.
    * Keys are provider names: 'anthropic' | 'openai' | 'gemini' | 'moonshot'.
    */
   providers?: Record<string, LlmProviderEntry>;
   /**
-   * Canonical default LLM for unscoped calls. Replaces the role previously
-   * played by `daemon`, which stays as a deprecated alias for one release
-   * cycle.
+   * Canonical default LLM for unscoped calls.
    *
-   * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+   * @task T-LLM-CRED-CENTRALIZATION Phase 4 (T9306)
    */
   default?: LlmDefaultConfig;
   /**
-   * Per-role LLM overrides. Each role optionally pins to a credential
-   * label.
+   * Per-role LLM overrides. Each role optionally pins to a credential label.
    *
-   * Resolution order: `roles[role]` → `default` → `daemon` (legacy).
+   * Resolution order: `roles[role]` → `default` → implicit fallback.
    *
-   * @task T-LLM-CRED-CENTRALIZATION Phase 2 (T9256)
+   * @task T-LLM-CRED-CENTRALIZATION Phase 4 (T9306)
    */
   roles?: Partial<Record<RoleName, LlmRoleConfig>>;
 }

package/src/credentials.ts

@@ -0,0 +1,114 @@
+/**
+ * Pure credential-parsing helpers for the CLEO LLM layer.
+ *
+ * This module is a LEAF — it has NO imports from @cleocode/core or any
+ * other runtime package. It exists so adapter packages can parse Claude Code
+ * OAuth credentials without creating a circular dependency on @cleocode/core.
+ *
+ * ## What lives here
+ * - `ClaudeCodeCredential` — shape of `~/.claude/.credentials.json`
+ * - `parseClaudeCodeCredentials()` — pure JSON parser + expiry check
+ *
+ * ## What does NOT live here
+ * - Filesystem reads (those belong in core/llm/credentials.ts)
+ * - Caching (belongs in core)
+ * - Multi-tier resolution (belongs in core)
+ *
+ * @module credentials
+ * @task T9307
+ */
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+/**
+ * The `claudeAiOauth` block found inside `~/.claude/.credentials.json`.
+ */
+export interface ClaudeCodeOAuthBlock {
+  /** Short-lived bearer token for Anthropic API calls. */
+  accessToken: string;
+  /** Unix-millisecond timestamp after which the token is invalid. Optional. */
+  expiresAt?: number;
+  /** Refresh token for obtaining new access tokens. Optional. */
+  refreshToken?: string;
+}
+
+/**
+ * Parsed result returned by `parseClaudeCodeCredentials()`.
+ *
+ * All fields mirror `ClaudeCodeOAuthBlock` but `accessToken` is always
+ * present (a null return indicates the file was absent, malformed, or expired).
+ */
+export interface ParsedClaudeCodeCredential {
+  /** Bearer access token for the Anthropic API. */
+  accessToken: string;
+  /** Expiry as a Unix millisecond timestamp, if provided. */
+  expiresAt?: number;
+  /** Refresh token, if present in the credentials file. */
+  refreshToken?: string;
+}
+
+// ---------------------------------------------------------------------------
+// Parser
+// ---------------------------------------------------------------------------
+
+/**
+ * Parse the contents of `~/.claude/.credentials.json` and extract the OAuth
+ * credential block.
+ *
+ * This is a **pure** helper: it accepts a `Buffer | string` (the raw file
+ * content) and returns the parsed credential or `null`. It never reads the
+ * filesystem or accesses environment variables.
+ *
+ * Expiry is checked using `Date.now()` — tokens whose `expiresAt` is in the
+ * past are treated as absent and `null` is returned.
+ *
+ * @param buf - Raw UTF-8 contents of the credentials file.
+ * @returns Parsed credential object, or `null` when the file is malformed,
+ *          the OAuth block is absent, or the token is expired.
+ *
+ * @example
+ * ```ts
+ * import { readFileSync } from 'node:fs';
+ * import { join } from 'node:path';
+ * import { homedir } from 'node:os';
+ * import { parseClaudeCodeCredentials } from '@cleocode/contracts';
+ *
+ * const raw = readFileSync(join(homedir(), '.claude', '.credentials.json'));
+ * const cred = parseClaudeCodeCredentials(raw);
+ * if (cred) {
+ *   console.log('token:', cred.accessToken);
+ * }
+ * ```
+ */
+export function parseClaudeCodeCredentials(
+  buf: Buffer | string,
+): ParsedClaudeCodeCredential | null {
+  try {
+    const text = typeof buf === 'string' ? buf : buf.toString('utf-8');
+    const raw = JSON.parse(text) as Record<string, unknown>;
+    const oauth = raw['claudeAiOauth'];
+    if (!oauth || typeof oauth !== 'object') return null;
+
+    const block = oauth as Record<string, unknown>;
+    const accessToken = block['accessToken'];
+    if (typeof accessToken !== 'string' || !accessToken.trim()) return null;
+
+    const expiresAt = typeof block['expiresAt'] === 'number' ? block['expiresAt'] : undefined;
+    if (expiresAt !== undefined && Date.now() > expiresAt) return null;
+
+    const refreshToken =
+      typeof block['refreshToken'] === 'string' && block['refreshToken'].trim()
+        ? block['refreshToken']
+        : undefined;
+
+    return {
+      accessToken: accessToken.trim(),
+      ...(expiresAt !== undefined ? { expiresAt } : {}),
+      ...(refreshToken !== undefined ? { refreshToken } : {}),
+    };
+  } catch {
+    return null;
+  }
+}