@robota-sdk/agent-core 3.0.0-beta.86 → 3.0.0-beta.88

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 (40) hide show
  1. package/CHANGELOG.md +36 -15
  2. package/README.md +56 -22
  3. package/dist/browser/{bounded-output-Bgx2Cgkx.js → bounded-output-BdWv9SX3.js} +2 -2
  4. package/dist/browser/bounded-output-BdWv9SX3.js.map +1 -0
  5. package/dist/browser/{command-executor-C0XXfBnt.js → command-executor-DIXaSMrr.js} +2 -2
  6. package/dist/{node/command-executor-d6DdfUTD.js.map → browser/command-executor-DIXaSMrr.js.map} +1 -1
  7. package/dist/browser/index.d.ts +140 -48
  8. package/dist/browser/index.d.ts.map +1 -1
  9. package/dist/browser/index.js +10 -9
  10. package/dist/browser/index.js.map +1 -1
  11. package/dist/node/{bounded-output-Bgx2Cgkx.js → bounded-output-BdWv9SX3.js} +2 -2
  12. package/dist/node/bounded-output-BdWv9SX3.js.map +1 -0
  13. package/dist/node/{command-executor-d6DdfUTD.js → command-executor-D_UBZHxh.js} +2 -2
  14. package/dist/{browser/command-executor-C0XXfBnt.js.map → node/command-executor-D_UBZHxh.js.map} +1 -1
  15. package/dist/node/{command-executor-CqAFpB-X.cjs → command-executor-wBgBdWXr.cjs} +1 -1
  16. package/dist/node/{http-executor-BFtXs8FP.cjs → http-executor-CeAAZotH.cjs} +1 -1
  17. package/dist/node/{index-CPwJEiFl.d.cts → index-CagopdzH.d.cts} +141 -49
  18. package/dist/node/index-CagopdzH.d.cts.map +1 -0
  19. package/dist/node/{index-DQrmrFn9.d.ts → index-CjyNzgQN.d.ts} +141 -49
  20. package/dist/node/index-CjyNzgQN.d.ts.map +1 -0
  21. package/dist/node/index.cjs +10 -9
  22. package/dist/node/index.d.cts +2 -2
  23. package/dist/node/index.d.ts +2 -2
  24. package/dist/node/index.js +12 -11
  25. package/dist/node/index.js.map +1 -1
  26. package/dist/node/node.cjs +1 -1
  27. package/dist/node/node.d.cts +13 -2
  28. package/dist/node/node.d.cts.map +1 -1
  29. package/dist/node/node.d.ts +13 -2
  30. package/dist/node/node.d.ts.map +1 -1
  31. package/dist/node/node.js +1 -1
  32. package/dist/node/node.js.map +1 -1
  33. package/dist/node/testing/index.d.cts +1 -1
  34. package/dist/node/testing/index.d.ts +1 -1
  35. package/dist/node/{verdict-decoder-DIHay1ul.cjs → verdict-decoder-DQqwwDE7.cjs} +1 -1
  36. package/package.json +10 -10
  37. package/dist/browser/bounded-output-Bgx2Cgkx.js.map +0 -1
  38. package/dist/node/bounded-output-Bgx2Cgkx.js.map +0 -1
  39. package/dist/node/index-CPwJEiFl.d.cts.map +0 -1
  40. package/dist/node/index-DQrmrFn9.d.ts.map +0 -1
@@ -106,7 +106,35 @@ interface IUriImageMessagePart {
106
106
  uri: string;
107
107
  mimeType?: string;
108
108
  }
109
- type TUniversalMessagePart = ITextMessagePart | IInlineImageMessagePart | IUriImageMessagePart;
109
+ /** An inline audio observation; provider support is determined by the adapter. */
110
+ interface IInlineAudioMessagePart {
111
+ type: 'audio_inline';
112
+ mimeType: string;
113
+ data: string;
114
+ }
115
+ /** An opaque reference, never authority to fetch its URI. */
116
+ interface IResourceLinkMessagePart {
117
+ type: 'resource_link';
118
+ uri: string;
119
+ name: string;
120
+ mimeType?: string;
121
+ title?: string;
122
+ description?: string;
123
+ size?: number;
124
+ }
125
+ /** Embedded untrusted resource content, tied to the contributor's opaque URI. */
126
+ type TEmbeddedResourceMessagePart = {
127
+ type: 'resource_embedded';
128
+ uri: string;
129
+ mimeType?: string;
130
+ } & ({
131
+ text: string;
132
+ blob?: never;
133
+ } | {
134
+ blob: string;
135
+ text?: never;
136
+ });
137
+ type TUniversalMessagePart = ITextMessagePart | IInlineImageMessagePart | IUriImageMessagePart | IInlineAudioMessagePart | IResourceLinkMessagePart | TEmbeddedResourceMessagePart;
110
138
  /**
111
139
  * Tool call (OpenAI tool calling format).
112
140
  */
@@ -240,7 +268,7 @@ type TProviderModelCapability = 'tools' | 'vision' |
240
268
  'json_object' | 'reasoning' | 'native_web' | 'streaming' |
241
269
  /**
242
270
  * CLI-1990: the vendor documents a server-side tool search — deferred definitions the API expands
243
- * on demand. Declaration-only in v1: Robota runs its own client-side catalog on every provider
271
+ * on demand. Declaration-only in v1: ConversationAgent runs its own client-side catalog on every provider
244
272
  * and emits no vendor block. The member exists so a later offload can be capability-gated in this
245
273
  * table rather than by provider name.
246
274
  */
@@ -330,9 +358,9 @@ type TErrorContextData = Record<string, string | number | boolean | Date | Error
330
358
  */
331
359
  type TErrorExternalInput = Error | string | Record<string, string | number | boolean> | null | undefined;
332
360
  /**
333
- * Base error class for all Robota errors
361
+ * Base error class for all ConversationAgent errors
334
362
  */
335
- declare abstract class RobotaError extends Error {
363
+ declare abstract class AgentRuntimeError extends Error {
336
364
  readonly context?: TErrorContextData | undefined;
337
365
  abstract readonly code: string;
338
366
  abstract readonly category: 'user' | 'system' | 'provider';
@@ -342,7 +370,7 @@ declare abstract class RobotaError extends Error {
342
370
  /**
343
371
  * Configuration related errors
344
372
  */
345
- declare class ConfigurationError extends RobotaError {
373
+ declare class ConfigurationError extends AgentRuntimeError {
346
374
  readonly code = "CONFIGURATION_ERROR";
347
375
  readonly category: "user";
348
376
  readonly recoverable = false;
@@ -351,7 +379,7 @@ declare class ConfigurationError extends RobotaError {
351
379
  /**
352
380
  * Input validation errors
353
381
  */
354
- declare class ValidationError extends RobotaError {
382
+ declare class ValidationError extends AgentRuntimeError {
355
383
  readonly field?: string | undefined;
356
384
  readonly code = "VALIDATION_ERROR";
357
385
  readonly category: "user";
@@ -366,7 +394,7 @@ declare class ValidationError extends RobotaError {
366
394
  * validation messages from the last attempt; `attempts` is the total number of
367
395
  * provider turns spent (initial + retries).
368
396
  */
369
- declare class StructuredOutputError extends RobotaError {
397
+ declare class StructuredOutputError extends AgentRuntimeError {
370
398
  readonly issues: string[];
371
399
  readonly attempts: number;
372
400
  readonly code = "STRUCTURED_OUTPUT_ERROR";
@@ -384,7 +412,7 @@ interface IProviderFailureDetails {
384
412
  /**
385
413
  * Provider related errors
386
414
  */
387
- declare class ProviderError extends RobotaError {
415
+ declare class ProviderError extends AgentRuntimeError {
388
416
  readonly provider: string;
389
417
  readonly originalError?: Error | undefined;
390
418
  readonly code = "PROVIDER_ERROR";
@@ -397,7 +425,7 @@ declare class ProviderError extends RobotaError {
397
425
  /**
398
426
  * Authentication errors
399
427
  */
400
- declare class AuthenticationError extends RobotaError {
428
+ declare class AuthenticationError extends AgentRuntimeError {
401
429
  readonly provider?: string | undefined;
402
430
  readonly code = "AUTHENTICATION_ERROR";
403
431
  readonly category: "user";
@@ -407,7 +435,7 @@ declare class AuthenticationError extends RobotaError {
407
435
  /**
408
436
  * Rate limit errors
409
437
  */
410
- declare class RateLimitError extends RobotaError {
438
+ declare class RateLimitError extends AgentRuntimeError {
411
439
  readonly retryAfter?: number | undefined;
412
440
  readonly provider?: string | undefined;
413
441
  readonly code = "RATE_LIMIT_ERROR";
@@ -418,7 +446,7 @@ declare class RateLimitError extends RobotaError {
418
446
  /**
419
447
  * Network/connectivity errors
420
448
  */
421
- declare class NetworkError extends RobotaError {
449
+ declare class NetworkError extends AgentRuntimeError {
422
450
  readonly originalError?: Error | undefined;
423
451
  /** `undefined` for a network failure with no provider context (e.g. a generic timeout). */
424
452
  readonly provider?: string | undefined;
@@ -432,7 +460,7 @@ declare class NetworkError extends RobotaError {
432
460
  /**
433
461
  * Tool execution errors
434
462
  */
435
- declare class ToolExecutionError extends RobotaError {
463
+ declare class ToolExecutionError extends AgentRuntimeError {
436
464
  readonly toolName: string;
437
465
  readonly originalError?: Error | undefined;
438
466
  readonly code = "TOOL_EXECUTION_ERROR";
@@ -449,13 +477,13 @@ declare class ToolExecutionError extends RobotaError {
449
477
  * `success: true, interrupted: true` — reporting a run that produced no answer as a success.
450
478
  *
451
479
  * Named rather than a bare `Error` for the reason the SPEC was reaching for by naming a type at all:
452
- * a caller must be able to tell "the agent looped" from "the network died". `RobotaError` carries
480
+ * a caller must be able to tell "the agent looped" from "the network died". `AgentRuntimeError` carries
453
481
  * `code`/`category`/`recoverable` out through CORE-027's failure path intact.
454
482
  *
455
483
  * `recoverable` is TRUE: the loop is a property of this turn's prompt and tool set, not of the
456
484
  * system, and a caller that varies either can reasonably try again.
457
485
  */
458
- declare class SameToolInputLoopError extends RobotaError {
486
+ declare class SameToolInputLoopError extends AgentRuntimeError {
459
487
  readonly toolName: string;
460
488
  readonly callCount: number;
461
489
  readonly maxSameToolInputs: number;
@@ -479,7 +507,7 @@ declare class SameToolInputLoopError extends RobotaError {
479
507
  * `recoverable` is TRUE: like `SameToolInputLoopError`, this is a property of this turn's prompt and
480
508
  * model response, not of the system, and a caller that varies either can reasonably try again.
481
509
  */
482
- declare class EmptyCompletionError extends RobotaError {
510
+ declare class EmptyCompletionError extends AgentRuntimeError {
483
511
  readonly round: number;
484
512
  readonly code = "EMPTY_COMPLETION";
485
513
  readonly category: "provider";
@@ -489,7 +517,7 @@ declare class EmptyCompletionError extends RobotaError {
489
517
  /**
490
518
  * Model not available errors
491
519
  */
492
- declare class ModelNotAvailableError extends RobotaError {
520
+ declare class ModelNotAvailableError extends AgentRuntimeError {
493
521
  /** `undefined` when the failure names no model — a provider adapter classifying a raw HTTP
494
522
  * response by status alone does not always know which model the vendor meant. */
495
523
  readonly model: string | undefined;
@@ -512,7 +540,7 @@ declare class ModelNotAvailableError extends RobotaError {
512
540
  /**
513
541
  * Circuit breaker open error
514
542
  */
515
- declare class CircuitBreakerOpenError extends RobotaError {
543
+ declare class CircuitBreakerOpenError extends AgentRuntimeError {
516
544
  readonly code = "CIRCUIT_BREAKER_OPEN";
517
545
  readonly category: "system";
518
546
  readonly recoverable = true;
@@ -521,7 +549,7 @@ declare class CircuitBreakerOpenError extends RobotaError {
521
549
  /**
522
550
  * Plugin errors
523
551
  */
524
- declare class PluginError extends RobotaError {
552
+ declare class PluginError extends AgentRuntimeError {
525
553
  readonly pluginName: string;
526
554
  readonly code = "PLUGIN_ERROR";
527
555
  readonly category: "system";
@@ -531,7 +559,7 @@ declare class PluginError extends RobotaError {
531
559
  /**
532
560
  * Storage related errors
533
561
  */
534
- declare class StorageError extends RobotaError {
562
+ declare class StorageError extends AgentRuntimeError {
535
563
  readonly code = "STORAGE_ERROR";
536
564
  readonly category: "system";
537
565
  readonly recoverable = true;
@@ -540,7 +568,7 @@ declare class StorageError extends RobotaError {
540
568
  /**
541
569
  * Cache integrity validation errors
542
570
  */
543
- declare class CacheIntegrityError extends RobotaError {
571
+ declare class CacheIntegrityError extends AgentRuntimeError {
544
572
  readonly code = "CACHE_INTEGRITY_ERROR";
545
573
  readonly category: "system";
546
574
  readonly recoverable = false;
@@ -1302,6 +1330,10 @@ declare function readModelFallbackNotice(data: Readonly<Record<string, unknown>>
1302
1330
  declare const TOOL_BODY_EVENTS: {
1303
1331
  readonly COMPLETED: "tool_body_completed";
1304
1332
  };
1333
+ /** Submission to scheduler selection or refusal; never permission or effect completion. */
1334
+ declare const TOOL_QUEUE_EVENTS: {
1335
+ readonly COMPLETED: "tool_queue_completed";
1336
+ };
1305
1337
  /** Content-free decision reached for one tool call before any body runs. */
1306
1338
  declare const TOOL_PERMISSION_EVENTS: {
1307
1339
  readonly DECIDED: "tool_permission_decided";
@@ -1441,7 +1473,22 @@ interface IDeferredToolCatalog {
1441
1473
  //#region src/interfaces/tool.d.ts
1442
1474
  /** Awaited host admission for effective parameters, immediately before a tool body. */
1443
1475
  type TToolEffectAdmission<TParameters = TToolParameters> = (parameters: TParameters) => Promise<void>;
1444
- type TToolContextExtensionValue = TUniversalValue | Date | Error | TLoggerData | TContextData | TToolParameters | TToolMetadata;
1476
+ /** Trusted caller scheduling; plugin annotations grant neither authority nor retry permission. */
1477
+ interface IToolCallScheduling {
1478
+ dependsOn?: readonly string[];
1479
+ /** Omitted means unknown shared state; an empty array explicitly declares independence. */
1480
+ resources?: readonly {
1481
+ key: string;
1482
+ access: 'read' | 'write';
1483
+ }[];
1484
+ }
1485
+ interface IToolExecutionPolicy {
1486
+ mode?: 'parallel' | 'sequential';
1487
+ maxConcurrency?: number;
1488
+ continueOnError?: boolean;
1489
+ scheduling?: ReadonlyMap<string, IToolCallScheduling>;
1490
+ }
1491
+ type TToolContextExtensionValue = TUniversalValue | Date | Error | TLoggerData | TContextData | TToolParameters | TToolMetadata | TUniversalMessagePart[];
1445
1492
  /**
1446
1493
  * Tool metadata structure - specific type definition
1447
1494
  */
@@ -1459,6 +1506,8 @@ type TToolMetadata = Record<string, string | number | boolean | string[] | numbe
1459
1506
  interface IToolResult {
1460
1507
  success: boolean;
1461
1508
  data?: TUniversalValue;
1509
+ /** Ordered observations accompanying structured data; images stay typed through history. */
1510
+ parts?: TUniversalMessagePart[];
1462
1511
  error?: string;
1463
1512
  metadata?: TToolMetadata;
1464
1513
  [key: string]: TToolContextExtensionValue | undefined;
@@ -1473,6 +1522,8 @@ interface IToolExecutionResult {
1473
1522
  toolName?: string;
1474
1523
  /** Execution result or data */
1475
1524
  result?: TUniversalValue;
1525
+ /** Ordered observations retained with the durable execution settlement. */
1526
+ parts?: TUniversalMessagePart[];
1476
1527
  /** Error message if execution failed */
1477
1528
  error?: string;
1478
1529
  /** Execution duration in milliseconds */
@@ -1611,7 +1662,18 @@ type TToolExecutor<TParams = TToolParameters, TResult = TUniversalValue> = (para
1611
1662
  /**
1612
1663
  * Base tool interface
1613
1664
  */
1665
+ /** Host-declared tool attribution. It identifies a source; it never grants execution authority. */
1666
+ interface IToolProvenance {
1667
+ readonly sourceId: string;
1668
+ readonly component: string;
1669
+ readonly origin: string;
1670
+ /** A declared source version, not proof of installed bytes. */
1671
+ readonly version?: string;
1672
+ readonly protocolVersion?: string;
1673
+ readonly generation?: string;
1674
+ }
1614
1675
  interface ITool {
1676
+ readonly provenance?: IToolProvenance;
1615
1677
  /** Tool schema */
1616
1678
  schema: IToolSchema;
1617
1679
  /**
@@ -2450,7 +2512,7 @@ interface IPluginContract<TOptions extends IPluginOptions = IPluginOptions, TSta
2450
2512
  /**
2451
2513
  * CORE-022: the single component-level disposal entry point. The base implementation
2452
2514
  * unsubscribes module events; overrides release owned resources (timers, sockets,
2453
- * storage) — always calling `super.dispose()`. Driven by `Robota.destroy()`.
2515
+ * storage) — always calling `super.dispose()`. Driven by `ConversationAgent.destroy()`.
2454
2516
  */
2455
2517
  dispose(): Promise<void>;
2456
2518
  cleanup?(): Promise<void>;
@@ -2550,7 +2612,7 @@ declare class ConsoleLogger implements ILogger {
2550
2612
  * This logger's own threshold. `undefined` means "follow the process-wide level".
2551
2613
  *
2552
2614
  * CORE-029: the field existed and nothing ever set it, so the only way to change a level was
2553
- * `setGlobalLogLevel` — and `Robota`'s constructor called it from `config.logging`, which meant one
2615
+ * `setGlobalLogLevel` — and `ConversationAgent`'s constructor called it from `config.logging`, which meant one
2554
2616
  * agent's per-agent setting silenced every other agent AND every other package in the process.
2555
2617
  * A per-agent option has to reach a per-agent logger.
2556
2618
  */
@@ -2562,7 +2624,7 @@ declare class ConsoleLogger implements ILogger {
2562
2624
  *
2563
2625
  * It used to be `logger || SilentLogger`, decided once in the constructor. No call site in the
2564
2626
  * repository ever passed one and there was no way to set one afterwards, so every diagnostic this
2565
- * package emits — 157 `logger.*` calls, including "Robota initialization failed" and every
2627
+ * package emits — 157 `logger.*` calls, including "ConversationAgent initialization failed" and every
2566
2628
  * catch-and-log-only path — went to `SilentLogger` by construction. Not "was not configured":
2567
2629
  * could not be.
2568
2630
  *
@@ -2657,6 +2719,7 @@ interface IAbstractTool<TParams = TToolParameters, TResult = IToolResult> {
2657
2719
  */
2658
2720
  interface IToolContract<TParameters = TToolParameters, TResult = IToolResult> {
2659
2721
  readonly schema: IToolSchema;
2722
+ readonly provenance?: IToolProvenance;
2660
2723
  execute(parameters: TParameters, context: IToolExecutionContext): Promise<TResult>;
2661
2724
  /**
2662
2725
  * Wrappers await admission exactly once with final canonical arguments after preconditions and before
@@ -2669,10 +2732,10 @@ interface IToolContract<TParameters = TToolParameters, TResult = IToolResult> {
2669
2732
  getName(): string;
2670
2733
  }
2671
2734
  /**
2672
- * Runtime tool instance contract used by Robota internals.
2735
+ * Runtime tool instance contract used by ConversationAgent internals.
2673
2736
  *
2674
2737
  * Tools passed into Agent configuration must support EventService injection
2675
- * so Robota can emit unified tool lifecycle events.
2738
+ * so ConversationAgent can emit unified tool lifecycle events.
2676
2739
  */
2677
2740
  interface IToolWithEventService<TParameters = TToolParameters, TResult = IToolResult> extends IToolContract<TParameters, TResult> {
2678
2741
  setEventService(eventService: IEventService | undefined): void;
@@ -2737,6 +2800,8 @@ interface IAgentConfig {
2737
2800
  toolChoice?: TToolChoice;
2738
2801
  };
2739
2802
  tools?: Array<IToolWithEventService>;
2803
+ /** Host-owned per-round policy. Absent declarations serialize unknown shared-state operations. */
2804
+ toolExecutionPolicy?: (calls: readonly IToolCall[]) => IToolExecutionPolicy;
2740
2805
  /**
2741
2806
  * CLI-1990: whether tools that declare `deferLoading` are withheld from the model until loaded.
2742
2807
  * `'auto'` (the default) decides by threshold — `resolveToolSearchMode` — so a small tool set is
@@ -3285,6 +3350,8 @@ interface IToolManager {
3285
3350
  * Execute a tool
3286
3351
  */
3287
3352
  executeTool(name: string, parameters: TToolParameters, context?: IToolExecutionContext): Promise<TUniversalValue>;
3353
+ /** Full result port; absent on legacy value-only manager implementations. */
3354
+ executeToolResult?(name: string, parameters: TToolParameters, context?: IToolExecutionContext): Promise<IToolResult>;
3288
3355
  /**
3289
3356
  * Check if tool exists
3290
3357
  */
@@ -3746,7 +3813,7 @@ interface ILocalExecutorConfig {
3746
3813
  /**
3747
3814
  * Configuration options for a remote executor.
3748
3815
  *
3749
- * @deprecated Robota ships no remote executor, so nothing reads this type. It stays exported only
3816
+ * @deprecated ConversationAgent ships no remote executor, so nothing reads this type. It stays exported only
3750
3817
  * so existing imports keep compiling; describe your own executor's options instead.
3751
3818
  */
3752
3819
  interface IRemoteExecutorConfig {
@@ -3893,7 +3960,7 @@ interface IFileSystemAsync {
3893
3960
  */
3894
3961
  /** A secret's name: the owning service and the account within it, both chosen by the caller. */
3895
3962
  interface ICredentialKey {
3896
- /** A namespace for the caller, e.g. `robota.remote-control`. */
3963
+ /** A namespace for the caller, e.g. `agent.remote-control`. */
3897
3964
  readonly service: string;
3898
3965
  /** The secret's name within that namespace. */
3899
3966
  readonly account: string;
@@ -3907,6 +3974,12 @@ interface ICredentialStore {
3907
3974
  delete(key: ICredentialKey): Promise<void>;
3908
3975
  }
3909
3976
  //#endregion
3977
+ //#region src/utils/tool-provenance.d.ts
3978
+ /** Copy only the declared public attribution, before handing control to a tool. */
3979
+ declare function snapshotToolProvenance(source?: IToolProvenance): IToolProvenance | undefined;
3980
+ /** The execution owner's attribution overrides any result-supplied claim. */
3981
+ declare function withToolProvenance(result: IToolResult, source?: IToolProvenance): IToolResult;
3982
+ //#endregion
3910
3983
  //#region src/abstracts/abstract-agent.d.ts
3911
3984
  declare abstract class AbstractAgent<TConfig = IAgentConfig, TContext = IRunOptions, TMessage = TUniversalMessage> implements IAgent<TConfig, TContext, TMessage> {
3912
3985
  protected history: TMessage[];
@@ -4430,6 +4503,7 @@ declare abstract class AbstractExecutor implements IExecutor {
4430
4503
  */
4431
4504
  declare abstract class AbstractTool<TParameters = TToolParameters, TResult = IToolResult> implements IToolWithEventService<TParameters, TResult> {
4432
4505
  abstract readonly schema: IToolSchema;
4506
+ readonly provenance?: IToolProvenance;
4433
4507
  /**
4434
4508
  * Logger for tool operations
4435
4509
  */
@@ -4590,7 +4664,7 @@ declare class ErrorUtils {
4590
4664
  /**
4591
4665
  * Create error from unknown value
4592
4666
  */
4593
- static fromUnknown(error: TErrorExternalInput, defaultMessage?: string): RobotaError;
4667
+ static fromUnknown(error: TErrorExternalInput, defaultMessage?: string): AgentRuntimeError;
4594
4668
  /**
4595
4669
  * Wrap external errors
4596
4670
  */
@@ -4678,7 +4752,7 @@ interface IPlatformShellResolutionRequest {
4678
4752
  readonly platform?: NodeJS.Platform;
4679
4753
  }
4680
4754
  /** An explicit executable whose basename has no supported command argument family. */
4681
- declare class UnsupportedShellError extends RobotaError {
4755
+ declare class UnsupportedShellError extends AgentRuntimeError {
4682
4756
  readonly executable: string;
4683
4757
  readonly code = "UNSUPPORTED_SHELL";
4684
4758
  readonly category: "user";
@@ -4720,9 +4794,9 @@ declare function toolTraceContextFor(traceContext: IRunTraceContext, toolBodyId:
4720
4794
  */
4721
4795
  declare function traceEnvFor(subprocessClass: TSubprocessTraceClass, traceContext: IRunTraceContext | undefined, spanId: string): ISubprocessTraceEnv | undefined;
4722
4796
  /**
4723
- * A fresh child environment: `base`, then Robota's trace, then `overrides`. When Robota's value
4797
+ * A fresh child environment: `base`, then ConversationAgent's trace, then `overrides`. When ConversationAgent's value
4724
4798
  * applies, the ambient `TRACESTATE` is dropped because it belongs to a different parent. When
4725
- * `overrides` sets its own `TRACEPARENT`, Robota's value does not apply and `base` passes unchanged.
4799
+ * `overrides` sets its own `TRACEPARENT`, ConversationAgent's value does not apply and `base` passes unchanged.
4726
4800
  * `base` itself is never modified.
4727
4801
  */
4728
4802
  declare function subprocessTraceEnvironment(base: Readonly<Record<string, string | undefined>>, traceEnv: ISubprocessTraceEnv | undefined, overrides?: Readonly<Record<string, string>>): Record<string, string | undefined>;
@@ -5370,10 +5444,13 @@ declare class ToolRegistry implements IToolRegistry {
5370
5444
  * circular runtime dependency (tools -> agents -> tools).
5371
5445
  */
5372
5446
  declare class FunctionTool implements IFunctionTool {
5447
+ private readonly resultExecutor?;
5373
5448
  readonly schema: IToolSchema;
5374
5449
  readonly fn: TToolExecutor;
5375
5450
  private eventService;
5376
- constructor(schema: IToolSchema, fn: TToolExecutor);
5451
+ constructor(schema: IToolSchema, fn: TToolExecutor, resultExecutor?: TToolExecutor<TToolParameters, IToolResult> | undefined);
5452
+ /** Register an envelope executor explicitly; ordinary function values remain domain data. */
5453
+ static fromResult(schema: IToolSchema, execute: TToolExecutor<TToolParameters, IToolResult>): FunctionTool;
5377
5454
  /**
5378
5455
  * Get tool name
5379
5456
  */
@@ -5421,11 +5498,11 @@ declare const DEFERRED_WITHOUT_LOADER_MESSAGE: string;
5421
5498
  */
5422
5499
  declare function assertResidentToolRemains(schemas: readonly IToolSchema[]): void;
5423
5500
  //#endregion
5424
- //#region src/core/robota-types.d.ts
5501
+ //#region src/core/agent-types.d.ts
5425
5502
  /**
5426
5503
  * Shared model configuration shape used in setModel / getModel. The system prompt is intentionally
5427
5504
  * absent: it is an agent-level concern (top-level `config.systemMessage`), updated live via
5428
- * `Robota.updateSystemPrompt`, not part of model config.
5505
+ * `ConversationAgent.updateSystemPrompt`, not part of model config.
5429
5506
  */
5430
5507
  interface IModelConfig {
5431
5508
  provider: string;
@@ -5470,7 +5547,7 @@ type TExecuteModuleResult = {
5470
5547
  duration?: number;
5471
5548
  };
5472
5549
  //#endregion
5473
- //#region src/core/robota-base.d.ts
5550
+ //#region src/core/conversation-agent-base.d.ts
5474
5551
  type TPlugin = IPluginContract<IPluginOptions, IPluginStats> & IPluginHooks;
5475
5552
  interface IModuleManagerProxy {
5476
5553
  registerModule(module: IModule, options?: TRegisterModuleOptions): Promise<void>;
@@ -5490,11 +5567,11 @@ interface IPluginManagerProxy {
5490
5567
  getPlugins(): TPlugin[];
5491
5568
  getPluginNames(): string[];
5492
5569
  }
5493
- declare abstract class RobotaBase extends AbstractAgent<IAgentConfig, IRunOptions, TUniversalMessage> {
5570
+ declare abstract class ConversationAgentBase extends AbstractAgent<IAgentConfig, IRunOptions, TUniversalMessage> {
5494
5571
  protected moduleManager: IModuleManagerProxy;
5495
5572
  protected pluginManager: IPluginManagerProxy;
5496
5573
  /**
5497
- * Narrowed from `AbstractAgent`'s optional `config`: a Robota agent always has one, assigned in the
5574
+ * Narrowed from `AbstractAgent`'s optional `config`: a ConversationAgent agent always has one, assigned in the
5498
5575
  * constructor. Declared HERE so `name` below can read it without a fallback that would lie.
5499
5576
  */
5500
5577
  protected config: IAgentConfig;
@@ -5640,6 +5717,8 @@ declare class Tools extends AbstractManager implements IToolManager {
5640
5717
  * Register a tool with schema and executor function
5641
5718
  */
5642
5719
  addTool(schema: IToolSchema, executor: TToolExecutor): void;
5720
+ /** Register a typed result executor without discarding its observations or failure envelope. */
5721
+ addResultTool(schema: IToolSchema, executor: TToolExecutor<TToolParameters, IToolResult>, provenance?: IToolProvenance): void;
5643
5722
  /**
5644
5723
  * Remove a tool by name
5645
5724
  */
@@ -5678,6 +5757,8 @@ declare class Tools extends AbstractManager implements IToolManager {
5678
5757
  * Execute a tool with parameters
5679
5758
  */
5680
5759
  executeTool(name: string, parameters: TToolParameters, context?: IToolExecutionContext): Promise<TUniversalValue>;
5760
+ /** Execute the full result envelope for runtime observation and durable settlement. */
5761
+ executeToolResult(name: string, parameters: TToolParameters, context?: IToolExecutionContext): Promise<IToolResult>;
5681
5762
  /**
5682
5763
  * Check if tool exists
5683
5764
  */
@@ -5700,7 +5781,7 @@ declare class Tools extends AbstractManager implements IToolManager {
5700
5781
  getToolCount(): number;
5701
5782
  }
5702
5783
  //#endregion
5703
- //#region src/core/robota-config-manager.d.ts
5784
+ //#region src/core/agent-config-manager.d.ts
5704
5785
  /** Agent statistics metadata type */
5705
5786
  type TAgentStatsMetadata = Record<string, string | number | boolean | Date | string[]>;
5706
5787
  //#endregion
@@ -5739,9 +5820,9 @@ declare const EXECUTION_EVENTS: {
5739
5820
  };
5740
5821
  declare const EXECUTION_EVENT_PREFIX: "execution";
5741
5822
  //#endregion
5742
- //#region src/core/robota-lifecycle.d.ts
5823
+ //#region src/core/agent-lifecycle.d.ts
5743
5824
  /** Dependencies required by getStats. @internal */
5744
- interface IRobotaStatsDeps {
5825
+ interface IAgentStatsDeps {
5745
5826
  readonly name: string;
5746
5827
  readonly version: string;
5747
5828
  readonly conversationId: string;
@@ -5754,7 +5835,7 @@ interface IRobotaStatsDeps {
5754
5835
  getHistory(): TUniversalMessage[];
5755
5836
  }
5756
5837
  /** Build comprehensive agent statistics. @internal */
5757
- declare function buildAgentStats(deps: IRobotaStatsDeps): {
5838
+ declare function buildAgentStats(deps: IAgentStatsDeps): {
5758
5839
  name: string;
5759
5840
  version: string;
5760
5841
  conversationId: string;
@@ -5772,9 +5853,9 @@ interface IDestroyResult {
5772
5853
  errors: Error[];
5773
5854
  }
5774
5855
  //#endregion
5775
- //#region src/core/robota.d.ts
5856
+ //#region src/core/conversation-agent.d.ts
5776
5857
  /** @public */
5777
- declare class Robota extends RobotaBase implements IAgent<IAgentConfig, IRunOptions, TUniversalMessage> {
5858
+ declare class ConversationAgent extends ConversationAgentBase implements IAgent<IAgentConfig, IRunOptions, TUniversalMessage> {
5778
5859
  readonly version: string;
5779
5860
  private aiProviders;
5780
5861
  private tools;
@@ -5817,14 +5898,14 @@ declare class Robota extends RobotaBase implements IAgent<IAgentConfig, IRunOpti
5817
5898
  */
5818
5899
  resumeToolCalls(value: IResumeToolCallsOptions): Promise<IResumeToolCallsResult>;
5819
5900
  /**
5820
- * Concurrency contract (CORE-012): a Robota instance owns ONE conversation history, so
5901
+ * Concurrency contract (CORE-012): a ConversationAgent instance owns ONE conversation history, so
5821
5902
  * concurrent `run`/`runStream` calls on the same instance are serialized on an internal queue —
5822
5903
  * a call issued while another is in flight waits its turn (its `signal` is honored while queued).
5823
5904
  * Interleaved histories are therefore impossible by construction.
5824
5905
  *
5825
5906
  * Structured output (CORE-015): with `options.output` set the promise resolves to the validated
5826
5907
  * object (typed `z.infer<S>` for a Zod schema) instead of a string. Note the structured typing
5827
- * is visible on `Robota` directly; through the generic `IAgent` interface the return type stays
5908
+ * is visible on `ConversationAgent` directly; through the generic `IAgent` interface the return type stays
5828
5909
  * `Promise<string>`.
5829
5910
  */
5830
5911
  run<S extends ZodType>(input: string, options: TRunOptionsWithOutput<S>): Promise<TypeOf<S>>;
@@ -6791,10 +6872,17 @@ declare const UNCLASSIFIED_TOOL_FALLBACK: Record<TPermissionMode, TPermissionDec
6791
6872
  declare const PROTECTED_DIRECTORY_NAMES: readonly string[];
6792
6873
  /** Files that configure git, npm, MCP servers or the user's shell, wherever they sit. */
6793
6874
  declare const PROTECTED_FILE_NAMES: readonly string[];
6875
+ /** Additional host-owned state protection; common repository and shell protection always applies. */
6876
+ interface IPathProtectionPolicy {
6877
+ readonly protectedDirectoryNames: readonly string[];
6878
+ readonly protectedPaths: readonly string[];
6879
+ readonly writableWorktreeContainers: readonly string[];
6880
+ }
6794
6881
  /** Whether a path names a protected directory, something inside one, or a protected file. */
6795
- declare function isProtectedPath(path: string): boolean;
6882
+ declare function isProtectedPath(path: string, context?: ICriticalPathContext): boolean;
6796
6883
  /** Where a removal is judged from. Either may be unknown; what is unknown is not guessed. */
6797
6884
  interface ICriticalPathContext {
6885
+ readonly pathProtection?: IPathProtectionPolicy;
6798
6886
  /** The session's execution root. */
6799
6887
  cwd?: string;
6800
6888
  /** The user's home directory. */
@@ -7297,5 +7385,9 @@ declare function decodeHookVerdict(raw: string, source: THookDefinition['type'],
7297
7385
  /** Does a hook that reached no verdict block at this event? */
7298
7386
  declare function isEnforcing(event: THookEvent): boolean;
7299
7387
  //#endregion
7300
- export { parseParameterRule as $, IProviderSetupStepDefinition as $a, assertProviderNativeWebToolsAvailable as $c, IProgressReportingTool as $i, isAssistantMessage as $l, ConversationStore as $n, TStructuredOutputValidation as $o, isAbortFailure as $r, USER_EVENT_PREFIX as $s, IRegistryOwnedLifecycle as $t, allowRulesForAutoMode as A, IProviderMediaError as Aa, IRawProviderResponse as Ac, ITerminalOutput as Ai, IModelCapabilityDeviation as Al, EventEmitterPlugin as An, IPluginContext as Ao, TShellKind as Ar, TToolEffectAdmission as As, IHandoffOrchestrationSpec as At, IPermissionPolicyProjection as B, IProviderStructuredOutputCapability as Ba, getProviderCapabilities as Bc, IRemoteExecutorConfig as Bi, ISystemMessage as Bl, createBoundedOutput as Bn, PluginPriority as Bo, ExecutionJournalError as Br, IUserInteraction as Bs, AGENT_EVENTS as Bt, IContextTokenEstimate as C, IImageComposeRequest as Ca, TEventLoggerData as Cc, ICredentialStore as Ci, StructuredOutputError as Cl, EXECUTION_EVENT_PREFIX as Cn, getGlobalLogLevel as Co, spanIdFromMintedId as Cr, IFunctionTool as Cs, createExecutionProxy as Ct, estimateToolSchemaTokens as D, IImageGenerationResult as Da, IProviderNativeRawPayloadEvent as Dc, IStats as Di, ValidationError as Dl, assertResidentToolRemains as Dn, setGlobalLoggerSink as Do, traceHeadersFor as Dr, IToolExecutionResult as Ds, ORCHESTRATION_EVENT_PREFIX as Dt, estimateSerializedContextTokens as E, IImageGenerationRequest as Ea, IChatOptions as Ec, IFileSystemAsync as Ei, ToolExecutionError as El, DEFERRED_WITHOUT_LOADER_MESSAGE as En, setGlobalLogLevel as Eo, traceEnvFor as Er, IToolExecutionContext as Es, ORCHESTRATION_EVENTS as Et, IPermissionPatternProblem as F, IVideoJobSnapshot as Fa, TProviderNativeRawPayloadCallback as Fc, IExecutor as Fi, TProviderModelCapability as Fl, InMemoryEventEmitterMetrics as Fn, IPluginExecutionResult as Fo, TTimerId as Fr, TToolSearchMode as Fs, IOrchestrationStep as Ft, IToolPermissionArgument as G, IProviderDefinitionConfig as Ga, TJSONSchemaKind as Gc, IConversationResponse as Gi, IUserMessage as Gl, resolveEnvReference as Gn, TEventName as Go, validateApiKey as Gr, SPAN_EVENTS as Gs, IAssistantUsageMetadata as Gt, IParameterRule as H, TStructuredOutputProvenance as Ha, IParameterSchema as Hc, TExecutorStreamEvent as Hi, IToolCall as Hl, formatEnvReference as Hn, IEventEmitterEventData as Ho, ISimpleValidationResult as Hr, ISpanCompletionEventData as Hs, peerDriverOf as Ht, findInvalidPermissionPatterns as I, TImageInputSource as Ia, TProviderNativeRawPayloadKind as Ic, IExecutorChatResult as Ii, IAssistantMessage as Il, shellArgumentForDisplay as In, IPluginHooks as Io, isExecutionControlError as Ir, TToolSearchSetting as Is, IOrchestrationStepResult as It, clearRegisteredToolProfiles as J, IProviderModelCatalogEntry as Ja, IProviderCapabilities as Jc, IStreamingChunk as Ji, TUniversalMessageMetadata as Jl, ConversationHistory as Jn, TExecutionEventCallback as Jo, validateUserInput as Jr, TOOL_PERMISSION_EVENTS as Js, sumHistoryUsage as Jt, IToolPermissionProfile as K, IProviderEndpoint as Ka, TParameterDefaultValue as Kc, IConversationService as Ki, TMessageState as Kl, IAIProviderInstance as Kn, TExecutionEventName as Ko, validateModelName as Kr, SPAN_EVENT_PREFIX as Ks, ISessionUsageTotals as Kt, findPermissionPatternWarnings as L, TProviderMediaResult as La, TProviderOptionValueBase as Lc, IExecutorStreamMessageEvent as Li, IBaseMessage as Ll, IBoundedOutput as Ln, IPluginOptions as Lo, ExecutionRecoveryError as Lr, IActionDefault as Ls, IParallelOrchestrationSpec as Lt, splitCommandSegments as M, IVideoGenerationProvider as Ma, ITokenUsageWithCacheRead as Mc, IEventHistoryRecord as Mi, modelDeclaresCapability as Ml, IEventEmitterPluginOptions as Mn, IPluginData as Mo, resolvePlatformShell as Mr, TToolMetadata as Ms, IOrchestrationDelegation as Mt, applyPresetToolLists as N, IVideoGenerationRequest as Na, TProviderConfigValue as Nc, IEventHistorySnapshot as Ni, resolveModelCapabilities as Nl, IEventEmitterMetrics as Nn, IPluginErrorContext as No, startPeriodicTask as Nr, IDeferredToolCatalog as Ns, IOrchestrationEventData as Nt, IContextTokenUsage as O, IInlineImageInputSource as Oa, IProviderOptions as Oc, ISession as Oi, IModelRef as Ol, FunctionTool as On, IPlugin as Oo, IPlatformShell as Or, IToolRegistry as Os, TOrchestrationEvent as Ot, toolNamesToPatterns as P, IVideoJobAccepted as Pa, TProviderNativeRawPayload as Pc, IChatExecutionRequest as Pi, resolveModelCapability as Pl, IEventEmitterMetricsSnapshot as Pn, IPluginExecutionContext as Po, stopPeriodicTask as Pr, TOOL_SEARCH_TOOL_NAME as Ps, IOrchestrationRunResult as Pt, matchesAnyPattern as Q, IProviderSetupHelpLink as Qa, IProviderNativeWebToolRequest as Qc, TToolExecutionParameters as Qi, getMessagesForAPI as Ql, createUserMessage as Qn, TStructuredOutputSchema as Qo, TProviderMessage as Qr, USER_EVENTS as Qs, verifiedProviderCallUsage as Qt, validatePermissionPattern as R, isImageGenerationProvider as Ra, TTextDeltaCallback as Rc, IExecutorStreamTerminalEvent as Ri, IHistoryEntry as Rl, IBoundedOutputOptions as Rn, IPluginStats as Ro, TExecutionRecoveryErrorCode as Rr, IActionOption as Rs, ISequentialOrchestrationSpec as Rt, CONTEXT_ESTIMATE_CHARS_PER_TOKEN as S, isMediaProviderDefinition as Sa, TEventListener as Sc, ICredentialKey as Si, StorageError as Sl, EXECUTION_EVENTS as Sn, createLogger as So, providerCallSpanId as Sr, TJournalModelOptions as Ss, ExecutionProxy as St, estimateContextTokensFromMessages as T, IImageGenerationProvider as Ta, IAIProvider as Tc, IFileSystem as Ti, TErrorExternalInput as Tl, TOOL_EVENT_PREFIX as Tn, logger as To, toolTraceContextFor as Tr, ITool as Ts, IExecutionProxyConfig as Tt, IPermissionEvaluationContext as U, IProviderCredentialRequirement as Ua, IToolSchema as Uc, IContextOptions as Ui, IToolMessage as Ul, hasUsableSecretReference as Un, IEventEmitterPlugin as Uo, Validator as Ur, PROVIDER_CALL_EVENTS as Us, printablePeerDriver as Ut, projectPermissionPolicy as V, TStructuredOutputMechanism as Va, IObjectParameterSchema as Vc, IStreamExecutionRequest as Vi, ITextMessagePart as Vl, ENV_REFERENCE_PREFIX as Vn, EVENT_EMITTER_EVENTS as Vo, ErrorUtils as Vr, TActionResponse as Vs, AGENT_EVENT_PREFIX as Vt, IPermissionLists as W, IProviderDefinition as Wa, TJSONSchemaEnum as Wc, IConversationContext as Wi, IUriImageMessagePart as Wl, isEnvReference as Wn, TEventEmitterListener as Wo, validateAgentConfig as Wr, PROVIDER_FALLBACK_EVENTS as Ws, EventHistoryModule as Wt, getToolPermissionProfile as X, IProviderProfileConfig as Xa, IProviderNativeWebToolCapabilities as Xc, TConversationContextMetadata as Xi, TUniversalMessageRole as Xl, createSystemMessage as Xn, IJsonSchemaOutput as Xo, TMessageConverterRegistry as Xr, readModelFallbackNotice as Xs, IVerifiedProviderCallUsage as Xt, evaluatePermission as Y, IProviderProbeResult as Ya, IProviderFunctionCallingCapability as Yc, IToolExecutionRequest as Yi, TUniversalMessagePart as Yl, createAssistantMessage as Yn, TExecutionEventData as Yo, MessageConverter as Yr, TSpanEvent as Ys, sumMessagesUsage as Yt, isToolDeniedOutright as Z, IProviderProfileDefaults as Za, IProviderNativeWebToolCapability as Zc, TResponseMetadata as Zi, chatEntryToMessage as Zl, createToolMessage as Zn, IStructuredOutputSpec as Zo, TMessageFormatConverter as Zr, TUserEvent as Zs, TProviderUsageProvenance as Zt, getModelName as _, TManagerToolParameters as _a, IEventServiceOwnerBinding as _c, hashToolSchema as _i, PluginError as _l, ToolResultAdmissionError as _n, ILogger as _o, zodToJsonSchema as _r, IRecoverableExecutionJournal as _s, TBackgroundPermissionPolicy as _t, TMetadataValue as _u, IModelPrice as a, setToolProgressCallback as aa, ObservableEventService as ac, IProviderRuntimeConfig as ai, classifyProviderFailure as al, AgentFactory as an, findProviderDefinition as ao, resolveMediaProviderConfig as ar, IZodSchema as as, PROTECTED_FILE_NAMES as at, IToolActionIdentity as au, readTokenUsageFromMessage as b, IMediaProviderDefinition as ba, IToolEventData as bc, IManagerLifecycleOptions as bi, RobotaError as bl, Robota as bn, SilentLogger as bo, isMintedSpanId as br, IResumeToolCallsResult as bs, TRUST_TO_MODE as bt, estimateBlendedCostPer1000 as c, confirmAction as ca, bindWithOwnerPath as cc, IToolSchemaProjectionChange as ci, toProviderError as cl, IAgentCreationStats as cn, IAgent as co, processEnvResolver as cr, ICacheEntry as cs, RISK_CLASS_POLICY as ct, IToolWaitRequest as cu, DEFAULT_MAX_OUTPUT as d, selectAction as da, isDefaultEventService as dc, PERMISSIVE_TOOL_SCHEMA_PROFILE as di, CircuitBreakerOpenError as dl, DEFAULT_TOOL_RESULT_HARD_CHARS as dn, IAbstractTool as do, extractEnumValues as dr, ICacheStats as ds, TArgumentKind as dt, TComplexConfigValue as du, IToolExecutionStep as ea, TASK_EVENTS as ec, AbstractTool as ei, createDefaultProviderCapabilities as el, IRegistryTransactionError as en, TProviderCredentialField as eo, createProviderFromConfig as er, normalizeStructuredOutput as es, registerToolPermissionProfile as et, isChatEntry as eu, IModelDefinition as f, textAction as fa, IAgentEventData as fc, STRICT_TOOL_SCHEMA_PROFILE as fi, ConfigurationError as fl, DEFAULT_TOOL_RESULT_WARNING_CHARS as fn, IAbstractToolOptions as fo, getSchemaTypeName as fr, ICacheStorage as fs, TMatchDirection as ft, TConfigData as fu, getModelMaxOutput as g, IToolManager as ga, IEventService as gc, TToolSchemaProjectionProfileBase as gi, NetworkError as gl, TToolResultAdmissionErrorCode as gn, ConsoleLogger as go, closeObjectSchemas as gr, IModelJournalContext as gs, DEFAULT_BACKGROUND_PERMISSION_POLICY as gt, TMetadata as gu, getModelContextWindow as h, IAIProviderManager as ha, IEventObjectValue as hc, TToolSchemaProjectionOutcome as hi, ModelNotAvailableError as hl, MAX_TOOL_RESULT_CHARS as hn, TToolExecutionFunction as ho, ISchemaClosureOptions as hr, IExecutionRoundCheckpoint as hs, isReadOnlyCommandLine as ht, TLoggerData as hu, runHooks as i, isProgressReportingTool as ia, DefaultEventService as ic, IExecutorAwareProviderConfig as ii, TProviderFailureReason as il, runRegistryTransaction as in, TProviderSetupHelpLinkKind as io, createVideoProviderFromDefinition as ir, IZodParseResult as is, PROTECTED_DIRECTORY_NAMES as it, messageToHistoryEntry as iu, isBroadExecutionAllowRule as j, IUriImageInputSource as ja, ITokenUsage as jc, IEventHistoryModule as ji, IProviderCapabilityTable as jl, IEventEmitterHierarchicalEventData as jn, IPluginContract as jo, UnsupportedShellError as jr, TToolExecutor as js, IHierarchicalOrchestrationSpec as jt, IContextWindowState as k, IMediaOutputRef as ka, IProviderRequest as kc, ISpinner as ki, TRoleModelMap as kl, ToolRegistry as kn, IPluginConfig as ko, IPlatformShellResolutionRequest as kr, IToolResult as ks, IGroupChatOrchestrationSpec as kt, lookupModelPrice as l, isConfirmed as la, composeEventName as lc, IToolSchemaProjectionProfile as li, AuthenticationError as ll, IAgentFactoryOptions as ln, IAgentConfig as lo, IStructuredOutputResolutionInput as lr, ICacheKey as ls, TToolRiskClass as lt, IToolWaitResponse as lu, formatTokenCount as m, IToolFactory as ma, IEventContext as mc, TOOL_SCHEMA_PROJECTION_MAX_NODES as mi, IProviderFailureDetails as ml, IToolResultSpillStore as mn, IToolWithEventService as mo, ISchemaClosureChange as mr, IExecutionJournal as ms, TResolveInWorkspace as mt, TContextData as mu, decodeHookVerdict as n, getToolEstimatedDuration as na, AbstractEventService as nc, AbstractPlugin as ni, TModelFallbackCallback as nl, isRegistryTransactionError as nn, TProviderModelLifecycle as no, IMediaProviderOverrides as nr, validateAgainstJsonSchema as ns, toolNameMatches as nt, isToolMessage as nu, MODEL_PRICES as o, CONFIRM_NO as oa, StructuredEventService as oc, TProviderLoggingData as oi, readProviderFailureDetails as ol, AgentTemplates as on, formatSupportedProviderTypes as oo, TEnvResolver as or, IZodSchemaDef as os, isProtectedPath as ot, IToolContinuation as ou, findModelDefinition as p, IOpenAPIToolConfig as pa, IBaseEventData as pc, TOOL_SCHEMA_PROJECTION_MAX_DEPTH as pi, EmptyCompletionError as pl, IToolResultAdmissionOptions as pn, IToolContract as po, hasValidationConstraints as pr, IExecutionContinuationState as ps, IReadOnlyCommandContext as pt, TConfigValue as pu, TToolArgs as q, IProviderModelCatalog as qa, IProviderSpecificOptions as qc, IConversationServiceOptions as qi, TUniversalMessage as ql, LocalExecutor as qn, IRunOptions as qo, validateProviderName as qr, TOOL_BODY_EVENTS as qs, collectAssistantUsageMetadata as qt, GuardrailExecutor as r, getToolExecutionSteps as ra, DEFAULT_ABSTRACT_EVENT_SERVICE as rc, AbstractAIProvider as ri, IProviderFailureClassification as rl, lifecycleOf as rn, TProviderSetupField as ro, createImageProviderFromDefinition as rr, ISchemaConversionOptions as rs, ICriticalPathContext as rt, isUserMessage as ru, calculateModelCost as s, CONFIRM_YES as sa, bindEventServiceOwner as sc, IToolSchemaProjection as si, scrubSecrets as sl, ITemplateApplicationResult as sn, getProviderCredentialRequirement as so, createRecordEnvResolver as sr, IResponseFormatConfig as ss, removesCriticalPath as st, IToolContinuationPrompt as su, isEnforcing as t, TToolProgressCallback as ta, TASK_EVENT_PREFIX as tc, AbstractExecutor as ti, IModelFallbackNotice as tl, IRegistryTransactionStep as tn, TProviderModelCatalogStatus as to, normalizeProviderConfig as tr, parseStructuredResponseText as ts, requiresFreshApproval as tt, isSystemMessage as tu, DEFAULT_CONTEXT_WINDOW as u, multiSelectAction as ua, generateSpanId as uc, PARAMETER_SCHEMA_KEYWORDS as ui, CacheIntegrityError as ul, IAgentLifecycleEvents as un, IAgentTemplate as uo, resolveStructuredOutputCapability as ur, ICacheOptions as us, UNCLASSIFIED_TOOL_FALLBACK as ut, IToolWaitState as uu, registerModelMetadata as v, IMediaProviderConfig as va, IExecutionEventData as vc, projectToolSchema as vi, ProviderError as vl, admitToolResult as vn, ILoggerOptions as vo, callJournaledProvider as vr, IResumeExecutionOptions as vs, TPermissionDecision$1 as vt, TToolParameters as vu, IContextTokenEstimateOptions as w, IImageEditRequest as wa, TEventUniversalValue as wc, IDirent as wi, TErrorContextData as wl, TOOL_EVENTS as wn, getGlobalLoggerSink as wo, subprocessTraceEnvironment as wr, IParameterValidationResult as ws, withEventEmission as wt, readTokenUsageFromMetadata as x, findMediaProviderDefinition as xa, TEventExtensionValue as xc, AbstractAgent as xi, SameToolInputLoopError as xl, IDestroyResult as xn, TUtilLogLevel as xo, outboundTraceContextFor as xr, TExecutionJournalRecord as xs, TTrustLevel as xt, IMessageTokenUsage as y, IMediaProviderCredentialRequirement as ya, IOwnerPathSegment as yc, AbstractManager as yi, RateLimitError as yl, wasToolResultAdmitted as yn, IUtilLogEntry as yo, buildTraceparent as yr, IResumeToolCallsOptions as ys, TPermissionMode as yt, TypeUtils as yu, IPermissionPolicyContext as z, isVideoGenerationProvider as za, TToolChoice as zc, ILocalExecutorConfig as zi, IInlineImageMessagePart as zl, TOutputRetention as zn, PluginCategory as zo, ExecutionSuspendedError as zr, IActionRequest as zs, TOrchestrationPrimitive as zt };
7301
- //# sourceMappingURL=index-CPwJEiFl.d.cts.map
7388
+ //#region src/utils/non-visual-observation-text.d.ts
7389
+ /** Text projection for adapters without native resource or audio payload support. Never resolves URIs. */
7390
+ declare function nonVisualObservationText(part: TUniversalMessagePart): string | undefined;
7391
+ //#endregion
7392
+ export { matchesAnyPattern as $, IProviderProbeResult as $a, TJSONSchemaKind as $c, IToolExecutionRequest as $i, IToolMessage as $l, createToolMessage as $n, TExecutionEventData as $o, TMessageFormatConverter as $r, SPAN_EVENT_PREFIX as $s, TProviderUsageProvenance as $t, IContextWindowState as A, IImageGenerationRequest as Aa, TEventListener as Ac, IFileSystemAsync as Ai, StorageError as Al, FunctionTool as An, setGlobalLogLevel as Ao, IPlatformShell as Ar, IToolCallScheduling as As, TOrchestrationEvent as At, TypeUtils as Au, IPermissionPolicyContext as B, TImageInputSource as Ba, ITokenUsageWithCacheRead as Bc, IExecutorChatResult as Bi, modelDeclaresCapability as Bl, IBoundedOutputOptions as Bn, IPluginHooks as Bo, TExecutionRecoveryErrorCode as Br, IDeferredToolCatalog as Bs, ISequentialOrchestrationSpec as Bt, CONTEXT_ESTIMATE_CHARS_PER_TOKEN as C, IMediaProviderCredentialRequirement as Ca, IEventObjectValue as Cc, AbstractAgent as Ci, IProviderFailureDetails as Cl, IDestroyResult as Cn, IUtilLogEntry as Co, outboundTraceContextFor as Cr, IResumeToolCallsOptions as Cs, TTrustLevel as Ct, TConfigData as Cu, estimateSerializedContextTokens as D, IImageComposeRequest as Da, IOwnerPathSegment as Dc, ICredentialStore as Di, ProviderError as Dl, TOOL_EVENT_PREFIX as Dn, getGlobalLogLevel as Do, toolTraceContextFor as Dr, IFunctionTool as Ds, IExecutionProxyConfig as Dt, TMetadata as Du, estimateContextTokensFromMessages as E, isMediaProviderDefinition as Ea, IExecutionEventData as Ec, ICredentialKey as Ei, PluginError as El, TOOL_EVENTS as En, createLogger as Eo, subprocessTraceEnvironment as Er, TJournalModelOptions as Es, withEventEmission as Et, TLoggerData as Eu, toolNamesToPatterns as F, IUriImageInputSource as Fa, IProviderNativeRawPayloadEvent as Fc, IEventHistoryModule as Fi, ValidationError as Fl, IEventEmitterMetrics as Fn, IPluginContract as Fo, startPeriodicTask as Fr, IToolRegistry as Fs, IOrchestrationEventData as Ft, IPermissionLists as G, TStructuredOutputMechanism as Ga, TProviderOptionValueBase as Gc, IStreamExecutionRequest as Gi, IBaseMessage as Gl, hasUsableSecretReference as Gn, EVENT_EMITTER_EVENTS as Go, Validator as Gr, IActionOption as Gs, printablePeerDriver as Gt, projectPermissionPolicy as H, isImageGenerationProvider as Ha, TProviderNativeRawPayload as Hc, IExecutorStreamTerminalEvent as Hi, resolveModelCapability as Hl, createBoundedOutput as Hn, IPluginStats as Ho, ExecutionJournalError as Hr, TToolSearchMode as Hs, AGENT_EVENTS as Ht, IPermissionPatternProblem as I, IVideoGenerationProvider as Ia, IProviderOptions as Ic, IEventHistoryRecord as Ii, IModelRef as Il, IEventEmitterMetricsSnapshot as In, IPluginData as Io, stopPeriodicTask as Ir, IToolResult as Is, IOrchestrationRunResult as It, TToolArgs as J, IProviderDefinition as Ja, getProviderCapabilities as Jc, IConversationContext as Ji, IInlineImageMessagePart as Jl, IAIProviderInstance as Jn, TEventEmitterListener as Jo, validateModelName as Jr, TActionResponse as Js, ISessionUsageTotals as Jt, IToolPermissionArgument as K, TStructuredOutputProvenance as Ka, TTextDeltaCallback as Kc, TExecutorStreamEvent as Ki, IHistoryEntry as Kl, isEnvReference as Kn, IEventEmitterEventData as Ko, validateAgentConfig as Kr, IActionRequest as Ks, EventHistoryModule as Kt, findInvalidPermissionPatterns as L, IVideoGenerationRequest as La, IProviderRequest as Lc, IEventHistorySnapshot as Li, TRoleModelMap as Ll, InMemoryEventEmitterMetrics as Ln, IPluginErrorContext as Lo, TTimerId as Lr, TToolEffectAdmission as Ls, IOrchestrationStep as Lt, isBroadExecutionAllowRule as M, IInlineImageInputSource as Ma, TEventUniversalValue as Mc, ISession as Mi, TErrorContextData as Ml, EventEmitterPlugin as Mn, IPlugin as Mo, TShellKind as Mr, IToolExecutionPolicy as Ms, IHandoffOrchestrationSpec as Mt, splitCommandSegments as N, IMediaOutputRef as Na, IAIProvider as Nc, ISpinner as Ni, TErrorExternalInput as Nl, IEventEmitterHierarchicalEventData as Nn, IPluginConfig as No, UnsupportedShellError as Nr, IToolExecutionResult as Ns, IHierarchicalOrchestrationSpec as Nt, estimateToolSchemaTokens as O, IImageEditRequest as Oa, IToolEventData as Oc, IDirent as Oi, RateLimitError as Ol, DEFERRED_WITHOUT_LOADER_MESSAGE as On, getGlobalLoggerSink as Oo, traceEnvFor as Or, IParameterValidationResult as Os, ORCHESTRATION_EVENTS as Ot, TMetadataValue as Ou, applyPresetToolLists as P, IProviderMediaError as Pa, IChatOptions as Pc, ITerminalOutput as Pi, ToolExecutionError as Pl, IEventEmitterPluginOptions as Pn, IPluginContext as Po, resolvePlatformShell as Pr, IToolProvenance as Ps, IOrchestrationDelegation as Pt, isToolDeniedOutright as Q, IProviderModelCatalogEntry as Qa, TJSONSchemaEnum as Qc, IStreamingChunk as Qi, IToolCall as Ql, createSystemMessage as Qn, TExecutionEventCallback as Qo, TMessageConverterRegistry as Qr, SPAN_EVENTS as Qs, IVerifiedProviderCallUsage as Qt, findPermissionPatternWarnings as R, IVideoJobAccepted as Ra, IRawProviderResponse as Rc, IChatExecutionRequest as Ri, IModelCapabilityDeviation as Rl, shellArgumentForDisplay as Rn, IPluginExecutionContext as Ro, isExecutionControlError as Rr, TToolExecutor as Rs, IOrchestrationStepResult as Rt, readTokenUsageFromMetadata as S, IMediaProviderConfig as Sa, IEventContext as Sc, IManagerLifecycleOptions as Si, EmptyCompletionError as Sl, ConversationAgent as Sn, ILoggerOptions as So, isMintedSpanId as Sr, IResumeExecutionOptions as Ss, TRUST_TO_MODE as St, TComplexConfigValue as Su, IContextTokenEstimateOptions as T, findMediaProviderDefinition as Ta, IEventServiceOwnerBinding as Tc, withToolProvenance as Ti, NetworkError as Tl, EXECUTION_EVENT_PREFIX as Tn, TUtilLogLevel as To, spanIdFromMintedId as Tr, TExecutionJournalRecord as Ts, createExecutionProxy as Tt, TContextData as Tu, IParameterRule as U, isVideoGenerationProvider as Ua, TProviderNativeRawPayloadCallback as Uc, ILocalExecutorConfig as Ui, TProviderModelCapability as Ul, ENV_REFERENCE_PREFIX as Un, PluginCategory as Uo, ErrorUtils as Ur, TToolSearchSetting as Us, AGENT_EVENT_PREFIX as Ut, IPermissionPolicyProjection as V, TProviderMediaResult as Va, TProviderConfigValue as Vc, IExecutorStreamMessageEvent as Vi, resolveModelCapabilities as Vl, TOutputRetention as Vn, IPluginOptions as Vo, ExecutionSuspendedError as Vr, TOOL_SEARCH_TOOL_NAME as Vs, TOrchestrationPrimitive as Vt, IPermissionEvaluationContext as W, IProviderStructuredOutputCapability as Wa, TProviderNativeRawPayloadKind as Wc, IRemoteExecutorConfig as Wi, IAssistantMessage as Wl, formatEnvReference as Wn, PluginPriority as Wo, ISimpleValidationResult as Wr, IActionDefault as Ws, peerDriverOf as Wt, evaluatePermission as X, IProviderEndpoint as Xa, IParameterSchema as Xc, IConversationService as Xi, ISystemMessage as Xl, ConversationHistory as Xn, TExecutionEventName as Xo, validateUserInput as Xr, PROVIDER_CALL_EVENTS as Xs, sumHistoryUsage as Xt, clearRegisteredToolProfiles as Y, IProviderDefinitionConfig as Ya, IObjectParameterSchema as Yc, IConversationResponse as Yi, IResourceLinkMessagePart as Yl, LocalExecutor as Yn, TEventName as Yo, validateProviderName as Yr, ISpanCompletionEventData as Ys, collectAssistantUsageMetadata as Yt, getToolPermissionProfile as Z, IProviderModelCatalog as Za, IToolSchema as Zc, IConversationServiceOptions as Zi, ITextMessagePart as Zl, createAssistantMessage as Zn, IRunOptions as Zo, MessageConverter as Zr, PROVIDER_FALLBACK_EVENTS as Zs, sumMessagesUsage as Zt, getModelMaxOutput as _, IOpenAPIToolConfig as _a, composeEventName as _c, TToolSchemaProjectionOutcome as _i, AgentRuntimeError as _l, MAX_TOOL_RESULT_CHARS as _n, IToolContract as _o, ISchemaClosureOptions as _r, IExecutionContinuationState as _s, isReadOnlyCommandLine as _t, IToolContinuation as _u, runHooks as a, TToolProgressCallback as aa, TUserEvent as ac, AbstractAIProvider as ai, IProviderNativeWebToolCapability as al, lifecycleOf as an, TProviderModelCatalogStatus as ao, createImageProviderFromDefinition as ar, parseStructuredResponseText as as, IPathProtectionPolicy as at, TUniversalMessageMetadata as au, IMessageTokenUsage as b, IToolManager as ba, IAgentEventData as bc, projectToolSchema as bi, CircuitBreakerOpenError as bl, admitToolResult as bn, ConsoleLogger as bo, callJournaledProvider as br, IModelJournalContext as bs, TPermissionDecision$1 as bt, IToolWaitResponse as bu, calculateModelCost as c, isProgressReportingTool as ca, TASK_EVENTS as cc, TProviderLoggingData as ci, createDefaultProviderCapabilities as cl, AgentTemplates as cn, TProviderSetupHelpLinkKind as co, TEnvResolver as cr, IZodParseResult as cs, isProtectedPath as ct, chatEntryToMessage as cu, DEFAULT_CONTEXT_WINDOW as d, CONFIRM_YES as da, DEFAULT_ABSTRACT_EVENT_SERVICE as dc, IToolSchemaProjectionProfile as di, IProviderFailureClassification as dl, IAgentFactoryOptions as dn, getProviderCredentialRequirement as do, IStructuredOutputResolutionInput as dr, IResponseFormatConfig as ds, TToolRiskClass as dt, isChatEntry as du, TConversationContextMetadata as ea, TOOL_BODY_EVENTS as ec, TProviderMessage as ei, TParameterDefaultValue as el, verifiedProviderCallUsage as en, IProviderProfileConfig as eo, createUserMessage as er, IJsonSchemaOutput as es, parseParameterRule as et, IUriImageMessagePart as eu, DEFAULT_MAX_OUTPUT as f, confirmAction as fa, DefaultEventService as fc, PARAMETER_SCHEMA_KEYWORDS as fi, TProviderFailureReason as fl, IAgentLifecycleEvents as fn, IAgent as fo, resolveStructuredOutputCapability as fr, ICacheEntry as fs, UNCLASSIFIED_TOOL_FALLBACK as ft, isSystemMessage as fu, getModelContextWindow as g, textAction as ga, bindWithOwnerPath as gc, TOOL_SCHEMA_PROJECTION_MAX_NODES as gi, toProviderError as gl, IToolResultSpillStore as gn, IAbstractToolOptions as go, ISchemaClosureChange as gr, ICacheStorage as gs, TResolveInWorkspace as gt, IToolActionIdentity as gu, formatTokenCount as h, selectAction as ha, bindEventServiceOwner as hc, TOOL_SCHEMA_PROJECTION_MAX_DEPTH as hi, scrubSecrets as hl, IToolResultAdmissionOptions as hn, IAbstractTool as ho, hasValidationConstraints as hr, ICacheStats as hs, IReadOnlyCommandContext as ht, messageToHistoryEntry as hu, GuardrailExecutor as i, IToolExecutionStep as ia, readModelFallbackNotice as ic, AbstractPlugin as ii, IProviderNativeWebToolCapabilities as il, isRegistryTransactionError as in, TProviderCredentialField as io, IMediaProviderOverrides as ir, normalizeStructuredOutput as is, ICriticalPathContext as it, TUniversalMessage as iu, allowRulesForAutoMode as j, IImageGenerationResult as ja, TEventLoggerData as jc, IStats as ji, StructuredOutputError as jl, ToolRegistry as jn, setGlobalLoggerSink as jo, IPlatformShellResolutionRequest as jr, IToolExecutionContext as js, IGroupChatOrchestrationSpec as jt, IContextTokenUsage as k, IImageGenerationProvider as ka, TEventExtensionValue as kc, IFileSystem as ki, SameToolInputLoopError as kl, assertResidentToolRemains as kn, logger as ko, traceHeadersFor as kr, ITool as ks, ORCHESTRATION_EVENT_PREFIX as kt, TToolParameters as ku, estimateBlendedCostPer1000 as l, setToolProgressCallback as la, TASK_EVENT_PREFIX as lc, IToolSchemaProjection as li, IModelFallbackNotice as ll, ITemplateApplicationResult as ln, findProviderDefinition as lo, createRecordEnvResolver as lr, IZodSchema as ls, removesCriticalPath as lt, getMessagesForAPI as lu, findModelDefinition as m, multiSelectAction as ma, StructuredEventService as mc, STRICT_TOOL_SCHEMA_PROFILE as mi, readProviderFailureDetails as ml, DEFAULT_TOOL_RESULT_WARNING_CHARS as mn, IAgentTemplate as mo, getSchemaTypeName as mr, ICacheOptions as ms, TMatchDirection as mt, isUserMessage as mu, isEnforcing as n, TToolExecutionParameters as na, TOOL_QUEUE_EVENTS as nc, AbstractTool as ni, IProviderCapabilities as nl, IRegistryTransactionError as nn, IProviderSetupHelpLink as no, createProviderFromConfig as nr, TStructuredOutputSchema as ns, requiresFreshApproval as nt, TEmbeddedResourceMessagePart as nu, IModelPrice as o, getToolEstimatedDuration as oa, USER_EVENTS as oc, IExecutorAwareProviderConfig as oi, IProviderNativeWebToolRequest as ol, runRegistryTransaction as on, TProviderModelLifecycle as oo, createVideoProviderFromDefinition as or, validateAgainstJsonSchema as os, PROTECTED_DIRECTORY_NAMES as ot, TUniversalMessagePart as ou, IModelDefinition as p, isConfirmed as pa, ObservableEventService as pc, PERMISSIVE_TOOL_SCHEMA_PROFILE as pi, classifyProviderFailure as pl, DEFAULT_TOOL_RESULT_HARD_CHARS as pn, IAgentConfig as po, extractEnumValues as pr, ICacheKey as ps, TArgumentKind as pt, isToolMessage as pu, IToolPermissionProfile as q, IProviderCredentialRequirement as qa, TToolChoice as qc, IContextOptions as qi, IInlineAudioMessagePart as ql, resolveEnvReference as qn, IEventEmitterPlugin as qo, validateApiKey as qr, IUserInteraction as qs, IAssistantUsageMetadata as qt, decodeHookVerdict as r, IProgressReportingTool as ra, TSpanEvent as rc, AbstractExecutor as ri, IProviderFunctionCallingCapability as rl, IRegistryTransactionStep as rn, IProviderSetupStepDefinition as ro, normalizeProviderConfig as rr, TStructuredOutputValidation as rs, toolNameMatches as rt, TMessageState as ru, MODEL_PRICES as s, getToolExecutionSteps as sa, USER_EVENT_PREFIX as sc, IProviderRuntimeConfig as si, assertProviderNativeWebToolsAvailable as sl, AgentFactory as sn, TProviderSetupField as so, resolveMediaProviderConfig as sr, ISchemaConversionOptions as ss, PROTECTED_FILE_NAMES as st, TUniversalMessageRole as su, nonVisualObservationText as t, TResponseMetadata as ta, TOOL_PERMISSION_EVENTS as tc, isAbortFailure as ti, IProviderSpecificOptions as tl, IRegistryOwnedLifecycle as tn, IProviderProfileDefaults as to, ConversationStore as tr, IStructuredOutputSpec as ts, registerToolPermissionProfile as tt, IUserMessage as tu, lookupModelPrice as u, CONFIRM_NO as ua, AbstractEventService as uc, IToolSchemaProjectionChange as ui, TModelFallbackCallback as ul, IAgentCreationStats as un, formatSupportedProviderTypes as uo, processEnvResolver as ur, IZodSchemaDef as us, RISK_CLASS_POLICY as ut, isAssistantMessage as uu, getModelName as v, IToolFactory as va, generateSpanId as vc, TToolSchemaProjectionProfileBase as vi, AuthenticationError as vl, TToolResultAdmissionErrorCode as vn, IToolWithEventService as vo, closeObjectSchemas as vr, IExecutionJournal as vs, DEFAULT_BACKGROUND_PERMISSION_POLICY as vt, IToolContinuationPrompt as vu, IContextTokenEstimate as w, IMediaProviderDefinition as wa, IEventService as wc, snapshotToolProvenance as wi, ModelNotAvailableError as wl, EXECUTION_EVENTS as wn, SilentLogger as wo, providerCallSpanId as wr, IResumeToolCallsResult as ws, ExecutionProxy as wt, TConfigValue as wu, readTokenUsageFromMessage as x, TManagerToolParameters as xa, IBaseEventData as xc, AbstractManager as xi, ConfigurationError as xl, wasToolResultAdmitted as xn, ILogger as xo, buildTraceparent as xr, IRecoverableExecutionJournal as xs, TPermissionMode as xt, IToolWaitState as xu, registerModelMetadata as y, IAIProviderManager as ya, isDefaultEventService as yc, hashToolSchema as yi, CacheIntegrityError as yl, ToolResultAdmissionError as yn, TToolExecutionFunction as yo, zodToJsonSchema as yr, IExecutionRoundCheckpoint as ys, TBackgroundPermissionPolicy as yt, IToolWaitRequest as yu, validatePermissionPattern as z, IVideoJobSnapshot as za, ITokenUsage as zc, IExecutor as zi, IProviderCapabilityTable as zl, IBoundedOutput as zn, IPluginExecutionResult as zo, ExecutionRecoveryError as zr, TToolMetadata as zs, IParallelOrchestrationSpec as zt };
7393
+ //# sourceMappingURL=index-CagopdzH.d.cts.map