@sudobility/sider_lib 0.0.2 → 0.0.3

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./templating";
+export { templatePath, graphqlOperationOf, endpointKey, clusterObservations, hashRecipe, canonicalizeRecipe, } from "@sudobility/sider_types";
 export * from "./tokenize";
 export * from "./recipe";
 export * from "./gates";

package/dist/index.js

@@ -8,7 +8,9 @@
 //
 // No Chrome/DOM/server dependencies — safe to import from sider_api,
 // sider_extension, and sider_app alike.
-export * from "./templating";
+// Clustering/templating + recipe hashing moved to sider_types (shared with the
+// backend); re-exported here so sider_lib's public API stays stable.
+export { templatePath, graphqlOperationOf, endpointKey, clusterObservations, hashRecipe, canonicalizeRecipe, } from "@sudobility/sider_types";
 export * from "./tokenize";
 export * from "./recipe";
 export * from "./gates";

package/dist/recipe.d.ts

@@ -1,4 +1,4 @@
-import type { CompiledRequest, InvocationRecipe, ToolSpec } from "@sudobility/sider_types";
+import type { CompiledRequest, ToolSpec } from "@sudobility/sider_types";
 export declare function secretSentinel(slotId: string): string;
 export declare class RecipeCompileError extends Error {
 }
@@ -13,6 +13,3 @@ export interface CompileContext {
 export declare function compileRecipe(tool: ToolSpec, ctx: CompileContext): CompiledRequest;
 /** Read a dotted/bracketed path from an object: "data.sections[0].id". */
 export declare function getByPath(obj: unknown, path: string): unknown;
-/** Stable stringify (sorted keys) so two users' equivalent recipes hash equal. */
-export declare function canonicalizeRecipe(recipe: InvocationRecipe): string;
-export declare function hashRecipe(recipe: InvocationRecipe): string;

package/dist/recipe.js

@@ -92,24 +92,5 @@ export function getByPath(obj, path) {
     }
     return cur;
 }
-// --- Recipe canonicalization for corroboration hashing --------------------
-/** Stable stringify (sorted keys) so two users' equivalent recipes hash equal. */
-export function canonicalizeRecipe(recipe) {
-    return stableStringify(recipe);
-}
-export function hashRecipe(recipe) {
-    const s = canonicalizeRecipe(recipe);
-    let h = 0;
-    for (let i = 0; i < s.length; i++)
-        h = (Math.imul(31, h) + s.charCodeAt(i)) | 0;
-    return (h >>> 0).toString(16);
-}
-function stableStringify(v) {
-    if (v === null || typeof v !== "object")
-        return JSON.stringify(v) ?? "null";
-    if (Array.isArray(v))
-        return `[${v.map(stableStringify).join(",")}]`;
-    const obj = v;
-    const keys = Object.keys(obj).sort();
-    return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(",")}}`;
-}
+// Recipe canonicalization + corroboration hashing now live in sider_types
+// (shared by the backend trust engine); re-exported from sider_lib/index.ts.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sudobility/sider_lib",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Sider business logic — recipe compiler, egress gates, tokenizer, clustering. Pure, no Chrome/DOM/server.",
   "license": "BUSL-1.1",
   "publishConfig": {
@@ -19,7 +19,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@sudobility/sider_types": "^0.0.2"
+    "@sudobility/sider_types": "^0.0.3"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",

package/src/index.ts

@@ -9,7 +9,16 @@
 // No Chrome/DOM/server dependencies — safe to import from sider_api,
 // sider_extension, and sider_app alike.
 
-export * from "./templating";
+// Clustering/templating + recipe hashing moved to sider_types (shared with the
+// backend); re-exported here so sider_lib's public API stays stable.
+export {
+  templatePath,
+  graphqlOperationOf,
+  endpointKey,
+  clusterObservations,
+  hashRecipe,
+  canonicalizeRecipe,
+} from "@sudobility/sider_types";
 export * from "./tokenize";
 export * from "./recipe";
 export * from "./gates";

package/src/recipe.ts

@@ -7,7 +7,6 @@
 
 import type {
   CompiledRequest,
-  InvocationRecipe,
   ParamBinding,
   ToolSpec,
 } from "@sudobility/sider_types";
@@ -120,24 +119,5 @@ export function getByPath(obj: unknown, path: string): unknown {
   return cur;
 }
 
-// --- Recipe canonicalization for corroboration hashing --------------------
-
-/** Stable stringify (sorted keys) so two users' equivalent recipes hash equal. */
-export function canonicalizeRecipe(recipe: InvocationRecipe): string {
-  return stableStringify(recipe);
-}
-
-export function hashRecipe(recipe: InvocationRecipe): string {
-  const s = canonicalizeRecipe(recipe);
-  let h = 0;
-  for (let i = 0; i < s.length; i++) h = (Math.imul(31, h) + s.charCodeAt(i)) | 0;
-  return (h >>> 0).toString(16);
-}
-
-function stableStringify(v: unknown): string {
-  if (v === null || typeof v !== "object") return JSON.stringify(v) ?? "null";
-  if (Array.isArray(v)) return `[${v.map(stableStringify).join(",")}]`;
-  const obj = v as Record<string, unknown>;
-  const keys = Object.keys(obj).sort();
-  return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(obj[k])}`).join(",")}}`;
-}
+// Recipe canonicalization + corroboration hashing now live in sider_types
+// (shared by the backend trust engine); re-exported from sider_lib/index.ts.

package/dist/templating.d.ts

@@ -1,13 +0,0 @@
-import type { Observation } from "@sudobility/sider_types";
-/** Replace id-like path segments with `{id}`: /sections/120/seats → /sections/{id}/seats */
-export declare function templatePath(rawUrl: string): string;
-/**
- * GraphQL keying: one URL serves many operations, so cluster on operation name,
- * not path. Returns undefined for non-GraphQL requests.
- */
-export declare function graphqlOperationOf(url: string, body: unknown): string | undefined;
-type Clusterable = Pick<Observation, "method" | "url" | "requestBody">;
-/** Stable key identifying the endpoint template an observation belongs to. */
-export declare function endpointKey(o: Clusterable): string;
-export declare function clusterObservations<T extends Clusterable>(observations: T[]): Map<string, T[]>;
-export {};

package/dist/templating.js

@@ -1,66 +0,0 @@
-// Deterministic clustering & path templating. Runs BEFORE any AI: groups raw
-// observations into endpoint templates so the brain infers semantics once per
-// endpoint, not once per request. (This is the logic distill.ts inlined.)
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const LONGHEX_RE = /^[0-9a-f]{16,}$/i;
-/** Replace id-like path segments with `{id}`: /sections/120/seats → /sections/{id}/seats */
-export function templatePath(rawUrl) {
-    let pathname = rawUrl;
-    try {
-        pathname = new URL(rawUrl, "http://sider.local").pathname;
-    }
-    catch {
-        /* keep raw */
-    }
-    return pathname
-        .split("/")
-        .map((seg) => {
-        if (seg === "")
-            return seg;
-        if (/^\d+$/.test(seg))
-            return "{id}";
-        if (UUID_RE.test(seg))
-            return "{id}";
-        if (LONGHEX_RE.test(seg))
-            return "{id}";
-        return seg;
-    })
-        .join("/");
-}
-/**
- * GraphQL keying: one URL serves many operations, so cluster on operation name,
- * not path. Returns undefined for non-GraphQL requests.
- */
-export function graphqlOperationOf(url, body) {
-    if (body && typeof body === "object") {
-        const b = body;
-        if (typeof b["operationName"] === "string" && b["operationName"]) {
-            return b["operationName"];
-        }
-        if (typeof b["query"] === "string") {
-            const m = /\b(query|mutation|subscription)\s+([A-Za-z0-9_]+)/.exec(b["query"]);
-            if (m && m[2])
-                return m[2];
-        }
-    }
-    if (/\/graphql\b/i.test(url))
-        return "anonymous";
-    return undefined;
-}
-/** Stable key identifying the endpoint template an observation belongs to. */
-export function endpointKey(o) {
-    const op = graphqlOperationOf(o.url, o.requestBody);
-    return `${o.method} ${templatePath(o.url)}${op ? ` #${op}` : ""}`;
-}
-export function clusterObservations(observations) {
-    const groups = new Map();
-    for (const o of observations) {
-        const key = endpointKey(o);
-        const g = groups.get(key);
-        if (g)
-            g.push(o);
-        else
-            groups.set(key, [o]);
-    }
-    return groups;
-}

package/src/templating.ts

@@ -1,69 +0,0 @@
-// Deterministic clustering & path templating. Runs BEFORE any AI: groups raw
-// observations into endpoint templates so the brain infers semantics once per
-// endpoint, not once per request. (This is the logic distill.ts inlined.)
-
-import type { Observation } from "@sudobility/sider_types";
-
-const UUID_RE =
-  /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const LONGHEX_RE = /^[0-9a-f]{16,}$/i;
-
-/** Replace id-like path segments with `{id}`: /sections/120/seats → /sections/{id}/seats */
-export function templatePath(rawUrl: string): string {
-  let pathname = rawUrl;
-  try {
-    pathname = new URL(rawUrl, "http://sider.local").pathname;
-  } catch {
-    /* keep raw */
-  }
-  return pathname
-    .split("/")
-    .map((seg) => {
-      if (seg === "") return seg;
-      if (/^\d+$/.test(seg)) return "{id}";
-      if (UUID_RE.test(seg)) return "{id}";
-      if (LONGHEX_RE.test(seg)) return "{id}";
-      return seg;
-    })
-    .join("/");
-}
-
-/**
- * GraphQL keying: one URL serves many operations, so cluster on operation name,
- * not path. Returns undefined for non-GraphQL requests.
- */
-export function graphqlOperationOf(url: string, body: unknown): string | undefined {
-  if (body && typeof body === "object") {
-    const b = body as Record<string, unknown>;
-    if (typeof b["operationName"] === "string" && b["operationName"]) {
-      return b["operationName"];
-    }
-    if (typeof b["query"] === "string") {
-      const m = /\b(query|mutation|subscription)\s+([A-Za-z0-9_]+)/.exec(b["query"]);
-      if (m && m[2]) return m[2];
-    }
-  }
-  if (/\/graphql\b/i.test(url)) return "anonymous";
-  return undefined;
-}
-
-type Clusterable = Pick<Observation, "method" | "url" | "requestBody">;
-
-/** Stable key identifying the endpoint template an observation belongs to. */
-export function endpointKey(o: Clusterable): string {
-  const op = graphqlOperationOf(o.url, o.requestBody);
-  return `${o.method} ${templatePath(o.url)}${op ? ` #${op}` : ""}`;
-}
-
-export function clusterObservations<T extends Clusterable>(
-  observations: T[],
-): Map<string, T[]> {
-  const groups = new Map<string, T[]>();
-  for (const o of observations) {
-    const key = endpointKey(o);
-    const g = groups.get(key);
-    if (g) g.push(o);
-    else groups.set(key, [o]);
-  }
-  return groups;
-}