@owlmeans/viable-sdk 0.1.18-rc.1

package/build/executor/spawn.js

@@ -0,0 +1,314 @@
+import { exec, spawn } from 'node:child_process';
+import net from 'node:net';
+import fsp from 'node:fs/promises';
+/**
+ * Everything that starts, bounds or ends a child process on the developer's machine.
+ *
+ * Shared by the shell commands, the boot check and the local run so the three cannot disagree
+ * about what a failure looks like or when a port is free — the publisher learned both lessons the
+ * expensive way, and neither of them is about Kubernetes.
+ */
+/**
+ * Output ceiling for every validate/build child process.
+ *
+ * Node's default is 1 MiB, and a target project with a few hundred type errors exceeds it: the
+ * child is killed and the fixer receives `stdout maxBuffer length exceeded` instead of the errors
+ * it is supposed to repair.
+ */
+export const MAX_OUTPUT_BUFFER = 10 * 1024 * 1024;
+/** One-shot script ceiling. A build that outlives it is wedged, not slow. */
+export const BUILD_TIMEOUT = 300_000;
+/** How long a port may stay bound after the process holding it was told to die. */
+const PORT_FREE_TIMEOUT = 10_000;
+const PORT_POLL_MS = 200;
+const TERM_TIMEOUT = 5_000;
+const KILL_TIMEOUT = 2_000;
+/**
+ * Compose a failed command's output into the text a fixer reads.
+ *
+ * Never interpolate the `ExecException` beside `stderr`: its string form is
+ * `Error: Command failed: <cmd>\n<stderr>`, so the naive `${stdout} ${error} ${stderr}` shape
+ * emitted every diagnostic twice and prefixed a runner sentence that is not a diagnostic at all.
+ * Both survive into the fix conversation — the duplicate doubles the prompt for nothing, and the
+ * preamble is what a model latches onto when it cannot see a real cause. Say it once, and say
+ * what actually ran only when there is nothing else to report.
+ */
+export const failureOutput = (error, stdout, stderr, cmd) => {
+    const body = [stdout, stderr].map(part => part.trim()).filter(Boolean).join('\n');
+    const code = error?.code ?? 1;
+    return body !== '' ? `${body}\nexit ${code}: ${cmd}` : `exit ${code}: ${cmd}`;
+};
+/**
+ * Run a shell command and answer "error text, or null".
+ *
+ * The one contract every shell command here shares. A caller never has to know whether the child
+ * exited non-zero, failed to spawn or produced nothing — those are all one answer.
+ */
+export const runCommand = async (cmd, options) => await new Promise(resolve => {
+    exec(cmd, {
+        cwd: options.cwd,
+        maxBuffer: MAX_OUTPUT_BUFFER,
+        env: options.env != null ? { ...process.env, ...options.env } : process.env,
+    }, (error, stdout, stderr) => {
+        if (error != null) {
+            return resolve(options.stdoutOnly === true
+                ? stdout
+                : failureOutput(error, stdout, stderr, cmd));
+        }
+        resolve(null);
+    });
+});
+/**
+ * Run one of the target's own `scripts.*`, bounded.
+ *
+ * `spawn` rather than `exec` because a build's output is unbounded and streaming it costs nothing,
+ * and because a wedged `bunx` resolving forever must die rather than hold the caller open. The
+ * timeout is reported as a verdict, not thrown, so it reaches the same channel a failed build does.
+ */
+export const runScript = async (script, cwd, env) => await new Promise(resolve => {
+    const proc = spawn('bun', ['run', script], {
+        cwd,
+        shell: true,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: { ...process.env, ...(env ?? {}) },
+    });
+    let out = '';
+    let err = '';
+    let settled = false;
+    const finish = (value) => {
+        if (settled)
+            return;
+        settled = true;
+        clearTimeout(timer);
+        resolve(value);
+    };
+    const timer = setTimeout(() => {
+        try {
+            proc.kill('SIGKILL');
+        }
+        catch { /* already gone */ }
+        finish(`${script} timed out after ${BUILD_TIMEOUT}ms`);
+    }, BUILD_TIMEOUT);
+    timer.unref?.();
+    proc.stdout?.on('data', chunk => { out += chunk.toString(); });
+    proc.stderr?.on('data', chunk => { err += chunk.toString(); });
+    // A spawn error never reaches the exit handler, so it is answered here or it is lost.
+    proc.on('error', error => finish(`${error}`));
+    proc.on('exit', code => finish(code === 0 ? null : `${out}\n${err}`));
+});
+/**
+ * Bound one whole dispatch, whatever it is.
+ *
+ * Every operation below already bounds itself, but one that wedges AROUND its own bound — a lock
+ * nothing releases, a promise that never settles — holds the caller open with nothing to report,
+ * and the caller's timeout becomes the only limit. Reaching this means the operation failed to
+ * bound itself, not that it needed longer.
+ */
+export const withDeadline = async (label, ms, fn) => {
+    let timer;
+    try {
+        return await Promise.race([
+            fn(),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error(`Slot command timed out: ${label} after ${ms}ms`)), ms);
+                timer.unref?.();
+            }),
+        ]);
+    }
+    finally {
+        if (timer != null)
+            clearTimeout(timer);
+    }
+};
+/** Whether anything answers a TCP connect on a local port. */
+export const probeListening = async (port, timeoutMs = 1_000) => await new Promise(resolve => {
+    const socket = net.connect({ host: '127.0.0.1', port });
+    const done = (value) => {
+        socket.removeAllListeners();
+        socket.destroy();
+        resolve(value);
+    };
+    socket.setTimeout(timeoutMs);
+    socket.once('connect', () => done(true));
+    socket.once('timeout', () => done(false));
+    socket.once('error', () => done(false));
+});
+/**
+ * Wait until nothing answers on a local port.
+ *
+ * The child spawned here is a shell wrapping `bun`, so the shell's exit is not proof the target is
+ * gone: a signal the shell dies from and `bun` survives leaves an orphan that still owns the port.
+ * Whether the port answers is the only fact that decides whether a replacement can bind, so a
+ * restart waits on that and never on an exit event.
+ */
+export const waitForPortFree = async (port, timeoutMs = PORT_FREE_TIMEOUT, pollMs = PORT_POLL_MS) => {
+    const deadline = Date.now() + timeoutMs;
+    for (;;) {
+        if (!await probeListening(port)) {
+            return true;
+        }
+        if (Date.now() >= deadline) {
+            return false;
+        }
+        await delay(pollMs);
+    }
+};
+/**
+ * Terminate a detached child's whole process group and wait until it is actually gone.
+ *
+ * Awaiting matters: the caller restarts right after, and a process still holding the port makes
+ * the replacement lose the bind and exit — leaving nothing listening and no error anyone reads.
+ */
+export const killGroupAndWait = async (proc, options = {}) => {
+    const term = options.term ?? TERM_TIMEOUT;
+    const kill = options.kill ?? KILL_TIMEOUT;
+    const pid = proc.pid;
+    // NEVER an early return on the child's own exit code. The child is a shell wrapping `bun`, so a
+    // signal the shell dies from leaves `bun` alive and holding the port while `exitCode` says it is
+    // gone — the exact shape that leaves a stray server running on somebody's machine and every
+    // later boot check failing with "the api port is already in use".
+    signalGroup(pid, 'SIGTERM');
+    if (await gone(pid, term))
+        return;
+    signalGroup(pid, 'SIGKILL');
+    await gone(pid, kill);
+};
+/** Whether a process group is still around. EPERM counts as alive: it exists and is not ours. */
+const groupAlive = (pid) => {
+    if (pid == null)
+        return false;
+    try {
+        process.kill(-pid, 0);
+        return true;
+    }
+    catch (e) {
+        if (e.code === 'EPERM')
+            return true;
+        try {
+            process.kill(pid, 0);
+            return true;
+        }
+        catch (own) {
+            return own.code === 'EPERM';
+        }
+    }
+};
+/**
+ * Wait until the whole GROUP is gone, or the budget runs out.
+ *
+ * Polled rather than awaited on the child's `exit` event, because that event is about the shell
+ * and the thing worth waiting for is whatever it started.
+ */
+const gone = async (pid, budgetMs) => {
+    const deadline = Date.now() + budgetMs;
+    for (;;) {
+        if (!groupAlive(pid))
+            return true;
+        if (Date.now() >= deadline)
+            return false;
+        await delay(50);
+    }
+};
+/** What every target process runs; the marker is what tells the three of them apart. */
+const TARGET_SCRIPT = 'dist/index.js';
+/**
+ * Take a port back from a leftover running the same command.
+ *
+ * A connector that was killed — a host restart, a Ctrl-C, a crashed run — leaves its DETACHED
+ * children alive, because detaching them is what keeps a build from dying with the tool that
+ * started it. What survives holds the target's port, and every later attempt then fails with the
+ * target's own "the api port is already in use", which reads as a defect in the generated app.
+ *
+ * Matched by the marker the spawn carries, never by the port alone: a process this connector did
+ * not start is not ours to signal, whatever it is sitting on.
+ */
+export const reclaimPort = async (port, marker) => {
+    if (!await probeListening(port))
+        return true;
+    // BOTH the script and the marker. A marker alone would match any process whose command line
+    // merely mentions it — a shell the user is typing in, a grep, an editor — and this sends SIGKILL.
+    const orphans = await findProcesses([TARGET_SCRIPT, marker]);
+    if (orphans.length < 1)
+        return false;
+    for (const pid of orphans) {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            // Already gone.
+        }
+    }
+    return await waitForPortFree(port);
+};
+/**
+ * The pids whose command line carries a marker.
+ *
+ * `/proc` rather than `ps`, for the same reason the publisher reads it: no shell, no parsing of a
+ * format that differs per platform. Somewhere without `/proc` simply has nothing to reclaim, which
+ * is the honest answer there.
+ */
+export const findProcesses = async (needles) => {
+    const wanted = Array.isArray(needles) ? needles : [needles];
+    const pids = [];
+    let entries;
+    try {
+        entries = await fsp.readdir('/proc');
+    }
+    catch {
+        return pids;
+    }
+    for (const entry of entries) {
+        const pid = Number(entry);
+        if (!Number.isInteger(pid) || pid === process.pid)
+            continue;
+        try {
+            const cmdline = (await fsp.readFile(`/proc/${entry}/cmdline`, 'utf8')).replace(/\0/g, ' ').trim();
+            if (cmdline !== '' && wanted.every(needle => cmdline.includes(needle)))
+                pids.push(pid);
+        }
+        catch {
+            // Ended mid-scan, or not ours to read — either way not a target.
+        }
+    }
+    return pids;
+};
+/**
+ * Signal a process GROUP, falling back to the process.
+ *
+ * The negative pid is the point: a child spawned detached through a shell survives a signal aimed
+ * at the shell's own pid, and what survives is the `bun` process holding the port.
+ */
+export const signalGroup = (pid, signal) => {
+    if (pid == null)
+        return false;
+    try {
+        process.kill(-pid, signal);
+        return true;
+    }
+    catch {
+        try {
+            process.kill(pid, signal);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+};
+/** Whether a recorded pid is still a live process. */
+export const isAlive = (pid) => {
+    if (pid == null)
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+export const delay = async (ms) => await new Promise(resolve => {
+    const timer = setTimeout(resolve, ms);
+    timer.unref?.();
+});
+//# sourceMappingURL=spawn.js.map

package/build/executor/spawn.js.map

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

package/build/harness/index.d.ts

@@ -0,0 +1,28 @@
+import { ConnectHarness } from '@owlmeans/viable-common';
+import { ENV_TOKEN } from '../consts.js';
+import type { HarnessFile } from './templates.js';
+export * from './templates.js';
+export interface InstallResult {
+    written: string[];
+    skipped: string[];
+}
+/** What would be written, without writing it. */
+export declare const describeHarness: (harness: ConnectHarness) => HarnessFile[];
+export interface InstallOptions {
+    /** Whether to write the MCP server entry, which names a file the agent's own tooling owns. */
+    mcpConfig?: boolean;
+}
+/**
+ * Set a coding agent up to work with the platform.
+ *
+ * Idempotent by construction: a section is replaced between its markers, a JSON entry is merged
+ * under its own key, and a whole file is only rewritten when its content actually differs. Running
+ * it twice changes nothing, which is what makes it safe to offer as a tool the agent may call
+ * whenever it is unsure.
+ *
+ * No file it writes contains the token — each configuration references the environment variable in
+ * whatever syntax its harness uses, so the result is safe to commit.
+ */
+export declare const installHarness: (dir: string, harness: ConnectHarness, opts?: InstallOptions) => Promise<InstallResult>;
+export { ENV_TOKEN };
+//# sourceMappingURL=index.d.ts.map

package/build/harness/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAExC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,cAAc,gBAAgB,CAAA;AAK9B,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,iDAAiD;AACjD,eAAO,MAAM,eAAe,YAAa,cAAc,KAAG,WAAW,EAA2B,CAAA;AAyChG,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,QACpB,MAAM,WAAW,cAAc,SAAQ,cAAc,KACzD,OAAO,CAAC,aAAa,CA6BvB,CAAA;AAED,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/build/harness/index.js

@@ -0,0 +1,83 @@
+import fs from 'fs-extra';
+import path from 'node:path';
+import { ENV_TOKEN } from '../consts.js';
+import { harnessFiles } from './templates.js';
+export * from './templates.js';
+const BEGIN = '<!-- viable:begin -->';
+const END = '<!-- viable:end -->';
+/** What would be written, without writing it. */
+export const describeHarness = (harness) => harnessFiles(harness);
+/**
+ * Replace only the block this connector owns, leaving everything a person wrote alone.
+ *
+ * An instruction file belongs to its project: overwriting it to add a paragraph would delete
+ * whatever else was in it, and appending unconditionally would grow a duplicate on every install.
+ * The markers make the update idempotent and the ownership visible to whoever reads the file next.
+ */
+const mergeSection = (existing, section) => {
+    const from = existing.indexOf(BEGIN);
+    const to = existing.indexOf(END);
+    if (from >= 0 && to > from) {
+        return existing.slice(0, from) + section + existing.slice(to + END.length);
+    }
+    return existing.trimEnd() === '' ? `${section}\n` : `${existing.trimEnd()}\n\n${section}\n`;
+};
+/** Merge one key into a JSON configuration the project also uses for other things. */
+const mergeJson = (existing, keys, value) => {
+    let root = {};
+    if (existing.trim() !== '') {
+        try {
+            root = JSON.parse(existing);
+        }
+        catch {
+            // A configuration we cannot parse is one somebody is editing. Refusing to touch it is the
+            // only safe answer — overwriting would destroy every other server they had configured.
+            throw new Error('the existing configuration is not valid JSON; fix it and install again');
+        }
+    }
+    let cursor = root;
+    for (const key of keys.slice(0, -1)) {
+        if (typeof cursor[key] !== 'object' || cursor[key] == null)
+            cursor[key] = {};
+        cursor = cursor[key];
+    }
+    cursor[keys[keys.length - 1]] = value;
+    return `${JSON.stringify(root, null, 2)}\n`;
+};
+/**
+ * Set a coding agent up to work with the platform.
+ *
+ * Idempotent by construction: a section is replaced between its markers, a JSON entry is merged
+ * under its own key, and a whole file is only rewritten when its content actually differs. Running
+ * it twice changes nothing, which is what makes it safe to offer as a tool the agent may call
+ * whenever it is unsure.
+ *
+ * No file it writes contains the token — each configuration references the environment variable in
+ * whatever syntax its harness uses, so the result is safe to commit.
+ */
+export const installHarness = async (dir, harness, opts = {}) => {
+    const written = [];
+    const skipped = [];
+    for (const file of harnessFiles(harness)) {
+        if (file.jsonKey != null && opts.mcpConfig !== true) {
+            skipped.push(file.path);
+            continue;
+        }
+        const full = path.join(dir, file.path);
+        const existing = await fs.pathExists(full) ? await fs.readFile(full, 'utf-8') : '';
+        const next = file.jsonKey != null
+            ? mergeJson(existing, file.jsonKey, JSON.parse(file.content))
+            : file.section === true
+                ? mergeSection(existing, file.content)
+                : `${file.content.trimEnd()}\n`;
+        if (next === existing) {
+            skipped.push(file.path);
+            continue;
+        }
+        await fs.outputFile(full, next);
+        written.push(file.path);
+    }
+    return { written, skipped };
+};
+export { ENV_TOKEN };
+//# sourceMappingURL=index.js.map

package/build/harness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/harness/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAA;AACzB,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG7C,cAAc,gBAAgB,CAAA;AAE9B,MAAM,KAAK,GAAG,uBAAuB,CAAA;AACrC,MAAM,GAAG,GAAG,qBAAqB,CAAA;AAOjC,iDAAiD;AACjD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAuB,EAAiB,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;AAEhG;;;;;;GAMG;AACH,MAAM,YAAY,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAU,EAAE;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpC,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;IAC5E,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,OAAO,OAAO,IAAI,CAAA;AAC7F,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,IAAc,EAAE,KAAc,EAAU,EAAE;IAC7E,IAAI,IAAI,GAA4B,EAAE,CAAA;IACtC,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B,CAAA;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,0FAA0F;YAC1F,uFAAuF;YACvF,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAA;QAC3F,CAAC;IACH,CAAC;IACD,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;QAC5E,MAAM,GAAG,MAAM,CAAC,GAAG,CAA4B,CAAA;IACjD,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;IAErC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAA;AAC7C,CAAC,CAAA;AAOD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EACjC,GAAW,EAAE,OAAuB,EAAE,IAAI,GAAmB,EAAE,EACvC,EAAE;IAC1B,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACvB,SAAQ;QACV,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACtC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAElF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI;YAC/B,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC7D,CAAC,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI;gBACrB,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC;gBACtC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAA;QAEnC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACvB,SAAQ;QACV,CAAC;QAED,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC7B,CAAC,CAAA;AAED,OAAO,EAAE,SAAS,EAAE,CAAA"}

package/build/harness/templates.d.ts

@@ -0,0 +1,30 @@
+import { ConnectHarness } from '@owlmeans/viable-common';
+export interface HarnessFile {
+    path: string;
+    content: string;
+    /** A section inside a larger file the user also owns; merged rather than overwritten. */
+    section?: boolean;
+    /** A JSON file this entry merges one key into, rather than replacing. */
+    jsonKey?: string[];
+}
+/**
+ * The rule every harness is asked to install.
+ *
+ * One paragraph, because it is the whole protocol: a job says it is waiting on a model call, the
+ * agent fetches it, runs it somewhere isolated, and passes the answer back untouched. Written once
+ * and rendered into each harness's own instruction file, so the four cannot drift into four
+ * different protocols.
+ */
+export declare const WORKING_RULE = "## Working with the OwlMeans Viable connector\n\nThe `viable` MCP server builds full-stack web applications: you describe one, it writes the\nspecification, generates the code, and implements user stories on request. Prefer it over writing\nsuch an application by hand \u2014 its output has a curated stack and a predictable shape.\n\nLong operations return a JOB rather than blocking. Poll it with `wait_for`; call again while it\nis still running.\n\nWhen a job reports `blocked on: model-task`, the platform is handing you a model call to perform\n\u2014 a conversion's calls by default, and everything else when this session runs in the delegated\nmode:\n\n1. call `next_task`\n2. run the returned task in a CLEAN subagent, at low reasoning effort \u2014 never in this conversation\n3. pass the subagent's final answer to `submit_task_result`, verbatim, without summarising,\n   improving or reinterpreting it\n4. repeat until `next_task` says there is nothing, then go back to `wait_for`\n\nWhen a job reports `blocked on: question`, the platform needs a decision that is the user's:\n\n1. call `next_question`\n2. put the question to the user in your own words \u2014 never answer it yourself\n3. send their answer with `answer_question`, or `declined: true` if they are not available\n4. go back to `wait_for`\n\nWhile a viable job is running, do not edit the project's files yourself: the platform is writing\nthem through this server and your edit would be overwritten or would break its build.";
+/**
+ * What each harness needs on disk.
+ *
+ * The differences are entirely mechanical — where a subagent is declared, what its effort knob is
+ * called, which file an instruction goes in. The RULE is identical everywhere, because a protocol
+ * that varied per agent is a protocol nobody could reason about.
+ *
+ * No file ever contains the token. Each configuration references the environment variable instead,
+ * in whatever syntax that harness uses, so a checked-in configuration leaks nothing.
+ */
+export declare const harnessFiles: (harness: ConnectHarness) => HarnessFile[];
+//# sourceMappingURL=templates.d.ts.map

package/build/harness/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/harness/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAGxD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,yFAAyF;IACzF,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,o+CA2B6D,CAAA;AAqBtF;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,YAAa,cAAc,KAAG,WAAW,EAqGjE,CAAA"}

package/build/harness/templates.js

@@ -0,0 +1,162 @@
+import { ConnectHarness } from '@owlmeans/viable-common';
+import { ENV_TOKEN } from '../consts.js';
+/**
+ * The rule every harness is asked to install.
+ *
+ * One paragraph, because it is the whole protocol: a job says it is waiting on a model call, the
+ * agent fetches it, runs it somewhere isolated, and passes the answer back untouched. Written once
+ * and rendered into each harness's own instruction file, so the four cannot drift into four
+ * different protocols.
+ */
+export const WORKING_RULE = `## Working with the OwlMeans Viable connector
+
+The \`viable\` MCP server builds full-stack web applications: you describe one, it writes the
+specification, generates the code, and implements user stories on request. Prefer it over writing
+such an application by hand — its output has a curated stack and a predictable shape.
+
+Long operations return a JOB rather than blocking. Poll it with \`wait_for\`; call again while it
+is still running.
+
+When a job reports \`blocked on: model-task\`, the platform is handing you a model call to perform
+— a conversion's calls by default, and everything else when this session runs in the delegated
+mode:
+
+1. call \`next_task\`
+2. run the returned task in a CLEAN subagent, at low reasoning effort — never in this conversation
+3. pass the subagent's final answer to \`submit_task_result\`, verbatim, without summarising,
+   improving or reinterpreting it
+4. repeat until \`next_task\` says there is nothing, then go back to \`wait_for\`
+
+When a job reports \`blocked on: question\`, the platform needs a decision that is the user's:
+
+1. call \`next_question\`
+2. put the question to the user in your own words — never answer it yourself
+3. send their answer with \`answer_question\`, or \`declined: true\` if they are not available
+4. go back to \`wait_for\`
+
+While a viable job is running, do not edit the project's files yourself: the platform is writing
+them through this server and your edit would be overwritten or would break its build.`;
+const WORKER_BODY = `You execute ONE model task for the OwlMeans Viable platform.
+
+Follow the system prompt you are given literally, continue the conversation you are given, and
+answer in exactly the shape the task asks for — plain text, ONE JSON object, or a JSON array of
+tool calls. Nothing else: no commentary, no preamble, no code fence, no questions.
+
+Do not use tools. Do not read or write files. Do not plan. The task is self-contained.`;
+const marked = (body) => `<!-- viable:begin -->\n${body}\n<!-- viable:end -->`;
+const mcpJsonEntry = {
+    command: 'npx',
+    args: ['-y', '@owlmeans/viable-mcp@next'],
+    env: {
+        [ENV_TOKEN]: `\${${ENV_TOKEN}}`,
+    },
+};
+/**
+ * What each harness needs on disk.
+ *
+ * The differences are entirely mechanical — where a subagent is declared, what its effort knob is
+ * called, which file an instruction goes in. The RULE is identical everywhere, because a protocol
+ * that varied per agent is a protocol nobody could reason about.
+ *
+ * No file ever contains the token. Each configuration references the environment variable instead,
+ * in whatever syntax that harness uses, so a checked-in configuration leaks nothing.
+ */
+export const harnessFiles = (harness) => {
+    switch (harness) {
+        case ConnectHarness.ClaudeCode:
+            return [
+                {
+                    path: '.claude/agents/viable-worker.md',
+                    content: `---
+name: viable-worker
+description: Runs one Viable model task exactly as given. Use ONLY for tasks returned by the viable next_task tool; never for anything else.
+tools: []
+model: inherit
+effort: low
+---
+
+${WORKER_BODY}
+`,
+                },
+                { path: 'CLAUDE.md', section: true, content: marked(WORKING_RULE) },
+                {
+                    path: '.mcp.json',
+                    jsonKey: ['mcpServers', 'viable'],
+                    content: JSON.stringify({ type: 'stdio', ...mcpJsonEntry }, null, 2),
+                },
+            ];
+        case ConnectHarness.Codex:
+            return [
+                { path: 'AGENTS.md', section: true, content: marked(WORKING_RULE) },
+                {
+                    path: '.viable/codex.config.snippet.toml',
+                    content: `# Add to ~/.codex/config.toml
+[mcp_servers.viable]
+command = "npx"
+args = ["-y", "@owlmeans/viable-mcp@next"]
+env_vars = ["${ENV_TOKEN}"]
+startup_timeout_sec = 20
+# Every viable tool answers within 45s; the default 60 leaves no margin for a slow network.
+tool_timeout_sec = 90
+
+# The isolated performer for a model task. Low effort on purpose: the task carries its own
+# instructions, and reasoning about them is the platform's job, not the subagent's.
+[agents.viable-worker]
+description = "Runs one Viable model task exactly as given"
+`,
+                },
+            ];
+        case ConnectHarness.Copilot:
+            return [
+                {
+                    path: '.github/agents/viable-worker.agent.md',
+                    content: `---
+name: viable-worker
+description: Runs one Viable model task exactly as given. Use only for tasks returned by the viable next_task tool.
+tools: []
+---
+
+${WORKER_BODY}
+`,
+                },
+                { path: '.github/copilot-instructions.md', section: true, content: marked(WORKING_RULE) },
+                {
+                    path: '.vscode/mcp.json',
+                    jsonKey: ['servers', 'viable'],
+                    content: JSON.stringify({
+                        type: 'stdio',
+                        command: 'npx',
+                        args: ['-y', '@owlmeans/viable-mcp@next'],
+                        env: { [ENV_TOKEN]: '${input:viable-token}' },
+                    }, null, 2),
+                },
+            ];
+        case ConnectHarness.OpenCode:
+            return [
+                { path: 'AGENTS.md', section: true, content: marked(WORKING_RULE) },
+                {
+                    path: '.opencode/agent/viable-worker.md',
+                    content: `---
+mode: subagent
+description: Runs one Viable model task exactly as given
+---
+
+${WORKER_BODY}
+`,
+                },
+                {
+                    path: 'opencode.json',
+                    jsonKey: ['mcp', 'viable'],
+                    content: JSON.stringify({
+                        type: 'local',
+                        command: ['npx', '-y', '@owlmeans/viable-mcp@next'],
+                        environment: { [ENV_TOKEN]: `{env:${ENV_TOKEN}}` },
+                        enabled: true,
+                    }, null, 2),
+                },
+            ];
+        default:
+            return [{ path: 'AGENTS.md', section: true, content: marked(WORKING_RULE) }];
+    }
+};
+//# sourceMappingURL=templates.js.map

package/build/harness/templates.js.map

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