@ixo/openhands-sdk 0.0.0-stage → 0.2.0

package/dist/esm/geo/tiles.js

@@ -0,0 +1,136 @@
+import { haversineMetres } from "./box.js";
+/**
+ * Turning a place into a picture of that place.
+ *
+ * Web Mercator, the slippy-map convention every tile server shares: the world
+ * at zoom `z` is a grid of `2^z` square tiles, each 256 px, and a coordinate
+ * lands at a fractional position in that grid.
+ *
+ * **The trap, which cost us a wrong answer during planning.** A tile address
+ * is three integers, and almost any three integers name *some* tile of the
+ * earth — so a mistake does not return 404, it returns a confident picture of
+ * somewhere else. A guessed `14/8811/5713` fetched perfectly; the correct tile
+ * for the same coordinates is `14/8852/5825`, roughly four hundred kilometres
+ * away. That is the same shape as the reversed-bbox trap in `osm.ts`: no
+ * status code will ever catch it, so the arithmetic is pinned by a fixture
+ * test and the surfaces are checked by eye.
+ */
+/** OSM's own scale constant: metres per pixel at zoom 0 on the equator. */
+const EQUATOR_METRES_PER_PIXEL = 156_543.033_92;
+export const TILE_PIXELS = 256;
+/** How far one pixel reaches on the ground — the number every overlay needs. */
+export const metresPerPixel = (lat, zoom) => (EQUATOR_METRES_PER_PIXEL * Math.cos((lat * Math.PI) / 180)) / 2 ** zoom;
+/** Where a coordinate falls in the tile grid, as fractions of a tile. */
+export function tileFor(point, zoom) {
+    const n = 2 ** zoom;
+    const x = ((point.lon + 180) / 360) * n;
+    const latitude = (point.lat * Math.PI) / 180;
+    const y = ((1 - Math.asinh(Math.tan(latitude)) / Math.PI) / 2) * n;
+    return { x, y };
+}
+/**
+ * How close to look.
+ *
+ * Chosen so the thing being described fills a useful part of the frame: a
+ * doorway-sized radius wants a street, a city-sized box wants a city. The same
+ * ladder decides how specific a place name to ask for, so the words and the
+ * picture always agree about scale.
+ */
+export function zoomForMetres(across) {
+    if (across <= 250)
+        return 17;
+    if (across <= 1_000)
+        return 16;
+    if (across <= 5_000)
+        return 14;
+    return 12;
+}
+/** A radius' centre, or a box's — one point to build a frame around. */
+export const centreOf = (geometry) => geometry.kind === "radius" ? { lat: geometry.lat, lon: geometry.lon } : { lat: (geometry.box.south + geometry.box.north) / 2, lon: (geometry.box.west + geometry.box.east) / 2 };
+/** How wide the thing is, in metres — the input to `zoomForMetres`. */
+export const spanOf = (geometry) => geometry.kind === "radius"
+    ? geometry.meters * 2
+    : haversineMetres({ lat: geometry.box.south, lon: geometry.box.west }, { lat: geometry.box.north, lon: geometry.box.east });
+/**
+ * The picture, worked out completely before anything is fetched.
+ *
+ * A **window centred on the target**, not a block of tiles the target happens
+ * to fall inside. The difference is the whole quality of the thing: anchoring
+ * a 2×2 block on a floored tile leaves the point anywhere in the middle half
+ * of the frame, and a map whose subject sits up and to the left reads as a
+ * mistake even when every coordinate in it is right. So the window is placed
+ * first, and the tiles that intersect it are worked out afterwards — the
+ * arithmetic every slippy map does, minus the scrolling.
+ *
+ * That costs between four and nine tiles depending on where the point falls
+ * inside its own tile, usually six. Still one small lazy grid per page,
+ * cached for a week at the edge, and still no JavaScript to assemble.
+ *
+ * The zoom steps down while the geometry does not comfortably fit, so a large
+ * area is never clipped by the frame that is supposed to explain it.
+ */
+export function frameFor(geometry, maxZoom = 17) {
+    const centre = centreOf(geometry);
+    const span = spanOf(geometry);
+    const width = TILE_PIXELS * 2;
+    let zoom = Math.min(zoomForMetres(span), maxZoom);
+    /* Leave a margin: the shape should sit inside the frame, not touch its
+       edges, or the picture reads as cropped rather than as centred. */
+    while (zoom > 1 && span / metresPerPixel(centre.lat, zoom) > width * 0.8)
+        zoom -= 1;
+    const n = 2 ** zoom;
+    const fractional = tileFor(centre, zoom);
+    /* World pixel coordinates of the centre, and the window that brackets it. */
+    const centrePixel = { x: fractional.x * TILE_PIXELS, y: fractional.y * TILE_PIXELS };
+    const window = { left: centrePixel.x - width / 2, top: centrePixel.y - width / 2 };
+    const tiles = [];
+    const firstX = Math.floor(window.left / TILE_PIXELS);
+    const firstY = Math.floor(window.top / TILE_PIXELS);
+    const lastX = Math.floor((window.left + width - 1) / TILE_PIXELS);
+    const lastY = Math.floor((window.top + width - 1) / TILE_PIXELS);
+    for (let y = firstY; y <= lastY; y += 1) {
+        /* Latitude does not wrap: a window at the top of the world simply has
+           fewer tiles in it, and the frame's own background fills the rest. */
+        if (y < 0 || y >= n)
+            continue;
+        for (let x = firstX; x <= lastX; x += 1) {
+            tiles.push({
+                /* Longitude does wrap, so a window across the antimeridian still
+                   finds real tiles on the far side. */
+                x: ((x % n) + n) % n,
+                y,
+                left: x * TILE_PIXELS - window.left,
+                top: y * TILE_PIXELS - window.top
+            });
+        }
+    }
+    /* Centred by construction — the window was placed around it. */
+    const marker = { x: width / 2, y: width / 2 };
+    const scale = metresPerPixel(centre.lat, zoom);
+    let overlay = null;
+    if (geometry.kind === "radius") {
+        overlay = { kind: "circle", radius: geometry.meters / scale };
+    }
+    else {
+        const topLeft = tileFor({ lat: geometry.box.north, lon: geometry.box.west }, zoom);
+        const bottomRight = tileFor({ lat: geometry.box.south, lon: geometry.box.east }, zoom);
+        overlay = {
+            kind: "rect",
+            x: topLeft.x * TILE_PIXELS - window.left,
+            y: topLeft.y * TILE_PIXELS - window.top,
+            width: (bottomRight.x - topLeft.x) * TILE_PIXELS,
+            height: (bottomRight.y - topLeft.y) * TILE_PIXELS
+        };
+    }
+    return { zoom, tiles, width, height: width, marker, overlay };
+}
+/** The geometry a gate describes, if it describes one. Shape-only, no imports. */
+export function geometryOfGate(gate) {
+    if (gate?.id === "within-radius" && typeof gate.lat === "number" && typeof gate.lon === "number" && typeof gate.meters === "number") {
+        return { kind: "radius", lat: gate.lat, lon: gate.lon, meters: gate.meters };
+    }
+    if (gate?.id === "mapped-grid" && gate.box)
+        return { kind: "box", box: gate.box };
+    return null;
+}
+//# sourceMappingURL=tiles.js.map

package/dist/esm/geo/tiles.js.map

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

package/dist/esm/geo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@ixo/openhands-sdk/geo` — places, boxes, tiles, EXIF, sun position and OSM/Nominatim search.
+ *
+ * Isomorphic by contract: nothing reachable from here imports a `node:`
+ * builtin or a server-only package (`barrels.test.ts` walks the graph and
+ * fails if one appears), so a browser bundle can import this barrel. A module
+ * that needs Node stays reachable only by its own subpath.
+ */
+export * from "./geo/box.ts";
+export * from "./geo/exif.ts";
+export * from "./geo/exifcarry.ts";
+export * from "./geo/exifnote.ts";
+export * from "./geo/mentions.ts";
+export * from "./geo/osm.ts";
+export * from "./geo/place.ts";
+export * from "./geo/search.ts";
+export * from "./geo/sun.ts";
+export * from "./geo/tiles.ts";
+export type { Reach } from "./geo/osm.ts";
+//# sourceMappingURL=geo.d.ts.map

package/dist/esm/geo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.d.ts","sourceRoot":"","sources":["../../src/geo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAI/B,YAAY,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/geo.js

@@ -0,0 +1,19 @@
+/**
+ * `@ixo/openhands-sdk/geo` — places, boxes, tiles, EXIF, sun position and OSM/Nominatim search.
+ *
+ * Isomorphic by contract: nothing reachable from here imports a `node:`
+ * builtin or a server-only package (`barrels.test.ts` walks the graph and
+ * fails if one appears), so a browser bundle can import this barrel. A module
+ * that needs Node stays reachable only by its own subpath.
+ */
+export * from "./geo/box.js";
+export * from "./geo/exif.js";
+export * from "./geo/exifcarry.js";
+export * from "./geo/exifnote.js";
+export * from "./geo/mentions.js";
+export * from "./geo/osm.js";
+export * from "./geo/place.js";
+export * from "./geo/search.js";
+export * from "./geo/sun.js";
+export * from "./geo/tiles.js";
+//# sourceMappingURL=geo.js.map

package/dist/esm/geo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geo.js","sourceRoot":"","sources":["../../src/geo.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/esm/given.d.ts

@@ -0,0 +1,15 @@
+/**
+ * What the host passed to `configure()`, and nothing else — kept apart from
+ * `config.ts` so a module that needs ONE value (a browser page building an
+ * image path) can honour `configure()` without importing the whole resolver,
+ * its per-network tables and every environment name, which would ride into
+ * every page's shared chunk.
+ */
+import type { OpenhandsConfig } from "./config.ts";
+export declare const givenConfig: () => Partial<OpenhandsConfig>;
+export declare const setGivenConfig: (next: Partial<OpenhandsConfig>) => void;
+/** The current generation of the configuration; `config()` recomputes when it moves. */
+export declare const givenVersion: () => number;
+/** Tell `config()` to recompute on its next call — after the host changed `process.env` under it. */
+export declare const invalidateGiven: () => void;
+//# sourceMappingURL=given.d.ts.map

package/dist/esm/given.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"given.d.ts","sourceRoot":"","sources":["../../src/given.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AASnD,eAAO,MAAM,WAAW,QAAO,OAAO,CAAC,eAAe,CAAU,CAAC;AACjE,eAAO,MAAM,cAAc,GAAI,MAAM,OAAO,CAAC,eAAe,CAAC,KAAG,IAG/D,CAAC;AACF,wFAAwF;AACxF,eAAO,MAAM,YAAY,QAAO,MAAiB,CAAC;AAClD,qGAAqG;AACrG,eAAO,MAAM,eAAe,QAAO,IAElC,CAAC"}

package/dist/esm/given.js

@@ -0,0 +1,18 @@
+let given = {};
+/* Bumped whenever what the accessors may see changes; `config()` keys its
+   memo on it, so a host that refreshes `process.env` (the Worker's `bindEnv`,
+   once per event) can drop that memo through this module alone, without
+   loading the resolver and every accessor behind it. */
+let version = 0;
+export const givenConfig = () => given;
+export const setGivenConfig = (next) => {
+    given = next;
+    version += 1;
+};
+/** The current generation of the configuration; `config()` recomputes when it moves. */
+export const givenVersion = () => version;
+/** Tell `config()` to recompute on its next call — after the host changed `process.env` under it. */
+export const invalidateGiven = () => {
+    version += 1;
+};
+//# sourceMappingURL=given.js.map

package/dist/esm/given.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"given.js","sourceRoot":"","sources":["../../src/given.ts"],"names":[],"mappings":"AASA,IAAI,KAAK,GAA6B,EAAE,CAAC;AACzC;;;wDAGwD;AACxD,IAAI,OAAO,GAAG,CAAC,CAAC;AAEhB,MAAM,CAAC,MAAM,WAAW,GAAG,GAA6B,EAAE,CAAC,KAAK,CAAC;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAA8B,EAAQ,EAAE;IACrE,KAAK,GAAG,IAAI,CAAC;IACb,OAAO,IAAI,CAAC,CAAC;AACf,CAAC,CAAC;AACF,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,OAAO,CAAC;AAClD,qGAAqG;AACrG,MAAM,CAAC,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,OAAO,IAAI,CAAC,CAAC;AACf,CAAC,CAAC"}

package/dist/esm/network.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Which chain — the one setting most other settings depend on, so it lives
+ * on its own: an accessor that needs a per-network default imports this and
+ * `given.ts`, and nothing else of the configuration.
+ *
+ * One of three, or a refusal (scale review D23: `Mainnet` with a capital once
+ * ran a "mainnet" deployment against testnet). Unset or empty is testnet, the
+ * documented default. Deliberately exact. Validated when read, never at import.
+ */
+export declare const NETWORKS: readonly ["devnet", "testnet", "mainnet"];
+export type Network = (typeof NETWORKS)[number];
+export declare function chainNetwork(raw: string | undefined, source?: string): Network;
+/** `configure({ network })`, else `NEXT_PUBLIC_CHAIN_NETWORK`, else testnet. Throws on anything else. */
+export declare function network(): Network;
+export declare const hasEnv: () => boolean;
+export declare const firstSet: (...values: (string | undefined)[]) => string | undefined;
+/**
+ * A count of base units, read strictly: a mis-set variable used to become NaN
+ * and price legs at "NaN". Anything that is not a whole, non-negative safe
+ * integer falls back.
+ */
+export declare function strictBase(raw: string | undefined, fallback: number): number;
+//# sourceMappingURL=network.d.ts.map

package/dist/esm/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,eAAO,MAAM,QAAQ,2CAA4C,CAAC;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,SAA8B,GAAG,OAAO,CAInG;AAED,yGAAyG;AACzG,wBAAgB,OAAO,IAAI,OAAO,CAIjC;AAUD,eAAO,MAAM,MAAM,QAAO,OAAiE,CAAC;AAG5F,eAAO,MAAM,QAAQ,GAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,KAAG,MAAM,GAAG,SAAwE,CAAC;AAE/I;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAI5E"}

package/dist/esm/network.js

@@ -0,0 +1,48 @@
+/**
+ * Which chain — the one setting most other settings depend on, so it lives
+ * on its own: an accessor that needs a per-network default imports this and
+ * `given.ts`, and nothing else of the configuration.
+ *
+ * One of three, or a refusal (scale review D23: `Mainnet` with a capital once
+ * ran a "mainnet" deployment against testnet). Unset or empty is testnet, the
+ * documented default. Deliberately exact. Validated when read, never at import.
+ */
+import { givenConfig } from "./given.js";
+export const NETWORKS = ["devnet", "testnet", "mainnet"];
+export function chainNetwork(raw, source = "NEXT_PUBLIC_CHAIN_NETWORK") {
+    if (raw === undefined || raw === "")
+        return "testnet";
+    if (NETWORKS.includes(raw))
+        return raw;
+    throw new Error(`${source} is ${JSON.stringify(raw)}; it must be one of ${NETWORKS.join(", ")} (or unset for testnet)`);
+}
+/** `configure({ network })`, else `NEXT_PUBLIC_CHAIN_NETWORK`, else testnet. Throws on anything else. */
+export function network() {
+    const given = givenConfig().network;
+    if (given !== undefined)
+        return chainNetwork(given, "configure({ network })");
+    return chainNetwork(hasEnv() ? process.env.NEXT_PUBLIC_CHAIN_NETWORK : undefined);
+}
+/*
+ * The env helpers every lazy accessor shares live here too, beside
+ * `network()`, rather than in a module of their own: each separate shared
+ * module tends to become its own async chunk, and every async chunk is an
+ * entry in the webpack runtime's chunk map that EVERY page pays for. Only
+ * lazily-loaded accessors import this module; first-load code (`docPath`,
+ * `engineUrl`, `askDenom`) needs only `given.ts`.
+ */
+export const hasEnv = () => typeof process !== "undefined" && Boolean(process.env);
+/* `||`, not `??`: an empty variable has always meant "unset" in this repo. */
+export const firstSet = (...values) => values.find((value) => value !== undefined && value !== "");
+/**
+ * A count of base units, read strictly: a mis-set variable used to become NaN
+ * and price legs at "NaN". Anything that is not a whole, non-negative safe
+ * integer falls back.
+ */
+export function strictBase(raw, fallback) {
+    if (raw === undefined || raw.trim() === "")
+        return fallback;
+    const parsed = Number(raw);
+    return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : fallback;
+}
+//# sourceMappingURL=network.js.map

package/dist/esm/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/network.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAGlE,MAAM,UAAU,YAAY,CAAC,GAAuB,EAAE,MAAM,GAAG,2BAA2B;IACxF,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtD,IAAK,QAA8B,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAc,CAAC;IACzE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAuB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AAC1H,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,OAAO;IACrB,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC,OAAO,CAAC;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IAC9E,OAAO,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,GAAY,EAAE,CAAC,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAE5F,8EAA8E;AAC9E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,MAA8B,EAAsB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;AAE/I;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,GAAuB,EAAE,QAAgB;IAClE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;AACzE,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/protocol.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `@ixo/openhands-sdk/protocol` — the shapes and rules every Openhands front end shares: envelopes, verdicts, proofs, the UDID wrapper, ask terms and the evaluation leg.
+ *
+ * Isomorphic by contract: nothing reachable from here imports a `node:`
+ * builtin or a server-only package (`barrels.test.ts` walks the graph and
+ * fails if one appears), so a browser bundle can import this barrel. A module
+ * that needs Node stays reachable only by its own subpath.
+ */
+export * from "./data/envelope.ts";
+export * from "./data/verdict.ts";
+export * from "./data/proof.ts";
+export * from "./data/types.ts";
+export * from "./data/resources.ts";
+export * from "./data/issueMessage.ts";
+export * from "./data/openness.ts";
+export * from "./data/network.ts";
+export * from "./data/accept.ts";
+export * from "./data/engine.ts";
+export * from "./udid/schema.ts";
+export * from "./udid/canonical.ts";
+export * from "./udid/wrapper.ts";
+export * from "./udid/verify.ts";
+export * from "./udid/resolve.ts";
+export * from "./udid/base58.ts";
+export * from "./rubric/terms.ts";
+export * from "./rubric/bridge.ts";
+export * from "./rubric/claimForm.ts";
+export * from "./rubric/claimFormResource.ts";
+export * from "./rubric/gateMet.ts";
+export * from "./rubric/wants.ts";
+export * from "./rubric/leg.ts";
+export * from "./rubric/card.ts";
+export * from "./rubric/confidence.ts";
+export * from "./chain/money.ts";
+export * from "./chain/iid.ts";
+export * from "./chain/accountProof.ts";
+export * from "./chain/grantPending.ts";
+export type { EngineGate } from "./data/engine.ts";
+export type { EngineGate as EngineRubricGate } from "./rubric/bridge.ts";
+//# sourceMappingURL=protocol.d.ts.map

package/dist/esm/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AAIxC,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,UAAU,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/esm/protocol.js

@@ -0,0 +1,38 @@
+/**
+ * `@ixo/openhands-sdk/protocol` — the shapes and rules every Openhands front end shares: envelopes, verdicts, proofs, the UDID wrapper, ask terms and the evaluation leg.
+ *
+ * Isomorphic by contract: nothing reachable from here imports a `node:`
+ * builtin or a server-only package (`barrels.test.ts` walks the graph and
+ * fails if one appears), so a browser bundle can import this barrel. A module
+ * that needs Node stays reachable only by its own subpath.
+ */
+export * from "./data/envelope.js";
+export * from "./data/verdict.js";
+export * from "./data/proof.js";
+export * from "./data/types.js";
+export * from "./data/resources.js";
+export * from "./data/issueMessage.js";
+export * from "./data/openness.js";
+export * from "./data/network.js";
+export * from "./data/accept.js";
+export * from "./data/engine.js";
+export * from "./udid/schema.js";
+export * from "./udid/canonical.js";
+export * from "./udid/wrapper.js";
+export * from "./udid/verify.js";
+export * from "./udid/resolve.js";
+export * from "./udid/base58.js";
+export * from "./rubric/terms.js";
+export * from "./rubric/bridge.js";
+export * from "./rubric/claimForm.js";
+export * from "./rubric/claimFormResource.js";
+export * from "./rubric/gateMet.js";
+export * from "./rubric/wants.js";
+export * from "./rubric/leg.js";
+export * from "./rubric/card.js";
+export * from "./rubric/confidence.js";
+export * from "./chain/money.js";
+export * from "./chain/iid.js";
+export * from "./chain/accountProof.js";
+export * from "./chain/grantPending.js";
+//# sourceMappingURL=protocol.js.map

package/dist/esm/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC"}