@wenathlan/saddle 2.0.153 → 2.0.155

package/dist/seedcatalog.d.ts

@@ -1,13 +0,0 @@
-/** Style: Saddle catalog seeds — the reviewed offline answer of the catalog
- * until the database endpoint is paired. The rows describe the prepared media
- * areas the pages render: no image file ships in the repository, the picture
- * content arrives from the database over HTTPS. The agent session seed
- * mirrors the documented example log of docs/logs/examplesession.json
- * verbatim, so the agent browser page renders the repository's own example
- * instead of inventing one. */
-import type { AgentSession, MediaSlot } from "./catalog";
-export declare const seedMediaSlots: MediaSlot[];
-/** the reviewed agent session seed: the documented example session of
- * docs/logs/examplesession.json (id, browser, seed, events and the captcha
- * verdict), mirrored verbatim — the offline answer of the sessions catalog. */
-export declare const seedAgentSessions: AgentSession[];

package/dist/seedcatalog.js

@@ -1,46 +0,0 @@
-export const seedMediaSlots = [
-    {
-        id: "media.home.hero",
-        label: "memory bridge",
-        ratio: "16 / 10",
-        caption: "Abstract bridge of storage tiles and remote compute nodes.",
-    },
-    {
-        id: "media.runtime.map",
-        label: "remote runtime map",
-        ratio: "4 / 3",
-        caption: "Illustrated map of repositories connected to remote runners.",
-    },
-    {
-        id: "media.agentbrowser.trace",
-        label: "browser trace",
-        ratio: "3 / 2",
-        caption: "Cursor trace and evidence from a browser session.",
-    },
-];
-/** the reviewed agent session seed: the documented example session of
- * docs/logs/examplesession.json (id, browser, seed, events and the captcha
- * verdict), mirrored verbatim — the offline answer of the sessions catalog. */
-export const seedAgentSessions = [
-    {
-        version: 1,
-        session: {
-            id: "examplesession-0001",
-            browser: "brave",
-            seed: "examplesession-seed-0001",
-        },
-        events: [
-            { t: 140, type: "move", x: 120, y: 90 },
-            { t: 300, type: "move", x: 180, y: 140 },
-            { t: 480, type: "click", x: 180, y: 140 },
-            { t: 680, type: "type", key: "k" },
-            { t: 900, type: "move", x: 240, y: 200 },
-            { t: 1140, type: "click", x: 240, y: 200 },
-            { t: 1400, type: "scroll", dy: 320 },
-        ],
-        captcha: {
-            kind: "hcaptcha",
-            passed: true,
-        },
-    },
-];

package/dist/server.d.ts

@@ -1,20 +0,0 @@
-/**
- * server.ts — the Node HTTP server surface.
- *
- * This file is the v2.0.0 grand-merge consolidation of the former nested
- * folders of the repository (server) into the single
- * root-level domain file of the saddle family standard: one optimized
- * TypeScript file per correlated domain, ordinal sections, JSDoc on every
- * block, intra-domain imports dissolved, cross-domain imports rewritten to
- * ./<domain>.js. Every capability of every source file is preserved here;
- * the pure re-export barrels (none in this domain) folded their surface into this file directly.
- */
-/**
- * node server is an optional adapter around the universal service contract.
- */
-/** Creates a Node HTTP adapter with explicit host, port, and request handler. */
-export declare function nodeserver(options?: {}): {
-    server: import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>;
-    listen(): Promise<unknown>;
-    close(): Promise<unknown>;
-};

package/dist/server.js

@@ -1,53 +0,0 @@
-/**
- * server.ts — the Node HTTP server surface.
- *
- * This file is the v2.0.0 grand-merge consolidation of the former nested
- * folders of the repository (server) into the single
- * root-level domain file of the saddle family standard: one optimized
- * TypeScript file per correlated domain, ordinal sections, JSDoc on every
- * block, intra-domain imports dissolved, cross-domain imports rewritten to
- * ./<domain>.js. Every capability of every source file is preserved here;
- * the pure re-export barrels (none in this domain) folded their surface into this file directly.
- */
-import { createServer } from "node:http";
-/* ════════════════════════════════════════════════════════════════════ */
-/* Section 1: server/node.ts — node server is an optional adapter around the universal service contract. */
-/* ════════════════════════════════════════════════════════════════════ */
-/**
- * node server is an optional adapter around the universal service contract.
- */
-/** Creates a Node HTTP adapter with explicit host, port, and request handler. */
-export function nodeserver(options = {}) {
-    if (!options.host || !Number.isInteger(options.port) || options.port < 1)
-        throw new TypeError("node server requires host and port");
-    if (typeof options.handle !== "function")
-        throw new TypeError("node server requires handle");
-    /* Request translation stays inside the Node adapter. */
-    const server = createServer(async (request, response) => {
-        try {
-            const chunks = [];
-            for await (const chunk of request)
-                chunks.push(chunk);
-            const body = Buffer.concat(chunks).toString("utf8");
-            const headers = new Headers(request.headers);
-            const webrequest = new Request(new URL(request.url ?? "/", `http://${options.host}:${options.port}`), { method: request.method, headers, body: body || undefined });
-            const result = await options.handle(webrequest);
-            response.statusCode = result.status;
-            result.headers.forEach((value, key) => {
-                response.setHeader(key, value);
-            });
-            response.end(Buffer.from(await result.arrayBuffer()));
-        }
-        catch (error) {
-            response.statusCode = 500;
-            response.setHeader("content-type", "application/json");
-            response.end(JSON.stringify({ error: error.message }));
-        }
-    });
-    /* Lifecycle methods keep the server optional for library consumers. */
-    return {
-        server,
-        listen() { return new Promise((resolve, reject) => { server.once("error", reject); server.listen(options.port, options.host, () => resolve({ host: options.host, port: options.port })); }); },
-        close() { return new Promise((resolve, reject) => server.close((error) => error ? reject(error) : resolve())); }
-    };
-}

package/dist/speccatalog.d.ts

@@ -1,31 +0,0 @@
-/** one normalized catalog row: the payload cell keeps the full source
- * row as json text so no field of the datasets is lost. */
-export type SpecRow = {
-    id: string;
-    name: string;
-    payload: string;
-};
-/**
- * lists the boards dataset.
- *
- * @returns the board rows.
- */
-export declare function listboards(): SpecRow[];
-/**
- * lists the cores dataset.
- *
- * @returns the core rows.
- */
-export declare function listcores(): SpecRow[];
-/**
- * lists the gpus dataset.
- *
- * @returns the gpu rows.
- */
-export declare function listgpus(): SpecRow[];
-/**
- * lists the processors dataset.
- *
- * @returns the processor rows.
- */
-export declare function listprocessors(): SpecRow[];

package/dist/speccatalog.js

@@ -1,163 +0,0 @@
-/**
- * speccatalog.ts — the spec catalog layer of the saddle database (root
- * layer, library-grade: no consumer data hardcoded here).
- *
- * mirrors the repository datasets (boards.json, cores.json, gpus.json,
- * processors.json) into the site DB on first run and serves typed list
- * accessors over prepared statements. every statement is parameterized —
- * sql is never assembled by string concatenation. the database file is
- * the same one db.ts boots (SADDLE_DB environment, never a hardcoded
- * location), so the engine, the self-hosted api and the theme answer
- * from one source of truth. the json files stay the seed source of
- * record; nothing inside the engine modules duplicates them.
- */
-import { createHash } from 'node:crypto';
-import { readFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { DatabaseSync } from 'node:sqlite';
-import { dbpath } from './db.ts';
-/** the directory holding this module: the repository root with the
- * datasets beside the engine sources. */
-const moduledir = dirname(fileURLToPath(import.meta.url));
-/** the datasets the catalog mirrors, with the array key of each file. */
-const datasets = [
-    { dataset: 'boards', file: 'boards.json', key: 'boards' },
-    { dataset: 'cores', file: 'cores.json', key: 'models' },
-    { dataset: 'gpus', file: 'gpus.json', key: 'gpus' },
-    { dataset: 'processors', file: 'processors.json', key: 'processors' },
-];
-/** the catalog schema: static strings only, safe on every boot. */
-const ddl = `
-  create table if not exists specboards (
-    id text primary key,
-    name text not null,
-    payload text not null
-  );
-  create table if not exists speccores (
-    id text primary key,
-    name text not null,
-    payload text not null
-  );
-  create table if not exists specgpus (
-    id text primary key,
-    name text not null,
-    payload text not null
-  );
-  create table if not exists specprocessors (
-    id text primary key,
-    name text not null,
-    payload text not null
-  );
-`;
-/** the statements, all prepared once (bound parameters only). */
-const statements = {};
-/** the catalog connection: the same file the engine db.ts boots. */
-let database = null;
-/** true once the mirror pass has run for this process. */
-let mirrored = false;
-/**
- * derives the stable row id: sha-256 of the exact source row, so the
- * mirror stays idempotent across runs (insert or replace).
- *
- * @param dataset the dataset namespace.
- * @param row the raw source row.
- * @returns the hex digest id.
- */
-function rowid(dataset, row) {
-    return createHash('sha256').update(`${dataset}:${JSON.stringify(row)}`).digest('hex').slice(0, 40);
-}
-/**
- * extracts the display name of a row from the usual field candidates.
- *
- * @param row the raw source row.
- * @returns the best name field found.
- */
-function rowname(row) {
-    const candidates = ['name', 'model', 'model_name', 'board', 'title', 'id'];
-    for (const key of candidates) {
-        const value = row[key];
-        if (typeof value === 'string' && value.trim() !== '')
-            return value;
-    }
-    return '(unnamed)';
-}
-/**
- * opens the catalog connection, creates the schema and mirrors the
- * datasets on first run. errors stay contained: a catalog failure never
- * breaks the engine boot.
- */
-function ensurecatalog() {
-    if (mirrored)
-        return;
-    database = new DatabaseSync(dbpath);
-    database.exec(ddl);
-    for (const spec of datasets) {
-        statements[spec.dataset] = {
-            insert: database.prepare(`insert or replace into spec${spec.dataset} (id, name, payload) values (?, ?, ?)`),
-            select: database.prepare(`select id, name, payload from spec${spec.dataset} order by name`),
-        };
-        try {
-            const document = JSON.parse(readFileSync(join(moduledir, spec.file), 'utf8'));
-            const rows = document[spec.key];
-            if (!Array.isArray(rows))
-                continue;
-            for (const row of rows) {
-                if (row === null || typeof row !== 'object')
-                    continue;
-                const record = row;
-                statements[spec.dataset].insert.run(rowid(spec.dataset, row), rowname(record), JSON.stringify(record));
-            }
-        }
-        catch {
-            /* an unreadable dataset leaves the catalog table as-is; the json
-             * file stays the source of record for the next boot */
-        }
-    }
-    mirrored = true;
-}
-/**
- * lists the rows of one dataset through the prepared statement.
- *
- * @param dataset the dataset to read.
- * @returns the catalog rows.
- */
-function listdataset(dataset) {
-    ensurecatalog();
-    const statement = statements[dataset]?.select;
-    if (!statement)
-        return [];
-    return statement.all();
-}
-/**
- * lists the boards dataset.
- *
- * @returns the board rows.
- */
-export function listboards() {
-    return listdataset('boards');
-}
-/**
- * lists the cores dataset.
- *
- * @returns the core rows.
- */
-export function listcores() {
-    return listdataset('cores');
-}
-/**
- * lists the gpus dataset.
- *
- * @returns the gpu rows.
- */
-export function listgpus() {
-    return listdataset('gpus');
-}
-/**
- * lists the processors dataset.
- *
- * @returns the processor rows.
- */
-export function listprocessors() {
-    return listdataset('processors');
-}