@inkeep/agents-sdk 0.1.0 → 0.1.6

package/dist/artifact-component.js

@@ -1,117 +0,0 @@
-import { generateIdFromName, } from '@inkeep/agents-core';
-import { getLogger } from '@inkeep/agents-core';
-const logger = getLogger('artifactComponent');
-export class ArtifactComponent {
-    config;
-    baseURL;
-    tenantId;
-    projectId;
-    initialized = false;
-    id;
-    constructor(config) {
-        this.id = generateIdFromName(config.name);
-        this.config = {
-            ...config,
-            id: this.id,
-            tenantId: config.tenantId || 'default',
-            projectId: config.projectId || 'default',
-        };
-        this.baseURL = process.env.INKEEP_API_URL || 'http://localhost:3002';
-        this.tenantId = this.config.tenantId;
-        this.projectId = this.config.projectId;
-        logger.info({
-            artifactComponentId: this.getId(),
-            artifactComponentName: config.name,
-        }, 'ArtifactComponent constructor initialized');
-    }
-    // Compute ID from name using same slug transformation as agents
-    getId() {
-        return this.id;
-    }
-    getName() {
-        return this.config.name;
-    }
-    getDescription() {
-        return this.config.description;
-    }
-    getSummaryProps() {
-        return this.config.summaryProps;
-    }
-    getFullProps() {
-        return this.config.fullProps;
-    }
-    // Public method to ensure artifact component exists in backend (with upsert behavior)
-    async init() {
-        if (this.initialized)
-            return;
-        try {
-            // Always attempt to upsert the artifact component
-            await this.upsertArtifactComponent();
-            logger.info({
-                artifactComponentId: this.getId(),
-            }, 'ArtifactComponent initialized successfully');
-            this.initialized = true;
-        }
-        catch (error) {
-            logger.error({
-                artifactComponentId: this.getId(),
-                error: error instanceof Error ? error.message : 'Unknown error',
-            }, 'Failed to initialize artifact component');
-            throw error;
-        }
-    }
-    // Private method to upsert artifact component (create or update)
-    async upsertArtifactComponent() {
-        const artifactComponentData = {
-            id: this.getId(),
-            name: this.config.name,
-            description: this.config.description,
-            summaryProps: this.config.summaryProps,
-            fullProps: this.config.fullProps,
-        };
-        logger.info({ artifactComponentData }, 'artifactComponentData for create/update');
-        // First try to update (in case artifact component exists)
-        const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/artifact-components/${this.getId()}`, {
-            method: 'PUT',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(artifactComponentData),
-        });
-        logger.info({
-            status: updateResponse.status,
-            artifactComponentId: this.getId(),
-        }, 'artifact component updateResponse');
-        if (updateResponse.ok) {
-            logger.info({
-                artifactComponentId: this.getId(),
-            }, 'ArtifactComponent updated successfully');
-            return;
-        }
-        // If update failed with 404, artifact component doesn't exist - create it
-        if (updateResponse.status === 404) {
-            logger.info({
-                artifactComponentId: this.getId(),
-            }, 'ArtifactComponent not found, creating new artifact component');
-            const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/artifact-components`, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(artifactComponentData),
-            });
-            if (!createResponse.ok) {
-                const errorText = await createResponse.text().catch(() => 'Unknown error');
-                throw new Error(`Failed to create artifact component: ${createResponse.status} ${createResponse.statusText} - ${errorText}`);
-            }
-            logger.info({
-                artifactComponentId: this.getId(),
-            }, 'ArtifactComponent created successfully');
-            return;
-        }
-        // If we get here, the update failed for some other reason
-        const errorText = await updateResponse.text().catch(() => 'Unknown error');
-        throw new Error(`Failed to update artifact component: ${updateResponse.status} ${updateResponse.statusText} - ${errorText}`);
-    }
-}
-//# sourceMappingURL=artifact-component.js.map

package/dist/artifact-component.js.map

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

package/dist/builders.d.ts

@@ -1,211 +0,0 @@
-import { z } from 'zod';
-import { Agent } from './agent.js';
-import { ArtifactComponent } from './artifact-component.js';
-import { DataComponent } from './data-component.js';
-import { Tool } from './tool.js';
-import { type CredentialReferenceApiInsert, type MCPToolConfig } from '@inkeep/agents-core';
-import type { AgentConfig, TransferConfig } from './types.js';
-/**
- * Creates a new agent with stable ID enforcement.
- *
- * @param config - Agent configuration including required stable ID
- * @returns A new Agent instance
- * @throws Error if config.id is not provided (stable IDs are required)
- *
- * @example
- * ```typescript
- * const myAgent = agent({
- *   id: 'customer-support-agent',
- *   name: 'Customer Support',
- *   prompt: 'Help customers with their questions'
- * });
- * ```
- */
-export declare function agent(config: AgentConfig): Agent;
-export declare function credential(config: CredentialReferenceApiInsert): {
-    id: string;
-    type: string;
-    credentialStoreId: string;
-    retrievalParams?: Record<string, unknown> | null | undefined;
-};
-export declare const ToolConfigSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodString;
-    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    schema: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strip>;
-export declare const ToolSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodString;
-    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    schema: z.ZodOptional<z.ZodUnknown>;
-    execute: z.ZodAny;
-}, z.core.$strip>;
-/**
- * Creates a tool with automatic ID generation (unlike agents which require explicit IDs).
- *
- * Tools automatically generate IDs from their name, whereas agents require stable IDs
- * to be explicitly provided for consistency across deployments.
- *
- * @param config - Tool configuration with auto-generated ID
- * @returns A Tool instance with auto-generated ID based on name
- *
- * @example
- * ```typescript
- * const searchTool = tool({
- *   name: 'Search Database',
- *   description: 'Search the product database',
- *   execute: async (params) => { ... }
- * });
- * // ID will be auto-generated as 'search-database'
- * ```
- */
-export declare function tool(config: {
-    name: string;
-    description: string;
-    execute: (params: any) => Promise<any>;
-    parameters?: Record<string, any>;
-    schema?: z.ZodJSONSchema;
-}): {
-    id: string;
-    name: string;
-    description: string;
-    execute: (params: any) => Promise<any>;
-    parameters: Record<string, any> | undefined;
-    schema: unknown;
-    type: "function";
-};
-export declare const McpServerConfigSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    name: z.ZodString;
-    description: z.ZodString;
-    tenantId: z.ZodOptional<z.ZodString>;
-    deployment: z.ZodOptional<z.ZodEnum<{
-        local: "local";
-        remote: "remote";
-    }>>;
-    port: z.ZodOptional<z.ZodNumber>;
-    serverUrl: z.ZodOptional<z.ZodString>;
-    credential: z.ZodOptional<z.ZodObject<{
-        id: z.ZodString;
-        type: z.ZodString;
-        credentialStoreId: z.ZodString;
-        retrievalParams: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    }, z.core.$strip>>;
-    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    transport: z.ZodOptional<z.ZodEnum<{
-        sse: "sse";
-        ipc: "ipc";
-        http: "http";
-    }>>;
-    activeTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strip>;
-/**
- * Creates an MCP (Model Context Protocol) server for tool functionality.
- *
- * This unified builder replaces tool(), mcpTool(), ipcTool(), and hostedTool().
- * All tools are MCP servers - either local (with execute function) or remote (with URL).
- *
- * @param config - MCP server configuration
- * @returns An MCP server instance that can be used as a tool in agents
- *
- * @example
- * ```typescript
- * // Local MCP server with execute function (auto-wrapped via IPC)
- * const searchServer = mcpServer({
- *   name: 'search',
- *   description: 'Search the database',
- *   execute: async (params) => {
- *     // Implementation
- *     return results;
- *   }
- * });
- *
- * // Remote MCP server
- * const apiServer = mcpServer({
- *   name: 'external_api',
- *   description: 'External API service',
- *   serverUrl: 'https://api.example.com/mcp'
- * });
- * ```
- */
-export declare function mcpServer(config: {
-    name: string;
-    description: string;
-    deployment?: 'local' | 'remote';
-    execute?: (params: any) => Promise<any>;
-    port?: number;
-    serverUrl?: string;
-    id?: string;
-    parameters?: Record<string, z.ZodJSONSchema>;
-    credential?: CredentialReferenceApiInsert;
-    tenantId?: string;
-    transport?: 'ipc' | 'http' | 'sse';
-    activeTools?: string[];
-    headers?: Record<string, string>;
-}): Tool;
-export declare function mcpTool(config: MCPToolConfig): Tool;
-export declare const TransferConfigSchema: z.ZodObject<{
-    agent: z.ZodCustom<Agent, Agent>;
-    description: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export declare const TransferSchema: z.ZodObject<{
-    agent: z.ZodCustom<Agent, Agent>;
-    description: z.ZodOptional<z.ZodString>;
-    condition: z.ZodOptional<z.ZodAny>;
-}, z.core.$strip>;
-export declare function transfer(targetAgent: Agent, description?: string, condition?: (context: unknown) => boolean): TransferConfig;
-export declare function agentRelation(targetAgent: string, relationType?: 'transfer' | 'delegate'): {
-    targetAgent: string;
-    relationType: "transfer" | "delegate";
-};
-/**
- * Creates an artifact component with automatic ID generation.
- *
- * @param config - Artifact component configuration
- * @returns An ArtifactComponent instance with auto-generated ID
- *
- * @example
- * ```typescript
- * const productCard = artifactComponent({
- *   name: 'Product Card',
- *   description: 'Display product information',
- *   summaryProps: { title: 'Product', price: '$0' },
- *   fullProps: { title: 'Product', price: '$0', description: '...' }
- * });
- * ```
- */
-export declare function artifactComponent(config: {
-    name: string;
-    description: string;
-    summaryProps: Record<string, any>;
-    fullProps: Record<string, any>;
-    tenantId?: string;
-    projectId?: string;
-}): ArtifactComponent;
-/**
- * Creates a data component with automatic ID generation.
- *
- * @param config - Data component configuration
- * @returns A DataComponent instance with auto-generated ID
- *
- * @example
- * ```typescript
- * const userProfile = dataComponent({
- *   name: 'User Profile',
- *   description: 'User profile data',
- *   props: { userId: '123', name: 'John Doe' }
- * });
- * ```
- */
-export declare function dataComponent(config: {
-    name: string;
-    description: string;
-    props: Record<string, any>;
-    tenantId?: string;
-    projectId?: string;
-}): DataComponent;
-//# sourceMappingURL=builders.d.ts.map

package/dist/builders.d.ts.map

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

package/dist/builders.js

@@ -1,244 +0,0 @@
-import { z } from 'zod';
-import { Agent } from './agent.js';
-import { ArtifactComponent } from './artifact-component.js';
-import { DataComponent } from './data-component.js';
-import { Tool } from './tool.js';
-import { CredentialReferenceApiInsertSchema, MCPToolConfigSchema, } from '@inkeep/agents-core';
-/**
- * Creates a new agent with stable ID enforcement.
- *
- * @param config - Agent configuration including required stable ID
- * @returns A new Agent instance
- * @throws Error if config.id is not provided (stable IDs are required)
- *
- * @example
- * ```typescript
- * const myAgent = agent({
- *   id: 'customer-support-agent',
- *   name: 'Customer Support',
- *   prompt: 'Help customers with their questions'
- * });
- * ```
- */
-export function agent(config) {
-    return new Agent(config);
-}
-export function credential(config) {
-    return CredentialReferenceApiInsertSchema.parse(config);
-}
-// Separate schema for non-function properties
-export const ToolConfigSchema = z.object({
-    id: z.string().optional(),
-    name: z.string(),
-    description: z.string(),
-    parameters: z.record(z.string(), z.any()).optional(),
-    schema: z.unknown().optional(),
-});
-// Keep the old schema name for backward compatibility, but make it clear it's partial
-export const ToolSchema = ToolConfigSchema.extend({
-    execute: z.any(), // Function - validated separately at runtime
-});
-/**
- * Creates a tool with automatic ID generation (unlike agents which require explicit IDs).
- *
- * Tools automatically generate IDs from their name, whereas agents require stable IDs
- * to be explicitly provided for consistency across deployments.
- *
- * @param config - Tool configuration with auto-generated ID
- * @returns A Tool instance with auto-generated ID based on name
- *
- * @example
- * ```typescript
- * const searchTool = tool({
- *   name: 'Search Database',
- *   description: 'Search the product database',
- *   execute: async (params) => { ... }
- * });
- * // ID will be auto-generated as 'search-database'
- * ```
- */
-export function tool(config) {
-    // Validate function separately with clear error message
-    if (typeof config.execute !== 'function') {
-        throw new Error('execute must be a function');
-    }
-    // Validate non-function properties with schema
-    const { execute, ...configWithoutFunction } = config;
-    const validatedConfig = ToolConfigSchema.parse(configWithoutFunction);
-    // Combine validated config with function
-    const fullConfig = { ...validatedConfig, execute };
-    // Return function tool format
-    const computedId = fullConfig.name
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-+|-+$/g, '');
-    return {
-        id: computedId,
-        name: fullConfig.name,
-        description: fullConfig.description,
-        execute: fullConfig.execute,
-        parameters: fullConfig.parameters,
-        schema: fullConfig.schema,
-        type: 'function',
-    };
-}
-// MCP Server Configuration Schema
-export const McpServerConfigSchema = z.object({
-    id: z.string().optional(),
-    name: z.string(),
-    description: z.string(),
-    tenantId: z.string().optional(),
-    // Deployment configuration
-    deployment: z.enum(['local', 'remote']).optional(),
-    // For local MCP servers
-    port: z.number().optional(),
-    // For remote MCP servers
-    serverUrl: z.string().optional(),
-    credential: CredentialReferenceApiInsertSchema.optional(),
-    // Additional configuration
-    parameters: z.record(z.string(), z.any()).optional(),
-    transport: z.enum(['ipc', 'http', 'sse']).optional(),
-    activeTools: z.array(z.string()).optional(),
-    headers: z.record(z.string(), z.string()).optional(),
-});
-/**
- * Creates an MCP (Model Context Protocol) server for tool functionality.
- *
- * This unified builder replaces tool(), mcpTool(), ipcTool(), and hostedTool().
- * All tools are MCP servers - either local (with execute function) or remote (with URL).
- *
- * @param config - MCP server configuration
- * @returns An MCP server instance that can be used as a tool in agents
- *
- * @example
- * ```typescript
- * // Local MCP server with execute function (auto-wrapped via IPC)
- * const searchServer = mcpServer({
- *   name: 'search',
- *   description: 'Search the database',
- *   execute: async (params) => {
- *     // Implementation
- *     return results;
- *   }
- * });
- *
- * // Remote MCP server
- * const apiServer = mcpServer({
- *   name: 'external_api',
- *   description: 'External API service',
- *   serverUrl: 'https://api.example.com/mcp'
- * });
- * ```
- */
-export function mcpServer(config) {
-    // Auto-detect deployment type
-    const deployment = config.deployment || (config.execute ? 'local' : 'remote');
-    // Generate ID if not provided
-    const id = config.id ||
-        config.name
-            .toLowerCase()
-            .replace(/[^a-z0-9]+/g, '-')
-            .replace(/^-+|-+$/g, '');
-    if (deployment === 'local') {
-        // Local MCP server with execute function
-        if (!config.execute) {
-            throw new Error('Local MCP server requires an execute function');
-        }
-        throw new Error('Local MCP servers are no longer supported. Please use remote MCP servers instead.');
-    }
-    else {
-        // Remote MCP server
-        if (!config.serverUrl) {
-            throw new Error('Remote MCP server requires a serverUrl');
-        }
-        // Use Tool class for remote MCP servers
-        return new Tool({
-            id,
-            name: config.name,
-            description: config.description,
-            serverUrl: config.serverUrl,
-            tenantId: config.tenantId,
-            credential: config.credential,
-            activeTools: config.activeTools,
-            headers: config.headers,
-        });
-    }
-}
-export function mcpTool(config) {
-    const validatedConfig = MCPToolConfigSchema.parse(config);
-    return new Tool(validatedConfig);
-}
-// Separate schema for non-function transfer properties
-export const TransferConfigSchema = z.object({
-    agent: z.instanceof(Agent),
-    description: z.string().optional(),
-});
-// Full schema for backward compatibility (but functions validated separately)
-export const TransferSchema = TransferConfigSchema.extend({
-    condition: z.any().optional(), // Function - validated separately at runtime when present
-});
-export function transfer(targetAgent, description, condition) {
-    // Validate function if provided
-    if (condition !== undefined && typeof condition !== 'function') {
-        throw new Error('condition must be a function when provided');
-    }
-    const config = {
-        agent: targetAgent,
-        description: description || `Hand off to ${targetAgent.getName()}`,
-        condition,
-    };
-    // Validate the configuration (functions are validated separately above)
-    return TransferSchema.parse(config);
-}
-export function agentRelation(targetAgent, relationType = 'transfer') {
-    return {
-        targetAgent,
-        relationType,
-    };
-}
-/**
- * Creates an artifact component with automatic ID generation.
- *
- * @param config - Artifact component configuration
- * @returns An ArtifactComponent instance with auto-generated ID
- *
- * @example
- * ```typescript
- * const productCard = artifactComponent({
- *   name: 'Product Card',
- *   description: 'Display product information',
- *   summaryProps: { title: 'Product', price: '$0' },
- *   fullProps: { title: 'Product', price: '$0', description: '...' }
- * });
- * ```
- */
-export function artifactComponent(config) {
-    return new ArtifactComponent({
-        ...config,
-        tenantId: config.tenantId || 'default',
-        projectId: config.projectId || 'default',
-    });
-}
-/**
- * Creates a data component with automatic ID generation.
- *
- * @param config - Data component configuration
- * @returns A DataComponent instance with auto-generated ID
- *
- * @example
- * ```typescript
- * const userProfile = dataComponent({
- *   name: 'User Profile',
- *   description: 'User profile data',
- *   props: { userId: '123', name: 'John Doe' }
- * });
- * ```
- */
-export function dataComponent(config) {
-    return new DataComponent({
-        ...config,
-        tenantId: config.tenantId || 'default',
-        projectId: config.projectId || 'default',
-    });
-}
-//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

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

package/dist/data-component.d.ts

@@ -1,25 +0,0 @@
-import { type DataComponentInsert as DataComponentType } from '@inkeep/agents-core';
-export interface DataComponentInterface {
-    config: Omit<DataComponentType, 'id'>;
-    init(): Promise<void>;
-    getId(): DataComponentType['id'];
-    getName(): DataComponentType['name'];
-    getDescription(): DataComponentType['description'];
-    getProps(): DataComponentType['props'];
-}
-export declare class DataComponent implements DataComponentInterface {
-    config: DataComponentType;
-    private baseURL;
-    private tenantId;
-    private projectId;
-    private initialized;
-    private id;
-    constructor(config: Omit<DataComponentType, 'id'>);
-    getId(): string;
-    getName(): string;
-    getDescription(): string;
-    getProps(): DataComponentType['props'];
-    init(): Promise<void>;
-    private upsertDataComponent;
-}
-//# sourceMappingURL=data-component.d.ts.map

package/dist/data-component.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"data-component.d.ts","sourceRoot":"","sources":["../src/data-component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,IAAI,iBAAiB,EAAsB,MAAM,qBAAqB,CAAC;AAKxG,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACrC,cAAc,IAAI,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACnD,QAAQ,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;CACxC;AAED,qBAAa,aAAc,YAAW,sBAAsB;IACnD,MAAM,EAAE,iBAAiB,CAAC;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,EAAE,CAA0B;gBAExB,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC;IAsBjD,KAAK,IAAI,MAAM;IAIf,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,QAAQ,IAAI,iBAAiB,CAAC,OAAO,CAAC;IAKhC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YA4Bb,mBAAmB;CAkFlC"}