@dorokuma/herdsman 0.6.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Ryo Nakae
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Copyright (c) 2026 dorokuma (herdsman)

package/README.ja.md

@@ -0,0 +1,143 @@
+![Herdsman cover](./assets/herdsman-cover.png)
+
+# Herdsman
+
+<!-- README-I18N:START -->
+[English](./README.md) | **日本語**
+<!-- README-I18N:END -->
+
+Herdsman は、Herdr で動く coding agent の状態を記録する daemon ベースの観測ツールです。CLI から構造化された履歴を取得でき、Pi では owner だけに cached context と通知を送り、必要なときに自動で wake します。
+
+Herdr の `herdr agent read` は terminal stream や scrollback を読みます。Herdsman は agent の session data から作業状況、message の抜粋、compact tool result、未読の outcome を取得します。Herdsman は agent を操作しません。agent の start、prompt、wait、pane 操作、terminal control には公式 Herdr CLI または skill を使います。
+
+現在は Claude Code、Codex、Gemini CLI、OpenCode、Pi のセッション履歴の取得に対応しています。
+
+## 要件
+
+- Node.js >= 24.18.0
+- Herdr >= 0.7.0
+- `herdsman-pi` を使う場合は Pi >= 0.80.6
+
+## インストール
+
+```bash
+npm install --global @dorokuma/herdsman
+herdsman help
+```
+
+### ソースからインストールする
+
+ソースからbuildする場合はpnpm >= 11.9.0も必要です。
+
+```bash
+git clone https://github.com/ryonakae/herdsman.git
+cd herdsman
+pnpm install
+pnpm build
+npm install --global . --ignore-scripts
+herdsman help
+```
+
+## daemon を起動する
+
+Herdsman のagent commandとPi notificationはdaemonを必要とします。daemon は `herdr session list --json` に出る実行中の Herdr session を監視し、60 秒ごとに再スキャンします。停止した Herdr session は index しません。runtime file は標準で `~/.herdsman` に置きます。別の directory を使う場合は `SHEPHERD_HOME` を設定します。
+
+```bash
+herdsman daemon start
+```
+
+## 主なコマンド
+
+- `herdsman agent list`: 選択した workspace の最新キャッシュから status と最後の user / assistant message の抜粋を返します。鮮度が必要なときは各行の `updatedAt` を確認します。
+- `herdsman agent get <target>`: 明示的に詳細を取得し、1 agent の metadata、compact history、最新の compact tool result を返します。
+- `herdsman agent read <target> --limit N`: 明示的に履歴を読み、直近 N 件の user / assistant / compact `tool_result` message を返します。
+
+各 agent record は、`reviewer` のような Herdr の live `name` と、`codex` のような runtime `agent` kind を別々に保持します。通常の list 出力では `name` と `agent` を別の column に表示し、JSON でも両方を返します。Herdr workspace 内では、Herdsman が current workspace を自動で選びます。
+
+```bash
+herdsman agent list --json
+herdsman agent get reviewer --json
+herdsman agent read reviewer --limit 20 --json
+```
+
+Herdr の外から読む場合は scope を指定します。
+
+```bash
+herdsman agent list --all --json
+herdsman agent list --workspace wB --json
+herdsman agent get reviewer --workspace wB --json
+herdsman agent read wB:p2 --workspace wB --limit 20 --json
+```
+
+`<target>` は、選択した scope 内で pane id、terminal id、Herdsman agent id の完全一致を最初に探します。次に `reviewer` のような Herdr live name を探し、live name が一致しない場合だけ `codex` のような一意の agent kind を使います。複数の running Herdr session で target が曖昧になる場合は `--session <name>` を付けます。
+
+## Agent Skill
+
+Agent Skill を追加する前に、Herdsman CLI をインストールして daemon を起動します。次のコマンドで、対応する coding agent に Herdsman の手順を追加します。
+
+```bash
+npx skills add ryonakae/herdsman --skill herdsman -g
+```
+
+Herdsman skill は agent の status、compact history、直近の tool result を構造化データとして読み取ります。agent の確認だけなら、Herdsman skill を単独で使えます。
+
+workspace、tab、pane、terminal input/output、wait も agent から操作する場合は、公式 Herdr skill を追加します。
+
+```bash
+npx skills add ogulcancelik/herdr --skill herdr -g
+```
+
+## Pi extension
+
+Piからextensionをインストールします。
+
+```bash
+pi install npm:@dorokuma/herdsman-pi
+```
+
+extensionにはPi 0.80.6以降が必要です。PiがHerdr内で動くとHerdsman daemonに接続します。接続中のPiはoffの状態でも正確なPi session pathをpresence identityとして登録します。extensionはturnごとのtool resultや最終messageのtelemetryを送信しません。
+
+Piで`/herdsman on`を入力すると、そのterminalが現在のHerdr sessionとworkspaceにおける唯一のHerdsman ownerになります。cached current-workspace agent context、pending件数、agent update、自動wakeを受け取るのはownerだけです。contextからowner自身のPi terminalを除き、ほかのPi terminalを含めます。通常のpromptではdaemon RPCや履歴読み込みを待たず、local cacheのsnapshotを挿入します。起動直後、reconnect直後、scope移動直後はsnapshotが届くまでcontextが一時的にない場合があります。
+
+agentが完了またはblockedになると、visibleなHerdsman turnを1回開始します。通常のuser runが実行中なら、Herdsmanはsettleを待ちます。themed cardは最大3件を表示し、Piのexpand keyで全outcomeと長さを制限した最終responseを確認できます。nameがあるagentは`reviewer · Codex`、ないagentは`Codex`と表示します。agentの出力は信頼できない参考情報として扱い、Piは既存のuser requestに必要な作業だけを続けます。
+
+現在のPiの状態は`/herdsman`または`/herdsman status`で確認し、`/herdsman off`でそのPiのowner動作を解除します。offにしても別のownerへは影響しません。offまたはnon-ownerのPiは後でclaimできるよう接続を保ちますが、hidden agent context、pending件数、update、wakeは受け取りません。onのPiだけがfooterに`◆ Herdsman`を表示し、未処理のoutcomeがある間は`· N agent updates`が付きます。updateを含むturnが最終assistant responseを生成してsettleし、元のeventをacknowledgeすると件数が消えます。直前までonだったPiが接続を失うと、復旧中は`◇ Herdsman · reconnecting`を表示します。ownerがいない間はoutcomeを配信せず、その間に発生したoutcomeは後からclaimしてもreplayしません。reload、reconnect、別Piによる直接のowner交代では、未acknowledgedのoutcomeを保持します。ownershipはPi sessionの切り替えやpaneの移動後も同じHerdr terminalに追従し、そのterminalがgrace periodを超えて切断された場合は解除されます。
+
+## Herdr plugin
+
+任意のpluginはGitHub Releaseのtagからインストールします。
+
+```bash
+herdr plugin install ryonakae/herdsman/packages/herdsman-herdr-plugin --ref v0.4.0 --yes
+```
+
+plugin は Herdsman daemon に接続し、current Herdr workspace の compact agent row を Herdr UI に表示します。row には live name と runtime kind の column、cached history の抜粋が含まれます。Herdrはrepository subdirectoryからpluginをインストールします。npmには公開せず、CLIとPi extensionだけを使う場合は不要です。
+
+## パッケージ
+
+| Path | 配布方法 | Purpose |
+| --- | --- | --- |
+| repository root | npm: `@dorokuma/herdsman` | Herdsman CLIとdaemon。 |
+| `packages/herdsman-pi` | npm: `@dorokuma/herdsman-pi` | agent historyとagent updateのPi extension。 |
+| `packages/herdsman-herdr-plugin` | GitHub Releaseのsubdirectory | 任意のHerdr UI integration。npm packageではありません。 |
+
+## 開発
+
+```bash
+pnpm install
+pnpm check
+pnpm build
+```
+
+package検証、npm公開、GitHub Releaseの手順は[Releasing Herdsman](./docs/releasing.md)に記載しています。
+
+DB schema を変えたら次も実行します。
+
+```bash
+pnpm db:generate
+pnpm db:check
+```
+
+## ライセンス
+
+[MIT](./LICENSE)

package/README.md

@@ -0,0 +1,150 @@
+![Herdsman cover](./assets/herdsman-cover.png)
+
+
+## Credits / Acknowledgements
+
+herdsman is forked from ryonakae/shepherd at commit dfdd3a2 (v0.5.1). Thanks to the original author, Ryo Nakae, and the upstream project.
+
+Upstream: https://github.com/ryonakae/shepherd
+
+# Herdsman
+
+<!-- README-I18N:START -->
+**English** | [日本語](./README.ja.md)
+<!-- README-I18N:END -->
+
+Herdsman is a daemon-backed observability layer for coding agents running in Herdr. It provides two interfaces over the same durable agent index: pull-based CLI access to structured history, and owner-scoped Pi notifications with cached context and automatic wake.
+
+Herdr's `herdr agent read` reads terminal streams or scrollback. Herdsman instead reads agent session data so callers can retrieve work status, structured message excerpts, compact tool results, and unread outcomes without parsing terminal output. Herdsman is read-only; use the official Herdr CLI or skill for agent start, prompts, waits, pane operations, and terminal control.
+
+Herdsman currently supports session history from Claude Code, Codex, Gemini CLI, OpenCode, and Pi.
+
+## Requirements
+
+- Node.js >= 24.18.0
+- Herdr >= 0.7.0
+- Pi >= 0.80.6 when using `herdsman-pi`
+
+## Install
+
+```bash
+npm install --global @dorokuma/herdsman
+herdsman help
+```
+
+### Install from source
+
+Source builds also require pnpm >= 11.9.0.
+
+```bash
+git clone https://github.com/ryonakae/herdsman.git
+cd herdsman
+pnpm install
+pnpm build
+npm install --global . --ignore-scripts
+herdsman help
+```
+
+## Start the daemon
+
+Herdsman agent commands and Pi notifications require the daemon. The daemon watches all running Herdr sessions reported by `herdr session list --json`, rescans them every 60 seconds, and does not index stopped Herdr sessions. Runtime files live in `~/.herdsman` by default. Set `SHEPHERD_HOME` to use another directory.
+
+```bash
+herdsman daemon start
+```
+
+## Main commands
+
+- `herdsman agent list`: returns the daemon's latest cached status and last user / assistant excerpts for the selected workspace. Check each row's `updatedAt` when freshness matters.
+- `herdsman agent get <target>`: performs an explicit detail lookup and returns one agent's metadata, compact history, and latest compact tool result.
+- `herdsman agent read <target> --limit N`: performs an explicit history read and returns the latest N user / assistant / compact `tool_result` messages.
+
+Each agent record keeps Herdr's optional live `name`, such as `reviewer`, separate from its runtime `agent` kind, such as `codex`. Human list output uses distinct `name` and `agent` columns, and JSON returns both fields. Inside a Herdr workspace, Herdsman selects the current workspace automatically.
+
+```bash
+herdsman agent list --json
+herdsman agent get reviewer --json
+herdsman agent read reviewer --limit 20 --json
+```
+
+From outside Herdr, pass a scope.
+
+```bash
+herdsman agent list --all --json
+herdsman agent list --workspace wB --json
+herdsman agent get reviewer --workspace wB --json
+herdsman agent read wB:p2 --workspace wB --limit 20 --json
+```
+
+`<target>` first matches an exact pane id, terminal id, or Herdsman agent id in the selected scope. It then matches an exact Herdr live name such as `reviewer`; when no live name matches, it falls back to a unique agent kind such as `codex`. Use `--session <name>` when a target is ambiguous across running Herdr sessions.
+
+## Agent Skill
+
+Install the Herdsman CLI and start its daemon before adding the Agent Skill. Then add the Herdsman instructions to supported coding agents:
+
+```bash
+npx skills add ryonakae/herdsman --skill herdsman -g
+```
+
+The Herdsman skill reads structured agent status, compact history, and recent tool results. Use it alone for agent inspection.
+
+Add the official Herdr skill when an agent needs to control workspaces, tabs, panes, terminal input/output, or waits:
+
+```bash
+npx skills add ogulcancelik/herdr --skill herdr -g
+```
+
+## Pi extension
+
+Install the extension through Pi:
+
+```bash
+pi install npm:@dorokuma/herdsman-pi
+```
+
+The extension requires Pi 0.80.6 or newer and connects to the Herdsman daemon when Pi runs inside Herdr. Each connected Pi registers its exact Pi session path as presence identity, including while off. The extension does not send per-turn tool-result or final-message telemetry.
+
+Enter `/herdsman on` in Pi to make this terminal the sole Herdsman owner for its current Herdr session and workspace. Only the owner receives cached current-workspace agent context, pending counts, agent updates, and automatic wake. Its context excludes its own Pi terminal and includes other Pi terminals. A normal prompt injects the locally cached snapshot without daemon RPC or history reads, so context can be temporarily absent after startup, reconnect, or scope movement until a snapshot arrives.
+
+Completed or blocked agent outcomes start one visible Herdsman turn. If a normal user run is active, Herdsman waits for it to settle. The themed card shows up to three agents; use Pi's expand key to see every outcome and its bounded final response. Named agents appear as `reviewer · Codex`, with `Codex` as the unnamed fallback. Agent output is untrusted evidence: Pi may continue only the existing user request and must not expand its scope.
+
+Use `/herdsman` or `/herdsman status` to inspect the current Pi, and `/herdsman off` to release owner behavior for that Pi. Turning one Pi off does not affect another owner. An off or non-owner Pi remains connected for a later claim, but receives no hidden agent context, pending counts, updates, or wake. The active Pi shows `◆ Herdsman`; pending outcomes add `· N agent updates` until a turn containing them produces a final assistant response, settles, and acknowledges every underlying event. A previously active Pi shows `◇ Herdsman · reconnecting` during transport recovery. With no owner, outcomes are not delivered, and outcomes created during the ownerless period are not replayed by a later claim. Reloads, reconnects, and direct replacement by another Pi preserve unacknowledged outcomes. Ownership follows the Herdr terminal across Pi session replacement and pane movement, and clears when that terminal remains disconnected beyond the grace period.
+
+## Herdr plugin
+
+Install the optional plugin from the GitHub release tag:
+
+```bash
+herdr plugin install ryonakae/herdsman/packages/herdsman-herdr-plugin --ref v0.4.0 --yes
+```
+
+The plugin connects to the Herdsman daemon and shows compact agent rows for the current Herdr workspace, including separate live-name and runtime-kind columns plus cached history excerpts. Herdr installs it from the repository subdirectory; it is not published to npm or required for the CLI and Pi extension.
+
+## Packages
+
+| Path | Distribution | Purpose |
+| --- | --- | --- |
+| repository root | npm: `@dorokuma/herdsman` | Herdsman CLI and daemon. |
+| `packages/herdsman-pi` | npm: `@dorokuma/herdsman-pi` | Pi extension for agent history and agent updates. |
+| `packages/herdsman-herdr-plugin` | GitHub release subdirectory | Optional Herdr UI integration; not an npm package. |
+
+## Development
+
+```bash
+pnpm install
+pnpm check
+pnpm build
+```
+
+See [Releasing Herdsman](./docs/releasing.md) for package validation, npm publication, and GitHub Release steps.
+
+DB schema changes require:
+
+```bash
+pnpm db:generate
+pnpm db:check
+```
+
+## License
+
+[MIT](./LICENSE)

package/dist/drizzle.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("drizzle-kit").Config;
+export default _default;
+//# sourceMappingURL=drizzle.config.d.ts.map

package/dist/drizzle.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.config.d.ts","sourceRoot":"","sources":["../drizzle.config.ts"],"names":[],"mappings":";AAEA,wBAIG"}

package/dist/drizzle.config.js

@@ -0,0 +1,7 @@
+import { defineConfig } from "drizzle-kit";
+export default defineConfig({
+    dialect: "sqlite",
+    out: "./drizzle",
+    schema: "./src/db/schema.ts",
+});
+//# sourceMappingURL=drizzle.config.js.map

package/dist/drizzle.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.config.js","sourceRoot":"","sources":["../drizzle.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,eAAe,YAAY,CAAC;IAC1B,OAAO,EAAE,QAAQ;IACjB,GAAG,EAAE,WAAW;IAChB,MAAM,EAAE,oBAAoB;CAC7B,CAAC,CAAC"}

package/dist/src/agent-history/claude-reader.d.ts

@@ -0,0 +1,10 @@
+import type { AgentHistoryMessage, AgentHistoryRef } from "../observability/contracts.js";
+import { type AgentHistoryReader } from "./readers.js";
+export declare class ClaudeHistoryReader implements AgentHistoryReader {
+    canRead(ref: AgentHistoryRef): boolean;
+    read(ref: AgentHistoryRef, options?: {
+        limit?: number;
+    }): Promise<AgentHistoryMessage[]>;
+    readCompact(ref: AgentHistoryRef): Promise<import("../observability/contracts.js").CompactAgentHistory>;
+}
+//# sourceMappingURL=claude-reader.d.ts.map

package/dist/src/agent-history/claude-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-reader.d.ts","sourceRoot":"","sources":["../../../src/agent-history/claude-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,cAAc,CAAC;AAItB,qBAAa,mBAAoB,YAAW,kBAAkB;IAC5D,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO;IAIhC,IAAI,CACR,GAAG,EAAE,eAAe,EACpB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAwC3B,WAAW,CAAC,GAAG,EAAE,eAAe;CAGvC"}

package/dist/src/agent-history/claude-reader.js

@@ -0,0 +1,90 @@
+import { compactFromMessages, limitMessages, readJsonl, } from "./readers.js";
+import { messageRef, textFromContent, timestampFrom } from "./text.js";
+import { compactToolResult } from "./tool-compaction.js";
+export class ClaudeHistoryReader {
+    canRead(ref) {
+        return ref.source === "claude-jsonl" && Boolean(ref.path ?? ref.value);
+    }
+    async read(ref, options = {}) {
+        const path = ref.path ?? ref.value;
+        const messages = [];
+        for (const entry of await readJsonl(path)) {
+            const type = stringValue(entry.value.type);
+            if (!type || ignoredTypes.has(type))
+                continue;
+            const message = record(entry.value.message);
+            const uuid = stringValue(entry.value.uuid) ?? stringValue(entry.value.id);
+            const timestamp = timestampFrom(entry.value.timestamp) ?? timestampFrom(message.timestamp);
+            const refValue = messageRef(path, uuid ?? undefined, entry.line);
+            const role = stringValue(message.role) ?? (type === "assistant" || type === "user" ? type : null);
+            const toolResult = toolResultFrom(entry.value, message);
+            if (toolResult) {
+                const compact = compactToolResult({
+                    isError: toolResult.isError,
+                    ref: refValue,
+                    text: toolResult.text,
+                    toolName: toolResult.toolName,
+                });
+                messages.push({
+                    compact,
+                    ref: refValue,
+                    role: "tool_result",
+                    text: compact.text,
+                    timestamp,
+                    toolName: toolResult.toolName,
+                });
+                continue;
+            }
+            if (role === "user" || role === "assistant") {
+                const text = textFromContent(message.content);
+                if (text)
+                    messages.push({ ref: refValue, role, text, timestamp });
+            }
+        }
+        return limitMessages(messages, options.limit);
+    }
+    async readCompact(ref) {
+        return compactFromMessages(ref, await this.read(ref));
+    }
+}
+const ignoredTypes = new Set(["attachment", "file-history-snapshot", "mode", "permission-mode"]);
+function toolResultFrom(entry, message) {
+    const topToolUseResult = entry.toolUseResult;
+    if (topToolUseResult !== undefined && topToolUseResult !== null) {
+        return {
+            isError: entry.isError === true || message.isError === true,
+            text: typeof topToolUseResult === "string" ? topToolUseResult : JSON.stringify(topToolUseResult),
+            toolName: stringValue(entry.toolName) ?? stringValue(message.toolName) ?? "unknown",
+        };
+    }
+    const content = message.content;
+    if (Array.isArray(content)) {
+        const toolBlocks = content.filter((block) => {
+            if (typeof block !== "object" || block === null)
+                return false;
+            const record = block;
+            return record.type === "tool_result" || record.type === "tool_result_delta";
+        });
+        if (toolBlocks.length > 0) {
+            return {
+                isError: toolBlocks.some((block) => typeof block === "object" &&
+                    block !== null &&
+                    block.is_error === true),
+                text: toolBlocks
+                    .map((block) => textFromContent(record(block).content) ?? JSON.stringify(block))
+                    .join("\n"),
+                toolName: stringValue(record(toolBlocks[0]).name) ??
+                    stringValue(record(toolBlocks[0]).toolName) ??
+                    "unknown",
+            };
+        }
+    }
+    return null;
+}
+function record(value) {
+    return typeof value === "object" && value !== null ? value : {};
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+//# sourceMappingURL=claude-reader.js.map

package/dist/src/agent-history/claude-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-reader.js","sourceRoot":"","sources":["../../../src/agent-history/claude-reader.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,mBAAmB,EACnB,aAAa,EACb,SAAS,GACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,OAAO,mBAAmB;IAC9B,OAAO,CAAC,GAAoB;QAC1B,OAAO,GAAG,CAAC,MAAM,KAAK,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,IAAI,CACR,GAAoB,EACpB,UAA8B,EAAE;QAEhC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;QACnC,MAAM,QAAQ,GAA0B,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,MAAM,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,SAAS;YAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1E,MAAM,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAC3F,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,IAAI,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACjE,MAAM,IAAI,GACR,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAEvF,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxD,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,iBAAiB,CAAC;oBAChC,OAAO,EAAE,UAAU,CAAC,OAAO;oBAC3B,GAAG,EAAE,QAAQ;oBACb,IAAI,EAAE,UAAU,CAAC,IAAI;oBACrB,QAAQ,EAAE,UAAU,CAAC,QAAQ;iBAC9B,CAAC,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC;oBACZ,OAAO;oBACP,GAAG,EAAE,QAAQ;oBACb,IAAI,EAAE,aAAa;oBACnB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,SAAS;oBACT,QAAQ,EAAE,UAAU,CAAC,QAAQ;iBAC9B,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC5C,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC9C,IAAI,IAAI;oBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAoB;QACpC,OAAO,mBAAmB,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;CACF;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,uBAAuB,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAEjG,SAAS,cAAc,CACrB,KAA8B,EAC9B,OAAgC;IAEhC,MAAM,gBAAgB,GAAG,KAAK,CAAC,aAAa,CAAC;IAC7C,IAAI,gBAAgB,KAAK,SAAS,IAAI,gBAAgB,KAAK,IAAI,EAAE,CAAC;QAChE,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;YAC3D,IAAI,EACF,OAAO,gBAAgB,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC;YAC5F,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,SAAS;SACpF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;gBAAE,OAAO,KAAK,CAAC;YAC9D,MAAM,MAAM,GAAG,KAAgC,CAAC;YAChD,OAAO,MAAM,CAAC,IAAI,KAAK,aAAa,IAAI,MAAM,CAAC,IAAI,KAAK,mBAAmB,CAAC;QAC9E,CAAC,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,UAAU,CAAC,IAAI,CACtB,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ;oBACzB,KAAK,KAAK,IAAI;oBACb,KAAgC,CAAC,QAAQ,KAAK,IAAI,CACtD;gBACD,IAAI,EAAE,UAAU;qBACb,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;qBAC/E,IAAI,CAAC,IAAI,CAAC;gBACb,QAAQ,EACN,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBACvC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;oBAC3C,SAAS;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/F,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACtE,CAAC"}

package/dist/src/agent-history/codex-reader.d.ts

@@ -0,0 +1,10 @@
+import type { AgentHistoryMessage, AgentHistoryRef } from "../observability/contracts.js";
+import { type AgentHistoryReader } from "./readers.js";
+export declare class CodexHistoryReader implements AgentHistoryReader {
+    canRead(ref: AgentHistoryRef): boolean;
+    read(ref: AgentHistoryRef, options?: {
+        limit?: number;
+    }): Promise<AgentHistoryMessage[]>;
+    readCompact(ref: AgentHistoryRef): Promise<import("../observability/contracts.js").CompactAgentHistory>;
+}
+//# sourceMappingURL=codex-reader.d.ts.map

package/dist/src/agent-history/codex-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-reader.d.ts","sourceRoot":"","sources":["../../../src/agent-history/codex-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EACL,KAAK,kBAAkB,EAIxB,MAAM,cAAc,CAAC;AAItB,qBAAa,kBAAmB,YAAW,kBAAkB;IAC3D,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO;IAIhC,IAAI,CACR,GAAG,EAAE,eAAe,EACpB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAoF3B,WAAW,CAAC,GAAG,EAAE,eAAe;CAGvC"}

package/dist/src/agent-history/codex-reader.js

@@ -0,0 +1,119 @@
+import { compactFromMessages, limitMessages, readJsonl, } from "./readers.js";
+import { messageRef, textFromContent, timestampFrom } from "./text.js";
+import { compactToolResult } from "./tool-compaction.js";
+export class CodexHistoryReader {
+    canRead(ref) {
+        return ref.source === "codex-jsonl" && Boolean(ref.path ?? ref.value);
+    }
+    async read(ref, options = {}) {
+        const path = ref.path ?? ref.value;
+        const messages = [];
+        const toolNamesByCallId = new Map();
+        for (const entry of await readJsonl(path)) {
+            const type = stringValue(entry.value.type);
+            const payload = record(entry.value.payload);
+            const payloadType = stringValue(payload.type);
+            const id = stringValue(payload.id) ?? stringValue(payload.call_id) ?? stringValue(entry.value.id);
+            const timestamp = timestampFrom(payload.timestamp) ??
+                timestampFrom(payload.started_at) ??
+                timestampFrom(entry.value.timestamp);
+            const refValue = messageRef(path, id ?? undefined, entry.line);
+            if (type === "event_msg") {
+                if (payloadType === "user_message") {
+                    const text = stringValue(payload.message);
+                    if (text && !isSystemCodexMessage(text)) {
+                        messages.push({ ref: refValue, role: "user", text, timestamp });
+                    }
+                    continue;
+                }
+                if (payloadType === "agent_message") {
+                    const text = stringValue(payload.message);
+                    if (text)
+                        messages.push({ ref: refValue, role: "assistant", text, timestamp });
+                    continue;
+                }
+                if (payloadType === "task_complete") {
+                    const text = stringValue(payload.last_agent_message);
+                    if (text)
+                        messages.push({ ref: refValue, role: "assistant", text, timestamp });
+                    continue;
+                }
+            }
+            if (type !== "response_item")
+                continue;
+            if (payloadType === "function_call" || payloadType === "custom_tool_call") {
+                const callId = stringValue(payload.call_id);
+                const name = stringValue(payload.name);
+                if (callId && name)
+                    toolNamesByCallId.set(callId, name);
+                continue;
+            }
+            if (payloadType === "function_call_output" || payloadType === "custom_tool_call_output") {
+                const callId = stringValue(payload.call_id);
+                const toolName = (callId ? toolNamesByCallId.get(callId) : null) ?? "unknown";
+                const text = textFromCodexOutput(payload.output);
+                const compact = compactToolResult({ isError: false, ref: refValue, text, toolName });
+                messages.push({
+                    compact,
+                    ref: refValue,
+                    role: "tool_result",
+                    text: compact.text,
+                    timestamp,
+                    toolName,
+                });
+                continue;
+            }
+            if (payloadType === "message") {
+                const role = stringValue(payload.role);
+                if (role === "developer")
+                    continue;
+                if (role === "user") {
+                    const text = textFromCodexContent(payload.content, "input_text");
+                    if (text && !isSystemCodexMessage(text)) {
+                        messages.push({ ref: refValue, role: "user", text, timestamp });
+                    }
+                    continue;
+                }
+                if (role === "assistant") {
+                    const text = textFromCodexContent(payload.content, "output_text") ??
+                        textFromContent(payload.content);
+                    if (text)
+                        messages.push({ ref: refValue, role: "assistant", text, timestamp });
+                }
+            }
+        }
+        return limitMessages(messages, options.limit);
+    }
+    async readCompact(ref) {
+        return compactFromMessages(ref, await this.read(ref));
+    }
+}
+function textFromCodexContent(content, blockType) {
+    if (!Array.isArray(content))
+        return typeof content === "string" ? content : null;
+    const parts = content
+        .map((block) => {
+        const item = record(block);
+        if (item.type !== blockType)
+            return "";
+        return stringValue(item.text) ?? "";
+    })
+        .filter((part) => part.trim().length > 0);
+    return parts.length > 0 ? parts.join("\n") : null;
+}
+function textFromCodexOutput(value) {
+    if (typeof value === "string")
+        return value;
+    return JSON.stringify(value ?? "");
+}
+function isSystemCodexMessage(text) {
+    const trimmed = text.trim();
+    return trimmed.startsWith("<environment_context>") || trimmed.startsWith("<user_instructions>");
+}
+function record(value) {
+    return typeof value === "object" && value !== null ? value : {};
+}
+function stringValue(value) {
+    return typeof value === "string" && value.length > 0 ? value : null;
+}
+//# sourceMappingURL=codex-reader.js.map

package/dist/src/agent-history/codex-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-reader.js","sourceRoot":"","sources":["../../../src/agent-history/codex-reader.ts"],"names":[],"mappings":"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"}

package/dist/src/agent-history/discovery.d.ts

@@ -0,0 +1,13 @@
+import type { AgentHistoryRef, AgentSessionRef } from "../observability/contracts.js";
+export declare const DISCOVERY_RECENCY_GRACE_MS: number;
+export type AgentHistoryLookupInput = {
+    agent: string | null;
+    agentSession: AgentSessionRef | null;
+    cwd: string | null;
+    foregroundCwd: string | null;
+    firstSeenAtMs?: number;
+    homeDir?: string;
+};
+export declare function discoverAgentHistory(input: AgentHistoryLookupInput): Promise<AgentHistoryRef | null>;
+export declare function historySourceFromSessionRef(ref: AgentSessionRef): AgentHistoryRef["source"];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/src/agent-history/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/agent-history/discovery.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AASrF,eAAO,MAAM,0BAA0B,QAAc,CAAC;AAEtD,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,eAAe,GAAG,IAAI,CAAC;IACrC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AASF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAyDjC;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC,CAS3F"}