@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/server/drivers/web-search/pick.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pick the web-search or web-extract connection for one intern.
+ * Pin → dedicated (non-completion, not the projected intern) → Nous intern → keyless.
+ * Grok/xAI `can` completion+web-search; it does not auto-win search or extract.
+ * `web-nous` is projected; file BYOK must beat it regardless of map insertion order.
+ *
+ * Product fallback policy lives here. Nous owns source/gateway credential lifecycle.
+ */
+import { ConnectionSpec, DriverSpec } from "@inhuman.tools/plexus-expectations";
+export type WebSearchCanFace = {
+    readonly driver: {
+        readonly abilityClaim: readonly string[];
+    };
+};
+export type WebSearchPickKernel = {
+    readonly kvs: {
+        readonly [key: string]: string;
+    };
+    readonly drivers: {
+        readonly [name: string]: DriverSpec | undefined;
+    };
+    readonly connections: {
+        readonly [id: string]: ConnectionSpec | WebSearchCanFace | undefined;
+    };
+};
+export declare function projectKeylessConnection(into: WebSearchPickKernel): void;
+export declare function pickWebSearchConnection(kernel: WebSearchPickKernel): string | null;
+export declare function pickWebExtractConnection(kernel: WebSearchPickKernel): string | null;
+//# sourceMappingURL=pick.d.ts.map

package/dist/server/drivers/web-search/pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../../../../src/server/drivers/web-search/pick.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAehF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACjD,QAAQ,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;KAAE,CAAC;IACtE,QAAQ,CAAC,WAAW,EAAE;QACpB,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,gBAAgB,GAAG,SAAS,CAAC;KACtE,CAAC;CACH,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CAexE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAMlF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAMnF"}

package/dist/server/drivers/web-search/pick.js

@@ -0,0 +1,65 @@
+/**
+ * Pick the web-search or web-extract connection for one intern.
+ * Pin → dedicated (non-completion, not the projected intern) → Nous intern → keyless.
+ * Grok/xAI `can` completion+web-search; it does not auto-win search or extract.
+ * `web-nous` is projected; file BYOK must beat it regardless of map insertion order.
+ *
+ * Product fallback policy lives here. Nous owns source/gateway credential lifecycle.
+ */
+import { ConnectionSpec } from "@inhuman.tools/plexus-expectations";
+import { NOUS_GATEWAY_CONNECTION_ID } from "../../../providers/nous/index.js";
+import { isCompletionCan, isWebExtractCan, isWebSearchCan, KEYLESS_CONNECTION_ID, KEYLESS_DRIVER_NAME, WEB_EXTRACT_PIN_KV, WEB_SEARCH_KEYLESS_FALLBACK_KV, WEB_SEARCH_PIN_KV, } from "./types.js";
+export function projectKeylessConnection(into) {
+    const driver = into.drivers[KEYLESS_DRIVER_NAME];
+    if (driver === undefined)
+        return;
+    if (into.kvs[WEB_SEARCH_KEYLESS_FALLBACK_KV] === "false") {
+        delete into.connections[KEYLESS_CONNECTION_ID];
+        return;
+    }
+    const connections = into.connections;
+    const spec = (connections[KEYLESS_CONNECTION_ID] ??= new ConnectionSpec({
+        driver,
+    }));
+    spec.driver = driver;
+    spec.name = "web-keyless";
+    spec.annotation = "Keyless web-search ring";
+    spec.configuration = {};
+}
+export function pickWebSearchConnection(kernel) {
+    return pickByCan(kernel, {
+        pin: (kernel.kvs[WEB_SEARCH_PIN_KV] ?? "").trim(),
+        eligible: (spec) => isWebSearchCan(spec.driver.abilityClaim),
+        dedicated: (spec) => isWebSearchCan(spec.driver.abilityClaim) && !isCompletionCan(spec.driver.abilityClaim),
+    });
+}
+export function pickWebExtractConnection(kernel) {
+    return pickByCan(kernel, {
+        pin: (kernel.kvs[WEB_EXTRACT_PIN_KV] ?? "").trim(),
+        eligible: (spec) => isWebExtractCan(spec.driver.abilityClaim),
+        dedicated: (spec) => isWebExtractCan(spec.driver.abilityClaim) && !isCompletionCan(spec.driver.abilityClaim),
+    });
+}
+function pickByCan(kernel, opts) {
+    const ids = [];
+    for (const [id, spec] of Object.entries(kernel.connections)) {
+        if (spec !== undefined && opts.eligible(spec))
+            ids.push(id);
+    }
+    if (opts.pin !== "" && ids.includes(opts.pin))
+        return opts.pin;
+    const dedicated = ids.find((id) => {
+        const spec = kernel.connections[id];
+        return (spec !== undefined && id !== KEYLESS_CONNECTION_ID && id !== NOUS_GATEWAY_CONNECTION_ID && opts.dedicated(spec));
+    });
+    if (dedicated !== undefined)
+        return dedicated;
+    const intern = kernel.connections[NOUS_GATEWAY_CONNECTION_ID];
+    if (intern !== undefined && ids.includes(NOUS_GATEWAY_CONNECTION_ID) && opts.dedicated(intern)) {
+        return NOUS_GATEWAY_CONNECTION_ID;
+    }
+    if (ids.includes(KEYLESS_CONNECTION_ID))
+        return KEYLESS_CONNECTION_ID;
+    return null;
+}
+//# sourceMappingURL=pick.js.map

package/dist/server/drivers/web-search/pick.js.map

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

package/dist/server/drivers/web-search/types.d.ts

@@ -0,0 +1,10 @@
+/** Product driver IDs and pin keys. Wire types live in provider-web/wire. */
+export declare const KEYLESS_DRIVER_NAME = "web-keyless";
+export declare const KEYLESS_CONNECTION_ID = "web-keyless";
+export declare const WEB_SEARCH_PIN_KV = "web-search-connection";
+export declare const WEB_EXTRACT_PIN_KV = "web-extract-connection";
+export declare const WEB_SEARCH_KEYLESS_FALLBACK_KV = "web.keyless_fallback";
+export declare function isWebSearchCan(can: readonly string[]): boolean;
+export declare function isWebExtractCan(can: readonly string[]): boolean;
+export declare function isCompletionCan(can: readonly string[]): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/server/drivers/web-search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/drivers/web-search/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAI7E,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AACjD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AACzD,eAAO,MAAM,kBAAkB,2BAA2B,CAAC;AAC3D,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE9D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE/D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAE/D"}

package/dist/server/drivers/web-search/types.js

@@ -0,0 +1,17 @@
+/** Product driver IDs and pin keys. Wire types live in provider-web/wire. */
+import { WEB_EXTRACT_CAN, WEB_SEARCH_CAN } from "../../../providers/web/wire/index.js";
+export const KEYLESS_DRIVER_NAME = "web-keyless";
+export const KEYLESS_CONNECTION_ID = "web-keyless";
+export const WEB_SEARCH_PIN_KV = "web-search-connection";
+export const WEB_EXTRACT_PIN_KV = "web-extract-connection";
+export const WEB_SEARCH_KEYLESS_FALLBACK_KV = "web.keyless_fallback";
+export function isWebSearchCan(can) {
+    return can.includes(WEB_SEARCH_CAN);
+}
+export function isWebExtractCan(can) {
+    return can.includes(WEB_EXTRACT_CAN);
+}
+export function isCompletionCan(can) {
+    return can.includes("completion");
+}
+//# sourceMappingURL=types.js.map

package/dist/server/drivers/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/server/drivers/web-search/types.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAC;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAC;AAErE,MAAM,UAAU,cAAc,CAAC,GAAsB;IACnD,OAAO,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,OAAO,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAsB;IACpD,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC"}

package/dist/server/ensure.d.ts

@@ -0,0 +1,9 @@
+export type EnsureOptions = {
+    /** Kill the live owner, then spawn. Dev default; product `ensure()` is still attach. */
+    readonly restart?: boolean;
+};
+/** True when the kernel's daemon socket answers right now. Never spawns and never clears a stale socket. */
+export declare function daemonRunning(root?: string): Promise<boolean>;
+export declare function ensure(root?: string, options?: EnsureOptions): Promise<void>;
+export declare function stop(root: string): Promise<void>;
+//# sourceMappingURL=ensure.d.ts.map

package/dist/server/ensure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../src/server/ensure.ts"],"names":[],"mappings":"AAgGA,MAAM,MAAM,aAAa,GAAG;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,4GAA4G;AAC5G,wBAAsB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED,wBAAsB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDlF;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBtD"}

package/dist/server/ensure.js

@@ -0,0 +1,174 @@
+import { execFileSync, spawn } from "node:child_process";
+import { existsSync, realpathSync, unlinkSync } from "node:fs";
+import { access, mkdir, realpath, unlink } from "node:fs/promises";
+import { connect } from "node:net";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { step } from "@inhuman.tools/harness-diagnostics";
+import { daemonLogPath, daemonSocketPath } from "@inhuman.tools/harness-sdk/paths";
+import invariant from "tiny-invariant";
+import { errnoCode } from "./util/errno.js";
+const READY_TIMEOUT_MS = 10_000;
+const PROBE_TIMEOUT_MS = 300;
+const GRACE_MS = 2000;
+// Old startup adapter: spawn the in-process daemon bin. Do not import composition.
+// Public ensure() is daemon-socket liveness, not hypervisor sync/execution health.
+const entry = fileURLToPath(new URL("boot.js", import.meta.url));
+async function socketAnswers(socketPath) {
+    return new Promise((_resolve) => {
+        const socket = connect(socketPath);
+        const settle = (alive) => {
+            socket.removeAllListeners();
+            socket.destroy();
+            _resolve(alive);
+        };
+        const timer = setTimeout(() => settle(false), PROBE_TIMEOUT_MS);
+        socket.once("connect", () => {
+            clearTimeout(timer);
+            settle(true);
+        });
+        socket.once("error", () => {
+            clearTimeout(timer);
+            settle(false);
+        });
+    });
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveRoot(root) {
+    const given = resolve(root ?? join(homedir(), ".harness"));
+    await mkdir(given, { recursive: true });
+    return realpath(given);
+}
+function pidAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return errnoCode(error) === "EPERM";
+    }
+}
+/** lsof matches unix sockets by the bound (canonical) path. */
+function socketPids(socketPath) {
+    if (!existsSync(socketPath))
+        return [];
+    try {
+        const out = execFileSync("lsof", ["-t", socketPath], {
+            encoding: "utf8",
+            timeout: 5000,
+        }).trim();
+        if (out === "")
+            return [];
+        return [
+            ...new Set(out
+                .split("\n")
+                .map((line) => Number(line.trim()))
+                .filter((pid) => Number.isInteger(pid) && pid > 0 && pid !== process.pid)),
+        ].sort((a, b) => a - b);
+    }
+    catch {
+        return [];
+    }
+}
+function sockPath(root) {
+    try {
+        return daemonSocketPath(realpathSync(root));
+    }
+    catch {
+        return daemonSocketPath(root);
+    }
+}
+/** True when the kernel's daemon socket answers right now. Never spawns and never clears a stale socket. */
+export async function daemonRunning(root) {
+    return socketAnswers(daemonSocketPath(await resolveRoot(root)));
+}
+export async function ensure(root, options) {
+    const resolved = await resolveRoot(root);
+    if (options?.restart === true) {
+        step("ensure restart");
+        await stop(resolved);
+    }
+    const sock = daemonSocketPath(resolved);
+    step(`ensure probe ${sock}`);
+    if (await socketAnswers(sock)) {
+        step("ensure already live");
+        return;
+    }
+    if (await exists(sock)) {
+        try {
+            await unlink(sock);
+        }
+        catch {
+            /* another ensure() may have already cleared it */
+        }
+    }
+    step(`ensure spawn ${entry}`);
+    const log = process.env.HARNESS_LOG || daemonLogPath(resolved);
+    step(`ensure log ${log}`);
+    // Daemon identity is cwd. No argv, no stdout handshake. Log path is explicit
+    // so a live daemon writes the kernel file even if the parent cwd differs.
+    // stdio stays ignore: the daemon outlives this parent. boot.js records an
+    // import failure in that log, then exits.
+    const childExit = { code: null };
+    const child = spawn(process.execPath, [entry], {
+        cwd: resolved,
+        detached: true,
+        stdio: "ignore",
+        env: { ...process.env, HARNESS_LOG: log },
+    });
+    child.once("exit", (code, signal) => {
+        childExit.code = code ?? (signal == null ? 0 : 1);
+    });
+    step(`ensure pid ${child.pid ?? "none"}`);
+    child.unref();
+    const deadline = Date.now() + READY_TIMEOUT_MS;
+    while (!(await socketAnswers(sock))) {
+        if (childExit.code !== null) {
+            step(`ensure child exit ${childExit.code}`);
+            invariant(false, `harness daemon exited ${childExit.code} before listen: ${sock} (see ${log})`);
+        }
+        invariant(Date.now() < deadline, `harness daemon sock is dead: ${sock}`);
+        await new Promise((_resolve) => setTimeout(_resolve, 50));
+    }
+    step("ensure child ready");
+}
+export async function stop(root) {
+    const sock = sockPath(root);
+    const pids = socketPids(sock);
+    for (const pid of pids) {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch { }
+    }
+    const deadline = Date.now() + GRACE_MS;
+    for (const pid of pids) {
+        while (pidAlive(pid) && Date.now() < deadline) {
+            await new Promise((_resolve) => setTimeout(_resolve, 50));
+        }
+        if (pidAlive(pid)) {
+            try {
+                process.kill(pid, "SIGKILL");
+            }
+            catch { }
+        }
+    }
+    if (existsSync(sock) && !(await socketAnswers(sock))) {
+        try {
+            unlinkSync(sock);
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=ensure.js.map

package/dist/server/ensure.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,5 @@
+/** Light client facade: start/stop, plugin install, and the process log path. Does not import executable composition. */
+export { installPlugin, type InstallStreams } from "../extensions/install.js";
+export { daemonRunning as daemonRunning, ensure as ensure, stop as stop } from "./ensure.js";
+export * from "./step.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,MAAM,IAAI,MAAM,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,aAAa,CAAC;AAC7F,cAAc,WAAW,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,5 @@
+/** Light client facade: start/stop, plugin install, and the process log path. Does not import executable composition. */
+export { installPlugin } from "../extensions/install.js";
+export { daemonRunning as daemonRunning, ensure as ensure, stop as stop } from "./ensure.js";
+export * from "./step.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,yHAAyH;AACzH,OAAO,EAAE,aAAa,EAAuB,MAAM,0BAA0B,CAAC;AAC9E,OAAO,EAAE,aAAa,IAAI,aAAa,EAAE,MAAM,IAAI,MAAM,EAAE,IAAI,IAAI,IAAI,EAAE,MAAM,aAAa,CAAC;AAC7F,cAAc,WAAW,CAAC"}

package/dist/server/provider-roster/nous.d.ts

@@ -0,0 +1,3 @@
+/** Product intern. Not adopted; projected when a nous row exists. */
+export declare const nousGatewayIntern: import("@inhuman.tools/harness-provider-sdk").RegisteredProvider;
+//# sourceMappingURL=nous.d.ts.map

package/dist/server/provider-roster/nous.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nous.d.ts","sourceRoot":"","sources":["../../../src/server/provider-roster/nous.ts"],"names":[],"mappings":"AAMA,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,kEAc5B,CAAC"}

package/dist/server/provider-roster/nous.js

@@ -0,0 +1,20 @@
+import { parseProviderRegistration, PROVIDER_SDK_CONTRACT } from "@inhuman.tools/harness-provider-sdk";
+import { NOUS_GATEWAY_DRIVER_NAME } from "../../providers/nous/index.js";
+import { NousGatewayWebSearchConnection } from "../drivers/web-search/nous-gateway.js";
+/** Product intern. Not adopted; projected when a nous row exists. */
+export const nousGatewayIntern = parseProviderRegistration({
+    id: NOUS_GATEWAY_DRIVER_NAME,
+    name: "Nous Tool Gateway",
+    description: "Projected intern when a nous connection exists",
+    contract: PROVIDER_SDK_CONTRACT,
+    drivers: [
+        {
+            name: NOUS_GATEWAY_DRIVER_NAME,
+            description: "Nous Portal Tool Gateway search and extract",
+            abilityClaim: ["web-search", "web-extract"],
+            multiplicity: "add-by-default",
+            connection: NousGatewayWebSearchConnection,
+        },
+    ],
+});
+//# sourceMappingURL=nous.js.map

package/dist/server/provider-roster/nous.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nous.js","sourceRoot":"","sources":["../../../src/server/provider-roster/nous.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAEvG,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAEvF,qEAAqE;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;IACzD,EAAE,EAAE,wBAAwB;IAC5B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,gDAAgD;IAC7D,QAAQ,EAAE,qBAAqB;IAC/B,OAAO,EAAE;QACP;YACE,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EAAE,6CAA6C;YAC1D,YAAY,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;YAC3C,YAAY,EAAE,gBAAgB;YAC9B,UAAU,EAAE,8BAA8B;SAC3C;KACF;CACF,CAAC,CAAC"}

package/dist/server/runtime-bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=runtime-bin.d.ts.map

package/dist/server/runtime-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bin.d.ts","sourceRoot":"","sources":["../../src/server/runtime-bin.ts"],"names":[],"mappings":""}

package/dist/server/runtime-bin.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { join } from "node:path";
+import { fail } from "@inhuman.tools/harness-diagnostics";
+import { WebSocket } from "ws";
+import { openDriverRegistry } from "../connections/index.js";
+import { runSupervisedProcess } from "../hypervisor/index.js";
+import { RuntimeServer } from "../runtime-server/index.js";
+import { connectRemoteDocument, wrapWebSocket } from "../yjs/index.js";
+import { PRODUCT_PROVIDERS } from "./composition.js";
+const PEER_SOCK = join(process.cwd(), "private-peer.sock");
+const PEER_CAPABILITY = "product";
+try {
+    process.exit(await runSupervisedProcess({
+        start: async ({ identity }) => {
+            const ws = new WebSocket(`ws+unix://${PEER_SOCK}:/`);
+            await new Promise((resolve, reject) => {
+                const onOpen = () => {
+                    ws.off("error", onError);
+                    resolve();
+                };
+                const onError = (error) => {
+                    ws.off("open", onOpen);
+                    reject(error);
+                };
+                ws.once("open", onOpen);
+                ws.once("error", onError);
+            });
+            let closing = false;
+            ws.on("error", () => undefined);
+            ws.on("close", () => {
+                if (!closing)
+                    process.exit(1);
+            });
+            const connected = await connectRemoteDocument(wrapWebSocket(ws), {
+                capability: PEER_CAPABILITY,
+                identity,
+            });
+            if (!connected.ok) {
+                closing = true;
+                ws.close();
+                throw new Error(`runtime peer ${connected.reason}`);
+            }
+            const server = new RuntimeServer({
+                adapter: connected.adapter,
+                registry: openDriverRegistry(PRODUCT_PROVIDERS),
+            });
+            return async () => {
+                closing = true;
+                let flush = "ok";
+                const loaded = server.documents.loaded();
+                if (loaded.length > 0) {
+                    for (const ref of loaded) {
+                        const result = await server.documents.flush(ref.key);
+                        if (!result.ok) {
+                            flush = result.reason === "disconnected" ? "pending" : "failed";
+                            break;
+                        }
+                    }
+                }
+                server[Symbol.dispose]();
+                ws.close();
+                return flush;
+            };
+        },
+    }));
+}
+catch (error) {
+    fail("runtime-server", error);
+    process.exit(1);
+}
+//# sourceMappingURL=runtime-bin.js.map

package/dist/server/runtime-bin.js.map

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

package/dist/server/schemas/index.d.ts

@@ -0,0 +1,5 @@
+export * from "@inhuman.tools/harness-contract";
+export * from "./json-record.js";
+export * from "./tool-result.js";
+export * from "./well-known.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/schemas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/server/schemas/index.js

@@ -0,0 +1,5 @@
+export * from "@inhuman.tools/harness-contract";
+export * from "./json-record.js";
+export * from "./tool-result.js";
+export * from "./well-known.js";
+//# sourceMappingURL=index.js.map

package/dist/server/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/server/schemas/json-record.d.ts

@@ -0,0 +1,10 @@
+import { z } from "zod";
+/** Object JSON after `JSON.parse`. Arrays fail. */
+export declare const unknownRecordSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+/**
+ * Tool `argsJson` at a Zod boundary. Empty string is `{}`.
+ * Invalid JSON becomes `undefined` so the next object schema fails —
+ * callers choose `null` vs defaults; this does not.
+ */
+export declare function argsJsonValue(value: unknown): unknown;
+//# sourceMappingURL=json-record.d.ts.map

package/dist/server/schemas/json-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-record.d.ts","sourceRoot":"","sources":["../../../src/server/schemas/json-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mDAAmD;AACnD,eAAO,MAAM,mBAAmB,wCAAoC,CAAC;AAErE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQrD"}

package/dist/server/schemas/json-record.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+/** Object JSON after `JSON.parse`. Arrays fail. */
+export const unknownRecordSchema = z.record(z.string(), z.unknown());
+/**
+ * Tool `argsJson` at a Zod boundary. Empty string is `{}`.
+ * Invalid JSON becomes `undefined` so the next object schema fails —
+ * callers choose `null` vs defaults; this does not.
+ */
+export function argsJsonValue(value) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        const parsed = JSON.parse(value === "" ? "{}" : value);
+        return parsed;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=json-record.js.map

package/dist/server/schemas/json-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-record.js","sourceRoot":"","sources":["../../../src/server/schemas/json-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mDAAmD;AACnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAChE,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/server/schemas/tool-result.d.ts

@@ -0,0 +1,14 @@
+import { z } from "@inhuman.tools/plugin-sdk";
+export declare const toolResultSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    text: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const toolResultShape: z.ZodObject<{
+    ok: z.ZodBoolean;
+    text: z.ZodOptional<z.ZodUnknown>;
+    value: z.ZodOptional<z.ZodUnknown>;
+    truncated: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+//# sourceMappingURL=tool-result.d.ts.map

package/dist/server/schemas/tool-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.d.ts","sourceRoot":"","sources":["../../../src/server/schemas/tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,2BAA2B,CAAC;AAE9C,eAAO,MAAM,gBAAgB;;;;;iBAK3B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;iBAK1B,CAAC"}

package/dist/server/schemas/tool-result.js

@@ -0,0 +1,14 @@
+import { z } from "@inhuman.tools/plugin-sdk";
+export const toolResultSchema = z.object({
+    ok: z.boolean(),
+    text: z.string().optional(),
+    value: z.unknown().optional(),
+    truncated: z.boolean().optional(),
+});
+export const toolResultShape = z.object({
+    ok: z.boolean(),
+    text: z.unknown().optional(),
+    value: z.unknown().optional(),
+    truncated: z.boolean().optional(),
+});
+//# sourceMappingURL=tool-result.js.map

package/dist/server/schemas/tool-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result.js","sourceRoot":"","sources":["../../../src/server/schemas/tool-result.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,2BAA2B,CAAC;AAE9C,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE;IACf,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC"}