@kodax-ai/kodax 0.7.77 → 0.7.78

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 (98) hide show
  1. package/CHANGELOG.md +176 -4
  2. package/README.md +200 -64
  3. package/README_CN.md +153 -49
  4. package/config-templates/config.example.jsonc +114 -32
  5. package/dist/chunks/agent-ASP4MS3X.js +2 -0
  6. package/dist/chunks/argument-completer-JYQ7FX3W.js +2 -0
  7. package/dist/chunks/{chunk-XSA37BVM.js → chunk-2CFHBKRE.js} +1 -1
  8. package/dist/chunks/chunk-35PPHOQ2.js +292 -0
  9. package/dist/chunks/chunk-43QNNDHR.js +29 -0
  10. package/dist/chunks/chunk-5BNQXXGY.js +1 -0
  11. package/dist/chunks/chunk-5GO6FH7L.js +458 -0
  12. package/dist/chunks/{chunk-FSXI4MAV.js → chunk-5NDCSFOP.js} +14 -14
  13. package/dist/chunks/{chunk-3DD4QEBH.js → chunk-6FOJVETH.js} +10 -10
  14. package/dist/chunks/chunk-6XM4B6K2.js +48 -0
  15. package/dist/chunks/chunk-6YZUE6NC.js +240 -0
  16. package/dist/chunks/{chunk-HORNWBYR.js → chunk-7OEBJGHK.js} +1 -1
  17. package/dist/chunks/{chunk-OAMKECRG.js → chunk-KQLQYHWU.js} +205 -200
  18. package/dist/chunks/{chunk-IQT4RPCE.js → chunk-NXO6GWSY.js} +2 -2
  19. package/dist/chunks/chunk-T2XZTLYE.js +316 -0
  20. package/dist/chunks/chunk-TQDBTTIM.js +348 -0
  21. package/dist/chunks/{chunk-FNW2XUL5.js → chunk-UID7BLAB.js} +1 -1
  22. package/dist/chunks/chunk-VAT2QYXM.js +765 -0
  23. package/dist/chunks/chunk-YAZQTC2L.js +5 -0
  24. package/dist/chunks/chunk-YVRYHC4C.js +655 -0
  25. package/dist/chunks/{chunk-EH7AOMJ7.js → chunk-Z3KFRTSB.js} +1 -1
  26. package/dist/chunks/compaction-config-BQSSIWK5.js +2 -0
  27. package/dist/chunks/{construction-bootstrap-RPRL3L7R.js → construction-bootstrap-VQLQGWPY.js} +1 -1
  28. package/dist/chunks/{dist-FDSOIR35.js → dist-BFT5YIGU.js} +1 -1
  29. package/dist/chunks/dist-PCFE24YP.js +2 -0
  30. package/dist/chunks/host-UTFXCYYM.js +2 -0
  31. package/dist/chunks/run-manager-PJU3WIFJ.js +2 -0
  32. package/dist/chunks/utils-SID4HW2Q.js +2 -0
  33. package/dist/index.d.ts +18 -17
  34. package/dist/index.js +6 -6
  35. package/dist/kodax_cli.js +1751 -1352
  36. package/dist/kodax_resume.js +17 -17
  37. package/dist/runtime-worker.js +1680 -1299
  38. package/dist/sandbox-workspace-session.js +563 -0
  39. package/dist/sdk-a2a.d.ts +16 -16
  40. package/dist/sdk-a2a.js +8 -8
  41. package/dist/sdk-agent.d.ts +275 -60
  42. package/dist/sdk-agent.js +1 -1
  43. package/dist/sdk-coding.d.ts +33 -165
  44. package/dist/sdk-coding.js +1 -1
  45. package/dist/sdk-experimental-memory.d.ts +2 -2
  46. package/dist/sdk-experimental-memory.js +1 -1
  47. package/dist/sdk-llm.d.ts +2 -1
  48. package/dist/sdk-llm.js +1 -1
  49. package/dist/sdk-mcp.js +1 -1
  50. package/dist/sdk-media.js +1 -1
  51. package/dist/sdk-repl.d.ts +67 -25
  52. package/dist/sdk-repl.js +2 -2
  53. package/dist/sdk-runtime.d.ts +194 -147
  54. package/dist/sdk-runtime.js +1 -1
  55. package/dist/sdk-sandbox.d.ts +93 -0
  56. package/dist/sdk-sandbox.js +2 -0
  57. package/dist/sdk-session.d.ts +6 -7
  58. package/dist/sdk-session.js +1 -1
  59. package/dist/sdk-skills.d.ts +2 -2
  60. package/dist/sdk-skills.js +1 -1
  61. package/dist/semantic-worker.js +15 -15
  62. package/dist/types-chunks/{bash-prefix-extractor.d-pZdu6qt7.d.ts → bash-prefix-extractor.d-uAe2Oqda.d.ts} +126 -8
  63. package/dist/types-chunks/{capsule.d-CxCm1KZz.d.ts → capsule.d-BlSv9l3V.d.ts} +1 -1
  64. package/dist/types-chunks/{guardrail.d-CJx9RRd3.d.ts → guardrail.d-BRE_ErEj.d.ts} +1 -1
  65. package/dist/types-chunks/{guardrail.d-B0PwAZVR.d.ts → guardrail.d-CXDYRgZ3.d.ts} +200 -34
  66. package/dist/types-chunks/{history-retrieval.d-B__aEN62.d.ts → history-retrieval.d-DtCy7x64.d.ts} +1 -1
  67. package/dist/types-chunks/{integration-config.d-ojG4swOP.d.ts → integration-config.d-BNowXE8k.d.ts} +23 -8
  68. package/dist/types-chunks/{public-api.d--fF88JrC.d.ts → public-api.d-B3AohsxN.d.ts} +36 -7
  69. package/dist/types-chunks/{commands.d-BccESAMV.d.ts → repl.d-Ie_ZXb_U.d.ts} +89 -78
  70. package/dist/types-chunks/{side-query.d-5JvXhuOZ.d.ts → resolver.d-iAQ9ocLB.d.ts} +3 -66
  71. package/dist/types-chunks/{run-manager.d-B47hIqnI.d.ts → run-manager.d-D1twIhF9.d.ts} +1 -1
  72. package/dist/types-chunks/{sdk-session-CLWf8Adb.d.ts → sdk-session-DB9KksIx.d.ts} +2 -2
  73. package/dist/types-chunks/side-query.d-DTuLPcC5.d.ts +77 -0
  74. package/dist/types-chunks/{types-LanCEDj8.d.ts → types-D3g6XUQr.d.ts} +41 -2
  75. package/dist/types-chunks/{types.d-RdWRfUEs.d.ts → types.d-BA-Jwpfs.d.ts} +459 -7
  76. package/dist/types-chunks/{types.d-CODuyyqy.d.ts → types.d-BH0ZkTGf.d.ts} +1 -1
  77. package/dist/types-chunks/{types.d-DCQVBqVn.d.ts → types.d-BbtGlKZu.d.ts} +25 -3
  78. package/dist/types-chunks/{types.d-DCsKM8aT.d.ts → types.d-DVDTIfB_.d.ts} +2 -2
  79. package/dist/types-chunks/{utils.d-CDduqbFw.d.ts → utils.d-CVp6bFl9.d.ts} +22 -6
  80. package/docs/SDK_EMBEDDER_GUIDE.md +399 -55
  81. package/package.json +8 -1
  82. package/dist/chunks/agent-NGSWFE73.js +0 -2
  83. package/dist/chunks/argument-completer-WGGZPEEO.js +0 -2
  84. package/dist/chunks/chunk-27QLRH3D.js +0 -5
  85. package/dist/chunks/chunk-2MQPVY6P.js +0 -770
  86. package/dist/chunks/chunk-6WAPVAGQ.js +0 -74
  87. package/dist/chunks/chunk-AOENDSVN.js +0 -448
  88. package/dist/chunks/chunk-HV2GMZUZ.js +0 -343
  89. package/dist/chunks/chunk-JS2BHGJP.js +0 -158
  90. package/dist/chunks/chunk-ON2WG2LG.js +0 -622
  91. package/dist/chunks/chunk-RUGAAHTF.js +0 -321
  92. package/dist/chunks/chunk-TGCG7U2W.js +0 -37
  93. package/dist/chunks/compaction-config-BE7VYWH6.js +0 -2
  94. package/dist/chunks/dist-ZZBNVTKU.js +0 -2
  95. package/dist/chunks/host-QAKQVC4A.js +0 -2
  96. package/dist/chunks/run-manager-N4UFWA2D.js +0 -2
  97. package/dist/chunks/utils-AUHCI4D5.js +0 -2
  98. package/dist/types-chunks/center-types.d-BBT122uJ.d.ts +0 -91
@@ -207,8 +207,7 @@ interface AgentMutationOptions {
207
207
  interface AgentTurnExecutor {
208
208
  execute(input: AgentExecutionInput): Promise<AgentExecutionResult>;
209
209
  }
210
- interface AgentActorSnapshot {
211
- readonly schemaVersion: 1;
210
+ interface AgentActorSnapshotContents {
212
211
  readonly revision: number;
213
212
  readonly maxConcurrentThreads: number;
214
213
  readonly actors: readonly AgentActor[];
@@ -220,8 +219,28 @@ interface AgentActorSnapshot {
220
219
  readonly pendingRootCompletionTurnIds?: readonly string[];
221
220
  readonly events: readonly AgentEvent[];
222
221
  }
222
+ /** Runtime process/controller identity that exclusively owns one durable Actor tree. */
223
+ interface AgentActorOwner {
224
+ readonly ownerId: string;
225
+ readonly runtimeId: string;
226
+ readonly pid: number;
227
+ readonly startedAt: string;
228
+ /** Opaque host identity for proving that this exact Runtime, not only its PID, remains alive. */
229
+ readonly livenessId?: string;
230
+ /** Loopback challenge endpoint paired with livenessId. */
231
+ readonly livenessPort?: number;
232
+ }
233
+ interface AgentActorSnapshotV1 extends AgentActorSnapshotContents {
234
+ readonly schemaVersion: 1;
235
+ }
236
+ interface AgentActorSnapshotV2 extends AgentActorSnapshotContents {
237
+ readonly schemaVersion: 2;
238
+ readonly owner?: AgentActorOwner;
239
+ }
240
+ type AgentActorSnapshot = AgentActorSnapshotV1 | AgentActorSnapshotV2;
223
241
  interface AgentActorStore {
224
242
  load(): Promise<AgentActorSnapshot | undefined>;
243
+ /** CAS save. Implementations must throw actor_snapshot_conflict on a revision mismatch. */
225
244
  save(snapshot: AgentActorSnapshot, expectedRevision: number): Promise<void>;
226
245
  }
227
246
  /** Runtime-bound actor control surface. The caller path is minted by Runtime. */
@@ -346,26 +365,47 @@ interface KodaXSessionClientNoticeEntry extends KodaXSessionEntryBase {
346
365
  interface KodaXMemoryOutcomeDigest {
347
366
  readonly id: string;
348
367
  readonly reviewKey: string;
368
+ /** Stable root-episode identity; absent on pre-F263 digests. */
369
+ readonly episodeId?: string;
349
370
  readonly sessionId: string;
350
371
  readonly branchId: string;
351
372
  readonly sequence: number;
352
373
  readonly objective: string;
353
374
  readonly actionSignature?: string;
354
375
  readonly approach: string;
355
- readonly outcome: 'succeeded' | 'failed';
376
+ /**
377
+ * `cancelled` is reserved for a host-bound explicit Memory intent. Ordinary
378
+ * cancelled episodes do not produce an outcome digest.
379
+ */
380
+ readonly outcome: 'succeeded' | 'failed' | 'cancelled';
356
381
  readonly summary: string;
357
382
  readonly preconditions?: string;
358
383
  readonly lesson?: string;
359
384
  readonly evidenceRefs: readonly string[];
360
385
  readonly evidence?: readonly KodaXMemoryOutcomeEvidence[];
386
+ /**
387
+ * Explicit durable intent captured from the Action LLM and bound by the
388
+ * host to an exact quote in the current user turn. It is evidence for the
389
+ * governed reviewer, never proof that Memory was queued or applied.
390
+ */
391
+ readonly memoryIntent?: KodaXMemoryIntent;
361
392
  readonly memoryInfluence?: readonly KodaXMemoryInfluenceRef[];
362
393
  readonly visibility: 'prompt_safe' | 'private' | 'sensitive';
363
394
  readonly createdAt: string;
364
395
  }
396
+ interface KodaXMemoryIntent {
397
+ readonly operation: 'remember' | 'correct';
398
+ readonly evidenceRef: string;
399
+ /** Sanitized model-derived claim proposed for governed review. */
400
+ readonly candidateStatement: string;
401
+ /** Sanitized representation of the exact current-user quote verified by the host. */
402
+ readonly userQuote: string;
403
+ }
365
404
  interface KodaXMemoryOutcomeEvidence {
366
405
  readonly ref: string;
367
406
  readonly grade: 'authoritative' | 'verified' | 'corroborated' | 'observed' | 'inferred';
368
407
  readonly source: 'user' | 'host' | 'tool' | 'environment' | 'agent';
408
+ readonly verdict?: 'passed' | 'failed' | 'inconclusive';
369
409
  readonly observedAt: string;
370
410
  }
371
411
  interface KodaXMemoryInfluenceRef {
@@ -375,9 +415,13 @@ interface KodaXMemoryInfluenceRef {
375
415
  interface KodaXSessionMemoryOutcomeDigestEntry extends KodaXSessionEntryBase {
376
416
  readonly type: 'memory_outcome_digest';
377
417
  readonly digest: KodaXMemoryOutcomeDigest;
418
+ /** Durable F263 review job identity. Absent on pre-F263 lineage records. */
419
+ readonly jobId?: string;
378
420
  }
379
421
  interface KodaXSessionMemoryReviewReceiptEntry extends KodaXSessionEntryBase {
380
422
  readonly type: 'memory_review_receipt';
423
+ /** Distinguishes repeated review keys across branch epochs. */
424
+ readonly jobId?: string;
381
425
  readonly reviewKey: string;
382
426
  readonly proposalIds: readonly string[];
383
427
  readonly status: 'completed' | 'no_action';
@@ -617,6 +661,14 @@ interface KodaXExtensionStore {
617
661
  interface KodaXSessionStorage {
618
662
  save(id: string, data: KodaXSessionData): Promise<void>;
619
663
  load(id: string): Promise<KodaXSessionData | null>;
664
+ /**
665
+ * Atomically mutates context-silent lineage state against the latest
666
+ * persisted session. Hosts that own session persistence may expose this
667
+ * without allowing the runner to write a stale full snapshot. Returns
668
+ * true when the session existed and the callback was evaluated, including
669
+ * an idempotent no-op; false only when the session was not found.
670
+ */
671
+ mutateLineage?(id: string, mutation: (lineage: KodaXSessionLineage) => KodaXSessionLineage): Promise<boolean>;
620
672
  getLineage?(id: string): Promise<KodaXSessionLineage | null>;
621
673
  /** Exact lineage merged from the active session file and island sidecars. */
622
674
  loadFullLineage?(id: string): Promise<KodaXSessionLineage | null>;
@@ -2794,6 +2846,8 @@ interface DiscoveryOptions {
2794
2846
  declare function discoverInstances(options?: DiscoveryOptions): DiscoveredInstance[];
2795
2847
 
2796
2848
  interface MemoryContextIdentity {
2849
+ /** Explicit owner home for durable runtime state; never persisted in review envelopes. */
2850
+ readonly configHome?: string;
2797
2851
  readonly tenantId: string;
2798
2852
  readonly workspaceId?: string;
2799
2853
  readonly userId?: string;
@@ -2892,6 +2946,7 @@ interface MemoryApproval {
2892
2946
  readonly expectedFingerprints: Readonly<Record<string, string>>;
2893
2947
  readonly policyId?: string;
2894
2948
  readonly policyReason?: string;
2949
+ readonly revalidateAuthority?: () => Promise<void>;
2895
2950
  }
2896
2951
  interface MemoryApplyResult {
2897
2952
  readonly proposalId: string;
@@ -3068,7 +3123,15 @@ interface MemoryController {
3068
3123
  maybeRunAutoCurator(input?: MemoryAutoCuratorInput): Promise<MemoryAutoCuratorResult>;
3069
3124
  buildMemoryPack(input: MemoryPackInput): Promise<MemoryPack>;
3070
3125
  reviewMemoryFeedback(input: MemoryReviewInput): Promise<MemoryReviewPlan>;
3126
+ prepareEpisodeReview?(digest: KodaXMemoryOutcomeDigest): Promise<MemoryReviewModelInput>;
3127
+ applyReviewedEpisode?(plan: MemoryReviewPlan, digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal, revalidateAuthority?: () => Promise<void>): Promise<MemoryEpisodeReviewResult>;
3071
3128
  persistReviewPlan(plan: MemoryReviewPlan): Promise<readonly string[]>;
3129
+ /**
3130
+ * Resolves which episode-review proposals were actually auto-applied by the
3131
+ * governed host policy. Used to keep durable receipts complete while user
3132
+ * notices remain truthful.
3133
+ */
3134
+ listHostAppliedEpisodeProposalIds?(proposalIds: readonly string[]): Promise<readonly string[]>;
3072
3135
  reviewEpisode(digest: KodaXMemoryOutcomeDigest, signal?: AbortSignal): Promise<MemoryEpisodeReviewResult>;
3073
3136
  archiveRef(id: string): Promise<MemoryLifecycleOperationResult>;
3074
3137
  forgetRef(id: string): Promise<MemoryLifecycleOperationResult>;
@@ -3095,6 +3158,395 @@ type MemoryEvent = {
3095
3158
  readonly actionCount: number;
3096
3159
  };
3097
3160
 
3161
+ type LearnedCapabilityCarrier = 'skill' | 'extension' | 'workflow_handoff';
3162
+ type LearnedCapabilityLifecycle = 'opportunity' | 'drafting' | 'ready' | 'testing' | 'active_learned' | 'promoted_user' | 'quarantined' | 'archived' | 'rejected';
3163
+ type LearningEventKind = 'opportunity' | 'drafting' | 'ready' | 'testing' | 'activated' | 'promoted' | 'attention' | 'archived' | 'rejected';
3164
+ type LearningAction = 'review' | 'trust' | 'reject' | 'disable' | 'rollback' | 'archive' | 'restore' | 'promote';
3165
+ interface LearnedCapabilitySource {
3166
+ readonly kind: 'learning_controller' | 'f224_proposal' | 'skill_learning_loop' | 'legacy_manual';
3167
+ readonly proposalId?: string;
3168
+ }
3169
+ interface LearnedCapabilityRecordBase {
3170
+ readonly capabilityId: string;
3171
+ readonly displayName: string;
3172
+ readonly slug: string;
3173
+ readonly carrier: LearnedCapabilityCarrier;
3174
+ readonly lifecycle: LearnedCapabilityLifecycle;
3175
+ readonly revision: number;
3176
+ readonly createdAt: string;
3177
+ readonly updatedAt: string;
3178
+ readonly source: LearnedCapabilitySource;
3179
+ /** The control action that produced this revision, when it is not implied by lifecycle. */
3180
+ readonly lastAction?: LearningAction;
3181
+ readonly artifactPath?: string;
3182
+ readonly previousGoodRevision?: number;
3183
+ readonly previousLifecycle?: LearnedCapabilityLifecycle;
3184
+ readonly diagnostics?: readonly string[];
3185
+ }
3186
+ interface LearnedCapabilityRecordV1 extends LearnedCapabilityRecordBase {
3187
+ readonly schemaVersion: 1;
3188
+ }
3189
+ interface LearnedCapabilityScope {
3190
+ readonly configHomeHash: string;
3191
+ readonly tenantHash: string;
3192
+ readonly projectHash: string;
3193
+ }
3194
+ interface LearnedCapabilityArtifact {
3195
+ readonly kind: 'skill_markdown';
3196
+ readonly relativePath: string;
3197
+ readonly fingerprint: string;
3198
+ readonly contentRevision: number;
3199
+ }
3200
+ interface LearnedCapabilityProvenance {
3201
+ readonly jobId: string;
3202
+ readonly inputHash: string;
3203
+ readonly decisionId: string;
3204
+ readonly actionId: string;
3205
+ }
3206
+ interface LearnedCapabilityCanaryBinding {
3207
+ readonly bindingId: string;
3208
+ readonly ownerSessionRef: string;
3209
+ readonly expiresAt: string;
3210
+ }
3211
+ interface LearnedCapabilityCanaryInvocation {
3212
+ readonly invocationId: string;
3213
+ readonly bindingId: string;
3214
+ /** Durable usage-ledger identity for recovery after the binding expires. */
3215
+ readonly usageSessionHash?: string;
3216
+ readonly artifactRevision?: number;
3217
+ readonly artifactFingerprint?: string;
3218
+ readonly status: 'pending' | 'verified_success' | 'credible_negative' | 'inconclusive';
3219
+ readonly evidenceRefs: readonly string[];
3220
+ readonly invokedAt: string;
3221
+ readonly completedAt?: string;
3222
+ }
3223
+ interface LearnedCapabilityCanary {
3224
+ readonly maxInvocations: 3;
3225
+ readonly invocationCount: number;
3226
+ readonly verifiedSuccesses: number;
3227
+ readonly credibleNegatives: number;
3228
+ readonly binding?: LearnedCapabilityCanaryBinding;
3229
+ readonly invocations: readonly LearnedCapabilityCanaryInvocation[];
3230
+ }
3231
+ interface LearnedCapabilityRecordV2 extends LearnedCapabilityRecordBase {
3232
+ readonly schemaVersion: 2;
3233
+ readonly carrier: 'skill';
3234
+ readonly scope: LearnedCapabilityScope;
3235
+ readonly artifact: LearnedCapabilityArtifact;
3236
+ readonly previousGoodArtifact?: LearnedCapabilityArtifact;
3237
+ readonly provenance: LearnedCapabilityProvenance;
3238
+ readonly canary: LearnedCapabilityCanary;
3239
+ }
3240
+ type LearnedCapabilityRecord = LearnedCapabilityRecordV1 | LearnedCapabilityRecordV2;
3241
+ interface LearningEvent {
3242
+ readonly schemaVersion: 1;
3243
+ readonly sequence: number;
3244
+ readonly eventId: string;
3245
+ readonly capabilityId: string;
3246
+ readonly capabilityRevision: number;
3247
+ readonly kind: LearningEventKind;
3248
+ readonly lifecycle: LearnedCapabilityLifecycle;
3249
+ readonly displayName: string;
3250
+ readonly slug: string;
3251
+ readonly carrier: LearnedCapabilityCarrier;
3252
+ readonly createdAt: string;
3253
+ }
3254
+ type LearningNotificationState = 'unread' | 'seen' | 'acknowledged' | 'snoozed';
3255
+ interface LearningClientEventState {
3256
+ readonly state: LearningNotificationState;
3257
+ readonly capabilityRevision: number;
3258
+ readonly updatedAt: string;
3259
+ readonly snoozedUntil?: string;
3260
+ }
3261
+ interface LearningClientRecord {
3262
+ readonly schemaVersion: 1;
3263
+ readonly clientIdentity: string;
3264
+ readonly events: Readonly<Record<string, LearningClientEventState>>;
3265
+ }
3266
+ interface LearningSurfaceSnapshot {
3267
+ readonly ready: number;
3268
+ readonly newlyActive: number;
3269
+ readonly attention: number;
3270
+ readonly active: number;
3271
+ readonly revision: number;
3272
+ }
3273
+ interface LearningQuery {
3274
+ readonly search?: string;
3275
+ readonly carrier?: LearnedCapabilityCarrier;
3276
+ readonly lifecycle?: LearnedCapabilityLifecycle;
3277
+ readonly limit?: number;
3278
+ readonly cursor?: string;
3279
+ }
3280
+ interface LearningPage {
3281
+ readonly items: readonly LearnedCapabilityRecord[];
3282
+ readonly nextCursor?: string;
3283
+ readonly revision: number;
3284
+ }
3285
+ interface LearningSubscribeOptions {
3286
+ readonly afterRevision?: number;
3287
+ }
3288
+ interface LearningExplicitUserAuthority {
3289
+ readonly authority: 'explicit_user';
3290
+ readonly expectedRevision: number;
3291
+ readonly expectedFingerprint?: string;
3292
+ }
3293
+ interface LearningActionDriver {
3294
+ readonly carrier: LearnedCapabilityCarrier;
3295
+ readonly actions: readonly LearningAction[];
3296
+ execute(action: LearningAction, capability: LearnedCapabilityRecord): Promise<LearnedCapabilityRecord>;
3297
+ }
3298
+ type LearningCapabilityErrorCode = 'ambiguous_name' | 'action_failed' | 'capability_not_found' | 'invalid_record' | 'invalid_transition' | 'store_integrity_error' | 'unsupported_action';
3299
+ declare class LearningCapabilityError extends Error {
3300
+ readonly code: LearningCapabilityErrorCode;
3301
+ constructor(code: LearningCapabilityErrorCode, message: string);
3302
+ }
3303
+ declare function canTransitionLearnedCapability(from: LearnedCapabilityLifecycle, to: LearnedCapabilityLifecycle): boolean;
3304
+ declare function assertLearnedCapabilityTransition(from: LearnedCapabilityLifecycle, to: LearnedCapabilityLifecycle): void;
3305
+ declare function slugifyLearnedCapabilityName(displayName: string): string;
3306
+ declare function learningEventKindForLifecycle(lifecycle: LearnedCapabilityLifecycle): LearningEventKind;
3307
+ declare function learningEventIdFor(record: LearnedCapabilityRecord): string;
3308
+
3309
+ interface LearnedAreaPaths {
3310
+ readonly root: string;
3311
+ readonly skills: string;
3312
+ readonly extensions: string;
3313
+ readonly capabilities: string;
3314
+ readonly events: string;
3315
+ readonly clients: string;
3316
+ }
3317
+ declare function resolveLearnedAreaPaths(rootDir: string): LearnedAreaPaths;
3318
+ declare class LearnedAreaStore {
3319
+ #private;
3320
+ readonly paths: LearnedAreaPaths;
3321
+ constructor(rootDir: string);
3322
+ initialize(): Promise<void>;
3323
+ readCapability(capabilityId: string): Promise<LearnedCapabilityRecord | undefined>;
3324
+ listCapabilities(): Promise<readonly LearnedCapabilityRecord[]>;
3325
+ writeCapability(record: LearnedCapabilityRecord): Promise<void>;
3326
+ writeEvent(event: LearningEvent): Promise<void>;
3327
+ listEvents(): Promise<readonly LearningEvent[]>;
3328
+ readClient(identity: string): Promise<LearningClientRecord>;
3329
+ writeClient(record: LearningClientRecord): Promise<void>;
3330
+ withOwnerMutation<T>(operation: () => Promise<T>): Promise<T>;
3331
+ withClientMutation<T>(identity: string, operation: () => Promise<T>): Promise<T>;
3332
+ ensureCurrentEvent(record: LearnedCapabilityRecord): Promise<LearningEvent>;
3333
+ }
3334
+ declare function eventFromCapability(record: LearnedCapabilityRecord, sequence: number): LearningEvent;
3335
+
3336
+ interface DeclarativeSkillSpec {
3337
+ readonly name: string;
3338
+ readonly description: string;
3339
+ readonly purpose: string;
3340
+ readonly triggers: readonly string[];
3341
+ readonly steps: readonly string[];
3342
+ readonly verification: readonly string[];
3343
+ readonly pitfalls: readonly string[];
3344
+ }
3345
+ interface StagedLearnedSkillArtifact extends LearnedCapabilityArtifact {
3346
+ readonly absolutePath: string;
3347
+ }
3348
+ interface CreateLearnedSkillRecordInput {
3349
+ readonly capabilityId: string;
3350
+ readonly displayName: string;
3351
+ readonly scope: LearnedCapabilityScope;
3352
+ readonly artifact: LearnedCapabilityArtifact;
3353
+ readonly provenance: LearnedCapabilityProvenance;
3354
+ readonly now?: string;
3355
+ readonly previous?: LearnedCapabilityRecordV2;
3356
+ }
3357
+ interface LearnedSkillBindingAdmission {
3358
+ readonly bindingId: string;
3359
+ readonly ownerSessionRef: string;
3360
+ readonly expiresAt: string;
3361
+ }
3362
+ interface LearnedSkillInvocationAdmission {
3363
+ readonly invocationId: string;
3364
+ readonly invocationCount: number;
3365
+ readonly maxInvocations: 3;
3366
+ }
3367
+ interface CommitLearnedSkillRevisionInput {
3368
+ readonly scope: LearnedCapabilityScope;
3369
+ readonly spec: DeclarativeSkillSpec;
3370
+ readonly disposition: 'ready' | 'project_canary';
3371
+ readonly operation: 'create' | 'patch';
3372
+ readonly provenance: LearnedCapabilityProvenance;
3373
+ readonly targetCapabilityId?: string;
3374
+ readonly expectedRevision?: number;
3375
+ readonly expectedFingerprint?: string;
3376
+ readonly protectedSkillNames?: readonly string[];
3377
+ readonly now?: string;
3378
+ readonly authority?: {
3379
+ readonly commit: (operation: (revalidateAuthority: () => Promise<void>) => Promise<LearnedCapabilityRecordV2>) => Promise<LearnedCapabilityRecordV2>;
3380
+ };
3381
+ }
3382
+ type LearnedSkillCanaryOutcome = 'verified_success' | 'credible_negative' | 'inconclusive';
3383
+ declare function resolveProjectLearnedAreaRoot(configHome: string, scope: {
3384
+ readonly tenantId: string;
3385
+ readonly projectId: string;
3386
+ }): string;
3387
+ declare function createLearnedCapabilityScope(configHome: string, scope: {
3388
+ readonly tenantId: string;
3389
+ readonly projectId: string;
3390
+ }): LearnedCapabilityScope;
3391
+ declare function validateDeclarativeSkillSpec(spec: DeclarativeSkillSpec): void;
3392
+ declare function renderDeclarativeSkill(spec: DeclarativeSkillSpec): string;
3393
+ declare function stageLearnedSkillRevision(rootDir: string, capabilityId: string, spec: DeclarativeSkillSpec): Promise<StagedLearnedSkillArtifact>;
3394
+ declare function createLearnedSkillRecord(input: CreateLearnedSkillRecordInput): LearnedCapabilityRecordV2;
3395
+ declare function commitLearnedSkillRevision(store: LearnedAreaStore, input: CommitLearnedSkillRevisionInput): Promise<LearnedCapabilityRecordV2>;
3396
+ declare function admitLearnedSkillBinding(store: LearnedAreaStore, capabilityId: string, input: {
3397
+ readonly bindingId: string;
3398
+ readonly ownerSessionRef: string;
3399
+ readonly now?: Date;
3400
+ readonly ttlMs?: number;
3401
+ }): Promise<LearnedSkillBindingAdmission | undefined>;
3402
+ declare function releaseLearnedSkillBinding(store: LearnedAreaStore, capabilityId: string, bindingId: string, now?: string): Promise<boolean>;
3403
+ declare function invokeLearnedSkillCanary(store: LearnedAreaStore, capabilityId: string, input: {
3404
+ readonly bindingId: string;
3405
+ readonly invocationId?: string;
3406
+ readonly usageSessionHash?: string;
3407
+ readonly artifactRevision?: number;
3408
+ readonly artifactFingerprint?: string;
3409
+ readonly now?: Date;
3410
+ }): Promise<LearnedSkillInvocationAdmission>;
3411
+ declare function completeLearnedSkillOutcome(store: LearnedAreaStore, capabilityId: string, input: {
3412
+ readonly invocationId: string;
3413
+ readonly outcome: LearnedSkillCanaryOutcome;
3414
+ readonly evidenceRefs: readonly string[];
3415
+ readonly now?: string;
3416
+ }): Promise<LearnedCapabilityRecordV2>;
3417
+ declare function quarantineLearnedSkillRevision(store: LearnedAreaStore, capabilityId: string, input: {
3418
+ readonly expectedRevision: number;
3419
+ readonly expectedFingerprint: string;
3420
+ readonly reason: string;
3421
+ readonly now?: string;
3422
+ readonly revalidateAuthority?: () => Promise<void>;
3423
+ }): Promise<LearnedCapabilityRecordV2>;
3424
+ declare function isLearnedCapabilityRecordV2(record: LearnedCapabilityRecord): record is LearnedCapabilityRecordV2;
3425
+
3426
+ interface LearnedSkillOfferedReceipt {
3427
+ readonly version: 1;
3428
+ readonly kind: 'offered';
3429
+ readonly receiptId: string;
3430
+ readonly sessionHash: string;
3431
+ readonly bindingId: string;
3432
+ readonly capabilityId: string;
3433
+ readonly revision: number;
3434
+ readonly fingerprint: string;
3435
+ readonly createdAt: string;
3436
+ }
3437
+ interface LearnedSkillInvokedReceipt {
3438
+ readonly version: 1;
3439
+ readonly kind: 'invoked';
3440
+ readonly receiptId: string;
3441
+ readonly sessionHash: string;
3442
+ readonly bindingId: string;
3443
+ readonly invocationId: string;
3444
+ readonly capabilityId: string;
3445
+ readonly revision: number;
3446
+ readonly fingerprint: string;
3447
+ readonly createdAt: string;
3448
+ }
3449
+ interface LearnedSkillOutcomeReceipt {
3450
+ readonly version: 1;
3451
+ readonly kind: 'outcome';
3452
+ readonly receiptId: string;
3453
+ readonly sessionHash: string;
3454
+ readonly invocationId: string;
3455
+ readonly capabilityId: string;
3456
+ readonly outcome: LearnedSkillCanaryOutcome;
3457
+ readonly evidenceRefs: readonly string[];
3458
+ readonly createdAt: string;
3459
+ }
3460
+ type LearnedSkillUsageReceipt = LearnedSkillOfferedReceipt | LearnedSkillInvokedReceipt | LearnedSkillOutcomeReceipt;
3461
+ interface ExactInvokedSkillSnapshot {
3462
+ readonly capabilityId: string;
3463
+ readonly name: string;
3464
+ readonly fingerprint: string;
3465
+ readonly revision: number;
3466
+ readonly invocationId: string;
3467
+ readonly content: string;
3468
+ }
3469
+ declare function recordLearnedSkillOffered(store: LearnedAreaStore, input: {
3470
+ readonly sessionId: string;
3471
+ readonly bindingId: string;
3472
+ readonly capabilityId: string;
3473
+ readonly revision: number;
3474
+ readonly fingerprint: string;
3475
+ readonly now?: string;
3476
+ }): Promise<LearnedSkillOfferedReceipt>;
3477
+ declare function admitAndRecordLearnedSkillInvocation(store: LearnedAreaStore, input: {
3478
+ readonly sessionId: string;
3479
+ readonly bindingId: string;
3480
+ readonly ownerSessionRef: string;
3481
+ readonly capabilityId: string;
3482
+ readonly expectedRevision: number;
3483
+ readonly expectedFingerprint: string;
3484
+ readonly invocationId?: string;
3485
+ readonly now?: Date;
3486
+ }): Promise<LearnedSkillInvokedReceipt>;
3487
+ declare function completeLearnedSkillSessionOutcomes(store: LearnedAreaStore, input: {
3488
+ readonly sessionId: string;
3489
+ /** Restricts completion to invocations from one root-run binding. */
3490
+ readonly bindingId?: string;
3491
+ readonly outcome: LearnedSkillCanaryOutcome;
3492
+ readonly evidenceRefs: readonly string[];
3493
+ readonly now?: string;
3494
+ }): Promise<readonly LearnedSkillOutcomeReceipt[]>;
3495
+ /** Repairs current-binding and stale-canary outcome delivery fail closed. */
3496
+ declare function reconcileLearnedSkillBindingOutcomes(store: LearnedAreaStore, input: {
3497
+ readonly sessionId: string;
3498
+ readonly bindingId: string;
3499
+ readonly now?: string;
3500
+ }): Promise<readonly LearnedSkillOutcomeReceipt[]>;
3501
+ declare function listLearnedSkillUsageReceipts(store: LearnedAreaStore, sessionId: string): Promise<readonly LearnedSkillUsageReceipt[]>;
3502
+ declare function exactInvokedSkillSnapshotForSession(store: LearnedAreaStore, sessionId: string, options?: {
3503
+ readonly bindingId?: string;
3504
+ }): Promise<ExactInvokedSkillSnapshot | null>;
3505
+
3506
+ interface LearningReviewVerifierFact {
3507
+ readonly ref: string;
3508
+ readonly verdict: 'passed' | 'failed' | 'inconclusive';
3509
+ }
3510
+
3511
+ interface LearningReviewQualification {
3512
+ readonly reusableMethodEvidence: boolean;
3513
+ readonly explicitSkillPreservation: boolean;
3514
+ readonly independentEpisodeCount: number;
3515
+ readonly verifiedOutcome: boolean;
3516
+ readonly exactSkillInvoked: boolean;
3517
+ }
3518
+ interface LearningReviewEvidencePacket {
3519
+ readonly outcomeDigest: KodaXMemoryOutcomeDigest;
3520
+ readonly exactInvokedSkill: ExactInvokedSkillSnapshot | null;
3521
+ readonly verifierFacts: readonly LearningReviewVerifierFact[];
3522
+ readonly priorDigests: readonly KodaXMemoryOutcomeDigest[];
3523
+ readonly qualification: LearningReviewQualification;
3524
+ }
3525
+ interface UnifiedLearningReviewModelInput {
3526
+ readonly cacheDomain: 'learning-review';
3527
+ readonly memory: MemoryReviewModelInput;
3528
+ readonly evidence: LearningReviewEvidencePacket;
3529
+ }
3530
+ type LearnedSkillDecisionDisposition = 'discard' | 'ready' | 'project_canary';
3531
+ interface NormalizedLearnedSkillDecision {
3532
+ readonly disposition: LearnedSkillDecisionDisposition;
3533
+ readonly reasonCodes: readonly string[];
3534
+ readonly operation?: 'create' | 'patch';
3535
+ readonly spec?: DeclarativeSkillSpec;
3536
+ readonly targetCapabilityId?: string;
3537
+ readonly expectedFingerprint?: string;
3538
+ readonly expectedRevision?: number;
3539
+ readonly quarantineExactInvokedRevision?: true;
3540
+ }
3541
+ interface UnifiedLearningReviewResult {
3542
+ readonly memoryPlan: MemoryReviewPlan;
3543
+ readonly capabilityDecision?: NormalizedLearnedSkillDecision;
3544
+ }
3545
+ type UnifiedLearningReviewRunner = (input: UnifiedLearningReviewModelInput, signal?: AbortSignal) => Promise<unknown>;
3546
+ declare function sanitizeUnifiedLearningReviewInput(input: UnifiedLearningReviewModelInput): UnifiedLearningReviewModelInput;
3547
+ declare function isUnifiedLearningReviewModelInput(value: unknown): value is UnifiedLearningReviewModelInput;
3548
+ declare function normalizeUnifiedLearningReview(input: UnifiedLearningReviewModelInput, raw: unknown): UnifiedLearningReviewResult;
3549
+
3098
3550
  /**
3099
3551
  * ../../index.js Compaction Types
3100
3552
  */
@@ -4007,7 +4459,7 @@ interface AgentExecutorPreflightResult {
4007
4459
  }
4008
4460
  interface AgentExecutor {
4009
4461
  preflight?(input: AgentTaskStartInput): Promise<AgentExecutorPreflightResult>;
4010
- start(input: AgentTaskStartInput): Promise<AgentExecutorTaskReference>;
4462
+ start(input: AgentTaskStartInput, signal?: AbortSignal): Promise<AgentExecutorTaskReference>;
4011
4463
  events(reference: AgentExecutorTaskReference): AsyncIterable<AgentExecutorEvent>;
4012
4464
  get(reference: AgentExecutorTaskReference): Promise<AgentExecutorTaskSnapshot>;
4013
4465
  sendInput(reference: AgentExecutorTaskReference, input: AgentContinuationInput): Promise<void>;
@@ -4095,7 +4547,7 @@ interface AgentRegistrationService {
4095
4547
  remove(agentId: string, options?: AgentRegistrationMutationOptions): Promise<boolean>;
4096
4548
  }
4097
4549
  interface AgentTaskService {
4098
- start(input: AgentTaskStartInput): Promise<AgentTaskSnapshot>;
4550
+ start(input: AgentTaskStartInput, signal?: AbortSignal): Promise<AgentTaskSnapshot>;
4099
4551
  list(filter?: AgentTaskFilter): Promise<readonly AgentTaskSnapshot[]>;
4100
4552
  get(taskId: string): Promise<AgentTaskSnapshot>;
4101
4553
  events(taskId: string, cursor?: number): Promise<readonly AgentTaskEvent[]>;
@@ -4140,5 +4592,5 @@ interface CreateAgentExecutorPlaneOptions {
4140
4592
  readonly closeTimeoutMs?: number;
4141
4593
  }
4142
4594
 
4143
- export { ASK_USER_BACK_SIGNAL as A, ASK_USER_CUSTOM_INPUT_SIGNAL as a, DEFAULT_SYSTEM_CAP as aW, InvariantSession as bj, MAX_TOOL_LOOP_ITERATIONS as c7, Runner as d1, Tracer as dF, WorkflowEventRecorder as dQ, SpanImpl as dn, readRunnerRecoveryTranscript as e$, asSingleSelection as eA, attachRunnerRecoveryTranscript as eB, buildAssistantMessageFromLlmResult as eC, buildSystemPrompt as eD, buildToolResultMessage as eE, createAgent as eF, createHandoff as eG, createInMemorySession as eH, createInvariantSessionForAgent as eI, createStateWriter as eJ, createTrace as eK, createWorkflowProcessTracker as eL, defaultTracer as eM, detectInstructionsInjection as eN, discoverInstances as eO, executeRunnerToolCall as eP, extractAssistantTextFromMessage as eQ, getActiveUserInteraction as eR, getAdmittedAgentBindings as eS, hashMemoryIdentityComponent as eT, isAskUserCustomInputAnswer as eU, isFinalWorkflowProcessStatus as eV, isRunnableTool as eW, isRunnerLlmResult as eX, matchesMemoryApplicability as eY, memoryApplicabilityFingerprint as eZ, normalizeHostMetadata as e_, _resetAdmittedAgentBindings as ey, _resetPresetDispatchers as ez, registerPresetDispatcher as f0, runAdmissionAudit as f1, setActiveUserInteraction as f2, setAdmittedAgentBindings as f3 };
4144
- export type { AgentFollowupResult as $, AgentDetail as B, AgentDispatchContext as C, AgentDispatchPolicy as D, AgentDispatchPolicyDecision as E, AgentDispatchPolicyInput as F, AgentDispatchabilitySnapshot as G, AgentDispatchabilityStatus as H, AgentEffectDeclaration as I, AgentEvent as J, AgentEventKind as K, AgentExecutionInput as L, AgentExecutionKind as M, AgentExecutionResult as N, AgentExecutor as O, AgentExecutorEvent as P, AgentExecutorFactory as Q, AgentExecutorFactoryContext as R, AgentExecutorPlane as S, AgentExecutorPlaneBackgroundErrorContext as T, AgentExecutorPlaneBackgroundErrorHandler as U, AgentExecutorPlaneBinding as V, AgentExecutorPlaneStore as W, AgentExecutorPreflightResult as X, AgentExecutorProtocol as Y, AgentExecutorTaskReference as Z, AgentExecutorTaskSnapshot as _, DispatchableAgentListing as a$, AgentForkTurns as a0, AgentInterruptScope as a1, AgentJsonObject as a2, AgentJsonValue as a3, AgentLimitReached as a4, AgentListEntry as a5, AgentMailboxMessage as a6, AgentManifest as a7, AgentMessage as a8, AgentMetadataValue as a9, AgentTreeSnapshot as aA, AgentTurn as aB, AgentTurnExecutor as aC, AgentTurnRef as aD, AgentTurnState as aE, AgentTurnSummary as aF, AskUserAnswer as aG, AskUserCustomInputAnswer as aH, AskUserMultiOptions as aI, AskUserQuestionItem as aJ, AskUserQuestionOptions as aK, AskUserSelectionAnswer as aL, CapabilitySupport as aM, CompactionAnchor as aN, CompactionConfig as aO, CompactionDetails as aP, CompactionReport as aQ, CompactionResult as aR, CompactionSpanData as aS, CompactionUpdate as aT, CreateAgentExecutorPlaneOptions as aU, CurrentTodoSummary as aV, Deliverable as aX, DiscoveredInstance as aY, DiscoveryOptions as aZ, DispatchableAgentDescriptor as a_, AgentMiddlewareDeclaration as aa, AgentMutationOptions as ab, AgentOutput as ac, AgentPreflightInput as ad, AgentPreflightResult as ae, AgentProgressItem as af, AgentProgressKind as ag, AgentProgressUpdate as ah, AgentReasoningProfile as ai, AgentRegistrationEnabledMutationOptions as aj, AgentRegistrationMutationOptions as ak, AgentRegistrationService as al, AgentSpanData as am, AgentSpawnInput as an, AgentTaskCancellation as ao, AgentTaskCorrelation as ap, AgentTaskEvent as aq, AgentTaskFilter as ar, AgentTaskProgress as as, AgentTaskRegistrationSnapshot as at, AgentTaskService as au, AgentTaskSnapshot as av, AgentTaskStartInput as aw, AgentTaskState as ax, AgentTaskUsage as ay, AgentTool as az, AdmissionAuditOptions as b, KodaXSessionUiToolCall as b$, DispatchableAgentOrigin as b0, DispatchableAgentQuery as b1, EvidenceSpanData as b2, ExternalAgentEffectDeclaration as b3, ExternalAgentHealth as b4, ExternalAgentProtocol as b5, ExternalAgentRegistration as b6, ExternalAgentRegistrationSummary as b7, FanoutSpanData as b8, FileOperations as b9, KodaXMemoryOutcomeDigest as bA, KodaXMemoryOutcomeEvidence as bB, KodaXSessionArchiveMarkerEntry as bC, KodaXSessionArtifactLedgerEntry as bD, KodaXSessionBranchSummaryEntry as bE, KodaXSessionClientNoticeEntry as bF, KodaXSessionCompactionEntry as bG, KodaXSessionData as bH, KodaXSessionEntry as bI, KodaXSessionEntryBase as bJ, KodaXSessionGoalEntry as bK, KodaXSessionLabelEntry as bL, KodaXSessionLineage as bM, KodaXSessionMemoryOutcomeDigestEntry as bN, KodaXSessionMemoryReviewReceiptEntry as bO, KodaXSessionMessageEntry as bP, KodaXSessionMeta as bQ, KodaXSessionNavigationOptions as bR, KodaXSessionRewindMarkerEntry as bS, KodaXSessionRuntimeInfo as bT, KodaXSessionScope as bU, KodaXSessionStorage as bV, KodaXSessionTreeNode as bW, KodaXSessionUiHistoryItem as bX, KodaXSessionUiHistoryItemType as bY, KodaXSessionUiTextHistoryItem as bZ, KodaXSessionUiTextHistoryItemType as b_, GenerationSpanData as ba, Guardrail as bb, GuardrailSpanData as bc, Handoff as bd, HandoffSpanData as be, InMemorySessionOptions as bf, InstanceDiscoveryFs as bg, InvariantId as bh, InvariantResult as bi, KodaXCompactMemoryProgress as bk, KodaXCompactMemorySeed as bl, KodaXExtensionSessionRecord as bm, KodaXExtensionSessionState as bn, KodaXExtensionStore as bo, KodaXExtensionStoreEntry as bp, KodaXFileInputArtifact as bq, KodaXGoalEventType as br, KodaXGoalState as bs, KodaXGoalStatus as bt, KodaXImageInputArtifact as bu, KodaXImageMediaType as bv, KodaXInputArtifact as bw, KodaXInputArtifactSource as bx, KodaXJsonValue as by, KodaXMemoryInfluenceRef as bz, AdmissionCtx as c, RunResult as c$, KodaXSessionUiToolCallStatus as c0, KodaXSessionUiToolGroupHistoryItem as c1, KodaXSessionWorkspaceKind as c2, KodaXVideoInputArtifact as c3, KodaXVideoMediaType as c4, LocalAgentTaskInput as c5, LocalAgentTaskUpdate as c6, ManifestPatch as c8, MemoryActionProposal as c9, MemoryRefFilter as cA, MemoryRefKind as cB, MemoryRejectResult as cC, MemoryReviewCandidateRef as cD, MemoryReviewDraftAction as cE, MemoryReviewInput as cF, MemoryReviewModelInput as cG, MemoryReviewPersistenceDecision as cH, MemoryReviewPersistenceKind as cI, MemoryReviewPlan as cJ, MemoryReviewRunner as cK, MemoryReviewTrigger as cL, MemoryScope as cM, MemorySourceAdapter as cN, MemoryVisibility as cO, MessageEntry as cP, ObserveCtx as cQ, PersistedSessionState as cR, PresetDispatcher as cS, PresetTracingContext as cT, QualityInvariant as cU, ReadonlyMutationTracker as cV, ReadonlyRecorder as cW, ReasoningDepth as cX, RecentlyModifiedFile as cY, RunEvent as cZ, RunOptions as c_, MemoryApplicability as ca, MemoryApplyPreview as cb, MemoryApplyResult as cc, MemoryApproval as cd, MemoryAuthority as ce, MemoryAutoCuratorInput as cf, MemoryAutoCuratorResult as cg, MemoryBodySnapshot as ch, MemoryClaimKind as ci, MemoryContextIdentity as cj, MemoryController as ck, MemoryCuratorInput as cl, MemoryDecisionTraceReceipt as cm, MemoryEpisodeReviewResult as cn, MemoryEvent as co, MemoryGovernanceFinding as cp, MemoryGovernanceFindingKind as cq, MemoryGovernanceReport as cr, MemoryItemRef as cs, MemoryLifecycle as ct, MemoryLifecycleOperationResult as cu, MemoryPack as cv, MemoryPackHint as cw, MemoryPackInput as cx, MemoryPackTraceMetadata as cy, MemoryProposalAction as cz, AdmissionVerdict as d, WorkflowOutcomeStatus as d$, RunnableTool as d0, RunnerEvent as d2, RunnerLlmResult as d3, RunnerLlmReturn as d4, RunnerRecoveryTranscriptCarrier as d5, RunnerToolCall as d6, RunnerToolContext as d7, RunnerToolObserver as d8, RunnerToolResult as d9, ToolCallSpanData as dA, ToolCapability as dB, ToolPermission as dC, Trace as dD, TraceOptions as dE, TracerOptions as dG, UserInteraction as dH, WorkflowAgentBackend as dI, WorkflowApi as dJ, WorkflowApproval as dK, WorkflowApprovalSummary as dL, WorkflowArtifactRef as dM, WorkflowBudget as dN, WorkflowEvent as dO, WorkflowEventCorrelation as dP, WorkflowEventType as dR, WorkflowIsolation as dS, WorkflowLimits as dT, WorkflowLogEvent as dU, WorkflowMeta as dV, WorkflowModelHint as dW, WorkflowModule as dX, WorkflowOutcome as dY, WorkflowOutcomeError as dZ, WorkflowOutcomeResult as d_, RunnerToolResultBatch as da, RunnerToolResultBatchTransform as db, Session as dc, SessionDispatchResult as dd, SessionEntry as de, SessionErrorMetadata as df, SessionExtension as dg, SessionForkOptions as dh, SessionMeta as di, SessionStateSnapshot as dj, Span as dk, SpanData as dl, SpanError as dm, SpanImplOptions as dp, StartTraceOptions as dq, StateWriter as dr, StateWriterFs as ds, StateWriterOptions as dt, StopHookContext as du, StopHookFn as dv, StopHookResult as dw, StopHookSpanData as dx, SystemCap as dy, TerminalCtx as dz, AdmittedHandle as e, WorkflowOutcomeUsage as e0, WorkflowParallelOptions as e1, WorkflowProcessArtifact as e2, WorkflowProcessCounts as e3, WorkflowProcessEvent as e4, WorkflowProcessItem as e5, WorkflowProcessItemKind as e6, WorkflowProcessItemOrigin as e7, WorkflowProcessItemStatus as e8, WorkflowProcessProgress as e9, WorkflowProcessSnapshot as ea, WorkflowProcessSource as eb, WorkflowProcessStatus as ec, WorkflowProcessSummaryStatus as ed, WorkflowProcessTokenUsage as ee, WorkflowProcessTracker as ef, WorkflowProcessTrackerOptions as eg, WorkflowRun as eh, WorkflowRunState as ei, WorkflowRunStatus as ej, WorkflowSpawnAgentInput as ek, WorkflowSynthesis as el, WorkflowSynthesizeInput as em, WorkflowTaskHandle as en, WorkflowTaskResult as eo, WorkflowTaskSnapshot as ep, WorkflowTaskStatus as eq, WorkflowTaskSummaryEventUpdate as er, WorkflowTaskSummaryKind as es, WorkflowTaskSummaryUpdate as et, WorkflowTaskUsage as eu, WorkflowTaskVerification as ev, WorkflowTaskVerificationResult as ew, WorkflowWaitOptions as ex, Agent as f, AgentActor as g, AgentActorClient as h, AgentActorSnapshot as i, AgentActorState as j, AgentActorStore as k, AgentArtifactDescriptor as l, AgentArtifactPolicy as m, AgentArtifactPolicyDecision as n, AgentArtifactPolicyInput as o, AgentArtifactReference as p, AgentBudgetAdmission as q, AgentBudgetAdmissionInput as r, AgentBudgetExhausted as s, AgentBudgetPort as t, AgentCapabilities as u, AgentCapabilityDeclaration as v, AgentCapabilityRequirements as w, AgentContinuationInput as x, AgentCredentialBroker as y, AgentDataClassification as z };
4595
+ export { ASK_USER_BACK_SIGNAL as A, ASK_USER_CUSTOM_INPUT_SIGNAL as a, DEFAULT_SYSTEM_CAP as a$, InvariantSession as bq, LearningCapabilityError as cB, MAX_TOOL_LOOP_ITERATIONS as cS, LearnedAreaStore as ce, Runner as dO, SpanImpl as e8, WorkflowEventRecorder as eE, Tracer as eq, learningEventKindForLifecycle as f$, createAgent as fA, createHandoff as fB, createInMemorySession as fC, createInvariantSessionForAgent as fD, createLearnedCapabilityScope as fE, createLearnedSkillRecord as fF, createStateWriter as fG, createTrace as fH, createWorkflowProcessTracker as fI, defaultTracer as fJ, detectInstructionsInjection as fK, discoverInstances as fL, eventFromCapability as fM, exactInvokedSkillSnapshotForSession as fN, executeRunnerToolCall as fO, extractAssistantTextFromMessage as fP, getActiveUserInteraction as fQ, getAdmittedAgentBindings as fR, hashMemoryIdentityComponent as fS, invokeLearnedSkillCanary as fT, isAskUserCustomInputAnswer as fU, isFinalWorkflowProcessStatus as fV, isLearnedCapabilityRecordV2 as fW, isRunnableTool as fX, isRunnerLlmResult as fY, isUnifiedLearningReviewModelInput as fZ, learningEventIdFor as f_, _resetAdmittedAgentBindings as fm, _resetPresetDispatchers as fn, admitAndRecordLearnedSkillInvocation as fo, admitLearnedSkillBinding as fp, asSingleSelection as fq, assertLearnedCapabilityTransition as fr, attachRunnerRecoveryTranscript as fs, buildAssistantMessageFromLlmResult as ft, buildSystemPrompt as fu, buildToolResultMessage as fv, canTransitionLearnedCapability as fw, commitLearnedSkillRevision as fx, completeLearnedSkillOutcome as fy, completeLearnedSkillSessionOutcomes as fz, listLearnedSkillUsageReceipts as g0, matchesMemoryApplicability as g1, memoryApplicabilityFingerprint as g2, normalizeHostMetadata as g3, normalizeUnifiedLearningReview as g4, quarantineLearnedSkillRevision as g5, readRunnerRecoveryTranscript as g6, reconcileLearnedSkillBindingOutcomes as g7, recordLearnedSkillOffered as g8, registerPresetDispatcher as g9, releaseLearnedSkillBinding as ga, renderDeclarativeSkill as gb, resolveLearnedAreaPaths as gc, resolveProjectLearnedAreaRoot as gd, runAdmissionAudit as ge, sanitizeUnifiedLearningReviewInput as gf, setActiveUserInteraction as gg, setAdmittedAgentBindings as gh, slugifyLearnedCapabilityName as gi, stageLearnedSkillRevision as gj, validateDeclarativeSkillSpec as gk };
4596
+ export type { AgentExecutorProtocol as $, AgentContinuationInput as B, AgentCredentialBroker as C, AgentDataClassification as D, AgentDetail as E, AgentDispatchContext as F, AgentDispatchPolicy as G, AgentDispatchPolicyDecision as H, AgentDispatchPolicyInput as I, AgentDispatchabilitySnapshot as J, AgentDispatchabilityStatus as K, AgentEffectDeclaration as L, AgentEvent as M, AgentEventKind as N, AgentExecutionInput as O, AgentExecutionKind as P, AgentExecutionResult as Q, AgentExecutor as R, AgentExecutorEvent as S, AgentExecutorFactory as T, AgentExecutorFactoryContext as U, AgentExecutorPlane as V, AgentExecutorPlaneBackgroundErrorContext as W, AgentExecutorPlaneBackgroundErrorHandler as X, AgentExecutorPlaneBinding as Y, AgentExecutorPlaneStore as Z, AgentExecutorPreflightResult as _, AgentExecutorTaskReference as a0, AgentExecutorTaskSnapshot as a1, AgentFollowupResult as a2, AgentForkTurns as a3, AgentInterruptScope as a4, AgentJsonObject as a5, AgentJsonValue as a6, AgentLimitReached as a7, AgentListEntry as a8, AgentMailboxMessage as a9, AgentTaskState as aA, AgentTaskUsage as aB, AgentTool as aC, AgentTreeSnapshot as aD, AgentTurn as aE, AgentTurnExecutor as aF, AgentTurnRef as aG, AgentTurnState as aH, AgentTurnSummary as aI, AskUserAnswer as aJ, AskUserCustomInputAnswer as aK, AskUserMultiOptions as aL, AskUserQuestionItem as aM, AskUserQuestionOptions as aN, AskUserSelectionAnswer as aO, CapabilitySupport as aP, CommitLearnedSkillRevisionInput as aQ, CompactionAnchor as aR, CompactionConfig as aS, CompactionDetails as aT, CompactionReport as aU, CompactionResult as aV, CompactionSpanData as aW, CompactionUpdate as aX, CreateAgentExecutorPlaneOptions as aY, CreateLearnedSkillRecordInput as aZ, CurrentTodoSummary as a_, AgentManifest as aa, AgentMessage as ab, AgentMetadataValue as ac, AgentMiddlewareDeclaration as ad, AgentMutationOptions as ae, AgentOutput as af, AgentPreflightInput as ag, AgentPreflightResult as ah, AgentProgressItem as ai, AgentProgressKind as aj, AgentProgressUpdate as ak, AgentReasoningProfile as al, AgentRegistrationEnabledMutationOptions as am, AgentRegistrationMutationOptions as an, AgentRegistrationService as ao, AgentSpanData as ap, AgentSpawnInput as aq, AgentTaskCancellation as ar, AgentTaskCorrelation as as, AgentTaskEvent as at, AgentTaskFilter as au, AgentTaskProgress as av, AgentTaskRegistrationSnapshot as aw, AgentTaskService as ax, AgentTaskSnapshot as ay, AgentTaskStartInput as az, AdmissionAuditOptions as b, KodaXSessionRuntimeInfo as b$, DeclarativeSkillSpec as b0, Deliverable as b1, DiscoveredInstance as b2, DiscoveryOptions as b3, DispatchableAgentDescriptor as b4, DispatchableAgentListing as b5, DispatchableAgentOrigin as b6, DispatchableAgentQuery as b7, EvidenceSpanData as b8, ExactInvokedSkillSnapshot as b9, KodaXGoalStatus as bA, KodaXImageInputArtifact as bB, KodaXImageMediaType as bC, KodaXInputArtifact as bD, KodaXInputArtifactSource as bE, KodaXJsonValue as bF, KodaXMemoryInfluenceRef as bG, KodaXMemoryIntent as bH, KodaXMemoryOutcomeDigest as bI, KodaXMemoryOutcomeEvidence as bJ, KodaXSessionArchiveMarkerEntry as bK, KodaXSessionArtifactLedgerEntry as bL, KodaXSessionBranchSummaryEntry as bM, KodaXSessionClientNoticeEntry as bN, KodaXSessionCompactionEntry as bO, KodaXSessionData as bP, KodaXSessionEntry as bQ, KodaXSessionEntryBase as bR, KodaXSessionGoalEntry as bS, KodaXSessionLabelEntry as bT, KodaXSessionLineage as bU, KodaXSessionMemoryOutcomeDigestEntry as bV, KodaXSessionMemoryReviewReceiptEntry as bW, KodaXSessionMessageEntry as bX, KodaXSessionMeta as bY, KodaXSessionNavigationOptions as bZ, KodaXSessionRewindMarkerEntry as b_, ExternalAgentEffectDeclaration as ba, ExternalAgentHealth as bb, ExternalAgentProtocol as bc, ExternalAgentRegistration as bd, ExternalAgentRegistrationSummary as be, FanoutSpanData as bf, FileOperations as bg, GenerationSpanData as bh, Guardrail as bi, GuardrailSpanData as bj, Handoff as bk, HandoffSpanData as bl, InMemorySessionOptions as bm, InstanceDiscoveryFs as bn, InvariantId as bo, InvariantResult as bp, KodaXCompactMemoryProgress as br, KodaXCompactMemorySeed as bs, KodaXExtensionSessionRecord as bt, KodaXExtensionSessionState as bu, KodaXExtensionStore as bv, KodaXExtensionStoreEntry as bw, KodaXFileInputArtifact as bx, KodaXGoalEventType as by, KodaXGoalState as bz, AdmissionCtx as c, MemoryAutoCuratorResult as c$, KodaXSessionScope as c0, KodaXSessionStorage as c1, KodaXSessionTreeNode as c2, KodaXSessionUiHistoryItem as c3, KodaXSessionUiHistoryItemType as c4, KodaXSessionUiTextHistoryItem as c5, KodaXSessionUiTextHistoryItemType as c6, KodaXSessionUiToolCall as c7, KodaXSessionUiToolCallStatus as c8, KodaXSessionUiToolGroupHistoryItem as c9, LearningActionDriver as cA, LearningCapabilityErrorCode as cC, LearningClientEventState as cD, LearningClientRecord as cE, LearningEvent as cF, LearningEventKind as cG, LearningExplicitUserAuthority as cH, LearningNotificationState as cI, LearningPage as cJ, LearningQuery as cK, LearningReviewEvidencePacket as cL, LearningReviewQualification as cM, LearningReviewVerifierFact as cN, LearningSubscribeOptions as cO, LearningSurfaceSnapshot as cP, LocalAgentTaskInput as cQ, LocalAgentTaskUpdate as cR, ManifestPatch as cT, MemoryActionProposal as cU, MemoryApplicability as cV, MemoryApplyPreview as cW, MemoryApplyResult as cX, MemoryApproval as cY, MemoryAuthority as cZ, MemoryAutoCuratorInput as c_, KodaXSessionWorkspaceKind as ca, KodaXVideoInputArtifact as cb, KodaXVideoMediaType as cc, LearnedAreaPaths as cd, LearnedCapabilityArtifact as cf, LearnedCapabilityCanary as cg, LearnedCapabilityCanaryBinding as ch, LearnedCapabilityCanaryInvocation as ci, LearnedCapabilityCarrier as cj, LearnedCapabilityLifecycle as ck, LearnedCapabilityProvenance as cl, LearnedCapabilityRecord as cm, LearnedCapabilityRecordV1 as cn, LearnedCapabilityRecordV2 as co, LearnedCapabilityScope as cp, LearnedCapabilitySource as cq, LearnedSkillBindingAdmission as cr, LearnedSkillCanaryOutcome as cs, LearnedSkillDecisionDisposition as ct, LearnedSkillInvocationAdmission as cu, LearnedSkillInvokedReceipt as cv, LearnedSkillOfferedReceipt as cw, LearnedSkillOutcomeReceipt as cx, LearnedSkillUsageReceipt as cy, LearningAction as cz, AdmissionVerdict as d, SessionEntry as d$, MemoryBodySnapshot as d0, MemoryClaimKind as d1, MemoryContextIdentity as d2, MemoryController as d3, MemoryCuratorInput as d4, MemoryDecisionTraceReceipt as d5, MemoryEpisodeReviewResult as d6, MemoryEvent as d7, MemoryGovernanceFinding as d8, MemoryGovernanceFindingKind as d9, NormalizedLearnedSkillDecision as dA, ObserveCtx as dB, PersistedSessionState as dC, PresetDispatcher as dD, PresetTracingContext as dE, QualityInvariant as dF, ReadonlyMutationTracker as dG, ReadonlyRecorder as dH, ReasoningDepth as dI, RecentlyModifiedFile as dJ, RunEvent as dK, RunOptions as dL, RunResult as dM, RunnableTool as dN, RunnerEvent as dP, RunnerLlmResult as dQ, RunnerLlmReturn as dR, RunnerRecoveryTranscriptCarrier as dS, RunnerToolCall as dT, RunnerToolContext as dU, RunnerToolObserver as dV, RunnerToolResult as dW, RunnerToolResultBatch as dX, RunnerToolResultBatchTransform as dY, Session as dZ, SessionDispatchResult as d_, MemoryGovernanceReport as da, MemoryItemRef as db, MemoryLifecycle as dc, MemoryLifecycleOperationResult as dd, MemoryPack as de, MemoryPackHint as df, MemoryPackInput as dg, MemoryPackTraceMetadata as dh, MemoryProposalAction as di, MemoryRefFilter as dj, MemoryRefKind as dk, MemoryRejectResult as dl, MemoryReviewCandidateRef as dm, MemoryReviewDraftAction as dn, MemoryReviewInput as dp, MemoryReviewModelInput as dq, MemoryReviewPersistenceDecision as dr, MemoryReviewPersistenceKind as ds, MemoryReviewPlan as dt, MemoryReviewRunner as du, MemoryReviewTrigger as dv, MemoryScope as dw, MemorySourceAdapter as dx, MemoryVisibility as dy, MessageEntry as dz, AdmittedHandle as e, WorkflowProcessSource as e$, SessionErrorMetadata as e0, SessionExtension as e1, SessionForkOptions as e2, SessionMeta as e3, SessionStateSnapshot as e4, Span as e5, SpanData as e6, SpanError as e7, SpanImplOptions as e9, WorkflowArtifactRef as eA, WorkflowBudget as eB, WorkflowEvent as eC, WorkflowEventCorrelation as eD, WorkflowEventType as eF, WorkflowIsolation as eG, WorkflowLimits as eH, WorkflowLogEvent as eI, WorkflowMeta as eJ, WorkflowModelHint as eK, WorkflowModule as eL, WorkflowOutcome as eM, WorkflowOutcomeError as eN, WorkflowOutcomeResult as eO, WorkflowOutcomeStatus as eP, WorkflowOutcomeUsage as eQ, WorkflowParallelOptions as eR, WorkflowProcessArtifact as eS, WorkflowProcessCounts as eT, WorkflowProcessEvent as eU, WorkflowProcessItem as eV, WorkflowProcessItemKind as eW, WorkflowProcessItemOrigin as eX, WorkflowProcessItemStatus as eY, WorkflowProcessProgress as eZ, WorkflowProcessSnapshot as e_, StagedLearnedSkillArtifact as ea, StartTraceOptions as eb, StateWriter as ec, StateWriterFs as ed, StateWriterOptions as ee, StopHookContext as ef, StopHookFn as eg, StopHookResult as eh, StopHookSpanData as ei, SystemCap as ej, TerminalCtx as ek, ToolCallSpanData as el, ToolCapability as em, ToolPermission as en, Trace as eo, TraceOptions as ep, TracerOptions as er, UnifiedLearningReviewModelInput as es, UnifiedLearningReviewResult as et, UnifiedLearningReviewRunner as eu, UserInteraction as ev, WorkflowAgentBackend as ew, WorkflowApi as ex, WorkflowApproval as ey, WorkflowApprovalSummary as ez, Agent as f, WorkflowProcessStatus as f0, WorkflowProcessSummaryStatus as f1, WorkflowProcessTokenUsage as f2, WorkflowProcessTracker as f3, WorkflowProcessTrackerOptions as f4, WorkflowRun as f5, WorkflowRunState as f6, WorkflowRunStatus as f7, WorkflowSpawnAgentInput as f8, WorkflowSynthesis as f9, WorkflowSynthesizeInput as fa, WorkflowTaskHandle as fb, WorkflowTaskResult as fc, WorkflowTaskSnapshot as fd, WorkflowTaskStatus as fe, WorkflowTaskSummaryEventUpdate as ff, WorkflowTaskSummaryKind as fg, WorkflowTaskSummaryUpdate as fh, WorkflowTaskUsage as fi, WorkflowTaskVerification as fj, WorkflowTaskVerificationResult as fk, WorkflowWaitOptions as fl, AgentActor as g, AgentActorClient as h, AgentActorOwner as i, AgentActorSnapshot as j, AgentActorSnapshotV1 as k, AgentActorSnapshotV2 as l, AgentActorState as m, AgentActorStore as n, AgentArtifactDescriptor as o, AgentArtifactPolicy as p, AgentArtifactPolicyDecision as q, AgentArtifactPolicyInput as r, AgentArtifactReference as s, AgentBudgetAdmission as t, AgentBudgetAdmissionInput as u, AgentBudgetExhausted as v, AgentBudgetPort as w, AgentCapabilities as x, AgentCapabilityDeclaration as y, AgentCapabilityRequirements as z };
@@ -1,4 +1,4 @@
1
- import { bw as KodaXInputArtifact } from './types.d-RdWRfUEs.js';
1
+ import { bD as KodaXInputArtifact } from './types.d-BA-Jwpfs.js';
2
2
  import { S as KodaXTaskResultMetadata } from './types.d-DIpZJKUl.js';
3
3
 
4
4
  /**