@wrongstack/core 0.283.0 → 0.283.1

package/dist/hq/index.d.ts

@@ -607,7 +607,7 @@ declare function createHqPersistence(dataDir: string): HqPersistence;
  */
 
 /** HQ_COMMAND_TYPES — the full set of recognized command `type` strings. */
-declare const HQ_COMMAND_TYPES: readonly ["steer", "abort", "spawn", "broadcast", "run-command"];
+declare const HQ_COMMAND_TYPES: readonly ["steer", "btw", "queue", "abort", "spawn", "broadcast", "run-command"];
 type HqCommandType = (typeof HQ_COMMAND_TYPES)[number];
 /** Inject a steer text into a target agent's conversation. */
 interface HqSteerCommand {
@@ -618,6 +618,32 @@ interface HqSteerCommand {
     body: string;
     priority?: 'low' | 'normal' | 'high';
 }
+/**
+ * Post a non-urgent FYI (`btw`) into a target agent's mailbox. Unlike a steer,
+ * a btw is absorbed as context — it does not demand the agent change course.
+ * Same wire shape as steer; only the emitted mailbox `type` differs.
+ */
+interface HqBtwCommand {
+    type: 'btw';
+    /** Target agent address: a unique id (`leader@<tag>`), an alias (`leader`), or `*` for all. */
+    to: string;
+    subject: string;
+    body: string;
+    priority?: 'low' | 'normal' | 'high';
+}
+/**
+ * Queue a prompt/note (`queue`) for a target agent. Delivered as a plain
+ * `note` mailbox message the agent picks up before its next step — used when
+ * the prompt should wait its turn rather than steer the current operation.
+ */
+interface HqQueueCommand {
+    type: 'queue';
+    /** Target agent address: a unique id (`leader@<tag>`), an alias (`leader`), or `*` for all. */
+    to: string;
+    subject: string;
+    body: string;
+    priority?: 'low' | 'normal' | 'high';
+}
 /** Abort a running agent run or fleet. */
 interface HqAbortCommand {
     type: 'abort';
@@ -646,7 +672,7 @@ interface HqRunCommandCommand {
     /** Optional working directory (defaults to the agent's project root). */
     cwd?: string;
 }
-type HqCommand = HqSteerCommand | HqAbortCommand | HqSpawnCommand | HqBroadcastCommand | HqRunCommandCommand;
+type HqCommand = HqSteerCommand | HqBtwCommand | HqQueueCommand | HqAbortCommand | HqSpawnCommand | HqBroadcastCommand | HqRunCommandCommand;
 /**
  * Validate that an inbound `HqQueuedCommand` has a recognized `type` and a
  * minimally well-formed payload. Returns the narrowed command on success, or
@@ -787,4 +813,4 @@ declare function mergeToolResults(flat: readonly HqTranscriptEntry[]): HqTranscr
  */
 declare function buildTranscriptFromEvents(events: Iterable<Record<string, unknown>>): HqTranscriptEntry[];
 
-export { type AgentMonitorEventBridgeOptions, type BrainTelemetryBridgeOptions, type CostTelemetryBridgeOptions, type CreateGlobalMailboxOptions, type CreateHqPublisherOptions, type EnsureHqFirstRunAuthResult, type FleetTelemetryBridgeOptions, HQ_AUTH_FILE_VERSION, HQ_COMMAND_TYPES, type HqAbortCommand, type HqAgentEventPublisher, type HqAlert, HqAlertEngine, HqAlertMessage, type HqAlertRuleConfig, type HqAlertSeverity, type HqAuthFile, type HqBroadcastCommand, type HqBrowserToken, HqClientCapability, HqClientIdentity, type HqCommand, type HqCommandAuditEntry, HqCommandAuditLog, type HqCommandType, HqEventEnvelope, HqEventLog, type HqEventLogOptions, type HqPersistence, HqPublisher, HqPublisherCommandHandler, type HqPublisherEnvConfig, HqQueuedCommand, type HqRedactOptions, HqRedactionPolicy, type HqRedactionResult, type HqRunCommandCommand, type HqRuntimeFile, HqSnapshot, HqSnapshotStore, type HqSnapshotStoreOptions, HqSocketFactory, type HqSpawnCommand, type HqSteerCommand, type HqTimeseriesSample, HqTimeseriesStore, type HqTimeseriesStoreOptions, type HqToken, HqTranscriptEntry, type SessionTelemetryBridgeOptions, type ToolTelemetryBridgeOptions, type WorktreeTelemetryBridgeOptions, buildTranscriptFromEvents, createGlobalMailbox, createHqPersistence, createHqPublisherFromEnv, defaultHqDataDir, discoverLocalHqEndpoint, emptyHqAuthFile, ensureHqFirstRunAuthFile, hqAuthFilePath, hqRuntimeFilePath, mapSessionEventToEntries, mergeToolResults, mintHqBrowserToken, mintHqToken, mutateHqAuthFile, readHqAuthFile, readHqRuntimeFileSync, redactHqEvent, redactHqValue, resolveHqConfig, resolveHqConfigFromEnv, resolveHqDataDir, scrubAndTruncateHqPreview, startAgentMonitorEventBridge, startBrainTelemetryBridge, startCostTelemetryBridge, startFleetTelemetryBridge, startSessionTelemetryBridge, startToolTelemetryBridge, startWorktreeTelemetryBridge, summarizeHqToolArgs, toAlertMessage, tokenHasCapability, validateHqCommand, watchHqAuthFile, writeHqAuthFile, writeHqRuntimeFile };
+export { type AgentMonitorEventBridgeOptions, type BrainTelemetryBridgeOptions, type CostTelemetryBridgeOptions, type CreateGlobalMailboxOptions, type CreateHqPublisherOptions, type EnsureHqFirstRunAuthResult, type FleetTelemetryBridgeOptions, HQ_AUTH_FILE_VERSION, HQ_COMMAND_TYPES, type HqAbortCommand, type HqAgentEventPublisher, type HqAlert, HqAlertEngine, HqAlertMessage, type HqAlertRuleConfig, type HqAlertSeverity, type HqAuthFile, type HqBroadcastCommand, type HqBrowserToken, type HqBtwCommand, HqClientCapability, HqClientIdentity, type HqCommand, type HqCommandAuditEntry, HqCommandAuditLog, type HqCommandType, HqEventEnvelope, HqEventLog, type HqEventLogOptions, type HqPersistence, HqPublisher, HqPublisherCommandHandler, type HqPublisherEnvConfig, type HqQueueCommand, HqQueuedCommand, type HqRedactOptions, HqRedactionPolicy, type HqRedactionResult, type HqRunCommandCommand, type HqRuntimeFile, HqSnapshot, HqSnapshotStore, type HqSnapshotStoreOptions, HqSocketFactory, type HqSpawnCommand, type HqSteerCommand, type HqTimeseriesSample, HqTimeseriesStore, type HqTimeseriesStoreOptions, type HqToken, HqTranscriptEntry, type SessionTelemetryBridgeOptions, type ToolTelemetryBridgeOptions, type WorktreeTelemetryBridgeOptions, buildTranscriptFromEvents, createGlobalMailbox, createHqPersistence, createHqPublisherFromEnv, defaultHqDataDir, discoverLocalHqEndpoint, emptyHqAuthFile, ensureHqFirstRunAuthFile, hqAuthFilePath, hqRuntimeFilePath, mapSessionEventToEntries, mergeToolResults, mintHqBrowserToken, mintHqToken, mutateHqAuthFile, readHqAuthFile, readHqRuntimeFileSync, redactHqEvent, redactHqValue, resolveHqConfig, resolveHqConfigFromEnv, resolveHqDataDir, scrubAndTruncateHqPreview, startAgentMonitorEventBridge, startBrainTelemetryBridge, startCostTelemetryBridge, startFleetTelemetryBridge, startSessionTelemetryBridge, startToolTelemetryBridge, startWorktreeTelemetryBridge, summarizeHqToolArgs, toAlertMessage, tokenHasCapability, validateHqCommand, watchHqAuthFile, writeHqAuthFile, writeHqRuntimeFile };

package/dist/hq/index.js

@@ -3542,6 +3542,8 @@ function createHqPersistence(dataDir) {
 // src/hq/commands.ts
 var HQ_COMMAND_TYPES = [
   "steer",
+  "btw",
+  "queue",
   "abort",
   "spawn",
   "broadcast",
@@ -3563,6 +3565,26 @@ function validateHqCommand(queued) {
       }
       return result;
     }
+    case "btw": {
+      if (typeof p["to"] !== "string" || typeof p["subject"] !== "string" || typeof p["body"] !== "string") {
+        return null;
+      }
+      const result = { type: "btw", to: p["to"], subject: p["subject"], body: p["body"] };
+      if (p["priority"] === "low" || p["priority"] === "normal" || p["priority"] === "high") {
+        result.priority = p["priority"];
+      }
+      return result;
+    }
+    case "queue": {
+      if (typeof p["to"] !== "string" || typeof p["subject"] !== "string" || typeof p["body"] !== "string") {
+        return null;
+      }
+      const result = { type: "queue", to: p["to"], subject: p["subject"], body: p["body"] };
+      if (p["priority"] === "low" || p["priority"] === "normal" || p["priority"] === "high") {
+        result.priority = p["priority"];
+      }
+      return result;
+    }
     case "abort":
       if (typeof p["target"] !== "string") return null;
       return { type: "abort", target: p["target"] };