pramana-protocol 1.2.1 → 1.3.0

package/dist/index.d.ts

@@ -158,4 +158,82 @@ export interface AuthenticityMarker {
     explanation?: string;
 }
 export declare function buildMarker(strandsAvailable: StrandType[], slmAvailable?: boolean, explanation?: string): AuthenticityMarker;
+/**
+ * A single node returned by HBT traversal.
+ * Maps to GET /api/hbt/traverse response nodes.
+ */
+export interface TraversalNode {
+    id: string;
+    title: string;
+    domain: string;
+    prb: number;
+    kitchen_mask: number;
+    confidence: number;
+    status: string;
+    /** True if PHALA_DIRTY bit is set — PRAMANA level should be demoted by 1 */
+    phala_dirty: boolean;
+    /** True if PHALA_CLEAN bit is set — last 10 signals all success */
+    phala_clean: boolean;
+    /** Fraction of requested bits matched (0.0–1.0) */
+    match_score: number;
+}
+/**
+ * Full result from HBT traversal engine.
+ * Maps to POST /api/hbt/traverse response (GRANTHX port 4130).
+ */
+export interface TraversalResult {
+    nodes: TraversalNode[];
+    total_indexed: number;
+    domain_matched: number;
+    topic_matched: number;
+    returned: number;
+    elapsed_ms: number;
+    match_method: 'prb_full' | 'prb_domain_only' | 'none';
+    has_dirty_nodes: boolean;
+    intent?: {
+        domain_bit: number;
+        topic_mask: number;
+    };
+}
+/**
+ * Intent vector derived from natural language query + domain hint.
+ * Input to HBT traversal. Output of `encodeIntent()`.
+ */
+export interface IntentVector {
+    /** PRB domain bits (one or more PRB_DOMAIN bits ORed together) */
+    intentDomainBit: number;
+    /** PRB topic + tier bits (from PRB_TOPIC + PRB_TIER, may be 0 = any) */
+    intentTopicMask: number;
+    labels: {
+        domains: string[];
+        topics: string[];
+    };
+    /** True if query spans more than one domain */
+    multiDomain: boolean;
+}
+/**
+ * Domain branch entry from the HBT L1 domain index.
+ * Returned by GET /api/hbt/domain-branches.
+ */
+export interface DomainBranch {
+    domain_bit: number;
+    domain_name: string;
+    domain_hex: string;
+    service_count: number;
+    services: Array<{
+        id: string;
+        description?: string;
+    }>;
+}
+/**
+ * Full domain branch index (L1 of the HBT).
+ * Returned by GET /api/hbt/domain-branches.
+ */
+export interface DomainBranchIndex {
+    built_at: string;
+    universe_mask: number;
+    universe_hex: string;
+    total_services: number;
+    branches: DomainBranch[];
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pramana-protocol",
-  "version": "1.2.1",
-  "description": "PRAMANA/1.0 — SHREEA Protocol Layer 3+4. Three strands. Four signals. Five authenticity levels. HBT kitchen_mask + PRB (Pramana Rule Bitmask) for binary truth at rule level.",
+  "version": "1.3.0",
+  "description": "PRAMANA/1.0 — SHREEA Protocol Layers 3+4. Three strands. Four signals. Five levels. HBT PRB + kitchen_mask + TraversalResult + DomainBranchIndex types. Binary truth at every level.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [