@subcortex-ai/sdk 0.1.3 → 0.3.0

package/dist/index.js

@@ -905,49 +905,10 @@ ${connectedPeople.map((p) => {
     let assertionsCreated = 0;
     let relationshipsCreated = 0;
     const warnings = [];
-    await this.http.post("/api/v1/assertions", {
-      tenant_id: this.tenantId,
-      subject: personSubject,
-      predicate: "name",
-      value: input.name,
-      confidence: conf
-    });
-    assertionsCreated++;
+    const candidates = [];
+    candidates.push({ subject: personSubject, predicate: "name", value: input.name, source_confidence: conf, provenance: "agent" });
     if (input.role) {
-      try {
-        const existing = await this.http.get(
-          `/api/v1/assertions/query/${enc2(this.tenantId)}/${enc2(personSubject)}`
-        );
-        const existingRole = existing.find((a) => a.predicate === "role" && !a.isSuperseded);
-        if (existingRole && existingRole.value !== input.role) {
-          warnings.push(`${input.name} was previously "${existingRole.value}" \u2014 now being set as "${input.role}". Role change or mistake?`);
-          await this.http.post("/api/v1/assertions/supersede", {
-            tenant_id: this.tenantId,
-            original_assertion_id: existingRole.id,
-            subject: personSubject,
-            predicate: "role",
-            value: input.role,
-            confidence: conf
-          });
-        } else if (!existingRole) {
-          await this.http.post("/api/v1/assertions", {
-            tenant_id: this.tenantId,
-            subject: personSubject,
-            predicate: "role",
-            value: input.role,
-            confidence: conf
-          });
-        }
-      } catch {
-        await this.http.post("/api/v1/assertions", {
-          tenant_id: this.tenantId,
-          subject: personSubject,
-          predicate: "role",
-          value: input.role,
-          confidence: conf
-        });
-      }
-      assertionsCreated++;
+      candidates.push({ subject: personSubject, predicate: "role", value: input.role, source_confidence: conf, provenance: "agent" });
       try {
         const allAssertions = await this.http.get(
           `/api/v1/assertions/list/${enc2(this.tenantId)}`
@@ -964,6 +925,35 @@ ${connectedPeople.map((p) => {
         }
       } catch {
       }
+    }
+    if (input.details) {
+      candidates.push({ subject: personSubject, predicate: "details", value: input.details, source_confidence: conf, provenance: "agent" });
+    }
+    candidates.push({
+      subject: personSubject,
+      predicate: "status",
+      value: input.relationship === "candidate" ? "candidate" : "active",
+      source_confidence: conf,
+      provenance: "agent"
+    });
+    const correlationId = `register_person_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+    const intakeResult = await this.http.post("/api/v1/intake/submit", {
+      correlation_id: correlationId,
+      agent_id: "sdk",
+      tenant_id: this.tenantId,
+      candidates,
+      context: input.sessionId ? { sessionId: input.sessionId } : void 0
+    });
+    assertionsCreated = intakeResult.accepted + intakeResult.reinforced;
+    if (intakeResult.conflicts > 0) {
+      const conflictItems = (intakeResult.items || []).filter(
+        (i) => i.status === "conflict_detected"
+      );
+      for (const item of conflictItems) {
+        warnings.push(item.surfacingHint || "A conflict was detected with existing data.");
+      }
+    }
+    if (input.role) {
       const roleSubject = subject("role" /* ROLE */, input.role);
       await this.http.post("/api/v1/assertions", {
         tenant_id: this.tenantId,
@@ -979,34 +969,13 @@ ${connectedPeople.map((p) => {
         relationship_type: "holds_role" /* HOLDS_ROLE */,
         confidence: conf
       });
-      assertionsCreated++;
       relationshipsCreated++;
     }
-    if (input.details) {
-      await this.http.post("/api/v1/assertions", {
-        tenant_id: this.tenantId,
-        subject: personSubject,
-        predicate: "details",
-        value: input.details,
-        confidence: conf
-      });
-      assertionsCreated++;
-    }
-    await this.http.post("/api/v1/assertions", {
-      tenant_id: this.tenantId,
-      subject: personSubject,
-      predicate: "status",
-      value: input.relationship === "candidate" ? "candidate" : "active",
-      confidence: conf
-    });
-    assertionsCreated++;
     const FORWARD_MAP = {
       "direct_report": "manages" /* MANAGES */,
       "team_member": "has_member" /* HAS_MEMBER */,
       "candidate": "manages" /* MANAGES */,
-      // user manages the hiring
       "manager": "reports_to" /* REPORTS_TO */,
-      // user reports to this person
       "stakeholder": "stakeholder_in" /* STAKEHOLDER_IN */,
       "collaborator": "collaborates_with" /* COLLABORATES_WITH */,
       "mentor": "mentors" /* MENTORS */
@@ -1047,31 +1016,26 @@ ${connectedPeople.map((p) => {
   async recordRapport(input) {
     const userSubject = subject("user" /* USER */, input.userId);
     const conf = typeof input.confidence === "number" ? input.confidence : confidenceToScore(input.confidence || "high" /* HIGH */);
-    await this.http.post("/api/v1/assertions", {
-      tenant_id: this.tenantId,
-      subject: userSubject,
-      predicate: input.type,
-      value: input.value,
-      confidence: conf
-    });
+    const candidates = [
+      { subject: userSubject, predicate: input.type, value: input.value, source_confidence: conf, provenance: "agent" }
+    ];
     if (input.aboutPerson) {
       const personSubject = subject("person" /* PERSON */, input.aboutPerson);
-      try {
-        const personAssertions = await this.http.get(
-          `/api/v1/assertions/query/${enc2(this.tenantId)}/${enc2(personSubject)}`
-        );
-        if (personAssertions.length > 0) {
-          await this.http.post("/api/v1/assertions", {
-            tenant_id: this.tenantId,
-            subject: personSubject,
-            predicate: "timeline",
-            value: input.value,
-            confidence: conf
-          });
-        }
-      } catch {
-      }
+      candidates.push({
+        subject: personSubject,
+        predicate: "timeline",
+        value: input.value,
+        source_confidence: conf,
+        provenance: "agent"
+      });
     }
+    const correlationId = `rapport_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 6)}`;
+    await this.http.post("/api/v1/intake/submit", {
+      correlation_id: correlationId,
+      agent_id: "sdk",
+      tenant_id: this.tenantId,
+      candidates
+    });
     return { success: true };
   }
   /**
@@ -1096,6 +1060,242 @@ function enc2(s) {
   return encodeURIComponent(s);
 }
 
+// src/types/rules.ts
+var RulePredicates = {
+  BANNED_PATTERN: "rule:banned_pattern",
+  REQUIRED_PATTERN: "rule:required_pattern",
+  FILE_CONSTRAINT: "rule:file_constraint",
+  REQUIRES_PROPAGATION: "rule:requires_propagation"
+};
+
+// src/rules.ts
+var RULE_PREDICATE_PREFIX = "rule:";
+var TYPE_TO_PREDICATE = {
+  banned_pattern: RulePredicates.BANNED_PATTERN,
+  required_pattern: RulePredicates.REQUIRED_PATTERN,
+  file_constraint: RulePredicates.FILE_CONSTRAINT,
+  requires_propagation: RulePredicates.REQUIRES_PROPAGATION
+};
+function defaultSeverity(confidence) {
+  if (confidence >= 1) return "block";
+  if (confidence >= 0.7) return "warn";
+  return "info";
+}
+var RulesNamespace = class {
+  http;
+  tenantId;
+  constructor(http, tenantId) {
+    this.http = http;
+    this.tenantId = tenantId;
+  }
+  /**
+   * Create a new rule.
+   *
+   * Stores an assertion with a `rule:*` predicate and a typed value.
+   * Defaults to confidence 1.0 (enforcement) if not specified.
+   *
+   * @example
+   * ```typescript
+   * await subcortex.rules.create({
+   *   subject: 'project:my-project',
+   *   type: 'banned_pattern',
+   *   pattern: 'as any',
+   *   description: 'No any casts — use proper types',
+   * })
+   * ```
+   */
+  async create(input) {
+    const confidence = input.confidence ?? 1;
+    const severity = input.severity ?? defaultSeverity(confidence);
+    const ruleValue = {
+      description: input.description,
+      pattern: input.pattern,
+      fileScope: input.fileScope,
+      propagatesTo: input.propagatesTo
+    };
+    const assertion = await this.http.post(
+      `/api/v1/assertions`,
+      {
+        subject: input.subject,
+        predicate: TYPE_TO_PREDICATE[input.type],
+        value: { ...ruleValue, severity },
+        confidence,
+        tenant_id: input.tenantId ?? this.tenantId
+      },
+      input.tenantId ?? this.tenantId
+    );
+    return parseRule(assertion);
+  }
+  /**
+   * Get a rule by its assertion ID.
+   */
+  async get(ruleId, options) {
+    const tenant = options?.tenantId ?? this.tenantId;
+    const assertion = await this.http.get(
+      `/api/v1/assertions/${enc3(tenant)}/${enc3(ruleId)}`
+    );
+    return parseRule(assertion);
+  }
+  /**
+   * List all rules for this project, optionally filtered by type or severity.
+   */
+  async list(options) {
+    const tenant = options?.tenantId ?? this.tenantId;
+    const assertions = await this.http.get(
+      `/api/v1/assertions/list/${enc3(tenant)}`
+    );
+    return assertions.filter((a) => isRuleAssertion(a)).filter((a) => options?.includeSuperseded || !a.isSuperseded).map(parseRule).filter((r) => !options?.type || r.type === options.type).filter((r) => !options?.severity || r.severity === options.severity);
+  }
+  /**
+   * Get all rules whose fileScope matches the given file path.
+   *
+   * This is the primary query for the PreToolUse hook — "what rules apply
+   * to the file I'm about to modify?"
+   *
+   * @example
+   * ```typescript
+   * const rules = await subcortex.rules.forFile('app/api/users/route.ts')
+   * // Returns banned_pattern and required_pattern rules whose fileScope
+   * // matches the path, plus any project-wide rules without a fileScope.
+   * ```
+   */
+  async forFile(filePath, options) {
+    const allRules = await this.list(options);
+    return allRules.filter((rule) => {
+      if (!rule.value.fileScope) return true;
+      try {
+        const regex = new RegExp(rule.value.fileScope);
+        return regex.test(filePath);
+      } catch {
+        return false;
+      }
+    });
+  }
+  /**
+   * Get all rules scoped to a specific intent subject.
+   *
+   * @example
+   * ```typescript
+   * const apiRules = await subcortex.rules.forIntent('api')
+   * // Queries subject "intent:api" for all rule assertions
+   * ```
+   */
+  async forIntent(intent, options) {
+    const tenant = options?.tenantId ?? this.tenantId;
+    const subject2 = intent.startsWith("intent:") ? intent : `intent:${intent}`;
+    const assertions = await this.http.get(
+      `/api/v1/assertions/query/${enc3(tenant)}/${enc3(subject2)}`
+    );
+    return assertions.filter((a) => isRuleAssertion(a)).filter((a) => options?.includeSuperseded || !a.isSuperseded).map(parseRule).filter((r) => !options?.type || r.type === options.type).filter((r) => !options?.severity || r.severity === options.severity);
+  }
+  /**
+   * Get all rules scoped to a specific subject (project, file, intent, etc.).
+   */
+  async forSubject(subject2, options) {
+    const tenant = options?.tenantId ?? this.tenantId;
+    const assertions = await this.http.get(
+      `/api/v1/assertions/query/${enc3(tenant)}/${enc3(subject2)}`
+    );
+    return assertions.filter((a) => isRuleAssertion(a)).filter((a) => options?.includeSuperseded || !a.isSuperseded).map(parseRule).filter((r) => !options?.type || r.type === options.type).filter((r) => !options?.severity || r.severity === options.severity);
+  }
+  /**
+   * Update a rule by superseding it.
+   *
+   * The old rule is marked as superseded, a new one is created.
+   * Full assertion history is preserved.
+   */
+  async update(input) {
+    const tenant = input.tenantId ?? this.tenantId;
+    const existing = await this.get(input.ruleId, { tenantId: tenant });
+    const confidence = input.confidence ?? existing.confidence;
+    const severity = input.severity ?? existing.severity;
+    const ruleValue = {
+      description: input.description ?? existing.value.description,
+      pattern: input.pattern ?? existing.value.pattern,
+      fileScope: input.fileScope ?? existing.value.fileScope,
+      propagatesTo: input.propagatesTo ?? existing.value.propagatesTo
+    };
+    const assertion = await this.http.post(
+      `/api/v1/assertions/supersede`,
+      {
+        original_assertion_id: input.ruleId,
+        subject: existing.subject,
+        predicate: existing.predicate,
+        value: { ...ruleValue, severity },
+        confidence,
+        tenant_id: tenant
+      },
+      tenant
+    );
+    return parseRule(assertion);
+  }
+  /**
+   * Retract (deactivate) a rule.
+   *
+   * The assertion's temporal bounds are closed. The rule stops matching
+   * in future queries but its history is preserved.
+   */
+  async retract(ruleId, options) {
+    const tenant = options?.tenantId ?? this.tenantId;
+    await this.http.post(
+      `/api/v1/assertions/retract/${enc3(tenant)}/${enc3(ruleId)}`,
+      {},
+      tenant
+    );
+  }
+};
+function isRuleAssertion(assertion) {
+  return assertion.predicate?.startsWith(RULE_PREDICATE_PREFIX) ?? false;
+}
+function parseRule(assertion) {
+  const predicate = assertion.predicate;
+  const type = predicate.replace(RULE_PREDICATE_PREFIX, "");
+  let ruleValue;
+  let severity;
+  if (typeof assertion.value === "object" && assertion.value !== null) {
+    const val = assertion.value;
+    ruleValue = {
+      description: String(val.description ?? ""),
+      pattern: val.pattern != null ? String(val.pattern) : void 0,
+      fileScope: val.fileScope != null ? String(val.fileScope) : void 0,
+      propagatesTo: Array.isArray(val.propagatesTo) ? val.propagatesTo.map(String) : void 0
+    };
+    severity = val.severity ?? defaultSeverity(assertion.confidence);
+  } else if (typeof assertion.value === "string") {
+    try {
+      const parsed = JSON.parse(assertion.value);
+      ruleValue = {
+        description: String(parsed.description ?? ""),
+        pattern: parsed.pattern != null ? String(parsed.pattern) : void 0,
+        fileScope: parsed.filePattern != null ? String(parsed.filePattern) : void 0,
+        propagatesTo: Array.isArray(parsed.propagatesTo) ? parsed.propagatesTo.map(String) : void 0
+      };
+      severity = parsed.severity ?? defaultSeverity(assertion.confidence);
+    } catch {
+      ruleValue = { description: String(assertion.value) };
+      severity = defaultSeverity(assertion.confidence);
+    }
+  } else {
+    ruleValue = { description: "" };
+    severity = defaultSeverity(assertion.confidence);
+  }
+  return {
+    id: assertion.id,
+    tenantId: assertion.tenantId,
+    subject: assertion.subject,
+    type,
+    predicate,
+    value: ruleValue,
+    severity,
+    confidence: assertion.confidence,
+    validFrom: assertion.validFrom,
+    isSuperseded: assertion.isSuperseded
+  };
+}
+function enc3(s) {
+  return encodeURIComponent(s);
+}
+
 // src/client.ts
 var AssertionsNamespace = class {
   constructor(http, tenantId) {
@@ -1117,21 +1317,21 @@ var AssertionsNamespace = class {
   async get(assertionId, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/assertions/${enc3(tenantId)}/${enc3(assertionId)}`
+      `/api/v1/assertions/${enc4(tenantId)}/${enc4(assertionId)}`
     );
   }
   /** Query assertions by subject. */
   async query(subject2, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/assertions/query/${enc3(tenantId)}/${enc3(subject2)}`
+      `/api/v1/assertions/query/${enc4(tenantId)}/${enc4(subject2)}`
     );
   }
   /** List all active assertions for the tenant. */
   async list(options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/assertions/list/${enc3(tenantId)}`
+      `/api/v1/assertions/list/${enc4(tenantId)}`
     );
   }
   /** Supersede an existing assertion with updated values. */
@@ -1150,7 +1350,7 @@ var AssertionsNamespace = class {
   async retract(assertionId, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.post(
-      `/api/v1/assertions/retract/${enc3(tenantId)}/${enc3(assertionId)}`,
+      `/api/v1/assertions/retract/${enc4(tenantId)}/${enc4(assertionId)}`,
       {}
     );
   }
@@ -1177,14 +1377,14 @@ var RelationshipsNamespace = class {
   async query(subject2, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/relationships/${enc3(tenantId)}/${enc3(subject2)}`
+      `/api/v1/relationships/${enc4(tenantId)}/${enc4(subject2)}`
     );
   }
   /** List all relationships for the tenant. */
   async list(options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/relationships/list/${enc3(tenantId)}`
+      `/api/v1/relationships/list/${enc4(tenantId)}`
     );
   }
 };
@@ -1211,14 +1411,14 @@ var AgentsNamespace = class {
   async get(agentId, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/agents/${enc3(tenantId)}/${enc3(agentId)}`
+      `/api/v1/agents/${enc4(tenantId)}/${enc4(agentId)}`
     );
   }
   /** Update an agent. */
   async update(agentId, input, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.put(
-      `/api/v1/agents/${enc3(tenantId)}/${enc3(agentId)}`,
+      `/api/v1/agents/${enc4(tenantId)}/${enc4(agentId)}`,
       {
         tenant_id: tenantId,
         name: input.name,
@@ -1235,20 +1435,20 @@ var AgentsNamespace = class {
   /** Delete an agent. */
   async delete(agentId, options) {
     const tenantId = options?.tenantId || this.tenantId;
-    await this.http.delete(`/api/v1/agents/${enc3(tenantId)}/${enc3(agentId)}`);
+    await this.http.delete(`/api/v1/agents/${enc4(tenantId)}/${enc4(agentId)}`);
   }
   /** List all agents for the tenant. */
   async list(options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/agents/list/${enc3(tenantId)}`
+      `/api/v1/agents/list/${enc4(tenantId)}`
     );
   }
   /** Get composed system instructions for an agent. */
   async getInstructions(agentId, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/agents/${enc3(tenantId)}/${enc3(agentId)}/instructions`
+      `/api/v1/agents/${enc4(tenantId)}/${enc4(agentId)}/instructions`
     );
   }
 };
@@ -1298,14 +1498,14 @@ var MemoryNamespace = class {
   async recall(subject2, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.get(
-      `/api/v1/assertions/query/${enc3(tenantId)}/${enc3(subject2)}`
+      `/api/v1/assertions/query/${enc4(tenantId)}/${enc4(subject2)}`
     );
   }
   /** Forget a specific memory (retract the assertion). */
   async forget(assertionId, options) {
     const tenantId = options?.tenantId || this.tenantId;
     return this.http.post(
-      `/api/v1/assertions/retract/${enc3(tenantId)}/${enc3(assertionId)}`,
+      `/api/v1/assertions/retract/${enc4(tenantId)}/${enc4(assertionId)}`,
       {}
     );
   }
@@ -1337,7 +1537,7 @@ var IntakeNamespace = class {
   }
   /** Get pending intake results for an agent. */
   async pending(agentId, options) {
-    let path = `/api/v1/intake/pending/${enc3(agentId)}`;
+    let path = `/api/v1/intake/pending/${enc4(agentId)}`;
     const params = [];
     if (options?.status) params.push(`status=${options.status.join(",")}`);
     if (options?.limit) params.push(`limit=${options.limit}`);
@@ -1346,18 +1546,131 @@ var IntakeNamespace = class {
   }
   /** Acknowledge an intake result (mark as consumed). */
   async acknowledge(itemId) {
-    await this.http.post(`/api/v1/intake/acknowledge/${enc3(itemId)}`, {});
+    await this.http.post(`/api/v1/intake/acknowledge/${enc4(itemId)}`, {});
   }
   /** Acknowledge all pending items for an agent. */
   async acknowledgeAll(agentId) {
     return this.http.post(
-      `/api/v1/intake/acknowledge-all/${enc3(agentId)}`,
+      `/api/v1/intake/acknowledge-all/${enc4(agentId)}`,
       {}
     );
   }
   /** Get intake processing stats for an agent. */
   async stats(agentId) {
-    return this.http.get(`/api/v1/intake/stats/${enc3(agentId)}`);
+    return this.http.get(`/api/v1/intake/stats/${enc4(agentId)}`);
+  }
+};
+var ExperiencesNamespace = class {
+  constructor(http, tenantId) {
+    this.http = http;
+    this.tenantId = tenantId;
+  }
+  /** List experiences, optionally filtered by subject. */
+  async list(input) {
+    const tenantId = input?.tenantId || this.tenantId;
+    const params = new URLSearchParams();
+    if (input?.subject) params.set("subject", input.subject);
+    if (input?.limit) params.set("limit", String(input.limit));
+    const qs = params.toString();
+    return this.http.get(
+      `/api/v1/experiences/${enc4(tenantId)}${qs ? `?${qs}` : ""}`
+    );
+  }
+  /** Get a single experience by ID. */
+  async get(experienceId, options) {
+    const tenantId = options?.tenantId || this.tenantId;
+    return this.http.get(
+      `/api/v1/experiences/${enc4(tenantId)}/${enc4(experienceId)}`
+    );
+  }
+};
+var RecallNamespace = class {
+  constructor(http, tenantId) {
+    this.http = http;
+    this.tenantId = tenantId;
+  }
+  /** BM25 full-text search across assertions. */
+  async search(input) {
+    const tenantId = input.tenantId || this.tenantId;
+    const params = new URLSearchParams({ q: input.query });
+    if (input.limit) params.set("limit", String(input.limit));
+    return this.http.get(
+      `/api/v1/recall/${enc4(tenantId)}?${params.toString()}`
+    );
+  }
+};
+var GraphNamespace = class {
+  constructor(http, tenantId) {
+    this.http = http;
+    this.tenantId = tenantId;
+  }
+  /** Find paths between two subjects. */
+  async findPaths(input) {
+    const tenantId = input.tenantId || this.tenantId;
+    return this.http.post(
+      `/api/v1/graph/${enc4(tenantId)}/paths`,
+      {
+        from: input.from,
+        to: input.to,
+        max_depth: input.maxDepth,
+        min_confidence: input.minConfidence,
+        strategy: input.strategy
+      }
+    );
+  }
+  /** BFS traversal from a starting subject. */
+  async traverse(input) {
+    const tenantId = input.tenantId || this.tenantId;
+    return this.http.post(
+      `/api/v1/graph/${enc4(tenantId)}/traverse`,
+      {
+        start_subject: input.startSubject,
+        max_depth: input.maxDepth,
+        relationship_types: input.relationshipTypes,
+        min_confidence: input.minConfidence,
+        max_nodes: input.maxNodes
+      }
+    );
+  }
+};
+var TemporalNamespace = class {
+  constructor(http, tenantId) {
+    this.http = http;
+    this.tenantId = tenantId;
+  }
+  /** Get assertions valid at a specific point in time. */
+  async at(subject2, point, options) {
+    const tenantId = options?.tenantId || this.tenantId;
+    const pointStr = point instanceof Date ? point.toISOString() : point;
+    return this.http.get(
+      `/api/v1/temporal/${enc4(tenantId)}/${enc4(subject2)}/at?point=${enc4(pointStr)}`
+    );
+  }
+  /** Get assertions within a date range. */
+  async range(subject2, start, end, options) {
+    const tenantId = options?.tenantId || this.tenantId;
+    const startStr = start instanceof Date ? start.toISOString() : start;
+    const endStr = end instanceof Date ? end.toISOString() : end;
+    return this.http.get(
+      `/api/v1/temporal/${enc4(tenantId)}/${enc4(subject2)}/range?start=${enc4(startStr)}&end=${enc4(endStr)}`
+    );
+  }
+};
+var SearchNamespace = class {
+  constructor(http, tenantId) {
+    this.http = http;
+    this.tenantId = tenantId;
+  }
+  /** Semantic nearest-neighbor search over assertion embeddings. */
+  async semantic(input) {
+    const tenantId = input.tenantId || this.tenantId;
+    return this.http.post(
+      `/api/v1/search/${enc4(tenantId)}/semantic`,
+      {
+        embedding: input.embedding,
+        top_k: input.topK
+      }
+    );
   }
 };
 var DEFAULT_RETRY = {
@@ -1365,6 +1678,129 @@ var DEFAULT_RETRY = {
   baseDelayMs: 500,
   maxDelayMs: 1e4
 };
+var EntitiesNamespace = class {
+  constructor(http, tenantId) {
+    this.http = http;
+    this.tenantId = tenantId;
+  }
+  /** Create an entity with optional description and type. */
+  async create(input) {
+    const tenantId = input.tenantId || this.tenantId;
+    const subject2 = `entity:${input.name.toLowerCase().replace(/\s+/g, "-")}`;
+    const typeAssertion = await this.http.post(
+      `/api/v1/assertions`,
+      {
+        tenant_id: tenantId,
+        subject: subject2,
+        predicate: "type",
+        value: input.type || "model",
+        confidence: 1
+      }
+    );
+    if (input.description) {
+      await this.http.post(
+        `/api/v1/assertions`,
+        {
+          tenant_id: tenantId,
+          subject: subject2,
+          predicate: "description",
+          value: input.description,
+          confidence: 1
+        }
+      );
+    }
+    return typeAssertion;
+  }
+  /** Add a property to an entity. */
+  async addProperty(input) {
+    const tenantId = input.tenantId || this.tenantId;
+    const entitySubject = `entity:${input.entityName.toLowerCase().replace(/\s+/g, "-")}`;
+    const propertySubject = `property:${input.entityName.toLowerCase().replace(/\s+/g, "-")}.${input.name.toLowerCase().replace(/\s+/g, "-")}`;
+    const assertion = await this.http.post(
+      `/api/v1/assertions`,
+      {
+        tenant_id: tenantId,
+        subject: propertySubject,
+        predicate: "field_type",
+        value: input.fieldType,
+        confidence: 1
+      }
+    );
+    const relationship = await this.http.post(
+      `/api/v1/relationships`,
+      {
+        tenant_id: tenantId,
+        from_subject: entitySubject,
+        to_subject: propertySubject,
+        relationship_type: "has_property",
+        confidence: 1
+      }
+    );
+    if (input.required) {
+      await this.http.post(
+        `/api/v1/assertions`,
+        {
+          tenant_id: tenantId,
+          subject: propertySubject,
+          predicate: "required",
+          value: true,
+          confidence: 1
+        }
+      );
+    }
+    return { assertion, relationship };
+  }
+  /** Describe an entity by reconstructing its properties and relationships from assertions. */
+  async describe(entityName, options) {
+    const tenantId = options?.tenantId || this.tenantId;
+    const subject2 = `entity:${entityName.toLowerCase().replace(/\s+/g, "-")}`;
+    const assertions = await this.http.get(
+      `/api/v1/assertions/query/${enc4(tenantId)}/${enc4(subject2)}`
+    );
+    const relationships = await this.http.get(
+      `/api/v1/relationships/query/${enc4(tenantId)}/${enc4(subject2)}`
+    );
+    const typeAssertion = assertions.find((a) => a.predicate === "type" && !a.isSuperseded);
+    const descAssertion = assertions.find((a) => a.predicate === "description" && !a.isSuperseded);
+    const propertyRels = relationships.filter((r) => r.relationshipType === "has_property");
+    const properties = await Promise.all(
+      propertyRels.map(async (rel) => {
+        const propAssertions = await this.http.get(
+          `/api/v1/assertions/query/${enc4(tenantId)}/${enc4(rel.toSubject)}`
+        );
+        const fieldType = propAssertions.find((a) => a.predicate === "field_type" && !a.isSuperseded);
+        const required = propAssertions.find((a) => a.predicate === "required" && !a.isSuperseded);
+        const name = rel.toSubject.replace(/^property:[^.]+\./, "");
+        return {
+          name,
+          fieldType: fieldType ? String(fieldType.value) : null,
+          required: required ? Boolean(required.value) : false
+        };
+      })
+    );
+    const otherRels = relationships.filter((r) => r.relationshipType !== "has_property").map((r) => ({
+      type: r.relationshipType,
+      target: r.toSubject,
+      confidence: r.confidence
+    }));
+    return {
+      subject: subject2,
+      name: entityName,
+      type: typeAssertion ? String(typeAssertion.value) : null,
+      description: descAssertion ? String(descAssertion.value) : null,
+      properties,
+      relationships: otherRels
+    };
+  }
+  /** List all entities for a tenant (subjects with entity: prefix that have a type predicate). */
+  async list(options) {
+    const tenantId = options?.tenantId || this.tenantId;
+    const all = await this.http.get(
+      `/api/v1/assertions/list/${enc4(tenantId)}`
+    );
+    return all.filter((a) => a.subject.startsWith("entity:") && a.predicate === "type" && !a.isSuperseded);
+  }
+};
 var SubCortexClient = class {
   /** Assertion operations (low-level knowledge primitives) */
   assertions;
@@ -1380,6 +1816,20 @@ var SubCortexClient = class {
   users;
   /** Emotional signals — record, query, and resolve */
   signals;
+  /** Graph queries — pathfinding and traversal */
+  graph;
+  /** Temporal queries — point-in-time snapshots and range queries */
+  temporal;
+  /** Semantic search over assertion embeddings */
+  search;
+  /** BM25 full-text recall search */
+  recall;
+  /** Episodic memory — experiences grouped by session */
+  experiences;
+  /** Entity schema management — create, describe, and manage data models */
+  entities;
+  /** Code guardrails — typed rules stored as assertions with file-scope matching */
+  rules;
   http;
   constructor(options) {
     if (!options.apiKey && !options.token) {
@@ -1403,13 +1853,20 @@ var SubCortexClient = class {
     this.intake = new IntakeNamespace(this.http, options.tenantId);
     this.users = new UsersNamespace(this.http, options.tenantId);
     this.signals = new SignalsNamespace(this.http, options.tenantId);
+    this.graph = new GraphNamespace(this.http, options.tenantId);
+    this.temporal = new TemporalNamespace(this.http, options.tenantId);
+    this.search = new SearchNamespace(this.http, options.tenantId);
+    this.recall = new RecallNamespace(this.http, options.tenantId);
+    this.experiences = new ExperiencesNamespace(this.http, options.tenantId);
+    this.entities = new EntitiesNamespace(this.http, options.tenantId);
+    this.rules = new RulesNamespace(this.http, options.tenantId);
   }
   /** Check SubCortex server health. */
   async health() {
     return this.http.get("/health");
   }
 };
-function enc3(s) {
+function enc4(s) {
   return encodeURIComponent(s);
 }
 
@@ -1577,9 +2034,12 @@ export {
   CONTEXT_SCHEMA_VERSION,
   ConfidenceLevel,
   ConfidenceScores,
+  EntitiesNamespace,
   EntityPredicate,
   EntityRelationship,
   EventPredicate,
+  ExperiencesNamespace,
+  GraphNamespace,
   IdentityPredicate,
   IntakeNamespace,
   MULTI_VALUE_PREDICATES,
@@ -1592,10 +2052,14 @@ export {
   RELATIONSHIP_LABELS,
   REVERSE_RELATIONSHIPS,
   RapportPredicate,
+  RecallNamespace,
   RelationshipTypes,
   RelationshipsNamespace,
+  RulePredicates,
+  RulesNamespace,
   SIGNAL_DECAY_CONFIG,
   SYSTEM_SIGNAL_TYPES,
+  SearchNamespace,
   SignalsNamespace,
   SubCortexAuthenticationError,
   SubCortexAuthorizationError,
@@ -1609,6 +2073,7 @@ export {
   SubCortexTimeoutError,
   SubCortexValidationError,
   SubjectPrefix,
+  TemporalNamespace,
   UsersNamespace,
   WorkPredicate,
   confidenceToScore,