@wrongstack/core 0.270.0 → 0.272.0

package/dist/hq/index.d.ts

@@ -1,9 +1,9 @@
-import { W as HqRedactionPolicy, p as HqEventEnvelope, R as HqPublisher, l as HqClientIdentity, a2 as HqSocketFactory, G as GlobalMailbox } from '../global-mailbox-Bvrz1P3f.js';
-export { D as DEFAULT_HQ_REDACTION_POLICY, H as HQ_PROTOCOL_VERSION, a as HqAlertMessage, b as HqBrowserEventMessage, c as HqBrowserMessage, d as HqBrowserSnapshotMessage, e as HqClientCapability, f as HqClientCommandAckMessage, g as HqClientCommandPollMessage, h as HqClientEventMessage, i as HqClientHeartbeatPayload, j as HqClientHelloMessage, k as HqClientHelloPayload, m as HqClientKind, n as HqClientMessage, o as HqClientRecord, q as HqEventPayloadResult, r as HqEventType, s as HqFleetEventPayload, t as HqFleetSnapshotPayload, u as HqFleetSummary, v as HqGitSnapshotPayload, w as HqMailboxAgentStatus, x as HqMailboxAgentSummary, y as HqMailboxEventAction, z as HqMailboxEventPayload, A as HqMailboxMappingOptions, B as HqMailboxMessageSummary, C as HqMailboxMessageType, E as HqMailboxPriority, F as HqMailboxSnapshotOptions, I as HqMailboxSnapshotPayload, J as HqMailboxSummary, K as HqParseResult, L as HqPathPolicy, M as HqProjectIdentity, N as HqProjectRecord, O as HqProjectStatus, P as HqProtocolVersion, Q as HqPublishEventOptions, S as HqPublisherCommandHandler, T as HqPublisherCommandResult, U as HqPublisherOptions, V as HqQueuedCommand, X as HqServerCommandBatchMessage, Y as HqServerMessage, Z as HqSessionStartedPayload, _ as HqSessionStatus, $ as HqSessionStatusPayload, a0 as HqSessionSummary, a1 as HqSnapshot, a3 as HqSocketLike, a4 as HqSubagentSummary, a5 as HqToolArgsPolicy, a6 as HqToolCompletedPayload, a7 as HqToolStartedPayload, a8 as HqUsagePayload, a9 as HqWelcomePayload, aa as HqWorklistCounts, ab as HqWorklistSnapshotPayload, ac as HqWorkspaceKind, ad as createHqEventEnvelope, ae as createMailboxEventPayload, af as createMailboxSnapshotPayload, ag as createMailboxSnapshotPayloadFromMailbox, ah as mapMailboxAgentToHqSummary, ai as mapMailboxMessageToHqSummary, aj as parseHqEventPayload, ak as parseHqFrame } from '../global-mailbox-Bvrz1P3f.js';
-import { E as EventBus } from '../brain-BYcK__Ym.js';
-import { x as HqClientConfig } from '../config-C_ae2k86.js';
+import { Z as HqRedactionPolicy, r as HqEventEnvelope, U as HqPublisher, n as HqClientIdentity, aa as HqSocketFactory, G as GlobalMailbox, ah as HqTranscriptEntry } from '../global-mailbox-CQj_C9Dp.js';
+export { D as DEFAULT_HQ_REDACTION_POLICY, H as HQ_PROTOCOL_VERSION, a as HqAgentMessagePayload, b as HqAgentStatusPayload, c as HqAlertMessage, d as HqBrowserEventMessage, e as HqBrowserMessage, f as HqBrowserSnapshotMessage, g as HqClientCapability, h as HqClientCommandAckMessage, i as HqClientCommandPollMessage, j as HqClientEventMessage, k as HqClientHeartbeatPayload, l as HqClientHelloMessage, m as HqClientHelloPayload, o as HqClientKind, p as HqClientMessage, q as HqClientRecord, s as HqEventPayloadResult, t as HqEventType, u as HqFleetEventPayload, v as HqFleetSnapshotPayload, w as HqFleetSummary, x as HqGitSnapshotPayload, y as HqMachineRecord, z as HqMailboxAgentStatus, A as HqMailboxAgentSummary, B as HqMailboxEventAction, C as HqMailboxEventPayload, E as HqMailboxMappingOptions, F as HqMailboxMessageSummary, I as HqMailboxMessageType, J as HqMailboxPriority, K as HqMailboxSnapshotOptions, L as HqMailboxSnapshotPayload, M as HqMailboxSummary, N as HqParseResult, O as HqPathPolicy, P as HqProjectIdentity, Q as HqProjectRecord, R as HqProjectStatus, S as HqProtocolVersion, T as HqPublishEventOptions, V as HqPublisherCommandHandler, W as HqPublisherCommandResult, X as HqPublisherOptions, Y as HqQueuedCommand, _ as HqServerCommandBatchMessage, $ as HqServerMessage, a0 as HqSessionAgentLiveStatus, a1 as HqSessionAgentSummary, a2 as HqSessionEndedPayload, a3 as HqSessionLiveStatus, a4 as HqSessionSnapshotPayload, a5 as HqSessionStartedPayload, a6 as HqSessionStatus, a7 as HqSessionStatusPayload, a8 as HqSessionSummary, a9 as HqSnapshot, ab as HqSocketLike, ac as HqSubagentSummary, ad as HqToolArgsPolicy, ae as HqToolCompletedPayload, af as HqToolStartedPayload, ag as HqTranscriptAppendPayload, ai as HqTranscriptRole, aj as HqUsagePayload, ak as HqWelcomePayload, al as HqWorklistCounts, am as HqWorklistSnapshotPayload, an as HqWorkspaceKind, ao as createHqEventEnvelope, ap as createMailboxEventPayload, aq as createMailboxSnapshotPayload, ar as createMailboxSnapshotPayloadFromMailbox, as as mapMailboxAgentToHqSummary, at as mapMailboxMessageToHqSummary, au as parseHqEventPayload, av as parseHqFrame } from '../global-mailbox-CQj_C9Dp.js';
+import { E as EventBus } from '../brain-CdbbJWi3.js';
+import { x as HqClientConfig } from '../config-D2DGoGSQ.js';
 import '../mailbox-types-Ct2hJq0P.js';
-import '../context-Dp87Bcaq.js';
+import '../context-Dw55zZ_Q.js';
 
 interface HqRedactOptions {
     policy?: Partial<HqRedactionPolicy>;
@@ -201,4 +201,91 @@ declare function watchHqAuthFile(dataDir: string, onChange: (file: HqAuthFile) =
     close: () => void;
 };
 
-export { type CreateGlobalMailboxOptions, type CreateHqPublisherOptions, type EnsureHqFirstRunAuthResult, HQ_AUTH_FILE_VERSION, type HqAuthFile, type HqBrowserToken, HqClientIdentity, HqEventEnvelope, HqPublisher, type HqPublisherEnvConfig, type HqRedactOptions, HqRedactionPolicy, type HqRedactionResult, type HqRuntimeFile, HqSocketFactory, type HqToken, createGlobalMailbox, createHqPublisherFromEnv, defaultHqDataDir, emptyHqAuthFile, ensureHqFirstRunAuthFile, hqAuthFilePath, hqRuntimeFilePath, mintHqBrowserToken, mintHqToken, mutateHqAuthFile, readHqAuthFile, readHqRuntimeFileSync, redactHqEvent, redactHqValue, resolveHqConfig, resolveHqConfigFromEnv, resolveHqDataDir, scrubAndTruncateHqPreview, summarizeHqToolArgs, watchHqAuthFile, writeHqAuthFile, writeHqRuntimeFile };
+/**
+ * AgentMonitorEventBridge — forwards local agent timeline and status events
+ * to the HQ publisher as structured HQ event envelopes, so the HQ browser
+ * dashboard sees real-time agent conversation streams.
+ */
+
+type HqAgentEventPublisher = (envelope: HqEventEnvelope) => void;
+interface AgentMonitorEventBridgeOptions {
+    /** Local EventBus emitting agent.timeline.* and agent.status_changed events. */
+    events: EventBus;
+    /** Client/project identifiers for HQ envelope authorship. */
+    clientId: string;
+    projectId: string;
+    /**
+     * Publish callback — called with each HQ event envelope. Wire this to
+     * your HQ publisher's `send()` or queue method when connected.
+     * When null (no HQ connection), events are silently dropped.
+     */
+    publish?: HqAgentEventPublisher | undefined;
+}
+/**
+ * Start forwarding agent monitoring events to HQ. Returns a disposer that
+ * unsubscribes all listeners — call on shutdown.
+ */
+declare function startAgentMonitorEventBridge(opts: AgentMonitorEventBridgeOptions): () => void;
+
+interface SessionTelemetryBridgeOptions {
+    publisher: HqPublisher;
+    /** Local bus carrying `session.agents_updated`. When omitted, snapshots
+     * still publish (with empty/last-known agents) and the transcript still
+     * streams from disk. */
+    events?: EventBus | undefined;
+    sessionId: string;
+    projectRoot: string;
+    projectName?: string | undefined;
+    /** Override the global root used to resolve the session JSONL path. */
+    globalRoot?: string | undefined;
+    gitBranch?: string | undefined;
+    startedAt?: string | undefined;
+    /** Snapshot republish interval (also refreshes lastActivity). Default 2500ms. */
+    snapshotIntervalMs?: number | undefined;
+    /** Transcript tail poll interval. Default 1200ms. */
+    transcriptIntervalMs?: number | undefined;
+    now?: (() => string) | undefined;
+}
+/**
+ * Start streaming this surface's session telemetry to HQ. Returns a disposer
+ * that stops both streams and publishes a final `session.ended`.
+ */
+declare function startSessionTelemetryBridge(opts: SessionTelemetryBridgeOptions): () => void;
+
+/**
+ * Transcript mapper — converts raw session JSONL events into the canonical
+ * {@link HqTranscriptEntry} shape used by HQ for full chat-history rendering.
+ *
+ * On-disk reality (see `types/session.ts` + `core/agent-tools.ts`):
+ *   - A tool CALL (with its arguments) is NOT a standalone event — it is a
+ *     `tool_use` content block inside the assistant's `llm_response`.
+ *   - The tool RESULT is a separate `tool_result` event carrying the matching
+ *     `id`.
+ * So we extract each `tool_use` block as a tool entry (args) at the assistant's
+ * position, then merge the later `tool_result` (matched by `id`) INTO that same
+ * entry — giving one box per tool (args + result) in strict chronological order.
+ *
+ * @module hq/transcript-mapper
+ */
+
+/**
+ * Map a single raw JSONL session event to zero or more transcript entries.
+ * An `llm_response` can yield an assistant text entry PLUS one tool entry per
+ * embedded `tool_use` block.
+ */
+declare function mapSessionEventToEntries(ev: Record<string, unknown>): HqTranscriptEntry[];
+/**
+ * Merge each tool result into its matching args entry (by `toolUseId`),
+ * keeping the args entry's chronological position. Results with no matching
+ * args entry are kept as their own entries. Mutates/keeps order; pure w.r.t.
+ * input ordering.
+ */
+declare function mergeToolResults(flat: readonly HqTranscriptEntry[]): HqTranscriptEntry[];
+/**
+ * Map + merge an array of raw JSONL events into the final transcript-entry
+ * list: strict chronological order, with each tool's args and result combined
+ * into a single entry.
+ */
+declare function buildTranscriptFromEvents(events: Iterable<Record<string, unknown>>): HqTranscriptEntry[];
+
+export { type AgentMonitorEventBridgeOptions, type CreateGlobalMailboxOptions, type CreateHqPublisherOptions, type EnsureHqFirstRunAuthResult, HQ_AUTH_FILE_VERSION, type HqAgentEventPublisher, type HqAuthFile, type HqBrowserToken, HqClientIdentity, HqEventEnvelope, HqPublisher, type HqPublisherEnvConfig, type HqRedactOptions, HqRedactionPolicy, type HqRedactionResult, type HqRuntimeFile, HqSocketFactory, type HqToken, HqTranscriptEntry, type SessionTelemetryBridgeOptions, buildTranscriptFromEvents, createGlobalMailbox, createHqPublisherFromEnv, defaultHqDataDir, emptyHqAuthFile, ensureHqFirstRunAuthFile, hqAuthFilePath, hqRuntimeFilePath, mapSessionEventToEntries, mergeToolResults, mintHqBrowserToken, mintHqToken, mutateHqAuthFile, readHqAuthFile, readHqRuntimeFileSync, redactHqEvent, redactHqValue, resolveHqConfig, resolveHqConfigFromEnv, resolveHqDataDir, scrubAndTruncateHqPreview, startAgentMonitorEventBridge, startSessionTelemetryBridge, summarizeHqToolArgs, watchHqAuthFile, writeHqAuthFile, writeHqRuntimeFile };