nexus-agents 2.28.0 → 2.29.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (118) hide show
  1. package/README.md +11 -10
  2. package/dist/adaptive-memory-RST6DZYR.js +15 -0
  3. package/dist/chunk-2UR7YN6T.js +700 -0
  4. package/dist/chunk-2UR7YN6T.js.map +1 -0
  5. package/dist/chunk-2UUUKVNR.js +61 -0
  6. package/dist/chunk-2UUUKVNR.js.map +1 -0
  7. package/dist/chunk-3EVVQ32X.js +838 -0
  8. package/dist/chunk-3EVVQ32X.js.map +1 -0
  9. package/dist/{chunk-UGNLR4NZ.js → chunk-3GXDN4AX.js} +2 -2
  10. package/dist/{chunk-LKSTILEE.js → chunk-4AGPR6XZ.js} +194 -1461
  11. package/dist/chunk-4AGPR6XZ.js.map +1 -0
  12. package/dist/chunk-4HA5PAL7.js +246 -0
  13. package/dist/chunk-4HA5PAL7.js.map +1 -0
  14. package/dist/chunk-633WH2ML.js +127 -0
  15. package/dist/chunk-633WH2ML.js.map +1 -0
  16. package/dist/chunk-7SKAKA4I.js +90 -0
  17. package/dist/chunk-7SKAKA4I.js.map +1 -0
  18. package/dist/chunk-AP2FD37C.js +127 -0
  19. package/dist/chunk-AP2FD37C.js.map +1 -0
  20. package/dist/chunk-BC3M4VLP.js +359 -0
  21. package/dist/chunk-BC3M4VLP.js.map +1 -0
  22. package/dist/chunk-BQ4YXGGQ.js +127 -0
  23. package/dist/chunk-BQ4YXGGQ.js.map +1 -0
  24. package/dist/chunk-C2C5ONFR.js +195 -0
  25. package/dist/chunk-C2C5ONFR.js.map +1 -0
  26. package/dist/chunk-CGWRJ4EM.js +12661 -0
  27. package/dist/chunk-CGWRJ4EM.js.map +1 -0
  28. package/dist/chunk-CLYZ7FWP.js +30 -0
  29. package/dist/chunk-CLYZ7FWP.js.map +1 -0
  30. package/dist/chunk-ED6VQWNG.js +63 -0
  31. package/dist/chunk-ED6VQWNG.js.map +1 -0
  32. package/dist/{chunk-L2SHSW4T.js → chunk-ELIFTCYM.js} +2705 -2473
  33. package/dist/chunk-ELIFTCYM.js.map +1 -0
  34. package/dist/chunk-FYJVXQHX.js +944 -0
  35. package/dist/chunk-FYJVXQHX.js.map +1 -0
  36. package/dist/{chunk-QZEAD6AG.js → chunk-FZFZ77UJ.js} +19434 -38182
  37. package/dist/chunk-FZFZ77UJ.js.map +1 -0
  38. package/dist/chunk-IECE6DBS.js +1585 -0
  39. package/dist/chunk-IECE6DBS.js.map +1 -0
  40. package/dist/chunk-LLGUX44Z.js +356 -0
  41. package/dist/chunk-LLGUX44Z.js.map +1 -0
  42. package/dist/chunk-MRU6L7YJ.js +931 -0
  43. package/dist/chunk-MRU6L7YJ.js.map +1 -0
  44. package/dist/chunk-N5SY7V45.js +44 -0
  45. package/dist/chunk-N5SY7V45.js.map +1 -0
  46. package/dist/chunk-OOIPRRPX.js +3790 -0
  47. package/dist/chunk-OOIPRRPX.js.map +1 -0
  48. package/dist/chunk-SRECH7OQ.js +354 -0
  49. package/dist/chunk-SRECH7OQ.js.map +1 -0
  50. package/dist/{chunk-YSDUVCCZ.js → chunk-VKRMXD62.js} +6 -6
  51. package/dist/{chunk-E7EX2KQJ.js → chunk-XU3NADFE.js} +2 -2
  52. package/dist/chunk-YSTJEMQX.js +122 -0
  53. package/dist/chunk-YSTJEMQX.js.map +1 -0
  54. package/dist/cli-circuit-breaker-5FAODXVY.js +13 -0
  55. package/dist/cli.d.ts +2 -2
  56. package/dist/cli.js +1485 -683
  57. package/dist/cli.js.map +1 -1
  58. package/dist/codebase-search-CZUA37RU.js +9 -0
  59. package/dist/composite-router-FNW7ZWL7.js +17 -0
  60. package/dist/composite-router-FNW7ZWL7.js.map +1 -0
  61. package/dist/consensus-vote-757YULIP.js +25 -0
  62. package/dist/consensus-vote-757YULIP.js.map +1 -0
  63. package/dist/{dist-H5XNXVAV.js → dist-CV74KUT7.js} +1521 -972
  64. package/dist/dist-CV74KUT7.js.map +1 -0
  65. package/dist/{doctor-deep-BDE2PHVX.js → doctor-deep-LMCEAFU4.js} +4 -3
  66. package/dist/doctor-deep-LMCEAFU4.js.map +1 -0
  67. package/dist/expert-bridge-L2D4OXOR.js +10 -0
  68. package/dist/expert-bridge-L2D4OXOR.js.map +1 -0
  69. package/dist/expert-config-A5CHKUGI.js +22 -0
  70. package/dist/expert-config-A5CHKUGI.js.map +1 -0
  71. package/dist/factory-ELEDP2WD.js +17 -0
  72. package/dist/factory-ELEDP2WD.js.map +1 -0
  73. package/dist/factory-IDTIBX6B.js +14 -0
  74. package/dist/factory-IDTIBX6B.js.map +1 -0
  75. package/dist/index.d.ts +1814 -777
  76. package/dist/index.js +785 -355
  77. package/dist/index.js.map +1 -1
  78. package/dist/issue-triage-SJPKJLXH.js +15 -0
  79. package/dist/issue-triage-SJPKJLXH.js.map +1 -0
  80. package/dist/learning-persistence-WMWZJZ35.js +16 -0
  81. package/dist/learning-persistence-WMWZJZ35.js.map +1 -0
  82. package/dist/mcp-config-2OXIOMJ6.js +12 -0
  83. package/dist/mcp-config-2OXIOMJ6.js.map +1 -0
  84. package/dist/mobimem-5S3VLNSU.js +13 -0
  85. package/dist/mobimem-5S3VLNSU.js.map +1 -0
  86. package/dist/{model-capabilities-types-CSWO27YN.d.ts → model-capabilities-types-B57GZryc.d.ts} +1 -1
  87. package/dist/repo-analyze-HWMXSK5C.js +24 -0
  88. package/dist/repo-analyze-HWMXSK5C.js.map +1 -0
  89. package/dist/repo-security-plan-MUFDGWSQ.js +17 -0
  90. package/dist/repo-security-plan-MUFDGWSQ.js.map +1 -0
  91. package/dist/research-helpers-synthesize-OBQJ5BGX.js +10 -0
  92. package/dist/research-helpers-synthesize-OBQJ5BGX.js.map +1 -0
  93. package/dist/routing-memory-3QBQTS4A.js +13 -0
  94. package/dist/routing-memory-3QBQTS4A.js.map +1 -0
  95. package/dist/session-memory-VXWLOFRC.js +22 -0
  96. package/dist/session-memory-VXWLOFRC.js.map +1 -0
  97. package/dist/{setup-command-SS7LMN7Y.js → setup-command-E6MXO5RZ.js} +9 -5
  98. package/dist/setup-command-E6MXO5RZ.js.map +1 -0
  99. package/dist/setup-config-O5F3AZBL.js +10 -0
  100. package/dist/setup-config-O5F3AZBL.js.map +1 -0
  101. package/dist/shared-memory-AEO2HJLC.js +8 -0
  102. package/dist/shared-memory-AEO2HJLC.js.map +1 -0
  103. package/dist/symbol-extractor-UEBANFSN.js +10 -0
  104. package/dist/symbol-extractor-UEBANFSN.js.map +1 -0
  105. package/dist/weather-report-MUGSIOU5.js +15 -0
  106. package/dist/weather-report-MUGSIOU5.js.map +1 -0
  107. package/package.json +18 -19
  108. package/dist/chunk-L2SHSW4T.js.map +0 -1
  109. package/dist/chunk-LKSTILEE.js.map +0 -1
  110. package/dist/chunk-QZEAD6AG.js.map +0 -1
  111. package/dist/dist-H5XNXVAV.js.map +0 -1
  112. package/dist/setup-config-DSMOOLVW.js +0 -9
  113. /package/dist/{doctor-deep-BDE2PHVX.js.map → adaptive-memory-RST6DZYR.js.map} +0 -0
  114. /package/dist/{chunk-UGNLR4NZ.js.map → chunk-3GXDN4AX.js.map} +0 -0
  115. /package/dist/{chunk-YSDUVCCZ.js.map → chunk-VKRMXD62.js.map} +0 -0
  116. /package/dist/{chunk-E7EX2KQJ.js.map → chunk-XU3NADFE.js.map} +0 -0
  117. /package/dist/{setup-command-SS7LMN7Y.js.map → cli-circuit-breaker-5FAODXVY.js.map} +0 -0
  118. /package/dist/{setup-config-DSMOOLVW.js.map → codebase-search-CZUA37RU.js.map} +0 -0
package/dist/index.d.ts CHANGED
@@ -1,8 +1,7 @@
1
1
  import { ZodError, z, ZodType, ZodSafeParseResult } from 'zod';
2
- import { C as CliNameLiteral, M as ModelId } from './model-capabilities-types-CSWO27YN.js';
2
+ import { C as CliNameLiteral, M as ModelId } from './model-capabilities-types-B57GZryc.js';
3
3
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
4
4
  import { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
5
- import { FastifyInstance } from 'fastify';
6
5
  import { ChildProcess } from 'node:child_process';
7
6
 
8
7
  /**
@@ -362,7 +361,7 @@ type AgentState$2 = 'idle' | 'thinking' | 'acting' | 'waiting' | 'error';
362
361
  * 'orchestrator' is the preferred name for the coordination agent (Issue #759).
363
362
  * 'tech_lead' is retained for backward compatibility but will be deprecated in v3.0.
364
363
  */
365
- type AgentRole = 'orchestrator' | 'tech_lead' | 'code_expert' | 'architecture_expert' | 'security_expert' | 'documentation_expert' | 'testing_expert' | 'devops_expert' | 'research_expert' | 'pm_expert' | 'ux_expert' | 'infrastructure_expert' | 'thinker' | 'worker' | 'verifier' | 'custom';
364
+ type AgentRole = 'orchestrator' | 'tech_lead' | 'code_expert' | 'architecture_expert' | 'security_expert' | 'documentation_expert' | 'testing_expert' | 'devops_expert' | 'research_expert' | 'pm_expert' | 'ux_expert' | 'infrastructure_expert' | 'qa_expert' | 'data_visualization_expert' | 'thinker' | 'worker' | 'verifier' | 'custom';
366
365
  /**
367
366
  * Agent capabilities.
368
367
  */
@@ -1543,17 +1542,6 @@ type OrchestrationObserverEvent = {
1543
1542
  * Observer event listener function.
1544
1543
  */
1545
1544
  type OrchestrationObserverListener = (event: OrchestrationObserverEvent) => void;
1546
- /**
1547
- * OrchestrationObserver configuration schema.
1548
- */
1549
- declare const OrchestrationObserverConfigSchema: z.ZodObject<{
1550
- maxRoutingHistory: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1551
- maxSessionHistory: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1552
- metricsUpdateIntervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1553
- verboseLogging: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1554
- tokenCostRates: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
1555
- }, z.core.$strip>;
1556
- type OrchestrationObserverConfig = z.infer<typeof OrchestrationObserverConfigSchema>;
1557
1545
  /**
1558
1546
  * OrchestrationObserver interface for dependency injection.
1559
1547
  */
@@ -1581,47 +1569,6 @@ interface IOrchestrationObserver {
1581
1569
  /** Check if observer is active */
1582
1570
  isActive(): boolean;
1583
1571
  }
1584
- /**
1585
- * Event topics the SwarmObserver subscribes to.
1586
- */
1587
- declare const ObserverTopics: {
1588
- /** All session events */
1589
- readonly SESSIONS: "session.*";
1590
- /** All agent events */
1591
- readonly AGENTS: "agent.*";
1592
- /** All consensus events */
1593
- readonly CONSENSUS: "consensus.*";
1594
- /** All protocol events */
1595
- readonly PROTOCOLS: "protocol.*";
1596
- /** Catch-all for any missed events */
1597
- readonly ALL: "*";
1598
- };
1599
- /**
1600
- * Options for creating an OrchestrationObserver.
1601
- */
1602
- interface OrchestrationObserverOptions {
1603
- config?: Partial<OrchestrationObserverConfig> | undefined;
1604
- logger?: ILogger | undefined;
1605
- }
1606
- /** @deprecated Use OrchestrationStats instead */
1607
- type SwarmStats = OrchestrationStats;
1608
- /** @deprecated Use OrchestrationObserverEvent instead */
1609
- type SwarmObserverEvent = OrchestrationObserverEvent;
1610
- /** @deprecated Use OrchestrationObserverListener instead */
1611
- type SwarmObserverListener = OrchestrationObserverListener;
1612
- /** @deprecated Use OrchestrationObserverConfig instead */
1613
- type SwarmObserverConfig$1 = OrchestrationObserverConfig;
1614
- declare const SwarmObserverConfigSchema$1: z.ZodObject<{
1615
- maxRoutingHistory: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1616
- maxSessionHistory: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1617
- metricsUpdateIntervalMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1618
- verboseLogging: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
1619
- tokenCostRates: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>>;
1620
- }, z.core.$strip>;
1621
- /** @deprecated Use IOrchestrationObserver instead */
1622
- type ISwarmObserver$1 = IOrchestrationObserver;
1623
- /** @deprecated Use OrchestrationObserverOptions instead */
1624
- type SwarmObserverOptions = OrchestrationObserverOptions;
1625
1572
 
1626
1573
  /**
1627
1574
  * nexus-agents/cli-adapters - ZeroRouter Types
@@ -2464,6 +2411,8 @@ declare const TaskOutcomeSchema$2: z.ZodObject<{
2464
2411
  }>;
2465
2412
  wasRetried: z.ZodOptional<z.ZodBoolean>;
2466
2413
  triageAction: z.ZodOptional<z.ZodString>;
2414
+ routingStage: z.ZodOptional<z.ZodString>;
2415
+ retryCount: z.ZodOptional<z.ZodNumber>;
2467
2416
  }, z.core.$strip>;
2468
2417
  /** Schema for filtering outcomes. */
2469
2418
  declare const OutcomeQuerySchema: z.ZodObject<{
@@ -2506,6 +2455,7 @@ declare const OutcomeQuerySchema: z.ZodObject<{
2506
2455
  }>>;
2507
2456
  since: z.ZodOptional<z.ZodString>;
2508
2457
  limit: z.ZodOptional<z.ZodNumber>;
2458
+ excludeQualitySignals: z.ZodOptional<z.ZodArray<z.ZodString>>;
2509
2459
  }, z.core.$strip>;
2510
2460
  /** A single recorded task execution outcome. */
2511
2461
  type TaskOutcome$2 = z.infer<typeof TaskOutcomeSchema$2>;
@@ -3009,7 +2959,11 @@ declare class CompositeRouter implements ICompositeRouter {
3009
2959
  private initializeCoreRouters;
3010
2960
  private initializeMemoryAndStages;
3011
2961
  private initializeOptionalStages;
3012
- /** Warm-start LinUCB bandit from persisted outcomes (Issue #1015). Best-effort. */
2962
+ /** Emit routing.decision event to pipeline event bus (#1687). */
2963
+ private emitRoutingDecision;
2964
+ /** Warm-start LinUCB bandit from persisted outcomes (Issue #1015).
2965
+ * Uses a 30-day lookback window so stale outcomes don't override
2966
+ * routing changes like primaryCli specialization (#1667). */
3013
2967
  private warmStartBandit;
3014
2968
  private logInitialization;
3015
2969
  route(task: CliTask): Promise<Result<CompositeRoutingDecision, CompositeRoutingError>>;
@@ -4383,6 +4337,21 @@ declare const AppConfigSchema: z.ZodObject<{
4383
4337
  ANALYZED: "ANALYZED";
4384
4338
  ORCHESTRATED: "ORCHESTRATED";
4385
4339
  }>>>;
4340
+ upstreamServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
4341
+ name: z.ZodString;
4342
+ command: z.ZodEnum<{
4343
+ docker: "docker";
4344
+ python: "python";
4345
+ node: "node";
4346
+ npx: "npx";
4347
+ python3: "python3";
4348
+ uvx: "uvx";
4349
+ }>;
4350
+ args: z.ZodDefault<z.ZodArray<z.ZodString>>;
4351
+ env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
4352
+ lazy: z.ZodDefault<z.ZodBoolean>;
4353
+ timeoutMs: z.ZodDefault<z.ZodNumber>;
4354
+ }, z.core.$strip>>>;
4386
4355
  }, z.core.$strip>>;
4387
4356
  }, z.core.$strip>;
4388
4357
  type AppConfig = z.infer<typeof AppConfigSchema>;
@@ -5022,7 +4991,7 @@ declare function calculateDelay(attempt: number, config: RetryConfig): number;
5022
4991
  * @param error - The error to check
5023
4992
  * @returns True if the error is retryable
5024
4993
  */
5025
- declare function isRetryableError(error: unknown): boolean;
4994
+ declare function isRetryableError$1(error: unknown): boolean;
5026
4995
  /**
5027
4996
  * Options for withRetry function.
5028
4997
  */
@@ -5626,10 +5595,6 @@ declare class ClaudeAdapter extends BaseAdapter {
5626
5595
  * Executes streaming completion and pushes chunks to the controller.
5627
5596
  */
5628
5597
  private executeStream;
5629
- /**
5630
- * Extracts system prompt from request, checking both systemPrompt field and messages.
5631
- */
5632
- private extractSystemPrompt;
5633
5598
  /**
5634
5599
  * Builds Anthropic API request parameters from our CompletionRequest.
5635
5600
  */
@@ -5868,7 +5833,6 @@ declare class OllamaAdapter extends BaseAdapter {
5868
5833
  stream(request: CompletionRequest): AsyncIterable<StreamChunk>;
5869
5834
  countTokens(text: string): Promise<number>;
5870
5835
  private executeStream;
5871
- private extractSystemPrompt;
5872
5836
  private buildOptions;
5873
5837
  private applyFormatAndTools;
5874
5838
  private buildRequestParams;
@@ -5996,10 +5960,6 @@ declare class GeminiAdapter extends BaseAdapter {
5996
5960
  * Executes streaming completion and pushes chunks to the controller.
5997
5961
  */
5998
5962
  private executeStream;
5999
- /**
6000
- * Extracts system prompt from request.
6001
- */
6002
- private extractSystemPrompt;
6003
5963
  /**
6004
5964
  * Builds generation config from request parameters.
6005
5965
  */
@@ -6240,6 +6200,35 @@ interface CircuitStateChangeEvent {
6240
6200
  * Event listener for circuit state changes.
6241
6201
  */
6242
6202
  type CircuitStateChangeListener = (event: CircuitStateChangeEvent) => void;
6203
+ /**
6204
+ * Interface for circuit breaker operations.
6205
+ */
6206
+ interface ICircuitBreaker {
6207
+ /**
6208
+ * Executes a function with circuit breaker protection.
6209
+ */
6210
+ execute<T>(fn: () => Promise<T>): Promise<Result<T, CircuitError>>;
6211
+ /**
6212
+ * Gets the current circuit state.
6213
+ */
6214
+ getState(): CircuitState;
6215
+ /**
6216
+ * Gets a full snapshot of circuit breaker state.
6217
+ */
6218
+ getSnapshot(): CircuitBreakerSnapshot;
6219
+ /**
6220
+ * Manually resets the circuit breaker to closed state.
6221
+ */
6222
+ reset(): void;
6223
+ /**
6224
+ * Records a failure manually (for external failure detection).
6225
+ */
6226
+ recordFailure(category: FailureCategory$1): void;
6227
+ /**
6228
+ * Records a success manually (for external success detection).
6229
+ */
6230
+ recordSuccess(): void;
6231
+ }
6243
6232
  /**
6244
6233
  * Error codes specific to circuit breaker.
6245
6234
  */
@@ -8860,6 +8849,27 @@ interface TaskAnalysis {
8860
8849
  approach: string;
8861
8850
  /** Estimated total effort in relative units */
8862
8851
  estimatedEffort: number;
8852
+ /**
8853
+ * Commit-before-generate block (#1827).
8854
+ * Forces the orchestrator to commit to a direction before dispatching workers,
8855
+ * countering LLM mode-collapse toward safe defaults. Optional for backward
8856
+ * compatibility with older analysis outputs.
8857
+ */
8858
+ commitment?: TaskCommitment | undefined;
8859
+ }
8860
+ /**
8861
+ * Orchestrator's directional commitment, emitted before decomposition (#1827).
8862
+ * Modeled after the `frontend-design` plugin's Design Thinking pre-phase.
8863
+ */
8864
+ interface TaskCommitment {
8865
+ /** What this task is fundamentally about (one sentence). */
8866
+ purpose: string;
8867
+ /** The non-obvious choice being made. */
8868
+ approach: string;
8869
+ /** What would make the output worse if solved by default patterns. */
8870
+ differentiation: string;
8871
+ /** Hard limits: deadlines, scope boundaries, invariants. */
8872
+ constraints: string[];
8863
8873
  }
8864
8874
  /**
8865
8875
  * Expert assignment for a subtask.
@@ -9027,6 +9037,12 @@ declare const TaskAnalysisSchema: z.ZodObject<{
9027
9037
  needsDecomposition: z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>, z.ZodTransform<boolean, string | boolean>>;
9028
9038
  approach: z.ZodString;
9029
9039
  estimatedEffort: z.ZodPipe<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>, z.ZodTransform<number, string | number>>;
9040
+ commitment: z.ZodOptional<z.ZodObject<{
9041
+ purpose: z.ZodString;
9042
+ approach: z.ZodString;
9043
+ differentiation: z.ZodString;
9044
+ constraints: z.ZodArray<z.ZodString>;
9045
+ }, z.core.$strip>>;
9030
9046
  }, z.core.$strip>;
9031
9047
  /**
9032
9048
  * Zod schema for ExpertAssignment.
@@ -10555,13 +10571,15 @@ interface ExpertConfig {
10555
10571
  capabilities: AgentCapability[];
10556
10572
  /** Optional model preferences */
10557
10573
  modelPreference?: ModelPreference;
10574
+ /** Optional tool restrictions (allowlist/denylist per role) */
10575
+ toolRestrictions?: ToolRestrictions;
10558
10576
  /** Optional metadata for extensions */
10559
10577
  metadata?: Record<string, unknown>;
10560
10578
  }
10561
10579
  /**
10562
10580
  * Built-in expert type identifiers.
10563
10581
  */
10564
- type BuiltInExpertType = 'code' | 'architecture' | 'security' | 'documentation' | 'testing' | 'devops' | 'research' | 'pm' | 'ux' | 'infrastructure';
10582
+ type BuiltInExpertType = 'code' | 'architecture' | 'security' | 'documentation' | 'testing' | 'devops' | 'research' | 'pm' | 'ux' | 'infrastructure' | 'qa' | 'data-visualization';
10565
10583
  /**
10566
10584
  * Zod schema for ModelPreference.
10567
10585
  */
@@ -10574,6 +10592,17 @@ declare const ModelPreferenceSchema: z.ZodObject<{
10574
10592
  /**
10575
10593
  * Zod schema for ExpertConfig.
10576
10594
  */
10595
+ /**
10596
+ * Tool restriction configuration for expert roles.
10597
+ * Inspired by Augment Code's subagent tool access control.
10598
+ * Allowlist takes priority — if set, only listed tools are available.
10599
+ * Denylist blocks specific tools (used when allowlist is not set).
10600
+ */
10601
+ declare const ToolRestrictionsSchema: z.ZodOptional<z.ZodObject<{
10602
+ allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
10603
+ deniedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
10604
+ }, z.core.$strip>>;
10605
+ type ToolRestrictions = z.infer<typeof ToolRestrictionsSchema>;
10577
10606
  declare const ExpertConfigSchema: z.ZodObject<{
10578
10607
  id: z.ZodString;
10579
10608
  name: z.ZodString;
@@ -10590,6 +10619,8 @@ declare const ExpertConfigSchema: z.ZodObject<{
10590
10619
  pm_expert: "pm_expert";
10591
10620
  ux_expert: "ux_expert";
10592
10621
  infrastructure_expert: "infrastructure_expert";
10622
+ qa_expert: "qa_expert";
10623
+ data_visualization_expert: "data_visualization_expert";
10593
10624
  }>;
10594
10625
  systemPrompt: z.ZodString;
10595
10626
  capabilities: z.ZodArray<z.ZodEnum<{
@@ -10607,6 +10638,10 @@ declare const ExpertConfigSchema: z.ZodObject<{
10607
10638
  temperature: z.ZodOptional<z.ZodNumber>;
10608
10639
  maxTokens: z.ZodOptional<z.ZodNumber>;
10609
10640
  }, z.core.$strip>>;
10641
+ toolRestrictions: z.ZodOptional<z.ZodObject<{
10642
+ allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
10643
+ deniedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
10644
+ }, z.core.$strip>>;
10610
10645
  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
10611
10646
  }, z.core.$strip>;
10612
10647
  /**
@@ -10623,6 +10658,7 @@ declare const BuiltInExpertTypeSchema: z.ZodEnum<{
10623
10658
  devops: "devops";
10624
10659
  pm: "pm";
10625
10660
  ux: "ux";
10661
+ "data-visualization": "data-visualization";
10626
10662
  }>;
10627
10663
  /**
10628
10664
  * Built-in expert configurations.
@@ -13012,206 +13048,6 @@ declare class SkillLoader implements ISkillLoader {
13012
13048
  */
13013
13049
  declare function createSkillLoader(library: SkillLibrary, config?: Partial<SkillLoaderConfig>, logger?: ILogger): ISkillLoader;
13014
13050
 
13015
- /**
13016
- * OrchestrationObserver - Real-time multi-agent orchestration visibility.
13017
- * (Source: Issue #187, renamed from SwarmObserver in Issue #251)
13018
- * @module agents/observability/orchestration-observer
13019
- */
13020
-
13021
- /**
13022
- * Provides real-time visibility into multi-agent orchestration.
13023
- * Tracks agent states, routing decisions, session metrics, and costs.
13024
- */
13025
- declare class OrchestrationObserver implements IOrchestrationObserver {
13026
- private readonly eventBus;
13027
- private readonly config;
13028
- private readonly logger;
13029
- private readonly agents;
13030
- private readonly routingHistory;
13031
- private readonly sessionMetrics;
13032
- private readonly listeners;
13033
- private readonly subscriptions;
13034
- private active;
13035
- private readonly startTime;
13036
- private totalTasks;
13037
- private successfulTasks;
13038
- private totalTaskDurationMs;
13039
- private eventsProcessed;
13040
- private consensusVotesRequested;
13041
- private consensusVotesCast;
13042
- private consensusReachedCount;
13043
- private consensusApproved;
13044
- private consensusRejected;
13045
- private consensusAbstained;
13046
- private consensusUnanimous;
13047
- constructor(eventBus: IEventBus$1, options?: OrchestrationObserverOptions);
13048
- start(): void;
13049
- stop(): void;
13050
- private subscribeToEvents;
13051
- private handleSessionEvent;
13052
- private handleAgentEvent;
13053
- /**
13054
- * Handles consensus events and tracks voting statistics.
13055
- * (Source: Issue #552 - Wire up consensus event handlers)
13056
- */
13057
- private handleConsensusEvent;
13058
- private onVoteRequested;
13059
- private onVoteCast;
13060
- private onConsensusReached;
13061
- private logVerbose;
13062
- private handleProtocolEvent;
13063
- private onSessionCreated;
13064
- private onSessionStatusChanged;
13065
- private onResultSubmitted;
13066
- private onSessionFinalized;
13067
- private onTaskDelegated;
13068
- private onResultBroadcast;
13069
- private updateAgentState;
13070
- private pruneOldMetrics;
13071
- getAgentStates(): readonly TrackedAgent[];
13072
- getRoutingHistory(limit?: number): readonly RoutingDecision$2[];
13073
- getSessionMetrics(sessionId?: string): readonly SessionMetrics[];
13074
- getStats(): OrchestrationStats;
13075
- recordRoutingDecision(decision: RoutingDecision$2): void;
13076
- recordTokenUsage(sessionId: string, model: CliName, tokens: TokenUsage$1): void;
13077
- addEventListener(listener: OrchestrationObserverListener): void;
13078
- removeEventListener(listener: OrchestrationObserverListener): void;
13079
- private emitObserverEvent;
13080
- isActive(): boolean;
13081
- }
13082
- /** Creates an OrchestrationObserver instance. */
13083
- declare function createOrchestrationObserver(eventBus: IEventBus$1, options?: OrchestrationObserverOptions): IOrchestrationObserver;
13084
- declare const SwarmObserver$1: typeof OrchestrationObserver;
13085
- declare const createSwarmObserver$1: typeof createOrchestrationObserver;
13086
-
13087
- /**
13088
- * nexus-agents/agents - OrchestrationObserver Helper Functions
13089
- *
13090
- * Pure helper functions for OrchestrationObserver that don't depend on class state.
13091
- * Extracted to reduce main class file size and improve testability.
13092
- *
13093
- * @module agents/observability/orchestration-observer-helpers
13094
- */
13095
-
13096
- /**
13097
- * Extracts a string field from a payload object safely.
13098
- *
13099
- * @param payload - The payload object to extract from
13100
- * @param field - The field name to extract
13101
- * @returns The string value or empty string if not found/invalid
13102
- */
13103
- declare function extractStringField(payload: Record<string, unknown>, field: string): string;
13104
- /**
13105
- * Extracts a number field from a payload object safely.
13106
- *
13107
- * @param payload - The payload object to extract from
13108
- * @param field - The field name to extract
13109
- * @param defaultValue - Default value if not found
13110
- * @returns The number value or default if not found/invalid
13111
- */
13112
- declare function extractNumberField(payload: Record<string, unknown>, field: string, defaultValue?: number): number;
13113
- /**
13114
- * Extracts a boolean field from a payload object safely.
13115
- *
13116
- * @param payload - The payload object to extract from
13117
- * @param field - The field name to extract
13118
- * @returns The boolean value (defaults to false if not found/invalid)
13119
- */
13120
- declare function extractBooleanField(payload: Record<string, unknown>, field: string): boolean;
13121
- /**
13122
- * Extracts a string array field from a payload object safely.
13123
- *
13124
- * @param payload - The payload object to extract from
13125
- * @param field - The field name to extract
13126
- * @returns The string array or empty array if not found/invalid
13127
- */
13128
- declare function extractStringArrayField(payload: Record<string, unknown>, field: string): string[];
13129
- /**
13130
- * Extracts session ID from event object or payload.
13131
- *
13132
- * @param event - The domain event
13133
- * @param payload - The event payload
13134
- * @returns The session ID or empty string if not found
13135
- */
13136
- declare function extractSessionId(event: DomainEvent, payload: Record<string, unknown>): string;
13137
- /**
13138
- * Creates initial session metrics with default values.
13139
- *
13140
- * @param sessionId - The session ID
13141
- * @returns A new SessionMetrics object with initial values
13142
- */
13143
- declare function createInitialSessionMetrics(sessionId: string): SessionMetrics;
13144
- /**
13145
- * Creates initial token usage with zero values.
13146
- *
13147
- * @returns A new TokenUsage object with zero values
13148
- */
13149
- declare function createInitialTokenUsage(): TokenUsage$1;
13150
- /**
13151
- * Creates initial cost metrics with zero values.
13152
- *
13153
- * @returns A new CostMetrics object with zero values
13154
- */
13155
- declare function createInitialCostMetrics(): CostMetrics;
13156
- /**
13157
- * Creates a new TrackedAgent object with initial values.
13158
- *
13159
- * @param agentId - The agent ID
13160
- * @param state - The initial agent state
13161
- * @param role - The agent role (defaults to 'unknown')
13162
- * @param currentTask - Optional current task description
13163
- * @returns A new TrackedAgent object
13164
- */
13165
- declare function createTrackedAgent(agentId: string, state: AgentState$1, role?: string, currentTask?: string): TrackedAgent;
13166
- /**
13167
- * Calculates routing distribution from routing history.
13168
- *
13169
- * @param routingHistory - The routing decision history
13170
- * @returns A record mapping CLI names to counts
13171
- */
13172
- declare function calculateRoutingDistribution(routingHistory: readonly RoutingDecision$2[]): Record<CliName, number>;
13173
- /**
13174
- * Aggregates token and cost totals from session metrics.
13175
- *
13176
- * @param sessionMetrics - Iterable of session metrics
13177
- * @returns Object containing total tokens and total cost
13178
- */
13179
- declare function calculateMetricsTotals(sessionMetrics: Iterable<SessionMetrics>): {
13180
- totalTokens: number;
13181
- totalCost: number;
13182
- };
13183
- /**
13184
- * Counts active sessions (sessions without a completedAt timestamp).
13185
- *
13186
- * @param sessionMetrics - Iterable of session metrics
13187
- * @returns The count of active sessions
13188
- */
13189
- declare function countActiveSessions(sessionMetrics: Iterable<SessionMetrics>): number;
13190
- /**
13191
- * Finds the first active session (no completedAt) from metrics.
13192
- *
13193
- * @param sessionMetrics - Iterable of session metrics
13194
- * @returns The first active session or undefined
13195
- */
13196
- declare function findActiveSession(sessionMetrics: Iterable<SessionMetrics>): SessionMetrics | undefined;
13197
- /**
13198
- * Identifies session IDs to remove based on max history limit.
13199
- * Returns oldest sessions first.
13200
- *
13201
- * @param sessions - Array of [sessionId, metrics] entries
13202
- * @param maxSessions - Maximum sessions to keep
13203
- * @returns Array of session IDs to remove
13204
- */
13205
- declare function identifySessionsToRemove(sessions: Array<[string, SessionMetrics]>, maxSessions: number): string[];
13206
- /**
13207
- * Calculates the cost for token usage based on rate.
13208
- *
13209
- * @param tokens - Token usage to calculate cost for
13210
- * @param ratePerThousand - Cost rate per 1000 tokens
13211
- * @returns The calculated cost in USD
13212
- */
13213
- declare function calculateTokenCost(tokens: TokenUsage$1, ratePerThousand: number): number;
13214
-
13215
13051
  /**
13216
13052
  * nexus-agents/agents - Forest-of-Thought Node Types
13217
13053
  *
@@ -18821,6 +18657,7 @@ declare const CreateExpertInputSchema: z.ZodObject<{
18821
18657
  pm_expert: "pm_expert";
18822
18658
  ux_expert: "ux_expert";
18823
18659
  infrastructure_expert: "infrastructure_expert";
18660
+ data_visualization_expert: "data_visualization_expert";
18824
18661
  }>;
18825
18662
  modelPreference: z.ZodOptional<z.ZodString>;
18826
18663
  }, z.core.$strip>;
@@ -18876,6 +18713,7 @@ interface CreateExpertResponse {
18876
18713
  * Uses createSecureHandler for standardized security middleware (Issue #531).
18877
18714
  * Includes timeout protection for CVE-2026-0621 mitigation (Issue #271).
18878
18715
  *
18716
+ * @category MCP
18879
18717
  * @param server - MCP server instance
18880
18718
  * @param deps - Tool dependencies
18881
18719
  */
@@ -18971,6 +18809,7 @@ interface RunWorkflowDeps extends BaseMcpToolDeps {
18971
18809
  * Uses createSecureHandler for standardized security middleware (Issue #531).
18972
18810
  * Includes timeout protection for CVE-2026-0621 mitigation (Issue #271).
18973
18811
  *
18812
+ * @category MCP
18974
18813
  * @param server - MCP server instance
18975
18814
  * @param deps - Tool dependencies
18976
18815
  */
@@ -19171,6 +19010,7 @@ declare class OrchestrationUnavailableError extends AgentError {
19171
19010
  /**
19172
19011
  * Registers the orchestrate tool with the MCP server.
19173
19012
  * Uses createSecureHandler (Issue #531) with timeout protection (Issue #271).
19013
+ * @category MCP
19174
19014
  */
19175
19015
  declare function registerOrchestrateTool(server: McpServer, deps: OrchestrateDeps): void;
19176
19016
 
@@ -20229,6 +20069,7 @@ declare function selectModel(input: DelegateInput, requirements: TaskRequirement
20229
20069
  * Uses createSecureHandler for standardized security middleware (Issue #531).
20230
20070
  * Includes timeout protection for CVE-2026-0621 mitigation (Issue #271).
20231
20071
  *
20072
+ * @category MCP
20232
20073
  * @param server - MCP server instance
20233
20074
  * @param deps - Dependencies
20234
20075
  */
@@ -20868,6 +20709,7 @@ interface ListExpertsResponse {
20868
20709
  * Uses createSecureHandler for standardized security middleware (Issue #531).
20869
20710
  * Includes timeout protection for CVE-2026-0621 mitigation (Issue #271).
20870
20711
  *
20712
+ * @category MCP
20871
20713
  * @param server - MCP server instance
20872
20714
  * @param deps - Tool dependencies
20873
20715
  */
@@ -20935,6 +20777,7 @@ interface ListWorkflowsResponse {
20935
20777
  * Uses createSecureHandler for standardized security middleware (Issue #531).
20936
20778
  * Includes timeout protection for CVE-2026-0621 mitigation (Issue #271).
20937
20779
  *
20780
+ * @category MCP
20938
20781
  * @param server - MCP server instance
20939
20782
  * @param deps - Tool dependencies
20940
20783
  */
@@ -20959,6 +20802,7 @@ declare const ExecuteExpertInputSchema: z.ZodObject<{
20959
20802
  task: z.ZodString;
20960
20803
  context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
20961
20804
  timeoutMs: z.ZodOptional<z.ZodNumber>;
20805
+ previousExpertSummary: z.ZodOptional<z.ZodString>;
20962
20806
  }, z.core.$strip>;
20963
20807
  /**
20964
20808
  * Type for validated execute expert input.
@@ -21005,6 +20849,7 @@ interface ExecuteExpertResponse {
21005
20849
  * Uses createSecureHandler for standardized security middleware (Issue #531).
21006
20850
  * Includes timeout protection for CVE-2026-0621 mitigation (Issue #271).
21007
20851
  *
20852
+ * @category MCP
21008
20853
  * @param server - MCP server instance
21009
20854
  * @param deps - Tool dependencies
21010
20855
  */
@@ -21024,6 +20869,7 @@ declare function registerExecuteExpertTool(server: McpServer, deps: ExecuteExper
21024
20869
  * - unanimous: 100% approval required
21025
20870
  * - proof_of_learning: weighted voting based on agent performance
21026
20871
  * - opinion_wise: higher-order voting with correlation awareness (Issue #333)
20872
+ * - higher_order: alias for opinion_wise (Issue #514)
21027
20873
  */
21028
20874
  declare const ConsensusAlgorithmSchema: z.ZodEnum<{
21029
20875
  simple_majority: "simple_majority";
@@ -21031,6 +20877,7 @@ declare const ConsensusAlgorithmSchema: z.ZodEnum<{
21031
20877
  unanimous: "unanimous";
21032
20878
  proof_of_learning: "proof_of_learning";
21033
20879
  opinion_wise: "opinion_wise";
20880
+ higher_order: "higher_order";
21034
20881
  }>;
21035
20882
  type ConsensusAlgorithm = z.infer<typeof ConsensusAlgorithmSchema>;
21036
20883
  /**
@@ -21109,6 +20956,7 @@ declare const ProposalSchema: z.ZodObject<{
21109
20956
  unanimous: "unanimous";
21110
20957
  proof_of_learning: "proof_of_learning";
21111
20958
  opinion_wise: "opinion_wise";
20959
+ higher_order: "higher_order";
21112
20960
  }>;
21113
20961
  timeout: z.ZodOptional<z.ZodNumber>;
21114
20962
  requiredVoters: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -21169,6 +21017,7 @@ declare const ConsensusResultSchema: z.ZodObject<{
21169
21017
  unanimous: "unanimous";
21170
21018
  proof_of_learning: "proof_of_learning";
21171
21019
  opinion_wise: "opinion_wise";
21020
+ higher_order: "higher_order";
21172
21021
  }>;
21173
21022
  timeout: z.ZodOptional<z.ZodNumber>;
21174
21023
  requiredVoters: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -21352,6 +21201,7 @@ declare const ConsensusMetricsSchema: z.ZodObject<{
21352
21201
  unanimous: "unanimous";
21353
21202
  proof_of_learning: "proof_of_learning";
21354
21203
  opinion_wise: "opinion_wise";
21204
+ higher_order: "higher_order";
21355
21205
  }>, z.ZodNumber>;
21356
21206
  }, z.core.$strip>;
21357
21207
 
@@ -21994,8 +21844,9 @@ interface IHigherOrderVoting {
21994
21844
  * - `unanimous`: Requires 100% approval
21995
21845
  * - `proof_of_learning`: Weighted by agent performance (Issue #103)
21996
21846
  * - `higher_order`: Bayesian-optimal with correlation awareness (Issue #514)
21847
+ * - `opinion_wise`: Alias for higher_order (Issue #333)
21997
21848
  */
21998
- type VotingStrategy = 'simple_majority' | 'supermajority' | 'unanimous' | 'proof_of_learning' | 'higher_order';
21849
+ type VotingStrategy = 'simple_majority' | 'supermajority' | 'unanimous' | 'proof_of_learning' | 'higher_order' | 'opinion_wise';
21999
21850
  declare const ConsensusVoteInputSchema: z.ZodObject<{
22000
21851
  proposal: z.ZodString;
22001
21852
  threshold: z.ZodOptional<z.ZodEnum<{
@@ -22008,6 +21859,7 @@ declare const ConsensusVoteInputSchema: z.ZodObject<{
22008
21859
  supermajority: "supermajority";
22009
21860
  unanimous: "unanimous";
22010
21861
  proof_of_learning: "proof_of_learning";
21862
+ opinion_wise: "opinion_wise";
22011
21863
  higher_order: "higher_order";
22012
21864
  }>>;
22013
21865
  quickMode: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -22057,11 +21909,6 @@ interface ConsensusVoteResponse {
22057
21909
  higherOrderMetadata?: HigherOrderMetadata;
22058
21910
  }
22059
21911
 
22060
- /**
22061
- * nexus-agents/mcp - Consensus Vote Tool
22062
- * @module mcp/tools/consensus-vote
22063
- */
22064
-
22065
21912
  interface ConsensusVoteDeps extends BaseMcpToolDeps {
22066
21913
  /** MCP notifier for client-visible logging (Issue #974) */
22067
21914
  notifier?: IMcpNotifier | undefined;
@@ -22069,63 +21916,443 @@ interface ConsensusVoteDeps extends BaseMcpToolDeps {
22069
21916
  /**
22070
21917
  * Registers the consensus_vote tool with the MCP server.
22071
21918
  * Uses createSecureHandler (Issue #531) with timeout protection (Issue #271).
21919
+ * @category MCP
22072
21920
  */
22073
21921
  declare function registerConsensusVoteTool(server: McpServer, deps: ConsensusVoteDeps): void;
22074
21922
 
22075
21923
  /**
22076
- * nexus-agents/mcp - Issue Triage Tool
21924
+ * nexus-agents/mcp - Research Query Tool
22077
21925
  *
22078
- * MCP tool for automated GitHub issue triage using the full
22079
- * security pipeline (8/8 modules). Read-only by default.
21926
+ * MCP tool for querying the research registry.
21927
+ * Wraps existing CLI helpers: getResearchStatus(), findOverlaps(), generateStatsJson().
22080
21928
  *
22081
- * @module mcp/tools/issue-triage-tool
22082
- * (Source: Issue #828 Wire remaining security modules)
21929
+ * @module mcp/tools/research-query
21930
+ * (Source: Research System Enhancement - Phase 1A)
22083
21931
  */
22084
21932
 
22085
- declare const IssueTriageInputSchema: z.ZodObject<{
22086
- issueUrl: z.ZodString;
22087
- dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22088
- }, z.core.$strip>;
22089
- type IssueTriageInput = z.infer<typeof IssueTriageInputSchema>;
22090
- type IssueTriageDeps = BaseMcpToolDeps;
22091
- interface IssueTriageResponse {
22092
- readonly issueNumber: number;
22093
- readonly repository: string;
22094
- readonly category: string;
22095
- readonly categoryConfidence: number;
22096
- readonly trustAssessment: {
22097
- readonly trustTier: string;
22098
- readonly userRole: string;
22099
- readonly reputationScore?: number | undefined;
22100
- readonly isSuspicious: boolean;
22101
- readonly suspiciousSignals: readonly string[];
22102
- };
22103
- readonly proposedActions: ReadonlyArray<{
22104
- readonly type: string;
22105
- readonly description: string;
22106
- readonly policyApproved: boolean;
22107
- readonly corroborated: boolean;
21933
+ /**
21934
+ * Input schema for research_query tool.
21935
+ */
21936
+ declare const ResearchQueryInputSchema: z.ZodObject<{
21937
+ action: z.ZodEnum<{
21938
+ status: "status";
21939
+ search: "search";
21940
+ stats: "stats";
21941
+ overlap: "overlap";
22108
21942
  }>;
22109
- readonly durationMs: number;
21943
+ techniqueId: z.ZodOptional<z.ZodString>;
21944
+ query: z.ZodOptional<z.ZodString>;
21945
+ status: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
21946
+ rejected: "rejected";
21947
+ all: "all";
21948
+ implemented: "implemented";
21949
+ planned: "planned";
21950
+ "not-started": "not-started";
21951
+ }>>>;
21952
+ threshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
21953
+ }, z.core.$strip>;
21954
+ /**
21955
+ * Type for validated research query input.
21956
+ */
21957
+ type ResearchQueryInput = z.infer<typeof ResearchQueryInputSchema>;
21958
+ /**
21959
+ * Dependencies for research_query tool.
21960
+ */
21961
+ type ResearchQueryDeps = BaseMcpToolDeps;
21962
+ /**
21963
+ * Response from research_query tool.
21964
+ */
21965
+ interface ResearchQueryResponse {
21966
+ /** Action that was performed */
21967
+ action: string;
21968
+ /** Whether the query succeeded */
21969
+ success: boolean;
21970
+ /** Query results */
21971
+ data: unknown;
22110
21972
  }
22111
21973
  /**
22112
- * Registers the issue_triage tool with the MCP server.
22113
- * Uses createSecureHandler for rate limiting and input sanitization.
21974
+ * Registers the research_query tool with the MCP server.
21975
+ *
21976
+ * @category MCP
21977
+ * @param server - MCP server instance
21978
+ * @param deps - Tool dependencies
22114
21979
  */
22115
- declare function registerIssueTriageTool(server: McpServer, deps: IssueTriageDeps): void;
21980
+ declare function registerResearchQueryTool(server: McpServer, deps: ResearchQueryDeps): void;
22116
21981
 
22117
21982
  /**
22118
- * nexus-agents/mcp - Run Graph Workflow Tool
21983
+ * nexus-agents/mcp - Research Add Tool
22119
21984
  *
22120
- * MCP tool for executing graph-based workflows with checkpointing,
22121
- * event streaming, and audit trail integration.
21985
+ * MCP tool for adding papers to the research registry.
21986
+ * Wraps existing CLI helpers: addResearchPaper(), fetchArxivMetadataResult().
22122
21987
  *
22123
- * @module mcp/tools/run-graph-workflow
22124
- * (Source: Issue #840 Expose graph workflows via MCP tool)
21988
+ * @module mcp/tools/research-add
21989
+ * (Source: Research System Enhancement - Phase 1B)
22125
21990
  */
22126
21991
 
22127
- declare const RunGraphWorkflowInputSchema: z.ZodObject<{
22128
- workflow: z.ZodString;
21992
+ /**
21993
+ * Input schema for research_add tool.
21994
+ */
21995
+ declare const ResearchAddInputSchema: z.ZodObject<{
21996
+ arxivId: z.ZodString;
21997
+ topic: z.ZodOptional<z.ZodString>;
21998
+ priority: z.ZodOptional<z.ZodEnum<{
21999
+ P1: "P1";
22000
+ P2: "P2";
22001
+ P3: "P3";
22002
+ P4: "P4";
22003
+ }>>;
22004
+ dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22005
+ }, z.core.$strip>;
22006
+ /**
22007
+ * Type for validated research add input.
22008
+ */
22009
+ type ResearchAddInput = z.infer<typeof ResearchAddInputSchema>;
22010
+ /**
22011
+ * Dependencies for research_add tool.
22012
+ */
22013
+ type ResearchAddDeps = BaseMcpToolDeps;
22014
+ /**
22015
+ * Response from research_add tool.
22016
+ */
22017
+ interface ResearchAddResponse {
22018
+ /** Whether the operation succeeded */
22019
+ success: boolean;
22020
+ /** Paper ID */
22021
+ paperId: string;
22022
+ /** Paper title (empty on failure) */
22023
+ title: string;
22024
+ /** Human-readable message */
22025
+ message: string;
22026
+ /** Whether this was a dry run */
22027
+ dryRun: boolean;
22028
+ }
22029
+ /**
22030
+ * Registers the research_add tool with the MCP server.
22031
+ *
22032
+ * @category MCP
22033
+ * @param server - MCP server instance
22034
+ * @param deps - Tool dependencies
22035
+ */
22036
+ declare function registerResearchAddTool(server: McpServer, deps: ResearchAddDeps): void;
22037
+
22038
+ /**
22039
+ * nexus-agents/mcp - Research Add Source Tool
22040
+ *
22041
+ * MCP tool for adding non-paper sources (repos, tools, blogs) to the
22042
+ * research registry. Accepts pre-populated metadata or fetches from
22043
+ * GitHub via `gh` CLI (optional, graceful fallback).
22044
+ *
22045
+ * @module mcp/tools/research-add-source
22046
+ * @see Issue #1580
22047
+ */
22048
+
22049
+ declare const ResearchAddSourceInputSchema: z.ZodObject<{
22050
+ url: z.ZodString;
22051
+ name: z.ZodString;
22052
+ type: z.ZodEnum<{
22053
+ code_analysis: "code_analysis";
22054
+ specification: "specification";
22055
+ product_docs: "product_docs";
22056
+ research_blog: "research_blog";
22057
+ open_source_repo: "open_source_repo";
22058
+ }>;
22059
+ vendor: z.ZodOptional<z.ZodString>;
22060
+ topics: z.ZodOptional<z.ZodArray<z.ZodString>>;
22061
+ tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
22062
+ quality_signals: z.ZodOptional<z.ZodObject<{
22063
+ stars_at_review: z.ZodOptional<z.ZodNumber>;
22064
+ language: z.ZodOptional<z.ZodString>;
22065
+ has_tests: z.ZodOptional<z.ZodBoolean>;
22066
+ has_docs: z.ZodOptional<z.ZodBoolean>;
22067
+ has_paper: z.ZodOptional<z.ZodBoolean>;
22068
+ }, z.core.$strip>>;
22069
+ techniques_extracted: z.ZodOptional<z.ZodArray<z.ZodString>>;
22070
+ verdict: z.ZodOptional<z.ZodEnum<{
22071
+ rejected: "rejected";
22072
+ monitoring: "monitoring";
22073
+ planned: "planned";
22074
+ adopted: "adopted";
22075
+ partially_adopted: "partially_adopted";
22076
+ }>>;
22077
+ verdict_notes: z.ZodOptional<z.ZodString>;
22078
+ dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22079
+ }, z.core.$strip>;
22080
+ type ResearchAddSourceInput = z.infer<typeof ResearchAddSourceInputSchema>;
22081
+ type ResearchAddSourceDeps = BaseMcpToolDeps;
22082
+ interface ResearchAddSourceResponse {
22083
+ success: boolean;
22084
+ sourceId: string;
22085
+ name: string;
22086
+ quality_score: number;
22087
+ evidence_tier: string;
22088
+ message: string;
22089
+ dryRun: boolean;
22090
+ }
22091
+ /** @category MCP */
22092
+ declare function registerResearchAddSourceTool(server: McpServer, deps: ResearchAddSourceDeps): void;
22093
+
22094
+ /**
22095
+ * nexus-agents/mcp - Research Discover Tool
22096
+ *
22097
+ * MCP tool for discovering new research papers and repos from external sources.
22098
+ * Searches arXiv, GitHub, and other sources for relevant research.
22099
+ *
22100
+ * @module mcp/tools/research-discover
22101
+ * (Source: Research System Enhancement - Phase 1C)
22102
+ */
22103
+
22104
+ /** A discovered research item. */
22105
+ interface DiscoveredItem {
22106
+ /** Source type */
22107
+ source: string;
22108
+ /** Item title */
22109
+ title: string;
22110
+ /** URL to the item */
22111
+ url: string;
22112
+ /** Brief description */
22113
+ description: string;
22114
+ /** Whether this item already exists in the registry */
22115
+ alreadyInRegistry: boolean;
22116
+ /** Discovery date */
22117
+ discoveredAt: string;
22118
+ /** Relevance score (0-1) relative to the search topic */
22119
+ relevanceScore?: number;
22120
+ }
22121
+ /**
22122
+ * Input schema for research_discover tool.
22123
+ */
22124
+ declare const ResearchDiscoverInputSchema: z.ZodObject<{
22125
+ topic: z.ZodString;
22126
+ source: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
22127
+ all: "all";
22128
+ arxiv: "arxiv";
22129
+ github: "github";
22130
+ google_ai: "google_ai";
22131
+ meta_fair: "meta_fair";
22132
+ microsoft: "microsoft";
22133
+ deepmind: "deepmind";
22134
+ semantic_scholar: "semantic_scholar";
22135
+ papers_with_code: "papers_with_code";
22136
+ openalex: "openalex";
22137
+ }>>>;
22138
+ maxResults: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
22139
+ sinceDate: z.ZodOptional<z.ZodString>;
22140
+ relevanceThreshold: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
22141
+ }, z.core.$strip>;
22142
+ /**
22143
+ * Type for validated research discover input.
22144
+ */
22145
+ type ResearchDiscoverInput = z.infer<typeof ResearchDiscoverInputSchema>;
22146
+ /**
22147
+ * Dependencies for research_discover tool.
22148
+ */
22149
+ type ResearchDiscoverDeps = BaseMcpToolDeps;
22150
+ /**
22151
+ * Response from research_discover tool.
22152
+ */
22153
+ interface ResearchDiscoverResponse {
22154
+ /** Topic that was searched */
22155
+ topic: string;
22156
+ /** Sources queried */
22157
+ sourcesQueried: string[];
22158
+ /** Sources that failed during discovery */
22159
+ failedSources: string[];
22160
+ /** Discovered items */
22161
+ items: DiscoveredItem[];
22162
+ /** Total items found (before filtering) */
22163
+ totalFound: number;
22164
+ /** Items already in registry (filtered out) */
22165
+ alreadyInRegistry: number;
22166
+ /** New items not yet in registry */
22167
+ newItems: number;
22168
+ /** Items filtered out by relevance threshold */
22169
+ filteredByRelevance: number;
22170
+ }
22171
+ /**
22172
+ * Registers the research_discover tool with the MCP server.
22173
+ *
22174
+ * @category MCP
22175
+ * @param server - MCP server instance
22176
+ * @param deps - Tool dependencies
22177
+ */
22178
+ declare function registerResearchDiscoverTool(server: McpServer, deps: ResearchDiscoverDeps): void;
22179
+
22180
+ /**
22181
+ * nexus-agents/mcp - Research Analyze Tool
22182
+ *
22183
+ * MCP tool for analyzing the research registry for gaps, trends,
22184
+ * priorities, stale entries, and coverage.
22185
+ *
22186
+ * @module mcp/tools/research-analyze
22187
+ * (Source: Research System Enhancement - Phase 1D)
22188
+ */
22189
+
22190
+ /**
22191
+ * Input schema for research_analyze tool.
22192
+ */
22193
+ declare const ResearchAnalyzeInputSchema: z.ZodObject<{
22194
+ focus: z.ZodEnum<{
22195
+ coverage: "coverage";
22196
+ trends: "trends";
22197
+ gaps: "gaps";
22198
+ priorities: "priorities";
22199
+ stale: "stale";
22200
+ }>;
22201
+ topic: z.ZodOptional<z.ZodString>;
22202
+ }, z.core.$strip>;
22203
+ /**
22204
+ * Type for validated research analyze input.
22205
+ */
22206
+ type ResearchAnalyzeInput = z.infer<typeof ResearchAnalyzeInputSchema>;
22207
+ /**
22208
+ * Dependencies for research_analyze tool.
22209
+ */
22210
+ type ResearchAnalyzeDeps = BaseMcpToolDeps;
22211
+ /**
22212
+ * Response from research_analyze tool.
22213
+ */
22214
+ interface ResearchAnalyzeResponse {
22215
+ /** Analysis focus that was performed */
22216
+ focus: string;
22217
+ /** Whether the analysis succeeded */
22218
+ success: boolean;
22219
+ /** Analysis results */
22220
+ analysis: unknown;
22221
+ /** Recommendations based on analysis */
22222
+ recommendations: string[];
22223
+ }
22224
+ /**
22225
+ * Registers the research_analyze tool with the MCP server.
22226
+ *
22227
+ * @category MCP
22228
+ * @param server - MCP server instance
22229
+ * @param deps - Tool dependencies
22230
+ */
22231
+ declare function registerResearchAnalyzeTool(server: McpServer, deps: ResearchAnalyzeDeps): void;
22232
+
22233
+ /**
22234
+ * nexus-agents/mcp - Research Catalog Review Tool
22235
+ *
22236
+ * MCP tool for reviewing auto-cataloged research references.
22237
+ * Actions: list, approve, dismiss, flush.
22238
+ *
22239
+ * @module mcp/tools/research-catalog-review
22240
+ * (Source: Research System Enhancement - Phase 5)
22241
+ */
22242
+
22243
+ /**
22244
+ * Input schema for research_catalog_review tool.
22245
+ */
22246
+ declare const ResearchCatalogReviewInputSchema: z.ZodObject<{
22247
+ action: z.ZodEnum<{
22248
+ list: "list";
22249
+ approve: "approve";
22250
+ dismiss: "dismiss";
22251
+ flush: "flush";
22252
+ }>;
22253
+ identifier: z.ZodOptional<z.ZodString>;
22254
+ topic: z.ZodOptional<z.ZodString>;
22255
+ createIssue: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22256
+ }, z.core.$strip>;
22257
+ /**
22258
+ * Dependencies for research_catalog_review tool.
22259
+ */
22260
+ type ResearchCatalogReviewDeps = BaseMcpToolDeps;
22261
+ /**
22262
+ * Registers the research_catalog_review tool with the MCP server.
22263
+ *
22264
+ * @category MCP
22265
+ * @param server - MCP server instance
22266
+ * @param deps - Tool dependencies
22267
+ */
22268
+ declare function registerResearchCatalogReviewTool(server: McpServer, deps: ResearchCatalogReviewDeps): void;
22269
+
22270
+ /**
22271
+ * nexus-agents/mcp - Research Synthesize Tool
22272
+ *
22273
+ * MCP tool for synthesizing the research registry by grouping papers
22274
+ * into topic clusters and generating structured synthesis summaries
22275
+ * with themes, findings, techniques, and implementation opportunities.
22276
+ *
22277
+ * @module mcp/tools/research-synthesize
22278
+ * (Source: Issue #1386 — Research Synthesis Pipeline)
22279
+ */
22280
+
22281
+ /**
22282
+ * Input schema for research_synthesize tool.
22283
+ */
22284
+ declare const ResearchSynthesizeInputSchema: z.ZodObject<{
22285
+ topic: z.ZodOptional<z.ZodString>;
22286
+ }, z.core.$strip>;
22287
+ /**
22288
+ * Type for validated research synthesize input.
22289
+ */
22290
+ type ResearchSynthesizeInput = z.infer<typeof ResearchSynthesizeInputSchema>;
22291
+ type ResearchSynthesizeDeps = BaseMcpToolDeps;
22292
+ /**
22293
+ * Registers the research_synthesize tool with the MCP server.
22294
+ *
22295
+ * @category MCP
22296
+ * @param server - MCP server instance
22297
+ * @param deps - Tool dependencies
22298
+ */
22299
+ declare function registerResearchSynthesizeTool(server: McpServer, deps: ResearchSynthesizeDeps): void;
22300
+
22301
+ /**
22302
+ * nexus-agents/mcp - Issue Triage Tool
22303
+ *
22304
+ * MCP tool for automated GitHub issue triage using the full
22305
+ * security pipeline (8/8 modules). Read-only by default.
22306
+ *
22307
+ * @module mcp/tools/issue-triage-tool
22308
+ * (Source: Issue #828 — Wire remaining security modules)
22309
+ */
22310
+
22311
+ declare const IssueTriageInputSchema: z.ZodObject<{
22312
+ issueUrl: z.ZodString;
22313
+ dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22314
+ }, z.core.$strip>;
22315
+ type IssueTriageInput = z.infer<typeof IssueTriageInputSchema>;
22316
+ type IssueTriageDeps = BaseMcpToolDeps;
22317
+ interface IssueTriageResponse {
22318
+ readonly issueNumber: number;
22319
+ readonly repository: string;
22320
+ readonly category: string;
22321
+ readonly categoryConfidence: number;
22322
+ readonly trustAssessment: {
22323
+ readonly trustTier: string;
22324
+ readonly userRole: string;
22325
+ readonly reputationScore?: number | undefined;
22326
+ readonly isSuspicious: boolean;
22327
+ readonly suspiciousSignals: readonly string[];
22328
+ };
22329
+ readonly proposedActions: ReadonlyArray<{
22330
+ readonly type: string;
22331
+ readonly description: string;
22332
+ readonly policyApproved: boolean;
22333
+ readonly corroborated: boolean;
22334
+ }>;
22335
+ readonly durationMs: number;
22336
+ }
22337
+ /**
22338
+ * Registers the issue_triage tool with the MCP server.
22339
+ * Uses createSecureHandler for rate limiting and input sanitization.
22340
+ * @category MCP
22341
+ */
22342
+ declare function registerIssueTriageTool(server: McpServer, deps: IssueTriageDeps): void;
22343
+
22344
+ /**
22345
+ * nexus-agents/mcp - Run Graph Workflow Tool
22346
+ *
22347
+ * MCP tool for executing graph-based workflows with checkpointing,
22348
+ * event streaming, and audit trail integration.
22349
+ *
22350
+ * @module mcp/tools/run-graph-workflow
22351
+ * (Source: Issue #840 — Expose graph workflows via MCP tool)
22352
+ */
22353
+
22354
+ declare const RunGraphWorkflowInputSchema: z.ZodObject<{
22355
+ workflow: z.ZodString;
22129
22356
  inputs: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
22130
22357
  enableCheckpointing: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22131
22358
  enableAuditTrail: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -22151,7 +22378,7 @@ interface GraphEventSummary {
22151
22378
  readonly nodeId?: string | undefined;
22152
22379
  readonly detail?: string | undefined;
22153
22380
  }
22154
- /** Registers the run_graph_workflow tool with an MCP server. */
22381
+ /** Registers the run_graph_workflow tool with an MCP server. @category MCP */
22155
22382
  declare function registerRunGraphWorkflowTool(server: McpServer, deps: RunGraphWorkflowDeps): void;
22156
22383
 
22157
22384
  /**
@@ -22170,7 +22397,7 @@ declare const ExecuteSpecInputSchema: z.ZodObject<{
22170
22397
  }, z.core.$strip>;
22171
22398
  type ExecuteSpecInput = z.infer<typeof ExecuteSpecInputSchema>;
22172
22399
  type ExecuteSpecDeps = BaseMcpToolDeps;
22173
- /** Registers the execute_spec tool with an MCP server. */
22400
+ /** Registers the execute_spec tool with an MCP server. @category MCP */
22174
22401
  declare function registerExecuteSpecTool(server: McpServer, deps: ExecuteSpecDeps): void;
22175
22402
 
22176
22403
  /**
@@ -22269,6 +22496,139 @@ interface SessionMemoryConfig {
22269
22496
  readonly logger?: ILogger;
22270
22497
  }
22271
22498
 
22499
+ /**
22500
+ * nexus-agents/mcp - Memory Query Tool
22501
+ *
22502
+ * MCP tool for unified memory search across all backends.
22503
+ * Exposes ToolMemoryManager.queryAll() as an MCP tool.
22504
+ *
22505
+ * @module mcp/tools/memory-query
22506
+ * (Source: Issue #751 - Memory observability MCP tools)
22507
+ */
22508
+
22509
+ /**
22510
+ * Input schema for memory_query tool.
22511
+ */
22512
+ declare const MemoryQueryInputSchema: z.ZodObject<{
22513
+ query: z.ZodString;
22514
+ limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
22515
+ source: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
22516
+ session: "session";
22517
+ belief: "belief";
22518
+ all: "all";
22519
+ adaptive: "adaptive";
22520
+ agentic: "agentic";
22521
+ typed: "typed";
22522
+ }>>>;
22523
+ }, z.core.$strip>;
22524
+ /**
22525
+ * Type for validated memory query input.
22526
+ */
22527
+ type MemoryQueryInput = z.infer<typeof MemoryQueryInputSchema>;
22528
+ /**
22529
+ * Dependencies for memory_query tool.
22530
+ */
22531
+ type MemoryQueryDeps = BaseMcpToolDeps;
22532
+ /**
22533
+ * Registers the memory_query tool with the MCP server.
22534
+ *
22535
+ * @category MCP
22536
+ * @param server - MCP server instance
22537
+ * @param deps - Tool dependencies
22538
+ */
22539
+ declare function registerMemoryQueryTool(server: McpServer, deps: MemoryQueryDeps): void;
22540
+
22541
+ /**
22542
+ * nexus-agents/mcp - Memory Stats Tool
22543
+ *
22544
+ * MCP tool for memory system observability dashboard.
22545
+ * Aggregates stats from all memory backends.
22546
+ *
22547
+ * @module mcp/tools/memory-stats
22548
+ * (Source: Issue #751 - Memory observability MCP tools)
22549
+ */
22550
+
22551
+ /**
22552
+ * Input schema for memory_stats tool.
22553
+ */
22554
+ declare const MemoryStatsInputSchema: z.ZodObject<{
22555
+ includeDecay: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22556
+ }, z.core.$strip>;
22557
+ /**
22558
+ * Dependencies for memory_stats tool.
22559
+ */
22560
+ type MemoryStatsDeps = BaseMcpToolDeps;
22561
+ /**
22562
+ * Registers the memory_stats tool with the MCP server.
22563
+ *
22564
+ * @category MCP
22565
+ * @param server - MCP server instance
22566
+ * @param deps - Tool dependencies
22567
+ */
22568
+ declare function registerMemoryStatsTool(server: McpServer, deps: MemoryStatsDeps): void;
22569
+
22570
+ /**
22571
+ * nexus-agents/mcp - Memory Write Tool
22572
+ *
22573
+ * MCP tool for manual memory injection across backends.
22574
+ * Supports session (learnings), belief (triples), agentic (knowledge),
22575
+ * adaptive (priority-scored), and typed (MIRIX-style) writes.
22576
+ *
22577
+ * @module mcp/tools/memory-write
22578
+ * (Source: Issue #1090 - Add memory_write MCP tool)
22579
+ */
22580
+
22581
+ /**
22582
+ * Input schema for memory_write tool.
22583
+ */
22584
+ declare const MemoryWriteInputSchema: z.ZodObject<{
22585
+ key: z.ZodString;
22586
+ content: z.ZodString;
22587
+ backend: z.ZodEnum<{
22588
+ session: "session";
22589
+ belief: "belief";
22590
+ adaptive: "adaptive";
22591
+ agentic: "agentic";
22592
+ typed: "typed";
22593
+ }>;
22594
+ confidence: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
22595
+ low: "low";
22596
+ medium: "medium";
22597
+ high: "high";
22598
+ }>>>;
22599
+ metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
22600
+ }, z.core.$strip>;
22601
+ /**
22602
+ * Type for validated memory write input.
22603
+ */
22604
+ type MemoryWriteInput = z.infer<typeof MemoryWriteInputSchema>;
22605
+ /**
22606
+ * Dependencies for memory_write tool.
22607
+ */
22608
+ type MemoryWriteDeps = BaseMcpToolDeps;
22609
+ /**
22610
+ * Registers the memory_write tool with the MCP server.
22611
+ *
22612
+ * @category MCP
22613
+ * @param server - MCP server instance
22614
+ * @param deps - Tool dependencies
22615
+ */
22616
+ declare function registerMemoryWriteTool(server: McpServer, deps: MemoryWriteDeps): void;
22617
+
22618
+ /**
22619
+ * nexus-agents/mcp - Weather Report MCP Tool
22620
+ *
22621
+ * Read-only MCP tool that returns per-CLI, per-category performance
22622
+ * data and adaptive routing bonuses from the OutcomeStore.
22623
+ *
22624
+ * @module mcp/tools/weather-report-tool
22625
+ * (Source: Issue #865 — Weather report with adaptive routing)
22626
+ */
22627
+
22628
+ type WeatherReportDeps = BaseMcpToolDeps;
22629
+ /** @category MCP */
22630
+ declare function registerWeatherReportTool(server: McpServer, deps: WeatherReportDeps): void;
22631
+
22272
22632
  /**
22273
22633
  * Type definitions for the Weather Report MCP tool.
22274
22634
  *
@@ -22279,6 +22639,27 @@ interface SessionMemoryConfig {
22279
22639
  * (Source: Issue #865 — Weather report with adaptive routing)
22280
22640
  */
22281
22641
 
22642
+ declare const WeatherReportInputSchema: z.ZodObject<{
22643
+ cli: z.ZodOptional<z.ZodEnum<{
22644
+ claude: "claude";
22645
+ gemini: "gemini";
22646
+ codex: "codex";
22647
+ opencode: "opencode";
22648
+ }>>;
22649
+ category: z.ZodOptional<z.ZodEnum<{
22650
+ planning: "planning";
22651
+ code_generation: "code_generation";
22652
+ code_review: "code_review";
22653
+ research: "research";
22654
+ architecture: "architecture";
22655
+ security_review: "security_review";
22656
+ documentation: "documentation";
22657
+ testing: "testing";
22658
+ devops: "devops";
22659
+ exploration: "exploration";
22660
+ }>>;
22661
+ includeAdaptive: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22662
+ }, z.core.$strip>;
22282
22663
  /** Options for generateWeatherReport (all fields optional). */
22283
22664
  interface WeatherReportOptions {
22284
22665
  readonly cli?: CliNameLiteral;
@@ -22472,6 +22853,41 @@ type WeatherReportConfig = z.infer<typeof WeatherReportConfigSchema>;
22472
22853
  */
22473
22854
  declare function generateWeatherReport(input: WeatherReportOptions, config?: Partial<WeatherReportConfig>): WeatherReportResponse;
22474
22855
 
22856
+ /**
22857
+ * nexus-agents/mcp - Registry Import MCP Tool
22858
+ *
22859
+ * Generates draft ModelCapability entries for adding new models
22860
+ * to the canonical registry. Quality scores default to 5/10
22861
+ * and require human review before routing trusts them.
22862
+ *
22863
+ * @module mcp/tools/registry-import-tool
22864
+ * (Source: Issue #889, Epic #888)
22865
+ */
22866
+
22867
+ type RegistryImportDeps = BaseMcpToolDeps;
22868
+ /** @category MCP */
22869
+ declare function registerRegistryImportTool(server: McpServer, deps: RegistryImportDeps): void;
22870
+
22871
+ /**
22872
+ * nexus-agents/mcp - Registry Import Types
22873
+ *
22874
+ * Input/output types for the registry_import MCP tool.
22875
+ *
22876
+ * @module mcp/tools/registry-import-types
22877
+ * (Source: Issue #889, Epic #888)
22878
+ */
22879
+
22880
+ declare const RegistryImportInputSchema: z.ZodObject<{
22881
+ provider: z.ZodEnum<{
22882
+ anthropic: "anthropic";
22883
+ google: "google";
22884
+ openai: "openai";
22885
+ }>;
22886
+ modelId: z.ZodString;
22887
+ dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
22888
+ }, z.core.$strip>;
22889
+ type RegistryImportInput = z.infer<typeof RegistryImportInputSchema>;
22890
+
22475
22891
  /**
22476
22892
  * nexus-agents/mcp - Repository Analyze MCP Tool
22477
22893
  *
@@ -22484,6 +22900,7 @@ declare function generateWeatherReport(input: WeatherReportOptions, config?: Par
22484
22900
  */
22485
22901
 
22486
22902
  type RepoAnalyzeDeps = BaseMcpToolDeps;
22903
+ /** @category MCP */
22487
22904
  declare function registerRepoAnalyzeTool(server: McpServer, deps: RepoAnalyzeDeps): void;
22488
22905
 
22489
22906
  /**
@@ -22564,7 +22981,7 @@ interface GhRepoMetadata {
22564
22981
  } | null;
22565
22982
  }
22566
22983
  /** Analyze a GitHub repository given its metadata and file tree. */
22567
- declare function analyzeRepo(metadata: GhRepoMetadata, topLevelEntries: readonly string[]): RepoAnalysis;
22984
+ declare function analyzeRepo(metadata: GhRepoMetadata, topLevelEntries: readonly string[], workflowEntries?: readonly string[]): RepoAnalysis;
22568
22985
  /** Fetch repo data from GitHub and produce analysis. */
22569
22986
  declare function analyzeGitHubRepo(input: RepoAnalyzeInput): Promise<RepoAnalysis>;
22570
22987
 
@@ -22579,6 +22996,7 @@ declare function analyzeGitHubRepo(input: RepoAnalyzeInput): Promise<RepoAnalysi
22579
22996
  */
22580
22997
 
22581
22998
  type RepoSecurityPlanDeps = BaseMcpToolDeps;
22999
+ /** @category MCP */
22582
23000
  declare function registerRepoSecurityPlanTool(server: McpServer, deps: RepoSecurityPlanDeps): void;
22583
23001
 
22584
23002
  /**
@@ -22742,6 +23160,70 @@ declare function clearRegistryCache(): void;
22742
23160
  */
22743
23161
  declare function getRegistryManifest(): Promise<ScannerRegistryManifest | null>;
22744
23162
 
23163
+ /**
23164
+ * nexus-agents/mcp - Search Codebase MCP Tool
23165
+ *
23166
+ * Keyword search across an indexed codebase symbol table.
23167
+ * Returns matching functions, classes, methods, interfaces, and types
23168
+ * with relevance scoring and file locations.
23169
+ *
23170
+ * @module mcp/tools/search-codebase-tool
23171
+ */
23172
+
23173
+ declare const SearchCodebaseInputSchema: z.ZodObject<{
23174
+ query: z.ZodString;
23175
+ directory: z.ZodOptional<z.ZodString>;
23176
+ limit: z.ZodOptional<z.ZodNumber>;
23177
+ mode: z.ZodOptional<z.ZodEnum<{
23178
+ search: "search";
23179
+ summary: "summary";
23180
+ list: "list";
23181
+ }>>;
23182
+ }, z.core.$strip>;
23183
+ type SearchCodebaseDeps = BaseMcpToolDeps;
23184
+ /** @category MCP */
23185
+ declare function registerSearchCodebaseTool(server: McpServer, deps: SearchCodebaseDeps): void;
23186
+
23187
+ /**
23188
+ * nexus-agents/mcp - Extract Symbols MCP Tool
23189
+ *
23190
+ * AST-based symbol extraction for token-efficient code retrieval.
23191
+ * Returns function, class, method, interface, type definitions from
23192
+ * TypeScript/JavaScript files — 80%+ smaller than full file reads.
23193
+ *
23194
+ * @module mcp/tools/extract-symbols-tool
23195
+ */
23196
+
23197
+ declare const ExtractSymbolsInputSchema: z.ZodObject<{
23198
+ filePath: z.ZodString;
23199
+ mode: z.ZodOptional<z.ZodEnum<{
23200
+ full: "full";
23201
+ index: "index";
23202
+ }>>;
23203
+ }, z.core.$strip>;
23204
+ type ExtractSymbolsDeps = BaseMcpToolDeps;
23205
+ /** @category MCP */
23206
+ declare function registerExtractSymbolsTool(server: McpServer, deps: ExtractSymbolsDeps): void;
23207
+
23208
+ /**
23209
+ * nexus-agents/mcp - Query Trace MCP Tool (Epic #952, Phase 5)
23210
+ *
23211
+ * Read-only MCP tool that queries execution traces from disk
23212
+ * (./runs/{runId}/trace.jsonl) written by TraceWriter.
23213
+ *
23214
+ * @module mcp/tools/query-trace-tool
23215
+ */
23216
+
23217
+ declare const QueryTraceInputSchema: z.ZodObject<{
23218
+ runId: z.ZodString;
23219
+ eventType: z.ZodOptional<z.ZodString>;
23220
+ limit: z.ZodOptional<z.ZodNumber>;
23221
+ }, z.core.$strip>;
23222
+ type QueryTraceInput = z.infer<typeof QueryTraceInputSchema>;
23223
+ type QueryTraceDeps = BaseMcpToolDeps;
23224
+ /** @category MCP */
23225
+ declare function registerQueryTraceTool(server: McpServer, deps: QueryTraceDeps): void;
23226
+
22745
23227
  /**
22746
23228
  * Pipeline Event Types — V2 Observability (Issue #912, Phase 4-1)
22747
23229
  *
@@ -23148,13 +23630,9 @@ declare abstract class BaseCliAdapter implements ICliAdapter {
23148
23630
  */
23149
23631
  private computeTimeout;
23150
23632
  /**
23151
- * Executes task with retry logic.
23633
+ * Executes task with retry logic via shared retry loop.
23152
23634
  */
23153
23635
  private executeWithRetry;
23154
- /**
23155
- * Checks if this attempt should be the final one.
23156
- */
23157
- private isTerminalAttempt;
23158
23636
  /**
23159
23637
  * Performs a health check.
23160
23638
  */
@@ -23201,6 +23679,52 @@ declare abstract class BaseCliAdapter implements ICliAdapter {
23201
23679
  protected delay(ms: number): Promise<void>;
23202
23680
  }
23203
23681
 
23682
+ /**
23683
+ * nexus-agents/cli-adapters - Unified CLI Retry Loop
23684
+ *
23685
+ * Single retry loop used by all CLI adapters (base + Gemini).
23686
+ * Supports optional circuit breaker integration.
23687
+ *
23688
+ * (Source: Issue #1596 — Extract shared prompt utils and rate-limit patterns)
23689
+ */
23690
+
23691
+ interface CliRetryLoopConfig {
23692
+ readonly maxRetries: number;
23693
+ readonly allowRetry: boolean;
23694
+ readonly baseDelayMs: number;
23695
+ readonly maxDelayMs: number;
23696
+ readonly circuitBreaker?: ICircuitBreaker | null;
23697
+ readonly cli: CliName;
23698
+ readonly logger: ILogger;
23699
+ }
23700
+ interface CliRetryResult {
23701
+ readonly response: CliResponse;
23702
+ readonly retryCount: number;
23703
+ }
23704
+ /**
23705
+ * Calculates exponential backoff delay with jitter.
23706
+ *
23707
+ * @param attempt - Current attempt number (1-indexed)
23708
+ * @param baseDelayMs - Base delay in milliseconds
23709
+ * @param maxDelayMs - Maximum delay cap in milliseconds
23710
+ * @returns Delay in milliseconds with jitter applied
23711
+ */
23712
+ declare function calculateBackoffDelay(attempt: number, baseDelayMs: number, maxDelayMs: number): number;
23713
+ /** Determines if an error code is retryable. */
23714
+ declare function isRetryableError(code: CliErrorCode): boolean;
23715
+ /**
23716
+ * Categorizes a CLI error for circuit breaker tracking.
23717
+ * Returns a FailureCategory compatible with the circuit breaker.
23718
+ */
23719
+ declare function categorizeError(error: CliError): FailureCategory$1;
23720
+ /**
23721
+ * Executes a CLI operation with retry logic and optional circuit breaker.
23722
+ *
23723
+ * Used by both BaseCliAdapter (no circuit breaker) and GeminiCliAdapter
23724
+ * (with circuit breaker) to eliminate duplicate retry implementations.
23725
+ */
23726
+ declare function executeCliRetryLoop(executeFn: () => Promise<Result<CliResponse, CliError>>, config: CliRetryLoopConfig): Promise<Result<CliRetryResult, CliError>>;
23727
+
23204
23728
  /**
23205
23729
  * nexus-agents/cli-adapters - Subprocess Adapter
23206
23730
  *
@@ -23419,9 +23943,6 @@ declare class GeminiCliAdapter extends SubprocessCliAdapter {
23419
23943
  private buildExecutionOptions;
23420
23944
  private buildExecutionResult;
23421
23945
  private executeWithRetryTracking;
23422
- private shouldRetry;
23423
- private logRetryAttempt;
23424
- private logRetryDelay;
23425
23946
  }
23426
23947
 
23427
23948
  /**
@@ -24650,455 +25171,140 @@ declare class InMemoryAuditStorage implements IAuditStorage {
24650
25171
  query(criteria: AuditQueryCriteria): Promise<AuditEvent$1[]>;
24651
25172
  /** Get all events (for testing) */
24652
25173
  getAll(): AuditEvent$1[];
24653
- /** Clear all events (for testing) */
24654
- clear(): void;
24655
- }
24656
-
24657
- /**
24658
- * nexus-agents/audit - File-based Audit Storage
24659
- *
24660
- * JSON-L file storage with rotation for audit events.
24661
- * SIEM-compatible output format.
24662
- *
24663
- * (Source: Issue #193 - Phase 3 structured audit logging)
24664
- *
24665
- * @module audit/audit-storage
24666
- */
24667
-
24668
- /**
24669
- * Configuration for FileAuditStorage with optional security boundary.
24670
- */
24671
- interface FileAuditStorageConfig extends AuditLogConfig {
24672
- /** Optional root directory that logDir must be within. */
24673
- allowedRoot?: string;
24674
- }
24675
- declare class FileAuditStorage implements IAuditStorage {
24676
- private readonly logDir;
24677
- private readonly filePrefix;
24678
- private readonly maxFileSizeBytes;
24679
- private readonly maxFiles;
24680
- private readonly logger;
24681
- private currentFile;
24682
- private writeStream;
24683
- private currentFileSize;
24684
- private writeBuffer;
24685
- /**
24686
- * Creates a FileAuditStorage instance with path validation.
24687
- * Use this factory method for safe instantiation with proper error handling.
24688
- *
24689
- * @param config - Audit log configuration with optional allowedRoot
24690
- * @param logger - Optional logger instance
24691
- * @returns Result with FileAuditStorage or SecurityError
24692
- */
24693
- static create(config: FileAuditStorageConfig, logger?: ILogger): Result<FileAuditStorage, SecurityError>;
24694
- /**
24695
- * Constructor for FileAuditStorage.
24696
- *
24697
- * SECURITY NOTE: Prefer using FileAuditStorage.create() for safe instantiation
24698
- * with proper path validation and error handling.
24699
- *
24700
- * @param config - Audit log configuration
24701
- * @param logger - Optional logger instance
24702
- * @param skipValidation - Internal flag, set by create() after validation
24703
- * @throws SecurityError if path validation fails and skipValidation is false
24704
- */
24705
- constructor(config: AuditLogConfig, logger?: ILogger, skipValidation?: boolean);
24706
- private ensureLogDirectory;
24707
- private generateFileName;
24708
- private getExistingLogFiles;
24709
- private initCurrentFile;
24710
- private openWriteStream;
24711
- private rotateFile;
24712
- private pruneOldFiles;
24713
- write(event: AuditEvent$1): Promise<void>;
24714
- flush(): Promise<void>;
24715
- close(): Promise<void>;
24716
- query(criteria: AuditQueryCriteria): Promise<AuditEvent$1[]>;
24717
- }
24718
-
24719
- /**
24720
- * nexus-agents/audit - SecureHandler Audit Integration
24721
- *
24722
- * Integration helper to add audit logging to SecureHandler middleware.
24723
- *
24724
- * (Source: Issue #193 - Phase 3 structured audit logging)
24725
- *
24726
- * @module audit/secure-handler-audit
24727
- */
24728
-
24729
- /**
24730
- * Configuration for audit-enabled secure handler.
24731
- */
24732
- interface AuditHandlerConfig {
24733
- /** Audit logger instance */
24734
- auditLogger: IAuditLogger;
24735
- /** Default actor for requests without caller info */
24736
- defaultActor?: AuditActor | undefined;
24737
- }
24738
- /**
24739
- * Creates an AuditActor from RequestContext.
24740
- */
24741
- declare function actorFromContext(ctx: RequestContext, fallback?: AuditActor): AuditActor;
24742
- /**
24743
- * Maps tool result to audit outcome.
24744
- */
24745
- declare function resultToOutcome(isError: boolean | undefined, isPolicyDenied: boolean): AuditOutcome;
24746
- /** Options for logging tool invocation audit */
24747
- interface LogToolInvocationOpts {
24748
- auditLogger: IAuditLogger;
24749
- toolName: string;
24750
- outcome: AuditOutcome;
24751
- actor: AuditActor;
24752
- requestId: string;
24753
- durationMs?: number | undefined;
24754
- errorMessage?: string | undefined;
24755
- }
24756
- /**
24757
- * Logs tool invocation to audit logger.
24758
- */
24759
- declare function logToolInvocationAudit(opts: LogToolInvocationOpts): void;
24760
- /** Options for logging policy audit */
24761
- interface LogPolicyAuditOpts {
24762
- auditLogger: IAuditLogger;
24763
- policyName: string;
24764
- decision: 'allow' | 'deny';
24765
- reason: string;
24766
- toolName: string;
24767
- actor: AuditActor;
24768
- requestId: string;
24769
- }
24770
- /**
24771
- * Logs policy decision to audit logger.
24772
- */
24773
- declare function logPolicyAudit(opts: LogPolicyAuditOpts): void;
24774
- /** Options for logging rate limit audit */
24775
- interface LogRateLimitAuditOpts {
24776
- auditLogger: IAuditLogger;
24777
- toolName: string;
24778
- actor: AuditActor;
24779
- currentRate: number;
24780
- limitRate: number;
24781
- requestId: string;
24782
- }
24783
- /**
24784
- * Logs rate limit violation to audit logger.
24785
- */
24786
- declare function logRateLimitAudit(opts: LogRateLimitAuditOpts): void;
24787
-
24788
- /**
24789
- * nexus-agents/api - REST API Types
24790
- *
24791
- * Type definitions for the REST API gateway.
24792
- * Mirrors MCP tool interfaces with REST-specific extensions.
24793
- *
24794
- * (Source: Issue #184 - REST API gateway for non-MCP clients)
24795
- *
24796
- * @module api/rest-types
24797
- */
24798
-
24799
- /**
24800
- * REST API server configuration.
24801
- */
24802
- declare const RestApiConfigSchema: z.ZodObject<{
24803
- port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
24804
- host: z.ZodDefault<z.ZodOptional<z.ZodString>>;
24805
- basePath: z.ZodDefault<z.ZodOptional<z.ZodString>>;
24806
- enableCors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
24807
- corsOrigins: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
24808
- enableSwagger: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
24809
- rateLimitPerMinute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
24810
- apiKeyHeader: z.ZodDefault<z.ZodOptional<z.ZodString>>;
24811
- trustProxy: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
24812
- maxBodySize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
24813
- }, z.core.$strip>;
24814
- type RestApiConfig = z.infer<typeof RestApiConfigSchema>;
24815
- /**
24816
- * API key configuration.
24817
- */
24818
- interface ApiKeyConfig {
24819
- /** API key value */
24820
- key: string;
24821
- /** Optional name/label */
24822
- name?: string | undefined;
24823
- /** Allowed endpoints (empty = all) */
24824
- allowedEndpoints?: string[] | undefined;
24825
- /** Rate limit override */
24826
- rateLimitOverride?: number | undefined;
24827
- }
24828
- /**
24829
- * Authenticated request context.
24830
- */
24831
- interface AuthContext {
24832
- /** Whether request is authenticated */
24833
- authenticated: boolean;
24834
- /** API key name if authenticated */
24835
- keyName?: string | undefined;
24836
- /** Client ID for tracking */
24837
- clientId: string;
24838
- }
24839
- /**
24840
- * Standard API error response.
24841
- */
24842
- declare const ApiErrorSchema: z.ZodObject<{
24843
- error: z.ZodObject<{
24844
- code: z.ZodString;
24845
- message: z.ZodString;
24846
- details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
24847
- }, z.core.$strip>;
24848
- requestId: z.ZodString;
24849
- timestamp: z.ZodString;
24850
- }, z.core.$strip>;
24851
- type ApiError = z.infer<typeof ApiErrorSchema>;
24852
- /**
24853
- * POST /orchestrate request body.
24854
- */
24855
- declare const OrchestrateRequestSchema: z.ZodObject<{
24856
- task: z.ZodString;
24857
- context: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
24858
- constraints: z.ZodOptional<z.ZodObject<{
24859
- maxTokens: z.ZodOptional<z.ZodNumber>;
24860
- maxCostUsd: z.ZodOptional<z.ZodNumber>;
24861
- maxDurationMs: z.ZodOptional<z.ZodNumber>;
24862
- }, z.core.$strip>>;
24863
- }, z.core.$strip>;
24864
- type OrchestrateRequest = z.infer<typeof OrchestrateRequestSchema>;
24865
- /**
24866
- * POST /orchestrate response body.
24867
- */
24868
- declare const OrchestrateResponseSchema: z.ZodObject<{
24869
- taskId: z.ZodString;
24870
- analysis: z.ZodObject<{
24871
- complexity: z.ZodNumber;
24872
- taskType: z.ZodString;
24873
- requirements: z.ZodArray<z.ZodString>;
24874
- approach: z.ZodString;
24875
- }, z.core.$strip>;
24876
- result: z.ZodUnknown;
24877
- metadata: z.ZodObject<{
24878
- durationMs: z.ZodNumber;
24879
- tokensUsed: z.ZodNumber;
24880
- expertsUsed: z.ZodArray<z.ZodString>;
24881
- }, z.core.$strip>;
24882
- }, z.core.$strip>;
24883
- type OrchestrateResponse = z.infer<typeof OrchestrateResponseSchema>;
24884
- /**
24885
- * POST /delegate request body.
24886
- */
24887
- declare const DelegateRequestSchema: z.ZodObject<{
24888
- task: z.ZodString;
24889
- preferredModel: z.ZodOptional<z.ZodEnum<{
24890
- claude: "claude";
24891
- gemini: "gemini";
24892
- codex: "codex";
24893
- opencode: "opencode";
24894
- }>>;
24895
- constraints: z.ZodOptional<z.ZodObject<{
24896
- maxTokens: z.ZodOptional<z.ZodNumber>;
24897
- maxCostUsd: z.ZodOptional<z.ZodNumber>;
24898
- maxLatencyMs: z.ZodOptional<z.ZodNumber>;
24899
- }, z.core.$strip>>;
24900
- }, z.core.$strip>;
24901
- type DelegateRequest = z.infer<typeof DelegateRequestSchema>;
24902
- /**
24903
- * POST /delegate response body.
24904
- */
24905
- declare const DelegateResponseSchema: z.ZodObject<{
24906
- selectedModel: z.ZodString;
24907
- confidence: z.ZodNumber;
24908
- reason: z.ZodString;
24909
- result: z.ZodOptional<z.ZodUnknown>;
24910
- alternatives: z.ZodArray<z.ZodString>;
24911
- }, z.core.$strip>;
24912
- type DelegateResponse = z.infer<typeof DelegateResponseSchema>;
24913
- /**
24914
- * POST /workflow request body.
24915
- */
24916
- declare const WorkflowRequestSchema: z.ZodObject<{
24917
- workflowId: z.ZodOptional<z.ZodString>;
24918
- workflowYaml: z.ZodOptional<z.ZodString>;
24919
- inputs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
24920
- }, z.core.$strip>;
24921
- type WorkflowRequest = z.infer<typeof WorkflowRequestSchema>;
24922
- /**
24923
- * POST /workflow response body.
24924
- */
24925
- declare const WorkflowResponseSchema: z.ZodObject<{
24926
- executionId: z.ZodString;
24927
- status: z.ZodEnum<{
24928
- failed: "failed";
24929
- completed: "completed";
24930
- timeout: "timeout";
24931
- }>;
24932
- stepResults: z.ZodArray<z.ZodObject<{
24933
- stepId: z.ZodString;
24934
- status: z.ZodString;
24935
- output: z.ZodOptional<z.ZodUnknown>;
24936
- durationMs: z.ZodNumber;
24937
- }, z.core.$strip>>;
24938
- finalOutput: z.ZodOptional<z.ZodUnknown>;
24939
- metadata: z.ZodObject<{
24940
- totalDurationMs: z.ZodNumber;
24941
- stepsCompleted: z.ZodNumber;
24942
- stepsFailed: z.ZodNumber;
24943
- }, z.core.$strip>;
24944
- }, z.core.$strip>;
24945
- type WorkflowResponse = z.infer<typeof WorkflowResponseSchema>;
24946
- /**
24947
- * POST /expert request body.
24948
- */
24949
- declare const ExpertRequestSchema: z.ZodObject<{
24950
- type: z.ZodEnum<{
24951
- code: "code";
24952
- security: "security";
24953
- architecture: "architecture";
24954
- documentation: "documentation";
24955
- testing: "testing";
24956
- }>;
24957
- task: z.ZodString;
24958
- options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
24959
- }, z.core.$strip>;
24960
- type ExpertRequest = z.infer<typeof ExpertRequestSchema>;
24961
- /**
24962
- * POST /expert response body.
24963
- */
24964
- declare const ExpertResponseSchema: z.ZodObject<{
24965
- expertId: z.ZodString;
24966
- expertType: z.ZodString;
24967
- result: z.ZodUnknown;
24968
- metadata: z.ZodObject<{
24969
- durationMs: z.ZodNumber;
24970
- tokensUsed: z.ZodNumber;
24971
- }, z.core.$strip>;
24972
- }, z.core.$strip>;
24973
- type ExpertResponse = z.infer<typeof ExpertResponseSchema>;
24974
- /**
24975
- * GET /health response.
24976
- */
24977
- declare const HealthResponseSchema: z.ZodObject<{
24978
- status: z.ZodEnum<{
24979
- healthy: "healthy";
24980
- degraded: "degraded";
24981
- unhealthy: "unhealthy";
24982
- }>;
24983
- version: z.ZodString;
24984
- uptime: z.ZodNumber;
24985
- checks: z.ZodRecord<z.ZodString, z.ZodObject<{
24986
- status: z.ZodEnum<{
24987
- pass: "pass";
24988
- fail: "fail";
24989
- }>;
24990
- message: z.ZodOptional<z.ZodString>;
24991
- }, z.core.$strip>>;
24992
- }, z.core.$strip>;
24993
- type HealthResponse = z.infer<typeof HealthResponseSchema>;
25174
+ /** Clear all events (for testing) */
25175
+ clear(): void;
25176
+ }
25177
+
24994
25178
  /**
24995
- * GET /metrics response (Prometheus format handled separately).
25179
+ * nexus-agents/audit - File-based Audit Storage
25180
+ *
25181
+ * JSON-L file storage with rotation for audit events.
25182
+ * SIEM-compatible output format.
25183
+ *
25184
+ * (Source: Issue #193 - Phase 3 structured audit logging)
25185
+ *
25186
+ * @module audit/audit-storage
24996
25187
  */
24997
- declare const MetricsResponseSchema: z.ZodObject<{
24998
- requestsTotal: z.ZodNumber;
24999
- requestsPerEndpoint: z.ZodRecord<z.ZodString, z.ZodNumber>;
25000
- avgResponseTimeMs: z.ZodNumber;
25001
- errorRate: z.ZodNumber;
25002
- activeConnections: z.ZodNumber;
25003
- }, z.core.$strip>;
25004
- type MetricsResponse = z.infer<typeof MetricsResponseSchema>;
25188
+
25005
25189
  /**
25006
- * REST API server interface.
25190
+ * Configuration for FileAuditStorage with optional security boundary.
25007
25191
  */
25008
- interface IRestApiServer {
25009
- /** Start the server */
25010
- start(): Promise<void>;
25011
- /** Stop the server */
25012
- stop(): Promise<void>;
25013
- /** Get the Fastify instance */
25014
- getInstance(): FastifyInstance;
25015
- /** Check if server is running */
25016
- isRunning(): boolean;
25017
- /** Get server address */
25018
- getAddress(): string | null;
25192
+ interface FileAuditStorageConfig extends AuditLogConfig {
25193
+ /** Optional root directory that logDir must be within. */
25194
+ allowedRoot?: string;
25195
+ }
25196
+ declare class FileAuditStorage implements IAuditStorage {
25197
+ private readonly logDir;
25198
+ private readonly filePrefix;
25199
+ private readonly maxFileSizeBytes;
25200
+ private readonly maxFiles;
25201
+ private readonly logger;
25202
+ private currentFile;
25203
+ private writeStream;
25204
+ private currentFileSize;
25205
+ private writeBuffer;
25206
+ /**
25207
+ * Creates a FileAuditStorage instance with path validation.
25208
+ * Use this factory method for safe instantiation with proper error handling.
25209
+ *
25210
+ * @param config - Audit log configuration with optional allowedRoot
25211
+ * @param logger - Optional logger instance
25212
+ * @returns Result with FileAuditStorage or SecurityError
25213
+ */
25214
+ static create(config: FileAuditStorageConfig, logger?: ILogger): Result<FileAuditStorage, SecurityError>;
25215
+ /**
25216
+ * Constructor for FileAuditStorage.
25217
+ *
25218
+ * SECURITY NOTE: Prefer using FileAuditStorage.create() for safe instantiation
25219
+ * with proper path validation and error handling.
25220
+ *
25221
+ * @param config - Audit log configuration
25222
+ * @param logger - Optional logger instance
25223
+ * @param skipValidation - Internal flag, set by create() after validation
25224
+ * @throws SecurityError if path validation fails and skipValidation is false
25225
+ */
25226
+ constructor(config: AuditLogConfig, logger?: ILogger, skipValidation?: boolean);
25227
+ private ensureLogDirectory;
25228
+ private generateFileName;
25229
+ private getExistingLogFiles;
25230
+ private initCurrentFile;
25231
+ private openWriteStream;
25232
+ private rotateFile;
25233
+ private pruneOldFiles;
25234
+ write(event: AuditEvent$1): Promise<void>;
25235
+ flush(): Promise<void>;
25236
+ close(): Promise<void>;
25237
+ query(criteria: AuditQueryCriteria): Promise<AuditEvent$1[]>;
25019
25238
  }
25020
25239
 
25021
25240
  /**
25022
- * nexus-agents/api - REST API Server
25241
+ * nexus-agents/audit - SecureHandler Audit Integration
25023
25242
  *
25024
- * Fastify-based REST API gateway exposing nexus-agents capabilities.
25025
- * Provides HTTP interface for non-MCP clients.
25243
+ * Integration helper to add audit logging to SecureHandler middleware.
25026
25244
  *
25027
- * (Source: Issue #184 - REST API gateway for non-MCP clients)
25245
+ * (Source: Issue #193 - Phase 3 structured audit logging)
25028
25246
  *
25029
- * @module api/rest-server
25247
+ * @module audit/secure-handler-audit
25030
25248
  */
25031
25249
 
25032
25250
  /**
25033
- * REST API server options.
25251
+ * Configuration for audit-enabled secure handler.
25034
25252
  */
25035
- interface RestApiServerOptions {
25036
- config?: Partial<RestApiConfig> | undefined;
25037
- logger?: ILogger | undefined;
25038
- apiKeys?: ApiKeyConfig[] | undefined;
25253
+ interface AuditHandlerConfig {
25254
+ /** Audit logger instance */
25255
+ auditLogger: IAuditLogger;
25256
+ /** Default actor for requests without caller info */
25257
+ defaultActor?: AuditActor | undefined;
25039
25258
  }
25040
25259
  /**
25041
- * REST API Server providing HTTP interface to nexus-agents.
25042
- *
25043
- * @example
25044
- * ```typescript
25045
- * const server = new RestApiServer({
25046
- * config: { port: 3000 },
25047
- * apiKeys: [{ key: 'my-secret-key', name: 'default' }],
25048
- * });
25049
- *
25050
- * await server.start();
25051
- * // Server running at http://0.0.0.0:3000
25052
- *
25053
- * await server.stop();
25054
- * ```
25260
+ * Creates an AuditActor from RequestContext.
25055
25261
  */
25056
- declare class RestApiServer implements IRestApiServer {
25057
- private readonly config;
25058
- private readonly logger;
25059
- private readonly apiKeys;
25060
- private fastify;
25061
- private running;
25062
- private address;
25063
- private readonly startTime;
25064
- private requestCount;
25065
- private readonly requestsPerEndpoint;
25066
- private totalResponseTimeMs;
25067
- private errorCount;
25068
- constructor(options?: RestApiServerOptions);
25069
- start(): Promise<void>;
25070
- stop(): Promise<void>;
25071
- getInstance(): FastifyInstance;
25072
- isRunning(): boolean;
25073
- getAddress(): string | null;
25074
- private createFastifyInstance;
25075
- private registerPlugins;
25076
- private registerSwagger;
25077
- private registerMiddleware;
25078
- /** Adds security headers to all responses (Issue #740). */
25079
- private registerSecurityHeaders;
25080
- /** Registers request-level hooks (logging, auth, response tracking). */
25081
- private registerRequestHooks;
25082
- /** Checks if a URL path matches a public (unauthenticated) endpoint. */
25083
- private isPublicPath;
25084
- private authenticateRequest;
25085
- /** Extract a single string value from request headers (handles string[] case). */
25086
- private getHeaderString;
25087
- private getRateLimitKey;
25088
- private getClientId;
25089
- private generateRequestId;
25090
- getMetrics(): {
25091
- requestsTotal: number;
25092
- requestsPerEndpoint: Record<string, number>;
25093
- avgResponseTimeMs: number;
25094
- errorRate: number;
25095
- uptimeMs: number;
25096
- };
25262
+ declare function actorFromContext(ctx: RequestContext, fallback?: AuditActor): AuditActor;
25263
+ /**
25264
+ * Maps tool result to audit outcome.
25265
+ */
25266
+ declare function resultToOutcome(isError: boolean | undefined, isPolicyDenied: boolean): AuditOutcome;
25267
+ /** Options for logging tool invocation audit */
25268
+ interface LogToolInvocationOpts {
25269
+ auditLogger: IAuditLogger;
25270
+ toolName: string;
25271
+ outcome: AuditOutcome;
25272
+ actor: AuditActor;
25273
+ requestId: string;
25274
+ durationMs?: number | undefined;
25275
+ errorMessage?: string | undefined;
25276
+ }
25277
+ /**
25278
+ * Logs tool invocation to audit logger.
25279
+ */
25280
+ declare function logToolInvocationAudit(opts: LogToolInvocationOpts): void;
25281
+ /** Options for logging policy audit */
25282
+ interface LogPolicyAuditOpts {
25283
+ auditLogger: IAuditLogger;
25284
+ policyName: string;
25285
+ decision: 'allow' | 'deny';
25286
+ reason: string;
25287
+ toolName: string;
25288
+ actor: AuditActor;
25289
+ requestId: string;
25290
+ }
25291
+ /**
25292
+ * Logs policy decision to audit logger.
25293
+ */
25294
+ declare function logPolicyAudit(opts: LogPolicyAuditOpts): void;
25295
+ /** Options for logging rate limit audit */
25296
+ interface LogRateLimitAuditOpts {
25297
+ auditLogger: IAuditLogger;
25298
+ toolName: string;
25299
+ actor: AuditActor;
25300
+ currentRate: number;
25301
+ limitRate: number;
25302
+ requestId: string;
25097
25303
  }
25098
25304
  /**
25099
- * Creates a REST API server instance.
25305
+ * Logs rate limit violation to audit logger.
25100
25306
  */
25101
- declare function createRestApiServer(options?: RestApiServerOptions): IRestApiServer;
25307
+ declare function logRateLimitAudit(opts: LogRateLimitAuditOpts): void;
25102
25308
 
25103
25309
  /**
25104
25310
  * nexus-agents/security/sandbox - Type Definitions
@@ -27026,6 +27232,11 @@ declare const ParsedSpecSchema: z.ZodObject<{
27026
27232
  }, z.core.$strip>>;
27027
27233
  missingSections: z.ZodArray<z.ZodString>;
27028
27234
  rawMarkdown: z.ZodString;
27235
+ techStack: z.ZodOptional<z.ZodObject<{
27236
+ language: z.ZodOptional<z.ZodString>;
27237
+ framework: z.ZodOptional<z.ZodString>;
27238
+ packageManager: z.ZodOptional<z.ZodString>;
27239
+ }, z.core.$strip>>;
27029
27240
  }, z.core.$strip>;
27030
27241
  type ParsedSpec = z.infer<typeof ParsedSpecSchema>;
27031
27242
  /**
@@ -27197,13 +27408,13 @@ declare function decomposeSpec(spec: ParsedSpec): Result<TaskDag, DecomposeError
27197
27408
  /**
27198
27409
  * Which stage of the pipeline failed.
27199
27410
  */
27200
- type PipelineStage = 'parse' | 'decompose' | 'compile';
27411
+ type PipelineStage$1 = 'parse' | 'decompose' | 'compile';
27201
27412
  /**
27202
27413
  * Error detail when the spec pipeline fails.
27203
27414
  */
27204
27415
  interface PipelineError {
27205
27416
  readonly message: string;
27206
- readonly stage: PipelineStage;
27417
+ readonly stage: PipelineStage$1;
27207
27418
  }
27208
27419
  /**
27209
27420
  * A graph node handler function — takes state, returns partial state update.
@@ -28075,30 +28286,173 @@ interface VoterAgentOptions {
28075
28286
  }
28076
28287
 
28077
28288
  /**
28078
- * Options for collecting votes from multiple agents.
28289
+ * Options for collecting votes from multiple agents.
28290
+ */
28291
+ interface CollectRealVotesOptions extends VoterAgentOptions {
28292
+ /** Voter roles to include */
28293
+ readonly roles: readonly VoterRole[];
28294
+ /** Proposal text */
28295
+ readonly proposal: string;
28296
+ /** Use simulation mode (explicit opt-in only) */
28297
+ readonly simulate?: boolean;
28298
+ }
28299
+ /**
28300
+ * Error thrown when no adapter is available and simulation is disabled.
28301
+ */
28302
+ declare class NoAdapterError extends Error {
28303
+ constructor(message: string);
28304
+ }
28305
+ /**
28306
+ * Collects votes from multiple voter agents.
28307
+ *
28308
+ * Per Issue #280: No automatic simulation fallback. If no adapter is
28309
+ * available and simulation is not explicitly enabled, throws NoAdapterError.
28310
+ * Per Issue #845: Uses diverse CLIs when multiple are available.
28311
+ */
28312
+ declare function collectRealVotes(options: CollectRealVotesOptions): Promise<readonly AgentVoteResult[]>;
28313
+
28314
+ /**
28315
+ * nexus-agents/agents - OrchestrationObserver Helper Functions
28316
+ *
28317
+ * Pure helper functions for OrchestrationObserver that don't depend on class state.
28318
+ * Extracted to reduce main class file size and improve testability.
28319
+ *
28320
+ * @module agents/observability/orchestration-observer-helpers
28321
+ */
28322
+
28323
+ /**
28324
+ * Extracts a string field from a payload object safely.
28325
+ *
28326
+ * @param payload - The payload object to extract from
28327
+ * @param field - The field name to extract
28328
+ * @returns The string value or empty string if not found/invalid
28329
+ */
28330
+ declare function extractStringField(payload: Record<string, unknown>, field: string): string;
28331
+ /**
28332
+ * Extracts a number field from a payload object safely.
28333
+ *
28334
+ * @param payload - The payload object to extract from
28335
+ * @param field - The field name to extract
28336
+ * @param defaultValue - Default value if not found
28337
+ * @returns The number value or default if not found/invalid
28338
+ */
28339
+ declare function extractNumberField(payload: Record<string, unknown>, field: string, defaultValue?: number): number;
28340
+ /**
28341
+ * Extracts a boolean field from a payload object safely.
28342
+ *
28343
+ * @param payload - The payload object to extract from
28344
+ * @param field - The field name to extract
28345
+ * @returns The boolean value (defaults to false if not found/invalid)
28346
+ */
28347
+ declare function extractBooleanField(payload: Record<string, unknown>, field: string): boolean;
28348
+ /**
28349
+ * Extracts a string array field from a payload object safely.
28350
+ *
28351
+ * @param payload - The payload object to extract from
28352
+ * @param field - The field name to extract
28353
+ * @returns The string array or empty array if not found/invalid
28354
+ */
28355
+ declare function extractStringArrayField(payload: Record<string, unknown>, field: string): string[];
28356
+ /**
28357
+ * Extracts session ID from event object or payload.
28358
+ *
28359
+ * @param event - The domain event
28360
+ * @param payload - The event payload
28361
+ * @returns The session ID or empty string if not found
28362
+ */
28363
+ declare function extractSessionId(event: DomainEvent, payload: Record<string, unknown>): string;
28364
+ /**
28365
+ * Creates initial session metrics with default values.
28366
+ *
28367
+ * @param sessionId - The session ID
28368
+ * @returns A new SessionMetrics object with initial values
28369
+ */
28370
+ declare function createInitialSessionMetrics(sessionId: string): SessionMetrics;
28371
+ /**
28372
+ * Creates initial token usage with zero values.
28373
+ *
28374
+ * @returns A new TokenUsage object with zero values
28375
+ */
28376
+ declare function createInitialTokenUsage(): TokenUsage$1;
28377
+ /**
28378
+ * Creates initial cost metrics with zero values.
28379
+ *
28380
+ * @returns A new CostMetrics object with zero values
28381
+ */
28382
+ declare function createInitialCostMetrics(): CostMetrics;
28383
+ /**
28384
+ * Creates a new TrackedAgent object with initial values.
28385
+ *
28386
+ * @param agentId - The agent ID
28387
+ * @param state - The initial agent state
28388
+ * @param role - The agent role (defaults to 'unknown')
28389
+ * @param currentTask - Optional current task description
28390
+ * @returns A new TrackedAgent object
28391
+ */
28392
+ declare function createTrackedAgent(agentId: string, state: AgentState$1, role?: string, currentTask?: string): TrackedAgent;
28393
+ /**
28394
+ * Calculates routing distribution from routing history.
28395
+ *
28396
+ * @param routingHistory - The routing decision history
28397
+ * @returns A record mapping CLI names to counts
28398
+ */
28399
+ declare function calculateRoutingDistribution(routingHistory: readonly RoutingDecision$2[]): Record<CliName, number>;
28400
+ /**
28401
+ * Aggregates token and cost totals from session metrics.
28402
+ *
28403
+ * @param sessionMetrics - Iterable of session metrics
28404
+ * @returns Object containing total tokens and total cost
28405
+ */
28406
+ declare function calculateMetricsTotals(sessionMetrics: Iterable<SessionMetrics>): {
28407
+ totalTokens: number;
28408
+ totalCost: number;
28409
+ };
28410
+ /**
28411
+ * Counts active sessions (sessions without a completedAt timestamp).
28412
+ *
28413
+ * @param sessionMetrics - Iterable of session metrics
28414
+ * @returns The count of active sessions
28415
+ */
28416
+ declare function countActiveSessions(sessionMetrics: Iterable<SessionMetrics>): number;
28417
+ /**
28418
+ * Finds the first active session (no completedAt) from metrics.
28419
+ *
28420
+ * @param sessionMetrics - Iterable of session metrics
28421
+ * @returns The first active session or undefined
28079
28422
  */
28080
- interface CollectRealVotesOptions extends VoterAgentOptions {
28081
- /** Voter roles to include */
28082
- readonly roles: readonly VoterRole[];
28083
- /** Proposal text */
28084
- readonly proposal: string;
28085
- /** Use simulation mode (explicit opt-in only) */
28086
- readonly simulate?: boolean;
28087
- }
28423
+ declare function findActiveSession(sessionMetrics: Iterable<SessionMetrics>): SessionMetrics | undefined;
28088
28424
  /**
28089
- * Error thrown when no adapter is available and simulation is disabled.
28425
+ * Identifies session IDs to remove based on max history limit.
28426
+ * Returns oldest sessions first.
28427
+ *
28428
+ * @param sessions - Array of [sessionId, metrics] entries
28429
+ * @param maxSessions - Maximum sessions to keep
28430
+ * @returns Array of session IDs to remove
28090
28431
  */
28091
- declare class NoAdapterError extends Error {
28092
- constructor(message: string);
28093
- }
28432
+ declare function identifySessionsToRemove(sessions: Array<[string, SessionMetrics]>, maxSessions: number): string[];
28094
28433
  /**
28095
- * Collects votes from multiple voter agents.
28434
+ * Calculates the cost for token usage based on rate.
28096
28435
  *
28097
- * Per Issue #280: No automatic simulation fallback. If no adapter is
28098
- * available and simulation is not explicitly enabled, throws NoAdapterError.
28099
- * Per Issue #845: Uses diverse CLIs when multiple are available.
28436
+ * @param tokens - Token usage to calculate cost for
28437
+ * @param ratePerThousand - Cost rate per 1000 tokens
28438
+ * @returns The calculated cost in USD
28100
28439
  */
28101
- declare function collectRealVotes(options: CollectRealVotesOptions): Promise<readonly AgentVoteResult[]>;
28440
+ declare function calculateTokenCost(tokens: TokenUsage$1, ratePerThousand: number): number;
28441
+
28442
+ /** A tracked task/issue. */
28443
+ interface TrackedTask {
28444
+ /** Backend-specific ID (issue number or local ID). */
28445
+ readonly id: string;
28446
+ readonly title: string;
28447
+ readonly status: 'open' | 'in_progress' | 'closed';
28448
+ readonly url?: string | undefined;
28449
+ }
28450
+ /** Task tracker interface — create, update, comment. */
28451
+ interface ITaskTracker {
28452
+ createTask(title: string, body: string): Promise<TrackedTask>;
28453
+ updateStatus(taskId: string, status: TrackedTask['status']): Promise<void>;
28454
+ postComment(taskId: string, comment: string): Promise<void>;
28455
+ }
28102
28456
 
28103
28457
  /**
28104
28458
  * nexus-agents/swe-bench - Type Definitions
@@ -28135,6 +28489,10 @@ interface SWEBenchInstance {
28135
28489
  readonly version?: string;
28136
28490
  /** Environment setup script. */
28137
28491
  readonly environment_setup_commit?: string;
28492
+ /** Tests that should pass after the fix (currently failing). */
28493
+ readonly FAIL_TO_PASS?: readonly string[];
28494
+ /** Tests that should continue passing after the fix. */
28495
+ readonly PASS_TO_PASS?: readonly string[];
28138
28496
  }
28139
28497
  /**
28140
28498
  * A prediction/solution for a SWE-bench instance.
@@ -28459,7 +28817,7 @@ declare function validatePrediction(prediction: unknown): prediction is SWEBench
28459
28817
  /**
28460
28818
  * System prompt for SWE-bench agent.
28461
28819
  */
28462
- declare const SWE_BENCH_SYSTEM_PROMPT = "You are an expert software engineer solving GitHub issues.\n\nYour task is to find the root cause and fix it with a minimal patch. Change as few lines as possible. Do not refactor surrounding code.\n\nGuidelines:\n1. Read the problem statement carefully.\n2. Read the FAIL_TO_PASS test names to understand expected behavior, but do NOT edit test files.\n3. Start with files mentioned in the error/traceback, then search for the function/class name.\n4. Identify the root cause of the issue.\n5. Edit only the source files needed for a minimal fix. Maintain backward compatibility.\n6. Run `git diff` to verify your changes are correct BEFORE outputting the patch.\n\nIMPORTANT: After making your fix, output the patch using this exact format:\n\n```diff\n[paste your \"git diff\" output here]\n```";
28820
+ declare const SWE_BENCH_SYSTEM_PROMPT = "You are an expert software engineer solving GitHub issues.\n\nYour task is to find the root cause and fix it with a minimal patch. Change as few lines as possible. Do not refactor surrounding code.\n\nGuidelines:\n1. Read the problem statement carefully.\n2. Read the FAIL_TO_PASS test names to understand expected behavior, but do NOT edit test files.\n3. Start with files mentioned in the error/traceback, then search for the function/class name.\n4. Identify the root cause of the issue.\n5. Edit only the source files needed for a minimal fix. Maintain backward compatibility.\n6. VERIFY your fix by running the failing test(s) BEFORE outputting the patch.\n7. If the test still fails after your fix, analyze the failure output and iterate.\n8. Run `git diff` to confirm your final changes.\n\nCONTEXT BUDGET: You have limited context. Be efficient:\n- Don't read entire files \u2014 use grep/search to find relevant sections\n- Don't explore the whole codebase \u2014 go directly to files mentioned in the error\n- Keep your analysis concise \u2014 focus on the root cause, not comprehensive review\n- If you're running low on context, output your best patch immediately\n\nIMPORTANT: After making your fix, output the patch using this exact format:\n\n```diff\n[paste your \"git diff\" output here]\n```";
28463
28821
  /**
28464
28822
  * Creates a user prompt for a specific SWE-bench instance.
28465
28823
  */
@@ -31086,9 +31444,6 @@ declare function extractFilesFromResponse(response: string): ExploredFile[];
31086
31444
  * Returns null if none found. Truncates to 200 chars.
31087
31445
  */
31088
31446
  declare function extractHypothesis(response: string): string | null;
31089
- /**
31090
- * Extracts an approach record from agent response and iteration metadata.
31091
- */
31092
31447
  declare function extractApproach(response: string, iteration: number, hadPatch: boolean, patchApplied: boolean): ApproachRecord;
31093
31448
  /**
31094
31449
  * Merges new findings into existing context.
@@ -31899,6 +32254,686 @@ interface V2Config {
31899
32254
  */
31900
32255
  declare function resolveV2Config(): V2Config;
31901
32256
 
32257
+ /** Agent roles used in the pipeline. */
32258
+ type PipelineRole = 'researcher' | 'architect' | 'pm' | 'coder' | 'qa' | 'security';
32259
+ /** A task decomposed by the PM, potentially with conditional approval requirements. */
32260
+ interface PipelineTask {
32261
+ readonly id: string;
32262
+ readonly title: string;
32263
+ readonly description: string;
32264
+ readonly assignedTo: PipelineRole;
32265
+ readonly status: 'pending' | 'in_progress' | 'review' | 'done' | 'rejected';
32266
+ readonly feedback?: string;
32267
+ /** Implementation text from the code expert (surfaced for harness use). */
32268
+ readonly implementation?: string;
32269
+ /** Conditions required for task completion (from conditional_go vote). */
32270
+ readonly conditions?: readonly string[] | undefined;
32271
+ /** Caveats/warnings associated with the task (from conditional_go vote). */
32272
+ readonly caveats?: readonly string[] | undefined;
32273
+ }
32274
+ /** Vote result from consensus — discriminated union with conditional approval support. */
32275
+ type VoteResult = {
32276
+ readonly kind: 'approved';
32277
+ readonly approvalPercentage: number;
32278
+ } | {
32279
+ readonly kind: 'rejected';
32280
+ readonly feedback: string;
32281
+ readonly approvalPercentage: number;
32282
+ } | {
32283
+ readonly kind: 'conditional_go';
32284
+ readonly conditions: readonly string[];
32285
+ readonly caveats: readonly string[];
32286
+ readonly approvalPercentage: number;
32287
+ };
32288
+ /** QA review result. */
32289
+ interface QaReviewResult {
32290
+ readonly verdict: 'pass' | 'needs_work' | 'reject';
32291
+ readonly feedback: string;
32292
+ readonly issues: readonly string[];
32293
+ }
32294
+ /** Overall pipeline result. */
32295
+ interface DevPipelineResult {
32296
+ readonly completed: boolean;
32297
+ readonly plan: string;
32298
+ readonly tasks: readonly PipelineTask[];
32299
+ readonly voteIterations: number;
32300
+ readonly qaIterations: number;
32301
+ readonly securityPassed: boolean;
32302
+ }
32303
+ /** Pluggable stage implementations — inject real or mock agents. */
32304
+ interface DevPipelineStages {
32305
+ /** Research expert gathers context for the task. */
32306
+ research(task: string): Promise<string>;
32307
+ /** Architect creates a plan from research + task. */
32308
+ plan(task: string, research: string, priorFeedback?: string): Promise<string>;
32309
+ /** Consensus vote on the plan. Returns approval + feedback. */
32310
+ vote(plan: string): Promise<VoteResult>;
32311
+ /** PM decomposes approved plan into tasks. */
32312
+ decompose(plan: string): Promise<PipelineTask[]>;
32313
+ /** Code expert implements a task. Returns the work product. */
32314
+ implement(task: PipelineTask): Promise<string>;
32315
+ /** QA expert reviews implementation. */
32316
+ qaReview(task: PipelineTask, implementation: string): Promise<QaReviewResult>;
32317
+ /** Security scan. Returns true if passed. */
32318
+ securityScan(): Promise<{
32319
+ passed: boolean;
32320
+ feedback: string;
32321
+ }>;
32322
+ }
32323
+ /** Pipeline execution mode. */
32324
+ type PipelineMode = 'autonomous' | 'harness';
32325
+ /** Options for pipeline execution. */
32326
+ interface DevPipelineOptions {
32327
+ /** Session ID for checkpoint/resume. Omit for no persistence. */
32328
+ readonly sessionId?: string | undefined;
32329
+ /** When true, stop after plan+vote and return partial result (#1717). */
32330
+ readonly dryRun?: boolean | undefined;
32331
+ /**
32332
+ * Pipeline mode (#1704):
32333
+ * - 'autonomous' (default): full pipeline runs internally
32334
+ * - 'harness': stops after decompose, returns tasks for external implementation
32335
+ */
32336
+ readonly mode?: PipelineMode | undefined;
32337
+ /** Optional BeliefMemory for hindsight updates after plan outcomes (#1720). */
32338
+ readonly beliefMemory?: IHindsightBeliefMemory | undefined;
32339
+ }
32340
+ /**
32341
+ * Execute the full multi-agent development pipeline.
32342
+ *
32343
+ * When `sessionId` is provided, each stage checkpoints to disk. On crash,
32344
+ * re-running with the same sessionId resumes from the last completed stage.
32345
+ *
32346
+ * @param task - High-level task description
32347
+ * @param stages - Pluggable stage implementations
32348
+ * @param options - Pipeline options (sessionId for checkpoint/resume)
32349
+ * @returns Pipeline result with all outputs
32350
+ */
32351
+ declare function runDevPipeline(task: string, stages: DevPipelineStages, options?: DevPipelineOptions): Promise<DevPipelineResult>;
32352
+
32353
+ /**
32354
+ * Expert Bridge — Programmatic access to the execute_expert pipeline (#1693)
32355
+ *
32356
+ * Provides a clean wrapper for calling experts with the full pipeline:
32357
+ * timeout, fallback cascade, degradation detection, heartbeat, outcome recording.
32358
+ *
32359
+ * DRY: reuses createBuiltInExpert + CompositeRouter instead of reimplementing.
32360
+ *
32361
+ * @module pipeline/expert-bridge
32362
+ */
32363
+
32364
+ /** Result of an expert execution. */
32365
+ interface ExpertBridgeResult {
32366
+ readonly success: boolean;
32367
+ readonly text: string;
32368
+ readonly expertType: BuiltInExpertType;
32369
+ readonly durationMs: number;
32370
+ readonly error?: string;
32371
+ }
32372
+ declare function executeExpert(expertType: BuiltInExpertType, prompt: string): Promise<ExpertBridgeResult>;
32373
+
32374
+ /**
32375
+ * Agent Executor — Connects pipeline stages to nexus-agents infrastructure (#1684)
32376
+ *
32377
+ * DRY integration (Issue #1691):
32378
+ * - CompositeRouter for intelligent multi-CLI routing (#1692)
32379
+ * - Pipeline observability events + OutcomeStore recording (#1696)
32380
+ * - Task tracker for GitHub/GitLab/JSON issue management
32381
+ *
32382
+ * @module pipeline/agent-executor
32383
+ */
32384
+
32385
+ /** Configuration for the agent executor. */
32386
+ interface AgentExecutorConfig {
32387
+ readonly scanTarget?: string | undefined;
32388
+ readonly simulateVotes?: boolean | undefined;
32389
+ /** Voting strategy for consensus stages (default: higher_order). */
32390
+ readonly votingStrategy?: 'simple_majority' | 'supermajority' | 'unanimous' | 'higher_order' | 'proof_of_learning' | 'opinion_wise' | undefined;
32391
+ /** Use 3 agents instead of 6 for faster voting (default: false). */
32392
+ readonly quickMode?: boolean | undefined;
32393
+ readonly tracker?: ITaskTracker | undefined;
32394
+ readonly issueNumber?: number | undefined;
32395
+ readonly repo?: string | undefined;
32396
+ }
32397
+ /** Flush pipeline memory session + persist MobiMem state (#1782). */
32398
+ declare function flushPipelineMemory(): void;
32399
+ declare function createAgentStages(config?: AgentExecutorConfig): DevPipelineStages;
32400
+
32401
+ /**
32402
+ * Research Trigger — Auto-create pipeline tasks from research discoveries (#1715)
32403
+ *
32404
+ * When research_discover finds high-quality papers/repos, this module
32405
+ * converts them into PipelineTask[] for the dev pipeline to assess.
32406
+ * Part of the Central Workflow Hub (#1711).
32407
+ *
32408
+ * @module pipeline/research-trigger
32409
+ */
32410
+
32411
+ /** Configuration for research trigger behavior. */
32412
+ interface ResearchTriggerConfig {
32413
+ /** Minimum quality score to trigger (0-10). Default: 7 */
32414
+ readonly qualityThreshold?: number | undefined;
32415
+ /** Max tasks per invocation. Default: 3 */
32416
+ readonly maxTriggers?: number | undefined;
32417
+ /** Topic filter for research_discover. */
32418
+ readonly topic?: string | undefined;
32419
+ /** Known task IDs to skip (dedup). */
32420
+ readonly existingTaskIds?: ReadonlySet<string> | undefined;
32421
+ }
32422
+ /**
32423
+ * Check for research discoveries and convert high-quality ones to pipeline tasks.
32424
+ *
32425
+ * Calls research_discover via expert-bridge, filters by quality threshold,
32426
+ * deduplicates against known tasks, and rate-limits output.
32427
+ *
32428
+ * Returns empty array when expert-bridge is unavailable (graceful degradation).
32429
+ */
32430
+ declare function checkForResearchTriggers(config?: ResearchTriggerConfig): Promise<PipelineTask[]>;
32431
+
32432
+ /**
32433
+ * Pipeline Checkpoint — Persist stage results for crash recovery (#1703)
32434
+ *
32435
+ * DRY: reuses ensureCheckpointDir from wave-checkpoint-persistence for
32436
+ * directory management and path security. Pipeline-specific JSONL schema.
32437
+ *
32438
+ * Storage: ~/.nexus-agents/checkpoints/pipeline-{sessionId}.jsonl
32439
+ *
32440
+ * @module pipeline/pipeline-checkpoint
32441
+ */
32442
+
32443
+ /** Stages that can be checkpointed. */
32444
+ type PipelineStage = 'research' | 'plan' | 'vote' | 'decompose' | 'implement' | 'security';
32445
+ /** Discriminated union of stage data. */
32446
+ type PipelineStageData = {
32447
+ readonly type: 'research';
32448
+ readonly text: string;
32449
+ } | {
32450
+ readonly type: 'plan';
32451
+ readonly text: string;
32452
+ readonly iterations: number;
32453
+ } | {
32454
+ readonly type: 'vote';
32455
+ readonly approved: boolean;
32456
+ readonly conditional: boolean;
32457
+ readonly conditions?: readonly string[];
32458
+ readonly caveats?: readonly string[];
32459
+ readonly iterations: number;
32460
+ } | {
32461
+ readonly type: 'decompose';
32462
+ readonly tasks: readonly PipelineTask[];
32463
+ } | {
32464
+ readonly type: 'implement';
32465
+ readonly tasks: readonly PipelineTask[];
32466
+ } | {
32467
+ readonly type: 'security';
32468
+ readonly passed: boolean;
32469
+ };
32470
+ /** Partial pipeline state loaded from checkpoints. */
32471
+ interface PipelineCheckpointState {
32472
+ readonly research?: string;
32473
+ readonly plan?: string;
32474
+ readonly voteIterations?: number;
32475
+ readonly voteConditional?: boolean;
32476
+ readonly voteConditions?: readonly string[];
32477
+ readonly voteCaveats?: readonly string[];
32478
+ readonly tasks?: readonly PipelineTask[];
32479
+ readonly implementedTasks?: readonly PipelineTask[];
32480
+ readonly securityPassed?: boolean;
32481
+ readonly lastCompletedStage?: PipelineStage;
32482
+ }
32483
+ /** Append a stage checkpoint to disk. */
32484
+ declare function saveStageCheckpoint(sessionId: string, stage: PipelineStage, data: PipelineStageData, customDir?: string): boolean;
32485
+ /** Load checkpoint state for a session. Returns null if no checkpoints exist. */
32486
+ declare function loadCheckpointState(sessionId: string, customDir?: string): PipelineCheckpointState | null;
32487
+ /** Delete checkpoint file on successful completion. */
32488
+ declare function cleanupCheckpoint(sessionId: string, customDir?: string): boolean;
32489
+ /** Build a DevPipelineResult from checkpoint state (for resume scenarios). */
32490
+ declare function checkpointToResult(state: PipelineCheckpointState): Partial<DevPipelineResult>;
32491
+
32492
+ /**
32493
+ * Pipeline Observability — Shared stage event emission (#1734, Phase 1.1)
32494
+ *
32495
+ * Extracts the duplicated emitStageEvent pattern from agent-executor.ts
32496
+ * and pipeline-runner.ts into a single shared helper.
32497
+ *
32498
+ * @module pipeline/pipeline-observability
32499
+ */
32500
+
32501
+ /** Options for emitting a stage started event. */
32502
+ interface StageStartedOptions {
32503
+ readonly bus?: IEventBus | undefined;
32504
+ readonly executionId: string;
32505
+ readonly stageId: string;
32506
+ readonly pluginId?: string | undefined;
32507
+ }
32508
+ /** Options for emitting a stage completed event. */
32509
+ interface StageCompletedOptions {
32510
+ readonly bus?: IEventBus | undefined;
32511
+ readonly executionId: string;
32512
+ readonly stageId: string;
32513
+ readonly durationMs: number;
32514
+ readonly success?: boolean | undefined;
32515
+ }
32516
+ /** Options for emitting a stage failed event. */
32517
+ interface StageFailedOptions {
32518
+ readonly bus?: IEventBus | undefined;
32519
+ readonly executionId: string;
32520
+ readonly stageId: string;
32521
+ readonly error: string;
32522
+ }
32523
+ /** Emit a stage.started event. */
32524
+ declare function emitStageStarted(options: StageStartedOptions): void;
32525
+ /** Emit a stage.completed event. */
32526
+ declare function emitStageCompleted(options: StageCompletedOptions): void;
32527
+ /** Emit a stage.failed event. */
32528
+ declare function emitStageFailed(options: StageFailedOptions): void;
32529
+ /**
32530
+ * Convenience wrapper matching agent-executor's original signature.
32531
+ * Emits stage events using the global event bus with a prefixed executionId.
32532
+ */
32533
+ declare function emitPipelineStageEvent(prefix: string, stage: string, status: 'started' | 'completed' | 'failed', details?: Record<string, unknown>): void;
32534
+
32535
+ /**
32536
+ * Iterative Consensus Stage — Reusable vote loop (#1734, Phase 1.2)
32537
+ *
32538
+ * Extracts the plan→vote→feedback iteration pattern from agent-executor.ts
32539
+ * into a reusable stage. Wraps executeVoting from consensus-vote.ts.
32540
+ *
32541
+ * @module pipeline/iterative-consensus
32542
+ */
32543
+
32544
+ /** Configuration for an iterative consensus vote. */
32545
+ interface IterativeConsensusConfig {
32546
+ /** Maximum plan→vote iterations (default: 3). */
32547
+ readonly maxIterations?: number | undefined;
32548
+ /** Use simulated votes (for testing). */
32549
+ readonly simulateVotes?: boolean | undefined;
32550
+ /** Use quick mode (3 agents instead of 6). */
32551
+ readonly quickMode?: boolean | undefined;
32552
+ /** Voting strategy (default: 'higher_order'). */
32553
+ readonly strategy?: VotingStrategy | undefined;
32554
+ /** Max proposal length sent to voters (default: 4000). */
32555
+ readonly maxProposalLength?: number | undefined;
32556
+ /** Logger instance. */
32557
+ readonly logger?: ILogger | undefined;
32558
+ /** Pipeline prefix for observability events. */
32559
+ readonly pipelinePrefix?: string | undefined;
32560
+ }
32561
+ /** Result of the iterative consensus process. */
32562
+ interface IterativeConsensusResult {
32563
+ readonly vote: VoteResult;
32564
+ readonly iterations: number;
32565
+ readonly durationMs: number;
32566
+ }
32567
+ declare function runIterativeConsensus(initialPlan: string, revisePlan: (plan: string, feedback: string) => Promise<string>, config?: IterativeConsensusConfig): Promise<IterativeConsensusResult>;
32568
+
32569
+ /**
32570
+ * Shared Memory — Cross-stage knowledge propagation (#1737, Phase 4)
32571
+ *
32572
+ * Early pipeline stages (planning, research) write structured discoveries
32573
+ * to a shared memory layer. Later stages read before acting.
32574
+ *
32575
+ * Scoped to a single pipeline run — not persisted cross-session.
32576
+ *
32577
+ * Pattern from: SWE-AF shared memory, AutoGen knowledge propagation.
32578
+ *
32579
+ * @module pipeline/shared-memory
32580
+ */
32581
+ /** A tagged memory entry written by a pipeline stage. */
32582
+ interface SharedMemoryEntry {
32583
+ /** Stage that wrote this entry. */
32584
+ readonly sourceStage: string;
32585
+ /** Category tag for filtering. */
32586
+ readonly tag: SharedMemoryTag;
32587
+ /** The content (structured or text). */
32588
+ readonly content: unknown;
32589
+ /** When this was written. */
32590
+ readonly timestamp: number;
32591
+ }
32592
+ /** Tags for categorizing shared memory entries. */
32593
+ type SharedMemoryTag = 'convention' | 'discovery' | 'constraint' | 'decision' | 'risk' | 'dependency' | 'context';
32594
+ /** In-memory store for cross-stage knowledge sharing. */
32595
+ declare class SharedMemoryStore {
32596
+ private readonly entries;
32597
+ private readonly maxEntries;
32598
+ constructor(maxEntries?: number);
32599
+ /** Write a memory entry. */
32600
+ write(sourceStage: string, tag: SharedMemoryTag, content: unknown): void;
32601
+ /** Read all entries, optionally filtered by tag. */
32602
+ read(tag?: SharedMemoryTag): readonly SharedMemoryEntry[];
32603
+ /** Read entries from a specific stage. */
32604
+ readFromStage(sourceStage: string): readonly SharedMemoryEntry[];
32605
+ /** Get summary of all entries as context string for LLM consumption. */
32606
+ summarize(maxLength?: number): string;
32607
+ /** Get entry count. */
32608
+ get size(): number;
32609
+ /** Clear all entries. */
32610
+ clear(): void;
32611
+ }
32612
+
32613
+ /**
32614
+ * Pipeline Stage Types — Shared interfaces for graph-backed pipelines (#1735, Phase 2)
32615
+ *
32616
+ * Defines the IPipelineStage interface that all pipeline stages implement.
32617
+ * Stages are wrapped as GraphBuilder NodeHandlers for execution.
32618
+ *
32619
+ * @module pipeline/stage-types
32620
+ */
32621
+ /** Read-only pipeline context passed to every stage. */
32622
+ interface PipelineContext {
32623
+ /** Unique pipeline execution ID. */
32624
+ readonly executionId: string;
32625
+ /** The original task/prompt that started the pipeline. */
32626
+ readonly task: string;
32627
+ /** Pipeline template being executed. */
32628
+ readonly templateId: string;
32629
+ /** Accumulated state from prior stages. */
32630
+ readonly state: Readonly<Record<string, unknown>>;
32631
+ /** Cross-stage knowledge store for discoveries, decisions, constraints (#1764). */
32632
+ readonly sharedMemory: SharedMemoryStore;
32633
+ }
32634
+ /** Result of executing a single pipeline stage. */
32635
+ interface StageOutput {
32636
+ /** The key to store this stage's output under in pipeline state. */
32637
+ readonly stateKey: string;
32638
+ /** The output value (stored in GraphState). */
32639
+ readonly value: unknown;
32640
+ /** Duration in milliseconds. */
32641
+ readonly durationMs: number;
32642
+ /** Whether the stage succeeded. */
32643
+ readonly success: boolean;
32644
+ /** Error message if failed. */
32645
+ readonly error?: string | undefined;
32646
+ }
32647
+ /** A pipeline stage that can be compiled into a graph node. */
32648
+ interface IPipelineStage {
32649
+ /** Unique stage identifier (used as graph node ID). */
32650
+ readonly id: string;
32651
+ /** Human-readable stage name. */
32652
+ readonly name: string;
32653
+ /** Execute the stage. */
32654
+ execute(context: PipelineContext): Promise<StageOutput>;
32655
+ }
32656
+ /** Edge definition in a pipeline template. */
32657
+ type PipelineEdge = {
32658
+ readonly type: 'fixed';
32659
+ readonly from: string;
32660
+ readonly to: string;
32661
+ } | {
32662
+ readonly type: 'conditional';
32663
+ readonly from: string;
32664
+ readonly routerKey: string;
32665
+ readonly targets: readonly string[];
32666
+ };
32667
+ /** A declarative pipeline template defining stages and their connections. */
32668
+ interface PipelineTemplate {
32669
+ /** Unique template identifier. */
32670
+ readonly id: string;
32671
+ /** Human-readable name. */
32672
+ readonly name: string;
32673
+ /** Ordered stage IDs (for simple linear pipelines). */
32674
+ readonly stages: readonly string[];
32675
+ /** Edge overrides (for non-linear flows like vote→plan feedback loops). */
32676
+ readonly edges?: readonly PipelineEdge[] | undefined;
32677
+ /** Stage IDs that can be skipped via dryRun. */
32678
+ readonly dryRunStopAfter?: string | undefined;
32679
+ }
32680
+ /** Standard state keys used across pipeline templates. */
32681
+ declare const PIPELINE_STATE_KEYS: {
32682
+ readonly TASK: "task";
32683
+ readonly RESEARCH: "research";
32684
+ readonly PLAN: "plan";
32685
+ readonly VOTE_RESULT: "voteResult";
32686
+ readonly VOTE_FEEDBACK: "voteFeedback";
32687
+ readonly VOTE_ITERATIONS: "voteIterations";
32688
+ readonly TASKS: "tasks";
32689
+ readonly IMPLEMENTATIONS: "implementations";
32690
+ readonly QA_ITERATIONS: "qaIterations";
32691
+ readonly SECURITY_PASSED: "securityPassed";
32692
+ readonly FINDINGS: "findings";
32693
+ readonly SYNTHESIS: "synthesis";
32694
+ readonly DELIVERABLES: "deliverables";
32695
+ readonly PARSED_SPEC: "parsedSpec";
32696
+ readonly SCAFFOLD_OUTPUT: "scaffoldOutput";
32697
+ readonly COMPLETED: "completed";
32698
+ readonly SHARED_MEMORY: "__sharedMemory__";
32699
+ };
32700
+
32701
+ /**
32702
+ * Pipeline Graph Compiler — Build executable graphs from templates (#1735, Phase 2)
32703
+ *
32704
+ * Compiles a PipelineTemplate + IPipelineStage implementations into a
32705
+ * CompiledGraph that can be executed by the GraphExecutor.
32706
+ *
32707
+ * @module pipeline/pipeline-graph
32708
+ */
32709
+
32710
+ /** Result of compiling a pipeline template into a graph. */
32711
+ interface PipelineGraphResult {
32712
+ readonly ok: boolean;
32713
+ readonly graph?: CompiledGraph | undefined;
32714
+ readonly error?: string | undefined;
32715
+ }
32716
+ /** Map of stage ID → stage implementation. */
32717
+ type StageRegistry = ReadonlyMap<string, IPipelineStage>;
32718
+ /**
32719
+ * Compile a pipeline template + stages into an executable graph.
32720
+ *
32721
+ * Each IPipelineStage is wrapped as a GraphBuilder node handler.
32722
+ * Linear edges are auto-generated from template.stages order.
32723
+ * Custom edges override the linear flow for feedback loops.
32724
+ */
32725
+ declare function compilePipelineGraph(template: PipelineTemplate, stages: StageRegistry): PipelineGraphResult;
32726
+
32727
+ /**
32728
+ * Pipeline Templates — Declarative pipeline configurations (#1735, Phase 2)
32729
+ *
32730
+ * Predefined pipeline shapes that can be compiled into executable graphs.
32731
+ * Each template defines stage ordering and edge routing.
32732
+ *
32733
+ * @module pipeline/templates
32734
+ */
32735
+
32736
+ /** Development pipeline: research → plan → vote → decompose → implement → qa → security. */
32737
+ declare const DEV_PIPELINE_TEMPLATE: PipelineTemplate;
32738
+ /** Research pipeline: decompose → investigate → synthesize → vote → scaffold. */
32739
+ declare const RESEARCH_PIPELINE_TEMPLATE: PipelineTemplate;
32740
+ /** Security audit pipeline: analyze → scan → report. */
32741
+ declare const AUDIT_PIPELINE_TEMPLATE: PipelineTemplate;
32742
+ /**
32743
+ * General-purpose pipeline for tasks that don't match a specific template.
32744
+ * Includes security gate (fail-safe: unclassified tasks must not bypass security).
32745
+ */
32746
+ declare const GENERAL_PIPELINE_TEMPLATE: PipelineTemplate;
32747
+ /** All available pipeline templates. */
32748
+ declare const PIPELINE_TEMPLATES: ReadonlyMap<string, PipelineTemplate>;
32749
+ /** Get a pipeline template by ID. */
32750
+ declare function getTemplate(id: string): PipelineTemplate | undefined;
32751
+ /** List all available template IDs. */
32752
+ declare function listTemplateIds(): readonly string[];
32753
+
32754
+ /**
32755
+ * Stage Wrappers — Adapt DevPipelineStages to IPipelineStage (#1735, Phase 2)
32756
+ *
32757
+ * Wraps existing agent-executor stage functions as IPipelineStage objects
32758
+ * that can be compiled into graph nodes. This is an adapter layer that
32759
+ * preserves existing behavior while enabling graph-based execution.
32760
+ *
32761
+ * @module pipeline/stage-wrappers
32762
+ */
32763
+
32764
+ /** Create a complete stage registry for the dev pipeline template. */
32765
+ declare function createDevStageRegistry(stages: DevPipelineStages): Map<string, IPipelineStage>;
32766
+
32767
+ /**
32768
+ * Graph Pipeline Runner — Execute pipelines via GraphBuilder (#1735, Phase 2)
32769
+ *
32770
+ * Provides a runGraphPipeline() function that compiles a PipelineTemplate
32771
+ * + stage registry into an executable graph and runs it through the
32772
+ * graph executor with checkpoint/resume support.
32773
+ *
32774
+ * @module pipeline/graph-pipeline-runner
32775
+ */
32776
+
32777
+ /** Options for graph-based pipeline execution. */
32778
+ interface GraphPipelineOptions {
32779
+ /** When true, stop after the dryRunStopAfter stage. */
32780
+ readonly dryRun?: boolean | undefined;
32781
+ /** Maximum graph execution steps (default: 20). */
32782
+ readonly maxSteps?: number | undefined;
32783
+ }
32784
+ /** Result of a graph-based pipeline execution. */
32785
+ interface GraphPipelineResult {
32786
+ readonly success: boolean;
32787
+ readonly templateId: string;
32788
+ readonly stepsExecuted: number;
32789
+ readonly durationMs: number;
32790
+ readonly finalState: Readonly<Record<string, unknown>>;
32791
+ readonly error?: string | undefined;
32792
+ }
32793
+ /**
32794
+ * Run a pipeline using graph-based execution.
32795
+ *
32796
+ * Compiles the template + stages into a graph, then executes via
32797
+ * the graph executor (super-step BSP model).
32798
+ */
32799
+ declare function runGraphPipeline(task: string, template: PipelineTemplate, stages: StageRegistry, options?: GraphPipelineOptions): Promise<GraphPipelineResult>;
32800
+ /** Extract a value from the final pipeline state. */
32801
+ declare function extractStateValue(state: Readonly<Record<string, unknown>>, key: string): unknown;
32802
+
32803
+ /**
32804
+ * Adaptive Orchestrator — Task-driven pipeline selection (#1736, Phase 3)
32805
+ *
32806
+ * Analyzes incoming tasks, selects the appropriate pipeline template,
32807
+ * and executes via the graph pipeline runner. Single entry point
32808
+ * for all pipeline types.
32809
+ *
32810
+ * Design pattern: deterministic state machine backbone + selective
32811
+ * LLM invocation at decision nodes only (per CrewAI Flows / Temporal).
32812
+ *
32813
+ * @module pipeline/adaptive-orchestrator
32814
+ */
32815
+
32816
+ /** Options for the adaptive orchestrator. */
32817
+ interface AdaptiveOrchestratorOptions extends GraphPipelineOptions {
32818
+ /** Force a specific template (skip auto-detection). */
32819
+ readonly templateId?: string | undefined;
32820
+ /** Stage registry to use. If omitted, stages must be provided per-template. */
32821
+ readonly stages: StageRegistry;
32822
+ }
32823
+ /** Result of adaptive orchestration — extends GraphPipelineResult with metadata. */
32824
+ interface AdaptiveOrchestratorResult extends GraphPipelineResult {
32825
+ /** How the template was selected. */
32826
+ readonly selectionMethod: 'explicit' | 'auto-detected';
32827
+ /** Task classification used for selection. */
32828
+ readonly taskClassification: TaskClassification;
32829
+ }
32830
+ /** Classification of a task for template routing. */
32831
+ interface TaskClassification {
32832
+ readonly pipelineType: PipelineType;
32833
+ readonly complexity: 'simple' | 'moderate' | 'complex';
32834
+ readonly confidence: number;
32835
+ readonly keywords: readonly string[];
32836
+ }
32837
+ /** Pipeline type derived from task analysis. */
32838
+ type PipelineType = 'dev' | 'research' | 'audit' | 'greenfield' | 'general';
32839
+ /** Classify a task for pipeline routing. */
32840
+ declare function classifyTask(task: string): TaskClassification;
32841
+ /**
32842
+ * Run the adaptive orchestrator — classify task, select template, execute.
32843
+ *
32844
+ * This is the single entry point for all pipeline execution.
32845
+ */
32846
+ declare function runAdaptiveOrchestrator(task: string, options: AdaptiveOrchestratorOptions): Promise<AdaptiveOrchestratorResult>;
32847
+
32848
+ /**
32849
+ * Incomplete Result — Typed partial completion for pipeline stages (#1737, Phase 4)
32850
+ *
32851
+ * When a stage cannot fully complete, it emits an IncompleteResult with
32852
+ * severity and justification. Downstream stages can gate on this —
32853
+ * compensate, skip, or escalate.
32854
+ *
32855
+ * Pattern from: SWE-AF explicit incompleteness.
32856
+ *
32857
+ * @module pipeline/incomplete-result
32858
+ */
32859
+ /** Severity of an incomplete result. */
32860
+ type IncompleteSeverity = 'info' | 'warning' | 'error' | 'critical';
32861
+ /** A typed partial result from a pipeline stage. */
32862
+ interface IncompleteResult {
32863
+ /** The stage that produced this result. */
32864
+ readonly stageId: string;
32865
+ /** What was accomplished (may be partial). */
32866
+ readonly partialOutput: unknown;
32867
+ /** What was NOT accomplished. */
32868
+ readonly missing: readonly string[];
32869
+ /** Severity — determines downstream behavior. */
32870
+ readonly severity: IncompleteSeverity;
32871
+ /** Why the stage couldn't fully complete. */
32872
+ readonly justification: string;
32873
+ /** Whether downstream stages can proceed. */
32874
+ readonly canProceed: boolean;
32875
+ }
32876
+ /** Check if a value is an IncompleteResult. */
32877
+ declare function isIncompleteResult(value: unknown): value is IncompleteResult;
32878
+ /** Create an IncompleteResult. */
32879
+ declare function createIncompleteResult(stageId: string, partialOutput: unknown, missing: readonly string[], severity: IncompleteSeverity, justification: string): IncompleteResult;
32880
+ /** Check if a pipeline can proceed given incomplete results. */
32881
+ declare function canPipelineProceed(results: readonly IncompleteResult[]): boolean;
32882
+ /** Filter incomplete results by severity. */
32883
+ declare function filterBySeverity(results: readonly IncompleteResult[], minSeverity: IncompleteSeverity): readonly IncompleteResult[];
32884
+
32885
+ /**
32886
+ * Dynamic Expert Creation — Bounded agent creation at runtime (#1737, Phase 4)
32887
+ *
32888
+ * When the PM/Orchestrator detects a capability gap, it can create
32889
+ * temporary expert types. Bounded to MAX_DYNAMIC_EXPERTS per run.
32890
+ *
32891
+ * New experts are temporary (not persisted to registry unless promoted).
32892
+ * Capabilities are constrained to subset of existing tool permissions.
32893
+ *
32894
+ * @module pipeline/dynamic-expert
32895
+ */
32896
+ /** Specification for a dynamically created expert. */
32897
+ interface DynamicExpertSpec {
32898
+ /** Unique ID for this expert. */
32899
+ readonly id: string;
32900
+ /** Human-readable name. */
32901
+ readonly name: string;
32902
+ /** System prompt / role description. */
32903
+ readonly roleDescription: string;
32904
+ /** Capabilities this expert needs. */
32905
+ readonly capabilities: readonly string[];
32906
+ /** Why this expert was created. */
32907
+ readonly justification: string;
32908
+ }
32909
+ /** A created dynamic expert instance. */
32910
+ interface DynamicExpert {
32911
+ /** The spec used to create this expert. */
32912
+ readonly spec: DynamicExpertSpec;
32913
+ /** When this expert was created. */
32914
+ readonly createdAt: number;
32915
+ /** Whether this expert has been promoted to the permanent registry. */
32916
+ readonly promoted: boolean;
32917
+ }
32918
+ /** Maximum dynamic experts that can be created per pipeline run. */
32919
+ declare const MAX_DYNAMIC_EXPERTS = 2;
32920
+ /** Manages dynamic expert creation within a pipeline run. */
32921
+ declare class DynamicExpertManager {
32922
+ private readonly experts;
32923
+ private readonly maxExperts;
32924
+ constructor(maxExperts?: number);
32925
+ /** Create a new dynamic expert. Returns null if limit reached. */
32926
+ create(spec: DynamicExpertSpec): DynamicExpert | null;
32927
+ /** Get all created experts. */
32928
+ list(): readonly DynamicExpert[];
32929
+ /** Get an expert by ID. */
32930
+ get(id: string): DynamicExpert | undefined;
32931
+ /** How many more experts can be created. */
32932
+ get remaining(): number;
32933
+ /** Whether the limit has been reached. */
32934
+ get atLimit(): boolean;
32935
+ }
32936
+
31902
32937
  /**
31903
32938
  * nexus-agents/scm - SCM Provider Types
31904
32939
  *
@@ -32044,6 +33079,7 @@ interface IScmProvider {
32044
33079
  readonly repo: string;
32045
33080
  getIssue(number: number): Promise<Result<ScmIssue, ScmError>>;
32046
33081
  listIssues(filters?: IssueFilters): Promise<Result<readonly ScmIssue[], ScmError>>;
33082
+ createIssue(title: string, body: string, labels?: readonly string[]): Promise<Result<ScmIssue, ScmError>>;
32047
33083
  addLabels(issueNumber: number, labels: readonly string[]): Promise<Result<void, ScmError>>;
32048
33084
  createPR(options: CreatePROptions): Promise<Result<ScmPullRequest, ScmError>>;
32049
33085
  mergePR(prNumber: number, options?: MergePROptions): Promise<Result<void, ScmError>>;
@@ -32147,6 +33183,7 @@ declare class GitHubProvider implements IScmProvider {
32147
33183
  createPR(options: CreatePROptions): Promise<Result<ScmPullRequest, ScmError>>;
32148
33184
  mergePR(prNumber: number, options?: MergePROptions): Promise<Result<void, ScmError>>;
32149
33185
  getPRStatus(prNumber: number): Promise<Result<PRStatus, ScmError>>;
33186
+ createIssue(title: string, body: string, labels?: readonly string[]): Promise<Result<ScmIssue, ScmError>>;
32150
33187
  addComment(issueNumber: number, body: string): Promise<Result<void, ScmError>>;
32151
33188
  listComments(issueNumber: number): Promise<Result<readonly ScmComment[], ScmError>>;
32152
33189
  }
@@ -32247,4 +33284,4 @@ declare function createScmProvider(config: CreateScmProviderConfig): Promise<Res
32247
33284
  */
32248
33285
  declare function createGitHubProvider(repo: string): IScmProvider;
32249
33286
 
32250
- export { ALLOWED_COMMANDS, ARTIFACT_TYPES, AbTestTracker, type ActionContext, type ActionRecord, type ActionValidationResult, type ActivationOptions, type ActivationStrategy, ActivationStrategySchema, type ActivityItem, type AdapterConfig, AdapterConfigSchema, type AdapterCreator, AdapterFactory, AdapterModelError, RateLimiter$1 as AdapterRateLimiter, type RateLimiterConfig$1 as AdapterRateLimiterConfig, type RegisterOptions$1 as AdapterRegisterOptions, type AdaptiveThresholdResult, type AgentAction, AgentActionSchema, type AgentActionType, AgentCapability, type AgentCluster, type AgentContext, AgentError, type AgentEvent, AgentEventSchema, type AgentExecutionResult, type AgentFinding, AgentFindingSchema, type AgentId, type AgentMessage, AgentMessageSchema, type AgentMessageType, type AgentPairKey, type AgentPerformance, AgentPerformanceSchema, type AgentResponse, type AgentRole, AgentRoleSchema, type AgentRoleType, AgentRunnerError, type AgentState$2 as AgentState, AgentStateMachine, AgentStateSchema, type AgentStatus, StepExecutor as AgentStepExecutor, type AgentVoteResult, type AgentVoteSummary, type AggregatedResult, type AggregationMetadata, type AggregationStrategy, type AggregatorInput, type AggregatorOptions, AnalysisError$1 as AnalysisError, type ApiDocumentation, type ApiEndpoint, type ApiKeyConfig, type ApiType, type AppConfig, AppConfigSchema, type ApproachOutcome, type ApproachRecord, type ArchitectureAnalysisResult, type ArchitectureDecision, ArchitectureExpert, type ArchitectureExpertOptions, type ArchitecturePattern, type ArchitectureStyle, type Artifact, type ArtifactFilter, type ArtifactRef, ArtifactRefSchema, ArtifactStore, type ArtifactStoreOptions, type ArtifactType, type AuditActor, AuditActorSchema, type AuditCategory, AuditCategorySchema, AuditError, type AuditEvent$1 as AuditEvent, type AuditEventInput, AuditEventInputSchema, AuditEventSchema, type AuditHandlerConfig, type AuditLogConfig, AuditLogConfigSchema, AuditLogger, type AuditOutcome, AuditOutcomeSchema, type AuditQueryCriteria, AuditQueryCriteriaSchema, type AuditResource, AuditResourceSchema, type AuditSeverity, AuditSeveritySchema, AuditTrail, type AuthContext, type AuthorizationMethod, AuthorizationMethodSchema, AvailabilityCache, type AvailabilityCacheConfig, BIAS_CATEGORY, BUILT_IN_EXPERTS, BUILT_IN_RULES, BUILT_IN_TEMPLATES, BaseAdapter, type BaseAdapterConfig, type BaseAdapterOptions, BaseAgent, type BaseAgentOptions, BaseAgentOptionsSchema, BaseCliAdapter, type BaseMcpToolDeps, type BenchmarkRunOptions, type BenchmarkRunResult, type BestSolution, BestSolutionSchema, type BottleneckInfo, type BuiltInExpertType, BuiltInExpertTypeSchema, CHECKPOINT_SCHEMA_VERSION, CLAUDE_MODELS, CLAUDE_MODEL_ALIASES, DEFAULT_CACHE_CONFIG as CLI_DEFAULT_CACHE_CONFIG, DEFAULT_CAPABILITIES$1 as CLI_DEFAULT_CAPABILITIES, DEFAULT_COMPOSITE_CONFIG as CLI_DEFAULT_COMPOSITE_CONFIG, CLI_TIMEOUT_PROFILES, CLI_VERSION_REQUIREMENTS, COMPLEXITY_ORDER, CORE_PLUGINS, type CancelledResultFactory, type CapabilityProfile, type CapacityStatus, type Checkpoint, type CheckpointSummary, type CircuitProtectedResult, type ClassifyInput, type ClassifyResult, ClaudeAdapter, type ClaudeAdapterConfig, ClaudeCliAdapter, type ClaudeCliResponse, ClaudeResponseParser, type CliAdapterConfig, CliAgentExecutor, type CliAgentExecutorConfig, type CacheStats as CliCacheStats, type CapabilityProfile$1 as CliCapabilityProfile, type CliCircuitBreakerConfig, CliCircuitBreakerIntegration, type CliCircuitHealthStatus, CliDetectionCache, type CliDetectionCacheConfig, CliDetectionCacheConfigSchema, type CliError, type CliErrorCode, type ExecutionOptions$1 as CliExecutionOptions, type CliHealthResult, type ModelInfo as CliModelInfo, type CliName, type CliResponse, type CliTask, type TaskComplexity$1 as CliTaskComplexity, type TokenUsage$2 as CliTokenUsage, type CliTransport, type CodeAnalysisResult, type CodeChange, CodeChangeSchema, CodeExpert, type CodeExpertOptions, CodexCliAdapter, type CodexCliResponse, CodexMcpAdapter, CodexResponseParser, type CollaborationConfig, CollaborationConfigSchema, type CollaborationMessage, type CollaborationPattern, CollaborationPatternSchema, type CollaborationResult, CollaborationSession, type CollaborationSessionOptions, type CollectRealVotesOptions, CompactDashboardRenderer, type ComparisonReport, type ComparisonResult, type CompetitorResult, type CompetitorSystem, type CompileOptions, type CompileResult$2 as CompileResult, type CompiledGraph, type CompiledPipeline, type CompletionRequest, type CompletionResponse, type ComplexityLevel, ComplexityLevelSchema, type ComplianceStatus, CompositeRouter, type CompositeRouterConfig, CompositeRouterConfigSchema, type CompositeRouterStats, type CompositeRoutingDecision, CompositeRoutingError, type CompositionStep, type CompositionValidation, type ComputedReward, type ConfidenceInterval, ConfigError, type ExpertConfig$1 as ConfigExpertConfig, ExpertConfigSchema$1 as ConfigExpertConfigSchema, type ExpertDefinition$1 as ConfigExpertDefinition, ExpertDefinitionSchema as ConfigExpertDefinitionSchema, type Conflict, type ConflictResolver, type ConflictWarning, type ConsensusAlgorithm, ConsensusAlgorithmSchema, ConsensusEngine, type ConsensusEngineConfig, ConsensusEngineConfigSchema, ConsensusError, type ConsensusMetrics, ConsensusMetricsSchema, ConsensusProtocol, type ConsensusResult, ConsensusResultSchema, type ConsensusVoteDeps, type ConsensusVoteInput, ConsensusVoteInputSchema, type ConsensusVoteResponse, type ConsolidatedFinding, type ContentBlock, ContentPriority, type ContextBudget, ContextBudgetSchema, type ContextFilter, ContextFilterSchema, type ContextItem, ContextManager, type ContextManagerConfig, ContextManagerConfigSchema, type ContextPruneStrategy, ContextPruneStrategySchema, ContextPruner, type ContextPrunerConfig, ContextPrunerConfigSchema, type ContextStats, type ContributionScore, type CorePluginRegistrationResult, type CorrelationCoefficient, CorrelationCoefficientSchema, type CorrelationMatrix, CorrelationTracker, type CorrelationTrackerStats, CorrelationTrackerStatsSchema, type CorroborationEvent, type CorroborationResult, type CorroborationRule, type CostEstimate, CostEstimateSchema, type CostMetrics, type CoverageAnalysis, type CoverageMetrics, CoverageMetricsSchema, type CreateExecutionContextOptions, type CreateExpertDeps, type CreateExpertInput, CreateExpertInputSchema, type CreateExpertOptions, type CreateExpertResponse, type CreateForestInput, type CreateNodeInput, type CreatePROptions, type CreateScmProviderConfig, type CreateSkillOptions, type CreateStreamOptions, type CreateTreeInput, type CriterionFailure, type CriterionResult, CriterionResultSchema, CriterionType, CriterionTypeSchema, type CriterionTypeType, type CrossTreeInfo, CrossTreeInfoSchema, type CrossTreeStrategy, CrossTreeStrategySchema, type CuratedContextItem, type CurationResult, DECEPTION_CATEGORY, DEFAULT_ACTIVATION_OPTIONS, DEFAULT_BUDGET, DEFAULT_COMPOSER_CONFIG, DEFAULT_CONSENSUS_CONFIG, DEFAULT_DASHBOARD_CONFIG, DEFAULT_DASHBOARD_RENDER_OPTIONS, DEFAULT_DISTILLER_CONFIG, DEFAULT_EVALUATION_CONFIG, DEFAULT_EXECUTION_TIME_MS, DEFAULT_FEEDBACK_COLLECTOR_CONFIG, DEFAULT_FEEDBACK_INTEGRATION_CONFIG, DEFAULT_FOREST_CONFIG, DEFAULT_HARNESS_EXECUTION_CONFIG, DEFAULT_HIGHER_ORDER_CONFIG, DEFAULT_MAX_RETRIES, DEFAULT_OUTCOME_STORAGE_CONFIG, DEFAULT_PATCH_OPTIONS, DEFAULT_PATH_SCORING_OPTIONS, DEFAULT_PERMISSIONS, DEFAULT_POLICIES, DEFAULT_PREFERENCE_ROUTER_CONFIG, DEFAULT_RBAC, DEFAULT_REPORT_CONFIG, DEFAULT_RESOURCE_LIMITS, DEFAULT_RETRY_CONFIG, DEFAULT_ROLE_MAPPINGS, DEFAULT_SKILL_LIBRARY_CONFIG, DEFAULT_SKILL_LOADER_CONFIG, DEFAULT_STATISTICAL_OPTIONS, DEFAULT_SWARM_OBSERVER_CONFIG, DEFAULT_SWE_BENCH_CONFIG, DEFAULT_TEST_RUNNER_CONFIG, DEFAULT_TIMEOUTS, DEFAULT_TIMEOUT_PROFILE, DEFAULT_TRINITY_CONFIG, DEFAULT_VOTING_PROTOCOL_CONFIG, DEFAULT_WAVE_CONFIG, DEFAULT_WEIGHTED_VOTING_CONFIG, type DagEdge, DagEdgeSchema, Dashboard, type DashboardConfig, DashboardConfigSchema, type DashboardFilter, type DashboardFormat, type DashboardHealthIndicators, type DashboardOutcome, type DashboardRenderOptions, type DashboardSnapshot, type DashboardSummary, type DashboardUpdateOptions, DatasetLoadError, type DatasetLoadOptions, type DatasetLoadResult, type DecomposeError, type DelegateDeps, type DelegateInput, type DelegateInputLike, DelegateInputSchema, type DelegateOutput, DelegateOutputSchema, type DependencyError, type DependencyErrorCode, DependencyErrorCodeSchema, DependencyErrorSchema, DependencyGraph, type DependencyStructure, DirectedInteractionGraph, type DiskSpaceValidation, type DistilledRule, type DistillerConfig, type DistillerStats, type DistributionStats, type DockerExecutionState, type DockerValidation, DocumentationExpert, type DocumentationExpertOptions, type DocumentationResult, type DocumentationSection, type DryRunResult, END, EXPERT_CAPABILITIES, EXPERT_DEFAULT_CAPABILITIES, EXPERT_DEFAULT_TEMPERATURES, EXPERT_TYPE_TO_ROLE, type EnvValidationResult, type EnvironmentValidationResult, ErrorCode, type ErrorHandler, type ErrorPayload, type EvaluationCacheLevel, type EvaluationCriterion, EvaluationCriterionSchema, type EvaluationErrorCode, EvaluationHarness, type EvaluationHarnessConfig, EvaluationHarnessError, type EvaluationMetrics, type EvaluationMode, type EvaluationPhase, type EvaluationProgress, type EvaluationProgressCallback, type EvaluationReport, type EvaluationRunResult, type EvaluationValidationResult, EventBus, type EventBusBridgeOptions, type EventBusBridgeResult, type EventBusOptions, type EventFilter, type EventHandler, type EventPayload, type EventType, type ExecuteExpertDeps, type ExecuteExpertInput, ExecuteExpertInputSchema, type ExecuteExpertResponse, type ExecuteSpecDeps, type ExecuteSpecInput, ExecuteSpecInputSchema, type ExecutionContext$1 as ExecutionContext, type ExecutionMode, type ExecutionPhase$1 as ExecutionPhase, type ExecutionPlan$2 as ExecutionPlan, type ExecutionStage, type ExecutorWithModel, ExpectedOutcome, ExpectedOutcomeSchema, type ExpectedOutcomeType, type ExperienceRecord, type ExperienceStep, type ExperimentDefinition, type ExperimentExport, type ExperimentOutcome, type ExperimentResult, type ExperimentStatus, type ExperimentSummary, type ExperimentVariant, Expert, type ExpertAssignment, ExpertAssignmentSchema, ExpertCollaborationPattern, type ExpertCollaborationPatternType, type ExpertConfig, ExpertConfigSchema, type ExpertDefinition, type ExpertDomain, ExpertDomainSchema, ExpertFactory, ExpertFactoryAdapter, type ExpertInfo, type ExpertMatch, ExpertMatchSchema, type ExpertOptions, ExpertOptionsSchema, type ExpertOutput, ExpertOutputSchema, type ExpertParticipation, ExpertParticipationSchema, type RegisterOptions as ExpertRegisterOptions, ExpertRegistry$1 as ExpertRegistry, type ExpertResult, type ExpertResultSummary, type ExplorationEvent, ExplorationEventSchema, type ExplorationEventType, ExplorationEventTypeSchema, type ExploredFile, type ExpressionType, FALLBACK_SCANNER_DATA, FactoryError, type FailureAnalysis$1 as FailureAnalysis, type AnalysisError as FailureAnalysisError, type FailureCategory, type FailurePattern$1 as FailurePattern, FailurePatternSchema, type FailureStatistics, type FailureType, type FallbackBehavior, type FallbackEntry, type FeedbackCollectorConfig, FeedbackCollectorConfigSchema, FeedbackIntegration, type FeedbackIntegrationConfig, type FeedbackLoopStats, type FeedbackMessage, type RoutingDecision as FeedbackRoutingDecision, RoutingDecisionSchema as FeedbackRoutingDecisionSchema, FileAuditStorage, type FileReference, FileReferenceSchema, type FileRelevance, type FindingVote, FindingVoteSchema, type Artifact$1 as FirewallArtifact, type PolicyContext$1 as FirewallPolicyContext, type PolicyDecision$2 as FirewallPolicyDecision, type PolicyRule$1 as FirewallPolicyRule, type FirewallResult, type Forest, type ForestConfig, ForestConfigSchema, type ForestId, type ForestPruningStrategy, ForestPruningStrategySchema, type ForestResult, ForestResultSchema, type ForestState, ForestStateSchema, type ForestStatistics, ForestStatisticsSchema, type FrameworkDetectionResult, type FullCapableProvider, GEMINI_MODELS, GEMINI_MODEL_ALIASES, GeminiAdapter, type GeminiAdapterConfig, GeminiCliAdapter, type GeminiCliResponse, GeminiResponseParser, type GeneratedMcpConfig, type GeneratedTest, GeneratedTestSchema, type GitHubInput, GitHubProvider, GitHubReviewer, GitHubUserInfo, type GitHubUserMetadata, type GitHubUserRole, GitHubUserRoleSchema, GraphBuilder, type GraphCompileError, type GraphEdge, type GraphEdgeDisplay, type GraphEvent, type GraphExecuteOptions, type GraphExecutionAuditEvent, type GraphExecutionResult, type GraphNode, type GraphState, type GraphStats, type GraphSummary, type GraphWorkflowInfo, HARM_EMOTIONAL_CATEGORY, HARM_FINANCIAL_CATEGORY, HARM_PHYSICAL_CATEGORY, type HarnessErrorCode, type HarnessExecutionConfig, type HarnessExecutionProgress, type HarnessExecutionResult, type HarnessExecutionState, HarnessExecutor, HarnessExecutorError, type HarnessProgressCallback, type HarnessValidationResult, type HealthStatus, type HigherOrderVotingConfig, HigherOrderVotingConfigSchema, type HigherOrderVotingResult, HigherOrderVotingResultSchema, HigherOrderVotingStrategy, type HookError, HostileInputFirewall, type IAbTestTracker, type IAgent, type IAgentExecutor, type IArtifactStore, type IAuditLogger, type IAuditStorage, type IBenchmarkWriter, type ICTMConfig, ICTMConfigSchema, type ICTMInferenceResult, ICTMInferenceResultSchema, type ICheckpointStore, type ICliAdapter, type ICliCircuitBreakerIntegration, type ICliDetectionCache, type ICliResponseParser, type ICollaborationProtocol, type ICompositeRouter, type IConsensusEngine, type ICorrelationTracker, type IDashboard, type IDashboardRenderer, type IEvaluationHarness, type IEventBus, type IFeedbackIntegration, type IHarnessExecutor, type IHigherOrderVoting, type ISwarmObserver as IInteractionObserver, type ILogger, type IMcpNotifier, type IModelAdapter, INSTRUCTION_SAFETY_CATEGORY, type IOrchestrationObserver, type IOrchestrator, type IOrchestratorFactory, type IOutcomeFeedback, type IOutcomeStorage, type IPatchApplicator, type IPluginRegistry, type IPolicyEngine, type IPolicyFirewall, type IPreferenceDataStore, type IReportGenerator, type IRestApiServer, type IRoutingMemory$1 as IRoutingMemory, type ISQLiteDatabase, type ISQLiteStatement, type ISandboxExecutor, type IScmProvider, type IScmReviewer, type IScmUserInfo, type ISkillDependencyGraph, type ISkillLoader, type ISwarmObserver$1 as ISwarmObserver, type ITemplateRegistry, type ITestRunner, type ITokenCounter, type IVotingProtocol, type IVotingStrategy, type IWeightedVoting, type IWorkflowEngine, type IWorkflowRouter, type ImprovementSuggestion, InMemoryAuditStorage, InMemoryCheckpointStore, InMemoryPreferenceStore, type IndependentSubset, IndependentSubsetSchema, type InjectionFlag, InjectionFlagSchema, type InputBinding, type InputDefinition, type InputDefinitionInput, type InputDefinitionOutput, InputDefinitionSchema, type InputType, InputTypeSchema, type InstanceEvaluationResult, type InteractionEdge, type InteractionGraph, type SwarmObserverConfig as InteractionObserverConfig, SwarmObserverConfigSchema as InteractionObserverConfigSchema, type InteractionOutcome, SwarmObserver as InteractionSwarmObserver, type InvalidVar, type IssueFilters, type IssueReference, IssueReferenceSchema, type IssueTriageDeps, type IssueTriageInput, IssueTriageInputSchema, type IssueTriageResponse, type IterationContext, JsonDashboardRenderer, KNOWN_SECTIONS, type KnownSection, type LanguageMatrixEntry, type LeaderboardEntry, type LeaderboardSnapshot, type LearningProgress, type LibraryStatistics, type ListExpertsDeps, type ListExpertsInput, ListExpertsInputSchema, type ListExpertsResponse, type ListWorkflowsDeps, type ListWorkflowsInput, ListWorkflowsInputSchema, type ListWorkflowsResponse, type LoadedSkillSet, LoadedSkillSetSchema, LockedWriter, type LogContext, type LogEntry, type LogLevel, type LogPolicyAuditOpts, type LogRateLimitAuditOpts, type LogToolInvocationOpts, type LoggingConfig, LoggingConfigSchema, MANIPULATION_CATEGORY, MAX_EXECUTION_TIME_MS, MIN_EXPERTS_FOR_PATTERN, MODEL_CAPABILITIES, type McpConfigOptions, type IExpertFactory$1 as McpExpertFactory, type McpLogContext, type McpLogLevel, RateLimiter as McpRateLimiter, type RateLimiterConfig as McpRateLimiterConfig, type MemoryInfo, type MemoryPayload, type MergePROptions, type Message, type MessagePayload, type MessageRole, ModelCapability, type ModelConfig, ModelConfigSchema, ModelError, type ModelMetrics, type ModelPerformanceSummary, type ModelPreference, ModelPreferenceSchema, type ModelPricing, type ModelSelection, ModelSelectionSchema, type ModelTiers, ModelTiersSchema, NOOP_NOTIFIER, NexusAgentExecutor, type NexusAgentExecutorConfig, NexusError, type NexusErrorOptions, NoAdapterError, type NodeHandler$1 as NodeHandler, type NodeHandlerFactory, type NodeHook, type NodeHookContext, type NodeId, type NodeResult, type NodeState, NodeStateSchema, OLLAMA_MODELS, OPENAI_MODELS, OPENAI_MODEL_ALIASES, OWVoting, type OWVotingOptions, type AgentState$1 as ObserverAgentState, type TokenUsage$1 as ObserverTokenUsage, ObserverTopics, OllamaAdapter, type OllamaAdapterConfig, OpenAIAdapter, type OpenAIAdapterConfig, OpenCodeCliAdapter, type OrchestrateDeps, type OrchestrateInput, type OrchestrateInputLike, OrchestrateInputSchema, type OrchestrateOutput, OrchestrateOutputSchema, OrchestrationError, OrchestrationObserver, type OrchestrationObserverConfig, OrchestrationObserverConfigSchema, type OrchestrationObserverEvent, type OrchestrationObserverListener, type OrchestrationObserverOptions, type OrchestrationStats, OrchestrationUnavailableError, Orchestrator, type OrchestratorDefinition, OrchestratorError, type OrchestratorErrorCode, type OrchestratorExecuteOptions, OrchestratorFactory, type OrchestratorFactoryConfig, type OrchestratorOptions, OrchestratorOptionsSchema, type OrchestratorResult, type OrchestratorStep, type OrchestratorType, type OutcomeClass, type OutcomeFailureCategory, OutcomeFailureCategorySchema, OutcomeFeedbackCollector, type OutcomeProcessedCallback, type OutcomeRecord, type OutcomeStorageConfig, OutcomeStorageConfigSchema, OutcomeStorageError, OutcomeStore, type OutcomeStoreConfig, type TaskOutcome$2 as OutcomeTaskRecord, TaskOutcomeSchema$2 as OutcomeTaskSchema, PIPELINE_EVENT_TYPES, PLUGIN_TRUST_LEVELS, PRIVACY_CATEGORY, PROMPT_DEFINITIONS, type PairwiseVotingHistory, PairwiseVotingHistorySchema, type ParallelOptions, ParallelProtocol, ParseError, type ParsedExpression, type ParsedSpec, ParsedSpecSchema, type ParsedTemplate, type PatchApplicationOptions, type PatchApplicationResult, PatchApplicator, PatchApplicatorError, type PatchErrorCode, type PatchFormat, type PatchValidationResult, type PathAccessRule, type PathScore, type PathScoreBreakdown, PathScoreBreakdownSchema, PathScoreSchema, type PathScoringOptions, type PatternMetrics, type PatternOutcome, type PatternType, type PerformanceMatrixEntry, type PerformanceSummary, type PersistentDistillerConfig, PersistentOutcomeStore, type PersistentOutcomeStoreConfig, PersistentStrategyDistiller, type PipelineBridgeResult, type PipelineError, type PipelineEvent, type PipelineEventType, type PipelineExecuteOptions, type PipelineMetrics, type PipelinePlugin, type PolicyMode as PipelinePolicyMode, type PolicyViolation as PipelinePolicyViolation, type PipelineResult, PipelineRunner, type PipelineStage, type PlanCompileOptions, type PlanContract, PlanContractSchema, type PluginManifest, PluginManifestSchema, PluginRegistry, type PluginRegistryOptions, type PluginTrustLevel, type ValidationError as PluginValidationError, type PolicyConfig, PolicyConfigSchema, type PolicyContext, type PolicyDecision, type PolicyDecisionAuditOpts, PolicyEngine, PolicyError, type PolicyEvalResult, type PolicyEvaluation, type PolicyEvaluatorOptions, PolicyFirewall, type PolicyFirewallConfig, type PolicyGateEvent, type PolicyGateSpec, PolicyGateSpecSchema, type PolicyMode$1 as PolicyMode, type PolicyRule, type PolicyViolation$1 as PolicyViolation, type PreconditionConfig, type PreconditionOutcome, type PreconditionResult, PredictionWriteError, PredictionWriter, type PredictionWriterOptions, type PreferenceDataPoint, type PreferenceFilter, type PreferenceModelStats, type PreferencePrediction, type PreferenceRecord, PreferenceRouter, type PreferenceRouterConfig, PreferenceRouterConfigSchema, type PreferenceRoutingDecision, type PreferenceSignal, type PreferredCapability, type ProbeFn, type ProbeResult, type ProgressCallback, type PromptDefinition, type PromptMessage, type PromptRegistrationResult, ProofOfLearningStrategy, type Proposal, type ProposalId, ProposalSchema, type ProposalState, type ProposalStatus, ProposalStatusSchema, ProtocolFactory, type ProtocolOptions, type ProvenanceEntry, type ProviderConfig, ProviderConfigSchema, type PruneOptions, type PruneResult, PruningStrategy, type PythonValidation, type QualityAttribute, type QualityRequirement, type QualityScorer, type QualitySignals, QualitySignalsSchema, QueryFeatureExtractor, type QueryFeatures, type QueryOptions, REJECTION_CATEGORIES, REPO_COMPLEXITY, RISK_AWARENESS_CATEGORY, ROBUSTNESS_CATEGORY, ROLE_DEFAULT_TRUST, type RateLimitAuditOpts, RateLimitError, type RateLimitExceeded, type RateLimiterState, type RawHarnessOutput, type RawHarnessProgress, type RawInstanceResult, type RawTestResult, type ReasoningDepth, ReasoningDepthSchema, type ReasoningNode, type ReasoningNodeMetadata, ReasoningNodeMetadataSchema, ReasoningNodeSchema, type ReasoningStepType, ReasoningStepTypeSchema, type ReasoningTree, ReasoningTreeSchema, type RecordExecutionOptions, type RecordInteractionOptions, type RecordOutcomeParams, type RegistrationError, RegistryError, type RegistryRelationship, type RegistryScanner, type RegistryStats, type RegretAnalysis, type RejectionCategory, RejectionCategorySchema, type RepoAnalysis, type RepoAnalyzeDeps, type RepoAnalyzeInput, RepoAnalyzeInputSchema, type RepoSecurityPlan, type RepoSecurityPlanDeps, type RepoSecurityPlanInput, RepoSecurityPlanInputSchema, type ReportComparison, type ReportConfig, type ReportDetailLevel, type ReportFormat, ReportGenerationError, ReportGenerator, type ReportInstanceDetails, type ReportMetadata, type ReportMetrics, type ReportRepositoryBreakdown, type ReportSummary, type RepositoryMetrics, type ReputationAssessment, ReputationCache, type ReputationEvent, type ResolutionStatus, type ResolveResult, type ResourceLimits, type ResourceStatistics, type ResourceUsage, type RestApiConfig, RestApiConfigSchema, type ApiError as RestApiError, RestApiServer, type RestApiServerOptions, type DelegateRequest as RestDelegateRequest, DelegateRequestSchema as RestDelegateRequestSchema, type DelegateResponse as RestDelegateResponse, type ExpertRequest as RestExpertRequest, ExpertRequestSchema as RestExpertRequestSchema, type ExpertResponse as RestExpertResponse, type HealthResponse as RestHealthResponse, type MetricsResponse as RestMetricsResponse, type OrchestrateRequest as RestOrchestrateRequest, OrchestrateRequestSchema as RestOrchestrateRequestSchema, type OrchestrateResponse as RestOrchestrateResponse, type WorkflowRequest as RestWorkflowRequest, WorkflowRequestSchema as RestWorkflowRequestSchema, type WorkflowResponse as RestWorkflowResponse, type Result, ResultAggregator, type ResultConflict, type ResultSubmissionMessage, type ResultSummary, type RetryAttemptInfo, type RetryConfig, RetryExhaustedError, type ReviewCapableProvider, ReviewProtocol, type ReviewRequestMessage, type ReviewResponseMessage, ReviewResponseMessageSchema, RiskLevel, RiskLevelSchema, type RiskLevelType, type RoleSkillMapping, type RoundSummary, type RouterType, type DashboardConfig$1 as RoutingDashboardConfig, type RoutingDecision$2 as RoutingDecision, type RoutingDecisionRecord, RoutingMemoryError, type RoutingMemoryExport, type RoutingMemoryStats$1 as RoutingMemoryStats, type RoutingMetrics, RoutingMetricsCollector, type RoutingMetricsConfig, type RoutingRecord, type RuleStatus, type RulesSnapshot, RulesSnapshotSchema, type RunGraphWorkflowDeps, type RunGraphWorkflowInput, RunGraphWorkflowInputSchema, type RunGraphWorkflowResponse, type RunOptions, type RunProgress, type RunStatus, type RunWorkflowDeps, type RunWorkflowInput, RunWorkflowInputSchema, type RunnerConfig, type RunnerErrorCode, SAFETY_CATEGORIES, SAFETY_CATEGORY_MAP, PROVIDER_ENV_KEYS as SDK_PROVIDER_ENV_KEYS, DEFAULT_CAPABILITIES as SKILL_DEFAULT_CAPABILITIES, SKILL_PERMISSIONS, SQLiteOutcomeStorage, STAGE_TYPES, START, type SWEBenchCheckpoint, type SWEBenchConfig, type CostEstimate$1 as SWEBenchCostEstimate, type SWEBenchDatasetInfo, type SWEBenchEvalResult, type FailureAnalysis as SWEBenchFailureAnalysis, type FailurePattern as SWEBenchFailurePattern, type SWEBenchInstance, type SWEBenchPrediction, type SWEBenchRunResult, SWEBenchRunner, SWEBenchRunnerError, type SWEBenchSummary, type SWEBenchVariant, SWE_BENCH_DATASETS, SWE_BENCH_SYSTEM_PROMPT, type SafetyCategory, SafetyCategoryId, SafetyCategoryIdSchema, type SafetyCategoryIdType, SafetyCategorySchema, type SafetyTaxonomySummary, type SafetyTestCase, SafetyTestCaseSchema, type SandboxConfig, type SandboxExecutionOptions, type SandboxMode, type SandboxPolicy, type SandboxResult, type SanitizationEvent, type SanitizedInput, SanitizedInputSchema, type SanitizerConfig, SanitizerConfigSchema, type ScannerData, type ScannerEntry, type ScannerRecommendation, type ScannerRegistryManifest, type ScenarioError, type ScenarioResult, ScenarioResultSchema, type ScmComment, type ScmCommentDetail, ScmError, type ScmFileChange, type ScmIssue, type ScmIssueDetail, type PRStatus as ScmPRStatus, type ScmPlatform, type ScmPullRequest, type ScmPullRequestDetail, type ScmReviewDecision, type ScmToken, type ScmUserMetadata, type ScoreBreakdown, ScoreBreakdownSchema, SdkAdapter, type SdkAdapterConfig, type SdkProviderId, type SecurityAnalysisResult, type AuditEvent as SecurityAuditEvent, type AuditQuery as SecurityAuditQuery, type SecurityCapability, type SecurityConfig, SecurityConfigSchema, SecurityError, type SecurityErrorCode, SecurityErrorCodeSchema, type SecurityEventAuditOpts, SecurityExpert, type SecurityExpertOptions, type SecurityFocusArea, type PolicyDecision$1 as SecurityPolicyDecision, SelectionError, type ExpertRegistry as SelectionExpertRegistry, type SelectionOptions, SelectionOptionsSchema, type SelectionResult$1 as SelectionResult, SelectionResultSchema, SequentialProtocol, type SerializedError, type ServerConfig, type ServerError, type ServerInstance, type SessionEvent, type SessionMetrics, type SessionState, type SessionStatus, SessionStatusSchema, type SharedConclusion, SharedConclusionSchema, type SharedInsight, SharedInsightSchema, SimpleAgent, SimpleMajorityStrategy, type Skill, AgentRoleSchema$2 as SkillAgentRoleSchema, type SkillAttestation, SkillAttestationSchema, type SkillCapabilities, SkillCapabilitiesSchema, type SkillCategory, type SkillComplexity, SkillComposer, type SkillComposerConfig, type SkillComposition, type SkillCompositionRequest, type SkillDependency, SkillDependencyGraph, SkillDependencySchema, type SkillDependencyType, SkillDependencyTypeSchema, type SkillExample, type SkillExecution, type SkillExecutionStatus, SkillLibrary, type SkillLibraryConfig, SkillLoader, type SkillLoaderConfig, SkillLoaderConfigSchema, type SkillLoaderError, type SkillLoaderErrorCode, SkillLoaderErrorSchema, type SkillMetrics, type SkillParameter, type SkillPermission, SkillPermissionSchema, type SkillProvenance, SkillProvenanceSchema, type SkillQuery, type SkillRBAC, SkillRBACSchema, type SkillSearchResult, type SkillSecurityError, SkillSecurityErrorSchema, type SkillStore, type SkillWithMetrics, type SortOptions, type SourceCitation, SourceCitationSchema, type SpanId, type SpecExecutionError, type SpecExecutionOptions, type SpecExecutionResult, type SpecParseError, type StageContext, type StageResult, StageResultSchema, type StageSpec, StageSpecSchema, type StageType, type StateChangeCallback, type StateChangePayload, type StateFieldSchema, type StateMachineOptions, type StateReducer, type StateSchema, type StateTransition, type StateTransitionEvent, type StatisticalOptions, type StatisticalSummary, type StatusUpdateMessage, type StepExecutionOptions, type StepExecutor$1 as StepExecutor, type StepExecutorDeps, type StepResult, type StepResultSummary, type StopReason, type StoredModelStats, type StoredReward, type StoredRoutingDecision, type StoredTaskOutcome, type StrategyAction, StrategyDistiller, StreamCancelledError, type StreamChunk, StreamController, StreamError, type StreamState, AgentRoleSchema$1 as StrictAgentRoleSchema, InputDefinitionSchema$1 as StrictInputDefinitionSchema, WorkflowDefinitionSchema$1 as StrictWorkflowDefinitionSchema, WorkflowStepSchema$1 as StrictWorkflowStepSchema, type StrippedElement, StrippedElementSchema, type SubTask, SubTaskSchema, SubprocessCliAdapter, type SubtaskNode, SubtaskNodeSchema, type SubtaskPriority, SubtaskPrioritySchema, type SubtaskStatus, SubtaskStatusSchema, type SubtaskType, SubtaskTypeSchema, SupermajorityStrategy, type SuspiciousSignal, SuspiciousSignalSchema, type AgentState as SwarmAgentState, type SwarmHealthMetrics$1 as SwarmHealthMetrics, SwarmObserver$1 as SwarmObserver, type SwarmObserverConfig$1 as SwarmObserverConfig, SwarmObserverConfigSchema$1 as SwarmObserverConfigSchema, type SwarmObserverEvent, type SwarmObserverListener, type SwarmObserverOptions, type SwarmStats, type SwebenchValidation, type SycophancyIndicator, type SycophancyReport, type SynthesizedResult, SynthesizedResultSchema, type SystemComponent, TASK_STATUSES, TASK_TYPE_EXPERTS, TEMPLATE_CATEGORIES, TEMPLATE_KEYWORDS, TRINITY_ROLE_MAX_TOKENS, TRINITY_ROLE_PROMPTS, TRINITY_ROLE_TEMPERATURES, TRUST_TIER_NUMERIC, type Task$1 as Task, type TaskAnalysis, type TaskAnalysisResult, TaskAnalysisResultSchema, TaskAnalysisSchema, type TaskAssignmentMessage, TaskComplexity, type TaskContext, type TaskContract, TaskContractSchema, type TaskDag, TaskDagSchema, TaskDomain$1 as TaskDomain, type TaskId, type TaskOutcome$1 as TaskOutcome, type TaskOutcomeRecord, TaskOutcomeSchema$1 as TaskOutcomeSchema, type TaskPayload, type TaskProfileSummary, TaskQueue, type TaskRequirements, type TaskResult, TaskSchema, type TaskSignals, type TaskStatus, type TaskToolResponse, type TaskTypePerformance, type TemplateCategory, TemplateCategorySchema, type TemplateMetadata, TemplateMetadataSchema, TemplateRegistry, type TerminationReason, TerminationReasonSchema, type TestCaseResult, type TestFramework, type TestQuality, TestRunner, type TestRunnerConfig, TestRunnerError, type TestRunnerErrorCode, type TestStatus, type TestSuiteResult, type TestingAnalysisResult, TestingExpert, type TestingExpertOptions, type TextContent, TextDashboardRenderer, type ThinkerOutput, type ThresholdUpdateDetail, type TimeConstraint, type TimePeriod, TimeoutError, type TimeoutProfile, type TimingStatistics, TokenCountError, type TokenCountResult, TokenCounter, type TokenCounterConfig, TokenCounterProvider, type TokenResolverConfig, type TokenStrategy, type TokenUsage, type TokenUsageBreakdown, type TokensByPhase, type ToolCompletedEvent, type ToolDefinition, type ToolInvocationAuditOpts, type ToolInvokedEvent, type ToolPayload, type ToolRegistrationOptions, type ToolRegistrationResult, type ToolResult, type ToolSet, ToolSetSchema, type TraceEvent, type TraceEventType, type TraceId, TraceLogger, type TraceLoggerOptions, type TrackedAgent, type TransitionErrorCallback, type TreeId, type TreeState, TreeStateSchema, type TreeStatistics, TreeStatisticsSchema, type Trend, type TrendDetectedDetail, type TrinityConfig, TrinityConfigSchema, TrinityCoordinator, type TrinityExecuteOptions, type TrinityPhase, type TrinityPhaseResult, TrinityPhaseSchema, type TrinityResult, type TrinityRole, type TrinityRoleConfig, TrinityRoleSchema, TrinityStopReasonSchema, type TrustClassificationEvent, type TrustTier, TrustTierSchema, UnanimousStrategy, type UnknownVar, type Unsubscribe, type V2Config, type V2Mode, VERSION, VOTING_THRESHOLDS, ValidationDashboard, ValidationError$1 as ValidationError, type ValidationIssue, type VariantStats, type VerificationResult, type VerifierOutput, VerifierVerdictSchema, type VersionRequirements, type VersionStatus, type Violation, ViolationSchema, type Vote, type VoteCounts, type VoteDecision$1 as VoteDecision, VoteDecisionSchema$1 as VoteDecisionSchema, type VoteDecisionStatus, type VoteMessage, VoteMessageSchema, VoteSchema, type VotingObservation, VotingObservationSchema, type VotingOutcome, VotingProtocol, type VotingProtocolConfig, VotingProtocolConfigSchema, type VotingProtocolResult, type VotingRound, type VotingRoundPhase, VotingRoundPhaseSchema, type VotingRoundStatus, VotingRoundStatusSchema, type VotingSession, VotingStrategyFactory, type Vulnerability, VulnerabilitySchema, VulnerabilitySeveritySchema, type WaveExecutionResult, type WaveResult, WaveScheduler, type WaveSchedulerConfig, type WaveTask, type WaveTaskExecutor, type WaveTaskResult, type WeightedAgentRecord, type WeightedConsensusResult, type WeightedVoteCounts, WeightedVoting, type WeightedVotingConfig, type WeightedVotingOptions, type WinLossAnalysis, type WithRetryOptions, type WorkChunk, type WorkerOutput, type WorkflowAdapterConfig, type WorkflowConfig, WorkflowConfigSchema, type WorkflowDefinition, type WorkflowDefinitionInput, type WorkflowDefinitionOutput, WorkflowDefinitionSchema, type WorkflowEngineFactoryConfig, WorkflowError, type WorkflowExecutionContext, type ExecutionPlan$1 as WorkflowExecutionPlan, type IExpertFactory$2 as WorkflowExpertFactory, type WorkflowInfo, WorkflowInputsSchema, WorkflowOrchestratorAdapter, type WorkflowPattern, type WorkflowRouterOptions, type RoutingDecision$1 as WorkflowRoutingDecision, type WorkflowStep$1 as WorkflowStep, type WorkflowStepInput, type WorkflowStepOutput, WorkflowStepSchema, type WorkflowTemplate, type WorkflowToolResult, actorFromContext, aggregateResults, analysisToTaskContract, analyzeTask as analyzeDelegateTask, analyzeFailures, analyzeGitHubRepo, analyzeRepo, analyzeTask$1 as analyzeTask, append, applyPatch, areStepsCompleted, assessReputation, bufferStream, buildDependencyGraph, buildDockerArgs, buildEnrichedPrompt, buildFinalResult, buildHarnessArgs, buildHarnessCommand, buildPendingResult, buildPlanFromAnalysis, buildDependencyGraph$1 as buildSkillDependencyGraph, buildTimeoutResult, calculateDelay, calculateDistributionStats, calculateEstimatedRemaining, calculateMetrics, calculateMetricsTotals, calculateMinSampleSize, calculateRegret, calculateRepositoryMetrics, calculateRoutingDistribution, calculateTokenCost, calculateVoteWeight, calculateWinLoss, canApplyPatch, canExecuteSkill, canInfluenceDecisions, canProceed, cancelExecution, categorizeOutcomeError, categorizeOutcomeErrorMessage, checkPermissionBoundary, checkPipelinePolicy, chunkByDirectory, classifyTrust, clearRegistryCache, clearTemplateCache, closeServer, collectRealVotes, collectStream, compareProportions, compilePlan, compileSpecToGraph, computeAdaptiveThresholds, computeOutcomeReward, concatStreams, connectTransport, containsExpressions, countActiveSessions, createAbTestTracker, createAgentPairKey, createStepExecutor as createAgentStepExecutor, createAllAdapters, createArchitectureExpert, createAttestation, createAuditLogger, createAuditTrail, createBenchmarkMemory, createCheckpoint, createCheckpointStore, createClaudeAdapter, createCliAdapter, createCliCircuitBreakerIntegration, createCliDetectionCache, createCliExecutor, createCodeExpert, createCollaborationSession, createCompositeRouter, createConsensusEngine, createContextItem, createCorePluginRegistry, createCorrelationTracker, createDashboard, createDashboardRenderer, createDefaultDeps, createDefaultPolicyEngine, createDefaultPolicyFirewall, createDefaultRateLimiter, createDefaultRegistry, createDelegatePipeline, createDependencyError, createDocumentationExpert, createDryRunHandler, createEmptyContext, createEvaluationHarness, createEventBusBridge, createExecutionContext, createExecutionPlan, createExecutor, createExplorationPrompt, createFeedbackIntegration, createFeedbackSubscriber, createFullGitHubProvider, createGeminiAdapter, createGitHubAdapter, createGitHubProvider, createGraphAuditBridge, createHarnessExecutor, createHigherOrderVotingStrategy, createInitialCostMetrics, createInitialProgress, createInitialSessionMetrics, createInitialTokenUsage, createInitializedWorkflowEngine, createInstancePrompt, createInteractionGraph, createSwarmObserver as createInteractionSwarmObserver, createIsolatedRegistry, createLogger, createMcpLogger, createMcpNotifier, createMockExecutor, createNexusExecutorFromEnv, createOWVoting, createOllamaAdapter, createOpenAIAdapter, createOrchestrationObserver, createOrchestrator, createOrchestratorFactory, createOutcomeFeedbackCollector, createOutcomeStorage, createPatchApplicator, createPolicyContext, createPrediction, createPreferenceRouter, createProductionWorkflowEngine, createProgressAdapter, createProtocolFactory, createRateLimiter, createRealWorkflowEngine, createReportGenerator, createRestApiServer, createResultAggregator, createRetryPrompt, createRoutingDecision, createRoutingMetricsCollector, createRunner, createSandboxExecutor, createScmProvider, createSecurityError, createSecurityExpert, createServer, createSkillComposer, createSkillDependencyGraph, createSkillLibrary, createSkillLoader, createStateComparisonVerifier, createStateGuard, createStateMachine, createStrategyDistiller, createStrategyFactory, createStream, createSummaryPrompt, createSwarmObserver$1 as createSwarmObserver, createTaskOutcome, createTaskQueue, createTemplateRegistry, createTestRunner, createTestingExpert, createTimer, createTokenCounter, createToolLogger, createTrackedAgent, createTrinityCoordinator, createValidatedExecutor, createValidatedHarness, createValidationDashboard, createValidator, createVariantRunner, createVotingProtocol, createWaveScheduler, createWeightedVoting, createWorkflowEngineDeps, createWorkflowEngineDepsAsync, createWorkflowRouter, curateContext, customReducer, decomposeSpec, defaultConfig, delegateInputToTaskContract, denyMutationsWithoutModeRule, detectFailurePatterns, detectLatencyPatterns, detectSuccessPatterns, detectTestFramework, detectTrend, determineFinalStatus, emitCorroborationEvent, emitExecutionComplete, emitGraphExecutionEvent, emitNodeResults, emitNodeStarted, emitPolicyEvent, emitReputationEvent, emitSanitizationEvent, emitStateUpdated, emitStepCompleted, emitThresholdUpdate, emitTrendDetected, emitTrustEvent, err, estimateDifficulty, estimateTaskComplexity, estimateTokens, evaluatePolicy as evaluatePipelinePolicy, evaluatePolicy$2 as evaluatePolicy, evaluatePredictions, evaluatePolicy$1 as evaluateSecurityPolicy, executeDelegatePipeline, executeGraph, executeHarness, executeInDocker, executeOrchestratePipeline, executeParallel, executeSpec, exportReport, extractApproach, extractBooleanField, extractExpressions, extractFilesFromResponse, extractHypothesis, extractModelName, extractNonErrorMessage, extractNumberField, extractPastSuccessRates, extractPatch, extractRepoFromInstanceId, extractRepoName, extractSessionId, extractStringArrayField, extractStringField, filterAvailableModels, filterByRepo, filterByVersion, filterStream, findActiveSession, findMissingDependencies, formatCompileError, formatContextForPrompt, formatValidationResult, fromArray, generateATL, generateMcpConfig, generateProposalId, generateReport, generateSecurityPlan, generateWeatherReport, getAllTestCases, getAvailabilityCache, getAvailableClis, getAvailableRoles, getBuiltInTemplates, getBuiltInTemplatesPath, getBuiltInTemplatesWithMetadata, getCapabilitiesForRole, getCategoriesByMinRiskLevel, getCliForModelId, getCompletedInstanceIds, getCompletedSteps, getCorroborationRules, getCpuCores, getDatasetInfo, getDefaultAllowedTools, getDockerVersion, getEventBusStats, getExecutionDuration, getExecutionOrder, getExpertRegistry, getFallbackChain, getGraphRegistry, getGraphWorkflowList, getInstance, getKnownNexusVarNames, getMemoryInfo, getOutcomeStore, getPipelineArtifactStore, getPipelinePluginRegistry, getPolicy, getPolicyMode, getPythonVersion, getRecommendedRole, getReferencedSteps, getRegistryManifest, getRequiredTrustTier, getResultsFilePath, getSafetyCategory, getSafetyTaxonomySummary, getSkillSetForTask, getSkillsForTask, getStepResult, getSwarmObserver, getSwebenchVersion, getTestCasesByTags, getTimeoutForTask, getTimeoutForTaskAuto, getTokenEnvVars, getTopologicalOrder, getVariable, hasToken, ictmToExpertConfig, identifySessionsToRemove, inferICTM, initializeAgentSkills, initializeBuiltInTemplates, initializeEventBusBridge, isCancelled, isCliAvailable$1 as isCliAvailable, isErr, isMutatingAction, isOk, isReadOnlyAction, isRetryableError, isCliAvailable as isSWEBenchCliAvailable, isStepCompleted, isZodError, listInstances, loadDataset, loadTemplateFile, loadTemplatesFromDirectory, loadWorkflowFile, logPolicyAudit, logRateLimitAudit, logToolError, logToolInvocationAudit, logToolStart, logToolSuccess, logger, map, mapAuthorAssociation, mapErr, mapResolutionStatus, mapStateToPhase, mapTestStatus, meanConfidenceInterval, mergeStreams, normalizeRepoId, ok, orchestrateInputToTaskContract, overwrite, parseATL, parseAgentPairKey, parseExpression, parseJsonResults, parseProgressLine, parseSpec, parseStdoutResults, parseTemplateContent, parseTestResults, parseWorkflowJson, parseWorkflowYaml, proportionConfidenceInterval, quickRun, quickSelect, readJsonResults, readPredictions, recordOutcome, reduceStream, registerConsensusVoteTool, registerCorePlugins, registerCreateExpertTool, registerDelegateToModelTool, registerExecuteExpertTool, registerExecuteSpecTool, registerExpertsResource, registerIssueTriageTool, registerListExpertsTool, registerListWorkflowsTool, registerModelsResource, registerOrchestrateTool, registerPrompts, registerRepoAnalyzeTool, registerRepoSecurityPlanTool, registerResearchResource, registerResources, registerRunGraphWorkflowTool, registerRunWorkflowTool, registerTools, requiresCitation, requiresCorroboration, resetAvailabilityCache, resetPipelineArtifactStore, resetPipelinePluginRegistry, resetRegistry, resolveExpression, resolveFallback, resolveInput, resolveScannerData, resolveStringExpressions, resolveToken, resolveV2Config, resolveWithFallbacks, resultToOutcome, runAgentOnInstance, runBenchmarkInstances, runBenchmarkParallel, runPreconditions, runSingleInstance, runTests, runVerification, safePathsRule, safeValidateExpertConfig, sanitize, sanitizeInput, scoreByHybrid, scoreByImportance, scoreByRecency, selectExperts, selectModel, setSwarmObserver, setVariable, sigmoidConfidence, skip, sleep, snapshotContext, sortByPriority, startStdioServer, storeStepResult, take, takeUntil, tapStream, taskContractToToolResponse, toolError, toolSuccess, toolSuccessStructured, transformHarnessOutput, transformHarnessProgress, transformInstanceResult, transformStream, transformTestResult, unwrap, unwrapOr, updateContext, validateAgentAction, validateCommand, validateCorroboration, validateDependencyGraph, validateDiskSpace, validateDocker, validateEnvironment, validateEvaluationCriterion, validateExpertConfig, validateExpressions, validateICTM, validateNexusEnv, validatePatch, validatePatchFormat, validatePrediction, validatePredictionsFile, validatePython, validateRequiredInputs, validateSafetyCategory, validateScenario, validateCapabilities as validateSkillCapabilities, validateSkillExecution, validateSkillProvenance, validateRBAC as validateSkillRBAC, validateSwebench, validateTestCase, validateToolInput, validateWorkflow, validateWorkflowDependencies, withLogging, withRetry, withRetryWrapper, withTimeout, writePredictions };
33287
+ export { ALLOWED_COMMANDS, ARTIFACT_TYPES, AUDIT_PIPELINE_TEMPLATE, AbTestTracker, type ActionContext, type ActionRecord, type ActionValidationResult, type ActivationOptions, type ActivationStrategy, ActivationStrategySchema, type ActivityItem, type AdapterConfig, AdapterConfigSchema, type AdapterCreator, AdapterFactory, AdapterModelError, RateLimiter$1 as AdapterRateLimiter, type RateLimiterConfig$1 as AdapterRateLimiterConfig, type RegisterOptions$1 as AdapterRegisterOptions, type AdaptiveOrchestratorOptions, type AdaptiveOrchestratorResult, type AdaptiveThresholdResult, type AgentAction, AgentActionSchema, type AgentActionType, AgentCapability, type AgentCluster, type AgentContext, AgentError, type AgentEvent, AgentEventSchema, type AgentExecutionResult, type AgentExecutorConfig, type AgentFinding, AgentFindingSchema, type AgentId, type AgentMessage, AgentMessageSchema, type AgentMessageType, type AgentPairKey, type AgentPerformance, AgentPerformanceSchema, type AgentResponse, type AgentRole, AgentRoleSchema, type AgentRoleType, AgentRunnerError, type AgentState$2 as AgentState, AgentStateMachine, type AgentStatus, StepExecutor as AgentStepExecutor, type AgentVoteResult, type AgentVoteSummary, type AggregatedResult, type AggregationMetadata, type AggregationStrategy, type AggregatorInput, type AggregatorOptions, AnalysisError$1 as AnalysisError, type ApiDocumentation, type ApiEndpoint, type ApiType, type AppConfig, AppConfigSchema, type ApproachOutcome, type ApproachRecord, type ArchitectureAnalysisResult, type ArchitectureDecision, ArchitectureExpert, type ArchitectureExpertOptions, type ArchitecturePattern, type ArchitectureStyle, type Artifact, type ArtifactFilter, type ArtifactRef, ArtifactRefSchema, ArtifactStore, type ArtifactStoreOptions, type ArtifactType, type AuditActor, AuditActorSchema, type AuditCategory, AuditCategorySchema, AuditError, type AuditEvent$1 as AuditEvent, type AuditEventInput, AuditEventInputSchema, AuditEventSchema, type AuditHandlerConfig, type AuditLogConfig, AuditLogConfigSchema, AuditLogger, type AuditOutcome, AuditOutcomeSchema, type AuditQueryCriteria, AuditQueryCriteriaSchema, type AuditResource, AuditResourceSchema, type AuditSeverity, AuditSeveritySchema, AuditTrail, type AuthorizationMethod, AuthorizationMethodSchema, AvailabilityCache, type AvailabilityCacheConfig, BIAS_CATEGORY, BUILT_IN_EXPERTS, BUILT_IN_RULES, BUILT_IN_TEMPLATES, BaseAdapter, type BaseAdapterConfig, type BaseAdapterOptions, BaseAgent, type BaseAgentOptions, BaseAgentOptionsSchema, BaseCliAdapter, type BaseMcpToolDeps, type BenchmarkRunOptions, type BenchmarkRunResult, type BestSolution, BestSolutionSchema, type BottleneckInfo, type BuiltInExpertType, BuiltInExpertTypeSchema, CHECKPOINT_SCHEMA_VERSION, CLAUDE_MODELS, CLAUDE_MODEL_ALIASES, DEFAULT_CACHE_CONFIG as CLI_DEFAULT_CACHE_CONFIG, DEFAULT_CAPABILITIES$1 as CLI_DEFAULT_CAPABILITIES, DEFAULT_COMPOSITE_CONFIG as CLI_DEFAULT_COMPOSITE_CONFIG, CLI_TIMEOUT_PROFILES, CLI_VERSION_REQUIREMENTS, COMPLEXITY_ORDER, CORE_PLUGINS, type CancelledResultFactory, type CapabilityProfile, type CapacityStatus, type Checkpoint, type PipelineStage as CheckpointPipelineStage, type CheckpointSummary, type FailureCategory$1 as CircuitBreakerFailureCategory, type CircuitProtectedResult, type CircuitState, type ClassifyInput, type ClassifyResult, ClaudeAdapter, type ClaudeAdapterConfig, ClaudeCliAdapter, type ClaudeCliResponse, ClaudeResponseParser, type CliAdapterConfig, CliAgentExecutor, type CliAgentExecutorConfig, type CacheStats as CliCacheStats, type CapabilityProfile$1 as CliCapabilityProfile, type CliCircuitBreakerConfig, CliCircuitBreakerIntegration, type CliCircuitHealthStatus, CliDetectionCache, type CliDetectionCacheConfig, CliDetectionCacheConfigSchema, type CliError, type CliErrorCode, type ExecutionOptions$1 as CliExecutionOptions, type CliHealthResult, type ModelInfo as CliModelInfo, type CliName, type CliResponse, type CliRetryLoopConfig, type CliRetryResult, type CliTask, type TaskComplexity$1 as CliTaskComplexity, type TokenUsage$2 as CliTokenUsage, type CliTransport, type CodeAnalysisResult, type CodeChange, CodeChangeSchema, CodeExpert, type CodeExpertOptions, CodexCliAdapter, type CodexCliResponse, CodexMcpAdapter, CodexResponseParser, type CollaborationConfig, CollaborationConfigSchema, type CollaborationMessage, type CollaborationPattern, CollaborationPatternSchema, type CollaborationResult, CollaborationSession, type CollaborationSessionOptions, type CollectRealVotesOptions, CompactDashboardRenderer, type ComparisonReport, type ComparisonResult, type CompetitorResult, type CompetitorSystem, type CompileOptions, type CompileResult$2 as CompileResult, type CompiledGraph, type CompiledPipeline, type CompletionRequest, type CompletionResponse, type ComplexityLevel, ComplexityLevelSchema, type ComplianceStatus, CompositeRouter, type CompositeRouterConfig, CompositeRouterConfigSchema, type CompositeRouterStats, type CompositeRoutingDecision, CompositeRoutingError, type CompositionStep, type CompositionValidation, type ComputedReward, type ConfidenceInterval, ConfigError, type ExpertConfig$1 as ConfigExpertConfig, ExpertConfigSchema$1 as ConfigExpertConfigSchema, type ExpertDefinition$1 as ConfigExpertDefinition, ExpertDefinitionSchema as ConfigExpertDefinitionSchema, type Conflict, type ConflictResolver, type ConflictWarning, type ConsensusAlgorithm, ConsensusAlgorithmSchema, ConsensusEngine, type ConsensusEngineConfig, ConsensusEngineConfigSchema, ConsensusError, type ConsensusMetrics, ConsensusMetricsSchema, ConsensusProtocol, type ConsensusResult, ConsensusResultSchema, type ConsensusStats, type ConsensusVoteDeps, type ConsensusVoteInput, ConsensusVoteInputSchema, type ConsensusVoteResponse, type ConsolidatedFinding, type ContentBlock, ContentPriority, type ContextBudget, ContextBudgetSchema, type ContextFilter, ContextFilterSchema, type ContextItem, ContextManager, type ContextManagerConfig, ContextManagerConfigSchema, type ContextPruneStrategy, ContextPruneStrategySchema, ContextPruner, type ContextPrunerConfig, ContextPrunerConfigSchema, type ContextStats, type ContributionScore, type CorePluginRegistrationResult, type CorrelationCoefficient, CorrelationCoefficientSchema, type CorrelationMatrix, CorrelationTracker, type CorrelationTrackerStats, CorrelationTrackerStatsSchema, type CorroborationEvent, type CorroborationResult, type CorroborationRule, type CostEstimate, CostEstimateSchema, type CoverageAnalysis, type CoverageMetrics, CoverageMetricsSchema, type CreateExecutionContextOptions, type CreateExpertDeps, type CreateExpertInput, CreateExpertInputSchema, type CreateExpertOptions, type CreateExpertResponse, type CreateForestInput, type CreateNodeInput, type CreatePROptions, type CreateScmProviderConfig, type CreateSkillOptions, type CreateStreamOptions, type CreateTreeInput, type CriterionFailure, type CriterionResult, CriterionResultSchema, CriterionType, CriterionTypeSchema, type CriterionTypeType, type CrossTreeInfo, CrossTreeInfoSchema, type CrossTreeStrategy, CrossTreeStrategySchema, type CuratedContextItem, type CurationResult, DECEPTION_CATEGORY, DEFAULT_ACTIVATION_OPTIONS, DEFAULT_BUDGET, DEFAULT_COMPOSER_CONFIG, DEFAULT_CONSENSUS_CONFIG, DEFAULT_DASHBOARD_CONFIG, DEFAULT_DASHBOARD_RENDER_OPTIONS, DEFAULT_DISTILLER_CONFIG, DEFAULT_EVALUATION_CONFIG, DEFAULT_EXECUTION_TIME_MS, DEFAULT_FEEDBACK_COLLECTOR_CONFIG, DEFAULT_FEEDBACK_INTEGRATION_CONFIG, DEFAULT_FOREST_CONFIG, DEFAULT_HARNESS_EXECUTION_CONFIG, DEFAULT_HIGHER_ORDER_CONFIG, DEFAULT_MAX_RETRIES, DEFAULT_OUTCOME_STORAGE_CONFIG, DEFAULT_PATCH_OPTIONS, DEFAULT_PATH_SCORING_OPTIONS, DEFAULT_PERMISSIONS, DEFAULT_POLICIES, DEFAULT_PREFERENCE_ROUTER_CONFIG, DEFAULT_RBAC, DEFAULT_REPORT_CONFIG, DEFAULT_RESOURCE_LIMITS, DEFAULT_RETRY_CONFIG, DEFAULT_ROLE_MAPPINGS, DEFAULT_SKILL_LIBRARY_CONFIG, DEFAULT_SKILL_LOADER_CONFIG, DEFAULT_STATISTICAL_OPTIONS, DEFAULT_SWARM_OBSERVER_CONFIG, DEFAULT_SWE_BENCH_CONFIG, DEFAULT_TEST_RUNNER_CONFIG, DEFAULT_TIMEOUTS, DEFAULT_TIMEOUT_PROFILE, DEFAULT_TRINITY_CONFIG, DEFAULT_VOTING_PROTOCOL_CONFIG, DEFAULT_WAVE_CONFIG, DEFAULT_WEIGHTED_VOTING_CONFIG, DEV_PIPELINE_TEMPLATE, type DagEdge, DagEdgeSchema, Dashboard, type DashboardConfig, DashboardConfigSchema, type DashboardFilter, type DashboardFormat, type DashboardHealthIndicators, type DashboardOutcome, type DashboardRenderOptions, type DashboardSnapshot, type DashboardSummary, type DashboardUpdateOptions, DatasetLoadError, type DatasetLoadOptions, type DatasetLoadResult, type DecomposeError, type DelegateDeps, type DelegateInput, type DelegateInputLike, DelegateInputSchema, type DelegateOutput, DelegateOutputSchema, type DependencyError, type DependencyErrorCode, DependencyErrorCodeSchema, DependencyErrorSchema, DependencyGraph, type DependencyStructure, type DevPipelineOptions, type DevPipelineResult, type DevPipelineStages, DirectedInteractionGraph, type DiskSpaceValidation, type DistilledRule, type DistillerConfig, type DistillerStats, type DistributionStats, type DockerExecutionState, type DockerValidation, DocumentationExpert, type DocumentationExpertOptions, type DocumentationResult, type DocumentationSection, type DryRunResult, type DynamicExpert, DynamicExpertManager, type DynamicExpertSpec, END, EXPERT_CAPABILITIES, EXPERT_DEFAULT_CAPABILITIES, EXPERT_DEFAULT_TEMPERATURES, EXPERT_TYPE_TO_ROLE, type EnvValidationResult, type EnvironmentValidationResult, ErrorCode, type ErrorHandler, type ErrorPayload, type EvaluationCacheLevel, type EvaluationCriterion, EvaluationCriterionSchema, type EvaluationErrorCode, EvaluationHarness, type EvaluationHarnessConfig, EvaluationHarnessError, type EvaluationMetrics, type EvaluationMode, type EvaluationPhase, type EvaluationProgress, type EvaluationProgressCallback, type EvaluationReport, type EvaluationRunResult, type EvaluationValidationResult, EventBus, type EventBusBridgeOptions, type EventBusBridgeResult, type EventBusOptions, type EventFilter, type EventHandler, type EventPayload, type EventType, type ExecuteExpertDeps, type ExecuteExpertInput, ExecuteExpertInputSchema, type ExecuteExpertResponse, type ExecuteSpecDeps, type ExecuteSpecInput, ExecuteSpecInputSchema, type ExecutionContext$1 as ExecutionContext, type ExecutionMode, type ExecutionPhase$1 as ExecutionPhase, type ExecutionPlan$2 as ExecutionPlan, type ExecutionStage, type ExecutorWithModel, ExpectedOutcome, ExpectedOutcomeSchema, type ExpectedOutcomeType, type ExperienceRecord, type ExperienceStep, type ExperimentDefinition, type ExperimentExport, type ExperimentOutcome, type ExperimentResult, type ExperimentStatus, type ExperimentSummary, type ExperimentVariant, Expert, type ExpertAssignment, ExpertAssignmentSchema, type ExpertBridgeResult, ExpertCollaborationPattern, type ExpertCollaborationPatternType, type ExpertConfig, ExpertConfigSchema, type ExpertDefinition, type ExpertDomain, ExpertDomainSchema, ExpertFactory, ExpertFactoryAdapter, type ExpertInfo, type ExpertMatch, ExpertMatchSchema, type ExpertOptions, ExpertOptionsSchema, type ExpertOutput, ExpertOutputSchema, type ExpertParticipation, ExpertParticipationSchema, type RegisterOptions as ExpertRegisterOptions, ExpertRegistry$1 as ExpertRegistry, type ExpertResult, type ExpertResultSummary, type ExplorationEvent, ExplorationEventSchema, type ExplorationEventType, ExplorationEventTypeSchema, type ExploredFile, type ExpressionType, type ExtractSymbolsDeps, ExtractSymbolsInputSchema, FALLBACK_SCANNER_DATA, FactoryError, type FailureAnalysis$1 as FailureAnalysis, type AnalysisError as FailureAnalysisError, type FailureCategory, type FailurePattern$1 as FailurePattern, FailurePatternSchema, type FailureStatistics, type FailureType, type FallbackBehavior, type FallbackEntry, type FeedbackCollectorConfig, FeedbackCollectorConfigSchema, FeedbackIntegration, type FeedbackIntegrationConfig, type FeedbackLoopStats, type FeedbackMessage, type RoutingDecision as FeedbackRoutingDecision, RoutingDecisionSchema as FeedbackRoutingDecisionSchema, FileAuditStorage, type FileReference, FileReferenceSchema, type FileRelevance, type FindingVote, FindingVoteSchema, type Artifact$1 as FirewallArtifact, type PolicyContext$1 as FirewallPolicyContext, type PolicyDecision$2 as FirewallPolicyDecision, type PolicyRule$1 as FirewallPolicyRule, type FirewallResult, type Forest, type ForestConfig, ForestConfigSchema, type ForestId, type ForestPruningStrategy, ForestPruningStrategySchema, type ForestResult, ForestResultSchema, type ForestState, ForestStateSchema, type ForestStatistics, ForestStatisticsSchema, type FrameworkDetectionResult, type FullCapableProvider, GEMINI_MODELS, GEMINI_MODEL_ALIASES, GENERAL_PIPELINE_TEMPLATE, GeminiAdapter, type GeminiAdapterConfig, GeminiCliAdapter, type GeminiCliResponse, GeminiResponseParser, type GeneratedMcpConfig, type GeneratedTest, GeneratedTestSchema, type GitHubInput, GitHubProvider, GitHubReviewer, GitHubUserInfo, type GitHubUserMetadata, type GitHubUserRole, GitHubUserRoleSchema, GraphBuilder, type GraphCompileError, type GraphEdge, type GraphEdgeDisplay, type GraphEvent, type GraphExecuteOptions, type GraphExecutionAuditEvent, type GraphExecutionResult, type GraphNode, type GraphPipelineOptions, type GraphPipelineResult, type GraphState, type GraphStats, type GraphSummary, type GraphWorkflowInfo, HARM_EMOTIONAL_CATEGORY, HARM_FINANCIAL_CATEGORY, HARM_PHYSICAL_CATEGORY, type HarnessErrorCode, type HarnessExecutionConfig, type HarnessExecutionProgress, type HarnessExecutionResult, type HarnessExecutionState, HarnessExecutor, HarnessExecutorError, type HarnessProgressCallback, type HarnessValidationResult, type HealthStatus, type HigherOrderVotingConfig, HigherOrderVotingConfigSchema, type HigherOrderVotingResult, HigherOrderVotingResultSchema, HigherOrderVotingStrategy, type HookError, HostileInputFirewall, type IAbTestTracker, type IAgent, type IAgentExecutor, type IArtifactStore, type IAuditLogger, type IAuditStorage, type IBenchmarkWriter, type ICTMConfig, ICTMConfigSchema, type ICTMInferenceResult, ICTMInferenceResultSchema, type ICheckpointStore, type ICircuitBreaker, type ICliAdapter, type ICliCircuitBreakerIntegration, type ICliDetectionCache, type ICliResponseParser, type ICollaborationProtocol, type ICompositeRouter, type IConsensusEngine, type ICorrelationTracker, type IDashboard, type IDashboardRenderer, type IEvaluationHarness, type IEventBus, type IFeedbackIntegration, type IHarnessExecutor, type IHigherOrderVoting, type ISwarmObserver as IInteractionObserver, type ILogger, type IMcpNotifier, type IModelAdapter, INSTRUCTION_SAFETY_CATEGORY, type IOrchestrationObserver, type IOrchestrator, type IOrchestratorFactory, type IOutcomeFeedback, type IOutcomeStorage, type IPatchApplicator, type IPipelineStage, type IPluginRegistry, type IPolicyEngine, type IPolicyFirewall, type IPreferenceDataStore, type IReportGenerator, type IRoutingMemory$1 as IRoutingMemory, type ISQLiteDatabase, type ISQLiteStatement, type ISandboxExecutor, type IScmProvider, type IScmReviewer, type IScmUserInfo, type ISkillDependencyGraph, type ISkillLoader, type ITaskTracker, type ITemplateRegistry, type ITestRunner, type ITokenCounter, type IVotingProtocol, type IVotingStrategy, type IWeightedVoting, type IWorkflowEngine, type IWorkflowRouter, type ImprovementSuggestion, InMemoryAuditStorage, InMemoryCheckpointStore, InMemoryPreferenceStore, type IncompleteResult, type IncompleteSeverity, type IndependentSubset, IndependentSubsetSchema, type InjectionFlag, InjectionFlagSchema, type InputBinding, type InputDefinition, type InputDefinitionInput, type InputDefinitionOutput, InputDefinitionSchema, type InputType, InputTypeSchema, type InstanceEvaluationResult, type InteractionEdge, type InteractionGraph, type SwarmObserverConfig as InteractionObserverConfig, SwarmObserverConfigSchema as InteractionObserverConfigSchema, type InteractionOutcome, SwarmObserver as InteractionSwarmObserver, type InvalidVar, type IssueFilters, type IssueReference, IssueReferenceSchema, type IssueTriageDeps, type IssueTriageInput, IssueTriageInputSchema, type IssueTriageResponse, type IterationContext, type IterativeConsensusConfig, type IterativeConsensusResult, JsonDashboardRenderer, KNOWN_SECTIONS, type KnownSection, type LanguageMatrixEntry, type LeaderboardEntry, type LeaderboardSnapshot, type LearningProgress, type LibraryStatistics, type ListExpertsDeps, type ListExpertsInput, ListExpertsInputSchema, type ListExpertsResponse, type ListWorkflowsDeps, type ListWorkflowsInput, ListWorkflowsInputSchema, type ListWorkflowsResponse, type LoadedSkillSet, LoadedSkillSetSchema, LockedWriter, type LogContext, type LogEntry, type LogLevel, type LogPolicyAuditOpts, type LogRateLimitAuditOpts, type LogToolInvocationOpts, type LoggingConfig, LoggingConfigSchema, MANIPULATION_CATEGORY, MAX_DYNAMIC_EXPERTS, MAX_EXECUTION_TIME_MS, MIN_EXPERTS_FOR_PATTERN, MODEL_CAPABILITIES, type McpConfigOptions, type IExpertFactory$1 as McpExpertFactory, type McpLogContext, type McpLogLevel, RateLimiter as McpRateLimiter, type RateLimiterConfig as McpRateLimiterConfig, type MemoryInfo, type MemoryPayload, type MemoryQueryInput, MemoryQueryInputSchema, MemoryStatsInputSchema, type MemoryWriteInput, MemoryWriteInputSchema, type MergePROptions, type Message, type MessagePayload, type MessageRole, ModelCapability, type ModelConfig, ModelConfigSchema, ModelError, type ModelMetrics, type ModelPerformanceSummary, type ModelPreference, ModelPreferenceSchema, type ModelPricing, type ModelSelection, ModelSelectionSchema, type ModelTiers, ModelTiersSchema, NOOP_NOTIFIER, NexusAgentExecutor, type NexusAgentExecutorConfig, NexusError, type NexusErrorOptions, NoAdapterError, type NodeHandler$1 as NodeHandler, type NodeHandlerFactory, type NodeHook, type NodeHookContext, type NodeId, type NodeResult, type NodeState, NodeStateSchema, OLLAMA_MODELS, OPENAI_MODELS, OPENAI_MODEL_ALIASES, OWVoting, type OWVotingOptions, type AgentState$1 as ObserverAgentState, type CostMetrics as ObserverCostMetrics, type RoutingDecision$2 as ObserverRoutingDecision, type SessionMetrics as ObserverSessionMetrics, type TokenUsage$1 as ObserverTokenUsage, type TrackedAgent as ObserverTrackedAgent, OllamaAdapter, type OllamaAdapterConfig, OpenAIAdapter, type OpenAIAdapterConfig, OpenCodeCliAdapter, type OrchestrateDeps, type OrchestrateInput, type OrchestrateInputLike, OrchestrateInputSchema, type OrchestrateOutput, OrchestrateOutputSchema, OrchestrationError, type OrchestrationObserverEvent, type OrchestrationObserverListener, type OrchestrationStats, OrchestrationUnavailableError, Orchestrator, type OrchestratorDefinition, OrchestratorError, type OrchestratorErrorCode, type OrchestratorExecuteOptions, OrchestratorFactory, type OrchestratorFactoryConfig, type OrchestratorOptions, OrchestratorOptionsSchema, type OrchestratorResult, type OrchestratorStep, type OrchestratorType, type OutcomeClass, type OutcomeFailureCategory, OutcomeFailureCategorySchema, OutcomeFeedbackCollector, type OutcomeProcessedCallback, type OutcomeRecord, type OutcomeStorageConfig, OutcomeStorageConfigSchema, OutcomeStorageError, OutcomeStore, type OutcomeStoreConfig, type TaskOutcome$2 as OutcomeTaskRecord, TaskOutcomeSchema$2 as OutcomeTaskSchema, PIPELINE_EVENT_TYPES, PIPELINE_STATE_KEYS, PIPELINE_TEMPLATES, PLUGIN_TRUST_LEVELS, PRIVACY_CATEGORY, PROMPT_DEFINITIONS, type PairwiseVotingHistory, PairwiseVotingHistorySchema, type ParallelOptions, ParallelProtocol, ParseError, type ParsedExpression, type ParsedSpec, ParsedSpecSchema, type ParsedTemplate, type PatchApplicationOptions, type PatchApplicationResult, PatchApplicator, PatchApplicatorError, type PatchErrorCode, type PatchFormat, type PatchValidationResult, type PathAccessRule, type PathScore, type PathScoreBreakdown, PathScoreBreakdownSchema, PathScoreSchema, type PathScoringOptions, type PatternMetrics, type PatternOutcome, type PatternType, type PerformanceMatrixEntry, type PerformanceSummary, type PersistentDistillerConfig, PersistentOutcomeStore, type PersistentOutcomeStoreConfig, PersistentStrategyDistiller, type PipelineBridgeResult, type PipelineCheckpointState, type PipelineContext, type PipelineEdge, type PipelineError, type PipelineEvent, type PipelineEventType, type PipelineExecuteOptions, type PipelineGraphResult, type PipelineMetrics, type PipelineMode, type PipelinePlugin, type PolicyMode as PipelinePolicyMode, type PolicyViolation as PipelinePolicyViolation, type PipelineResult, type PipelineRole, PipelineRunner, type PipelineStage$1 as PipelineStage, type PipelineStageData, type PipelineTask, type PipelineTemplate, type PipelineType, type PlanCompileOptions, type PlanContract, PlanContractSchema, type PluginManifest, PluginManifestSchema, PluginRegistry, type PluginRegistryOptions, type PluginTrustLevel, type ValidationError as PluginValidationError, type PolicyConfig, PolicyConfigSchema, type PolicyContext, type PolicyDecision, type PolicyDecisionAuditOpts, PolicyEngine, PolicyError, type PolicyEvalResult, type PolicyEvaluation, type PolicyEvaluatorOptions, PolicyFirewall, type PolicyFirewallConfig, type PolicyGateEvent, type PolicyGateSpec, PolicyGateSpecSchema, type PolicyMode$1 as PolicyMode, type PolicyRule, type PolicyViolation$1 as PolicyViolation, type PreconditionConfig, type PreconditionOutcome, type PreconditionResult, PredictionWriteError, PredictionWriter, type PredictionWriterOptions, type PreferenceDataPoint, type PreferenceFilter, type PreferenceModelStats, type PreferencePrediction, type PreferenceRecord, PreferenceRouter, type PreferenceRouterConfig, PreferenceRouterConfigSchema, type PreferenceRoutingDecision, type PreferenceSignal, type PreferredCapability, type ProbeFn, type ProbeResult, type ProgressCallback, type PromptDefinition, type PromptMessage, type PromptRegistrationResult, ProofOfLearningStrategy, type Proposal, type ProposalId, ProposalSchema, type ProposalState, type ProposalStatus, ProposalStatusSchema, ProtocolFactory, type ProtocolOptions, type ProvenanceEntry, type ProviderConfig, ProviderConfigSchema, type PruneOptions, type PruneResult, PruningStrategy, type PythonValidation, type QaReviewResult, type QualityAttribute, type QualityRequirement, type QualityScorer, type QualitySignals, QualitySignalsSchema, QueryFeatureExtractor, type QueryFeatures, type QueryOptions, type QueryTraceInput, QueryTraceInputSchema, REJECTION_CATEGORIES, REPO_COMPLEXITY, RESEARCH_PIPELINE_TEMPLATE, RISK_AWARENESS_CATEGORY, ROBUSTNESS_CATEGORY, ROLE_DEFAULT_TRUST, type RateLimitAuditOpts, RateLimitError, type RateLimitExceeded, type RateLimiterState, type RawHarnessOutput, type RawHarnessProgress, type RawInstanceResult, type RawTestResult, type ReasoningDepth, ReasoningDepthSchema, type ReasoningNode, type ReasoningNodeMetadata, ReasoningNodeMetadataSchema, ReasoningNodeSchema, type ReasoningStepType, ReasoningStepTypeSchema, type ReasoningTree, ReasoningTreeSchema, type RecordExecutionOptions, type RecordInteractionOptions, type RecordOutcomeParams, type RegistrationError, RegistryError, type RegistryImportInput, RegistryImportInputSchema, type RegistryRelationship, type RegistryScanner, type RegistryStats, type RegretAnalysis, type RejectionCategory, RejectionCategorySchema, type RepoAnalysis, type RepoAnalyzeDeps, type RepoAnalyzeInput, RepoAnalyzeInputSchema, type RepoSecurityPlan, type RepoSecurityPlanDeps, type RepoSecurityPlanInput, RepoSecurityPlanInputSchema, type ReportComparison, type ReportConfig, type ReportDetailLevel, type ReportFormat, ReportGenerationError, ReportGenerator, type ReportInstanceDetails, type ReportMetadata, type ReportMetrics, type ReportRepositoryBreakdown, type ReportSummary, type RepositoryMetrics, type ReputationAssessment, ReputationCache, type ReputationEvent, type ResearchAddDeps, type ResearchAddInput, ResearchAddInputSchema, type ResearchAddResponse, type ResearchAddSourceDeps, type ResearchAddSourceInput, ResearchAddSourceInputSchema, type ResearchAddSourceResponse, type ResearchAnalyzeDeps, type ResearchAnalyzeInput, ResearchAnalyzeInputSchema, type ResearchAnalyzeResponse, type ResearchCatalogReviewDeps, ResearchCatalogReviewInputSchema, type ResearchDiscoverDeps, type ResearchDiscoverInput, ResearchDiscoverInputSchema, type ResearchDiscoverResponse, type ResearchQueryDeps, type ResearchQueryInput, ResearchQueryInputSchema, type ResearchQueryResponse, type ResearchSynthesizeDeps, type ResearchSynthesizeInput, ResearchSynthesizeInputSchema, type ResearchTriggerConfig, type ResolutionStatus, type ResolveResult, type ResourceLimits, type ResourceStatistics, type ResourceUsage, type Result, ResultAggregator, type ResultConflict, type ResultSubmissionMessage, type ResultSummary, type RetryAttemptInfo, type RetryConfig, RetryExhaustedError, type ReviewCapableProvider, ReviewProtocol, type ReviewRequestMessage, type ReviewResponseMessage, ReviewResponseMessageSchema, RiskLevel, RiskLevelSchema, type RiskLevelType, type RoleSkillMapping, type RoundSummary, type RouterType, type DashboardConfig$1 as RoutingDashboardConfig, type RoutingDecisionRecord, RoutingMemoryError, type RoutingMemoryExport, type RoutingMemoryStats$1 as RoutingMemoryStats, type RoutingMetrics, RoutingMetricsCollector, type RoutingMetricsConfig, type RoutingRecord, type RuleStatus, type RulesSnapshot, RulesSnapshotSchema, type RunGraphWorkflowDeps, type RunGraphWorkflowInput, RunGraphWorkflowInputSchema, type RunGraphWorkflowResponse, type RunOptions, type RunProgress, type RunStatus, type RunWorkflowDeps, type RunWorkflowInput, RunWorkflowInputSchema, type RunnerConfig, type RunnerErrorCode, SAFETY_CATEGORIES, SAFETY_CATEGORY_MAP, PROVIDER_ENV_KEYS as SDK_PROVIDER_ENV_KEYS, DEFAULT_CAPABILITIES as SKILL_DEFAULT_CAPABILITIES, SKILL_PERMISSIONS, SQLiteOutcomeStorage, STAGE_TYPES, START, type SWEBenchCheckpoint, type SWEBenchConfig, type CostEstimate$1 as SWEBenchCostEstimate, type SWEBenchDatasetInfo, type SWEBenchEvalResult, type FailureAnalysis as SWEBenchFailureAnalysis, type FailurePattern as SWEBenchFailurePattern, type SWEBenchInstance, type SWEBenchPrediction, type SWEBenchRunResult, SWEBenchRunner, SWEBenchRunnerError, type SWEBenchSummary, type SWEBenchVariant, SWE_BENCH_DATASETS, SWE_BENCH_SYSTEM_PROMPT, type SafetyCategory, SafetyCategoryId, SafetyCategoryIdSchema, type SafetyCategoryIdType, SafetyCategorySchema, type SafetyTaxonomySummary, type SafetyTestCase, SafetyTestCaseSchema, type SandboxConfig, type SandboxExecutionOptions, type SandboxMode, type SandboxPolicy, type SandboxResult, type SanitizationEvent, type SanitizedInput, SanitizedInputSchema, type SanitizerConfig, SanitizerConfigSchema, type ScannerData, type ScannerEntry, type ScannerRecommendation, type ScannerRegistryManifest, type ScenarioError, type ScenarioResult, ScenarioResultSchema, type ScmComment, type ScmCommentDetail, ScmError, type ScmFileChange, type ScmIssue, type ScmIssueDetail, type PRStatus as ScmPRStatus, type ScmPlatform, type ScmPullRequest, type ScmPullRequestDetail, type ScmReviewDecision, type ScmToken, type ScmUserMetadata, type ScoreBreakdown, ScoreBreakdownSchema, SdkAdapter, type SdkAdapterConfig, type SdkProviderId, type SearchCodebaseDeps, SearchCodebaseInputSchema, type SecurityAnalysisResult, type AuditEvent as SecurityAuditEvent, type AuditQuery as SecurityAuditQuery, type SecurityCapability, type SecurityConfig, SecurityConfigSchema, SecurityError, type SecurityErrorCode, SecurityErrorCodeSchema, type SecurityEventAuditOpts, SecurityExpert, type SecurityExpertOptions, type SecurityFocusArea, type PolicyDecision$1 as SecurityPolicyDecision, SelectionError, type ExpertRegistry as SelectionExpertRegistry, type SelectionOptions, SelectionOptionsSchema, type SelectionResult$1 as SelectionResult, SelectionResultSchema, SequentialProtocol, type SerializedError, type ServerConfig, type ServerError, type ServerInstance, type SessionEvent, type SessionState, type SessionStatus, SessionStatusSchema, type SharedConclusion, SharedConclusionSchema, type SharedInsight, SharedInsightSchema, type SharedMemoryEntry, SharedMemoryStore, type SharedMemoryTag, SimpleAgent, SimpleMajorityStrategy, type Skill, AgentRoleSchema$2 as SkillAgentRoleSchema, type SkillAttestation, SkillAttestationSchema, type SkillCapabilities, SkillCapabilitiesSchema, type SkillCategory, type SkillComplexity, SkillComposer, type SkillComposerConfig, type SkillComposition, type SkillCompositionRequest, type SkillDependency, SkillDependencyGraph, SkillDependencySchema, type SkillDependencyType, SkillDependencyTypeSchema, type SkillExample, type SkillExecution, type SkillExecutionStatus, SkillLibrary, type SkillLibraryConfig, SkillLoader, type SkillLoaderConfig, SkillLoaderConfigSchema, type SkillLoaderError, type SkillLoaderErrorCode, SkillLoaderErrorSchema, type SkillMetrics, type SkillParameter, type SkillPermission, SkillPermissionSchema, type SkillProvenance, SkillProvenanceSchema, type SkillQuery, type SkillRBAC, SkillRBACSchema, type SkillSearchResult, type SkillSecurityError, SkillSecurityErrorSchema, type SkillStore, type SkillWithMetrics, type SortOptions, type SourceCitation, SourceCitationSchema, type SpanId, type SpecExecutionError, type SpecExecutionOptions, type SpecExecutionResult, type SpecParseError, type StageCompletedOptions, type StageContext, type StageFailedOptions, type StageOutput, type StageRegistry, type StageResult, StageResultSchema, type StageSpec, StageSpecSchema, type StageStartedOptions, type StageType, type StateChangeCallback, type StateChangePayload, type StateFieldSchema, type StateMachineOptions, type StateReducer, type StateSchema, type StateTransition, type StateTransitionEvent, type StatisticalOptions, type StatisticalSummary, type StatusUpdateMessage, type StepExecutionOptions, type StepExecutor$1 as StepExecutor, type StepExecutorDeps, type StepResult, type StepResultSummary, type StopReason, type StoredModelStats, type StoredReward, type StoredRoutingDecision, type StoredTaskOutcome, type StrategyAction, StrategyDistiller, StreamCancelledError, type StreamChunk, StreamController, StreamError, type StreamState, AgentRoleSchema$1 as StrictAgentRoleSchema, InputDefinitionSchema$1 as StrictInputDefinitionSchema, WorkflowDefinitionSchema$1 as StrictWorkflowDefinitionSchema, WorkflowStepSchema$1 as StrictWorkflowStepSchema, type StrippedElement, StrippedElementSchema, type SubTask, SubTaskSchema, SubprocessCliAdapter, type SubtaskNode, SubtaskNodeSchema, type SubtaskPriority, SubtaskPrioritySchema, type SubtaskStatus, SubtaskStatusSchema, type SubtaskType, SubtaskTypeSchema, SupermajorityStrategy, type SuspiciousSignal, SuspiciousSignalSchema, type AgentState as SwarmAgentState, type SwarmHealthMetrics$1 as SwarmHealthMetrics, type SwebenchValidation, type SycophancyIndicator, type SycophancyReport, type SynthesizedResult, SynthesizedResultSchema, type SystemComponent, TASK_STATUSES, TASK_TYPE_EXPERTS, TEMPLATE_CATEGORIES, TEMPLATE_KEYWORDS, TRINITY_ROLE_MAX_TOKENS, TRINITY_ROLE_PROMPTS, TRINITY_ROLE_TEMPERATURES, TRUST_TIER_NUMERIC, type Task$1 as Task, type TaskAnalysis, type TaskAnalysisResult, TaskAnalysisResultSchema, TaskAnalysisSchema, type TaskAssignmentMessage, type TaskClassification, type TaskCommitment, TaskComplexity, type TaskContext, type TaskContract, TaskContractSchema, type TaskDag, TaskDagSchema, TaskDomain$1 as TaskDomain, type TaskId, type TaskOutcome$1 as TaskOutcome, type TaskOutcomeRecord, TaskOutcomeSchema$1 as TaskOutcomeSchema, type TaskPayload, type TaskProfileSummary, TaskQueue, type TaskRequirements, type TaskResult, TaskSchema, type TaskSignals, type TaskStatus, type TaskToolResponse, type TaskTypePerformance, type TemplateCategory, TemplateCategorySchema, type TemplateMetadata, TemplateMetadataSchema, TemplateRegistry, type TerminationReason, TerminationReasonSchema, type TestCaseResult, type TestFramework, type TestQuality, TestRunner, type TestRunnerConfig, TestRunnerError, type TestRunnerErrorCode, type TestStatus, type TestSuiteResult, type TestingAnalysisResult, TestingExpert, type TestingExpertOptions, type TextContent, TextDashboardRenderer, type ThinkerOutput, type ThresholdUpdateDetail, type TimeConstraint, type TimePeriod, TimeoutError, type TimeoutProfile, type TimingStatistics, TokenCountError, type TokenCountResult, TokenCounter, type TokenCounterConfig, TokenCounterProvider, type TokenResolverConfig, type TokenStrategy, type TokenUsage, type TokenUsageBreakdown, type TokensByPhase, type ToolCompletedEvent, type ToolDefinition, type ToolInvocationAuditOpts, type ToolInvokedEvent, type ToolPayload, type ToolRegistrationOptions, type ToolRegistrationResult, type ToolResult, type ToolSet, ToolSetSchema, type TraceEvent, type TraceEventType, type TraceId, TraceLogger, type TraceLoggerOptions, type TrackedTask, type TransitionErrorCallback, type TreeId, type TreeState, TreeStateSchema, type TreeStatistics, TreeStatisticsSchema, type Trend, type TrendDetectedDetail, type TrinityConfig, TrinityConfigSchema, TrinityCoordinator, type TrinityExecuteOptions, type TrinityPhase, type TrinityPhaseResult, TrinityPhaseSchema, type TrinityResult, type TrinityRole, type TrinityRoleConfig, TrinityRoleSchema, TrinityStopReasonSchema, type TrustClassificationEvent, type TrustTier, TrustTierSchema, UnanimousStrategy, type UnknownVar, type Unsubscribe, type V2Config, type V2Mode, VERSION, VOTING_THRESHOLDS, ValidationDashboard, ValidationError$1 as ValidationError, type ValidationIssue, type VariantStats, type VerificationResult, type VerifierOutput, VerifierVerdictSchema, type VersionRequirements, type VersionStatus, type Violation, ViolationSchema, type Vote, type VoteCounts, type VoteDecision$1 as VoteDecision, VoteDecisionSchema$1 as VoteDecisionSchema, type VoteDecisionStatus, type VoteMessage, VoteMessageSchema, type VoteResult, VoteSchema, type VotingObservation, VotingObservationSchema, type VotingOutcome, VotingProtocol, type VotingProtocolConfig, VotingProtocolConfigSchema, type VotingProtocolResult, type VotingRound, type VotingRoundPhase, VotingRoundPhaseSchema, type VotingRoundStatus, VotingRoundStatusSchema, type VotingSession, VotingStrategyFactory, type Vulnerability, VulnerabilitySchema, VulnerabilitySeveritySchema, type WaveExecutionResult, type WaveResult, WaveScheduler, type WaveSchedulerConfig, type WaveTask, type WaveTaskExecutor, type WaveTaskResult, WeatherReportInputSchema, type WeightedAgentRecord, type WeightedConsensusResult, type WeightedVoteCounts, WeightedVoting, type WeightedVotingConfig, type WeightedVotingOptions, type WinLossAnalysis, type WithRetryOptions, type WorkChunk, type WorkerOutput, type WorkflowAdapterConfig, type WorkflowConfig, WorkflowConfigSchema, type WorkflowDefinition, type WorkflowDefinitionInput, type WorkflowDefinitionOutput, WorkflowDefinitionSchema, type WorkflowEngineFactoryConfig, WorkflowError, type WorkflowExecutionContext, type ExecutionPlan$1 as WorkflowExecutionPlan, type IExpertFactory$2 as WorkflowExpertFactory, type WorkflowInfo, WorkflowInputsSchema, WorkflowOrchestratorAdapter, type WorkflowPattern, type WorkflowRouterOptions, type RoutingDecision$1 as WorkflowRoutingDecision, type WorkflowStep$1 as WorkflowStep, type WorkflowStepInput, type WorkflowStepOutput, WorkflowStepSchema, type WorkflowTemplate, type WorkflowToolResult, actorFromContext, aggregateResults, analysisToTaskContract, analyzeTask as analyzeDelegateTask, analyzeFailures, analyzeGitHubRepo, analyzeRepo, analyzeTask$1 as analyzeTask, append, applyPatch, areStepsCompleted, assessReputation, bufferStream, buildDependencyGraph, buildDockerArgs, buildEnrichedPrompt, buildFinalResult, buildHarnessArgs, buildHarnessCommand, buildPendingResult, buildPlanFromAnalysis, buildDependencyGraph$1 as buildSkillDependencyGraph, buildTimeoutResult, calculateDelay, calculateDistributionStats, calculateEstimatedRemaining, calculateMetrics, calculateMetricsTotals, calculateMinSampleSize, calculateRegret, calculateRepositoryMetrics, calculateRoutingDistribution, calculateTokenCost, calculateVoteWeight, calculateWinLoss, canApplyPatch, canExecuteSkill, canInfluenceDecisions, canPipelineProceed, canProceed, cancelExecution, categorizeOutcomeError, categorizeOutcomeErrorMessage, checkForResearchTriggers, checkPermissionBoundary, checkPipelinePolicy, checkpointToResult, chunkByDirectory, classifyTask, classifyTrust, cleanupCheckpoint, clearRegistryCache, clearTemplateCache, calculateBackoffDelay as cliCalculateBackoffDelay, categorizeError as cliCategorizeError, closeServer, collectRealVotes, collectStream, compareProportions, compilePipelineGraph, compilePlan, compileSpecToGraph, computeAdaptiveThresholds, computeOutcomeReward, concatStreams, connectTransport, containsExpressions, countActiveSessions, createAbTestTracker, createAgentPairKey, createAgentStages, createStepExecutor as createAgentStepExecutor, createAllAdapters, createArchitectureExpert, createAttestation, createAuditLogger, createAuditTrail, createBenchmarkMemory, createCheckpoint, createCheckpointStore, createClaudeAdapter, createCliAdapter, createCliCircuitBreakerIntegration, createCliDetectionCache, createCliExecutor, createCodeExpert, createCollaborationSession, createCompositeRouter, createConsensusEngine, createContextItem, createCorePluginRegistry, createCorrelationTracker, createDashboard, createDashboardRenderer, createDefaultDeps, createDefaultPolicyEngine, createDefaultPolicyFirewall, createDefaultRateLimiter, createDefaultRegistry, createDelegatePipeline, createDependencyError, createDevStageRegistry, createDocumentationExpert, createDryRunHandler, createEmptyContext, createEvaluationHarness, createEventBusBridge, createExecutionContext, createExecutionPlan, createExecutor, createExplorationPrompt, createFeedbackIntegration, createFeedbackSubscriber, createFullGitHubProvider, createGeminiAdapter, createGitHubAdapter, createGitHubProvider, createGraphAuditBridge, createHarnessExecutor, createHigherOrderVotingStrategy, createIncompleteResult, createInitialCostMetrics, createInitialProgress, createInitialSessionMetrics, createInitialTokenUsage, createInitializedWorkflowEngine, createInstancePrompt, createInteractionGraph, createSwarmObserver as createInteractionSwarmObserver, createIsolatedRegistry, createLogger, createMcpLogger, createMcpNotifier, createMockExecutor, createNexusExecutorFromEnv, createOWVoting, createOllamaAdapter, createOpenAIAdapter, createOrchestrator, createOrchestratorFactory, createOutcomeFeedbackCollector, createOutcomeStorage, createPatchApplicator, createPolicyContext, createPrediction, createPreferenceRouter, createProductionWorkflowEngine, createProgressAdapter, createProtocolFactory, createRateLimiter, createRealWorkflowEngine, createReportGenerator, createResultAggregator, createRetryPrompt, createRoutingDecision, createRoutingMetricsCollector, createRunner, createSandboxExecutor, createScmProvider, createSecurityError, createSecurityExpert, createServer, createSkillComposer, createSkillDependencyGraph, createSkillLibrary, createSkillLoader, createStateComparisonVerifier, createStateGuard, createStateMachine, createStrategyDistiller, createStrategyFactory, createStream, createSummaryPrompt, createTaskOutcome, createTaskQueue, createTemplateRegistry, createTestRunner, createTestingExpert, createTimer, createTokenCounter, createToolLogger, createTrackedAgent, createTrinityCoordinator, createValidatedExecutor, createValidatedHarness, createValidationDashboard, createValidator, createVariantRunner, createVotingProtocol, createWaveScheduler, createWeightedVoting, createWorkflowEngineDeps, createWorkflowEngineDepsAsync, createWorkflowRouter, curateContext, customReducer, decomposeSpec, defaultConfig, delegateInputToTaskContract, denyMutationsWithoutModeRule, detectFailurePatterns, detectLatencyPatterns, detectSuccessPatterns, detectTestFramework, detectTrend, determineFinalStatus, emitCorroborationEvent, emitExecutionComplete, emitGraphExecutionEvent, emitNodeResults, emitNodeStarted, emitPipelineStageEvent, emitPolicyEvent, emitReputationEvent, emitSanitizationEvent, emitStageCompleted, emitStageFailed, emitStageStarted, emitStateUpdated, emitStepCompleted, emitThresholdUpdate, emitTrendDetected, emitTrustEvent, err, estimateDifficulty, estimateTaskComplexity, estimateTokens, evaluatePolicy as evaluatePipelinePolicy, evaluatePolicy$2 as evaluatePolicy, evaluatePredictions, evaluatePolicy$1 as evaluateSecurityPolicy, executeCliRetryLoop, executeDelegatePipeline, executeExpert, executeGraph, executeHarness, executeInDocker, executeOrchestratePipeline, executeParallel, executeSpec, exportReport, extractApproach, extractBooleanField, extractExpressions, extractFilesFromResponse, extractHypothesis, extractModelName, extractNonErrorMessage, extractNumberField, extractPastSuccessRates, extractPatch, extractRepoFromInstanceId, extractRepoName, extractSessionId, extractStateValue, extractStringArrayField, extractStringField, filterAvailableModels, filterByRepo, filterBySeverity, filterByVersion, filterStream, findActiveSession, findMissingDependencies, flushPipelineMemory, formatCompileError, formatContextForPrompt, formatValidationResult, fromArray, generateATL, generateMcpConfig, generateProposalId, generateReport, generateSecurityPlan, generateWeatherReport, getAllTestCases, getAvailabilityCache, getAvailableClis, getAvailableRoles, getBuiltInTemplates, getBuiltInTemplatesPath, getBuiltInTemplatesWithMetadata, getCapabilitiesForRole, getCategoriesByMinRiskLevel, getCliForModelId, getCompletedInstanceIds, getCompletedSteps, getCorroborationRules, getCpuCores, getDatasetInfo, getDefaultAllowedTools, getDockerVersion, getEventBusStats, getExecutionDuration, getExecutionOrder, getExpertRegistry, getFallbackChain, getGraphRegistry, getGraphWorkflowList, getInstance, getKnownNexusVarNames, getMemoryInfo, getOutcomeStore, getPipelineArtifactStore, getPipelinePluginRegistry, getPolicy, getPolicyMode, getPythonVersion, getRecommendedRole, getReferencedSteps, getRegistryManifest, getRequiredTrustTier, getResultsFilePath, getSafetyCategory, getSafetyTaxonomySummary, getSkillSetForTask, getSkillsForTask, getStepResult, getSwarmObserver, getSwebenchVersion, getTemplate, getTestCasesByTags, getTimeoutForTask, getTimeoutForTaskAuto, getTokenEnvVars, getTopologicalOrder, getVariable, hasToken, ictmToExpertConfig, identifySessionsToRemove, inferICTM, initializeAgentSkills, initializeBuiltInTemplates, initializeEventBusBridge, isCancelled, isCliAvailable$1 as isCliAvailable, isRetryableError as isCliRetryableError, isErr, isIncompleteResult, isMutatingAction, isOk, isReadOnlyAction, isRetryableError$1 as isRetryableError, isCliAvailable as isSWEBenchCliAvailable, isStepCompleted, isZodError, listInstances, listTemplateIds, loadCheckpointState, loadDataset, loadTemplateFile, loadTemplatesFromDirectory, loadWorkflowFile, logPolicyAudit, logRateLimitAudit, logToolError, logToolInvocationAudit, logToolStart, logToolSuccess, logger, map, mapAuthorAssociation, mapErr, mapResolutionStatus, mapStateToPhase, mapTestStatus, meanConfidenceInterval, mergeStreams, normalizeRepoId, ok, orchestrateInputToTaskContract, overwrite, parseATL, parseAgentPairKey, parseExpression, parseJsonResults, parseProgressLine, parseSpec, parseStdoutResults, parseTemplateContent, parseTestResults, parseWorkflowJson, parseWorkflowYaml, proportionConfidenceInterval, quickRun, quickSelect, readJsonResults, readPredictions, recordOutcome, reduceStream, registerConsensusVoteTool, registerCorePlugins, registerCreateExpertTool, registerDelegateToModelTool, registerExecuteExpertTool, registerExecuteSpecTool, registerExpertsResource, registerExtractSymbolsTool, registerIssueTriageTool, registerListExpertsTool, registerListWorkflowsTool, registerMemoryQueryTool, registerMemoryStatsTool, registerMemoryWriteTool, registerModelsResource, registerOrchestrateTool, registerPrompts, registerQueryTraceTool, registerRegistryImportTool, registerRepoAnalyzeTool, registerRepoSecurityPlanTool, registerResearchAddSourceTool, registerResearchAddTool, registerResearchAnalyzeTool, registerResearchCatalogReviewTool, registerResearchDiscoverTool, registerResearchQueryTool, registerResearchResource, registerResearchSynthesizeTool, registerResources, registerRunGraphWorkflowTool, registerRunWorkflowTool, registerSearchCodebaseTool, registerTools, registerWeatherReportTool, requiresCitation, requiresCorroboration, resetAvailabilityCache, resetPipelineArtifactStore, resetPipelinePluginRegistry, resetRegistry, resolveExpression, resolveFallback, resolveInput, resolveScannerData, resolveStringExpressions, resolveToken, resolveV2Config, resolveWithFallbacks, resultToOutcome, runAdaptiveOrchestrator, runAgentOnInstance, runBenchmarkInstances, runBenchmarkParallel, runDevPipeline, runGraphPipeline, runIterativeConsensus, runPreconditions, runSingleInstance, runTests, runVerification, safePathsRule, safeValidateExpertConfig, sanitize, sanitizeInput, saveStageCheckpoint, scoreByHybrid, scoreByImportance, scoreByRecency, selectExperts, selectModel, setSwarmObserver, setVariable, sigmoidConfidence, skip, sleep, snapshotContext, sortByPriority, startStdioServer, storeStepResult, take, takeUntil, tapStream, taskContractToToolResponse, toolError, toolSuccess, toolSuccessStructured, transformHarnessOutput, transformHarnessProgress, transformInstanceResult, transformStream, transformTestResult, unwrap, unwrapOr, updateContext, validateAgentAction, validateCommand, validateCorroboration, validateDependencyGraph, validateDiskSpace, validateDocker, validateEnvironment, validateEvaluationCriterion, validateExpertConfig, validateExpressions, validateICTM, validateNexusEnv, validatePatch, validatePatchFormat, validatePrediction, validatePredictionsFile, validatePython, validateRequiredInputs, validateSafetyCategory, validateScenario, validateCapabilities as validateSkillCapabilities, validateSkillExecution, validateSkillProvenance, validateRBAC as validateSkillRBAC, validateSwebench, validateTestCase, validateToolInput, validateWorkflow, validateWorkflowDependencies, withLogging, withRetry, withRetryWrapper, withTimeout, writePredictions };