agentstack-sdk 0.5.1-rc2 → 0.5.2-rc2

package/dist/client/a2a/extensions/ui/trajectory.d.ts

@@ -1,15 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import z from 'zod';
-import type { A2AUiExtension } from '../types';
-declare const URI = "https://a2a-extensions.agentstack.beeai.dev/ui/trajectory/v1";
-declare const schema: z.ZodObject<{
-    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    group_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export type TrajectoryMetadata = z.infer<typeof schema>;
-export declare const trajectoryExtension: A2AUiExtension<typeof URI, TrajectoryMetadata>;
-export {};

package/dist/client/api/build-api-client.d.ts

@@ -1,62 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import type { ContextPermissionsGrant, GlobalPermissionsGrant, ModelCapability } from './types';
-export interface MatchProvidersParams {
-    suggestedModels: string[] | null;
-    capability: ModelCapability;
-    scoreCutoff: number;
-}
-export interface CreateContextTokenParams {
-    contextId: string;
-    globalPermissions: GlobalPermissionsGrant;
-    contextPermissions: ContextPermissionsGrant;
-}
-export declare const buildApiClient: ({ baseUrl, fetch: customFetchImpl, }?: {
-    baseUrl: string;
-    fetch?: typeof globalThis.fetch;
-}) => {
-    createContextToken: ({ contextId, globalPermissions, contextPermissions }: CreateContextTokenParams) => Promise<{
-        token: {
-            token: string;
-            expires_at: string | null;
-        };
-        contextId: string;
-    }>;
-    createContext: (providerId: string) => Promise<{
-        id: string;
-        created_at: string;
-        updated_at: string;
-        last_active_at: string;
-        created_by: string;
-        provider_id: string | null;
-        metadata: Record<string, unknown> | null;
-    }>;
-    matchProviders: ({ suggestedModels, capability, scoreCutoff }: MatchProvidersParams) => Promise<{
-        total_count: number;
-        has_more: boolean;
-        next_page_token: string | null;
-        items: {
-            model_id: string;
-            score: number;
-        }[];
-    }>;
-    listConnectors: () => Promise<{
-        total_count: number;
-        has_more: boolean;
-        next_page_token: string | null;
-        items: {
-            id: string;
-            url: string;
-            state: import("./types").ConnectorState;
-            auth_request: {
-                type: "code";
-                authorization_endpoint: string;
-            } | null;
-            disconnect_reason: string | null;
-            metadata: Record<string, string> | null;
-        }[];
-    }>;
-};
-export type AgentstackClient = ReturnType<typeof buildApiClient>;

package/dist/types.d.ts

@@ -1,10 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import z from 'zod';
-export declare const interactionModeSchema: z.ZodEnum<{
-    "single-turn": "single-turn";
-    "multi-turn": "multi-turn";
-}>;
-export type InteractionMode = z.infer<typeof interactionModeSchema>;

package/src/client/a2a/extensions/handle-task-status-update.ts

@@ -1,95 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import type { TaskStatusUpdateEvent } from '@a2a-js/sdk';
-
-import type { FormRender } from './common/form';
-import type { ApprovalRequest } from './interactions/approval';
-import { approvalExtension } from './interactions/approval';
-import type { SecretDemands } from './services/secrets';
-import { secretsMessageExtension } from './services/secrets';
-import { FormRequestExtension } from './ui/form-request';
-import { oauthRequestExtension } from './ui/oauth';
-import { extractUiExtensionData } from './utils';
-
-const secretsMessageExtensionExtractor = extractUiExtensionData(secretsMessageExtension);
-const oauthRequestExtensionExtractor = extractUiExtensionData(oauthRequestExtension);
-const FormRequestExtensionExtractor = extractUiExtensionData(FormRequestExtension);
-const approvalExtensionExtractor = extractUiExtensionData(approvalExtension);
-
-export enum TaskStatusUpdateType {
-  SecretRequired = 'secret-required',
-  FormRequired = 'form-required',
-  OAuthRequired = 'oauth-required',
-  ApprovalRequired = 'approval-required',
-}
-
-export interface SecretRequiredResult {
-  type: TaskStatusUpdateType.SecretRequired;
-  demands: SecretDemands;
-}
-
-export interface FormRequiredResult {
-  type: TaskStatusUpdateType.FormRequired;
-  form: FormRender;
-}
-
-export interface OAuthRequiredResult {
-  type: TaskStatusUpdateType.OAuthRequired;
-  url: string;
-}
-
-export interface ApprovalRequiredResult {
-  type: TaskStatusUpdateType.ApprovalRequired;
-  request: ApprovalRequest;
-}
-
-export type TaskStatusUpdateResult =
-  | SecretRequiredResult
-  | FormRequiredResult
-  | OAuthRequiredResult
-  | ApprovalRequiredResult;
-
-export const handleTaskStatusUpdate = (event: TaskStatusUpdateEvent): TaskStatusUpdateResult[] => {
-  const results: TaskStatusUpdateResult[] = [];
-
-  if (event.status.state === 'auth-required') {
-    const secretRequired = secretsMessageExtensionExtractor(event.status.message?.metadata);
-    const oauthRequired = oauthRequestExtensionExtractor(event.status.message?.metadata);
-
-    if (oauthRequired) {
-      results.push({
-        type: TaskStatusUpdateType.OAuthRequired,
-        url: oauthRequired.authorization_endpoint_url,
-      });
-    }
-
-    if (secretRequired) {
-      results.push({
-        type: TaskStatusUpdateType.SecretRequired,
-        demands: secretRequired,
-      });
-    }
-  } else if (event.status.state === 'input-required') {
-    const formRequired = FormRequestExtensionExtractor(event.status.message?.metadata);
-    const approvalRequired = approvalExtensionExtractor(event.status.message?.metadata);
-
-    if (formRequired) {
-      results.push({
-        type: TaskStatusUpdateType.FormRequired,
-        form: formRequired,
-      });
-    }
-
-    if (approvalRequired) {
-      results.push({
-        type: TaskStatusUpdateType.ApprovalRequired,
-        request: approvalRequired,
-      });
-    }
-  }
-
-  return results;
-};

package/src/client/a2a/extensions/resolve-user-metadata.ts

@@ -1,30 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import type { FormResponseValue } from './common/form';
-import { type CanvasEditRequest, CanvasExtension } from './ui/canvas';
-import { FormRequestExtension } from './ui/form-request';
-
-export type UserMetadataInputs = Partial<{
-  form: Record<string, FormResponseValue>;
-  canvasEditRequest: CanvasEditRequest;
-}>;
-
-export const resolveUserMetadata = async (inputs: UserMetadataInputs) => {
-  const metadata: Record<string, unknown> = {};
-
-  const { form, canvasEditRequest } = inputs;
-
-  if (form) {
-    metadata[FormRequestExtension.getUri()] = {
-      values: form,
-    };
-  }
-  if (canvasEditRequest) {
-    metadata[CanvasExtension.getUri()] = canvasEditRequest;
-  }
-
-  return metadata;
-};

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

@@ -1,43 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AServiceExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/embedding/v1';
-
-const embeddingDemandSchema = z.object({
-  description: z.string().nullish(),
-  suggested: z.array(z.string()).nullish(),
-});
-
-const embeddingDemandsSchema = z.object({
-  embedding_demands: z.record(z.string(), embeddingDemandSchema),
-});
-export type EmbeddingDemands = z.infer<typeof embeddingDemandsSchema>;
-
-const embeddingFulfillmentsSchema = z.object({
-  embedding_fulfillments: z.record(
-    z.string(),
-    z.object({
-      identifier: z.string().nullish(),
-      api_base: z.string(),
-      api_key: z.string(),
-      api_model: z.string(),
-    }),
-  ),
-});
-export type EmbeddingFulfillments = z.infer<typeof embeddingFulfillmentsSchema>;
-
-export const embeddingExtension: A2AServiceExtension<
-  typeof URI,
-  z.infer<typeof embeddingDemandsSchema>,
-  EmbeddingFulfillments
-> = {
-  getUri: () => URI,
-  getDemandsSchema: () => embeddingDemandsSchema,
-  getFulfillmentSchema: () => embeddingFulfillmentsSchema,
-};

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

@@ -1,31 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import { formRenderSchema, formResponseSchema } from '../common/form';
-import type { A2AServiceExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/form/v1';
-
-const formDemandSchema = z.object({
-  form_demands: z
-    .object({
-      initial_form: formRenderSchema,
-    })
-    .partial(),
-});
-export type FormDemands = z.infer<typeof formDemandSchema>;
-
-const formFulfillmentSchema = z.object({
-  form_fulfillments: z.record(z.string(), formResponseSchema),
-});
-export type FormFulfillments = z.infer<typeof formFulfillmentSchema>;
-
-export const formExtension: A2AServiceExtension<typeof URI, FormDemands, FormFulfillments> = {
-  getDemandsSchema: () => formDemandSchema,
-  getFulfillmentSchema: () => formFulfillmentSchema,
-  getUri: () => URI,
-};

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

@@ -1,39 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AServiceExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/llm/v1';
-
-const llmDemandSchema = z.object({
-  description: z.string().nullish(),
-  suggested: z.array(z.string()).nullish(),
-});
-
-const llmDemandsSchema = z.object({
-  llm_demands: z.record(z.string(), llmDemandSchema),
-});
-export type LLMDemands = z.infer<typeof llmDemandsSchema>;
-
-const llmFulfillmentSchema = z.object({
-  llm_fulfillments: z.record(
-    z.string(),
-    z.object({
-      identifier: z.string().nullish(),
-      api_base: z.string(),
-      api_key: z.string(),
-      api_model: z.string(),
-    }),
-  ),
-});
-export type LLMFulfillments = z.infer<typeof llmFulfillmentSchema>;
-
-export const llmExtension: A2AServiceExtension<typeof URI, z.infer<typeof llmDemandsSchema>, LLMFulfillments> = {
-  getUri: () => URI,
-  getDemandsSchema: () => llmDemandsSchema,
-  getFulfillmentSchema: () => llmFulfillmentSchema,
-};

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

@@ -1,59 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AServiceExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/services/mcp/v1';
-
-const mcpTransportTypesEnum = z.enum(['streamable_http', 'stdio']);
-type MCPTransportType = z.infer<typeof mcpTransportTypesEnum>;
-
-const mcpDemandSchema = z.object({
-  description: z.string().nullish(),
-  suggested: z.array(z.string()).nullish(),
-  allowed_transports: z.array(mcpTransportTypesEnum).nullish(),
-});
-
-const mcpDemandsSchema = z.object({
-  mcp_demands: z.record(z.string(), mcpDemandSchema),
-});
-export type MCPDemands = z.infer<typeof mcpDemandsSchema>;
-
-const mcpFulfillmentSchema = z.object({
-  mcp_fulfillments: z.record(
-    z.string(),
-    z.object({
-      transport: z.object({
-        type: mcpTransportTypesEnum,
-        url: z.string(),
-        headers: z.record(z.string(), z.string()).optional(),
-      }),
-    }),
-  ),
-});
-export type MCPFulfillments = z.infer<typeof mcpFulfillmentSchema>;
-
-export const mcpExtension: A2AServiceExtension<
-  typeof URI,
-  z.infer<typeof mcpDemandsSchema>,
-  {
-    mcp_fulfillments: Record<
-      string,
-      {
-        transport: {
-          type: MCPTransportType;
-          url: string;
-          headers?: Record<string, string>;
-        };
-      }
-    >;
-  }
-> = {
-  getUri: () => URI,
-  getDemandsSchema: () => mcpDemandsSchema,
-  getFulfillmentSchema: () => mcpFulfillmentSchema,
-};

package/src/client/a2a/extensions/services/oauth-provider.ts

@@ -1,52 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AServiceExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/auth/oauth/v1';
-
-const oauthDemandSchema = z.object({
-  redirect_uri: z.boolean(),
-});
-
-const oauthDemandsSchema = z.object({
-  oauth_demands: z.record(z.string(), oauthDemandSchema),
-});
-export type OAuthDemands = z.infer<typeof oauthDemandsSchema>;
-
-const oauthFulfillmentSchema = z.object({
-  oauth_fulfillments: z.record(
-    z.string(),
-    z.object({
-      redirect_uri: z.string(),
-    }),
-  ),
-});
-export type OAuthFulfillments = z.infer<typeof oauthFulfillmentSchema>;
-
-export const oauthProviderExtension: A2AServiceExtension<
-  typeof URI,
-  z.infer<typeof oauthDemandsSchema>,
-  {
-    oauth_fulfillments: Record<
-      string,
-      {
-        redirect_uri: string;
-      }
-    >;
-  }
-> = {
-  getUri: () => URI,
-  getDemandsSchema: () => oauthDemandsSchema,
-  getFulfillmentSchema: () => oauthFulfillmentSchema,
-};
-
-export const oauthMessageSchema = z.object({
-  data: z.object({
-    redirect_uri: z.string(),
-  }),
-});

package/src/client/a2a/extensions/services/secrets.ts

@@ -1,46 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AServiceExtension, A2AUiExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/auth/secrets/v1';
-
-const secretDemandSchema = z.object({
-  name: z.string(),
-  description: z.string().nullish(),
-});
-export type SecretDemand = z.infer<typeof secretDemandSchema>;
-
-const secretDemandsSchema = z.object({
-  secret_demands: z.record(z.string(), secretDemandSchema),
-});
-export type SecretDemands = z.infer<typeof secretDemandsSchema>;
-
-const secretFulfillmentSchema = z.object({
-  secret_fulfillments: z.record(
-    z.string(),
-    z.object({
-      secret: z.string(),
-    }),
-  ),
-});
-export type SecretFulfillments = z.infer<typeof secretFulfillmentSchema>;
-
-export const secretsExtension: A2AServiceExtension<
-  typeof URI,
-  z.infer<typeof secretDemandsSchema>,
-  SecretFulfillments
-> = {
-  getUri: () => URI,
-  getDemandsSchema: () => secretDemandsSchema,
-  getFulfillmentSchema: () => secretFulfillmentSchema,
-};
-
-export const secretsMessageExtension: A2AUiExtension<typeof URI, SecretDemands> = {
-  getMessageMetadataSchema: () => z.object({ [URI]: secretDemandsSchema }).partial(),
-  getUri: () => URI,
-};

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

@@ -1,46 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import { interactionModeSchema } from '../../../../types';
-import type { A2AUiExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/agent-detail/v1';
-
-const contributorSchema = z.object({
-  name: z.string(),
-  email: z.string().nullish(),
-  url: z.string().nullish(),
-});
-
-const toolSchema = z.object({
-  name: z.string(),
-  description: z.string(),
-});
-
-const schema = z.object({
-  interaction_mode: z.union([interactionModeSchema, z.string()]).nullish(),
-  user_greeting: z.string().nullish(),
-  input_placeholder: z.string().nullish(),
-  tools: z.array(toolSchema).nullish(),
-  framework: z.string().nullish(),
-  license: z.string().nullish(),
-  programming_language: z.string().nullish(),
-  homepage_url: z.string().nullish(),
-  source_code_url: z.string().nullish(),
-  container_image_url: z.string().nullish(),
-  author: contributorSchema.nullish(),
-  contributors: z.array(contributorSchema).nullish(),
-});
-
-export type AgentDetailTool = z.infer<typeof toolSchema>;
-export type AgentDetailContributor = z.infer<typeof contributorSchema>;
-export type AgentDetail = z.infer<typeof schema>;
-
-export const agentDetailExtension: A2AUiExtension<typeof URI, AgentDetail> = {
-  getMessageMetadataSchema: () => z.object({ [URI]: schema }).partial(),
-  getUri: () => URI,
-};

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

@@ -1,24 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { z } from 'zod';
-
-import type { A2AUiExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/canvas/v1';
-
-const schema = z.object({
-  start_index: z.int(),
-  end_index: z.int(),
-  description: z.string().nullish(),
-  artifact_id: z.string(),
-});
-
-export type CanvasEditRequest = z.infer<typeof schema>;
-
-export const CanvasExtension: A2AUiExtension<typeof URI, CanvasEditRequest> = {
-  getMessageMetadataSchema: () => z.object({ [URI]: schema }).partial(),
-  getUri: () => URI,
-};

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

@@ -1,30 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AUiExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/citation/v1';
-
-const citationSchema = z.object({
-  url: z.string().nullish(),
-  start_index: z.number().nullish(),
-  end_index: z.number().nullish(),
-  title: z.string().nullish(),
-  description: z.string().nullish(),
-});
-
-const schema = z.object({
-  citations: z.array(citationSchema),
-});
-
-export type CitationMetadata = z.infer<typeof schema>;
-export type Citation = z.infer<typeof citationSchema>;
-
-export const citationExtension: A2AUiExtension<typeof URI, CitationMetadata> = {
-  getMessageMetadataSchema: () => z.object({ [URI]: schema }).partial(),
-  getUri: () => URI,
-};

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

@@ -1,33 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AUiExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/ui/error/v1';
-
-const errorSchema = z.object({
-  title: z.string(),
-  message: z.string(),
-});
-
-const errorGroupSchema = z.object({
-  message: z.string(),
-  errors: z.array(errorSchema),
-});
-
-const schema = z.object({
-  error: z.union([errorSchema, errorGroupSchema]),
-  context: z.record(z.string(), z.unknown()).nullish(),
-  stack_trace: z.string().nullish(),
-});
-
-export type ErrorMetadata = z.infer<typeof schema>;
-
-export const errorExtension: A2AUiExtension<typeof URI, ErrorMetadata> = {
-  getMessageMetadataSchema: () => z.object({ [URI]: schema }).partial(),
-  getUri: () => URI,
-};

package/src/client/a2a/extensions/ui/oauth.ts

@@ -1,21 +0,0 @@
-/**
- * Copyright 2025 © BeeAI a Series of LF Projects, LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import z from 'zod';
-
-import type { A2AUiExtension } from '../types';
-
-const URI = 'https://a2a-extensions.agentstack.beeai.dev/auth/oauth/v1';
-
-const schema = z.object({
-  authorization_endpoint_url: z.string(),
-});
-
-export type OAuthRequest = z.infer<typeof schema>;
-
-export const oauthRequestExtension: A2AUiExtension<typeof URI, OAuthRequest> = {
-  getMessageMetadataSchema: () => z.object({ [URI]: schema }).partial(),
-  getUri: () => URI,
-};