@kaiban/sdk 0.1.1

package/dist/types/entities/activities.d.ts

@@ -0,0 +1,32 @@
+import { ISODate } from './shared';
+export interface CardActivity {
+    id: string;
+    card_id: string;
+    type: string;
+    content?: string;
+    created_at?: ISODate;
+}
+export interface CreateCardActivityInput {
+    type: string;
+    content?: string;
+}
+export interface ActivityActor {
+    id: string;
+    type: 'user' | 'agent' | 'system';
+    name: string;
+}
+export interface ActivityChange {
+    field: string;
+    old_value: unknown;
+    new_value: unknown;
+}
+export interface ActivityCreate {
+    board_id: string;
+    card_id: string;
+    team_id: string;
+    type: 'card_created' | 'card_column_changed' | string;
+    description: string;
+    actor: ActivityActor;
+    changes?: ActivityChange[];
+    metadata?: Record<string, unknown>;
+}

package/dist/types/entities/activities.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities/agent.d.ts

@@ -0,0 +1,16 @@
+import { ISODate } from './shared';
+export interface Agent {
+    id: string;
+    name: string;
+    description: string;
+    team_id: string;
+    status: 'active' | 'draft' | 'inactive';
+    type: 'kaibanjs' | 'crewai' | 'external' | 'a2a';
+    created_at?: ISODate;
+    updated_at?: ISODate;
+}
+export interface AgentFeedback {
+    rating?: number;
+    comment?: string;
+    metadata?: Record<string, unknown>;
+}

package/dist/types/entities/agent.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities/benchmark.d.ts

@@ -0,0 +1,82 @@
+import { ISODate } from './shared';
+export interface Benchmark {
+    id: string;
+    name: string;
+    description?: string;
+    created_at?: ISODate;
+    updated_at?: ISODate;
+}
+export interface CreateBenchmarkInput {
+    name: string;
+    description?: string;
+}
+export type UpdateBenchmarkInput = Partial<CreateBenchmarkInput>;
+export interface BenchmarkExecution {
+    id: string;
+    benchmark_id: string;
+    agent_name?: string;
+    agent_id: string;
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    total_tests: number;
+    completed_tests: number;
+    passed_tests: number;
+    failed_tests: number;
+    total_execution_time: number;
+    total_cost: number;
+    total_tokens: number;
+    total_input_tokens?: number;
+    total_output_tokens?: number;
+    thresholds?: Record<string, number>;
+    max_tests?: number;
+    parallel?: boolean;
+    batch_size?: number;
+    multi_turn?: boolean;
+    created_at?: ISODate;
+    updated_at?: ISODate;
+    started_at?: ISODate;
+    completed_at?: ISODate;
+    error?: string;
+    attempt?: number;
+}
+export interface CreateBenchmarkExecutionInput {
+    benchmark_id: string;
+    agent_id: string;
+    status?: 'pending' | 'running' | 'completed' | 'failed';
+    thresholds?: Record<string, number>;
+    max_tests?: number;
+    parallel?: boolean;
+    batch_size?: number;
+    multi_turn?: boolean;
+}
+export type UpdateBenchmarkExecutionInput = Partial<CreateBenchmarkExecutionInput>;
+export interface TestCaseResult {
+    id: string;
+    execution_id: string;
+    test_index: number;
+    input: string;
+    agent_output: string;
+    execution_time: number;
+    token_usage?: {
+        input_tokens?: number;
+        output_tokens?: number;
+        total_tokens?: number;
+        cost?: number;
+        model?: string;
+    };
+    scores?: Array<{
+        scorer: string;
+        attribute?: string;
+        expected_value?: string;
+        score?: number;
+        passed?: boolean;
+        details?: Record<string, unknown>;
+        info?: Record<string, unknown>;
+        reason?: string;
+    }>;
+    passed?: boolean;
+    average_score?: number;
+    tags?: string[];
+    created_at?: ISODate;
+}
+export type CreateTestCaseResultInput = Omit<TestCaseResult, 'id' | 'execution_id' | 'created_at'>;
+export type UpdateTestCaseResultInput = Partial<CreateTestCaseResultInput>;

package/dist/types/entities/benchmark.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities/board.d.ts

@@ -0,0 +1,20 @@
+import { ISODate } from './shared';
+export interface Column {
+    column_key: string;
+    name: string;
+    process_stage: string;
+    order: number;
+    created_at: ISODate;
+    updated_at: ISODate;
+}
+export interface Board {
+    id: string;
+    name: string;
+    description: string;
+    team_id: string;
+    owner_id: string;
+    agent_ids: string[];
+    member_ids: string[];
+    allowed_roles: string[];
+    columns: Column[];
+}

package/dist/types/entities/board.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities/card.d.ts

@@ -0,0 +1,50 @@
+import { ISODate } from './shared';
+export interface Card {
+    id: string;
+    team_id: string;
+    board_id: string;
+    owner_id: string;
+    agent_id: string;
+    title: string;
+    description?: string;
+    status: 'backlog' | 'todo' | 'doing' | 'blocked' | 'done';
+    column_key: string;
+    created_at?: ISODate;
+    updated_at?: ISODate;
+    priority: string;
+    result?: string;
+    member_ids: string[];
+    metadata?: Record<string, unknown>;
+    enabled?: boolean;
+    parts?: Part[];
+}
+export type Part = {
+    type: 'text';
+    text: {
+        content: string;
+    };
+} | {
+    type: 'file';
+    file: {
+        name: string;
+        mimeType: string;
+        uri: string;
+    };
+};
+export interface CreateCardInput {
+    team_id: string;
+    board_id: string;
+    owner_id: string;
+    agent_id: string;
+    title: string;
+    description?: string;
+    status: Card['status'];
+    column_key: string;
+    priority: string;
+    member_ids: string[];
+    parts?: Part[];
+    metadata?: Record<string, unknown>;
+}
+export type UpdateCardInput = Partial<Omit<CreateCardInput, 'team_id' | 'board_id' | 'owner_id'>> & {
+    status?: Card['status'];
+};

package/dist/types/entities/card.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities/external-channel.d.ts

@@ -0,0 +1,12 @@
+import { ISODate } from './shared';
+export interface ExternalChannel {
+    id: string;
+    name: string;
+    type: string;
+    team_id: string;
+    board_id: string;
+    agent_id: string;
+    initial_column_key?: string;
+    created_at?: ISODate;
+    updated_at?: ISODate;
+}

package/dist/types/entities/external-channel.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities/index.d.ts

@@ -0,0 +1,9 @@
+export * from './shared';
+export * from './card';
+export * from './activities';
+export * from './agent';
+export * from './team';
+export * from './board';
+export * from './resource';
+export * from './benchmark';
+export * from './external-channel';

package/dist/types/entities/index.js

@@ -0,0 +1,9 @@
+export * from './shared';
+export * from './card';
+export * from './activities';
+export * from './agent';
+export * from './team';
+export * from './board';
+export * from './resource';
+export * from './benchmark';
+export * from './external-channel';

package/dist/types/entities/resource.d.ts

@@ -0,0 +1,16 @@
+import { ISODate } from './shared';
+export interface Resource {
+    id: string;
+    name: string;
+    description?: string;
+    version?: number;
+    content?: string;
+    status?: string;
+    team_id?: string;
+    created_by?: string;
+    last_edited_by?: string;
+    published_at?: ISODate | null;
+    last_edited_at?: ISODate;
+    created_at?: ISODate;
+    updated_at?: ISODate;
+}

package/dist/types/entities/resource.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities/shared.d.ts

@@ -0,0 +1 @@
+export type ISODate = string;

package/dist/types/entities/shared.js

@@ -0,0 +1,2 @@
+// Shared primitives for entity wire types
+export {};

package/dist/types/entities/team.d.ts

@@ -0,0 +1,14 @@
+import { ISODate } from './shared';
+export interface Team {
+    id: string;
+    name: string;
+    created_at: ISODate;
+}
+export interface TeamMember {
+    id: string;
+    team_id: string;
+    role: string;
+    is_agent: boolean;
+    joined_at: ISODate;
+    created_at: ISODate;
+}

package/dist/types/entities/team.js

@@ -0,0 +1 @@
+export {};

package/dist/types/entities.d.ts

@@ -0,0 +1 @@
+export * from './entities/index';

package/dist/types/entities.js

@@ -0,0 +1 @@
+export * from './entities/index';

package/dist/types/requests.d.ts

@@ -0,0 +1,22 @@
+export type Empty = Record<string, never>;
+export interface ActivitiesBatchRequestItem {
+    board_id: string;
+    card_id: string;
+    team_id: string;
+    type: string;
+    description: string;
+    actor: {
+        id: string;
+        type: 'user' | 'agent' | 'system';
+        name: string;
+    };
+    changes?: Array<{
+        field: string;
+        old_value: unknown;
+        new_value: unknown;
+    }>;
+    metadata?: Record<string, unknown>;
+}
+export interface ActivitiesBatchRequest {
+    items: ActivitiesBatchRequestItem[];
+}

package/dist/types/requests.js

@@ -0,0 +1 @@
+export {};

package/dist/types/responses.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Pagination metadata returned by list endpoints
+ */
+export interface PaginationMeta {
+    /** Number of items per page */
+    limit: number;
+    /** Whether there are more results available */
+    has_more: boolean;
+    /** Cursor for the next page */
+    next_cursor?: string;
+    /** Cursor for the previous page */
+    previous_cursor?: string;
+}
+/**
+ * API meta information returned with each response
+ */
+export interface ResponseMeta {
+    /** Server timestamp (ISO8601) */
+    timestamp: string;
+    /** Request ID included only when server generated it (client did not provide) */
+    request_id?: string;
+}
+/**
+ * Standard error object
+ */
+export interface ApiErrorObject {
+    code: 'invalid_argument' | 'unauthenticated' | 'permission_denied' | 'not_found' | 'conflict' | 'internal' | 'validation_error' | 'rate_limit_exceeded' | 'bad_gateway' | 'service_unavailable' | 'gateway_timeout' | string;
+    message: string;
+    details?: unknown;
+}
+/**
+ * Generic success envelope
+ */
+export interface SuccessEnvelope<T> {
+    data: T;
+    meta: ResponseMeta;
+}
+/**
+ * Generic error envelope
+ */
+export interface ErrorEnvelope {
+    error: ApiErrorObject;
+    meta: ResponseMeta;
+}
+/**
+ * Generic paginated response format (Option A)
+ */
+export interface Paginated<T> {
+    /** Array of items in the current page */
+    data: T[];
+    /** Pagination metadata */
+    meta: PaginationMeta;
+}
+/**
+ * Parameters for list operations
+ */
+export interface ListParams {
+    /** Cursor for pagination (from previous/next response) */
+    cursor?: string;
+    /** Number of items per page (default: 50, max: 100) */
+    limit?: number;
+    /**
+     * Fields to sort by. Use - prefix for descending order.
+     * Example: ['-created_at', 'name'] sorts by created_at desc, then name asc
+     */
+    order_by?: string;
+    /**
+     * Filter parameters. Each client defines available fields.
+     * Example: { status: 'active', team_id: '123' }
+     */
+    filters?: Record<string, unknown>;
+    /**
+     * Metadata filters for cards. Each key becomes metadata.{key} in the query.
+     * Example: { thread_id: '123' } becomes ?metadata.thread_id=123
+     */
+    metadata?: Record<string, unknown>;
+}

package/dist/types/responses.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@kaiban/sdk",
+  "version": "0.1.1",
+  "description": "Official TypeScript SDK for the Kaiban API",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "npm run lint && npm run format && tsc -p tsconfig.json",
+    "clean": "rimraf dist",
+    "prepare": "npm run build",
+    "dev": "npm run lint && npm run format && tsc -w -p tsconfig.json",
+    "lint": "node_modules/.bin/eslint .",
+    "lint:fix": "node_modules/.bin/eslint . --fix",
+    "format": "node_modules/.bin/prettier --write .",
+    "format:check": "node_modules/.bin/prettier --check .",
+    "refresh": "rm -rf node_modules package-lock.json && npm install",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "docs:generate": "typedoc",
+    "docs:clean": "rimraf docs",
+    "docs:build": "npm run docs:clean && npm run docs:generate",
+    "docs:serve": "npm run docs:generate && npx serve docs"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.12.0",
+    "@vitest/coverage-v8": "^2.1.1",
+    "eslint": "^9.12.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.3.3",
+    "rimraf": "^6.0.1",
+    "typedoc": "^0.28.14",
+    "typescript": "^5.4.0",
+    "typescript-eslint": "^8.8.0",
+    "vitest": "^2.1.1"
+  }
+}