@vesk/agentic 0.2.11

package/dist/config.js

@@ -0,0 +1,399 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+const DEFAULT_CONFIG = {
+    provider: 'openai',
+    model: 'gpt-4o-mini',
+    mode: 'explore',
+    maxSteps: 25,
+};
+export const SUPPORTED_PROVIDERS = [
+    'openai', 'anthropic', 'google', 'ollama',
+    'opencode', 'opencode-go', 'openrouter', 'loopers', 'custom',
+];
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+function configPath(projectDir) {
+    return resolve(projectDir, '.vesk', 'agentic', 'config.json');
+}
+function keysDir(projectDir) {
+    return resolve(projectDir, '.vesk', 'agentic', 'keys');
+}
+function sanitizeProvider(provider) {
+    // keep lower-case, replace path separators and disallowed chars
+    const p = provider.trim().toLowerCase();
+    if (!p)
+        return 'default';
+    // replace any slash/backslash or .. and non-alnum except - _ .
+    return p.replace(/[\/\\]+/g, '_').replace(/[^a-z0-9_.-]/g, '_') || 'default';
+}
+function normalizeProvider(provider) {
+    return provider.trim().toLowerCase();
+}
+function providerKeyPath(projectDir, provider) {
+    return resolve(keysDir(projectDir), `${sanitizeProvider(provider)}.key`);
+}
+// ── .env.local provider keys (VK_{PROVIDER}_KEY) ────────────────────────────
+// Primary key store: project `.env.local` holds one line per provider, e.g.
+//   VK_OPENAI_KEY=sk-...
+//   VK_OPENCODE_KEY=sk-...
+//   VK_OPENCODE_GO_KEY=sk-...
+// These are read into `process.env` at CLI startup via loadEnvFiles, so
+// reading `process.env` reflects the file. Saving rewrites the file so the
+// change persists for later `vesk dev`/`vesk start` runs.
+export function providerDotenvVar(provider) {
+    const prov = sanitizeProvider(provider);
+    // opencode-go -> VK_OPENCODE_GO_KEY
+    return `VK_${prov.toUpperCase().replace(/[^A-Z0-9]/g, '_')}_KEY`;
+}
+export function dotenvPath(projectDir) {
+    return resolve(projectDir, '.env.local');
+}
+/**
+ * Read a provider key from the project `.env.local` file.
+ * Note: normally `process.env` already reflects `.env.local` (loaded at CLI
+ * startup); this reads the file directly as a defensive fallback (e.g. when
+ * the file changed after startup, or callers didn't go through loadEnvFiles).
+ */
+export function readDotenvValue(projectDir, key, def = null) {
+    try {
+        const p = dotenvPath(projectDir);
+        if (!existsSync(p))
+            return def;
+        const content = readFileSync(p, 'utf-8');
+        for (const rawLine of content.split('\n')) {
+            const line = rawLine.trim();
+            if (!line || line.startsWith('#'))
+                continue;
+            const eq = line.indexOf('=');
+            if (eq === -1)
+                continue;
+            if (line.slice(0, eq).trim() !== key)
+                continue;
+            let val = line.slice(eq + 1).trim();
+            if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'")))
+                val = val.slice(1, -1);
+            return val;
+        }
+        return def;
+    }
+    catch {
+        return def;
+    }
+}
+/**
+ * Set a `KEY=VALUE` line in the project `.env.local`, creating the file if
+ * missing, updating in place if present. Also mirrors into `process.env` so
+ * the current process sees it immediately. Returns true on success.
+ */
+export function writeDotenvValue(projectDir, key, value) {
+    const p = dotenvPath(projectDir);
+    const pad = value && !value.startsWith('#');
+    const newLine = `${key}=${pad && /^[A-Za-z0-9_@./:+-]+$/.test(value) ? value : JSON.stringify(value)}`;
+    try {
+        let out = '';
+        let replaced = false;
+        if (existsSync(p)) {
+            const lines = readFileSync(p, 'utf-8').split('\n');
+            for (const rawLine of lines) {
+                const trimmed = rawLine.trim();
+                const eq = trimmed.indexOf('=');
+                if (eq !== -1 && trimmed.slice(0, eq).trim() === key) {
+                    out += newLine + '\n';
+                    replaced = true;
+                }
+                else {
+                    out += rawLine + '\n';
+                }
+            }
+        }
+        if (!replaced)
+            out += newLine + '\n';
+        writeFileSync(p, out, { mode: 0o600 });
+        try {
+            chmodSync(p, 0o600);
+        }
+        catch { }
+        process.env[key] = value;
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Config (non-secret)
+// ---------------------------------------------------------------------------
+export function loadAgenticConfig(projectDir) {
+    const p = configPath(projectDir);
+    let cfg = { ...DEFAULT_CONFIG };
+    try {
+        if (existsSync(p))
+            cfg = { ...cfg, ...JSON.parse(readFileSync(p, 'utf-8')) };
+    }
+    catch { }
+    // hasKey = true if any provider key is set (read from .env.local VK_*_KEY)
+    let hasKey = false;
+    try {
+        for (const prov of SUPPORTED_PROVIDERS) {
+            if (getProviderSpecificKey(projectDir, prov)) {
+                hasKey = true;
+                break;
+            }
+        }
+    }
+    catch { }
+    return { ...cfg, hasKey };
+}
+export function saveAgenticConfig(projectDir, patch) {
+    const p = configPath(projectDir);
+    const current = loadAgenticConfig(projectDir);
+    const next = { ...DEFAULT_CONFIG, ...current, ...patch };
+    // never store apiKey in config.json
+    const toWrite = { provider: next.provider, model: next.model, mode: next.mode, maxSteps: next.maxSteps };
+    if (next.baseUrl)
+        toWrite.baseUrl = next.baseUrl;
+    try {
+        mkdirSync(dirname(p), { recursive: true });
+        writeFileSync(p, JSON.stringify(toWrite, null, 2), 'utf-8');
+    }
+    catch { }
+    return next;
+}
+// ---------------------------------------------------------------------------
+// Masking
+// ---------------------------------------------------------------------------
+export function maskApiKey(apiKey) {
+    if (!apiKey)
+        return null;
+    const trimmed = apiKey.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.length <= 8)
+        return '***';
+    return trimmed.slice(0, 7) + '***' + trimmed.slice(-4);
+}
+// aliases for "masked preview per provider" requirement — multiple names for compatibility
+export const maskKey = maskApiKey;
+export const maskedPreview = maskApiKey;
+export function getMaskedKey(projectDir, provider) {
+    return getKeyPreview(projectDir, provider);
+}
+export function getApiKeyPreview(projectDir, provider) {
+    return getKeyPreview(projectDir, provider);
+}
+export function getMaskedPreview(projectDir, provider) {
+    return getKeyPreview(projectDir, provider);
+}
+export function getKeyPreview(projectDir, provider) {
+    // preview per provider — mask the result of getApiKey (which includes fallback to legacy/generic)
+    // This matches spec: getApiKey with provider checks env provider, file, legacy, generic
+    const key = getApiKey(projectDir, provider);
+    return maskApiKey(key);
+}
+// internal helper for per-provider direct lookup (no legacy/generic fallback)
+function getProviderSpecificKey(projectDir, provider) {
+    if (!provider || !provider.trim())
+        return null;
+    const prov = provider.trim();
+    // 0. .env.local VK_*_KEY (primary) — process.env reflects the file at startup
+    const dotenvName = providerDotenvVar(prov);
+    const dotenvEnv = process.env[dotenvName];
+    if (dotenvEnv && dotenvEnv.trim())
+        return dotenvEnv.trim();
+    const dotenvFile = readDotenvValue(projectDir, dotenvName);
+    if (dotenvFile && dotenvFile.trim())
+        return dotenvFile.trim();
+    // 1. legacy per-provider file (compat fallback)
+    try {
+        const pp = providerKeyPath(projectDir, prov);
+        if (existsSync(pp)) {
+            const v = readFileSync(pp, 'utf-8').trim();
+            if (v)
+                return v;
+        }
+    }
+    catch { }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Per-provider keys
+// ---------------------------------------------------------------------------
+/**
+ * Save an API key for a specific provider.
+ *
+ * Supports both new 3-arg form `saveApiKey(projectDir, provider, apiKey)`
+ * and legacy 2-arg form `saveApiKey(projectDir, apiKey)` for backward compat.
+ * Keys are stored in project `.env.local` as VK_{PROVIDER}_KEY (0600).
+ * The legacy 2-arg form targets the currently-configured provider.
+ */
+export function saveApiKey(projectDir, providerOrApiKey, apiKeyMaybe) {
+    let provider;
+    let apiKey;
+    if (apiKeyMaybe === undefined) {
+        // legacy 2-arg — target the currently-configured provider
+        provider = loadAgenticConfig(projectDir).provider;
+        apiKey = providerOrApiKey;
+    }
+    else {
+        provider = providerOrApiKey;
+        apiKey = apiKeyMaybe;
+    }
+    if (typeof apiKey !== 'string')
+        apiKey = String(apiKey ?? '');
+    if (provider !== null) {
+        provider = provider.trim();
+        if (!provider)
+            provider = null;
+    }
+    if (provider) {
+        // Primary: write/update the provider line in project .env.local (VK_*_KEY)
+        const dotenvName = providerDotenvVar(provider);
+        writeDotenvValue(projectDir, dotenvName, apiKey);
+    }
+    else {
+        // no provider configured — fall back to the openai line
+        writeDotenvValue(projectDir, providerDotenvVar('openai'), apiKey);
+    }
+}
+/**
+ * Get API key for a provider.
+ * Precedence:
+ *   1. .env.local VK_{PROVIDER}_KEY (primary store; reflected in process.env)
+ *   2. (fallback) legacy .vesk/agentic/keys/{provider}.key
+ * If `provider` is omitted, returns the key for the currently-configured
+ * provider, else null.
+ */
+export function getApiKey(projectDir, provider) {
+    const hasProvider = typeof provider === 'string' && provider.trim().length > 0;
+    if (hasProvider) {
+        const prov = provider.trim();
+        const dotenvName = providerDotenvVar(prov);
+        if (process.env[dotenvName] && process.env[dotenvName].trim())
+            return process.env[dotenvName].trim();
+        try {
+            const df = readDotenvValue(projectDir, dotenvName);
+            if (df && df.trim())
+                return df.trim();
+        }
+        catch { }
+        try {
+            const pp = providerKeyPath(projectDir, prov);
+            if (existsSync(pp)) {
+                const v = readFileSync(pp, 'utf-8').trim();
+                if (v)
+                    return v;
+            }
+        }
+        catch { }
+        return null;
+    }
+    else {
+        const prov = normalizeProvider(loadAgenticConfig(projectDir).provider);
+        const dotenvName = providerDotenvVar(prov);
+        if (process.env[dotenvName] && process.env[dotenvName].trim())
+            return process.env[dotenvName].trim();
+        try {
+            const df = readDotenvValue(projectDir, dotenvName);
+            if (df && df.trim())
+                return df.trim();
+        }
+        catch { }
+        return null;
+    }
+}
+// hasKey / hasApiKey — per-provider check
+export function hasApiKey(projectDirOrProvider, providerMaybe) {
+    let projectDir;
+    let provider;
+    if (providerMaybe !== undefined) {
+        projectDir = projectDirOrProvider;
+        provider = providerMaybe;
+    }
+    else {
+        // single arg — could be provider name or projectDir
+        const arg = projectDirOrProvider;
+        // heuristic: if arg is a known provider or doesn't look like a path, treat as provider with cwd
+        const isProviderName = SUPPORTED_PROVIDERS.includes(arg) || SUPPORTED_PROVIDERS.includes(arg.toLowerCase());
+        const looksLikePath = arg.includes('/') || arg.includes('\\') || arg.startsWith('.') || arg.includes(':');
+        if (isProviderName && !looksLikePath) {
+            projectDir = process.cwd();
+            provider = arg;
+        }
+        else if (!looksLikePath && /^[a-z0-9_.-]+$/i.test(arg) && arg.length < 30 && !existsSync(resolve(arg, '.vesk'))) {
+            // ambiguous short string without path separators — treat as provider if it's in supported list or single word
+            // but to avoid false positive for projectDir like "/tmp/foo", we check existsSync for .vesk fallback above.
+            // If it doesn't look like a path and is known provider, already handled; otherwise treat as projectDir without provider
+            // For safety, if arg matches provider pattern and is short, consider it provider.
+            // We'll default to projectDir without provider for hasKey(projectDir) calls.
+            // To cover both, check if arg is supported provider else treat as projectDir
+            if (SUPPORTED_PROVIDERS.includes(arg.toLowerCase())) {
+                projectDir = process.cwd();
+                provider = arg;
+            }
+            else {
+                projectDir = arg;
+                provider = undefined;
+            }
+        }
+        else {
+            projectDir = arg;
+            provider = undefined;
+        }
+    }
+    return !!getApiKey(projectDir, provider);
+}
+// primary name "hasKey" per prompt
+export const hasKey = hasApiKey;
+// additional alias used in some codebases
+export const hasApiKeys = hasApiKey;
+// listApiKeys
+export function listApiKeys(projectDir) {
+    const out = {};
+    const seen = new Set(SUPPORTED_PROVIDERS);
+    // discover additional providers from .env.local VK_*_KEY lines
+    try {
+        const p = dotenvPath(projectDir);
+        if (existsSync(p)) {
+            for (const rawLine of readFileSync(p, 'utf-8').split('\n')) {
+                const trimmed = rawLine.trim();
+                if (!trimmed.startsWith('VK_') || !trimmed.endsWith('_KEY=') && !trimmed.includes('_KEY='))
+                    continue;
+                const eq = trimmed.indexOf('=');
+                if (eq === -1)
+                    continue;
+                const k = trimmed.slice(0, eq).trim();
+                if (!k.startsWith('VK_') || !k.endsWith('_KEY'))
+                    continue;
+                const prov = k.slice(3, -4).toLowerCase().replace(/_/g, '-');
+                if (prov)
+                    seen.add(prov);
+            }
+        }
+    }
+    catch { }
+    // also consider VK_*_KEY env vars not in seen
+    try {
+        for (const k of Object.keys(process.env)) {
+            if (k.startsWith('VK_') && k.endsWith('_KEY')) {
+                const prov = k.slice(3, -4).toLowerCase().replace(/_/g, '-');
+                if (prov)
+                    seen.add(prov);
+            }
+        }
+    }
+    catch { }
+    for (const p of seen) {
+        try {
+            out[p] = !!getApiKey(projectDir, p);
+        }
+        catch {
+            out[p] = false;
+        }
+    }
+    // Ensure supported providers always present
+    for (const p of SUPPORTED_PROVIDERS)
+        if (!(p in out))
+            out[p] = false;
+    return out;
+}

package/dist/context.d.ts

@@ -0,0 +1,21 @@
+import type { AgentMode } from './permissions.js';
+export interface LiveProjectContext {
+    files?: Array<{
+        path: string;
+        content: string;
+    }>;
+    config?: unknown;
+    diagnostics?: unknown[];
+    plugins?: unknown;
+    git?: unknown;
+    compilerState?: unknown;
+}
+export interface AgentContextLayers {
+    framework: string;
+    projectMd: string;
+    live: LiveProjectContext;
+}
+export declare function loadFrameworkKnowledge(projectDir?: string): string;
+export declare function loadProjectKnowledge(projectDir: string): string;
+export declare function assembleSystemPrompt(layers: AgentContextLayers, mode: AgentMode): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBlE;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAkBxF"}

package/dist/context.js

@@ -0,0 +1,64 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+export function loadFrameworkKnowledge(projectDir) {
+    // Prefer llm.txt at project root or repo root, fallback to minimal built-in knowledge.
+    const candidates = [
+        projectDir ? resolve(projectDir, 'llm.txt') : null,
+        resolve(process.cwd(), 'llm.txt'),
+        resolve(process.cwd(), 'plans', 'devtools.md'),
+    ].filter(Boolean);
+    for (const p of candidates) {
+        try {
+            if (existsSync(p))
+                return readFileSync(p, 'utf-8').slice(0, 8000);
+        }
+        catch { }
+    }
+    return [
+        'Vesk is a compiler-first framework. Components use `component Name { ... }` with expression or statement mode.',
+        'Reactivity: const &[count]=track(0), effect(), derived, islands via #client.',
+        'Routing: app/ file-based, useFetch/stream, Md for markdown.',
+        'Config: vesk.config.ts, plugins via @vesk/plugin-*, dev server is capability-gated.',
+    ].join('\n');
+}
+export function loadProjectKnowledge(projectDir) {
+    const p = resolve(projectDir, 'agents.md');
+    try {
+        if (existsSync(p))
+            return readFileSync(p, 'utf-8').slice(0, 8000);
+    }
+    catch { }
+    // Also try AGENTS.md
+    const p2 = resolve(projectDir, 'AGENTS.md');
+    try {
+        if (existsSync(p2))
+            return readFileSync(p2, 'utf-8').slice(0, 8000);
+    }
+    catch { }
+    return '';
+}
+export function assembleSystemPrompt(layers, mode) {
+    const parts = [];
+    parts.push('# Vesk Framework Knowledge');
+    parts.push(layers.framework || '(no framework docs)');
+    parts.push('\n# Project Knowledge (agents.md)');
+    parts.push(layers.projectMd || '(no project agents.md)');
+    if (layers.live) {
+        parts.push('\n# Live Project Context');
+        if (layers.live.config)
+            parts.push(`Config: ${JSON.stringify(layers.live.config).slice(0, 2000)}`);
+        if (layers.live.diagnostics)
+            parts.push(`Diagnostics: ${JSON.stringify(layers.live.diagnostics).slice(0, 2000)}`);
+        if (layers.live.plugins)
+            parts.push(`Plugins: ${JSON.stringify(layers.live.plugins).slice(0, 2000)}`);
+    }
+    parts.push(`\n# Mode: ${mode}`);
+    if (mode === 'explore')
+        parts.push('You are in Explore (read-only). Do NOT modify files, run commands, or install packages. Explain and analyze only.');
+    if (mode === 'debug')
+        parts.push('You are in Debug. You may read and make controlled fixes to relevant source files and run build/tests, but respect permissions.');
+    if (mode === 'agent')
+        parts.push('You are in Agent. You may act fully within granted capabilities. Always respect the capability table; blocked tools will return errors.');
+    parts.push('\nAlways use Vesk-native tools (vesk.*) when they apply; prefer them over raw filesystem writes.');
+    return parts.join('\n');
+}

package/dist/dev-api.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Dev API router — `createAgentRouter` (B6-plug of plans/devtools.md).
+ *
+ * A self-contained, dependency-injectable router for the agentic
+ * dev-panel HTTP endpoints under `/__vesk/agent/*`. Mirrors the shape of
+ * `createDevApiRouter` from `@vesk/adapter/src/dev-api.ts`:
+ *
+ *     POST /__vesk/agent/run        → run the agent (prompt, mode, providerConfig)
+ *     GET  /__vesk/agent/history    → list checkpoints (history.json)
+ *     POST /__vesk/agent/checkpoint → create a checkpoint
+ *     POST /__vesk/agent/rollback   → rollback to a checkpoint
+ *
+ * ARCHITECTURE: the Dev Server is the ONLY path from browser → project files /
+ * build system. Every endpoint is gated by an `AgentCapability` in
+ * `AgentCapabilityTable` (server-enforced — the browser cannot bypass it).
+ * There is NO raw `child_process` reach: the agent's `command.execute` tool
+ * routes through the dev server's allowlisted `runCommand` hook, and file
+ * access is containment-checked.
+ *
+ * Pure (fake injectable inputs, no socket/listener), mirroring
+ * `createPluginStateRouter` / `createDevApiRouter`: returns
+ * `{ route(method, pathname, body, search) }`, yielding `null` for
+ * non-`/ __vesk/agent/*` paths so the dev server can fall through to the
+ * next router (e.g. the adapter's `createDevApiRouter`).
+ *
+ * Zero deps — only local `@vesk/agentic` modules; no npm dependencies
+ * beyond `@vesk/types`.
+ */
+import type { AgentCapabilityTable, AgentMode } from './permissions.js';
+import type { AgentResult, AgentStreamEvent } from './loop.js';
+import type { ProviderConfig } from './providers/types.js';
+import type { Checkpoint } from './checkpoints.js';
+export interface DevPanelResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: string;
+    encoding?: 'utf8' | 'base64';
+    /** When set, `body`/`encoding` are ignored and this async iterable of
+        (already-framed) strings is streamed to the client instead — used for
+        SSE agent progress. */
+    stream?: AsyncIterable<string>;
+}
+export interface AgentRouter {
+    route: (method: string, pathname: string, body?: unknown, search?: string) => Promise<DevPanelResponse | null>;
+}
+export interface AgentRouterOptions {
+    /** Absolute path to the project root (where `vesk.config.ts` lives). */
+    projectDir: string;
+    /** Absolute path to the `app/` directory. */
+    appDir: string;
+    /** Absolute path to the `.vesk` state directory. */
+    veskDir: string;
+    /** Current permission snapshot — server-enforced. */
+    getPermissions: () => AgentCapabilityTable;
+    /**
+     * Run the agent for a single turn.
+     * `(prompt, mode, providerConfig) => AgentResult`
+     */
+    runAgent: (prompt: string, mode: AgentMode, providerConfig?: ProviderConfig | unknown) => Promise<AgentResult>;
+    /**
+     * Stream the agent for a single turn. Optional — when provided, the
+     * `/__vesk/agent/run` endpoint responds with an SSE stream of
+     * `AgentStreamEvent`s for `{ stream: true }` requests.
+     */
+    runAgentStream?: (prompt: string, mode: AgentMode, providerConfig?: ProviderConfig | unknown) => AsyncIterable<AgentStreamEvent> | Promise<AsyncIterable<AgentStreamEvent>>;
+    /**
+     * List all checkpoints, newest first. Closure form is typically
+     * `() => manager.list()` or `() => listCheckpoints(projectDir)`.
+     */
+    listCheckpoints?: () => Checkpoint[] | Promise<Checkpoint[]>;
+    /**
+     * Rollback to a checkpoint by id. Closure form is
+     * `(id: string) => Checkpoint | null`.
+     */
+    rollback?: (id: string) => Checkpoint | null | Promise<Checkpoint | null>;
+    /**
+     * Optional injection for checkpoint creation. Signature may be
+     * `(message, changes?, buildResult?) => Checkpoint` or
+     * `(projectDir, message, changes?, buildResult?) => Checkpoint` or
+     * `(opts: CreateCheckpointOptions) => Checkpoint`.
+     */
+    createCheckpoint?: (...args: unknown[]) => Checkpoint | Promise<Checkpoint>;
+}
+export declare function createAgentRouter(opts: AgentRouterOptions): AgentRouter;
+//# sourceMappingURL=dev-api.d.ts.map

package/dist/dev-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-api.d.ts","sourceRoot":"","sources":["../src/dev-api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAenD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B;;8BAE0B;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CACL,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,cAAc,EAAE,MAAM,oBAAoB,CAAC;IAC3C;;;OAGG;IACH,QAAQ,EAAE,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,KACtC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,SAAS,EACf,cAAc,CAAC,EAAE,cAAc,GAAG,OAAO,KACtC,aAAa,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChF;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,UAAU,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7D;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC1E;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7E;AA4HD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CA6pBvE"}