plugin-agent-orchestrator 1.1.4 → 1.1.6

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 (148) hide show
  1. package/README.md +204 -114
  2. package/dist/client/index.js +1 -1
  3. package/dist/client-v2/117.7565cff57c39318a.js +10 -0
  4. package/dist/client-v2/214.106635011859dede.js +10 -0
  5. package/dist/client-v2/418.41ed200e7d6da332.js +10 -0
  6. package/dist/client-v2/53.349fff8db80b19d4.js +10 -0
  7. package/dist/client-v2/981.e4a1f41cfc94a856.js +10 -0
  8. package/dist/client-v2/index.js +1 -1
  9. package/dist/externalVersion.js +7 -8
  10. package/dist/locale/en-US.json +226 -170
  11. package/dist/locale/vi-VN.json +226 -170
  12. package/dist/locale/zh-CN.json +226 -170
  13. package/dist/server/collections/agent-execution-spans.js +8 -0
  14. package/dist/server/collections/agent-loop-action-approvals.js +1 -0
  15. package/dist/server/collections/agent-loop-runs.js +7 -1
  16. package/dist/server/collections/agent-loop-steps.js +7 -0
  17. package/dist/server/collections/skill-executions.js +8 -0
  18. package/dist/server/plugin.js +3 -1
  19. package/dist/server/resources/agent-harness-profile.js +117 -0
  20. package/dist/server/resources/agent-knowledge-insights.js +1 -3
  21. package/dist/server/resources/agent-loop-approval.js +25 -0
  22. package/dist/server/resources/agent-loop.js +3 -1
  23. package/dist/server/services/AgentMemoryContextService.js +34 -0
  24. package/dist/server/services/HarnessCompiler.js +35 -2
  25. package/dist/server/services/HarnessProfileService.js +74 -9
  26. package/dist/server/services/HarnessSchema.js +30 -3
  27. package/dist/server/services/LoopPatternSchema.js +16 -1
  28. package/dist/server/services/LoopRunRepository.js +80 -0
  29. package/dist/server/services/LoopRunStateMachine.js +92 -3
  30. package/dist/server/services/LoopTriggerService.js +37 -0
  31. package/dist/server/services/LoopWorkerService.js +261 -23
  32. package/dist/server/services/NativeSubAgentObserver.js +165 -23
  33. package/dist/server/services/PluginAiRuntimeAdapter.js +16 -5
  34. package/dist/server/services/ToolLoopDetectionService.js +210 -0
  35. package/dist/server/services/VerificationService.js +66 -0
  36. package/dist/server/services/harness-runtime-policy.js +139 -0
  37. package/dist/server/skill-hub/plugin.js +36 -3
  38. package/dist/server/skill-hub/tasks/SkillExecutionTask.js +29 -0
  39. package/package.json +53 -53
  40. package/src/client/ApprovalsTab.tsx +2 -0
  41. package/src/client/OrchestratorSettings.tsx +11 -0
  42. package/src/client/skill-hub/components/GitSkillImport.tsx +3 -3
  43. package/src/client/skill-hub/components/SkillMetrics.tsx +15 -10
  44. package/src/client/skill-hub/index.tsx +0 -52
  45. package/src/client-v2/components/AgentRunsTab.tsx +576 -576
  46. package/src/client-v2/components/ApprovalsTab.tsx +337 -0
  47. package/src/client-v2/components/HarnessProfilesTab.tsx +385 -105
  48. package/src/client-v2/components/MemoryInspectorTab.tsx +141 -141
  49. package/src/client-v2/components/TracingTab.tsx +515 -515
  50. package/src/client-v2/hooks/useApiRequest.ts +141 -141
  51. package/src/client-v2/pages/ApprovalsPage.tsx +10 -0
  52. package/src/client-v2/plugin.tsx +6 -6
  53. package/src/client-v2/skill-hub/components/SkillMetrics.tsx +5 -2
  54. package/src/locale/en-US.json +226 -174
  55. package/src/locale/vi-VN.json +226 -174
  56. package/src/locale/zh-CN.json +226 -174
  57. package/src/server/__tests__/circuit-breaker.test.ts +248 -248
  58. package/src/server/__tests__/harness-compiler.test.ts +83 -0
  59. package/src/server/__tests__/harness-profile-service.test.ts +51 -0
  60. package/src/server/__tests__/harness-runtime-policy.test.ts +293 -0
  61. package/src/server/__tests__/harness-tool-plan.test.ts +24 -0
  62. package/src/server/__tests__/loop-approval-decision.test.ts +512 -0
  63. package/src/server/__tests__/loop-approval-expiry.test.ts +258 -0
  64. package/src/server/__tests__/loop-budget-service.test.ts +255 -255
  65. package/src/server/__tests__/loop-control-plane-backfill.test.ts +266 -266
  66. package/src/server/__tests__/loop-pattern-schema.test.ts +18 -1
  67. package/src/server/__tests__/loop-pattern-service.test.ts +148 -148
  68. package/src/server/__tests__/loop-run-state-machine.test.ts +11 -0
  69. package/src/server/__tests__/loop-trigger-service.test.ts +148 -0
  70. package/src/server/__tests__/loop-worker-claim.test.ts +341 -341
  71. package/src/server/__tests__/loop-worker-execution.test.ts +82 -1
  72. package/src/server/__tests__/native-sub-agent-observer.test.ts +288 -4
  73. package/src/server/__tests__/path-lock-service.test.ts +254 -254
  74. package/src/server/__tests__/skill-execution-task-policy.test.ts +140 -0
  75. package/src/server/__tests__/smoke.test.ts +162 -162
  76. package/src/server/__tests__/tool-loop-detection.test.ts +275 -0
  77. package/src/server/collections/agent-execution-spans.ts +8 -0
  78. package/src/server/collections/agent-harness-profile-versions.ts +26 -26
  79. package/src/server/collections/agent-harness-profiles.ts +71 -71
  80. package/src/server/collections/agent-loop-action-approvals.ts +1 -0
  81. package/src/server/collections/agent-loop-artifacts.ts +25 -25
  82. package/src/server/collections/agent-loop-circuit-states.ts +23 -23
  83. package/src/server/collections/agent-loop-control-settings.ts +21 -21
  84. package/src/server/collections/agent-loop-events.ts +98 -98
  85. package/src/server/collections/agent-loop-path-locks.ts +27 -27
  86. package/src/server/collections/agent-loop-patterns.ts +42 -42
  87. package/src/server/collections/agent-loop-runs.ts +7 -1
  88. package/src/server/collections/agent-loop-steps.ts +7 -0
  89. package/src/server/collections/agent-loop-usage-buckets.ts +22 -22
  90. package/src/server/collections/agent-loop-worktrees.ts +25 -25
  91. package/src/server/collections/skill-executions.ts +8 -0
  92. package/src/server/migrations/20260427000002-change-packages-to-text.ts +52 -52
  93. package/src/server/migrations/20260429000000-add-llm-fields.ts +47 -47
  94. package/src/server/migrations/20260429000001-fix-inputargs-json-to-text.ts +45 -45
  95. package/src/server/migrations/20260503000000-add-orchestrator-trace-fields.ts +33 -33
  96. package/src/server/migrations/20260524000000-add-agent-loop-fields-to-skill-executions.ts +31 -31
  97. package/src/server/migrations/20260803010000-backfill-loop-control-plane-data.ts +293 -293
  98. package/src/server/plugin.ts +3 -1
  99. package/src/server/resources/agent-harness-profile.ts +94 -0
  100. package/src/server/resources/agent-knowledge-insights.ts +5 -3
  101. package/src/server/resources/agent-loop-approval.ts +32 -0
  102. package/src/server/resources/agent-loop-artifact.ts +56 -56
  103. package/src/server/resources/agent-loop-events-stream.ts +105 -105
  104. package/src/server/resources/agent-loop.ts +3 -1
  105. package/src/server/resources/resource-helpers.ts +33 -33
  106. package/src/server/resources/tracing.ts +266 -266
  107. package/src/server/services/AgentMemoryContextService.ts +44 -0
  108. package/src/server/services/DurableCircuitBreakerService.ts +239 -239
  109. package/src/server/services/ExecutionSpanService.ts +2 -0
  110. package/src/server/services/HarnessCompiler.ts +37 -0
  111. package/src/server/services/HarnessProfileService.ts +92 -10
  112. package/src/server/services/HarnessSchema.ts +31 -0
  113. package/src/server/services/LoopBudgetService.ts +275 -275
  114. package/src/server/services/LoopControlService.ts +124 -124
  115. package/src/server/services/LoopPatternSchema.ts +19 -1
  116. package/src/server/services/LoopPatternService.ts +143 -143
  117. package/src/server/services/LoopRunRepository.ts +99 -0
  118. package/src/server/services/LoopRunStateMachine.ts +100 -3
  119. package/src/server/services/LoopSchedulerService.ts +199 -199
  120. package/src/server/services/LoopTriggerService.ts +42 -0
  121. package/src/server/services/LoopWorkerService.ts +327 -27
  122. package/src/server/services/NativeSubAgentObserver.ts +186 -21
  123. package/src/server/services/PathLockService.ts +321 -321
  124. package/src/server/services/PluginAiRuntimeAdapter.ts +24 -7
  125. package/src/server/services/ToolLoopDetectionService.ts +213 -0
  126. package/src/server/services/VerificationSchema.ts +31 -31
  127. package/src/server/services/VerificationService.ts +81 -2
  128. package/src/server/services/harness-runtime-policy.ts +141 -0
  129. package/src/server/skill-hub/plugin.ts +41 -3
  130. package/src/server/skill-hub/services/RegistrySkillSnapshotService.ts +235 -235
  131. package/src/server/skill-hub/services/__tests__/RegistrySkillSnapshotService.test.ts +61 -61
  132. package/src/server/skill-hub/tasks/SkillExecutionTask.ts +43 -2
  133. package/src/server/utils/ensure-indexes.ts +96 -96
  134. package/src/server/utils/logging.ts +62 -62
  135. package/src/server/utils/loop-pattern-context.ts +20 -20
  136. package/dist/client-v2/214.b063f33ba044a808.js +0 -10
  137. package/dist/client-v2/373.f5d5292e53c4e832.js +0 -10
  138. package/dist/client-v2/418.58fa350f5496efd3.js +0 -10
  139. package/dist/client-v2/53.9a10455323390f14.js +0 -10
  140. package/dist/client-v2/677.a991ce0250ff5c77.js +0 -10
  141. package/dist/client-v2/925.e5925bf21ed68e7a.js +0 -10
  142. package/src/client/AIEmployeeSelect.tsx +0 -47
  143. package/src/client/AIEmployeesContext.tsx +0 -102
  144. package/src/client/RulesTab.tsx +0 -2
  145. package/src/client/TracingTab.tsx +0 -436
  146. package/src/client/skill-hub/components/ExecutionProgress.tsx +0 -51
  147. package/src/client-v2/components/RulesTab.tsx +0 -2
  148. package/src/client-v2/pages/AgentRunsPage.tsx +0 -13
@@ -1,8 +1,13 @@
1
1
  import { createHash } from 'crypto';
2
+ import { mkdirSync, writeFileSync } from 'fs';
3
+ import { resolve } from 'path';
2
4
  import { ExecutionSpanService } from './ExecutionSpanService';
3
5
  import { AgentMemoryContextService } from './AgentMemoryContextService';
4
6
  import { TokenTracker } from './TokenTracker';
5
- import { runWithAgentExecutionContext } from './AgentExecutionContext';
7
+ import { getAgentExecutionContext, runWithAgentExecutionContext } from './AgentExecutionContext';
8
+ import { compileHarness } from './HarnessCompiler';
9
+ import type { CompiledHarness, HarnessLayer } from './HarnessCompiler';
10
+ import { redactSecretsIn, resolveRunRoleHarness, spilledText } from './harness-runtime-policy';
6
11
  import { asObject, currentUserId, toPlain, trimText } from '../utils/ctx-utils';
7
12
 
8
13
  const WRAP_STATE_KEY = Symbol.for('plugin-agent-orchestrator.nativeSubAgentObserver');
@@ -57,6 +62,7 @@ type RunState = {
57
62
  leaderUsername?: string;
58
63
  employeeUsername?: string;
59
64
  userId?: string | number;
65
+ policy: CompiledHarness;
60
66
  toolSpans: Map<string, ToolSpanState>;
61
67
  pending: Set<Promise<void>>;
62
68
  };
@@ -184,13 +190,28 @@ export class NativeSubAgentObserver {
184
190
  }
185
191
 
186
192
  const parentSessionId = this.resolveParentSessionId(task) || undefined;
193
+ const parentConversation = await this.safeFindParentConversation(task.ctx, parentSessionId);
194
+ const parentRunId = this.controlPlaneRunIdOf(parentConversation);
195
+ // A sub-agent dispatched from a loop session inherits the role's frozen harness as an extra
196
+ // compile layer, so delegation caps, sharing and memory restrictions do not reset at the hop.
197
+ const parentRunHarness = parentRunId
198
+ ? await this.safeResolveParentRunHarness(
199
+ parentRunId,
200
+ normalizeString(readValue(parentConversation, 'aiEmployeeUsername')),
201
+ )
202
+ : null;
203
+ const policy = this.compilePolicy(settings, parentRunHarness);
204
+ const spansEnabled = policy.observability.sharing !== 'disabled';
205
+
187
206
  const subSessionId = normalizeString(task.sessionId) || undefined;
188
207
  const employeeUsername = modelUsername(task.employee);
189
208
  const userId = currentUserId(task.ctx) || task.ctx?.auth?.user?.id;
190
209
  const dispatchToolMessage = await this.resolveDispatchToolMessage(task.ctx, parentSessionId, subSessionId);
191
210
  const toolCallId = dispatchToolMessage?.toolCallId;
192
- const leaderUsername = await this.resolveLeaderUsername(task.ctx, parentSessionId);
211
+ const leaderUsername = this.leaderUsernameFor(task.ctx, parentConversation);
193
212
  const rootRunId = makeNativeRunId([parentSessionId, subSessionId, toolCallId, employeeUsername]);
213
+ const delegation = await this.resolveDelegationContext(parentSessionId);
214
+ const childDepth = delegation.depth + 1;
194
215
  const memory = await this.safeBuildMemoryContext({
195
216
  userId,
196
217
  aiEmployeeUsername: employeeUsername,
@@ -219,6 +240,7 @@ export class NativeSubAgentObserver {
219
240
  memoryScopes: memory.appliedScopes,
220
241
  memoryContextChars: memory.chars,
221
242
  harnessTag: settings.harnessTag || 'default',
243
+ ...(parentRunId ? { agentLoopRunId: parentRunId } : {}),
222
244
  },
223
245
  parentSessionId,
224
246
  subSessionId,
@@ -226,11 +248,34 @@ export class NativeSubAgentObserver {
226
248
  leaderUsername,
227
249
  employeeUsername,
228
250
  userId,
251
+ policy,
229
252
  toolSpans: new Map(),
230
253
  pending: new Set(),
231
254
  };
232
255
 
233
- await this.safeCreateRootSpan(state, task.question);
256
+ if (spansEnabled) {
257
+ await this.safeCreateRootSpan(state, task.question, {
258
+ depth: childDepth,
259
+ parentSpanId: delegation.parentSpanId,
260
+ agentLoopRunId: parentRunId,
261
+ });
262
+ }
263
+
264
+ // Depth is persisted on the span, not carried in-process, so a resumed child arrives with its
265
+ // true depth. The cap comes from the compiled policy, which includes the inherited parent
266
+ // layer; exceeding it fails the dispatch instead of silently deepening the recursion.
267
+ const maxDepth = policy.delegation.maxDepth;
268
+ if (maxDepth !== null && childDepth > maxDepth) {
269
+ const message = `Sub-agent delegation depth ${childDepth} exceeds the harness limit of ${maxDepth}.`;
270
+ await this.spanService.finish(state.rootSpanId, 'error', state.rootStartedAt, {
271
+ error: message,
272
+ metadata: {
273
+ ...state.rootMetadata,
274
+ failedAt: new Date().toISOString(),
275
+ },
276
+ });
277
+ throw new Error(message);
278
+ }
234
279
 
235
280
  const originalWriter = task.writer;
236
281
  observedTask.writer = (chunk: Record<string, unknown>) => {
@@ -242,7 +287,7 @@ export class NativeSubAgentObserver {
242
287
  };
243
288
 
244
289
  try {
245
- const result = await runWithAgentExecutionContext(
290
+ const rawResult = await runWithAgentExecutionContext(
246
291
  {
247
292
  rootRunId,
248
293
  spanId: state.rootSpanId ? String(state.rootSpanId) : undefined,
@@ -253,9 +298,11 @@ export class NativeSubAgentObserver {
253
298
  },
254
299
  () => this.runWithKnowledgeBaseAgentContext(employeeUsername, () => originalRun(observedTask)),
255
300
  );
301
+ const result = this.spillLargeResult(state, rawResult);
256
302
  await this.flushPending(state);
303
+ const capturedOutput = this.spanOutput(state, trimText(result, 20000));
257
304
  await this.spanService.finish(state.rootSpanId, 'success', state.rootStartedAt, {
258
- output: trimText(result, 20000),
305
+ ...(capturedOutput !== undefined ? { output: capturedOutput } : {}),
259
306
  metadata: {
260
307
  ...state.rootMetadata,
261
308
  completedAt: new Date().toISOString(),
@@ -270,8 +317,9 @@ export class NativeSubAgentObserver {
270
317
  return result;
271
318
  } catch (error) {
272
319
  await this.flushPending(state);
320
+ const capturedError = this.spanOutput(state, trimText(errorMessage(error), 10000));
273
321
  await this.spanService.finish(state.rootSpanId, 'error', state.rootStartedAt, {
274
- error: trimText(errorMessage(error), 10000),
322
+ ...(capturedError !== undefined ? { error: capturedError } : {}),
275
323
  metadata: {
276
324
  ...state.rootMetadata,
277
325
  failedAt: new Date().toISOString(),
@@ -296,6 +344,65 @@ export class NativeSubAgentObserver {
296
344
  }
297
345
  }
298
346
 
347
+ // Span payload gates: inputs are captured only under 'full' sharing, outputs under 'full' or
348
+ // 'feedback-only'. Redaction scrubs secret-looking keys on whatever is captured; free text is
349
+ // deliberately left alone.
350
+ private spanInput(state: RunState, input: Record<string, unknown>): Record<string, unknown> | undefined {
351
+ const observability = state.policy.observability;
352
+ if (observability.sharing !== 'full' || !observability.captureInputs) return undefined;
353
+ return observability.redactSecrets ? redactSecretsIn(input) : input;
354
+ }
355
+
356
+ private spanOutput(state: RunState, output: unknown): unknown | undefined {
357
+ const observability = state.policy.observability;
358
+ if (observability.sharing === 'disabled' || !observability.captureOutputs) return undefined;
359
+ return observability.redactSecrets ? redactSecretsIn(output) : output;
360
+ }
361
+
362
+ // Resolved settings are a raw profile record plus the harnessTag marker; the marker is not a
363
+ // schema field. On any compile trouble fall back to an empty (all-default) harness so the
364
+ // safety defaults — redaction on, sharing full — still govern the spans.
365
+ private compilePolicy(settings: Record<string, unknown>, parentRunHarness: CompiledHarness | null): CompiledHarness {
366
+ const tag =
367
+ typeof settings.harnessTag === 'string' && settings.harnessTag.trim() ? settings.harnessTag.trim() : 'default';
368
+ const { harnessTag: _harnessTag, ...rest } = settings;
369
+ try {
370
+ const layers: HarnessLayer[] = [];
371
+ if (parentRunHarness) {
372
+ // `sources` is a compiler artifact the strict schema rejects, so it is stripped before the
373
+ // compiled parent harness is re-used as a layer. Most-restrictive-wins then carries the
374
+ // parent's delegation caps, sharing mode and memory limits into the child.
375
+ const { sources, ...inherited } = parentRunHarness;
376
+ layers.push({ source: `run-role:${sources.join('+') || 'snapshot'}`, settings: inherited });
377
+ }
378
+ layers.push({ source: `profile:${tag}`, settings: rest });
379
+ return compileHarness(layers);
380
+ } catch (error) {
381
+ this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to compile observer harness policy', error);
382
+ return compileHarness([{ source: 'default', settings: {} }]);
383
+ }
384
+ }
385
+
386
+ // Oversized sub-agent results are stored on disk and replaced by a head/tail preview plus the
387
+ // file path, so the parent conversation can read the full text back with its file tools.
388
+ // Best effort: a spill failure keeps the original result inline.
389
+ private spillLargeResult(state: RunState, result: string): string {
390
+ const maxInlineBytes = state.policy.context.spill.maxInlineBytes;
391
+ if (!maxInlineBytes || typeof result !== 'string') return result;
392
+ try {
393
+ const spillDir = resolve(process.cwd(), 'storage', 'plugin-agent-orchestrator', 'spills');
394
+ mkdirSync(spillDir, { recursive: true });
395
+ const spillPath = resolve(spillDir, `${state.rootRunId}-${Date.now()}.txt`);
396
+ const replaced = spilledText(result, maxInlineBytes, spillPath);
397
+ if (!replaced) return result;
398
+ writeFileSync(spillPath, result, 'utf8');
399
+ return replaced;
400
+ } catch (error) {
401
+ this.plugin.app.logger?.warn?.('[AgentOrchestrator] Sub-agent result spill failed', error);
402
+ return result;
403
+ }
404
+ }
405
+
299
406
  private async safeBuildMemoryContext(options: {
300
407
  userId?: string | number;
301
408
  aiEmployeeUsername?: string;
@@ -309,10 +416,16 @@ export class NativeSubAgentObserver {
309
416
  }
310
417
  }
311
418
 
312
- private async safeCreateRootSpan(state: RunState, question: string) {
419
+ private async safeCreateRootSpan(
420
+ state: RunState,
421
+ question: string,
422
+ delegationInfo: { depth: number; parentSpanId?: string; agentLoopRunId?: number },
423
+ ) {
313
424
  const span = (await this.spanService.create({
314
425
  rootRunId: state.rootRunId,
315
- parentSpanId: undefined,
426
+ parentSpanId: delegationInfo.parentSpanId,
427
+ depth: delegationInfo.depth,
428
+ agentLoopRunId: delegationInfo.agentLoopRunId,
316
429
  source: NATIVE_SOURCE,
317
430
  parentSessionId: state.parentSessionId,
318
431
  subSessionId: state.subSessionId,
@@ -323,11 +436,11 @@ export class NativeSubAgentObserver {
323
436
  employeeUsername: state.employeeUsername,
324
437
  toolName: 'dispatch-sub-agent-task',
325
438
  title: `${state.leaderUsername || 'main'} -> ${state.employeeUsername || 'sub-agent'}`,
326
- input: {
439
+ input: this.spanInput(state, {
327
440
  question,
328
441
  parentSessionId: state.parentSessionId,
329
442
  subSessionId: state.subSessionId,
330
- },
443
+ }),
331
444
  metadata: state.rootMetadata,
332
445
  userId: state.userId,
333
446
  })) as SpanRecord | null;
@@ -369,6 +482,7 @@ export class NativeSubAgentObserver {
369
482
  }
370
483
 
371
484
  private async handleBeforeToolCall(state: RunState, chunk: Record<string, unknown>) {
485
+ if (state.policy.observability.sharing === 'disabled') return;
372
486
  const body = chunkBody(chunk);
373
487
  const toolCall = asObject(body.toolCall);
374
488
  const toolCallId = normalizeString(toolCall.id);
@@ -402,7 +516,7 @@ export class NativeSubAgentObserver {
402
516
  employeeUsername: normalizeString(conversation.username) || state.employeeUsername,
403
517
  toolName,
404
518
  title: toolName || 'tool call',
405
- input: asObject(toolCall.args),
519
+ input: this.spanInput(state, asObject(toolCall.args)),
406
520
  metadata: {
407
521
  source: NATIVE_SOURCE,
408
522
  currentConversation: conversation,
@@ -443,8 +557,8 @@ export class NativeSubAgentObserver {
443
557
  status,
444
558
  endedAt: new Date(),
445
559
  durationMs,
446
- output: forceError ? undefined : trimText(output, 20000),
447
- error: forceError ? trimText(errorMessage(error), 10000) : undefined,
560
+ output: forceError ? undefined : this.spanOutput(state, trimText(output, 20000)),
561
+ error: forceError ? this.spanOutput(state, trimText(errorMessage(error), 10000)) : undefined,
448
562
  skillExecutionId,
449
563
  metadata: {
450
564
  source: NATIVE_SOURCE,
@@ -483,24 +597,75 @@ export class NativeSubAgentObserver {
483
597
  return normalizeString(values.sessionId) || undefined;
484
598
  }
485
599
 
486
- private async resolveLeaderUsername(ctx: NativeSubAgentTask['ctx'], parentSessionId?: string) {
600
+ private leaderUsernameFor(ctx: NativeSubAgentTask['ctx'], parentConversation: unknown) {
487
601
  const values = ctx?.action?.params?.values || {};
488
602
  const direct =
489
603
  normalizeString(values.aiEmployeeUsername) ||
490
604
  normalizeString((asObject(values.aiEmployee) as Record<string, unknown>).username);
491
- if (direct) return direct;
492
- if (!parentSessionId) return undefined;
605
+ return direct || normalizeString(readValue(parentConversation, 'aiEmployeeUsername')) || undefined;
606
+ }
493
607
 
608
+ private async safeFindParentConversation(ctx: NativeSubAgentTask['ctx'], parentSessionId?: string) {
609
+ if (!parentSessionId) return null;
494
610
  try {
495
611
  const repo = ctx.db?.getRepository?.('aiConversations') as
496
612
  | { findOne?: (options: Record<string, unknown>) => Promise<unknown> }
497
613
  | undefined;
498
- const conversation = await repo?.findOne?.({
499
- filter: { sessionId: parentSessionId },
500
- });
501
- return normalizeString(readValue(conversation, 'aiEmployeeUsername')) || undefined;
614
+ const conversation = await repo?.findOne?.({ filter: { sessionId: parentSessionId } });
615
+ return conversation || null;
502
616
  } catch {
503
- return undefined;
617
+ return null;
618
+ }
619
+ }
620
+
621
+ private controlPlaneRunIdOf(conversation: unknown): number | undefined {
622
+ const runId = Number(asObject(readValue(conversation, 'options')).controlPlaneRunId);
623
+ return Number.isSafeInteger(runId) && runId > 0 ? runId : undefined;
624
+ }
625
+
626
+ private async safeResolveParentRunHarness(runId: number, parentUsername: string): Promise<CompiledHarness | null> {
627
+ if (!parentUsername) return null;
628
+ try {
629
+ return await resolveRunRoleHarness(this.plugin.db, runId, parentUsername);
630
+ } catch (error) {
631
+ this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve parent run harness for delegation', error);
632
+ return null;
633
+ }
634
+ }
635
+
636
+ // The parent's persisted span is the authoritative depth source: it was recorded when the
637
+ // parent itself was dispatched, so a resumed child arrives with its true depth even though its
638
+ // in-process context is fresh. The runtime context can only confirm or deepen the count, never
639
+ // lower it.
640
+ private async resolveDelegationContext(parentSessionId?: string): Promise<{ parentSpanId?: string; depth: number }> {
641
+ const candidates: Array<{ id?: string | number; depth?: unknown }> = [];
642
+ const context = getAgentExecutionContext();
643
+ if (context?.spanId) {
644
+ const span = await this.safeFindSpan({ filterByTk: context.spanId });
645
+ if (span) candidates.push(span);
646
+ }
647
+ if (parentSessionId) {
648
+ const span = await this.safeFindSpan({
649
+ filter: { subSessionId: parentSessionId, type: 'sub_agent' },
650
+ sort: ['-id'],
651
+ });
652
+ if (span) candidates.push(span);
653
+ }
654
+ const depth = candidates.reduce((deepest, span) => Math.max(deepest, Number(span.depth) || 0), 0);
655
+ const parentSpanId = candidates.find((span) => span.id !== undefined)?.id;
656
+ return { parentSpanId: parentSpanId === undefined ? undefined : String(parentSpanId), depth };
657
+ }
658
+
659
+ private async safeFindSpan(
660
+ options: Record<string, unknown>,
661
+ ): Promise<{ id?: string | number; depth?: unknown } | null> {
662
+ try {
663
+ const repo = this.plugin.db.getRepository('agentExecutionSpans');
664
+ if (!repo || typeof repo.findOne !== 'function') return null;
665
+ return ((await repo.findOne(options)) as { id?: string | number; depth?: unknown } | null) || null;
666
+ } catch (error) {
667
+ this.plugin.app.logger?.warn?.('[AgentOrchestrator] Failed to resolve delegation parent span', error);
668
+ return null;
504
669
  }
505
670
  }
506
671