@chanl-ai/sdk 2.0.1

package/dist/modules/scorecard.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * ScorecardModule - SDK module for scorecard management and evaluation
+ *
+ * Provides operations for:
+ * - Scorecard CRUD operations
+ * - Category and criteria management
+ * - Evaluation and results retrieval
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScorecardModule = void 0;
+// ==================== Module Implementation ====================
+class ScorecardModule {
+    constructor(sdk) {
+        this.sdk = sdk;
+    }
+    // ==================== Scorecard CRUD ====================
+    /**
+     * List all scorecards with optional filters
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.list();
+     * console.log(data.scorecards);
+     *
+     * // Filter by status
+     * const { data } = await sdk.scorecards.list({ status: 'active' });
+     * ```
+     */
+    async list(filters) {
+        const queryParams = new URLSearchParams();
+        if (filters?.status)
+            queryParams.append('status', filters.status);
+        if (filters?.industry)
+            queryParams.append('industry', filters.industry);
+        if (filters?.useCase)
+            queryParams.append('useCase', filters.useCase);
+        if (filters?.tags)
+            queryParams.append('tags', filters.tags.join(','));
+        if (filters?.page)
+            queryParams.append('page', filters.page.toString());
+        if (filters?.limit)
+            queryParams.append('limit', filters.limit.toString());
+        if (filters?.sortBy)
+            queryParams.append('sortBy', filters.sortBy);
+        if (filters?.sortOrder)
+            queryParams.append('sortOrder', filters.sortOrder);
+        const url = `/api/v1/scorecards${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.sdk.request('GET', url);
+    }
+    /**
+     * Get a scorecard by ID
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.get('scorecard_abc');
+     * console.log(data.name, data.status);
+     * ```
+     */
+    async get(id) {
+        return this.sdk.request('GET', `/api/v1/scorecards/${id}`);
+    }
+    /**
+     * Create a new scorecard
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.create({
+     *   name: 'Customer Service Quality',
+     *   description: 'Evaluate customer service call quality',
+     *   status: 'active',
+     *   passingThreshold: 70,
+     *   scoringAlgorithm: 'weighted_average'
+     * });
+     * ```
+     */
+    async create(data) {
+        return this.sdk.request('POST', '/api/v1/scorecards', data);
+    }
+    /**
+     * Update a scorecard
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.update('scorecard_abc', {
+     *   name: 'Updated Name',
+     *   status: 'inactive'
+     * });
+     * ```
+     */
+    async update(id, data) {
+        return this.sdk.request('PUT', `/api/v1/scorecards/${id}`, data);
+    }
+    /**
+     * Delete a scorecard
+     *
+     * @example
+     * ```typescript
+     * await sdk.scorecards.delete('scorecard_abc');
+     * ```
+     */
+    async delete(id) {
+        return this.sdk.request('DELETE', `/api/v1/scorecards/${id}`);
+    }
+    // ==================== Category Operations ====================
+    /**
+     * List categories for a scorecard
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.listCategories('ws_123', 'scorecard_abc');
+     * console.log(data.categories);
+     * ```
+     */
+    async listCategories(scorecardId) {
+        return this.sdk.request('GET', `/api/v1/scorecards/${scorecardId}/categories`);
+    }
+    /**
+     * Get a category by ID
+     */
+    async getCategory(scorecardId, categoryId) {
+        return this.sdk.request('GET', `/api/v1/scorecards/${scorecardId}/categories/${categoryId}`);
+    }
+    /**
+     * Create a category for a scorecard
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.createCategory('ws_123', 'scorecard_abc', {
+     *   name: 'Greeting',
+     *   description: 'Opening greeting quality',
+     *   weight: 20
+     * });
+     * ```
+     */
+    async createCategory(scorecardId, data) {
+        return this.sdk.request('POST', `/api/v1/scorecards/${scorecardId}/categories`, data);
+    }
+    /**
+     * Update a category
+     */
+    async updateCategory(scorecardId, categoryId, data) {
+        return this.sdk.request('PUT', `/api/v1/scorecards/${scorecardId}/categories/${categoryId}`, data);
+    }
+    /**
+     * Delete a category
+     */
+    async deleteCategory(scorecardId, categoryId) {
+        return this.sdk.request('DELETE', `/api/v1/scorecards/${scorecardId}/categories/${categoryId}`);
+    }
+    // ==================== Criteria Operations ====================
+    /**
+     * List criteria for a scorecard
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.listCriteria('ws_123', 'scorecard_abc');
+     * console.log(data.criteria);
+     * ```
+     */
+    async listCriteria(scorecardId) {
+        return this.sdk.request('GET', `/api/v1/scorecards/${scorecardId}/criteria`);
+    }
+    /**
+     * Get a criterion by ID
+     */
+    async getCriterion(scorecardId, criterionId) {
+        return this.sdk.request('GET', `/api/v1/scorecards/${scorecardId}/criteria/${criterionId}`);
+    }
+    /**
+     * Create a criterion for a scorecard
+     *
+     * @example
+     * ```typescript
+     * // Prompt-based criterion
+     * const { data } = await sdk.scorecards.createCriterion('ws_123', 'scorecard_abc', {
+     *   key: 'proper_greeting',
+     *   name: 'Proper Greeting',
+     *   type: 'prompt',
+     *   settings: {
+     *     description: 'Agent greeted customer properly with name and company',
+     *     evaluationType: 'boolean'
+     *   },
+     *   threshold: { expectedValue: true }
+     * });
+     *
+     * // Keyword-based criterion
+     * const { data } = await sdk.scorecards.createCriterion('ws_123', 'scorecard_abc', {
+     *   key: 'thank_you',
+     *   name: 'Said Thank You',
+     *   type: 'keyword',
+     *   settings: {
+     *     matchType: 'must_contain',
+     *     keyword: ['thank you', 'thanks']
+     *   }
+     * });
+     * ```
+     */
+    async createCriterion(scorecardId, data) {
+        return this.sdk.request('POST', `/api/v1/scorecards/${scorecardId}/criteria`, data);
+    }
+    /**
+     * Update a criterion
+     */
+    async updateCriterion(scorecardId, criterionId, data) {
+        return this.sdk.request('PATCH', `/api/v1/scorecards/${scorecardId}/criteria/${criterionId}`, data);
+    }
+    /**
+     * Delete a criterion
+     */
+    async deleteCriterion(scorecardId, criterionId) {
+        return this.sdk.request('DELETE', `/api/v1/scorecards/${scorecardId}/criteria/${criterionId}`);
+    }
+    // ==================== Evaluation & Results ====================
+    /**
+     * Evaluate a call with a scorecard
+     *
+     * @example
+     * ```typescript
+     * // Evaluate with auto-selected scorecard
+     * const { data } = await sdk.scorecards.evaluate('call_abc');
+     *
+     * // Evaluate with specific scorecard
+     * const { data } = await sdk.scorecards.evaluate('call_abc', {
+     *   scorecardId: 'scorecard_xyz',
+     *   force: true  // Re-evaluate even if already evaluated
+     * });
+     * ```
+     */
+    async evaluate(callId, options) {
+        return this.sdk.request('POST', `/api/v1/scorecard-results/evaluate/${callId}`, options || {});
+    }
+    /**
+     * List evaluation results
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.listResults('ws_123', {
+     *   scorecardId: 'scorecard_abc',
+     *   status: 'completed'
+     * });
+     * ```
+     */
+    async listResults(filters) {
+        const queryParams = new URLSearchParams();
+        if (filters?.scorecardId)
+            queryParams.append('scorecardId', filters.scorecardId);
+        if (filters?.callId)
+            queryParams.append('callId', filters.callId);
+        if (filters?.status)
+            queryParams.append('status', filters.status);
+        if (filters?.page)
+            queryParams.append('page', filters.page.toString());
+        if (filters?.limit)
+            queryParams.append('limit', filters.limit.toString());
+        if (filters?.sortBy)
+            queryParams.append('sortBy', filters.sortBy);
+        if (filters?.sortOrder)
+            queryParams.append('sortOrder', filters.sortOrder);
+        const url = `/api/v1/scorecard-results${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.sdk.request('GET', url);
+    }
+    /**
+     * Get a result by ID
+     */
+    async getResult(resultId) {
+        return this.sdk.request('GET', `/api/v1/scorecard-results/${resultId}`);
+    }
+    /**
+     * Get results for a call
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.scorecards.getResultsByCall('ws_123', 'call_abc');
+     * for (const result of data.results) {
+     *   console.log('Score:', result.overallScore);
+     * }
+     * ```
+     */
+    async getResultsByCall(callId) {
+        return this.sdk.request('GET', `/api/v1/scorecard-results/by-call/${callId}`);
+    }
+    /**
+     * Get populated result (with scorecard details) for a call
+     */
+    async getPopulatedResultsByCall(callId) {
+        return this.sdk.request('GET', `/api/v1/scorecard-results/by-call/${callId}/populated`);
+    }
+    /**
+     * Delete a result
+     */
+    async deleteResult(resultId) {
+        return this.sdk.request('DELETE', `/api/v1/scorecard-results/${resultId}`);
+    }
+    // ==================== Legacy Methods (deprecated) ====================
+    /**
+     * @deprecated Use list() instead
+     */
+    async getAll(params) {
+        const response = await this.list(params);
+        // Transform to match old response format
+        return {
+            ...response,
+            data: response.data?.scorecards || [],
+        };
+    }
+    /**
+     * @deprecated Use get() instead
+     */
+    async getById(id) {
+        return this.get(id);
+    }
+    /**
+     * @deprecated Use getResultsByCall() instead
+     */
+    async getEvaluationById(id) {
+        return this.getResult(id);
+    }
+    /**
+     * @deprecated Extraction is now part of CallsModule
+     */
+    async extractData(_data) {
+        throw new Error('extractData is deprecated. Use CallsModule.import() with customExtractions instead.');
+    }
+}
+exports.ScorecardModule = ScorecardModule;
+//# sourceMappingURL=scorecard.js.map

package/dist/modules/scorecard.js.map

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

package/dist/modules/tools.d.ts

@@ -0,0 +1,222 @@
+/**
+ * ToolsModule - SDK module for MCP tool management and execution
+ *
+ * TDD Phase: GREEN - Implementation to make tests pass
+ *
+ * Provides CRUD operations for tools and execution capabilities.
+ * Supports both JWT auth (admin UI) and MCP API key auth.
+ */
+import { ChanlSDK } from '../client';
+import { ApiResponse } from '../types/config';
+import type { ExecuteResult, CreateToolInput, UpdateToolInput, ToolFilters, ExecutionFilters, ToolListResponse, ToolResponse, ToolDeleteResponse, ExecutionListResponse, ToolCategoriesResponse } from '../types/tools';
+export declare class ToolsModule {
+    private sdk;
+    constructor(sdk: ChanlSDK);
+    /**
+     * List all tools with optional filters
+     *
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of tools
+     *
+     * @example
+     * ```typescript
+     * // List all tools
+     * const { data } = await sdk.tools.list();
+     *
+     * // Filter by type and status
+     * const { data } = await sdk.tools.list({
+     *   type: 'http',
+     *   isEnabled: true,
+     *   page: 1,
+     *   limit: 10
+     * });
+     *
+     * // Exclude system tools (kb_search, chanl_reason, etc.)
+     * const { data } = await sdk.tools.list({
+     *   includeSystem: false
+     * });
+     * ```
+     */
+    list(filters?: ToolFilters): Promise<ApiResponse<ToolListResponse>>;
+    /**
+     * Get a single tool by ID
+     *
+     * @param id - Tool ID
+     * @returns Tool details
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.get('tool_abc123');
+     * console.log(data.tool.name);
+     * ```
+     */
+    get(id: string): Promise<ApiResponse<ToolResponse>>;
+    /**
+     * Create a new tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param input - Tool creation data
+     * @returns Created tool
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if tool name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.create({
+     *   name: 'get_weather',
+     *   description: 'Get weather for a city',
+     *   type: 'http',
+     *   inputSchema: {
+     *     type: 'object',
+     *     properties: { city: { type: 'string' } },
+     *     required: ['city']
+     *   },
+     *   configuration: {
+     *     http: { method: 'GET', url: 'https://wttr.in/{{city}}' }
+     *   }
+     * });
+     * ```
+     */
+    create(input: CreateToolInput): Promise<ApiResponse<ToolResponse>>;
+    /**
+     * Update an existing tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param input - Update data
+     * @returns Updated tool
+     * @throws NotFoundError if tool doesn't exist
+     * @throws ValidationError if input is invalid
+     * @throws ConflictError if new name already exists
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.update('tool_abc123', {
+     *   description: 'Updated description',
+     *   isEnabled: false
+     * });
+     * ```
+     */
+    update(id: string, input: UpdateToolInput): Promise<ApiResponse<ToolResponse>>;
+    /**
+     * Delete a tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @returns Deletion confirmation
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.delete('tool_abc123');
+     * console.log(data.deleted); // true
+     * ```
+     */
+    delete(id: string): Promise<ApiResponse<ToolDeleteResponse>>;
+    /**
+     * Execute a tool with given arguments
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param args - Arguments to pass to the tool
+     * @returns Execution result
+     * @throws NotFoundError if tool doesn't exist
+     * @throws ValidationError if args don't match input schema
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.execute('tool_abc123', {
+     *   city: 'London',
+     *   units: 'celsius'
+     * });
+     * console.log(data.output); // { temperature: 12, ... }
+     * ```
+     */
+    execute(id: string, args: Record<string, unknown>): Promise<ApiResponse<ExecuteResult>>;
+    /**
+     * Test a tool execution (same as execute but for testing in admin UI)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param args - Arguments to pass to the tool
+     * @returns Execution result
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.test('tool_abc123', {
+     *   city: 'London'
+     * });
+     * ```
+     */
+    test(id: string, args: Record<string, unknown>): Promise<ApiResponse<ExecuteResult>>;
+    /**
+     * Get execution history for a tool
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @param filters - Optional filters for the query
+     * @returns Paginated list of executions
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // Get all executions
+     * const { data } = await sdk.tools.getExecutions('ws_123', 'tool_abc123');
+     *
+     * // Filter by status and date range
+     * const { data } = await sdk.tools.getExecutions('ws_123', 'tool_abc123', {
+     *   status: 'completed',
+     *   fromDate: '2025-01-01',
+     *   toDate: '2025-01-31'
+     * });
+     * ```
+     */
+    getExecutions(id: string, filters?: ExecutionFilters): Promise<ApiResponse<ExecutionListResponse>>;
+    /**
+     * Enable a tool (shortcut for setting isEnabled=true)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @returns Updated tool
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.enable('tool_abc123');
+     * console.log(data.tool.isEnabled); // true
+     * ```
+     */
+    enable(id: string): Promise<ApiResponse<ToolResponse>>;
+    /**
+     * Disable a tool (shortcut for setting isEnabled=false)
+     *
+     * @param workspaceId - Workspace ID
+     * @param id - Tool ID
+     * @returns Updated tool
+     * @throws NotFoundError if tool doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.disable('tool_abc123');
+     * console.log(data.tool.isEnabled); // false
+     * ```
+     */
+    disable(id: string): Promise<ApiResponse<ToolResponse>>;
+    /**
+     * Get tool categories (aggregated tags with counts)
+     *
+     * @param workspaceId - Workspace ID
+     * @returns List of categories with counts
+     *
+     * @example
+     * ```typescript
+     * const { data } = await sdk.tools.getCategories('ws_123');
+     * console.log(data.categories);
+     * // [{ name: 'weather', count: 5, enabledCount: 3 }, ...]
+     * ```
+     */
+    getCategories(): Promise<ApiResponse<ToolCategoriesResponse>>;
+}
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/modules/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,gBAAgB,CAAC;AAMxB,qBAAa,WAAW;IACV,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,QAAQ;IAEjC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAmCzE;;;;;;;;;;;;OAYG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAIzD;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAIxE;;;;;;;;;;;;;;;;;;OAkBG;IACG,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAIrC;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAIlE;;;;;;;;;;;;;;;;;;OAkBG;IACG,OAAO,CACX,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAMtC;;;;;;;;;;;;;;;OAeG;IACG,IAAI,CACR,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAMtC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACG,aAAa,CACjB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;IA0B9C;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAI5D;;;;;;;;;;;;;OAaG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAI7D;;;;;;;;;;;;OAYG;IACG,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;CAGpE"}