agentstack-sdk 0.6.0-rc4 → 0.6.1

package/README.md

@@ -8,65 +8,189 @@ TypeScript/JavaScript client SDK for building applications that interact with Ag
 
 ## Overview
 
-The `agentstack-sdk` provides TypeScript/JavaScript tools for building client applications that communicate with agents deployed on Agent Stack. It includes utilities for handling the A2A (Agent-to-Agent) protocol, managing agent extensions, and working with the Agent Stack platform API.
+The `agentstack-sdk` provides TypeScript and JavaScript tools for building client applications that communicate with agents deployed on Agent Stack. It includes utilities for handling the A2A (Agent2Agent) protocol, working with extensions, and calling the Agent Stack platform API.
 
 ## Key Features
 
-- **A2A Protocol Support** - Full support for Agent-to-Agent communication
-- **Extension System** - Built-in handlers for forms, OAuth, LLM services, MCP, and more
-- **Platform API Client** - Utilities for context and token management
-- **TypeScript Types** - Comprehensive types for all APIs
+- **A2A Protocol Support** - Parse agent cards and task status updates with typed utilities
+- **Extension System** - Resolve service demands and UI metadata with typed helpers
+- **Platform API Client** - Typed access to core platform resources
+- **Type Safe Responses** - Zod validated payloads with structured API error helpers
 
 ## Installation
 
 ```bash
-npm install agentstack-sdk
+npm install agentstack-sdk @a2a-js/sdk
 ```
 
 ## Quickstart
 
 ```typescript
-import { handleAgentCard, handleTaskStatusUpdate, TaskStatusUpdateType } from 'agentstack-sdk';
-
-// Parse agent capabilities
-const { extensions, fulfillments } = await handleAgentCard(agentCard);
+import {
+  buildApiClient,
+  createAuthenticatedFetch,
+  unwrapResult,
+  getAgentCardPath,
+  handleAgentCard,
+  handleTaskStatusUpdate,
+  resolveUserMetadata,
+  type TaskStatusUpdateType,
+  type Fulfillments,
+} from "agentstack-sdk";
+import {
+  ClientFactory,
+  ClientFactoryOptions,
+  DefaultAgentCardResolver,
+  JsonRpcTransportFactory,
+} from "@a2a-js/sdk/client";
+
+const baseUrl = "https://your-agentstack-instance.com";
+const accessToken = "<user-access-token>";
+
+const api = buildApiClient({
+  baseUrl,
+  fetch: createAuthenticatedFetch(accessToken),
+});
+
+const providers = unwrapResult(await api.listProviders());
+const providerId = providers[0]?.id;
+
+const context = unwrapResult(await api.createContext({ provider_id: providerId }));
+const contextToken = unwrapResult(
+  await api.createContextToken({
+    context_id: context.id,
+    grant_global_permissions: {
+      llm: ["*"],
+      embeddings: ["*"],
+      a2a_proxy: ["*"],
+    },
+    grant_context_permissions: {
+      files: ["*"],
+      vector_stores: ["*"],
+      context_data: ["*"],
+    },
+  }),
+);
+
+const fetchImpl = createAuthenticatedFetch(contextToken.token);
+const factory = new ClientFactory(
+  ClientFactoryOptions.createFrom(ClientFactoryOptions.default, {
+    transports: [new JsonRpcTransportFactory({ fetchImpl })],
+    cardResolver: new DefaultAgentCardResolver({ fetchImpl }),
+  }),
+);
+
+const agentCardPath = getAgentCardPath(providerId);
+const client = await factory.createFromUrl(baseUrl, agentCardPath);
+
+const card = await client.getAgentCard();
+const { resolveMetadata, demands } = handleAgentCard(card);
+
+const selectedLlmModels: Record<string, string> = { default: "gpt-4o" };
+
+const fulfillments: Fulfillments = {
+  llm: demands.llmDemands
+    ? async ({ llm_demands }) => ({
+        llm_fulfillments: Object.fromEntries(
+          Object.keys(llm_demands).map((key) => [
+            key,
+            {
+              identifier: "llm_proxy",
+              api_base: `${baseUrl}/api/v1/openai/`,
+              api_key: contextToken.token,
+              api_model: selectedLlmModels[key],
+            },
+          ]),
+        ),
+      })
+    : undefined,
+};
+
+const agentMetadata = await resolveMetadata(fulfillments);
+
+const stream = client.sendMessageStream({
+  message: {
+    kind: "message",
+    role: "user",
+    messageId: crypto.randomUUID(),
+    contextId: context.id,
+    parts: [{ kind: "text", text: "Hello" }],
+    metadata: agentMetadata,
+  }
+});
 
-// Send message and handle responses
-const stream = client.sendMessage(message);
+let taskId: string | undefined;
 
 for await (const event of stream) {
-  const result = handleTaskStatusUpdate(event);
-  
-  switch (result.type) {
-    case TaskStatusUpdateType.Message:
-      console.log('Agent response:', result.message.parts[0].text);
-      break;
-    case TaskStatusUpdateType.InputRequired:
-      // Handle extension demands (forms, OAuth, etc.)
-      break;
+  switch (event.kind) {
+    case "task":
+      taskId = event.id;
+    case "status-update":
+      taskId = event.taskId;
+
+      for (const update of handleTaskStatusUpdate(event)) {
+        switch (update.type) {
+          case TaskStatusUpdateType.FormRequired:
+            // Render form
+          case TaskStatusUpdateType.OAuthRequired:
+            // Redirect to update.url
+          case TaskStatusUpdateType.SecretRequired:
+            // Prompt for secrets
+          case TaskStatusUpdateType.ApprovalRequired:
+            // Request approval
+        }
+      }
+    case "message":
+      // Render message parts and metadata
+    case "artifact-update":
+      // Render artifacts
   }
 }
 ```
 
-## Available Extensions
+## Core APIs
 
-The SDK includes clients and specs for handling:
+- `buildApiClient` returns a typed API client for platform endpoints.
+- `handleAgentCard` extracts extension demands and returns `resolveMetadata`.
+- `handleTaskStatusUpdate` parses A2A status updates into UI actions.
+- `resolveUserMetadata` builds metadata when the user submits forms, canvas edits, or approvals.
+- `createAuthenticatedFetch` helps add bearer auth headers to API calls.
+- `buildLLMExtensionFulfillmentResolver` matches LLM providers and returns fulfillments.
+- `unwrapResult` returns the response data on success, throws an `ApiErrorException` on error
 
-- **Forms** - Static and dynamic form handling (`FormExtensionClient`, `FormExtensionSpec`)
-- **OAuth** - Authentication flows (`OAuthExtensionClient`, `OAuthExtensionSpec`)
-- **LLM Services** - Model access and credentials (`LLMServiceExtensionClient`, `buildLLMExtensionFulfillmentResolver`)
-- **Platform API** - Context and resource access (`PlatformApiExtensionClient`, `buildApiClient`)
-- **MCP** - Model Context Protocol integration (`MCPServiceExtensionClient`)
-- **Embeddings** - Vector embedding services (`EmbeddingServiceExtensionClient`)
-- **Secrets** - Secure credential management (`SecretsExtensionClient`)
-- **Citations** - Source attribution (`citationExtension`)
-- **Agent Details** - Metadata and UI enhancements (`AgentDetailExtensionSpec`)
+## Extensions
 
-Each extension has a corresponding `ExtensionClient` for sending data and `ExtensionSpec` for parsing agent cards.
+Service extensions (client fulfillments):
 
-## Resources
+- **Embedding** - Provide embedding access (`api_base`, `api_key`, `api_model`) for RAG or search.
+- **Form** - Request structured user input via forms.
+- **LLM** - Resolve model access and credentials for text generation.
+- **MCP** - Connect Model Context Protocol services and tools.
+- **OAuth** - Provide OAuth credentials or redirect URIs.
+- **Platform API** - Inject context token metadata for platform access.
+- **Secrets** - Supply or request secret values securely.
+
+UI extensions (message metadata your UI can render):
+
+- **Agent Detail** - Show agent specific metadata and context.
+- **Approval** - Ask the user to approve actions or tool calls.
+- **Canvas** - Provide canvas edit requests and updates.
+- **Citation** - Display inline source references.
+- **Error** - Render structured error messages.
+- **Form Request** - Render interactive forms in the UI.
+- **Settings** - Read or update runtime configuration values.
+- **Trajectory** - Render execution traces or reasoning steps.
+
+## Documentation
 
 - [Agent Stack Documentation](https://agentstack.beeai.dev)
+- [Getting Started](https://agentstack.beeai.dev/stable/custom-ui/getting-started)
+- [A2A Client Integration](https://agentstack.beeai.dev/stable/custom-ui/a2a-client)
+- [Agent Requirements](https://agentstack.beeai.dev/stable/custom-ui/agent-requirements)
+- [Platform API Client](https://agentstack.beeai.dev/stable/custom-ui/platform-api-client)
+
+## Resources
+
 - [GitHub Repository](https://github.com/i-am-bee/agentstack)
 - [npm Package](https://www.npmjs.com/package/agentstack-sdk)
 

package/dist/client/a2a/extensions/common/form/schemas.d.ts

@@ -6,13 +6,13 @@ import z from 'zod';
 export declare const baseFieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
 }, z.core.$strip>;
 export declare const textFieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"text">;
     placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -22,7 +22,7 @@ export declare const textFieldSchema: z.ZodObject<{
 export declare const dateFieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"date">;
     placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -31,15 +31,19 @@ export declare const dateFieldSchema: z.ZodObject<{
 export declare const fileFieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"file">;
     accept: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
+export declare const selectFieldOptionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
 export declare const singleSelectFieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"singleselect">;
     options: z.ZodArray<z.ZodObject<{
@@ -51,7 +55,7 @@ export declare const singleSelectFieldSchema: z.ZodObject<{
 export declare const multiSelectFieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"multiselect">;
     options: z.ZodArray<z.ZodObject<{
@@ -63,16 +67,16 @@ export declare const multiSelectFieldSchema: z.ZodObject<{
 export declare const checkboxFieldSchema: z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"checkbox">;
     content: z.ZodString;
-    default_value: z.ZodBoolean;
+    default_value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
 }, z.core.$strip>;
 export declare const formFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"text">;
     placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -81,7 +85,7 @@ export declare const formFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"date">;
     placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -89,14 +93,14 @@ export declare const formFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"file">;
     accept: z.ZodArray<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"singleselect">;
     options: z.ZodArray<z.ZodObject<{
@@ -107,7 +111,7 @@ export declare const formFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"multiselect">;
     options: z.ZodArray<z.ZodObject<{
@@ -118,11 +122,11 @@ export declare const formFieldSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     id: z.ZodString;
     label: z.ZodString;
-    required: z.ZodBoolean;
+    required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
     type: z.ZodLiteral<"checkbox">;
     content: z.ZodString;
-    default_value: z.ZodBoolean;
+    default_value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
 }, z.core.$strip>], "type">;
 export declare const textFieldValueSchema: z.ZodObject<{
     type: z.ZodLiteral<"text">;
@@ -176,14 +180,10 @@ export declare const formFieldValueSchema: z.ZodDiscriminatedUnion<[z.ZodObject<
     value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
 }, z.core.$strip>], "type">;
 export declare const formRenderSchema: z.ZodObject<{
-    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    columns: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
-    submit_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-        required: z.ZodBoolean;
+        required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         type: z.ZodLiteral<"text">;
         placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -192,7 +192,7 @@ export declare const formRenderSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-        required: z.ZodBoolean;
+        required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         type: z.ZodLiteral<"date">;
         placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -200,14 +200,14 @@ export declare const formRenderSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-        required: z.ZodBoolean;
+        required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         type: z.ZodLiteral<"file">;
         accept: z.ZodArray<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-        required: z.ZodBoolean;
+        required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         type: z.ZodLiteral<"singleselect">;
         options: z.ZodArray<z.ZodObject<{
@@ -218,7 +218,7 @@ export declare const formRenderSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-        required: z.ZodBoolean;
+        required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         type: z.ZodLiteral<"multiselect">;
         options: z.ZodArray<z.ZodObject<{
@@ -229,12 +229,16 @@ export declare const formRenderSchema: z.ZodObject<{
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
         label: z.ZodString;
-        required: z.ZodBoolean;
+        required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
         col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
         type: z.ZodLiteral<"checkbox">;
         content: z.ZodString;
-        default_value: z.ZodBoolean;
+        default_value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
     }, z.core.$strip>], "type">>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    columns: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+    submit_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;
 export declare const formValuesSchema: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"text">;

package/dist/client/a2a/extensions/common/form/types.d.ts

@@ -3,10 +3,11 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type z from 'zod';
-import type { checkboxFieldSchema, checkboxFieldValueSchema, dateFieldSchema, dateFieldValueSchema, fileFieldSchema, fileFieldValueSchema, formFieldSchema, formFieldValueSchema, formRenderSchema, formResponseSchema, formValuesSchema, multiSelectFieldSchema, multiSelectFieldValueSchema, singleSelectFieldSchema, singleSelectFieldValueSchema, textFieldSchema, textFieldValueSchema } from './schemas';
+import type { checkboxFieldSchema, checkboxFieldValueSchema, dateFieldSchema, dateFieldValueSchema, fileFieldSchema, fileFieldValueSchema, formFieldSchema, formFieldValueSchema, formRenderSchema, formResponseSchema, formValuesSchema, multiSelectFieldSchema, multiSelectFieldValueSchema, selectFieldOptionSchema, singleSelectFieldSchema, singleSelectFieldValueSchema, textFieldSchema, textFieldValueSchema } from './schemas';
 export type TextField = z.infer<typeof textFieldSchema>;
 export type DateField = z.infer<typeof dateFieldSchema>;
 export type FileField = z.infer<typeof fileFieldSchema>;
+export type SelectFieldOption = z.infer<typeof selectFieldOptionSchema>;
 export type SingleSelectField = z.infer<typeof singleSelectFieldSchema>;
 export type MultiSelectField = z.infer<typeof multiSelectFieldSchema>;
 export type CheckboxField = z.infer<typeof checkboxFieldSchema>;

package/dist/client/a2a/extensions/services/form/schemas.d.ts

@@ -6,14 +6,10 @@ import z from 'zod';
 export declare const formDemandsSchema: z.ZodObject<{
     form_demands: z.ZodObject<{
         initial_form: z.ZodOptional<z.ZodObject<{
-            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            columns: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
-            submit_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
             fields: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
-                required: z.ZodBoolean;
+                required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
                 col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
                 type: z.ZodLiteral<"text">;
                 placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -22,7 +18,7 @@ export declare const formDemandsSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
-                required: z.ZodBoolean;
+                required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
                 col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
                 type: z.ZodLiteral<"date">;
                 placeholder: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -30,14 +26,14 @@ export declare const formDemandsSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
-                required: z.ZodBoolean;
+                required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
                 col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
                 type: z.ZodLiteral<"file">;
                 accept: z.ZodArray<z.ZodString>;
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
-                required: z.ZodBoolean;
+                required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
                 col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
                 type: z.ZodLiteral<"singleselect">;
                 options: z.ZodArray<z.ZodObject<{
@@ -48,7 +44,7 @@ export declare const formDemandsSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
-                required: z.ZodBoolean;
+                required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
                 col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
                 type: z.ZodLiteral<"multiselect">;
                 options: z.ZodArray<z.ZodObject<{
@@ -59,12 +55,16 @@ export declare const formDemandsSchema: z.ZodObject<{
             }, z.core.$strip>, z.ZodObject<{
                 id: z.ZodString;
                 label: z.ZodString;
-                required: z.ZodBoolean;
+                required: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
                 col_span: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
                 type: z.ZodLiteral<"checkbox">;
                 content: z.ZodString;
-                default_value: z.ZodBoolean;
+                default_value: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
             }, z.core.$strip>], "type">>;
+            title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            columns: z.ZodOptional<z.ZodNullable<z.ZodInt>>;
+            submit_label: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;

package/dist/client/core/handle-agent-card.d.ts

@@ -65,8 +65,8 @@ export declare const handleAgentCard: (agentCard: {
                     fields: ({
                         id: string;
                         label: string;
-                        required: boolean;
                         type: "text";
+                        required?: boolean | null | undefined;
                         col_span?: number | null | undefined;
                         placeholder?: string | null | undefined;
                         default_value?: string | null | undefined;
@@ -74,48 +74,48 @@ export declare const handleAgentCard: (agentCard: {
                     } | {
                         id: string;
                         label: string;
-                        required: boolean;
                         type: "date";
+                        required?: boolean | null | undefined;
                         col_span?: number | null | undefined;
                         placeholder?: string | null | undefined;
                         default_value?: string | null | undefined;
                     } | {
                         id: string;
                         label: string;
-                        required: boolean;
                         type: "file";
                         accept: string[];
+                        required?: boolean | null | undefined;
                         col_span?: number | null | undefined;
                     } | {
                         id: string;
                         label: string;
-                        required: boolean;
                         type: "singleselect";
                         options: {
                             id: string;
                             label: string;
                         }[];
+                        required?: boolean | null | undefined;
                         col_span?: number | null | undefined;
                         default_value?: string | null | undefined;
                     } | {
                         id: string;
                         label: string;
-                        required: boolean;
                         type: "multiselect";
                         options: {
                             id: string;
                             label: string;
                         }[];
+                        required?: boolean | null | undefined;
                         col_span?: number | null | undefined;
                         default_value?: string[] | null | undefined;
                     } | {
                         id: string;
                         label: string;
-                        required: boolean;
                         type: "checkbox";
                         content: string;
-                        default_value: boolean;
+                        required?: boolean | null | undefined;
                         col_span?: number | null | undefined;
+                        default_value?: boolean | null | undefined;
                     })[];
                     title?: string | null | undefined;
                     description?: string | null | undefined;

package/dist/client/core/index.d.ts

@@ -11,3 +11,4 @@ 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/get-agent-card-path';

package/dist/client/core/utils/get-agent-card-path.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare function getAgentCardPath(providerId: string): string;