@viewportai/daemon 0.2.0 → 0.3.0

package/dist/workflows/platform-sync.js

@@ -0,0 +1,306 @@
+import { transportFetch } from '../cli/network.js';
+import { runtimeCommands } from './platform-runtime-command.js';
+import { buildReviewPacket } from './review-packet.js';
+export class WorkflowRunPlatformSync {
+    configManager;
+    fetcher;
+    eventOffsets = new Map();
+    latestRuns = new Map();
+    workers = new Map();
+    retryTimers = new Map();
+    blockedPollTimers = new Map();
+    processedCommandIds = new Map();
+    retryDelaysMs;
+    exhaustedRetryDelayMs;
+    blockedPollDelayMs;
+    onRuntimeCommand;
+    constructor(configManager, fetcher = transportFetch, options = {}) {
+        this.configManager = configManager;
+        this.fetcher = fetcher;
+        this.retryDelaysMs = options.retryDelaysMs ?? [1_000, 2_000, 5_000, 10_000, 30_000];
+        this.exhaustedRetryDelayMs = options.exhaustedRetryDelayMs ?? 60_000;
+        this.blockedPollDelayMs = options.blockedPollDelayMs ?? 3_000;
+        this.onRuntimeCommand = options.onRuntimeCommand;
+    }
+    schedule(run) {
+        if (!this.targetFor(run))
+            return;
+        this.latestRuns.set(run.id, cloneRun(run));
+        const timer = this.retryTimers.get(run.id);
+        if (timer) {
+            clearTimeout(timer);
+            this.retryTimers.delete(run.id);
+        }
+        const blockedPollTimer = this.blockedPollTimers.get(run.id);
+        if (blockedPollTimer) {
+            clearTimeout(blockedPollTimer);
+            this.blockedPollTimers.delete(run.id);
+        }
+        if (this.workers.has(run.id))
+            return;
+        this.startWorker(run.id);
+    }
+    async flushPending() {
+        await Promise.all([...this.workers.values()]);
+    }
+    async sync(run) {
+        const target = this.targetFor(run);
+        if (!target)
+            return;
+        const eventOffset = this.eventOffsets.get(run.id) ?? 0;
+        const newEvents = run.events.slice(eventOffset);
+        const reviewPacket = buildReviewPacket(run);
+        const res = await this.fetcher(target.url, {
+            method: 'PATCH',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({
+                credential: target.issueToken,
+                runtime_target_id: target.runtimeTargetId,
+                runtime_run_id: run.id,
+                status: run.status,
+                data_capture_policy: dataCapturePolicy(run),
+                output_snapshot: collectOutputs(run),
+                error_summary: run.error ?? null,
+                started_at: run.startedAt ? new Date(run.startedAt).toISOString() : null,
+                completed_at: run.completedAt ? new Date(run.completedAt).toISOString() : null,
+                ...(reviewPacket ? { review_packet: reviewPacket } : {}),
+                nodes: Object.values(run.nodes).map((node) => ({
+                    node_key: node.id,
+                    title: node.title ?? node.id,
+                    type: node.type,
+                    status: node.status,
+                    session_id: node.sessionId ?? null,
+                    worktree_path: node.worktreePath ?? null,
+                    output: node.output ?? null,
+                    output_snapshot: node.outputs ?? null,
+                    transcript_excerpt: dataCapturePolicy(run).transcripts === 'none' ? null : (node.transcriptExcerpt ?? null),
+                    error: node.error ?? null,
+                    started_at: node.startedAt ? new Date(node.startedAt).toISOString() : null,
+                    completed_at: node.completedAt ? new Date(node.completedAt).toISOString() : null,
+                    metadata: {
+                        ...(node.metadata ?? {}),
+                        approval: node.approval ?? null,
+                        inlineAgents: node.inlineAgents ?? null,
+                        nativeSessionId: node.nativeSessionId ?? null,
+                        exitCode: node.exitCode ?? null,
+                    },
+                })),
+                artifacts: run.artifacts.map((artifact) => ({
+                    node_key: artifact.nodeId,
+                    name: artifact.name,
+                    kind: artifact.kind ?? null,
+                    path: dataCapturePolicy(run).artifacts === 'local_reference' ? artifact.path : artifact.name,
+                    uri: null,
+                    mime_type: null,
+                    digest: artifact.digest ?? readString(artifact.metadata?.['digest']),
+                    metadata: {
+                        ...(artifact.metadata ?? {}),
+                        description: artifact.description ?? null,
+                        sizeBytes: artifact.sizeBytes ?? null,
+                    },
+                })),
+                ...(newEvents.length > 0
+                    ? { events: newEvents.map((event) => formatEvent(run, event)) }
+                    : {}),
+            }),
+            timeoutMs: 5_000,
+            tlsVerify: target.tlsVerify,
+            caCertPath: target.caCertPath,
+            tlsPins: target.tlsPins,
+        });
+        if (!res.ok) {
+            throw new WorkflowPlatformSyncError(`workflow platform sync failed: HTTP ${res.status}`, isRetryableHttpStatus(res.status));
+        }
+        await this.applyRuntimeCommands(run, await readResponseJson(res));
+        this.eventOffsets.set(run.id, run.events.length);
+    }
+    async syncLatest(runId) {
+        let attempts = 0;
+        while (true) {
+            const run = this.latestRuns.get(runId);
+            if (!run)
+                return;
+            try {
+                await this.sync(run);
+            }
+            catch (error) {
+                if (error instanceof WorkflowPlatformSyncError && !error.retryable) {
+                    this.latestRuns.delete(runId);
+                    return;
+                }
+                const delayMs = this.retryDelaysMs[attempts];
+                if (delayMs === undefined) {
+                    this.scheduleExhaustedRetry(runId);
+                    return;
+                }
+                attempts += 1;
+                await delay(delayMs);
+                continue;
+            }
+            if (this.latestRuns.get(runId) === run) {
+                if (run.status === 'blocked') {
+                    this.scheduleBlockedPoll(runId);
+                    return;
+                }
+                this.latestRuns.delete(runId);
+                this.processedCommandIds.delete(runId);
+                return;
+            }
+            attempts = 0;
+        }
+    }
+    startWorker(runId) {
+        const worker = this.syncLatest(runId).finally(() => {
+            this.workers.delete(runId);
+        });
+        this.workers.set(runId, worker);
+    }
+    scheduleExhaustedRetry(runId) {
+        if (!this.latestRuns.has(runId) || this.retryTimers.has(runId))
+            return;
+        const timer = setTimeout(() => {
+            this.retryTimers.delete(runId);
+            if (!this.latestRuns.has(runId) || this.workers.has(runId))
+                return;
+            this.startWorker(runId);
+        }, this.exhaustedRetryDelayMs);
+        timer.unref?.();
+        this.retryTimers.set(runId, timer);
+    }
+    scheduleBlockedPoll(runId) {
+        if (!this.latestRuns.has(runId) || this.blockedPollTimers.has(runId))
+            return;
+        const timer = setTimeout(() => {
+            this.blockedPollTimers.delete(runId);
+            if (!this.latestRuns.has(runId) || this.workers.has(runId))
+                return;
+            this.startWorker(runId);
+        }, this.blockedPollDelayMs);
+        timer.unref?.();
+        this.blockedPollTimers.set(runId, timer);
+    }
+    async applyRuntimeCommands(run, body) {
+        if (!this.onRuntimeCommand || run.status !== 'blocked')
+            return;
+        const commands = runtimeCommands(body);
+        if (commands.length === 0)
+            return;
+        const processed = this.processedCommandIds.get(run.id) ?? new Set();
+        this.processedCommandIds.set(run.id, processed);
+        for (const command of commands) {
+            if (processed.has(command.id))
+                continue;
+            const applied = await this.onRuntimeCommand(command, run);
+            if (applied === false)
+                continue;
+            processed.add(command.id);
+        }
+    }
+    targetFor(run) {
+        const resourceId = run.resourceId;
+        const runtimeTargetId = run.runtimeTargetId;
+        if (!resourceId || !runtimeTargetId || !run.platformRunId)
+            return null;
+        const daemonConfig = this.configManager.getDaemonConfig();
+        const server = daemonConfig?.server ?? {};
+        const relay = daemonConfig?.relay ?? {};
+        const serverUrl = relay.serverUrl ?? server.url;
+        const issueToken = relay.issueToken;
+        if (!serverUrl || !issueToken)
+            return null;
+        if (relay.workspaceId && relay.workspaceId !== resourceId)
+            return null;
+        if (relay.runtimeTargetId && relay.runtimeTargetId !== runtimeTargetId) {
+            return null;
+        }
+        return {
+            url: `${serverUrl.replace(/\/+$/, '')}/api/runtime/workspaces/${encodeURIComponent(resourceId)}/workflow-runs/${encodeURIComponent(run.platformRunId)}/sync`,
+            issueToken,
+            runtimeTargetId,
+            tlsVerify: server.tlsVerify,
+            caCertPath: server.caCertPath,
+            tlsPins: server.tlsPins,
+        };
+    }
+}
+class WorkflowPlatformSyncError extends Error {
+    retryable;
+    constructor(message, retryable) {
+        super(message);
+        this.retryable = retryable;
+        this.name = 'WorkflowPlatformSyncError';
+    }
+}
+function isRetryableHttpStatus(status) {
+    if (status === 408 || status === 409 || status === 425 || status === 429)
+        return true;
+    if (status >= 500)
+        return true;
+    return false;
+}
+function cloneRun(run) {
+    return JSON.parse(JSON.stringify(run));
+}
+async function delay(ms) {
+    if (ms <= 0)
+        return;
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+function readString(value) {
+    return typeof value === 'string' ? value : null;
+}
+async function readResponseJson(res) {
+    try {
+        return await res.json();
+    }
+    catch {
+        return null;
+    }
+}
+function collectOutputs(run) {
+    return Object.fromEntries(Object.values(run.nodes)
+        .filter((node) => typeof node.output === 'string' && node.output.length > 0)
+        .map((node) => [node.id, node.output]));
+}
+function formatEvent(run, event) {
+    const payload = sanitizeEventPayload(run, event);
+    return {
+        runtime_event_id: event.id,
+        node_key: event.nodeId ?? null,
+        type: event.type,
+        severity: eventSeverity(event),
+        message: event.type === 'node-log' && dataCapturePolicy(run).logs === 'metadata'
+            ? 'Node log content redacted by workflow data capture policy.'
+            : event.message,
+        payload,
+        occurred_at: new Date(event.timestamp).toISOString(),
+    };
+}
+function sanitizeEventPayload(run, event) {
+    if (event.type !== 'node-log' || dataCapturePolicy(run).logs === 'content') {
+        return event.data ?? null;
+    }
+    return {
+        source: readString(event.data?.['source']) ?? undefined,
+        stream: readString(event.data?.['stream']) ?? undefined,
+        redacted: true,
+        reason: 'workflow_data_capture_policy',
+    };
+}
+function dataCapturePolicy(run) {
+    return (run.dataCapturePolicy ?? {
+        transcripts: 'none',
+        logs: 'metadata',
+        artifacts: 'metadata',
+    });
+}
+function eventSeverity(event) {
+    if (event.type.includes('failed') || event.type.includes('error'))
+        return 'error';
+    if (event.type.includes('blocked') ||
+        event.type.includes('missing') ||
+        event.type.includes('canceled'))
+        return 'warning';
+    return 'info';
+}
+//# sourceMappingURL=platform-sync.js.map

package/dist/workflows/platform-sync.js.map

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

package/dist/workflows/plugin-loader.d.ts

@@ -0,0 +1,28 @@
+interface LoadedPlugin {
+    name: string;
+    nodes: number;
+    expressions: number;
+}
+export interface PluginLoadResult {
+    loaded: LoadedPlugin[];
+    errors: Array<{
+        name: string;
+        message: string;
+    }>;
+}
+/**
+ * Read `~/.viewport/plugins.json`, dynamic-import each plugin module, and
+ * register its node executors into the runtime registry. Failures during
+ * plugin import never block the daemon — they're collected into the result
+ * and surfaced via the daemon's structured logger.
+ *
+ * Each plugin module's default export must look like:
+ *   { name: string; version: string; nodes?: NodeDefinition[]; expressions?: ExpressionDefinition[] }
+ *
+ * That shape comes from `@viewportai/workflow-sdk`'s `definePlugin()`. The
+ * daemon doesn't enforce the SDK is the source — anything matching the
+ * shape works — but the SDK is the supported way to author it.
+ */
+export declare function loadPlugins(): Promise<PluginLoadResult>;
+export {};
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/workflows/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/workflows/plugin-loader.ts"],"names":[],"mappings":"AAyCA,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAmD7D"}

package/dist/workflows/plugin-loader.js

@@ -0,0 +1,134 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { configDir } from '../core/config.js';
+import { logger } from '../core/logger.js';
+import { registerNodeExecutor } from './node-registry.js';
+const log = logger.child({ component: 'plugin-loader' });
+/**
+ * Plugin manifest schema, mirrored from `@viewportai/workflow-sdk`. The
+ * daemon doesn't take a workspace dependency on the SDK so plugin authors
+ * can ship their plugins independently of daemon releases — but the
+ * manifest contract is the same.
+ */
+const PluginManifestSchema = z
+    .object({
+    plugins: z
+        .array(z
+        .object({
+        name: z.string().min(1),
+        module: z.string().min(1),
+        enabled: z.boolean().optional(),
+    })
+        .strict())
+        .default([]),
+})
+    .strict();
+const RESERVED_NODE_TYPES = new Set([
+    'prompt',
+    'shell',
+    'approval',
+    'gate',
+    'loop',
+    'subflow',
+]);
+/**
+ * Read `~/.viewport/plugins.json`, dynamic-import each plugin module, and
+ * register its node executors into the runtime registry. Failures during
+ * plugin import never block the daemon — they're collected into the result
+ * and surfaced via the daemon's structured logger.
+ *
+ * Each plugin module's default export must look like:
+ *   { name: string; version: string; nodes?: NodeDefinition[]; expressions?: ExpressionDefinition[] }
+ *
+ * That shape comes from `@viewportai/workflow-sdk`'s `definePlugin()`. The
+ * daemon doesn't enforce the SDK is the source — anything matching the
+ * shape works — but the SDK is the supported way to author it.
+ */
+export async function loadPlugins() {
+    const result = { loaded: [], errors: [] };
+    const manifestPath = path.join(configDir(), 'plugins.json');
+    let raw;
+    try {
+        raw = await fs.readFile(manifestPath, 'utf-8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            log.debug('No plugin manifest found at ' + manifestPath);
+            return result;
+        }
+        log.error({ err: error, manifestPath }, 'Failed to read plugin manifest');
+        return result;
+    }
+    let manifest;
+    try {
+        manifest = PluginManifestSchema.parse(JSON.parse(raw));
+    }
+    catch (error) {
+        log.error({ err: error, manifestPath }, 'Invalid plugin manifest schema');
+        return result;
+    }
+    for (const entry of manifest.plugins) {
+        if (entry.enabled === false)
+            continue;
+        try {
+            const moduleSpecifier = path.isAbsolute(entry.module)
+                ? entry.module
+                : path.resolve(configDir(), entry.module);
+            const imported = (await import(moduleSpecifier));
+            const plugin = imported.default;
+            if (!isPluginShape(plugin)) {
+                throw new Error('Plugin default export does not match the expected WorkflowPlugin shape');
+            }
+            const counts = registerPluginNodes(entry.name, plugin);
+            result.loaded.push({ name: entry.name, ...counts });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            log.warn({ plugin: entry.name, message }, 'Skipping plugin (load failed)');
+            result.errors.push({ name: entry.name, message });
+        }
+    }
+    if (result.loaded.length > 0) {
+        log.info({ loaded: result.loaded.map((entry) => entry.name) }, `Loaded ${result.loaded.length} workflow plugin(s)`);
+    }
+    return result;
+}
+function isPluginShape(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    if (typeof candidate.name !== 'string')
+        return false;
+    if (candidate.nodes !== undefined &&
+        (!Array.isArray(candidate.nodes) ||
+            candidate.nodes.some((node) => !isNodeDefinitionShape(node)))) {
+        return false;
+    }
+    return true;
+}
+function isNodeDefinitionShape(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const node = value;
+    return typeof node.type === 'string' && typeof node.execute === 'function';
+}
+function registerPluginNodes(pluginName, plugin) {
+    let nodes = 0;
+    let expressions = 0;
+    for (const definition of plugin.nodes ?? []) {
+        if (RESERVED_NODE_TYPES.has(definition.type)) {
+            log.warn({ plugin: pluginName, type: definition.type }, 'Plugin tried to claim a reserved node type — skipping');
+            continue;
+        }
+        registerNodeExecutor(definition.type, definition.execute);
+        nodes += 1;
+    }
+    // Custom expressions are accepted at the manifest layer for forward
+    // compatibility but the JSONata runtime does not yet expose a binding
+    // surface for them. Track them as loaded so plugin authors can verify
+    // their manifest is being read.
+    expressions = (plugin.expressions ?? []).length;
+    return { nodes, expressions };
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/workflows/plugin-loader.js.map

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

package/dist/workflows/preflight.d.ts

@@ -0,0 +1,9 @@
+import type { WorkflowDefinition, WorkflowPreflightResult } from './types.js';
+import type { ModelInfo } from '../core/agent-registry.js';
+export interface WorkflowCapabilityProvider {
+    availableAgents: () => string[];
+    availableModels?: () => ModelInfo[] | Promise<ModelInfo[]>;
+    directoryPath?: string;
+}
+export declare function preflightWorkflow(definition: WorkflowDefinition, capabilities: WorkflowCapabilityProvider): Promise<WorkflowPreflightResult>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/workflows/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/workflows/preflight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,kBAAkB,EAElB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAM3D,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,MAAM,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,SAAS,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,kBAAkB,EAC9B,YAAY,EAAE,0BAA0B,GACvC,OAAO,CAAC,uBAAuB,CAAC,CA2GlC"}

package/dist/workflows/preflight.js

@@ -0,0 +1,147 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const SAFE_TOOL_NAME = /^[A-Za-z0-9._+/-]+$/;
+const TOOL_PREFLIGHT_TIMEOUT_MS = 5_000;
+export async function preflightWorkflow(definition, capabilities) {
+    const issues = [];
+    const availableAgents = new Set(capabilities.availableAgents());
+    const availableModels = capabilities.availableModels ? await capabilities.availableModels() : [];
+    for (const agent of definition.requires?.agents ?? []) {
+        if (!availableAgents.has(agent)) {
+            issues.push({
+                kind: 'agent',
+                name: agent,
+                message: `Required agent is unavailable: ${agent}`,
+            });
+        }
+    }
+    for (const [nodeId, node] of Object.entries(definition.nodes)) {
+        if (node.type === 'prompt' && node.agent && !availableAgents.has(node.agent)) {
+            issues.push({
+                kind: 'agent',
+                name: node.agent,
+                message: `Node ${nodeId} requires unavailable agent: ${node.agent}`,
+            });
+        }
+        if (node.type === 'prompt') {
+            addModelIssue(issues, availableModels, {
+                nodeId,
+                agent: node.agent,
+                model: node.model,
+                label: `Node ${nodeId}`,
+            });
+            for (const [agentId, inlineAgent] of Object.entries(node.agents ?? {})) {
+                const requiredAgent = inlineAgent.agent ?? node.agent;
+                if (requiredAgent && !availableAgents.has(requiredAgent)) {
+                    issues.push({
+                        kind: 'agent',
+                        name: requiredAgent,
+                        message: `Inline agent ${agentId} on node ${nodeId} requires unavailable agent: ${requiredAgent}`,
+                    });
+                }
+                addModelIssue(issues, availableModels, {
+                    nodeId,
+                    agent: requiredAgent,
+                    model: inlineAgent.model ?? node.model,
+                    label: `Inline agent ${agentId} on node ${nodeId}`,
+                });
+            }
+        }
+        if (node.type === 'loop' && node.body.type === 'prompt') {
+            if (node.body.agent && !availableAgents.has(node.body.agent)) {
+                issues.push({
+                    kind: 'agent',
+                    name: node.body.agent,
+                    message: `Loop body on node ${nodeId} requires unavailable agent: ${node.body.agent}`,
+                });
+            }
+            addModelIssue(issues, availableModels, {
+                nodeId,
+                agent: node.body.agent,
+                model: node.body.model,
+                label: `Loop body on node ${nodeId}`,
+            });
+        }
+        if (node.type === 'approval' &&
+            'onReject' in node &&
+            node.onReject &&
+            'prompt' in node.onReject) {
+            if (node.onReject.agent && !availableAgents.has(node.onReject.agent)) {
+                issues.push({
+                    kind: 'agent',
+                    name: node.onReject.agent,
+                    message: `Rejection prompt on node ${nodeId} requires unavailable agent: ${node.onReject.agent}`,
+                });
+            }
+            addModelIssue(issues, availableModels, {
+                nodeId,
+                agent: node.onReject.agent,
+                model: node.onReject.model,
+                label: `Rejection prompt on node ${nodeId}`,
+            });
+        }
+    }
+    for (const tool of definition.requires?.tools ?? []) {
+        if (!SAFE_TOOL_NAME.test(tool) || !(await hasShellTool(tool))) {
+            issues.push({
+                kind: 'tool',
+                name: tool,
+                message: `Required shell tool is unavailable: ${tool}`,
+            });
+        }
+    }
+    if (definition.requires?.tools?.includes('git') && capabilities.directoryPath) {
+        if (!(await isGitWorkTree(capabilities.directoryPath))) {
+            issues.push({
+                kind: 'tool',
+                name: 'git',
+                message: `Selected directory is not a git repository: ${capabilities.directoryPath}`,
+            });
+        }
+    }
+    return { ok: issues.length === 0, issues };
+}
+function addModelIssue(issues, availableModels, target) {
+    if (!target.model || availableModels.length === 0)
+        return;
+    const isAvailable = availableModels.some((model) => {
+        if (model.value !== target.model)
+            return false;
+        return !target.agent || !model.agentId || model.agentId === target.agent;
+    });
+    if (isAvailable)
+        return;
+    const agentSuffix = target.agent ? ` for agent ${target.agent}` : '';
+    issues.push({
+        kind: 'node',
+        name: target.nodeId,
+        message: `${target.label} requests unavailable model${agentSuffix}: ${target.model}`,
+    });
+}
+async function hasShellTool(tool) {
+    try {
+        await execFileAsync('sh', ['-lc', `command -v ${shellQuote(tool)}`], {
+            timeout: TOOL_PREFLIGHT_TIMEOUT_MS,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+async function isGitWorkTree(directoryPath) {
+    try {
+        await execFileAsync('git', ['-C', directoryPath, 'rev-parse', '--is-inside-work-tree'], {
+            timeout: TOOL_PREFLIGHT_TIMEOUT_MS,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=preflight.js.map