@kaiban/sdk 0.1.1

package/dist/lib/resources/BenchmarksClient.js

@@ -0,0 +1,158 @@
+/**
+ * Client for managing benchmarks in the Kaiban platform
+ * Benchmarks are used to evaluate and test agent performance
+ * @category Resources
+ */
+export class BenchmarksClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List benchmarks with pagination, filters, and sorting
+     *
+     * @param params - Optional query parameters for filtering and pagination
+     * @param params.cursor - Cursor for the next page of results
+     * @param params.limit - Number of items per page
+     * @param params.order_by - Fields to sort by
+     * @param options - Optional request configuration
+     *
+     * @returns A paginated list of benchmarks
+     *
+     * @example
+     * ```typescript
+     * const result = await client.benchmarks.list({ limit: 10 });
+     * console.log(result.items);
+     * ```
+     */
+    list(params, options) {
+        return this.http.list('/benchmarks', params, options);
+    }
+    /**
+     * Iterate through all benchmarks using async generator
+     * Automatically handles pagination by following next_page_token
+     *
+     * @param params - Optional query parameters (excluding cursor)
+     * @param options - Optional request configuration
+     *
+     * @yields Individual Benchmark objects
+     *
+     * @example
+     * ```typescript
+     * for await (const benchmark of client.benchmarks.listAll()) {
+     *   console.log(benchmark.id, benchmark.name);
+     * }
+     * ```
+     */
+    async *listAll(params, options) {
+        let pageToken = undefined;
+        do {
+            const page = await this.list({ ...(params || {}), cursor: pageToken }, options);
+            for (const item of page.items)
+                yield item;
+            pageToken = page.next_page_token;
+        } while (pageToken);
+    }
+    /**
+     * Get a single benchmark by ID
+     *
+     * @param id - The unique identifier of the benchmark
+     * @param options - Optional request configuration
+     *
+     * @returns The benchmark object
+     *
+     * @throws {Error} If the benchmark is not found or request fails
+     *
+     * @example
+     * ```typescript
+     * const benchmark = await client.benchmarks.get('benchmark-123');
+     * console.log(benchmark.name, benchmark.description);
+     * ```
+     */
+    get(id, options) {
+        return this.http.get(`/benchmark/${encodeURIComponent(id)}`, options);
+    }
+    /**
+     * Create a new benchmark
+     *
+     * @param data - Benchmark creation data
+     * @param data.name - The benchmark name
+     * @param data.description - Optional description
+     * @param options - Optional request configuration
+     *
+     * @returns The newly created benchmark
+     *
+     * @throws {Error} If creation fails
+     *
+     * @example
+     * ```typescript
+     * const benchmark = await client.benchmarks.create({
+     *   name: 'Performance Test Suite',
+     *   description: 'Test agent response times',
+     *   test_cases: [...]
+     * });
+     * ```
+     */
+    create(data, options) {
+        return this.http.post('/benchmarks', data, options);
+    }
+    /**
+     * Update a benchmark's properties
+     *
+     * @param id - The unique identifier of the benchmark to update
+     * @param data - Benchmark data with fields to update
+     * @param options - Optional request configuration
+     *
+     * @returns The updated benchmark object
+     *
+     * @throws {Error} If the benchmark is not found or update fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.benchmarks.update('benchmark-123', {
+     *   name: 'Updated Benchmark Name'
+     * });
+     * ```
+     */
+    update(id, data, options) {
+        return this.http.put(`/benchmark/${encodeURIComponent(id)}`, data, options);
+    }
+    /**
+     * Execute a benchmark against an agent
+     * Runs the benchmark test suite with specified configuration
+     *
+     * @param params - Execution parameters
+     * @param params.benchmark_id - The unique identifier of the benchmark to execute
+     * @param params.body - Execution configuration
+     * @param params.body.agentConfig - Agent configuration including ID, name, and card URL
+     * @param params.body.thresholds - Optional performance thresholds
+     * @param params.body.maxTests - Optional maximum number of tests to run
+     * @param params.body.parallel - Optional flag to run tests in parallel
+     * @param params.body.batchSize - Optional batch size for parallel execution
+     * @param options - Optional request configuration
+     *
+     * @returns A response with execution status message
+     *
+     * @throws {Error} If the benchmark is not found or execution fails
+     *
+     * @example
+     * ```typescript
+     * const result = await client.benchmarks.execute({
+     *   benchmark_id: 'benchmark-123',
+     *   body: {
+     *     agentConfig: {
+     *       id: 'agent-456',
+     *       name: 'Test Agent',
+     *       cardUrl: 'https://example.com/agent-card'
+     *     },
+     *     maxTests: 100,
+     *     parallel: true,
+     *     batchSize: 10
+     *   }
+     * });
+     * console.log(result.message);
+     * ```
+     */
+    execute(params, options) {
+        return this.http.post(`/benchmark/${encodeURIComponent(params.benchmark_id)}/execute`, params.body, options);
+    }
+}

package/dist/lib/resources/BoardsClient.d.ts

@@ -0,0 +1,65 @@
+import { HttpClient } from '../http/HttpClient';
+import { RequestOptions } from '../http/types';
+import { Board } from '../../types/entities';
+import { ListParams, Paginated } from '../../types/responses';
+/**
+ * Client for managing boards in the Kaiban platform
+ * Boards organize cards into columns for workflow management
+ * @category Resources
+ */
+export declare class BoardsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List boards with pagination, filters, and sorting
+     *
+     * @param params - Optional query parameters for filtering and pagination
+     * @param params.cursor - Cursor for the next page of results
+     * @param params.limit - Number of items per page
+     * @param params.order_by - Fields to sort by
+     * @param options - Optional request configuration
+     *
+     * @returns A paginated list of boards
+     *
+     * @example
+     * ```typescript
+     * const result = await client.boards.list({ limit: 10 });
+     * console.log(result.data);
+     * ```
+     */
+    list(params?: ListParams, options?: RequestOptions): Promise<Paginated<Board>>;
+    /**
+     * Iterate through all boards using async generator
+     * Automatically handles pagination by following next_page_token
+     *
+     * @param params - Optional query parameters (excluding cursor)
+     * @param options - Optional request configuration
+     *
+     * @yields Individual Board objects
+     *
+     * @example
+     * ```typescript
+     * for await (const board of client.boards.listAll()) {
+     *   console.log(board.id, board.name);
+     * }
+     * ```
+     */
+    listAll(params?: Omit<ListParams, 'cursor'>, options?: RequestOptions): AsyncGenerator<Board, void, unknown>;
+    /**
+     * Get a single board by ID
+     *
+     * @param id - The unique identifier of the board
+     * @param options - Optional request configuration
+     *
+     * @returns The board object
+     *
+     * @throws {Error} If the board is not found or request fails
+     *
+     * @example
+     * ```typescript
+     * const board = await client.boards.get('board-123');
+     * console.log(board.name, board.columns);
+     * ```
+     */
+    get(id: string, options?: RequestOptions): Promise<Board>;
+}

package/dist/lib/resources/BoardsClient.js

@@ -0,0 +1,74 @@
+/**
+ * Client for managing boards in the Kaiban platform
+ * Boards organize cards into columns for workflow management
+ * @category Resources
+ */
+export class BoardsClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List boards with pagination, filters, and sorting
+     *
+     * @param params - Optional query parameters for filtering and pagination
+     * @param params.cursor - Cursor for the next page of results
+     * @param params.limit - Number of items per page
+     * @param params.order_by - Fields to sort by
+     * @param options - Optional request configuration
+     *
+     * @returns A paginated list of boards
+     *
+     * @example
+     * ```typescript
+     * const result = await client.boards.list({ limit: 10 });
+     * console.log(result.data);
+     * ```
+     */
+    list(params, options) {
+        return this.http.list('/boards', params, options);
+    }
+    /**
+     * Iterate through all boards using async generator
+     * Automatically handles pagination by following next_page_token
+     *
+     * @param params - Optional query parameters (excluding cursor)
+     * @param options - Optional request configuration
+     *
+     * @yields Individual Board objects
+     *
+     * @example
+     * ```typescript
+     * for await (const board of client.boards.listAll()) {
+     *   console.log(board.id, board.name);
+     * }
+     * ```
+     */
+    async *listAll(params, options) {
+        let cursor = undefined;
+        do {
+            const page = await this.list({ ...(params || {}), cursor: cursor }, options);
+            for (const item of page.data)
+                yield item;
+            cursor = page.meta.next_cursor;
+        } while (cursor);
+    }
+    /**
+     * Get a single board by ID
+     *
+     * @param id - The unique identifier of the board
+     * @param options - Optional request configuration
+     *
+     * @returns The board object
+     *
+     * @throws {Error} If the board is not found or request fails
+     *
+     * @example
+     * ```typescript
+     * const board = await client.boards.get('board-123');
+     * console.log(board.name, board.columns);
+     * ```
+     */
+    get(id, options) {
+        return this.http.get(`/board/${encodeURIComponent(id)}`, options);
+    }
+}

package/dist/lib/resources/CardsClient.d.ts

@@ -0,0 +1,161 @@
+import { HttpClient } from '../http/HttpClient';
+import { RequestOptions } from '../http/types';
+import { Card, CreateCardInput, UpdateCardInput, ActivityActor } from '../../types/entities';
+import { ListParams, Paginated } from '../../types/responses';
+/**
+ * Client for managing cards in the Kaiban platform
+ * Cards represent work items, tasks, or tickets within boards
+ * @category Resources
+ */
+export declare class CardsClient {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List cards with pagination, filters, and sorting
+     *
+     * @param params - Optional query parameters for filtering and pagination
+     * @param params.cursor - Cursor for the next page of results
+     * @param params.limit - Number of items per page
+     * @param params.order_by - Fields to sort by
+     * @param options - Optional request configuration
+     *
+     * @returns A paginated list of cards
+     *
+     * @example
+     * ```typescript
+     * // List cards with filters
+     * const result = await client.cards.list({
+     *   limit: 20,
+     *   order_by: ['created_at']
+     * });
+     * ```
+     */
+    list(params?: ListParams, options?: RequestOptions): Promise<Paginated<Card>>;
+    /**
+     * Iterate through all cards using async generator
+     * Automatically handles pagination by following next_page_token
+     *
+     * @param params - Optional query parameters (excluding cursor)
+     * @param options - Optional request configuration
+     *
+     * @yields Individual Card objects
+     *
+     * @example
+     * ```typescript
+     * // Process all cards
+     * for await (const card of client.cards.listAll()) {
+     *   console.log(card.title, card.status);
+     * }
+     * ```
+     */
+    listAll(params?: Omit<ListParams, 'cursor'>, options?: RequestOptions): AsyncGenerator<Card, void, unknown>;
+    /**
+     * Get a single card by ID
+     *
+     * @param id - The unique identifier of the card
+     * @param options - Optional request configuration
+     *
+     * @returns The card object
+     *
+     * @throws {Error} If the card is not found or request fails
+     *
+     * @example
+     * ```typescript
+     * const card = await client.cards.get('card-123');
+     * console.log(card.title, card.description);
+     * ```
+     */
+    get(id: string, options?: RequestOptions): Promise<Card>;
+    /**
+     * Create a new card with optional activity tracking
+     *
+     * @param data - Card creation data
+     * @param data.title - The card title
+     * @param data.board_id - The board this card belongs to
+     * @param data.column_key - The column where the card should be placed
+     * @param options - Optional request configuration
+     * @param options.create_activity - If true, creates a 'card_created' activity
+     *
+     * @returns The newly created card
+     *
+     * @throws {Error} If creation fails
+     *
+     * @example
+     * ```typescript
+     * const card = await client.cards.create({
+     *   title: 'New Task',
+     *   board_id: 'board-123',
+     *   team_id: 'team-456',
+     *   column_key: 'todo',
+     *   description: 'Task description'
+     * }, { create_activity: true });
+     * ```
+     */
+    create(data: CreateCardInput, options?: RequestOptions & {
+        create_activity?: boolean;
+    }): Promise<Card>;
+    /**
+     * Update a card's properties
+     *
+     * @param id - The unique identifier of the card to update
+     * @param data - Card data with fields to update
+     * @param options - Optional request configuration
+     *
+     * @returns The updated card object
+     *
+     * @throws {Error} If the card is not found or update fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.cards.update('card-123', {
+     *   title: 'Updated Title',
+     *   status: 'in_progress'
+     * });
+     * ```
+     */
+    update(id: string, data: UpdateCardInput, options?: RequestOptions): Promise<Card>;
+    /**
+     * Delete a card by ID
+     *
+     * @param id - The unique identifier of the card to delete
+     * @param options - Optional request configuration
+     *
+     * @returns Promise that resolves when the card is deleted
+     *
+     * @throws {Error} If the card is not found or deletion fails
+     *
+     * @example
+     * ```typescript
+     * await client.cards.delete('card-123');
+     * ```
+     */
+    delete(id: string, options?: RequestOptions): Promise<void>;
+    /**
+     * Move a card to a new column and automatically record the activity
+     * This is a convenience method that combines update and activity creation
+     *
+     * @param id - The unique identifier of the card to move
+     * @param newColumnKey - The key of the destination column
+     * @param options - Optional request configuration
+     * @param options.actor - The actor performing the move (defaults to SDK system actor)
+     *
+     * @returns The updated card object
+     *
+     * @throws {Error} If the card is not found or move fails
+     *
+     * @example
+     * ```typescript
+     * // Move card to 'in_progress' column
+     * const card = await client.cards.moveToColumn('card-123', 'in_progress', {
+     *   actor: {
+     *     id: 'user-456',
+     *     type: 'user',
+     *     name: 'John Doe'
+     *   }
+     * });
+     * ```
+     */
+    moveToColumn(id: string, newColumnKey: string, options?: RequestOptions & {
+        actor?: ActivityActor;
+    }): Promise<Card>;
+}

package/dist/lib/resources/CardsClient.js

@@ -0,0 +1,202 @@
+// Minimal create-activity payload aligned to backend activity schema
+// Activity types are shared in entities
+/**
+ * Client for managing cards in the Kaiban platform
+ * Cards represent work items, tasks, or tickets within boards
+ * @category Resources
+ */
+export class CardsClient {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * List cards with pagination, filters, and sorting
+     *
+     * @param params - Optional query parameters for filtering and pagination
+     * @param params.cursor - Cursor for the next page of results
+     * @param params.limit - Number of items per page
+     * @param params.order_by - Fields to sort by
+     * @param options - Optional request configuration
+     *
+     * @returns A paginated list of cards
+     *
+     * @example
+     * ```typescript
+     * // List cards with filters
+     * const result = await client.cards.list({
+     *   limit: 20,
+     *   order_by: ['created_at']
+     * });
+     * ```
+     */
+    list(params, options) {
+        return this.http.list('/cards', params, options);
+    }
+    /**
+     * Iterate through all cards using async generator
+     * Automatically handles pagination by following next_page_token
+     *
+     * @param params - Optional query parameters (excluding cursor)
+     * @param options - Optional request configuration
+     *
+     * @yields Individual Card objects
+     *
+     * @example
+     * ```typescript
+     * // Process all cards
+     * for await (const card of client.cards.listAll()) {
+     *   console.log(card.title, card.status);
+     * }
+     * ```
+     */
+    async *listAll(params, options) {
+        let cursor = undefined;
+        do {
+            const page = await this.list({ ...(params || {}), cursor }, options);
+            for (const item of page.data)
+                yield item;
+            cursor = page.meta.next_cursor;
+        } while (cursor);
+    }
+    /**
+     * Get a single card by ID
+     *
+     * @param id - The unique identifier of the card
+     * @param options - Optional request configuration
+     *
+     * @returns The card object
+     *
+     * @throws {Error} If the card is not found or request fails
+     *
+     * @example
+     * ```typescript
+     * const card = await client.cards.get('card-123');
+     * console.log(card.title, card.description);
+     * ```
+     */
+    get(id, options) {
+        return this.http.get(`/card/${encodeURIComponent(id)}`, options);
+    }
+    /**
+     * Create a new card with optional activity tracking
+     *
+     * @param data - Card creation data
+     * @param data.title - The card title
+     * @param data.board_id - The board this card belongs to
+     * @param data.column_key - The column where the card should be placed
+     * @param options - Optional request configuration
+     * @param options.create_activity - If true, creates a 'card_created' activity
+     *
+     * @returns The newly created card
+     *
+     * @throws {Error} If creation fails
+     *
+     * @example
+     * ```typescript
+     * const card = await client.cards.create({
+     *   title: 'New Task',
+     *   board_id: 'board-123',
+     *   team_id: 'team-456',
+     *   column_key: 'todo',
+     *   description: 'Task description'
+     * }, { create_activity: true });
+     * ```
+     */
+    async create(data, options) {
+        const card = await this.http.post('/cards', data, options);
+        if (options?.create_activity) {
+            const activity = {
+                board_id: card.board_id,
+                team_id: card.team_id,
+                card_id: card.id,
+                type: 'card_created',
+                description: 'Card created',
+                actor: { id: 'sdk', type: 'system', name: 'Kaiban SDK' },
+            };
+            await this.http.post(`/card/${encodeURIComponent(card.id)}/activities`, activity, options);
+        }
+        return card;
+    }
+    /**
+     * Update a card's properties
+     *
+     * @param id - The unique identifier of the card to update
+     * @param data - Card data with fields to update
+     * @param options - Optional request configuration
+     *
+     * @returns The updated card object
+     *
+     * @throws {Error} If the card is not found or update fails
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.cards.update('card-123', {
+     *   title: 'Updated Title',
+     *   status: 'in_progress'
+     * });
+     * ```
+     */
+    update(id, data, options) {
+        return this.http.put(`/card/${encodeURIComponent(id)}`, data, options);
+    }
+    /**
+     * Delete a card by ID
+     *
+     * @param id - The unique identifier of the card to delete
+     * @param options - Optional request configuration
+     *
+     * @returns Promise that resolves when the card is deleted
+     *
+     * @throws {Error} If the card is not found or deletion fails
+     *
+     * @example
+     * ```typescript
+     * await client.cards.delete('card-123');
+     * ```
+     */
+    delete(id, options) {
+        return this.http.delete(`/card/${encodeURIComponent(id)}`, options);
+    }
+    // Activity operations moved to ActivitiesClient
+    /**
+     * Move a card to a new column and automatically record the activity
+     * This is a convenience method that combines update and activity creation
+     *
+     * @param id - The unique identifier of the card to move
+     * @param newColumnKey - The key of the destination column
+     * @param options - Optional request configuration
+     * @param options.actor - The actor performing the move (defaults to SDK system actor)
+     *
+     * @returns The updated card object
+     *
+     * @throws {Error} If the card is not found or move fails
+     *
+     * @example
+     * ```typescript
+     * // Move card to 'in_progress' column
+     * const card = await client.cards.moveToColumn('card-123', 'in_progress', {
+     *   actor: {
+     *     id: 'user-456',
+     *     type: 'user',
+     *     name: 'John Doe'
+     *   }
+     * });
+     * ```
+     */
+    async moveToColumn(id, newColumnKey, options) {
+        const current = await this.get(id, options);
+        const oldColumn = current.column_key;
+        const updated = await this.update(id, { column_key: newColumnKey }, options);
+        const activity = {
+            board_id: updated.board_id,
+            team_id: updated.team_id,
+            card_id: updated.id,
+            type: 'card_column_changed',
+            description: `Moved card from ${oldColumn} to ${newColumnKey}`,
+            actor: options?.actor || { id: 'sdk', type: 'system', name: 'Kaiban SDK' },
+            changes: [{ field: 'column_key', old_value: oldColumn, new_value: newColumnKey }],
+        };
+        await this.http.post(`/card/${encodeURIComponent(updated.id)}/activities`, activity, options);
+        return updated;
+    }
+}