agentstack-sdk 0.6.1 → 0.6.2-rc2

package/dist/types-MfIzGgpV.d.cts

@@ -0,0 +1,43 @@
+import z__default from 'zod';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare const llmDemandSchema: z__default.ZodObject<{
+    description: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+    suggested: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodArray<z__default.ZodString>>>;
+}, z__default.core.$strip>;
+declare const llmDemandsSchema: z__default.ZodObject<{
+    llm_demands: z__default.ZodRecord<z__default.ZodString, z__default.ZodObject<{
+        description: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+        suggested: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodArray<z__default.ZodString>>>;
+    }, z__default.core.$strip>>;
+}, z__default.core.$strip>;
+declare const llmFulfillmentSchema: z__default.ZodObject<{
+    identifier: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+    api_base: z__default.ZodString;
+    api_key: z__default.ZodString;
+    api_model: z__default.ZodString;
+}, z__default.core.$strip>;
+declare const llmFulfillmentsSchema: z__default.ZodObject<{
+    llm_fulfillments: z__default.ZodRecord<z__default.ZodString, z__default.ZodObject<{
+        identifier: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+        api_base: z__default.ZodString;
+        api_key: z__default.ZodString;
+        api_model: z__default.ZodString;
+    }, z__default.core.$strip>>;
+}, z__default.core.$strip>;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type LLMDemand = z__default.infer<typeof llmDemandSchema>;
+type LLMDemands = z__default.infer<typeof llmDemandsSchema>;
+type LLMFulfillment = z__default.infer<typeof llmFulfillmentSchema>;
+type LLMFulfillments = z__default.infer<typeof llmFulfillmentsSchema>;
+
+export { type LLMDemand as L, type LLMDemands as a, type LLMFulfillment as b, type LLMFulfillments as c, llmDemandsSchema as d, llmFulfillmentSchema as e, llmFulfillmentsSchema as f, llmDemandSchema as l };

package/dist/types-MfIzGgpV.d.ts

@@ -0,0 +1,43 @@
+import z__default from 'zod';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare const llmDemandSchema: z__default.ZodObject<{
+    description: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+    suggested: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodArray<z__default.ZodString>>>;
+}, z__default.core.$strip>;
+declare const llmDemandsSchema: z__default.ZodObject<{
+    llm_demands: z__default.ZodRecord<z__default.ZodString, z__default.ZodObject<{
+        description: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+        suggested: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodArray<z__default.ZodString>>>;
+    }, z__default.core.$strip>>;
+}, z__default.core.$strip>;
+declare const llmFulfillmentSchema: z__default.ZodObject<{
+    identifier: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+    api_base: z__default.ZodString;
+    api_key: z__default.ZodString;
+    api_model: z__default.ZodString;
+}, z__default.core.$strip>;
+declare const llmFulfillmentsSchema: z__default.ZodObject<{
+    llm_fulfillments: z__default.ZodRecord<z__default.ZodString, z__default.ZodObject<{
+        identifier: z__default.ZodOptional<z__default.ZodNullable<z__default.ZodString>>;
+        api_base: z__default.ZodString;
+        api_key: z__default.ZodString;
+        api_model: z__default.ZodString;
+    }, z__default.core.$strip>>;
+}, z__default.core.$strip>;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type LLMDemand = z__default.infer<typeof llmDemandSchema>;
+type LLMDemands = z__default.infer<typeof llmDemandsSchema>;
+type LLMFulfillment = z__default.infer<typeof llmFulfillmentSchema>;
+type LLMFulfillments = z__default.infer<typeof llmFulfillmentsSchema>;
+
+export { type LLMDemand as L, type LLMDemands as a, type LLMFulfillment as b, type LLMFulfillments as c, llmDemandsSchema as d, llmFulfillmentSchema as e, llmFulfillmentsSchema as f, llmDemandSchema as l };

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "agentstack-sdk",
   "author": "IBM Corp.",
-  "version": "0.6.1",
+  "version": "0.6.2-rc2",
   "type": "module",
   "scripts": {
-    "build": "rimraf dist && microbundle --format modern,cjs,umd src/*.ts",
-    "dev": "microbundle watch src/*.ts"
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "experimental:example:hello-world": "tsx watch src/examples/hello-world.ts",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "source": "src/index.ts",
   "repository": {
@@ -21,9 +24,7 @@
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
-      },
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+      }
     },
     "./api": {
       "require": {
@@ -33,9 +34,7 @@
       "import": {
         "types": "./dist/api.d.ts",
         "default": "./dist/api.js"
-      },
-      "types": "./dist/api.d.ts",
-      "default": "./dist/api.js"
+      }
     },
     "./core": {
       "require": {
@@ -45,9 +44,7 @@
       "import": {
         "types": "./dist/core.d.ts",
         "default": "./dist/core.js"
-      },
-      "types": "./dist/core.d.ts",
-      "default": "./dist/core.js"
+      }
     },
     "./extensions": {
       "require": {
@@ -57,9 +54,17 @@
       "import": {
         "types": "./dist/extensions.d.ts",
         "default": "./dist/extensions.js"
+      }
+    },
+    "./experimental/server": {
+      "require": {
+        "types": "./dist/server.d.cts",
+        "default": "./dist/server.cjs"
       },
-      "types": "./dist/extensions.d.ts",
-      "default": "./dist/extensions.js"
+      "import": {
+        "types": "./dist/server.d.ts",
+        "default": "./dist/server.js"
+      }
     },
     "./package.json": "./package.json"
   },
@@ -73,16 +78,26 @@
   "module": "dist/index.js",
   "unpkg": "dist/index.umd.js",
   "dependencies": {
-    "@a2a-js/sdk": "^0.3.7",
-    "zod": "^4.1.11"
+    "@a2a-js/sdk": "^0.3.10",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0 || ^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@i-am-bee/lint-config": "workspace:*",
-    "eslint": "^9.39.1",
-    "microbundle": "^0.15.1",
-    "prettier": "^3.7.4",
-    "rimraf": "^6.0.1",
-    "typescript": "^5.9.3"
+    "@types/express": "^4.17.21",
+    "eslint": "^9.39.2",
+    "prettier": "^3.8.1",
+    "tsup": "^8.4.0",
+    "tsx": "^4.19.4",
+    "typescript": "^5.9.3",
+    "vitest": "^3.1.3"
   },
   "packageManager": "pnpm@9.9.0"
 }

package/src/client/a2a/extensions/auth/oauth/index.ts

@@ -9,15 +9,15 @@ import type { A2AServiceExtension, A2AUiExtension } from '../../../../core/exten
 import { oauthDemandsSchema, oauthFulfillmentsSchema, oauthRequestSchema } from './schemas';
 import type { OAuthDemands, OAuthFulfillments, OAuthRequest } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/auth/oauth/v1';
+export const OAUTH_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/auth/oauth/v1';
 
-export const oauthExtension: A2AServiceExtension<typeof URI, OAuthDemands, OAuthFulfillments> = {
-  getUri: () => URI,
+export const oauthExtension: A2AServiceExtension<typeof OAUTH_EXTENSION_URI, OAuthDemands, OAuthFulfillments> = {
+  getUri: () => OAUTH_EXTENSION_URI,
   getDemandsSchema: () => oauthDemandsSchema,
   getFulfillmentsSchema: () => oauthFulfillmentsSchema,
 };
 
-export const oauthRequestExtension: A2AUiExtension<typeof URI, OAuthRequest> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: oauthRequestSchema }).partial(),
+export const oauthRequestExtension: A2AUiExtension<typeof OAUTH_EXTENSION_URI, OAuthRequest> = {
+  getUri: () => OAUTH_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [OAUTH_EXTENSION_URI]: oauthRequestSchema }).partial(),
 };

package/src/client/a2a/extensions/auth/secrets/index.ts

@@ -9,15 +9,15 @@ import type { A2AServiceExtension, A2AUiExtension } from '../../../../core/exten
 import { secretDemandsSchema, secretFulfillmentsSchema } from './schemas';
 import type { SecretDemands, SecretFulfillments } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/auth/secrets/v1';
+export const SECRETS_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/auth/secrets/v1';
 
-export const secretsExtension: A2AServiceExtension<typeof URI, SecretDemands, SecretFulfillments> = {
-  getUri: () => URI,
+export const secretsExtension: A2AServiceExtension<typeof SECRETS_EXTENSION_URI, SecretDemands, SecretFulfillments> = {
+  getUri: () => SECRETS_EXTENSION_URI,
   getDemandsSchema: () => secretDemandsSchema,
   getFulfillmentsSchema: () => secretFulfillmentsSchema,
 };
 
-export const secretsRequestExtension: A2AUiExtension<typeof URI, SecretDemands> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: secretDemandsSchema }).partial(),
+export const secretsRequestExtension: A2AUiExtension<typeof SECRETS_EXTENSION_URI, SecretDemands> = {
+  getUri: () => SECRETS_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [SECRETS_EXTENSION_URI]: secretDemandsSchema }).partial(),
 };

package/src/client/a2a/extensions/interactions/approval/index.ts

@@ -9,14 +9,14 @@ import type { A2AUiExtension } from '../../../../core/extensions/types';
 import { approvalRequestSchema, approvalResponseSchema } from './schemas';
 import type { ApprovalRequest, ApprovalResponse } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/interactions/approval/v1';
+export const APPROVAL_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/interactions/approval/v1';
 
-export const approvalExtension: A2AUiExtension<typeof URI, ApprovalRequest> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: approvalRequestSchema }).partial(),
+export const approvalExtension: A2AUiExtension<typeof APPROVAL_EXTENSION_URI, ApprovalRequest> = {
+  getUri: () => APPROVAL_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [APPROVAL_EXTENSION_URI]: approvalRequestSchema }).partial(),
 };
 
-export const approvalResponseExtension: A2AUiExtension<typeof URI, ApprovalResponse> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: approvalResponseSchema }).partial(),
+export const approvalResponseExtension: A2AUiExtension<typeof APPROVAL_EXTENSION_URI, ApprovalResponse> = {
+  getUri: () => APPROVAL_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [APPROVAL_EXTENSION_URI]: approvalResponseSchema }).partial(),
 };

package/src/client/a2a/extensions/services/embedding/index.ts

@@ -7,10 +7,14 @@ import type { A2AServiceExtension } from '../../../../core/extensions/types';
 import { embeddingDemandsSchema, embeddingFulfillmentsSchema } from './schemas';
 import type { EmbeddingDemands, EmbeddingFulfillments } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/embedding/v1';
+export const EMBEDDING_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/services/embedding/v1';
 
-export const embeddingExtension: A2AServiceExtension<typeof URI, EmbeddingDemands, EmbeddingFulfillments> = {
-  getUri: () => URI,
+export const embeddingExtension: A2AServiceExtension<
+  typeof EMBEDDING_EXTENSION_URI,
+  EmbeddingDemands,
+  EmbeddingFulfillments
+> = {
+  getUri: () => EMBEDDING_EXTENSION_URI,
   getDemandsSchema: () => embeddingDemandsSchema,
   getFulfillmentsSchema: () => embeddingFulfillmentsSchema,
 };

package/src/client/a2a/extensions/services/form/index.ts

@@ -7,10 +7,10 @@ import type { A2AServiceExtension } from '../../../../core/extensions/types';
 import { formDemandsSchema, formFulfillmentsSchema } from './schemas';
 import type { FormDemands, FormFulfillments } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/form/v1';
+export const FORM_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/services/form/v1';
 
-export const formExtension: A2AServiceExtension<typeof URI, FormDemands, FormFulfillments> = {
-  getUri: () => URI,
+export const formExtension: A2AServiceExtension<typeof FORM_EXTENSION_URI, FormDemands, FormFulfillments> = {
+  getUri: () => FORM_EXTENSION_URI,
   getDemandsSchema: () => formDemandsSchema,
   getFulfillmentsSchema: () => formFulfillmentsSchema,
 };

package/src/client/a2a/extensions/services/llm/index.ts

@@ -7,10 +7,10 @@ import type { A2AServiceExtension } from '../../../../core/extensions/types';
 import { llmDemandsSchema, llmFulfillmentsSchema } from './schemas';
 import type { LLMDemands, LLMFulfillments } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/llm/v1';
+export const LLM_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/services/llm/v1';
 
-export const llmExtension: A2AServiceExtension<typeof URI, LLMDemands, LLMFulfillments> = {
-  getUri: () => URI,
+export const llmExtension: A2AServiceExtension<typeof LLM_EXTENSION_URI, LLMDemands, LLMFulfillments> = {
+  getUri: () => LLM_EXTENSION_URI,
   getDemandsSchema: () => llmDemandsSchema,
   getFulfillmentsSchema: () => llmFulfillmentsSchema,
 };

package/src/client/a2a/extensions/services/mcp/index.ts

@@ -7,10 +7,10 @@ import type { A2AServiceExtension } from '../../../../core/extensions/types';
 import { mcpDemandsSchema, mcpFulfillmentsSchema } from './schemas';
 import type { MCPDemands, MCPFulfillments } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/mcp/v1';
+export const MCP_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/services/mcp/v1';
 
-export const mcpExtension: A2AServiceExtension<typeof URI, MCPDemands, MCPFulfillments> = {
-  getUri: () => URI,
+export const mcpExtension: A2AServiceExtension<typeof MCP_EXTENSION_URI, MCPDemands, MCPFulfillments> = {
+  getUri: () => MCP_EXTENSION_URI,
   getDemandsSchema: () => mcpDemandsSchema,
   getFulfillmentsSchema: () => mcpFulfillmentsSchema,
 };

package/src/client/a2a/extensions/services/platform-api/index.ts

@@ -5,12 +5,12 @@
 
 import type { ContextToken } from '../../../../api/contexts/types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/platform_api/v1';
+export const PLATFORM_API_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/services/platform_api/v1';
 
 export const platformApiExtension = (metadata: Record<string, unknown>, contextToken: ContextToken) => {
   return {
     ...metadata,
-    [URI]: {
+    [PLATFORM_API_EXTENSION_URI]: {
       auth_token: contextToken.token,
       expires_at: contextToken.expires_at,
     },

package/src/client/a2a/extensions/ui/agent-detail/index.ts

@@ -9,9 +9,9 @@ import type { A2AUiExtension } from '../../../../core/extensions/types';
 import { agentDetailSchema } from './schemas';
 import type { AgentDetail } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/agent-detail/v1';
+export const AGENT_DETAIL_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/agent-detail/v1';
 
-export const agentDetailExtension: A2AUiExtension<typeof URI, AgentDetail> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: agentDetailSchema }).partial(),
+export const agentDetailExtension: A2AUiExtension<typeof AGENT_DETAIL_EXTENSION_URI, AgentDetail> = {
+  getUri: () => AGENT_DETAIL_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [AGENT_DETAIL_EXTENSION_URI]: agentDetailSchema }).partial(),
 };

package/src/client/a2a/extensions/ui/canvas/index.ts

@@ -9,9 +9,9 @@ import type { A2AUiExtension } from '../../../../core/extensions/types';
 import { canvasEditRequestSchema } from './schemas';
 import type { CanvasEditRequest } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/canvas/v1';
+export const CANVAS_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/canvas/v1';
 
-export const canvasExtension: A2AUiExtension<typeof URI, CanvasEditRequest> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: canvasEditRequestSchema }).partial(),
+export const canvasExtension: A2AUiExtension<typeof CANVAS_EXTENSION_URI, CanvasEditRequest> = {
+  getUri: () => CANVAS_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [CANVAS_EXTENSION_URI]: canvasEditRequestSchema }).partial(),
 };

package/src/client/a2a/extensions/ui/citation/index.ts

@@ -9,9 +9,9 @@ import type { A2AUiExtension } from '../../../../core/extensions/types';
 import { citationMetadataSchema } from './schemas';
 import type { CitationMetadata } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/citation/v1';
+export const CITATION_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/citation/v1';
 
-export const citationExtension: A2AUiExtension<typeof URI, CitationMetadata> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: citationMetadataSchema }).partial(),
+export const citationExtension: A2AUiExtension<typeof CITATION_EXTENSION_URI, CitationMetadata> = {
+  getUri: () => CITATION_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [CITATION_EXTENSION_URI]: citationMetadataSchema }).partial(),
 };

package/src/client/a2a/extensions/ui/error/index.ts

@@ -9,9 +9,9 @@ import type { A2AUiExtension } from '../../../../core/extensions/types';
 import { errorMetadataSchema } from './schemas';
 import type { ErrorMetadata } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/error/v1';
+export const ERROR_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/error/v1';
 
-export const errorExtension: A2AUiExtension<typeof URI, ErrorMetadata> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: errorMetadataSchema }).partial(),
+export const errorExtension: A2AUiExtension<typeof ERROR_EXTENSION_URI, ErrorMetadata> = {
+  getUri: () => ERROR_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [ERROR_EXTENSION_URI]: errorMetadataSchema }).partial(),
 };

package/src/client/a2a/extensions/ui/form-request/index.ts

@@ -9,9 +9,9 @@ import type { A2AUiExtension } from '../../../../core/extensions/types';
 import { formRenderSchema } from '../../common/form/schemas';
 import type { FormRender } from '../../common/form/types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/form_request/v1';
+export const FORM_REQUEST_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/form_request/v1';
 
-export const formRequestExtension: A2AUiExtension<typeof URI, FormRender> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: formRenderSchema }).partial(),
+export const formRequestExtension: A2AUiExtension<typeof FORM_REQUEST_EXTENSION_URI, FormRender> = {
+  getUri: () => FORM_REQUEST_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [FORM_REQUEST_EXTENSION_URI]: formRenderSchema }).partial(),
 };

package/src/client/a2a/extensions/ui/settings/index.ts

@@ -7,10 +7,14 @@ import type { A2AServiceExtension } from '../../../../core/extensions/types';
 import { settingsDemandsSchema, settingsFulfillmentsSchema } from './schemas';
 import type { SettingsDemands, SettingsFulfillments } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/settings/v1';
+export const SETTINGS_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/settings/v1';
 
-export const settingsExtension: A2AServiceExtension<typeof URI, SettingsDemands, SettingsFulfillments> = {
-  getUri: () => URI,
+export const settingsExtension: A2AServiceExtension<
+  typeof SETTINGS_EXTENSION_URI,
+  SettingsDemands,
+  SettingsFulfillments
+> = {
+  getUri: () => SETTINGS_EXTENSION_URI,
   getDemandsSchema: () => settingsDemandsSchema,
   getFulfillmentsSchema: () => settingsFulfillmentsSchema,
 };

package/src/client/a2a/extensions/ui/trajectory/index.ts

@@ -9,9 +9,9 @@ import type { A2AUiExtension } from '../../../../core/extensions/types';
 import { trajectoryMetadataSchema } from './schemas';
 import type { TrajectoryMetadata } from './types';
 
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/trajectory/v1';
+export const TRAJECTORY_EXTENSION_URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/trajectory/v1';
 
-export const trajectoryExtension: A2AUiExtension<typeof URI, TrajectoryMetadata> = {
-  getUri: () => URI,
-  getMessageMetadataSchema: () => z.object({ [URI]: trajectoryMetadataSchema }).partial(),
+export const trajectoryExtension: A2AUiExtension<typeof TRAJECTORY_EXTENSION_URI, TrajectoryMetadata> = {
+  getUri: () => TRAJECTORY_EXTENSION_URI,
+  getMessageMetadataSchema: () => z.object({ [TRAJECTORY_EXTENSION_URI]: trajectoryMetadataSchema }).partial(),
 };

package/src/client/core/extensions/types.ts

@@ -56,6 +56,7 @@ export enum TaskStatusUpdateType {
   FormRequired = 'form-required',
   OAuthRequired = 'oauth-required',
   ApprovalRequired = 'approval-required',
+  TextInputRequired = 'text-input-required',
 }
 
 export interface SecretRequiredResult {
@@ -78,8 +79,14 @@ export interface ApprovalRequiredResult {
   request: ApprovalRequest;
 }
 
+export interface TextInputRequiredResult {
+  type: TaskStatusUpdateType.TextInputRequired;
+  text: string;
+}
+
 export type TaskStatusUpdateResult =
   | SecretRequiredResult
   | FormRequiredResult
   | OAuthRequiredResult
-  | ApprovalRequiredResult;
+  | ApprovalRequiredResult
+  | TextInputRequiredResult;

package/src/client/core/handle-task-status-update.ts

@@ -11,6 +11,7 @@ import type { TaskStatusUpdateEvent } from '../a2a/protocol/types';
 import { extractUiExtensionData } from './extensions/extract';
 import type { TaskStatusUpdateResult } from './extensions/types';
 import { TaskStatusUpdateType } from './extensions/types';
+import { extractTextFromMessage } from './utils/extract-text-from-message';
 
 const secretsRequestExtensionExtractor = extractUiExtensionData(secretsRequestExtension);
 const oauthRequestExtensionExtractor = extractUiExtensionData(oauthRequestExtension);
@@ -46,13 +47,19 @@ export const handleTaskStatusUpdate = (event: TaskStatusUpdateEvent): TaskStatus
         type: TaskStatusUpdateType.FormRequired,
         form: formRequired,
       });
-    }
-
-    if (approvalRequired) {
+    } else if (approvalRequired) {
       results.push({
         type: TaskStatusUpdateType.ApprovalRequired,
         request: approvalRequired,
       });
+    } else {
+      const text = extractTextFromMessage(event.status.message);
+      if (text) {
+        results.push({
+          type: TaskStatusUpdateType.TextInputRequired,
+          text,
+        });
+      }
     }
   }
 

package/src/client/core/index.ts

@@ -12,4 +12,5 @@ export * from './fulfillment-resolvers/build-llm-extension-fulfillment-resolver'
 export * from './handle-agent-card';
 export * from './handle-task-status-update';
 export * from './utils/build-message-builder';
+export * from './utils/extract-text-from-message';
 export * from './utils/get-agent-card-path';

package/src/client/core/utils/extract-text-from-message.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright 2026 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type { Message } from '@a2a-js/sdk';
+
+export function extractTextFromMessage(message: Message | undefined) {
+  const text = message?.parts
+    .filter((part) => part.kind === 'text')
+    .map((part) => part.text)
+    .join('\n');
+
+  return text;
+}

package/src/examples/hello-world.ts

@@ -0,0 +1,34 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { isTextPart } from '../experimental/server/a2a/utils';
+import { InteractionMode } from '../extensions';
+import { Server } from '../server';
+
+const server = new Server();
+
+server
+  .agent({
+    name: 'HelloWorld',
+    description: 'A simple hello world agent',
+    version: '0.0.1',
+    detail: {
+      interaction_mode: InteractionMode.MultiTurn,
+      user_greeting: 'Hello! How can I help you?',
+      author: {
+        name: 'Agent Stack',
+      },
+    },
+    handler: async function* (input) {
+      const firstPart = input.parts.at(0);
+
+      if (isTextPart(firstPart)) {
+        yield `Hello! You said: ${firstPart.text}`;
+      } else {
+        yield `No text part found`;
+      }
+    },
+  })
+  .run({ port: 8000 });

package/src/experimental/server/a2a/extensions/agent-detail/index.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import { AGENT_DETAIL_EXTENSION_URI } from '../../../../../extensions';
+import type { ExtensionSpec } from '../../../core/extensions/types';
+import type { AgentDetailExtensionFulfillments, AgentDetailExtensionParams } from './types';
+
+export class AgentDetailExtensionSpec implements ExtensionSpec<
+  AgentDetailExtensionParams,
+  AgentDetailExtensionFulfillments
+> {
+  readonly uri = AGENT_DETAIL_EXTENSION_URI;
+  readonly params: AgentDetailExtensionParams;
+
+  constructor(params: AgentDetailExtensionParams) {
+    this.params = {
+      ...params,
+      programming_language: params.programming_language ?? 'TypeScript',
+    };
+  }
+
+  toAgentCardExtension() {
+    return {
+      uri: this.uri,
+      required: false,
+      params: this.params,
+    };
+  }
+
+  parseFulfillments() {
+    return undefined;
+  }
+}

package/src/experimental/server/a2a/extensions/agent-detail/types.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+import type { AgentDetail } from '../../../../../extensions';
+
+export type AgentDetailExtensionParams = AgentDetail;
+
+export type AgentDetailExtensionFulfillments = undefined;

package/src/experimental/server/a2a/extensions/index.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+export * from './agent-detail';
+export * from './agent-detail/types';
+export * from './llm';
+export * from './llm/types';
+export * from './platform-self-registration';
+export * from './platform-self-registration/types';