@crewx/sdk 0.9.0-rc.23 → 0.9.0-rc.231

package/dist/route/sqlite-store.d.ts

@@ -0,0 +1,18 @@
+import { BaseSqliteRepository } from '../repository/base-sqlite-repository.js';
+import type { RouteDecision, RouteQuotaObservation, RouteCandidateConfig } from './types.js';
+import type { RouteDecisionCommit, RouteDecisionStore, RouteObservationStore, RouteStateSnapshot, RouteCommitResult } from './store.js';
+export declare class RouteSqliteStore extends BaseSqliteRepository implements RouteDecisionStore, RouteObservationStore {
+    private readonly configuredDbPath?;
+    constructor(options?: {
+        dbPath?: string;
+        dbRoot?: string;
+    });
+    resolveDbPath(): string;
+    private openHandle;
+    getDecision(workspaceKey: string, routeId: string, taskId: string): Promise<RouteDecision | undefined>;
+    listDecisions(workspaceKey: string, routeId: string, limit: number): Promise<RouteDecision[]>;
+    loadState(workspaceKey: string, routeId: string, threadId: string | null, configRevision: string): Promise<RouteStateSnapshot>;
+    commitDecision(input: RouteDecisionCommit): Promise<RouteCommitResult>;
+    recordQuotaObservation(observation: RouteQuotaObservation, observedAt: number): Promise<void>;
+    getObservations(candidates: readonly RouteCandidateConfig[], _now: number): Promise<RouteQuotaObservation[]>;
+}

package/dist/route/store.d.ts

@@ -0,0 +1,48 @@
+import type { JsonValue, RouteDecision, RouteQuotaObservation, RouteCandidateConfig } from './types.js';
+export interface RouteStateSnapshot {
+    revision: number;
+    storedConfigRevision: string | null;
+    states: Record<string, JsonValue>;
+    stickyCandidateId?: string;
+}
+export interface RouteDecisionCommit {
+    workspaceKey: string;
+    decision: RouteDecision;
+    expectedRevision: number;
+    expectedStoredConfigRevision: string | null;
+    configRevision: string;
+    states: Record<string, JsonValue>;
+    threadId: string | null;
+    stickyCandidateId?: string;
+}
+export type RouteCommitResult = {
+    status: 'saved';
+    decision: RouteDecision;
+} | {
+    status: 'conflict';
+} | {
+    status: 'existing';
+    decision: RouteDecision;
+};
+export interface RouteDecisionStore {
+    getDecision(workspaceKey: string, routeId: string, taskId: string): Promise<RouteDecision | undefined>;
+    listDecisions(workspaceKey: string, routeId: string, limit: number): Promise<RouteDecision[]>;
+    loadState(workspaceKey: string, routeId: string, threadId: string | null, configRevision: string): Promise<RouteStateSnapshot>;
+    commitDecision(input: RouteDecisionCommit): Promise<RouteCommitResult>;
+    recordQuotaObservation(observation: RouteQuotaObservation, observedAt: number): Promise<void>;
+}
+export interface RouteObservationStore {
+    getObservations(candidates: readonly RouteCandidateConfig[], now: number): Promise<RouteQuotaObservation[]>;
+}
+export declare class MemoryRouteStore implements RouteDecisionStore, RouteObservationStore {
+    private readonly states;
+    private readonly sticky;
+    private readonly decisions;
+    private readonly observations;
+    getDecision(workspaceKey: string, routeId: string, taskId: string): Promise<RouteDecision | undefined>;
+    listDecisions(workspaceKey: string, routeId: string, limit: number): Promise<RouteDecision[]>;
+    loadState(workspaceKey: string, routeId: string, threadId: string | null, configRevision: string): Promise<RouteStateSnapshot>;
+    commitDecision(input: RouteDecisionCommit): Promise<RouteCommitResult>;
+    recordQuotaObservation(observation: RouteQuotaObservation, observedAt: number): Promise<void>;
+    getObservations(candidates: readonly RouteCandidateConfig[], _now: number): Promise<RouteQuotaObservation[]>;
+}

package/dist/route/strategies.d.ts

@@ -0,0 +1,4 @@
+import type { RouteContext, RouteOutput } from './types.js';
+export declare function roundRobin(ctx: Readonly<RouteContext>): RouteOutput;
+export declare function smoothWeighted(ctx: Readonly<RouteContext>): RouteOutput;
+export declare function builtInStrategy(strategy: 'round-robin' | 'weighted'): typeof roundRobin;

package/dist/route/types.d.ts

@@ -0,0 +1,440 @@
+import { z } from 'zod';
+export declare const RouteModelModeSchema: z.ZodObject<{
+    query: z.ZodString;
+    execute: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    query: string;
+    execute: string;
+}, {
+    query: string;
+    execute: string;
+}>;
+export declare const RouteModelConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodString;
+    model: z.ZodString;
+    weight: z.ZodDefault<z.ZodNumber>;
+    account: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodObject<{
+        query: z.ZodString;
+        execute: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        query: string;
+        execute: string;
+    }, {
+        query: string;
+        execute: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    model: string;
+    provider: string;
+    weight: number;
+    mode?: {
+        query: string;
+        execute: string;
+    } | undefined;
+    effort?: string | undefined;
+    account?: string | undefined;
+}, {
+    id: string;
+    model: string;
+    provider: string;
+    mode?: {
+        query: string;
+        execute: string;
+    } | undefined;
+    effort?: string | undefined;
+    weight?: number | undefined;
+    account?: string | undefined;
+}>;
+export declare const RouteCandidateConfigSchema: z.ZodObject<{
+    id: z.ZodString;
+    provider: z.ZodString;
+    model: z.ZodString;
+    weight: z.ZodDefault<z.ZodNumber>;
+    account: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodObject<{
+        query: z.ZodString;
+        execute: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        query: string;
+        execute: string;
+    }, {
+        query: string;
+        execute: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    model: string;
+    provider: string;
+    weight: number;
+    mode?: {
+        query: string;
+        execute: string;
+    } | undefined;
+    effort?: string | undefined;
+    account?: string | undefined;
+}, {
+    id: string;
+    model: string;
+    provider: string;
+    mode?: {
+        query: string;
+        execute: string;
+    } | undefined;
+    effort?: string | undefined;
+    weight?: number | undefined;
+    account?: string | undefined;
+}>;
+export declare const RouteLinkConfigSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"custom">;
+    run: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "custom";
+    run: string;
+}, {
+    kind: "custom";
+    run: string;
+}>;
+declare const RouteConfigInputSchema: z.ZodEffects<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    strategy: z.ZodEnum<["round-robin", "weighted"]>;
+    chain: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        kind: z.ZodLiteral<"custom">;
+        run: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        kind: "custom";
+        run: string;
+    }, {
+        kind: "custom";
+        run: string;
+    }>, "many">>;
+    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodString;
+        model: z.ZodString;
+        weight: z.ZodDefault<z.ZodNumber>;
+        account: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodObject<{
+            query: z.ZodString;
+            execute: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            query: string;
+            execute: string;
+        }, {
+            query: string;
+            execute: string;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        model: string;
+        provider: string;
+        weight: number;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        account?: string | undefined;
+    }, {
+        id: string;
+        model: string;
+        provider: string;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        weight?: number | undefined;
+        account?: string | undefined;
+    }>, "many">>;
+    candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        provider: z.ZodString;
+        model: z.ZodString;
+        weight: z.ZodDefault<z.ZodNumber>;
+        account: z.ZodOptional<z.ZodString>;
+        effort: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodObject<{
+            query: z.ZodString;
+            execute: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            query: string;
+            execute: string;
+        }, {
+            query: string;
+            execute: string;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        model: string;
+        provider: string;
+        weight: number;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        account?: string | undefined;
+    }, {
+        id: string;
+        model: string;
+        provider: string;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        weight?: number | undefined;
+        account?: string | undefined;
+    }>, "many">>;
+    sticky: z.ZodDefault<z.ZodEnum<["conversation", "none"]>>;
+    defaultModel: z.ZodOptional<z.ZodString>;
+    defaultCandidate: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    strategy: "round-robin" | "weighted";
+    sticky: "none" | "conversation";
+    name?: string | undefined;
+    models?: {
+        id: string;
+        model: string;
+        provider: string;
+        weight: number;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    chain?: {
+        kind: "custom";
+        run: string;
+    }[] | undefined;
+    candidates?: {
+        id: string;
+        model: string;
+        provider: string;
+        weight: number;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    defaultModel?: string | undefined;
+    defaultCandidate?: string | undefined;
+}, {
+    strategy: "round-robin" | "weighted";
+    name?: string | undefined;
+    models?: {
+        id: string;
+        model: string;
+        provider: string;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        weight?: number | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    chain?: {
+        kind: "custom";
+        run: string;
+    }[] | undefined;
+    candidates?: {
+        id: string;
+        model: string;
+        provider: string;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        weight?: number | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    sticky?: "none" | "conversation" | undefined;
+    defaultModel?: string | undefined;
+    defaultCandidate?: string | undefined;
+}>, {
+    strategy: "round-robin" | "weighted";
+    sticky: "none" | "conversation";
+    name?: string | undefined;
+    models?: {
+        id: string;
+        model: string;
+        provider: string;
+        weight: number;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    chain?: {
+        kind: "custom";
+        run: string;
+    }[] | undefined;
+    candidates?: {
+        id: string;
+        model: string;
+        provider: string;
+        weight: number;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    defaultModel?: string | undefined;
+    defaultCandidate?: string | undefined;
+}, {
+    strategy: "round-robin" | "weighted";
+    name?: string | undefined;
+    models?: {
+        id: string;
+        model: string;
+        provider: string;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        weight?: number | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    chain?: {
+        kind: "custom";
+        run: string;
+    }[] | undefined;
+    candidates?: {
+        id: string;
+        model: string;
+        provider: string;
+        mode?: {
+            query: string;
+            execute: string;
+        } | undefined;
+        effort?: string | undefined;
+        weight?: number | undefined;
+        account?: string | undefined;
+    }[] | undefined;
+    sticky?: "none" | "conversation" | undefined;
+    defaultModel?: string | undefined;
+    defaultCandidate?: string | undefined;
+}>;
+export type RouteConfig = {
+    name?: string;
+    strategy: 'round-robin' | 'weighted';
+    chain?: RouteLinkConfig[];
+    models: RouteModelConfig[];
+    sticky: 'conversation' | 'none';
+    defaultModel?: string;
+    candidates?: RouteModelConfig[];
+    defaultCandidate?: string;
+};
+type ParsedRouteConfig = RouteConfig & {
+    candidates: RouteModelConfig[];
+};
+export declare const RouteConfigSchema: z.ZodType<ParsedRouteConfig, z.ZodTypeDef, z.input<typeof RouteConfigInputSchema>>;
+export type RouteModelConfig = z.infer<typeof RouteModelConfigSchema>;
+export type RouteModelMode = z.infer<typeof RouteModelModeSchema>;
+export type RouteCandidateConfig = RouteModelConfig;
+export type RouteLinkConfig = z.infer<typeof RouteLinkConfigSchema>;
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type RouteHealth = 'ok' | 'unknown' | 'blocked';
+export type RouteMode = 'query' | 'execute';
+export interface RouteModel {
+    id: string;
+    provider: string;
+    model: string;
+    weight: number;
+    eligible: boolean;
+    health: RouteHealth;
+    resetAt?: number;
+}
+export type RouteCandidate = RouteModel;
+export interface RouteContext {
+    v: 1;
+    route: {
+        id: string;
+        revision: string;
+    };
+    request: {
+        taskId: string;
+        threadId: string | null;
+        agentId: string;
+        mode: RouteMode;
+    };
+    now: number;
+    models: RouteModel[];
+    candidates: RouteModel[];
+    state: JsonValue;
+}
+export interface RouteSelectOutput {
+    type: 'select';
+    modelId: string;
+    nextState: JsonValue;
+    reason: string;
+}
+export interface RoutePassOutput {
+    type: 'pass';
+}
+export type RouteOutput = RouteSelectOutput | RoutePassOutput;
+export type RouteFunction = (ctx: Readonly<RouteContext>) => RouteOutput | unknown | Promise<RouteOutput | unknown>;
+export type RouteRunner = (ctx: RouteContext, timeoutMs?: number) => Promise<unknown>;
+export interface RouteBlockedCause {
+    candidateId: string;
+    provider: string;
+    accountRef: string;
+    model?: string;
+    source: string;
+    scope: 'account' | 'account-model';
+    resetAt: number;
+}
+export interface RouteLinkError {
+    link: string;
+    code: string;
+    message: string;
+}
+export interface RouteDecision {
+    routeId: string;
+    taskId: string;
+    configRevision: string;
+    candidateId: string;
+    provider: string;
+    model: string;
+    reason: string;
+    eligibleIds: string[];
+    blockedCauses: RouteBlockedCause[];
+    linkErrors: RouteLinkError[];
+    createdAt: number;
+}
+export interface RouteQuotaObservation {
+    provider: string;
+    accountRef: string;
+    model?: string;
+    status: 'ok' | 'blocked';
+    source: string;
+    resetAt?: number;
+}
+export interface RouteRequest {
+    taskId: string;
+    threadId: string | null;
+    agentId: string;
+    mode: RouteMode;
+    namedAcpSession?: boolean;
+}
+export {};

package/dist/schema/agent-send-history.d.ts

@@ -0,0 +1,85 @@
+export declare const agent_send_history: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "agent_send_history";
+    schema: undefined;
+    columns: {
+        workspace_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "workspace_id";
+            tableName: "agent_send_history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        actor_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "actor_id";
+            tableName: "agent_send_history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        agent_id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "agent_id";
+            tableName: "agent_send_history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        last_accepted_at: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "last_accepted_at";
+            tableName: "agent_send_history";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+    };
+    dialect: "sqlite";
+}>;
+export type AgentSendHistory = typeof agent_send_history.$inferSelect;
+export type NewAgentSendHistory = typeof agent_send_history.$inferInsert;