omniagent 0.1.6 → 0.1.8

package/dist/pty-CZBSAJzE.js

@@ -0,0 +1,362 @@
+import { constants } from "node:fs";
+import { access, chmod } from "node:fs/promises";
+import { createRequire } from "node:module";
+import os from "node:os";
+import path from "node:path";
+import headless from "@xterm/headless";
+import pty from "node-pty";
+const { Terminal } = headless;
+const require$1 = createRequire(import.meta.url);
+class PtyScenarioError extends Error {
+  command;
+  args;
+  timedOut;
+  raw;
+  screen;
+  snapshots;
+  debug;
+  constructor(message, options) {
+    super(message);
+    this.name = "PtyScenarioError";
+    this.command = options.command;
+    this.args = options.args;
+    this.timedOut = options.timedOut;
+    this.raw = options.raw;
+    this.screen = options.screen;
+    this.snapshots = options.snapshots;
+    this.debug = options.debug;
+  }
+}
+function enterKey() {
+  return os.platform() === "win32" ? "\r" : "\r";
+}
+function escapeKey() {
+  return "\x1B";
+}
+function typeTextSteps(text, delayMs) {
+  return [...text].map((char) => ({ write: char, waitMs: delayMs }));
+}
+function createHeadlessTerminal(cols = 100, rows = 40) {
+  return new Terminal({
+    allowProposedApi: true,
+    cols,
+    rows,
+    scrollback: 1e3
+  });
+}
+async function runPtyScenario(options) {
+  const args = options.args ?? [];
+  const cols = options.cols ?? 100;
+  const rows = options.rows ?? 40;
+  const terminal = createHeadlessTerminal(cols, rows);
+  const snapshots = {};
+  let raw = "";
+  let exited = false;
+  let exitCode = null;
+  let timedOut = false;
+  let child = null;
+  let terminalDataDisposable = null;
+  let terminalBinaryDisposable = null;
+  let timeout = null;
+  let removeAbortListener = null;
+  let cancelScenario = null;
+  const timeoutMs = options.timeoutMs ?? 45e3;
+  const buildScenarioError = (message) => new PtyScenarioError(message, {
+    command: options.command,
+    args,
+    timedOut,
+    raw,
+    screen: readScreen(terminal),
+    snapshots: { ...snapshots },
+    debug: buildDebugArtifacts({
+      options,
+      args,
+      raw,
+      screen: readScreen(terminal),
+      snapshots
+    })
+  });
+  const cancellationPromise = new Promise((_, reject) => {
+    cancelScenario = (message) => {
+      if (!exited) {
+        timedOut = true;
+        if (child) {
+          safeKillPty(child);
+        }
+      }
+      reject(buildScenarioError(message));
+    };
+  });
+  cancellationPromise.catch(() => {
+  });
+  if (options.signal) {
+    const abortHandler = () => {
+      cancelScenario?.(formatAbortReason(options.signal, timeoutMs));
+    };
+    if (options.signal.aborted) {
+      abortHandler();
+    } else {
+      options.signal.addEventListener("abort", abortHandler, { once: true });
+      removeAbortListener = () => options.signal?.removeEventListener("abort", abortHandler);
+    }
+  } else {
+    timeout = setTimeout(() => {
+      cancelScenario?.(`PTY scenario timed out after ${formatDuration(timeoutMs)}.`);
+    }, timeoutMs);
+  }
+  const withScenarioTimeout = async (promise) => Promise.race([promise, cancellationPromise]);
+  const throwIfTimedOut = () => {
+    if (timedOut) {
+      throw buildScenarioError(`PTY scenario timed out after ${formatDuration(timeoutMs)}.`);
+    }
+  };
+  try {
+    await withScenarioTimeout(ensureNodePtySpawnHelperExecutable());
+    child = pty.spawn(options.command, args, {
+      name: "xterm-256color",
+      cols,
+      rows,
+      cwd: options.cwd ?? process.cwd(),
+      env: {
+        ...process.env,
+        TERM: "xterm-256color",
+        ...options.env
+      }
+    });
+    terminalDataDisposable = terminal.onData((data) => {
+      if (!exited && child) {
+        child.write(data);
+      }
+    });
+    terminalBinaryDisposable = terminal.onBinary((data) => {
+      if (!exited && child) {
+        child.write(data);
+      }
+    });
+    child.onData((chunk) => {
+      raw += chunk;
+      terminal.write(chunk);
+    });
+    child.onExit((event) => {
+      exited = true;
+      exitCode = event.exitCode;
+    });
+    if (!exited) {
+      throwIfTimedOut();
+    }
+    for (const step of options.steps) {
+      throwIfTimedOut();
+      if (step.skipIf != null && matchesWaitFor(
+        step.skipIf,
+        step.skipIfSource ?? "raw",
+        () => raw,
+        () => readScreen(terminal)
+      )) {
+        continue;
+      }
+      if (step.waitMs != null) {
+        await withScenarioTimeout(sleep(step.waitMs));
+        throwIfTimedOut();
+      }
+      if (step.write != null) {
+        throwIfTimedOut();
+        child.write(step.write);
+      }
+      if (step.waitFor != null) {
+        const matched = await withScenarioTimeout(
+          waitForOutput({
+            match: step.waitFor,
+            source: step.waitForSource ?? "raw",
+            timeoutMs: step.waitForTimeoutMs ?? options.timeoutMs ?? 45e3,
+            getRaw: () => raw,
+            getScreen: () => readScreen(terminal)
+          })
+        );
+        throwIfTimedOut();
+        if (!matched && !step.optional) {
+          throw buildScenarioError(
+            `Timed out waiting for ${step.capture ?? "expected TUI output"}.`
+          );
+        }
+      }
+      if (step.capture != null) {
+        await withScenarioTimeout(sleep(step.captureWaitMs ?? 250));
+        throwIfTimedOut();
+        snapshots[step.capture] = {
+          raw,
+          screen: readScreen(terminal)
+        };
+      }
+    }
+    await withScenarioTimeout(sleep(options.finalWaitMs ?? 250));
+    throwIfTimedOut();
+    const screen = readScreen(terminal);
+    const debug = buildDebugArtifacts({ options, args, raw, screen, snapshots });
+    return {
+      command: options.command,
+      args,
+      exitCode,
+      timedOut,
+      raw,
+      screen,
+      snapshots,
+      debug
+    };
+  } catch (error) {
+    if (error instanceof PtyScenarioError) {
+      throw error;
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    throw buildScenarioError(message);
+  } finally {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+    removeAbortListener?.();
+    terminalDataDisposable?.dispose();
+    terminalBinaryDisposable?.dispose();
+    if (!exited && child) {
+      safeKillPty(child);
+    }
+    terminal.dispose();
+  }
+}
+function formatAbortReason(signal, timeoutMs) {
+  const reason = signal?.reason;
+  if (reason instanceof Error) {
+    return reason.message;
+  }
+  if (typeof reason === "string" && reason.trim().length > 0) {
+    return reason;
+  }
+  return `PTY scenario timed out after ${formatDuration(timeoutMs)}.`;
+}
+function readScreen(terminal) {
+  const buffer = terminal.buffer.active;
+  const lines = [];
+  for (let i = 0; i < buffer.length; i += 1) {
+    const line = buffer.getLine(i);
+    if (line == null) {
+      continue;
+    }
+    lines.push(line.translateToString(true));
+  }
+  return lines.join("\n");
+}
+function safeKillPty(child) {
+  try {
+    child.kill();
+  } catch {
+  }
+}
+function formatCommand(command, args) {
+  return [command, ...args].join(" ");
+}
+function buildDebugArtifacts(options) {
+  if (!options.options.debug?.enabled) {
+    return [];
+  }
+  const debug = [];
+  if (options.options.debug.includeRawOutput) {
+    debug.push({
+      type: "raw-output",
+      label: "pty.raw",
+      content: options.raw,
+      command: formatCommand(options.options.command, options.args)
+    });
+  }
+  if (options.options.debug.includeScreenSnapshots) {
+    for (const [label, snapshot] of Object.entries(options.snapshots)) {
+      debug.push({
+        type: "screen-snapshot",
+        label,
+        content: snapshot.screen,
+        mimeType: "text/plain"
+      });
+    }
+    debug.push({
+      type: "screen-snapshot",
+      label: "final",
+      content: options.screen,
+      mimeType: "text/plain"
+    });
+  }
+  return debug;
+}
+function formatDuration(timeoutMs) {
+  if (timeoutMs % 6e4 === 0) {
+    return `${timeoutMs / 6e4}m`;
+  }
+  if (timeoutMs % 1e3 === 0) {
+    return `${timeoutMs / 1e3}s`;
+  }
+  return `${timeoutMs}ms`;
+}
+async function waitForOutput(options) {
+  const intervalMs = 50;
+  const deadline = Date.now() + options.timeoutMs;
+  while (Date.now() <= deadline) {
+    if (matchesWaitFor(options.match, options.source, options.getRaw, options.getScreen)) {
+      return true;
+    }
+    const remainingMs = deadline - Date.now();
+    if (remainingMs <= 0) {
+      break;
+    }
+    await sleep(Math.min(intervalMs, remainingMs));
+  }
+  return matchesWaitFor(options.match, options.source, options.getRaw, options.getScreen);
+}
+function matchesWaitFor(match, source, getRaw, getScreen) {
+  if (typeof match === "function") {
+    return match({ raw: getRaw(), screen: getScreen() });
+  }
+  const value = source === "screen" ? getScreen() : getRaw();
+  if (typeof match === "string") {
+    return value.includes(match);
+  }
+  match.lastIndex = 0;
+  return match.test(value);
+}
+async function ensureNodePtySpawnHelperExecutable() {
+  if (process.platform === "win32") {
+    return;
+  }
+  const packageRoot = path.dirname(require$1.resolve("node-pty/package.json"));
+  const candidates = [
+    path.join(packageRoot, "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper"),
+    path.join(packageRoot, "build", "Release", "spawn-helper")
+  ];
+  for (const candidate of candidates) {
+    if (!await fileExists(candidate)) {
+      continue;
+    }
+    try {
+      await access(candidate, constants.X_OK);
+      return;
+    } catch {
+      try {
+        await chmod(candidate, 493);
+        return;
+      } catch {
+      }
+    }
+  }
+}
+async function fileExists(filePath) {
+  try {
+    await access(filePath, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  escapeKey as a,
+  enterKey as e,
+  runPtyScenario as r,
+  typeTextSteps as t
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omniagent",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "Unified agent configuration CLI that compiles canonical agent configs to multiple runtimes.",
   "type": "module",
   "bin": {
@@ -43,8 +43,10 @@
   "author": "plsdontemailme@joeroddy.net",
   "license": "MIT",
   "dependencies": {
+    "@xterm/headless": "^5.5.0",
     "jiti": "^2.6.1",
     "minimatch": "^10.2.5",
+    "node-pty": "^1.0.0",
     "yargs": "^17.7.2"
   },
   "devDependencies": {

package/CLAUDE.md

@@ -1,68 +0,0 @@
-# omniagent Development Guidelines
-
-Auto-generated from all feature plans. Last updated: 2026-01-10
-
-## Active Technologies
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js fs/promises + path (004-sync-agent-config)
-- Filesystem (repo-local directories) (004-sync-agent-config)
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js fs/promises + path, Vitest, Vite, Biome (005-sync-slash-commands)
-- Filesystem (repo `agents/commands/`, project target dirs, user home dirs) (005-sync-slash-commands)
-- Filesystem (repo-local config + target directories) (006-add-custom-subagents)
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises`, `path`, Vitest, Vite, Biome (007-agent-templating)
-- Filesystem (repo-local config + target directories + user home config) (007-agent-templating)
-- Filesystem (repo-local agents/ directories and user home state under `~/.omniagent/state/`) (009-local-config-sync)
-- Filesystem (repo-local sources/outputs + user home state under `~/.omniagent/state/`) (010-instruction-file-sync)
-- Filesystem (repo-local `agents/` directory or user-supplied agents directory) (012-agents-dir-override)
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, @typescript/native-preview (tsgo), Vitest, Vite, Biome (013-fix-typecheck-ci)
-- Filesystem (repo-local config and user home state) (013-fix-typecheck-ci)
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vite, Vitest, Biome (014-add-custom-targets)
-- Filesystem (repo-local directories and user home state under `~/.omniagent/state/`) (014-add-custom-targets)
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, `jiti`, Vite, Vitest, Biome, @typescript/native-preview (tsgo) (015-cli-shim-flags)
-- Filesystem (repo-local agents directory and user home state under `~/.omniagent/state/`) (015-cli-shim-flags)
-- TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vitest, Vite, Biome (016-sync-default-agents)
-- Filesystem (repo-local outputs and user home state under `~/.omniagent/state/`) (016-sync-default-agents)
-
-- TypeScript 5.x, ES2022 target + yargs (CLI parsing), Vitest (testing), Vite (build), Biome (formatting/linting) (003-biome-integration)
-
-- TypeScript 5.x, ES2022 target + yargs (CLI parsing), Vitest (testing) (002-vitest-cli-testing)
-
-- TypeScript 5.x, Node.js 18+ + yargs (CLI parsing only) (001-cli-foundation)
-
-## Project Structure
-
-```text
-src/
-tests/
-```
-
-## Commands
-
-npm run check && npm test
-
-## Code Style
-
-TypeScript 5.x, Node.js 18+: Enforced by Biome (formatting and linting)
-- Line width: 100 characters
-- Indentation: Tabs (2-space width)
-- Quotes: Double quotes
-- Semicolons: Always
-- Run `npm run format` before committing
-
-## Recent Changes
-- 016-sync-default-agents: Added TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vitest, Vite, Biome
-- 015-cli-shim-flags: Added TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, `jiti`, Vite, Vitest, Biome, @typescript/native-preview (tsgo)
-- 014-add-custom-targets: Added TypeScript 5.9 (ES2022) on Node.js 18+ + yargs, Node.js `fs/promises` + `path`, Vite, Vitest, Biome
-
-
-
-
-<!-- MANUAL ADDITIONS START -->
-- Dynamic template scripts (`<nodejs>` and `<shell>`) are a shared sync runtime feature and apply across all
-  syncable template surfaces (skills, subagents, slash commands, and instruction templates).
-- Any future syncable surface must integrate with the shared template-script runtime instead of
-  introducing surface-specific script execution behavior.
-- For GitHub actions, use `gh` CLI.
-- Keep ignore and publish rules aligned with tool-specific directories so package publishes stay
-  clean.
-- CLI shim E2E docs: `docs/cli-shim-e2e.md`.
-<!-- MANUAL ADDITIONS END -->

package/CONTRIBUTING.md

@@ -1,56 +0,0 @@
-# Contributing
-
-This document is for contributors and maintainers working on the `omniagent` codebase.
-
-If you are using `omniagent` as an npm package consumer, start with [`README.md`](README.md).
-
-## Local Setup
-
-- Node.js 18+
-- npm
-
-Install dependencies:
-
-```bash
-npm ci
-```
-
-## Local Validation
-
-Run the same checks used by CI before opening a PR:
-
-```bash
-npm run check
-npm run typecheck
-npm test
-npm run build
-```
-
-## Docs Changes
-
-When updating docs, keep root `README.md` consumer-focused.
-
-- End-user usage and product behavior belong in `README.md` and `docs/*.md`.
-- Development and contribution workflows belong in `CONTRIBUTING.md`.
-- Update docs assertions in `tests/docs/readme.test.ts` when docs architecture changes.
-
-## CLI Shim E2E (Contributor Workflow)
-
-CLI shim E2E is a contributor-only verification flow and is not required for normal package usage.
-
-Detailed guide:
-
-- [`docs/cli-shim-e2e.md`](docs/cli-shim-e2e.md)
-
-Quick commands:
-
-```bash
-# Build first
-npm run build
-
-# Record baseline outputs from real CLIs
-OA_E2E_RECORD_BASELINE=1 npm test -- tests/e2e/cli-shim/cli-shim.e2e.test.ts
-
-# Compare shim output to recorded baselines
-OA_E2E=1 npm test -- tests/e2e/cli-shim/cli-shim.e2e.test.ts
-```

package/biome.json

@@ -1,41 +0,0 @@
-{
-	"$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
-	"files": {
-		"includes": ["src/**/*.ts", "tests/**/*.ts"]
-	},
-	"formatter": {
-		"enabled": true,
-		"indentStyle": "tab",
-		"indentWidth": 2,
-		"lineWidth": 100
-	},
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"recommended": true,
-			"suspicious": {
-				"noExplicitAny": "warn"
-			},
-			"correctness": {
-				"noUnusedImports": "error",
-				"noUnusedVariables": "error"
-			}
-		}
-	},
-	"assist": {
-		"enabled": true,
-		"actions": {
-			"source": {
-				"recommended": true
-			}
-		}
-	},
-	"javascript": {
-		"formatter": {
-			"quoteStyle": "double",
-			"semicolons": "always",
-			"trailingCommas": "all",
-			"arrowParentheses": "always"
-		}
-	}
-}

package/tasks.md

@@ -1,25 +0,0 @@
-# README Docs Refactor Tasks
-
-- [x] Create concise onboarding-first `README.md` for the 90% sync workflow.
-- [x] Add advanced docs pages and move complex README content into `/docs`.
-- [x] Move custom targets/custom agent declaration guidance to `docs/custom-targets.md`.
-- [x] Move templating and dynamic script guidance to `docs/templating.md`.
-- [x] Add a docs index and link advanced docs from `README.md`.
-- [x] Update docs tests to match the new README/docs structure.
-- [x] Run validation (`npm run check` and `npm test`).
-
-# Contributor/Consumer Split Follow-up
-
-- [x] Remove development-only validation details from root `README.md`.
-- [x] Add `CONTRIBUTING.md` with local development and validation guidance.
-- [x] Move CLI shim E2E guidance under contributing docs flow.
-- [x] Remove contributor-only links from end-user docs indexes.
-- [x] Update docs tests for the new contributing boundary.
-- [x] Run validation (`npm run check` and `npm test`).
-
-# README Basics Follow-up
-
-- [x] Add simple `.local` override explanation to root `README.md`.
-- [x] Add simple basic templating explanation to root `README.md`.
-- [x] Update docs tests to assert these root README basics.
-- [x] Run validation (`npm run check` and `npm test`).

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "strict": true,
-    "types": ["node", "vitest/globals"],
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src"]
-}

package/vite.config.ts

@@ -1,22 +0,0 @@
-import { defineConfig } from 'vite'
-
-export default defineConfig({
-  build: {
-    target: 'node18',
-    ssr: true,
-    lib: {
-      entry: {
-        cli: 'src/cli/index.ts',
-        index: 'src/index.ts'
-      },
-      formats: ['es'],
-      fileName: (_format, entryName) => `${entryName}.js`
-    },
-    rollupOptions: {
-      external: ['yargs', 'yargs/helpers'],
-      output: {
-        banner: (chunk) => (chunk.name === 'cli' ? '#!/usr/bin/env node' : '')
-      }
-    }
-  }
-})

package/vitest.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    environment: 'node',
-    globals: true,
-    include: ['tests/**/*.test.ts', 'src/**/*.test.ts'],
-    testTimeout: 10000
-  }
-})