nexus-agents 2.82.0 → 2.83.0

package/dist/codebase-search-ZFJUVMVR.js

@@ -0,0 +1,8 @@
+import {
+  CodebaseIndex
+} from "./chunk-3ACDP4E6.js";
+import "./chunk-PR4QN5HX.js";
+export {
+  CodebaseIndex
+};
+//# sourceMappingURL=codebase-search-ZFJUVMVR.js.map

package/dist/{composite-router-FB7P22L5.js → composite-router-X2ZYIEHH.js}

@@ -4,7 +4,7 @@ import {
   CompositeRoutingError,
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
-} from "./chunk-7VNVDFD5.js";
+} from "./chunk-RXVH52UI.js";
 import "./chunk-I2HMWH4R.js";
 import "./chunk-PR4QN5HX.js";
 export {
@@ -14,4 +14,4 @@ export {
   DEFAULT_COMPOSITE_CONFIG,
   createCompositeRouter
 };
-//# sourceMappingURL=composite-router-FB7P22L5.js.map
+//# sourceMappingURL=composite-router-X2ZYIEHH.js.map

package/dist/{consensus-vote-KKAIFULI.js → consensus-vote-KZ6UURUI.js}

@@ -5,18 +5,18 @@ import {
   executeVoting,
   registerConsensusVoteTool,
   resetCorrelationTracker
-} from "./chunk-FTT2IYYX.js";
-import "./chunk-NTLJ3INA.js";
-import "./chunk-SBZVRH4S.js";
-import "./chunk-U7JXQSEM.js";
-import "./chunk-WUUEKFKG.js";
-import "./chunk-SHWGK7X6.js";
+} from "./chunk-4BXQ2OZY.js";
+import "./chunk-54UXPJVM.js";
+import "./chunk-ZIWEEVMI.js";
+import "./chunk-YO27YAEX.js";
+import "./chunk-Q6PZMGLU.js";
+import "./chunk-ZM5JKJHI.js";
 import "./chunk-633WH2ML.js";
-import "./chunk-2SQXJQTA.js";
-import "./chunk-QHL4KGNB.js";
+import "./chunk-FHGDJKCZ.js";
+import "./chunk-5T6SYCH2.js";
 import "./chunk-PQHVC4BD.js";
-import "./chunk-HVZ52LOL.js";
-import "./chunk-7VNVDFD5.js";
+import "./chunk-U6LDVJS7.js";
+import "./chunk-RXVH52UI.js";
 import "./chunk-I2HMWH4R.js";
 import "./chunk-PR4QN5HX.js";
 export {
@@ -27,4 +27,4 @@ export {
   registerConsensusVoteTool,
   resetCorrelationTracker
 };
-//# sourceMappingURL=consensus-vote-KKAIFULI.js.map
+//# sourceMappingURL=consensus-vote-KZ6UURUI.js.map

package/dist/{context-retriever-4JCGMWH7.js → context-retriever-QY4FNTDZ.js}

@@ -2,12 +2,12 @@ import {
   getContextForTask,
   inferTaskCategory,
   summarizeContextForPrompt
-} from "./chunk-TXIUCEFT.js";
-import "./chunk-U7JXQSEM.js";
+} from "./chunk-3GJAAENS.js";
+import "./chunk-YO27YAEX.js";
 import "./chunk-633WH2ML.js";
 import "./chunk-PQHVC4BD.js";
-import "./chunk-HVZ52LOL.js";
-import "./chunk-7VNVDFD5.js";
+import "./chunk-U6LDVJS7.js";
+import "./chunk-RXVH52UI.js";
 import "./chunk-I2HMWH4R.js";
 import "./chunk-PR4QN5HX.js";
 export {
@@ -15,4 +15,4 @@ export {
   inferTaskCategory,
   summarizeContextForPrompt
 };
-//# sourceMappingURL=context-retriever-4JCGMWH7.js.map
+//# sourceMappingURL=context-retriever-QY4FNTDZ.js.map

package/dist/{doctor-deep-7YK4BZIJ.js → doctor-deep-2E2GBMYR.js}

@@ -1,12 +1,12 @@
 import {
   formatDeepDiagnostics,
   runDeepDiagnostics
-} from "./chunk-XGUDCUMB.js";
-import "./chunk-7VNVDFD5.js";
+} from "./chunk-FI77TGBY.js";
+import "./chunk-RXVH52UI.js";
 import "./chunk-I2HMWH4R.js";
 import "./chunk-PR4QN5HX.js";
 export {
   formatDeepDiagnostics,
   runDeepDiagnostics
 };
-//# sourceMappingURL=doctor-deep-7YK4BZIJ.js.map
+//# sourceMappingURL=doctor-deep-2E2GBMYR.js.map

package/dist/expert-bridge-FHPWDFJX.js

@@ -0,0 +1,13 @@
+import {
+  executeExpert,
+  shutdownExpertBridge
+} from "./chunk-NLPMYBIV.js";
+import "./chunk-3WUVWZUC.js";
+import "./chunk-RXVH52UI.js";
+import "./chunk-I2HMWH4R.js";
+import "./chunk-PR4QN5HX.js";
+export {
+  executeExpert,
+  shutdownExpertBridge
+};
+//# sourceMappingURL=expert-bridge-FHPWDFJX.js.map

package/dist/{factory-PK4EZL7K.js → factory-STNVY3Y3.js}

@@ -3,9 +3,9 @@ import {
   createCliAdapter,
   getAvailableClis,
   isCliAvailable
-} from "./chunk-2SQXJQTA.js";
-import "./chunk-QHL4KGNB.js";
-import "./chunk-7VNVDFD5.js";
+} from "./chunk-FHGDJKCZ.js";
+import "./chunk-5T6SYCH2.js";
+import "./chunk-RXVH52UI.js";
 import "./chunk-I2HMWH4R.js";
 import "./chunk-PR4QN5HX.js";
 export {
@@ -14,4 +14,4 @@ export {
   getAvailableClis,
   isCliAvailable
 };
-//# sourceMappingURL=factory-PK4EZL7K.js.map
+//# sourceMappingURL=factory-STNVY3Y3.js.map

package/dist/{factory-DOWBGVAL.js → factory-W6KROBFN.js}

@@ -1,14 +1,14 @@
 import {
   createGitHubProvider,
   createScmProvider
-} from "./chunk-C7P2HLJX.js";
-import "./chunk-G2DZBEMU.js";
-import "./chunk-PZESEBD3.js";
-import "./chunk-7VNVDFD5.js";
+} from "./chunk-3ASED5PR.js";
+import "./chunk-Z64MSLEK.js";
+import "./chunk-L362KRSU.js";
+import "./chunk-RXVH52UI.js";
 import "./chunk-I2HMWH4R.js";
 import "./chunk-PR4QN5HX.js";
 export {
   createGitHubProvider,
   createScmProvider
 };
-//# sourceMappingURL=factory-DOWBGVAL.js.map
+//# sourceMappingURL=factory-W6KROBFN.js.map

package/dist/index.d.ts

@@ -12136,8 +12136,8 @@ declare const TrinityRoleSchema: z.ZodEnum<{
 declare const TrinityPhaseSchema: z.ZodEnum<{
     thinking: "thinking";
     working: "working";
-    verifying: "verifying";
     complete: "complete";
+    verifying: "verifying";
 }>;
 /** Schema for verifier verdict. */
 declare const VerifierVerdictSchema: z.ZodEnum<{
@@ -28311,6 +28311,28 @@ type GitHubInput = z.infer<typeof GitHubInputSchema>;
  */
 declare function createGitHubAdapter(): ISourceAdapter;
 
+/**
+ * nexus-agents/orchestration - Orchestrator Adapters
+ *
+ * Adapters wrapping Orchestrator, PuppeteerOrchestrator, WorkflowEngine
+ * to implement the unified IOrchestrator interface.
+ *
+ * @module orchestration/orchestrator-adapters
+ * @see docs/adr/0002-orchestrator-interface.md
+ */
+
+/**
+ * Narrow shape of an agent that the OrchestratorAdapter (and the factory
+ * config that wires one in) needs. Narrows the input to `Task` so the
+ * concrete `Orchestrator` instance can be passed without an `as unknown
+ * as` cast (#2944). Keeps the `Result` payload+error wide because the
+ * adapter is intentionally resilient to non-`AgentError` failures
+ * (see orchestrator-adapters.test.ts "fails with non-Error" coverage).
+ */
+interface OrchestratorAgentLike {
+    execute(task: Task$1): Promise<Result<unknown, unknown>>;
+}
+
 /**
  * nexus-agents/orchestration - Orchestrator Factory
  *
@@ -28368,17 +28390,22 @@ interface OrchestratorFactoryConfig {
     modelAdapter?: IModelAdapter;
     /** Workflow engine config */
     workflowConfig?: WorkflowEngineFactoryConfig;
-    /** Pre-created orchestrator agent instance for orchestrator adapter */
-    techLead?: {
-        execute: (task: unknown) => Promise<Result<unknown, unknown>>;
-    };
+    /**
+     * Pre-created orchestrator agent instance for orchestrator adapter.
+     * Narrowed from `(task: unknown)` to `OrchestratorAgentLike` so a real
+     * `Orchestrator` instance can be passed without an `as unknown as` cast
+     * (#2944). Task-input contract matches `OrchestratorAdapter.setOrchestrator`.
+     */
+    techLead?: OrchestratorAgentLike;
     /** Alias for techLead (preferred, Issue #759) */
-    orchestratorAgent?: {
-        execute: (task: unknown) => Promise<Result<unknown, unknown>>;
-    };
-    /** Pre-created PuppeteerOrchestrator instance */
+    orchestratorAgent?: OrchestratorAgentLike;
+    /**
+     * Pre-created PuppeteerOrchestrator instance. Input stays `unknown`
+     * because Puppeteer accepts arbitrary policy-shaped tasks, not the
+     * core `Task` type that the regular agent path requires.
+     */
     puppeteerOrchestrator?: {
-        execute: (task: unknown) => Promise<Result<unknown, unknown>>;
+        execute(task: unknown): Promise<Result<unknown, unknown>>;
     };
 }
 /**
@@ -31049,6 +31076,10 @@ declare function createDefaultPolicyEngine(): PolicyEngine;
  * Listens for `model.called` and `stage.failed` events and records
  * them as TaskOutcome entries in the OutcomeStore.
  *
+ * Returns an Unsubscribe handle for callers that manage their own
+ * subscription lifecycle (e.g. tests). For the server-wide singleton
+ * subscription, use `startFeedbackSubscriber` / `shutdownFeedbackSubscriber`.
+ *
  * @returns Unsubscribe function to stop the bridge.
  */
 declare function createFeedbackSubscriber(bus: IEventBus, store: OutcomeStore): Unsubscribe;
@@ -31119,11 +31150,16 @@ interface PipelineMetrics {
     readonly policyBlocked?: boolean;
     readonly policyViolations?: readonly string[];
 }
+/** Optional contract-construction options (#2957). */
+interface DelegateContractOpts {
+    /** Caller trust tier from RequestContext (`'1'..'4'`). */
+    readonly trustTier?: string;
+}
 /**
  * Converts delegate_to_model input into a V2 TaskContract.
  * Input fields are preserved in metadata for downstream pipeline stages.
  */
-declare function delegateInputToTaskContract(input: DelegateInputLike): TaskContract;
+declare function delegateInputToTaskContract(input: DelegateInputLike, opts?: DelegateContractOpts): TaskContract;
 /**
  * Compiles and executes a V2 pipeline for the given TaskContract.
  * Evaluates policy before execution — block mode halts the pipeline.
@@ -31192,8 +31228,13 @@ interface OrchestrateInputLike {
     readonly context?: Record<string, unknown>;
     readonly maxIterations?: number;
 }
+/** Optional contract-construction options (#2957). */
+interface OrchestrateContractOpts {
+    /** Caller trust tier from RequestContext (`'1'..'4'`). */
+    readonly trustTier?: string;
+}
 /** Converts orchestrate input to a TaskContract. */
-declare function orchestrateInputToTaskContract(input: OrchestrateInputLike): TaskContract;
+declare function orchestrateInputToTaskContract(input: OrchestrateInputLike, opts?: OrchestrateContractOpts): TaskContract;
 /** Executes the V2 orchestrate pipeline and returns metrics. */
 declare function executeOrchestratePipeline(task: TaskContract): Promise<PipelineMetrics>;
 
@@ -31557,50 +31598,6 @@ interface IterativeConsensusResult {
 }
 declare function runIterativeConsensus(initialPlan: string, revisePlan: (plan: string, feedback: string) => Promise<string>, config?: IterativeConsensusConfig): Promise<IterativeConsensusResult>;
 
-/**
- * Shared Memory — Cross-stage knowledge propagation (#1737, Phase 4)
- *
- * Early pipeline stages (planning, research) write structured discoveries
- * to a shared memory layer. Later stages read before acting.
- *
- * Scoped to a single pipeline run — not persisted cross-session.
- *
- * Pattern from: SWE-AF shared memory, AutoGen knowledge propagation.
- *
- * @module pipeline/shared-memory
- */
-/** A tagged memory entry written by a pipeline stage. */
-interface SharedMemoryEntry {
-    /** Stage that wrote this entry. */
-    readonly sourceStage: string;
-    /** Category tag for filtering. */
-    readonly tag: SharedMemoryTag;
-    /** The content (structured or text). */
-    readonly content: unknown;
-    /** When this was written. */
-    readonly timestamp: number;
-}
-/** Tags for categorizing shared memory entries. */
-type SharedMemoryTag = 'convention' | 'discovery' | 'constraint' | 'decision' | 'risk' | 'dependency' | 'context';
-/** In-memory store for cross-stage knowledge sharing. */
-declare class SharedMemoryStore {
-    private readonly entries;
-    private readonly maxEntries;
-    constructor(maxEntries?: number);
-    /** Write a memory entry. */
-    write(sourceStage: string, tag: SharedMemoryTag, content: unknown): void;
-    /** Read all entries, optionally filtered by tag. */
-    read(tag?: SharedMemoryTag): readonly SharedMemoryEntry[];
-    /** Read entries from a specific stage. */
-    readFromStage(sourceStage: string): readonly SharedMemoryEntry[];
-    /** Get summary of all entries as context string for LLM consumption. */
-    summarize(maxLength?: number): string;
-    /** Get entry count. */
-    get size(): number;
-    /** Clear all entries. */
-    clear(): void;
-}
-
 /**
  * Pipeline Stage Types — Shared interfaces for graph-backed pipelines (#1735, Phase 2)
  *
@@ -31617,10 +31614,14 @@ interface PipelineContext {
     readonly task: string;
     /** Pipeline template being executed. */
     readonly templateId: string;
-    /** Accumulated state from prior stages. */
+    /**
+     * Accumulated state from prior stages. The only cross-stage handoff
+     * channel — `sharedMemory` (the #1764 SharedMemoryStore) was removed
+     * in #2937 after being write-only since introduction. If you need
+     * structured cross-stage data, add a well-known key to
+     * `PIPELINE_STATE_KEYS` and write/read through `state`.
+     */
     readonly state: Readonly<Record<string, unknown>>;
-    /** Cross-stage knowledge store for discoveries, decisions, constraints (#1764). */
-    readonly sharedMemory: SharedMemoryStore;
 }
 /** Result of executing a single pipeline stage. */
 interface StageOutput {
@@ -31686,7 +31687,6 @@ declare const PIPELINE_STATE_KEYS: {
     readonly PARSED_SPEC: "parsedSpec";
     readonly SCAFFOLD_OUTPUT: "scaffoldOutput";
     readonly COMPLETED: "completed";
-    readonly SHARED_MEMORY: "__sharedMemory__";
 };
 
 /**
@@ -31873,6 +31873,50 @@ declare function canPipelineProceed(results: readonly IncompleteResult[]): boole
 /** Filter incomplete results by severity. */
 declare function filterBySeverity(results: readonly IncompleteResult[], minSeverity: IncompleteSeverity): readonly IncompleteResult[];
 
+/**
+ * Shared Memory — Cross-stage knowledge propagation (#1737, Phase 4)
+ *
+ * Early pipeline stages (planning, research) write structured discoveries
+ * to a shared memory layer. Later stages read before acting.
+ *
+ * Scoped to a single pipeline run — not persisted cross-session.
+ *
+ * Pattern from: SWE-AF shared memory, AutoGen knowledge propagation.
+ *
+ * @module pipeline/shared-memory
+ */
+/** A tagged memory entry written by a pipeline stage. */
+interface SharedMemoryEntry {
+    /** Stage that wrote this entry. */
+    readonly sourceStage: string;
+    /** Category tag for filtering. */
+    readonly tag: SharedMemoryTag;
+    /** The content (structured or text). */
+    readonly content: unknown;
+    /** When this was written. */
+    readonly timestamp: number;
+}
+/** Tags for categorizing shared memory entries. */
+type SharedMemoryTag = 'convention' | 'discovery' | 'constraint' | 'decision' | 'risk' | 'dependency' | 'context';
+/** In-memory store for cross-stage knowledge sharing. */
+declare class SharedMemoryStore {
+    private readonly entries;
+    private readonly maxEntries;
+    constructor(maxEntries?: number);
+    /** Write a memory entry. */
+    write(sourceStage: string, tag: SharedMemoryTag, content: unknown): void;
+    /** Read all entries, optionally filtered by tag. */
+    read(tag?: SharedMemoryTag): readonly SharedMemoryEntry[];
+    /** Read entries from a specific stage. */
+    readFromStage(sourceStage: string): readonly SharedMemoryEntry[];
+    /** Get summary of all entries as context string for LLM consumption. */
+    summarize(maxLength?: number): string;
+    /** Get entry count. */
+    get size(): number;
+    /** Clear all entries. */
+    clear(): void;
+}
+
 /**
  * Dynamic Expert Creation — Bounded agent creation at runtime (#1737, Phase 4)
  *