create-principles-disciple 1.80.0 → 1.82.0

package/pd-cli/dist/services/config-doctor.d.ts

@@ -0,0 +1,102 @@
+/**
+ * pd config doctor — Discover and explain PD / OpenClaw configuration state.
+ *
+ * PRI-305: Cutover to .pd/config.yaml.
+ *   - Feature flags and internal agent runtime bindings come from .pd/config.yaml
+ *   - .pd/feature-flags.yaml and .state/workflows.yaml are no longer production inputs
+ *   - Legacy files are detected and reported as warnings
+ *
+ * PRI-299 MVP UX: provides a single, read-only view of:
+ *   - PD workspace config paths (with existence checks)
+ *   - OpenClaw config paths (with existence checks)
+ *   - Effective feature flags from .pd/config.yaml
+ *   - Internal agent runtime binding readiness from .pd/config.yaml
+ *   - Provider/model/auth status (classified)
+ *
+ * Constraints:
+ *   - NEVER reads or returns API key values, env var values, or raw config bytes.
+ *   - All file reads are bounded; YAML/JSON is treated as `unknown` and validated.
+ *   - Missing/malformed config produces a structured warning, never a crash.
+ *   - Failures include `reason` and `nextAction` for operator guidance.
+ */
+export type DoctorClassification = 'healthy' | 'config_missing' | 'auth_missing' | 'needs_probe' | 'rate_limit' | 'unavailable' | 'parse_failure' | 'unknown';
+export type DoctorStatus = 'ok' | 'degraded' | 'failed';
+export interface ConfigPathEntry {
+    path: string;
+    exists: boolean;
+    parseable?: boolean;
+}
+export interface ProviderHealthEntry {
+    provider: string | null;
+    model: string | null;
+    apiKeyEnv: string | null;
+    apiKeyPresent: boolean;
+    classification: DoctorClassification;
+    reason: string;
+    nextAction: string;
+    source: string;
+}
+export interface FeatureFlagSummary {
+    source: string;
+    configPath: string;
+    enabledMvpChannels: string[];
+    disabledFlags: string[];
+    warnings: string[];
+}
+export interface InternalAgentDiagnostics {
+    name: string;
+    enabled: boolean;
+    runtimeProfileId: string;
+    runtimeProfileLabel: string;
+    readiness: 'ready' | 'not_ready' | 'needs_setup' | 'disabled' | 'unknown';
+    provider: string | null;
+    model: string | null;
+    apiKeyEnv: string | null;
+    apiKeyPresent: boolean;
+    reason: string;
+    nextAction: string;
+}
+export interface DoctorOutput {
+    status: DoctorStatus;
+    workspaceDir: string;
+    pdConfigPaths: {
+        workspaceDir: ConfigPathEntry;
+        pdDir: ConfigPathEntry;
+        configYaml: ConfigPathEntry;
+        stateDb: ConfigPathEntry;
+    };
+    openclawConfigPaths: {
+        openclawHome: ConfigPathEntry;
+        openclawConfig: ConfigPathEntry;
+    };
+    featureFlags: FeatureFlagSummary;
+    internalAgents: InternalAgentDiagnostics[];
+    providerHealth: ProviderHealthEntry[];
+    warnings: string[];
+    reason?: string;
+    nextActions: string[];
+    /** Legacy files detected (informational only, not used for resolution) */
+    legacyFilesDetected: string[];
+}
+export declare function getOpenClawHome(): string;
+export declare function getOpenClawConfigPath(): string;
+export interface InspectStateDbOptions {
+    maxRows?: number;
+    maxAgeMs?: number;
+}
+export interface RecentProviderSignal {
+    classification: DoctorClassification;
+    reason: string;
+    observedAt: string | null;
+}
+export interface StateDbSignalResult {
+    signal: RecentProviderSignal | null;
+    dbReachable: boolean;
+    warning?: string;
+}
+export declare function inspectStateDbForProviderSignal(stateDbPath: string, nowMs?: number, opts?: InspectStateDbOptions): Promise<StateDbSignalResult>;
+export interface BuildDoctorInput {
+    workspaceDir: string;
+}
+export declare function buildDoctorOutput(input: BuildDoctorInput): Promise<DoctorOutput>;
+//# sourceMappingURL=config-doctor.d.ts.map

package/pd-cli/dist/services/config-doctor.d.ts.map

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

package/pd-cli/dist/services/config-doctor.js

@@ -0,0 +1,426 @@
+/**
+ * pd config doctor — Discover and explain PD / OpenClaw configuration state.
+ *
+ * PRI-305: Cutover to .pd/config.yaml.
+ *   - Feature flags and internal agent runtime bindings come from .pd/config.yaml
+ *   - .pd/feature-flags.yaml and .state/workflows.yaml are no longer production inputs
+ *   - Legacy files are detected and reported as warnings
+ *
+ * PRI-299 MVP UX: provides a single, read-only view of:
+ *   - PD workspace config paths (with existence checks)
+ *   - OpenClaw config paths (with existence checks)
+ *   - Effective feature flags from .pd/config.yaml
+ *   - Internal agent runtime binding readiness from .pd/config.yaml
+ *   - Provider/model/auth status (classified)
+ *
+ * Constraints:
+ *   - NEVER reads or returns API key values, env var values, or raw config bytes.
+ *   - All file reads are bounded; YAML/JSON is treated as `unknown` and validated.
+ *   - Missing/malformed config produces a structured warning, never a crash.
+ *   - Failures include `reason` and `nextAction` for operator guidance.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import Database from 'better-sqlite3';
+import { loadPdConfig, computeFlagsFromLoadResult, redactLoadResult, getPdConfigPath, } from './pd-config-loader.js';
+import { MVP_CHANNEL_IDS } from '@principles/core/runtime-v2';
+// ─── Helpers ────────────────────────────────────────────────────────────────
+export function getOpenClawHome() {
+    const home = process.env.HOME
+        || process.env.USERPROFILE
+        || (process.env.HOMEDRIVE && process.env.HOMEPATH ? process.env.HOMEDRIVE + process.env.HOMEPATH : '');
+    if (!home)
+        return path.join(process.cwd(), '.openclaw');
+    return path.join(home, '.openclaw');
+}
+export function getOpenClawConfigPath() {
+    return path.join(getOpenClawHome(), 'openclaw.json');
+}
+function pathEntry(p) {
+    return { path: p, exists: fs.existsSync(p) };
+}
+const RATE_LIMIT_KEYWORDS = ['rate_limit', 'rate-limit', '429', 'too many requests', 'rpm exhausted'];
+const AUTH_MISSING_KEYWORDS = ['auth_missing', 'unauthorized', '401', 'api key', 'no api key', 'api_key missing'];
+const UNAVAILABLE_KEYWORDS = ['unavailable', 'model fallback', 'candidate_failed', 'embedded agent failed'];
+function classifyText(text) {
+    const lowered = text.toLowerCase();
+    for (const kw of RATE_LIMIT_KEYWORDS) {
+        if (lowered.includes(kw))
+            return 'rate_limit';
+    }
+    for (const kw of AUTH_MISSING_KEYWORDS) {
+        if (lowered.includes(kw))
+            return 'auth_missing';
+    }
+    for (const kw of UNAVAILABLE_KEYWORDS) {
+        if (lowered.includes(kw))
+            return 'unavailable';
+    }
+    return null;
+}
+const DEFAULT_MAX_ROWS = 50;
+const DEFAULT_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+export async function inspectStateDbForProviderSignal(stateDbPath, nowMs = Date.now(), opts = {}) {
+    const maxRows = opts.maxRows ?? DEFAULT_MAX_ROWS;
+    const maxAgeMs = opts.maxAgeMs ?? DEFAULT_MAX_AGE_MS;
+    if (!fs.existsSync(stateDbPath)) {
+        return { signal: null, dbReachable: false };
+    }
+    let db;
+    try {
+        db = new Database(stateDbPath, { readonly: true, fileMustExist: true });
+    }
+    catch (err) {
+        return {
+            signal: null,
+            dbReachable: false,
+            warning: `state.db present but readonly open failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    try {
+        const tableInfo = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='tasks'").get();
+        if (!tableInfo) {
+            return { signal: null, dbReachable: true, warning: 'state.db has no tasks table — pipeline not initialized yet' };
+        }
+        const taskCols = db.prepare("PRAGMA table_info(tasks)").all();
+        const taskColNames = new Set(taskCols.map((c) => c.name));
+        const hasErrorMessage = taskColNames.has('error_message');
+        const hasLastErrorMessage = taskColNames.has('last_error_message');
+        const hasFailureCategory = taskColNames.has('failure_category');
+        const hasErrorCategory = taskColNames.has('error_category');
+        const hasUpdatedAt = taskColNames.has('updated_at');
+        const hasLastErrorAt = taskColNames.has('last_error_at');
+        const hasCreatedAt = taskColNames.has('created_at');
+        if (!hasErrorMessage && !hasLastErrorMessage) {
+            return { signal: null, dbReachable: true, warning: 'state.db tasks table has no error_message column — provider signal unavailable' };
+        }
+        const errorCol = hasErrorMessage ? 'error_message' : 'last_error_message';
+        const tsCol = hasUpdatedAt ? 'updated_at' : hasLastErrorAt ? 'last_error_at' : hasCreatedAt ? 'created_at' : null;
+        const tsExpr = tsCol ? `, ${tsCol} AS ts` : '';
+        const whereExpr = tsCol ? `WHERE ${tsCol} >= ?` : '';
+        const params = tsCol ? [nowMs - maxAgeMs] : [];
+        const rows = db.prepare(`SELECT ${errorCol} AS error${tsExpr} FROM tasks ${whereExpr} ORDER BY rowid DESC LIMIT ?`).all(...params, maxRows);
+        let mostRecentObservedAt = null;
+        let aggregate = '';
+        for (const row of rows) {
+            if (typeof row.error !== 'string')
+                continue;
+            aggregate += ` ${row.error}`;
+            if (typeof row.ts === 'number' && (mostRecentObservedAt === null || row.ts > mostRecentObservedAt)) {
+                mostRecentObservedAt = row.ts;
+            }
+        }
+        if (hasErrorCategory || hasFailureCategory) {
+            const catCol = hasErrorCategory ? 'error_category' : 'failure_category';
+            const catRows = db.prepare(`SELECT ${catCol} AS cat${tsCol ? `, ${tsCol} AS ts` : ''} FROM tasks WHERE ${catCol} IS NOT NULL ${tsCol ? `AND ${tsCol} >= ?` : ''} ORDER BY rowid DESC LIMIT ?`).all(...(tsCol ? [nowMs - maxAgeMs] : []), maxRows);
+            for (const row of catRows) {
+                if (typeof row.cat === 'string') {
+                    aggregate += ` ${row.cat}`;
+                }
+            }
+        }
+        const classification = classifyText(aggregate);
+        if (classification === null) {
+            return { signal: null, dbReachable: true };
+        }
+        return {
+            signal: {
+                classification,
+                reason: `Recent task error matches '${classification}' signature (state.db scan)`,
+                observedAt: mostRecentObservedAt ? new Date(mostRecentObservedAt).toISOString() : null,
+            },
+            dbReachable: true,
+        };
+    }
+    catch (err) {
+        return {
+            signal: null,
+            dbReachable: false,
+            warning: `state.db scan failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    finally {
+        try {
+            db.close();
+        }
+        catch { /* best effort */ }
+    }
+}
+// ─── Internal Agent Diagnostics from .pd/config.yaml ─────────────────────────
+function diagnoseInternalAgent(agent, profile) {
+    if (!agent.enabled) {
+        return {
+            name: agent.name,
+            enabled: false,
+            runtimeProfileId: agent.runtimeProfileId,
+            runtimeProfileLabel: agent.runtimeProfileLabel,
+            readiness: 'disabled',
+            provider: null,
+            model: null,
+            apiKeyEnv: null,
+            apiKeyPresent: false,
+            reason: `${agent.name} is disabled in .pd/config.yaml`,
+            nextAction: `Set internalAgents.agents.${agent.name}.enabled=true in .pd/config.yaml to enable`,
+        };
+    }
+    // Agent is enabled — check profile readiness
+    if (!profile) {
+        return {
+            name: agent.name,
+            enabled: true,
+            runtimeProfileId: agent.runtimeProfileId,
+            runtimeProfileLabel: agent.runtimeProfileLabel,
+            readiness: 'needs_setup',
+            provider: null,
+            model: null,
+            apiKeyEnv: null,
+            apiKeyPresent: false,
+            reason: `Runtime profile '${agent.runtimeProfileId}' not found in .pd/config.yaml`,
+            nextAction: `Add runtime profile '${agent.runtimeProfileId}' to .pd/config.yaml runtimeProfiles, or change the agent's runtimeProfile reference`,
+        };
+    }
+    // Check apiKeyEnv for pi-ai profiles
+    if (profile.type === 'pi-ai') {
+        const apiKeyEnv = profile.apiKeyEnv ?? null;
+        const apiKeyPresent = !!apiKeyEnv && Object.prototype.hasOwnProperty.call(process.env, apiKeyEnv) && !!process.env[apiKeyEnv];
+        if (!apiKeyEnv) {
+            return {
+                name: agent.name,
+                enabled: true,
+                runtimeProfileId: agent.runtimeProfileId,
+                runtimeProfileLabel: agent.runtimeProfileLabel,
+                readiness: 'needs_setup',
+                provider: null,
+                model: null,
+                apiKeyEnv: null,
+                apiKeyPresent: false,
+                reason: `pi-ai profile '${profile.id}' missing apiKeyEnv`,
+                nextAction: `Add apiKeyEnv to runtime profile '${profile.id}' in .pd/config.yaml`,
+            };
+        }
+        if (!apiKeyPresent) {
+            return {
+                name: agent.name,
+                enabled: true,
+                runtimeProfileId: agent.runtimeProfileId,
+                runtimeProfileLabel: agent.runtimeProfileLabel,
+                readiness: 'needs_setup',
+                provider: null,
+                model: null,
+                apiKeyEnv,
+                apiKeyPresent: false,
+                reason: `Environment variable '${apiKeyEnv}' is not set or empty`,
+                nextAction: `Set the environment variable '${apiKeyEnv}' with a valid API key`,
+            };
+        }
+        // pi-ai with key present — check state.db for signals
+        return {
+            name: agent.name,
+            enabled: true,
+            runtimeProfileId: agent.runtimeProfileId,
+            runtimeProfileLabel: agent.runtimeProfileLabel,
+            readiness: 'not_ready', // runtime availability unknown without actual probe
+            provider: null,
+            model: null,
+            apiKeyEnv,
+            apiKeyPresent: true,
+            reason: `pi-ai profile configured with apiKeyEnv='${apiKeyEnv}' (key present); runtime availability unknown`,
+            nextAction: 'Run pd runtime probe to verify end-to-end connectivity',
+        };
+    }
+    // OpenClaw profile
+    if (profile.readiness === 'needs_setup') {
+        return {
+            name: agent.name,
+            enabled: true,
+            runtimeProfileId: agent.runtimeProfileId,
+            runtimeProfileLabel: agent.runtimeProfileLabel,
+            readiness: 'needs_setup',
+            provider: null,
+            model: null,
+            apiKeyEnv: null,
+            apiKeyPresent: false,
+            reason: `OpenClaw profile '${profile.id}' needs setup (missing provider/model)`,
+            nextAction: `Configure provider and model in runtime profile '${profile.id}' in .pd/config.yaml`,
+        };
+    }
+    return {
+        name: agent.name,
+        enabled: true,
+        runtimeProfileId: agent.runtimeProfileId,
+        runtimeProfileLabel: agent.runtimeProfileLabel,
+        readiness: 'ready',
+        provider: null,
+        model: null,
+        apiKeyEnv: null,
+        apiKeyPresent: false,
+        reason: `OpenClaw profile '${profile.id}' is configured and ready`,
+        nextAction: 'No action required',
+    };
+}
+export async function buildDoctorOutput(input) {
+    const workspaceDir = path.resolve(input.workspaceDir);
+    const pdDir = path.join(workspaceDir, '.pd');
+    const configYamlPath = getPdConfigPath(workspaceDir);
+    const stateDbPath = path.join(pdDir, 'state.db');
+    // 1) Load PD config from .pd/config.yaml
+    const loadResult = loadPdConfig(workspaceDir);
+    const flags = computeFlagsFromLoadResult(loadResult);
+    const redacted = redactLoadResult(loadResult);
+    // 2) Feature flag summary
+    const enabledMvpChannels = [];
+    const disabledFlags = [];
+    for (const flag of Object.values(flags.flags)) {
+        if (flag.enabled && MVP_CHANNEL_IDS.includes(flag.id)) {
+            enabledMvpChannels.push(flag.id);
+        }
+        else if (!flag.enabled) {
+            disabledFlags.push(flag.id);
+        }
+    }
+    const featureFlags = {
+        source: loadResult.ok ? loadResult.source : 'malformed',
+        configPath: loadResult.configPath,
+        enabledMvpChannels,
+        disabledFlags,
+        warnings: flags.warnings,
+    };
+    // 3) Internal agent diagnostics from .pd/config.yaml
+    const profileMap = new Map();
+    for (const p of redacted.runtimeProfiles) {
+        profileMap.set(p.id, p);
+    }
+    const internalAgents = [];
+    for (const agent of redacted.agents) {
+        const profile = profileMap.get(agent.runtimeProfileId);
+        internalAgents.push(diagnoseInternalAgent(agent, profile));
+    }
+    // 4) Provider health — derived from internal agents that are enabled
+    const providerHealth = [];
+    const warnings = [];
+    const nextActions = [];
+    // Add config-level warnings
+    warnings.push(...loadResult.warnings);
+    warnings.push(...flags.warnings);
+    if (!loadResult.ok) {
+        for (const err of loadResult.errors) {
+            warnings.push(`Config error at ${err.path}: ${err.reason}`);
+        }
+        nextActions.push(loadResult.errors[0]?.nextAction ?? 'Fix .pd/config.yaml and retry');
+    }
+    // Check for enabled agents that need setup
+    const needsSetupAgents = internalAgents.filter(a => a.enabled && (a.readiness === 'needs_setup' || a.readiness === 'not_ready'));
+    for (const agent of needsSetupAgents) {
+        // not_ready = key present but not probed → needs_probe (degraded), NOT auth_missing (failed)
+        const classification = agent.readiness === 'needs_setup'
+            ? 'config_missing'
+            : 'needs_probe';
+        providerHealth.push({
+            provider: null,
+            model: null,
+            apiKeyEnv: agent.apiKeyEnv,
+            apiKeyPresent: agent.apiKeyPresent,
+            classification,
+            reason: agent.reason,
+            nextAction: agent.nextAction,
+            source: 'config.yaml',
+        });
+    }
+    // Check state.db for rate-limit / unavailable signals for enabled agents
+    const readyAgents = internalAgents.filter(a => a.enabled && a.readiness === 'ready');
+    if (readyAgents.length > 0) {
+        const signalResult = await inspectStateDbForProviderSignal(stateDbPath);
+        if (signalResult.warning) {
+            warnings.push(signalResult.warning);
+        }
+        if (signalResult.signal) {
+            const { classification: cls, reason: rsn } = signalResult.signal;
+            providerHealth.push({
+                provider: null,
+                model: null,
+                apiKeyEnv: null,
+                apiKeyPresent: false,
+                classification: cls,
+                reason: rsn,
+                nextAction: cls === 'rate_limit'
+                    ? "Wait for the provider's rate limit to reset, or reduce request rate"
+                    : 'Provider/model temporarily unavailable. Try a different model or retry later.',
+                source: 'state.db',
+            });
+        }
+        else {
+            providerHealth.push({
+                provider: null,
+                model: null,
+                apiKeyEnv: null,
+                apiKeyPresent: false,
+                classification: 'healthy',
+                reason: 'Config is valid; no recent error signals in state.db',
+                nextAction: 'Run pd runtime probe to verify end-to-end connectivity',
+                source: 'config.yaml',
+            });
+        }
+    }
+    // 5) Compute overall status
+    let status = 'ok';
+    const classifications = providerHealth.map((p) => p.classification);
+    if (classifications.includes('rate_limit') || classifications.includes('unavailable') || classifications.includes('needs_probe')) {
+        status = 'degraded';
+    }
+    if (classifications.includes('auth_missing') || classifications.includes('config_missing')) {
+        status = 'failed';
+    }
+    if (!loadResult.ok) {
+        status = 'failed';
+    }
+    if ((warnings.length > 0) && status === 'ok') {
+        status = 'degraded';
+    }
+    // 6) Reason
+    let reason;
+    if (status === 'failed') {
+        if (!loadResult.ok) {
+            reason = `Config validation failed: ${loadResult.errors.map(e => e.reason).join('; ')}`;
+        }
+        else {
+            const failed = providerHealth.filter((p) => p.classification === 'auth_missing' || p.classification === 'config_missing');
+            reason = failed.length > 0
+                ? `Provider auth/config missing: ${failed.map((p) => p.classification).join(', ')}`
+                : 'Configuration is missing required fields';
+        }
+    }
+    else if (status === 'degraded') {
+        const degraded = providerHealth.filter((p) => p.classification === 'rate_limit' || p.classification === 'unavailable' || p.classification === 'needs_probe');
+        if (degraded.length > 0) {
+            reason = `Provider connectivity degraded: ${degraded.map((p) => p.classification).join(', ')}`;
+        }
+        else if (warnings.length > 0) {
+            reason = `Config warnings present: ${warnings.length} item(s)`;
+        }
+    }
+    // 7) Build output
+    const out = {
+        status,
+        workspaceDir,
+        pdConfigPaths: {
+            workspaceDir: pathEntry(workspaceDir),
+            pdDir: pathEntry(pdDir),
+            configYaml: { ...pathEntry(configYamlPath), parseable: loadResult.ok || !fs.existsSync(configYamlPath) ? true : false },
+            stateDb: pathEntry(stateDbPath),
+        },
+        openclawConfigPaths: {
+            openclawHome: pathEntry(getOpenClawHome()),
+            openclawConfig: pathEntry(getOpenClawConfigPath()),
+        },
+        featureFlags,
+        internalAgents,
+        providerHealth,
+        warnings,
+        nextActions: nextActions.length > 0 ? nextActions : ['All checks passed — configuration is valid'],
+        legacyFilesDetected: loadResult.legacyFilesDetected,
+    };
+    if (reason)
+        out.reason = reason;
+    return out;
+}
+//# sourceMappingURL=config-doctor.js.map

package/pd-cli/dist/services/config-doctor.js.map

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

package/pd-cli/dist/services/console-launcher.d.ts

@@ -0,0 +1,110 @@
+/**
+ * PD Console Launcher — seed-friendly Console startup with port detection,
+ * reuse, and browser opening.
+ *
+ * PRI-300 MVP UX:
+ *   - Default port 3100; auto-falls back to next available if 3100 is busy
+ *   - Reuses a running Console if one is already serving on the chosen port
+ *   - Refuses non-loopback hosts (ERR-049 loopback safety)
+ *   - Opens the system browser on success (skipped under --json)
+ *   - Emits `reason` + `nextAction` for every failure
+ *
+ * Constraints (no daemonization, no public bind, no manual port):
+ *   - Does NOT start a background service
+ *   - Does NOT bind to non-loopback hosts
+ *   - Does NOT require user-configured ports (uses 3100 then 3101..)
+ */
+export type ConsoleStatus = 'reused' | 'started' | 'failed' | 'refused';
+export interface ConsoleLaunchResult {
+    status: ConsoleStatus;
+    url: string;
+    port: number;
+    host: string;
+    workspaceDir: string;
+    reason?: string;
+    nextAction?: string;
+    /** True when an existing console was detected and reused. */
+    reused: boolean;
+    /** True when a browser should/has been opened (skipped in --json mode). */
+    browserOpened: boolean;
+}
+export interface ConsoleLaunchOptions {
+    workspaceDir: string;
+    /** Preferred port. Defaults to 3100. */
+    preferredPort?: number;
+    /** Optional override host. Must be loopback; non-loopback is refused. */
+    host?: string;
+    /** When true, the launcher does not open the browser. */
+    skipBrowser?: boolean;
+    /** Timeout in ms to wait for a freshly-spawned console to become ready. */
+    readyTimeoutMs?: number;
+}
+/** Returns true if the host resolves to a loopback address. */
+export declare function isLoopbackHost(host: string): boolean;
+/**
+ * Normalize loopback host for safe use in listen/http.request.
+ * - [::1] → ::1 (strip brackets; Node net/http don't want brackets in host field)
+ * - localhost, 127.x.x.x, ::1 → pass through
+ * - non-loopback → return as-is (caller must reject via isLoopbackHost first)
+ */
+export declare function normalizeLoopbackHost(host: string): string;
+/**
+ * Build a valid Console URL from a normalized loopback host and port.
+ * - IPv6 ::1 → http://[::1]:port (brackets required for valid URL)
+ * - IPv4/localhost → http://host:port (unchanged)
+ */
+export declare function buildConsoleUrl(host: string, port: number): string;
+/** Returns true if the port on the given host accepts a TCP connection. */
+export declare function isPortInUse(host: string, port: number, timeoutMs?: number): Promise<boolean>;
+export interface HealthProbeOptions {
+    host: string;
+    port: number;
+    timeoutMs?: number;
+    /** Optional auth token (PD_CONSOLE_TOKEN) for authenticated health probes. */
+    token?: string;
+}
+/** Probe a port to see if it serves a healthy PD Console. */
+export declare function probeConsoleHealth(opts: HealthProbeOptions): Promise<{
+    healthy: boolean;
+    reason?: string;
+}>;
+/** Find the first available port in [preferred..preferred+limit]. */
+export declare function findAvailablePort(host: string, preferred: number, limit?: number): Promise<number | null>;
+/**
+ * Open the system browser. Best-effort — failures are reported but do not
+ * crash the launcher.
+ */
+export declare function openBrowser(url: string): Promise<{
+    opened: boolean;
+    reason?: string;
+    nextAction?: string;
+}>;
+/**
+ * Orchestrates the seed-friendly Console launch:
+ *   1. Validate the host is loopback (refuse otherwise)
+ *   2. If a healthy console is already running on the preferred port, reuse it
+ *   3. Otherwise find the next available port starting at the preferred one
+ *
+ * NOTE: This function does NOT spawn the server. The caller (CLI command) is
+ * responsible for actually launching the child process; the result returned
+ * here tells the caller which port to bind to and whether the existing port
+ * already serves a console.
+ */
+export interface OrchestratorResult {
+    status: ConsoleStatus;
+    url: string;
+    port: number;
+    host: string;
+    reused: boolean;
+    reason?: string;
+    nextAction?: string;
+}
+export interface OrchestratorInput {
+    workspaceDir: string;
+    preferredPort?: number;
+    host?: string;
+    /** Optional auth token for health probes (PD_CONSOLE_TOKEN). */
+    token?: string;
+}
+export declare function planConsoleLaunch(input: OrchestratorInput): Promise<OrchestratorResult>;
+//# sourceMappingURL=console-launcher.d.ts.map