claude-task-worker 0.115.0 → 0.117.0

package/dist/herdr-runner.d.ts

@@ -0,0 +1,136 @@
+import type * as HerdrModule from "./herdr";
+import type { AgentStatus } from "./herdr";
+import type { TaskResult } from "./task-result";
+export declare const AGENT_POLL_INTERVAL_MS: number;
+export declare const PANE_OUTPUT_LINES = 300;
+export declare function taskTabLabel(projectName: string, number: number): string;
+export declare function toAgentName(label: string): string;
+export interface CompletionTracker {
+    seenWorking: boolean;
+    warnedBlocked: boolean;
+}
+export declare function createCompletionTracker(): CompletionTracker;
+export type TrackerDecision = "running" | "completed" | "blocked-first-seen";
+export declare function observeAgentStatus(tracker: CompletionTracker, status: AgentStatus): {
+    tracker: CompletionTracker;
+    decision: TrackerDecision;
+};
+export declare function extractCloudSessionId(text: string): string | undefined;
+export declare function normalizePtyOutput(text: string): string;
+/**
+ * herdr モードのタスク結果を組み立てる。`claude -p` と違い exit code が無いため、
+ * 「出力が空か」だけで成否を判定する。プリアンブル失敗などでモデルが
+ * 起動しないまま idle になったセッションを空振りとして失敗扱いにする狙いは
+ * task-result.ts の buildTaskResult と同じ。
+ *
+ * 通知に載せる本文は **transcript から取った最終レポート（`report`）を最優先**する。
+ * ペインの端末内容は「会話ログ + 空行パディング + 入力ボックス + ステータスバー」で、
+ * Slack 通知が切り出す末尾1000文字はほぼ TUI の装飾しか含まないため、通知本文として
+ * 使い物にならない（transcript.ts 参照）。transcript を引けなかった場合のみ
+ * 従来どおりペイン内容へフォールバックする。
+ */
+export declare function buildHerdrTaskResult(paneOutput: string, options?: {
+    report?: string;
+}): TaskResult;
+export interface HerdrTask {
+    paneId: string;
+    tabId: string;
+}
+export declare const PANE_READY_TIMEOUT_MS: number;
+export declare const PANE_READY_POLL_INTERVAL_MS = 200;
+export interface StartTiming {
+    paneReadyTimeoutMs?: number;
+    paneReadyPollIntervalMs?: number;
+    agentStartReadyTimeoutMs?: number;
+    promptAcceptTimeoutMs?: number;
+    promptAcceptPollIntervalMs?: number;
+}
+export declare const PROMPT_ACCEPT_TIMEOUT_MS: number;
+export declare const PROMPT_ACCEPT_POLL_INTERVAL_MS = 500;
+/**
+ * herdr のタスク専用タブで claude を TUI 起動する（1タスク=1タブ）。
+ *
+ * `--no-focus` でタスク専用タブを作り、その**ルートペイン（シェル）で** `herdr agent start`
+ * を使って素の claude(TUI) を起動し、起動後に `herdr agent prompt` でタスクのプロンプトを
+ * 投入する。`agent start <name> --kind claude --pane <id> -- <args>` は（name は
+ * ラベルを agent 名規則へ変換した `toAgentName(label)`）、
+ * ペインのシェルで claude を起動し、agent として検出され入力待ちになるまで同期的にブロックする
+ * （旧 send-text 方式の「起動コマンド送信 → 自動検出待ちポーリング」を1コマンドで担う）。
+ * `--kind claude` が実行ファイルを供給するため、`args` には claude のフラグだけを渡す
+ * （実行ファイル名・プロンプトは含めない）。cwd・env は tabCreate の `--cwd` / `--env` で
+ * ペインへ渡してあり、そこで起動する claude が継承する。ルートペインがそのまま claude の
+ * ペインになるので、旧実装のような余剰シェルペインの `paneClose` は不要。
+ *
+ * **プロンプトを起動引数に含めてはいけない**。含めると claude が起動と同時に作業を始め、
+ * 「入力待ちになるまでブロックする」`agent start` がタスク完了まで返らず（2分を超えると
+ * timeout エラーで作業中の claude ごとタブが閉じられる）、しかも herdr がそのターンを
+ * 追跡しないため非フォーカス完了で `done` にならず `idle` へ戻る。結果として
+ * waitForHerdrTask は `working` を一度も観測できず、完了を永久に検知できない
+ * （実測: ステータスが `running:idle` のまま張り付く）。
+ *
+ * 手順:
+ * 1. tabCreate（`--no-focus`）でユーザーの見ているタブに割り込まないタスク専用タブを作る
+ * 2. waitForPaneReady でシェルプロンプトの描画を待つ（未描画で agent start すると起動に失敗しうる）
+ * 3. agentStart で claude を起動し、検出＋入力待ちになるまで待つ。検出できなければ herdr が
+ *    エラーを返して agentStart が throw する（例: 起動失敗）。その場合は
+ *    シェルだけのタブが残らないよう閉じてから失敗させる
+ * 4. agentPrompt でタスクのプロンプトを投入する。失敗時は 3 と同様にタブを閉じて失敗させる
+ */
+export declare function startHerdrTask({ label, cwd, args, prompt, env, workspaceId, herdr, timing, }: {
+    label: string;
+    cwd: string;
+    args: string[];
+    prompt: string;
+    env?: Record<string, string>;
+    workspaceId?: string;
+    herdr?: typeof HerdrModule;
+    timing?: StartTiming;
+}): Promise<HerdrTask>;
+export declare function waitForPaneReady(paneId: string, mod: typeof HerdrModule, options?: {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}): Promise<boolean>;
+/**
+ * agent ステータスをポーリングしてタスクの完了を待ち、完了時の出力を回収する。
+ * 出力は transcript の最終レポートを優先し、引けない場合だけペイン内容を使う。
+ *
+ * - `working` → `idle` の遷移を完了とみなす
+ * - `blocked` は人の介入を待つ状態として待機を継続する（自動失敗にはしない）
+ * - ペインが消えた場合（`pane_not_found`）は claude の異常終了・タブの手動クローズとして失敗扱い
+ *
+ * タスクの実行時間に上限は設けない（default モードと同じ方針）。
+ */
+export declare function waitForHerdrTask(paneId: string, options?: {
+    pollIntervalMs?: number;
+    herdr?: typeof HerdrModule;
+    onBlocked?: () => void;
+    onStatus?: (status: AgentStatus) => void;
+    signal?: {
+        aborted: boolean;
+    };
+    readReport?: (sessionId: string | undefined) => string;
+}): Promise<TaskResult>;
+export declare const CLAUDE_EXIT_TIMEOUT_MS: number;
+export declare const CLAUDE_EXIT_POLL_INTERVAL_MS = 200;
+/**
+ * タスクの TUI セッションを終了してタブを閉じる。
+ *
+ * ペインの内容はタブを閉じると失われるため、必ず出力を回収した後に呼ぶこと。
+ * また claude がまだ worktree を掴んでいる状態で worktree を削除できないよう、
+ * 呼び出し側は「停止 → 完了コールバック（worktree 削除）」の順序を守る。
+ *
+ * ctrl-c は **1コマンドで連続2回** 送る。Claude Code の TUI は ctrl-c 1回では終了せず
+ * （1回目は入力のキャンセル）、間隔を空けた2回でも終了カウントがリセットされて終了しない
+ * ことを実測で確認している（`pane send-keys <pane> ctrl+c ctrl+c` なら終了する）。
+ * ここで終了させずに tabClose だけに頼ると、claude は後片付けの機会を得られないまま
+ * 強制終了される。
+ *
+ * 新モデルでは claude はタブのルートシェルペインで動くため、claude がグレースフルに
+ * 終了してもペイン（＝シェル）とタブは残る。そのため tabClose は必須で、agent 検出が
+ * 外れる（＝claude が終了した）のを待ってから確実にタブごと閉じる。既にタブが
+ * 消えているケース（tab_not_found）は正常系として握り潰す。
+ */
+export declare function stopHerdrTask(task: HerdrTask, herdr?: typeof HerdrModule, options?: {
+    exitTimeoutMs?: number;
+    exitPollIntervalMs?: number;
+}): Promise<void>;

package/dist/herdr.d.ts

@@ -0,0 +1,85 @@
+export interface TabInfo {
+    tabId: string;
+    label: string;
+    workspaceId: string;
+}
+export interface WorkspaceInfo {
+    workspaceId: string;
+    label: string;
+    focused: boolean;
+}
+export interface CreatedWorkspace {
+    workspaceId: string;
+    tabId: string;
+    paneId: string;
+}
+export type AgentStatus = "working" | "idle" | "blocked" | "done" | "unknown";
+export interface AgentInfo {
+    paneId: string;
+    tabId: string;
+    workspaceId: string;
+    agentStatus: AgentStatus;
+    sessionId?: string;
+}
+export interface PaneProcessInfo {
+    foregroundProcesses: {
+        name: string;
+        argv: string[];
+        cmdline: string;
+        pid: number;
+    }[];
+}
+export declare class HerdrUnavailableError extends Error {
+    readonly reason: "not-installed" | "server-unreachable";
+    constructor(message: string, reason: "not-installed" | "server-unreachable");
+}
+export declare class HerdrError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+export declare const HERDR_TIMEOUT_MS: number;
+export declare function tabCreate({ label, cwd, workspaceId, env, }: {
+    label: string;
+    cwd: string;
+    workspaceId?: string;
+    env?: Record<string, string>;
+}): Promise<{
+    paneId: string;
+    tabId: string;
+}>;
+export declare function tabRename(tabId: string, label: string): Promise<void>;
+export declare function paneClose(paneId: string): Promise<void>;
+export declare function paneGet(paneId: string): Promise<{
+    paneId: string;
+    tabId: string;
+}>;
+export declare function tabClose(tabId: string): Promise<void>;
+export declare function tabList(): Promise<TabInfo[]>;
+export declare function workspaceCreate({ label, cwd, env, }: {
+    label: string;
+    cwd: string;
+    env?: Record<string, string>;
+}): Promise<CreatedWorkspace>;
+export declare function workspaceList(): Promise<WorkspaceInfo[]>;
+export declare function workspaceClose(workspaceId: string): Promise<void>;
+export declare function workspaceFocus(workspaceId: string): Promise<void>;
+export declare const AGENT_KIND = "claude";
+export declare const AGENT_START_READY_TIMEOUT_MS: number;
+export declare function agentStart(paneId: string, { name, args, kind, readyTimeoutMs, }: {
+    name: string;
+    args: string[];
+    kind?: string;
+    readyTimeoutMs?: number;
+}): Promise<AgentInfo>;
+export declare function agentPrompt(paneId: string, text: string): Promise<void>;
+export declare function agentGet(target: string): Promise<AgentInfo>;
+export declare function getCurrentWorkspaceId(): string | undefined;
+export type PaneReadSource = "visible" | "recent" | "recent-unwrapped";
+export declare function paneRead(paneId: string, options?: {
+    source?: PaneReadSource;
+    lines?: number;
+}): Promise<string>;
+export declare function paneSendText(paneId: string, text: string): Promise<void>;
+export declare function paneSendKeys(paneId: string, ...keys: string[]): Promise<void>;
+export declare function paneProcessInfo(paneId: string): Promise<PaneProcessInfo>;
+export declare function checkHerdrAvailable(): Promise<void>;

package/dist/index.d.ts

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