@strands-agents/sdk 1.11.1 → 1.12.0

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 (130) hide show
  1. package/README.md +0 -1
  2. package/dist/src/agent/agent-as-tool.d.ts +22 -0
  3. package/dist/src/agent/agent-as-tool.d.ts.map +1 -1
  4. package/dist/src/agent/agent-as-tool.js +16 -0
  5. package/dist/src/agent/agent-as-tool.js.map +1 -1
  6. package/dist/src/agent/agent-delegation.d.ts +85 -0
  7. package/dist/src/agent/agent-delegation.d.ts.map +1 -0
  8. package/dist/src/agent/agent-delegation.js +290 -0
  9. package/dist/src/agent/agent-delegation.js.map +1 -0
  10. package/dist/src/agent/agent.d.ts +20 -4
  11. package/dist/src/agent/agent.d.ts.map +1 -1
  12. package/dist/src/agent/agent.js +32 -6
  13. package/dist/src/agent/agent.js.map +1 -1
  14. package/dist/src/context-manager/modes/agentic/agentic-context.d.ts +5 -0
  15. package/dist/src/context-manager/modes/agentic/agentic-context.d.ts.map +1 -1
  16. package/dist/src/context-manager/modes/agentic/agentic-context.js +6 -1
  17. package/dist/src/context-manager/modes/agentic/agentic-context.js.map +1 -1
  18. package/dist/src/conversation-manager/conversation-manager.d.ts +0 -2
  19. package/dist/src/conversation-manager/conversation-manager.d.ts.map +1 -1
  20. package/dist/src/conversation-manager/conversation-manager.js +2 -10
  21. package/dist/src/conversation-manager/conversation-manager.js.map +1 -1
  22. package/dist/src/index.d.ts +1 -1
  23. package/dist/src/index.d.ts.map +1 -1
  24. package/dist/src/index.js.map +1 -1
  25. package/dist/src/mcp/client.d.ts +35 -1
  26. package/dist/src/mcp/client.d.ts.map +1 -1
  27. package/dist/src/mcp/client.js +64 -11
  28. package/dist/src/mcp/client.js.map +1 -1
  29. package/dist/src/mcp/config.d.ts +15 -0
  30. package/dist/src/mcp/config.d.ts.map +1 -1
  31. package/dist/src/mcp/config.js.map +1 -1
  32. package/dist/src/mcp/config.node.d.ts.map +1 -1
  33. package/dist/src/mcp/config.node.js +24 -0
  34. package/dist/src/mcp/config.node.js.map +1 -1
  35. package/dist/src/mcp/index.d.ts +2 -2
  36. package/dist/src/mcp/index.d.ts.map +1 -1
  37. package/dist/src/mcp/index.js.map +1 -1
  38. package/dist/src/middleware/interrupt.d.ts +4 -1
  39. package/dist/src/middleware/interrupt.d.ts.map +1 -1
  40. package/dist/src/middleware/interrupt.js +4 -2
  41. package/dist/src/middleware/interrupt.js.map +1 -1
  42. package/dist/src/models/defaults.d.ts +2 -0
  43. package/dist/src/models/defaults.d.ts.map +1 -1
  44. package/dist/src/models/defaults.js +16 -0
  45. package/dist/src/models/defaults.js.map +1 -1
  46. package/dist/src/models/model.d.ts +10 -0
  47. package/dist/src/models/model.d.ts.map +1 -1
  48. package/dist/src/models/model.js +19 -1
  49. package/dist/src/models/model.js.map +1 -1
  50. package/dist/src/models/openai/mantle.d.ts +10 -8
  51. package/dist/src/models/openai/mantle.d.ts.map +1 -1
  52. package/dist/src/models/openai/mantle.js +22 -17
  53. package/dist/src/models/openai/mantle.js.map +1 -1
  54. package/dist/src/multiagent/swarm.d.ts +18 -0
  55. package/dist/src/multiagent/swarm.d.ts.map +1 -1
  56. package/dist/src/multiagent/swarm.js +57 -1
  57. package/dist/src/multiagent/swarm.js.map +1 -1
  58. package/dist/src/sandbox/docker.js +4 -4
  59. package/dist/src/sandbox/docker.js.map +1 -1
  60. package/dist/src/sandbox/ssh.js +4 -4
  61. package/dist/src/sandbox/ssh.js.map +1 -1
  62. package/dist/src/session/file-storage.d.ts +1 -1
  63. package/dist/src/session/file-storage.d.ts.map +1 -1
  64. package/dist/src/session/file-storage.js +3 -2
  65. package/dist/src/session/file-storage.js.map +1 -1
  66. package/dist/src/session/s3-storage.d.ts.map +1 -1
  67. package/dist/src/session/s3-storage.js +2 -1
  68. package/dist/src/session/s3-storage.js.map +1 -1
  69. package/dist/src/session/session-manager.d.ts +6 -2
  70. package/dist/src/session/session-manager.d.ts.map +1 -1
  71. package/dist/src/session/session-manager.js +17 -1
  72. package/dist/src/session/session-manager.js.map +1 -1
  73. package/dist/src/session/validation.d.ts +10 -0
  74. package/dist/src/session/validation.d.ts.map +1 -1
  75. package/dist/src/session/validation.js +14 -0
  76. package/dist/src/session/validation.js.map +1 -1
  77. package/dist/src/storage/in-memory-storage.d.ts +4 -3
  78. package/dist/src/storage/in-memory-storage.d.ts.map +1 -1
  79. package/dist/src/storage/in-memory-storage.js +4 -3
  80. package/dist/src/storage/in-memory-storage.js.map +1 -1
  81. package/dist/src/storage/local-file-storage.d.ts +1 -1
  82. package/dist/src/storage/local-file-storage.js +1 -1
  83. package/dist/src/storage/s3-storage.d.ts +1 -1
  84. package/dist/src/storage/s3-storage.js +1 -1
  85. package/dist/src/storage/storage.d.ts +21 -8
  86. package/dist/src/storage/storage.d.ts.map +1 -1
  87. package/dist/src/storage/storage.js +16 -5
  88. package/dist/src/storage/storage.js.map +1 -1
  89. package/dist/src/telemetry/tracer.d.ts.map +1 -1
  90. package/dist/src/telemetry/tracer.js +11 -0
  91. package/dist/src/telemetry/tracer.js.map +1 -1
  92. package/dist/src/tsconfig.tsbuildinfo +1 -1
  93. package/dist/src/types/agent.d.ts +9 -0
  94. package/dist/src/types/agent.d.ts.map +1 -1
  95. package/dist/src/types/agent.js.map +1 -1
  96. package/dist/src/vended-interventions/hitl/classifier.d.ts +33 -0
  97. package/dist/src/vended-interventions/hitl/classifier.d.ts.map +1 -0
  98. package/dist/src/vended-interventions/hitl/classifier.js +63 -0
  99. package/dist/src/vended-interventions/hitl/classifier.js.map +1 -0
  100. package/dist/src/vended-interventions/hitl/hitl.d.ts +32 -4
  101. package/dist/src/vended-interventions/hitl/hitl.d.ts.map +1 -1
  102. package/dist/src/vended-interventions/hitl/hitl.js +62 -12
  103. package/dist/src/vended-interventions/hitl/hitl.js.map +1 -1
  104. package/dist/src/vended-interventions/hitl/index.d.ts +1 -0
  105. package/dist/src/vended-interventions/hitl/index.d.ts.map +1 -1
  106. package/dist/src/vended-memory-stores/test-memory-store/store.d.ts +4 -2
  107. package/dist/src/vended-memory-stores/test-memory-store/store.d.ts.map +1 -1
  108. package/dist/src/vended-memory-stores/test-memory-store/store.js +4 -2
  109. package/dist/src/vended-memory-stores/test-memory-store/store.js.map +1 -1
  110. package/dist/src/vended-plugins/context-offloader/plugin.d.ts +7 -3
  111. package/dist/src/vended-plugins/context-offloader/plugin.d.ts.map +1 -1
  112. package/dist/src/vended-plugins/context-offloader/plugin.js +27 -11
  113. package/dist/src/vended-plugins/context-offloader/plugin.js.map +1 -1
  114. package/dist/src/vended-tools/bash/index.d.ts +8 -4
  115. package/dist/src/vended-tools/bash/index.d.ts.map +1 -1
  116. package/dist/src/vended-tools/bash/index.js +7 -3
  117. package/dist/src/vended-tools/bash/index.js.map +1 -1
  118. package/dist/src/vended-tools/bash/make-shell.d.ts +36 -0
  119. package/dist/src/vended-tools/bash/make-shell.d.ts.map +1 -0
  120. package/dist/src/vended-tools/bash/make-shell.js +51 -0
  121. package/dist/src/vended-tools/bash/make-shell.js.map +1 -0
  122. package/dist/src/vended-tools/bash/types.d.ts +23 -1
  123. package/dist/src/vended-tools/bash/types.d.ts.map +1 -1
  124. package/dist/src/vended-tools/bash/types.js +30 -2
  125. package/dist/src/vended-tools/bash/types.js.map +1 -1
  126. package/package.json +2 -2
  127. package/dist/src/vended-tools/bash/make-bash.d.ts +0 -22
  128. package/dist/src/vended-tools/bash/make-bash.d.ts.map +0 -1
  129. package/dist/src/vended-tools/bash/make-bash.js +0 -40
  130. package/dist/src/vended-tools/bash/make-bash.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"s3-storage.js","sourceRoot":"","sources":["../../../src/session/s3-storage.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"s3-storage.js","sourceRoot":"","sources":["../../../src/session/s3-storage.ts"],"names":[],"mappings":"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"}
@@ -45,8 +45,11 @@ export interface SessionManagerConfig {
45
45
  * Accepts either:
46
46
  * - A unified {@link Storage} instance (recommended) — wrapped internally with {@link SnapshotStorageAdapter}
47
47
  * - A legacy `{ snapshot: SnapshotStorage }` object
48
+ *
49
+ * When omitted, resolves from the agent-level `storage` during initialization.
50
+ * If no agent-level storage is available either, an error is thrown.
48
51
  */
49
- storage: Storage | {
52
+ storage?: Storage | {
50
53
  snapshot: SnapshotStorage;
51
54
  };
52
55
  /** Unique session identifier. Defaults to `'default-session'`. */
@@ -82,7 +85,8 @@ export interface SessionManagerConfig {
82
85
  */
83
86
  export declare class SessionManager implements Plugin, MultiAgentPlugin {
84
87
  private readonly _sessionId;
85
- private readonly _storage;
88
+ private _storage;
89
+ private readonly _configStorage?;
86
90
  private readonly _saveLatestOn;
87
91
  private readonly _snapshotTrigger?;
88
92
  private readonly _multiAgentSaveLatestOn;
@@ -1 +1 @@
1
- {"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/session/session-manager.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/session/session-manager.ts"],"names":[],"mappings":"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"}
@@ -28,6 +28,7 @@ import { AfterMultiAgentInvocationEvent, AfterNodeCallEvent, BeforeMultiAgentInv
28
28
  export class SessionManager {
29
29
  _sessionId;
30
30
  _storage;
31
+ _configStorage;
31
32
  _saveLatestOn;
32
33
  _snapshotTrigger;
33
34
  _multiAgentSaveLatestOn;
@@ -40,12 +41,18 @@ export class SessionManager {
40
41
  }
41
42
  constructor(config) {
42
43
  this._sessionId = validateIdentifier(config.sessionId ?? 'default-session');
43
- this._storage = { snapshot: this._resolveSnapshotStorage(config.storage) };
44
+ this._configStorage = config.storage;
45
+ if (config.storage) {
46
+ this._storage = { snapshot: this._resolveSnapshotStorage(config.storage) };
47
+ }
44
48
  this._saveLatestOn = config.saveLatestOn ?? 'invocation';
45
49
  this._multiAgentSaveLatestOn = config.multiAgentSaveLatestOn ?? 'node';
46
50
  this._snapshotTrigger = config.snapshotTrigger;
47
51
  }
48
52
  get _snapshotStorage() {
53
+ if (!this._storage) {
54
+ throw new Error('SessionManager requires a storage backend. Provide storage in SessionManagerConfig or set storage on the Agent.');
55
+ }
49
56
  return this._storage.snapshot;
50
57
  }
51
58
  _resolveSnapshotStorage(storage) {
@@ -56,6 +63,12 @@ export class SessionManager {
56
63
  }
57
64
  /** Initializes the plugin by registering lifecycle hook callbacks. */
58
65
  initAgent(agent) {
66
+ if (!this._configStorage) {
67
+ if (!agent.storage) {
68
+ throw new Error('SessionManager requires a storage backend. Provide storage in SessionManagerConfig or set storage on the Agent.');
69
+ }
70
+ this._storage = { snapshot: this._resolveSnapshotStorage(agent.storage) };
71
+ }
59
72
  agent.addHook(InitializedEvent, async (event) => {
60
73
  await this._onAgentInitialized(event);
61
74
  });
@@ -180,6 +193,9 @@ export class SessionManager {
180
193
  // ---------------------------------------------------------------------------
181
194
  /** Initializes the multi-agent plugin by registering orchestrator lifecycle hooks. */
182
195
  initMultiAgent(orchestrator) {
196
+ if (!this._storage) {
197
+ throw new Error('SessionManager requires a storage backend. Provide storage in SessionManagerConfig when using with multi-agent orchestrators.');
198
+ }
183
199
  orchestrator.addHook(BeforeMultiAgentInvocationEvent, async (event) => {
184
200
  await this._onBeforeMultiAgentInvocation(event);
185
201
  });
@@ -1 +1 @@
1
- {"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/session/session-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAIpD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACnH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EACL,YAAY,IAAI,sBAAsB,EACtC,YAAY,IAAI,sBAAsB,GACvC,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,8BAA8B,EAC9B,kBAAkB,EAClB,+BAA+B,GAChC,MAAM,yBAAyB,CAAA;AA4DhC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,cAAc;IACR,UAAU,CAAQ;IAClB,QAAQ,CAA+B;IACvC,aAAa,CAAoB;IACjC,gBAAgB,CAAsC;IACtD,uBAAuB,CAA8B;IAC9D,sBAAsB,GAAG,IAAI,GAAG,EAAU,CAAA;IAElD;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,yBAAyB,CAAA;IAClC,CAAC;IAED,YAAY,MAA4B;QACtC,IAAI,CAAC,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,IAAI,iBAAiB,CAAC,CAAA;QAC3E,IAAI,CAAC,QAAQ,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;QAC1E,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,YAAY,IAAI,YAAY,CAAA;QACxD,IAAI,CAAC,uBAAuB,GAAG,MAAM,CAAC,sBAAsB,IAAI,MAAM,CAAA;QACtE,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,eAAe,CAAA;IAChD,CAAC;IAED,IAAY,gBAAgB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAA;IAC/B,CAAC;IAEO,uBAAuB,CAAC,OAAgD;QAC9E,IAAI,UAAU,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC,QAAQ,CAAA;QAClD,MAAM,MAAM,GAAG,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;QAC9E,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IAED,sEAAsE;IAC/D,SAAS,CAAC,KAAiB;QAChC,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC9C,MAAM,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAA;QACvC,CAAC,CAAC,CAAA;QACF,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBAC/C,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAA;YACnC,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,qEAAqE;QACrE,oFAAoF;QACpF,0BAA0B;QAC1B,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACjD,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAA;YACrC,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAClD,MAAM,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAA;QAC3C,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,SAAS,CAAC,KAAiB;QACjC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAA;IAC1E,CAAC;IAKD,KAAK,CAAC,YAAY,CAAC,MAIlB;QACC,MAAM,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,MAAM,CAAA;QAC3C,MAAM,QAAQ,GAAG,OAAO;YACtB,CAAC,CAAE,MAAM,CAAC,MAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;YACnE,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,MAAuB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACxE,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAA;QACxD,MAAM,QAAQ,GAAG,OAAO;YACtB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAoB,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAoB,CAAC,CAAA;QACzD,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAA;IACzG,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,CAAC,gBAAgB,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAA;IAC3E,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,eAAe,CAAC,MAAmE;QACvF,OAAO,IAAI,CAAC,gBAAgB,CAAC,eAAe,CAAC;YAC3C,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC;YACvC,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1D,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;SAC1E,CAAC,CAAA;IACJ,CAAC;IASD,KAAK,CAAC,eAAe,CAAC,MAIrB;QACC,MAAM,OAAO,GAAG,UAAU,IAAI,MAAM,CAAC,MAAM,CAAA;QAC3C,MAAM,QAAQ,GAAG,OAAO;YACtB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAoB,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAoB,CAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC;YACxD,QAAQ;YACR,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;SAC1E,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ;YAAE,OAAO,KAAK,CAAA;QAE3B,IAAI,OAAO,EAAE,CAAC;YACZ,CAAC;YAAC,MAAM,CAAC,MAAqB,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;QACvD,CAAC;aAAM,CAAC;YACN,sBAAsB,CAAC,MAAM,CAAC,MAAuB,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QAChF,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,sDAAsD;IAC9C,KAAK,CAAC,mBAAmB,CAAC,KAAuB;QACvD,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;QACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QAEpE,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CACT,aAAa,KAAK,CAAC,KAAK,CAAC,EAAE,kBAAkB,IAAI,CAAC,UAAU,0EAA0E,CACvI,CAAA;QACH,CAAC;QAED,2EAA2E;QAC3E,0EAA0E;QAC1E,wEAAwE;QACxE,kEAAkE;QAClE,MAAM,aAAa,GAAI,KAAK,CAAC,KAA4C,CAAC,KAAK,EAAE,QAAQ,CAAA;QACzF,IAAI,QAAQ,IAAI,aAAa,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjE,MAAM,CAAC,KAAK,CACV,aAAa,KAAK,CAAC,KAAK,CAAC,EAAE,qBAAqB,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,qDAAqD,CACjI,CAAA;YACD,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;QACjC,CAAC;IACH,CAAC;IAED,0FAA0F;IAClF,KAAK,CAAC,uBAAuB,CAAC,KAA2B;QAC/D,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QAClE,CAAC;QAED,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,KAAwB;QACpD,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAClE,CAAC;IAED;;;OAGG;IACK,KAAK,CAAC,iBAAiB,CAAC,KAA0B;QACxD,qCAAqC;QACrC,IAAI,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QAClE,CAAC;IACH,CAAC;IAED,yFAAyF;IACjF,KAAK,CAAC,uBAAuB,CAAC,KAAiB;QACrD,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAA;QAC1D,MAAM,UAAU,GAAG,MAAM,EAAE,CAAA;QAC3B,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YAC9G,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC;gBACjC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAC/B,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,IAAI;gBACd,QAAQ;aACT,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;IAED,8EAA8E;IAC9E,cAAc;IACd,8EAA8E;IAE9E,sFAAsF;IAC/E,cAAc,CAAC,YAAwB;QAC5C,YAAY,CAAC,OAAO,CAAC,+BAA+B,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACpE,MAAM,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC,CAAA;QACjD,CAAC,CAAC,CAAA;QACF,IAAI,IAAI,CAAC,uBAAuB,KAAK,MAAM,EAAE,CAAC;YAC5C,YAAY,CAAC,OAAO,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvD,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;YACpC,CAAC,CAAC,CAAA;QACJ,CAAC;QACD,YAAY,CAAC,OAAO,CAAC,8BAA8B,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACnE,MAAM,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAA;QAChD,CAAC,CAAC,CAAA;IACJ,CAAC;IAEO,mBAAmB,CAAC,YAAwB;QAClD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,EAAE,CAAA;IACtF,CAAC;IAED,wHAAwH;IAChH,KAAK,CAAC,6BAA6B,CAAC,KAAsC;QAChF,IAAI,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;YAAE,OAAM;QAClE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAA;QAEtD,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAA;QACvE,IAAI,CAAC,QAAQ;YAAE,OAAM;QAErB,sBAAsB,CAAC,KAAK,CAAC,YAA6B,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACpF,CAAC;IAED,oEAAoE;IAC5D,KAAK,CAAC,gBAAgB,CAAC,KAAyB;QACtD,MAAM,IAAI,CAAC,YAAY,CAAC;YACtB,MAAM,EAAE,KAAK,CAAC,YAA6B;YAC3C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAA;IACJ,CAAC;IAED,qEAAqE;IAC7D,KAAK,CAAC,4BAA4B,CAAC,KAAqC;QAC9E,MAAM,IAAI,CAAC,YAAY,CAAC;YACtB,MAAM,EAAE,KAAK,CAAC,YAA6B;YAC3C,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAA;IACJ,CAAC;CACF"}
1
+ {"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/session/session-manager.ts"],"names":[],"mappings":"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"}
@@ -1,3 +1,4 @@
1
+ import type { Scope } from './types.js';
1
2
  /**
2
3
  * Validates that an identifier contains only allowed characters.
3
4
  * Allowed characters: lowercase letters (a-z), numbers (0-9), hyphens (-), and underscores (_)
@@ -7,6 +8,15 @@
7
8
  * @throws Error if identifier contains invalid characters
8
9
  */
9
10
  export declare function validateIdentifier(id: string): string;
11
+ /**
12
+ * Validates that a snapshot scope is supported.
13
+ *
14
+ * @internal
15
+ * @param scope - The scope to validate
16
+ * @returns The validated scope
17
+ * @throws Error if the scope is not supported
18
+ */
19
+ export declare function validateScope(scope: unknown): Scope;
10
20
  /**
11
21
  * Validates that a string is a UUID v7.
12
22
  *
@@ -1 +1 @@
1
- {"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/session/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK/C"}
1
+ {"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/session/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAKnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAK/C"}
@@ -13,6 +13,20 @@ export function validateIdentifier(id) {
13
13
  }
14
14
  return id;
15
15
  }
16
+ /**
17
+ * Validates that a snapshot scope is supported.
18
+ *
19
+ * @internal
20
+ * @param scope - The scope to validate
21
+ * @returns The validated scope
22
+ * @throws Error if the scope is not supported
23
+ */
24
+ export function validateScope(scope) {
25
+ if (scope !== 'agent' && scope !== 'multiAgent') {
26
+ throw new Error(`Invalid scope '${String(scope)}': must be 'agent' or 'multiAgent'`);
27
+ }
28
+ return scope;
29
+ }
16
30
  /**
17
31
  * Validates that a string is a UUID v7.
18
32
  *
@@ -1 +1 @@
1
- {"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/session/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,MAAM,YAAY,GAAG,eAAe,CAAA;IACpC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,yEAAyE,CAAC,CAAA;IAC7G,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,aAAa,GAAG,wEAAwE,CAAA;IAC9F,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,sCAAsC,CAAC,CAAA;IAC/D,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/session/validation.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,MAAM,YAAY,GAAG,eAAe,CAAA;IACpC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,eAAe,EAAE,yEAAyE,CAAC,CAAA;IAC7G,CAAC;IACD,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAA;IACtF,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,aAAa,GAAG,wEAAwE,CAAA;IAC9F,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,sCAAsC,CAAC,CAAA;IAC/D,CAAC;AACH,CAAC"}
@@ -9,8 +9,9 @@ import type { Storage } from './storage.js';
9
9
  * This is a plain unbounded store with no eviction. Consumers that need eviction
10
10
  * (e.g. the ContextOffloader plugin) manage it themselves.
11
11
  *
12
- * Keys are normalized identically to {@link LocalFileStorage}: slash runs are collapsed,
13
- * leading/trailing slashes are stripped, and `..` segments are rejected.
12
+ * Like the other shipped backends, keys are normalized via {@link normalizeKey}:
13
+ * slash runs are collapsed, leading/trailing slashes are stripped, and `..`
14
+ * segments are rejected.
14
15
  *
15
16
  * @example
16
17
  * ```typescript
@@ -25,7 +26,7 @@ export declare class InMemoryStorage implements Storage {
25
26
  * Stores `data` under `key`, overwriting any existing value.
26
27
  * Bytes are copied on write to prevent aliasing with the caller's buffer.
27
28
  *
28
- * @param key - Opaque, `/`-separated key identifying the value
29
+ * @param key - Opaque string key identifying the value
29
30
  * @param data - Raw bytes to persist
30
31
  * @throws {@link StorageError} if the key is empty or contains `..` segments
31
32
  */
@@ -1 +1 @@
1
- {"version":3,"file":"in-memory-storage.d.ts","sourceRoot":"","sources":["../../../src/storage/in-memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD;;;;;;;OAOG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;;;;;;OAOG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMnD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS7C,6EAA6E;IAC7E,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}
1
+ {"version":3,"file":"in-memory-storage.d.ts","sourceRoot":"","sources":["../../../src/storage/in-memory-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IAEvD;;;;;;;OAOG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD;;;;;;;OAOG;IACG,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMnD;;;;;OAKG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;;;OAMG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS7C,6EAA6E;IAC7E,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}
@@ -9,8 +9,9 @@ import { namespace, normalizeKey, normalizePrefix } from './storage.js';
9
9
  * This is a plain unbounded store with no eviction. Consumers that need eviction
10
10
  * (e.g. the ContextOffloader plugin) manage it themselves.
11
11
  *
12
- * Keys are normalized identically to {@link LocalFileStorage}: slash runs are collapsed,
13
- * leading/trailing slashes are stripped, and `..` segments are rejected.
12
+ * Like the other shipped backends, keys are normalized via {@link normalizeKey}:
13
+ * slash runs are collapsed, leading/trailing slashes are stripped, and `..`
14
+ * segments are rejected.
14
15
  *
15
16
  * @example
16
17
  * ```typescript
@@ -25,7 +26,7 @@ export class InMemoryStorage {
25
26
  * Stores `data` under `key`, overwriting any existing value.
26
27
  * Bytes are copied on write to prevent aliasing with the caller's buffer.
27
28
  *
28
- * @param key - Opaque, `/`-separated key identifying the value
29
+ * @param key - Opaque string key identifying the value
29
30
  * @param data - Raw bytes to persist
30
31
  * @throws {@link StorageError} if the key is empty or contains `..` segments
31
32
  */
@@ -1 +1 @@
1
- {"version":3,"file":"in-memory-storage.js","sourceRoot":"","sources":["../../../src/storage/in-memory-storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,eAAe;IACT,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAA;IAEvD;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,IAAgB;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAClD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAA;QAChD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QACpC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAa,EAAE,CAAA;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAA;IACpB,CAAC;IAED,6EAA6E;IAC7E,SAAS,CAAC,MAAc;QACtB,OAAO,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;CACF"}
1
+ {"version":3,"file":"in-memory-storage.js","sourceRoot":"","sources":["../../../src/storage/in-memory-storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAEvE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,eAAe;IACT,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAA;IAEvD;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,IAAgB;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAClD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAA;QAChD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAA;QACpC,OAAO,KAAK,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAA;IACvC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;QAC1C,MAAM,IAAI,GAAa,EAAE,CAAA;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAChD,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAA;IACpB,CAAC;IAED,6EAA6E;IAC7E,SAAS,CAAC,MAAc;QACtB,OAAO,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;IACrB,CAAC;CACF"}
@@ -38,7 +38,7 @@ export declare class LocalFileStorage implements Storage {
38
38
  /**
39
39
  * Stores `data` under `key`, overwriting any existing value.
40
40
  *
41
- * @param key - Opaque, `/`-separated key identifying the value
41
+ * @param key - Opaque string key identifying the value
42
42
  * @param data - Raw bytes to persist
43
43
  * @throws {@link StorageError} if the key is invalid or the write fails
44
44
  */
@@ -56,7 +56,7 @@ export class LocalFileStorage {
56
56
  /**
57
57
  * Stores `data` under `key`, overwriting any existing value.
58
58
  *
59
- * @param key - Opaque, `/`-separated key identifying the value
59
+ * @param key - Opaque string key identifying the value
60
60
  * @param data - Raw bytes to persist
61
61
  * @throws {@link StorageError} if the key is invalid or the write fails
62
62
  */
@@ -37,7 +37,7 @@ export declare class S3Storage implements Storage {
37
37
  /**
38
38
  * Stores `data` under `key`, overwriting any existing value.
39
39
  *
40
- * @param key - Opaque, `/`-separated key identifying the value
40
+ * @param key - Opaque string key identifying the value
41
41
  * @param data - Raw bytes to persist
42
42
  * @throws {@link StorageError} if the key is invalid or the upload fails
43
43
  */
@@ -38,7 +38,7 @@ export class S3Storage {
38
38
  /**
39
39
  * Stores `data` under `key`, overwriting any existing value.
40
40
  *
41
- * @param key - Opaque, `/`-separated key identifying the value
41
+ * @param key - Opaque string key identifying the value
42
42
  * @param data - Raw bytes to persist
43
43
  * @throws {@link StorageError} if the key is invalid or the upload fails
44
44
  */
@@ -6,8 +6,13 @@
6
6
  */
7
7
  export declare const NAMESPACED: unique symbol;
8
8
  /**
9
- * Validates and normalizes a storage key: collapses runs of `/`, strips leading
10
- * and trailing `/`, and rejects empty keys and any `..` segment.
9
+ * Validates and normalizes a storage key for path-based backends: collapses
10
+ * runs of `/`, strips leading and trailing `/`, and rejects empty keys and
11
+ * any `..` segment.
12
+ *
13
+ * Used by the shipped path-based backends ({@link InMemoryStorage},
14
+ * {@link LocalFileStorage}, {@link S3Storage}), not required by the
15
+ * {@link Storage} interface itself.
11
16
  *
12
17
  * @param key - The raw key to normalize
13
18
  * @returns The normalized key
@@ -15,8 +20,11 @@ export declare const NAMESPACED: unique symbol;
15
20
  */
16
21
  export declare function normalizeKey(key: string): string;
17
22
  /**
18
- * Normalizes a list prefix: collapses slash runs, strips leading slashes.
19
- * Unlike a key, an empty prefix is valid and matches everything.
23
+ * Normalizes a list prefix for path-based backends: collapses slash runs,
24
+ * strips leading slashes. Unlike a key, an empty prefix is valid and matches
25
+ * everything.
26
+ *
27
+ * Used by the shipped path-based backends alongside {@link normalizeKey}.
20
28
  *
21
29
  * @param prefix - The raw prefix to normalize
22
30
  * @returns The normalized prefix
@@ -27,8 +35,10 @@ export declare function normalizePrefix(prefix: string): string;
27
35
  * A backend for storing and retrieving raw bytes under string keys.
28
36
  *
29
37
  * The interface is deliberately minimal — four operations over opaque `Uint8Array`
30
- * values. Implementations must treat keys as opaque path-like strings (segments
31
- * separated by `/`) and must round-trip the bytes they are given unchanged.
38
+ * values. Keys are opaque strings implementations must round-trip the bytes
39
+ * they are given unchanged. The shipped backends interpret `/` as a logical
40
+ * separator (collapsing runs, rejecting `..`), but custom backends may apply
41
+ * their own key scheme.
32
42
  *
33
43
  * The `ListQuery` type parameter controls what `list` accepts. It defaults to
34
44
  * `string` (a key prefix), which every backend supports. Implementations may
@@ -42,7 +52,7 @@ export interface Storage<ListQuery = string> {
42
52
  /**
43
53
  * Stores `data` under `key`, overwriting any existing value.
44
54
  *
45
- * @param key - Opaque, `/`-separated key identifying the value
55
+ * @param key - Opaque string key identifying the value
46
56
  * @param data - Raw bytes to persist
47
57
  * @throws {@link StorageError} if the write fails
48
58
  */
@@ -92,10 +102,13 @@ export interface Storage<ListQuery = string> {
92
102
  * Returns a {@link Storage} view with all keys prefixed by `prefix`.
93
103
  *
94
104
  * Composable — calling `namespace()` on the result nests prefixes.
105
+ * Uses {@link normalizePrefix} to sanitize the prefix, so it assumes a
106
+ * `/`-separated key scheme. Backends with a different key scheme should
107
+ * implement their own namespacing.
95
108
  *
96
109
  * @internal
97
110
  * @param storage - The underlying storage to delegate to
98
- * @param prefix - Prefix to prepend to all keys
111
+ * @param prefix - Prefix to prepend to all keys (normalized as a `/`-separated path)
99
112
  * @returns A namespaced Storage view
100
113
  */
101
114
  export declare function namespace(storage: Storage, prefix: string): Storage;
@@ -1 +1 @@
1
- {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,MAAiD,CAAA;AAEjF;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,OAAO,CAAC,SAAS,GAAG,MAAM;IACzC;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnD;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAE7C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAEzC;;;;;;;;OAQG;IACH,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CACpC;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAYnE"}
1
+ {"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,MAAiD,CAAA;AAEjF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAShD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAStD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,OAAO,CAAC,SAAS,GAAG,MAAM;IACzC;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnD;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAE7C;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElC;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAEzC;;;;;;;;OAQG;IACH,SAAS,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CACpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAYnE"}
@@ -7,8 +7,13 @@ import { StorageError } from '../errors.js';
7
7
  */
8
8
  export const NAMESPACED = Symbol.for('strands.storage.namespaced');
9
9
  /**
10
- * Validates and normalizes a storage key: collapses runs of `/`, strips leading
11
- * and trailing `/`, and rejects empty keys and any `..` segment.
10
+ * Validates and normalizes a storage key for path-based backends: collapses
11
+ * runs of `/`, strips leading and trailing `/`, and rejects empty keys and
12
+ * any `..` segment.
13
+ *
14
+ * Used by the shipped path-based backends ({@link InMemoryStorage},
15
+ * {@link LocalFileStorage}, {@link S3Storage}), not required by the
16
+ * {@link Storage} interface itself.
12
17
  *
13
18
  * @param key - The raw key to normalize
14
19
  * @returns The normalized key
@@ -25,8 +30,11 @@ export function normalizeKey(key) {
25
30
  return segments.join('/');
26
31
  }
27
32
  /**
28
- * Normalizes a list prefix: collapses slash runs, strips leading slashes.
29
- * Unlike a key, an empty prefix is valid and matches everything.
33
+ * Normalizes a list prefix for path-based backends: collapses slash runs,
34
+ * strips leading slashes. Unlike a key, an empty prefix is valid and matches
35
+ * everything.
36
+ *
37
+ * Used by the shipped path-based backends alongside {@link normalizeKey}.
30
38
  *
31
39
  * @param prefix - The raw prefix to normalize
32
40
  * @returns The normalized prefix
@@ -46,10 +54,13 @@ export function normalizePrefix(prefix) {
46
54
  * Returns a {@link Storage} view with all keys prefixed by `prefix`.
47
55
  *
48
56
  * Composable — calling `namespace()` on the result nests prefixes.
57
+ * Uses {@link normalizePrefix} to sanitize the prefix, so it assumes a
58
+ * `/`-separated key scheme. Backends with a different key scheme should
59
+ * implement their own namespacing.
49
60
  *
50
61
  * @internal
51
62
  * @param storage - The underlying storage to delegate to
52
- * @param prefix - Prefix to prepend to all keys
63
+ * @param prefix - Prefix to prepend to all keys (normalized as a `/`-separated path)
53
64
  * @returns A namespaced Storage view
54
65
  */
55
66
  export function namespace(storage, prefix) {
@@ -1 +1 @@
1
- {"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,YAAY,CAAC,+BAA+B,CAAC,CAAA;IACzD,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CAAC,wBAAwB,GAAG,uCAAuC,CAAC,CAAA;IAC5F,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CAAC,2BAA2B,MAAM,uCAAuC,CAAC,CAAA;IAClG,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;IACnF,OAAO,UAAU,CAAA;AACnB,CAAC;AAwED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB,EAAE,MAAc;IACxD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,MAAM,IAAI,GAAqC;QAC7C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,EAAE,IAAI,CAAC;QACvD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QAC7C,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACpG,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QACpD,CAAC,UAAU,CAAC,EAAE,IAAI;KACnB,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}
1
+ {"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/storage/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAAkB,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAA;AAEjF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,YAAY,CAAC,+BAA+B,CAAC,CAAA;IACzD,CAAC;IACD,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CAAC,wBAAwB,GAAG,uCAAuC,CAAC,CAAA;IAC5F,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC3B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACtC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CAAC,2BAA2B,MAAM,uCAAuC,CAAC,CAAA;IAClG,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACjC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAA;IACnF,OAAO,UAAU,CAAA;AACnB,CAAC;AA0ED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB,EAAE,MAAc;IACxD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,MAAM,IAAI,GAAqC;QAC7C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,EAAE,IAAI,CAAC;QACvD,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QACzC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QAC7C,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACpG,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC;QACpD,CAAC,UAAU,CAAC,EAAE,IAAI;KACnB,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../src/telemetry/tracer.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../src/telemetry/tracer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAqC,cAAc,EAAQ,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEpH,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,6BAA6B,EAC7B,2BAA2B,EAG5B,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAgB,OAAO,EAAgB,MAAM,sBAAsB,CAAA;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAIxD;;GAEG;AACH,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CACxB;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,gBAAgB,CAAC,cAAc,CAAC;IACjE,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,sFAAsF;IACtF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAO;IAC7B,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAI;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAK;IACpC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAK;IAC9C,uFAAuF;IACvF,OAAO,EAAE,OAAO,GAAG,IAAI,CAAO;IAE9B;;;OAGG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,UAAU,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAW/E;;OAEG;IACH,GAAG,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAK3B,MAAM,IAAI,cAAc;CAazB;AAiBD;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACjB;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IAEpC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAE/C;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAS;IAEjD;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgC;IAEjE,kDAAkD;IAClD,OAAO,CAAC,UAAU,CAAkB;IAEpC,kFAAkF;IAClF,OAAO,CAAC,SAAS,CAAkB;IAEnC,sFAAsF;IACtF,OAAO,CAAC,eAAe,CAAkB;IAEzC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAE7C,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAE9D;;;;;;;OAOG;gBACS,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAe5D;;OAEG;IACH,IAAI,WAAW,IAAI,UAAU,EAAE,CAE9B;IAED;;;;;;OAMG;IACH,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI;IA4C3D;;;;;OAKG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI;IA+BxE;;;;;OAKG;IACH,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,IAAI,GAAG,IAAI;IA6BvE;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI;IA6B9E;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,GAAG,IAAI;IA4DjE;;;;;OAKG;IACH,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,sBAA2B,GAAG,IAAI;IAuD9E;;;;;;OAMG;IACH,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,GAAG,IAAI;IAuBrE;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,wBAA6B,GAAG,IAAI;IAgBlF;;;;;;OAMG;IACH,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI;IAyBzD;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,kBAAuB,GAAG,IAAI;IAetE;;;;;;;;OAQG;IACH,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,IAAI,GAAG,IAAI;IAgBzE;;;;;;;;OAQG;IACH,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,0BAA+B,GAAG,IAAI;IA+BtF;;;;;;;;OAQG;IACH,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI;IAoBnE;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI;IAYhF;;;;OAIG;IACH,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,IAAI,GAAG,IAAI;IAY9E;;;;;;;;OAQG;IACH,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAcjF;;;;;;;;OAQG;IACH,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,GAAG,IAAI;IAiC3E;;;;;OAKG;IACH,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,2BAAgC,GAAG,IAAI;IAWxF;;;;;;;;OAQG;IACH,kBAAkB,IAAI,WAAW,GAAG,SAAS;IAY7C;;;;;;;;OAQG;IACH,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAKrD;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI;IAyBnE;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,GAAE,uBAA4B,GAAG,IAAI;IAgBhF;;OAEG;IACH,OAAO,CAAC,UAAU;IA4ClB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAoBhB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IA2BjB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAc5B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAUjC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAW9B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAgB1C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAiB3C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,+BAA+B;CAkB/C"}
@@ -348,6 +348,10 @@ export class Tracer {
348
348
  ...(this._loopSpan && { parentSpan: this._loopSpan }),
349
349
  });
350
350
  if (this._useLatestConventions) {
351
+ // The execute_tool span convention records tool inputs in the dedicated
352
+ // gen_ai.tool.call.arguments span attribute (Opt-In), which spec-compliant
353
+ // consumers read on tool spans.
354
+ span.setAttribute('gen_ai.tool.call.arguments', JSON.stringify(tool.input, jsonReplacer));
351
355
  this._addEvent(span, 'gen_ai.client.inference.operation.details', {
352
356
  'gen_ai.input.messages': JSON.stringify([
353
357
  {
@@ -392,6 +396,13 @@ export class Tracer {
392
396
  const statusStr = typeof toolResult.status === 'string' ? toolResult.status : String(toolResult.status);
393
397
  attributes['gen_ai.tool.status'] = statusStr;
394
398
  if (this._useLatestConventions) {
399
+ // The execute_tool span convention records tool outputs in the dedicated
400
+ // gen_ai.tool.call.result span attribute (Opt-In), which spec-compliant
401
+ // consumers read on tool spans. The spec scopes the attribute to successful
402
+ // executions; failures are captured in the span status instead.
403
+ if (statusStr !== 'error') {
404
+ attributes['gen_ai.tool.call.result'] = JSON.stringify(toolResult.content, jsonReplacer);
405
+ }
395
406
  this._addEvent(span, 'gen_ai.client.inference.operation.details', {
396
407
  'gen_ai.output.messages': JSON.stringify([
397
408
  {