@muxoai/sdk 1.2.3 → 1.3.0

package/dist/store.d.ts

@@ -0,0 +1,216 @@
+import { DatabaseSync } from "node:sqlite";
+import type { ActionPlan, ApiKeyRecord, ByokKeyRecord, ConnectionRecord, ExecutionReceipt, ExecutionRun, GovernanceDecisionRecord, GovernancePolicy, LedgerEntry, MemoryContextSummary, ProviderLane, ProvisionedResource, RiskLevel, SupplierSettlement, SupplierSettlementSummary, User, Workspace, WorkspaceMemoryRecord } from "./types.js";
+export declare const BYOK_PROVIDER_CATALOG: Record<string, {
+    category: "llm" | "supplier";
+    envVarName: string;
+    label: string;
+}>;
+export declare class MuxoStore {
+    readonly db: DatabaseSync;
+    private readonly vaultKey;
+    constructor(dbPath: string, vaultKey: Buffer);
+    private initSchema;
+    encryptSecrets(workspaceId: string, secrets: Record<string, string>): string;
+    decryptSecrets(workspaceId: string, payloadHex: string | null): Record<string, string>;
+    ensureDefaultWorkspace(): {
+        user: User;
+        workspace: Workspace;
+        defaultApiKey?: string;
+    };
+    private hashPassword;
+    private hashToken;
+    registerUser(params: {
+        email: string;
+        name: string;
+        password: string;
+        workspaceName?: string;
+    }): {
+        user: User;
+        workspace: Workspace;
+        sessionToken: string;
+    };
+    loginUser(email: string, password: string): {
+        user: User;
+        workspace: Workspace;
+        sessionToken: string;
+    } | null;
+    createSession(userId: string, workspaceId: string): string;
+    resolveAuthToken(token: string): {
+        user: User;
+        workspace: Workspace;
+        authType: "session" | "api_key";
+        actorId: string;
+    } | null;
+    getUser(userId: string): User | null;
+    getWorkspace(workspaceId: string): Workspace | null;
+    updateWorkspacePolicy(workspaceId: string, policy: Partial<GovernancePolicy>): Workspace;
+    createApiKey(params: {
+        workspaceId: string;
+        name: string;
+        environment?: "live" | "test";
+        scopes?: string[];
+    }): {
+        record: ApiKeyRecord;
+        secretKey: string;
+    };
+    listApiKeys(workspaceId: string): ApiKeyRecord[];
+    revokeApiKey(workspaceId: string, keyId: string): boolean;
+    upsertConnection(params: {
+        workspaceId: string;
+        lane: ProviderLane;
+        providerSlug: string;
+        providerName: string;
+        status: ConnectionRecord["status"];
+        externalAccountId?: string | null;
+        redirectUrl?: string | null;
+        metadata?: Record<string, unknown>;
+    }): ConnectionRecord;
+    getConnection(id: string): ConnectionRecord | null;
+    listConnections(workspaceId: string): ConnectionRecord[];
+    upsertResource(params: {
+        workspaceId: string;
+        resourceName: string;
+        providerSlug: string;
+        providerName: string;
+        serviceSlug: string;
+        planSlug?: string | null;
+        status: ProvisionedResource["status"];
+        secrets?: Record<string, string>;
+        externalResourceId?: string | null;
+        metadata?: Record<string, unknown>;
+    }): ProvisionedResource;
+    getResource(workspaceId: string, resourceNameOrId: string): ProvisionedResource | null;
+    listResources(workspaceId: string): ProvisionedResource[];
+    getDecryptedWorkspaceEnv(workspaceId: string): Record<string, string>;
+    normalizeByokProvider(providerInput: string): {
+        provider: string;
+        category: "llm" | "supplier";
+        envVarName: string;
+    };
+    setByokKey(workspaceId: string, providerInput: string, secretKey: string): ByokKeyRecord;
+    getByokKey(workspaceId: string, providerInput: string): string | null;
+    deleteByokKey(workspaceId: string, providerInput: string): boolean;
+    listByokKeys(workspaceId: string): ByokKeyRecord[];
+    hasByokForLane(workspaceId: string, lane: ProviderLane, toolSlug?: string): boolean;
+    createPlan(params: {
+        workspaceId: string;
+        actorId: string;
+        toolSlug: string;
+        upstreamSlug: string;
+        lane: ProviderLane;
+        riskLevel: RiskLevel;
+        input: Record<string, unknown>;
+        reason: string;
+        creditCost: number;
+        approvalStatus: ActionPlan["approvalStatus"];
+        decisionRecord?: GovernanceDecisionRecord | null;
+        memoryContext?: MemoryContextSummary | null;
+    }): ActionPlan;
+    getPlan(workspaceId: string, planId: string): ActionPlan | null;
+    listPlans(workspaceId: string, limit?: number): ActionPlan[];
+    updatePlanApproval(params: {
+        workspaceId: string;
+        planId: string;
+        approvalStatus: "approved" | "rejected";
+        approvedBy: string;
+    }): ActionPlan;
+    createRun(plan: ActionPlan, actorId: string): ExecutionRun;
+    finalizeRun(params: {
+        workspaceId: string;
+        runId: string;
+        status: "succeeded" | "failed" | "cancelled";
+        output?: Record<string, unknown> | null;
+        error?: string | null;
+        actionsMetered: number;
+        creditsMetered: number;
+        durationMs: number;
+        decisionRecord?: GovernanceDecisionRecord | null;
+    }): {
+        run: ExecutionRun;
+        receipt: ExecutionReceipt;
+    };
+    private issueReceipt;
+    verifyReceipt(receipt: ExecutionReceipt): boolean;
+    getRun(workspaceId: string, runId: string): ExecutionRun | null;
+    listRuns(workspaceId: string, limit?: number): ExecutionRun[];
+    getReceipt(workspaceId: string, receiptIdOrRunId: string): ExecutionReceipt | null;
+    listReceipts(workspaceId: string, limit?: number): ExecutionReceipt[];
+    markStripeEventProcessed(eventId: string): boolean;
+    upgradeWorkspaceToStarter(params: {
+        workspaceId: string;
+        stripeCustomerId?: string | null;
+        stripeSubscriptionId?: string | null;
+        referenceId: string;
+        bonusCredits?: number;
+    }): Workspace;
+    addWorkspaceCredits(params: {
+        workspaceId: string;
+        credits: number;
+        referenceId: string;
+        description: string;
+    }): Workspace;
+    addLedgerEntry(params: {
+        workspaceId: string;
+        kind: LedgerEntry["kind"];
+        actionsDelta: number;
+        creditsDelta: number;
+        balanceAfter: number;
+        referenceId: string | null;
+        description: string;
+    }): LedgerEntry;
+    computeSupplierSettlement(lane: ProviderLane, toolSlug: string, creditCost: number, settlementStatus?: "settled_by_muxo_master_wallet" | "planned_muxo_master_wallet" | "settled_by_customer_byok" | "planned_customer_byok", workspaceId?: string): SupplierSettlement;
+    getSupplierSettlementSummary(workspaceId: string): SupplierSettlementSummary;
+    listLedgerEntries(workspaceId: string, limit?: number): LedgerEntry[];
+    saveMemoryRecord(params: {
+        workspaceId: string;
+        namespace: string;
+        documentId: string;
+        title: string;
+        content: string;
+        kind: WorkspaceMemoryRecord["kind"];
+        metadata?: Record<string, unknown>;
+    }): WorkspaceMemoryRecord;
+    listMemoryRecords(workspaceId: string, limit?: number): WorkspaceMemoryRecord[];
+    deleteMemoryRecord(workspaceId: string, idOrDocId: string): WorkspaceMemoryRecord | null;
+    createAutonomousAgentSignup(params?: {
+        agentName?: string;
+        harness?: string;
+    }): {
+        user: User;
+        workspace: Workspace;
+        apiKey: string;
+        apiKeyRecord: ApiKeyRecord;
+    };
+    getLatestClaimForWorkspace(workspaceId: string): {
+        claimSlug: string;
+        targetEmail: string;
+        status: "invited" | "claimed";
+        claimedAt: string | null;
+        expiresAt: string;
+    } | null;
+    createAgentClaim(params: {
+        workspaceId: string;
+        email: string;
+        baseUrl: string;
+    }): {
+        claimSlug: string;
+        claimUrl: string;
+        targetEmail: string;
+        status: "invited" | "claimed";
+        expiresAt: string;
+    };
+    redeemAgentClaim(claimSlug: string): {
+        claimSlug: string;
+        workspace: Workspace;
+        targetEmail: string;
+        status: "claimed";
+        claimedAt: string;
+    } | null;
+    private mapUser;
+    private mapWorkspace;
+    private mapConnection;
+    private mapResource;
+    private mapPlan;
+    private mapRun;
+    private mapReceipt;
+}