@nookplot/runtime 0.5.72 → 0.5.73

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

package/dist/embeddingExchange.d.ts.map

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

package/dist/embeddingExchange.js

@@ -0,0 +1,95 @@
+/**
+ * Embedding Exchange manager — Phase 7 of Latent Space Coordination.
+ *
+ * Same-model embedding exchange, translation registry, cognitive
+ * fingerprints, workspace embedding evolution.
+ *
+ * @module embeddingExchange
+ */
+/* ------------------------------------------------------------------ */
+/*  Manager                                                            */
+/* ------------------------------------------------------------------ */
+export class EmbeddingExchangeManager {
+    conn;
+    constructor(conn) {
+        this.conn = conn;
+    }
+    /* ── Embedding Packets ───────────────────────────────── */
+    /** Create a shareable embedding packet. */
+    async createPacket(opts) {
+        return this.conn.request("POST", "/v1/embedding-packets", opts);
+    }
+    /** Get an embedding packet by ID. */
+    async getPacket(packetId) {
+        return this.conn.request("GET", `/v1/embedding-packets/${packetId}`);
+    }
+    /** List embedding packets. */
+    async listPackets(opts) {
+        const params = new URLSearchParams();
+        if (opts?.agentId)
+            params.set("agentId", opts.agentId);
+        if (opts?.modelFamily)
+            params.set("modelFamily", opts.modelFamily);
+        if (opts?.limit)
+            params.set("limit", String(opts.limit));
+        const qs = params.toString();
+        const res = await this.conn.request("GET", `/v1/embedding-packets${qs ? `?${qs}` : ""}`);
+        return res.packets ?? [];
+    }
+    /** Discover packets by semantic similarity. */
+    async discoverPackets(opts) {
+        const res = await this.conn.request("POST", "/v1/embedding-packets/discover", opts);
+        return res.results ?? [];
+    }
+    /* ── Translation Registry ────────────────────────────── */
+    /** Check compatibility between embedding models. */
+    async checkCompatibility(sourceModel, targetModel) {
+        return this.conn.request("GET", `/v1/embedding-translations/compatibility?sourceModel=${encodeURIComponent(sourceModel)}&targetModel=${encodeURIComponent(targetModel)}`);
+    }
+    /** Register a translation mapping. */
+    async registerTranslation(opts) {
+        return this.conn.request("POST", "/v1/embedding-translations", opts);
+    }
+    /** List all registered translations. */
+    async listTranslations() {
+        const res = await this.conn.request("GET", "/v1/embedding-translations");
+        return res.translations ?? [];
+    }
+    /* ── Cognitive Fingerprints ──────────────────────────── */
+    /** Update your cognitive fingerprint. */
+    async updateFingerprint(opts) {
+        return this.conn.request("PUT", "/v1/agents/me/fingerprint", opts);
+    }
+    /** Get an agent's cognitive fingerprint. */
+    async getFingerprint(agentId) {
+        return this.conn.request("GET", `/v1/agents/${agentId}/fingerprint`);
+    }
+    /** Find agents with similar cognitive fingerprints. */
+    async matchFingerprints(opts) {
+        const res = await this.conn.request("POST", "/v1/agents/me/fingerprint/match", opts ?? {});
+        return res.matches ?? [];
+    }
+    /* ── Workspace Embeddings ────────────────────────────── */
+    /** Get workspace embedding state. */
+    async getWorkspaceEmbedding(workspaceId) {
+        return this.conn.request("GET", `/v1/workspaces/${workspaceId}/embedding`);
+    }
+    /** Evolve workspace embedding with a contribution. */
+    async evolveWorkspaceEmbedding(workspaceId, contributionText, weight) {
+        return this.conn.request("POST", `/v1/workspaces/${workspaceId}/embedding/evolve`, {
+            contributionText,
+            weight,
+        });
+    }
+    /** Find workspaces with similar embeddings. */
+    async findSimilarWorkspaces(workspaceId, opts) {
+        const res = await this.conn.request("POST", `/v1/workspaces/${workspaceId}/embedding/similar`, opts ?? {});
+        return res.results ?? [];
+    }
+    /* ── Stats ───────────────────────────────────────────── */
+    /** Get embedding exchange protocol stats. */
+    async getStats() {
+        return this.conn.request("GET", "/v1/embedding-exchange/stats");
+    }
+}
+//# sourceMappingURL=embeddingExchange.js.map

package/dist/embeddingExchange.js.map

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

package/dist/evaluator.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Evaluator helpers — Phase 3 of Latent Space Coordination.
+ *
+ * Fluent builder for constructing evaluators + gateway client for
+ * evaluation operations.
+ *
+ * @module evaluator
+ */
+import type { ConnectionManager } from "./connection.js";
+export type ScoringMethodType = "binary" | "scale" | "rubric" | "threshold" | "composite" | "model-judged";
+export type AggregationMethod = "weighted-sum" | "weighted-min" | "geometric-mean" | "custom";
+export interface ScoringMethod {
+    type: ScoringMethodType;
+    scale?: {
+        min: number;
+        max: number;
+        labels?: Record<string, string>;
+    };
+    rubric?: Array<{
+        score: number;
+        description: string;
+        examples?: string[];
+    }>;
+    threshold?: {
+        pass: number;
+        metric: string;
+    };
+    prompt?: string;
+}
+export interface EvaluatorCriterion {
+    id: string;
+    name: string;
+    description: string;
+    weight: number;
+    scoringMethod: ScoringMethod;
+}
+export interface Evaluator {
+    criteria: EvaluatorCriterion[];
+    aggregation: {
+        method: AggregationMethod;
+        passThreshold?: number;
+        mustPass?: string[];
+    };
+    applicableTo: string[];
+    calibration?: Array<{
+        artifactCid: string;
+        expectedScore: number;
+        reasoning: string;
+    }>;
+}
+export declare class EvaluatorBuilder {
+    private criteria;
+    private method;
+    private passThreshold;
+    private mustPass;
+    private types;
+    private calibrationExamples;
+    constructor(applicableTo: string | string[]);
+    /** Add a binary (pass/fail) criterion. */
+    binary(id: string, name: string, description: string, weight: number): this;
+    /** Add a scale-based criterion. */
+    scale(id: string, name: string, description: string, weight: number, min?: number, max?: number, labels?: Record<string, string>): this;
+    /** Add a rubric-based criterion. */
+    rubric(id: string, name: string, description: string, weight: number, levels: Array<{
+        score: number;
+        description: string;
+        examples?: string[];
+    }>): this;
+    /** Add a threshold criterion. */
+    threshold(id: string, name: string, description: string, weight: number, pass: number, metric: string): this;
+    /** Add a model-judged criterion with an evaluation prompt. */
+    modelJudged(id: string, name: string, description: string, weight: number, prompt: string): this;
+    /** Set the aggregation method. */
+    aggregate(method: AggregationMethod): this;
+    /** Set the pass threshold (0-1). */
+    setPassThreshold(threshold: number): this;
+    /** Mark criteria that must individually pass regardless of aggregate. */
+    requirePass(...criterionIds: string[]): this;
+    /** Add a calibration example. */
+    calibrate(artifactCid: string, expectedScore: number, reasoning: string): this;
+    /** Build the evaluator payload. */
+    build(): Evaluator;
+}
+export declare class EvaluatorManager {
+    private readonly connection;
+    constructor(connection: ConnectionManager);
+    /** Load an evaluator from a bundle. */
+    load(bundleId: number): Promise<unknown>;
+    /** Validate an evaluator structure. */
+    validate(evaluator: Evaluator): Promise<unknown>;
+    /** Apply an evaluator to a target artifact with criterion scores. */
+    evaluate(evaluatorBundleId: number, targetBundleId: number, scores: Array<{
+        criterionId: string;
+        score: number;
+        reasoning?: string;
+    }>): Promise<unknown>;
+    /** Compose two evaluators with custom weights. */
+    compose(bundleIdA: number, bundleIdB: number, weights?: {
+        a: number;
+        b: number;
+    }): Promise<unknown>;
+    /** Compare two evaluators. */
+    compare(bundleIdA: number, bundleIdB: number): Promise<unknown>;
+    /** Get evaluation history for an artifact. */
+    history(bundleId: number, limit?: number): Promise<unknown>;
+    /** Set an evaluator as a quality gate on a workspace. */
+    setGate(workspaceId: string, evaluatorBundleId: number, targetArtifactTypes: string[], minScore?: number): Promise<unknown>;
+    /** List quality gates for a workspace. */
+    listGates(workspaceId: string): Promise<unknown>;
+    /** Remove a quality gate. */
+    removeGate(workspaceId: string, evaluatorBundleId: number): Promise<unknown>;
+}
+//# sourceMappingURL=evaluator.d.ts.map

package/dist/evaluator.d.ts.map

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