@inkeep/agents-sdk 0.0.0-dev-20250910233133

package/dist/tool.js

@@ -0,0 +1,122 @@
+import { getLogger } from "@inkeep/agents-core";
+const logger = getLogger("tool");
+export class Tool {
+    config;
+    baseURL;
+    tenantId;
+    initialized = false;
+    constructor(config) {
+        this.config = config;
+        this.baseURL = process.env.INKEEP_API_URL || "http://localhost:3002";
+        this.tenantId = config.tenantId || "default";
+        logger.info({
+            toolId: this.getId(),
+            toolName: config.name,
+        }, "Tool constructor initialized");
+    }
+    // Compute ID from name using same slug transformation as agents
+    getId() {
+        return this.config.id;
+    }
+    getName() {
+        return this.config.name;
+    }
+    getDescription() {
+        return this.config.description || "";
+    }
+    getServerUrl() {
+        return this.config.serverUrl;
+    }
+    getActiveTools() {
+        return this.config.activeTools;
+    }
+    getCredentialReferenceId() {
+        return this.config.credential?.id;
+    }
+    // Public method to ensure tool exists in backend (with upsert behavior)
+    async init(options) {
+        if (this.initialized)
+            return;
+        try {
+            // Only upsert the tool if not skipping database registration
+            if (!options?.skipDatabaseRegistration) {
+                await this.upsertTool();
+            }
+            logger.info({
+                toolId: this.getId(),
+            }, "Tool initialized successfully");
+            this.initialized = true;
+        }
+        catch (error) {
+            logger.error({
+                toolId: this.getId(),
+                error: error instanceof Error ? error.message : "Unknown error",
+            }, "Failed to initialize tool");
+            throw error;
+        }
+    }
+    // Private method to upsert tool (create or update)
+    async upsertTool() {
+        const toolDataForUpdate = {
+            id: this.getId(),
+            name: this.config.name,
+            // Don't send description as it's not in the database schema
+            // Explicitly set to null when undefined to ensure removal
+            credentialReferenceId: this.config.credential?.id ?? null,
+            // Explicitly set headers to null when undefined to ensure removal
+            headers: this.config.headers ?? null,
+            imageUrl: this.config.imageUrl, // Include image URL
+            config: {
+                type: "mcp",
+                mcp: {
+                    server: {
+                        url: this.config.serverUrl,
+                    },
+                    activeTools: this.config.activeTools,
+                },
+            },
+        };
+        const toolDataForCreate = {
+            ...toolDataForUpdate,
+        };
+        logger.info({ toolDataForCreate }, "toolDataForCreate");
+        // First try to update (in case tool exists)
+        const updateResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/tools/${this.getId()}`, {
+            method: "PUT",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(toolDataForUpdate),
+        });
+        logger.info({ updateResponse }, "tool updateResponse");
+        if (updateResponse.ok) {
+            logger.info({
+                toolId: this.getId(),
+            }, "Tool updated successfully");
+            return;
+        }
+        // If update failed with 404, tool doesn't exist - create it
+        if (updateResponse.status === 404) {
+            logger.info({
+                toolId: this.getId(),
+            }, "Tool not found, creating new tool");
+            const createResponse = await fetch(`${this.baseURL}/tenants/${this.tenantId}/crud/tools`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(toolDataForCreate),
+            });
+            if (!createResponse.ok) {
+                throw new Error(`Failed to create tool: ${createResponse.status}`);
+            }
+            logger.info({
+                toolId: this.getId(),
+            }, "Tool created successfully");
+            return;
+        }
+        // If we get here, the update failed for some other reason
+        throw new Error(`Failed to update tool: ${updateResponse.status}`);
+    }
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,286 @@
+import type { AgentApiInsert, AgentConversationHistoryConfig, ArtifactComponentApiInsert, CredentialReferenceApiInsert, DataComponentApiInsert, McpTransportConfig, ToolInsert } from "@inkeep/agents-core";
+import { z } from "zod";
+import type { ExternalAgentConfig } from "./externalAgent";
+export interface UserMessage {
+    role: "user";
+    content: string;
+}
+export interface AssistantMessage {
+    role: "assistant";
+    content: string;
+    toolCalls?: ToolCall[];
+}
+export interface ToolMessage {
+    role: "tool";
+    content: string;
+    toolCallId: string;
+}
+export interface SystemMessage {
+    role: "system";
+    content: string;
+}
+export type Message = UserMessage | AssistantMessage | ToolMessage | SystemMessage;
+export type MessageInput = string | string[] | Message | Message[];
+export interface ToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolResult {
+    id: string;
+    result: any;
+    error?: string;
+}
+export type AllAgentInterface = AgentInterface | ExternalAgentInterface;
+export interface AgentConfig extends Omit<AgentApiInsert, "projectId"> {
+    type?: "internal";
+    tools?: () => any[];
+    canTransferTo?: () => AgentInterface[];
+    canDelegateTo?: () => AllAgentInterface[];
+    tenantId?: string;
+    projectId?: string;
+    models?: {
+        base?: ModelSettings;
+        structuredOutput?: ModelSettings;
+        summarizer?: ModelSettings;
+    };
+    stopWhen?: {
+        stepCountIs?: number;
+    };
+    memory?: {
+        type: "conversation" | "episodic" | "short_term";
+        capacity?: number;
+    };
+    dataComponents?: () => DataComponentApiInsert[];
+    artifactComponents?: () => ArtifactComponentApiInsert[];
+    conversationHistoryConfig?: AgentConversationHistoryConfig;
+}
+export interface ModelSettings {
+    model?: string;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+export declare const ModelSettingsSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+export interface ToolConfig extends ToolInsert {
+    execute: (params: any) => Promise<any>;
+    parameters?: Record<string, any>;
+    schema?: z.ZodJSONSchema;
+}
+export interface ServerConfig {
+    type: string;
+    version?: string;
+}
+export interface MCPToolConfig {
+    id: string;
+    name: string;
+    tenantId?: string;
+    description?: string;
+    credential?: CredentialReferenceApiInsert;
+    server?: ServerConfig;
+    serverUrl: string;
+    toolName?: string;
+    activeTools?: string[];
+    headers?: Record<string, string>;
+    mcpType?: "nango" | "generic";
+    transport?: McpTransportConfig;
+    imageUrl?: string;
+}
+export interface FetchDefinitionConfig {
+    id: string;
+    name?: string;
+    trigger: "initialization" | "invocation";
+    url: string;
+    method?: string;
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+    transform?: string;
+    responseSchema?: z.ZodSchema<any>;
+    defaultValue?: unknown;
+    timeout?: number;
+    credential?: CredentialReferenceApiInsert;
+}
+export interface RequestSchemaDefinition {
+    body?: z.ZodSchema<any>;
+    headers?: z.ZodSchema<any>;
+    query?: z.ZodSchema<any>;
+    params?: z.ZodSchema<any>;
+}
+export interface RequestSchemaConfig {
+    schemas: RequestSchemaDefinition;
+    optional?: ("body" | "headers" | "query" | "params")[];
+}
+export interface TransferConfig {
+    agent: AgentInterface;
+    description?: string;
+    condition?: (context: any) => boolean;
+}
+export interface GenerateOptions {
+    maxTurns?: number;
+    maxSteps?: number;
+    temperature?: number;
+    toolChoice?: "auto" | "none" | string;
+    resourceId?: string;
+    conversationId?: string;
+    stream?: boolean;
+    customBodyParams?: Record<string, unknown>;
+}
+export interface AgentResponse {
+    id?: string;
+    text: string;
+    toolCalls?: ToolCall[];
+    transfer?: TransferConfig;
+    finishReason: "completed" | "tool_calls" | "transfer" | "max_turns" | "error";
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens?: number;
+    };
+    metadata?: Record<string, any>;
+}
+export interface StreamResponse {
+    textStream?: AsyncGenerator<string>;
+    eventStream?: AsyncGenerator<StreamEvent>;
+}
+export interface StreamEvent {
+    type: "text" | "tool_call" | "transfer" | "error" | "done";
+    data: any;
+    timestamp: Date;
+}
+export interface RunResult {
+    finalOutput: string;
+    agent: AgentInterface;
+    turnCount: number;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens?: number;
+    };
+    metadata?: {
+        toolCalls: ToolCall[];
+        transfers: TransferConfig[];
+    };
+}
+export interface StatusComponent {
+    id: string;
+    name: string;
+    type: string;
+    description?: string;
+    schema: {
+        type: "object";
+        properties: Record<string, any>;
+        required?: string[];
+    };
+}
+export interface StatusUpdateSettings {
+    enabled?: boolean;
+    numEvents?: number;
+    timeInSeconds?: number;
+    model?: string;
+    statusComponents?: StatusComponent[];
+    prompt?: string;
+}
+export interface GraphConfig {
+    id: string;
+    name?: string;
+    description?: string;
+    defaultAgent?: AgentInterface;
+    agents?: () => AllAgentInterface[];
+    tenantId?: string;
+    contextConfig?: any;
+    credentials?: () => CredentialReferenceApiInsert[];
+    stopWhen?: {
+        transferCountIs?: number;
+    };
+    graphPrompt?: string;
+    models?: {
+        base?: ModelSettings;
+        structuredOutput?: ModelSettings;
+        summarizer?: ModelSettings;
+    };
+    statusUpdates?: StatusUpdateSettings;
+}
+export declare class AgentError extends Error {
+    code?: string | undefined;
+    details?: any | undefined;
+    constructor(message: string, code?: string | undefined, details?: any | undefined);
+}
+export declare class MaxTurnsExceededError extends AgentError {
+    constructor(maxTurns: number);
+}
+export declare class ToolExecutionError extends AgentError {
+    constructor(toolName: string, originalError: Error);
+}
+export declare class TransferError extends AgentError {
+    constructor(sourceAgent: string, targetAgent: string, reason: string);
+}
+export interface AgentInterface {
+    config: AgentConfig;
+    type: "internal";
+    init(): Promise<void>;
+    getId(): string;
+    getName(): string;
+    getInstructions(): string;
+    getTools(): Record<string, any>;
+    getTransfers(): AgentInterface[];
+    getDelegates(): AllAgentInterface[];
+    getDataComponents(): DataComponentApiInsert[];
+    getArtifactComponents(): ArtifactComponentApiInsert[];
+    addTool(name: string, tool: any): void;
+    addTransfer(...agents: AgentInterface[]): void;
+    addDelegate(...agents: AgentInterface[]): void;
+}
+export interface ExternalAgentInterface {
+    config: ExternalAgentConfig;
+    type: "external";
+    init(): Promise<void>;
+    getId(): string;
+    getName(): string;
+    getDescription(): string;
+    getBaseUrl(): string;
+    getCredentialReferenceId(): string | undefined;
+    getHeaders(): Record<string, string> | undefined;
+}
+export interface GraphInterface {
+    init(): Promise<void>;
+    setConfig(tenantId: string, projectId: string, apiUrl: string): void;
+    getId(): string;
+    getName(): string;
+    getDescription(): string | undefined;
+    getTenantId(): string;
+    generate(input: MessageInput, options?: GenerateOptions): Promise<string>;
+    stream(input: MessageInput, options?: GenerateOptions): Promise<StreamResponse>;
+    generateStream(input: MessageInput, options?: GenerateOptions): Promise<StreamResponse>;
+    getDefaultAgent(): AgentInterface | undefined;
+    getAgent(name: string): AllAgentInterface | undefined;
+    getAgents(): AllAgentInterface[];
+}
+export interface BuilderToolConfig {
+    name: string;
+    description: string;
+    config: {
+        type: "mcp";
+        mcp: {
+            server: {
+                url: string;
+            };
+        };
+    };
+    parameters?: Record<string, any>;
+}
+export interface BuilderRelationConfig {
+    targetAgent: string;
+    relationType: "transfer" | "delegate";
+}
+export interface BuilderAgentConfig {
+    name: string;
+    description: string;
+    instructions: string;
+    tools: BuilderToolConfig[];
+    relations?: BuilderRelationConfig[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+export const ModelSettingsSchema = z.object({
+    model: z.string().optional(),
+    providerOptions: z
+        .record(z.string(), z.record(z.string(), z.unknown()))
+        .optional(),
+});
+// Error types
+export class AgentError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "AgentError";
+    }
+}
+export class MaxTurnsExceededError extends AgentError {
+    constructor(maxTurns) {
+        super(`Maximum turns (${maxTurns}) exceeded`);
+        this.code = "MAX_TURNS_EXCEEDED";
+    }
+}
+export class ToolExecutionError extends AgentError {
+    constructor(toolName, originalError) {
+        super(`Tool '${toolName}' execution failed: ${originalError.message}`);
+        this.code = "TOOL_EXECUTION_ERROR";
+        this.details = { toolName, originalError };
+    }
+}
+export class TransferError extends AgentError {
+    constructor(sourceAgent, targetAgent, reason) {
+        super(`Transfer from '${sourceAgent}' to '${targetAgent}' failed: ${reason}`);
+        this.code = "TRANSFER_ERROR";
+        this.details = { sourceAgent, targetAgent, reason };
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiFxB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,eAAe,EAAE,CAAC;SAChB,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACrD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAkKH,cAAc;AACd,MAAM,OAAO,UAAW,SAAQ,KAAK;IAG5B;IACA;IAHR,YACC,OAAe,EACR,IAAa,EACb,OAAa;QAEpB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAS;QACb,YAAO,GAAP,OAAO,CAAM;QAGpB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,CAAC;CACD;AAED,MAAM,OAAO,qBAAsB,SAAQ,UAAU;IACpD,YAAY,QAAgB;QAC3B,KAAK,CAAC,kBAAkB,QAAQ,YAAY,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,UAAU;IACjD,YAAY,QAAgB,EAAE,aAAoB;QACjD,KAAK,CAAC,SAAS,QAAQ,uBAAuB,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;CACD;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC5C,YAAY,WAAmB,EAAE,WAAmB,EAAE,MAAc;QACnE,KAAK,CACJ,kBAAkB,WAAW,SAAS,WAAW,aAAa,MAAM,EAAE,CACtE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IACrD,CAAC;CACD"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@inkeep/agents-sdk",
+  "version": "0.0.0-dev-20250910233133",
+  "description": "SDK for building and managing agents in the Inkeep Agent Framework",
+  "main": "dist/index.js",
+  "type": "module",
+  "clean-package": "./clean-package.config.json",
+  "dependencies": {
+    "nanoid": "^5.1.5",
+    "zod": "^4.1.5",
+    "@inkeep/agents-core": "^0.0.0-dev-20250910233133"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.1.4",
+    "@types/node": "^20.11.24",
+    "@vitest/coverage-v8": "^2.0.0",
+    "clean-package": "^2.2.0",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3",
+    "vitest": "^3.1.4"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/inkeep/agents.git",
+    "directory": "packages/agents-sdk"
+  },
+  "keywords": [
+    "agents",
+    "ai",
+    "framework",
+    "sdk",
+    "inkeep"
+  ],
+  "author": "Inkeep",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "ENVIRONMENT=test vitest --run",
+    "test:watch": "ENVIRONMENT=test vitest",
+    "test:coverage": "ENVIRONMENT=test vitest --run --coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check --apply .",
+    "format": "biome format --write ."
+  }
+}