@ailu-ai/contracts 2.0.0

package/dist/catalog.js

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import { ExampleGraphDtoSchema } from "./graphs.js";
+/**
+ * The component / prebuilt-agent / model-tier catalog contract: the shape the API
+ * serves so Studio can render the building-block library without importing the engine
+ * or the SDK. The SDK owns the source metadata (`@ailu-ai/graph-sdk` `catalog`); the
+ * API validates it against these schemas and forwards it unchanged.
+ */
+/** A single parameter a component factory accepts. */
+export const ComponentParamDtoSchema = z.object({
+    name: z.string().min(1),
+    type: z.string().min(1),
+    required: z.boolean(),
+    description: z.string().min(1)
+});
+/** The category buckets a component falls into in the library. */
+export const ComponentCategoryDtoSchema = z.enum([
+    "prompt",
+    "validation",
+    "parsing",
+    "routing",
+    "retrieval",
+    "text",
+    "data",
+    "integration",
+    // --- wave two: Haystack-gap categories ---
+    "splitter",
+    "generation",
+    "evaluation",
+    "writer"
+]);
+/** One entry in the component library: a `kind` plus its presentation + params. */
+export const ComponentCatalogEntryDtoSchema = z.object({
+    kind: z.string().min(1),
+    title: z.string().min(1),
+    category: ComponentCategoryDtoSchema,
+    description: z.string().min(1),
+    params: z.array(ComponentParamDtoSchema),
+    /** `true` for vendor-I/O integration components (httpFetch / webSearch). */
+    integration: z.boolean()
+});
+/** The four capability tiers, wire-compatible (camelCase) with the engine `ModelTier`. */
+export const ModelTierDtoSchema = z.enum(["frontier", "balanced", "fast", "creative"]);
+/** One entry in the prebuilt-agent catalog, mirroring the Rust `PrebuiltAgent` table. */
+export const PrebuiltAgentCatalogEntryDtoSchema = z.object({
+    name: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string().min(1),
+    tier: ModelTierDtoSchema,
+    tools: z.array(z.string().min(1)),
+    suspendForApproval: z.boolean(),
+    outputChannel: z.string().min(1)
+});
+/** Describes one capability tier plus its recommended per-provider models. */
+export const ModelTierInfoDtoSchema = z.object({
+    tier: ModelTierDtoSchema,
+    description: z.string().min(1),
+    /** `provider -> model` recommended defaults for this tier. */
+    models: z.record(z.string(), z.string())
+});
+/** The full catalog the API serves to Studio. */
+export const CatalogDtoSchema = z.object({
+    components: z.array(ComponentCatalogEntryDtoSchema),
+    prebuilt: z.array(PrebuiltAgentCatalogEntryDtoSchema),
+    tiers: z.array(ModelTierInfoDtoSchema),
+    /** SDK-authored example graphs, served so Studio can render + import them. */
+    exampleGraphs: z.array(ExampleGraphDtoSchema)
+});
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}

package/dist/catalog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=catalog.test.d.ts.map

package/dist/catalog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.test.d.ts","sourceRoot":"","sources":["../src/catalog.test.ts"],"names":[],"mappings":""}

package/dist/catalog.test.js

@@ -0,0 +1,98 @@
+import { describe, expect, it } from "vitest";
+import { CatalogDtoSchema } from "./catalog.js";
+/**
+ * The catalog contract is the API↔Studio boundary for the building-block library.
+ * We assert a representative `CatalogDto` parses cleanly and round-trips unchanged, so
+ * the API can validate the SDK metadata against this schema and forward it.
+ */
+describe("@ailu-ai/contracts — catalog", () => {
+    const sample = {
+        components: [
+            {
+                kind: "promptBuilder",
+                title: "Prompt Builder",
+                category: "prompt",
+                description: "Render {{var}} placeholders from the channels into a target channel.",
+                params: [
+                    { name: "template", type: "string", required: true, description: "Template with {{var}} placeholders." },
+                    { name: "into", type: "string", required: true, description: "Channel the rendered string is written into." }
+                ],
+                integration: false
+            },
+            {
+                kind: "httpFetch",
+                title: "HTTP Fetch",
+                category: "integration",
+                description: "Fetch a URL via an injectable fetch impl.",
+                params: [
+                    { name: "into", type: "string", required: true, description: "Channel receiving the result." }
+                ],
+                integration: true
+            }
+        ],
+        prebuilt: [
+            {
+                name: "summarizer",
+                title: "Summarizer",
+                description: "Condenses input text into a short, faithful summary.",
+                tier: "fast",
+                tools: [],
+                suspendForApproval: false,
+                outputChannel: "summary"
+            },
+            {
+                name: "refundApprover",
+                title: "Refund Approver",
+                description: "Decides whether to issue a refund behind a human approval gate.",
+                tier: "balanced",
+                tools: ["refund"],
+                suspendForApproval: true,
+                outputChannel: "refundDecision"
+            }
+        ],
+        tiers: [
+            {
+                tier: "fast",
+                description: "Lowest-latency, lowest-cost models for high-volume simple tasks.",
+                models: { anthropic: "claude-haiku-4-5", mistral: "mistral-small-latest", ollama: "mistral" }
+            }
+        ],
+        exampleGraphs: [
+            {
+                slug: "publish-flow",
+                name: "Publish flow",
+                description: "A human-in-the-loop flow: write, approval gate, publish.",
+                definition: {
+                    version: "1.0.0",
+                    name: "publish-flow",
+                    channels: {
+                        draft: { type: "string", reducer: "replace", default: "" }
+                    },
+                    nodes: [
+                        { id: "write", type: "action", label: "write" },
+                        { id: "review", type: "human-gate", label: "review" }
+                    ],
+                    edges: [{ id: "write->review", from: "write", to: "review", type: "default" }],
+                    entryNodeId: "write"
+                }
+            }
+        ]
+    };
+    it("parses a representative CatalogDto", () => {
+        const result = CatalogDtoSchema.safeParse(sample);
+        expect(result.success).toBe(true);
+    });
+    it("round-trips a CatalogDto through parse unchanged", () => {
+        const parsed = CatalogDtoSchema.parse(sample);
+        expect(parsed).toEqual(sample);
+    });
+    it("rejects an invalid tier", () => {
+        const bad = { ...sample, prebuilt: [{ ...sample.prebuilt[0], tier: "ultra" }] };
+        expect(CatalogDtoSchema.safeParse(bad).success).toBe(false);
+    });
+    it("rejects an unknown component category", () => {
+        const bad = { ...sample, components: [{ ...sample.components[0], category: "magic" }] };
+        expect(CatalogDtoSchema.safeParse(bad).success).toBe(false);
+    });
+});
+//# sourceMappingURL=catalog.test.js.map

package/dist/catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.test.js","sourceRoot":"","sources":["../src/catalog.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAmB,MAAM,cAAc,CAAC;AAEjE;;;;GAIG;AACH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,MAAM,MAAM,GAAe;QACzB,UAAU,EAAE;YACV;gBACE,IAAI,EAAE,eAAe;gBACrB,KAAK,EAAE,gBAAgB;gBACvB,QAAQ,EAAE,QAAQ;gBAClB,WAAW,EAAE,sEAAsE;gBACnF,MAAM,EAAE;oBACN,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qCAAqC,EAAE;oBACxG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8CAA8C,EAAE;iBAC9G;gBACD,WAAW,EAAE,KAAK;aACnB;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,KAAK,EAAE,YAAY;gBACnB,QAAQ,EAAE,aAAa;gBACvB,WAAW,EAAE,2CAA2C;gBACxD,MAAM,EAAE;oBACN,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,+BAA+B,EAAE;iBAC/F;gBACD,WAAW,EAAE,IAAI;aAClB;SACF;QACD,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,YAAY;gBACnB,WAAW,EAAE,sDAAsD;gBACnE,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,EAAE;gBACT,kBAAkB,EAAE,KAAK;gBACzB,aAAa,EAAE,SAAS;aACzB;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,iBAAiB;gBACxB,WAAW,EAAE,iEAAiE;gBAC9E,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,CAAC,QAAQ,CAAC;gBACjB,kBAAkB,EAAE,IAAI;gBACxB,aAAa,EAAE,gBAAgB;aAChC;SACF;QACD,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,kEAAkE;gBAC/E,MAAM,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAE,sBAAsB,EAAE,MAAM,EAAE,SAAS,EAAE;aAC9F;SACF;QACD,aAAa,EAAE;YACb;gBACE,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,0DAA0D;gBACvE,UAAU,EAAE;oBACV,OAAO,EAAE,OAAO;oBAChB,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE;wBACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;qBAC3D;oBACD,KAAK,EAAE;wBACL,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;wBAC/C,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE;qBACtD;oBACD,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;oBAC9E,WAAW,EAAE,OAAO;iBACrB;aACF;SACF;KACF,CAAC;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QAChF,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/compliance.d.ts

@@ -0,0 +1,428 @@
+import { z } from "zod";
+/** EU AI Act risk tiers (simplified): minimal | limited | high. */
+export declare const ComplianceRiskSchema: z.ZodEnum<["minimal", "limited", "high"]>;
+/** One graph in the tenant cartography, with its AI-system inventory + risk classification. */
+export declare const ComplianceGraphEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    nodeCount: z.ZodNumber;
+    agentNodes: z.ZodArray<z.ZodObject<{
+        nodeId: z.ZodString;
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        nodeId: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+    }, {
+        nodeId: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+    }>, "many">;
+    hasHumanGate: z.ZodBoolean;
+    risk: z.ZodEnum<["minimal", "limited", "high"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    nodeCount: number;
+    agentNodes: {
+        nodeId: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+    }[];
+    hasHumanGate: boolean;
+    risk: "minimal" | "limited" | "high";
+}, {
+    id: string;
+    name: string;
+    nodeCount: number;
+    agentNodes: {
+        nodeId: string;
+        provider?: string | undefined;
+        model?: string | undefined;
+    }[];
+    hasHumanGate: boolean;
+    risk: "minimal" | "limited" | "high";
+}>;
+/** A knowledge base's data-quality summary: volume + freshness window. */
+export declare const ComplianceKbEntrySchema: z.ZodObject<{
+    namespace: z.ZodString;
+    documents: z.ZodNumber;
+    oldest: z.ZodOptional<z.ZodString>;
+    newest: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    namespace: string;
+    documents: number;
+    oldest?: string | undefined;
+    newest?: string | undefined;
+}, {
+    namespace: string;
+    documents: number;
+    oldest?: string | undefined;
+    newest?: string | undefined;
+}>;
+/** Tenant-level AI Act cartography + aggregate human-oversight stats. */
+export declare const ComplianceTenantReportDtoSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    graphs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        nodeCount: z.ZodNumber;
+        agentNodes: z.ZodArray<z.ZodObject<{
+            nodeId: z.ZodString;
+            provider: z.ZodOptional<z.ZodString>;
+            model: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            nodeId: string;
+            provider?: string | undefined;
+            model?: string | undefined;
+        }, {
+            nodeId: string;
+            provider?: string | undefined;
+            model?: string | undefined;
+        }>, "many">;
+        hasHumanGate: z.ZodBoolean;
+        risk: z.ZodEnum<["minimal", "limited", "high"]>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        name: string;
+        nodeCount: number;
+        agentNodes: {
+            nodeId: string;
+            provider?: string | undefined;
+            model?: string | undefined;
+        }[];
+        hasHumanGate: boolean;
+        risk: "minimal" | "limited" | "high";
+    }, {
+        id: string;
+        name: string;
+        nodeCount: number;
+        agentNodes: {
+            nodeId: string;
+            provider?: string | undefined;
+            model?: string | undefined;
+        }[];
+        hasHumanGate: boolean;
+        risk: "minimal" | "limited" | "high";
+    }>, "many">;
+    providers: z.ZodArray<z.ZodString, "many">;
+    knowledgeBases: z.ZodArray<z.ZodObject<{
+        namespace: z.ZodString;
+        documents: z.ZodNumber;
+        oldest: z.ZodOptional<z.ZodString>;
+        newest: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        namespace: string;
+        documents: number;
+        oldest?: string | undefined;
+        newest?: string | undefined;
+    }, {
+        namespace: string;
+        documents: number;
+        oldest?: string | undefined;
+        newest?: string | undefined;
+    }>, "many">;
+    supervision: z.ZodObject<{
+        totalApprovals: z.ZodNumber;
+        resolved: z.ZodNumber;
+        selfApprovalViolations: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        totalApprovals: number;
+        resolved: number;
+        selfApprovalViolations: number;
+    }, {
+        totalApprovals: number;
+        resolved: number;
+        selfApprovalViolations: number;
+    }>;
+    generatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    graphs: {
+        id: string;
+        name: string;
+        nodeCount: number;
+        agentNodes: {
+            nodeId: string;
+            provider?: string | undefined;
+            model?: string | undefined;
+        }[];
+        hasHumanGate: boolean;
+        risk: "minimal" | "limited" | "high";
+    }[];
+    providers: string[];
+    knowledgeBases: {
+        namespace: string;
+        documents: number;
+        oldest?: string | undefined;
+        newest?: string | undefined;
+    }[];
+    supervision: {
+        totalApprovals: number;
+        resolved: number;
+        selfApprovalViolations: number;
+    };
+    generatedAt: string;
+}, {
+    tenantId: string;
+    graphs: {
+        id: string;
+        name: string;
+        nodeCount: number;
+        agentNodes: {
+            nodeId: string;
+            provider?: string | undefined;
+            model?: string | undefined;
+        }[];
+        hasHumanGate: boolean;
+        risk: "minimal" | "limited" | "high";
+    }[];
+    providers: string[];
+    knowledgeBases: {
+        namespace: string;
+        documents: number;
+        oldest?: string | undefined;
+        newest?: string | undefined;
+    }[];
+    supervision: {
+        totalApprovals: number;
+        resolved: number;
+        selfApprovalViolations: number;
+    };
+    generatedAt: string;
+}>;
+/** One lifecycle event in a run's decision trail. */
+export declare const ComplianceEventSchema: z.ZodObject<{
+    seq: z.ZodNumber;
+    type: z.ZodString;
+    nodeId: z.ZodNullable<z.ZodString>;
+    at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    at: string;
+    type: string;
+    nodeId: string | null;
+    seq: number;
+}, {
+    at: string;
+    type: string;
+    nodeId: string | null;
+    seq: number;
+}>;
+/** One human-approval record proving oversight (distinctResolver = no self-approval). */
+export declare const ComplianceApprovalSchema: z.ZodObject<{
+    id: z.ZodString;
+    nodeId: z.ZodString;
+    subject: z.ZodString;
+    requestedBy: z.ZodString;
+    resolvedBy: z.ZodNullable<z.ZodString>;
+    distinctResolver: z.ZodBoolean;
+    status: z.ZodString;
+    resolvedAt: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    id: string;
+    nodeId: string;
+    requestedBy: string;
+    subject: string;
+    resolvedBy: string | null;
+    distinctResolver: boolean;
+    resolvedAt: string | null;
+}, {
+    status: string;
+    id: string;
+    nodeId: string;
+    requestedBy: string;
+    subject: string;
+    resolvedBy: string | null;
+    distinctResolver: boolean;
+    resolvedAt: string | null;
+}>;
+/** A data source the run relied on, with provenance (the KB doc + its origin/freshness). */
+export declare const ComplianceSourceSchema: z.ZodObject<{
+    id: z.ZodString;
+    namespace: z.ZodOptional<z.ZodString>;
+    resource: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    namespace?: string | undefined;
+    resource?: string | undefined;
+    timestamp?: string | undefined;
+}, {
+    id: string;
+    namespace?: string | undefined;
+    resource?: string | undefined;
+    timestamp?: string | undefined;
+}>;
+/** Per-run AI Act report: decision traceability + human supervision + data provenance. */
+/** PII-handling evidence for the run (ADR 0008): detections, redactions, blocks. */
+export declare const CompliancePiiEventSchema: z.ZodObject<{
+    type: z.ZodString;
+    count: z.ZodOptional<z.ZodNumber>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    timestamp: string;
+    count?: number | undefined;
+}, {
+    type: string;
+    timestamp: string;
+    count?: number | undefined;
+}>;
+export declare const ComplianceRunReportDtoSchema: z.ZodObject<{
+    runId: z.ZodString;
+    graphId: z.ZodString;
+    status: z.ZodString;
+    risk: z.ZodEnum<["minimal", "limited", "high"]>;
+    traceability: z.ZodArray<z.ZodObject<{
+        seq: z.ZodNumber;
+        type: z.ZodString;
+        nodeId: z.ZodNullable<z.ZodString>;
+        at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        at: string;
+        type: string;
+        nodeId: string | null;
+        seq: number;
+    }, {
+        at: string;
+        type: string;
+        nodeId: string | null;
+        seq: number;
+    }>, "many">;
+    humanSupervision: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        nodeId: z.ZodString;
+        subject: z.ZodString;
+        requestedBy: z.ZodString;
+        resolvedBy: z.ZodNullable<z.ZodString>;
+        distinctResolver: z.ZodBoolean;
+        status: z.ZodString;
+        resolvedAt: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        nodeId: string;
+        requestedBy: string;
+        subject: string;
+        resolvedBy: string | null;
+        distinctResolver: boolean;
+        resolvedAt: string | null;
+    }, {
+        status: string;
+        id: string;
+        nodeId: string;
+        requestedBy: string;
+        subject: string;
+        resolvedBy: string | null;
+        distinctResolver: boolean;
+        resolvedAt: string | null;
+    }>, "many">;
+    dataSources: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        namespace: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        namespace?: string | undefined;
+        resource?: string | undefined;
+        timestamp?: string | undefined;
+    }, {
+        id: string;
+        namespace?: string | undefined;
+        resource?: string | undefined;
+        timestamp?: string | undefined;
+    }>, "many">;
+    piiEvents: z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        timestamp: string;
+        count?: number | undefined;
+    }, {
+        type: string;
+        timestamp: string;
+        count?: number | undefined;
+    }>, "many">;
+    generatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    runId: string;
+    risk: "minimal" | "limited" | "high";
+    generatedAt: string;
+    graphId: string;
+    traceability: {
+        at: string;
+        type: string;
+        nodeId: string | null;
+        seq: number;
+    }[];
+    humanSupervision: {
+        status: string;
+        id: string;
+        nodeId: string;
+        requestedBy: string;
+        subject: string;
+        resolvedBy: string | null;
+        distinctResolver: boolean;
+        resolvedAt: string | null;
+    }[];
+    dataSources: {
+        id: string;
+        namespace?: string | undefined;
+        resource?: string | undefined;
+        timestamp?: string | undefined;
+    }[];
+    piiEvents: {
+        type: string;
+        timestamp: string;
+        count?: number | undefined;
+    }[];
+}, {
+    status: string;
+    runId: string;
+    risk: "minimal" | "limited" | "high";
+    generatedAt: string;
+    graphId: string;
+    traceability: {
+        at: string;
+        type: string;
+        nodeId: string | null;
+        seq: number;
+    }[];
+    humanSupervision: {
+        status: string;
+        id: string;
+        nodeId: string;
+        requestedBy: string;
+        subject: string;
+        resolvedBy: string | null;
+        distinctResolver: boolean;
+        resolvedAt: string | null;
+    }[];
+    dataSources: {
+        id: string;
+        namespace?: string | undefined;
+        resource?: string | undefined;
+        timestamp?: string | undefined;
+    }[];
+    piiEvents: {
+        type: string;
+        timestamp: string;
+        count?: number | undefined;
+    }[];
+}>;
+export type ComplianceRisk = z.infer<typeof ComplianceRiskSchema>;
+export type ComplianceGraphEntry = z.infer<typeof ComplianceGraphEntrySchema>;
+export type ComplianceKbEntry = z.infer<typeof ComplianceKbEntrySchema>;
+export type ComplianceTenantReportDto = z.infer<typeof ComplianceTenantReportDtoSchema>;
+export type ComplianceEvent = z.infer<typeof ComplianceEventSchema>;
+export type ComplianceApproval = z.infer<typeof ComplianceApprovalSchema>;
+export type ComplianceSource = z.infer<typeof ComplianceSourceSchema>;
+export type CompliancePiiEvent = z.infer<typeof CompliancePiiEventSchema>;
+export type ComplianceRunReportDto = z.infer<typeof ComplianceRunReportDtoSchema>;
+//# sourceMappingURL=compliance.d.ts.map

package/dist/compliance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compliance.d.ts","sourceRoot":"","sources":["../src/compliance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,2CAAyC,CAAC;AAE3E,+FAA+F;AAC/F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAarC,CAAC;AAEH,0EAA0E;AAC1E,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,yEAAyE;AACzE,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW1C,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASnC,CAAC;AAEH,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,0FAA0F;AAC1F,oFAAoF;AACpF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAC;AAEH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUvC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AACxF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}