@chanl-ai/sdk 2.0.1

package/dist/types/tool-calls.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Tool Call Types for @chanl-ai/sdk
+ *
+ * Normalized tool call data returned by Chat, Scenarios, and Calls APIs.
+ * Mirrors the backend NormalizedToolCallDto from agent-service.
+ */
+/**
+ * Tool call execution status
+ */
+export type ToolCallStatus = 'success' | 'error' | 'pending' | 'timeout';
+/**
+ * Structured error from a tool execution
+ */
+export interface ToolCallError {
+    /** Error code (e.g., 'TIMEOUT', 'NETWORK_ERROR') */
+    code?: string;
+    /** Human-readable error message */
+    message: string;
+    /** Additional error details (provider-specific) */
+    details?: unknown;
+}
+/**
+ * Normalized tool call record
+ *
+ * Consistent format returned by Chat, Scenarios, and Call transcript APIs.
+ * Contains the tool name, input parameters, execution result, timing, and status.
+ *
+ * @example
+ * ```typescript
+ * const response = await sdk.chat.sendMessage(wsId, sessionId, 'What is the weather?');
+ * for (const tc of response.data.toolCalls ?? []) {
+ *   console.log(`${tc.name}(${JSON.stringify(tc.parameters)}) → ${tc.status}`);
+ *   if (tc.durationMs) console.log(`  took ${tc.durationMs}ms`);
+ * }
+ * ```
+ */
+export interface ToolCall {
+    /** Unique identifier for this tool call */
+    id: string;
+    /** Tool name (e.g., 'get_weather', 'kb_search') */
+    name: string;
+    /** Tool description (from tool definition) */
+    description?: string;
+    /** Input parameters passed to the tool */
+    parameters: Record<string, unknown>;
+    /** Tool execution result */
+    result?: unknown;
+    /** Execution status */
+    status: ToolCallStatus;
+    /** Execution duration in milliseconds */
+    durationMs?: number;
+    /** When the tool execution started (ISO timestamp) */
+    startedAt: string;
+    /** When the tool execution completed (ISO timestamp) */
+    completedAt?: string;
+    /** Seconds from call/session start (for timeline positioning) */
+    secondsFromStart?: number;
+    /** Structured error information (when status is 'error') */
+    error?: ToolCallError;
+}
+//# sourceMappingURL=tool-calls.d.ts.map

package/dist/types/tool-calls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calls.d.ts","sourceRoot":"","sources":["../../src/types/tool-calls.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,QAAQ;IACvB,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,4BAA4B;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}

package/dist/types/tool-calls.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Tool Call Types for @chanl-ai/sdk
+ *
+ * Normalized tool call data returned by Chat, Scenarios, and Calls APIs.
+ * Mirrors the backend NormalizedToolCallDto from agent-service.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tool-calls.js.map

package/dist/types/tool-calls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calls.js","sourceRoot":"","sources":["../../src/types/tool-calls.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/types/tools.d.ts

@@ -0,0 +1,321 @@
+/**
+ * Tool Types for @chanl-ai/sdk
+ *
+ * TDD Phase: RED - These types define the contract for ToolsModule
+ * Based on chanl-api/src/tools/ schemas and DTOs
+ */
+export type ToolType = 'http' | 'javascript' | 'code';
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export type ExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'corrected';
+export type ExecutionSource = 'mcp' | 'api' | 'playground' | 'scheduled' | 'workflow';
+/**
+ * HTTP tool configuration for external API calls
+ */
+export interface HttpToolConfig {
+    /** HTTP method for the request */
+    method: HttpMethod;
+    /** URL template with {{variable}} placeholders */
+    url: string;
+    /** HTTP headers for the request */
+    headers?: Record<string, string>;
+    /** JSON body template with {{variable}} placeholders */
+    bodyTemplate?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+}
+/**
+ * JavaScript tool configuration for sandboxed code execution
+ */
+export interface JavaScriptToolConfig {
+    /** JavaScript code to execute (sandboxed) */
+    code: string;
+    /** Allowed modules for execution */
+    allowedModules?: string[];
+}
+/**
+ * Code execution configuration for Python/JavaScript workers
+ */
+export interface CodeToolConfig {
+    /** Programming language */
+    language: 'python' | 'javascript';
+    /** Entry point function name */
+    entryPoint: string;
+    /** Cloudflare Worker name for execution */
+    workerName?: string;
+}
+/**
+ * Tool configuration - contains type-specific settings
+ */
+export interface ToolConfiguration {
+    http?: HttpToolConfig;
+    javascript?: JavaScriptToolConfig;
+    code?: CodeToolConfig;
+}
+/**
+ * Tool execution statistics
+ */
+export interface ToolStats {
+    totalCalls: number;
+    successfulCalls: number;
+    failedCalls: number;
+    averageLatencyMs: number;
+    lastCalledAt?: string;
+}
+/**
+ * Tool entity representing an MCP-compatible tool
+ */
+export interface Tool {
+    /** Tool ID */
+    id: string;
+    /** Workspace ID this tool belongs to */
+    workspaceId: string;
+    /** Unique name for the tool (MCP tool name) */
+    name: string;
+    /** Description of what the tool does */
+    description: string;
+    /** Type of tool execution */
+    type: ToolType;
+    /** JSON Schema defining the tool input parameters */
+    inputSchema: Record<string, unknown>;
+    /** Tool configuration based on type */
+    configuration: ToolConfiguration;
+    /** Whether the tool is enabled */
+    isEnabled: boolean;
+    /** Tags for categorizing tools */
+    tags: string[];
+    /** User ID who created the tool */
+    createdBy: string;
+    /** User ID who last modified the tool */
+    lastModifiedBy?: string;
+    /** Execution statistics */
+    stats: ToolStats;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Input for creating a new tool
+ */
+export interface CreateToolInput {
+    /** Unique name for the tool (MCP tool name) */
+    name: string;
+    /** Description of what the tool does */
+    description: string;
+    /** Type of tool execution */
+    type: ToolType;
+    /** JSON Schema defining the tool input parameters */
+    inputSchema: Record<string, unknown>;
+    /** Tool configuration based on type */
+    configuration: ToolConfiguration;
+    /** Whether the tool is enabled (default: true) */
+    isEnabled?: boolean;
+    /** Tags for categorizing tools */
+    tags?: string[];
+}
+/**
+ * Input for updating an existing tool
+ */
+export interface UpdateToolInput {
+    /** Updated name */
+    name?: string;
+    /** Updated description */
+    description?: string;
+    /** Updated type */
+    type?: ToolType;
+    /** Updated input schema */
+    inputSchema?: Record<string, unknown>;
+    /** Updated configuration */
+    configuration?: ToolConfiguration;
+    /** Updated enabled status */
+    isEnabled?: boolean;
+    /** Updated tags */
+    tags?: string[];
+}
+/**
+ * Filters for listing tools
+ */
+export interface ToolFilters {
+    /** Filter by tool type */
+    type?: ToolType;
+    /** Filter by enabled status */
+    isEnabled?: boolean;
+    /** Search by name or description */
+    search?: string;
+    /** Filter by tag */
+    tag?: string;
+    /** Include system tools in results (default: true) */
+    includeSystem?: boolean;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Number of items per page (default: 20) */
+    limit?: number;
+    /** Sort field */
+    sortBy?: 'name' | 'createdAt' | 'updatedAt' | 'type';
+    /** Sort order */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Correction record for input normalization
+ */
+export interface CorrectionRecord {
+    field: string;
+    original: unknown;
+    corrected: unknown;
+    rule: string;
+}
+/**
+ * Tool execution record
+ */
+export interface ToolExecution {
+    /** Execution ID */
+    id: string;
+    /** Tool ID that was executed */
+    toolId: string;
+    /** Workspace ID */
+    workspaceId: string;
+    /** User ID who triggered the execution */
+    userId?: string;
+    /** Source of the execution */
+    source: ExecutionSource;
+    /** Input arguments passed to the tool */
+    input: Record<string, unknown>;
+    /** Output from the tool execution */
+    output?: Record<string, unknown>;
+    /** Execution status */
+    status: ExecutionStatus;
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+    /** Error message if execution failed */
+    errorMessage?: string;
+    /** Input corrections applied during normalization */
+    correctionsApplied?: CorrectionRecord[];
+    /** OpenTelemetry trace ID */
+    traceId?: string;
+    /** OpenTelemetry span ID */
+    spanId?: string;
+    /** When execution started */
+    startedAt?: string;
+    /** When execution completed */
+    completedAt?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Filters for listing executions
+ */
+export interface ExecutionFilters {
+    /** Filter by execution status */
+    status?: ExecutionStatus;
+    /** Filter by execution source */
+    source?: ExecutionSource;
+    /** Filter by start date */
+    fromDate?: string;
+    /** Filter by end date */
+    toDate?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Number of items per page (default: 20) */
+    limit?: number;
+}
+/**
+ * Response for listing tools
+ */
+export interface ToolListResponse {
+    tools: Tool[];
+    total: number;
+    pagination: {
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+/**
+ * Response for single tool operations
+ */
+export interface ToolResponse {
+    tool: Tool;
+}
+/**
+ * Response for tool deletion
+ */
+export interface ToolDeleteResponse {
+    deleted: boolean;
+}
+/**
+ * Real-time execution result (returned by execute/test endpoints)
+ * Different from ToolExecution which is a stored history record
+ */
+export interface ExecuteResult {
+    /** Whether the execution succeeded */
+    success: boolean;
+    /** The tool's output data */
+    data: unknown;
+    /** Execution time in milliseconds */
+    latencyMs: number;
+    /** OpenTelemetry trace ID */
+    traceId: string;
+    /** Execution record ID */
+    executionId: string;
+    /** Error message if execution failed */
+    error?: string;
+}
+/**
+ * Response for tool execution
+ * @deprecated Use ExecuteResult for real-time execution
+ */
+export interface ToolExecutionResponse {
+    execution: ToolExecution;
+}
+/**
+ * Response for listing executions
+ */
+export interface ExecutionListResponse {
+    data: ToolExecution[];
+    total: number;
+    page: number;
+    limit: number;
+    pagination: {
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+/**
+ * Tool category (tag) with counts
+ */
+export interface ToolCategory {
+    /** Tag name */
+    tag: string;
+    /** Total count of tools with this tag */
+    count: number;
+    /** Count of enabled tools with this tag */
+    enabled: number;
+}
+/**
+ * Uncategorized tools count
+ */
+export interface UncategorizedCount {
+    /** Total count of tools without tags */
+    count: number;
+    /** Count of enabled tools without tags */
+    enabled: number;
+}
+/**
+ * Response for tool categories
+ */
+export interface ToolCategoriesResponse {
+    /** List of categories (tags) with counts */
+    categories: ToolCategory[];
+    /** Count of uncategorized tools */
+    uncategorized: UncategorizedCount;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/types/tools.d.ts.map

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

package/dist/types/tools.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Tool Types for @chanl-ai/sdk
+ *
+ * TDD Phase: RED - These types define the contract for ToolsModule
+ * Based on chanl-api/src/tools/ schemas and DTOs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/types/toolsets.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Toolset Types for @chanl-ai/sdk
+ *
+ * Based on chanl-api/src/tools/dto/toolset-*.dto.ts and schemas/toolset.schema.ts
+ */
+/**
+ * Toolset entity representing a collection of MCP tools
+ */
+export interface Toolset {
+    /** Toolset ID */
+    id: string;
+    /** Workspace ID this toolset belongs to */
+    workspaceId: string;
+    /** Unique name for the toolset */
+    name: string;
+    /** Description of the toolset purpose */
+    description: string;
+    /** Array of tool IDs in this toolset */
+    tools: string[];
+    /** Tool count in this toolset */
+    toolCount: number;
+    /** Custom tool name/description overrides */
+    toolOverrides?: Record<string, {
+        name?: string;
+        description?: string;
+    }>;
+    /** Whether the toolset is enabled */
+    enabled: boolean;
+    /** Whether the toolset is publicly visible */
+    isPublic: boolean;
+    /** Registry ID for MCP registry publishing */
+    registryId?: string;
+    /** Version string */
+    version: string;
+    /** Tags for categorizing toolsets */
+    tags?: string[];
+    /** User ID who created the toolset */
+    createdBy: string;
+    /** User ID who last modified the toolset */
+    updatedBy?: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Input for creating a new toolset
+ */
+export interface CreateToolsetInput {
+    /** Unique name for the toolset within the workspace */
+    name: string;
+    /** Description of the toolset purpose */
+    description: string;
+    /** Array of tool IDs to include in this toolset */
+    tools?: string[];
+    /** Whether the toolset is enabled (default: true) */
+    enabled?: boolean;
+    /** Whether the toolset is publicly visible (default: false) */
+    isPublic?: boolean;
+    /** Registry ID for MCP registry publishing */
+    registryId?: string;
+    /** Version string for the toolset (default: '1.0.0') */
+    version?: string;
+    /** Tags for categorizing toolsets */
+    tags?: string[];
+}
+/**
+ * Input for updating an existing toolset
+ */
+export interface UpdateToolsetInput {
+    /** Updated name */
+    name?: string;
+    /** Updated description */
+    description?: string;
+    /** Updated tool IDs */
+    tools?: string[];
+    /** Updated enabled status */
+    enabled?: boolean;
+    /** Updated public visibility */
+    isPublic?: boolean;
+    /** Updated registry ID */
+    registryId?: string;
+    /** Updated version */
+    version?: string;
+    /** Updated tags */
+    tags?: string[];
+}
+/**
+ * Filters for listing toolsets
+ */
+export interface ToolsetFilters {
+    /** Search by toolset name or description */
+    search?: string;
+    /** Filter by enabled status */
+    enabled?: boolean;
+    /** Filter by public visibility */
+    isPublic?: boolean;
+    /** Filter by tag */
+    tag?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Number of items per page (default: 20) */
+    limit?: number;
+}
+/**
+ * Input for managing tools in a toolset
+ */
+export interface ManageToolsInput {
+    /** Tool IDs to add */
+    add?: string[];
+    /** Tool IDs to remove */
+    remove?: string[];
+}
+/**
+ * Tool override configuration
+ */
+export interface ToolOverride {
+    /** Custom tool name */
+    name?: string;
+    /** Custom tool description */
+    description?: string;
+}
+/**
+ * Response for listing toolsets
+ */
+export interface ToolsetListResponse {
+    /** Array of toolsets (API returns this as 'data') */
+    data: Toolset[];
+    total: number;
+    pagination?: {
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNext: boolean;
+        hasPrev: boolean;
+    };
+}
+/**
+ * Response for single toolset operations
+ * Note: API returns toolset directly in data, not nested as { toolset: ... }
+ */
+export type ToolsetResponse = Toolset;
+/**
+ * Response for toolset deletion
+ */
+export interface ToolsetDeleteResponse {
+    deleted: boolean;
+}
+//# sourceMappingURL=toolsets.d.ts.map

package/dist/types/toolsets.d.ts.map

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

package/dist/types/toolsets.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Toolset Types for @chanl-ai/sdk
+ *
+ * Based on chanl-api/src/tools/dto/toolset-*.dto.ts and schemas/toolset.schema.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=toolsets.js.map

package/dist/types/toolsets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolsets.js","sourceRoot":"","sources":["../../src/types/toolsets.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@chanl-ai/sdk",
+  "version": "2.0.1",
+  "description": "TypeScript SDK for Chanl AI platform — agents, tools, scenarios, knowledge, memory, and more",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "prebuild": "npm run clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/**/*.ts",
+    "format": "prettier --write src/**/*.ts"
+  },
+  "keywords": [
+    "chanl",
+    "ai-agents",
+    "api",
+    "sdk",
+    "typescript",
+    "call-analytics",
+    "mcp",
+    "scenarios",
+    "knowledge-base"
+  ],
+  "author": "Chanl AI",
+  "license": "MIT",
+  "dependencies": {
+    "form-data": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.3.1",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.42.0",
+    "prettier": "^3.0.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.1.3",
+    "vitest": "^2.1.8"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chanl-ai/chanl-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/chanl-ai/chanl-sdk/issues"
+  },
+  "homepage": "https://github.com/chanl-ai/chanl-sdk#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}