openshain 0.1.1 → 0.3.1

package/dist/bin.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { anthropicProvider, openaiCompatibleProvider } from "@openshain/agent";
+import { isOpenshainError } from "@openshain/core";
+import { standardTools } from "@openshain/tools";
+import { init } from "./commands/init.js";
+import { mcp } from "./commands/mcp.js";
+import { toolsList } from "./commands/tools.js";
+import { workList, workShow } from "./commands/work.js";
+import { plain } from "./format.js";
+import { errorLabel } from "./labels.js";
+import { startTui } from "./tui/index.js";
+import { findWorkspace } from "./workspace.js";
+const USAGE = `使い方:
+  openshain                      端末で対話を始める
+  openshain init                 openshain.yaml のひな型を書く
+  openshain tools list           使える Tool の一覧
+  openshain work list            Work の一覧
+  openshain work show <id>       Work の詳細
+  openshain mcp                  MCP Server を stdio で起動する
+
+  --workspace <dir>              起点のディレクトリ。省略時はカレントディレクトリ
+                                 init はそこに書き、他のコマンドはそこから上に openshain.yaml を探す`;
+/** The providers this CLI knows, by the ids used in openshain.yaml. */
+const providers = {
+    models: {
+        anthropic: (model) => anthropicProvider(model),
+        "openai-compatible": (model) => openaiCompatibleProvider(model),
+    },
+    tools: { standard: () => standardTools() },
+};
+async function main(argv) {
+    const write = (line) => console.log(plain(line));
+    let values;
+    let positionals;
+    try {
+        ({ values, positionals } = parseArgs({
+            args: argv,
+            options: { workspace: { type: "string" }, help: { type: "boolean", short: "h" } },
+            allowPositionals: true,
+        }));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        const option = /'(-[^']*)'/.exec(message)?.[1];
+        const unknown = err.code === "ERR_PARSE_ARGS_UNKNOWN_OPTION" && option;
+        write(unknown ? `不明なオプション ${option}` : `引数を解釈できません。${message}`);
+        write(USAGE);
+        return 2;
+    }
+    const [command, ...rest] = positionals;
+    if (!command && !values.help && process.stdin.isTTY === true && process.stdout.isTTY === true) {
+        const workspaceRoot = await findWorkspace(values.workspace ?? process.cwd());
+        return startTui({ workspaceRoot, providers });
+    }
+    if (values.help || !command) {
+        write(USAGE);
+        return values.help ? 0 : 2;
+    }
+    switch (command) {
+        case "init":
+            await init({ workspaceRoot: values.workspace ?? process.cwd(), write });
+            return 0;
+        case "mcp": {
+            const workspaceRoot = await findWorkspace(values.workspace ?? process.cwd());
+            await mcp({ workspaceRoot, providers });
+            return 0;
+        }
+        case "tools": {
+            if (rest[0] !== "list") {
+                write(USAGE);
+                return 2;
+            }
+            const workspaceRoot = await findWorkspace(values.workspace ?? process.cwd());
+            await toolsList({ workspaceRoot, providers, write });
+            return 0;
+        }
+        case "work": {
+            const sub = rest[0];
+            const id = rest[1] ?? "";
+            if (!(sub === "list" || (sub === "show" && id))) {
+                write(USAGE);
+                return 2;
+            }
+            const workspaceRoot = await findWorkspace(values.workspace ?? process.cwd());
+            if (sub === "list") {
+                await workList({ workspaceRoot, write });
+                return 0;
+            }
+            await workShow({ workspaceRoot, id, write });
+            return 0;
+        }
+        default:
+            write(`不明なコマンド ${command}`);
+            write(USAGE);
+            return 2;
+    }
+}
+main(process.argv.slice(2)).then((code) => process.exit(code), (err) => {
+    if (isOpenshainError(err)) {
+        const heading = errorLabel(err.code);
+        console.error(plain(`エラー(${err.code}) ${heading ? `${heading}。` : ""}${err.message}`));
+    }
+    else {
+        console.error(err);
+    }
+    process.exit(1);
+});

package/dist/commands/init.d.ts

@@ -0,0 +1,21 @@
+import { type Language } from "@openshain/core";
+/** The company's language for the template: from the OS locale, Japanese unless the locale says otherwise. */
+export declare function detectLanguage(env: Record<string, string | undefined>): Language;
+export declare const configTemplate: (language: Language) => string;
+export declare const CONFIG_TEMPLATE: string;
+/** Registers the runtime as a project MCP server for Claude Code. `openshain` must be on PATH. */
+export declare const MCP_TEMPLATE: string;
+/** What an outside agent reads before working in the folder. Codex reads AGENTS.md; Claude Code reads it through CLAUDE.md. */
+export declare const AGENTS_TEMPLATE = "# \u3053\u306E\u4F1A\u793E\u30D5\u30A9\u30EB\u30C0\u3067\u50CD\u304F\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u3078\n\n\u3053\u306E\u30D5\u30A9\u30EB\u30C0\u306F openshain \u306E Company Workspace \u3067\u3059\u3002\u3053\u306E\u6307\u793A\u306F\u3001Claude Code \u3084 Codex \u306E\u3088\u3046\u306A\u5916\u90E8\u306E\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u304C MCP \u7D4C\u7531\u3067\u3053\u306E\u30D5\u30A9\u30EB\u30C0\u3092\u6271\u3046\u3068\u304D\u306E\u3082\u306E\u3067\u3059\u3002openshain \u306E\u5BFE\u8A71\u578B CLI \u3082\u540C\u3058\u624B\u9806\u3067 Runtime \u3092\u4F7F\u3044\u307E\u3059\u3002\n\n\u4F1A\u793E\u306E\u30D5\u30A1\u30A4\u30EB\u306E\u8AAD\u307F\u66F8\u304D\u3068\u96C6\u8A08\u306F openshain \u306E MCP tool \u3067\u884C\u3044\u307E\u3059\u3002Claude Code \u3084 Codex \u81EA\u8EAB\u306E Read\u3001Write\u3001Bash \u306F\u4F1A\u793E\u306E\u30D5\u30A1\u30A4\u30EB\u306B\u306F\u4F7F\u3044\u307E\u305B\u3093\u3002Runtime \u3092\u901A\u3089\u306A\u304B\u3063\u305F\u64CD\u4F5C\u306F\u8A18\u9332\u306B\u6B8B\u3089\u306A\u3044\u305F\u3081\u3067\u3059\u3002\n\n- \u4F9D\u983C\u3092\u53D7\u3051\u305F\u3089\u3001\u307E\u305A `work_create` \u306B\u4F9D\u983C\u306E\u6587\u3092\u305D\u306E\u307E\u307E\u6E21\u3057\u3066 Work \u3092\u4F5C\u308B\n- \u30D5\u30A1\u30A4\u30EB\u306F `fs_list`\u3001`fs_search`\u3001`fs_read`\u3001`csv_read`\u3001`markdown_read` \u3067\u898B\u308B\u3002\u5408\u8A08\u3084\u4EF6\u6570\u306F `csv_aggregate` \u306B\u4EFB\u305B\u3001\u81EA\u5206\u3067\u5408\u8A08\u3057\u306A\u3044\n- \u66F8\u304F\u3068\u304D\u306F `fs_write` \u304B `csv_write`\n- \u7D42\u308F\u3063\u305F\u3089 `work_complete` \u306B\u3001\u4F55\u3092\u3057\u305F\u304B\u3068\u3001\u66F8\u3044\u305F\u30D5\u30A1\u30A4\u30EB\u3092\u6E21\u3059\u3002\u7D9A\u3051\u3089\u308C\u306A\u3044\u3068\u304D\u306F `work_fail`\n- `openshain.yaml` \u3068 `work/` \u306F Runtime \u306E\u3082\u306E\u3002\u5909\u66F4\u3057\u306A\u3044\n";
+export declare const CLAUDE_TEMPLATE = "@AGENTS.md\n";
+export interface InitOptions {
+    workspaceRoot: string;
+    write: (line: string) => void;
+}
+/**
+ * Writes the starter files of a company workspace: openshain.yaml, .mcp.json, AGENTS.md and
+ * CLAUDE.md. A workspace that already has openshain.yaml is left alone with an error. An existing
+ * .mcp.json keeps its servers and gains the openshain entry when it lacks one; any other file that
+ * already exists is kept as it is.
+ */
+export declare function init({ workspaceRoot, write }: InitOptions): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,128 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { CONFIG_FILE_NAME, OpenshainError } from "@openshain/core";
+/** The company's language for the template: from the OS locale, Japanese unless the locale says otherwise. */
+export function detectLanguage(env) {
+    const raw = env.LC_ALL || env.LC_MESSAGES || env.LANG || "";
+    const code = raw.toLowerCase().split(/[_.@-]/)[0] ?? "";
+    if (code === "ja" || code === "" || code === "c" || code === "posix")
+        return "ja";
+    return "en";
+}
+export const configTemplate = (language) => `version: 1
+company:
+  name: サンプル株式会社   # 会社名。model に伝わる
+  language: ${language}             # ja | en。社員エージェントの名前の言語。init が OS の locale から埋める
+principal:
+  id: alice                # 依頼する人の id。小文字の英数字、_ と -
+  name: Alice
+profession:
+  id: generic
+  # model への指示。100,000 文字まで
+  instructions: |
+    あなたはこの会社の事務担当です。依頼された作業を、workspace 内のファイルだけを使って進めてください。
+model:
+  provider: anthropic      # anthropic | openai-compatible
+  model: claude-opus-5
+  api_key_env: ANTHROPIC_API_KEY   # API キーを入れておく環境変数の名前。サーバーを替えるなら変数名も見直す
+  # base_url: http://localhost:11434/v1   # openai-compatible のとき
+  # options: { effort: high }             # provider にそのまま渡す
+tools:
+  - provider: standard
+    # allow: [fs_list, fs_search, fs_read, csv_read, csv_aggregate, markdown_read, fs_write, csv_write]   # 省略時は全部
+  # - module: ./tools/my-tool.ts   # ToolProvider を default export するモジュール
+limits:
+  max_model_calls: 30      # 超えると Work は失敗(上限到達)で止まる
+  max_tool_calls: 100
+  max_output_tokens: 16000 # model の 1 回の出力の上限
+# debug:
+#   persist_raw: true      # provider の生の応答を記録に残す
+`;
+export const CONFIG_TEMPLATE = configTemplate("ja");
+/** Registers the runtime as a project MCP server for Claude Code. `openshain` must be on PATH. */
+export const MCP_TEMPLATE = `${JSON.stringify({ mcpServers: { openshain: { command: "openshain", args: ["mcp"] } } }, null, 2)}\n`;
+/** What an outside agent reads before working in the folder. Codex reads AGENTS.md; Claude Code reads it through CLAUDE.md. */
+export const AGENTS_TEMPLATE = `# この会社フォルダで働くエージェントへ
+
+このフォルダは openshain の Company Workspace です。この指示は、Claude Code や Codex のような外部のエージェントが MCP 経由でこのフォルダを扱うときのものです。openshain の対話型 CLI も同じ手順で Runtime を使います。
+
+会社のファイルの読み書きと集計は openshain の MCP tool で行います。Claude Code や Codex 自身の Read、Write、Bash は会社のファイルには使いません。Runtime を通らなかった操作は記録に残らないためです。
+
+- 依頼を受けたら、まず \`work_create\` に依頼の文をそのまま渡して Work を作る
+- ファイルは \`fs_list\`、\`fs_search\`、\`fs_read\`、\`csv_read\`、\`markdown_read\` で見る。合計や件数は \`csv_aggregate\` に任せ、自分で合計しない
+- 書くときは \`fs_write\` か \`csv_write\`
+- 終わったら \`work_complete\` に、何をしたかと、書いたファイルを渡す。続けられないときは \`work_fail\`
+- \`openshain.yaml\` と \`work/\` は Runtime のもの。変更しない
+`;
+export const CLAUDE_TEMPLATE = "@AGENTS.md\n";
+/**
+ * Writes the starter files of a company workspace: openshain.yaml, .mcp.json, AGENTS.md and
+ * CLAUDE.md. A workspace that already has openshain.yaml is left alone with an error. An existing
+ * .mcp.json keeps its servers and gains the openshain entry when it lacks one; any other file that
+ * already exists is kept as it is.
+ */
+export async function init({ workspaceRoot, write }) {
+    const configPath = join(workspaceRoot, CONFIG_FILE_NAME);
+    try {
+        await writeFile(configPath, configTemplate(detectLanguage(process.env)), { flag: "wx" });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "EEXIST") {
+            throw new OpenshainError("config", `${configPath} はすでにあります。上書きはしません。`);
+        }
+        if (code === "ENOENT") {
+            throw new OpenshainError("config", `${workspaceRoot} がありません。先にディレクトリを作ってください。`);
+        }
+        throw err;
+    }
+    write(`${configPath} を作りました。`);
+    for (const [name, content] of [
+        [".mcp.json", MCP_TEMPLATE],
+        ["AGENTS.md", AGENTS_TEMPLATE],
+        ["CLAUDE.md", CLAUDE_TEMPLATE],
+    ]) {
+        const path = join(workspaceRoot, name);
+        try {
+            await writeFile(path, content, { flag: "wx" });
+            write(`${path} を作りました。`);
+        }
+        catch (err) {
+            if (err.code !== "EEXIST")
+                throw err;
+            if (name === ".mcp.json")
+                write(await addToMcpConfig(path));
+            else
+                write(`${path} はすでにあるので変更しません。`);
+        }
+    }
+    write("company と principal を自分の会社に合わせ、api_key_env に書いた環境変数を設定してから openshain を実行してください。");
+}
+/**
+ * Adds the openshain server to a .mcp.json that is already there, keeping every other server.
+ * A file that cannot be read as JSON is left as it is, and the line says so.
+ */
+async function addToMcpConfig(path) {
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path, "utf8"));
+    }
+    catch {
+        return `${path} はすでにあり、JSON として読めないので変更しません。openshain を手動で登録してください。`;
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        return `${path} はすでにあり、形が違うので変更しません。openshain を手動で登録してください。`;
+    }
+    const config = parsed;
+    const servers = config.mcpServers && typeof config.mcpServers === "object" && !Array.isArray(config.mcpServers)
+        ? config.mcpServers
+        : {};
+    if (Object.hasOwn(servers, "openshain"))
+        return `${path} には openshain がすでにあるので変更しません。`;
+    const next = {
+        ...config,
+        mcpServers: { ...servers, openshain: { command: "openshain", args: ["mcp"] } },
+    };
+    await writeFile(path, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+    return `${path} に openshain を追加しました。他の項目はそのままです。`;
+}

package/dist/commands/mcp.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeProviders } from "@openshain/core";
+export interface McpOptions {
+    workspaceRoot: string;
+    providers: RuntimeProviders;
+}
+/**
+ * Serves the workspace over MCP on stdin and stdout until the client hangs up. Nothing else may
+ * be written to stdout while it runs; the protocol owns it.
+ */
+export declare function mcp({ workspaceRoot, providers }: McpOptions): Promise<void>;

package/dist/commands/mcp.js

@@ -0,0 +1,17 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createMcpServer } from "@openshain/mcp";
+/**
+ * Serves the workspace over MCP on stdin and stdout until the client hangs up. Nothing else may
+ * be written to stdout while it runs; the protocol owns it.
+ */
+export async function mcp({ workspaceRoot, providers }) {
+    const server = await createMcpServer({ workspaceRoot, tools: providers.tools });
+    const transport = new StdioServerTransport();
+    await new Promise((resolve) => {
+        server.onclose = () => resolve();
+        server.connect(transport).catch((err) => {
+            console.error(err instanceof Error ? err.message : String(err));
+            resolve();
+        });
+    });
+}

package/dist/commands/tools.d.ts

@@ -0,0 +1,8 @@
+import { type RuntimeProviders } from "@openshain/core";
+export interface ToolsListOptions {
+    workspaceRoot: string;
+    providers: RuntimeProviders;
+    write: (line: string) => void;
+}
+/** Every tool the model can call in this workspace, and the ones the allow lists hide. Needs no model provider. */
+export declare function toolsList({ workspaceRoot, providers, write, }: ToolsListOptions): Promise<void>;

package/dist/commands/tools.js

@@ -0,0 +1,18 @@
+import { ASK_USER, createToolRegistry, loadConfig, RUNTIME_PROVIDER_ID, } from "@openshain/core";
+/** Every tool the model can call in this workspace, and the ones the allow lists hide. Needs no model provider. */
+export async function toolsList({ workspaceRoot, providers, write, }) {
+    const config = await loadConfig(workspaceRoot);
+    const registry = await createToolRegistry(workspaceRoot, config, providers.tools);
+    const rows = registry
+        .list()
+        .map((t) => [t.definition.name, t.providerId, t.definition.effect, "許可"]);
+    rows.push([ASK_USER.name, RUNTIME_PROVIDER_ID, ASK_USER.effect, "許可"]);
+    for (const hidden of registry.hiddenTools()) {
+        rows.push([hidden.name, hidden.providerId, hidden.effect, "不許可"]);
+    }
+    const width = Math.max(...rows.map(([name]) => name.length));
+    const providerWidth = Math.max(...rows.map(([, provider]) => provider.length));
+    for (const [name, provider, effect, allowed] of rows) {
+        write(`${name.padEnd(width)}  ${provider.padEnd(providerWidth)}  ${effect.padEnd(7)}  ${allowed}`);
+    }
+}

package/dist/commands/work.d.ts

@@ -0,0 +1,15 @@
+import { type AnyEvent, type Work } from "@openshain/core";
+export interface WorkListOptions {
+    workspaceRoot: string;
+    write: (line: string) => void;
+}
+/** One line per work, oldest first. Works that cannot be read are reported, not hidden. */
+export declare function workList({ workspaceRoot, write }: WorkListOptions): Promise<void>;
+export interface WorkShowOptions {
+    workspaceRoot: string;
+    id: string;
+    write: (line: string) => void;
+}
+/** Everything about one work: state, outcome, what the tools did, the usage, and who acts next. */
+export declare function workShow({ workspaceRoot, id, write }: WorkShowOptions): Promise<void>;
+export declare function describeWork(work: Work, events: AnyEvent[]): string[];

package/dist/commands/work.js

@@ -0,0 +1,87 @@
+import { parseWorkId, pendingQuestions, WorkStore, } from "@openshain/core";
+import { describeInput, padDisplay } from "../format.js";
+import { errorLabel, failureLabel, rejectionLabel, statusLabel } from "../labels.js";
+import { nextActor } from "../report.js";
+import { formatUsage, summarizeUsage } from "../usage.js";
+/** One line per work, oldest first. Works that cannot be read are reported, not hidden. */
+export async function workList({ workspaceRoot, write }) {
+    const { works, problems } = await new WorkStore(workspaceRoot).list();
+    if (works.length === 0 && problems.length === 0) {
+        write("Work はまだありません。openshain で社員エージェントに依頼すると始まります。");
+        return;
+    }
+    for (const work of works) {
+        write(`${work.id}  ${padDisplay(statusLabel(work.status), 16)}  ${work.createdAt.slice(0, 16)}  ${shorten(work.objective)}`);
+    }
+    for (const { id, error } of problems) {
+        write(`${id}  読めない(${errorLabel(error.code) ?? error.code})  ${error.message}`);
+    }
+}
+/** Everything about one work: state, outcome, what the tools did, the usage, and who acts next. */
+export async function workShow({ workspaceRoot, id, write }) {
+    const store = new WorkStore(workspaceRoot);
+    const workId = parseWorkId(id);
+    const work = await store.get(workId);
+    const events = await store.events(workId);
+    for (const line of describeWork(work, events))
+        write(line);
+}
+export function describeWork(work, events) {
+    const lines = [
+        `${work.id}`,
+        `状態      ${statusLabel(work.status)}(${work.status})`,
+        `依頼      ${work.objective}`,
+        `作成      ${work.createdAt}`,
+    ];
+    if (work.agentName)
+        lines.push(`名前      ${work.agentName}(社員エージェント)`);
+    if (work.startedAt)
+        lines.push(`開始      ${work.startedAt}`);
+    if (work.completedAt)
+        lines.push(`終了      ${work.completedAt}`);
+    if (work.outcome) {
+        lines.push(`結果      ${work.outcome.summary}`);
+        for (const artifact of work.outcome.artifacts)
+            lines.push(`  書き込み ${artifact.path}  ${artifact.sha256.slice(0, 12)}${artifact.missing ? "  完了時には読めなかった" : ""}${artifact.claimed ? "  エージェントの申告(この Work の Tool は書いていない)" : ""}`);
+    }
+    if (work.failure) {
+        lines.push(`失敗      ${failureLabel(work.failure.reason)}。${work.failure.detail}`);
+    }
+    if (work.status === "waiting_input") {
+        for (const { question } of pendingQuestions(events))
+            lines.push(`質問      ${question}`);
+    }
+    const calls = toolLines(events);
+    if (calls.length > 0) {
+        lines.push("Tool");
+        for (const line of calls)
+            lines.push(line);
+    }
+    lines.push(formatUsage(summarizeUsage(events)));
+    lines.push(nextActor(work));
+    return lines;
+}
+/** One line per tool call, in log order, with its outcome when it was rejected or failed. */
+function toolLines(events) {
+    const lines = new Map();
+    for (const event of events) {
+        if (event.type === "tool.called") {
+            const { callId, name, input } = event.payload;
+            lines.set(callId, `  ${name} ${describeInput(input)}`.trimEnd());
+        }
+        else if (event.type === "tool.rejected") {
+            const { callId, name, code } = event.payload;
+            lines.set(callId, `${lines.get(callId) ?? `  ${name}`}  拒否(${rejectionLabel(code)})`);
+        }
+        else if (event.type === "tool.completed") {
+            const { callId, isError } = event.payload;
+            if (isError)
+                lines.set(callId, `${lines.get(callId) ?? `  ${callId}`}  失敗`);
+        }
+    }
+    return [...lines.values()];
+}
+function shorten(text) {
+    const oneLine = text.replace(/\s+/g, " ").trim();
+    return oneLine.length > 40 ? `${oneLine.slice(0, 39)}…` : oneLine;
+}

package/dist/format.d.ts

@@ -0,0 +1,15 @@
+/** Display width in a terminal: East Asian wide and full-width characters take two columns. */
+export declare function displayWidth(text: string): number;
+/** Pads with spaces to a display width, so columns line up with Japanese text in them. */
+export declare function padDisplay(text: string, width: number): string;
+/** A tool input on one line: the path when there is one, nothing for a question, otherwise the JSON, shortened. */
+export declare function describeInput(input: unknown): string;
+export declare function truncate(text: string, max?: number): string;
+/**
+ * Text as it may reach a terminal: escape sequences and other control characters are dropped,
+ * newline and tab stay. Nothing a model says or a file contains can then move the cursor,
+ * retitle the window or write the clipboard. Invisible formatting characters (zero-width and
+ * bidirectional controls) go too, so a line cannot be made to read differently from what it is.
+ * A scan over the characters, not a regular expression, so the time is linear in the text.
+ */
+export declare function plain(text: string): string;

package/dist/format.js

@@ -0,0 +1,103 @@
+/** Display width in a terminal: East Asian wide and full-width characters take two columns. */
+export function displayWidth(text) {
+    let width = 0;
+    for (const ch of text)
+        width += isWide(ch.codePointAt(0) ?? 0) ? 2 : 1;
+    return width;
+}
+function isWide(code) {
+    return ((code >= 0x1100 && code <= 0x115f) ||
+        (code >= 0x2e80 && code <= 0xa4cf) ||
+        (code >= 0xac00 && code <= 0xd7a3) ||
+        (code >= 0xf900 && code <= 0xfaff) ||
+        (code >= 0xfe30 && code <= 0xfe4f) ||
+        (code >= 0xff00 && code <= 0xff60) ||
+        (code >= 0xffe0 && code <= 0xffe6) ||
+        (code >= 0x20000 && code <= 0x3fffd));
+}
+/** Pads with spaces to a display width, so columns line up with Japanese text in them. */
+export function padDisplay(text, width) {
+    const missing = width - displayWidth(text);
+    return missing > 0 ? text + " ".repeat(missing) : text;
+}
+/** A tool input on one line: the path when there is one, nothing for a question, otherwise the JSON, shortened. */
+export function describeInput(input) {
+    if (input && typeof input === "object") {
+        if ("path" in input)
+            return String(input.path);
+        if ("question" in input)
+            return "";
+    }
+    return truncate(JSON.stringify(input) ?? "");
+}
+export function truncate(text, max = 80) {
+    return text.length > max ? `${text.slice(0, max - 3)}...` : text;
+}
+/**
+ * Text as it may reach a terminal: escape sequences and other control characters are dropped,
+ * newline and tab stay. Nothing a model says or a file contains can then move the cursor,
+ * retitle the window or write the clipboard. Invisible formatting characters (zero-width and
+ * bidirectional controls) go too, so a line cannot be made to read differently from what it is.
+ * A scan over the characters, not a regular expression, so the time is linear in the text.
+ */
+export function plain(text) {
+    const chars = [...text];
+    let out = "";
+    let i = 0;
+    while (i < chars.length) {
+        const ch = chars[i];
+        const code = ch.codePointAt(0) ?? 0;
+        if (code === ESC || code === CSI)
+            i = afterSequence(chars, i);
+        else {
+            if (!isControl(code))
+                out += ch;
+            i += 1;
+        }
+    }
+    return out;
+}
+const ESC = 0x1b;
+const CSI = 0x9b;
+const BEL = 0x07;
+const ST = 0x9c;
+function isControl(code) {
+    return ((code < 0x20 && code !== 0x0a && code !== 0x09) ||
+        (code >= 0x7f && code <= 0x9f) ||
+        (code >= 0x200b && code <= 0x200f) ||
+        (code >= 0x202a && code <= 0x202e) ||
+        (code >= 0x2066 && code <= 0x2069) ||
+        code === 0xfeff);
+}
+/** The index after the escape sequence that starts at `start`. An unfinished one runs to the end. */
+function afterSequence(chars, start) {
+    const at = (i) => chars[i]?.codePointAt(0) ?? -1;
+    const end = chars.length;
+    const opener = at(start) === CSI ? "[" : chars[start + 1];
+    let i = at(start) === CSI ? start + 1 : start + 2;
+    if (opener === "[") {
+        // CSI: parameter and intermediate bytes, then one final byte.
+        while (i < end && at(i) >= 0x20 && at(i) <= 0x3f)
+            i += 1;
+        return Math.min(i + 1, end);
+    }
+    if (opener === "]" || opener === "P" || opener === "X" || opener === "^" || opener === "_") {
+        // OSC, DCS, SOS, PM, APC: a string that ends with BEL or ST.
+        while (i < end) {
+            if (at(i) === BEL || at(i) === ST)
+                return i + 1;
+            if (at(i) === ESC && chars[i + 1] === "\\")
+                return i + 2;
+            i += 1;
+        }
+        return end;
+    }
+    if (at(start + 1) >= 0x20 && at(start + 1) <= 0x2f) {
+        // Intermediate bytes, then one final byte.
+        while (i < end && at(i) >= 0x20 && at(i) <= 0x2f)
+            i += 1;
+        return Math.min(i + 1, end);
+    }
+    // ESC and one final character.
+    return Math.min(i, end);
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { AGENTS_TEMPLATE, CLAUDE_TEMPLATE, CONFIG_TEMPLATE, type InitOptions, init, MCP_TEMPLATE, } from "./commands/init.ts";
+export { type McpOptions, mcp } from "./commands/mcp.ts";
+export { type ToolsListOptions, toolsList } from "./commands/tools.ts";
+export { describeWork, type WorkListOptions, type WorkShowOptions, workList, workShow, } from "./commands/work.ts";
+export { ERROR_LABELS, errorLabel, FAILURE_LABELS, failureLabel, REJECTION_LABELS, rejectionLabel, STATUS_LABELS, statusLabel, } from "./labels.ts";
+export { nextActor, progressLine, report } from "./report.ts";
+export { formatUsage, summarizeUsage, type UsageSummary } from "./usage.ts";
+export { findWorkspace } from "./workspace.ts";

package/dist/index.js

@@ -0,0 +1,9 @@
+// openshain: Reference CLI agent for the openshain runtime
+export { AGENTS_TEMPLATE, CLAUDE_TEMPLATE, CONFIG_TEMPLATE, init, MCP_TEMPLATE, } from "./commands/init.js";
+export { mcp } from "./commands/mcp.js";
+export { toolsList } from "./commands/tools.js";
+export { describeWork, workList, workShow, } from "./commands/work.js";
+export { ERROR_LABELS, errorLabel, FAILURE_LABELS, failureLabel, REJECTION_LABELS, rejectionLabel, STATUS_LABELS, statusLabel, } from "./labels.js";
+export { nextActor, progressLine, report } from "./report.js";
+export { formatUsage, summarizeUsage } from "./usage.js";
+export { findWorkspace } from "./workspace.js";

package/dist/labels.d.ts

@@ -0,0 +1,13 @@
+import type { ErrorCode, FailureReason, ToolRejectionCode, WorkStatus } from "@openshain/core";
+/** The words shown for a work's status. The log keeps the original value. */
+export declare const STATUS_LABELS: Record<WorkStatus, string>;
+/** Why a work failed, as a heading before the original detail. */
+export declare const FAILURE_LABELS: Record<FailureReason, string>;
+/** Why a tool call was rejected, as a heading before the original reason. */
+export declare const REJECTION_LABELS: Record<ToolRejectionCode, string>;
+/** A heading for a runtime error, before the original message. */
+export declare const ERROR_LABELS: Record<ErrorCode, string>;
+export declare function statusLabel(status: string): string;
+export declare function failureLabel(reason: string | undefined): string;
+export declare function rejectionLabel(code: string): string;
+export declare function errorLabel(code: string): string | undefined;

package/dist/labels.js

@@ -0,0 +1,59 @@
+/** The words shown for a work's status. The log keeps the original value. */
+export const STATUS_LABELS = {
+    queued: "未着手",
+    in_progress: "進行中",
+    waiting_input: "利用者の入力待ち",
+    waiting_approval: "承認待ち",
+    waiting_external: "外部の応答待ち",
+    completed: "完了",
+    failed: "失敗",
+    cancelled: "取り消し",
+};
+/** Why a work failed, as a heading before the original detail. */
+export const FAILURE_LABELS = {
+    limit_reached: "上限到達",
+    model_refusal: "model の拒否",
+    model_error: "model のエラー",
+};
+/** Why a tool call was rejected, as a heading before the original reason. */
+export const REJECTION_LABELS = {
+    schema_mismatch: "schema に合わない入力",
+    unknown_tool: "知らない Tool",
+    not_allowed: "この workspace では不許可",
+    reserved_path: "予約されたパス",
+    outside_workspace: "workspace の外",
+    invalid_path: "不正なパス",
+    limit_reached: "Tool 呼び出しの上限",
+};
+/** A heading for a runtime error, before the original message. */
+export const ERROR_LABELS = {
+    auth: "認証の失敗",
+    network: "接続の失敗",
+    rate_limit: "呼び出し上限",
+    invalid_response: "解釈できない model の応答",
+    config: "設定の問題",
+    corrupt_log: "壊れた Work の記録",
+    invalid_transition: "進められない状態",
+    duplicate_tool: "同じ名前の Tool の重複",
+    invalid_id: "不正な id",
+    invalid_tool: "不正な Tool の定義",
+    invalid_path: "不正なパス",
+    lock_held: "別のプロセスが使用中",
+    not_found: "対象なし",
+    reserved_path: "予約されたパス",
+    outside_workspace: "workspace の外",
+    concurrent_write: "同時書き込み",
+    invalid_event: "記録できないイベント",
+};
+export function statusLabel(status) {
+    return STATUS_LABELS[status] ?? status;
+}
+export function failureLabel(reason) {
+    return reason ? (FAILURE_LABELS[reason] ?? reason) : "理由は不明";
+}
+export function rejectionLabel(code) {
+    return REJECTION_LABELS[code] ?? code;
+}
+export function errorLabel(code) {
+    return ERROR_LABELS[code];
+}

package/dist/report.d.ts

@@ -0,0 +1,6 @@
+import { type AnyEvent, type Work } from "@openshain/core";
+/** One line for a tool call, a rejection or a failure; nothing for the other events. `names` maps call ids to tool names. */
+export declare function progressLine(event: AnyEvent, names: Map<string, string>): string | undefined;
+/** The closing lines: what happened, what it cost, and who acts next. */
+export declare function report(work: Work, events: AnyEvent[]): string[];
+export declare function nextActor(work: Work): string;