tailii-host 0.1.0

package/dist/protocol.d.ts

@@ -0,0 +1,329 @@
+export declare const PROTOCOL_LEGACY = 0;
+export declare const PROTOCOL_V1 = 1;
+export declare const PROTOCOL_V2 = 2;
+export declare const PROTOCOL_MAX_SUPPORTED = 2;
+/** 承認要求に含まれる編集差分の構造化表現。 */
+export interface ToolDiff {
+    kind: "create" | "edit";
+    path: string;
+    newText?: string;
+    oldString?: string;
+    newString?: string;
+}
+/** tool_activity の差分詳細（キャップ済み old/new と切り詰めフラグ）。 */
+export interface ToolActivityDiff {
+    oldString?: string;
+    newString?: string;
+    oldStringTruncated: boolean;
+    newStringTruncated: boolean;
+}
+/** TodoWrite の 1 項目。 */
+export interface ToolActivityTodo {
+    content: string;
+    status: string;
+}
+/** Claude Code transcript の tool_use を chat timeline に表示するための構造化通知。 */
+export interface ToolActivity {
+    id: string;
+    name: string;
+    label: string;
+    file?: string;
+    addedLines?: number;
+    removedLines?: number;
+    diff?: ToolActivityDiff;
+    command?: string;
+    commandTruncated: boolean;
+    description?: string;
+    descriptionTruncated: boolean;
+    todos?: ToolActivityTodo[];
+}
+export type SubagentNodeStatus = "running" | "completed" | "error";
+/** サブエージェント（workflow）進捗ツリーのノード状態通知。 */
+export interface SubagentNode {
+    nodeId: string;
+    toolUseId: string;
+    parentNodeId?: string | null;
+    agentType: string;
+    label: string;
+    depth: number;
+    status: SubagentNodeStatus;
+    currentActivity?: string | null;
+    ts: number;
+}
+/** セッション一覧応答の 1 要素。 */
+export interface SessionInfo {
+    name: string;
+    cwd: string;
+    alive: boolean;
+    updatedAt?: number;
+}
+/** マシン内会話 1 件（claude=jsonl / codex=rollout）。 */
+export interface ClaudeSessionInfo {
+    sessionId: string;
+    cwd: string;
+    title: string;
+    updatedAt?: number;
+    /** 会話を駆動するエージェント（claude=既定 / codex, agent-tag）。未指定は claude 相当。 */
+    agent?: "claude" | "codex";
+}
+/** session_search_response の 1 検索結果。 */
+export interface SessionSearchResult {
+    sessionId: string;
+    title: string;
+    cwd: string;
+    snippet: string;
+    updatedAt?: number;
+}
+/** slash_list_response の 1 コマンド候補。 */
+export interface SlashCommandInfo {
+    name: string;
+    summary: string;
+}
+/** AskUserQuestion の選択肢。 */
+export interface QuestionOption {
+    label: string;
+    description: string;
+}
+/** AskUserQuestion の質問 1 件。 */
+export interface QuestionPromptQuestion {
+    header: string;
+    question: string;
+    multiSelect: boolean;
+    options: QuestionOption[];
+}
+/** AskUserQuestion の回答 1 件。 */
+export interface QuestionAnswer {
+    questionIndex: number;
+    selectedOptionIndexes: number[];
+    otherText?: string;
+    /** 対象質問が multiSelect か（TUI 注入方式の選択に使う。旧形式欠落は false）。 */
+    multiSelect: boolean;
+}
+export type ChatRole = "assistant" | "user" | "system";
+export type Decision = "allow" | "deny";
+export type ControlMessage = {
+    type: "channel_hello";
+    v: number;
+    maxVersion: number;
+    serverVersion?: string;
+} | {
+    type: "approval_request";
+    v: number;
+    id: string;
+    tool: string;
+    summary: string;
+    cwd: string;
+    diff?: ToolDiff;
+} | {
+    type: "approval_decision";
+    v: number;
+    id: string;
+    decision: Decision;
+    reason?: string;
+} | {
+    type: "session_list_request";
+    v: number;
+    id: string;
+    limit?: number;
+    cursor?: string;
+} | {
+    type: "session_list_response";
+    v: number;
+    id: string;
+    sessions: SessionInfo[];
+    nextCursor?: string;
+} | {
+    type: "session_start";
+    v: number;
+    id: string;
+    cwd: string;
+    name: string;
+    baseDir?: string;
+    resumeSessionId?: string;
+    title?: string;
+    agentType?: "claude" | "codex";
+    codexModel?: string;
+    codexSandbox?: "read-only" | "workspace-write" | "danger-full-access";
+} | {
+    type: "session_reattach";
+    v: number;
+    id: string;
+    name: string;
+} | {
+    type: "session_kill";
+    v: number;
+    id: string;
+    name: string;
+} | {
+    type: "session_idle_hint";
+    v: number;
+    id: string;
+    name: string;
+} | {
+    type: "error";
+    v: number;
+    id?: string;
+    code: string;
+    message: string;
+} | {
+    type: "image_available";
+    v: number;
+    id: string;
+    path: string;
+    mime: string;
+    thumbnail: string;
+    width: number;
+    height: number;
+    relatedApprovalId?: string;
+} | {
+    type: "image_fetch_request";
+    v: number;
+    id: string;
+} | {
+    type: "image_fetch_response";
+    v: number;
+    id: string;
+    seq: number;
+    data: string;
+    eof: boolean;
+    mime: string;
+} | {
+    type: "chat_output";
+    v: number;
+    streamId: string;
+    role: ChatRole;
+    text: string;
+    eof: boolean;
+} | {
+    type: "tool_activity";
+    v: number;
+    activity: ToolActivity;
+} | {
+    type: "subagent_node";
+    v: number;
+    node: SubagentNode;
+} | {
+    type: "question_prompt";
+    v: number;
+    id: string;
+    questions: QuestionPromptQuestion[];
+} | {
+    type: "question_answer";
+    v: number;
+    id: string;
+    session: string;
+    answers: QuestionAnswer[];
+} | {
+    type: "question_dismiss";
+    v: number;
+    id: string;
+} | {
+    type: "usage_request";
+    v: number;
+    id: string;
+} | {
+    type: "usage_response";
+    v: number;
+    id: string;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreationTokens: number;
+    turns: number;
+    fiveHourUtilization?: number;
+    fiveHourResetsAt?: string;
+    sevenDayUtilization?: number;
+    sevenDayResetsAt?: string;
+    sevenDayFableUtilization?: number;
+    sevenDayFableResetsAt?: string;
+} | {
+    type: "mode_get";
+    v: number;
+    id: string;
+    session: string;
+} | {
+    type: "mode_set";
+    v: number;
+    id: string;
+    session: string;
+    mode: string;
+} | {
+    type: "mode_set_response";
+    v: number;
+    id: string;
+    mode: string;
+} | {
+    type: "slash_list_request";
+    v: number;
+    id: string;
+    cwd?: string;
+} | {
+    type: "slash_list_response";
+    v: number;
+    id: string;
+    commands: SlashCommandInfo[];
+} | {
+    type: "dir_list_request";
+    v: number;
+    id: string;
+    baseDir: string;
+    partial: string;
+} | {
+    type: "dir_list_response";
+    v: number;
+    id: string;
+    entries: string[];
+} | {
+    type: "browse_request";
+    v: number;
+    id: string;
+    path: string;
+} | {
+    type: "browse_response";
+    v: number;
+    id: string;
+    path: string;
+    entries: string[];
+} | {
+    type: "claude_session_list_request";
+    v: number;
+    id: string;
+} | {
+    type: "claude_session_list_response";
+    v: number;
+    id: string;
+    claudeSessions: ClaudeSessionInfo[];
+} | {
+    type: "dir_create_request";
+    v: number;
+    id: string;
+    baseDir: string;
+    relative: string;
+} | {
+    type: "dir_create_response";
+    v: number;
+    id: string;
+    path: string;
+    ok: boolean;
+} | {
+    type: "session_search_request";
+    v: number;
+    id: string;
+    query: string;
+    limit?: number;
+} | {
+    type: "session_search_response";
+    v: number;
+    id: string;
+    results: SessionSearchResult[];
+};
+export type ControlMessageType = ControlMessage["type"];
+/** decode が投げる型付きエラー。呼び出し元は「決定未取得」として安全側（deny）に倒す。 */
+export declare class ProtocolDecodeError extends Error {
+    readonly reason: "invalid-json" | "missing-type" | "unknown-type" | "unsupported-version" | "legacy-unsupported-type" | "missing-field";
+    constructor(reason: "invalid-json" | "missing-type" | "unknown-type" | "unsupported-version" | "legacy-unsupported-type" | "missing-field", detail: string);
+}
+/** NDJSON 1 行（改行なし）を `ControlMessage` へデコードする。失敗は `ProtocolDecodeError`。 */
+export declare function decodeControlMessage(line: string | Buffer): ControlMessage;
+/** `ControlMessage` を canonical NDJSON 1 行（改行なし）へエンコードする。 */
+export declare function encodeControlMessage(message: ControlMessage): string;