@corenel/harness 0.3.2 → 0.4.0

package/dist/tools/procs.js

@@ -0,0 +1,281 @@
+const DEFAULT_SETTLE_MS = 10000;
+const MIN_SETTLE_MS = 100;
+const MAX_SETTLE_MS = 120000;
+/** How many processes THIS factory will let the agent have running at once,
+ * counted within the daemon's own MAX_RUNNING=8. Deliberately smaller than the
+ * daemon's cap: the operator may want to run their own dev server, build watch,
+ * and log tail alongside whatever the agent starts, and an agent that can eat
+ * every slot locks them out of their own dock. This protects the OPERATOR, not
+ * the agent — it is not a courtesy limit the agent could reasonably ask to
+ * raise. */
+const DEFAULT_AGENT_BUDGET = 3;
+/** Every process this file starts is labelled with this marker (plus the
+ * session, when known) so a listing can tell "the agent started this" from "a
+ * human started this" from ProcInfo.label alone — durable across reloads and
+ * reconnects, because the label lives on the daemon-owned ProcInfo, not in this
+ * factory's own memory. */
+const AGENT_TAG = 'agent';
+function agentLabel(session, userLabel) {
+    const tag = session ? `${AGENT_TAG}:${session}` : AGENT_TAG;
+    return userLabel ? `${userLabel} [${tag}]` : `[${tag}]`;
+}
+/** True if a ProcInfo's label carries this file's agent marker — used to count
+ * agent-started processes from the daemon's OWN table (procs.list()), not from
+ * a Set this factory keeps in memory, so the budget holds even across a reload
+ * that drops this factory and rebuilds it. */
+function isAgentStarted(info) {
+    return /\[agent(:[^\]]*)?\]/.test(info.label ?? '');
+}
+function str(args, key) {
+    const v = args[key];
+    return typeof v === 'string' && v.length ? v : undefined;
+}
+function clamp(n, min, max) {
+    if (!Number.isFinite(n))
+        return min;
+    return Math.min(Math.max(n, min), max);
+}
+/** Beyond this many characters, `renderTail`'s output is truncated -- same
+ * budget and reasoning as shellTool's MAX_OUTPUT (packages/cli/src/shellTool.ts):
+ * the retention ring this reads from is bounded at up to 200_000 chars
+ * (packages/sidecar/src/procs.ts / packages/cli/src/sidecarProcs.ts), which is
+ * still large enough for one `proc_start` result to blow the model's context
+ * window on its own. `corenel run`'s tool context wires no `recall`, so
+ * offload cannot rescue this the way it can a `tool-result` that goes through
+ * compression -- the cap has to be applied here. */
+const RENDER_TAIL_MAX = 30000;
+/** Render the buffered tail for a process. `truncated` must show up as WORDS —
+ * a tail that looks complete when it is not is the failure that matters, so
+ * this is never left to a caller to notice on its own. Keeps the LAST
+ * RENDER_TAIL_MAX characters (not the first): for a process still starting up,
+ * the most recent output is the one that says whether it's ready. */
+function renderTail(procs, procId) {
+    const { chunks, truncated } = procs.backlog(procId, 0);
+    const body = chunks.map((c) => (c.stream === 'err' ? `[stderr] ${c.text}` : c.text)).join('');
+    const capped = body.length > RENDER_TAIL_MAX;
+    const shown = capped ? body.slice(body.length - RENDER_TAIL_MAX) : body;
+    const notes = [];
+    if (truncated)
+        notes.push('[some earlier output was dropped from the buffer and is not shown here]');
+    if (capped) {
+        notes.push(`[showing only the last ${RENDER_TAIL_MAX} of ${body.length} characters -- earlier output in ` +
+            'this result was cut to avoid blowing the context window]');
+    }
+    const note = notes.length ? `\n${notes.join('\n')}` : '';
+    return (shown ? `Output so far:\n${shown}` : 'No output yet.') + note;
+}
+function describeInfo(info) {
+    return `${info.procId} (pid ${info.pid ?? 'unknown'}): ${info.command}${info.label ? ` [${info.label}]` : ''}`;
+}
+/** Race the three ways `proc_start` can resolve. Whichever happens first wins;
+ * the other two paths are torn down (unsubscribed / timer cleared) so only one
+ * result is ever produced. */
+function watchStart(procs, procId, waitFor, settleMs, onChunk) {
+    return new Promise((resolve) => {
+        let settled = false;
+        let lastSeenSeq = 0;
+        let buffer = '';
+        const finish = (outcome) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            unsub();
+            resolve(outcome);
+        };
+        const handleChunk = (c) => {
+            if (c.seq <= lastSeenSeq)
+                return; // already seen (backlog catch-up vs. live)
+            lastSeenSeq = c.seq;
+            // Check settled BEFORE streaming: once this call has resolved, nothing
+            // reads ctx.stream for it anymore, so a chunk delivered afterwards
+            // (synchronous backlog catch-up can call finish() partway through, per
+            // the caller's own comment above) must not be pushed at all, not pushed
+            // and then ignored for wait_for matching.
+            if (settled)
+                return;
+            onChunk(c);
+            if (!waitFor)
+                return;
+            buffer += c.text;
+            if (buffer.includes(waitFor)) {
+                const info = procs.get(procId);
+                if (info)
+                    finish({ kind: 'matched', info });
+            }
+        };
+        // `timer` and `unsub` must both be assigned BEFORE anything that can call
+        // `finish` synchronously (the backlog catch-up below can: a command that
+        // fails instantly, or prints its wait_for text, before this promise's
+        // caller ever gets control back) — finish() reads both.
+        const timer = setTimeout(() => {
+            const info = procs.get(procId);
+            if (info)
+                finish({ kind: 'settled', info });
+        }, settleMs);
+        const unsub = procs.subscribe((ev) => {
+            if (ev.procId !== procId)
+                return;
+            if (ev.kind === 'out')
+                handleChunk(ev.chunk);
+            else
+                finish({ kind: 'exited', info: ev.info });
+        });
+        // Catch up on anything already buffered/settled BEFORE we subscribed — the
+        // daemon's spawn() has an await in it (root confinement), so output (or
+        // even exit, for a command that fails instantly) can land before this
+        // function's caller ever gets control back.
+        for (const c of procs.backlog(procId, 0).chunks)
+            handleChunk(c);
+        if (!settled) {
+            const cur = procs.get(procId);
+            if (cur && !cur.running)
+                finish({ kind: 'exited', info: cur });
+        }
+    });
+}
+/** Build the proc_start / proc_stop / proc_list tools over a live SidecarProcs.
+ * `procs` is expected to be a real, already-constructed process table (node
+ * child_process-backed in production, a fake in tests) — this file never
+ * constructs one itself. */
+export function procTools(procs, opts = {}) {
+    const budget = opts.agentBudget ?? DEFAULT_AGENT_BUDGET;
+    const agentRunningCount = () => procs.list().filter((p) => p.running && isAgentStarted(p)).length;
+    const procStart = {
+        name: 'proc_start',
+        means: 'start a long-running command (a dev server, a watcher, a build) and watch its output',
+        description: 'Start a long-lived command (e.g. "npm run start") and watch it come up. Unlike a one-shot ' +
+            'shell exec, this does not wait for the command to finish — it resolves once EITHER wait_for ' +
+            'matches a substring of the output, OR settle_ms elapses with the process still running, OR the ' +
+            'process exits early. The result text always says explicitly which of those happened and whether ' +
+            'the process is still running. The process keeps running (and its output keeps being pushed live) ' +
+            'after this call resolves; use proc_list to see it again and proc_stop to end it.',
+        parameters: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'the shell command line to run' },
+                cwd: { type: 'string', description: 'working directory relative to the chosen root (default ".")' },
+                root: { type: 'string', description: 'which pre-approved root to resolve cwd against' },
+                label: { type: 'string', description: 'a short human-readable label for this process' },
+                wait_for: {
+                    type: 'string',
+                    description: 'a plain SUBSTRING (never a regex) to watch for in the combined output, e.g. "Local: http://". ' +
+                        'When it appears, the call resolves immediately instead of waiting out settle_ms.',
+                },
+                settle_ms: {
+                    type: 'number',
+                    description: `how long to wait, in ms, before resolving anyway if wait_for never matches and the process hasn't exited (default ${DEFAULT_SETTLE_MS}, max ${MAX_SETTLE_MS})`,
+                },
+            },
+            required: ['command'],
+        },
+        namespace: 'shell',
+        mutates: true,
+        permission: 'ask',
+        async run(args, ctx) {
+            const command = str(args, 'command')?.trim();
+            if (!command)
+                return 'Error: no command given';
+            const waitFor = str(args, 'wait_for');
+            const settleMs = clamp(Number(args.settle_ms) || DEFAULT_SETTLE_MS, MIN_SETTLE_MS, MAX_SETTLE_MS);
+            const running = agentRunningCount();
+            if (running >= budget) {
+                return (`Error: refusing to start another process — this agent already has ${running} of its ` +
+                    `${budget} allowed concurrent processes running. Stop one with proc_stop first, or ask the ` +
+                    'operator to start it themselves.');
+            }
+            const cwd = str(args, 'cwd');
+            const root = str(args, 'root');
+            let info;
+            try {
+                info = await procs.spawn({
+                    command,
+                    ...(cwd ? { cwd } : {}),
+                    ...(root ? { root } : {}),
+                    label: agentLabel(opts.session, str(args, 'label')),
+                });
+            }
+            catch (e) {
+                return `Error: could not start the process: ${e instanceof Error ? e.message : String(e)}`;
+            }
+            const outcome = await watchStart(procs, info.procId, waitFor, settleMs, (c) => ctx.stream?.(c.text));
+            const tail = renderTail(procs, info.procId);
+            if (outcome.kind === 'matched') {
+                return (`Started ${describeInfo(outcome.info)}\n` +
+                    `STILL RUNNING — matched wait_for ${JSON.stringify(waitFor)} in its output.\n\n${tail}`);
+            }
+            if (outcome.kind === 'settled') {
+                const waitNote = waitFor ? ` (wait_for ${JSON.stringify(waitFor)} has NOT appeared yet)` : '';
+                return (`Started ${describeInfo(outcome.info)}\n` +
+                    `STILL RUNNING after ${settleMs}ms with no exit${waitNote}.\n\n${tail}`);
+            }
+            // outcome.kind === 'exited'
+            const { info: endInfo } = outcome;
+            const status = `exit code ${endInfo.exitCode ?? 'unknown'}${endInfo.signal ? ` (signal ${endInfo.signal})` : ''}`;
+            return (`Started ${describeInfo(endInfo)}\n` +
+                `ALREADY EXITED before it finished starting — it is NOT running. ${status}.\n\n${tail}`);
+        },
+    };
+    const procStop = {
+        name: 'proc_stop',
+        means: 'stop a process this agent (or the operator) started',
+        description: 'Stop a running process by its proc_id (from proc_start or proc_list). Idempotent — stopping an ' +
+            'already-stopped or unknown process is reported, not treated as an error.',
+        parameters: {
+            type: 'object',
+            properties: { proc_id: { type: 'string', description: 'the procId to stop' } },
+            required: ['proc_id'],
+        },
+        namespace: 'shell',
+        mutates: true,
+        permission: 'ask',
+        async run(args) {
+            const procId = str(args, 'proc_id');
+            if (!procId)
+                return 'Error: no proc_id given';
+            const before = procs.get(procId);
+            if (!before)
+                return `${procId}: no such process (it may already have been evicted after exiting).`;
+            if (!before.running) {
+                const status = `exit code ${before.exitCode ?? 'unknown'}${before.signal ? ` (signal ${before.signal})` : ''}`;
+                return `${describeInfo(before)} was already stopped (${status}).`;
+            }
+            try {
+                procs.kill(procId);
+            }
+            catch (e) {
+                return `Error: could not stop ${procId}: ${e instanceof Error ? e.message : String(e)}`;
+            }
+            return `Stopping ${describeInfo(before)} (SIGTERM sent; it will be force-killed if it doesn't exit).`;
+        },
+    };
+    const procList = {
+        name: 'proc_list',
+        means: 'see every process running or recently run on this machine',
+        description: 'List the processes visible through this connection, running or recently exited — including ones ' +
+            'started before this conversation, or in an earlier turn whose proc_id has since fallen out of ' +
+            'context. A process started elsewhere (by the operator, or another client) AFTER this connection ' +
+            'was established may not appear here until it reconnects — if an expected process (e.g. a dev ' +
+            'server you did not start) is missing, that does not mean it is not running; ask before starting ' +
+            'a second one on the same port. Each entry says whether it was started by an agent or by the ' +
+            'operator directly.',
+        parameters: { type: 'object', properties: {} },
+        namespace: 'sidecar',
+        async run() {
+            const all = procs.list();
+            if (!all.length)
+                return 'No processes.';
+            return all
+                .map((p) => {
+                const who = isAgentStarted(p) ? 'agent-started' : 'operator-started';
+                const state = p.running
+                    ? 'running'
+                    : `exited (code ${p.exitCode ?? 'unknown'}${p.signal ? `, signal ${p.signal}` : ''})`;
+                return `${describeInfo(p)} — ${who}, ${state}`;
+            })
+                .join('\n');
+        },
+    };
+    return [procStart, procStop, procList];
+}
+//# sourceMappingURL=procs.js.map

package/dist/tools/procs.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@corenel/harness",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "type": "module",
-  "description": "Corenel — host-agnostic agent harness (kernel). Consumed as source; the app resolves it via the `corenel` path alias, node consumers via this workspace package + the exports map below. The app never hits these exports (the alias intercepts first), so the .ts-only wildcard is safe — node only ever imports the clean .ts kernel subpaths (e.g. corenel/sidecar/server), never the coupled .tsx UI.",
+  "description": "Corenel — host-agnostic agent harness (kernel). The app resolves it via the `corenel` path alias (bypasses these exports entirely); vitest aliases it to source too. Everything else — node consumers like @corenel/cli, @corenel/term, @corenel/sidecar — resolves it through this workspace package via the exports map below, which points at dist/ unconditionally (not just at publish) so in-repo and published resolution are identical: a bundle that treats @corenel/harness as external (see packages/term/build.mjs) must see the SAME module instance node sees when it later resolves this package at runtime, and plain node cannot execute the raw .ts sources at all. Run `pnpm build` here (or let a dependent's prebuild do it) before relying on this package outside the app/vitest. NOTE: @xyflow/react and dagre are NOT dependencies here at all — this package has no .tsx files and imports neither. `react` IS a real (small) runtime dependency: `todos.ts` uses `useSyncExternalStore`. It is declared below as an OPTIONAL peer, not a hard dependency, so node-only consumers (cli/term/sidecar) aren't forced to install react; node consumers hoist it today only because something else in the tree happens to pull it in. Do not add @xyflow/react or dagre as dependencies/peers without testing a packed install end to end — an earlier attempt at that (before this package had any .tsx files) failed npm's peer resolution with ERESOLVE.",
   "exports": {
     "./acp": {
       "types": "./dist/acp/index.d.ts",
@@ -28,12 +28,18 @@
   "dependencies": {
     "openai": "^4.77.0",
     "yaml": "^2.8.3",
-    "@corenel/protocol": "0.3.2"
+    "@corenel/protocol": "0.4.0"
   },
   "peerDependencies": {
-    "@xyflow/react": "^12.11.0",
-    "dagre": "^0.8.5",
-    "react": "^18.3.1"
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.13"
   },
   "publishConfig": {
     "access": "public"
@@ -42,6 +48,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json"
+    "prebuild": "pnpm --filter @corenel/protocol build",
+    "build": "node build.mjs"
   }
 }