@muxoai/platform 1.4.2 → 1.4.3

package/dist/oss-suite.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Unified Open-Source & Commercial Enterprise Suite (Runtime-Agnostic: Node.js + Cloudflare Workers):
+ * 1. AWS Cedar & Open Policy Agent (OPA / Rego) Policy-as-Code Compiler & Evaluator
+ * 2. OpenTelemetry (OTel GenAI / MCP Semantic Conventions) OTLP JSON & Langfuse Trace Exporter
+ * 3. Turnkey Commercial Business Saga Playbooks (backed by Temporal-compatible DurableWorkflows)
+ * 4. FinOps & Commercial ROI Unit-Economics Analytics
+ */
+import { type DurableWorkflow } from "./durable-workflow.js";
+import type { ActionPlan, ByokKeyRecord, ExecutionReceipt, ExecutionRun, GovernancePolicy, HumanFriendlyExplanation, ProviderLane, ProvisionedResource, RiskLevel, TemporalGraphFact, Workspace } from "./types.js";
+export interface CompiledPolicyAsCodeBundle {
+    workspaceId: string;
+    workspaceSlug: string;
+    generatedAt: string;
+    engines: ["aws-cedar-4.x", "open-policy-agent-rego-v1"];
+    cedarSchemaVersion: "4.0";
+    cedarPolicyText: string;
+    opaRegoText: string;
+    statements: Array<{
+        id: string;
+        effect: "permit" | "forbid";
+        description: string;
+        statement: string;
+    }>;
+    cedar: {
+        schemaNamespace: "Muxo";
+        statementsCount: number;
+        policyText: string;
+        statements: Array<{
+            id: string;
+            effect: "permit" | "forbid";
+            description: string;
+            statement: string;
+        }>;
+    };
+    opa: {
+        packageName: "muxo.authz";
+        rulesCount: number;
+        regoText: string;
+    };
+    plainEnglishSummary: string[];
+    explanation: HumanFriendlyExplanation;
+}
+export interface PolicyAsCodeEvaluationResult {
+    workspaceId: string;
+    toolSlug: string;
+    riskLevel: RiskLevel;
+    creditCost: number;
+    allowed: boolean;
+    decision: "ALLOW" | "DENY" | "REQUIRE_APPROVAL";
+    policyDecision: "allow" | "deny" | "require_approval";
+    cedarResult: {
+        decision: "ALLOW" | "DENY";
+        determiningPolicies: string[];
+        errors: string[];
+    };
+    opaResult: {
+        allow: boolean;
+        decision: "allow" | "deny" | "review";
+        denyReasons: string[];
+        reviewReasons: string[];
+    };
+    matchedStatements: string[];
+    remediationForLlm: string;
+    compiledBundle: CompiledPolicyAsCodeBundle;
+}
+export declare function compileWorkspacePolicyToCedarAndRego(policy: GovernancePolicy, workspace: Pick<Workspace, "id" | "slug" | "name">): CompiledPolicyAsCodeBundle;
+export declare function evaluateCedarAndOpaPolicy(params: {
+    policy: GovernancePolicy;
+    workspace: Pick<Workspace, "id" | "slug" | "name">;
+    toolSlug: string;
+    input?: Record<string, unknown>;
+    riskLevel?: RiskLevel;
+    creditCost?: number;
+    lane?: string;
+}): PolicyAsCodeEvaluationResult;
+export interface OtelSpanAttribute {
+    key: string;
+    value: {
+        stringValue?: string;
+        intValue?: number;
+        boolValue?: boolean;
+    };
+}
+export interface OtelTraceExportBundle {
+    workspaceId: string;
+    workspaceSlug: string;
+    exportedAt: string;
+    protocol: "OTLP/HTTP-JSON-v1";
+    semanticConventions: ["gen_ai.1.29.0", "mcp.2026-07-28", "muxo.governance.v5"];
+    w3cTraceParent: string;
+    w3cTraceContextSample: string;
+    spansCount: number;
+    otlpPayload: {
+        resourceSpans: OtelTraceExportBundle["resourceSpans"];
+    };
+    resourceSpans: Array<{
+        resource: {
+            attributes: OtelSpanAttribute[];
+        };
+        scopeSpans: Array<{
+            scope: {
+                name: string;
+                version: string;
+            };
+            spans: Array<{
+                traceId: string;
+                spanId: string;
+                parentSpanId?: string;
+                traceparent: string;
+                name: string;
+                kind: "SPAN_KIND_SERVER" | "SPAN_KIND_CLIENT";
+                startTimeUnixNano: string;
+                endTimeUnixNano: string;
+                status: {
+                    code: "STATUS_CODE_OK" | "STATUS_CODE_ERROR";
+                    message?: string;
+                };
+                attributes: OtelSpanAttribute[];
+            }>;
+        }>;
+    }>;
+    langfuseBatch: Array<{
+        id: string;
+        type: "trace-create" | "span-create";
+        timestamp: string;
+        body: Record<string, unknown>;
+    }>;
+}
+export declare function buildOtelTraceExport(params: {
+    workspace: Pick<Workspace, "id" | "slug" | "name" | "tier">;
+    runs: ExecutionRun[];
+    receipts: ExecutionReceipt[];
+    plans?: ActionPlan[];
+    version?: string;
+}): OtelTraceExportBundle;
+export interface CommercialPlaybookDefinition {
+    slug: "fullstack-cloud-bootstrap" | "competitor-seo-growth-brief" | "incident-containment-audit" | "customer-release-readiness";
+    name: string;
+    persona: "Engineering & DevOps" | "Marketing & Growth" | "SecOps & Compliance" | "Product & Founders";
+    summary: string;
+    commercialValue: string;
+    estimatedMinutesSaved: number;
+    creditCost: number;
+    defaultProvider: string;
+    defaultServiceRef: string;
+    steps: Array<{
+        name: string;
+        toolSlug: string;
+        primitive: "step.do" | "step.waitForEvent";
+        compensationAction?: string;
+        description: string;
+    }>;
+}
+export declare const MUXO_COMMERCIAL_PLAYBOOKS: CommercialPlaybookDefinition[];
+export declare function getCommercialPlaybook(slug: string): CommercialPlaybookDefinition | null;
+export declare function buildPlaybookSagaExecution(params: {
+    id: string;
+    workspaceId: string;
+    workspaceSlug: string;
+    playbook: CommercialPlaybookDefinition;
+    input?: Record<string, unknown>;
+}): {
+    playbook: CommercialPlaybookDefinition;
+    workflow: DurableWorkflow;
+    temporalFact: {
+        subject: string;
+        predicate: string;
+        object: string;
+        summary: string;
+        episodeId: string;
+    };
+};
+export interface CommercialRoiReport {
+    workspaceId: string;
+    workspaceSlug: string;
+    workspaceName: string;
+    tier: string;
+    generatedAt: string;
+    unitEconomics: {
+        creditsBalance: number;
+        totalRunsAnalyzed: number;
+        succeededRunsCount: number;
+        byokZeroCreditRunsCount: number;
+        managedFundedRunsCount: number;
+        totalCreditsConsumed: number;
+        byokCreditsSaved: number;
+        byokDollarsSavedUsd: number;
+        estimatedEngineeringMinutesSaved: number;
+        estimatedEngineeringHoursSaved: number;
+        estimatedLaborValueSavedUsd: number;
+        preventedPolicyViolationsCount: number;
+        activeCloudResourcesCount: number;
+        activeBiTemporalFactsCount: number;
+        configuredByokProviders: string[];
+    };
+    laneBreakdown: Record<ProviderLane, {
+        runsCount: number;
+        creditsConsumed: number;
+        estimatedMinutesSaved: number;
+    }>;
+    recommendations: Array<{
+        id: string;
+        category: "byok_savings" | "cloud_consolidation" | "governance_safety" | "playbook_automation";
+        title: string;
+        impact: string;
+        actionCommand: string;
+    }>;
+    explanation: HumanFriendlyExplanation;
+}
+export declare function buildCommercialRoiReport(params: {
+    workspace: Workspace;
+    runs: ExecutionRun[];
+    plans?: ActionPlan[];
+    resources: ProvisionedResource[];
+    byokKeys: ByokKeyRecord[];
+    temporalFacts: TemporalGraphFact[];
+}): CommercialRoiReport;