@wrongstack/core 0.284.0 → 0.285.0

package/dist/global-mailbox-sZwyI6CS.d.ts

@@ -1,959 +0,0 @@
-import { M as MailboxMessage, a as MailboxAgentStatus, b as Mailbox, c as MailboxSendInput, d as MailboxQuery, e as MailboxAckInput, f as MailboxAckBatchInput, A as AgentRegistrationInput, g as AgentHeartbeatInput, C as ClientRegistrationInput, h as ClientHeartbeatInput, i as ClientStatus, P as PurgeOptions, j as PurgeResult } from './mailbox-types-BGZWrYTJ.js';
-import { E as EventBus } from './events-Bgnh43r9.js';
-
-declare const HQ_PROTOCOL_VERSION: 1;
-type HqProtocolVersion = typeof HQ_PROTOCOL_VERSION;
-type HqClientKind = 'tui' | 'repl' | 'webui' | 'cli' | 'unknown';
-type HqWorkspaceKind = 'git' | 'directory' | 'unknown';
-type HqProjectStatus = 'active' | 'idle' | 'stale' | 'error';
-type HqClientCapability = 'telemetry.publish' | 'session.summary' | 'fleet.summary' | 'mailbox.summary' | 'control.receive';
-type HqToolArgsPolicy = 'none' | 'summary' | 'redacted';
-type HqPathPolicy = 'none' | 'project-relative' | 'redacted' | 'full';
-interface HqRedactionPolicy {
-    rawContent: boolean;
-    toolArgs: HqToolArgsPolicy;
-    paths: HqPathPolicy;
-}
-declare const DEFAULT_HQ_REDACTION_POLICY: HqRedactionPolicy;
-interface HqClientIdentity {
-    clientId: string;
-    kind: HqClientKind;
-    version?: string;
-    machineId: string;
-    hostname?: string;
-    pid?: number;
-    startedAt: string;
-}
-interface HqProjectIdentity {
-    projectId: string;
-    projectRoot: string;
-    projectName: string;
-    gitRemote?: string;
-    gitBranch?: string;
-    machineId: string;
-    workspaceKind: HqWorkspaceKind;
-}
-interface HqClientHelloPayload {
-    protocolVersion: HqProtocolVersion;
-    client: HqClientIdentity;
-    project: HqProjectIdentity;
-    capabilities: readonly HqClientCapability[];
-}
-interface HqWelcomePayload {
-    type: 'hq.welcome';
-    protocolVersion: HqProtocolVersion;
-    serverTime: string;
-    acceptedCapabilities: readonly HqClientCapability[];
-    redactionPolicy: HqRedactionPolicy;
-}
-interface HqEventEnvelope<TPayload = unknown> {
-    id: string;
-    type: HqEventType | (string & {});
-    schemaVersion: HqProtocolVersion;
-    timestamp: string;
-    clientId: string;
-    projectId: string;
-    sessionId?: string;
-    runId?: string;
-    seq: number;
-    payload: TPayload;
-}
-type HqEventType = 'client.hello' | 'client.heartbeat' | 'session.started' | 'session.status' | 'session.usage' | 'tool.started' | 'tool.completed' | 'fleet.snapshot' | 'fleet.event' | 'mailbox.snapshot' | 'mailbox.event' | 'worklist.snapshot' | 'git.snapshot' | 'agent.message' | 'agent.status' | 'session.snapshot' | 'session.transcript' | 'session.ended' | 'brain.event' | 'worktree.event';
-interface HqClientHeartbeatPayload {
-    uptimeMs: number;
-    activeSessionId?: string;
-    activeRunId?: string;
-    status: HqProjectStatus;
-    activeSubagents?: number;
-    queuedTasks?: number;
-}
-type HqSessionStatus = 'idle' | 'running' | 'paused' | 'completed' | 'failed';
-interface HqSessionStartedPayload {
-    sessionId: string;
-    provider?: string;
-    model?: string;
-    startedAt: string;
-}
-interface HqSessionStatusPayload {
-    status: HqSessionStatus;
-    phase?: string;
-    message?: string;
-}
-interface HqUsagePayload {
-    inputTokens?: number;
-    outputTokens?: number;
-    totalTokens?: number;
-    costUsd?: number;
-    durationMs?: number;
-}
-interface HqToolStartedPayload {
-    toolName: string;
-    capabilities?: readonly string[];
-    risk?: string;
-    inputSummary?: unknown;
-}
-interface HqToolCompletedPayload {
-    toolName: string;
-    status: 'success' | 'error' | 'timeout' | 'cancelled';
-    durationMs: number;
-    outputSummary?: unknown;
-    errorClass?: string;
-}
-interface HqSubagentSummary {
-    subagentId: string;
-    role?: string;
-    status: 'pending' | 'running' | 'idle' | 'completed' | 'failed' | 'stopped';
-    task?: string;
-    currentTool?: string;
-    runtimeMs?: number;
-    costUsd?: number;
-    lastActivityAt?: string;
-}
-interface HqFleetSnapshotPayload {
-    runId: string;
-    activeSubagents: number;
-    queuedTasks: number;
-    completedTasks: number;
-    failedTasks: number;
-    totalCostUsd?: number;
-    subagents: readonly HqSubagentSummary[];
-}
-/** Payload for `agent.message` events — a subagent's conversational output. */
-interface HqAgentMessagePayload {
-    subagentId: string;
-    agentName: string;
-    content: string;
-    kind: 'text' | 'thinking' | 'tool_use' | 'tool_result' | 'error' | 'status' | 'system';
-    iteration: number;
-    ts: string;
-    toolName?: string;
-    costUsd?: number;
-}
-/** Payload for `agent.status` events — a subagent's lifecycle transition. */
-interface HqAgentStatusPayload {
-    subagentId: string;
-    agentName: string;
-    status: 'spawned' | 'running' | 'completed' | 'failed' | 'timeout' | 'stopped' | 'budget_exhausted';
-    ts: string;
-    summary?: string;
-    task?: string;
-}
-interface HqFleetEventPayload {
-    runId: string;
-    subagentId?: string;
-    event: string;
-    summary?: string;
-    data?: unknown;
-}
-type HqBrainEventKind = 'decision_requested' | 'decision_answered' | 'decision_ask_human' | 'human_answered' | 'decision_denied' | 'intervention';
-interface HqBrainEventPayload {
-    /** Which brain lifecycle event this is (mirrors the EventBus `brain.*` name suffix). */
-    kind: HqBrainEventKind;
-    /** The decision request id, when present (decision_request/answer/deny). */
-    requestId?: string;
-    /** Short human-readable question the brain was asked. */
-    question?: string;
-    /** The source that triggered the decision (e.g. 'autonomy', 'system'). */
-    source?: string;
-    /** Resolved risk tier, when known (e.g. 'low' | 'medium' | 'high'). */
-    risk?: string;
-    /** The chosen decision kind, when answered/denied (e.g. 'answer' | 'ask_human' | 'deny'). */
-    decision?: string;
-    /** Free-text rationale or answer payload, when present. */
-    detail?: string;
-    /** For `intervention`: the watched signal that engaged the brain. */
-    interventionKind?: 'tool_failure_streak' | 'error_storm';
-    /** For `intervention`: true when a steer was actually delivered to the agent. */
-    intervened?: boolean;
-    /** Epoch milliseconds at which the event occurred. */
-    at: number;
-}
-type HqWorktreeEventKind = 'allocated' | 'committed' | 'merged' | 'conflict' | 'released' | 'failed';
-interface HqWorktreeEventPayload {
-    /** Which worktree lifecycle event this is (mirrors `worktree.<kind>`). */
-    kind: HqWorktreeEventKind;
-    handleId: string;
-    ownerId: string;
-    ownerLabel?: string;
-    slug?: string;
-    branch?: string;
-    baseBranch?: string;
-    /** For `committed`: diff stats. */
-    insertions?: number;
-    deletions?: number;
-    files?: number;
-    sha?: string;
-    /** For `merged`: whether the merge was a squash. */
-    squash?: boolean;
-    /** For `conflict`: the list of conflicting files. */
-    conflictFiles?: readonly string[];
-    /** For `released`: whether the worktree was kept (true) or pruned (false). */
-    kept?: boolean;
-    /** For `failed`: the error message. */
-    error?: string;
-}
-type HqSessionLiveStatus = 'active' | 'idle' | 'closing' | 'stale';
-type HqSessionAgentLiveStatus = 'idle' | 'running' | 'streaming' | 'waiting_user' | 'error';
-/** A single live agent inside a session snapshot (mirrors SessionRegistry's AgentEntry). */
-interface HqSessionAgentSummary {
-    id: string;
-    name: string;
-    /** UTC ISO timestamp when this agent/run started, when known. */
-    startedAt?: string;
-    status: HqSessionAgentLiveStatus;
-    currentTool?: string;
-    iterations: number;
-    toolCalls: number;
-    costUsd?: number;
-    tokensIn?: number;
-    tokensOut?: number;
-    ctxPct?: number;
-    model?: string;
-    /** Throttled tail of the response currently streaming, when known. */
-    partialText?: string;
-    lastActivityAt: string;
-}
-/** Payload for `session.snapshot` — one connected terminal's live state. */
-interface HqSessionSnapshotPayload {
-    sessionId: string;
-    clientKind: HqClientKind;
-    machineId: string;
-    hostname?: string;
-    pid?: number;
-    projectId: string;
-    projectName: string;
-    projectRoot: string;
-    gitBranch?: string;
-    status: HqSessionLiveStatus;
-    startedAt: string;
-    lastActivityAt: string;
-    agentCount: number;
-    agents: readonly HqSessionAgentSummary[];
-}
-type HqTranscriptRole = 'user' | 'assistant' | 'thinking' | 'tool' | 'system' | 'error';
-/** One rendered conversation turn. Canonical shape shared by client streaming
- * and server-side JSONL replay so both planes agree. */
-interface HqTranscriptEntry {
-    ts: string;
-    role: HqTranscriptRole;
-    text: string;
-    tool?: string;
-    /** Stringified tool input/arguments, for tool calls (shown alongside the result). */
-    toolInput?: string;
-    durationMs?: number;
-    isError?: boolean;
-    toolUseId?: string;
-    /** Which agent/subagent produced this turn, when attribution is known. */
-    agentId?: string;
-}
-/** Payload for `session.transcript` — an incremental batch of new turns. */
-interface HqTranscriptAppendPayload {
-    sessionId: string;
-    /** Monotonic sequence index of the FIRST entry in this batch within the session. */
-    fromSeq: number;
-    entries: readonly HqTranscriptEntry[];
-}
-/** Payload for `session.ended` — a terminal closed. */
-interface HqSessionEndedPayload {
-    sessionId: string;
-    endedAt: string;
-}
-/** A physical machine, aggregated by HQ from connected clients' machineId. */
-interface HqMachineRecord {
-    machineId: string;
-    hostname?: string;
-    clientCount: number;
-    sessionCount: number;
-    agentCount: number;
-    projectIds: readonly string[];
-    lastActivityAt: string;
-}
-type HqMailboxMessageType = 'note' | 'ask' | 'assign' | 'steer' | 'btw' | 'broadcast' | 'status' | 'result' | 'review' | 'control';
-type HqMailboxPriority = 'low' | 'normal' | 'high';
-type HqMailboxAgentStatus = 'idle' | 'running' | 'streaming' | 'waiting_user' | 'error' | 'offline';
-interface HqMailboxMessageSummary {
-    mailId: string;
-    messageId: string;
-    from: string;
-    to: string;
-    type: HqMailboxMessageType;
-    subject: string;
-    priority: HqMailboxPriority;
-    timestamp: string;
-    replyTo?: string;
-    senderSessionId?: string;
-    completed: boolean;
-    completedBy?: string;
-    completedAt?: string;
-    unreadCount?: number;
-    readCount?: number;
-    hasBody: boolean;
-    bodyPreview?: string;
-    outcomePreview?: string;
-    task?: {
-        taskId?: string;
-        agentRole?: string;
-        agentName?: string;
-        status?: 'pending' | 'in_progress' | 'completed' | 'failed';
-    };
-}
-interface HqMailboxAgentSummary {
-    agentId: string;
-    name: string;
-    role?: string;
-    sessionId: string;
-    status: HqMailboxAgentStatus;
-    currentTool?: string;
-    currentTask?: string;
-    iterations: number;
-    toolCalls: number;
-    lastActivityAt: string;
-    lastSeenAt: string;
-    online: boolean;
-    source?: 'cli' | 'webui' | 'mcp' | 'acp' | 'http';
-}
-interface HqMailboxSnapshotPayload {
-    mailboxId: string;
-    scope: 'project' | 'global';
-    messages: readonly HqMailboxMessageSummary[];
-    agents: readonly HqMailboxAgentSummary[];
-    totals: {
-        messages: number;
-        unread: number;
-        incomplete: number;
-        highPriority: number;
-        onlineAgents: number;
-    };
-}
-interface HqMailboxEventPayload {
-    mailboxId: string;
-    action: 'message.sent' | 'message.read' | 'message.completed' | 'message.updated' | 'agent.registered' | 'agent.heartbeat' | 'agent.offline' | 'agent.deregistered';
-    message?: HqMailboxMessageSummary;
-    agent?: HqMailboxAgentSummary;
-    summary?: string;
-}
-interface HqWorklistSnapshotPayload {
-    todos?: HqWorklistCounts;
-    tasks?: HqWorklistCounts;
-    plans?: HqWorklistCounts;
-    activeItem?: string;
-}
-interface HqWorklistCounts {
-    total: number;
-    pending: number;
-    inProgress: number;
-    completed: number;
-    failed?: number;
-}
-interface HqGitSnapshotPayload {
-    branch?: string;
-    dirtyFiles?: number;
-    stagedFiles?: number;
-    ahead?: number;
-    behind?: number;
-}
-interface HqClientRecord {
-    clientId: string;
-    kind: HqClientKind;
-    machineId: string;
-    hostname?: string;
-    pid?: number;
-    version?: string;
-    connected: boolean;
-    connectedAt?: string;
-    lastSeenAt: string;
-    projectId: string;
-    sessionId?: string;
-    capabilities: readonly HqClientCapability[];
-}
-interface HqProjectRecord {
-    projectId: string;
-    projectName: string;
-    projectRootDisplay: string;
-    machineIds: readonly string[];
-    gitBranch?: string;
-    activeClients: number;
-    activeSessions: number;
-    activeSubagents: number;
-    totalCostUsd: number;
-    lastActivityAt: string;
-    status: HqProjectStatus;
-}
-interface HqSessionSummary {
-    sessionId: string;
-    projectId: string;
-    clientId: string;
-    status: HqSessionStatus;
-    provider?: string;
-    model?: string;
-    startedAt?: string;
-    lastActivityAt: string;
-    costUsd?: number;
-}
-interface HqFleetSummary {
-    runId: string;
-    projectId: string;
-    clientId: string;
-    activeSubagents: number;
-    queuedTasks: number;
-    completedTasks: number;
-    failedTasks: number;
-    totalCostUsd?: number;
-    lastActivityAt: string;
-}
-interface HqMailboxSummary {
-    mailboxId: string;
-    projectId: string;
-    scope: 'project' | 'global';
-    messageCount: number;
-    unreadCount: number;
-    incompleteCount: number;
-    highPriorityCount: number;
-    onlineAgentCount: number;
-    lastActivityAt: string;
-}
-interface HqSnapshot {
-    generatedAt: string;
-    clients: readonly HqClientRecord[];
-    projects: readonly HqProjectRecord[];
-    sessions: readonly HqSessionSummary[];
-    fleets: readonly HqFleetSummary[];
-    mailboxes: readonly HqMailboxSummary[];
-    /** Physical machines aggregated from connected clients (optional, additive). */
-    machines?: readonly HqMachineRecord[];
-    /** Live terminal sessions with their agents — the spine of the fleet tree. */
-    liveSessions?: readonly HqSessionSnapshotPayload[];
-    totals: {
-        activeProjects: number;
-        activeClients: number;
-        activeSessions: number;
-        activeSubagents: number;
-        unreadMailboxMessages: number;
-        incompleteMailboxMessages: number;
-        totalCostUsd: number;
-        /** Distinct physical machines currently connected. */
-        activeMachines?: number;
-        /** Total live agents across all sessions. */
-        activeAgents?: number;
-    };
-}
-interface HqBrowserSnapshotMessage {
-    type: 'hq.snapshot';
-    snapshot: HqSnapshot;
-}
-interface HqBrowserEventMessage<TPayload = unknown> {
-    type: 'hq.event';
-    event: HqEventEnvelope<TPayload>;
-}
-interface HqAlertMessage {
-    type: 'hq.alert';
-    severity: 'info' | 'warn' | 'error';
-    message: string;
-    timestamp: string;
-}
-type HqBrowserMessage = HqBrowserSnapshotMessage | HqBrowserEventMessage | HqAlertMessage;
-interface HqClientHelloMessage {
-    type: 'client.hello';
-    payload: HqClientHelloPayload;
-}
-interface HqClientEventMessage<TPayload = unknown> {
-    type: 'client.event';
-    event: HqEventEnvelope<TPayload>;
-}
-interface HqClientCommandPollMessage {
-    type: 'client.command_poll';
-    clientId: string;
-    projectId: string;
-    afterCommandId?: string;
-    limit?: number;
-}
-interface HqClientCommandAckMessage {
-    type: 'client.command_ack';
-    clientId: string;
-    projectId: string;
-    commandId: string;
-    status: 'accepted' | 'completed' | 'failed' | 'rejected';
-    message?: string;
-}
-interface HqQueuedCommand {
-    commandId: string;
-    type: string;
-    createdAt: string;
-    payload: unknown;
-    requiresAck?: boolean;
-}
-interface HqServerCommandBatchMessage {
-    type: 'hq.command_batch';
-    commands: readonly HqQueuedCommand[];
-}
-type HqClientMessage = HqClientHelloMessage | HqClientEventMessage | HqClientCommandPollMessage | HqClientCommandAckMessage;
-type HqServerMessage = HqServerCommandBatchMessage | HqWelcomePayload;
-/**
- * Discriminated parse result for {@link parseHqFrame}. The `reason` field
- * is only present when `ok` is `false`; consumers should narrow on `ok`
- * before accessing `frame` or `reason`.
- */
-type HqParseResult = {
-    ok: true;
-    frame: HqClientMessage;
-} | {
-    ok: false;
-    reason: 'invalid-json' | 'unknown-type' | 'malformed';
-};
-/**
- * Strictly parse a raw client → server frame into a {@link HqParseResult}.
- *
- * Validates, in order:
- *  1. JSON syntax (`invalid-json` on failure)
- *  2. Top-level object with string `type` discriminator
- *  3. `type` is one of {@link HqClientMessage} union members (`unknown-type`)
- *  4. Per-type field-shape presence checks (`malformed` on failure)
- *
- * On success, `frame` is narrowed to {@link HqClientMessage} and consumers
- * can switch on `frame.type` for type-safe access to per-union-member
- * fields without `as` casts.
- */
-declare function parseHqFrame(raw: string | Buffer): HqParseResult;
-/**
- * Validate the `payload` field of a {@link HqEventEnvelope} for known
- * event types. Returns `{ ok: true, payload }` with a narrowed payload
- * type when the event type has a registered shape guard and the payload
- * matches it; `{ ok: true, payload: unknown }` for event types that the
- * server does not yet validate; or `{ ok: false, reason }` when the
- * payload fails the registered guard.
- *
- * Use this after {@link parseHqFrame} has produced a valid frame, when
- * the frame is `client.event` and the server is about to consume the
- * event payload.
- */
-type HqEventPayloadResult<T> = {
-    ok: true;
-    payload: T;
-} | {
-    ok: false;
-    reason: 'unknown-event-type' | 'malformed-payload';
-};
-declare function parseHqEventPayload(eventType: string, payload: unknown): HqEventPayloadResult<unknown>;
-declare function createHqEventEnvelope<TPayload>(input: {
-    id: string;
-    type: HqEventType | (string & {});
-    timestamp: string;
-    clientId: string;
-    projectId: string;
-    seq: number;
-    payload: TPayload;
-    sessionId?: string;
-    runId?: string;
-}): HqEventEnvelope<TPayload>;
-
-interface HqMailboxMappingOptions {
-    mailboxId: string;
-    scope?: 'project' | 'global';
-    limit?: number;
-    previewLength?: number;
-    redactionPolicy?: Partial<HqRedactionPolicy>;
-}
-interface HqMailboxSnapshotOptions extends HqMailboxMappingOptions {
-    includeCompleted?: boolean;
-}
-type HqMailboxEventAction = HqMailboxEventPayload['action'];
-declare function mapMailboxMessageToHqSummary(message: MailboxMessage, options?: Pick<HqMailboxMappingOptions, 'previewLength' | 'redactionPolicy'>): HqMailboxMessageSummary;
-declare function mapMailboxAgentToHqSummary(agent: MailboxAgentStatus): HqMailboxAgentSummary;
-declare function createMailboxSnapshotPayload(messages: readonly MailboxMessage[], agents: readonly MailboxAgentStatus[], options: HqMailboxSnapshotOptions): HqMailboxSnapshotPayload;
-declare function createMailboxSnapshotPayloadFromMailbox(mailbox: Pick<Mailbox, 'query' | 'getAgentStatuses'>, options: HqMailboxSnapshotOptions): Promise<HqMailboxSnapshotPayload>;
-declare function createMailboxEventPayload(input: {
-    mailboxId: string;
-    action: HqMailboxEventAction;
-    message?: MailboxMessage;
-    agent?: MailboxAgentStatus;
-    summary?: string;
-    previewLength?: number;
-    redactionPolicy?: Partial<HqRedactionPolicy>;
-}): HqMailboxEventPayload;
-
-interface HqSocketLike {
-    readyState: number;
-    send(data: string): void;
-    close(code?: number, reason?: string): void;
-    addEventListener?(type: 'open' | 'close' | 'error' | 'message', listener: (event: unknown) => void): void;
-    removeEventListener?(type: 'open' | 'close' | 'error' | 'message', listener: (event: unknown) => void): void;
-    on?(type: 'open' | 'close' | 'error' | 'message', listener: (event: unknown) => void): void;
-    off?(type: 'open' | 'close' | 'error' | 'message', listener: (event: unknown) => void): void;
-}
-type HqSocketFactory = (url: string, init: {
-    token?: string;
-}) => HqSocketLike;
-interface HqPublisherCommandResult {
-    commandId: string;
-    status: 'accepted' | 'completed' | 'failed' | 'rejected';
-    message?: string;
-}
-type HqPublisherCommandHandler = (command: HqQueuedCommand) => void | HqPublisherCommandResult | Promise<void | HqPublisherCommandResult>;
-interface HqPublisherOptions {
-    url: string;
-    token?: string;
-    client: HqClientIdentity;
-    project: HqProjectIdentity;
-    capabilities?: readonly HqClientCapability[];
-    socketFactory?: HqSocketFactory;
-    now?: () => string;
-    idFactory?: () => string;
-    reconnect?: boolean;
-    reconnectBaseMs?: number;
-    reconnectMaxMs?: number;
-    maxQueuedMessages?: number;
-    redactionPolicy?: Partial<HqRedactionPolicy>;
-    commandPollIntervalMs?: number;
-    commandPollLimit?: number;
-    onCommand?: HqPublisherCommandHandler;
-    /**
-     * Local auto-discovery hook: re-resolve the HQ endpoint before EVERY
-     * connect attempt (e.g. by reading `<hq dataDir>/runtime.json`). Returning
-     * `undefined` means no HQ is currently discoverable — the publisher stays
-     * dormant (events keep queueing, bounded) and re-checks every
-     * {@link HqPublisherOptions.discoveryPollMs}. Because the endpoint is
-     * re-resolved per attempt, an HQ started AFTER this client — or restarted
-     * on a different port, or one that minted its first client token on boot —
-     * is picked up automatically.
-     */
-    resolveEndpoint?: () => {
-        url: string;
-        token?: string | undefined;
-    } | undefined;
-    /** Dormant re-check interval while `resolveEndpoint` yields nothing. Default 5s. */
-    discoveryPollMs?: number;
-    /**
-     * Diagnostic sink for the one-time consecutive-connect-failure warning.
-     * The publisher is otherwise deliberately silent (dormant queueing), which
-     * made auth failures invisible: a token the server rejects — e.g. a wrong
-     * `WRONGSTACK_HQ_TOKEN` against a remote HQ — looked exactly like "HQ not
-     * running". Defaults to a single structured `console.warn` line.
-     */
-    warn?: (message: string) => void;
-}
-interface HqPublishEventOptions {
-    type: HqEventType | (string & {});
-    payload: unknown;
-    sessionId?: string;
-    runId?: string;
-    timestamp?: string;
-}
-declare class HqPublisher {
-    private readonly options;
-    private readonly socketFactory;
-    private readonly now;
-    private readonly idFactory;
-    private readonly capabilities;
-    private readonly reconnect;
-    private readonly reconnectBaseMs;
-    private readonly reconnectMaxMs;
-    private readonly maxQueuedMessages;
-    private socket;
-    private seq;
-    private queue;
-    private stopped;
-    private reconnectAttempt;
-    private connectWarningEmitted;
-    private lastAttempt;
-    private reconnectTimer;
-    private commandPollTimer;
-    private lastCommandId;
-    constructor(options: HqPublisherOptions);
-    connect(): void;
-    close(): void;
-    publishEvent<TPayload>(options: HqPublishEventOptions & {
-        payload: TPayload;
-    }): HqEventEnvelope<TPayload>;
-    publishMailboxSnapshot(mailbox: Pick<Mailbox, 'query' | 'getAgentStatuses'>, options: Omit<HqMailboxSnapshotOptions, 'redactionPolicy'> & {
-        sessionId?: string;
-        timestamp?: string;
-    }): Promise<HqEventEnvelope<HqMailboxSnapshotPayload>>;
-    publishMailboxEvent(input: {
-        mailboxId: string;
-        action: HqMailboxEventAction;
-        message?: MailboxMessage;
-        agent?: MailboxAgentStatus;
-        summary?: string;
-        previewLength?: number;
-        sessionId?: string;
-        timestamp?: string;
-    }): HqEventEnvelope<HqMailboxEventPayload>;
-    /** The client identity this publisher announced (clientId, kind, machineId, …). */
-    get identity(): HqClientIdentity;
-    /** The project identity this publisher is bound to. */
-    get project(): HqProjectIdentity;
-    /** Publish a live session/terminal snapshot (state + agents). */
-    publishSessionSnapshot(payload: HqSessionSnapshotPayload, opts?: {
-        timestamp?: string;
-    }): HqEventEnvelope<HqSessionSnapshotPayload>;
-    /** Publish an incremental batch of transcript turns for a session. */
-    publishTranscriptAppend(payload: HqTranscriptAppendPayload, opts?: {
-        timestamp?: string;
-    }): HqEventEnvelope<HqTranscriptAppendPayload>;
-    /** Mark a session/terminal as ended. */
-    publishSessionEnded(payload: HqSessionEndedPayload, opts?: {
-        timestamp?: string;
-    }): HqEventEnvelope<HqSessionEndedPayload>;
-    /** Publish a fleet (multi-agent coordinator) snapshot. */
-    publishFleetSnapshot(payload: HqFleetSnapshotPayload, opts?: {
-        sessionId?: string;
-        timestamp?: string;
-    }): HqEventEnvelope<HqFleetSnapshotPayload>;
-    pollCommands(): void;
-    ackCommand(result: HqPublisherCommandResult): void;
-    private createHelloFrame;
-    private sendHelloNow;
-    private sendFrame;
-    private enqueue;
-    /** Batch-dequeue up to 50 frames at a time, yielding to the microtask
-     *  queue between batches so we don't starve the event loop on reconnect. */
-    private flushQueue;
-    private startCommandPolling;
-    private stopCommandPolling;
-    private handleServerMessage;
-    private parseServerMessage;
-    private extractMessageData;
-    private handleCommandBatch;
-    private scheduleReconnect;
-    private emitConnectWarning;
-    /**
-     * Dormant re-check while no HQ endpoint is discoverable. Uses a FIXED
-     * interval (not the exponential reconnect backoff): the check is a cheap
-     * local file read, and backing off would delay attaching to an HQ the
-     * user just started — the whole point of auto-discovery.
-     */
-    private scheduleDiscoveryPoll;
-}
-
-/**
- * GlobalMailbox — project-level inter-agent mailbox with cross-session support.
- *
- * Stores messages at `~/.wrongstack/projects/<slug>/_mailbox.jsonl` so all
- * sessions (terminals, WebUIs) working on the same project share one inbox.
- *
- * Features:
- * - Agent registration + heartbeat (agents go stale after 60s without heartbeat)
- * - Per-recipient read receipts (readBy[agentId] = ISO8601)
- * - Atomic file-locking for concurrent multi-process writes
- * - Unread count for new-mail notifications
- * - Online agent list
- *
- * @module GlobalMailbox
- */
-
-type HqPublisherRef = HqPublisher | (() => HqPublisher | undefined);
-/**
- * Derive the project-level mailbox directory path.
- *
- * Delegates to the CANONICAL `projectSlug()` from wstack-paths so every
- * surface (CLI, TUI, WebUI, mailbox tool, loop checker) lands in the exact
- * same `~/.wrongstack/projects/<slug>/` directory. A previous inline copy
- * skipped the leading/trailing-hyphen strip, which silently split agents
- * working on projects with non-alphanumeric name edges into TWO mailboxes.
- *
- * @param projectRoot  — absolute path to the project root
- * @param globalRoot   — `~/.wrongstack` (or custom global root)
- */
-declare function resolveProjectDir(projectRoot: string, globalRoot: string): string;
-declare class GlobalMailbox implements Mailbox {
-    /** Path to the JSONL message file. */
-    readonly messagePath: string;
-    /** Path to the JSON agent registry file. */
-    readonly registryPath: string;
-    /** Path to the JSON client registry file. */
-    readonly clientRegistryPath: string;
-    /** Optional event bus for emitting agent registration/heartbeat events. */
-    private readonly _events?;
-    /** Optional HQ publisher for cross-project command-center telemetry. */
-    private readonly _hqPublisher?;
-    /**
-     * Local cache of the agent registry to avoid re-reading on every call.
-     * Time-bounded: the registry file is shared ACROSS PROCESSES (that's the
-     * whole point of GlobalMailbox), so a cache served forever would never see
-     * agents registered by other sessions. Writers always bypass it.
-     */
-    private _registryCache;
-    /** When the registry cache was last refreshed from disk (epoch ms). */
-    private _registryCacheAt;
-    /**
-     * Local cache of the client registry to avoid re-reading on every call.
-     * Same reasoning as agent registry cache.
-     */
-    private _clientRegistryCache;
-    /** When the client registry cache was last refreshed from disk (epoch ms). */
-    private _clientRegistryCacheAt;
-    /** Last time each local agent sent a heartbeat (throttle). */
-    private _lastHeartbeat;
-    /** Last time each local client sent a heartbeat (throttle). */
-    private _lastClientHeartbeat;
-    /**
-     * In-memory mirror of the JSONL message file. The mailbox is shared
-     * ACROSS PROCESSES, so reads cannot trust the cache blindly — we pair it
-     * with an mtime check. The file lock serializes every write, so a
-     * changed mtimeMs is a definitive signal that another process (or this
-     * one) wrote; an unchanged mtimeMs guarantees no write happened and the
-     * cache is current. This collapses the per-iteration `query()` cost from
-     * O(file_size) disk + parse to O(messages) in memory.
-     */
-    private _messageCache;
-    /** mtimeMs of the file when `_messageCache` was populated. */
-    private _messageCacheMtime;
-    /** Size of the file when `_messageCache` was populated (extra guard). */
-    private _messageCacheSize;
-    /**
-     * Serializes reads of the message file so overlapping concurrent
-     * `_readMessagesCached()` calls don't both enter the incremental "file
-     * only grew" branch against the same stale `_messageCacheSize` and
-     * each push the same tail bytes onto the cache (duplicating every
-     * appended message). The chain runs each read to completion before
-     * the next starts, in issue order — readers are read-only and never
-     * conflict with each other on content, only on the cache mutation
-     * that follows the read. Pattern mirrors `DefaultMemoryStore.runSerialized`.
-     */
-    private _readChain;
-    /**
-     * @param projectDir — `~/.wrongstack/projects/<slug>/`
-     * @param events — optional EventBus for real-time TUI/WebUI notifications
-     * @param hqPublisher — optional HQ publisher, or getter, for cross-project telemetry
-     */
-    constructor(projectDir: string, events?: EventBus, hqPublisher?: HqPublisherRef);
-    private get hqMailboxId();
-    private get hqPublisher();
-    private publishHqMailboxEvent;
-    private publishHqMailboxSnapshot;
-    send(input: MailboxSendInput): Promise<MailboxMessage>;
-    query(q: MailboxQuery): Promise<MailboxMessage[]>;
-    ack(input: MailboxAckInput): Promise<MailboxMessage | null>;
-    ackMany(input: MailboxAckBatchInput): Promise<MailboxMessage[]>;
-    unreadCount(forAgentId: string): Promise<number>;
-    softDelete(mailId: string, by: string): Promise<MailboxMessage | null>;
-    restore(mailId: string): Promise<MailboxMessage | null>;
-    registerAgent(input: AgentRegistrationInput): Promise<void>;
-    deregisterAgent(agentId: string): Promise<void>;
-    heartbeat(input: AgentHeartbeatInput): Promise<void>;
-    getAgentStatuses(): Promise<MailboxAgentStatus[]>;
-    getOnlineAgents(): Promise<MailboxAgentStatus[]>;
-    registerClient(input: ClientRegistrationInput): Promise<void>;
-    clientHeartbeat(input: ClientHeartbeatInput): Promise<void>;
-    getClientStatuses(): Promise<ClientStatus[]>;
-    close(): Promise<void>;
-    clearAll(): Promise<void>;
-    purgeStale(opts?: PurgeOptions): Promise<PurgeResult>;
-    /**
-     * Read all messages from the JSONL file. Always reads + parses the file.
-     * Callers that can tolerate a stale-by-mtime view should use
-     * {@link _readMessagesCached}; writers that need the post-lock truth
-     * should call this directly (it's what {@link _readMessagesFresh} aliases).
-     */
-    private _readMessages;
-    /**
-     * Read only newly-appended bytes from the file and append them to the
-     * in-memory cache. This avoids re-reading and re-parsing the entire file
-     * when another process appended messages since our last read.
-     *
-     * Only safe when the file grew in size (messages are append-only). When
-     * the file was rewritten (ack/purge changed existing content), callers
-     * must fall back to {@link _readMessages}.
-     *
-     * @returns The (now up-to-date) message cache.
-     */
-    private _readNewMessagesOnly;
-    /** Parse a JSONL string into MailboxMessage[], including migration. */
-    private _parseLines;
-    /**
-     * Read messages, then adopt the result as the in-memory cache. Use this
-     * from writers that just took the file lock — the read reflects the
-     * authoritative post-lock state and should be served to subsequent
-     * queries without re-reading.
-     *
-     * The mtime/size are captured from the stat at read time so the cache
-     * trackers match exactly what was parsed. Writers that subsequently
-     * rewrite the file MUST re-stat after the write and re-promote with the
-     * post-write values (see ackMany / softDelete / restore / purgeStale /
-     * clearAll) — otherwise a concurrent reader misclassifies the rewrite
-     * as a "file only grew" append and corrupts the cache.
-     */
-    private _readMessagesFresh;
-    /**
-     * Stat the message file, returning its mtimeMs and size. Returns
-     * `-1/-1` when the file does not yet exist (ENOENT) so callers can
-     * still promote a cache snapshot — the next read will re-stat and
-     * fall through to a full re-read. Call from inside the file lock so
-     * the result reflects the post-write on-disk state, not a later
-     * intermediate state from another process.
-     */
-    private _statMessageFile;
-    /**
-     * Read messages, consulting the mtime-bounded in-memory cache first,
-     * serialized so concurrent callers don't both mutate the cache.
-     *
-     * The mailbox file is shared across processes; every `send`/`ack`/
-     * `clearAll`/`purgeStale` takes the file lock, so writes are serialized
-     * and a changed mtimeMs is a definitive freshness signal. When the
-     * stat matches the cached mtime+size we return the cached array — no
-     * file read and no JSON.parse — collapsing the per-iteration query
-     * cost on the mailbox-loop hot path.
-     *
-     * When the file only grew (new messages appended by another process),
-     * we read and parse just the tail bytes instead of the entire file.
-     * This avoids re-parsing the full 10K-message history on every check.
-     *
-     * SERIALIZATION: the actual work is chained onto `_readChain` so two
-     * overlapping calls can't both pass the `st.size > _messageCacheSize`
-     * incremental check against the same stale tracker and each push the
-     * same tail bytes onto the cache (duplicating every appended message).
-     * Readers don't conflict on file content — only on the cache mutation
-     * that follows the read — so we run them one at a time in issue order.
-     * Errors in the chain are swallowed so a failed read never poisons
-     * subsequent reads; each caller observes and re-throws its own error.
-     */
-    private _readMessagesCached;
-    /**
-     * The un-serialized body of {@link _readMessagesCached}. Reads the
-     * message file with the mtime-bounded cache + incremental-tail
-     * optimization. Must only be called from `_readMessagesCached` so the
-     * cache mutations here don't race a sibling read.
-     */
-    private _readMessagesCachedWork;
-    /**
-     * Replace the in-memory cache, setting the mtime/size trackers
-     * synchronously in the same step. Callers MUST pass the stat of the
-     * on-disk file state that produced `messages`.
-     *
-     * Why both are required (not fire-and-forget): `_readMessagesCached()`
-     * validates the cache against a fresh stat using these two trackers.
-     * If the cache array is updated but the trackers lag behind (e.g. via
-     * a deferred `stat().then(...)`), a concurrent reader landing in that
-     * window sees a mismatched mtime and falls into the incremental
-     * "file only grew" branch — parsing rewritten bytes as an appended
-     * tail and corrupting the cache with duplicates/garbage. So both
-     * values are captured under the file lock and applied synchronously
-     * here, matching the fix already shipped in DefaultMailbox.
-     */
-    private _setMessageCache;
-    /**
-     * Append a single just-sent message to the in-memory cache without
-     * re-reading the file. The caller must hold the file lock (or have
-     * just released it after a successful append) and MUST pass the
-     * post-append stat so the mtime/size trackers advance in lock-step
-     * with the pushed content.
-     *
-     * Why the stat is required here: without it, `_messageCacheSize`
-     * stays at the pre-append value. A concurrent `_readMessagesCached()`
-     * then sees `st.size > _messageCacheSize` (the file did grow), takes
-     * the incremental branch, and re-reads the just-appended tail —
-     * pushing the same message onto the cache a second time. Setting the
-     * trackers here closes that window for the local-process append path.
-     */
-    private _pushToCache;
-    private _ensureRegistry;
-    private _readRegistry;
-    private _pruneStaleInPlace;
-    private _writeRegistry;
-    private _ensureClientRegistry;
-    private _readClientRegistry;
-    private _pruneStaleClientsInPlace;
-    private _writeClientRegistry;
-}
-
-export { type HqRedactionPolicy as $, type HqMachineRecord as A, type HqMailboxAgentStatus as B, type HqMailboxAgentSummary as C, DEFAULT_HQ_REDACTION_POLICY as D, type HqMailboxEventAction as E, type HqMailboxEventPayload as F, GlobalMailbox as G, HQ_PROTOCOL_VERSION as H, type HqMailboxMappingOptions as I, type HqMailboxMessageSummary as J, type HqMailboxMessageType as K, type HqMailboxPriority as L, type HqMailboxSnapshotOptions as M, type HqMailboxSnapshotPayload as N, type HqMailboxSummary as O, type HqParseResult as P, type HqPathPolicy as Q, type HqProjectIdentity as R, type HqProjectRecord as S, type HqProjectStatus as T, type HqProtocolVersion as U, type HqPublishEventOptions as V, HqPublisher as W, type HqPublisherCommandHandler as X, type HqPublisherCommandResult as Y, type HqPublisherOptions as Z, type HqQueuedCommand as _, type HqAgentMessagePayload as a, type HqServerCommandBatchMessage as a0, type HqServerMessage as a1, type HqSessionAgentLiveStatus as a2, type HqSessionAgentSummary as a3, type HqSessionEndedPayload as a4, type HqSessionLiveStatus as a5, type HqSessionSnapshotPayload as a6, type HqSessionStartedPayload as a7, type HqSessionStatus as a8, type HqSessionStatusPayload as a9, resolveProjectDir as aA, type HqSessionSummary as aa, type HqSnapshot as ab, type HqSocketFactory as ac, type HqSocketLike as ad, type HqSubagentSummary as ae, type HqToolArgsPolicy as af, type HqToolCompletedPayload as ag, type HqToolStartedPayload as ah, type HqTranscriptAppendPayload as ai, type HqTranscriptEntry as aj, type HqTranscriptRole as ak, type HqUsagePayload as al, type HqWelcomePayload as am, type HqWorklistCounts as an, type HqWorklistSnapshotPayload as ao, type HqWorkspaceKind as ap, type HqWorktreeEventKind as aq, type HqWorktreeEventPayload as ar, createHqEventEnvelope as as, createMailboxEventPayload as at, createMailboxSnapshotPayload as au, createMailboxSnapshotPayloadFromMailbox as av, mapMailboxAgentToHqSummary as aw, mapMailboxMessageToHqSummary as ax, parseHqEventPayload as ay, parseHqFrame as az, type HqAgentStatusPayload as b, type HqAlertMessage as c, type HqBrainEventKind as d, type HqBrainEventPayload as e, type HqBrowserEventMessage as f, type HqBrowserMessage as g, type HqBrowserSnapshotMessage as h, type HqClientCapability as i, type HqClientCommandAckMessage as j, type HqClientCommandPollMessage as k, type HqClientEventMessage as l, type HqClientHeartbeatPayload as m, type HqClientHelloMessage as n, type HqClientHelloPayload as o, type HqClientIdentity as p, type HqClientKind as q, type HqClientMessage as r, type HqClientRecord as s, type HqEventEnvelope as t, type HqEventPayloadResult as u, type HqEventType as v, type HqFleetEventPayload as w, type HqFleetSnapshotPayload as x, type HqFleetSummary as y, type HqGitSnapshotPayload as z };