@spacefast/common 0.0.5 → 0.0.6

package/dist/vocabulary.d.ts

@@ -56,7 +56,7 @@ export declare const CONCEPTS: {
         readonly canonicalNoun: "version";
         readonly verb: "publish";
         readonly aliases: readonly [];
-        readonly deprecated: readonly ["deployment"];
+        readonly externalTerms: readonly ["deployment"];
         readonly description: string;
     };
     readonly channel: {
@@ -133,7 +133,7 @@ export declare const EXTERNAL_TERM_ALLOWLIST: readonly [{
     readonly concept: "publish";
     readonly allowedContexts: readonly ["github-integration", "platform-api"];
     readonly replacement: "publish";
-    readonly reason: "Push-deploys and the deploy status come from the GitHub integration.";
+    readonly reason: string;
 }, {
     readonly term: "site";
     readonly concept: "space";
@@ -148,6 +148,44 @@ export declare const EXTERNAL_TERM_ALLOWLIST: readonly [{
     readonly replacement: "infra";
     readonly reason: string;
 }];
+/**
+ * AMENDMENT (DECIDED 2026-07-02): the deploy vocabulary stays, as documented,
+ * first-class ALIASES of the canonical vocabulary — `deploy` is an alias of
+ * `publish` (the verb) and `deployments` is an alias of `versions` (the noun).
+ * The canonical lifecycle nouns are unchanged: version / channel / build.
+ *
+ * This relaxes the earlier total noun ban to alias-with-disambiguation:
+ *
+ *   - `sf deploy` / `sf deployments` stay listed and documented; every surface
+ *     that presents them names the canonical command first and marks the
+ *     deploy form as an alias.
+ *   - Wherever the alias is introduced, attach DEPLOY_ALIAS_DISAMBIGUATION
+ *     (the one sanctioned disambiguation sentence) so readers land on the
+ *     canonical nouns.
+ *   - A bare "deployment" noun in FRESH prose is still discouraged — write
+ *     "version" (the thing) or "publish" (the act) unless deliberately using
+ *     the alias, in which case disambiguate.
+ */
+export interface DeployAlias {
+    /** The deploy-vocabulary word being sanctioned. */
+    readonly alias: string;
+    /** The canonical word it is an alias of. */
+    readonly canonical: string;
+}
+export declare const DEPLOY_ALIASES: readonly [{
+    readonly alias: "deploy";
+    readonly canonical: "publish";
+}, {
+    readonly alias: "deployments";
+    readonly canonical: "versions";
+}];
+/**
+ * THE sanctioned disambiguation copy. Surfaces that present the deploy
+ * vocabulary (CLI --help, handbook/reference docs, generated skill docs) carry
+ * this sentence verbatim next to the alias, with the canonical command named
+ * first.
+ */
+export declare const DEPLOY_ALIAS_DISAMBIGUATION: string;
 /** An internal provider name and how it must be referred to in public copy. */
 export interface ProviderHygieneRule {
     /** Internal/vendor name that must not appear on public surfaces. */
@@ -187,34 +225,11 @@ export declare const PROVIDER_HYGIENE: {
         readonly reason: "Internal git/CI dependency; never surfaced.";
     };
 };
-export type ProviderHygieneId = keyof typeof PROVIDER_HYGIENE;
 /**
- * Canonical MCP tool naming. Tools are exposed under a namespaced canonical id
- * (`spacefast_<verb>`) plus a bare alias (`<verb>`) for clients where per-server
- * namespacing is already guaranteed.
- *
- * This replaces the current inverted form (`execute_spacefast`,
- * `resume_spacefast`) and the un-namespaced verbs (`publish`, `prepare_publish`).
- */
-export declare const MCP_TOOL_NAMING: {
-    /** Prefix that makes a tool id unambiguous across servers. */
-    readonly namespacePrefix: "spacefast_";
-    /** Canonical, namespaced tool id for a verb (e.g. "publish" → "spacefast_publish"). */
-    readonly canonical: (verb: string) => string;
-    /** Bare alias for a verb, valid only where per-server namespacing is guaranteed. */
-    readonly alias: (verb: string) => string;
-    /** Both names a verb should register under. */
-    readonly names: (verb: string) => {
-        readonly canonical: string;
-        readonly alias: string;
-    };
-};
-/**
- * Verbs that have a locked canonical MCP tool name. Generators should emit
- * `spacefast_<verb>` as the primary id and `<verb>` as the bare alias.
+ * Verbs that have a locked canonical MCP tool name. Generators emit the bare
+ * `<verb>` as the one and only tool id.
  */
-export declare const MCP_CANONICAL_VERBS: readonly ["publish", "execute", "prepare_publish", "resume_publish", "finalize_publish"];
-export type McpCanonicalVerb = (typeof MCP_CANONICAL_VERBS)[number];
+export declare const MCP_CANONICAL_VERBS: readonly ["publish", "execute", "search", "resume", "prepare_publish", "resume_publish", "finalize_publish"];
 /**
  * Canonical CLI verb → accepted aliases. Reused across command groups so every
  * `list`/`remove`/`create` command exposes the same shorthands. A command file
@@ -226,5 +241,90 @@ export declare const CLI_ALIASES: {
     readonly create: readonly ["add"];
 };
 export type CliCanonicalVerb = keyof typeof CLI_ALIASES;
-/** Aliases registered for a canonical CLI verb (empty for unknown verbs). */
-export declare function cliAliasesFor(verb: CliCanonicalVerb): readonly string[];
+/**
+ * Disclosure tiers gate how much of a surface (CLI help, `sf docs`) shows by
+ * default, so neither humans nor agents are overwhelmed:
+ *
+ *   - `essential` — the handful of commands/docs a new user or agent needs to
+ *     make a first publish and manage a space. The default everywhere.
+ *   - `full` — the complete product CLI surface (everything not hidden).
+ *   - `reference` — absolutely everything, including hidden/advanced commands.
+ *
+ * Tiers are cumulative for ranked surfaces (`reference` ⊇ `full` ⊇ `essential`);
+ * see {@link tierVisibleAt}. This is THE source of truth for tier ids + labels.
+ */
+export type CliDisclosureTier = "essential" | "full" | "reference";
+/** Display metadata for one disclosure tier. */
+export interface CliDisclosureTierMeta {
+    readonly id: CliDisclosureTier;
+    /** Human label for headers (`Essential commands`, etc.). */
+    readonly label: string;
+    /** One-line description of what the tier reveals. */
+    readonly description: string;
+    /** Flag that opts into this tier (absent for the default `essential`). */
+    readonly flag?: string;
+}
+export declare const CLI_DISCLOSURE_TIERS: {
+    readonly essential: {
+        readonly id: "essential";
+        readonly label: "Essential";
+        readonly description: "The handful of commands a new user or agent needs to publish and manage a space.";
+    };
+    readonly full: {
+        readonly id: "full";
+        readonly label: "Full";
+        readonly description: "Every command in the product CLI.";
+        readonly flag: "--full";
+    };
+    readonly reference: {
+        readonly id: "reference";
+        readonly label: "Reference";
+        readonly description: "Everything, including hidden and advanced commands.";
+        readonly flag: "--all";
+    };
+};
+/** Tiers ordered narrowest-first; index doubles as the cumulative rank. */
+export declare const CLI_DISCLOSURE_TIER_ORDER: readonly ["essential", "full", "reference"];
+/**
+ * Does a surface tagged `surfaceTier` show when viewing at `viewTier`? Ranked
+ * surfaces are cumulative: an `essential` doc shows at every tier, a `full` doc
+ * shows at `full`/`reference`, a `reference` doc only at `reference`.
+ */
+export declare function tierVisibleAt(viewTier: CliDisclosureTier, surfaceTier: CliDisclosureTier): boolean;
+/** One essential CLI verb and the registered command id it resolves to. */
+export interface CliEssentialCommand {
+    /** The verb a new user reaches for. */
+    readonly verb: string;
+    /** The registered CLI command id (some live under a topic, e.g. `spaces:claim`). */
+    readonly commandId: string;
+}
+/**
+ * The first-publish path: the essential verbs `sf help` (and `sf docs`) surface
+ * by default. Everything else is FULL (shown with `--full`) or REFERENCE
+ * (hidden/advanced, shown with `--all`). Ordered for display.
+ */
+export declare const CLI_ESSENTIAL_COMMANDS: readonly [{
+    readonly verb: "publish";
+    readonly commandId: "publish";
+}, {
+    readonly verb: "status";
+    readonly commandId: "status";
+}, {
+    readonly verb: "versions";
+    readonly commandId: "versions";
+}, {
+    readonly verb: "rollback";
+    readonly commandId: "rollback";
+}, {
+    readonly verb: "claim";
+    readonly commandId: "spaces:claim";
+}, {
+    readonly verb: "login";
+    readonly commandId: "login";
+}, {
+    readonly verb: "init";
+    readonly commandId: "init";
+}, {
+    readonly verb: "docs";
+    readonly commandId: "docs";
+}];

package/dist/vocabulary.js

@@ -11,10 +11,12 @@
 //   - `space` is the primitive noun on every user surface. `site` survives only
 //     as the platform-API term for the shared-pool host a space is placed on
 //     (see contracts/sites.ts, internal-docs/platform.md "Site").
-//   - `publish` is the verb. "deployment" is NOT a product noun — it means
-//     "publishing a version" and is retired from user-facing surfaces (drop the
-//     `dep_*` framing). It stays only inside the GitHub integration and the
-//     platform API (see EXTERNAL_TERM_ALLOWLIST).
+//   - `publish` is the verb. AMENDED 2026-07-02: `deploy` / `deployments` are
+//     first-class ALIASES of `publish` / `versions` (see DEPLOY_ALIASES) — they
+//     stay listed and documented, always with the sanctioned disambiguation
+//     line (DEPLOY_ALIAS_DISAMBIGUATION) and with the canonical command named
+//     first. A bare "deployment" noun in fresh prose is still discouraged (say
+//     "version"), and the `dep_*` id framing stays retired.
 //   - `version` / `channel` / `build` are the lifecycle nouns.
 //   - `API key` — never "access token".
 //   - `Collab` is the feature; `comment` is the unit.
@@ -40,17 +42,19 @@ export const CONCEPTS = {
         aliases: ["go live"],
         externalTerms: ["deployment", "deploy"],
         deprecated: ["dep_", "dep_build_", "dep_version_"],
-        description: "The verb for making a version live. 'Deployment' is not a product noun " +
-            "(it just means publishing a version); allowed only in GitHub + platform API.",
+        description: "The verb for making a version live. 'Deploy' is a sanctioned first-class " +
+            "alias of publish (see DEPLOY_ALIASES); introduce it with the " +
+            "disambiguation line, and keep fresh prose on 'publish'.",
     },
     version: {
         id: "version",
         canonicalNoun: "version",
         verb: "publish",
         aliases: [],
-        deprecated: ["deployment"],
+        externalTerms: ["deployment"],
         description: "An immutable snapshot of a space's content. Publishing promotes a version " +
-            "to a channel; the thing once mislabeled a 'deployment' is a version.",
+            "to a channel; a 'deployment' is a sanctioned alias for a version (see " +
+            "DEPLOY_ALIASES), though fresh prose still says 'version'.",
     },
     channel: {
         id: "channel",
@@ -109,14 +113,18 @@ export const EXTERNAL_TERM_ALLOWLIST = [
         allowedContexts: ["github-integration", "platform-api"],
         replacement: "version / publish",
         reason: "GitHub speaks 'deployment'; the platform API keeps it for contract " +
-            "stability. Everywhere else say 'publish a version'.",
+            "stability. Elsewhere it is a sanctioned alias of 'version' when paired " +
+            "with DEPLOY_ALIAS_DISAMBIGUATION (see DEPLOY_ALIASES); bare fresh prose " +
+            "still says 'publish a version'.",
     },
     {
         term: "deploy",
         concept: "publish",
         allowedContexts: ["github-integration", "platform-api"],
         replacement: "publish",
-        reason: "Push-deploys and the deploy status come from the GitHub integration.",
+        reason: "Push-deploys and the deploy status come from the GitHub integration; " +
+            "'deploy' is also a sanctioned first-class alias of 'publish' when paired " +
+            "with DEPLOY_ALIAS_DISAMBIGUATION (see DEPLOY_ALIASES).",
     },
     {
         term: "site",
@@ -136,6 +144,18 @@ export const EXTERNAL_TERM_ALLOWLIST = [
             "the provider; general copy says 'infra'.",
     },
 ];
+export const DEPLOY_ALIASES = [
+    { alias: "deploy", canonical: "publish" },
+    { alias: "deployments", canonical: "versions" },
+];
+/**
+ * THE sanctioned disambiguation copy. Surfaces that present the deploy
+ * vocabulary (CLI --help, handbook/reference docs, generated skill docs) carry
+ * this sentence verbatim next to the alias, with the canonical command named
+ * first.
+ */
+export const DEPLOY_ALIAS_DISAMBIGUATION = "Deploying is publishing: a deployment is a version, and the canonical " +
+    "nouns are version, channel, and build.";
 export const PROVIDER_HYGIENE = {
     e2b: {
         internalName: "E2B",
@@ -168,33 +188,14 @@ export const PROVIDER_HYGIENE = {
 /* MCP tool naming                                                             */
 /* -------------------------------------------------------------------------- */
 /**
- * Canonical MCP tool naming. Tools are exposed under a namespaced canonical id
- * (`spacefast_<verb>`) plus a bare alias (`<verb>`) for clients where per-server
- * namespacing is already guaranteed.
- *
- * This replaces the current inverted form (`execute_spacefast`,
- * `resume_spacefast`) and the un-namespaced verbs (`publish`, `prepare_publish`).
- */
-export const MCP_TOOL_NAMING = {
-    /** Prefix that makes a tool id unambiguous across servers. */
-    namespacePrefix: "spacefast_",
-    /** Canonical, namespaced tool id for a verb (e.g. "publish" → "spacefast_publish"). */
-    canonical: (verb) => `spacefast_${verb}`,
-    /** Bare alias for a verb, valid only where per-server namespacing is guaranteed. */
-    alias: (verb) => verb,
-    /** Both names a verb should register under. */
-    names: (verb) => ({
-        canonical: `spacefast_${verb}`,
-        alias: verb,
-    }),
-};
-/**
- * Verbs that have a locked canonical MCP tool name. Generators should emit
- * `spacefast_<verb>` as the primary id and `<verb>` as the bare alias.
+ * Verbs that have a locked canonical MCP tool name. Generators emit the bare
+ * `<verb>` as the one and only tool id.
  */
 export const MCP_CANONICAL_VERBS = [
     "publish",
     "execute",
+    "search",
+    "resume",
     "prepare_publish",
     "resume_publish",
     "finalize_publish",
@@ -212,7 +213,47 @@ export const CLI_ALIASES = {
     remove: ["rm", "delete"],
     create: ["add"],
 };
-/** Aliases registered for a canonical CLI verb (empty for unknown verbs). */
-export function cliAliasesFor(verb) {
-    return CLI_ALIASES[verb];
+export const CLI_DISCLOSURE_TIERS = {
+    essential: {
+        id: "essential",
+        label: "Essential",
+        description: "The handful of commands a new user or agent needs to publish and manage a space.",
+    },
+    full: {
+        id: "full",
+        label: "Full",
+        description: "Every command in the product CLI.",
+        flag: "--full",
+    },
+    reference: {
+        id: "reference",
+        label: "Reference",
+        description: "Everything, including hidden and advanced commands.",
+        flag: "--all",
+    },
+};
+/** Tiers ordered narrowest-first; index doubles as the cumulative rank. */
+export const CLI_DISCLOSURE_TIER_ORDER = ["essential", "full", "reference"];
+/**
+ * Does a surface tagged `surfaceTier` show when viewing at `viewTier`? Ranked
+ * surfaces are cumulative: an `essential` doc shows at every tier, a `full` doc
+ * shows at `full`/`reference`, a `reference` doc only at `reference`.
+ */
+export function tierVisibleAt(viewTier, surfaceTier) {
+    return (CLI_DISCLOSURE_TIER_ORDER.indexOf(surfaceTier) <= CLI_DISCLOSURE_TIER_ORDER.indexOf(viewTier));
 }
+/**
+ * The first-publish path: the essential verbs `sf help` (and `sf docs`) surface
+ * by default. Everything else is FULL (shown with `--full`) or REFERENCE
+ * (hidden/advanced, shown with `--all`). Ordered for display.
+ */
+export const CLI_ESSENTIAL_COMMANDS = [
+    { verb: "publish", commandId: "publish" },
+    { verb: "status", commandId: "status" },
+    { verb: "versions", commandId: "versions" },
+    { verb: "rollback", commandId: "rollback" },
+    { verb: "claim", commandId: "spaces:claim" },
+    { verb: "login", commandId: "login" },
+    { verb: "init", commandId: "init" },
+    { verb: "docs", commandId: "docs" },
+];

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@spacefast/common",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "license": "MIT",
   "description": "Shared TypeScript contracts and utilities for Spacefast packages.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spacefast/monorepo.git",
+    "directory": "packages/common"
+  },
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -20,6 +25,11 @@
       "import": "./dist/brand.js",
       "default": "./dist/brand.js"
     },
+    "./vocabulary": {
+      "types": "./dist/vocabulary.d.ts",
+      "import": "./dist/vocabulary.js",
+      "default": "./dist/vocabulary.js"
+    },
     "./contracts/*": {
       "types": "./dist/contracts/*.d.ts",
       "import": "./dist/contracts/*.js",
@@ -35,6 +45,11 @@
       "import": "./dist/utils/*.js",
       "default": "./dist/utils/*.js"
     },
+    "./agents/*": {
+      "types": "./dist/agents/*.d.ts",
+      "import": "./dist/agents/*.js",
+      "default": "./dist/agents/*.js"
+    },
     "./domain-exploration": {
       "types": "./dist/domain-exploration.d.ts",
       "import": "./dist/domain-exploration.js",

package/dist/contracts/account.d.ts

@@ -1,28 +0,0 @@
-import { z } from "zod";
-export declare const accessTokenScope: z.ZodEnum<{
-    "account:read": "account:read";
-    "account:write": "account:write";
-    "team:read": "team:read";
-    "team:write": "team:write";
-    "space:read": "space:read";
-    "space:write": "space:write";
-    "domain:read": "domain:read";
-    "domain:write": "domain:write";
-}>;
-export type AccessTokenScope = z.infer<typeof accessTokenScope>;
-export declare const ACCESS_TOKEN_SCOPE_DEFINITIONS: {
-    value: AccessTokenScope;
-    label: string;
-    description: string;
-}[];
-export declare const DEFAULT_ACCESS_TOKEN_SCOPES: AccessTokenScope[];
-export type AuthSession = {
-    session: {
-        id: string;
-    };
-    user: {
-        id: string;
-        email?: string | null | undefined;
-        name?: string | null | undefined;
-    };
-};

package/dist/contracts/account.js

@@ -1,54 +0,0 @@
-import { z } from "zod";
-export const accessTokenScope = z.enum([
-    "account:read",
-    "account:write",
-    "team:read",
-    "team:write",
-    "space:read",
-    "space:write",
-    "domain:read",
-    "domain:write",
-]);
-export const ACCESS_TOKEN_SCOPE_DEFINITIONS = [
-    {
-        value: "account:read",
-        label: "Read account",
-        description: "View account details, active sessions, and existing access tokens.",
-    },
-    {
-        value: "account:write",
-        label: "Manage account",
-        description: "Update account settings and revoke or create account-scoped credentials.",
-    },
-    {
-        value: "team:read",
-        label: "Read teams",
-        description: "View team membership, billing, activity, secrets, and settings.",
-    },
-    {
-        value: "team:write",
-        label: "Manage teams",
-        description: "Change team settings and manage members, invitations, or secrets.",
-    },
-    {
-        value: "space:read",
-        label: "Read spaces",
-        description: "View spaces, versions, diagnostics, variables, and runtime status.",
-    },
-    {
-        value: "space:write",
-        label: "Manage spaces",
-        description: "Create, update, publish, and delete spaces, versions, or variables.",
-    },
-    {
-        value: "domain:read",
-        label: "Read domains",
-        description: "Inspect custom domains, DNS state, and assignment details.",
-    },
-    {
-        value: "domain:write",
-        label: "Manage domains",
-        description: "Attach, update, verify, or remove space and team domains.",
-    },
-];
-export const DEFAULT_ACCESS_TOKEN_SCOPES = ["account:read"];

package/dist/contracts/intercom.d.ts

@@ -1,6 +0,0 @@
-import { z } from "zod";
-export declare const IntercomMessengerJwtSchema: z.ZodObject<{
-    token: z.ZodString;
-    expiresAt: z.ZodString;
-}, z.core.$strip>;
-export type IntercomMessengerJwt = z.infer<typeof IntercomMessengerJwtSchema>;

package/dist/contracts/intercom.js

@@ -1,5 +0,0 @@
-import { z } from "zod";
-export const IntercomMessengerJwtSchema = z.object({
-    token: z.string().min(1).describe("Server-signed Intercom Messenger JWT."),
-    expiresAt: z.string().datetime().describe("JWT expiry timestamp."),
-});

package/dist/contracts/telemetry.d.ts

@@ -1,2 +0,0 @@
-export { EVENT_BODY_CAP_BYTES as TELEMETRY_BODY_CAP_BYTES, EVENT_MAX_EVENTS_PER_REQUEST as TELEMETRY_MAX_EVENTS_PER_REQUEST, eventAcceptedSchema as telemetryAcceptedSchema, eventIngestSchema as telemetryIngestSchema, eventPayloadSchema as telemetryEventSchema, } from "./events.js";
-export type { EventIngest as TelemetryIngest, EventPayload as TelemetryEvent } from "./events.js";

package/dist/contracts/telemetry.js

@@ -1 +0,0 @@
-export { EVENT_BODY_CAP_BYTES as TELEMETRY_BODY_CAP_BYTES, EVENT_MAX_EVENTS_PER_REQUEST as TELEMETRY_MAX_EVENTS_PER_REQUEST, eventAcceptedSchema as telemetryAcceptedSchema, eventIngestSchema as telemetryIngestSchema, eventPayloadSchema as telemetryEventSchema, } from "./events.js";

package/dist/utils/access-policy.d.ts

@@ -1,39 +0,0 @@
-import { type ApiKeyPreset, type StatticAccessPolicy, type StatticAction } from "../contracts/api-keys.js";
-type RequestCondition = NonNullable<StatticAccessPolicy["statements"][number]["conditions"]>;
-export type PolicyCompileInput = {
-    tenantId: string;
-    teamId: string;
-};
-export type PolicyAuthorizeInput = {
-    policy: StatticAccessPolicy;
-    action: StatticAction;
-    /**
-     * Candidate resource URIs for one request target, evaluated together: spaces
-     * are addressed by their canonical site-rooted URI AND a principal-scoped
-     * candidate so principal wildcards cover them. A deny matching ANY candidate
-     * wins; otherwise an allow matching any candidate permits.
-     */
-    resource: string | readonly string[];
-    conditions?: RequestCondition;
-};
-export declare function compileApiKeyPreset(preset: ApiKeyPreset, input: PolicyCompileInput): StatticAccessPolicy;
-export declare function compileTeamRolePolicy(input: PolicyCompileInput & {
-    role: string;
-}): StatticAccessPolicy;
-export declare function allowPolicy(actions: StatticAction[], resources: string[]): StatticAccessPolicy;
-export declare function denyAllPolicy(): StatticAccessPolicy;
-export declare function policyIsSubsetOfGrantor(requested: StatticAccessPolicy, grantor: StatticAccessPolicy): boolean;
-export declare function policyAllows(input: PolicyAuthorizeInput): boolean;
-export declare function grantedTenantsFromPolicy(policy: StatticAccessPolicy): {
-    all: boolean;
-    tenantIds: string[];
-};
-export declare function grantedPrincipalsFromPolicy(policy: StatticAccessPolicy, input: {
-    tenantId: string;
-    principalType: "team" | "external";
-}): {
-    all: boolean;
-    principalIds: string[];
-};
-export declare function policyReaches(policy: StatticAccessPolicy, resourceBase: string): boolean;
-export {};

package/dist/utils/error-display.d.ts

@@ -1,7 +0,0 @@
-type ErrorDescription = {
-    message: string;
-    details: string[];
-};
-export declare function describeError(error: unknown): ErrorDescription;
-export declare function formatErrorMessage(error: unknown): string;
-export {};

package/dist/utils/error-display.js

@@ -1,42 +0,0 @@
-import { ApiError } from "./api.js";
-function baseMessage(error) {
-    if (error instanceof Error) {
-        return error.message;
-    }
-    return String(error);
-}
-function detailLines(error) {
-    if (!(error instanceof ApiError) || !error.details) {
-        return [];
-    }
-    const lines = [];
-    const { details } = error;
-    const missingPaths = details.missingPaths;
-    if (Array.isArray(missingPaths)) {
-        const paths = missingPaths.filter((entry) => typeof entry === "string");
-        if (paths.length > 0) {
-            lines.push(`Missing files: ${paths.join(", ")}`);
-        }
-    }
-    const path = details.path;
-    if (typeof path === "string" && path && lines.length === 0) {
-        lines.push(`Path: ${path}`);
-    }
-    if (error.requestId) {
-        lines.push(`Request ID: ${error.requestId}`);
-    }
-    return lines;
-}
-export function describeError(error) {
-    return {
-        message: baseMessage(error),
-        details: detailLines(error),
-    };
-}
-export function formatErrorMessage(error) {
-    const description = describeError(error);
-    if (description.details.length === 0) {
-        return description.message;
-    }
-    return `${description.message} ${description.details.join(" ")}`;
-}