jg-agent-hq 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.5.1
+
+- Qualify Claude Code 2.1.306 history alongside 2.1.304, including transcripts spanning both versions. Continue to reject unqualified CLI and transcript versions.
+
 ## 0.5.0
 
 - Add safe publication observations for the host's System view, with separate pending, blocked, failed and uncertain states, timestamps and exact commit identity.

package/README.md

@@ -39,9 +39,9 @@ The Node API exposes `createAgentHq({ stateRoot, allowedRoots })` and `requestAg
 
 The controller owns its SQLite worker and native connections independently of client connections. Private state contains the lifetime owner, Unix socket and SQLite discovery metadata. Conversation bodies remain in the native providers' storage. Browsing never resumes an external session or starts inference. Quota windows come from native account observations, with explicit stale and unavailable states.
 
-The current read contracts were exercised against Codex 0.163.0 and Claude Code 2.1.304 on Linux. Unsupported native responses fail explicitly. `jg-agent-hq/contracts` contains browser-safe schemas and types; importing it does not import the host runtime.
+The current read contracts were exercised against Codex 0.163.0 and Claude Code versions 2.1.304 and 2.1.306 on Linux. Unsupported native responses fail explicitly. `jg-agent-hq/contracts` contains browser-safe schemas and types; importing it does not import the host runtime.
 
-Use `--provider claude` for Claude history and usage; the default is `codex`. Claude connects lazily through its native structured CLI, with normal settings enabled and no user prompt. Usage requests explicitly disable the optional transcript-behavior scan. Its local history reader supports the qualified 2.1.304 format only, keeps byte locations rather than conversation bodies in SQLite, and reports unsupported history as unavailable. File history cannot establish current execution state. See the [reader limits and freshness contract](api/README.md#claude-history).
+Use `--provider claude` for Claude history and usage; the default is `codex`. Claude connects lazily through its native structured CLI, with normal settings enabled and no user prompt. Usage requests explicitly disable the optional transcript-behavior scan. Its local history reader accepts only the qualified 2.1.304 and 2.1.306 versions, including transcripts containing both, keeps byte locations rather than conversation bodies in SQLite, and reports unsupported history as unavailable. File history cannot establish current execution state. See the [reader limits and freshness contract](api/README.md#claude-history).
 
 Explicit actions create, name, adopt, resume and close threads; send idle messages; steer an exact running turn; queue the next message; interrupt; and answer native questions or permissions. Actions have stable UUIDs and durable receipts. Repeating the same request returns its receipt; changing that UUID's payload conflicts. A lost acknowledgement stays uncertain until the exact native response arrives or the operator makes an explicit recovery choice. HQ never resends uncertain input.
 

package/api/README.md

@@ -48,7 +48,7 @@ Threads expose native state, `historyState` (`available` or `unavailable`), owne
 
 Claude connects on its first read through `claude --print --input-format stream-json --output-format stream-json --verbose`. No user prompt, bare mode, permission bypass or SDK dependency is used. Runtime status reports this adapter as `idle`, `ready` or `unavailable`, with its observed CLI version. An unavailable native lane requires restarting the host after resolving the native problem.
 
-The qualified CLI interface has no session-history listing operation. The Claude-owned reader therefore uses direct UUID JSONL files in the native project's directory beneath `CLAUDE_CONFIG_DIR`, or the normal `.claude` directory. Both CLI and versioned transcript records must match 2.1.304. Other formats, encoded project keys longer than 200 characters, directory/file links, malformed records and records larger than 1 MiB report unavailable. Discovery never recurses into subdirectories, including excluded directories. Unsupported discovered sessions have `historyState: unavailable`; they do not prevent supported sessions from being listed.
+The qualified CLI interface has no session-history listing operation. The Claude-owned reader therefore uses direct UUID JSONL files in the native project's directory beneath `CLAUDE_CONFIG_DIR`, or the normal `.claude` directory. The CLI and each versioned transcript record must independently match a qualified version: 2.1.304 or 2.1.306. A transcript may contain both qualified versions. Other formats, encoded project keys longer than 200 characters, directory/file links, malformed records and records larger than 1 MiB report unavailable. Discovery never recurses into subdirectories, including excluded directories. Unsupported discovered sessions have `historyState: unavailable`; they do not prevent supported sessions from being listed.
 
 Discovery verifies the workspace recorded inside each transcript before returning its identity or title. A matching native directory name alone is insufficient because punctuation replacement can produce colliding directory keys. Foreign workspaces are omitted. If a file's workspace cannot be established, discovery reports unavailable rather than inventing an empty result.
 
@@ -100,7 +100,7 @@ Prompts expose `replyActionId` as soon as a reply is admitted, so reconnecting c
 
 ### Claude native control
 
-Each controlled session has one persistent native `claude` process in the authorized workspace. HQ adds structured input/output, replayed user-message acknowledgements, partial-message output and `--permission-prompt-tool=stdio`. It does not set a model, replace instructions/settings, disable session persistence, bypass permissions or enable a bare mode. Native skills remain available. Control was exercised against CLI 2.1.304. Native idle initialization, session identity and matching acknowledgements establish capability; a changed version label alone does not disable compatible controls. File history retains its separate exact-version check.
+Each controlled session has one persistent native `claude` process in the authorized workspace. HQ adds structured input/output, replayed user-message acknowledgements, partial-message output and `--permission-prompt-tool=stdio`. It does not set a model, replace instructions/settings, disable session persistence, bypass permissions or enable a bare mode. Native skills remain available. Control was exercised against CLI 2.1.304. Native idle initialization, session identity and matching acknowledgements establish capability; a changed version label alone does not disable compatible controls. File history retains its separate qualified-version check.
 
 Creation chooses a native UUID without inference, then names that exact session. Resume uses native `--resume` and verifies the session-id fence on the name control before marking the session idle. The operator's handoff confirmation establishes that another CLI controller is closed; file timestamps and file-backed unknown states do not establish this. Independently running CLIs are outside HQ's state-directory coordination boundary.
 

package/dist/providers/claude/claude.js

@@ -2,7 +2,7 @@ import { Exception } from 'error-message-utils';
 import { scheduler } from 'node:timers/promises';
 import { z } from 'zod';
 import { createClaudeRpc } from './rpc.js';
-import { CLAUDE_HISTORY_VERSION, ClaudeUsageSchema } from './types.js';
+import { ClaudeHistoryVersionSchema, ClaudeUsageSchema } from './types.js';
 import { toClaudeUsageSnapshot } from './transformers.js';
 /**
  * Lazily connects read-only Claude capabilities; Codex needs no Claude installation.
@@ -61,7 +61,7 @@ export const createClaudeProvider = (store) => {
         async readHistory(command) {
             const deadline = Date.now() + 30_000;
             const native = await open();
-            if (native.version !== CLAUDE_HISTORY_VERSION)
+            if (!ClaudeHistoryVersionSchema.safeParse(native.version).success)
                 throw new Exception('The Claude history is unavailable', undefined, {
                     kind: 'agent-unavailable',
                 });

package/dist/providers/claude/history/history.model.js

@@ -4,7 +4,7 @@ import { Exception, extractMessage, hasErrorCode } from 'error-message-utils';
 import { z } from 'zod';
 import { HqResponseSchema, } from '../../../contracts/index.js';
 import { decodeHistoryCursor, encodeHistoryCursor, } from '../../../sessions/index.js';
-import { CLAUDE_HISTORY_VERSION } from '../types.js';
+import { ClaudeHistoryVersionSchema } from '../types.js';
 import { EntryRowSchema, EntrySeekSchema, FileRowSchema, RecordSchema, SeekSchema, } from './types.js';
 import { openTranscript, projectDirectory, toClaudeItem } from './utilities.js';
 const MAX_RECORD_BYTES = 1_048_576;
@@ -189,7 +189,7 @@ export class ClaudeHistoryModel {
                     this.__unavailable();
                 const record = RecordSchema.parse(JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes)));
                 if (record.uuid !== entry.uuid ||
-                    record.version !== CLAUDE_HISTORY_VERSION ||
+                    !ClaudeHistoryVersionSchema.safeParse(record.version).success ||
                     record.cwd !== root)
                     this.__unavailable();
                 const item = toClaudeItem(record, entry.turn_id);
@@ -403,14 +403,15 @@ export class ClaudeHistoryModel {
             row.name = record.customTitle;
             return;
         }
-        if (record.version !== undefined && record.version !== CLAUDE_HISTORY_VERSION)
+        if (record.version !== undefined &&
+            !ClaudeHistoryVersionSchema.safeParse(record.version).success)
             this.__unavailable();
         if (record.isSidechain || !record.uuid)
             return;
         if ((record.type === 'user' || record.type === 'assistant') &&
             record.message?.role !== record.type)
             this.__unavailable();
-        if (record.version !== CLAUDE_HISTORY_VERSION ||
+        if (!ClaudeHistoryVersionSchema.safeParse(record.version).success ||
             record.sessionId !== nativeId ||
             record.cwd !== root ||
             record.timestamp === undefined ||

package/dist/providers/claude/types.d.ts

@@ -1,5 +1,8 @@
 import { z } from 'zod';
-export declare const CLAUDE_HISTORY_VERSION = "2.1.304";
+export declare const ClaudeHistoryVersionSchema: z.ZodEnum<{
+    "2.1.304": "2.1.304";
+    "2.1.306": "2.1.306";
+}>;
 export declare const ClaudeInitializeSchema: z.ZodObject<{
     claude_code_version: z.ZodString;
     commands: z.ZodOptional<z.ZodUnknown>;

package/dist/providers/claude/types.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-// the local reader is qualified against this exact CLI transcript capability
-export const CLAUDE_HISTORY_VERSION = '2.1.304';
+// only explicitly qualified CLI and transcript versions may use the local reader
+export const ClaudeHistoryVersionSchema = z.enum(['2.1.304', '2.1.306']);
 export const ClaudeInitializeSchema = z.object({
     claude_code_version: z.string().min(1).max(128),
     commands: z.unknown().optional(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jg-agent-hq",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Native coding-agent workspace primitives.",
   "type": "module",
   "license": "MIT",