@cjhyy/code-shell-core 0.5.0-rc.0

package/dist/utils/toolDisplay.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared formatting utilities for tool call display.
+ *
+ * Used by both:
+ * - ui/components/ToolCall.tsx (Ink REPL)
+ * - cli/output/renderer.ts (headless text output)
+ */
+/** Maximum preview lines for tool output. */
+export declare const MAX_PREVIEW_LINES = 4;
+export declare const MAX_LINE_WIDTH = 88;
+/** Tool name → display color for the dot indicator. */
+export declare const TOOL_DOT_COLORS: Record<string, string>;
+/**
+ * Format tool arguments into a compact one-line summary.
+ */
+export declare function formatToolArgs(toolName: string, args: Record<string, unknown>): string;
+/** Truncate a string to max length with ellipsis. */
+export declare function truncate(s: string, max: number): string;
+/** Collapse multiline text to a single line. */
+export declare function singleLine(s: string): string;
+/** Format byte count in human-readable form. */
+export declare function formatBytes(n: number): string;
+export interface CompactResult {
+    summary: string;
+    preview: string[];
+    moreLines: number;
+}
+/**
+ * Produce a compact summary of tool output for display.
+ */
+export declare function compactOutput(toolName: string, content: string): CompactResult;

package/dist/utils/toolDisplay.js

@@ -0,0 +1,188 @@
+/**
+ * Shared formatting utilities for tool call display.
+ *
+ * Used by both:
+ * - ui/components/ToolCall.tsx (Ink REPL)
+ * - cli/output/renderer.ts (headless text output)
+ */
+import { sep } from "node:path";
+/** Maximum preview lines for tool output. */
+export const MAX_PREVIEW_LINES = 4;
+export const MAX_LINE_WIDTH = 88;
+/**
+ * Argument keys that carry filesystem paths. Values for these keys are
+ * relativized against process.cwd() before display so users see
+ * "src/ui/App.tsx" instead of "/Users/.../codeshell/src/ui/App.tsx".
+ */
+const PATH_ARG_KEYS = new Set(["file_path", "path", "directory", "cwd"]);
+/**
+ * Strip the cwd prefix from a path string for display. Paths outside
+ * cwd, relative paths, and non-string values are returned unchanged.
+ */
+function relativizePath(value) {
+    if (!value || !value.startsWith("/"))
+        return value;
+    const cwd = process.cwd();
+    const prefix = cwd.endsWith(sep) ? cwd : cwd + sep;
+    if (value === cwd)
+        return ".";
+    if (value.startsWith(prefix))
+        return value.slice(prefix.length);
+    return value;
+}
+/** Tool name → display color for the dot indicator. */
+export const TOOL_DOT_COLORS = {
+    Read: "ansi:blue",
+    Write: "ansi:green",
+    Edit: "ansi:yellow",
+    Bash: "ansi:magenta",
+    Glob: "ansi:blue",
+    Grep: "ansi:blue",
+    Agent: "ansi:cyan",
+    WebSearch: "ansi:blue",
+    WebFetch: "ansi:blue",
+    LSP: "ansi:cyan",
+    TodoWrite: "ansi:cyan",
+};
+/** Mapping of tool names to their most informative argument keys. */
+const TOOL_ARG_KEYS = {
+    Read: ["file_path"],
+    Write: ["file_path"],
+    Edit: ["file_path"],
+    Glob: ["pattern"],
+    Grep: ["pattern", "path"],
+    Bash: ["command"],
+    WebSearch: ["query"],
+    WebFetch: ["url"],
+    Agent: ["description"],
+    TodoWrite: ["todos"],
+    Sleep: ["seconds"],
+    EnterWorktree: ["slug"],
+    SendMessage: ["to"],
+    CronCreate: ["name", "schedule"],
+    LSP: ["action", "file_path"],
+    NotebookEdit: ["action", "file_path"],
+    Config: ["action", "key"],
+};
+/**
+ * Strip a leading `cd <dir> && ` (or `; `) so the visible command is the
+ * thing the user actually cares about. The cwd prefix is mechanical noise
+ * that otherwise eats the entire truncation budget on long absolute paths.
+ */
+function stripCdPrefix(cmd) {
+    // Matches: cd <path> && rest   |   cd "<path with spaces>" && rest   |   cd '...'; rest
+    const m = cmd.match(/^\s*cd\s+(?:"[^"]*"|'[^']*'|\S+)\s*(?:&&|;)\s*(.+)$/s);
+    return m ? m[1].trim() : cmd;
+}
+/**
+ * Format tool arguments into a compact one-line summary.
+ */
+export function formatToolArgs(toolName, args) {
+    const keys = TOOL_ARG_KEYS[toolName] ?? Object.keys(args).slice(0, 2);
+    const parts = [];
+    for (const k of keys) {
+        let v = args[k];
+        if (v !== undefined && !k.startsWith("__")) {
+            let s = String(v);
+            if (toolName === "Bash" && k === "command")
+                s = stripCdPrefix(s);
+            else if (PATH_ARG_KEYS.has(k))
+                s = relativizePath(s);
+            // Bash commands deserve more room than other args — the truncation
+            // budget here used to swallow `git diff …` after a long cd prefix.
+            const max = toolName === "Bash" && k === "command" ? MAX_LINE_WIDTH : 60;
+            parts.push(truncate(s, max));
+        }
+    }
+    // Read often pages large files via offset/limit — show a range suffix so
+    // back-to-back reads of the same file are visually distinguishable.
+    if (toolName === "Read") {
+        const offset = typeof args.offset === "number" ? args.offset : undefined;
+        const limit = typeof args.limit === "number" ? args.limit : undefined;
+        if (offset !== undefined || limit !== undefined) {
+            const start = offset ?? 1;
+            const end = limit !== undefined ? start + limit - 1 : undefined;
+            parts.push(end !== undefined ? `:${start}-${end}` : `:${start}-`);
+        }
+    }
+    return parts.length > 0 ? parts.join(" ") : truncate(JSON.stringify(args), 80);
+}
+/** Truncate a string to max length with ellipsis. */
+export function truncate(s, max) {
+    return s.length > max ? s.slice(0, max - 1) + "…" : s;
+}
+/** Collapse multiline text to a single line. */
+export function singleLine(s) {
+    return s.replace(/\n/g, " ").replace(/\s+/g, " ").trim();
+}
+/** Format byte count in human-readable form. */
+export function formatBytes(n) {
+    if (n >= 1024 * 1024)
+        return (n / (1024 * 1024)).toFixed(1) + "MB";
+    if (n >= 1024)
+        return (n / 1024).toFixed(1) + "KB";
+    return n + "B";
+}
+/**
+ * Produce a compact summary of tool output for display.
+ */
+export function compactOutput(toolName, content) {
+    const lines = content.split("\n");
+    const totalLines = lines.length;
+    switch (toolName) {
+        case "Read":
+            return {
+                summary: `${totalLines} lines, ${formatBytes(content.length)}`,
+                preview: [],
+                moreLines: 0,
+            };
+        case "Bash": {
+            if (totalLines <= MAX_PREVIEW_LINES) {
+                return {
+                    summary: "",
+                    preview: lines.map((l) => truncate(l, MAX_LINE_WIDTH)),
+                    moreLines: 0,
+                };
+            }
+            return {
+                summary: `${totalLines} lines output`,
+                preview: lines.slice(0, MAX_PREVIEW_LINES).map((l) => truncate(l, MAX_LINE_WIDTH)),
+                moreLines: totalLines - MAX_PREVIEW_LINES,
+            };
+        }
+        case "Glob": {
+            const fileCount = lines.filter((l) => l.trim()).length;
+            return {
+                summary: `${fileCount} files found`,
+                preview: lines.slice(0, 5).map((l) => truncate(l, MAX_LINE_WIDTH)),
+                moreLines: Math.max(0, fileCount - 5),
+            };
+        }
+        case "Grep": {
+            const matchCount = lines.filter((l) => l.trim()).length;
+            return {
+                summary: `${matchCount} matches`,
+                preview: lines.slice(0, MAX_PREVIEW_LINES).map((l) => truncate(l, MAX_LINE_WIDTH)),
+                moreLines: Math.max(0, matchCount - MAX_PREVIEW_LINES),
+            };
+        }
+        case "Write":
+            return { summary: singleLine(content).slice(0, 60), preview: [], moreLines: 0 };
+        case "Edit":
+            return { summary: singleLine(content).slice(0, 70), preview: [], moreLines: 0 };
+        case "Agent":
+            return { summary: truncate(singleLine(content), 80), preview: [], moreLines: 0 };
+        case "TodoWrite":
+            return { summary: singleLine(content), preview: [], moreLines: 0 };
+        default: {
+            if (totalLines <= 1) {
+                return { summary: truncate(content, 80), preview: [], moreLines: 0 };
+            }
+            return {
+                summary: `${totalLines} lines`,
+                preview: lines.slice(0, MAX_PREVIEW_LINES).map((l) => truncate(l, MAX_LINE_WIDTH)),
+                moreLines: Math.max(0, totalLines - MAX_PREVIEW_LINES),
+            };
+        }
+    }
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@cjhyy/code-shell-core",
+  "version": "0.5.0-rc.0",
+  "description": "Core engine for code-shell — agent orchestration, tool execution, hooks, protocol. UI-agnostic.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./bin/agent-server-stdio": "./dist/cli/agent-server-stdio.js"
+  },
+  "sideEffects": [
+    "./dist/data/*.json",
+    "./dist/prompt/sections/*.md"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && mkdir -p dist/prompt/sections dist/data && cp src/prompt/sections/*.md dist/prompt/sections/ && cp src/data/*.json dist/data/",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "glob": "^11.0.0",
+    "gpt-tokenizer": "^3.4.0",
+    "nanoid": "^5.1.2",
+    "openai": "^4.82.0",
+    "proper-lockfile": "^4.1.2",
+    "semver": "^7.7.4",
+    "strip-ansi": "^7.2.0",
+    "yaml": "^2.7.0",
+    "zod": "^3.24.2"
+  },
+  "engines": {
+    "node": ">=20.10"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cjhyy/codeshell.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/cjhyy/codeshell/tree/main/packages/core#readme",
+  "bugs": {
+    "url": "https://github.com/cjhyy/codeshell/issues"
+  },
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "agent",
+    "orchestration",
+    "agent-framework",
+    "claude-code",
+    "claude",
+    "openai",
+    "anthropic",
+    "mcp",
+    "llm",
+    "tool-use",
+    "function-calling",
+    "headless"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}