agentstack-sdk 0.6.1 → 0.6.2-rc2

package/dist/server.d.cts

@@ -0,0 +1,244 @@
+import { AgentExtension, Message, Task, Part, TaskStatus, TaskStatusUpdateEvent, Artifact, AgentCard } from '@a2a-js/sdk';
+import * as z from 'zod';
+import z__default, { z as z$1 } from 'zod';
+import { A as AgentDetail } from './schemas-Dy3P_eAt.cjs';
+import * as zod_v4_core from 'zod/v4/core';
+import { b as LLMFulfillment, c as LLMFulfillments, L as LLMDemand } from './types-MfIzGgpV.cjs';
+import { ba as buildApiClient } from './types-CmEs5_Ag.cjs';
+import './types-B5B3b0V2.cjs';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface ExtensionSpec<TParams = unknown, TFulfillments = unknown> {
+    uri: string;
+    params?: TParams;
+    fulfillmentsSchema?: z$1.ZodSchema<TFulfillments>;
+    toAgentCardExtension(): AgentExtension;
+    parseFulfillments(message: Message): TFulfillments | undefined;
+}
+interface ExtensionServer<TDeps = unknown, TParams = unknown, TFulfillments = unknown> {
+    spec: ExtensionSpec<TParams, TFulfillments>;
+    resolveDeps(fulfillments: TFulfillments | undefined): TDeps;
+}
+type ExtensionConfig<TDeps = unknown> = {
+    [K in keyof TDeps]: ExtensionServer<TDeps[K], unknown, unknown>;
+};
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type AgentDetailExtensionParams = AgentDetail;
+type AgentDetailExtensionFulfillments = undefined;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare class AgentDetailExtensionSpec implements ExtensionSpec<AgentDetailExtensionParams, AgentDetailExtensionFulfillments> {
+    readonly uri = "https://a2a-extensions.agentstack.beeai.dev/ui/agent-detail/v1";
+    readonly params: AgentDetailExtensionParams;
+    constructor(params: AgentDetailExtensionParams);
+    toAgentCardExtension(): {
+        uri: string;
+        required: boolean;
+        params: {
+            interaction_mode?: string | null | undefined;
+            user_greeting?: string | null | undefined;
+            input_placeholder?: string | null | undefined;
+            tools?: {
+                name: string;
+                description: string;
+            }[] | null | undefined;
+            framework?: string | null | undefined;
+            license?: string | null | undefined;
+            programming_language?: string | null | undefined;
+            homepage_url?: string | null | undefined;
+            source_code_url?: string | null | undefined;
+            container_image_url?: string | null | undefined;
+            author?: {
+                name: string;
+                email?: string | null | undefined;
+                url?: string | null | undefined;
+            } | null | undefined;
+            contributors?: {
+                name: string;
+                email?: string | null | undefined;
+                url?: string | null | undefined;
+            }[] | null | undefined;
+        };
+    };
+    parseFulfillments(): undefined;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface LLMExtensionParams {
+    demands: Record<string, LLMDemand>;
+}
+type LLMExtensionFulfillments = LLMFulfillments;
+interface LLMExtensionDeps {
+    fulfillments?: Record<string, LLMFulfillment>;
+}
+
+declare class LLMExtensionSpec implements ExtensionSpec<LLMExtensionParams, LLMExtensionFulfillments> {
+    readonly uri = "https://a2a-extensions.agentstack.beeai.dev/services/llm/v1";
+    readonly params: LLMExtensionParams;
+    readonly fulfillmentsSchema: z.ZodObject<{
+        llm_fulfillments: z.ZodRecord<z.ZodString, z.ZodObject<{
+            identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            api_base: z.ZodString;
+            api_key: z.ZodString;
+            api_model: z.ZodString;
+        }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>;
+    constructor(params: LLMExtensionParams);
+    toAgentCardExtension(): {
+        uri: string;
+        required: boolean;
+        params: {
+            llm_demands: Record<string, {
+                description?: string | null | undefined;
+                suggested?: string[] | null | undefined;
+            }>;
+        };
+    };
+    parseFulfillments(message: Message): {
+        llm_fulfillments: Record<string, {
+            api_base: string;
+            api_key: string;
+            api_model: string;
+            identifier?: string | null | undefined;
+        }>;
+    } | undefined;
+}
+declare class LLMExtensionServer implements ExtensionServer<LLMExtensionDeps, LLMExtensionParams, LLMExtensionFulfillments> {
+    readonly spec: LLMExtensionSpec;
+    constructor(params: LLMExtensionParams);
+    resolveDeps(fulfillments: LLMExtensionFulfillments | undefined): LLMExtensionDeps;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+interface PlatformSelfRegistrationExtensionParams extends Record<string, unknown> {
+    self_registration_id: string;
+}
+type PlatformSelfRegistrationExtensionFulfillments = undefined;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare const PLATFORM_SELF_REGISTRATION_EXTENSION_URI = "https://a2a-extensions.agentstack.beeai.dev/services/platform-self-registration/v1";
+declare class PlatformSelfRegistrationExtensionSpec implements ExtensionSpec<PlatformSelfRegistrationExtensionParams, PlatformSelfRegistrationExtensionFulfillments> {
+    readonly uri = "https://a2a-extensions.agentstack.beeai.dev/services/platform-self-registration/v1";
+    readonly params: PlatformSelfRegistrationExtensionParams;
+    constructor(params: PlatformSelfRegistrationExtensionParams);
+    toAgentCardExtension(): {
+        uri: string;
+        required: boolean;
+        params: PlatformSelfRegistrationExtensionParams;
+    };
+    parseFulfillments(): undefined;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+declare function loadConfig(): {
+    platformUrl: string;
+    productionMode: boolean;
+};
+declare function isProductionMode(): boolean;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare class RunContext {
+    readonly taskId: string;
+    readonly contextId: string;
+    readonly task?: Task;
+    constructor(taskId: string, contextId: string, task?: Task);
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare const configSchema: z__default.ZodObject<{
+    platformUrl: z__default.ZodDefault<z__default.ZodString>;
+    productionMode: z__default.ZodDefault<z__default.ZodPipe<z__default.ZodOptional<z__default.ZodString>, z__default.ZodTransform<boolean, string | undefined>>>;
+}, z__default.core.$strip>;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type RunYield = string | Message | Part | TaskStatus | TaskStatusUpdateEvent | Artifact | Error | Record<string, unknown>;
+type AgentFunction<TDeps = Record<string, never>> = (input: Message, ctx: RunContext, deps: TDeps) => AsyncIterable<RunYield> | Promise<RunYield | void>;
+interface AgentOptions<TDeps = Record<string, never>> {
+    name: string;
+    description?: string;
+    detail?: AgentDetail;
+    extensions?: ExtensionConfig<TDeps>;
+    version?: string;
+    protocolVersion?: string;
+    handler: AgentFunction<TDeps>;
+}
+interface ServerOptions {
+    host?: string;
+    port?: number;
+    selfRegistrationId?: string;
+    platformUrl?: string;
+}
+interface ServerHandle {
+    port: number;
+    url: string;
+    close: () => Promise<void>;
+}
+interface AutoregistrationOptions {
+    selfRegistrationId: string;
+    agentCard: AgentCard;
+    host: string;
+    port: number;
+    api: ReturnType<typeof buildApiClient>;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare class Server {
+    private agentCard?;
+    private agentOptions?;
+    private agentConfigured;
+    agent<TDeps>(options: AgentOptions<TDeps>): this;
+    run(options?: ServerOptions): Promise<ServerHandle>;
+    private buildExtensions;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type Config = z__default.infer<typeof configSchema>;
+
+export { type AgentDetailExtensionFulfillments, type AgentDetailExtensionParams, AgentDetailExtensionSpec, type AgentFunction, type AgentOptions, type AutoregistrationOptions, type Config, type ExtensionConfig, type ExtensionServer, type ExtensionSpec, type LLMExtensionDeps, type LLMExtensionFulfillments, type LLMExtensionParams, LLMExtensionServer, LLMExtensionSpec, PLATFORM_SELF_REGISTRATION_EXTENSION_URI, type PlatformSelfRegistrationExtensionFulfillments, type PlatformSelfRegistrationExtensionParams, PlatformSelfRegistrationExtensionSpec, RunContext, type RunYield, Server, type ServerHandle, type ServerOptions, configSchema, isProductionMode, loadConfig };

package/dist/server.d.ts

@@ -0,0 +1,244 @@
+import { AgentExtension, Message, Task, Part, TaskStatus, TaskStatusUpdateEvent, Artifact, AgentCard } from '@a2a-js/sdk';
+import * as z from 'zod';
+import z__default, { z as z$1 } from 'zod';
+import { A as AgentDetail } from './schemas-Dy3P_eAt.js';
+import * as zod_v4_core from 'zod/v4/core';
+import { b as LLMFulfillment, c as LLMFulfillments, L as LLMDemand } from './types-MfIzGgpV.js';
+import { ba as buildApiClient } from './types-DJm5-rZZ.js';
+import './types-B5B3b0V2.js';
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface ExtensionSpec<TParams = unknown, TFulfillments = unknown> {
+    uri: string;
+    params?: TParams;
+    fulfillmentsSchema?: z$1.ZodSchema<TFulfillments>;
+    toAgentCardExtension(): AgentExtension;
+    parseFulfillments(message: Message): TFulfillments | undefined;
+}
+interface ExtensionServer<TDeps = unknown, TParams = unknown, TFulfillments = unknown> {
+    spec: ExtensionSpec<TParams, TFulfillments>;
+    resolveDeps(fulfillments: TFulfillments | undefined): TDeps;
+}
+type ExtensionConfig<TDeps = unknown> = {
+    [K in keyof TDeps]: ExtensionServer<TDeps[K], unknown, unknown>;
+};
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type AgentDetailExtensionParams = AgentDetail;
+type AgentDetailExtensionFulfillments = undefined;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare class AgentDetailExtensionSpec implements ExtensionSpec<AgentDetailExtensionParams, AgentDetailExtensionFulfillments> {
+    readonly uri = "https://a2a-extensions.agentstack.beeai.dev/ui/agent-detail/v1";
+    readonly params: AgentDetailExtensionParams;
+    constructor(params: AgentDetailExtensionParams);
+    toAgentCardExtension(): {
+        uri: string;
+        required: boolean;
+        params: {
+            interaction_mode?: string | null | undefined;
+            user_greeting?: string | null | undefined;
+            input_placeholder?: string | null | undefined;
+            tools?: {
+                name: string;
+                description: string;
+            }[] | null | undefined;
+            framework?: string | null | undefined;
+            license?: string | null | undefined;
+            programming_language?: string | null | undefined;
+            homepage_url?: string | null | undefined;
+            source_code_url?: string | null | undefined;
+            container_image_url?: string | null | undefined;
+            author?: {
+                name: string;
+                email?: string | null | undefined;
+                url?: string | null | undefined;
+            } | null | undefined;
+            contributors?: {
+                name: string;
+                email?: string | null | undefined;
+                url?: string | null | undefined;
+            }[] | null | undefined;
+        };
+    };
+    parseFulfillments(): undefined;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+interface LLMExtensionParams {
+    demands: Record<string, LLMDemand>;
+}
+type LLMExtensionFulfillments = LLMFulfillments;
+interface LLMExtensionDeps {
+    fulfillments?: Record<string, LLMFulfillment>;
+}
+
+declare class LLMExtensionSpec implements ExtensionSpec<LLMExtensionParams, LLMExtensionFulfillments> {
+    readonly uri = "https://a2a-extensions.agentstack.beeai.dev/services/llm/v1";
+    readonly params: LLMExtensionParams;
+    readonly fulfillmentsSchema: z.ZodObject<{
+        llm_fulfillments: z.ZodRecord<z.ZodString, z.ZodObject<{
+            identifier: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            api_base: z.ZodString;
+            api_key: z.ZodString;
+            api_model: z.ZodString;
+        }, zod_v4_core.$strip>>;
+    }, zod_v4_core.$strip>;
+    constructor(params: LLMExtensionParams);
+    toAgentCardExtension(): {
+        uri: string;
+        required: boolean;
+        params: {
+            llm_demands: Record<string, {
+                description?: string | null | undefined;
+                suggested?: string[] | null | undefined;
+            }>;
+        };
+    };
+    parseFulfillments(message: Message): {
+        llm_fulfillments: Record<string, {
+            api_base: string;
+            api_key: string;
+            api_model: string;
+            identifier?: string | null | undefined;
+        }>;
+    } | undefined;
+}
+declare class LLMExtensionServer implements ExtensionServer<LLMExtensionDeps, LLMExtensionParams, LLMExtensionFulfillments> {
+    readonly spec: LLMExtensionSpec;
+    constructor(params: LLMExtensionParams);
+    resolveDeps(fulfillments: LLMExtensionFulfillments | undefined): LLMExtensionDeps;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+interface PlatformSelfRegistrationExtensionParams extends Record<string, unknown> {
+    self_registration_id: string;
+}
+type PlatformSelfRegistrationExtensionFulfillments = undefined;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare const PLATFORM_SELF_REGISTRATION_EXTENSION_URI = "https://a2a-extensions.agentstack.beeai.dev/services/platform-self-registration/v1";
+declare class PlatformSelfRegistrationExtensionSpec implements ExtensionSpec<PlatformSelfRegistrationExtensionParams, PlatformSelfRegistrationExtensionFulfillments> {
+    readonly uri = "https://a2a-extensions.agentstack.beeai.dev/services/platform-self-registration/v1";
+    readonly params: PlatformSelfRegistrationExtensionParams;
+    constructor(params: PlatformSelfRegistrationExtensionParams);
+    toAgentCardExtension(): {
+        uri: string;
+        required: boolean;
+        params: PlatformSelfRegistrationExtensionParams;
+    };
+    parseFulfillments(): undefined;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+declare function loadConfig(): {
+    platformUrl: string;
+    productionMode: boolean;
+};
+declare function isProductionMode(): boolean;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare class RunContext {
+    readonly taskId: string;
+    readonly contextId: string;
+    readonly task?: Task;
+    constructor(taskId: string, contextId: string, task?: Task);
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare const configSchema: z__default.ZodObject<{
+    platformUrl: z__default.ZodDefault<z__default.ZodString>;
+    productionMode: z__default.ZodDefault<z__default.ZodPipe<z__default.ZodOptional<z__default.ZodString>, z__default.ZodTransform<boolean, string | undefined>>>;
+}, z__default.core.$strip>;
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type RunYield = string | Message | Part | TaskStatus | TaskStatusUpdateEvent | Artifact | Error | Record<string, unknown>;
+type AgentFunction<TDeps = Record<string, never>> = (input: Message, ctx: RunContext, deps: TDeps) => AsyncIterable<RunYield> | Promise<RunYield | void>;
+interface AgentOptions<TDeps = Record<string, never>> {
+    name: string;
+    description?: string;
+    detail?: AgentDetail;
+    extensions?: ExtensionConfig<TDeps>;
+    version?: string;
+    protocolVersion?: string;
+    handler: AgentFunction<TDeps>;
+}
+interface ServerOptions {
+    host?: string;
+    port?: number;
+    selfRegistrationId?: string;
+    platformUrl?: string;
+}
+interface ServerHandle {
+    port: number;
+    url: string;
+    close: () => Promise<void>;
+}
+interface AutoregistrationOptions {
+    selfRegistrationId: string;
+    agentCard: AgentCard;
+    host: string;
+    port: number;
+    api: ReturnType<typeof buildApiClient>;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+declare class Server {
+    private agentCard?;
+    private agentOptions?;
+    private agentConfigured;
+    agent<TDeps>(options: AgentOptions<TDeps>): this;
+    run(options?: ServerOptions): Promise<ServerHandle>;
+    private buildExtensions;
+}
+
+/**
+ * Copyright 2025 © BeeAI a Series of LF Projects, LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+type Config = z__default.infer<typeof configSchema>;
+
+export { type AgentDetailExtensionFulfillments, type AgentDetailExtensionParams, AgentDetailExtensionSpec, type AgentFunction, type AgentOptions, type AutoregistrationOptions, type Config, type ExtensionConfig, type ExtensionServer, type ExtensionSpec, type LLMExtensionDeps, type LLMExtensionFulfillments, type LLMExtensionParams, LLMExtensionServer, LLMExtensionSpec, PLATFORM_SELF_REGISTRATION_EXTENSION_URI, type PlatformSelfRegistrationExtensionFulfillments, type PlatformSelfRegistrationExtensionParams, PlatformSelfRegistrationExtensionSpec, RunContext, type RunYield, Server, type ServerHandle, type ServerOptions, configSchema, isProductionMode, loadConfig };