@ailu-ai/contracts 2.0.0

package/dist/node-metadata.d.ts.map

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

package/dist/node-metadata.js

@@ -0,0 +1,184 @@
+import { z } from "zod";
+import { ModelTierDtoSchema } from "./catalog.js";
+/**
+ * The SHARED CARRIER for catalog-backed graph nodes.
+ *
+ * A graph node that is a catalog COMPONENT carries `node.metadata.component =
+ * { kind, params }`; a catalog AGENT node carries `node.metadata.agent =
+ * { provider?, model?, tier?, system?, toolNames?, maxIterations?,
+ *   suspendForApproval?, approvalToolNames?, outputChannel?, outputStyle?,
+ *   contextBudget?, todosChannel?, enableFs?, resolvedMiddleware? }`.
+ *
+ * The graph editor EMITS these into `node.metadata`; the API run path READS
+ * `node.metadata` to assemble `EngineSpec.componentNodes` (kind + params) and
+ * `EngineSpec.agents` (the agent spec). Typing the carrier here keeps it
+ * end-to-end typed across the API ↔ Studio boundary even though the underlying
+ * `NodeDefinitionDto.metadata` stays an open `Record<string, unknown>`.
+ */
+/** A catalog COMPONENT carrier: a `kind` plus its parameter bag. */
+export const ComponentNodeMetadataSchema = z.object({
+    /** One of `ComponentRegistry::kinds()` (e.g. "promptBuilder") or an integration name. */
+    kind: z.string().min(1),
+    /** The component's parameter bag; validated by the native factory at assemble time. */
+    params: z.record(z.string(), z.unknown())
+});
+/** A catalog AGENT carrier: mirrors the engine `AgentSpec` (all fields optional in the editor). */
+export const AgentNodeMetadataSchema = z.object({
+    provider: z.string().min(1).optional(),
+    model: z.string().min(1).optional(),
+    tier: ModelTierDtoSchema.optional(),
+    /** A custom OpenAI-compatible endpoint (`model.openaiCompatible`) and the env var naming its key. */
+    baseURL: z.string().min(1).optional(),
+    apiKeyEnv: z.string().min(1).optional(),
+    system: z.string().optional(),
+    toolNames: z.array(z.string().min(1)).optional(),
+    /** Each tool's description and input JSON Schema, as the LLM sees them. */
+    toolSpecs: z
+        .array(z.object({
+        name: z.string().min(1),
+        description: z.string().optional(),
+        jsonSchema: z.record(z.string(), z.unknown()).optional()
+    }))
+        .optional(),
+    maxIterations: z.number().int().min(1).optional(),
+    suspendForApproval: z.boolean().optional(),
+    approvalToolNames: z.array(z.string().min(1)).optional(),
+    outputChannel: z.string().min(1).optional(),
+    /** ADR 0014 — terse output directive on the system prompt. */
+    outputStyle: z.literal("terse").optional(),
+    /** ADR 0014 — cap (chars) on the agent's seed message (the injected `Input`/`State` dump). */
+    contextBudget: z.number().int().min(1).optional(),
+    /** ADR 0022/0023 — durable channel the agent's `writeTodos` list is persisted into. */
+    todosChannel: z.string().min(1).optional(),
+    /** ADR 0030 phase 9e — channel carrying the run's multimodal input blocks. */
+    inputBlocksChannel: z.string().min(1).optional(),
+    /** The only channels the agent is shown in its seed state (context isolation). */
+    visibleChannels: z.array(z.string().min(1)).optional(),
+    /** ADR 0026 phase 11 — governed long-term memory overlay (namespace tenant-scoped). */
+    memory: z
+        .object({
+        namespace: z.string().min(1),
+        topK: z.number().int().min(1).optional(),
+        recall: z.enum(["vector", "graph", "both"]).optional()
+    })
+        .optional(),
+    /** ADR 0035 phase 12 — governed skills overlay (progressive disclosure; namespace tenant-scoped). */
+    skills: z
+        .object({
+        namespace: z.string().min(1),
+        /** Explicit `name@version` pins — the must-apply playbooks. */
+        required: z.array(z.string().min(1)).optional(),
+        /** Cap on advisory (vector-selected) skills. */
+        advisoryK: z.number().int().min(0).optional()
+    })
+        .optional(),
+    /** ADR 0024 phase 2c/2d — opt this agent into the governed virtual filesystem tools. */
+    enableFs: z.boolean().optional(),
+    /**
+     * ADR 0075 (issue #566 G3) — attach an external MCP server's tools to this agent, mid-run. The
+     * value references a tenant-owned `connector_connections` row (`provider: "mcp"`), resolved and
+     * connected at run start; every discovered tool is unconditionally `requiresApproval` (an MCP
+     * server is code Ailu does not control and cannot statically vet). Distinct from `toolNames`/
+     * `approvalToolNames` above — those are re-derived at run start to include the tools this
+     * connection discovers, since the tool set isn't known until the server is actually queried.
+     */
+    mcpConnectionId: z.string().min(1).optional(),
+    /**
+     * Issue #566 G19 — attach one or more governed action-tool connectors to this agent, mid-run.
+     * Keyed by provider id (e.g. `"slack"`), value is a tenant-owned `connector_connections` row id.
+     * Same resolution shape as `mcpConnectionId` (control plane resolves the connection, discovers
+     * that provider's action tools, merges them into `toolNames`/`approvalToolNames` before the run
+     * reaches this carrier — the Rust engine never resolves a connection itself), generalized to a
+     * map so adding the NEXT provider (Linear, Salesforce, ...) never needs another engine field/
+     * release — only a new product-side adapter keyed into the same map.
+     */
+    actionConnections: z.record(z.string().min(1), z.string().min(1)).optional(),
+    /**
+     * ADR 0025 phase 3d — the resolved EFFICIENCY middleware list. A discriminated union of
+     * efficiency-only kinds (compress / terse / contextBudget): a GOVERNANCE kind (redact /
+     * approvalGate / fsPolicy) fails this schema BY CONSTRUCTION, so any consumer that runs it
+     * (e.g. `readAgentMetadata`) drops the malformed agent. This is a **type-level + validation
+     * guarantee** for callers that opt to validate; it is NOT auto-applied on the persisted
+     * catalog run path today (that path reads an unvalidated carrier — the RUNTIME enforcer
+     * there is the Rust bridge, whose match only honours efficiency kinds and ignores governance
+     * kinds). The SDK's `toRustAgentConfig` throw-gate covers the in-process builder path.
+     */
+    resolvedMiddleware: z
+        .array(z.discriminatedUnion("kind", [
+        z.object({ kind: z.literal("compress") }),
+        z.object({ kind: z.literal("terse") }),
+        z.object({
+            kind: z.literal("contextBudget"),
+            params: z.object({ chars: z.number().int().min(1) })
+        }),
+        z.object({
+            kind: z.literal("reflection"),
+            params: z.object({ threshold: z.number().min(0).max(1).optional() }).optional()
+        }),
+        // ADR 0029 phase 8 — structured output (efficiency kind; the schema rides in params).
+        z.object({
+            kind: z.literal("structuredOutput"),
+            params: z.object({
+                schema: z.record(z.unknown()),
+                name: z.string().optional(),
+                strict: z.boolean().optional(),
+                mode: z.enum(["required", "lenient"]).optional(),
+                retryCap: z.number().int().min(0).optional()
+            })
+        })
+    ]))
+        .optional()
+});
+/**
+ * A catalog MAP-AGENTS carrier (ADR 0027 phase 4b — dynamic fan-out): run `subAgent` once per item
+ * in the `overChannel` array and collect the per-item results (in input order) into `joinAt`. The
+ * sub-agent is itself an agent carrier (same shape as a plain agent node → deepagents parity: skills,
+ * memory, fs, planning all apply to each spawn). Mirrors the engine `MapAgentSpec`.
+ */
+export const MapAgentNodeMetadataSchema = z.object({
+    /** Channel holding the array of items to fan the sub-agent out over. */
+    overChannel: z.string().min(1),
+    /** Channel the array of per-item results lands in (one entry per item, in input order). */
+    joinAt: z.string().min(1),
+    /** The sub-agent run per item — a full agent carrier. */
+    subAgent: AgentNodeMetadataSchema,
+    /** When true, a spawn that needs approval suspends the whole map (default false). */
+    suspendForApproval: z.boolean().optional()
+});
+/**
+ * The slice of `node.metadata` the catalog carrier owns. All keys are optional;
+ * a node carries at most one (a component OR an agent OR a mapAgents fan-out).
+ * Other metadata keys are untouched.
+ */
+export const CatalogNodeMetadataSchema = z
+    .object({
+    component: ComponentNodeMetadataSchema.optional(),
+    agent: AgentNodeMetadataSchema.optional(),
+    mapAgents: MapAgentNodeMetadataSchema.optional()
+})
+    .passthrough();
+/** Narrow an open metadata bag to its component carrier, if present and valid. */
+export const readComponentMetadata = (metadata) => {
+    if (metadata === undefined) {
+        return undefined;
+    }
+    const parsed = ComponentNodeMetadataSchema.safeParse(metadata.component);
+    return parsed.success ? parsed.data : undefined;
+};
+/** Narrow an open metadata bag to its agent carrier, if present and valid. */
+export const readAgentMetadata = (metadata) => {
+    if (metadata === undefined) {
+        return undefined;
+    }
+    const parsed = AgentNodeMetadataSchema.safeParse(metadata.agent);
+    return parsed.success ? parsed.data : undefined;
+};
+/** Narrow an open metadata bag to its mapAgents (dynamic fan-out) carrier, if present and valid. */
+export const readMapAgentMetadata = (metadata) => {
+    if (metadata === undefined) {
+        return undefined;
+    }
+    const parsed = MapAgentNodeMetadataSchema.safeParse(metadata.mapAgents);
+    return parsed.success ? parsed.data : undefined;
+};
+//# sourceMappingURL=node-metadata.js.map

package/dist/node-metadata.js.map

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

package/dist/node-metadata.test.d.ts

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

package/dist/node-metadata.test.d.ts.map

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

package/dist/node-metadata.test.js

@@ -0,0 +1,126 @@
+import { describe, expect, it } from "vitest";
+import { AgentNodeMetadataSchema, MapAgentNodeMetadataSchema, readAgentMetadata, readMapAgentMetadata } from "./node-metadata.js";
+/**
+ * The agent carrier is the API↔Studio boundary for a persisted agent node. The
+ * ADR 0014 (outputStyle/contextBudget) and ADR 0022/0023 (todosChannel) knobs must
+ * SURVIVE a parse round-trip — Zod strips unknown keys, so a field missing from the
+ * schema would be silently dropped on the catalog/Studio path (the bug this guards).
+ */
+describe("@ailu-ai/contracts — AgentNodeMetadataSchema", () => {
+    it("keeps outputStyle, contextBudget, todosChannel and enableFs through a parse round-trip", () => {
+        const carrier = {
+            provider: "anthropic",
+            toolNames: ["writeTodos"],
+            outputChannel: "agentResult",
+            outputStyle: "terse",
+            contextBudget: 4000,
+            todosChannel: "__todos",
+            enableFs: true
+        };
+        const parsed = AgentNodeMetadataSchema.parse(carrier);
+        expect(parsed.outputStyle).toBe("terse");
+        expect(parsed.contextBudget).toBe(4000);
+        expect(parsed.todosChannel).toBe("__todos");
+        expect(parsed.enableFs).toBe(true);
+    });
+    it("reads the carrier off an open metadata bag without dropping the new fields", () => {
+        const meta = readAgentMetadata({ agent: { provider: "anthropic", todosChannel: "__todos" } });
+        expect(meta?.todosChannel).toBe("__todos");
+    });
+    it("rejects an outputStyle other than terse", () => {
+        expect(AgentNodeMetadataSchema.safeParse({ outputStyle: "verbose" }).success).toBe(false);
+    });
+    it("leaves the new fields undefined when omitted", () => {
+        const parsed = AgentNodeMetadataSchema.parse({ provider: "anthropic" });
+        expect(parsed.todosChannel).toBeUndefined();
+        expect(parsed.outputStyle).toBeUndefined();
+        expect(parsed.contextBudget).toBeUndefined();
+        expect(parsed.mcpConnectionId).toBeUndefined();
+    });
+    // ADR 0075 (issue #566 G3) — the MCP connection carrier.
+    it("keeps mcpConnectionId through a parse round-trip", () => {
+        const parsed = AgentNodeMetadataSchema.parse({ provider: "anthropic", mcpConnectionId: "conn-1" });
+        expect(parsed.mcpConnectionId).toBe("conn-1");
+    });
+    it("rejects an empty mcpConnectionId", () => {
+        expect(AgentNodeMetadataSchema.safeParse({ mcpConnectionId: "" }).success).toBe(false);
+    });
+    // Issue #566 G19 — governed action-tool connectors, generalized (keyed by provider id).
+    it("keeps actionConnections through a parse round-trip", () => {
+        const parsed = AgentNodeMetadataSchema.parse({
+            provider: "anthropic",
+            actionConnections: { slack: "conn-1" }
+        });
+        expect(parsed.actionConnections).toEqual({ slack: "conn-1" });
+    });
+    it("rejects an actionConnections entry with an empty value", () => {
+        expect(AgentNodeMetadataSchema.safeParse({ actionConnections: { slack: "" } }).success).toBe(false);
+    });
+    // ADR 0025 phase 3d — the persisted resolvedMiddleware gate.
+    it("keeps an efficiency-only resolvedMiddleware list through a parse round-trip", () => {
+        const parsed = AgentNodeMetadataSchema.parse({
+            provider: "anthropic",
+            resolvedMiddleware: [
+                { kind: "compress" },
+                { kind: "terse" },
+                { kind: "contextBudget", params: { chars: 4000 } }
+            ]
+        });
+        expect(parsed.resolvedMiddleware?.map((m) => m.kind)).toEqual([
+            "compress",
+            "terse",
+            "contextBudget"
+        ]);
+    });
+    it("rejects a GOVERNANCE kind in resolvedMiddleware by construction (the persisted reject gate)", () => {
+        // A governance kind is not in the efficiency-only discriminated union → safeParse fails →
+        // readAgentMetadata drops the whole malformed agent. An ungoverned stack is unrepresentable.
+        for (const kind of ["redact", "approvalGate", "fsPolicy"]) {
+            expect(AgentNodeMetadataSchema.safeParse({ resolvedMiddleware: [{ kind }] }).success).toBe(false);
+            expect(readAgentMetadata({ agent: { provider: "anthropic", resolvedMiddleware: [{ kind }] } })).toBeUndefined();
+        }
+    });
+    it("rejects a contextBudget entry missing its chars param", () => {
+        expect(AgentNodeMetadataSchema.safeParse({ resolvedMiddleware: [{ kind: "contextBudget" }] }).success).toBe(false);
+    });
+    // ADR 0025 phase 3e — reflection variant.
+    it("accepts a reflection entry (bare and with a threshold), rejects an out-of-range threshold", () => {
+        expect(AgentNodeMetadataSchema.safeParse({ resolvedMiddleware: [{ kind: "reflection" }] }).success).toBe(true);
+        expect(AgentNodeMetadataSchema.safeParse({
+            resolvedMiddleware: [{ kind: "reflection", params: { threshold: 0.9 } }]
+        }).success).toBe(true);
+        expect(AgentNodeMetadataSchema.safeParse({
+            resolvedMiddleware: [{ kind: "reflection", params: { threshold: 1.5 } }]
+        }).success).toBe(false);
+    });
+});
+// ADR 0027 phase 4b / ADR 0049 — the mapAgents (dynamic fan-out) carrier.
+describe("@ailu-ai/contracts — MapAgentNodeMetadataSchema", () => {
+    it("keeps overChannel/joinAt/subAgent through a parse round-trip", () => {
+        const parsed = MapAgentNodeMetadataSchema.parse({
+            overChannel: "items",
+            joinAt: "results",
+            subAgent: { provider: "anthropic", system: "Summarize the item.", enableFs: true },
+            suspendForApproval: true
+        });
+        expect(parsed.overChannel).toBe("items");
+        expect(parsed.joinAt).toBe("results");
+        expect(parsed.subAgent.system).toBe("Summarize the item.");
+        expect(parsed.subAgent.enableFs).toBe(true);
+        expect(parsed.suspendForApproval).toBe(true);
+    });
+    it("requires overChannel, joinAt and subAgent", () => {
+        expect(MapAgentNodeMetadataSchema.safeParse({ joinAt: "r", subAgent: {} }).success).toBe(false);
+        expect(MapAgentNodeMetadataSchema.safeParse({ overChannel: "i", subAgent: {} }).success).toBe(false);
+        expect(MapAgentNodeMetadataSchema.safeParse({ overChannel: "i", joinAt: "r" }).success).toBe(false);
+    });
+    it("readMapAgentMetadata narrows the carrier off an open metadata bag", () => {
+        const meta = readMapAgentMetadata({
+            mapAgents: { overChannel: "items", joinAt: "results", subAgent: { provider: "anthropic" } }
+        });
+        expect(meta?.overChannel).toBe("items");
+        expect(readMapAgentMetadata({ agent: { provider: "anthropic" } })).toBeUndefined();
+        expect(readMapAgentMetadata(undefined)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=node-metadata.test.js.map

package/dist/node-metadata.test.js.map

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

package/dist/observability.d.ts

@@ -0,0 +1,154 @@
+import { z } from "zod";
+export declare const SpanDtoSchema: z.ZodObject<{
+    id: z.ZodString;
+    traceId: z.ZodString;
+    parentSpanId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    runId: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodString;
+    endedAt: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["ok", "error"]>;
+    attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "ok" | "error";
+    id: string;
+    name: string;
+    traceId: string;
+    startedAt: string;
+    attributes: Record<string, unknown>;
+    runId?: string | undefined;
+    nodeId?: string | undefined;
+    error?: string | undefined;
+    parentSpanId?: string | undefined;
+    endedAt?: string | undefined;
+}, {
+    status: "ok" | "error";
+    id: string;
+    name: string;
+    traceId: string;
+    startedAt: string;
+    attributes: Record<string, unknown>;
+    runId?: string | undefined;
+    nodeId?: string | undefined;
+    error?: string | undefined;
+    parentSpanId?: string | undefined;
+    endedAt?: string | undefined;
+}>;
+export declare const TraceDtoSchema: z.ZodObject<{
+    traceId: z.ZodString;
+    spans: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        traceId: z.ZodString;
+        parentSpanId: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        runId: z.ZodOptional<z.ZodString>;
+        nodeId: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodString;
+        endedAt: z.ZodOptional<z.ZodString>;
+        status: z.ZodEnum<["ok", "error"]>;
+        attributes: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "ok" | "error";
+        id: string;
+        name: string;
+        traceId: string;
+        startedAt: string;
+        attributes: Record<string, unknown>;
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+        error?: string | undefined;
+        parentSpanId?: string | undefined;
+        endedAt?: string | undefined;
+    }, {
+        status: "ok" | "error";
+        id: string;
+        name: string;
+        traceId: string;
+        startedAt: string;
+        attributes: Record<string, unknown>;
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+        error?: string | undefined;
+        parentSpanId?: string | undefined;
+        endedAt?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    traceId: string;
+    spans: {
+        status: "ok" | "error";
+        id: string;
+        name: string;
+        traceId: string;
+        startedAt: string;
+        attributes: Record<string, unknown>;
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+        error?: string | undefined;
+        parentSpanId?: string | undefined;
+        endedAt?: string | undefined;
+    }[];
+}, {
+    traceId: string;
+    spans: {
+        status: "ok" | "error";
+        id: string;
+        name: string;
+        traceId: string;
+        startedAt: string;
+        attributes: Record<string, unknown>;
+        runId?: string | undefined;
+        nodeId?: string | undefined;
+        error?: string | undefined;
+        parentSpanId?: string | undefined;
+        endedAt?: string | undefined;
+    }[];
+}>;
+export declare const MetricDtoSchema: z.ZodObject<{
+    name: z.ZodString;
+    value: z.ZodNumber;
+    unit: z.ZodString;
+    tags: z.ZodRecord<z.ZodString, z.ZodString>;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    name: string;
+    timestamp: string;
+    unit: string;
+    tags: Record<string, string>;
+}, {
+    value: number;
+    name: string;
+    timestamp: string;
+    unit: string;
+    tags: Record<string, string>;
+}>;
+export declare const AlertRuleDtoSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    metric: z.ZodString;
+    operator: z.ZodEnum<["gt", "gte", "lt", "lte", "eq"]>;
+    threshold: z.ZodNumber;
+    enabled: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    metric: string;
+    operator: "eq" | "gt" | "gte" | "lt" | "lte";
+    threshold: number;
+    enabled: boolean;
+}, {
+    id: string;
+    name: string;
+    metric: string;
+    operator: "eq" | "gt" | "gte" | "lt" | "lte";
+    threshold: number;
+    enabled: boolean;
+}>;
+export type TraceDto = z.infer<typeof TraceDtoSchema>;
+export type SpanDto = z.infer<typeof SpanDtoSchema>;
+export type MetricDto = z.infer<typeof MetricDtoSchema>;
+export type AlertRuleDto = z.infer<typeof AlertRuleDtoSchema>;
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYxB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGzB,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAM1B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/observability.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+export const SpanDtoSchema = z.object({
+    id: z.string().min(1),
+    traceId: z.string().min(1),
+    parentSpanId: z.string().min(1).optional(),
+    name: z.string().min(1),
+    runId: z.string().min(1).optional(),
+    nodeId: z.string().min(1).optional(),
+    startedAt: z.string().datetime(),
+    endedAt: z.string().datetime().optional(),
+    status: z.enum(["ok", "error"]),
+    attributes: z.record(z.string(), z.unknown()),
+    error: z.string().optional()
+});
+export const TraceDtoSchema = z.object({
+    traceId: z.string().min(1),
+    spans: z.array(SpanDtoSchema)
+});
+export const MetricDtoSchema = z.object({
+    name: z.string().min(1),
+    value: z.number(),
+    unit: z.string().min(1),
+    tags: z.record(z.string(), z.string()),
+    timestamp: z.string().datetime()
+});
+export const AlertRuleDtoSchema = z.object({
+    id: z.string().min(1),
+    name: z.string().min(1),
+    metric: z.string().min(1),
+    operator: z.enum(["gt", "gte", "lt", "lte", "eq"]),
+    threshold: z.number(),
+    enabled: z.boolean()
+});
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACrB,CAAC,CAAC"}

package/dist/pii.d.ts

@@ -0,0 +1,88 @@
+import { z } from "zod";
+/**
+ * PII redaction DTOs (ADR 0008). A per-namespace policy decides whether personal data is
+ * detected, redacted before reaching a model, or blocks the operation. Mirrors the router
+ * policy shape.
+ */
+export declare const PiiLevelSchema: z.ZodEnum<["off", "detect", "redact", "block"]>;
+export type PiiLevel = z.infer<typeof PiiLevelSchema>;
+/** Body for PUT /pii/namespace/:ns/policy (owner-only). */
+export declare const SetPiiPolicyDtoSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<["off", "detect", "redact", "block"]>>;
+    entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    threshold: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    threshold?: number | undefined;
+    level?: "off" | "detect" | "redact" | "block" | undefined;
+    entities?: string[] | undefined;
+}, {
+    threshold?: number | undefined;
+    level?: "off" | "detect" | "redact" | "block" | undefined;
+    entities?: string[] | undefined;
+}>;
+export type SetPiiPolicyDto = z.infer<typeof SetPiiPolicyDtoSchema>;
+/** The resolved policy for a namespace. */
+export declare const PiiPolicyDtoSchema: z.ZodObject<{
+    namespace: z.ZodString;
+    level: z.ZodEnum<["off", "detect", "redact", "block"]>;
+    entities: z.ZodArray<z.ZodString, "many">;
+    threshold: z.ZodNumber;
+    canWrite: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    namespace: string;
+    canWrite: boolean;
+    threshold: number;
+    level: "off" | "detect" | "redact" | "block";
+    entities: string[];
+}, {
+    namespace: string;
+    canWrite: boolean;
+    threshold: number;
+    level: "off" | "detect" | "redact" | "block";
+    entities: string[];
+}>;
+export type PiiPolicyDto = z.infer<typeof PiiPolicyDtoSchema>;
+/** A single detection (entity type, confidence, span). */
+export declare const PiiFindingDtoSchema: z.ZodObject<{
+    entity: z.ZodString;
+    score: z.ZodNumber;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    score: number;
+    entity: string;
+    start: number;
+    end: number;
+}, {
+    score: number;
+    entity: string;
+    start: number;
+    end: number;
+}>;
+export type PiiFindingDto = z.infer<typeof PiiFindingDtoSchema>;
+/**
+ * Wire contract for the native gateway seam (ADR 0008 phase 2). The Rust engine POSTs the
+ * outbound LLM texts (system + messages) to the control plane, which returns them redacted in
+ * the same order. Same length in, same length out.
+ */
+export declare const PiiRedactBatchDtoSchema: z.ZodObject<{
+    texts: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    texts: string[];
+}, {
+    texts: string[];
+}>;
+export type PiiRedactBatchDto = z.infer<typeof PiiRedactBatchDtoSchema>;
+/** `blocked` is true when a `block`-level policy matched — the engine then fails the call. */
+export declare const PiiRedactBatchResultDtoSchema: z.ZodObject<{
+    texts: z.ZodArray<z.ZodString, "many">;
+    blocked: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    texts: string[];
+    blocked: boolean;
+}, {
+    texts: string[];
+    blocked: boolean;
+}>;
+export type PiiRedactBatchResultDto = z.infer<typeof PiiRedactBatchResultDtoSchema>;
+//# sourceMappingURL=pii.d.ts.map

package/dist/pii.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pii.d.ts","sourceRoot":"","sources":["../src/pii.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,eAAO,MAAM,cAAc,iDAA+C,CAAC;AAC3E,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,2CAA2C;AAC3C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,0DAA0D;AAC1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,8FAA8F;AAC9F,eAAO,MAAM,6BAA6B;;;;;;;;;EAGxC,CAAC;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC"}