@sponsio/sdk 0.1.0-alpha.3 → 0.1.0

package/dist/cli/doctor.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * ``sponsio doctor`` — pre-flight env + config sanity check.
+ *
+ * Parity with Python's ``sponsio doctor``, tuned to the TS runtime:
+ * verifies node version, the ``yaml`` peer dep, the session log dir,
+ * ``SPONSIO_MODE`` value, and (if ``sponsio.yaml`` is present in CWD)
+ * that it parses cleanly. Exits non-zero when any check fails so CI
+ * can gate on it.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runDoctorCli = runDoctorCli;
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+const node_module_1 = require("node:module");
+const HELP = [
+    "sponsio doctor — env + config health check",
+    "",
+    "USAGE:",
+    "  sponsio doctor [options]",
+    "",
+    "OPTIONS:",
+    "      --format <f>  'text' (default) or 'json'",
+    "  -h, --help        Show this help",
+    "",
+    "EXIT CODES:",
+    "  0  all checks green",
+    "  2  at least one 'fail' — TS runtime won't start cleanly until fixed",
+].join("\n") + "\n";
+function parseArgs(argv) {
+    const a = { format: "text", help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const flag = argv[i];
+        if (flag === "-h" || flag === "--help")
+            a.help = true;
+        else if (flag === "--format") {
+            const v = argv[++i];
+            if (v !== "text" && v !== "json")
+                throw new Error(`--format must be 'text' or 'json'`);
+            a.format = v;
+        }
+        else {
+            throw new Error(`unknown flag: ${flag}`);
+        }
+    }
+    return a;
+}
+function checkNodeVersion() {
+    const v = process.versions.node.split(".").map((n) => parseInt(n, 10));
+    if (v[0] >= 18) {
+        return {
+            label: "node runtime",
+            status: "ok",
+            detail: `node ${process.versions.node}`,
+        };
+    }
+    return {
+        label: "node runtime",
+        status: "fail",
+        detail: `node ${process.versions.node} < 18 — the TS SDK uses global fetch`,
+    };
+}
+function checkYamlDep() {
+    try {
+        const require = (0, node_module_1.createRequire)(__filename);
+        const yaml = require("yaml");
+        if (typeof yaml.parse !== "function") {
+            return { label: "yaml peer dep", status: "fail", detail: "require('yaml') returned unexpected shape" };
+        }
+        return { label: "yaml peer dep", status: "ok", detail: "require('yaml') works" };
+    }
+    catch (e) {
+        return {
+            label: "yaml peer dep",
+            status: "fail",
+            detail: `yaml package missing — install with: npm install yaml (${e instanceof Error ? e.message : e})`,
+        };
+    }
+}
+function checkSessionDir() {
+    const dir = (0, node_path_1.join)((0, node_os_1.homedir)(), ".sponsio", "sessions");
+    try {
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+        (0, node_fs_1.accessSync)(dir, node_fs_1.constants.W_OK);
+        return {
+            label: "session log dir",
+            status: "ok",
+            detail: `${dir} writable`,
+        };
+    }
+    catch (e) {
+        return {
+            label: "session log dir",
+            status: "warn",
+            detail: `${dir} not writable (${e instanceof Error ? e.message : e}) — sessionLog:false when constructing guard`,
+        };
+    }
+}
+function checkSponsoMode() {
+    const raw = process.env.SPONSIO_MODE;
+    if (!raw) {
+        return {
+            label: "SPONSIO_MODE",
+            status: "ok",
+            detail: "unset (falls through to ctor / yaml / default 'observe')",
+        };
+    }
+    if (raw === "enforce" || raw === "observe") {
+        return { label: "SPONSIO_MODE", status: "ok", detail: raw };
+    }
+    return {
+        label: "SPONSIO_MODE",
+        status: "fail",
+        detail: `unknown value '${raw}' — expected 'enforce' | 'observe'`,
+    };
+}
+function checkYamlParses() {
+    const path = (0, node_path_1.resolve)(process.cwd(), "sponsio.yaml");
+    if (!(0, node_fs_1.existsSync)(path)) {
+        return {
+            label: "sponsio.yaml",
+            status: "warn",
+            detail: `${path} not found — run 'sponsio onboard .' to create one`,
+        };
+    }
+    try {
+        const st = (0, node_fs_1.statSync)(path);
+        if (st.size === 0) {
+            return {
+                label: "sponsio.yaml",
+                status: "warn",
+                detail: `${path} is empty`,
+            };
+        }
+        const require = (0, node_module_1.createRequire)(__filename);
+        const yaml = require("yaml");
+        const fs = require("fs");
+        const raw = fs.readFileSync(path, "utf-8");
+        const parsed = yaml.parse(raw);
+        if (typeof parsed !== "object" || parsed === null) {
+            return {
+                label: "sponsio.yaml",
+                status: "fail",
+                detail: `${path}: top-level is not a mapping`,
+            };
+        }
+        return {
+            label: "sponsio.yaml",
+            status: "ok",
+            detail: `${path} parses (use 'validate' for det/sto counts)`,
+        };
+    }
+    catch (e) {
+        return {
+            label: "sponsio.yaml",
+            status: "fail",
+            detail: `${path}: ${e instanceof Error ? e.message : e}`,
+        };
+    }
+}
+function render(checks) {
+    const width = Math.max(...checks.map((c) => c.label.length));
+    const out = [];
+    for (const c of checks) {
+        const marker = c.status === "ok" ? "✓" : c.status === "warn" ? "⚠" : "✗";
+        out.push(`  ${marker} ${c.label.padEnd(width)}  ${c.detail}`);
+    }
+    return out.join("\n") + "\n";
+}
+async function runDoctorCli(argv) {
+    let args;
+    try {
+        args = parseArgs(argv);
+    }
+    catch (err) {
+        process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+        process.exit(2);
+    }
+    if (args.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    const checks = [
+        checkNodeVersion(),
+        checkYamlDep(),
+        checkSessionDir(),
+        checkSponsoMode(),
+        checkYamlParses(),
+    ];
+    if (args.format === "json") {
+        process.stdout.write(JSON.stringify(checks, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write("Sponsio doctor\n");
+        process.stdout.write(render(checks));
+    }
+    if (checks.some((c) => c.status === "fail"))
+        process.exit(2);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/eval.d.ts

@@ -0,0 +1,2 @@
+export declare function runEvalCli(argv: string[]): Promise<void>;
+//# sourceMappingURL=eval.d.ts.map

package/dist/cli/eval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../src/cli/eval.ts"],"names":[],"mappings":"AA0KA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA2L9D"}

package/dist/cli/eval.js

@@ -0,0 +1,361 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEvalCli = runEvalCli;
+/**
+ * ``sponsio eval`` — replay a labelled corpus, report FPR/FNR.
+ *
+ * Mirrors the Python ``sponsio eval`` UX. Filename prefix is the
+ * label:
+ *   - ``safe_*``    expected to PASS every contract
+ *   - ``unsafe_*``  expected to be BLOCKED by ≥1 contract
+ *   - other         counted but not used in FPR/FNR
+ *
+ * Reports per-contract FPR/FNR + overall numbers. Supports
+ * ``--baseline`` diffing for CI gates (``--max-fpr-delta`` /
+ * ``--max-fnr-delta``).
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const yaml = __importStar(require("js-yaml"));
+const otlp_1 = require("./otlp");
+const HELP = "sponsio eval — replay a labelled trace corpus and report FPR/FNR\n" +
+    "\n" +
+    "USAGE:\n" +
+    "  sponsio eval <trace_path> [contracts...] [options]\n" +
+    "\n" +
+    "Label convention (filename prefix):\n" +
+    "  safe_*     expected to PASS\n" +
+    "  unsafe_*   expected to be BLOCKED by >=1 contract\n" +
+    "  *          counted, not used in FPR/FNR\n" +
+    "\n" +
+    "OPTIONS:\n" +
+    "  -c, --config <file>       sponsio.yaml\n" +
+    "  -a, --agent <id>          Agent id (with --config)\n" +
+    "      --json                Emit JSON report on stdout\n" +
+    "      --baseline <file>     Compare against a prior --json report\n" +
+    "      --max-fpr-delta <pp>  Exit 1 if overall FPR rose more than this (pp)\n" +
+    "      --max-fnr-delta <pp>  Exit 1 if overall FNR rose more than this (pp)\n" +
+    "      --write-baseline <f>  Write JSON report to this path after running\n" +
+    "  -h, --help                Show this help\n" +
+    "\n" +
+    "EXAMPLES:\n" +
+    "  sponsio eval traces/ --config sponsio.yaml --json\n" +
+    "  sponsio eval traces/ \"tool `transfer` at most 1 times\"\n" +
+    "  sponsio eval traces/ -c sponsio.yaml --baseline main.json --max-fpr-delta 0.01\n";
+function coerceEvent(raw) {
+    if (!raw || typeof raw !== "object")
+        return null;
+    const r = raw;
+    const tool = r.tool ?? r.action;
+    if (typeof tool !== "string")
+        return null;
+    return { tool, args: r.args ?? {} };
+}
+function loadEvents(path) {
+    const text = (0, node_fs_1.readFileSync)(path, "utf-8");
+    const trimmed = text.trimStart();
+    if (trimmed.startsWith("{")) {
+        const data = JSON.parse(text);
+        if ((0, otlp_1.isOtlpPayload)(data))
+            return (0, otlp_1.extractOtlpEvents)(data);
+        if (Array.isArray(data?.events))
+            return data.events.map(coerceEvent).filter(Boolean);
+        return [];
+    }
+    if (trimmed.startsWith("[")) {
+        const data = JSON.parse(text);
+        return data.map(coerceEvent).filter(Boolean);
+    }
+    const out = [];
+    for (const line of text.split(/\r?\n/)) {
+        if (!line.trim())
+            continue;
+        try {
+            const ev = coerceEvent(JSON.parse(line));
+            if (ev)
+                out.push(ev);
+        }
+        catch {
+            // skip malformed
+        }
+    }
+    return out;
+}
+function listCorpus(p) {
+    const abs = (0, node_path_1.resolve)(p);
+    const st = (0, node_fs_1.statSync)(abs);
+    if (st.isFile())
+        return [abs];
+    const out = [];
+    for (const f of (0, node_fs_1.readdirSync)(abs)) {
+        if (f.endsWith(".json") || f.endsWith(".jsonl"))
+            out.push((0, node_path_1.join)(abs, f));
+    }
+    return out;
+}
+function labelOf(file) {
+    const name = (0, node_path_1.basename)(file).toLowerCase();
+    if (name.startsWith("safe_") || name.startsWith("safe-"))
+        return "safe";
+    if (name.startsWith("unsafe_") || name.startsWith("unsafe-"))
+        return "unsafe";
+    return "other";
+}
+async function buildGuard(inline, configPath, agentId) {
+    const mod = await Promise.resolve().then(() => __importStar(require("@sponsio/sdk")));
+    const Sponsio = mod.Sponsio;
+    if (!Sponsio)
+        throw new Error("[eval] @sponsio/sdk does not export Sponsio");
+    const ctorOpts = { mode: "enforce", sessionLog: false };
+    if (configPath) {
+        const cfgAbs = (0, node_path_1.resolve)(configPath);
+        ctorOpts.config = cfgAbs;
+        if (agentId) {
+            ctorOpts.agentId = agentId;
+        }
+        else {
+            try {
+                const data = yaml.load((0, node_fs_1.readFileSync)(cfgAbs, "utf-8"));
+                const ids = data?.agents ? Object.keys(data.agents) : [];
+                if (ids.length === 1)
+                    ctorOpts.agentId = ids[0];
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+    else {
+        ctorOpts.agentId = "eval";
+        ctorOpts.contracts = inline;
+    }
+    return new Sponsio(ctorOpts);
+}
+function pct(n) {
+    return (n * 100).toFixed(2) + "%";
+}
+function diffPct(curr, prev) {
+    if (prev === undefined)
+        return "";
+    const d = curr - prev;
+    const sign = d >= 0 ? "+" : "";
+    return ` (${sign}${(d * 100).toFixed(2)}pp)`;
+}
+async function runEvalCli(argv) {
+    let tracePath;
+    let configPath;
+    let agentId;
+    let asJson = false;
+    let baselineFile;
+    let writeBaseline;
+    let maxFprDelta;
+    let maxFnrDelta;
+    const inline = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "-h" || a === "--help") {
+            process.stdout.write(HELP);
+            return;
+        }
+        if (a === "-c" || a === "--config") {
+            configPath = argv[++i];
+            continue;
+        }
+        if (a === "-a" || a === "--agent") {
+            agentId = argv[++i];
+            continue;
+        }
+        if (a === "--json") {
+            asJson = true;
+            continue;
+        }
+        if (a === "--baseline") {
+            baselineFile = argv[++i];
+            continue;
+        }
+        if (a === "--max-fpr-delta") {
+            maxFprDelta = parseFloat(argv[++i]);
+            continue;
+        }
+        if (a === "--max-fnr-delta") {
+            maxFnrDelta = parseFloat(argv[++i]);
+            continue;
+        }
+        if (a === "--write-baseline") {
+            writeBaseline = argv[++i];
+            continue;
+        }
+        if (a.startsWith("-")) {
+            process.stderr.write(`unknown flag: ${a}\n${HELP}`);
+            process.exit(2);
+        }
+        if (!tracePath) {
+            tracePath = a;
+        }
+        else {
+            inline.push(a);
+        }
+    }
+    if (!tracePath) {
+        process.stderr.write(`Error: trace path required\n\n${HELP}`);
+        process.exit(2);
+    }
+    if (configPath && inline.length > 0) {
+        process.stderr.write(`Error: cannot use both --config and positional contracts\n`);
+        process.exit(2);
+    }
+    if (!configPath && inline.length === 0) {
+        process.stderr.write(`Error: pass --config or positional contracts\n`);
+        process.exit(2);
+    }
+    const files = listCorpus(tracePath);
+    if (files.length === 0) {
+        process.stderr.write(`Error: no .json/.jsonl files in ${tracePath}\n`);
+        process.exit(1);
+    }
+    // Per-contract counters need a fresh guard per trace (state isolation).
+    const aggregate = new Map();
+    let safeN = 0, unsafeN = 0, otherN = 0;
+    let safeBlockedAny = 0; // false positives at trace level
+    let unsafeBlockedAny = 0; // true positives at trace level
+    for (const file of files) {
+        const label = labelOf(file);
+        if (label === "safe")
+            safeN++;
+        else if (label === "unsafe")
+            unsafeN++;
+        else
+            otherN++;
+        const guard = await buildGuard(inline, configPath, agentId);
+        if (aggregate.size === 0) {
+            for (const d of guard.contractDescs()) {
+                aggregate.set(d, { desc: d, tp: 0, fp: 0, fn: 0, tn: 0 });
+            }
+        }
+        const events = loadEvents(file);
+        const blocksByDesc = new Set();
+        for (const ev of events) {
+            const r = guard.guardBefore(ev.tool, ev.args ?? {});
+            if (r.blocked) {
+                for (const d of r.violatedDescs ?? r.detViolations?.map((v) => v.desc) ?? []) {
+                    blocksByDesc.add(d);
+                }
+            }
+        }
+        if (label === "safe") {
+            if (blocksByDesc.size > 0)
+                safeBlockedAny++;
+            for (const stat of aggregate.values()) {
+                if (blocksByDesc.has(stat.desc))
+                    stat.fp++;
+                else
+                    stat.tn++;
+            }
+        }
+        else if (label === "unsafe") {
+            if (blocksByDesc.size > 0)
+                unsafeBlockedAny++;
+            for (const stat of aggregate.values()) {
+                if (blocksByDesc.has(stat.desc))
+                    stat.tp++;
+                else
+                    stat.fn++;
+            }
+        }
+    }
+    const fpr = safeN > 0 ? safeBlockedAny / safeN : 0;
+    const fnr = unsafeN > 0 ? (unsafeN - unsafeBlockedAny) / unsafeN : 0;
+    const report = {
+        config: configPath ?? null,
+        contracts: aggregate.size,
+        totalTraces: files.length,
+        safeTraces: safeN,
+        unsafeTraces: unsafeN,
+        unlabeled: otherN,
+        fpr,
+        fnr,
+        perContract: Array.from(aggregate.values()),
+    };
+    // Baseline diff (optional).
+    let baseline;
+    if (baselineFile) {
+        if (!(0, node_fs_1.existsSync)((0, node_path_1.resolve)(baselineFile))) {
+            process.stderr.write(`Error: baseline ${baselineFile} not found\n`);
+            process.exit(1);
+        }
+        baseline = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.resolve)(baselineFile), "utf-8"));
+    }
+    if (asJson) {
+        process.stdout.write(JSON.stringify(report, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write(`Corpus:        ${files.length} traces (${safeN} safe, ${unsafeN} unsafe, ${otherN} unlabeled)\n`);
+        process.stdout.write(`Contracts:     ${report.contracts}\n`);
+        process.stdout.write(`Overall FPR:   ${pct(fpr)}${diffPct(fpr, baseline?.fpr)}\n`);
+        process.stdout.write(`Overall FNR:   ${pct(fnr)}${diffPct(fnr, baseline?.fnr)}\n\n`);
+        process.stdout.write(`Per-contract:\n`);
+        for (const s of report.perContract) {
+            const cFpr = s.fp + s.tn > 0 ? s.fp / (s.fp + s.tn) : 0;
+            const cFnr = s.tp + s.fn > 0 ? s.fn / (s.tp + s.fn) : 0;
+            process.stdout.write(`  ${s.desc.split("\n")[0]}\n` +
+                `    TP=${s.tp}  FP=${s.fp}  FN=${s.fn}  TN=${s.tn}` +
+                `   FPR=${pct(cFpr)}  FNR=${pct(cFnr)}\n`);
+        }
+    }
+    if (writeBaseline) {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.resolve)(writeBaseline), JSON.stringify(report, null, 2), "utf-8");
+        process.stderr.write(`✓ wrote baseline ${writeBaseline}\n`);
+    }
+    // CI gates.
+    let gateFail = false;
+    if (baseline && maxFprDelta !== undefined) {
+        const d = fpr - baseline.fpr;
+        if (d > maxFprDelta) {
+            process.stderr.write(`✗ FPR rose ${(d * 100).toFixed(2)}pp (limit ${maxFprDelta * 100}pp)\n`);
+            gateFail = true;
+        }
+    }
+    if (baseline && maxFnrDelta !== undefined) {
+        const d = fnr - baseline.fnr;
+        if (d > maxFnrDelta) {
+            process.stderr.write(`✗ FNR rose ${(d * 100).toFixed(2)}pp (limit ${maxFnrDelta * 100}pp)\n`);
+            gateFail = true;
+        }
+    }
+    if (gateFail)
+        process.exit(1);
+}
+//# sourceMappingURL=eval.js.map

package/dist/cli/eval.js.map

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

package/dist/cli/explain.d.ts

@@ -0,0 +1,2 @@
+export declare function runExplainCli(argv: string[]): Promise<void>;
+//# sourceMappingURL=explain.d.ts.map

package/dist/cli/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/cli/explain.ts"],"names":[],"mappings":"AA0JA,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoHjE"}