@v1nvn/agentic-core 0.44.0 → 0.45.1

package/src/draw.js

@@ -0,0 +1,244 @@
+/**
+ * The drawing kit — the one home of the repo's terminal drawing model: ink
+ * kinds are a closed union, color values are data, surfaces render
+ * documents, and `toSgr` is the one skin, resetting each inked segment
+ * unless it carries its ink into the next. Loaded only by processes — the
+ * engine's island loader imports its own files by relative path alone.
+ */
+export function rgb(r, g, b) {
+    return { rgb: [r, g, b] };
+}
+export function indexed(n) {
+    return { indexed: n };
+}
+export function bg(ink) {
+    return { bg: ink };
+}
+export function line(...segments) {
+    return segments;
+}
+export function doc(...rows) {
+    return rows;
+}
+export function plain(text) {
+    return { text };
+}
+export function dim(text) {
+    return { text, ink: 'dim' };
+}
+export function bold(text) {
+    return { text, ink: 'bold' };
+}
+export function green(text) {
+    return { text, ink: 'green' };
+}
+export function magenta(text) {
+    return { text, ink: 'magenta' };
+}
+export function red(text) {
+    return { text, ink: 'red' };
+}
+export function yellow(text) {
+    return { text, ink: 'yellow' };
+}
+function assertNever(kind) {
+    throw new Error(`unhandled Ink kind: ${String(kind)}`);
+}
+function paramsOf(ink) {
+    if (typeof ink !== 'string') {
+        if ('bg' in ink) {
+            return paramsOf(ink.bg)
+                .replace(/^3(\d)/, '4$1')
+                .replace(/^9(\d)/, '10$1');
+        }
+        return 'indexed' in ink
+            ? `38;5;${ink.indexed}`
+            : `38;2;${ink.rgb[0]};${ink.rgb[1]};${ink.rgb[2]}`;
+    }
+    switch (ink) {
+        case 'blue':
+            return '34';
+        case 'bold':
+            return '1';
+        case 'brightBlack':
+            return '90';
+        case 'cyan':
+            return '36';
+        case 'dim':
+            return '2';
+        case 'green':
+            return '32';
+        case 'magenta':
+            return '35';
+        case 'mark':
+            return '1;97';
+        case 'plain':
+            return '39';
+        case 'red':
+            return '31';
+        case 'white':
+            return '37';
+        case 'yellow':
+            return '33';
+        default:
+            return assertNever(ink);
+    }
+}
+function rowsOf(rows) {
+    return rows.every(r => Array.isArray(r))
+        ? rows
+        : [rows];
+}
+export function toSgr(rows) {
+    return rowsOf(rows)
+        .map(row => {
+        let out = '';
+        let inkOpen = false;
+        for (const seg of row) {
+            if (seg.ink === undefined) {
+                out += (inkOpen ? '\x1b[0m' : '') + seg.text;
+                inkOpen = false;
+                continue;
+            }
+            out += `\x1b[${paramsOf(seg.ink)}m${seg.text}`;
+            if (seg.carry === true) {
+                inkOpen = true;
+            }
+            else {
+                out += '\x1b[0m';
+                inkOpen = false;
+            }
+        }
+        return inkOpen ? `${out}\x1b[0m` : out;
+    })
+        .join('\n');
+}
+export function stripSgr(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*m/g, '');
+}
+export function textOf(rows) {
+    return rowsOf(rows)
+        .map(row => row.map(seg => seg.text).join(''))
+        .join('\n');
+}
+function stdioOf(result) {
+    return typeof result === 'object' && result !== null ? result : {};
+}
+export function stdoutOf(result) {
+    const { stdout } = stdioOf(result);
+    return typeof stdout === 'string' ? stdout : '';
+}
+/** The one line an exec shows: the refusal's reason, stdout, else stderr or `fallback`. */
+export function lineOf(call, fallback) {
+    if (call.deny !== undefined) {
+        return call.deny;
+    }
+    if (call.isError === true) {
+        return call.text ?? fallback;
+    }
+    const out = stdoutOf(call.result).trim();
+    if (out !== '') {
+        return out;
+    }
+    const { stderr } = stdioOf(call.result);
+    const err = typeof stderr === 'string' ? stderr.trim() : '';
+    return err !== '' ? err : fallback;
+}
+export const RULE_WIDTH = 68;
+export const BLOCK = '█';
+export const TRACK = '·';
+export const EIGHTHS = [
+    '',
+    '▏',
+    '▎',
+    '▍',
+    '▌',
+    '▋',
+    '▊',
+    '▉',
+];
+export function rule(width = RULE_WIDTH) {
+    return '─'.repeat(Math.max(0, width));
+}
+export function pad(text, width, side) {
+    if (text.length >= width) {
+        return text;
+    }
+    const gap = ' '.repeat(width - text.length);
+    return side === 'left' ? gap + text : text + gap;
+}
+export function meter(pct, width, filled = 'green') {
+    const safePct = typeof pct === 'number' && Number.isFinite(pct) ? pct : 0;
+    const n = Math.max(0, Math.min(width, Math.round((safePct / 100) * width)));
+    return line({ text: BLOCK.repeat(n), ink: filled }, { text: TRACK.repeat(width - n), ink: 'dim' });
+}
+/** Fixed-width bar field: full blocks, an eighth-fraction edge, spaces to width. */
+export function bar(value, max, width) {
+    if (!(value > 0) || !(max > 0)) {
+        return ' '.repeat(width);
+    }
+    const scaled = (value / 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 out = BLOCK.repeat(Math.min(full, width));
+    if (full < width && fi > 0) {
+        out += EIGHTHS[fi] ?? '';
+    }
+    return pad(out, width, 'right');
+}
+export function pad2(n) {
+    return String(n).padStart(2, '0');
+}
+export const MONTHS = [
+    'Jan',
+    'Feb',
+    'Mar',
+    'Apr',
+    'May',
+    'Jun',
+    'Jul',
+    'Aug',
+    'Sep',
+    'Oct',
+    'Nov',
+    'Dec',
+];
+/** Compact count: 1.2K / 3.4M / 5.6B; '—' for absent or NaN. */
+export 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);
+}
+/** Grouped integer, en-US separators; 0 for absent. */
+export function fmtNum(n) {
+    return (n || 0).toLocaleString('en-US');
+}
+/** Local date-time stamp: `YYYY-MM-DD`, plus `HH:mm` and optionally seconds. */
+export function localStamp(now, clock) {
+    const day = `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}`;
+    if (clock === 'none') {
+        return day;
+    }
+    const hhmm = `${pad2(now.getHours())}:${pad2(now.getMinutes())}`;
+    return clock === 'second'
+        ? `${day} ${hhmm}:${pad2(now.getSeconds())}`
+        : `${day} ${hhmm}`;
+}

package/src/draw.ts

@@ -0,0 +1,332 @@
+/**
+ * The drawing kit — the one home of the repo's terminal drawing model: ink
+ * kinds are a closed union, color values are data, surfaces render
+ * documents, and `toSgr` is the one skin, resetting each inked segment
+ * unless it carries its ink into the next. Loaded only by processes — the
+ * engine's island loader imports its own files by relative path alone.
+ */
+
+export type InkKind =
+  | 'blue'
+  | 'bold'
+  | 'brightBlack'
+  | 'cyan'
+  | 'dim'
+  | 'green'
+  | 'magenta'
+  | 'mark'
+  | 'plain'
+  | 'red'
+  | 'white'
+  | 'yellow';
+
+export type Ink =
+  | InkKind
+  | { readonly bg: Ink }
+  | { readonly indexed: number }
+  | { readonly rgb: readonly [number, number, number] };
+
+export function rgb(r: number, g: number, b: number): Ink {
+  return { rgb: [r, g, b] };
+}
+
+export function indexed(n: number): Ink {
+  return { indexed: n };
+}
+
+export function bg(ink: Ink): Ink {
+  return { bg: ink };
+}
+
+export interface Segment {
+  readonly carry?: boolean;
+  readonly ink?: Ink;
+  readonly text: string;
+}
+
+declare const lineBrand: unique symbol;
+declare const docBrand: unique symbol;
+
+export type Line = readonly Segment[] & { readonly [lineBrand]: true };
+export type Doc = readonly Line[] & { readonly [docBrand]: true };
+
+export function line(...segments: Segment[]): Line {
+  return segments as unknown as Line;
+}
+
+export function doc(...rows: Line[]): Doc {
+  return rows as unknown as Doc;
+}
+
+export function plain(text: string): Segment {
+  return { text };
+}
+
+export function dim(text: string): Segment {
+  return { text, ink: 'dim' };
+}
+
+export function bold(text: string): Segment {
+  return { text, ink: 'bold' };
+}
+
+export function green(text: string): Segment {
+  return { text, ink: 'green' };
+}
+
+export function magenta(text: string): Segment {
+  return { text, ink: 'magenta' };
+}
+
+export function red(text: string): Segment {
+  return { text, ink: 'red' };
+}
+
+export function yellow(text: string): Segment {
+  return { text, ink: 'yellow' };
+}
+
+function assertNever(kind: never): never {
+  throw new Error(`unhandled Ink kind: ${String(kind)}`);
+}
+
+function paramsOf(ink: Ink): string {
+  if (typeof ink !== 'string') {
+    if ('bg' in ink) {
+      return paramsOf(ink.bg)
+        .replace(/^3(\d)/, '4$1')
+        .replace(/^9(\d)/, '10$1');
+    }
+    return 'indexed' in ink
+      ? `38;5;${ink.indexed}`
+      : `38;2;${ink.rgb[0]};${ink.rgb[1]};${ink.rgb[2]}`;
+  }
+  switch (ink) {
+    case 'blue':
+      return '34';
+    case 'bold':
+      return '1';
+    case 'brightBlack':
+      return '90';
+    case 'cyan':
+      return '36';
+    case 'dim':
+      return '2';
+    case 'green':
+      return '32';
+    case 'magenta':
+      return '35';
+    case 'mark':
+      return '1;97';
+    case 'plain':
+      return '39';
+    case 'red':
+      return '31';
+    case 'white':
+      return '37';
+    case 'yellow':
+      return '33';
+    default:
+      return assertNever(ink);
+  }
+}
+
+function rowsOf(rows: Doc | Line): readonly (readonly Segment[])[] {
+  return (rows as readonly unknown[]).every(r => Array.isArray(r))
+    ? (rows as Doc)
+    : [rows as Line];
+}
+
+export function toSgr(rows: Doc | Line): string {
+  return rowsOf(rows)
+    .map(row => {
+      let out = '';
+      let inkOpen = false;
+      for (const seg of row) {
+        if (seg.ink === undefined) {
+          out += (inkOpen ? '\x1b[0m' : '') + seg.text;
+          inkOpen = false;
+          continue;
+        }
+        out += `\x1b[${paramsOf(seg.ink)}m${seg.text}`;
+        if (seg.carry === true) {
+          inkOpen = true;
+        } else {
+          out += '\x1b[0m';
+          inkOpen = false;
+        }
+      }
+      return inkOpen ? `${out}\x1b[0m` : out;
+    })
+    .join('\n');
+}
+
+export function stripSgr(text: string): string {
+  // eslint-disable-next-line no-control-regex
+  return text.replace(/\x1b\[[0-9;]*m/g, '');
+}
+
+export function textOf(rows: Doc | Line): string {
+  return rowsOf(rows)
+    .map(row => row.map(seg => seg.text).join(''))
+    .join('\n');
+}
+
+export interface ToolLineSource {
+  readonly deny?: string;
+  readonly isError?: boolean;
+  readonly result?: unknown;
+  readonly text?: string;
+}
+
+interface Stdio {
+  readonly stderr?: unknown;
+  readonly stdout?: unknown;
+}
+
+function stdioOf(result: unknown): Stdio {
+  return typeof result === 'object' && result !== null ? result : {};
+}
+
+export function stdoutOf(result: unknown): string {
+  const { stdout } = stdioOf(result);
+  return typeof stdout === 'string' ? stdout : '';
+}
+
+/** The one line an exec shows: the refusal's reason, stdout, else stderr or `fallback`. */
+export function lineOf(call: ToolLineSource, fallback: string): string {
+  if (call.deny !== undefined) {
+    return call.deny;
+  }
+  if (call.isError === true) {
+    return call.text ?? fallback;
+  }
+  const out = stdoutOf(call.result).trim();
+  if (out !== '') {
+    return out;
+  }
+  const { stderr } = stdioOf(call.result);
+  const err = typeof stderr === 'string' ? stderr.trim() : '';
+  return err !== '' ? err : fallback;
+}
+
+export const RULE_WIDTH = 68;
+
+export const BLOCK = '█';
+export const TRACK = '·';
+export const EIGHTHS: readonly (string | undefined)[] = [
+  '',
+  '▏',
+  '▎',
+  '▍',
+  '▌',
+  '▋',
+  '▊',
+  '▉',
+];
+
+export function rule(width: number = RULE_WIDTH): string {
+  return '─'.repeat(Math.max(0, width));
+}
+
+export function pad(
+  text: string,
+  width: number,
+  side: 'left' | 'right',
+): string {
+  if (text.length >= width) {
+    return text;
+  }
+  const gap = ' '.repeat(width - text.length);
+  return side === 'left' ? gap + text : text + gap;
+}
+
+export function meter(
+  pct: null | number | undefined,
+  width: number,
+  filled: Ink = 'green',
+): Line {
+  const safePct = typeof pct === 'number' && Number.isFinite(pct) ? pct : 0;
+  const n = Math.max(0, Math.min(width, Math.round((safePct / 100) * width)));
+  return line(
+    { text: BLOCK.repeat(n), ink: filled },
+    { text: TRACK.repeat(width - n), ink: 'dim' },
+  );
+}
+
+/** Fixed-width bar field: full blocks, an eighth-fraction edge, spaces to width. */
+export function bar(value: number, max: number, width: number): string {
+  if (!(value > 0) || !(max > 0)) {
+    return ' '.repeat(width);
+  }
+  const scaled = (value / 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 out = BLOCK.repeat(Math.min(full, width));
+  if (full < width && fi > 0) {
+    out += EIGHTHS[fi] ?? '';
+  }
+  return pad(out, width, 'right');
+}
+
+export function pad2(n: number): string {
+  return String(n).padStart(2, '0');
+}
+
+export const MONTHS = [
+  'Jan',
+  'Feb',
+  'Mar',
+  'Apr',
+  'May',
+  'Jun',
+  'Jul',
+  'Aug',
+  'Sep',
+  'Oct',
+  'Nov',
+  'Dec',
+] as const;
+
+/** Compact count: 1.2K / 3.4M / 5.6B; '—' for absent or NaN. */
+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);
+}
+
+/** Grouped integer, en-US separators; 0 for absent. */
+export function fmtNum(n: null | number | undefined): string {
+  return (n || 0).toLocaleString('en-US');
+}
+
+export type Clock = 'minute' | 'none' | 'second';
+
+/** Local date-time stamp: `YYYY-MM-DD`, plus `HH:mm` and optionally seconds. */
+export function localStamp(now: Date, clock: Clock): string {
+  const day = `${now.getFullYear()}-${pad2(now.getMonth() + 1)}-${pad2(now.getDate())}`;
+  if (clock === 'none') {
+    return day;
+  }
+  const hhmm = `${pad2(now.getHours())}:${pad2(now.getMinutes())}`;
+  return clock === 'second'
+    ? `${day} ${hhmm}:${pad2(now.getSeconds())}`
+    : `${day} ${hhmm}`;
+}

package/src/index.js

@@ -0,0 +1,8 @@
+export * from "./cli.js";
+export * from "./dev.js";
+export * from "./draw.js";
+export * from "./input.js";
+export * from "./last-reply.js";
+export * from "./logger.js";
+export * from "./mcp.js";
+export * from "./shutdown.js";

package/src/index.ts

@@ -1,6 +1,8 @@
-export * from './cli.js';
-export * from './dev.js';
-export * from './input.js';
-export * from './last-reply.js';
-export * from './logger.js';
-export * from './shutdown.js';
+export * from './cli.ts';
+export * from './dev.ts';
+export * from './draw.ts';
+export * from './input.ts';
+export * from './last-reply.ts';
+export * from './logger.ts';
+export * from './mcp.ts';
+export * from './shutdown.ts';

package/src/input.js

@@ -0,0 +1,25 @@
+import { readFileSync, statSync } from 'node:fs';
+function readAll(stream) {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        stream.setEncoding('utf8');
+        stream.on('data', (chunk) => {
+            data += chunk;
+        });
+        stream.on('end', () => {
+            resolve(data);
+        });
+        stream.on('error', reject);
+    });
+}
+export function readStdin(stream = process.stdin) {
+    return readAll(stream);
+}
+/** A markdown file's contents, with the CLI's no-such-file error. */
+export function readMarkdownFile(path) {
+    const stats = statSync(path, { throwIfNoEntry: false });
+    if (!stats?.isFile()) {
+        throw new Error(`no such file: ${path}`);
+    }
+    return readFileSync(path, 'utf8');
+}

package/src/last-reply.js

@@ -0,0 +1,75 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+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 undefined;
+    }
+    const blocks = content.filter((b) => typeof b === 'object' &&
+        b !== null &&
+        b.type === 'text');
+    return blocks.length > 0 ? blocks : undefined;
+}
+export function claudeProjectsDir() {
+    const claudeDir = process.env.CLAUDE_DIR ?? join(homedir(), '.claude');
+    return join(claudeDir, 'projects');
+}
+/**
+ * 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) {
+    // 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(claudeProjectsDir(), proj);
+    let file;
+    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;
+    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');
+}