@muxoai/sdk 1.2.3 → 1.4.2

package/dist/config.d.ts

@@ -0,0 +1,36 @@
+import type { ClerkEnv } from "./clerk.js";
+export declare const ROOT_DIR: string;
+export interface MuxoConfig {
+    port: number;
+    baseUrl: string;
+    dbPath: string;
+    composioApiKey: string;
+    composioInstantApiKey: string;
+    composioBaseUrl: string;
+    composioWebhookSecret: string;
+    composioWebhookSubscriptionId: string;
+    composioProjectId: string;
+    composioOrgId: string;
+    composioUserId: string;
+    stripeSecretKey: string;
+    stripePublishableKey: string;
+    stripeApiBaseUrl: string;
+    stripeProvisioningApiVersion: string;
+    stripeProjectId: string;
+    stripeConnectedAccountId?: string;
+    stripeStarterPriceId: string;
+    stripeCreditsPriceId: string;
+    stripeWebhookSecret: string;
+    stripeProjectsWorkdir: string;
+    stripeBinaryPath: string;
+    supermemoryApiKey: string;
+    supermemoryBaseUrl: string;
+    publicWebUrl: string;
+    docsUrl: string;
+    vaultMasterKey: Buffer;
+    /** Clerk sign-in settings; sign-in stays password-based unless CLERK_PUBLISHABLE_KEY is set. */
+    clerkEnv?: ClerkEnv & {
+        MUXO_OWNER_EMAILS?: string;
+    };
+}
+export declare function getConfig(): MuxoConfig;

package/dist/config.js

@@ -0,0 +1,115 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import crypto from "node:crypto";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export const ROOT_DIR = path.resolve(__dirname, "..");
+function loadDotEnv(envPath) {
+    if (!fs.existsSync(envPath))
+        return;
+    const raw = fs.readFileSync(envPath, "utf8");
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIdx = trimmed.indexOf("=");
+        if (eqIdx <= 0)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        const val = trimmed.slice(eqIdx + 1).trim().replace(/^["']|["']$/g, "");
+        if (process.env[key] === undefined || process.env[key] === "") {
+            process.env[key] = val;
+        }
+    }
+}
+if (process.env.MUXO_EXTERNAL_MODE !== "1") {
+    loadDotEnv(path.join(ROOT_DIR, ".env"));
+}
+function resolveStripeBinary() {
+    const candidates = [
+        process.env.STRIPE_BINARY_PATH,
+        "/Users/test/.local/bin/stripe",
+        "/opt/homebrew/bin/stripe",
+        "/usr/local/bin/stripe",
+        "stripe",
+    ].filter(Boolean);
+    for (const candidate of candidates) {
+        if (candidate === "stripe" || fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return "stripe";
+}
+function deriveVaultMasterKey() {
+    const seed = process.env.MUXO_VAULT_SECRET ||
+        process.env.COMPOSIO_API_KEY ||
+        "muxo-local-vault-default-seed-v1";
+    return crypto.scryptSync(seed, "muxo-aes256gcm-salt-v1", 32);
+}
+export function getConfig() {
+    const port = Number(process.env.PORT || 4310);
+    const isExternalPackage = process.env.MUXO_EXTERNAL_MODE === "1" ||
+        !fs.existsSync(path.join(ROOT_DIR, "src", "server.ts"));
+    const dataDir = process.env.MUXO_HOME
+        ? path.join(process.env.MUXO_HOME, "data")
+        : isExternalPackage
+            ? path.join(os.homedir(), ".muxo", "data")
+            : path.join(ROOT_DIR, "data");
+    if (!fs.existsSync(dataDir)) {
+        fs.mkdirSync(dataDir, { recursive: true });
+    }
+    return {
+        port,
+        baseUrl: process.env.MUXO_BASE_URL || `http://localhost:${port}`,
+        dbPath: process.env.MUXO_DB_PATH || path.join(dataDir, "muxo.db"),
+        composioApiKey: process.env.MUXO_EXTERNAL_MODE === "1"
+            ? ""
+            : process.env.COMPOSIO_API_KEY || process.env.COMPOSIO_INSTANT_API_KEY || "",
+        composioInstantApiKey: process.env.MUXO_EXTERNAL_MODE === "1"
+            ? ""
+            : process.env.COMPOSIO_INSTANT_API_KEY || process.env.COMPOSIO_API_KEY || "",
+        composioBaseUrl: process.env.COMPOSIO_BASE_URL || "https://backend.composio.dev/api/v3",
+        composioWebhookSecret: process.env.MUXO_EXTERNAL_MODE === "1"
+            ? ""
+            : process.env.COMPOSIO_WEBHOOK_SECRET || "",
+        composioWebhookSubscriptionId: process.env.COMPOSIO_WEBHOOK_SUBSCRIPTION_ID || "",
+        composioProjectId: process.env.COMPOSIO_PROJECT_ID || "",
+        composioOrgId: process.env.COMPOSIO_ORG_ID || "",
+        composioUserId: process.env.COMPOSIO_USER_ID || "",
+        stripeSecretKey: process.env.MUXO_EXTERNAL_MODE === "1"
+            ? ""
+            : process.env.STRIPE_SECRET_KEY || "",
+        stripePublishableKey: process.env.MUXO_EXTERNAL_MODE === "1"
+            ? ""
+            : process.env.STRIPE_PUBLISHABLE_KEY || "",
+        stripeApiBaseUrl: process.env.STRIPE_API_BASE_URL || "https://api.stripe.com",
+        stripeProvisioningApiVersion: process.env.STRIPE_PROVISIONING_API_VERSION || "2026-09-30.preview",
+        stripeProjectId: process.env.STRIPE_PROJECT_ID || "",
+        stripeConnectedAccountId: process.env.STRIPE_CONNECTED_ACCOUNT_ID ||
+            process.env.STRIPE_CONTEXT ||
+            "",
+        stripeStarterPriceId: process.env.STRIPE_STARTER_PRICE_ID || "",
+        stripeCreditsPriceId: process.env.STRIPE_CREDITS_PRICE_ID || "",
+        stripeWebhookSecret: process.env.STRIPE_WEBHOOK_SECRET || "",
+        stripeProjectsWorkdir: process.env.MUXO_EXTERNAL_MODE === "1"
+            ? "/nonexistent/external-user-workdir"
+            : process.env.STRIPE_PROJECTS_WORKDIR ||
+                "/Users/test/Documents/muxo2/muxo-production-qualification",
+        stripeBinaryPath: resolveStripeBinary(),
+        supermemoryApiKey: process.env.MUXO_EXTERNAL_MODE === "1"
+            ? ""
+            : process.env.SUPERMEMORY_API_KEY || "",
+        supermemoryBaseUrl: process.env.SUPERMEMORY_BASE_URL || "https://api.supermemory.ai",
+        publicWebUrl: process.env.MUXO_PUBLIC_WEB_URL || "https://muxo.ai",
+        docsUrl: process.env.MUXO_DOCS_URL || "https://docs.muxo.ai",
+        vaultMasterKey: deriveVaultMasterKey(),
+        clerkEnv: {
+            CLERK_PUBLISHABLE_KEY: process.env.CLERK_PUBLISHABLE_KEY,
+            CLERK_SECRET_KEY: process.env.CLERK_SECRET_KEY,
+            CLERK_JWT_KEY: process.env.CLERK_JWT_KEY,
+            CLERK_AUTHORIZED_PARTIES: process.env.CLERK_AUTHORIZED_PARTIES,
+            MUXO_OWNER_EMAILS: process.env.MUXO_OWNER_EMAILS,
+        },
+    };
+}

package/dist/durable-workflow.d.ts

@@ -0,0 +1,45 @@
+/** Cloud provisioning pipeline modelled on Cloudflare Workflows primitives, shared by the Node engine and the edge worker. */
+import { MuxoToolError } from "./mcp-schema.js";
+export type DurableWorkflowStepStatus = "completed" | "waiting" | "pending";
+export interface DurableWorkflowStep {
+    name: string;
+    primitive: "step.do" | "step.waitForEvent" | "step.sleep";
+    status: DurableWorkflowStepStatus;
+    output?: Record<string, unknown>;
+    completedAt?: string;
+}
+export interface DurableWorkflow {
+    id: string;
+    workspaceId: string;
+    workflowType: "cloud_provisioning_pipeline" | "approval_handoff_pipeline";
+    status: "running" | "waiting_for_event" | "completed" | "failed";
+    provider: string;
+    serviceRef: string;
+    resourceId: string | null;
+    steps: DurableWorkflowStep[];
+    createdAt: string;
+    updatedAt: string;
+}
+export declare const WORKFLOW_RESOURCE_COMPLETED_EVENT = "v2.provisioning.resource.completed";
+export declare function workflowNotFoundError(workflowId: string): MuxoToolError;
+export declare function normalizeWorkflowTarget(params: {
+    provider?: string;
+    serviceRef?: string;
+}): {
+    provider: string;
+    serviceRef: string;
+};
+export declare function createCloudProvisioningWorkflow(params: {
+    id: string;
+    workspaceId: string;
+    resourceId: string;
+    provider: string;
+    serviceRef: string;
+    region?: string;
+    apiVersion?: string;
+}): DurableWorkflow;
+/** Completes every outstanding step once the resource-completed event (or a manual advance) arrives. */
+export declare function completeCloudProvisioningWorkflow(wf: DurableWorkflow, params: {
+    secretKeys: string[];
+    triggerEvent?: unknown;
+}): DurableWorkflow;

package/dist/durable-workflow.js

@@ -0,0 +1,90 @@
+/** Cloud provisioning pipeline modelled on Cloudflare Workflows primitives, shared by the Node engine and the edge worker. */
+import { MuxoToolError } from "./mcp-schema.js";
+export const WORKFLOW_RESOURCE_COMPLETED_EVENT = "v2.provisioning.resource.completed";
+export function workflowNotFoundError(workflowId) {
+    return new MuxoToolError(`Durable workflow not found: ${workflowId}`, {
+        code: "workflow_not_found",
+        statusCode: 404,
+        payload: { workflowId },
+    });
+}
+export function normalizeWorkflowTarget(params) {
+    return {
+        provider: (params.provider || "neon").toLowerCase().trim(),
+        serviceRef: (params.serviceRef || "postgres").toLowerCase().trim(),
+    };
+}
+export function createCloudProvisioningWorkflow(params) {
+    const now = new Date().toISOString();
+    return {
+        id: params.id,
+        workspaceId: params.workspaceId,
+        workflowType: "cloud_provisioning_pipeline",
+        status: "waiting_for_event",
+        provider: params.provider,
+        serviceRef: params.serviceRef,
+        resourceId: params.resourceId,
+        steps: [
+            {
+                name: "check_stripe_v2_eligibility",
+                primitive: "step.do",
+                status: "completed",
+                output: { status: "eligible", apiVersion: params.apiVersion || "2026-09-30.preview" },
+                completedAt: now,
+            },
+            {
+                name: "ensure_payment_profile_and_provider_connection",
+                primitive: "step.do",
+                status: "completed",
+                output: { provider: params.provider, paymentProfileStatus: "active" },
+                completedAt: now,
+            },
+            {
+                name: "create_v2_provisioning_resource",
+                primitive: "step.do",
+                status: "completed",
+                output: {
+                    resourceId: params.resourceId,
+                    provider: params.provider,
+                    service_ref: params.serviceRef,
+                    region: params.region || "aws-us-east-1",
+                },
+                completedAt: now,
+            },
+            {
+                name: "wait_for_v2_provisioning_resource_completed",
+                primitive: "step.waitForEvent",
+                status: "waiting",
+                output: { expectedEvent: WORKFLOW_RESOURCE_COMPLETED_EVENT, resourceId: params.resourceId },
+            },
+            {
+                name: "reveal_access_configuration_and_seal_vault",
+                primitive: "step.do",
+                status: "pending",
+            },
+        ],
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+/** Completes every outstanding step once the resource-completed event (or a manual advance) arrives. */
+export function completeCloudProvisioningWorkflow(wf, params) {
+    const now = new Date().toISOString();
+    for (const step of wf.steps) {
+        if (step.status === "completed")
+            continue;
+        step.status = "completed";
+        step.completedAt = now;
+        if (step.name === "reveal_access_configuration_and_seal_vault") {
+            step.output = {
+                vaultEncrypted: true,
+                cipher: "AES-256-GCM",
+                secretKeys: params.secretKeys,
+                triggerEvent: params.triggerEvent || WORKFLOW_RESOURCE_COMPLETED_EVENT,
+            };
+        }
+    }
+    wf.status = "completed";
+    wf.updatedAt = now;
+    return wf;
+}