@synap-core/cli 1.10.0 → 1.12.2

package/dist/lib/batch-approval.js

@@ -0,0 +1,170 @@
+/**
+ * One-click approval for the agent keys `synap init` mints (V1 D5).
+ *
+ * Codex and Cursor each mint their agent key with `requireApproval`, and
+ * `provisionAgentKey` used to open one review page per key and block on it.
+ * Connecting both meant two pages and two clicks, one after the other.
+ *
+ * Now `init` mints every key that needs approval FIRST (deferred), opens ONE
+ * page (`/approve-agents?keys=…` on the pod admin, backed by
+ * `POST /api/hub/setup/agent/pending/approve-batch`), and polls every key
+ * until the person approves them together. The approved keys are then handed
+ * to the installers through `takePreApprovedKey`, so each installer's own
+ * `provisionAgentKey` call returns the key the person already approved instead
+ * of minting a second one.
+ *
+ * A pod older than the batch door has no `/approve-agents` page: `init`
+ * probes the batch lookup door first and, when it is missing, opens each
+ * key's own review page instead (every pod version serves those).
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { openPodPage } from "./safe-open.js";
+/**
+ * The targets whose installer mints an agent key that needs the person's
+ * approval. Claude Code mints without approval, so it is not here. The installers read their spec from this table
+ * (`installCodex` / `installCursor`), so the pre-mint cannot ask for a key the
+ * installer would not have asked for.
+ */
+export const TARGET_KEY_MINT = {
+    codex: { agentType: "codex", idempotent: true },
+    cursor: { agentType: "cursor", idempotent: true },
+};
+const ready = new Map();
+/** Take (once) the key already minted — and approved — for `agentType`. */
+export function takePreApprovedKey(agentType) {
+    const key = ready.get(agentType);
+    ready.delete(agentType);
+    return key;
+}
+/**
+ * Hand an installer a key that is already approved — the device flow returns
+ * one per agent the person approved with the computer (`device-connect.ts`).
+ * The installer's own `provisionAgentKey` call then takes it instead of minting,
+ * and `approveAgentKeysAtOnce` asks for nothing more for that agent.
+ */
+export function presetApprovedKey(agentType, key) {
+    ready.set(agentType, key);
+}
+/** The ONE review page for several pending keys, on the same origin as a single key's review URL. */
+export function batchReviewUrl(reviewUrl, keyIds) {
+    const origin = new URL(reviewUrl).origin;
+    return `${origin}/approve-agents?keys=${keyIds.map(encodeURIComponent).join(",")}`;
+}
+/**
+ * Does this pod serve the batch approval page? Its lookup door answers 401/400
+ * without a signed-in session; a pod older than it answers 404. Unreachable
+ * reads as "no": the per-key pages work on every pod.
+ */
+export async function podSupportsBatchApproval(podUrl) {
+    const res = await fetch(`${podUrl.replace(/\/$/, "")}/api/hub/setup/agent/pending/lookup`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ keyIds: [] }),
+        signal: AbortSignal.timeout(10_000),
+    }).catch(() => null);
+    return res !== null && res.status !== 404;
+}
+/**
+ * Mint every approval-gated key for `targets`, open one page, wait for all.
+ * Returns the targets the person did NOT approve (rejected, timed out, or
+ * failed to mint): `init` skips those instead of asking again, and prints
+ * one line for each.
+ */
+export async function approveAgentKeysAtOnce(podUrl, humanApiKey, targets, deps = {}) {
+    const provision = deps.provision ?? (await import("./targets.js")).provisionAgentKey;
+    const wait = deps.wait ?? (await import("./key-approval.js")).waitForKeyLive;
+    const openUrl = deps.openUrl ?? (await import("./targets.js")).openBrowserUrl;
+    const supportsBatch = deps.supportsBatch ?? podSupportsBatchApproval;
+    const podBase = podUrl.replace(/\/$/, "");
+    const pending = [];
+    const notApproved = [];
+    const reasons = {};
+    for (const target of targets) {
+        const spec = TARGET_KEY_MINT[target];
+        if (!spec)
+            continue;
+        // Approved already (with the computer, in the device flow): nothing to ask.
+        if (ready.has(spec.agentType))
+            continue;
+        try {
+            const r = await provision(podUrl, humanApiKey, spec.agentType, {
+                idempotent: spec.idempotent,
+                deferApproval: true,
+            });
+            if (r.pending) {
+                pending.push({
+                    target,
+                    agentType: spec.agentType,
+                    hubApiKey: r.hubApiKey,
+                    agentUserId: r.agentUserId,
+                    ...r.pending,
+                });
+            }
+            else {
+                // Already valid (reused) or active on mint: nothing to approve.
+                ready.set(spec.agentType, { hubApiKey: r.hubApiKey, agentUserId: r.agentUserId });
+            }
+        }
+        catch (err) {
+            notApproved.push(target);
+            reasons[target] = err instanceof Error ? err.message : String(err);
+        }
+    }
+    if (pending.length === 0)
+        return { notApproved, reasons };
+    // One key keeps its own review page (which every pod version serves); so do
+    // several on a pod that predates the batch page.
+    const batch = pending.length > 1 && (await supportsBatch(podUrl));
+    const urls = batch
+        ? [batchReviewUrl(pending[0].reviewUrl, pending.map((p) => p.pendingToken))]
+        : pending.map((p) => p.reviewUrl);
+    log.blank();
+    log.info(batch
+        ? `Approve your ${pending.length} agents in one step:`
+        : pending.length > 1
+            ? `Approve each of your ${pending.length} agents:`
+            : "Approve your agent:");
+    for (const url of urls) {
+        log.dim(url);
+        // A pod-supplied link: opened only on this pod's own / pod-admin origin.
+        openPodPage(url, podUrl, openUrl);
+    }
+    process.stdout.write(chalk.dim("  Waiting for approval"));
+    const ticker = setInterval(() => process.stdout.write(chalk.dim(".")), 2000);
+    try {
+        const outcomes = await Promise.allSettled(pending.map((p) => wait({ podUrl: podBase, pendingKey: p.hubApiKey, pendingToken: p.pendingToken, humanApiKey })));
+        process.stdout.write("\n");
+        const { clearPendingAgentKey } = await import("./pod.js");
+        outcomes.forEach((o, i) => {
+            const p = pending[i];
+            const outcome = o.status === "fulfilled" ? o.value : null;
+            if (outcome === "approved") {
+                // Live now: the recorded request is done; the installer writes the key.
+                clearPendingAgentKey(p.agentType, podUrl);
+                ready.set(p.agentType, { hubApiKey: p.hubApiKey, agentUserId: p.agentUserId });
+                return;
+            }
+            notApproved.push(p.target);
+            if (outcome === "rejected") {
+                clearPendingAgentKey(p.agentType, podUrl);
+                reasons[p.target] = "It was declined on the pod.";
+            }
+            else if (outcome === "timeout") {
+                // Still filed and recorded: the next connect resumes this request.
+                reasons[p.target] = `Nobody approved it in time — approve it at ${p.reviewUrl}, then run: synap doctor --fix`;
+            }
+            else {
+                reasons[p.target] = o.status === "rejected" && o.reason instanceof Error ? o.reason.message : String(o.status === "rejected" ? o.reason : "unknown");
+            }
+        });
+    }
+    finally {
+        clearInterval(ticker);
+    }
+    const approved = pending.length - pending.filter((p) => notApproved.includes(p.target)).length;
+    if (approved > 0)
+        log.success(`Approved ${approved} agent${approved > 1 ? "s" : ""}.`);
+    return { notApproved, reasons };
+}
+//# sourceMappingURL=batch-approval.js.map

package/dist/lib/batch-approval.js.map

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

package/dist/lib/capture-lane.d.ts

@@ -31,12 +31,13 @@ export interface LaneReport {
 }
 /**
  * Derive the lane from the workspace-routing `source` returned by
- * `resolveKnowledgeWorkspace`. A domain capture always lands in a real product
- * workspace → the Work lane. (The backend routing endpoint P7b is the SSoT for
- * resolving user/global lanes; the CLI's lane detection is a best-effort hint.)
+ * `resolveKnowledgeWorkspace`. Domain capture is the Work lane (even when
+ * workspaceId is omitted for server-derived / pod-wide preferred placement).
+ * (The backend routing endpoint P7b is the SSoT for resolving user/global
+ * lanes; the CLI's lane detection is a best-effort hint.)
  *
- *   source                              → lane
- *   "explicit" / "team" / "active …"    → work
+ *   source                                           → lane
+ *   "explicit" / "team" / "server-derived …"         → work
  */
 export declare function laneFromSource(_source: string): CaptureLane;
 /** Best-effort resolve a workspace name from the pod. Never throws. */

package/dist/lib/capture-lane.js

@@ -22,12 +22,13 @@ import { hubGet } from "./hub-client.js";
 import { unwrapList } from "./unwrapList.js";
 /**
  * Derive the lane from the workspace-routing `source` returned by
- * `resolveKnowledgeWorkspace`. A domain capture always lands in a real product
- * workspace → the Work lane. (The backend routing endpoint P7b is the SSoT for
- * resolving user/global lanes; the CLI's lane detection is a best-effort hint.)
+ * `resolveKnowledgeWorkspace`. Domain capture is the Work lane (even when
+ * workspaceId is omitted for server-derived / pod-wide preferred placement).
+ * (The backend routing endpoint P7b is the SSoT for resolving user/global
+ * lanes; the CLI's lane detection is a best-effort hint.)
  *
- *   source                              → lane
- *   "explicit" / "team" / "active …"    → work
+ *   source                                           → lane
+ *   "explicit" / "team" / "server-derived …"         → work
  */
 export function laneFromSource(_source) {
     return "work";
@@ -120,16 +121,18 @@ export async function reportWrite(res, o) {
         // A proposal is normal (a PR under review), NOT a failure — neutral tone,
         // never an alarm. The agent keeps composing; it just goes live on approval.
         log.info(`${o.label} — proposed (under review)`);
+        // Full ids — feed straight into `synap proposals approve <id>` /
+        // a follow-up create-relation call referencing the proposed entity.
         if (proposalId)
-            log.dim(`  proposal: ${proposalId.slice(0, 8)}`);
+            log.dim(`  proposal: ${proposalId}`);
         // Expose the stable proposed entity ID so the AI can reference this entity
         // in cross-write proposal graphs (e.g. create entity B linked to entity A).
         const proposedEntityId = String(res.proposedEntityId ?? "");
         if (proposedEntityId)
-            log.dim(`  entity: ${proposedEntityId.slice(0, 8)}`);
+            log.dim(`  entity: ${proposedEntityId}`);
     }
     else {
-        log.success(`${o.label}${id ? "  " + chalk.dim(id.slice(0, 8)) : ""}`);
+        log.success(`${o.label}${id ? "  " + chalk.dim(id) : ""}`);
     }
     console.log("  " + formatLaneLine(report));
 }

package/dist/lib/capture-lane.js.map

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

package/dist/lib/capture-structure.d.ts

@@ -0,0 +1,342 @@
+/**
+ * Shared shapes + honest reporting for the smart-capture pipeline
+ * (POST /capture/structure → POST /capture/execute).
+ *
+ * ONE declaration of the structure/execute wire shapes and ONE degraded/execute
+ * interpreter, imported by BOTH surfaces that drive this pipeline:
+ *   • `synap capture "<free text>"`  (commands/knowledge.ts)
+ *   • `synap import <files|urls>`    (commands/import.ts)
+ *
+ * These two used to keep independent `StructureResult` copies that had already
+ * drifted (import dropped fields knowledge kept). Consolidating here removes the
+ * drift AND the false-success reporting: the CLI now reports what /capture/execute
+ * ACTUALLY returned (applied vs proposed vs nothing-created) instead of guessing
+ * off the planned proposal count.
+ *
+ * Kept local to the CLI (not imported from @synap-core/hub-rest-client) because the
+ * CLI resolves the SDK via its built dist — the same reason the previous local
+ * mirrors existed. This is now the ONE mirror instead of two.
+ */
+export interface StructureProposal {
+    tempId: string;
+    profileSlug: string;
+    title: string;
+    description?: string;
+    properties?: Record<string, unknown>;
+    content?: string;
+    existingEntityId?: string;
+}
+export interface StructureRelation {
+    sourceTempId: string;
+    targetTempId: string;
+    relationType: string;
+}
+export interface FollowUpChip {
+    label: string;
+    value: string;
+    action?: "link_entity" | "set_property" | "add_relation" | "confirm" | "dismiss";
+    entityId?: string;
+    propertyKey?: string;
+}
+export interface FollowUp {
+    question: string;
+    suggestions?: FollowUpChip[];
+}
+/** The distribution behind an AI workspace pick (see the shared type). */
+export interface WorkspaceDecisionRecord {
+    decider: "jev" | "llm";
+    model?: string;
+    probabilities?: Record<string, number>;
+    candidates?: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+/** The placement advice a `capture.structure` result carries (a subset). */
+export interface CaptureStructureRouting {
+    targetWorkspaceId?: string | null;
+    targetWorkspaceReason?: string | null;
+    targetWorkspaceConfidence?: number | null;
+    targetWorkspaceDecision?: WorkspaceDecisionRecord | null;
+    targetProjectId?: string | null;
+    targetProjectReason?: string | null;
+    targetProjectConfidence?: number | null;
+}
+/** The advisory routing fields `capture.execute` accepts. */
+export interface CaptureExecuteRoutingHints {
+    aiWorkspaceId?: string | null;
+    aiWorkspaceConfidence?: number | null;
+    aiWorkspaceReason?: string | null;
+    aiWorkspaceDecision?: WorkspaceDecisionRecord | null;
+    aiProjectId?: string | null;
+    aiProjectConfidence?: number | null;
+    aiProjectReason?: string | null;
+}
+/**
+ * ADVISORY hints only — an AI pick proposes, it never places data. A user's
+ * deliberate choice (`--workspace` / `--project`) is NOT a hint.
+ */
+export declare function captureExecuteRoutingHints(structured: CaptureStructureRouting): CaptureExecuteRoutingHints;
+/** The AI's workspace-side hints only (drop them when the user pinned a workspace). */
+export declare function workspaceRoutingHints(structured: CaptureStructureRouting): {
+    aiWorkspaceId: string | null | undefined;
+    aiWorkspaceConfidence: number | null | undefined;
+    aiWorkspaceReason: string | null | undefined;
+    aiWorkspaceDecision: WorkspaceDecisionRecord | null | undefined;
+};
+/** The AI's project-side hints only (drop them when the user pinned a project). */
+export declare function projectRoutingHints(structured: CaptureStructureRouting): {
+    aiProjectId: string | null | undefined;
+    aiProjectConfidence: number | null | undefined;
+    aiProjectReason: string | null | undefined;
+};
+/** Where a capture will land, as `capture.structure` resolved it. */
+export interface CapturePlacement {
+    workspaceId: string | null;
+    workspaceName: string | null;
+    /** A deterministic rung placed it — never an AI guess. */
+    deterministic: boolean;
+    suggestion?: {
+        workspaceId: string;
+        workspaceName: string;
+        reason: string | null;
+        alternatives: Array<{
+            workspaceId: string;
+            workspaceName: string;
+            weight: number;
+        }>;
+    };
+}
+/** What the person did with the destination field before saving. */
+export type WorkspaceSelection = {
+    kind: "default";
+} | {
+    kind: "chosen";
+    workspaceId: string;
+    workspaceName: string;
+} | {
+    kind: "removed";
+};
+export type WorkspaceChoice = "accepted" | "changed" | "removed" | "ignored";
+export interface WorkspacePlacementView {
+    destination: {
+        workspaceId: string | null;
+        workspaceName: string | null;
+    };
+    aiSuggested: boolean;
+    alternatives: NonNullable<CapturePlacement["suggestion"]>["alternatives"];
+    canRemove: boolean;
+    execute: {
+        targetWorkspaceId?: string;
+        workspaceChoice?: WorkspaceChoice;
+    };
+}
+/** THE destination rule — see the shared type's docblock. */
+export declare function deriveWorkspacePlacementView(placement: CapturePlacement | null | undefined, selection: WorkspaceSelection, opts: {
+    interactive: boolean;
+}): WorkspacePlacementView;
+/**
+ * The headless placement fields the CLI sends to `/capture/execute` — the ONE
+ * door, so the CLI can never hand-roll a destination. Headless ⇒ an AI
+ * suggestion stays a proposal; a deterministic placement is pinned explicitly.
+ */
+export declare function headlessPlacementFields(structured: Pick<StructureResult, "placement">): {
+    targetWorkspaceId?: string;
+    workspaceChoice?: WorkspaceChoice;
+};
+/**
+ * The workspace line for a structure result: the NAME the pod resolved (never
+ * a raw id when a name is known) and the confidence percent, once.
+ */
+export declare function formatWorkspaceRouting(result: {
+    targetWorkspaceId?: string | null;
+    targetWorkspaceName?: string | null;
+    targetWorkspaceConfidence?: number | null;
+}): string | null;
+/** Response of POST /capture/structure (the AI plan — writes NOTHING). */
+export interface StructureResult {
+    proposals?: StructureProposal[];
+    relations?: StructureRelation[];
+    followUp?: string | FollowUp | null;
+    targetWorkspaceId?: string | null;
+    /** The pod's display name for `targetWorkspaceId` — what the CLI prints. */
+    targetWorkspaceName?: string | null;
+    targetWorkspaceConfidence?: number | null;
+    targetWorkspaceReason?: string | null;
+    targetWorkspaceDecision?: WorkspaceDecisionRecord | null;
+    targetProjectId?: string | null;
+    targetProjectConfidence?: number | null;
+    targetProjectReason?: string | null;
+    /**
+     * The honest destination block — where the capture lands and, separately,
+     * what the AI would SUGGEST. Read it through `headlessPlacementFields` /
+     * `deriveWorkspacePlacementView`, never by digging at `targetWorkspaceId`
+     * (which mixes a deterministic placement and an AI guess into one field).
+     * Absent on an older pod.
+     */
+    placement?: CapturePlacement | null;
+    /** True when the IS structurer is down and the server returned a raw fallback. */
+    degraded?: boolean;
+    degradedReason?: DegradedReason;
+    /**
+     * Summary of the extraction pass, present when a `file` input was normalized
+     * to text before structuring. `text` is what the pod needs echoed back on
+     * execute (as `file.extractedText`) so a kept original lands with a real
+     * document body instead of an empty one — the pod cannot re-derive it,
+     * because extraction runs in the Intelligence Service.
+     */
+    extraction?: {
+        kind: string;
+        extractor: string;
+        metadata?: Record<string, unknown>;
+        warnings?: string[];
+        text?: string;
+        textTruncated?: boolean;
+    };
+}
+/** One materialized entity row in a /capture/execute response. */
+export interface ExecuteCreated {
+    tempId?: string;
+    entityId?: string;
+    id?: string;
+    profileSlug?: string;
+    /** true = linked/deduped onto an EXISTING entity (nothing new was created). */
+    linked?: boolean;
+    degradedFrom?: string;
+    propertiesDropped?: boolean;
+    deduplicated?: boolean;
+}
+/**
+ * Response of POST /capture/execute — either a governed proposal (nothing
+ * written) or a materialized graph. The CLI authenticates as an agent, so it
+ * usually materializes, but a workspace policy can still queue a proposal; the
+ * reporter below reflects whichever actually happened.
+ *
+ * NOTE: there is no top-level `entitiesCreated`/`relationsCreated` on this
+ * response — those live only in the server's log line. Counts MUST be derived
+ * from `created`/`relations` (see `readCaptureExecute`).
+ */
+export interface ExecuteResult {
+    /** "proposed" when governance queued the write instead of applying it. */
+    status?: string;
+    created?: ExecuteCreated[];
+    relations?: unknown[];
+    proposalId?: string;
+    reviewUrl?: string;
+    reviewPath?: string;
+    /**
+     * The AI's outstanding "move to X?" suggestion. NOTHING was moved — the
+     * capture landed where it would have without the AI; re-file with an
+     * explicit workspace to accept it. (This replaced `movedToWorkspace`, which
+     * claimed a move the ladder never performs.)
+     */
+    pendingWorkspaceSwitch?: {
+        suggestedWorkspaceId: string;
+        suggestedWorkspaceName: string | null;
+        reason: string | null;
+        confidence: number | null;
+    } | null;
+    message?: string;
+    /**
+     * Disposition of the ORIGINAL file, present only when the caller sent
+     * `keepRaw: true` + `file`. Four honest outcomes — the blob can be stored,
+     * parked behind governance, denied by policy, or fail on storage — and a
+     * caller that prints "kept" for all four is back to false success.
+     */
+    sourceFile?: {
+        status: "stored" | "proposed" | "denied" | "failed";
+        entityId?: string;
+        documentId?: string;
+        proposalId?: string;
+        reviewUrl?: string;
+        reason?: string;
+    };
+}
+/** The honest outcome of a /capture/execute call, derived from the response. */
+export interface CaptureExecuteOutcome {
+    /** true when the write was queued for review, NOT applied. */
+    proposed: boolean;
+    /** entities newly created (excludes rows linked/deduped onto existing ones). */
+    entitiesCreated: number;
+    /** entities linked/deduped onto existing entities (nothing new stored). */
+    entitiesLinked: number;
+    relationsCreated: number;
+    proposalId?: string;
+    reviewUrl?: string;
+    /**
+     * The AI suggested another workspace and the pod did NOT move anything —
+     * a proposal for the caller to confirm, never a receipt of a move.
+     */
+    pendingWorkspaceSwitch?: {
+        suggestedWorkspaceId: string;
+        suggestedWorkspaceName: string | null;
+        reason: string | null;
+        confidence: number | null;
+    };
+}
+/**
+ * Interpret a /capture/execute response HONESTLY. Distinguishes applied vs
+ * proposed vs nothing-created and surfaces the real proposal/review handle so
+ * the CLI never claims "created" for a write that was proposed or a plan that
+ * only linked existing entities.
+ */
+export declare function readCaptureExecute(res: ExecuteResult): CaptureExecuteOutcome;
+/**
+ * The one line every CLI surface prints for an outstanding workspace
+ * suggestion. It says what to DO (re-file with `--workspace`), because the pod
+ * moved nothing — the old "→ filed into workspace X" line reported a move that
+ * never happened.
+ */
+export declare function formatPendingWorkspaceSwitch(outcome: Pick<CaptureExecuteOutcome, "pendingWorkspaceSwitch">): string | null;
+/** True when the structure step degraded (nothing usable came back). */
+export declare function isDegraded(res: StructureResult): boolean;
+/**
+ * WHY a capture degraded. Two families, and the difference is the whole point:
+ *
+ *  • pod plumbing (`is_*`) — the structurer itself failed. Retrying is sensible.
+ *  • Intelligence Service extraction honesty (everything else) — the INPUT
+ *    could not be read. Several of these are PERMANENT CONFIGURATION states
+ *    (`vision_provider_not_configured`, `transcription_provider_not_configured`)
+ *    where "retry when it's back" is simply a lie: nothing is coming back.
+ *
+ * Open-ended (`string & {}`) because the IS owns this vocabulary and may add to
+ * it. An unknown value must humanize, never leak, never crash.
+ */
+export type DegradedReason = "is_auth_error" | "is_invalid_response" | "is_empty_result" | "llm_budget_exceeded" | "pdf_scanned_needs_ocr" | "pdf_missing_binary" | "vision_provider_not_configured" | "vision_provider_failed" | "image_missing_binary" | "transcription_provider_not_configured" | "audio_missing_binary" | "docx_missing_binary" | "docx_empty" | "html_empty" | "unsupported_type" | (string & {});
+/**
+ * One line of honest copy for a degraded reason: WHAT happened, and WHAT TO DO.
+ *
+ * ── Why this is a second table, deliberately ────────────────────────────────
+ * `@synap-core/capture-pipeline`'s `describeDegradedReason` is the existing
+ * one-door for this copy, and it is the RIGHT door — but the CLI is a separate
+ * pnpm workspace whose only Synap runtime dependencies are
+ * `@synap-core/hub-rest-client` (a file: link into synap-backend) and
+ * `@synap-core/workspace-templates`. It cannot reach a `synap-app` package
+ * without a package.json/lockfile change. Same reason the `StructureResult`
+ * mirror above is local.
+ *
+ * So: the `title` half is COPIED VERBATIM from `describeDegradedReason` and
+ * pinned by a parity test (`test/degraded-message-honesty.test.ts`) that reads
+ * the sibling repo's source, so the two can never drift on WHAT happened.
+ * The `detail` half is deliberately DIFFERENT, because the app's
+ * details end in "saved as a note in the meantime" and the CLI creates nothing
+ * at all — repeating the app's sentence here would be a new lie in place of the
+ * old one.
+ */
+export declare function describeDegradedReason(reason: DegradedReason | undefined): {
+    title: string;
+    detail: string;
+};
+/**
+ * The ONE degraded message. The CLI does NOT materialize the server's generic
+ * `item` stand-in (the browser does the same via `offlineFallback:false`), so a
+ * captured note is never silently downgraded to an unstructured blob behind a
+ * "success" line.
+ *
+ * It used to print a single sentence for every cause — "AI structuring
+ * unavailable (is_empty_result) — nothing was created. Retry when it's back."
+ * — which leaked a raw machine token AND told users to retry states that never
+ * change (a pod with no vision provider is not going to come back). Now each
+ * reason says what actually happened and what to do about it.
+ */
+export declare function degradedMessage(res: StructureResult): string;