@protoboxai/sdk 1.0.0 → 1.0.1

package/README.md

@@ -1,8 +1,6 @@
 # @protoboxai/sdk
 
-Public TypeScript SDK for [Protobox](https://protobox.app) — managed MCP servers, tools, agents, knowledge resources, prompts, and chat.
-
-Forked from [`@chanl/sdk`](https://www.npmjs.com/package/@chanl/sdk) (source: `../chanl-v2/chanl-sdk`). Same API surface; Protobox-branded package for npm publish.
+Public TypeScript SDK for [Protobox](https://protobox.ai) — managed MCP servers: tools, toolsets, knowledge, prompts, workspaces, and chat.
 
 ## Install
 

package/dist/adapters/openai.d.ts

@@ -1,13 +1,13 @@
 /**
- * OpenAI Adapter for @chanl/sdk
+ * OpenAI Adapter for @protoboxai/sdk
  *
  * TDD Phase: GREEN - Implementation to make tests pass
  *
  * Provides integration with OpenAI's function calling format:
- * 1. Convert Chanl tools to OpenAI ChatCompletionTool format
+ * 1. Convert Protobox tools to OpenAI ChatCompletionTool format
  * 2. Execute tool calls from OpenAI responses
  */
-import { ChanlSDK } from '../client';
+import { ProtoboxSDK } from '../client';
 /**
  * OpenAI function definition
  */
@@ -51,7 +51,7 @@ export interface GetToolsOptions {
     tag?: string;
 }
 /**
- * Adapter to integrate Chanl tools with OpenAI's function calling
+ * Adapter to integrate Protobox tools with OpenAI's function calling
  *
  * @example
  * ```typescript
@@ -79,9 +79,9 @@ export declare class OpenAIAdapter {
     private sdk;
     /** Cached tools for lookup during execution */
     private toolsCache;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
-     * Convert Chanl tools to OpenAI function calling format
+     * Convert Protobox tools to OpenAI function calling format
      *
      * @param options - Optional filters for which tools to include
      * @returns Array of OpenAI ChatCompletionTool objects
@@ -95,7 +95,7 @@ export declare class OpenAIAdapter {
      */
     executeToolCalls(toolCalls: OpenAIToolCall[]): Promise<ToolOutput[]>;
     /**
-     * Convert a single Chanl tool to OpenAI function format
+     * Convert a single Protobox tool to OpenAI function format
      */
     private convertToolToOpenAI;
     /**

package/dist/adapters/openai.js

@@ -1,17 +1,17 @@
 "use strict";
 /**
- * OpenAI Adapter for @chanl/sdk
+ * OpenAI Adapter for @protoboxai/sdk
  *
  * TDD Phase: GREEN - Implementation to make tests pass
  *
  * Provides integration with OpenAI's function calling format:
- * 1. Convert Chanl tools to OpenAI ChatCompletionTool format
+ * 1. Convert Protobox tools to OpenAI ChatCompletionTool format
  * 2. Execute tool calls from OpenAI responses
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenAIAdapter = void 0;
 /**
- * Adapter to integrate Chanl tools with OpenAI's function calling
+ * Adapter to integrate Protobox tools with OpenAI's function calling
  *
  * @example
  * ```typescript
@@ -42,7 +42,7 @@ class OpenAIAdapter {
         this.toolsCache = new Map();
     }
     /**
-     * Convert Chanl tools to OpenAI function calling format
+     * Convert Protobox tools to OpenAI function calling format
      *
      * @param options - Optional filters for which tools to include
      * @returns Array of OpenAI ChatCompletionTool objects
@@ -55,15 +55,15 @@ class OpenAIAdapter {
             filters.tag = options.tag;
         }
         const response = await this.sdk.tools.list(filters);
-        if (!response.success || !response.data?.tools) {
+        if (!response.success || !response.data?.items) {
             return [];
         }
         // Cache tools for later execution
         this.toolsCache.clear();
-        for (const tool of response.data.tools) {
+        for (const tool of response.data.items) {
             this.toolsCache.set(tool.name, tool);
         }
-        return response.data.tools.map((tool) => this.convertToolToOpenAI(tool));
+        return response.data.items.map((tool) => this.convertToolToOpenAI(tool));
     }
     /**
      * Execute tool calls from an OpenAI response
@@ -87,7 +87,7 @@ class OpenAIAdapter {
         return results;
     }
     /**
-     * Convert a single Chanl tool to OpenAI function format
+     * Convert a single Protobox tool to OpenAI function format
      */
     convertToolToOpenAI(tool) {
         return {

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { ChanlConfig, RequestConfig, ApiResponse } from "./types/config";
+import { ProtoboxConfig, RequestConfig, ApiResponse } from "./types/config";
 import { WorkspaceModule } from "./modules/workspace";
 import { AuthModule } from "./modules/auth";
 import { HealthModule } from "./modules/health";
@@ -8,7 +8,7 @@ import { ToolsetsModule } from "./modules/toolsets";
 import { McpModule } from "./modules/mcp";
 import { KnowledgeModule } from "./modules/knowledge";
 import { ChatModule } from "./modules/chat";
-export declare class ChanlSDK {
+export declare class ProtoboxSDK {
     private config;
     readonly workspace: WorkspaceModule;
     readonly auth: AuthModule;
@@ -19,7 +19,7 @@ export declare class ChanlSDK {
     readonly mcp: McpModule;
     readonly knowledge: KnowledgeModule;
     readonly chat: ChatModule;
-    constructor(config: ChanlConfig);
+    constructor(config: ProtoboxConfig);
     /**
      * Make a request to the API
      */
@@ -41,6 +41,21 @@ export declare class ChanlSDK {
      * Skips if id already exists to avoid overwriting.
      */
     private normalizeIds;
+    /**
+     * Collapse any list-shaped response into the canonical { items, total, pagination }.
+     *
+     * The platform API is internally inconsistent about PAGINATED list envelopes
+     * (`/tools` → { tools, total }, `/toolsets` → { items, pagination },
+     * executions → { executions, total, pagination }). This collapses all of them
+     * to ONE shape so the CLI/SDK never branch per endpoint.
+     *
+     * SCOPE: only objects with a recognized collection array AND a `total`/`pagination`
+     * sibling qualify. Bare arrays (workspaces, api keys, prompt versions, kb chunks)
+     * are left as-is — those endpoints are already uniform and have consumers that
+     * iterate the array directly. Single entities that merely contain an array
+     * (e.g. a toolset's `tools`) lack the total/pagination sibling, so they pass through.
+     */
+    private canonicalizeListData;
     /**
      * Update authentication credentials
      */
@@ -51,7 +66,7 @@ export declare class ChanlSDK {
     /**
      * Get current configuration
      */
-    getConfig(): ChanlConfig;
+    getConfig(): ProtoboxConfig;
     /**
      * Enable/disable debug logging
      */

package/dist/client.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChanlSDK = void 0;
+exports.ProtoboxSDK = void 0;
 const workspace_1 = require("./modules/workspace");
 const auth_1 = require("./modules/auth");
 const health_1 = require("./modules/health");
@@ -10,13 +10,13 @@ const toolsets_1 = require("./modules/toolsets");
 const mcp_1 = require("./modules/mcp");
 const knowledge_1 = require("./modules/knowledge");
 const chat_1 = require("./modules/chat");
-class ChanlSDK {
+class ProtoboxSDK {
     constructor(config) {
         const server = config.server;
         const baseUrl = config.baseUrl ||
             (typeof server === 'string' && server.length > 0 ? server : '');
         if (!baseUrl) {
-            throw new Error('ChanlSDK: baseUrl or server is required');
+            throw new Error('ProtoboxSDK: baseUrl or server is required');
         }
         this.config = {
             timeout: 30000,
@@ -189,6 +189,12 @@ class ChanlSDK {
                     }
                 }
             }
+            // Canonicalize list envelopes LAST so EVERY list endpoint returns the same
+            // { items, total, pagination } shape regardless of what the API called the
+            // collection ({ tools, total } / { items, pagination } / a bare array / …).
+            if (normalized.data !== undefined) {
+                normalized.data = this.canonicalizeListData(normalized.data);
+            }
             return normalized;
         }
         catch (error) {
@@ -277,6 +283,59 @@ class ChanlSDK {
         }
         return result;
     }
+    /**
+     * Collapse any list-shaped response into the canonical { items, total, pagination }.
+     *
+     * The platform API is internally inconsistent about PAGINATED list envelopes
+     * (`/tools` → { tools, total }, `/toolsets` → { items, pagination },
+     * executions → { executions, total, pagination }). This collapses all of them
+     * to ONE shape so the CLI/SDK never branch per endpoint.
+     *
+     * SCOPE: only objects with a recognized collection array AND a `total`/`pagination`
+     * sibling qualify. Bare arrays (workspaces, api keys, prompt versions, kb chunks)
+     * are left as-is — those endpoints are already uniform and have consumers that
+     * iterate the array directly. Single entities that merely contain an array
+     * (e.g. a toolset's `tools`) lack the total/pagination sibling, so they pass through.
+     */
+    canonicalizeListData(data) {
+        if (data === null || typeof data !== 'object' || Array.isArray(data))
+            return data;
+        const COLLECTION_KEYS = [
+            'items', 'data', 'tools', 'toolsets', 'executions',
+            'prompts', 'documents', 'workspaces', 'results', 'knowledge',
+        ];
+        const buildMeta = (total, page, limit) => {
+            const safeLimit = limit > 0 ? limit : (total || 1);
+            const totalPages = safeLimit > 0 ? Math.max(1, Math.ceil(total / safeLimit)) : 1;
+            return {
+                page,
+                limit: safeLimit,
+                total,
+                totalPages,
+                hasNext: page < totalPages,
+                hasPrev: page > 1,
+            };
+        };
+        const obj = data;
+        const arrayKey = COLLECTION_KEYS.find((k) => Array.isArray(obj[k]));
+        const pag = (obj['pagination'] && typeof obj['pagination'] === 'object')
+            ? obj['pagination']
+            : undefined;
+        const hasTotal = typeof obj['total'] === 'number';
+        // Require a collection array PLUS a total/pagination sibling to qualify as a list.
+        if (!arrayKey || (!hasTotal && !pag))
+            return data;
+        const items = obj[arrayKey];
+        const total = (hasTotal ? obj['total'] : undefined)
+            ?? (typeof pag?.['total'] === 'number' ? pag['total'] : undefined)
+            ?? items.length;
+        const page = typeof pag?.['page'] === 'number' ? pag['page'] : 1;
+        const limit = typeof pag?.['limit'] === 'number' ? pag['limit'] : (items.length || total || 1);
+        const base = buildMeta(total, page, limit);
+        // Keep any explicit pagination fields the API provided; force total consistent.
+        const pagination = pag ? { ...base, ...pag, total } : base;
+        return { items, total, pagination };
+    }
     /**
      * Update authentication credentials
      */
@@ -303,5 +362,5 @@ class ChanlSDK {
         this.config.debug = enabled;
     }
 }
-exports.ChanlSDK = ChanlSDK;
+exports.ProtoboxSDK = ProtoboxSDK;
 //# sourceMappingURL=client.js.map

package/dist/errors/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Custom Error Classes for @chanl/sdk
+ * Custom Error Classes for @protoboxai/sdk
  *
  * TDD Phase: RED - These errors define the error handling contract
  *
@@ -9,10 +9,10 @@
  * - Serializable details: Allow JSON serialization for logging
  */
 /**
- * Options type for ChanlError constructor
+ * Options type for ProtoboxError constructor
  * Uses explicit `| undefined` to be compatible with exactOptionalPropertyTypes
  */
-interface ChanlErrorOptions {
+interface ProtoboxErrorOptions {
     code?: string | undefined;
     statusCode?: number | undefined;
     details?: Record<string, unknown> | undefined;
@@ -20,9 +20,9 @@ interface ChanlErrorOptions {
     requestId?: string | undefined;
 }
 /**
- * Base error class for all Chanl SDK errors
+ * Base error class for all Protobox SDK errors
  */
-export declare class ChanlError extends Error {
+export declare class ProtoboxError extends Error {
     /** Error code for programmatic handling */
     readonly code: string;
     /** HTTP status code if from API response */
@@ -33,7 +33,7 @@ export declare class ChanlError extends Error {
     readonly cause?: Error;
     /** Request ID from API for tracing */
     readonly requestId?: string;
-    constructor(message: string, options?: ChanlErrorOptions);
+    constructor(message: string, options?: ProtoboxErrorOptions);
     /**
      * Convert error to JSON for logging/serialization
      */
@@ -42,7 +42,7 @@ export declare class ChanlError extends Error {
 /**
  * Error thrown when a requested resource is not found (404)
  */
-export declare class NotFoundError extends ChanlError {
+export declare class NotFoundError extends ProtoboxError {
     /** The type of resource that was not found */
     readonly resourceType: string;
     /** The identifier that was used to look up the resource */
@@ -55,7 +55,7 @@ export declare class NotFoundError extends ChanlError {
 /**
  * Error thrown when input validation fails (400)
  */
-export declare class ValidationError extends ChanlError {
+export declare class ValidationError extends ProtoboxError {
     /** Field-level validation errors */
     readonly fieldErrors?: Record<string, string[]>;
     constructor(message: string, options?: {
@@ -75,7 +75,7 @@ export declare class ValidationError extends ChanlError {
 /**
  * Error thrown when authentication fails (401)
  */
-export declare class AuthenticationError extends ChanlError {
+export declare class AuthenticationError extends ProtoboxError {
     constructor(message?: string, options?: {
         details?: Record<string, unknown> | undefined;
         requestId?: string | undefined;
@@ -84,7 +84,7 @@ export declare class AuthenticationError extends ChanlError {
 /**
  * Error thrown when authorization fails (403)
  */
-export declare class AuthorizationError extends ChanlError {
+export declare class AuthorizationError extends ProtoboxError {
     /** The action that was attempted */
     readonly action?: string;
     /** The resource that was being accessed */
@@ -99,7 +99,7 @@ export declare class AuthorizationError extends ChanlError {
 /**
  * Error thrown when there's a conflict (409)
  */
-export declare class ConflictError extends ChanlError {
+export declare class ConflictError extends ProtoboxError {
     /** The conflicting resource identifier */
     readonly conflictingResource?: string;
     constructor(message: string, options?: {
@@ -111,7 +111,7 @@ export declare class ConflictError extends ChanlError {
 /**
  * Error thrown when rate limit is exceeded (429)
  */
-export declare class RateLimitError extends ChanlError {
+export declare class RateLimitError extends ProtoboxError {
     /** When the rate limit resets (Unix timestamp) */
     readonly retryAfter?: number;
     constructor(message?: string, options?: {
@@ -123,7 +123,7 @@ export declare class RateLimitError extends ChanlError {
 /**
  * Error thrown when API server fails (5xx)
  */
-export declare class ServerError extends ChanlError {
+export declare class ServerError extends ProtoboxError {
     constructor(message?: string, options?: {
         statusCode?: number | undefined;
         details?: Record<string, unknown> | undefined;
@@ -133,7 +133,7 @@ export declare class ServerError extends ChanlError {
 /**
  * Error thrown for network/connection issues
  */
-export declare class NetworkError extends ChanlError {
+export declare class NetworkError extends ProtoboxError {
     constructor(message?: string, options?: {
         cause?: Error | undefined;
         details?: Record<string, unknown> | undefined;
@@ -142,7 +142,7 @@ export declare class NetworkError extends ChanlError {
 /**
  * Error thrown when request times out
  */
-export declare class TimeoutError extends ChanlError {
+export declare class TimeoutError extends ProtoboxError {
     /** Timeout duration in milliseconds */
     readonly timeoutMs?: number;
     constructor(message?: string, options?: {
@@ -152,9 +152,9 @@ export declare class TimeoutError extends ChanlError {
     });
 }
 /**
- * Type guard to check if error is a ChanlError
+ * Type guard to check if error is a ProtoboxError
  */
-export declare function isChanlError(error: unknown): error is ChanlError;
+export declare function isProtoboxError(error: unknown): error is ProtoboxError;
 /**
  * Type guard to check if error is a NotFoundError
  */
@@ -174,6 +174,6 @@ export declare function createErrorFromResponse(statusCode: number, message: str
     details?: Record<string, unknown> | undefined;
     requestId?: string | undefined;
     fieldErrors?: Record<string, string[]> | undefined;
-}): ChanlError;
+}): ProtoboxError;
 export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/errors/index.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Custom Error Classes for @chanl/sdk
+ * Custom Error Classes for @protoboxai/sdk
  *
  * TDD Phase: RED - These errors define the error handling contract
  *
@@ -10,20 +10,20 @@
  * - Serializable details: Allow JSON serialization for logging
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeoutError = exports.NetworkError = exports.ServerError = exports.RateLimitError = exports.ConflictError = exports.AuthorizationError = exports.AuthenticationError = exports.ValidationError = exports.NotFoundError = exports.ChanlError = void 0;
-exports.isChanlError = isChanlError;
+exports.TimeoutError = exports.NetworkError = exports.ServerError = exports.RateLimitError = exports.ConflictError = exports.AuthorizationError = exports.AuthenticationError = exports.ValidationError = exports.NotFoundError = exports.ProtoboxError = void 0;
+exports.isProtoboxError = isProtoboxError;
 exports.isNotFoundError = isNotFoundError;
 exports.isValidationError = isValidationError;
 exports.isAuthenticationError = isAuthenticationError;
 exports.createErrorFromResponse = createErrorFromResponse;
 /**
- * Base error class for all Chanl SDK errors
+ * Base error class for all Protobox SDK errors
  */
-class ChanlError extends Error {
+class ProtoboxError extends Error {
     constructor(message, options = {}) {
         super(message);
-        this.name = 'ChanlError';
-        this.code = options.code ?? 'CHANL_ERROR';
+        this.name = 'ProtoboxError';
+        this.code = options.code ?? 'PROTOBOX_ERROR';
         // Only assign optional properties when defined (exactOptionalPropertyTypes)
         if (options.statusCode !== undefined) {
             this.statusCode = options.statusCode;
@@ -57,11 +57,11 @@ class ChanlError extends Error {
         };
     }
 }
-exports.ChanlError = ChanlError;
+exports.ProtoboxError = ProtoboxError;
 /**
  * Error thrown when a requested resource is not found (404)
  */
-class NotFoundError extends ChanlError {
+class NotFoundError extends ProtoboxError {
     constructor(resourceType, resourceId, options = {}) {
         const details = {
             resourceType,
@@ -83,7 +83,7 @@ exports.NotFoundError = NotFoundError;
 /**
  * Error thrown when input validation fails (400)
  */
-class ValidationError extends ChanlError {
+class ValidationError extends ProtoboxError {
     constructor(message, options = {}) {
         const details = {
             ...options.details,
@@ -119,7 +119,7 @@ exports.ValidationError = ValidationError;
 /**
  * Error thrown when authentication fails (401)
  */
-class AuthenticationError extends ChanlError {
+class AuthenticationError extends ProtoboxError {
     constructor(message = 'Authentication required', options = {}) {
         super(message, {
             code: 'AUTHENTICATION_ERROR',
@@ -134,7 +134,7 @@ exports.AuthenticationError = AuthenticationError;
 /**
  * Error thrown when authorization fails (403)
  */
-class AuthorizationError extends ChanlError {
+class AuthorizationError extends ProtoboxError {
     constructor(message = 'Permission denied', options = {}) {
         const details = {
             ...options.details,
@@ -164,7 +164,7 @@ exports.AuthorizationError = AuthorizationError;
 /**
  * Error thrown when there's a conflict (409)
  */
-class ConflictError extends ChanlError {
+class ConflictError extends ProtoboxError {
     constructor(message, options = {}) {
         const details = {
             ...options.details,
@@ -188,7 +188,7 @@ exports.ConflictError = ConflictError;
 /**
  * Error thrown when rate limit is exceeded (429)
  */
-class RateLimitError extends ChanlError {
+class RateLimitError extends ProtoboxError {
     constructor(message = 'Rate limit exceeded', options = {}) {
         const details = {
             ...options.details,
@@ -212,7 +212,7 @@ exports.RateLimitError = RateLimitError;
 /**
  * Error thrown when API server fails (5xx)
  */
-class ServerError extends ChanlError {
+class ServerError extends ProtoboxError {
     constructor(message = 'Internal server error', options = {}) {
         super(message, {
             code: 'SERVER_ERROR',
@@ -227,7 +227,7 @@ exports.ServerError = ServerError;
 /**
  * Error thrown for network/connection issues
  */
-class NetworkError extends ChanlError {
+class NetworkError extends ProtoboxError {
     constructor(message = 'Network error', options = {}) {
         super(message, {
             code: 'NETWORK_ERROR',
@@ -241,7 +241,7 @@ exports.NetworkError = NetworkError;
 /**
  * Error thrown when request times out
  */
-class TimeoutError extends ChanlError {
+class TimeoutError extends ProtoboxError {
     constructor(message = 'Request timeout', options = {}) {
         const details = {
             ...options.details,
@@ -262,10 +262,10 @@ class TimeoutError extends ChanlError {
 }
 exports.TimeoutError = TimeoutError;
 /**
- * Type guard to check if error is a ChanlError
+ * Type guard to check if error is a ProtoboxError
  */
-function isChanlError(error) {
-    return error instanceof ChanlError;
+function isProtoboxError(error) {
+    return error instanceof ProtoboxError;
 }
 /**
  * Type guard to check if error is a NotFoundError
@@ -298,8 +298,8 @@ function createErrorFromResponse(statusCode, message, options = {}) {
             return new AuthorizationError(message, options);
         case 404:
             // For 404, we need resourceType and resourceId which aren't in options
-            // Return a generic ChanlError instead
-            return new ChanlError(message, {
+            // Return a generic ProtoboxError instead
+            return new ProtoboxError(message, {
                 code: 'NOT_FOUND',
                 statusCode: 404,
                 details: options.details,
@@ -313,7 +313,7 @@ function createErrorFromResponse(statusCode, message, options = {}) {
             if (statusCode >= 500) {
                 return new ServerError(message, { statusCode, ...options });
             }
-            return new ChanlError(message, { statusCode, ...options });
+            return new ProtoboxError(message, { statusCode, ...options });
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export { ChanlSDK, ChanlSDK as Chanl, ChanlSDK as ProtoboxSDK, ChanlSDK as Protobox } from './client';
-export { ChanlConfig, ChanlAuthConfig } from './types/config';
+export { ProtoboxSDK, ProtoboxSDK as Protobox } from './client';
+export { ProtoboxConfig, ProtoboxAuthConfig } from './types/config';
+export type { ApiResponse, ListResult, PaginationMeta, PaginatedResponse } from './types/config';
 export { WorkspaceModule } from './modules/workspace';
 export { AuthModule } from './modules/auth';
 export { HealthModule } from './modules/health';

package/dist/index.js

@@ -14,12 +14,10 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ChatModule = exports.KnowledgeModule = exports.McpModule = exports.ToolsetsModule = exports.ToolsModule = exports.PromptsModule = exports.HealthModule = exports.AuthModule = exports.WorkspaceModule = exports.Protobox = exports.ProtoboxSDK = exports.Chanl = exports.ChanlSDK = void 0;
+exports.ChatModule = exports.KnowledgeModule = exports.McpModule = exports.ToolsetsModule = exports.ToolsModule = exports.PromptsModule = exports.HealthModule = exports.AuthModule = exports.WorkspaceModule = exports.Protobox = exports.ProtoboxSDK = void 0;
 var client_1 = require("./client");
-Object.defineProperty(exports, "ChanlSDK", { enumerable: true, get: function () { return client_1.ChanlSDK; } });
-Object.defineProperty(exports, "Chanl", { enumerable: true, get: function () { return client_1.ChanlSDK; } });
-Object.defineProperty(exports, "ProtoboxSDK", { enumerable: true, get: function () { return client_1.ChanlSDK; } });
-Object.defineProperty(exports, "Protobox", { enumerable: true, get: function () { return client_1.ChanlSDK; } });
+Object.defineProperty(exports, "ProtoboxSDK", { enumerable: true, get: function () { return client_1.ProtoboxSDK; } });
+Object.defineProperty(exports, "Protobox", { enumerable: true, get: function () { return client_1.ProtoboxSDK; } });
 var workspace_1 = require("./modules/workspace");
 Object.defineProperty(exports, "WorkspaceModule", { enumerable: true, get: function () { return workspace_1.WorkspaceModule; } });
 var auth_1 = require("./modules/auth");

package/dist/live/live-chat.d.ts

@@ -1,5 +1,5 @@
 import { TypedEventEmitter } from './typed-emitter';
-import type { ChanlSDK } from '../client';
+import type { ProtoboxSDK } from '../client';
 import type { ChatSessionResponse, ChatMessageResponse } from '../modules/chat';
 export type LiveChatEvents = {
     'message': (message: ChatMessageResponse) => void;
@@ -50,7 +50,7 @@ export declare class LiveChat extends TypedEventEmitter<LiveChatEvents> {
     private sdk;
     readonly sessionId: string;
     readonly agentName: string | undefined;
-    constructor(sdk: ChanlSDK, sessionData: ChatSessionResponse);
+    constructor(sdk: ProtoboxSDK, sessionData: ChatSessionResponse);
     /**
      * Send a message and receive the agent's response.
      *

package/dist/modules/auth.d.ts

@@ -1,4 +1,4 @@
-import { ChanlSDK } from '../client';
+import { ProtoboxSDK } from '../client';
 import { ApiResponse } from '../types/config';
 export interface ApiKey {
     id: string;
@@ -34,7 +34,7 @@ export interface AuthTokenResponse {
 }
 export declare class AuthModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * Exchange a Firebase ID token for platform JWT tokens.
      * Used by CLI browser login flow.

package/dist/modules/chat.d.ts

@@ -6,7 +6,7 @@
  * the platform owns the full lifecycle (interaction, transcript,
  * billing, evaluation) so the SDK only deals with sessions and messages.
  */
-import { ChanlSDK } from '../client';
+import { ProtoboxSDK } from '../client';
 import { ApiResponse } from '../types/config';
 import { ToolCall } from '../types/tool-calls';
 export interface CreateChatSessionInput {
@@ -62,7 +62,7 @@ export interface DeleteChatResponse {
 import { LiveChat } from '../live/live-chat';
 export declare class ChatModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * Create a new chat session with an agent
      *

package/dist/modules/health.d.ts

@@ -1,4 +1,4 @@
-import { ChanlSDK } from '../client';
+import { ProtoboxSDK } from '../client';
 import { ApiResponse } from '../types/config';
 export interface HealthStatus {
     status: 'healthy' | 'unhealthy' | 'ok';
@@ -32,7 +32,7 @@ export interface DetailedHealthStatus {
 }
 export declare class HealthModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * Get basic health status
      */

package/dist/modules/knowledge.d.ts

@@ -1,4 +1,4 @@
-import { ChanlSDK } from "../client";
+import { ProtoboxSDK } from "../client";
 import { ApiResponse } from "../types/config";
 export type KnowledgeSource = "text" | "url" | "file" | "manual" | "document" | "faq" | "api_docs" | "transcript";
 export type ProcessingStatus = "pending" | "processing" | "completed" | "failed";
@@ -150,7 +150,7 @@ export interface ProcessingTaskResponse {
 }
 export declare class KnowledgeModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * List all knowledge entries with optional filters
      */

package/dist/modules/mcp.d.ts

@@ -4,7 +4,7 @@
  * Provides access to MCP server configuration and health status.
  * Used by CLI and admin UI to get ready-to-use agent configurations.
  */
-import { ChanlSDK } from '../client';
+import { ProtoboxSDK } from '../client';
 import { ApiResponse } from '../types/config';
 export interface AgentConfig {
     url: string;
@@ -14,12 +14,12 @@ export interface AgentConfig {
 export interface AgentConfigs {
     claude: {
         mcpServers: {
-            chanl: AgentConfig;
+            protobox: AgentConfig;
         };
     };
     cursor: {
         mcpServers: {
-            chanl: AgentConfig;
+            protobox: AgentConfig;
         };
     };
     generic: AgentConfig;
@@ -59,7 +59,7 @@ export interface McpToolCallResult {
 }
 export declare class McpModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * Get MCP configuration for a workspace
      *

package/dist/modules/mcp.js

@@ -33,7 +33,20 @@ class McpModule {
         }
         const queryString = queryParams.toString();
         const url = '/api/v1/mcp/config' + (queryString ? '?' + queryString : '');
-        return this.sdk.request('GET', url);
+        const res = await this.sdk.request('GET', url);
+        // The backend keys the MCP server entry as `chanl` (legacy contract). Present
+        // it as `protobox` so consumer configs (Claude/Cursor) aren't off-brand and
+        // the runtime matches the AgentConfigs type.
+        if (res.success && res.data?.agentConfigs) {
+            for (const client of ['claude', 'cursor']) {
+                const servers = res.data.agentConfigs[client]?.mcpServers;
+                if (servers && 'chanl' in servers && !('protobox' in servers)) {
+                    servers['protobox'] = servers['chanl'];
+                    delete servers['chanl'];
+                }
+            }
+        }
+        return res;
     }
     /**
      * Check MCP server health status

package/dist/modules/prompts.d.ts

@@ -1,4 +1,4 @@
-import { ChanlSDK } from "../client";
+import { ProtoboxSDK } from "../client";
 import { ApiResponse } from "../types/config";
 export interface PromptVariable {
     name: string;
@@ -37,7 +37,12 @@ export interface PromptVersion {
     content: string;
     variables?: PromptVariable[];
     notes?: string;
-    isActive: boolean;
+    /**
+     * Whether this is the prompt's active version. Optional: the API tracks the
+     * active version via `Prompt.currentVersion`, so this may be absent — compare
+     * `version` to the prompt's `currentVersion` when it is not present.
+     */
+    isActive?: boolean;
     author?: string;
     createdAt: string;
     updatedAt?: string;
@@ -83,7 +88,7 @@ export interface PromptFilters {
 }
 export declare class PromptsModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * List all prompts with optional filters
      */

package/dist/modules/tools.d.ts

@@ -6,12 +6,12 @@
  * Provides CRUD operations for tools and execution capabilities.
  * Supports both JWT auth (admin UI) and MCP API key auth.
  */
-import { ChanlSDK } from '../client';
+import { ProtoboxSDK } from '../client';
 import { ApiResponse } from '../types/config';
 import type { Tool, ExecuteResult, CreateToolInput, UpdateToolInput, ToolFilters, ExecutionFilters, ToolListResponse, ToolDeleteResponse, ExecutionListResponse, ToolCategoriesResponse } from '../types/tools';
 export declare class ToolsModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * List all tools with optional filters
      *
@@ -31,7 +31,7 @@ export declare class ToolsModule {
      *   limit: 10
      * });
      *
-     * // Exclude system tools (kb_search, chanl_reason, etc.)
+     * // Exclude system tools (e.g. kb_search)
      * const { data } = await sdk.tools.list({
      *   includeSystem: false
      * });

package/dist/modules/tools.js

@@ -35,7 +35,7 @@ class ToolsModule {
      *   limit: 10
      * });
      *
-     * // Exclude system tools (kb_search, chanl_reason, etc.)
+     * // Exclude system tools (e.g. kb_search)
      * const { data } = await sdk.tools.list({
      *   includeSystem: false
      * });

package/dist/modules/toolsets.d.ts

@@ -4,12 +4,12 @@
  * Provides CRUD operations for toolsets (collections of tools).
  * Supports both JWT auth (admin UI) and API key auth.
  */
-import { ChanlSDK } from '../client';
+import { ProtoboxSDK } from '../client';
 import { ApiResponse } from '../types/config';
 import type { CreateToolsetInput, UpdateToolsetInput, ToolsetFilters, ToolsetListResponse, ToolsetResponse, ToolsetDeleteResponse, ManageToolsInput, ToolOverride } from '../types/toolsets';
 export declare class ToolsetsModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * List all toolsets with optional filters
      *

package/dist/modules/workspace.d.ts

@@ -1,4 +1,4 @@
-import { ChanlSDK } from "../client";
+import { ProtoboxSDK } from "../client";
 import { ApiResponse } from "../types/config";
 export type WorkspaceSettings = Record<string, unknown>;
 export interface Workspace {
@@ -11,7 +11,7 @@ export interface Workspace {
 }
 export declare class WorkspaceModule {
     private sdk;
-    constructor(sdk: ChanlSDK);
+    constructor(sdk: ProtoboxSDK);
     /**
      * Create a new workspace
      */

package/dist/types/config.d.ts

@@ -1,5 +1,5 @@
-export interface ChanlConfig {
-    /** API base URL (e.g., 'https://api.chanl.ai' or 'http://localhost:18005') */
+export interface ProtoboxConfig {
+    /** API base URL (e.g., 'https://api.protobox.app' or 'http://localhost:18005') */
     baseUrl: string;
     /** Same as baseUrl — supported for tooling that uses `server` (e.g. local eval). */
     server?: string;
@@ -31,7 +31,7 @@ export interface ChanlConfig {
         backoffMultiplier: number;
     };
 }
-export interface ChanlAuthConfig {
+export interface ProtoboxAuthConfig {
     /** API key for authentication */
     apiKey?: string;
     /** JWT token for authentication */
@@ -68,6 +68,31 @@ export interface PaginatedResponse<T = unknown> {
     message: string;
     timestamp: string;
 }
+/** Pagination metadata attached to every list response. */
+export interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+/**
+ * Canonical shape of `response.data` for EVERY list endpoint.
+ *
+ * The platform API is internally inconsistent — `/tools` returns `{ tools, total }`
+ * (no pagination), `/toolsets` returns `{ items, pagination }` (no top-level total),
+ * executions return `{ executions, ... }`, etc. The SDK client normalizes all of
+ * them to this one shape so consumers (and the CLI) never special-case per endpoint.
+ */
+export interface ListResult<T = unknown> {
+    /** The rows — always here regardless of what the API called the collection. */
+    items: T[];
+    /** Total matching rows across all pages. */
+    total: number;
+    /** Always present; synthesized when the API omits it. */
+    pagination: PaginationMeta;
+}
 export interface ApiError {
     success: false;
     error: {

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

@@ -1,5 +1,5 @@
 /**
- * Tool Call Types for @chanl/sdk
+ * Tool Call Types for @protoboxai/sdk
  *
  * Normalized tool call data returned by Chat, Scenarios, and Calls APIs.
  */

package/dist/types/tool-calls.js

@@ -1,6 +1,6 @@
 "use strict";
 /**
- * Tool Call Types for @chanl/sdk
+ * Tool Call Types for @protoboxai/sdk
  *
  * Normalized tool call data returned by Chat, Scenarios, and Calls APIs.
  */

package/dist/types/tools.d.ts

@@ -1,9 +1,9 @@
 /**
- * Tool Types for @chanl/sdk
+ * Tool Types for @protoboxai/sdk
  *
- * TDD Phase: RED - These types define the contract for ToolsModule
- * Based on chanl-api/src/tools/ schemas and DTOs
+ * Based on the platform agent-service tools schemas and DTOs.
  */
+import type { ListResult } from './config';
 export type ToolType = 'http' | 'javascript' | 'code';
 export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
 export type ExecutionStatus = 'pending' | 'running' | 'completed' | 'failed' | 'corrected';
@@ -223,19 +223,11 @@ export interface ExecutionFilters {
     limit?: number;
 }
 /**
- * Response for listing tools
+ * Response for listing tools.
+ * Canonical list shape — see {@link ListResult}. The SDK client normalizes the
+ * API's `{ tools, total }` into `{ items, total, pagination }`.
  */
-export interface ToolListResponse {
-    tools: Tool[];
-    total: number;
-    pagination: {
-        page: number;
-        limit: number;
-        totalPages: number;
-        hasNext: boolean;
-        hasPrev: boolean;
-    };
-}
+export type ToolListResponse = ListResult<Tool>;
 /**
  * Response for single tool operations
  */
@@ -274,21 +266,10 @@ export interface ToolExecutionResponse {
     execution: ToolExecution;
 }
 /**
- * Response for listing executions
+ * Response for listing executions.
+ * Canonical list shape — see {@link ListResult}. `items` holds the executions.
  */
-export interface ExecutionListResponse {
-    data: ToolExecution[];
-    total: number;
-    page: number;
-    limit: number;
-    pagination: {
-        page: number;
-        limit: number;
-        totalPages: number;
-        hasNext: boolean;
-        hasPrev: boolean;
-    };
-}
+export type ExecutionListResponse = ListResult<ToolExecution>;
 /**
  * Tool category (tag) with counts
  */

package/dist/types/tools.js

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

package/dist/types/toolsets.d.ts

@@ -1,8 +1,9 @@
 /**
- * Toolset Types for @chanl/sdk
+ * Toolset Types for @protoboxai/sdk
  *
- * Based on chanl-api/src/tools/dto/toolset-*.dto.ts and schemas/toolset.schema.ts
+ * Based on the platform agent-service toolset DTOs and schema.
  */
+import type { ListResult } from './config';
 /**
  * Toolset entity representing a collection of MCP tools
  */
@@ -123,20 +124,11 @@ export interface ToolOverride {
 /**
  * Response for listing toolsets
  */
-export interface ToolsetListResponse {
-    /** Array of toolsets (API may return as 'items' or 'data') */
-    items?: Toolset[];
-    data?: Toolset[];
-    total: number;
-    pagination?: {
-        page: number;
-        limit: number;
-        total: number;
-        totalPages: number;
-        hasNext: boolean;
-        hasPrev: boolean;
-    };
-}
+/**
+ * Canonical list shape — see {@link ListResult}. The SDK client normalizes the
+ * API's `{ items, pagination }` into `{ items, total, pagination }`.
+ */
+export type ToolsetListResponse = ListResult<Toolset>;
 /**
  * Response for single toolset operations
  * Note: API returns toolset directly in data, not nested as { toolset: ... }

package/dist/types/toolsets.js

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

package/package.json

@@ -1,20 +1,9 @@
 {
   "name": "@protoboxai/sdk",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "TypeScript SDK for Protobox — MCP servers, tools, agents, knowledge resources, prompts, and chat",
   "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": [
     "protobox",
     "mcp",
@@ -48,5 +37,16 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"
+  },
+  "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"
   }
-}
+}