@plurnk/plurnk-service 1.3.12 → 1.4.0

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@plurnk/plurnk-service",
-    "version": "1.3.12",
-    "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-grammar contract.",
+    "version": "1.4.0",
+    "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-contracts contract.",
     "type": "module",
     "license": "MIT",
     "engines": {
@@ -38,18 +38,21 @@
         "start": "node --conditions=plurnk-dev src/service.ts",
         "types:sqlrite": "node scripts/sqlrite-types.mjs --write",
         "test:sqlrite-types": "node scripts/sqlrite-types.mjs",
+        "test:artifacts:begin": "node ../scripts/test-artifacts.mjs begin",
+        "pretest:intg": "npm run test:artifacts:begin",
         "test:lint": "npm run test:sqlrite-types && tsc --noEmit && tsc --noEmit -p tsconfig.test.json",
         "test:unit": "node --conditions=plurnk-dev --import=./test/setup.ts --env-file-if-exists=.env.defaults --test --test-timeout=30000 src/**/*.test.ts",
         "test:intg": "PLURNK_SERVICE_FILES_ITEMS=0 node --conditions=plurnk-dev --import=./test/setup.ts --env-file-if-exists=.env.defaults --test --test-concurrency=8 --test-timeout=30000 test/intg/*.test.ts",
-        "test:live": "PLURNK_SERVICE_EMBED_DISABLE=0 PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/live/*.test.ts",
-        "test:live:zeropin": "PLURNK_ZERO_PIN=1 PLURNK_SERVICE_EMBED_DISABLE=0 PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/live/*.test.ts",
-        "test:demo": "PLURNK_SERVICE_EMBED_DISABLE=0 PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/demo/*.test.ts",
-        "test:demo:zeropin": "PLURNK_ZERO_PIN=1 PLURNK_SERVICE_EMBED_DISABLE=0 PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/demo/*.test.ts",
+        "test:live": "PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/live/*.test.ts",
+        "test:live:specimen": "node --conditions=plurnk-dev bin/live-specimen.ts",
+        "test:live:zeropin": "PLURNK_ZERO_PIN=1 PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/live/*.test.ts",
+        "test:demo": "PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/demo/*.test.ts",
+        "test:demo:zeropin": "PLURNK_ZERO_PIN=1 PLURNK_SERVICE_POLICY=../plurnk-meta/PLURNK_PERSONALITY.md node --conditions=plurnk-dev --import=./test/floor.ts --env-file-if-exists=.env.defaults --env-file-if-exists=$HOME/.plurnk/.env --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/demo/*.test.ts",
         "fixture:demo": "node --conditions=plurnk-dev test/demo/_fixture.ts",
         "test:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
         "test:digest": "node --conditions=plurnk-dev bin/digest.ts",
         "digest:missing": "node --conditions=plurnk-dev bin/digest-missing.ts",
-        "test:clean-tmp": "rm -rf test/intg/.tmp",
+        "test:clean-tmp": "node ../scripts/test-artifacts.mjs clean",
         "dev:digest": "node --conditions=plurnk-dev bin/digest.ts",
         "build:clean": "rm -rf dist",
         "build:dist": "tsc -p tsconfig.build.json",
@@ -66,32 +69,60 @@
         "prepack": "npm run build"
     },
     "dependencies": {
-        "@plurnk/gbnf": "1.3.12",
-        "@plurnk/plurnk-agui": "1.3.12",
-        "@plurnk/plurnk-execs": "1.3.12",
-        "@plurnk/plurnk-execs-common": "1.3.12",
-        "@plurnk/plurnk-execs-mcp": "1.3.12",
-        "@plurnk/plurnk-execs-search": "1.3.12",
-        "@plurnk/plurnk-grammar": "1.3.12",
-        "@plurnk/plurnk-meta": "1.3.12",
-        "@plurnk/plurnk-mimetypes": "1.3.12",
-        "@plurnk/plurnk-mimetypes-embeddings": "1.3.12",
-        "@plurnk/plurnk-mimetypes-text-html": "1.3.12",
-        "@plurnk/plurnk-models": "1.3.12",
-        "@plurnk/plurnk-providers": "1.3.12",
-        "@plurnk/plurnk-schemes": "1.3.12",
-        "@plurnk/plurnk-schemes-http": "1.3.12",
+        "@opentelemetry/api": "^1.9.1",
+        "@opentelemetry/context-async-hooks": "^2.10.0",
+        "@opentelemetry/exporter-metrics-otlp-http": "^0.221.0",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.221.0",
+        "@opentelemetry/resources": "^2.10.0",
+        "@opentelemetry/sdk-metrics": "^2.10.0",
+        "@opentelemetry/sdk-trace-base": "^2.10.0",
+        "@plurnk/gbnf": "1.4.0",
+        "@plurnk/plurnk-agui": "1.4.0",
+        "@plurnk/plurnk-contracts": "1.4.0",
+        "@plurnk/plurnk-execs": "1.4.0",
+        "@plurnk/plurnk-execs-common": "1.4.0",
+        "@plurnk/plurnk-execs-git": "1.4.0",
+        "@plurnk/plurnk-execs-jq": "1.4.0",
+        "@plurnk/plurnk-execs-search": "1.4.0",
+        "@plurnk/plurnk-execs-sqlite": "1.4.0",
+        "@plurnk/plurnk-execs-wasm": "1.4.0",
+        "@plurnk/plurnk-mcp": "1.4.0",
+        "@plurnk/plurnk-meta": "1.4.0",
+        "@plurnk/plurnk-mimetypes": "1.4.0",
+        "@plurnk/plurnk-mimetypes-application-ipynb": "1.4.0",
+        "@plurnk/plurnk-mimetypes-application-json": "1.4.0",
+        "@plurnk/plurnk-mimetypes-application-jsonl": "1.4.0",
+        "@plurnk/plurnk-mimetypes-application-pdf": "1.4.0",
+        "@plurnk/plurnk-mimetypes-application-xml": "1.4.0",
+        "@plurnk/plurnk-mimetypes-embeddings": "1.4.0",
+        "@plurnk/plurnk-mimetypes-text-csv": "1.4.0",
+        "@plurnk/plurnk-mimetypes-text-diff": "1.4.0",
+        "@plurnk/plurnk-mimetypes-text-dotenv": "1.4.0",
+        "@plurnk/plurnk-mimetypes-text-html": "1.4.0",
+        "@plurnk/plurnk-mimetypes-text-ini": "1.4.0",
+        "@plurnk/plurnk-mimetypes-text-markdown": "1.4.0",
+        "@plurnk/plurnk-mimetypes-text-plain": "1.4.0",
+        "@plurnk/plurnk-mimetypes-tokenizers": "1.4.0",
+        "@plurnk/plurnk-models": "1.4.0",
+        "@plurnk/plurnk-providers": "1.4.0",
+        "@plurnk/plurnk-schemes": "1.4.0",
+        "@plurnk/plurnk-schemes-http": "1.4.0",
         "@possumtech/sqlrite": "^6.5.2",
         "diff": "^9.0.0",
         "ignore": "7.0.6",
         "isomorphic-git": "1.40.0"
     },
     "devDependencies": {
+        "@opentelemetry/core": "^2.10.0",
         "@types/diff": "^7.0.2"
     },
-    "peerDependenciesMeta": {
-        "@plurnk/plurnk-mimetypes-embeddings": {
-            "optional": true
-        }
+    "homepage": "https://github.com/plurnk/plurnk-service/tree/main/plurnk-core#readme",
+    "bugs": {
+        "url": "https://repo.possumtech.com/plurnk/plurnk-service/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/plurnk/plurnk-service.git",
+        "directory": "plurnk-core"
     }
 }

package/dist/core/PluginLoader.d.ts

@@ -1,20 +0,0 @@
-export type PluginKind = "provider" | "scheme" | "mimetype";
-export interface PluginManifest {
-    kind: PluginKind;
-    name: string;
-    builtAgainst?: string;
-    compatibleWith?: string;
-}
-export interface DiscoveredPlugin {
-    packageName: string;
-    packagePath: string;
-    manifest: PluginManifest;
-}
-export default class PluginLoader {
-    #private;
-    static discoverPlugins(nodeModulesDir: string): Promise<DiscoveredPlugin[]>;
-    static headVersion(): Promise<string>;
-    static loadPlugin(plugin: DiscoveredPlugin): Promise<unknown>;
-    static assertIdentityMatch(plugin: DiscoveredPlugin, instance: unknown): void;
-}
-//# sourceMappingURL=PluginLoader.d.ts.map

package/dist/core/PluginLoader.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PluginLoader.d.ts","sourceRoot":"","sources":["../../src/core/PluginLoader.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;CAC5B;AAED,MAAM,CAAC,OAAO,OAAO,YAAY;;IAK7B,OAAa,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsChF;IAUD,OAAa,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAM1C;IAaD,OAAa,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBlE;IAED,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAiC5E;CACJ"}

package/dist/core/PluginLoader.js

@@ -1,142 +0,0 @@
-// Plugin discovery + loading for the daemon. SPEC §plugin-discovery.
-//
-// Boot-time scope-agnostic scan of node_modules — every scoped and unscoped
-// package with a `plurnk` manifest field is a candidate, gated by the shared
-// ecosystem trust rule (PLURNK_PLUGINS_TRUSTED_ONLY); dynamic-import them,
-// register with the matching registry by kind. Alphabetical load order;
-// collisions on (kind, name) fail-hard at registration time.
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
-import { readFile } from "node:fs/promises";
-import { resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-import Meta from "@plurnk/plurnk-meta";
-export default class PluginLoader {
-    static #isValidKind(kind) {
-        return kind === "provider" || kind === "scheme" || kind === "mimetype";
-    }
-    static async discoverPlugins(nodeModulesDir) {
-        const candidates = await Meta.packageDirs(nodeModulesDir);
-        const discovered = [];
-        for (const { dir: packagePath, name } of candidates) {
-            if (!Meta.isTrusted(name))
-                continue;
-            let pkg;
-            try {
-                const content = await readFile(resolve(packagePath, "package.json"), "utf8");
-                pkg = JSON.parse(content);
-            }
-            catch {
-                continue;
-            }
-            if (typeof pkg.name !== "string")
-                continue;
-            if (pkg.plurnk === undefined || pkg.plurnk === null || typeof pkg.plurnk !== "object")
-                continue;
-            const candidate = pkg.plurnk;
-            if (!PluginLoader.#isValidKind(candidate.kind))
-                continue;
-            if (typeof candidate.name !== "string" || candidate.name.length === 0)
-                continue;
-            const builtAgainst = candidate.builtAgainst;
-            const headName = {
-                provider: "@plurnk/plurnk-providers",
-                scheme: "@plurnk/plurnk-schemes",
-                mimetype: "@plurnk/plurnk-mimetypes",
-            }[candidate.kind];
-            const compatibleWith = pkg.peerDependencies?.[headName] ?? pkg.dependencies?.[headName];
-            discovered.push({
-                packageName: pkg.name,
-                packagePath,
-                manifest: {
-                    kind: candidate.kind,
-                    name: candidate.name,
-                    ...(typeof builtAgainst === "string" && builtAgainst.length > 0 ? { builtAgainst } : {}),
-                    ...(compatibleWith !== undefined ? { compatibleWith } : {}),
-                },
-            });
-        }
-        return discovered.toSorted((a, b) => a.packageName.localeCompare(b.packageName));
-    }
-    // Dynamic-import a discovered plugin's default export and instantiate it.
-    // Default export MUST be a constructable class with a zero-arg constructor.
-    // Identity-match enforcement per plurnk-mimetypes / plurnk-schemes manifests:
-    // the instance's claimed identity MUST match the package manifest's `plurnk.name`.
-    // Providers skip this check — manifest.name is a vendor identifier; the
-    // instance's `model` is per-config (plurnk-providers#1, identity getters).
-    // #514 — the family-head version this daemon IS (lockstep fleet). Resolved once.
-    static #headVersion;
-    static async headVersion() {
-        if (PluginLoader.#headVersion === undefined) {
-            const pkg = JSON.parse(await readFile(fileURLToPath(import.meta.resolve("@plurnk/plurnk-service/package.json")), "utf8"));
-            PluginLoader.#headVersion = pkg.version;
-        }
-        return PluginLoader.#headVersion;
-    }
-    static #legacyWarned = new Set();
-    static #supports(range, version) {
-        const r = /^\^(\d+)\.(\d+)\.(\d+)$/.exec(range);
-        const v = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
-        if (r === null || v === null || r[1] !== v[1])
-            return false;
-        const [, rMajor, rMinor, rPatch] = r.map(Number);
-        const [, vMajor, vMinor, vPatch] = v.map(Number);
-        if (rMajor > 0)
-            return vMinor > rMinor || (vMinor === rMinor && vPatch >= rPatch);
-        if (rMinor > 0)
-            return vMinor === rMinor && vPatch >= rPatch;
-        return vMajor === 0 && vMinor === 0 && vPatch === rPatch;
-    }
-    static async loadPlugin(plugin) {
-        const head = await PluginLoader.headVersion();
-        if (plugin.manifest.compatibleWith !== undefined && !PluginLoader.#supports(plugin.manifest.compatibleWith, head)) {
-            throw new Error(`${plugin.packageName} supports ${plugin.manifest.compatibleWith}; loaded ${head}.`);
-        }
-        if ((plugin.manifest.compatibleWith === undefined || plugin.manifest.builtAgainst === undefined)
-            && !PluginLoader.#legacyWarned.has(plugin.packageName)) {
-            PluginLoader.#legacyWarned.add(plugin.packageName);
-            process.stderr.write(`plurnk-service: ${plugin.packageName} has no compatibility/provenance metadata — loading unverified against ${head}\n`);
-        }
-        const mod = await import(__rewriteRelativeImportExtension(plugin.packageName));
-        const PluginClass = mod.default;
-        if (typeof PluginClass !== "function") {
-            throw new Error(`${plugin.packageName}: default export is not a constructor`);
-        }
-        const instance = new PluginClass();
-        PluginLoader.assertIdentityMatch(plugin, instance);
-        return instance;
-    }
-    static assertIdentityMatch(plugin, instance) {
-        if (plugin.manifest.kind === "mimetype") {
-            const declared = instance.mimetype;
-            if (typeof declared !== "string") {
-                throw new Error(`${plugin.packageName}: mimetype handler instance must declare a string \`mimetype\` field`);
-            }
-            if (declared !== plugin.manifest.name) {
-                throw new Error(`${plugin.packageName}: identity mismatch — package manifest declares mimetype '${plugin.manifest.name}', instance declares '${declared}'`);
-            }
-            return;
-        }
-        if (plugin.manifest.kind === "scheme") {
-            // Schemes carry a static `manifest` on the class (plurnk-schemes contract).
-            // Transitional: bundled schemes don't yet have it (task #32 wires
-            // manifest registration). When the static manifest is absent, accept
-            // the package manifest name as the source of truth and trust the caller.
-            const classManifest = instance.constructor;
-            const declared = classManifest?.manifest?.name;
-            if (declared !== undefined && declared !== plugin.manifest.name) {
-                throw new Error(`${plugin.packageName}: identity mismatch — package manifest declares scheme '${plugin.manifest.name}', class manifest declares '${String(declared)}'`);
-            }
-            return;
-        }
-        // Providers: no identity-match at this layer. Package manifest `name` is
-        // the vendor family; instance `model` is per-config (plurnk-providers#1).
-    }
-}
-//# sourceMappingURL=PluginLoader.js.map

package/dist/core/PluginLoader.js.map

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

package/dist/core/TelemetryChannel.d.ts

@@ -1,37 +0,0 @@
-import type { TelemetryEvent } from "@plurnk/plurnk-grammar";
-import type { Db } from "./Db.ts";
-import type { TelemetryEventNotify } from "./ChannelWrite.ts";
-declare const ENGINE_ERRORS: Readonly<{
-    readonly budget_overflow: {
-        readonly status: 413;
-        readonly term: "Budget Overflow: newest log items automatically FOLDed — a retrieval larger than Tokens Free arrives folded; FOLD older items first, then fetch within the room made";
-    };
-    readonly max_commands_exceeded: {
-        readonly status: 429;
-        readonly term: "Max Commands Exceeded";
-    };
-    readonly idle_turn: {
-        readonly status: 409;
-        readonly term: "Illegal idle turn - a [102] turn performs at least one operation. Conclude with [200] or wait with [202].";
-    };
-}>;
-export type EngineErrorKind = keyof typeof ENGINE_ERRORS;
-export default class TelemetryChannel {
-    #private;
-    constructor({ db, notify }: {
-        db: Db;
-        notify?: TelemetryEventNotify;
-    });
-    push(workspaceId: number, loopId: number, event: TelemetryEvent): void;
-    notify(workspaceId: number, loopId: number, event: TelemetryEvent): void;
-    drain(loopId: number): object[];
-    delete(loopId: number): void;
-    mintEngineError(kind: EngineErrorKind, { workerId, loopId, turnId, sequence }: {
-        workerId: number;
-        loopId: number;
-        turnId: number;
-        sequence: number;
-    }): Promise<void>;
-}
-export {};
-//# sourceMappingURL=TelemetryChannel.d.ts.map

package/dist/core/TelemetryChannel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TelemetryChannel.d.ts","sourceRoot":"","sources":["../../src/core/TelemetryChannel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAM9D,QAAA,MAAM,aAAa;;iBACI,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,sKAAsK;;;iBACnL,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,uBAAuB;;;iBAOtD,MAAM,EAAE,GAAG;iBAAE,IAAI,EAAE,2GAA2G;;EACpI,CAAC;AACZ,MAAM,MAAM,eAAe,GAAG,MAAM,OAAO,aAAa,CAAC;AAKzD,MAAM,CAAC,OAAO,OAAO,gBAAgB;;IAajC,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,oBAAoB,CAAA;KAAE,EAGpE;IAED,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAQrE;IAID,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI,CAEvE;IAGD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAK9B;IAED,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3B;IAMK,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1K;CACJ"}

package/dist/core/TelemetryChannel.js

@@ -1,80 +0,0 @@
-// §telemetry — the uniform error channel. Every engine failure is a terse op='error'
-// log row: a status code + the canonical term, no prose (the packet teaches recovery).
-// Each surfaces as a LogCoordinate TelemetryEvent derived from log≥400 — one channel,
-// no per-kind handling. {§telemetry-uniform-error-channel}
-const ENGINE_ERRORS = Object.freeze({
-    budget_overflow: { status: 413, term: "Budget Overflow: newest log items automatically FOLDed — a retrieval larger than Tokens Free arrives folded; FOLD older items first, then fetch within the room made" },
-    max_commands_exceeded: { status: 429, term: "Max Commands Exceeded" },
-    // premature-terminate is NOT a terse engine-error: it's a SEND op-result (409 + an actionable
-    // outcome, §send-premature-terminate) — the SEND row records the [200] attempt faithfully and
-    // auto-surfaces (status≥400) like any op failure, never an erasure to 102.
-    // #394 (owner wording) — states the LAW of legal turn shapes, deliberately nothing more:
-    // teaching decomposition/drafting of big jobs is a grammar-level concern, never an error
-    // message's (owner: "isn't going to fit in an error message").
-    idle_turn: { status: 409, term: "Illegal idle turn - a [102] turn performs at least one operation. Conclude with [200] or wait with [202]." },
-});
-// The model-facing alert channel: a per-loop transient buffer of actionless failures
-// pending surface in the NEXT packet's user.telemetry.errors[], plus the live client
-// fan-out and the uniform op='error' log-row mint. SPEC §telemetry.
-export default class TelemetryChannel {
-    #db;
-    // Per-loop transient buffer of actionless failures pending surface in the
-    // NEXT packet's user.telemetry.errors[]. Drained by PacketBuilder.buildTelemetryErrors.
-    // Map<loopId, TelemetryError[]>. SPEC §telemetry.
-    #buffer = new Map();
-    // Telemetry event fan-out: every TelemetryEvent pushed to the loop's
-    // buffer is also broadcast live to the connected client(s) on the
-    // workspace. Without this, the client sees `loop/terminated` with a
-    // status code but has no way to surface why the loop degraded.
-    // Per-grammar 0.17.0 protocol — see SPEC §telemetry.
-    #notify;
-    constructor({ db, notify }) {
-        this.#db = db;
-        this.#notify = notify;
-    }
-    push(workspaceId, loopId, event) {
-        const existing = this.#buffer.get(loopId);
-        if (existing === undefined)
-            this.#buffer.set(loopId, [event]);
-        else
-            existing.push(event);
-        // Live fan-out: client sees the event the moment it lands in the
-        // model's buffer (not at the next packet build). Same envelope on
-        // both sides per the grammar 0.17.0 TelemetryEvent protocol.
-        this.#notify?.(workspaceId, { loopId, event });
-    }
-    // Live fan-out ONLY, never buffered — for work with no loop to drain the
-    // buffer (e.g. workspace-scope derivation warming, loopId 0).
-    notify(workspaceId, loopId, event) {
-        this.#notify?.(workspaceId, { loopId, event });
-    }
-    // Telemetry drains as it's read into the packet — each event surfaces once. §telemetry-drain-on-read
-    drain(loopId) {
-        const buf = this.#buffer.get(loopId);
-        if (buf === undefined)
-            return [];
-        this.#buffer.delete(loopId);
-        return buf;
-    }
-    delete(loopId) {
-        this.#buffer.delete(loopId);
-    }
-    // Mint an engine failure as a uniform op='error' log row (§telemetry-uniform-error-channel):
-    // a terse status + canonical term keyed by `kind` (the packet teaches recovery, not the row),
-    // origin engine:rail. The errors section derives its LogCoordinate pointer from log≥400 — one
-    // channel, no per-kind handling.
-    async mintEngineError(kind, { workerId, loopId, turnId, sequence }) {
-        const { status, term } = ENGINE_ERRORS[kind];
-        await this.#db.engine_insert_log_entry.get({
-            worker_id: workerId, loop_id: loopId, turn_id: turnId, sequence,
-            origin: "plurnk", source: "rail", op: "error", suffix: "", signal: null,
-            scheme: null, username: null, password: null, hostname: null, port: null,
-            pathname: null, params: null, fragment: null, lineMarker: null,
-            tx: "", mimetype_tx: "text/plain",
-            rx: JSON.stringify({ kind, message: term }),
-            mimetype_rx: "application/json",
-            status_rx: status, tokens: 0, state: "resolved", outcome: null, attrs: "{}",
-        });
-    }
-}
-//# sourceMappingURL=TelemetryChannel.js.map

package/dist/core/TelemetryChannel.js.map

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

package/dist/core/path-decode.d.ts

@@ -1,3 +0,0 @@
-export declare const encodePathParens: (s: string) => string;
-export declare const decodePathParens: (s: string) => string;
-//# sourceMappingURL=path-decode.d.ts.map

package/dist/core/path-decode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-decode.d.ts","sourceRoot":"","sources":["../../src/core/path-decode.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,MAAO,MAAM,KAAG,MAAuD,CAAC;AACrG,eAAO,MAAM,gBAAgB,MAAO,MAAM,KAAG,MAAuD,CAAC"}

package/dist/core/path-decode.js

@@ -1,9 +0,0 @@
-// #239 item 4 — the grammar's target slot is opaque: a literal `)` closes the op slot, so
-// parens inside a path are percent-encoded (`%28`/`%29`) and the service decodes them at
-// resolve time. ONLY parens are encoded — `:`, spaces, and drive letters pass through
-// literally — so a targeted %28/%29 replacement is exact and safe: it never touches a
-// literal `%` in a path (which decodeURIComponent would mangle). A regex target's source
-// is NOT a path (its parens are groups/alternation), so callers skip it.
-export const encodePathParens = (s) => s.replace(/\(/g, "%28").replace(/\)/g, "%29");
-export const decodePathParens = (s) => s.replace(/%28/gi, "(").replace(/%29/gi, ")");
-//# sourceMappingURL=path-decode.js.map

package/dist/core/path-decode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"path-decode.js","sourceRoot":"","sources":["../../src/core/path-decode.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,yFAAyF;AACzF,sFAAsF;AACtF,sFAAsF;AACtF,yFAAyF;AACzF,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACrG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC"}

package/dist/core/plugin-attribution.d.ts

@@ -1,5 +0,0 @@
-export default class PluginAttribution {
-    static normalize(raw: unknown, packageName: string): string[];
-    static read(packageName: string): string[];
-}
-//# sourceMappingURL=plugin-attribution.d.ts.map

package/dist/core/plugin-attribution.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-attribution.d.ts","sourceRoot":"","sources":["../../src/core/plugin-attribution.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAIlC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAe5D;IAGD,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAQzC;CACJ"}

package/dist/core/plugin-attribution.js

@@ -1,39 +0,0 @@
-// #249 — plugin attribution. A plugin declares an opaque tag in its package.json
-// (plurnk.attribution: string | string[]) that rides the generate() attributions wire.
-// @plurnk/ is reserved: only a @plurnk/-scoped package may declare a @plurnk/ tag.
-import { createRequire } from "node:module";
-const RESERVED_PREFIX = "@plurnk/";
-export default class PluginAttribution {
-    // Normalize a raw `plurnk.attribution` value to a tag list AND enforce the reservation.
-    // Pure (no I/O) so the contract is unit-testable. A plugin claiming the reserved
-    // namespace is a fail-hard contract violation, not a silently-dropped tag.
-    static normalize(raw, packageName) {
-        if (raw === undefined || raw === null)
-            return [];
-        const tags = Array.isArray(raw) ? raw : [raw];
-        const firstParty = packageName.startsWith(RESERVED_PREFIX);
-        const out = [];
-        for (const tag of tags) {
-            if (typeof tag !== "string" || tag.length === 0) {
-                throw new Error(`plugin '${packageName}': plurnk.attribution must be a non-empty string or string[]`);
-            }
-            if (tag.startsWith(RESERVED_PREFIX) && !firstParty) {
-                throw new Error(`plugin '${packageName}': '${RESERVED_PREFIX}' is reserved for ${RESERVED_PREFIX}-scoped packages — '${packageName}' cannot claim '${tag}'`);
-            }
-            out.push(tag);
-        }
-        return out;
-    }
-    // [] when the manifest can't be resolved (strict `exports` with no `./package.json`).
-    static read(packageName) {
-        let manifest;
-        try {
-            manifest = createRequire(import.meta.url)(`${packageName}/package.json`);
-        }
-        catch {
-            return [];
-        }
-        return PluginAttribution.normalize(manifest?.plurnk?.attribution, packageName);
-    }
-}
-//# sourceMappingURL=plugin-attribution.js.map

package/dist/core/plugin-attribution.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-attribution.js","sourceRoot":"","sources":["../../src/core/plugin-attribution.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,uFAAuF;AACvF,mFAAmF;AAEnF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,eAAe,GAAG,UAAU,CAAC;AAEnC,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAClC,wFAAwF;IACxF,iFAAiF;IACjF,2EAA2E;IAC3E,MAAM,CAAC,SAAS,CAAC,GAAY,EAAE,WAAmB;QAC9C,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,8DAA8D,CAAC,CAAC;YAC1G,CAAC;YACD,IAAI,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,OAAO,eAAe,qBAAqB,eAAe,uBAAuB,WAAW,mBAAmB,GAAG,GAAG,CAAC,CAAC;YACjK,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,CAAC;IACf,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,IAAI,CAAC,WAAmB;QAC3B,IAAI,QAAgD,CAAC;QACrD,IAAI,CAAC;YACD,QAAQ,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,WAAW,eAAe,CAAoB,CAAC;QAChG,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,iBAAiB,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IACnF,CAAC;CACJ"}

package/dist/core/world-state.d.ts

@@ -1,10 +0,0 @@
-import type { Db } from "./Db.ts";
-export interface WorldStateViolation {
-    invariant: string;
-    detail: string;
-}
-export default class WorldState {
-    static check(db: Db): Promise<WorldStateViolation[]>;
-    static entryCount(db: Db): Promise<number>;
-}
-//# sourceMappingURL=world-state.d.ts.map

package/dist/core/world-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"world-state.d.ts","sourceRoot":"","sources":["../../src/core/world-state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,WAAW,mBAAmB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAE1E,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B,OAAa,KAAK,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA6BzD;IAGD,OAAa,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAE/C;CACJ"}

package/dist/core/world-state.js

@@ -1,35 +0,0 @@
-import Namespace from "./namespace.js";
-export default class WorldState {
-    static async check(db) {
-        const violations = [];
-        const dups = await db.ws_dup_identities.all({});
-        for (const d of dups) {
-            violations.push({ invariant: "§entry-identity-no-null", detail: `identity (ws ${d.workspace_id}, owner ${d.owner_id}, ${d.scheme}, ${d.pathname}) holds ${d.n} rows` });
-        }
-        const keys = await db.ws_file_keys.all({});
-        for (const k of keys) {
-            if (!Namespace.isCanonical(k.pathname, k.project_root)) {
-                violations.push({ invariant: "§fs-canonical-name", detail: `ws ${k.workspace_id}: stored key '${k.pathname}' is not its own canon` });
-            }
-        }
-        const orphanChannels = await db.ws_orphan_channels.get({});
-        if ((orphanChannels?.n ?? 0) > 0)
-            violations.push({ invariant: "orphan-freedom", detail: `${orphanChannels?.n} entry_channels rows without a parent entry` });
-        const orphanTags = await db.ws_orphan_tags.get({});
-        if ((orphanTags?.n ?? 0) > 0)
-            violations.push({ invariant: "orphan-freedom", detail: `${orphanTags?.n} entry_tags rows without a parent entry` });
-        const alien = await db.ws_alien_origin.all({});
-        for (const a of alien) {
-            violations.push({ invariant: "§fs-write-surface admission", detail: `ws ${a.workspace_id}: '${a.pathname}' carries alien grantor '${a.membership_origin}'` });
-        }
-        const sigLeak = await db.ws_sig_on_nonfile.get({});
-        if ((sigLeak?.n ?? 0) > 0)
-            violations.push({ invariant: "sig-coherence", detail: `${sigLeak?.n} non-file rows carry synced_sig` });
-        return violations;
-    }
-    // The soak's delta half: total entries rows — an idle turn grows this by ZERO.
-    static async entryCount(db) {
-        return (await db.ws_entry_count.get({}))?.n ?? 0;
-    }
-}
-//# sourceMappingURL=world-state.js.map

package/dist/core/world-state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"world-state.js","sourceRoot":"","sources":["../../src/core/world-state.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAIvC,MAAM,CAAC,OAAO,OAAO,UAAU;IAC3B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAM;QACrB,MAAM,UAAU,GAA0B,EAAE,CAAC;QAE7C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAA0F,EAAE,CAAC,CAAC;QACzI,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC,YAAY,WAAW,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5K,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,YAAY,CAAC,GAAG,CAA0E,EAAE,CAAC,CAAC;QACpH,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;gBACrD,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,YAAY,iBAAiB,CAAC,CAAC,QAAQ,wBAAwB,EAAE,CAAC,CAAC;YAC1I,CAAC;QACL,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAgB,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,CAAC,6CAA6C,EAAE,CAAC,CAAC;QAC9J,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAgB,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,yCAAyC,EAAE,CAAC,CAAC;QAElJ,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,GAAG,CAAwE,EAAE,CAAC,CAAC;QACtH,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACpB,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,6BAA6B,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,QAAQ,4BAA4B,CAAC,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;QAClK,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAgB,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,iCAAiC,EAAE,CAAC,CAAC;QAEnI,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,+EAA+E;IAC/E,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,EAAM;QAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC;CACJ"}

package/dist/core/world-state.sql

@@ -1,35 +0,0 @@
--- WorldState invariant queries ({§fs-world-state}) — the pure-db half of the harness.
--- Read-only; bench runs the same checks over campaign specimens (#536 evidence contract).
-
--- PREP: ws_dup_identities
--- {§entry-identity-no-null} in PRACTICE: no two rows may share the identity tuple. The
--- UNIQUE index should make this impossible; the harness asserts the world, not the intent.
-SELECT workspace_id, owner_id, scheme, pathname, COUNT(*) AS n
-FROM entries GROUP BY workspace_id, owner_id, scheme, pathname HAVING n > 1;
-
--- PREP: ws_file_keys
--- {§fs-canonical-name} fixpoint inputs: every file-class key with its workspace root.
-SELECT e.workspace_id, e.pathname, w.project_root
-FROM entries e JOIN workspaces w ON w.id = e.workspace_id
-WHERE e.scheme = 'file';
-
--- PREP: ws_orphan_channels
-SELECT COUNT(*) AS n FROM entry_channels c LEFT JOIN entries e ON e.id = c.entry_id WHERE e.id IS NULL;
-
--- PREP: ws_orphan_tags
-SELECT COUNT(*) AS n FROM entry_tags t LEFT JOIN entries e ON e.id = t.entry_id WHERE e.id IS NULL;
-
--- PREP: ws_alien_origin
--- The closed admission set ({§fs-write-surface} sandbox narrative): a file row's grantor is
--- git or a client act ('client'/'constraint'), or NULL for the create-accepted-this-instant
--- transient the next reconcile stamps — anything ELSE is a breach.
-SELECT workspace_id, pathname, membership_origin FROM entries
-WHERE scheme = 'file' AND membership_origin IS NOT NULL
-  AND membership_origin NOT IN ('git', 'client', 'constraint');
-
--- PREP: ws_sig_on_nonfile
--- synced_sig is the file-class disk gate; on any other scheme it is machinery leaking.
-SELECT COUNT(*) AS n FROM entries WHERE scheme != 'file' AND synced_sig IS NOT NULL;
-
--- PREP: ws_entry_count
-SELECT COUNT(*) AS n FROM entries;

package/dist/core/zero-pin.d.ts

@@ -1,3 +0,0 @@
-export declare const isEnvelopePin: (key: string) => boolean;
-export declare const scrubEnvelopePins: (env: NodeJS.ProcessEnv) => string[];
-//# sourceMappingURL=zero-pin.d.ts.map

package/dist/core/zero-pin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"zero-pin.d.ts","sourceRoot":"","sources":["../../src/core/zero-pin.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa,QAAS,MAAM,KAAG,OAGC,CAAC;AAI9C,eAAO,MAAM,iBAAiB,QAAS,MAAM,CAAC,UAAU,KAAG,MAAM,EAIhE,CAAC"}