@nt-ai-lab/deterministic-agent-workflow-claude-code 0.1.0

package/dist/features/claude-code-cli/entrypoint/claude-code-workflow-cli.d.ts

@@ -0,0 +1,4 @@
+import type { BaseWorkflowState, RehydratableWorkflow } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+import type { ClaudeCodeWorkflowCliConfig } from '../../../platform/domain/claude-code-workflow-cli-types';
+/** @riviere-role cli-entrypoint */
+export declare function createClaudeCodeWorkflowCli<TWorkflow extends RehydratableWorkflow<TState>, TState extends BaseWorkflowState, TDeps>(config: ClaudeCodeWorkflowCliConfig<TWorkflow, TState, TDeps>): void;

package/dist/features/claude-code-cli/entrypoint/claude-code-workflow-cli.js

@@ -0,0 +1,9 @@
+import { createWorkflowCli } from '@nt-ai-lab/deterministic-agent-workflow-cli';
+import { ClaudeCodeTranscriptReader } from '../../../platform/infra/external-clients/claude-code/claude-code-transcript-reader.js';
+/** @riviere-role cli-entrypoint */
+export function createClaudeCodeWorkflowCli(config) {
+    createWorkflowCli({
+        ...config,
+        transcriptReader: new ClaudeCodeTranscriptReader(),
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { ClaudeCodeTranscriptReader } from './platform/infra/external-clients/claude-code/claude-code-transcript-reader';
+export { createClaudeCodeWorkflowCli } from './features/claude-code-cli/entrypoint/claude-code-workflow-cli';
+export type { ClaudeCodeWorkflowCliConfig } from './platform/domain/claude-code-workflow-cli-types';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { ClaudeCodeTranscriptReader } from './platform/infra/external-clients/claude-code/claude-code-transcript-reader.js';
+export { createClaudeCodeWorkflowCli } from './features/claude-code-cli/entrypoint/claude-code-workflow-cli.js';

package/dist/platform/domain/claude-code-workflow-cli-types.d.ts

@@ -0,0 +1,4 @@
+import type { BaseWorkflowState, RehydratableWorkflow } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+import type { WorkflowCliConfig } from '@nt-ai-lab/deterministic-agent-workflow-cli';
+/** @riviere-role value-object */
+export type ClaudeCodeWorkflowCliConfig<TWorkflow extends RehydratableWorkflow<TState>, TState extends BaseWorkflowState, TDeps> = Omit<WorkflowCliConfig<TWorkflow, TState, TDeps>, 'transcriptReader'>;

package/dist/platform/domain/claude-code-workflow-cli-types.js

@@ -0,0 +1 @@
+export {};

package/dist/platform/infra/external-clients/claude-code/claude-code-transcript-reader.d.ts

@@ -0,0 +1,5 @@
+import type { TranscriptMessage, TranscriptReader } from '@nt-ai-lab/deterministic-agent-workflow-engine';
+/** @riviere-role external-client-model */
+export declare class ClaudeCodeTranscriptReader implements TranscriptReader {
+    readMessages(transcriptPath: string): readonly TranscriptMessage[];
+}

package/dist/platform/infra/external-clients/claude-code/claude-code-transcript-reader.js

@@ -0,0 +1,72 @@
+import { closeSync, openSync, readSync, statSync, } from 'node:fs';
+import { z } from 'zod';
+const READ_TAIL_BYTES = 50_000;
+const textBlock = z.object({
+    type: z.literal('text'),
+    text: z.string(),
+});
+const otherBlock = z.object({ type: z.string() });
+const contentBlock = z.union([textBlock, otherBlock]);
+const assistantEntrySchema = z.object({
+    type: z.literal('message'),
+    role: z.literal('assistant'),
+    id: z.string(),
+    content: z.array(contentBlock),
+});
+/** @riviere-role external-client-model */
+export class ClaudeCodeTranscriptReader {
+    readMessages(transcriptPath) {
+        const tail = readFileTail(transcriptPath);
+        return parseJsonlLines(tail);
+    }
+}
+function readFileTail(filePath) {
+    const fileSize = statSync(filePath).size;
+    const offset = Math.max(0, fileSize - READ_TAIL_BYTES);
+    const bytesToRead = fileSize - offset;
+    const buffer = Buffer.alloc(bytesToRead);
+    const fd = openSync(filePath, 'r');
+    readSync(fd, buffer, 0, bytesToRead, offset);
+    closeSync(fd);
+    return buffer.toString('utf-8');
+}
+function parseJsonlLines(content) {
+    return content
+        .split('\n')
+        .filter((line) => line.trim().length > 0)
+        .flatMap((line) => parseJsonlLine(line));
+}
+function parseJsonlLine(line) {
+    const entry = tryParseEntry(line);
+    if (entry === undefined) {
+        return [];
+    }
+    return [toTranscriptMessage(entry)];
+}
+function tryParseEntry(line) {
+    try {
+        const result = assistantEntrySchema.safeParse(JSON.parse(line));
+        if (result.success) {
+            return result.data;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function toTranscriptMessage(entry) {
+    return {
+        id: entry.id,
+        textContent: extractFirstText(entry),
+    };
+}
+function extractFirstText(entry) {
+    for (const block of entry.content) {
+        const result = textBlock.safeParse(block);
+        if (result.success) {
+            return result.data.text;
+        }
+    }
+    return undefined;
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@nt-ai-lab/deterministic-agent-workflow-claude-code",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@nt-ai-lab/deterministic-agent-workflow-cli": "workspace:*",
+    "@nt-ai-lab/deterministic-agent-workflow-engine": "workspace:*",
+    "zod": "^3.25.76"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}