@lobu/cli 5.0.0 → 6.0.0

package/dist/commands/_lib/apply/apply-cmd.js

@@ -0,0 +1,183 @@
+import chalk from "chalk";
+import { ApiError, ValidationError } from "../../memory/_lib/errors.js";
+import { printError, printText } from "../../memory/_lib/output.js";
+import { resolveApplyClient, } from "./client.js";
+import { computeDiff, } from "./diff.js";
+import { loadDesiredState } from "./desired-state.js";
+import { confirmPlan } from "./prompt.js";
+import { renderMissingSecrets, renderPlan, renderProgress } from "./render.js";
+// ── Required-secrets check ─────────────────────────────────────────────────
+/**
+ * v1 secret check: every `$VAR` referenced in lobu.toml must be present in
+ * the apply runner's environment. The file-loader already substitutes envs
+ * in-place during gateway boot, so this is the same set of names operators
+ * must satisfy at runtime — surfacing it pre-mutation gives the operator
+ * a cleaner failure than a silent empty-string config push.
+ *
+ * Plan §7 reserves cloud-side secret-list cross-checks for v3.
+ */
+function checkRequiredSecrets(state) {
+    const missing = state.requiredSecrets.filter((name) => process.env[name] === undefined || process.env[name] === "");
+    return { missing };
+}
+// ── Snapshot ───────────────────────────────────────────────────────────────
+async function fetchRemoteSnapshot(client, state, only) {
+    const agents = only === "memory" ? [] : await client.listAgents();
+    const agentSettings = new Map();
+    const platformsByAgent = new Map();
+    if (only !== "memory") {
+        const desiredAgentIds = state.agents.map((a) => a.metadata.agentId);
+        const remoteAgentIds = new Set(agents.map((a) => a.agentId));
+        // Only GET settings for agents that exist; new agents have no remote
+        // settings to compare against.
+        const targetAgentIds = desiredAgentIds.filter((id) => remoteAgentIds.has(id));
+        for (const agentId of targetAgentIds) {
+            agentSettings.set(agentId, await client.getAgentSettings(agentId));
+            platformsByAgent.set(agentId, await client.listPlatforms(agentId));
+        }
+    }
+    const entityTypes = only === "agents" ? [] : await client.listEntityTypes();
+    const relationshipTypes = only === "agents" ? [] : await client.listRelationshipTypes();
+    return {
+        agents,
+        agentSettings,
+        platformsByAgent,
+        entityTypes,
+        relationshipTypes,
+    };
+}
+/**
+ * Execute the plan in dependency order. Plan §footgun-7: agents → settings →
+ * connections → entity types → relationship types. No retry loop, no
+ * topological sort. First failure prints partial progress and re-throws.
+ */
+async function executePlan(ctx) {
+    const rowsByKind = (kind) => ctx.plan.rows.filter((row) => row.kind === kind && row.verb !== "noop" && row.verb !== "drift");
+    // 1) Agents
+    for (const row of rowsByKind("agent")) {
+        if (row.kind !== "agent")
+            continue;
+        if (!row.desired)
+            continue;
+        const desired = ctx.state.agents.find((a) => a.metadata.agentId === row.id);
+        if (!desired)
+            continue;
+        if (row.verb === "create") {
+            await ctx.client.upsertAgent(desired.metadata);
+        }
+        else {
+            await ctx.client.patchAgentMetadata(row.id, {
+                name: desired.metadata.name,
+                description: desired.metadata.description,
+            });
+        }
+        printText(renderProgress(row.verb, "agent", row.id));
+    }
+    // 2) Settings
+    for (const row of rowsByKind("settings")) {
+        if (row.kind !== "settings")
+            continue;
+        const desired = ctx.state.agents.find((a) => a.metadata.agentId === row.id);
+        if (!desired)
+            continue;
+        await ctx.client.patchAgentSettings(row.id, desired.settings);
+        printText(renderProgress(row.verb, "settings", row.id, row.changedFields ? `(${row.changedFields.join(", ")})` : undefined));
+    }
+    // 3) Platforms
+    for (const row of rowsByKind("platform")) {
+        if (row.kind !== "platform")
+            continue;
+        const desired = row.desired;
+        if (!desired)
+            continue;
+        const result = await ctx.client.upsertPlatform(row.agentId, desired.stableId, {
+            platform: desired.type,
+            ...(desired.name ? { name: desired.name } : {}),
+            config: desired.config,
+        });
+        const detail = result.willRestart
+            ? "(restarted)"
+            : result.noop
+                ? "(noop on server)"
+                : undefined;
+        printText(renderProgress(row.verb, "platform", `${row.agentId}/${row.id}`, detail));
+    }
+    // 4) Entity types
+    for (const row of rowsByKind("entity-type")) {
+        if (row.kind !== "entity-type")
+            continue;
+        if (!row.desired)
+            continue;
+        await ctx.client.upsertEntityType(row.desired);
+        printText(renderProgress(row.verb, "entity-type", row.id));
+    }
+    // 5) Relationship types
+    for (const row of rowsByKind("relationship-type")) {
+        if (row.kind !== "relationship-type")
+            continue;
+        if (!row.desired)
+            continue;
+        await ctx.client.upsertRelationshipType(row.desired);
+        printText(renderProgress(row.verb, "relationship-type", row.id));
+    }
+}
+// ── Top-level command ──────────────────────────────────────────────────────
+export async function applyCommand(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const { state, configPath } = await loadDesiredState({ cwd });
+    printText(chalk.dim(`Config: ${configPath}`));
+    // Required secrets gate: fail before any network mutation.
+    const { missing } = checkRequiredSecrets(state);
+    if (missing.length > 0) {
+        printError(renderMissingSecrets(missing));
+        throw new ValidationError(`${missing.length} required secret${missing.length === 1 ? "" : "s"} missing — see above.`);
+    }
+    const { client, orgSlug } = await resolveApplyClient({
+        url: opts.url,
+        org: opts.org,
+        fetchImpl: opts.fetchImpl,
+    });
+    printText(chalk.dim(`Org: ${orgSlug}`));
+    const remote = await fetchRemoteSnapshot(client, state, opts.only);
+    const plan = computeDiff(state, remote, { only: opts.only });
+    printText(renderPlan(plan));
+    if (opts.dryRun) {
+        printText(chalk.dim("\nDry run — no changes applied."));
+        return;
+    }
+    if (plan.counts.create === 0 && plan.counts.update === 0) {
+        printText(chalk.green("\nNothing to apply."));
+        return;
+    }
+    // Build a plain-text summary for the inquirer prompt — chalk-decorated
+    // text confuses some terminals when re-printed by the prompt library.
+    const { create, update, noop, drift } = plan.counts;
+    const summaryLine = `${create} create, ${update} update, ${noop} noop, ${drift} drift`;
+    const approved = await confirmPlan({
+        yes: opts.yes ?? false,
+        summaryLine,
+    });
+    if (!approved) {
+        printText(chalk.dim("\nCancelled."));
+        return;
+    }
+    printText(chalk.bold("\nApplying:"));
+    try {
+        await executePlan({ client, state, plan });
+        printText(chalk.green("\nApply complete."));
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            printError(`\n${err.message}`);
+        }
+        else if (err instanceof Error) {
+            printError(`\n${err.message}`);
+        }
+        else {
+            printError(`\n${String(err)}`);
+        }
+        printError("Apply halted on first failure. Re-run `lobu apply` once the underlying issue is resolved — every endpoint is idempotent.");
+        throw err;
+    }
+}
+//# sourceMappingURL=apply-cmd.js.map

package/dist/commands/_lib/apply/apply-cmd.js.map

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

package/dist/commands/_lib/apply/client.d.ts

@@ -0,0 +1,130 @@
+import type { AgentSettings } from "@lobu/core";
+export interface RemoteAgent {
+    agentId: string;
+    name: string;
+    description?: string;
+}
+export interface RemoteAgentDetail extends RemoteAgent {
+    settings?: AgentSettings | null;
+}
+export interface RemotePlatform {
+    id: string;
+    platform: string;
+    templateAgentId?: string;
+    config?: Record<string, unknown>;
+    status?: string;
+}
+export interface RemoteEntityType {
+    slug: string;
+    name?: string;
+    description?: string;
+    required?: string[];
+    properties?: Record<string, unknown>;
+}
+export interface RemoteRelationshipType {
+    slug: string;
+    name?: string;
+    description?: string;
+    rules?: Array<{
+        source: string;
+        target: string;
+    }>;
+}
+export interface UpsertPlatformResult {
+    /** Server reports `noop: true` when the desired config matches what's stored. */
+    noop?: boolean;
+    /** When the config materially changed, the live worker is restarted. */
+    willRestart?: boolean;
+    updated?: boolean;
+    created?: boolean;
+    platform?: RemotePlatform;
+}
+export interface UpsertEntityTypeResult {
+    created?: boolean;
+    updated?: boolean;
+    noop?: boolean;
+}
+export interface ApplyClientConfig {
+    apiBaseUrl: string;
+    orgSlug: string;
+    token: string;
+}
+/**
+ * Typed wrappers for the existing server endpoints `lobu apply` calls.
+ *
+ * The class is open over an injectable `fetchImpl` so tests can stub the
+ * network without monkey-patching globals. Real callers leave `fetchImpl`
+ * unset and pick up `globalThis.fetch`.
+ */
+export declare class ApplyClient {
+    private readonly apiBaseUrl;
+    private readonly orgSlug;
+    private readonly token;
+    private readonly fetchImpl;
+    constructor(cfg: ApplyClientConfig, fetchImpl?: typeof fetch);
+    private request;
+    listAgents(): Promise<RemoteAgent[]>;
+    /**
+     * Idempotent create: PR-2 makes `POST /` return 200 with the existing
+     * payload when an agent of the same ID already exists in the same org.
+     * Cross-org collision still surfaces as 409 with a clear `error.code` —
+     * we re-throw verbatim so `lobu apply` can show the operator the link
+     * to the org-scoped IDs issue.
+     */
+    upsertAgent(agent: {
+        agentId: string;
+        name: string;
+        description?: string;
+    }): Promise<RemoteAgent>;
+    patchAgentMetadata(agentId: string, agent: {
+        name?: string;
+        description?: string;
+    }): Promise<void>;
+    getAgentSettings(agentId: string): Promise<AgentSettings | null>;
+    patchAgentSettings(agentId: string, settings: Partial<AgentSettings>): Promise<void>;
+    listPlatforms(agentId: string): Promise<RemotePlatform[]>;
+    /**
+     * Stable-ID upsert.
+     *
+     * Server contract:
+     *   PUT /:agentId/platforms/by-stable-id/:stableId
+     *   body: { platform, name?, config }
+     *   response when unchanged: { noop: true, platform }
+     *   response when changed:   { updated: true, willRestart: true, platform }
+     *   response on first write: { created: true, platform }
+     */
+    upsertPlatform(agentId: string, stableId: string, payload: {
+        platform: string;
+        name?: string;
+        config: Record<string, string>;
+    }): Promise<UpsertPlatformResult>;
+    listEntityTypes(): Promise<RemoteEntityType[]>;
+    upsertEntityType(entity: {
+        slug: string;
+        name?: string;
+        description?: string;
+        required?: string[];
+        properties?: Record<string, unknown>;
+    }): Promise<UpsertEntityTypeResult>;
+    listRelationshipTypes(): Promise<RemoteRelationshipType[]>;
+    upsertRelationshipType(rel: {
+        slug: string;
+        name?: string;
+        description?: string;
+        rules?: Array<{
+            source: string;
+            target: string;
+        }>;
+    }): Promise<UpsertEntityTypeResult>;
+}
+export interface ResolvedClient {
+    client: ApplyClient;
+    apiBaseUrl: string;
+    orgSlug: string;
+}
+export declare function resolveApplyClient(opts: {
+    url?: string;
+    org?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<ResolvedClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/commands/_lib/apply/client.d.ts.map

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

package/dist/commands/_lib/apply/client.js

@@ -0,0 +1,243 @@
+import { resolveApiClient } from "../../../internal/index.js";
+import { ApiError } from "../../memory/_lib/errors.js";
+// ── Shape predicates ───────────────────────────────────────────────────────
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function extractApiError(parsed, status, statusText) {
+    if (typeof parsed.error === "string") {
+        return { message: parsed.error };
+    }
+    if (isRecord(parsed.error)) {
+        const message = typeof parsed.error.message === "string"
+            ? parsed.error.message
+            : `HTTP ${status} ${statusText}`;
+        const code = typeof parsed.error.code === "string" ? parsed.error.code : undefined;
+        return code ? { message, code } : { message };
+    }
+    return { message: `HTTP ${status} ${statusText}` };
+}
+async function parseResponseBody(res, url) {
+    const raw = await res.text();
+    if (!raw)
+        return {};
+    try {
+        const parsed = JSON.parse(raw);
+        return isRecord(parsed) ? parsed : { value: parsed };
+    }
+    catch {
+        throw new ApiError(`Invalid JSON from ${url}: ${raw.slice(0, 500)}`);
+    }
+}
+/**
+ * Typed wrappers for the existing server endpoints `lobu apply` calls.
+ *
+ * The class is open over an injectable `fetchImpl` so tests can stub the
+ * network without monkey-patching globals. Real callers leave `fetchImpl`
+ * unset and pick up `globalThis.fetch`.
+ */
+export class ApplyClient {
+    apiBaseUrl;
+    orgSlug;
+    token;
+    fetchImpl;
+    constructor(cfg, fetchImpl = fetch) {
+        this.apiBaseUrl = cfg.apiBaseUrl;
+        this.orgSlug = cfg.orgSlug;
+        this.token = cfg.token;
+        this.fetchImpl = fetchImpl;
+    }
+    // ── HTTP shape (mirrors openclaw-cmd.ts:postJson, locally scoped) ────────
+    async request(method, path, body, okStatuses = [200, 201, 204]) {
+        const url = `${this.apiBaseUrl}${path}`;
+        const init = {
+            method,
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.token}`,
+            },
+        };
+        if (body !== undefined)
+            init.body = JSON.stringify(body);
+        const res = await this.fetchImpl(url, init);
+        const parsed = await parseResponseBody(res, url);
+        if (!okStatuses.includes(res.status) && !res.ok) {
+            const { message, code } = extractApiError(parsed, res.status, res.statusText);
+            throw new ApiError(`${method} ${path} failed: ${message}${code ? ` [${code}]` : ""}`, res.status);
+        }
+        if (typeof parsed.error === "string" && parsed.error.length > 0) {
+            throw new ApiError(`${method} ${path} returned error: ${parsed.error}`, res.status);
+        }
+        return { status: res.status, body: parsed };
+    }
+    // ── Agents ────────────────────────────────────────────────────────────────
+    async listAgents() {
+        const { body } = await this.request("GET", `/api/${this.orgSlug}/agents`);
+        return body.agents ?? [];
+    }
+    /**
+     * Idempotent create: PR-2 makes `POST /` return 200 with the existing
+     * payload when an agent of the same ID already exists in the same org.
+     * Cross-org collision still surfaces as 409 with a clear `error.code` —
+     * we re-throw verbatim so `lobu apply` can show the operator the link
+     * to the org-scoped IDs issue.
+     */
+    async upsertAgent(agent) {
+        const { body } = await this.request("POST", 
+        // No trailing slash — Hono matches `routes.post('/', ...)` mounted at
+        // `/api/:orgSlug/agents` against `/api/dev/agents`, not `/api/dev/agents/`.
+        `/api/${this.orgSlug}/agents`, agent, [200, 201]);
+        return body;
+    }
+    async patchAgentMetadata(agentId, agent) {
+        await this.request("PATCH", `/api/${this.orgSlug}/agents/${encodeURIComponent(agentId)}`, agent);
+    }
+    async getAgentSettings(agentId) {
+        try {
+            const { body } = await this.request("GET", `/api/${this.orgSlug}/agents/${encodeURIComponent(agentId)}/config`);
+            return body;
+        }
+        catch (err) {
+            if (err instanceof ApiError && err.status === 404)
+                return null;
+            throw err;
+        }
+    }
+    async patchAgentSettings(agentId, settings) {
+        await this.request("PATCH", `/api/${this.orgSlug}/agents/${encodeURIComponent(agentId)}/config`, settings);
+    }
+    // ── Platforms ─────────────────────────────────────────────────────────────
+    async listPlatforms(agentId) {
+        const { body } = await this.request("GET", `/api/${this.orgSlug}/agents/${encodeURIComponent(agentId)}/platforms`);
+        return body.platforms ?? [];
+    }
+    /**
+     * Stable-ID upsert.
+     *
+     * Server contract:
+     *   PUT /:agentId/platforms/by-stable-id/:stableId
+     *   body: { platform, name?, config }
+     *   response when unchanged: { noop: true, platform }
+     *   response when changed:   { updated: true, willRestart: true, platform }
+     *   response on first write: { created: true, platform }
+     */
+    async upsertPlatform(agentId, stableId, payload) {
+        const { body } = await this.request("PUT", `/api/${this.orgSlug}/agents/${encodeURIComponent(agentId)}/platforms/by-stable-id/${encodeURIComponent(stableId)}`, payload);
+        return body;
+    }
+    // ── Memory schema ─────────────────────────────────────────────────────────
+    async listEntityTypes() {
+        const { body } = await this.request("POST", `/api/${this.orgSlug}/manage_entity_schema`, {
+            schema_type: "entity_type",
+            action: "list",
+        });
+        return body.entity_types ?? body.entityTypes ?? [];
+    }
+    async upsertEntityType(entity) {
+        // The admin tool exposes separate `create` / `update` actions and surfaces
+        // duplicates as a structured error code rather than a 4xx. Probe with
+        // `create`; on a duplicate-named-resource code, retry with `update`.
+        try {
+            await this.request("POST", `/api/${this.orgSlug}/manage_entity_schema`, {
+                schema_type: "entity_type",
+                action: "create",
+                ...entity,
+            });
+            return { created: true };
+        }
+        catch (err) {
+            if (err instanceof ApiError && isDuplicateError(err)) {
+                await this.request("POST", `/api/${this.orgSlug}/manage_entity_schema`, { schema_type: "entity_type", action: "update", ...entity });
+                return { updated: true };
+            }
+            throw err;
+        }
+    }
+    async listRelationshipTypes() {
+        const { body } = await this.request("POST", `/api/${this.orgSlug}/manage_entity_schema`, {
+            schema_type: "relationship_type",
+            action: "list",
+        });
+        return body.relationship_types ?? body.relationshipTypes ?? [];
+    }
+    async upsertRelationshipType(rel) {
+        const { rules, ...payload } = rel;
+        let result;
+        try {
+            await this.request("POST", `/api/${this.orgSlug}/manage_entity_schema`, {
+                schema_type: "relationship_type",
+                action: "create",
+                ...payload,
+            });
+            result = { created: true };
+        }
+        catch (err) {
+            if (err instanceof ApiError && isDuplicateError(err)) {
+                await this.request("POST", `/api/${this.orgSlug}/manage_entity_schema`, { schema_type: "relationship_type", action: "update", ...payload });
+                result = { updated: true };
+            }
+            else {
+                throw err;
+            }
+        }
+        // Register rules separately via add_rule. Backend treats add_rule as
+        // idempotent; duplicate-add surfaces a structured error we can swallow.
+        if (rules?.length) {
+            for (const rule of rules) {
+                try {
+                    await this.request("POST", `/api/${this.orgSlug}/manage_entity_schema`, {
+                        schema_type: "relationship_type",
+                        action: "add_rule",
+                        slug: rel.slug,
+                        source_entity_type_slug: rule.source,
+                        target_entity_type_slug: rule.target,
+                    });
+                }
+                catch (err) {
+                    if (err instanceof ApiError && isDuplicateError(err))
+                        continue;
+                    throw err;
+                }
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Recognise duplicate-name errors from the admin tools without substring
+ * matching the user-facing message. The server emits a structured code in
+ * `error.code` (e.g. `entity_type_exists`, `already_exists`) that the
+ * proxy surfaces in the error payload. This helper centralises that check
+ * so we can extend the code list as the server grows.
+ *
+ * Tradeoff: the existing `manage_entity_schema` handler doesn't currently
+ * stamp a stable code for every duplicate path. Until it does, we accept
+ * structured codes when present and fall back to the http status alone
+ * (any 4xx for a `create` action is treated as duplicate-or-bad-payload;
+ * the subsequent `update` will fail noisily on the latter).
+ */
+function isDuplicateError(err) {
+    if (typeof err.status === "number" && err.status >= 400 && err.status < 500) {
+        const message = err.message.toLowerCase();
+        if (message.includes("[entity_type_exists]") ||
+            message.includes("[relationship_type_exists]") ||
+            message.includes("[already_exists]")) {
+            return true;
+        }
+        // Fall back to status-only when no code is stamped. This is loose; we
+        // accept the loss because the v1 plan explicitly limits us to
+        // server endpoints whose error shape we don't control.
+        return err.status === 409 || err.status === 422 || err.status === 400;
+    }
+    return false;
+}
+export async function resolveApplyClient(opts) {
+    const { token, apiBaseUrl, orgSlug } = await resolveApiClient({
+        org: opts.org,
+        apiUrl: opts.url,
+        fetchImpl: opts.fetchImpl,
+    });
+    const client = new ApplyClient({ apiBaseUrl, orgSlug, token }, opts.fetchImpl);
+    return { client, apiBaseUrl, orgSlug };
+}
+//# sourceMappingURL=client.js.map

package/dist/commands/_lib/apply/client.js.map

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

package/dist/commands/_lib/apply/desired-state.d.ts

@@ -0,0 +1,71 @@
+import type { AgentSettings } from "@lobu/core";
+export declare function buildStablePlatformId(agentId: string, type: string, name?: string): string;
+export interface DesiredAgentMetadata {
+    agentId: string;
+    name: string;
+    description?: string;
+}
+export interface DesiredPlatform {
+    /** Stable, content-addressed ID derived from `(agentId, type, name?)`. */
+    stableId: string;
+    type: string;
+    name?: string;
+    /** Raw config from lobu.toml — values may still contain `$VAR` references. */
+    config: Record<string, string>;
+}
+export interface DesiredEntityType {
+    slug: string;
+    name?: string;
+    description?: string;
+    required?: string[];
+    properties?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface DesiredRelationshipType {
+    slug: string;
+    name?: string;
+    description?: string;
+    rules?: Array<{
+        source: string;
+        target: string;
+    }>;
+    metadata?: Record<string, unknown>;
+}
+export interface DesiredAgent {
+    metadata: DesiredAgentMetadata;
+    /**
+     * Settings payload destined for `PATCH /:agentId/config`. Built from the
+     * lobu.toml fields the file-loader currently lifts: networkConfig,
+     * skillsConfig, egressConfig, preApprovedTools, guardrails, toolsConfig,
+     * nixConfig, mcpServers, modelSelection, providerModelPreferences,
+     * installedProviders, identityMd/soulMd/userMd.
+     *
+     * Persistence of egressConfig/preApprovedTools/guardrails depends on PR-1.
+     */
+    settings: Partial<AgentSettings>;
+    platforms: DesiredPlatform[];
+}
+export interface DesiredState {
+    agents: DesiredAgent[];
+    memorySchema: {
+        entityTypes: DesiredEntityType[];
+        relationshipTypes: DesiredRelationshipType[];
+    };
+    /**
+     * Names of env vars referenced as `$NAME` anywhere in lobu.toml. The CLI
+     * surfaces these to the user before mutating remote state so missing
+     * secrets fail loud instead of expanding to empty strings.
+     */
+    requiredSecrets: string[];
+}
+export interface LoadDesiredStateOptions {
+    /** Project root (directory containing `lobu.toml`). */
+    cwd: string;
+    /** Env to resolve `$VAR` refs against; defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+}
+export declare function loadDesiredState(opts: LoadDesiredStateOptions): Promise<{
+    state: DesiredState;
+    configPath: string;
+}>;
+//# sourceMappingURL=desired-state.d.ts.map