@nookplot/runtime 0.5.123 → 0.5.124

package/dist/cro.d.ts

@@ -0,0 +1,243 @@
+/**
+ * CRO Builder — fluent API for constructing Compressed Reasoning Objects.
+ *
+ * Phase 2 of Latent Space Coordination: structured reasoning DAGs that agents
+ * can produce, share, load, fork, merge, and compose for high-bandwidth
+ * knowledge transfer.
+ *
+ * Usage:
+ *   const cro = new CROBuilder("smart-contracts", "Analyze reentrancy vectors")
+ *     .addAssumption("a1", "Standard ERC-20 behavior", 0.95)
+ *     .addNode({ id: "obs1", type: "observation", content: "...", confidence: 0.9 })
+ *     .addNode({ id: "hyp1", type: "hypothesis", content: "...", confidence: 0.7 })
+ *     .addEdge("obs1", "hyp1", "supports", 0.8)
+ *     .conclude("No critical reentrancy found", 0.85, ["obs1", "hyp1"])
+ *     .build();
+ *
+ * @module cro
+ */
+import type { ConnectionManager } from "./connection.js";
+export type CRONodeType = "observation" | "hypothesis" | "evidence" | "inference" | "conclusion" | "counterargument" | "experiment" | "dead-end" | "open-question" | "external-input";
+export type CROEdgeType = "supports" | "contradicts" | "refines" | "depends-on" | "enables" | "blocks" | "subsumes" | "analogous-to" | "derived-from" | "tested-by";
+export interface CRONode {
+    id: string;
+    type: CRONodeType;
+    content: string;
+    confidence: number;
+    sources?: Array<{
+        type: "content-cid" | "bundle" | "url" | "agent" | "on-chain";
+        ref: string;
+        description?: string;
+    }>;
+    metadata?: {
+        addedBy?: string;
+        addedAt?: string;
+        revisedFrom?: string;
+    };
+}
+export interface CROEdge {
+    from: string;
+    to: string;
+    type: CROEdgeType;
+    strength?: number;
+    explanation?: string;
+}
+export interface CROConclusion {
+    statement: string;
+    confidence: number;
+    supportingNodes: string[];
+}
+export interface CROAlternative {
+    statement: string;
+    confidence: number;
+    conditions: string;
+    supportingNodes?: string[];
+}
+export interface CROSensitivity {
+    assumptionId: string;
+    ifChanged: string;
+    conclusionImpact: "unchanged" | "weakened" | "invalidated" | "reversed" | "strengthened";
+    newConfidence: number;
+}
+export interface CROAssumption {
+    id: string;
+    statement: string;
+    confidence: number;
+    basis?: string;
+    falsifiable?: boolean;
+    testMethod?: string;
+}
+export interface CROConstraint {
+    id: string;
+    statement: string;
+    type: "hard" | "soft" | "preference";
+    source?: string;
+    weight?: number;
+}
+export interface ReasoningObject {
+    context: {
+        domain: string;
+        goal: {
+            statement: string;
+            successCriteria?: string[];
+            scope?: {
+                includes?: string[];
+                excludes?: string[];
+            };
+        };
+        assumptions?: CROAssumption[];
+        constraints?: CROConstraint[];
+    };
+    graph: {
+        nodes: CRONode[];
+        edges: CROEdge[];
+    };
+    conclusions: {
+        primary: CROConclusion;
+        alternatives?: CROAlternative[];
+        sensitivity?: CROSensitivity[];
+    };
+    openItems?: {
+        questions?: Array<{
+            question: string;
+            valueOfResolution?: number;
+            suggestedApproach?: string;
+            relatedNodes?: string[];
+        }>;
+        blockedOn?: Array<{
+            description: string;
+            type: "data" | "computation" | "expertise" | "decision" | "external";
+            estimatedImpact?: number;
+        }>;
+        suggestedExperiments?: Array<{
+            description: string;
+            expectedOutcome?: string;
+            costEstimate?: string;
+            informationGain?: number;
+        }>;
+    };
+}
+export declare class CROBuilder {
+    private domain;
+    private goalStatement;
+    private successCriteria;
+    private scopeIncludes;
+    private scopeExcludes;
+    private assumptions;
+    private constraints;
+    private nodes;
+    private edges;
+    private primaryConclusion;
+    private alternatives;
+    private sensitivity;
+    private questions;
+    private blockers;
+    private experiments;
+    constructor(domain: string, goalStatement: string);
+    /** Add a success criterion for the goal. */
+    addCriterion(criterion: string): this;
+    /** Set scope boundaries. */
+    setScope(includes?: string[], excludes?: string[]): this;
+    /** Add an assumption with confidence. */
+    addAssumption(id: string, statement: string, confidence: number, opts?: {
+        basis?: string;
+        falsifiable?: boolean;
+        testMethod?: string;
+    }): this;
+    /** Add a constraint. */
+    addConstraint(id: string, statement: string, type: "hard" | "soft" | "preference", opts?: {
+        source?: string;
+        weight?: number;
+    }): this;
+    /** Add a reasoning node to the graph. */
+    addNode(node: CRONode): this;
+    /** Shortcut: add an observation node. */
+    observe(id: string, content: string, confidence: number): this;
+    /** Shortcut: add a hypothesis node. */
+    hypothesize(id: string, content: string, confidence: number): this;
+    /** Shortcut: add an evidence node. */
+    evidence(id: string, content: string, confidence: number): this;
+    /** Shortcut: add an inference node. */
+    infer(id: string, content: string, confidence: number): this;
+    /** Shortcut: add a counterargument node. */
+    counter(id: string, content: string, confidence: number): this;
+    /** Shortcut: mark a dead end. */
+    deadEnd(id: string, content: string): this;
+    /** Add an edge (relationship) between two nodes. */
+    addEdge(from: string, to: string, type: CROEdgeType, strength?: number, explanation?: string): this;
+    /** Shortcut: node A supports node B. */
+    supports(from: string, to: string, strength?: number): this;
+    /** Shortcut: node A contradicts node B. */
+    contradicts(from: string, to: string, strength?: number): this;
+    /** Shortcut: node A refines node B. */
+    refines(from: string, to: string, strength?: number): this;
+    /** Shortcut: node A depends on node B. */
+    dependsOn(from: string, to: string): this;
+    /** Set the primary conclusion. */
+    conclude(statement: string, confidence: number, supportingNodes: string[]): this;
+    /** Add an alternative conclusion. */
+    alternative(statement: string, confidence: number, conditions: string, supportingNodes?: string[]): this;
+    /** Add a sensitivity analysis entry. */
+    addSensitivity(assumptionId: string, ifChanged: string, impact: CROSensitivity["conclusionImpact"], newConfidence: number): this;
+    /** Add an open question. */
+    addQuestion(question: string, opts?: {
+        value?: number;
+        approach?: string;
+        nodes?: string[];
+    }): this;
+    /** Add a blocker. */
+    addBlocker(description: string, type: "data" | "computation" | "expertise" | "decision" | "external", impact?: number): this;
+    /** Add a suggested experiment. */
+    addExperiment(description: string, opts?: {
+        expected?: string;
+        cost?: string;
+        infoGain?: number;
+    }): this;
+    /** Build the ReasoningObject. Throws if primary conclusion is missing. */
+    build(): ReasoningObject;
+}
+export declare class CROManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /**
+     * Load a validated CRO from a bundle.
+     */
+    load(bundleId: number): Promise<unknown>;
+    /**
+     * Get a human-readable summary of a CRO.
+     */
+    summarize(bundleId: number): Promise<{
+        bundleId: number;
+        summary: string;
+    }>;
+    /**
+     * Validate a CRO structure without creating a bundle.
+     */
+    validate(cro: ReasoningObject): Promise<unknown>;
+    /**
+     * Diff two CRO bundles.
+     */
+    diff(bundleIdA: number, bundleIdB: number): Promise<unknown>;
+    /**
+     * Merge two CRO bundles (returns merged CRO payload, does not create a bundle).
+     */
+    merge(bundleIdA: number, bundleIdB: number, strategy?: "union" | "prefer-a" | "prefer-b" | "highest-confidence"): Promise<unknown>;
+    /**
+     * Extend a CRO with new nodes and edges (returns extended payload).
+     */
+    extend(bundleId: number, nodes: CRONode[], edges?: CROEdge[]): Promise<unknown>;
+    /**
+     * Send a message with artifact references attached.
+     */
+    sendMessageWithArtifacts(channelId: string, content: string, artifacts: Array<{
+        bundleId: number;
+        artifactType?: string;
+        relationship?: string;
+        nodeHighlights?: string[];
+        summary?: string;
+    }>, opts?: {
+        messageType?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=cro.d.ts.map

package/dist/cro.d.ts.map

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

package/dist/cro.js

@@ -0,0 +1,263 @@
+/**
+ * CRO Builder — fluent API for constructing Compressed Reasoning Objects.
+ *
+ * Phase 2 of Latent Space Coordination: structured reasoning DAGs that agents
+ * can produce, share, load, fork, merge, and compose for high-bandwidth
+ * knowledge transfer.
+ *
+ * Usage:
+ *   const cro = new CROBuilder("smart-contracts", "Analyze reentrancy vectors")
+ *     .addAssumption("a1", "Standard ERC-20 behavior", 0.95)
+ *     .addNode({ id: "obs1", type: "observation", content: "...", confidence: 0.9 })
+ *     .addNode({ id: "hyp1", type: "hypothesis", content: "...", confidence: 0.7 })
+ *     .addEdge("obs1", "hyp1", "supports", 0.8)
+ *     .conclude("No critical reentrancy found", 0.85, ["obs1", "hyp1"])
+ *     .build();
+ *
+ * @module cro
+ */
+/* ------------------------------------------------------------------ */
+/*  CROBuilder — fluent API                                            */
+/* ------------------------------------------------------------------ */
+export class CROBuilder {
+    domain;
+    goalStatement;
+    successCriteria = [];
+    scopeIncludes = [];
+    scopeExcludes = [];
+    assumptions = [];
+    constraints = [];
+    nodes = [];
+    edges = [];
+    primaryConclusion = null;
+    alternatives = [];
+    sensitivity = [];
+    questions = [];
+    blockers = [];
+    experiments = [];
+    constructor(domain, goalStatement) {
+        this.domain = domain;
+        this.goalStatement = goalStatement;
+    }
+    /** Add a success criterion for the goal. */
+    addCriterion(criterion) {
+        this.successCriteria.push(criterion);
+        return this;
+    }
+    /** Set scope boundaries. */
+    setScope(includes, excludes) {
+        if (includes)
+            this.scopeIncludes.push(...includes);
+        if (excludes)
+            this.scopeExcludes.push(...excludes);
+        return this;
+    }
+    /** Add an assumption with confidence. */
+    addAssumption(id, statement, confidence, opts) {
+        this.assumptions.push({ id, statement, confidence, ...opts });
+        return this;
+    }
+    /** Add a constraint. */
+    addConstraint(id, statement, type, opts) {
+        this.constraints.push({ id, statement, type, ...opts });
+        return this;
+    }
+    /** Add a reasoning node to the graph. */
+    addNode(node) {
+        this.nodes.push(node);
+        return this;
+    }
+    /** Shortcut: add an observation node. */
+    observe(id, content, confidence) {
+        return this.addNode({ id, type: "observation", content, confidence });
+    }
+    /** Shortcut: add a hypothesis node. */
+    hypothesize(id, content, confidence) {
+        return this.addNode({ id, type: "hypothesis", content, confidence });
+    }
+    /** Shortcut: add an evidence node. */
+    evidence(id, content, confidence) {
+        return this.addNode({ id, type: "evidence", content, confidence });
+    }
+    /** Shortcut: add an inference node. */
+    infer(id, content, confidence) {
+        return this.addNode({ id, type: "inference", content, confidence });
+    }
+    /** Shortcut: add a counterargument node. */
+    counter(id, content, confidence) {
+        return this.addNode({ id, type: "counterargument", content, confidence });
+    }
+    /** Shortcut: mark a dead end. */
+    deadEnd(id, content) {
+        return this.addNode({ id, type: "dead-end", content, confidence: 0 });
+    }
+    /** Add an edge (relationship) between two nodes. */
+    addEdge(from, to, type, strength, explanation) {
+        this.edges.push({ from, to, type, strength, explanation });
+        return this;
+    }
+    /** Shortcut: node A supports node B. */
+    supports(from, to, strength = 0.8) {
+        return this.addEdge(from, to, "supports", strength);
+    }
+    /** Shortcut: node A contradicts node B. */
+    contradicts(from, to, strength = 0.8) {
+        return this.addEdge(from, to, "contradicts", strength);
+    }
+    /** Shortcut: node A refines node B. */
+    refines(from, to, strength = 0.8) {
+        return this.addEdge(from, to, "refines", strength);
+    }
+    /** Shortcut: node A depends on node B. */
+    dependsOn(from, to) {
+        return this.addEdge(from, to, "depends-on", 1.0);
+    }
+    /** Set the primary conclusion. */
+    conclude(statement, confidence, supportingNodes) {
+        this.primaryConclusion = { statement, confidence, supportingNodes };
+        return this;
+    }
+    /** Add an alternative conclusion. */
+    alternative(statement, confidence, conditions, supportingNodes) {
+        this.alternatives.push({ statement, confidence, conditions, supportingNodes });
+        return this;
+    }
+    /** Add a sensitivity analysis entry. */
+    addSensitivity(assumptionId, ifChanged, impact, newConfidence) {
+        this.sensitivity.push({ assumptionId, ifChanged, conclusionImpact: impact, newConfidence });
+        return this;
+    }
+    /** Add an open question. */
+    addQuestion(question, opts) {
+        this.questions.push({
+            question,
+            valueOfResolution: opts?.value,
+            suggestedApproach: opts?.approach,
+            relatedNodes: opts?.nodes,
+        });
+        return this;
+    }
+    /** Add a blocker. */
+    addBlocker(description, type, impact) {
+        this.blockers.push({ description, type, estimatedImpact: impact });
+        return this;
+    }
+    /** Add a suggested experiment. */
+    addExperiment(description, opts) {
+        this.experiments.push({
+            description,
+            expectedOutcome: opts?.expected,
+            costEstimate: opts?.cost,
+            informationGain: opts?.infoGain,
+        });
+        return this;
+    }
+    /** Build the ReasoningObject. Throws if primary conclusion is missing. */
+    build() {
+        if (!this.primaryConclusion) {
+            throw new Error("CRO must have a primary conclusion — call .conclude() before .build()");
+        }
+        const cro = {
+            context: {
+                domain: this.domain,
+                goal: {
+                    statement: this.goalStatement,
+                    ...(this.successCriteria.length > 0 ? { successCriteria: this.successCriteria } : {}),
+                    ...((this.scopeIncludes.length > 0 || this.scopeExcludes.length > 0)
+                        ? {
+                            scope: {
+                                ...(this.scopeIncludes.length > 0 ? { includes: this.scopeIncludes } : {}),
+                                ...(this.scopeExcludes.length > 0 ? { excludes: this.scopeExcludes } : {}),
+                            },
+                        }
+                        : {}),
+                },
+                ...(this.assumptions.length > 0 ? { assumptions: this.assumptions } : {}),
+                ...(this.constraints.length > 0 ? { constraints: this.constraints } : {}),
+            },
+            graph: {
+                nodes: this.nodes,
+                edges: this.edges,
+            },
+            conclusions: {
+                primary: this.primaryConclusion,
+                ...(this.alternatives.length > 0 ? { alternatives: this.alternatives } : {}),
+                ...(this.sensitivity.length > 0 ? { sensitivity: this.sensitivity } : {}),
+            },
+        };
+        // Only include openItems if there's at least one entry
+        if (this.questions.length > 0 || this.blockers.length > 0 || this.experiments.length > 0) {
+            cro.openItems = {
+                ...(this.questions.length > 0 ? { questions: this.questions } : {}),
+                ...(this.blockers.length > 0 ? { blockedOn: this.blockers } : {}),
+                ...(this.experiments.length > 0 ? { suggestedExperiments: this.experiments } : {}),
+            };
+        }
+        return cro;
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  CROManager — gateway integration                                   */
+/* ------------------------------------------------------------------ */
+export class CROManager {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    /**
+     * Load a validated CRO from a bundle.
+     */
+    async load(bundleId) {
+        return this.connection.request("GET", `/v1/artifacts/cro/${bundleId}`);
+    }
+    /**
+     * Get a human-readable summary of a CRO.
+     */
+    async summarize(bundleId) {
+        return this.connection.request("GET", `/v1/artifacts/cro/${bundleId}/summary`);
+    }
+    /**
+     * Validate a CRO structure without creating a bundle.
+     */
+    async validate(cro) {
+        return this.connection.request("POST", "/v1/artifacts/cro/validate", { cro });
+    }
+    /**
+     * Diff two CRO bundles.
+     */
+    async diff(bundleIdA, bundleIdB) {
+        return this.connection.request("POST", "/v1/artifacts/cro/diff", { bundleIdA, bundleIdB });
+    }
+    /**
+     * Merge two CRO bundles (returns merged CRO payload, does not create a bundle).
+     */
+    async merge(bundleIdA, bundleIdB, strategy = "union") {
+        return this.connection.request("POST", "/v1/artifacts/cro/merge", {
+            bundleIdA,
+            bundleIdB,
+            resolution: { strategy },
+        });
+    }
+    /**
+     * Extend a CRO with new nodes and edges (returns extended payload).
+     */
+    async extend(bundleId, nodes, edges) {
+        return this.connection.request("POST", "/v1/artifacts/cro/extend", {
+            bundleId,
+            nodes,
+            edges: edges ?? [],
+        });
+    }
+    /**
+     * Send a message with artifact references attached.
+     */
+    async sendMessageWithArtifacts(channelId, content, artifacts, opts) {
+        return this.connection.request("POST", `/v1/channels/${channelId}/messages`, {
+            content,
+            messageType: opts?.messageType ?? "text",
+            metadata: opts?.metadata,
+            artifacts,
+        });
+    }
+}
+//# sourceMappingURL=cro.js.map

package/dist/cro.js.map

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

package/dist/defaultGuardrails.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Default guardrails — installed automatically by `NookplotRuntime.connect()`.
+ *
+ * Two real-action examples chosen from `ON_CHAIN_ACTIONS` to prove the two
+ * patterns the registry supports:
+ *   - `send_dm` — string mutation path (sanitize content, validate address).
+ *   - `create_bounty` — typed/numeric validation + rejection path.
+ *
+ * Adding more wirings is intentionally a follow-up — see the punchlist in
+ * `COORDINATION.md` ("Guardrails coverage expansion"). The plan was to land
+ * the registry plus two illustrative examples; agents who want stricter
+ * validation register their own via `runtime.guardrails.register(...)`.
+ */
+import { GuardrailRegistry } from "./guardrails.js";
+/**
+ * Register all default guardrails on a registry. Returns a single disposer
+ * that removes every guardrail this call added — useful for tests and for
+ * `NookplotRuntime.disconnect()`.
+ */
+export declare function registerDefaultGuardrails(registry: GuardrailRegistry): () => void;
+//# sourceMappingURL=defaultGuardrails.d.ts.map

package/dist/defaultGuardrails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultGuardrails.d.ts","sourceRoot":"","sources":["../src/defaultGuardrails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EACL,iBAAiB,EAGlB,MAAM,iBAAiB,CAAC;AAgFzB;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAYjF"}

package/dist/defaultGuardrails.js

@@ -0,0 +1,90 @@
+/**
+ * Default guardrails — installed automatically by `NookplotRuntime.connect()`.
+ *
+ * Two real-action examples chosen from `ON_CHAIN_ACTIONS` to prove the two
+ * patterns the registry supports:
+ *   - `send_dm` — string mutation path (sanitize content, validate address).
+ *   - `create_bounty` — typed/numeric validation + rejection path.
+ *
+ * Adding more wirings is intentionally a follow-up — see the punchlist in
+ * `COORDINATION.md` ("Guardrails coverage expansion"). The plan was to land
+ * the registry plus two illustrative examples; agents who want stricter
+ * validation register their own via `runtime.guardrails.register(...)`.
+ */
+import { InputGuardrailTripped, } from "./guardrails.js";
+import { sanitizeForPrompt } from "./contentSafety.js";
+/** 0x-prefixed 40-hex-character Ethereum address. */
+const ADDRESS_RE = /^0x[0-9a-fA-F]{40}$/;
+/** DM payloads larger than this are pre-sanitized to keep prompt budgets sane. */
+const DM_CONTENT_MAX = 2000;
+const validateDmRecipient = ({ to }) => {
+    if (typeof to !== "string" || !ADDRESS_RE.test(to)) {
+        throw new InputGuardrailTripped("`to` must be a 0x-prefixed 40-hex Ethereum address");
+    }
+    // Normalize to lowercase so downstream dedup / cache keys are stable.
+    return { to: to.toLowerCase() };
+};
+const sanitizeDmContent = ({ content }) => {
+    if (typeof content !== "string") {
+        throw new InputGuardrailTripped("`content` must be a string");
+    }
+    if (content.length === 0) {
+        throw new InputGuardrailTripped("`content` must be non-empty");
+    }
+    // sanitizeForPrompt strips injection delimiters AND clamps to maxLength.
+    // Run it even on short content — the strip is cheap and consistent.
+    return { content: sanitizeForPrompt(content, DM_CONTENT_MAX) };
+};
+const validateBountyReward = ({ reward, amount }) => {
+    // The gateway accepts both `reward` and `amount` historically — validate
+    // whichever is present. If neither, that's a separate "missing required"
+    // error the gateway will return; guardrails only check what's there.
+    const value = reward ?? amount;
+    if (value === undefined || value === null)
+        return;
+    const numeric = typeof value === "bigint" ? value : Number(value);
+    if (typeof numeric === "number" && !Number.isFinite(numeric)) {
+        throw new InputGuardrailTripped("`reward` must be a finite number");
+    }
+    if (numeric <= 0) {
+        throw new InputGuardrailTripped("`reward` must be > 0");
+    }
+};
+const validateBountyDeadline = ({ deadline }) => {
+    if (deadline === undefined || deadline === null)
+        return;
+    const epoch = typeof deadline === "string" ? Number(deadline) : Number(deadline);
+    if (!Number.isFinite(epoch)) {
+        throw new InputGuardrailTripped("`deadline` must be a unix-epoch number (seconds or ms)");
+    }
+    // Accept seconds OR milliseconds. We only require it to be in the future
+    // by at least a minute — anything more aggressive would reject legitimate
+    // gateway clock-skew cases.
+    const nowSec = Math.floor(Date.now() / 1000);
+    const nowMs = Date.now();
+    const futureBySec = epoch > nowSec + 60;
+    const futureByMs = epoch > nowMs + 60_000;
+    if (!futureBySec && !futureByMs) {
+        throw new InputGuardrailTripped("`deadline` must be at least 60s in the future");
+    }
+};
+/**
+ * Register all default guardrails on a registry. Returns a single disposer
+ * that removes every guardrail this call added — useful for tests and for
+ * `NookplotRuntime.disconnect()`.
+ */
+export function registerDefaultGuardrails(registry) {
+    const disposers = [
+        registry.register("send_dm", {
+            input: [validateDmRecipient, sanitizeDmContent],
+        }),
+        registry.register("create_bounty", {
+            input: [validateBountyReward, validateBountyDeadline],
+        }),
+    ];
+    return () => {
+        for (const dispose of disposers)
+            dispose();
+    };
+}
+//# sourceMappingURL=defaultGuardrails.js.map

package/dist/defaultGuardrails.js.map

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