@wrongstack/core 0.299.0 → 0.301.0

package/dist/coordination/agents/project-agent-identity.d.ts

@@ -19,19 +19,19 @@
  */
 import { existsSync } from 'node:fs';
 import type { SubagentConfig } from '../../types/multi-agent.js';
+import { type ConsolidationMetadata } from './project-agent-consolidation.js';
+import type { LearnedCaptureResult, ProjectAgentConfig, RoleKnowledgeManifest } from './project-agent-identity-types.js';
 import { type ProjectAgentLearningPolicy } from './project-agent-learning-policy.js';
 import { type StructuredLearnedEntry } from './project-agent-learning-structured.js';
-import type { LearnedCaptureResult, ProjectAgentConfig, RoleKnowledgeManifest } from './project-agent-identity-types.js';
-import { type ConsolidationMetadata } from './project-agent-consolidation.js';
 export { validateProjectAgentConfig } from './project-agent-config-validation.js';
+export { buildConsolidationInstruction, type ConsolidationMetadata, clearProjectAgentConsolidated, isConsolidated, loadConsolidationMetadata, loadProjectAgentConsolidated, saveProjectAgentConsolidated, } from './project-agent-consolidation.js';
+export type { CreateProjectAgentInput, LearnedCaptureResult, ProjectAgentConfig, ProjectAgentProfile, RoleKnowledgeManifest, } from './project-agent-identity-types.js';
 export { classifyLearnedEntry, LEARNED_ENTRY_MAX_CHARS, LEARNED_HARD_LIMIT, LEARNED_SOFT_LIMIT, type LearnedEntryCategory, normalizeLearnedEntry, } from './project-agent-learning-normalize.js';
-export { decomposeLearnedEntry, mergeStructuredEntries, parseLearnedEntryStamp, renderLearnedInstructions, type StructuredLearnedEntry, } from './project-agent-learning-structured.js';
 export { loadProjectAgentLearningPolicy, type ProjectAgentLearningPolicy, updateProjectAgentLearningPolicy, } from './project-agent-learning-policy.js';
+export { decomposeLearnedEntry, mergeStructuredEntries, parseLearnedEntryStamp, renderLearnedInstructions, type StructuredLearnedEntry, } from './project-agent-learning-structured.js';
 export { assertProjectAgentRole } from './project-agent-paths.js';
-export { buildConsolidationInstruction, clearProjectAgentConsolidated, isConsolidated, loadConsolidationMetadata, loadProjectAgentConsolidated, saveProjectAgentConsolidated, type ConsolidationMetadata, } from './project-agent-consolidation.js';
-export type { CreateProjectAgentInput, LearnedCaptureResult, ProjectAgentConfig, ProjectAgentProfile, RoleKnowledgeManifest, } from './project-agent-identity-types.js';
-export { createProjectAgent, loadProjectAgentProfile, slugifyProjectAgentRole, } from './project-agent-profile.js';
 export { listProjectAgentRoles, refreshProjectAgentIdentity, resetProjectAgentIdentity, updateProjectAgentConfig, updateProjectAgentIdentity, updateProjectAgentKnowledge, updateProjectAgentLearned, } from './project-agent-files.js';
+export { createProjectAgent, loadProjectAgentProfile, slugifyProjectAgentRole, } from './project-agent-profile.js';
 /**
  * Live roster overlay. Project policy is resolved lazily for both built-in and
  * project-created roles, so WebUI changes take effect on the next spawn without

package/dist/coordination/agents/role-skills.d.ts

@@ -97,6 +97,6 @@ export declare const ROLE_SKILL_SETS: {
 export type CatalogRoleWithSkills = keyof typeof ROLE_SKILL_SETS;
 /** Standalone operational role that lives outside the phase catalog. */
 export declare const SHADOW_AGENT_SKILLS: ("api-design" | "audit-log" | "bug-hunter" | "chimera" | "data-governance" | "docker-deploy" | "git-flow" | "mnemosyne" | "multi-agent" | "node-modern" | "observability" | "output-standards" | "plugin-author" | "prompt-engineering" | "react-modern" | "refactor-planner" | "research-web" | "sdd" | "security-scanner" | "skill-creator" | "tech-stack" | "testing" | "typescript-strict" | "wrongstack-mailbox")[];
-/** Attach a fresh skill-name array so catalog templates remain mutation-safe. */
+/** Attach a bounded, fresh skill-name array so catalog templates remain mutation-safe. */
 export declare function assignSkillsToAgents(definitions: readonly AgentDefinition[]): AgentDefinition[];
 //# sourceMappingURL=role-skills.d.ts.map

package/dist/coordination/agents/types.d.ts

@@ -100,4 +100,10 @@ export declare const TOOLS: {
     /** Web research. */
     readonly research: readonly ["read", "grep", "glob", "search", "fetch", "mailbox"];
 };
+/** Canonical optional tool packs used by specialist roster roles. */
+export declare const SPECIALIST_TOOLS: {
+    readonly browser: string[];
+    readonly memory: string[];
+    readonly mcp: string[];
+};
 //# sourceMappingURL=types.d.ts.map

package/dist/coordination/director.d.ts

@@ -5,6 +5,7 @@ import type { Tool } from '../types/tool.js';
 import { InMemoryAgentBridge } from './agent-bridge.js';
 import type { CollabDebugReport, CollabSessionOptions } from './collab-debug.js';
 import type { DirectorOptions } from './director-options.js';
+import { type DirectorSubagentSessionSummary } from './director-session.js';
 import { FleetBus, type FleetUsage, FleetUsageAggregator } from './fleet-bus.js';
 import type { FleetManager } from './fleet-manager.js';
 import { type DirectorFleetHost } from './fleet-spawn.js';
@@ -14,10 +15,9 @@ import { LargeAnswerStore } from './large-answer-store.js';
 import type { ModelMatrixSource } from './model-matrix.js';
 import { DefaultMultiAgentCoordinator } from './multi-agent-coordinator.js';
 import { type WorktreeTaskStateUpdate } from './worktree-task-runner.js';
-import { type DirectorSubagentSessionSummary } from './director-session.js';
 export { FleetContextOverflowError, FleetCostCapError, FleetSpawnBudgetError, FleetTokenCapError, } from './director/director-errors.js';
-export type { ModelMatrixSource } from './model-matrix.js';
 export type { DirectorOptions, TaskResultNotification } from './director-options.js';
+export type { ModelMatrixSource } from './model-matrix.js';
 export declare class Director implements DirectorFleetHost, ICoordinator {
     private static _asManifestEntry;
     get coordinatorId(): string;
@@ -149,5 +149,13 @@ export declare class Director implements DirectorFleetHost, ICoordinator {
     acquireCheckpointLock(): Promise<boolean>;
     spawnCollab(options: CollabSessionOptions): Promise<CollabDebugReport>;
     resumeFromCheckpoint(snapshot: DirectorStateSnapshot): void;
+    /**
+     * After re-attaching checkpoint metadata, pin the live maxSpawns ceiling
+     * (profile/flag/env wins over historical checkpoint metadata). The
+     * historical cumulative spawn counter is deliberately NOT restored — the
+     * lifetime budget is scoped to this director run, so a restarted session
+     * resumes with a fresh budget rather than a possibly-exhausted counter.
+     */
+    private applyResumeBudget;
 }
 //# sourceMappingURL=director.d.ts.map

package/dist/coordination/fleet-manager.d.ts

@@ -72,6 +72,14 @@ export declare class FleetManager implements IFleetManager {
     readonly spawnDepth: number;
     /** Live spawn counter. */
     private spawnCount;
+    /**
+     * Historical `maxSpawns` from the last restored checkpoint (set for any
+     * finite checkpoint ceiling, matching or not). Surfaced in
+     * `budgetSnapshot()` so operators can see resume reconciliation without
+     * reading the JSON file; `ceilingMismatch` carries the actual mismatch signal.
+     */
+    private checkpointMaxSpawnsAtResume;
+    private ceilingMismatchAtResume;
     private readonly stateCheckpoint;
     private readonly sessionWriter;
     private manifestTimer;
@@ -129,7 +137,7 @@ export declare class FleetManager implements IFleetManager {
      * which cap was exceeded. Does NOT throw — the caller decides
      * how to surface the rejection.
      */
-    canSpawn(_config: SubagentConfig): {
+    canSpawn(config: SubagentConfig): {
         kind: 'max_spawns' | 'max_spawn_depth' | 'max_cost_usd' | 'max_tokens' | 'max_context_load';
         limit: number;
         observed: number;
@@ -144,6 +152,41 @@ export declare class FleetManager implements IFleetManager {
         maxCostUsd: number;
         usedCostUsd: number;
         remainingCostUsd: number;
+        /** Historical ceiling from the last restored checkpoint, when it differs. */
+        checkpointMaxSpawns?: number | undefined;
+        /** True when checkpoint metadata and the live ceiling disagree. */
+        ceilingMismatch?: boolean | undefined;
+    };
+    /**
+     * Re-attach the on-disk checkpoint after a resume while keeping the live
+     * `maxSpawns` ceiling from construction (profile / flag / env). The
+     * historical `spawnCount` is deliberately NOT restored: the lifetime
+     * budget is scoped to this director run, so a restarted session gets a
+     * fresh budget instead of inheriting a (possibly exhausted) counter from
+     * before the restart. The checkpoint ceiling is rewritten to the live
+     * value so subsequent writes do not reintroduce a stale limit.
+     */
+    restoreFromCheckpoint(snapshot: {
+        spawnCount: number;
+        maxSpawns?: number | undefined;
+        version?: 1 | undefined;
+        directorRunId?: string | undefined;
+        updatedAt?: string | undefined;
+        spawnDepth?: number | undefined;
+        maxSpawnDepth?: number | undefined;
+        directorBudget?: {
+            maxCostUsd?: number | undefined;
+            maxTokens?: number | undefined;
+        } | undefined;
+        subagents?: unknown[] | undefined;
+        tasks?: unknown[] | undefined;
+        usage?: unknown | undefined;
+    }): {
+        usedSpawns: number;
+        maxSpawns: number;
+        remainingSpawns: number;
+        checkpointMaxSpawns?: number | undefined;
+        ceilingMismatch: boolean;
     };
     setLeaderContextPressure(tokens: number): void;
     /** Test-only accessor: number of entries in the private subagent-meta map. */
@@ -175,8 +218,10 @@ export declare class FleetManager implements IFleetManager {
      */
     get usedNicknames(): ReadonlySet<string>;
     /**
-     * Records a spawn: increments counter, stores metadata, updates state checkpoint,
-     * and schedules a debounced manifest write. Call AFTER the coordinator
+     * Records a spawn: stores metadata, updates state checkpoint, and schedules
+     * a debounced manifest write. Increments the lifetime spawn counter UNLESS
+     * the config is `spawnBudgetExempt` (ephemeral Chimera reviewer/cascade
+     * spawns do not consume the leader's budget). Call AFTER the coordinator
      * has successfully spawned the subagent.
      *
      * @param subagentId The subagent's id (from coordinator.spawn result)

package/dist/coordination/ifleet-manager.d.ts

@@ -52,6 +52,8 @@ export interface IFleetManager {
         maxCostUsd: number;
         usedCostUsd: number;
         remainingCostUsd: number;
+        checkpointMaxSpawns?: number | undefined;
+        ceilingMismatch?: boolean | undefined;
     }) | undefined;
     /**
      * Update the leader agent's current context pressure (tokens used in the