@temporalio/strands-agents 1.22.0 → 1.23.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.
@@ -56,5 +56,6 @@ class StrandsFailureConverter extends common_1.DefaultFailureConverter {
56
56
  }
57
57
  }
58
58
  exports.StrandsFailureConverter = StrandsFailureConverter;
59
+ // ts-prune-ignore-next
59
60
  exports.failureConverter = new StrandsFailureConverter();
60
61
  //# sourceMappingURL=failure-converter.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"failure-converter.js","sourceRoot":"","sources":["../src/failure-converter.ts"],"names":[],"mappings":";;;AAAA,6CAAwG;AACxG,+CAO4B;AAEf,QAAA,sBAAsB,GAAG,kBAAkB,CAAC;AAQzD,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,SAAS,GAAG,GAA+B,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5F,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAqC,CAAC;IAC1E,OAAO,OAAO,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,EAAE,IAAI,EAAE,gCAA0B,EAAE,IAAI,EAAE,4BAA4B,EAAE;IACxE,EAAE,IAAI,EAAE,oBAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAChD,EAAE,IAAI,EAAE,2BAAqB,EAAE,IAAI,EAAE,uBAAuB,EAAE;CAC/D,CAAC;AAEF,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnE,OAAO,2BAAkB,CAAC,MAAM,CAAC;YAC/B,OAAO,EAAE,aAAa,KAAK,EAAE;YAC7B,IAAI,EAAE,8BAAsB;YAC5B,YAAY,EAAE,IAAI;YAClB,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,oBAAoB,EAAE,CAAC;YAClD,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;gBACxB,OAAO,2BAAkB,CAAC,MAAM,CAAC;oBAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,IAAI,EAAE,IAAI;oBACV,YAAY,EAAE,IAAI;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,uBAAwB,SAAQ,gCAAuB;IACzD,cAAc,CACrB,GAAY,EACZ,gBAAkC,EAClC,OAA8B;QAE9B,OAAO,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;CACF;AARD,0DAQC;AAEY,QAAA,gBAAgB,GAAqB,IAAI,uBAAuB,EAAE,CAAC"}
1
+ {"version":3,"file":"failure-converter.js","sourceRoot":"","sources":["../src/failure-converter.ts"],"names":[],"mappings":";;;AAAA,6CAAwG;AACxG,+CAO4B;AAEf,QAAA,sBAAsB,GAAG,kBAAkB,CAAC;AAQzD,SAAS,gBAAgB,CAAC,GAAY;IACpC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,MAAM,SAAS,GAAG,GAA+B,CAAC;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5F,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAqC,CAAC;IAC1E,OAAO,OAAO,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;AAC7C,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,EAAE,IAAI,EAAE,gCAA0B,EAAE,IAAI,EAAE,4BAA4B,EAAE;IACxE,EAAE,IAAI,EAAE,oBAAc,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAChD,EAAE,IAAI,EAAE,2BAAqB,EAAE,IAAI,EAAE,uBAAuB,EAAE;CAC/D,CAAC;AAEF,SAAS,YAAY,CAAC,GAAY;IAChC,IAAI,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnE,OAAO,2BAAkB,CAAC,MAAM,CAAC;YAC/B,OAAO,EAAE,aAAa,KAAK,EAAE;YAC7B,IAAI,EAAE,8BAAsB;YAC5B,YAAY,EAAE,IAAI;YAClB,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,oBAAoB,EAAE,CAAC;YAClD,IAAI,GAAG,YAAY,IAAI,EAAE,CAAC;gBACxB,OAAO,2BAAkB,CAAC,MAAM,CAAC;oBAC/B,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,IAAI,EAAE,IAAI;oBACV,YAAY,EAAE,IAAI;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAa,uBAAwB,SAAQ,gCAAuB;IACzD,cAAc,CACrB,GAAY,EACZ,gBAAkC,EAClC,OAA8B;QAE9B,OAAO,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;CACF;AARD,0DAQC;AAED,uBAAuB;AACV,QAAA,gBAAgB,GAAqB,IAAI,uBAAuB,EAAE,CAAC"}
package/lib/plugin.d.ts CHANGED
@@ -22,10 +22,11 @@ import { SimplePlugin } from '@temporalio/plugin';
22
22
  * true` to list once at the start of the workflow instead.
23
23
  *
24
24
  * - `mcpConnectionIdleTimeout` — how long a worker-process MCP connection is
25
- * kept open between `callTool` activities before it's disconnected. The timer
26
- * resets on every reuse. Accepts a millisecond number or a duration string
27
- * (e.g. `'5 minutes'`), like `startToCloseTimeout`. Defaults to
28
- * {@link MCP_CONNECTION_IDLE_MS} (5 minutes).
25
+ * kept open between `callTool` activities before it's disconnected. The window
26
+ * only starts once no activity is using the connection, so it never cuts off
27
+ * an in-flight call, however long it runs. Accepts a millisecond number or a
28
+ * duration string (e.g. `'5 minutes'`), like `startToCloseTimeout`. Defaults
29
+ * to {@link MCP_CONNECTION_IDLE_MS} (5 minutes).
29
30
  */
30
31
  export interface StrandsPluginOptions {
31
32
  models?: Record<string, () => Model>;
package/lib/plugin.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
@@ -90,10 +90,11 @@ export declare function buildListToolsActivity(server: string, factory: () => Mc
90
90
  server: string;
91
91
  }) => Promise<McpToolInfo[]>;
92
92
  /**
93
- * Default for how long an idle MCP connection is kept open before it's
94
- * disconnected. The timer resets on every {@link callToolActivityName |
95
- * callTool} that reuses the connection. Override per worker via
96
- * `StrandsPlugin({ mcpConnectionIdleMs })`.
93
+ * Default for how long an *idle* MCP connection is kept open before it's
94
+ * disconnected. The window only starts once no {@link callToolActivityName |
95
+ * callTool} or {@link listToolsActivityName | listTools} activity is using the
96
+ * connection, so a call that runs longer than this is never cut off. Override
97
+ * per worker via `StrandsPlugin({ mcpConnectionIdleTimeout })`.
97
98
  */
98
99
  export declare const MCP_CONNECTION_IDLE_MS: number;
99
100
  export declare function _evictConnection(server: string): Promise<void>;
@@ -127,8 +127,9 @@ function callToolActivityName(server) {
127
127
  function buildListToolsActivity(server, factory, idleMs = exports.MCP_CONNECTION_IDLE_MS) {
128
128
  const name = listToolsActivityName(server);
129
129
  const fn = async (_input) => {
130
- const client = await getConnection(server, factory, idleMs);
130
+ const record = acquireConnection(server, factory);
131
131
  try {
132
+ const client = await record.client;
132
133
  const tools = await client.listTools();
133
134
  return tools.map((t) => ({
134
135
  name: t.name,
@@ -142,66 +143,97 @@ function buildListToolsActivity(server, factory, idleMs = exports.MCP_CONNECTION
142
143
  await _evictConnection(server);
143
144
  throw err;
144
145
  }
146
+ finally {
147
+ // No more in-flight call on this connection; let idle eviction resume
148
+ // (no-op if the connection was just evicted above).
149
+ releaseConnection(server, record, idleMs);
150
+ }
145
151
  };
146
152
  Object.defineProperty(fn, 'name', { value: name });
147
153
  return fn;
148
154
  }
149
155
  /**
150
- * Default for how long an idle MCP connection is kept open before it's
151
- * disconnected. The timer resets on every {@link callToolActivityName |
152
- * callTool} that reuses the connection. Override per worker via
153
- * `StrandsPlugin({ mcpConnectionIdleMs })`.
156
+ * Default for how long an *idle* MCP connection is kept open before it's
157
+ * disconnected. The window only starts once no {@link callToolActivityName |
158
+ * callTool} or {@link listToolsActivityName | listTools} activity is using the
159
+ * connection, so a call that runs longer than this is never cut off. Override
160
+ * per worker via `StrandsPlugin({ mcpConnectionIdleTimeout })`.
154
161
  */
155
162
  exports.MCP_CONNECTION_IDLE_MS = 5 * 60 * 1000;
156
- // Worker-process caches, keyed by server name. Activities run in the worker's
163
+ // Worker-process cache, keyed by server name. Activities run in the worker's
157
164
  // Node process, so this module state is shared across every activity invocation on the worker.
158
165
  const CONNECTIONS = new Map();
159
- const IDLE_TIMERS = new Map();
160
- function resetIdleTimer(server, idleMs) {
161
- const existing = IDLE_TIMERS.get(server);
162
- if (existing !== undefined)
163
- clearTimeout(existing);
164
- const timer = setTimeout(() => void _evictConnection(server), idleMs);
165
- // Don't let an idle MCP connection keep the worker process alive.
166
- timer.unref?.();
167
- IDLE_TIMERS.set(server, timer);
168
- }
169
166
  async function _evictConnection(server) {
170
- const timer = IDLE_TIMERS.get(server);
171
- if (timer !== undefined) {
172
- clearTimeout(timer);
173
- IDLE_TIMERS.delete(server);
174
- }
175
- const entry = CONNECTIONS.get(server);
176
- if (entry === undefined)
167
+ const record = CONNECTIONS.get(server);
168
+ if (record === undefined)
177
169
  return;
170
+ // Delete before awaiting: a call arriving during `disconnect` must open a
171
+ // fresh connection rather than join the one being torn down.
178
172
  CONNECTIONS.delete(server);
173
+ if (record.idleTimer !== undefined) {
174
+ clearTimeout(record.idleTimer);
175
+ record.idleTimer = undefined;
176
+ }
179
177
  try {
180
- const client = await entry;
178
+ const client = await record.client;
181
179
  await client.disconnect();
182
180
  }
183
181
  catch {
184
182
  // Best-effort; the session may already be broken.
185
183
  }
186
184
  }
187
- function getConnection(server, factory, idleMs) {
188
- let entry = CONNECTIONS.get(server);
189
- if (entry === undefined) {
190
- entry = (async () => {
191
- const client = factory();
192
- await client.connect();
193
- return client;
194
- })();
195
- CONNECTIONS.set(server, entry);
185
+ /**
186
+ * Return the cached connection for `server`, opening one lazily if needed, and
187
+ * mark a call in flight so idle eviction can't disconnect underneath it.
188
+ * Concurrent first-callers dedupe onto a single connect handshake by awaiting
189
+ * the same record. Every caller must {@link releaseConnection} once its call
190
+ * completes.
191
+ */
192
+ function acquireConnection(server, factory) {
193
+ let record = CONNECTIONS.get(server);
194
+ if (record === undefined) {
195
+ const entry = {
196
+ inflight: 0,
197
+ client: (async () => {
198
+ const client = factory();
199
+ await client.connect();
200
+ return client;
201
+ })(),
202
+ };
196
203
  // If the connect handshake fails, drop the rejected promise so the next
197
204
  // call retries instead of caching the failure forever.
198
- entry.catch(() => {
205
+ entry.client.catch(() => {
199
206
  if (CONNECTIONS.get(server) === entry)
200
207
  CONNECTIONS.delete(server);
201
208
  });
209
+ CONNECTIONS.set(server, entry);
210
+ record = entry;
202
211
  }
203
- resetIdleTimer(server, idleMs);
204
- return entry;
212
+ record.inflight += 1;
213
+ if (record.idleTimer !== undefined) {
214
+ clearTimeout(record.idleTimer);
215
+ record.idleTimer = undefined;
216
+ }
217
+ return record;
218
+ }
219
+ /** Mark a call done; arm idle eviction once no calls remain in flight. */
220
+ function releaseConnection(server, record, idleMs) {
221
+ record.inflight -= 1;
222
+ // Only the record still cached under this server arms a timer; a record
223
+ // already evicted must not schedule one, or it could later evict a
224
+ // different, healthy connection for the same server.
225
+ if (record.inflight > 0 || CONNECTIONS.get(server) !== record)
226
+ return;
227
+ const timer = setTimeout(() => {
228
+ // `acquireConnection` clears this timer synchronously, so a pending timer
229
+ // implies the connection is still idle; re-checked to keep that invariant
230
+ // local.
231
+ if (record.inflight === 0)
232
+ void _evictConnection(server);
233
+ }, idleMs);
234
+ // Don't let an idle MCP connection keep the worker process alive.
235
+ timer.unref?.();
236
+ record.idleTimer = timer;
205
237
  }
206
238
  /**
207
239
  * Builds the per-server `{server}-callTool` activity. Reuses a worker-process
@@ -216,13 +248,14 @@ function buildCallToolActivity(server, factory, idleMs = exports.MCP_CONNECTION_
216
248
  activity_1.Context.current().log.debug(`Calling MCP tool ${input.toolName} on server ${server}`, {
217
249
  activityId: (0, activity_1.activityInfo)().activityId,
218
250
  });
219
- const client = await getConnection(server, factory, idleMs);
251
+ const record = acquireConnection(server, factory);
220
252
  // Dispatch by name without re-listing tools on the connection: the agent
221
253
  // already has the schema from `listTools`, and `McpClient.callTool` only
222
254
  // reads `tool.name` to build the request. A minimal `{ name }` matches the
223
255
  // by-name dispatch the Python SDK does via `session.call_tool`.
224
256
  const tool = { name: input.toolName };
225
257
  try {
258
+ const client = await record.client;
226
259
  return await client.callTool(tool, input.args);
227
260
  }
228
261
  catch (err) {
@@ -230,6 +263,11 @@ function buildCallToolActivity(server, factory, idleMs = exports.MCP_CONNECTION_
230
263
  await _evictConnection(server);
231
264
  throw err;
232
265
  }
266
+ finally {
267
+ // No more in-flight call on this connection; let idle eviction resume
268
+ // (no-op if the connection was just evicted above).
269
+ releaseConnection(server, record, idleMs);
270
+ }
233
271
  };
234
272
  Object.defineProperty(fn, 'name', { value: name });
235
273
  return fn;
@@ -1 +1 @@
1
- {"version":3,"file":"temporal-mcp-client.js","sourceRoot":"","sources":["../src/temporal-mcp-client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"temporal-mcp-client.js","sourceRoot":"","sources":["../src/temporal-mcp-client.ts"],"names":[],"mappings":"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"}
@@ -2,7 +2,6 @@ import { Model } from '@strands-agents/sdk';
2
2
  import type { BaseModelConfig, Message, ModelStreamEvent, StreamOptions } from '@strands-agents/sdk';
3
3
  import type { ActivityOptions } from '@temporalio/workflow';
4
4
  import type { Duration } from '@temporalio/common/lib/time';
5
- import type { ModelActivity } from './model-activity';
6
5
  /**
7
6
  * Options for {@link TemporalModel}.
8
7
  *
@@ -36,6 +35,3 @@ export declare class TemporalModel extends Model<BaseModelConfig> {
36
35
  getConfig(): BaseModelConfig;
37
36
  stream(messages: Message[], options?: StreamOptions): AsyncIterable<ModelStreamEvent>;
38
37
  }
39
- /** Type tag used only to forward the `ModelActivity` type from the activity side. */
40
- export type _ModelActivityRef = ModelActivity;
41
- export declare function rejectStructuredOutput(): never;
@@ -24,13 +24,8 @@ var __importStar = (this && this.__importStar) || function (mod) {
24
24
  };
25
25
  Object.defineProperty(exports, "__esModule", { value: true });
26
26
  exports.TemporalModel = void 0;
27
- exports.rejectStructuredOutput = rejectStructuredOutput;
28
27
  const sdk_1 = require("@strands-agents/sdk");
29
28
  const workflow = __importStar(require("@temporalio/workflow"));
30
- const common_1 = require("@temporalio/common");
31
- const STRUCTURED_OUTPUT_DISABLED = 'TemporalModel.structuredOutput is not supported. Use ' +
32
- 'TemporalAgent({ structuredOutputSchema: ... }) which routes structured ' +
33
- 'output through stream() via the structured-output tool.';
34
29
  /**
35
30
  * A Strands {@link Model} whose {@link Model.stream} runs as a Temporal
36
31
  * activity. Constructing a `TemporalModel` does no I/O, so instances are
@@ -82,7 +77,4 @@ class TemporalModel extends sdk_1.Model {
82
77
  }
83
78
  }
84
79
  exports.TemporalModel = TemporalModel;
85
- function rejectStructuredOutput() {
86
- throw common_1.ApplicationFailure.nonRetryable(STRUCTURED_OUTPUT_DISABLED);
87
- }
88
80
  //# sourceMappingURL=temporal-model.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"temporal-model.js","sourceRoot":"","sources":["../src/temporal-model.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA2FA,wDAEC;AA7FD,6CAA4C;AAE5C,+DAAiD;AAEjD,+CAAwD;AAIxD,MAAM,0BAA0B,GAC9B,uDAAuD;IACvD,yEAAyE;IACzE,yDAAyD,CAAC;AAiB5D;;;;;;;;GAQG;AACH,MAAa,aAAc,SAAQ,WAAsB;IACtC,SAAS,CAAU;IACnB,eAAe,CAAkB;IACjC,cAAc,CAAU;IACxB,sBAAsB,CAAW;IAElD,YAAY,UAAgC,EAAE;QAC5C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;QACrD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,IAAI,kBAAkB,CAAC;IACrF,CAAC;IAEQ,YAAY,CAAC,OAAwB;QAC5C,8EAA8E;IAChF,CAAC;IAEQ,SAAS;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAEQ,KAAK,CAAC,CAAC,MAAM,CAAC,QAAmB,EAAE,OAAuB;QACjE,MAAM,iBAAiB,GAAG,QAAQ,CAAC,eAAe,CAG/C;YACD,mBAAmB,EAAE,YAAY;YACjC,GAAG,IAAI,CAAC,eAAe;SACxB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc;YAChC,CAAC,CAAC,MAAM,iBAAiB,CAAC,oBAAoB,CAAC;gBAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ;gBACR,OAAO;gBACP,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;aACpD,CAAC;YACJ,CAAC,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC;gBAClC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;QAEP,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAjDD,sCAiDC;AAKD,SAAgB,sBAAsB;IACpC,MAAM,2BAAkB,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;AACpE,CAAC"}
1
+ {"version":3,"file":"temporal-model.js","sourceRoot":"","sources":["../src/temporal-model.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAA4C;AAE5C,+DAAiD;AAoBjD;;;;;;;;GAQG;AACH,MAAa,aAAc,SAAQ,WAAsB;IACtC,SAAS,CAAU;IACnB,eAAe,CAAkB;IACjC,cAAc,CAAU;IACxB,sBAAsB,CAAW;IAElD,YAAY,UAAgC,EAAE;QAC5C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;QACrD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,IAAI,kBAAkB,CAAC;IACrF,CAAC;IAEQ,YAAY,CAAC,OAAwB;QAC5C,8EAA8E;IAChF,CAAC;IAEQ,SAAS;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;IAEQ,KAAK,CAAC,CAAC,MAAM,CAAC,QAAmB,EAAE,OAAuB;QACjE,MAAM,iBAAiB,GAAG,QAAQ,CAAC,eAAe,CAG/C;YACD,mBAAmB,EAAE,YAAY;YACjC,GAAG,IAAI,CAAC,eAAe;SACxB,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc;YAChC,CAAC,CAAC,MAAM,iBAAiB,CAAC,oBAAoB,CAAC;gBAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ;gBACR,OAAO;gBACP,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;aACpD,CAAC;YACJ,CAAC,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC;gBAClC,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ;gBACR,OAAO;aACR,CAAC,CAAC;QAEP,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAjDD,sCAiDC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@temporalio/strands-agents",
3
- "version": "1.22.0",
3
+ "version": "1.23.0",
4
4
  "description": "Temporal Strands Agents integration package",
5
5
  "main": "lib/index.js",
6
6
  "types": "./lib/index.d.ts",
@@ -24,11 +24,11 @@
24
24
  "@ungap/structured-clone": "^1.3.1",
25
25
  "headers-polyfill": "^4.0.3",
26
26
  "web-streams-polyfill": "^4.2.0",
27
- "@temporalio/activity": "1.22.0",
28
- "@temporalio/common": "1.22.0",
29
- "@temporalio/workflow": "1.22.0",
30
- "@temporalio/workflow-streams": "1.22.0",
31
- "@temporalio/plugin": "1.22.0"
27
+ "@temporalio/plugin": "1.23.0",
28
+ "@temporalio/activity": "1.23.0",
29
+ "@temporalio/workflow": "1.23.0",
30
+ "@temporalio/common": "1.23.0",
31
+ "@temporalio/workflow-streams": "1.23.0"
32
32
  },
33
33
  "peerDependencies": {
34
34
  "@strands-agents/sdk": "^1.3.0",
@@ -39,14 +39,14 @@
39
39
  "@strands-agents/sdk": "^1.3.0",
40
40
  "ava": "^5.3.1",
41
41
  "zod": "^4.1.12",
42
- "@temporalio/test-helpers": "1.22.0",
43
- "@temporalio/client": "1.22.0",
44
- "@temporalio/proto": "1.22.0",
45
- "@temporalio/testing": "1.22.0",
46
- "@temporalio/worker": "1.22.0"
42
+ "@temporalio/client": "1.23.0",
43
+ "@temporalio/proto": "1.23.0",
44
+ "@temporalio/testing": "1.23.0",
45
+ "@temporalio/worker": "1.23.0",
46
+ "@temporalio/test-helpers": "1.23.0"
47
47
  },
48
48
  "engines": {
49
- "node": ">= 20.0.0"
49
+ "node": ">= 20.3.0"
50
50
  },
51
51
  "bugs": {
52
52
  "url": "https://github.com/temporalio/sdk-typescript/issues"
@@ -73,4 +73,5 @@ export class StrandsFailureConverter extends DefaultFailureConverter implements
73
73
  }
74
74
  }
75
75
 
76
+ // ts-prune-ignore-next
76
77
  export const failureConverter: FailureConverter = new StrandsFailureConverter();
package/src/plugin.ts CHANGED
@@ -33,10 +33,11 @@ import {
33
33
  * true` to list once at the start of the workflow instead.
34
34
  *
35
35
  * - `mcpConnectionIdleTimeout` — how long a worker-process MCP connection is
36
- * kept open between `callTool` activities before it's disconnected. The timer
37
- * resets on every reuse. Accepts a millisecond number or a duration string
38
- * (e.g. `'5 minutes'`), like `startToCloseTimeout`. Defaults to
39
- * {@link MCP_CONNECTION_IDLE_MS} (5 minutes).
36
+ * kept open between `callTool` activities before it's disconnected. The window
37
+ * only starts once no activity is using the connection, so it never cuts off
38
+ * an in-flight call, however long it runs. Accepts a millisecond number or a
39
+ * duration string (e.g. `'5 minutes'`), like `startToCloseTimeout`. Defaults
40
+ * to {@link MCP_CONNECTION_IDLE_MS} (5 minutes).
40
41
  */
41
42
  export interface StrandsPluginOptions {
42
43
  models?: Record<string, () => Model>;
@@ -161,8 +161,9 @@ export function buildListToolsActivity(
161
161
  ): (input: { server: string }) => Promise<McpToolInfo[]> {
162
162
  const name = listToolsActivityName(server);
163
163
  const fn = async (_input: { server: string }): Promise<McpToolInfo[]> => {
164
- const client = await getConnection(server, factory, idleMs);
164
+ const record = acquireConnection(server, factory);
165
165
  try {
166
+ const client = await record.client;
166
167
  const tools = await client.listTools();
167
168
  return tools.map((t) => ({
168
169
  name: t.name,
@@ -174,6 +175,10 @@ export function buildListToolsActivity(
174
175
  // the next call reconnects to the current deployment.
175
176
  await _evictConnection(server);
176
177
  throw err;
178
+ } finally {
179
+ // No more in-flight call on this connection; let idle eviction resume
180
+ // (no-op if the connection was just evicted above).
181
+ releaseConnection(server, record, idleMs);
177
182
  }
178
183
  };
179
184
  Object.defineProperty(fn, 'name', { value: name });
@@ -181,61 +186,96 @@ export function buildListToolsActivity(
181
186
  }
182
187
 
183
188
  /**
184
- * Default for how long an idle MCP connection is kept open before it's
185
- * disconnected. The timer resets on every {@link callToolActivityName |
186
- * callTool} that reuses the connection. Override per worker via
187
- * `StrandsPlugin({ mcpConnectionIdleMs })`.
189
+ * Default for how long an *idle* MCP connection is kept open before it's
190
+ * disconnected. The window only starts once no {@link callToolActivityName |
191
+ * callTool} or {@link listToolsActivityName | listTools} activity is using the
192
+ * connection, so a call that runs longer than this is never cut off. Override
193
+ * per worker via `StrandsPlugin({ mcpConnectionIdleTimeout })`.
188
194
  */
189
195
  export const MCP_CONNECTION_IDLE_MS = 5 * 60 * 1000;
190
196
 
191
- // Worker-process caches, keyed by server name. Activities run in the worker's
192
- // Node process, so this module state is shared across every activity invocation on the worker.
193
- const CONNECTIONS: Map<string, Promise<McpClient>> = new Map();
194
- const IDLE_TIMERS: Map<string, NodeJS.Timeout> = new Map();
195
-
196
- function resetIdleTimer(server: string, idleMs: number): void {
197
- const existing = IDLE_TIMERS.get(server);
198
- if (existing !== undefined) clearTimeout(existing);
199
- const timer = setTimeout(() => void _evictConnection(server), idleMs);
200
- // Don't let an idle MCP connection keep the worker process alive.
201
- timer.unref?.();
202
- IDLE_TIMERS.set(server, timer);
197
+ /** A worker-process MCP connection plus the state governing its idle eviction. */
198
+ interface ConnectionRecord {
199
+ /** Resolves to the connected client, or rejects if the handshake failed. */
200
+ client: Promise<McpClient>;
201
+ /** Number of activities currently using this connection. */
202
+ inflight: number;
203
+ /** Armed only while `inflight` is 0. */
204
+ idleTimer?: NodeJS.Timeout;
203
205
  }
204
206
 
207
+ // Worker-process cache, keyed by server name. Activities run in the worker's
208
+ // Node process, so this module state is shared across every activity invocation on the worker.
209
+ const CONNECTIONS: Map<string, ConnectionRecord> = new Map();
210
+
205
211
  export async function _evictConnection(server: string): Promise<void> {
206
- const timer = IDLE_TIMERS.get(server);
207
- if (timer !== undefined) {
208
- clearTimeout(timer);
209
- IDLE_TIMERS.delete(server);
210
- }
211
- const entry = CONNECTIONS.get(server);
212
- if (entry === undefined) return;
212
+ const record = CONNECTIONS.get(server);
213
+ if (record === undefined) return;
214
+ // Delete before awaiting: a call arriving during `disconnect` must open a
215
+ // fresh connection rather than join the one being torn down.
213
216
  CONNECTIONS.delete(server);
217
+ if (record.idleTimer !== undefined) {
218
+ clearTimeout(record.idleTimer);
219
+ record.idleTimer = undefined;
220
+ }
214
221
  try {
215
- const client = await entry;
222
+ const client = await record.client;
216
223
  await client.disconnect();
217
224
  } catch {
218
225
  // Best-effort; the session may already be broken.
219
226
  }
220
227
  }
221
228
 
222
- function getConnection(server: string, factory: () => McpClient, idleMs: number): Promise<McpClient> {
223
- let entry = CONNECTIONS.get(server);
224
- if (entry === undefined) {
225
- entry = (async () => {
226
- const client = factory();
227
- await client.connect();
228
- return client;
229
- })();
230
- CONNECTIONS.set(server, entry);
229
+ /**
230
+ * Return the cached connection for `server`, opening one lazily if needed, and
231
+ * mark a call in flight so idle eviction can't disconnect underneath it.
232
+ * Concurrent first-callers dedupe onto a single connect handshake by awaiting
233
+ * the same record. Every caller must {@link releaseConnection} once its call
234
+ * completes.
235
+ */
236
+ function acquireConnection(server: string, factory: () => McpClient): ConnectionRecord {
237
+ let record = CONNECTIONS.get(server);
238
+ if (record === undefined) {
239
+ const entry: ConnectionRecord = {
240
+ inflight: 0,
241
+ client: (async () => {
242
+ const client = factory();
243
+ await client.connect();
244
+ return client;
245
+ })(),
246
+ };
231
247
  // If the connect handshake fails, drop the rejected promise so the next
232
248
  // call retries instead of caching the failure forever.
233
- entry.catch(() => {
249
+ entry.client.catch(() => {
234
250
  if (CONNECTIONS.get(server) === entry) CONNECTIONS.delete(server);
235
251
  });
252
+ CONNECTIONS.set(server, entry);
253
+ record = entry;
254
+ }
255
+ record.inflight += 1;
256
+ if (record.idleTimer !== undefined) {
257
+ clearTimeout(record.idleTimer);
258
+ record.idleTimer = undefined;
236
259
  }
237
- resetIdleTimer(server, idleMs);
238
- return entry;
260
+ return record;
261
+ }
262
+
263
+ /** Mark a call done; arm idle eviction once no calls remain in flight. */
264
+ function releaseConnection(server: string, record: ConnectionRecord, idleMs: number): void {
265
+ record.inflight -= 1;
266
+ // Only the record still cached under this server arms a timer; a record
267
+ // already evicted must not schedule one, or it could later evict a
268
+ // different, healthy connection for the same server.
269
+ if (record.inflight > 0 || CONNECTIONS.get(server) !== record) return;
270
+ const timer = setTimeout(() => {
271
+ // `acquireConnection` clears this timer synchronously, so a pending timer
272
+ // implies the connection is still idle; re-checked to keep that invariant
273
+ // local.
274
+ if (record.inflight === 0) void _evictConnection(server);
275
+ }, idleMs);
276
+ // Don't let an idle MCP connection keep the worker process alive.
277
+ timer.unref?.();
278
+ record.idleTimer = timer;
239
279
  }
240
280
 
241
281
  /**
@@ -255,18 +295,23 @@ export function buildCallToolActivity(
255
295
  ActivityContext.current().log.debug(`Calling MCP tool ${input.toolName} on server ${server}`, {
256
296
  activityId: activityInfo().activityId,
257
297
  });
258
- const client = await getConnection(server, factory, idleMs);
298
+ const record = acquireConnection(server, factory);
259
299
  // Dispatch by name without re-listing tools on the connection: the agent
260
300
  // already has the schema from `listTools`, and `McpClient.callTool` only
261
301
  // reads `tool.name` to build the request. A minimal `{ name }` matches the
262
302
  // by-name dispatch the Python SDK does via `session.call_tool`.
263
303
  const tool = { name: input.toolName } as unknown as Parameters<McpClient['callTool']>[0];
264
304
  try {
305
+ const client = await record.client;
265
306
  return await client.callTool(tool, input.args);
266
307
  } catch (err) {
267
308
  // The session may be broken; drop it so the next call reconnects.
268
309
  await _evictConnection(server);
269
310
  throw err;
311
+ } finally {
312
+ // No more in-flight call on this connection; let idle eviction resume
313
+ // (no-op if the connection was just evicted above).
314
+ releaseConnection(server, record, idleMs);
270
315
  }
271
316
  };
272
317
  Object.defineProperty(fn, 'name', { value: name });
@@ -2,14 +2,8 @@ import { Model } from '@strands-agents/sdk';
2
2
  import type { BaseModelConfig, Message, ModelStreamEvent, StreamOptions } from '@strands-agents/sdk';
3
3
  import * as workflow from '@temporalio/workflow';
4
4
  import type { ActivityOptions } from '@temporalio/workflow';
5
- import { ApplicationFailure } from '@temporalio/common';
6
5
  import type { Duration } from '@temporalio/common/lib/time';
7
- import type { InvokeModelInput, InvokeModelStreamingInput, ModelActivity } from './model-activity';
8
-
9
- const STRUCTURED_OUTPUT_DISABLED =
10
- 'TemporalModel.structuredOutput is not supported. Use ' +
11
- 'TemporalAgent({ structuredOutputSchema: ... }) which routes structured ' +
12
- 'output through stream() via the structured-output tool.';
6
+ import type { InvokeModelInput, InvokeModelStreamingInput } from './model-activity';
13
7
 
14
8
  /**
15
9
  * Options for {@link TemporalModel}.
@@ -85,10 +79,3 @@ export class TemporalModel extends Model<BaseModelConfig> {
85
79
  }
86
80
  }
87
81
  }
88
-
89
- /** Type tag used only to forward the `ModelActivity` type from the activity side. */
90
- export type _ModelActivityRef = ModelActivity;
91
-
92
- export function rejectStructuredOutput(): never {
93
- throw ApplicationFailure.nonRetryable(STRUCTURED_OUTPUT_DISABLED);
94
- }