@bluelibs/runner-dev 4.1.0 → 4.2.0

package/dist/cli/init.js

@@ -0,0 +1,279 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const fs_1 = __importDefault(require("fs"));
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const format_1 = require("./format");
+async function main(argv) {
+    const [, , , rawName] = argv;
+    const flagArgs = argv.slice(4);
+    const flagSet = new Set(flagArgs.filter((a) => a && a.startsWith("--")).map((a) => a.slice(2)));
+    const shouldInstall = flagSet.has("install");
+    const shouldRun = flagSet.has("run");
+    const shouldRunTests = flagSet.has("run-tests") || flagSet.has("runTests");
+    const projectName = (rawName || "my-runner-project").trim();
+    if (!/^[a-zA-Z0-9_-]+$/.test(projectName)) {
+        // eslint-disable-next-line no-console
+        console.error("Invalid project name. Use only letters, numbers, dashes and underscores.");
+        process.exit(1);
+    }
+    const targetDir = path_1.default.resolve(process.cwd(), projectName);
+    await ensureEmptyDir(targetDir);
+    const options = { projectName, targetDir };
+    await scaffold(options);
+    // eslint-disable-next-line no-console
+    console.log(`\n${format_1.c.green("Project created in")} ${format_1.c.bold(targetDir)}.`);
+    // Helpful options & commands
+    const flags = (0, format_1.alignRows)([
+        [format_1.c.yellow("--install"), "Install dependencies after scaffold"],
+        [format_1.c.yellow("--run"), "Run 'npm run dev' after scaffold (keeps running)"],
+        [format_1.c.yellow("--run-tests"), "Run 'npm test' after scaffold"],
+    ], { gap: 4, indent: 2 });
+    const quick = (0, format_1.indentLines)([
+        `${format_1.c.gray("# Query your GraphQL endpoint")}`,
+        `ENDPOINT=http://localhost:1337/graphql ${format_1.c.cmd("npx runner-dev query")} 'query { tasks { id } }' --format pretty`,
+        `${format_1.c.gray("# Print SDL")}`,
+        `${format_1.c.cmd("npx runner-dev schema sdl")} --endpoint http://localhost:1337/graphql`,
+    ].join("\n"), 2);
+    const headersExample = 'HEADERS=\'{"Authorization":"Bearer ..."}\'';
+    const env = (0, format_1.alignRows)([
+        [format_1.c.bold("ENDPOINT / GRAPHQL_ENDPOINT"), "GraphQL endpoint URL"],
+        [format_1.c.bold(headersExample), "Add HTTP headers (JSON)"],
+        [format_1.c.bold("ALLOW_MUTATIONS=true"), "Enable mutations tool"],
+    ], { gap: 4, indent: 2 });
+    // eslint-disable-next-line no-console
+    console.log([
+        "",
+        format_1.c.title("Helpful options & commands"),
+        (0, format_1.divider)(),
+        format_1.c.bold("Flags for 'runner-dev new'"),
+        flags,
+        "",
+        format_1.c.bold("Quick commands"),
+        quick,
+        "",
+        format_1.c.bold("Environment"),
+        env,
+        "",
+    ].join("\n"));
+    // eslint-disable-next-line no-console
+    console.log([
+        format_1.c.bold("Endpoints"),
+        (0, format_1.alignRows)([
+            [format_1.c.cyan("GraphQL"), "http://localhost:1337/graphql"],
+            [format_1.c.cyan("Voyager"), "http://localhost:1337/voyager"],
+            [format_1.c.cyan("Docs"), "http://localhost:1337/docs"],
+        ], { gap: 4, indent: 2 }),
+    ].join("\n"));
+    // Execute optional post-scaffold actions
+    if (shouldInstall || shouldRunTests || shouldRun) {
+        console.log("\nInstalling dependencies...\n");
+        await runCommand("npm", ["install", "--prefer-offline", "--no-audit", "--no-fund"], targetDir);
+    }
+    if (shouldRunTests) {
+        console.log("\nRunning tests...\n");
+        await runCommand("npm", ["run", "test", "--", "--runInBand"], targetDir);
+    }
+    if (shouldRun) {
+        console.log("\nStarting dev server... (Ctrl+C to stop)\n");
+        await runCommand("npm", ["run", "dev"], targetDir);
+    }
+    // eslint-disable-next-line no-console
+    console.log(`\n${format_1.c.bold("Next steps")}\n${(0, format_1.alignRows)([
+        [format_1.c.cmd(`cd ${projectName}`), "enter project directory"],
+        [format_1.c.cmd("npm install"), "install dependencies"],
+        [format_1.c.cmd("npm run dev"), "start local dev server"],
+    ], { gap: 4, indent: 2 })}`);
+}
+async function ensureEmptyDir(dir) {
+    if (fs_1.default.existsSync(dir)) {
+        const entries = await promises_1.default.readdir(dir);
+        if (entries.length > 0) {
+            // eslint-disable-next-line no-console
+            console.error(`Target directory '${path_1.default.basename(dir)}' already exists and is not empty.`);
+            process.exit(1);
+        }
+        return;
+    }
+    await promises_1.default.mkdir(dir, { recursive: true });
+}
+async function scaffold(opts) {
+    const { targetDir, projectName } = opts;
+    const pkg = {
+        name: projectName,
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        scripts: {
+            dev: "tsx watch src/main.ts",
+            start: "node dist/main.js",
+            build: "tsc -p tsconfig.json",
+            test: "jest",
+            "test:watch": "jest --watch",
+            "schema:sdl": "runner-dev schema sdl",
+        },
+        dependencies: {
+            "@bluelibs/runner": "^4.0.0",
+        },
+        devDependencies: {
+            "@bluelibs/runner-dev": "^4.0.0",
+            typescript: "^5.6.3",
+            tsx: "^4.19.2",
+            jest: "^29.7.0",
+            "ts-jest": "^29.1.1",
+            "@types/jest": "^29.5.12",
+            "source-map-support": "^0.5.21",
+        },
+    };
+    const tsconfig = {
+        compilerOptions: {
+            target: "ESNext",
+            module: "Node16",
+            moduleResolution: "node16",
+            strict: true,
+            esModuleInterop: true,
+            forceConsistentCasingInFileNames: true,
+            declaration: true,
+            outDir: "dist",
+            rootDir: "src",
+            skipLibCheck: true,
+            resolveJsonModule: true,
+            lib: ["ESNext"],
+        },
+        include: ["src"],
+    };
+    const jestConfig = `/** @type {import('jest').Config} */
+module.exports = {
+  preset: 'ts-jest/presets/default-esm',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/src'],
+  moduleFileExtensions: ['ts', 'tsx', 'js'],
+  extensionsToTreatAsEsm: ['.ts', '.tsx'],
+  transform: {
+    '^.+\\.(ts|tsx)$': [
+      'ts-jest',
+      {
+        useESM: true,
+        tsconfig: 'tsconfig.jest.json',
+      },
+    ],
+  },
+};
+`;
+    const tsconfigJest = {
+        extends: "./tsconfig.json",
+        compilerOptions: {
+            module: "CommonJS",
+            moduleResolution: "node",
+            target: "ES2019",
+            esModuleInterop: true,
+            isolatedModules: false,
+        },
+        include: ["src/**/*.ts", "src/**/*.tsx"],
+    };
+    const mainTs = `import 'source-map-support/register';
+import { run, resource } from '@bluelibs/runner';
+import { dev } from '@bluelibs/runner-dev';
+
+// Minimal Runner app using runner-dev's dev resource
+const app = resource({
+  id: 'app.${projectName}',
+  register: [
+    dev.with({ port: 1337 }),
+  ],
+});
+
+run(app)
+  .then(() => {
+    // eslint-disable-next-line no-console
+    console.log('Runner app started on http://localhost:1337');
+  })
+  .catch((err) => {
+    // eslint-disable-next-line no-console
+    console.error(err);
+    process.exit(1);
+  });
+`;
+    const exampleTest = `describe('smoke', () => {
+  it('works', () => {
+    expect(1 + 1).toBe(2);
+  });
+});
+`;
+    const readme = `# ${projectName}
+
+Generated by \`runner-dev new\`.
+
+## Quick start
+
+1. Install dependencies:
+   - npm install
+2. Start the dev server:
+   - npm run dev
+
+The server starts on http://localhost:1337
+
+- GraphQL endpoint: http://localhost:1337/graphql (how to query your guts and live telemetry)
+- Voyager UI: http://localhost:1337/voyager (how the guts of your app look like)
+- Project docs: http://localhost:1337/docs (beautiful docs with live telemetry and easy task and event dispatching)
+
+## Scripts
+
+- dev: Run with tsx watch (TypeScript ESM)
+- build: Type-check and emit to dist
+- start: Run built app
+- test: Run Jest
+
+## Useful CLI commands
+
+These commands are available from \`@bluelibs/runner-dev\`:
+
+- Query your API:
+  - ENDPOINT=http://localhost:1337/graphql npx runner-dev query 'query { tasks { id } }' --format pretty
+- Print the GraphQL schema SDL:
+  - npx runner-dev schema sdl --endpoint http://localhost:1337/graphql
+
+`;
+    await writeJson(path_1.default.join(targetDir, "package.json"), pkg);
+    await writeJson(path_1.default.join(targetDir, "tsconfig.json"), tsconfig);
+    await writeFile(path_1.default.join(targetDir, "jest.config.cjs"), jestConfig);
+    await writeJson(path_1.default.join(targetDir, "tsconfig.jest.json"), tsconfigJest);
+    await promises_1.default.mkdir(path_1.default.join(targetDir, "src"), { recursive: true });
+    await writeFile(path_1.default.join(targetDir, "src", "main.ts"), mainTs);
+    await writeFile(path_1.default.join(targetDir, "src", "main.test.ts"), exampleTest);
+    await writeFile(path_1.default.join(targetDir, "README.md"), readme);
+    await writeGitignore(targetDir);
+}
+async function writeJson(filePath, data) {
+    const content = JSON.stringify(data, null, 2) + "\n";
+    await writeFile(filePath, content);
+}
+async function writeFile(filePath, content) {
+    await promises_1.default.writeFile(filePath, content, { encoding: "utf8" });
+}
+async function writeGitignore(targetDir) {
+    const content = `node_modules\n.dist\ndist\n.env\n\n`;
+    await writeFile(path_1.default.join(targetDir, ".gitignore"), content);
+}
+async function runCommand(cmd, args, cwd) {
+    await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(cmd, args, {
+            cwd,
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${cmd} ${args.join(" ")} exited with code ${code}`));
+        });
+        child.on("error", reject);
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/query.js

@@ -1,9 +1,16 @@
 #!/usr/bin/env node
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.main = main;
 require("source-map-support/register");
 const shared_1 = require("./shared");
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+const runner_1 = require("@bluelibs/runner");
+const graphql_cli_resource_1 = require("../resources/graphql.cli.resource");
 function printHelp() {
     // eslint-disable-next-line no-console
     console.log(`
@@ -20,6 +27,8 @@ Options:
   --format <fmt>          data|json|pretty (default: data)
   --raw                   Output full GraphQL response (with errors)
   --namespace <str>       Convenience filter for idIncludes
+  --entry-file <path>     TS entry file exporting default or named app
+  --export <name>         Named export to use (default export preferred)
 `);
 }
 async function main(argv) {
@@ -46,6 +55,8 @@ async function main(argv) {
     }
     const endpoint = opts.get("endpoint") || undefined;
     const headersJson = opts.get("headers") || undefined;
+    const entryFile = opts.get("entry-file") || undefined;
+    const exportName = opts.get("export") || undefined;
     const variables = (0, shared_1.parseVariablesOption)(opts.get("variables"));
     const operationName = opts.get("operation") || undefined;
     const format = (opts.get("format") || "data");
@@ -55,6 +66,64 @@ async function main(argv) {
         query = (0, shared_1.applyNamespaceFilter)(query, namespace);
     }
     try {
+        // Prefer dry-run entry-file mode when provided
+        if (entryFile) {
+            // Auto-load TypeScript; require ts-node/register/transpile-only
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                require("ts-node/register/transpile-only");
+            }
+            catch (e) {
+                throw new Error(`TypeScript loader not available. Please install ts-node. Original error: ${e.message}`);
+            }
+            const abs = node_path_1.default.isAbsolute(entryFile)
+                ? entryFile
+                : node_path_1.default.resolve(process.cwd(), entryFile);
+            const mod = await import((0, node_url_1.pathToFileURL)(abs).href);
+            const entry = (exportName ? mod?.[exportName] : mod?.default) ?? mod?.app ?? null;
+            if (!entry) {
+                throw new Error(`Entry not found. Provide a default export or use --export <name>.`);
+            }
+            // First pass: dry-run to get the Store
+            const dry = await (0, runner_1.run)(entry, { dryRun: true });
+            const customStore = dry.store;
+            if (!customStore) {
+                throw new Error("Dry-run did not return a store.");
+            }
+            // Second pass: run the GraphQL harness with the custom store
+            const harness = await (0, runner_1.run)(graphql_cli_resource_1.graphqlCli.with({ customStore }));
+            try {
+                const res = await harness.runTask("runner-dev.tasks.graphqlQueryCli", {
+                    query,
+                    variables,
+                    operationName,
+                });
+                const envelope = {
+                    data: res?.ok ? res?.data ?? null : null,
+                    errors: res?.ok
+                        ? undefined
+                        : Array.isArray(res?.errors)
+                            ? res?.errors?.map((m) => ({ message: String(m) }))
+                            : undefined,
+                };
+                if (!raw && envelope?.errors?.length) {
+                    // eslint-disable-next-line no-console
+                    console.error(JSON.stringify(envelope.errors, null, 2));
+                    // eslint-disable-next-line no-process-exit
+                    process.exit(1);
+                }
+                // eslint-disable-next-line no-console
+                console.log((0, shared_1.formatOutput)(envelope, { format, raw }));
+            }
+            finally {
+                try {
+                    await harness.dispose();
+                }
+                catch { }
+            }
+            return;
+        }
+        // Fallback to remote endpoint execution
         const result = await (0, shared_1.execRemote)({
             endpoint,
             headersJson,

package/dist/cli/query.js.map

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

package/dist/cli.js

@@ -2,31 +2,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 require("source-map-support/register");
+const format_1 = require("./cli/format");
 const subcommand = process.argv[2];
 async function run() {
     if (!subcommand || ["help", "-h", "--help"].includes(subcommand)) {
+        const title = format_1.c.title("runner-dev CLI");
+        const usage = (0, format_1.alignRows)([
+            [format_1.c.cmd("runner-dev mcp"), "Start the MCP GraphQL server over stdio"],
+            [format_1.c.cmd("runner-dev query"), "Run a GraphQL query against an endpoint"],
+            [
+                format_1.c.cmd("runner-dev new"),
+                "Scaffold a new Runner TypeScript project (or populate existing directory)",
+            ],
+            [format_1.c.cmd("runner-dev overview"), "Print Markdown project overview"],
+            [format_1.c.cmd("runner-dev schema"), "Print SDL or introspection JSON"],
+            [format_1.c.cmd("runner-dev ping"), "Ping GraphQL endpoint"],
+        ], { gap: 3, indent: 2 });
+        const headersExample = 'HEADERS=\'{"Authorization":"Bearer ..."}\'';
+        const env = (0, format_1.alignRows)([
+            [format_1.c.bold("ENDPOINT / GRAPHQL_ENDPOINT"), "GraphQL endpoint URL"],
+            [format_1.c.bold("ALLOW_MUTATIONS=true"), "Enable mutations tool"],
+            [format_1.c.bold(headersExample), "Extra headers JSON"],
+        ], { gap: 3, indent: 2 });
+        const examples = (0, format_1.indentLines)([
+            `${format_1.c.gray("# Start MCP over stdio against an endpoint")}`,
+            `ENDPOINT=http://localhost:2000/graphql ${format_1.c.cmd("runner-dev mcp")}`,
+            `${format_1.c.gray("# Add headers and enable mutations")}`,
+            `ALLOW_MUTATIONS=true HEADERS='{"Authorization":"Bearer token"}' ${format_1.c.cmd("runner-dev mcp")}`,
+            `${format_1.c.gray("# Query your GraphQL endpoint")}`,
+            `ENDPOINT=http://localhost:1337/graphql ${format_1.c.cmd("runner-dev query")} 'query { tasks { id } }' --format pretty`,
+            `${format_1.c.gray("# Print SDL")}`,
+            `${format_1.c.cmd("runner-dev schema sdl")} --endpoint http://localhost:1337/graphql`,
+        ].join("\n"), 2);
         // eslint-disable-next-line no-console
-        console.log(`
-runner-dev CLI
-
-Usage:
-  runner-dev mcp        Start the MCP GraphQL server over stdio
-  runner-dev query      Run a GraphQL query against an endpoint
-  runner-dev overview   Print Markdown project overview
-  runner-dev schema     Print SDL or introspection JSON
-  runner-dev ping       Ping GraphQL endpoint
-
-Environment:
-  ENDPOINT or GRAPHQL_ENDPOINT   GraphQL endpoint URL
-  ALLOW_MUTATIONS=true           Enable mutations tool
-  HEADERS='{"Authorization":"Bearer ..."}'  Extra headers JSON
-
-Examples:
-  ENDPOINT=http://localhost:2000/graphql runner-dev mcp
-  ALLOW_MUTATIONS=true HEADERS='{"Authorization":"Bearer token"}' runner-dev mcp
-  ENDPOINT=http://localhost:1337/graphql runner-dev query 'query { tasks { id } }'
-  runner-dev schema sdl --endpoint http://localhost:1337/graphql
-`);
+        console.log([
+            "",
+            title,
+            (0, format_1.divider)(),
+            format_1.c.bold("Usage"),
+            usage,
+            "",
+            format_1.c.bold("Environment"),
+            env,
+            "",
+            format_1.c.bold("Examples"),
+            examples,
+            "",
+        ].join("\n"));
         return;
     }
     if (subcommand === "mcp") {
@@ -38,6 +60,11 @@ Examples:
         await mod.main(process.argv);
         return;
     }
+    if (subcommand === "new") {
+        const mod = await import("./cli/init.js");
+        await mod.main(process.argv);
+        return;
+    }
     if (subcommand === "overview") {
         const mod = await import("./cli/overview.js");
         await mod.main(process.argv);

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AACA,uCAAqC;AAErC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnC,KAAK,UAAU,GAAG;IAChB,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACjE,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;CAoBf,CAAC,CAAC;QACC,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC9C,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC5C,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,GAAG,EAAE,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/code.d.ts

@@ -0,0 +1,50 @@
+type AgentMessageRole = "user" | "assistant" | "system" | "tool";
+export interface AgentMessage {
+    role: AgentMessageRole;
+    content: string;
+    name?: string;
+    timestampMs?: number;
+}
+export interface AgentToolCall {
+    id: string;
+    name: string;
+    argumentsJson: string;
+}
+export interface AgentResponseChunk {
+    type: "text" | "tool_call" | "tool_result" | "event";
+    text?: string;
+    toolCall?: AgentToolCall;
+    event?: {
+        name: string;
+        data?: unknown;
+    };
+}
+export interface TerminalConfig {
+    prompt?: string;
+    historyLimit?: number;
+    enableTools?: boolean;
+    modelName?: string;
+}
+export interface AgentTerminalState {
+    config: Required<TerminalConfig>;
+    history: AgentMessage[];
+    isRunning: boolean;
+    lastSearchResults: string[];
+    savedFiles: string[];
+}
+export interface AgentTerminalHandlers {
+    onChunk?: (chunk: AgentResponseChunk) => void;
+    onMessage?: (message: AgentMessage) => void;
+    onError?: (error: unknown) => void;
+    onExit?: () => void;
+}
+export interface AgentTerminalControls {
+    start: () => Promise<void>;
+    stop: () => Promise<void>;
+    send: (input: string) => Promise<void>;
+    getState: () => AgentTerminalState;
+    setConfig: (partial: Partial<TerminalConfig>) => void;
+}
+export declare function createAgentTerminal(initialConfig?: TerminalConfig, handlers?: AgentTerminalHandlers): AgentTerminalControls;
+export declare function buildAsyncCompleter(_state: AgentTerminalState): (line: string, cb: (err: Error | null, result: [string[], string]) => void) => void;
+export {};