@kindgi/cli 0.0.0-bootstrap.0 → 0.1.1

package/dist/templates/sample/guardrails/response-not-empty/index.ts.tmpl

@@ -0,0 +1,58 @@
+// {{PACK_ID}}.response-not-empty — zero-LLM guardrail that fails when the
+// run's final `output` is empty or whitespace-only. Cheap, deterministic,
+// replayable — the preferred kind of guardrail.
+//
+// The module exports a guardrail object literal whose `check` sub-object
+// carries an inline `evaluate` handler. The indexer picks up `action` +
+// `kind` at the top level; the runtime registers the inline check at
+// boot.
+
+import { type DefinedCheck, defineCheck } from '@kindgi/sdk/define';
+import { z } from 'zod';
+
+const ConfigSchema = z.object({
+  minLength: z.number().int().min(0).default(1),
+});
+
+const check = defineCheck({
+  id: '{{PACK_ID}}.checks.response-not-empty',
+  kind: 'zero-llm',
+  configSchema: ConfigSchema,
+  evaluate: async (config, trace) => {
+    const output = trace.output;
+    const text = typeof output === 'string' ? output.trim() : '';
+    if (text.length < config.minLength) {
+      return {
+        passed: false,
+        reason: `Response too short: got ${text.length} chars, expected >= ${config.minLength}.`,
+      };
+    }
+    return { passed: true };
+  },
+});
+
+// The check as the runtime registers it, typed with the SDK's
+// `DefinedCheck`. Left to inference, its type would name
+// `@kindgi/guardrails`, which the pack reaches only through
+// `@kindgi/sdk` — `tsc` then stops with TS2742 (`declaration: true`).
+type InlineCheck = Pick<DefinedCheck<typeof ConfigSchema>, 'id' | 'evaluate' | 'validateConfig'>;
+
+const inlineCheck: InlineCheck = {
+  id: check.id,
+  evaluate: check.evaluate,
+  ...(check.validateConfig !== undefined && { validateConfig: check.validateConfig }),
+};
+
+const guardrail = {
+  id: '{{PACK_ID}}.response-not-empty',
+  name: 'Response is non-empty',
+  kind: 'zero-llm' as const,
+  check: inlineCheck,
+  configSchema: check.configJsonSchema,
+  action: { 'on-violation': 'halt' } as const,
+  severity: 'error' as const,
+  scope: { when: 'runtime-only' as const },
+};
+
+export default guardrail;
+export { check };

package/dist/templates/sample/kindgi.config.ts.tmpl

@@ -0,0 +1,41 @@
+// Kindgi pack config — scaffolded by `kindgi init --template=sample`.
+
+const config = {
+  pack: {
+    id: '{{PACK_ID}}',
+    version: '{{PACK_VERSION}}',
+    description: 'A sample Kindgi pack — two tools, one guardrail, one agent, one flow.',
+  },
+  discovery: {
+    tools: 'tools/**/*.ts',
+    guardrails: 'guardrails/**/*.ts',
+    agents: 'agents/**/*.ts',
+    flows: 'flows/**/*.ts',
+  },
+  // ---------------------------------------------------------------
+  // Environments — one entry per deploy target. `kindgi build`
+  // reads `.build`, `.registry`, `.signingKey`, `.tenantId` for the
+  // chosen env; `kindgi deploy` reads `.endpoint`.
+  //
+  // Fill these in when you're ready to push a build. Local
+  // `kindgi dev` does NOT read this block.
+  // ---------------------------------------------------------------
+  environments: {
+    staging: {
+      endpoint: 'https://api.staging.example.com',
+      build: 'http://localhost:8787', // your Kindgi build server
+      registry: 'ghcr.io/your-org',
+      signingKey: '~/.kindgi/keys/staging.pem',
+      tenantId: 'tenant-your-org-staging',
+    },
+    production: {
+      endpoint: 'https://api.example.com',
+      build: 'https://build.example.com',
+      registry: 'ghcr.io/your-org',
+      signingKey: '~/.kindgi/keys/production.pem',
+      tenantId: 'tenant-your-org-production',
+    },
+  },
+} as const;
+
+export default config;

package/dist/templates/sample/package.json.tmpl

@@ -0,0 +1,25 @@
+{
+  "name": "{{PACK_NAME}}",
+  "version": "{{PACK_VERSION}}",
+  "private": true,
+  "description": "Kindgi pack — scaffolded by `kindgi init --template=sample`. Two tools, one guardrail, one agent, one flow.",
+  "license": "UNLICENSED",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@kindgi/sdk": "workspace:*",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@kindgi/cli": "workspace:*",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.0"
+  }
+}

package/dist/templates/sample/pnpm-workspace.yaml

@@ -0,0 +1,8 @@
+# pnpm 12+ reads settings from this file, not from `package.json`'s
+# `pnpm` block. `allowBuilds` records, per dependency, whether pnpm runs
+# its install script (true) or skips it (false); pnpm 11+ stops an install
+# until each one has a decision. esbuild (the CLI's bundler, and vitest's
+# transform) works without its script: its native binary comes from its
+# `@esbuild/<platform>` package, so the script stays off.
+allowBuilds:
+  esbuild: false

package/dist/templates/sample/tools/echo/index.test.ts.tmpl

@@ -0,0 +1,31 @@
+// {{PACK_ID}}.echo — smoke test verifying the tool compiles + the
+// handler returns the expected shape. Scaffolded by `kindgi init`
+// so `kindgi test` has something to run out of the box.
+
+import { describe, expect, test } from 'vitest';
+
+import type { ToolContext } from '@kindgi/sdk/define';
+import type { TenantId } from '@kindgi/sdk/types';
+
+import echo from './index.js';
+
+function makeCtx(): ToolContext {
+  return {
+    tenantId: '00000000-0000-0000-0000-000000000001' as TenantId,
+    abortSignal: new AbortController().signal,
+  };
+}
+
+describe('{{PACK_ID}}.echo', () => {
+  test('compiles with the expected id', () => {
+    expect(echo.id).toBe('{{PACK_ID}}.echo');
+  });
+
+  test('handler round-trips the message + count', async () => {
+    if (echo.handler === undefined) throw new Error('handler missing');
+    const out = await echo.handler({ message: 'hello' }, makeCtx());
+    expect(out.echo).toBe('hello');
+    expect(out.characterCount).toBe(5);
+    expect(typeof out.echoedAt).toBe('string');
+  });
+});

package/dist/templates/sample/tools/echo/index.ts.tmpl

@@ -0,0 +1,37 @@
+// {{PACK_ID}}.echo — echoes the caller-provided message back with a UTC
+// timestamp. Zod-authored — the wire form is JSON Schema, converted at
+// author time by `defineTool`.
+
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+const EchoInput = z.object({
+  message: z.string().min(1).max(500),
+});
+
+const EchoOutput = z.object({
+  echo: z.string(),
+  echoedAt: z.string(),
+  characterCount: z.number().int().nonnegative(),
+});
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.echo' as ToolId,
+  description: 'Echoes the caller-provided message with a UTC timestamp + character count.',
+  version: '{{PACK_VERSION}}',
+  input: EchoInput,
+  output: EchoOutput,
+  effects: [],
+  handler: async (input) => ({
+    echo: input.message,
+    echoedAt: new Date().toISOString(),
+    characterCount: input.message.length,
+  }),
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.echo failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/sample/tools/fetch-httpbin/index.ts.tmpl

@@ -0,0 +1,60 @@
+// {{PACK_ID}}.fetch-httpbin — declarative tool example (spec form).
+//
+// Uses `defineTool({spec: {kind: 'http', ...}})` — no imperative
+// handler code. The runtime synthesizes the fetch call from the
+// spec at register time. Handler receives validated input; URL
+// template placeholders substitute from that input.
+//
+// This tool hits httpbin.org (a free HTTP debugging service) so
+// it works without any secret configuration. For a real API with
+// authentication, add:
+//
+//     authorization: {
+//       kind: 'bearer',
+//       secretRef: { envName: 'local', name: 'MY_TOKEN' },
+//     },
+//
+// The runtime resolves the secret on every call from its secrets
+// store, in the env the ref names — under `kindgi dev`, env `local`
+// is your `.env` / `.env.local`. A secret it can't find fails the
+// call with `secret-unavailable`, naming it.
+
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+const FetchInput = z.object({
+  path: z.string().regex(/^[a-z0-9\-\/]+$/, 'lowercase path segments only'),
+});
+
+const FetchOutput = z
+  .object({
+    url: z.string(),
+    origin: z.string().optional(),
+    headers: z.record(z.string(), z.string()).optional(),
+    args: z.record(z.string(), z.string()).optional(),
+  })
+  .passthrough();
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.fetch-httpbin' as ToolId,
+  description:
+    'Fetch a path from httpbin.org (an HTTP request debugging service). Useful for testing the framework declarative-tool primitive end-to-end without needing real API credentials.',
+  version: '{{PACK_VERSION}}',
+  input: FetchInput,
+  output: FetchOutput,
+  effects: [{ kind: 'reads', resource: 'external:httpbin.org' }],
+  spec: {
+    kind: 'http',
+    method: 'GET',
+    urlTemplate: 'https://httpbin.org/{path}',
+    headers: [{ name: 'Accept', value: 'application/json' }],
+    timeoutMs: 10_000,
+  },
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.fetch-httpbin failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/sample/tools/greet/index.ts.tmpl

@@ -0,0 +1,35 @@
+// {{PACK_ID}}.greet — greets a named recipient. Second Zod-authored tool
+// alongside `echo` to show how a pack composes multiple primitives. It is
+// read-only (`mutating: false`), so it also runs in a dry run.
+
+import { defineTool } from '@kindgi/sdk/define';
+import type { ToolId } from '@kindgi/sdk/types';
+import { z } from 'zod';
+
+const GreetInput = z.object({
+  name: z.string().min(1).max(100),
+  greeting: z.string().min(1).max(50).default('Hello'),
+});
+
+const GreetOutput = z.object({
+  message: z.string(),
+});
+
+const defined = defineTool({
+  id: '{{PACK_ID}}.greet' as ToolId,
+  description: 'Formats a greeting for the named recipient.',
+  version: '{{PACK_VERSION}}',
+  input: GreetInput,
+  output: GreetOutput,
+  effects: [],
+  mutating: false,
+  handler: async (input) => ({
+    message: `${input.greeting}, ${input.name}!`,
+  }),
+});
+
+if (defined.kind === 'err') {
+  throw new Error(`{{PACK_ID}}.greet failed to compile: ${defined.error.message}`);
+}
+
+export default defined.value;

package/dist/templates/sample/tsconfig.json.tmpl

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2023", "DOM"],
+    "types": ["node"],
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": true,
+    "isolatedModules": true,
+    "declaration": true,
+    "sourceMap": true,
+    "noEmit": true,
+    "resolveJsonModule": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "tools/**/*.ts",
+    "guardrails/**/*.ts",
+    "agents/**/*.ts",
+    "flows/**/*.ts",
+    "kindgi.config.ts"
+  ],
+  "exclude": ["node_modules", "dist", ".kindgi"]
+}

package/dist/templates/sample/vitest.config.ts.tmpl

@@ -0,0 +1,14 @@
+// Vitest configuration for {{PACK_NAME}}. Scaffolded by `kindgi init`.
+// `kindgi test` shells out to the pack's local vitest install using
+// this config — the CLI does NOT force a vitest version through.
+
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    include: ['**/*.test.ts'],
+    exclude: ['node_modules/**', '.kindgi/**', 'dist/**'],
+    reporters: ['default'],
+    passWithNoTests: true,
+  },
+});

package/dist/terminal-input.d.ts

@@ -0,0 +1,17 @@
+/** A prompt whose answer isn't echoed. Tests hand in a fake. */
+export interface TtySeam {
+    /** Rejects with `PromptCancelled` when the person presses Ctrl+C (or Ctrl+D) instead. */
+    promptHidden(prompt: string): Promise<string>;
+    close(): void;
+}
+/** The person cancelled a prompt (Ctrl+C, or Ctrl+D): no answer, not an empty one. */
+export declare class PromptCancelled extends Error {
+    constructor();
+}
+/** Whether stdin is a terminal, so a hidden prompt can read from it. */
+export declare function stdinIsTty(): boolean;
+export declare function stripTrailingNewline(s: string): string;
+export declare function readStdinToEnd(): Promise<string>;
+/** The hidden prompt on the real terminal: the prompt on stderr, keystrokes from stdin. */
+export declare function realTtySeam(): TtySeam;
+//# sourceMappingURL=terminal-input.d.ts.map

package/dist/terminal-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-input.d.ts","sourceRoot":"","sources":["../src/terminal-input.ts"],"names":[],"mappings":"AAaA,gEAAgE;AAChE,MAAM,WAAW,OAAO;IACtB,yFAAyF;IACzF,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,KAAK,IAAI,IAAI,CAAC;CACf;AAED,sFAAsF;AACtF,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED,wEAAwE;AACxE,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAMtD;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,IAAI,OAAO,CAsDrC"}

package/dist/terminal-input.js

@@ -0,0 +1,88 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * Reading a secret from the person at the terminal (a hidden prompt) or
+ * from stdin: the value of `kindgi secrets set`, the registry token of
+ * `kindgi auth registry`. Nothing here echoes or logs what it reads.
+ */
+import { EOL } from 'node:os';
+import * as readline from 'node:readline';
+/** The person cancelled a prompt (Ctrl+C, or Ctrl+D): no answer, not an empty one. */
+export class PromptCancelled extends Error {
+    constructor() {
+        super('Cancelled.');
+        this.name = 'PromptCancelled';
+    }
+}
+/** Whether stdin is a terminal, so a hidden prompt can read from it. */
+export function stdinIsTty() {
+    return Boolean(process.stdin.isTTY);
+}
+export function stripTrailingNewline(s) {
+    if (s.endsWith(EOL))
+        return s.slice(0, -EOL.length);
+    if (s.endsWith('\n'))
+        return s.slice(0, -1);
+    return s;
+}
+export async function readStdinToEnd() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString('utf8');
+}
+/** The hidden prompt on the real terminal: the prompt on stderr, keystrokes from stdin. */
+export function realTtySeam() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stderr,
+        terminal: true,
+    });
+    // Silence output while user types. `readline` doesn't expose a
+    // built-in "no-echo" mode; the standard trick is to override the
+    // internal `_writeToOutput` on the interface. This is portable
+    // enough across Node 22.x + prints only the prompt itself.
+    const rlAny = rl;
+    return {
+        promptHidden: (prompt) => new Promise((resolve, reject) => {
+            const originalWrite = rlAny._writeToOutput;
+            const done = () => {
+                rl.off('SIGINT', cancel);
+                rl.off('close', cancel);
+                if (originalWrite !== undefined) {
+                    rlAny._writeToOutput = originalWrite;
+                }
+                else {
+                    // biome-ignore lint/performance/noDelete: readline distinguishes missing property from undefined
+                    delete rlAny._writeToOutput;
+                }
+                (rlAny.output ?? process.stderr).write('\n');
+            };
+            // Ctrl+C in a raw-mode prompt reaches readline, not the process:
+            // without these, readline closes, the answer never comes, and the
+            // process exits 0 as if nothing went wrong.
+            const cancel = () => {
+                done();
+                reject(new PromptCancelled());
+            };
+            rl.once('SIGINT', cancel);
+            rl.once('close', cancel);
+            rlAny._writeToOutput = function overrideWrite(str) {
+                // Write only the prompt itself (rl.question emits the
+                // prompt via the same channel); swallow keystrokes.
+                if (str === prompt) {
+                    (rlAny.output ?? process.stderr).write(str);
+                }
+            };
+            rl.question(prompt, (answer) => {
+                done();
+                resolve(answer);
+            });
+        }),
+        close: () => {
+            rl.close();
+        },
+    };
+}
+//# sourceMappingURL=terminal-input.js.map

package/dist/terminal-input.js.map

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

package/dist/test/defaults.d.ts

@@ -0,0 +1,3 @@
+import type { TestRunners } from './runners.js';
+export declare const REAL_TEST_RUNNERS: TestRunners;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/test/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/test/defaults.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAmC,WAAW,EAAE,MAAM,cAAc,CAAC;AASjF,eAAO,MAAM,iBAAiB,EAAE,WAc/B,CAAC"}

package/dist/test/defaults.js

@@ -0,0 +1,104 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+/**
+ * Production wiring for `kindgi test`. Uses `pnpm exec vitest` when
+ * the pack root has a `pnpm-workspace.yaml` or `pnpm-lock.yaml` above
+ * it, otherwise falls back to `npx --no-install vitest`. Either way,
+ * the runner used is the pack's OWN installed vitest — the CLI never
+ * forces a version through.
+ */
+import { spawn } from 'node:child_process';
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
+const VITEST_CONFIGS = [
+    'vitest.config.ts',
+    'vitest.config.mjs',
+    'vitest.config.js',
+    'vitest.config.cjs',
+];
+export const REAL_TEST_RUNNERS = {
+    hasVitestConfig: async ({ packDir }) => {
+        for (const name of VITEST_CONFIGS) {
+            const abs = join(packDir, name);
+            try {
+                const s = await stat(abs);
+                if (s.isFile())
+                    return true;
+            }
+            catch {
+                // try next
+            }
+        }
+        return false;
+    },
+    runTests: async (opts) => spawnRunner(opts),
+};
+async function spawnRunner(opts) {
+    // Prefer `pnpm exec` when a lockfile shape suggests pnpm; else npx.
+    const usePnpm = await hasFile(opts.packDir, ['pnpm-lock.yaml', 'pnpm-workspace.yaml']);
+    const binary = usePnpm ? 'pnpm' : 'npx';
+    const args = usePnpm
+        ? ['exec', 'vitest', ...opts.args]
+        : ['--no-install', 'vitest', ...opts.args];
+    return new Promise((resolvePromise) => {
+        let child;
+        try {
+            child = spawn(binary, args, {
+                cwd: opts.packDir,
+                env: { ...process.env, ...opts.env },
+                stdio: ['inherit', 'pipe', 'pipe'],
+                ...(opts.signal !== undefined && { signal: opts.signal }),
+            });
+        }
+        catch (err) {
+            resolvePromise({
+                spawned: false,
+                exitCode: 1,
+                reason: 'runner-spawn-error',
+                resolvedBinary: binary,
+            });
+            // Note the closure — err isn't surfaced structurally here; the
+            // command's stderr hint is generic. If we ever need typed spawn
+            // errors, extend RunTestsResult with an `errorMessage` field.
+            void err;
+            return;
+        }
+        child.stdout?.on('data', (chunk) => {
+            opts.onLog?.(chunk.toString('utf8'));
+        });
+        child.stderr?.on('data', (chunk) => {
+            opts.onLog?.(chunk.toString('utf8'));
+        });
+        child.on('error', (err) => {
+            // ENOENT surfaces here (binary not found on PATH).
+            const code = err.code;
+            resolvePromise({
+                spawned: false,
+                exitCode: 1,
+                reason: code === 'ENOENT' ? 'runner-binary-not-found' : 'runner-spawn-error',
+                resolvedBinary: binary,
+            });
+        });
+        child.on('close', (code) => {
+            resolvePromise({
+                spawned: true,
+                exitCode: code ?? 1,
+                resolvedBinary: binary,
+            });
+        });
+    });
+}
+async function hasFile(dir, names) {
+    for (const name of names) {
+        try {
+            const s = await stat(join(dir, name));
+            if (s.isFile())
+                return true;
+        }
+        catch {
+            // try next
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=defaults.js.map

package/dist/test/defaults.js.map

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

package/dist/test/runners.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Injectable seams for `kindgi test`. The test-runner shellout
+ * flows through this shape so tests inspect the invocation without
+ * spawning real vitest.
+ */
+export interface RunTestsOptions {
+    /** Absolute pack directory the runner spawns in. */
+    readonly packDir: string;
+    /** Which runner to invoke. v0.1 only `vitest` is supported. */
+    readonly runner: 'vitest';
+    /**
+     * Arguments to append to the runner invocation. `--watch` /
+     * `--reporter <name>` / any pass-through `-- ...` tokens land here.
+     */
+    readonly args: readonly string[];
+    /** Env vars threaded to the child process. */
+    readonly env: Readonly<Record<string, string | undefined>>;
+    /**
+     * Abort signal to forward to the child process. Watch-mode test
+     * runs listen on this to exit gracefully.
+     */
+    readonly signal?: AbortSignal;
+    /**
+     * Optional log sink for the child's stdout/stderr. Production wiring
+     * pipes directly to the current process; tests capture into an array.
+     */
+    readonly onLog?: (chunk: string) => void;
+}
+export interface RunTestsResult {
+    /** Runner exit code — 0 on success, non-zero on failed tests. */
+    readonly exitCode: number;
+    /**
+     * `true` if the runner binary was resolved + spawned. `false` when
+     * the CLI probed for the local install and came back empty; the
+     * caller surfaces the missing-binary hint in that path.
+     */
+    readonly spawned: boolean;
+    /** When `spawned=false`, a machine-readable code explaining why. */
+    readonly reason?: 'runner-binary-not-found' | 'runner-spawn-error';
+    /** Runner binary path (or command name) resolved by the runner. */
+    readonly resolvedBinary?: string;
+}
+export interface HasVitestConfigOptions {
+    readonly packDir: string;
+}
+export interface TestRunners {
+    /**
+     * Check whether the pack ships a vitest config. `kindgi test`
+     * refuses to spawn without one — a bare `vitest` invocation would
+     * either sweep the whole repo (dev machines) or fail cryptically
+     * (fresh clones).
+     */
+    readonly hasVitestConfig: (opts: HasVitestConfigOptions) => Promise<boolean>;
+    /**
+     * Spawn the runner. Blocks until the runner exits; forwards logs to
+     * `opts.onLog` line-by-line.
+     */
+    readonly runTests: (opts: RunTestsOptions) => Promise<RunTestsResult>;
+}
+//# sourceMappingURL=runners.d.ts.map

package/dist/test/runners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../../src/test/runners.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,yBAAyB,GAAG,oBAAoB,CAAC;IACnE,mEAAmE;IACnE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;CACvE"}

package/dist/test/runners.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+export {};
+//# sourceMappingURL=runners.js.map

package/dist/test/runners.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runners.js","sourceRoot":"","sources":["../../src/test/runners.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC"}