@aws-blocks/bb-agent 0.3.1 → 0.3.2

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/agent.js

@@ -6,13 +6,10 @@ import { Realtime } from '@aws-blocks/bb-realtime';
 import { AsyncJob } from '@aws-blocks/bb-async-job';
 import { FileBucket } from '@aws-blocks/bb-file-bucket';
 import { Logger } from '@aws-blocks/bb-logger';
-import { Agent as StrandsAgent, tool, SessionManager, ModelStreamUpdateEvent, AfterToolCallEvent, BeforeToolCallEvent, AgentResultEvent } from '@strands-agents/sdk';
-import { InterruptResponseContent } from '@strands-agents/sdk';
 import { z } from 'zod';
 import { createStrandsModel, checkModelHealth } from './model-factory.js';
 import { messageSchema, conversationSchema, agentStreamChunkSchema } from './schemas.js';
 import { AgentErrors, blocksAgentError, InterruptError } from './errors.js';
-import { SlidingWindowConversationManager, SummarizingConversationManager } from '@strands-agents/sdk';
 import { BB_NAME, BB_VERSION } from './version.js';
 import { ulid } from 'ulid';
 /** Payload submitted to the internal AsyncJob BB. */
@@ -28,6 +25,25 @@ const jobPayloadSchema = z.object({
 });
 /** Key under which the per-call tool context is threaded through Strands `invocationState`. */
 const TOOL_CONTEXT_KEY = '__bbAgentToolContext';
+/**
+ * Lazily import the Strands SDK runtime, caching the module after the first load.
+ *
+ * Importing the Agent BB must not eagerly evaluate `@strands-agents/sdk`: the
+ * `@aws-blocks/blocks` umbrella re-exports `Agent` statically, so a static top-level
+ * import here would load Strands — and its non-optional `@modelcontextprotocol/sdk`
+ * and `@opentelemetry/api` peers — for every app that touches the umbrella, even
+ * ones that never create an agent (see issue #153). Deferring the import to first
+ * agent execution keeps those packages off the load path for non-agent apps.
+ */
+let strandsModulePromise;
+function loadStrands() {
+    strandsModulePromise ??= import('@strands-agents/sdk').catch((err) => {
+        // Don't cache a rejected import — clear the slot so a later call can retry.
+        strandsModulePromise = undefined;
+        return Promise.reject(err);
+    });
+    return strandsModulePromise;
+}
 /**
  * The per-call tool factory handed to the `tools` callback. At runtime it's an identity
  * function whose only job is to give TypeScript a single call site per tool where it can
@@ -54,7 +70,8 @@ function resolveTools(toolsConfig) {
  * Controls how message history is trimmed in-memory before sending to the model. Does not handle persistence.
  * @see https://strandsagents.com/docs/user-guide/concepts/agents/conversation-management/
  */
-function createConversationManager(config) {
+async function createConversationManager(config) {
+    const { SlidingWindowConversationManager, SummarizingConversationManager } = await loadStrands();
     if (!config || !config.strategy || config.strategy === 'sliding-window') {
         const windowSize = config && 'windowSize' in config ? config.windowSize : undefined;
         return new SlidingWindowConversationManager({ windowSize });
@@ -174,6 +191,7 @@ export class AgentBase extends Scope {
      * TODO add comments for args
      */
     async runAgent(message, conversationId, channelId, userId, interruptResponses, context) {
+        const { InterruptResponseContent, ModelStreamUpdateEvent, BeforeToolCallEvent, AfterToolCallEvent, AgentResultEvent } = await loadStrands();
         const strandsAgent = await this.createStrandsAgent(conversationId, context);
         const startTime = Date.now();
         // Only persist user message on initial path (not resume)
@@ -278,6 +296,7 @@ export class AgentBase extends Scope {
         await this.rt.publish('chunks', channelId, { type: 'done', text: fullText, usage });
     }
     async createStrandsAgent(conversationId, fallbackContext) {
+        const { Agent: StrandsAgent, tool, SessionManager, BeforeToolCallEvent } = await loadStrands();
         const toolDefs = [...this.toolMap.values()];
         // Validate mutual exclusivity of needsApproval/trustable and interrupt
         for (const t of toolDefs) {
@@ -328,7 +347,7 @@ export class AgentBase extends Scope {
             ...(this.config.description !== undefined && { description: this.config.description }),
             systemPrompt: this.config.systemPrompt,
             tools: strandsTools,
-            conversationManager: createConversationManager(this.config.conversation),
+            conversationManager: await createConversationManager(this.config.conversation),
             sessionManager,
             printer: false, //disable Strands automatic printing
         });

package/dist/model-factory.d.ts

@@ -1,5 +1,4 @@
-import { type Model } from '@strands-agents/sdk';
-import type { BaseModelConfig } from '@strands-agents/sdk';
+import type { Model, BaseModelConfig } from '@strands-agents/sdk';
 import type { ChildLogger } from '@aws-blocks/bb-logger';
 import type { ModelConfig } from './types.js';
 /**

package/dist/model-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-factory.d.ts","sourceRoot":"","sources":["../src/model-factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C;;;;;;;GAOG;AACH,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACjC;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqHjI;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAkDjH"}
+{"version":3,"file":"model-factory.d.ts","sourceRoot":"","sources":["../src/model-factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C;;;;;;;GAOG;AACH,yDAAyD;AACzD,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CACjC;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqHjI;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAwDjH"}

package/dist/model-factory.js

@@ -1,9 +1,5 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-import { BedrockModel } from '@strands-agents/sdk';
-import { OpenAIModel } from '@strands-agents/sdk/models/openai';
-import { CannedProvider } from './providers/canned.js';
-import { ThrowingProvider } from './providers/throwing.js';
 import { AgentErrors, blocksAgentError } from './errors.js';
 export async function checkModelHealth(config, log, _testClient) {
     if (!config || config.provider === 'canned') {
@@ -122,17 +118,21 @@ export async function checkModelHealth(config, log, _testClient) {
  * @see https://strandsagents.com/docs/user-guide/concepts/model-providers/
  */
 export async function createStrandsModel(config, log) {
-    if (!config || config.provider === 'canned')
+    if (!config || config.provider === 'canned') {
+        const { CannedProvider } = await import('./providers/canned.js');
         return new CannedProvider();
+    }
     // Test-only provider — throws mid-stream to verify error handling
     if (config.provider === 'throwing') {
         log?.warn('ThrowingProvider is only for internal test purposes');
+        const { ThrowingProvider } = await import('./providers/throwing.js');
         return new ThrowingProvider();
     }
     if (config.provider === 'bedrock') {
         if (!config.modelId) {
             throw blocksAgentError(AgentErrors.InvalidModelConfig, "Model provider 'bedrock' requires modelId.");
         }
+        const { BedrockModel } = await import('@strands-agents/sdk');
         return new BedrockModel({
             modelId: config.modelId,
             ...(config.inferenceConfig && {
@@ -152,6 +152,7 @@ export async function createStrandsModel(config, log) {
         if (!apiKey && !process.env.OPENAI_API_KEY) {
             throw blocksAgentError(AgentErrors.InvalidModelConfig, "provider 'openai-api' requires apiKey or OPENAI_API_KEY environment variable.");
         }
+        const { OpenAIModel } = await import('@strands-agents/sdk/models/openai');
         return new OpenAIModel({
             api: 'chat',
             apiKey: apiKey ?? '',

package/dist/schemas.d.ts

@@ -12,11 +12,11 @@ export declare const messageSchema: z.ZodObject<{
     conversationId: z.ZodString;
     messageId: z.ZodString;
     role: z.ZodEnum<{
-        user: "user";
-        assistant: "assistant";
-        interrupt: "interrupt";
         "tool-call": "tool-call";
         "tool-result": "tool-result";
+        interrupt: "interrupt";
+        user: "user";
+        assistant: "assistant";
         approval: "approval";
     }>;
     content: z.ZodString;
@@ -34,12 +34,12 @@ export declare const messageSchema: z.ZodObject<{
 /** Schema for AgentStreamChunk — used by Realtime namespace validation. */
 export declare const agentStreamChunkSchema: z.ZodObject<{
     type: z.ZodEnum<{
-        interrupt: "interrupt";
         "text-delta": "text-delta";
         "tool-call": "tool-call";
         "tool-result": "tool-result";
         done: "done";
         error: "error";
+        interrupt: "interrupt";
     }>;
     text: z.ZodOptional<z.ZodString>;
     toolName: z.ZodOptional<z.ZodString>;

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare const BB_NAME = "Agent";
-export declare const BB_VERSION = "0.3.1";
+export declare const BB_VERSION = "0.3.2";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.mjs — do not edit manually
 export const BB_NAME = 'Agent';
-export const BB_VERSION = '0.3.1';
+export const BB_VERSION = '0.3.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-blocks/bb-agent",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "author": "Amazon Web Services",
   "license": "Apache-2.0",
   "type": "module",
@@ -41,6 +41,7 @@
     "@aws-blocks/bb-realtime": "^0.1.2",
     "@aws-blocks/core": "^0.1.10",
     "@aws-sdk/client-bedrock": "^3.700.0",
+    "@opentelemetry/api": "^1.9.0",
     "@strands-agents/sdk": "~1.3.0",
     "openai": "^6.7.0",
     "ulid": "^2.3.0",
@@ -49,7 +50,6 @@
   "devDependencies": {
     "@aws-sdk/client-bedrock-runtime": "^3.700.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "@opentelemetry/api": "^1.9.0",
     "@types/node": "^20.0.0",
     "typescript": "^5.3.0"
   },

package/src/agent.ts

@@ -9,16 +9,14 @@ import { AsyncJob } from '@aws-blocks/bb-async-job';
 import { FileBucket } from '@aws-blocks/bb-file-bucket';
 import { Logger } from '@aws-blocks/bb-logger';
 import type { ChildLogger } from '@aws-blocks/bb-logger';
-import { Agent as StrandsAgent, tool, SessionManager, ModelStreamUpdateEvent, AfterToolCallEvent, BeforeToolCallEvent, AgentResultEvent, InterruptEvent } from '@strands-agents/sdk';
-import type { AgentResult } from '@strands-agents/sdk';
-import { InterruptResponseContent } from '@strands-agents/sdk';
+// Runtime values from `@strands-agents/sdk` are deferred to loadStrands(); only types
+// are imported here (erased at compile time). See loadStrands() / issue #153.
+import type { Agent as StrandsAgent, SnapshotStorage } from '@strands-agents/sdk';
 import { z } from 'zod';
 import { createStrandsModel, checkModelHealth } from './model-factory.js';
-import type { SnapshotStorage } from '@strands-agents/sdk';
 import { messageSchema, conversationSchema, agentStreamChunkSchema } from './schemas.js';
 import type { AgentConfig, AgentStreamChunk, AgentStreamResult, StreamOptions, Message, Conversation, TokenUsage, ConversationManagerConfig, ModelConfig, JSONValue, InterruptResponse, DefaultToolContext, AgentTool, ToolDefinition } from './types.js';
 import { AgentErrors, blocksAgentError, InterruptError } from './errors.js';
-import { SlidingWindowConversationManager, SummarizingConversationManager } from '@strands-agents/sdk';
 import { BB_NAME, BB_VERSION } from './version.js';
 import { ulid } from 'ulid';
 
@@ -37,6 +35,26 @@ const jobPayloadSchema = z.object({
 /** Key under which the per-call tool context is threaded through Strands `invocationState`. */
 const TOOL_CONTEXT_KEY = '__bbAgentToolContext';
 
+/**
+ * Lazily import the Strands SDK runtime, caching the module after the first load.
+ *
+ * Importing the Agent BB must not eagerly evaluate `@strands-agents/sdk`: the
+ * `@aws-blocks/blocks` umbrella re-exports `Agent` statically, so a static top-level
+ * import here would load Strands — and its non-optional `@modelcontextprotocol/sdk`
+ * and `@opentelemetry/api` peers — for every app that touches the umbrella, even
+ * ones that never create an agent (see issue #153). Deferring the import to first
+ * agent execution keeps those packages off the load path for non-agent apps.
+ */
+let strandsModulePromise: Promise<typeof import('@strands-agents/sdk')> | undefined;
+function loadStrands(): Promise<typeof import('@strands-agents/sdk')> {
+	strandsModulePromise ??= import('@strands-agents/sdk').catch((err) => {
+		// Don't cache a rejected import — clear the slot so a later call can retry.
+		strandsModulePromise = undefined;
+		return Promise.reject(err);
+	});
+	return strandsModulePromise;
+}
+
 /**
  * The per-call tool factory handed to the `tools` callback. At runtime it's an identity
  * function whose only job is to give TypeScript a single call site per tool where it can
@@ -66,7 +84,8 @@ function resolveTools<TContext>(
  * Controls how message history is trimmed in-memory before sending to the model. Does not handle persistence.
  * @see https://strandsagents.com/docs/user-guide/concepts/agents/conversation-management/
  */
-function createConversationManager(config?: ConversationManagerConfig) {
+async function createConversationManager(config?: ConversationManagerConfig) {
+	const { SlidingWindowConversationManager, SummarizingConversationManager } = await loadStrands();
 	if (!config || !config.strategy || config.strategy === 'sliding-window') {
 		const windowSize = config && 'windowSize' in config ? config.windowSize : undefined;
 		return new SlidingWindowConversationManager({ windowSize });
@@ -192,6 +211,7 @@ export class AgentBase<TContext = DefaultToolContext> extends Scope {
 	 * TODO add comments for args
 	 */
 	private async runAgent(message: string, conversationId: string | undefined, channelId: string, userId: string, interruptResponses?: Array<{ interruptId: string; response: string }>, context?: TContext): Promise<void> {
+		const { InterruptResponseContent, ModelStreamUpdateEvent, BeforeToolCallEvent, AfterToolCallEvent, AgentResultEvent } = await loadStrands();
 		const strandsAgent = await this.createStrandsAgent(conversationId, context);
 		const startTime = Date.now();
 
@@ -298,6 +318,7 @@ export class AgentBase<TContext = DefaultToolContext> extends Scope {
 	}
 
 	private async createStrandsAgent(conversationId?: string, fallbackContext?: TContext): Promise<StrandsAgent> {
+		const { Agent: StrandsAgent, tool, SessionManager, BeforeToolCallEvent } = await loadStrands();
 		const toolDefs = [...this.toolMap.values()];
 		// Validate mutual exclusivity of needsApproval/trustable and interrupt
 		for (const t of toolDefs) {
@@ -351,7 +372,7 @@ export class AgentBase<TContext = DefaultToolContext> extends Scope {
 			...(this.config.description !== undefined && { description: this.config.description }),
 			systemPrompt: this.config.systemPrompt,
 			tools: strandsTools,
-			conversationManager: createConversationManager(this.config.conversation),
+			conversationManager: await createConversationManager(this.config.conversation),
 			sessionManager,
 			printer: false, //disable Strands automatic printing
 		});

package/src/model-factory.ts

@@ -1,12 +1,13 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 
-import { BedrockModel, type Model } from '@strands-agents/sdk';
-import type { BaseModelConfig } from '@strands-agents/sdk';
-import { OpenAIModel } from '@strands-agents/sdk/models/openai';
+// Strands runtime is loaded lazily inside createStrandsModel(); only types are
+// imported here. See loadStrands() in agent.ts and issue #153.
+import type { Model, BaseModelConfig } from '@strands-agents/sdk';
 import type { ChildLogger } from '@aws-blocks/bb-logger';
-import { CannedProvider } from './providers/canned.js';
-import { ThrowingProvider } from './providers/throwing.js';
+// `./providers/canned` and `./providers/throwing` extend Strands' `Model`, so importing
+// them would evaluate `@strands-agents/sdk` at load time — hence they're also loaded
+// lazily inside createStrandsModel(). See issue #153.
 import type { ModelConfig } from './types.js';
 import { AgentErrors, blocksAgentError } from './errors.js';
 
@@ -152,11 +153,15 @@ export async function checkModelHealth(config: ModelConfig, log: ChildLogger, _t
  * @see https://strandsagents.com/docs/user-guide/concepts/model-providers/
  */
 export async function createStrandsModel(config?: ModelConfig, log?: ChildLogger): Promise<Model<BaseModelConfig>> {
-	if (!config || config.provider === 'canned') return new CannedProvider();
+	if (!config || config.provider === 'canned') {
+		const { CannedProvider } = await import('./providers/canned.js');
+		return new CannedProvider();
+	}
 
 	// Test-only provider — throws mid-stream to verify error handling
 	if (config.provider === 'throwing' as string) {
 		log?.warn('ThrowingProvider is only for internal test purposes');
+		const { ThrowingProvider } = await import('./providers/throwing.js');
 		return new ThrowingProvider();
 	}
 
@@ -164,6 +169,7 @@ export async function createStrandsModel(config?: ModelConfig, log?: ChildLogger
 		if (!config.modelId) {
 			throw blocksAgentError(AgentErrors.InvalidModelConfig, "Model provider 'bedrock' requires modelId.");
 		}
+		const { BedrockModel } = await import('@strands-agents/sdk');
 		return new BedrockModel({
 			modelId: config.modelId,
 			...(config.inferenceConfig && {
@@ -184,6 +190,7 @@ export async function createStrandsModel(config?: ModelConfig, log?: ChildLogger
 		if (!apiKey && !process.env.OPENAI_API_KEY) {
 			throw blocksAgentError(AgentErrors.InvalidModelConfig, "provider 'openai-api' requires apiKey or OPENAI_API_KEY environment variable.");
 		}
+		const { OpenAIModel } = await import('@strands-agents/sdk/models/openai');
 		return new OpenAIModel({
 			api: 'chat',
 			apiKey: apiKey ?? '',

package/src/version.ts

@@ -1,3 +1,3 @@
 // Auto-generated by scripts/generate-version.mjs — do not edit manually
 export const BB_NAME = 'Agent';
-export const BB_VERSION = '0.3.1';
+export const BB_VERSION = '0.3.2';