@v1nvn/agentic-core 0.14.0

package/dist/index.js

@@ -0,0 +1,179 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+//#region src/hook.ts
+/**
+* Read the Claude Code hook event JSON from stdin; empty or unparseable input
+* yields an empty event, never a thrown error — a hook must always answer.
+*/
+function readHookEvent(stream = process.stdin) {
+	return new Promise((resolve) => {
+		let data = "";
+		stream.setEncoding("utf8");
+		stream.on("data", (chunk) => {
+			data += chunk;
+		});
+		stream.on("end", () => {
+			try {
+				resolve(JSON.parse(data));
+			} catch {
+				resolve({});
+			}
+		});
+		stream.on("error", () => {
+			resolve({});
+		});
+	});
+}
+/**
+* Which transcript lastReply should read, per the hook event: transcript_path
+* when it names a real file, else session_id, else nothing (lastReply then
+* falls back to the newest session for the current project).
+*/
+function replyTarget(event) {
+	if (event.transcript_path !== void 0 && isFile$1(event.transcript_path)) return event.transcript_path;
+	return event.session_id || void 0;
+}
+function isFile$1(path) {
+	try {
+		return statSync(path).isFile();
+	} catch {
+		return false;
+	}
+}
+/**
+* Print the UserPromptExpansion decision for a zero-token command: `block`
+* keeps the command from reaching the model, with the output as the `reason`.
+*/
+function emitHookBlock(reason) {
+	process.stdout.write(`${JSON.stringify({
+		decision: "block",
+		reason
+	})}\n`);
+}
+//#endregion
+//#region src/last-reply.ts
+function isFile(path) {
+	try {
+		return statSync(path).isFile();
+	} catch {
+		return false;
+	}
+}
+function textBlocks(entry) {
+	const content = entry.message?.content;
+	if (entry.type !== "assistant" || !Array.isArray(content)) return;
+	const blocks = content.filter((b) => typeof b === "object" && b !== null && b.type === "text");
+	return blocks.length > 0 ? blocks : void 0;
+}
+/**
+* The last assistant text reply from a Claude Code session, reproducing Claude
+* Code's `/copy` byte-for-byte: the last assistant entry that contains a
+* `text` block, only its `text` block(s) (tool_use / thinking dropped), blocks
+* joined with a blank line, and no trailing newline.
+*
+* @param arg a transcript file, a session UUID under the project dir, or
+*   nothing to use the newest session for the current project.
+*/
+function lastReply(arg) {
+	const claudeDir = process.env.CLAUDE_DIR ?? join(homedir(), ".claude");
+	const proj = (process.env.CLAUDE_PROJECT_DIR ?? process.cwd()).replaceAll("/", "-");
+	const projDir = join(claudeDir, "projects", proj);
+	let file;
+	if (arg !== void 0) file = isFile(arg) ? arg : join(projDir, `${arg}.jsonl`);
+	else if (existsSync(projDir)) {
+		const newest = readdirSync(projDir).filter((f) => f.endsWith(".jsonl")).map((f) => ({
+			f,
+			mtimeMs: statSync(join(projDir, f)).mtimeMs
+		})).sort((a, b) => b.mtimeMs - a.mtimeMs).at(0);
+		if (newest) file = join(projDir, newest.f);
+	}
+	if (file === void 0 || !isFile(file)) throw new Error(`no session transcript found in ${projDir}`);
+	let last;
+	for (const line of readFileSync(file, "utf8").split("\n")) {
+		if (!line.includes("\"assistant\"")) continue;
+		let entry;
+		try {
+			entry = JSON.parse(line);
+		} catch {
+			continue;
+		}
+		const blocks = textBlocks(entry);
+		if (blocks) last = blocks;
+	}
+	return (last ?? []).map((b) => b.text ?? "").join("\n\n");
+}
+//#endregion
+//#region src/text-format.ts
+/**
+* Plain-text rendering primitives shared by the zai and tokens report
+* renderers. Output targets a monospace terminal / hook-block `reason`, so
+* everything here is fixed-width: padding, block-glyph bars, and compact
+* number formatting.
+*/
+var MONTHS = [
+	"Jan",
+	"Feb",
+	"Mar",
+	"Apr",
+	"May",
+	"Jun",
+	"Jul",
+	"Aug",
+	"Sep",
+	"Oct",
+	"Nov",
+	"Dec"
+];
+var EIGHTHS = [
+	"",
+	"▏",
+	"▎",
+	"▍",
+	"▌",
+	"▋",
+	"▊",
+	"▉"
+];
+function fmtTokens(n) {
+	if (n == null || Number.isNaN(n)) return "—";
+	if (n >= 1e9) return (n / 1e9).toFixed(1) + "B";
+	if (n >= 1e6) return (n / 1e6).toFixed(1) + "M";
+	if (n >= 1e3) return (n / 1e3).toFixed(1) + "K";
+	return String(n);
+}
+function fmtNum(n) {
+	return (n || 0).toLocaleString("en-US");
+}
+function padR(s, n) {
+	return s.length >= n ? s : s + " ".repeat(n - s.length);
+}
+function padL(s, n) {
+	return s.length >= n ? s : " ".repeat(n - s.length) + s;
+}
+/** Fixed-width bar field (width cols): █ blocks + an eighth-fraction + trailing spaces. */
+function barField(v, max, width) {
+	if (!v || v <= 0 || max <= 0) return " ".repeat(width);
+	const scaled = v / max * width;
+	let full = Math.floor(scaled);
+	let fi = Math.round((scaled - full) * 8);
+	if (fi === 8) {
+		full += 1;
+		fi = 0;
+	}
+	if (full === 0 && fi === 0) fi = 1;
+	let s = "█".repeat(Math.min(full, width));
+	if (full < width && fi > 0) s += EIGHTHS[fi];
+	if (s.length < width) s += " ".repeat(width - s.length);
+	return s.slice(0, width);
+}
+/** Filled/empty meter: █ for used, ░ for remaining. */
+function meter(pct, width) {
+	let filled = Math.round((pct || 0) / 100 * width);
+	filled = Math.max(0, Math.min(width, filled));
+	return "█".repeat(filled) + "░".repeat(width - filled);
+}
+//#endregion
+export { MONTHS, barField, emitHookBlock, fmtNum, fmtTokens, lastReply, meter, padL, padR, readHookEvent, replyTarget };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/hook.ts","../src/last-reply.ts","../src/text-format.ts"],"sourcesContent":["import { statSync } from 'node:fs';\n\nexport interface HookEvent {\n  cwd?: string;\n  session_id?: string;\n  transcript_path?: string;\n}\n\n/**\n * Read the Claude Code hook event JSON from stdin; empty or unparseable input\n * yields an empty event, never a thrown error — a hook must always answer.\n */\nexport function readHookEvent(\n  stream: NodeJS.ReadableStream = process.stdin,\n): Promise<HookEvent> {\n  return new Promise(resolve => {\n    let data = '';\n    stream.setEncoding('utf8');\n    stream.on('data', (chunk: string) => {\n      data += chunk;\n    });\n    stream.on('end', () => {\n      try {\n        resolve(JSON.parse(data) as HookEvent);\n      } catch {\n        resolve({});\n      }\n    });\n    stream.on('error', () => {\n      resolve({});\n    });\n  });\n}\n\n/**\n * Which transcript lastReply should read, per the hook event: transcript_path\n * when it names a real file, else session_id, else nothing (lastReply then\n * falls back to the newest session for the current project).\n */\nexport function replyTarget(event: HookEvent): string | undefined {\n  if (event.transcript_path !== undefined && isFile(event.transcript_path)) {\n    return event.transcript_path;\n  }\n  return event.session_id || undefined;\n}\n\nfunction isFile(path: string): boolean {\n  try {\n    return statSync(path).isFile();\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Print the UserPromptExpansion decision for a zero-token command: `block`\n * keeps the command from reaching the model, with the output as the `reason`.\n */\nexport function emitHookBlock(reason: string): void {\n  process.stdout.write(`${JSON.stringify({ decision: 'block', reason })}\\n`);\n}\n","import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\n\ninterface ContentBlock {\n  text?: string;\n  type: string;\n}\n\ninterface TranscriptEntry {\n  message?: { content?: unknown };\n  type?: string;\n}\n\nfunction isFile(path: string): boolean {\n  try {\n    return statSync(path).isFile();\n  } catch {\n    return false;\n  }\n}\n\nfunction textBlocks(entry: TranscriptEntry): ContentBlock[] | undefined {\n  const content = entry.message?.content;\n  if (entry.type !== 'assistant' || !Array.isArray(content)) {\n    return undefined;\n  }\n  const blocks = content.filter(\n    (b): b is ContentBlock =>\n      typeof b === 'object' &&\n      b !== null &&\n      (b as ContentBlock).type === 'text',\n  );\n  return blocks.length > 0 ? blocks : undefined;\n}\n\n/**\n * The last assistant text reply from a Claude Code session, reproducing Claude\n * Code's `/copy` byte-for-byte: the last assistant entry that contains a\n * `text` block, only its `text` block(s) (tool_use / thinking dropped), blocks\n * joined with a blank line, and no trailing newline.\n *\n * @param arg a transcript file, a session UUID under the project dir, or\n *   nothing to use the newest session for the current project.\n */\nexport function lastReply(arg?: string): string {\n  const claudeDir = process.env.CLAUDE_DIR ?? join(homedir(), '.claude');\n  // Claude Code keys transcripts under the project root with \"/\" → \"-\".\n  // Prefer $CLAUDE_PROJECT_DIR (exported to hook processes) over $PWD.\n  const proj = (process.env.CLAUDE_PROJECT_DIR ?? process.cwd()).replaceAll(\n    '/',\n    '-',\n  );\n  const projDir = join(claudeDir, 'projects', proj);\n\n  let file: string | undefined;\n  if (arg !== undefined) {\n    file = isFile(arg) ? arg : join(projDir, `${arg}.jsonl`);\n  } else if (existsSync(projDir)) {\n    const newest = readdirSync(projDir)\n      .filter(f => f.endsWith('.jsonl'))\n      .map(f => ({ f, mtimeMs: statSync(join(projDir, f)).mtimeMs }))\n      .sort((a, b) => b.mtimeMs - a.mtimeMs)\n      .at(0);\n    if (newest) {\n      file = join(projDir, newest.f);\n    }\n  }\n\n  if (file === undefined || !isFile(file)) {\n    throw new Error(`no session transcript found in ${projDir}`);\n  }\n\n  let last: ContentBlock[] | undefined;\n  for (const line of readFileSync(file, 'utf8').split('\\n')) {\n    if (!line.includes('\"assistant\"')) {\n      continue;\n    }\n    let entry: TranscriptEntry;\n    try {\n      entry = JSON.parse(line) as TranscriptEntry;\n    } catch {\n      continue;\n    }\n    const blocks = textBlocks(entry);\n    if (blocks) {\n      last = blocks;\n    }\n  }\n  return (last ?? []).map(b => b.text ?? '').join('\\n\\n');\n}\n","/**\n * Plain-text rendering primitives shared by the zai and tokens report\n * renderers. Output targets a monospace terminal / hook-block `reason`, so\n * everything here is fixed-width: padding, block-glyph bars, and compact\n * number formatting.\n */\n\nexport const MONTHS = [\n  'Jan',\n  'Feb',\n  'Mar',\n  'Apr',\n  'May',\n  'Jun',\n  'Jul',\n  'Aug',\n  'Sep',\n  'Oct',\n  'Nov',\n  'Dec',\n];\n\nconst EIGHTHS = ['', '▏', '▎', '▍', '▌', '▋', '▊', '▉'];\n\nexport function fmtTokens(n: null | number | undefined): string {\n  if (n == null || Number.isNaN(n)) {\n    return '—';\n  }\n  if (n >= 1e9) {\n    return (n / 1e9).toFixed(1) + 'B';\n  }\n  if (n >= 1e6) {\n    return (n / 1e6).toFixed(1) + 'M';\n  }\n  if (n >= 1e3) {\n    return (n / 1e3).toFixed(1) + 'K';\n  }\n  return String(n);\n}\n\nexport function fmtNum(n: null | number | undefined): string {\n  return (n || 0).toLocaleString('en-US');\n}\n\nexport function padR(s: string, n: number): string {\n  return s.length >= n ? s : s + ' '.repeat(n - s.length);\n}\n\nexport function padL(s: string, n: number): string {\n  return s.length >= n ? s : ' '.repeat(n - s.length) + s;\n}\n\n/** Fixed-width bar field (width cols): █ blocks + an eighth-fraction + trailing spaces. */\nexport function barField(v: number, max: number, width: number): string {\n  if (!v || v <= 0 || max <= 0) {\n    return ' '.repeat(width);\n  }\n  const scaled = (v / max) * width;\n  let full = Math.floor(scaled);\n  let fi = Math.round((scaled - full) * 8);\n  if (fi === 8) {\n    full += 1;\n    fi = 0;\n  }\n  if (full === 0 && fi === 0) {\n    fi = 1;\n  } // keep a sliver for any nonzero value\n  let s = '█'.repeat(Math.min(full, width));\n  if (full < width && fi > 0) {\n    s += EIGHTHS[fi];\n  }\n  if (s.length < width) {\n    s += ' '.repeat(width - s.length);\n  }\n  return s.slice(0, width);\n}\n\n/** Filled/empty meter: █ for used, ░ for remaining. */\nexport function meter(pct: number | undefined, width: number): string {\n  let filled = Math.round(((pct || 0) / 100) * width);\n  filled = Math.max(0, Math.min(width, filled));\n  return '█'.repeat(filled) + '░'.repeat(width - filled);\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@v1nvn/agentic-core",
+  "version": "0.14.0",
+  "description": "Shared runtime for the @v1nvn agent tools — last-reply transcript reader and fixed-width text formatting.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "claude-code",
+    "transcripts",
+    "cli"
+  ],
+  "author": "v1nvn",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/v1nvn/agentic.git",
+    "directory": "packages/core"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "devDependencies": {
+    "vite": "^8.1.4",
+    "vitest": "^4.1.10"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/src/hook.ts

@@ -0,0 +1,61 @@
+import { statSync } from 'node:fs';
+
+export interface HookEvent {
+  cwd?: string;
+  session_id?: string;
+  transcript_path?: string;
+}
+
+/**
+ * Read the Claude Code hook event JSON from stdin; empty or unparseable input
+ * yields an empty event, never a thrown error — a hook must always answer.
+ */
+export function readHookEvent(
+  stream: NodeJS.ReadableStream = process.stdin,
+): Promise<HookEvent> {
+  return new Promise(resolve => {
+    let data = '';
+    stream.setEncoding('utf8');
+    stream.on('data', (chunk: string) => {
+      data += chunk;
+    });
+    stream.on('end', () => {
+      try {
+        resolve(JSON.parse(data) as HookEvent);
+      } catch {
+        resolve({});
+      }
+    });
+    stream.on('error', () => {
+      resolve({});
+    });
+  });
+}
+
+/**
+ * Which transcript lastReply should read, per the hook event: transcript_path
+ * when it names a real file, else session_id, else nothing (lastReply then
+ * falls back to the newest session for the current project).
+ */
+export function replyTarget(event: HookEvent): string | undefined {
+  if (event.transcript_path !== undefined && isFile(event.transcript_path)) {
+    return event.transcript_path;
+  }
+  return event.session_id || undefined;
+}
+
+function isFile(path: string): boolean {
+  try {
+    return statSync(path).isFile();
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Print the UserPromptExpansion decision for a zero-token command: `block`
+ * keeps the command from reaching the model, with the output as the `reason`.
+ */
+export function emitHookBlock(reason: string): void {
+  process.stdout.write(`${JSON.stringify({ decision: 'block', reason })}\n`);
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './hook.js';
+export * from './last-reply.js';
+export * from './text-format.js';

package/src/last-reply.ts

@@ -0,0 +1,91 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+interface ContentBlock {
+  text?: string;
+  type: string;
+}
+
+interface TranscriptEntry {
+  message?: { content?: unknown };
+  type?: string;
+}
+
+function isFile(path: string): boolean {
+  try {
+    return statSync(path).isFile();
+  } catch {
+    return false;
+  }
+}
+
+function textBlocks(entry: TranscriptEntry): ContentBlock[] | undefined {
+  const content = entry.message?.content;
+  if (entry.type !== 'assistant' || !Array.isArray(content)) {
+    return undefined;
+  }
+  const blocks = content.filter(
+    (b): b is ContentBlock =>
+      typeof b === 'object' &&
+      b !== null &&
+      (b as ContentBlock).type === 'text',
+  );
+  return blocks.length > 0 ? blocks : undefined;
+}
+
+/**
+ * The last assistant text reply from a Claude Code session, reproducing Claude
+ * Code's `/copy` byte-for-byte: the last assistant entry that contains a
+ * `text` block, only its `text` block(s) (tool_use / thinking dropped), blocks
+ * joined with a blank line, and no trailing newline.
+ *
+ * @param arg a transcript file, a session UUID under the project dir, or
+ *   nothing to use the newest session for the current project.
+ */
+export function lastReply(arg?: string): string {
+  const claudeDir = process.env.CLAUDE_DIR ?? join(homedir(), '.claude');
+  // Claude Code keys transcripts under the project root with "/" → "-".
+  // Prefer $CLAUDE_PROJECT_DIR (exported to hook processes) over $PWD.
+  const proj = (process.env.CLAUDE_PROJECT_DIR ?? process.cwd()).replaceAll(
+    '/',
+    '-',
+  );
+  const projDir = join(claudeDir, 'projects', proj);
+
+  let file: string | undefined;
+  if (arg !== undefined) {
+    file = isFile(arg) ? arg : join(projDir, `${arg}.jsonl`);
+  } else if (existsSync(projDir)) {
+    const newest = readdirSync(projDir)
+      .filter(f => f.endsWith('.jsonl'))
+      .map(f => ({ f, mtimeMs: statSync(join(projDir, f)).mtimeMs }))
+      .sort((a, b) => b.mtimeMs - a.mtimeMs)
+      .at(0);
+    if (newest) {
+      file = join(projDir, newest.f);
+    }
+  }
+
+  if (file === undefined || !isFile(file)) {
+    throw new Error(`no session transcript found in ${projDir}`);
+  }
+
+  let last: ContentBlock[] | undefined;
+  for (const line of readFileSync(file, 'utf8').split('\n')) {
+    if (!line.includes('"assistant"')) {
+      continue;
+    }
+    let entry: TranscriptEntry;
+    try {
+      entry = JSON.parse(line) as TranscriptEntry;
+    } catch {
+      continue;
+    }
+    const blocks = textBlocks(entry);
+    if (blocks) {
+      last = blocks;
+    }
+  }
+  return (last ?? []).map(b => b.text ?? '').join('\n\n');
+}

package/src/text-format.ts

@@ -0,0 +1,83 @@
+/**
+ * Plain-text rendering primitives shared by the zai and tokens report
+ * renderers. Output targets a monospace terminal / hook-block `reason`, so
+ * everything here is fixed-width: padding, block-glyph bars, and compact
+ * number formatting.
+ */
+
+export const MONTHS = [
+  'Jan',
+  'Feb',
+  'Mar',
+  'Apr',
+  'May',
+  'Jun',
+  'Jul',
+  'Aug',
+  'Sep',
+  'Oct',
+  'Nov',
+  'Dec',
+];
+
+const EIGHTHS = ['', '▏', '▎', '▍', '▌', '▋', '▊', '▉'];
+
+export function fmtTokens(n: null | number | undefined): string {
+  if (n == null || Number.isNaN(n)) {
+    return '—';
+  }
+  if (n >= 1e9) {
+    return (n / 1e9).toFixed(1) + 'B';
+  }
+  if (n >= 1e6) {
+    return (n / 1e6).toFixed(1) + 'M';
+  }
+  if (n >= 1e3) {
+    return (n / 1e3).toFixed(1) + 'K';
+  }
+  return String(n);
+}
+
+export function fmtNum(n: null | number | undefined): string {
+  return (n || 0).toLocaleString('en-US');
+}
+
+export function padR(s: string, n: number): string {
+  return s.length >= n ? s : s + ' '.repeat(n - s.length);
+}
+
+export function padL(s: string, n: number): string {
+  return s.length >= n ? s : ' '.repeat(n - s.length) + s;
+}
+
+/** Fixed-width bar field (width cols): █ blocks + an eighth-fraction + trailing spaces. */
+export function barField(v: number, max: number, width: number): string {
+  if (!v || v <= 0 || max <= 0) {
+    return ' '.repeat(width);
+  }
+  const scaled = (v / max) * width;
+  let full = Math.floor(scaled);
+  let fi = Math.round((scaled - full) * 8);
+  if (fi === 8) {
+    full += 1;
+    fi = 0;
+  }
+  if (full === 0 && fi === 0) {
+    fi = 1;
+  } // keep a sliver for any nonzero value
+  let s = '█'.repeat(Math.min(full, width));
+  if (full < width && fi > 0) {
+    s += EIGHTHS[fi];
+  }
+  if (s.length < width) {
+    s += ' '.repeat(width - s.length);
+  }
+  return s.slice(0, width);
+}
+
+/** Filled/empty meter: █ for used, ░ for remaining. */
+export function meter(pct: number | undefined, width: number): string {
+  let filled = Math.round(((pct || 0) / 100) * width);
+  filled = Math.max(0, Math.min(width, filled));
+  return '█'.repeat(filled) + '░'.repeat(width - filled);
+}