@wrongstack/core 0.286.0 → 0.287.0

package/dist/hq/protocol/session.d.ts

@@ -0,0 +1,153 @@
+import type { HqClientKind, HqClientRecord } from './client.js';
+import type { HqMachineRecord } from './core.js';
+import type { HqFleetSummary } from './fleet.js';
+import type { HqMailboxSummary } from './mailbox.js';
+import type { HqMcpServerHealth } from './mcp.js';
+import type { HqProjectRecord } from './project.js';
+export type HqSessionStatus = 'idle' | 'running' | 'paused' | 'completed' | 'failed';
+export interface HqSessionStartedPayload {
+    sessionId: string;
+    provider?: string;
+    model?: string;
+    startedAt: string;
+}
+export interface HqSessionStatusPayload {
+    status: HqSessionStatus;
+    phase?: string;
+    message?: string;
+}
+export interface HqSubagentSummary {
+    subagentId: string;
+    role?: string;
+    status: 'pending' | 'running' | 'idle' | 'completed' | 'failed' | 'stopped';
+    task?: string;
+    currentTool?: string;
+    runtimeMs?: number;
+    costUsd?: number;
+    lastActivityAt?: string;
+}
+/** Payload for `agent.message` events — a subagent's conversational output. */
+export 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. */
+export interface HqAgentStatusPayload {
+    subagentId: string;
+    agentName: string;
+    status: 'spawned' | 'running' | 'completed' | 'failed' | 'timeout' | 'stopped' | 'budget_exhausted';
+    ts: string;
+    summary?: string;
+    task?: string;
+}
+export type HqSessionLiveStatus = 'active' | 'idle' | 'closing' | 'stale';
+export type HqSessionAgentLiveStatus = 'idle' | 'running' | 'streaming' | 'waiting_user' | 'error';
+/** A single live agent inside a session snapshot (mirrors SessionRegistry's AgentEntry). */
+export 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. */
+export 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[];
+}
+export 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. */
+export 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. */
+export 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. */
+export interface HqSessionEndedPayload {
+    sessionId: string;
+    endedAt: string;
+}
+export interface HqSessionSummary {
+    sessionId: string;
+    projectId: string;
+    clientId: string;
+    status: HqSessionStatus;
+    provider?: string;
+    model?: string;
+    startedAt?: string;
+    lastActivityAt: string;
+    costUsd?: number;
+}
+export 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[];
+    /** Latest operational health for each MCP server reported by any connected client. */
+    mcpServers?: readonly HqMcpServerHealth[];
+    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;
+    };
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/hq/protocol/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/hq/protocol/session.ts"],"names":[],"mappings":"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"}

package/dist/hq/protocol/tool.d.ts

@@ -0,0 +1,31 @@
+import type { HqPathPolicy } from './project.js';
+export type HqToolArgsPolicy = 'none' | 'summary' | 'redacted' | 'full';
+export interface HqRedactionPolicy {
+    rawContent: boolean;
+    toolArgs: HqToolArgsPolicy;
+    paths: HqPathPolicy;
+}
+export declare const DEFAULT_HQ_REDACTION_POLICY: HqRedactionPolicy;
+/**
+ * Per-string cap applied when redacting chat-transcript events
+ * (`session.transcript` / `agent.message`). The generic 500-char summary cap
+ * is right for telemetry rollups but would mangle full chat-history rendering
+ * in the HQ Console once `rawContent` is enabled — messages and tool outputs
+ * routinely exceed it. Applied publisher-side AND at the server's re-redaction
+ * so both hops agree.
+ */
+export declare const HQ_TRANSCRIPT_TEXT_CAP = 16000;
+export interface HqToolStartedPayload {
+    toolName: string;
+    capabilities?: readonly string[];
+    risk?: string;
+    inputSummary?: unknown;
+}
+export interface HqToolCompletedPayload {
+    toolName: string;
+    status: 'success' | 'error' | 'timeout' | 'cancelled';
+    durationMs: number;
+    outputSummary?: unknown;
+    errorClass?: string;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/hq/protocol/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/hq/protocol/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,eAAO,MAAM,2BAA2B,EAAE,iBAIzC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}