@backbay/glia 0.2.0-alpha.1

package/dist/primitives/three/SpatialWorkspace/adapters.js

@@ -0,0 +1,253 @@
+/**
+ * Entity Adapters
+ *
+ * Maps Backbay contract entities (Job, Node, Receipt, Dispute) to CrystallineOrganism props.
+ * This adapter layer enables the SpatialWorkspace to use the unified emotion-driven
+ * visualization system from CrystallineOrganism.
+ */
+// -----------------------------------------------------------------------------
+// Job Adapter
+// -----------------------------------------------------------------------------
+const JOB_STATUS_TO_STATE = {
+    queued: "idle",
+    running: "busy",
+    completed: "success",
+    blocked: "thinking",
+    quarantine: "error",
+};
+export const jobAdapter = {
+    toOrganism(job) {
+        return {
+            id: job.id,
+            type: this.getType(job),
+            label: job.type || job.id.slice(0, 8),
+            state: this.getState(job),
+            power: this.getPower(job),
+        };
+    },
+    getState(job) {
+        return JOB_STATUS_TO_STATE[job.status] ?? "idle";
+    },
+    getType(_job) {
+        return "task"; // Jobs are always tetrahedrons
+    },
+    getPower(job) {
+        if (job.status === "running")
+            return "elevated";
+        if (job.status === "quarantine")
+            return "elevated";
+        return "standard";
+    },
+};
+// -----------------------------------------------------------------------------
+// Node Adapter
+// -----------------------------------------------------------------------------
+const NODE_TYPE_TO_ORGANISM = {
+    operator: "kernel",
+    fab: "workcell",
+    verifier: "agent",
+    relay: "relay",
+};
+const NODE_STATUS_TO_STATE = {
+    online: "idle",
+    degraded: "thinking",
+    offline: "sleep",
+};
+const TRUST_TIER_TO_POWER = {
+    bronze: "standard",
+    silver: "elevated",
+    gold: "intense",
+};
+export const nodeAdapter = {
+    toOrganism(node) {
+        return {
+            id: node.id,
+            type: this.getType(node),
+            label: node.id.slice(0, 8),
+            state: this.getState(node),
+            power: this.getPower(node),
+        };
+    },
+    getState(node) {
+        return NODE_STATUS_TO_STATE[node.status] ?? "idle";
+    },
+    getType(node) {
+        return NODE_TYPE_TO_ORGANISM[node.type] ?? "agent";
+    },
+    getPower(node) {
+        return TRUST_TIER_TO_POWER[node.trust_tier] ?? "standard";
+    },
+};
+// -----------------------------------------------------------------------------
+// Receipt Adapter
+// -----------------------------------------------------------------------------
+const RECEIPT_STATUS_TO_STATE = {
+    pending: "listening",
+    passed: "success",
+    failed: "error",
+};
+export const receiptAdapter = {
+    toOrganism(receipt) {
+        return {
+            id: receipt.id,
+            type: this.getType(receipt),
+            label: receipt.id.slice(0, 6),
+            state: this.getState(receipt),
+            power: this.getPower(receipt),
+        };
+    },
+    getState(receipt) {
+        return RECEIPT_STATUS_TO_STATE[receipt.status] ?? "idle";
+    },
+    getType(_receipt) {
+        // Receipts are micro-tasks - use minimal task geometry
+        return "task";
+    },
+    getPower(receipt) {
+        // Receipts are small - always minimal
+        return "minimal";
+    },
+};
+// -----------------------------------------------------------------------------
+// Dispute Adapter
+// -----------------------------------------------------------------------------
+export const disputeAdapter = {
+    toOrganism(dispute) {
+        return {
+            id: dispute.id,
+            type: this.getType(dispute),
+            label: `Dispute ${dispute.id.slice(0, 6)}`,
+            state: this.getState(dispute),
+            power: this.getPower(dispute),
+        };
+    },
+    getState(dispute) {
+        // Map dispute status to organism state
+        const statusMap = {
+            pending: "error", // Pending disputes need attention
+            resolved: "success", // Resolved disputes are complete
+            rejected: "idle", // Rejected disputes are dismissed
+        };
+        return statusMap[dispute.status] ?? "error";
+    },
+    getType(_dispute) {
+        // Disputes are task-like items that need resolution
+        return "task";
+    },
+    getPower(dispute) {
+        // Calculate severity based on age
+        const ageMs = Date.now() - new Date(dispute.opened_at).getTime();
+        const ageHours = ageMs / (1000 * 60 * 60);
+        if (ageHours >= 72)
+            return "intense";
+        if (ageHours >= 24)
+            return "elevated";
+        return "standard";
+    },
+};
+// -----------------------------------------------------------------------------
+// Batch Conversion Helpers
+// -----------------------------------------------------------------------------
+export function jobsToOrganisms(jobs) {
+    return jobs.map((job) => jobAdapter.toOrganism(job));
+}
+export function nodesToOrganisms(nodes) {
+    return nodes.map((node) => nodeAdapter.toOrganism(node));
+}
+export function receiptsToOrganisms(receipts) {
+    return receipts.map((receipt) => receiptAdapter.toOrganism(receipt));
+}
+export function disputesToOrganisms(disputes) {
+    return disputes.map((dispute) => disputeAdapter.toOrganism(dispute));
+}
+// -----------------------------------------------------------------------------
+// Cyntra Entity Adapters
+// -----------------------------------------------------------------------------
+const WORKCELL_STATE_TO_ORGANISM = {
+    idle: "idle",
+    running: "busy",
+    blocked: "error",
+};
+export const cyntraWorkcellAdapter = {
+    toOrganism(wc) {
+        return {
+            id: wc.id,
+            type: this.getType(wc),
+            label: wc.branch.split("/").pop() || wc.id.slice(0, 8),
+            state: this.getState(wc),
+            power: this.getPower(wc),
+        };
+    },
+    getState(wc) {
+        return WORKCELL_STATE_TO_ORGANISM[wc.state] ?? "idle";
+    },
+    getType(_wc) {
+        return "workcell";
+    },
+    getPower(wc) {
+        return wc.current_run ? "elevated" : "standard";
+    },
+};
+const RUN_STATE_TO_ORGANISM = {
+    queued: "idle",
+    running: "busy",
+    verifying: "thinking",
+    completed: "success",
+    failed: "error",
+};
+export const cyntraRunAdapter = {
+    toOrganism(run) {
+        return {
+            id: run.id,
+            type: this.getType(run),
+            label: run.issue_id.slice(0, 8),
+            state: this.getState(run),
+            power: this.getPower(run),
+        };
+    },
+    getState(run) {
+        return RUN_STATE_TO_ORGANISM[run.state] ?? "idle";
+    },
+    getType(_run) {
+        return "agent";
+    },
+    getPower(run) {
+        return run.state === "running" ? "elevated" : "standard";
+    },
+};
+const ISSUE_STATE_TO_ORGANISM = {
+    open: "idle",
+    in_progress: "busy",
+    resolved: "success",
+    wontfix: "sleep",
+};
+export const cyntraIssueAdapter = {
+    toOrganism(issue) {
+        return {
+            id: issue.id,
+            type: this.getType(issue),
+            label: issue.title.slice(0, 20),
+            state: this.getState(issue),
+            power: this.getPower(issue),
+        };
+    },
+    getState(issue) {
+        return ISSUE_STATE_TO_ORGANISM[issue.state] ?? "idle";
+    },
+    getType(_issue) {
+        return "task";
+    },
+    getPower(issue) {
+        return issue.state === "in_progress" ? "elevated" : "standard";
+    },
+};
+// Batch converters
+export function workcellsToOrganisms(workcells) {
+    return workcells.map((wc) => cyntraWorkcellAdapter.toOrganism(wc));
+}
+export function runsToOrganisms(runs) {
+    return runs.map((run) => cyntraRunAdapter.toOrganism(run));
+}
+export function issuesToOrganisms(issues) {
+    return issues.map((issue) => cyntraIssueAdapter.toOrganism(issue));
+}

package/dist/primitives/three/SpatialWorkspace/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SpatialWorkspace Module Exports
+ */
+export { SpatialWorkspace } from "./SpatialWorkspace";
+export type { SpatialWorkspaceProps } from "./types";
+export { JobCluster } from "./JobCluster";
+export type { JobClusterProps } from "./types";
+export { NodeGraph } from "./NodeGraph";
+export type { NodeGraphProps } from "./types";
+export { ReceiptOrbit } from "./ReceiptOrbit";
+export type { ReceiptOrbitProps } from "./types";
+export { TrustRings } from "./TrustRings";
+export type { TrustRingsProps } from "./types";
+export type { WorkspaceLayout, WorkspaceLayoutOptions, EntityVisual, EntityPosition, WorkspaceFilter, WorkspaceSelection, DisputeSeverity, DisputeBeaconProps, } from "./types";
+export { JOB_VISUALS, NODE_VISUALS, NODE_STATUS_MODIFIERS, RECEIPT_VISUALS, TRUST_RING_CONFIG, DISPUTE_SEVERITY_VISUALS, DEFAULT_WORKSPACE_CONFIG, getDisputeSeverity, } from "./types";
+export { jobAdapter, nodeAdapter, receiptAdapter, disputeAdapter, jobsToOrganisms, nodesToOrganisms, receiptsToOrganisms, disputesToOrganisms, cyntraWorkcellAdapter, cyntraRunAdapter, cyntraIssueAdapter, workcellsToOrganisms, runsToOrganisms, issuesToOrganisms, } from "./adapters";
+export type { EntityAdapter, CyntraKernelStatus, CyntraWorkcellStatus, CyntraRunStatus, CyntraIssueStatus, } from "./adapters";
+export { CyntraWorkspace } from "./CyntraWorkspace";
+export type { CyntraWorkspaceProps } from "./CyntraWorkspace";
+export { nexusAdapter, nexusItemsToOrganisms, getNexusOrganismScale, canSprawlInto, } from "./nexusAdapter";
+export type { NexusItem, NexusItemType, NexusItemStatus, } from "./nexusAdapter";
+//# sourceMappingURL=index.d.ts.map

package/dist/primitives/three/SpatialWorkspace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/primitives/three/SpatialWorkspace/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EAEnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG9D,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,SAAS,EACT,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/dist/primitives/three/SpatialWorkspace/index.js

@@ -0,0 +1,17 @@
+/**
+ * SpatialWorkspace Module Exports
+ */
+export { SpatialWorkspace } from "./SpatialWorkspace";
+export { JobCluster } from "./JobCluster";
+export { NodeGraph } from "./NodeGraph";
+export { ReceiptOrbit } from "./ReceiptOrbit";
+export { TrustRings } from "./TrustRings";
+export { JOB_VISUALS, NODE_VISUALS, NODE_STATUS_MODIFIERS, RECEIPT_VISUALS, TRUST_RING_CONFIG, DISPUTE_SEVERITY_VISUALS, DEFAULT_WORKSPACE_CONFIG, getDisputeSeverity, } from "./types";
+// Entity Adapters - map Backbay entities to CrystallineOrganism props
+export { jobAdapter, nodeAdapter, receiptAdapter, disputeAdapter, jobsToOrganisms, nodesToOrganisms, receiptsToOrganisms, disputesToOrganisms, 
+// Cyntra entity adapters
+cyntraWorkcellAdapter, cyntraRunAdapter, cyntraIssueAdapter, workcellsToOrganisms, runsToOrganisms, issuesToOrganisms, } from "./adapters";
+// CyntraWorkspace - visualize Cyntra kernel status
+export { CyntraWorkspace } from "./CyntraWorkspace";
+// Nexus adapters - map NexusItems to CrystallineOrganism props
+export { nexusAdapter, nexusItemsToOrganisms, getNexusOrganismScale, canSprawlInto, } from "./nexusAdapter";

package/dist/primitives/three/SpatialWorkspace/nexusAdapter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Nexus Adapter
+ *
+ * Maps NexusItem entities to CrystallineOrganism props for hierarchical
+ * workspace visualization. Enables NexusNodes to be rendered as
+ * emotion-driven organisms with consistent visual language.
+ */
+import * as THREE from "three";
+import type { CrystallineOrganismProps } from "../CrystallineOrganism";
+import type { EntityAdapter } from "./adapters";
+export type NexusItemType = "terminal" | "browser-tab" | "agent-task" | "industry" | "workcell" | "trade" | "cluster" | "index" | "app-window";
+export type NexusItemStatus = "idle" | "active" | "running" | "error" | "complete" | "pending";
+export interface NexusItem {
+    id: string;
+    type: NexusItemType;
+    label: string;
+    status: NexusItemStatus;
+    activityLevel: number;
+    /** 3D position in scene (used by NexusOrganismNode) */
+    position: THREE.Vector3;
+    metadata?: {
+        favicon?: string;
+        workcellId?: string;
+        taskId?: string;
+        tradeId?: string;
+        industryCode?: string;
+        /** Jobs associated with this item (for workspace drill-down) */
+        jobIds?: string[];
+        /** Nodes associated with this item */
+        nodeIds?: string[];
+        /** Receipt count for status rings */
+        receiptCounts?: {
+            passed: number;
+            failed: number;
+            pending: number;
+        };
+    };
+}
+export declare const nexusAdapter: EntityAdapter<NexusItem>;
+/**
+ * Convert array of NexusItems to CrystallineOrganismProps.
+ */
+export declare function nexusItemsToOrganisms(items: NexusItem[]): CrystallineOrganismProps[];
+/**
+ * Get organism scale factor based on NexusItem activity level.
+ * Matches the existing NexusNode scaling behavior.
+ */
+export declare function getNexusOrganismScale(item: NexusItem): number;
+/**
+ * Check if a NexusItem can be sprawled into (has detail workspace).
+ */
+export declare function canSprawlInto(item: NexusItem): boolean;
+//# sourceMappingURL=nexusAdapter.d.ts.map

package/dist/primitives/three/SpatialWorkspace/nexusAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexusAdapter.d.ts","sourceRoot":"","sources":["../../../../src/primitives/three/SpatialWorkspace/nexusAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EACV,wBAAwB,EAIzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAMhD,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,aAAa,GACb,YAAY,GACZ,UAAU,GACV,UAAU,GACV,OAAO,GACP,SAAS,GACT,OAAO,GACP,YAAY,CAAC;AAEjB,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gEAAgE;QAChE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,sCAAsC;QACtC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,qCAAqC;QACrC,aAAa,CAAC,EAAE;YACd,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,CAAC;CACH;AAgDD,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,SAAS,CAkCjD,CAAC;AAMF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAAE,GACjB,wBAAwB,EAAE,CAE5B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAG7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAOtD"}

package/dist/primitives/three/SpatialWorkspace/nexusAdapter.js

@@ -0,0 +1,107 @@
+/**
+ * Nexus Adapter
+ *
+ * Maps NexusItem entities to CrystallineOrganism props for hierarchical
+ * workspace visualization. Enables NexusNodes to be rendered as
+ * emotion-driven organisms with consistent visual language.
+ */
+// -----------------------------------------------------------------------------
+// Type Mappings
+// -----------------------------------------------------------------------------
+/**
+ * Maps NexusItemType to OrganismType geometry.
+ *
+ * Semantic mapping:
+ * - terminal → kernel (octahedron): Central command/control
+ * - browser-tab → relay (torus): Connection/communication point
+ * - agent-task → agent (icosahedron): AI/autonomous process
+ * - industry → workcell (dodecahedron): Industry sector
+ * - workcell → workcell (dodecahedron): Cyntra sandbox
+ * - trade → task (tetrahedron): Action/transaction
+ * - cluster → kernel (octahedron): Group container
+ * - index → relay (torus): Reference/lookup point
+ * - app-window → agent (icosahedron): Application instance
+ */
+const NEXUS_TYPE_TO_ORGANISM = {
+    terminal: "kernel",
+    "browser-tab": "relay",
+    "agent-task": "agent",
+    industry: "workcell",
+    workcell: "workcell",
+    trade: "task",
+    cluster: "kernel",
+    index: "relay",
+    "app-window": "agent",
+};
+/**
+ * Maps NexusItemStatus to OrganismState for emotion-driven visualization.
+ */
+const NEXUS_STATUS_TO_STATE = {
+    idle: "idle",
+    active: "busy",
+    running: "busy",
+    error: "error",
+    complete: "success",
+    pending: "listening",
+};
+// -----------------------------------------------------------------------------
+// Nexus Adapter
+// -----------------------------------------------------------------------------
+export const nexusAdapter = {
+    toOrganism(item) {
+        return {
+            id: item.id,
+            type: this.getType(item),
+            label: item.label,
+            state: this.getState(item),
+            power: this.getPower(item),
+        };
+    },
+    getState(item) {
+        return NEXUS_STATUS_TO_STATE[item.status] ?? "idle";
+    },
+    getType(item) {
+        return NEXUS_TYPE_TO_ORGANISM[item.type] ?? "agent";
+    },
+    getPower(item) {
+        // High activity → elevated power for more intense glow
+        if (item.activityLevel > 0.7)
+            return "elevated";
+        // Error and running states demand attention
+        if (item.status === "error")
+            return "elevated";
+        if (item.status === "running")
+            return "elevated";
+        // Clusters and terminals are important → standard+
+        if (item.type === "cluster" || item.type === "terminal") {
+            return item.activityLevel > 0.3 ? "elevated" : "standard";
+        }
+        return "standard";
+    },
+};
+// -----------------------------------------------------------------------------
+// Batch Conversion Helpers
+// -----------------------------------------------------------------------------
+/**
+ * Convert array of NexusItems to CrystallineOrganismProps.
+ */
+export function nexusItemsToOrganisms(items) {
+    return items.map((item) => nexusAdapter.toOrganism(item));
+}
+/**
+ * Get organism scale factor based on NexusItem activity level.
+ * Matches the existing NexusNode scaling behavior.
+ */
+export function getNexusOrganismScale(item) {
+    // Scale based on activity level: 0.8 to 1.2
+    return 0.8 + item.activityLevel * 0.4;
+}
+/**
+ * Check if a NexusItem can be sprawled into (has detail workspace).
+ */
+export function canSprawlInto(item) {
+    return (item.type === "cluster" ||
+        item.type === "workcell" ||
+        item.type === "industry" ||
+        item.type === "terminal");
+}

package/dist/primitives/three/SpatialWorkspace/types.d.ts

@@ -0,0 +1,173 @@
+/**
+ * SpatialWorkspace Types
+ *
+ * Types for the 3D spatial visualization of Backbay entities.
+ */
+import type * as THREE from "three";
+import type { VisionTopology, VisionTopologyEdge, VisionTopologyNode } from "../../../vision/types.js";
+import type { Job, JobStatus, Node, NodeType, NodeStatus, Receipt, ReceiptStatus, Dispute, DisputeStatus, TrustTier } from "@backbay/contract";
+export type { Job, JobStatus, Node, NodeType, NodeStatus, Receipt, ReceiptStatus, Dispute, DisputeStatus, TrustTier, };
+export type WorkspaceLayout = "clustered" | "force-directed" | "orbital";
+export interface WorkspaceLayoutOptions {
+    /** Animate layout transitions */
+    animate?: boolean;
+    /** Animation duration in ms */
+    animationDuration?: number;
+    /** Force simulation strength */
+    forceStrength?: number;
+    /** Repulsion between nodes */
+    repulsion?: number;
+    /** Center gravity */
+    gravity?: number;
+}
+export interface EntityVisual {
+    color: string;
+    opacity: number;
+    pulse: boolean;
+    icon: string;
+    shape?: "sphere" | "box" | "octahedron" | "icosahedron" | "torus" | "ring";
+    size?: number;
+    emissive?: string;
+    emissiveIntensity?: number;
+}
+export interface EntityPosition {
+    id: string;
+    position: THREE.Vector3;
+    velocity?: THREE.Vector3;
+}
+export interface TopologySlice {
+    nodes: VisionTopologyNode[];
+    edges?: VisionTopologyEdge[];
+}
+export interface JobClusterProps {
+    jobs: Job[];
+    selectedIds?: string[];
+    hoveredId?: string | null;
+    onJobClick?: (job: Job) => void;
+    onJobHover?: (job: Job | null) => void;
+    layout?: WorkspaceLayout;
+    position?: [number, number, number];
+    onTopologyChange?: (slice: TopologySlice) => void;
+}
+/** Visual mapping for job statuses */
+export declare const JOB_VISUALS: Record<JobStatus, EntityVisual>;
+export interface NodeGraphProps {
+    nodes: Node[];
+    selectedIds?: string[];
+    hoveredId?: string | null;
+    onNodeClick?: (node: Node) => void;
+    onNodeHover?: (node: Node | null) => void;
+    showConnections?: boolean;
+    layout?: WorkspaceLayout;
+    position?: [number, number, number];
+    onTopologyChange?: (slice: TopologySlice) => void;
+}
+/** Visual mapping for node types */
+export declare const NODE_VISUALS: Record<NodeType, EntityVisual>;
+/** Status-based opacity modifiers */
+export declare const NODE_STATUS_MODIFIERS: Record<NodeStatus, {
+    opacity: number;
+    pulse: boolean;
+}>;
+export interface ReceiptOrbitProps {
+    receipts: Receipt[];
+    parentPosition: [number, number, number];
+    orbitRadius?: number;
+    selectedIds?: string[];
+    hoveredId?: string | null;
+    onReceiptClick?: (receipt: Receipt) => void;
+    onReceiptHover?: (receipt: Receipt | null) => void;
+    onTopologyChange?: (slice: TopologySlice) => void;
+    origin?: [number, number, number];
+}
+/** Visual mapping for receipt statuses */
+export declare const RECEIPT_VISUALS: Record<ReceiptStatus, EntityVisual>;
+export interface TrustRingsProps {
+    currentTier: TrustTier;
+    position?: [number, number, number];
+    showLabels?: boolean;
+    interactive?: boolean;
+    onTierClick?: (tier: TrustTier) => void;
+}
+/** Trust tier ring configuration */
+export declare const TRUST_RING_CONFIG: Record<TrustTier, {
+    radius: number;
+    color: string;
+    metalness: number;
+    roughness: number;
+}>;
+export interface DisputeBeaconProps {
+    dispute: Dispute;
+    parentPosition: [number, number, number];
+    onDisputeClick?: (dispute: Dispute) => void;
+}
+/** Severity based on dispute age */
+export type DisputeSeverity = "low" | "medium" | "high";
+export declare function getDisputeSeverity(dispute: Dispute): DisputeSeverity;
+/** Visual mapping for dispute severity */
+export declare const DISPUTE_SEVERITY_VISUALS: Record<DisputeSeverity, {
+    color: string;
+    pulseSpeed: number;
+    size: number;
+}>;
+export interface WorkspaceFilter {
+    jobStatuses?: JobStatus[];
+    nodeTypes?: NodeType[];
+    nodeStatuses?: NodeStatus[];
+    receiptStatuses?: ReceiptStatus[];
+    trustTiers?: TrustTier[];
+    disputeStatuses?: DisputeStatus[];
+    showJobs?: boolean;
+    showNodes?: boolean;
+    showReceipts?: boolean;
+    showDisputes?: boolean;
+    showTrustRings?: boolean;
+}
+export interface WorkspaceSelection {
+    type: "job" | "node" | "receipt" | "dispute";
+    id: string;
+}
+export interface SpatialWorkspaceProps {
+    jobs?: Job[];
+    nodes?: Node[];
+    receipts?: Receipt[];
+    disputes?: Dispute[];
+    currentTrustTier?: TrustTier;
+    selection?: WorkspaceSelection[];
+    onSelectionChange?: (selection: WorkspaceSelection[]) => void;
+    hovered?: WorkspaceSelection | null;
+    onHoverChange?: (hovered: WorkspaceSelection | null) => void;
+    filters?: WorkspaceFilter;
+    layout?: WorkspaceLayout;
+    layoutOptions?: WorkspaceLayoutOptions;
+    autoRotate?: boolean;
+    enableZoom?: boolean;
+    enablePan?: boolean;
+    className?: string;
+    style?: React.CSSProperties;
+    topologyId?: string;
+    topologyUpdateMs?: number;
+    onTopologyChange?: (topology: VisionTopology) => void;
+    onCanvasReady?: (canvas: HTMLCanvasElement) => void;
+}
+export declare const DEFAULT_WORKSPACE_CONFIG: {
+    layout: WorkspaceLayout;
+    autoRotate: boolean;
+    enableZoom: boolean;
+    enablePan: boolean;
+    layoutOptions: {
+        animate: boolean;
+        animationDuration: number;
+        forceStrength: number;
+        repulsion: number;
+        gravity: number;
+    };
+    filters: {
+        showJobs: boolean;
+        showNodes: boolean;
+        showReceipts: boolean;
+        showDisputes: boolean;
+        showTrustRings: boolean;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/primitives/three/SpatialWorkspace/types.d.ts.map

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