@wrongstack/core 0.299.0 → 0.300.0

package/dist/fleet-notifier.d.ts

@@ -5,8 +5,13 @@ export interface FleetNotifierOptions {
     projectRoot: string;
     /** This process's pid, so a WebUI never pings itself. */
     selfPid?: number | undefined;
-    /** Injectable POST for tests. Defaults to a timed `fetch`. */
-    post?: ((url: string) => Promise<void>) | undefined;
+    /**
+     * Injectable POST for tests. Defaults to a timed `fetch`.
+     *
+     * The second parameter carries the target's API token (H3). It is optional
+     * so an existing `(url) => …` stub stays assignable.
+     */
+    post?: ((url: string, token?: string | undefined) => Promise<void>) | undefined;
 }
 export declare class FleetNotifier {
     private readonly baseDir;
@@ -21,6 +26,8 @@ export declare class FleetNotifier {
     notify(): void;
     /** Resolve same-project WebUI ping URLs (cached briefly). Exposed for tests. */
     endpoints(): Promise<string[]>;
+    /** Ping targets with their tokens (cached briefly). */
+    private targets;
     dispose(): void;
     /** Re-scope notifications after an in-process project switch. */
     setProjectRoot(projectRoot: string): void;

package/dist/hooks/index.js

@@ -776,7 +776,11 @@ function hookMatcherMatches(matcher, toolName) {
 
 // src/hooks/runner.ts
 var DEFAULT_TIMEOUT_MS3 = 5e3;
+var DEFAULT_BACKGROUND_TIMEOUT_MS = 6e4;
 var MAX_TIMEOUT_MS = 10 * 6e4;
+function hookTimeoutMs(entry) {
+  return entry.timeoutMs ?? (entry.background ? DEFAULT_BACKGROUND_TIMEOUT_MS : DEFAULT_TIMEOUT_MS3);
+}
 function normalizePreToolOutcome(outcome) {
   if ("action" in outcome) return outcome;
   if (outcome.decision === "block") {
@@ -961,12 +965,12 @@ var HookRunner = class {
       result = await this.invokeInProcess(entry, payload, env);
     } else {
       result = entry.kind === "shell" ? await runShellHookDetailed(
-        { command: entry.command, timeoutMs: entry.timeoutMs },
+        { command: entry.command, timeoutMs: hookTimeoutMs(entry) },
         payload,
         this.opts.logger,
         { signal: env.signal }
       ) : await runHttpHookDetailed(
-        { url: entry.url, headers: entry.headers, timeoutMs: entry.timeoutMs },
+        { url: entry.url, headers: entry.headers, timeoutMs: hookTimeoutMs(entry) },
         payload,
         this.opts.logger,
         { signal: env.signal }
@@ -983,12 +987,12 @@ var HookRunner = class {
     }
     if (!result.failure) return result.outcome;
     this.opts.logger?.warn?.(
-      `${payload.event} hook "${entry.name}" failed (${result.failure.kind}): ${result.failure.message}`
+      `${payload.event} ${entry.background ? "background " : ""}hook "${entry.name}" failed (${result.failure.kind}): ${result.failure.message}`
     );
     return this.failureOutcome(entry, payload, result.failure);
   }
   async invokeInProcess(entry, payload, env) {
-    const timeoutMs = Math.max(1, Math.min(entry.timeoutMs ?? DEFAULT_TIMEOUT_MS3, MAX_TIMEOUT_MS));
+    const timeoutMs = Math.max(1, Math.min(hookTimeoutMs(entry), MAX_TIMEOUT_MS));
     const controller = new AbortController();
     let timedOut = false;
     const onParentAbort = () => controller.abort(env.signal?.reason);

package/dist/hq/index.js

@@ -492,6 +492,9 @@ function isHqSubagentSummary(x) {
   const v = x;
   return typeof v.subagentId === "string" && typeof v.status === "string" && HQ_FLEET_SUBAGENT_STATUS.has(v.status);
 }
+function isOptionalFiniteNumber(x) {
+  return x === void 0 || typeof x === "number" && Number.isFinite(x);
+}
 function isHqFleetSnapshotPayload(x) {
   if (typeof x !== "object" || x === null) return false;
   const v = x;
@@ -501,6 +504,13 @@ function isHqFleetSnapshotPayload(x) {
   for (const s of v.subagents) {
     if (!isHqSubagentSummary(s)) return false;
   }
+  if (!isOptionalFiniteNumber(v.maxConcurrent)) return false;
+  if (!isOptionalFiniteNumber(v.maxSpawns)) return false;
+  if (!isOptionalFiniteNumber(v.usedSpawns)) return false;
+  if (!isOptionalFiniteNumber(v.remainingSpawns)) return false;
+  if (!isOptionalFiniteNumber(v.checkpointMaxSpawns)) return false;
+  if (v.effectiveSource !== void 0 && typeof v.effectiveSource !== "string") return false;
+  if (v.ceilingMismatch !== void 0 && typeof v.ceilingMismatch !== "boolean") return false;
   return true;
 }
 function isHqFleetEventPayload(x) {
@@ -2574,9 +2584,6 @@ function watchHqAuthFile(dataDir, onChange, opts = {}) {
       }
     }
   });
-  watcher.on("error", (err) => {
-    opts.warn?.(`HQ auth watcher error: ${err.message}`);
-  });
   return {
     close: () => {
       closed = true;
@@ -3313,7 +3320,14 @@ function startFleetTelemetryBridge(opts) {
       completedTasks: stats.completed,
       failedTasks: stats.stopped,
       ...stats.totalCostUsd !== void 0 ? { totalCostUsd: stats.totalCostUsd } : {},
-      subagents
+      subagents,
+      ...stats.maxConcurrent !== void 0 ? { maxConcurrent: stats.maxConcurrent } : {},
+      ...stats.maxSpawns !== void 0 ? { maxSpawns: stats.maxSpawns } : {},
+      ...stats.usedSpawns !== void 0 ? { usedSpawns: stats.usedSpawns } : {},
+      ...stats.remainingSpawns !== void 0 ? { remainingSpawns: stats.remainingSpawns } : {},
+      ...stats.effectiveSource !== void 0 ? { effectiveSource: stats.effectiveSource } : {},
+      ...stats.checkpointMaxSpawns !== void 0 ? { checkpointMaxSpawns: stats.checkpointMaxSpawns } : {},
+      ...stats.ceilingMismatch ? { ceilingMismatch: true } : {}
     };
   }
   const off = events.on("coordinator.stats", (stats) => {

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

@@ -7,6 +7,19 @@ export interface HqFleetSnapshotPayload {
     failedTasks: number;
     totalCostUsd?: number;
     subagents: readonly HqSubagentSummary[];
+    /** Concurrent-subagent ceiling (maxConcurrent). */
+    maxConcurrent?: number | undefined;
+    /** Lifetime spawn ceiling (maxSpawns). */
+    maxSpawns?: number | undefined;
+    /** Cumulative spawns consumed this director run. */
+    usedSpawns?: number | undefined;
+    /** maxSpawns − usedSpawns (clamped ≥ 0). */
+    remainingSpawns?: number | undefined;
+    /** Winning config source labels, e.g. "maxConcurrent=profile, maxSpawns=env". */
+    effectiveSource?: string | undefined;
+    /** Historical checkpoint maxSpawns when it disagreed with the live ceiling. */
+    checkpointMaxSpawns?: number | undefined;
+    ceilingMismatch?: boolean | undefined;
 }
 export interface HqFleetEventPayload {
     runId: string;
@@ -62,6 +75,13 @@ export interface HqFleetSummary {
     failedTasks: number;
     totalCostUsd?: number;
     lastActivityAt: string;
+    maxConcurrent?: number | undefined;
+    maxSpawns?: number | undefined;
+    usedSpawns?: number | undefined;
+    remainingSpawns?: number | undefined;
+    effectiveSource?: string | undefined;
+    checkpointMaxSpawns?: number | undefined;
+    ceilingMismatch?: boolean | undefined;
 }
 export interface HqQueuedCommand {
     commandId: string;

package/dist/hq/protocol.js

@@ -492,6 +492,9 @@ function isHqSubagentSummary(x) {
   const v = x;
   return typeof v.subagentId === "string" && typeof v.status === "string" && HQ_FLEET_SUBAGENT_STATUS.has(v.status);
 }
+function isOptionalFiniteNumber(x) {
+  return x === void 0 || typeof x === "number" && Number.isFinite(x);
+}
 function isHqFleetSnapshotPayload(x) {
   if (typeof x !== "object" || x === null) return false;
   const v = x;
@@ -501,6 +504,13 @@ function isHqFleetSnapshotPayload(x) {
   for (const s of v.subagents) {
     if (!isHqSubagentSummary(s)) return false;
   }
+  if (!isOptionalFiniteNumber(v.maxConcurrent)) return false;
+  if (!isOptionalFiniteNumber(v.maxSpawns)) return false;
+  if (!isOptionalFiniteNumber(v.usedSpawns)) return false;
+  if (!isOptionalFiniteNumber(v.remainingSpawns)) return false;
+  if (!isOptionalFiniteNumber(v.checkpointMaxSpawns)) return false;
+  if (v.effectiveSource !== void 0 && typeof v.effectiveSource !== "string") return false;
+  if (v.ceilingMismatch !== void 0 && typeof v.ceilingMismatch !== "boolean") return false;
   return true;
 }
 function isHqFleetEventPayload(x) {

package/dist/index.d.ts

@@ -54,6 +54,7 @@ export type { FallbackChain, FallbackChainEntry, ProviderHealth, } from './core/
 export { FallbackProfileManager } from './core/fallback-profile-manager.js';
 export { InputBuilder, type InputBuilderEvent, type InputBuilderOptions, } from './core/input-builder.js';
 export { type InstructionBundle, type InstructionBundlePaths, loadInstructionBundle, mergeInstructionBundle, type SystemInstructionBundle, type SystemInstructionVariant, } from './core/instruction-bundle.js';
+export { type InstructionTemplateContext, renderInstructionLayer, } from './core/instruction-template.js';
 export { buildMailboxBlock, buildMailboxBtwAwarenessBlock, createMailboxChecker, injectPendingMailboxMessages, type MailboxDeliveryMode, type MailboxLoopOptions, } from './core/mailbox-loop.js';
 export { evaluateModelCalendar, logicalCalendarTarget, type ModelBlackoutRule, type ModelCalendarDecision, } from './core/model-availability-calendar.js';
 export { runProviderWithRetry } from './core/provider-runner.js';