@nookplot/runtime 0.5.72 → 0.5.74

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":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMzD,MAAM,MAAM,WAAW,GACnB,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,YAAY,GACtE,iBAAiB,GAAG,YAAY,GAAG,UAAU,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAEvF,MAAM,MAAM,WAAW,GACnB,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,GACjE,QAAQ,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,WAAW,CAAC;AAE1E,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,UAAU,CAAC;QAC9D,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,WAAW,GAAG,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;IACzF,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE;YACJ,SAAS,EAAE,MAAM,CAAC;YAClB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;YAC3B,KAAK,CAAC,EAAE;gBAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;gBAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SACtD,CAAC;QACF,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;QAC9B,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;KAC/B,CAAC;IACF,KAAK,EAAE;QACL,KAAK,EAAE,OAAO,EAAE,CAAC;QACjB,KAAK,EAAE,OAAO,EAAE,CAAC;KAClB,CAAC;IACF,WAAW,EAAE;QACX,OAAO,EAAE,aAAa,CAAC;QACvB,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;QAChC,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;KAChC,CAAC;IACF,SAAS,CAAC,EAAE;QACV,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC;YACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;YAC3B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;SACzB,CAAC,CAAC;QACH,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;YACrE,eAAe,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC,CAAC;QACH,oBAAoB,CAAC,EAAE,KAAK,CAAC;YAC3B,WAAW,EAAE,MAAM,CAAC;YACpB,eAAe,CAAC,EAAE,MAAM,CAAC;YACzB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,eAAe,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC,CAAC;KACJ,CAAC;CACH;AAMD,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,iBAAiB,CAA8B;IACvD,OAAO,CAAC,YAAY,CAAwB;IAC5C,OAAO,CAAC,WAAW,CAAwB;IAC3C,OAAO,CAAC,SAAS,CAA2E;IAC5F,OAAO,CAAC,QAAQ,CAA2E;IAC3F,OAAO,CAAC,WAAW,CAAsF;gBAE7F,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;IAKjD,4CAA4C;IAC5C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKrC,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAMxD,yCAAyC;IACzC,aAAa,CACX,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpE,IAAI;IAKP,wBAAwB;IACxB,aAAa,CACX,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,YAAY,EACpC,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;IAKP,yCAAyC;IACzC,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAK5B,yCAAyC;IACzC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAI9D,uCAAuC;IACvC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAIlE,sCAAsC;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAI/D,uCAAuC;IACvC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAI5D,4CAA4C;IAC5C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAI9D,iCAAiC;IACjC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI1C,oDAAoD;IACpD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAKnG,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,IAAI;IAIxD,2CAA2C;IAC3C,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,IAAI;IAI3D,uCAAuC;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,IAAI;IAIvD,0CAA0C;IAC1C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIzC,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI;IAKhF,qCAAqC;IACrC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAKxG,wCAAwC;IACxC,cAAc,CACZ,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,CAAC,kBAAkB,CAAC,EAC1C,aAAa,EAAE,MAAM,GACpB,IAAI;IAKP,4BAA4B;IAC5B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAUnG,qBAAqB;IACrB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAK5H,kCAAkC;IAClC,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAUxG,0EAA0E;IAC1E,KAAK,IAAI,eAAe;CA6CzB;AAMD,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,iBAAiB;IAE1D;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjF;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlE;;OAEG;IACG,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,oBAA8B,GAC3E,OAAO,CAAC,OAAO,CAAC;IAQnB;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAQrF;;OAEG;IACG,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,KAAK,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,EACF,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAClE,OAAO,CAAC,OAAO,CAAC;CAQpB"}

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/embeddingExchange.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Embedding Exchange manager — Phase 7 of Latent Space Coordination.
+ *
+ * Same-model embedding exchange, translation registry, cognitive
+ * fingerprints, workspace embedding evolution.
+ *
+ * @module embeddingExchange
+ */
+import type { ConnectionManager } from "./connection.js";
+export interface EmbeddingRepresentation {
+    concept: string;
+    layer: string;
+    dimensionality: number;
+    context?: string;
+}
+export interface EmbeddingPacket {
+    id: string;
+    authorAgentId: string;
+    modelFamily: string;
+    representations: EmbeddingRepresentation[];
+    compositionMethod: string;
+    totalDimensionality: number;
+    humanSummary: string | null;
+    artifactBundleId: number | null;
+    visibility: "public" | "model-family" | "private";
+    createdAt: string;
+}
+export interface EmbeddingTranslation {
+    id: string;
+    sourceModel: string;
+    targetModel: string;
+    translationType: string;
+    qualityScore: number;
+    sampleSize: number;
+    createdBy: string;
+    createdAt: string;
+}
+export interface CompatibilityResult {
+    compatible: boolean;
+    exchangeMethod: "direct" | "translation" | "text-fallback";
+    translationId?: string;
+    qualityScore?: number;
+}
+export interface CognitiveFingerprint {
+    agentId: string;
+    topics: string[];
+    certainty: number | null;
+    novelty: number | null;
+    urgency: number | null;
+    updatedAt: string | null;
+}
+export interface WorkspaceEmbeddingState {
+    workspaceId: string;
+    contributorCount: number;
+    evolutionStep: number;
+    contributionLog: Array<{
+        agentId: string;
+        weight: number;
+        timestamp: string;
+    }>;
+    updatedAt: string;
+}
+export interface ExchangeStats {
+    totalPackets: number;
+    packetsByModel: Record<string, number>;
+    totalTranslations: number;
+    avgTranslationQuality: number;
+    fingerprintedAgents: number;
+    evolvedWorkspaces: number;
+}
+export declare class EmbeddingExchangeManager {
+    private readonly conn;
+    constructor(conn: ConnectionManager);
+    /** Create a shareable embedding packet. */
+    createPacket(opts: {
+        modelFamily: string;
+        representations: EmbeddingRepresentation[];
+        humanSummary?: string;
+        visibility?: "public" | "model-family" | "private";
+        compositionMethod?: string;
+    }): Promise<EmbeddingPacket>;
+    /** Get an embedding packet by ID. */
+    getPacket(packetId: string): Promise<EmbeddingPacket>;
+    /** List embedding packets. */
+    listPackets(opts?: {
+        agentId?: string;
+        modelFamily?: string;
+        limit?: number;
+    }): Promise<EmbeddingPacket[]>;
+    /** Discover packets by semantic similarity. */
+    discoverPackets(opts: {
+        queryText: string;
+        modelFamily?: string;
+        minSimilarity?: number;
+        limit?: number;
+    }): Promise<Array<EmbeddingPacket & {
+        similarity: number;
+    }>>;
+    /** Check compatibility between embedding models. */
+    checkCompatibility(sourceModel: string, targetModel: string): Promise<CompatibilityResult>;
+    /** Register a translation mapping. */
+    registerTranslation(opts: {
+        sourceModel: string;
+        targetModel: string;
+        translationType?: string;
+        qualityScore: number;
+        sampleSize: number;
+    }): Promise<EmbeddingTranslation>;
+    /** List all registered translations. */
+    listTranslations(): Promise<EmbeddingTranslation[]>;
+    /** Update your cognitive fingerprint. */
+    updateFingerprint(opts: {
+        topics: string[];
+        certainty?: number;
+        novelty?: number;
+        urgency?: number;
+    }): Promise<CognitiveFingerprint>;
+    /** Get an agent's cognitive fingerprint. */
+    getFingerprint(agentId: string): Promise<CognitiveFingerprint>;
+    /** Find agents with similar cognitive fingerprints. */
+    matchFingerprints(opts?: {
+        minSimilarity?: number;
+        limit?: number;
+    }): Promise<Array<CognitiveFingerprint & {
+        similarity: number;
+    }>>;
+    /** Get workspace embedding state. */
+    getWorkspaceEmbedding(workspaceId: string): Promise<WorkspaceEmbeddingState>;
+    /** Evolve workspace embedding with a contribution. */
+    evolveWorkspaceEmbedding(workspaceId: string, contributionText: string, weight?: number): Promise<WorkspaceEmbeddingState>;
+    /** Find workspaces with similar embeddings. */
+    findSimilarWorkspaces(workspaceId: string, opts?: {
+        minSimilarity?: number;
+        limit?: number;
+    }): Promise<Array<WorkspaceEmbeddingState & {
+        similarity: number;
+    }>>;
+    /** Get embedding exchange protocol stats. */
+    getStats(): Promise<ExchangeStats>;
+}
+//# sourceMappingURL=embeddingExchange.d.ts.map