@settlemint/dalp-cli 3.1.33-main.43433008600 → 3.1.33-release.43440124932

package/src/lib/cli-status.ts

@@ -1,102 +0,0 @@
-const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"] as const;
-
-export interface StatusEvent {
-  readonly phase: string;
-  readonly message: string;
-}
-
-export interface CliStatusReporter {
-  readonly update: (event: StatusEvent) => StatusEvent | undefined;
-  readonly succeed: (message: string) => StatusEvent | undefined;
-  readonly fail: (message: string) => StatusEvent | undefined;
-  readonly stop: () => void;
-}
-
-export interface CreateCliStatusOptions {
-  readonly agent: boolean;
-  readonly stream?: { write: (chunk: string) => unknown; isTTY?: boolean };
-  readonly isTty?: boolean;
-}
-
-export function createCliStatus(options: CreateCliStatusOptions): CliStatusReporter {
-  const stream = options.stream ?? process.stderr;
-  const isTty = options.isTty ?? Boolean("isTTY" in stream && stream.isTTY);
-  const human = options.agent !== true;
-  let frame = 0;
-  let currentMessage = "";
-  let timer: ReturnType<typeof setInterval> | undefined;
-  let spinning = false;
-
-  const clearLine = (): void => {
-    if (human && isTty) {
-      stream.write("\r\u001B[K");
-    }
-  };
-
-  const paint = (): void => {
-    if (!human || !isTty || !spinning) {
-      return;
-    }
-    const glyph = SPINNER_FRAMES[frame % SPINNER_FRAMES.length]!;
-    stream.write(`\r\u001B[K${glyph} ${currentMessage}`);
-    frame += 1;
-  };
-
-  const startSpinner = (): void => {
-    if (!human || !isTty || spinning) {
-      return;
-    }
-    spinning = true;
-    timer = setInterval(paint, 80);
-    paint();
-  };
-
-  const stopSpinner = (): void => {
-    if (timer !== undefined) {
-      clearInterval(timer);
-      timer = undefined;
-    }
-    if (spinning) {
-      clearLine();
-      spinning = false;
-    }
-  };
-
-  const emitHuman = (prefix: string, message: string): void => {
-    stopSpinner();
-    if (!human) {
-      return;
-    }
-    if (isTty) {
-      stream.write(`${prefix} ${message}\n`);
-    } else {
-      stream.write(`${message}\n`);
-    }
-  };
-
-  return {
-    update(event) {
-      currentMessage = event.message;
-      if (!options.agent) {
-        if (isTty) {
-          startSpinner();
-          paint();
-        } else {
-          stream.write(`${event.message}\n`);
-        }
-      }
-      return options.agent ? event : undefined;
-    },
-    succeed(message) {
-      emitHuman("✔", message);
-      return options.agent ? { phase: "done", message } : undefined;
-    },
-    fail(message) {
-      emitHuman("✖", message);
-      return options.agent ? { phase: "error", message } : undefined;
-    },
-    stop() {
-      stopSpinner();
-    },
-  };
-}

package/src/lib/coverage.ts

@@ -1,41 +0,0 @@
-export interface CoverageOperation {
-  readonly name: string;
-  readonly hintKey: string;
-}
-
-export function findSurfaceGaps(
-  sdkOperations: ReadonlyArray<string>,
-  hasSurface: (name: string) => boolean
-): Array<string> {
-  return sdkOperations.filter((name) => !hasSurface(name));
-}
-
-const MANIFEST_HINT_KEY = /\b[A-Z]+ \/\S+/g;
-
-export function findMountGaps(operations: ReadonlyArray<CoverageOperation>, manifest: string): Array<string> {
-  const mounted = new Set(manifest.match(MANIFEST_HINT_KEY));
-  return operations.filter((operation) => !mounted.has(operation.hintKey)).map((operation) => operation.name);
-}
-
-export interface ExemptionGaps {
-  readonly stale: ReadonlyArray<string>;
-  readonly reasonless: ReadonlyArray<string>;
-}
-
-export function findExemptionGaps(
-  exemptions: ReadonlyMap<string, string>,
-  sdkOperations: ReadonlyArray<string>
-): ExemptionGaps {
-  const live = new Set(sdkOperations);
-  const stale: Array<string> = [];
-  const reasonless: Array<string> = [];
-  for (const [name, reason] of exemptions) {
-    if (!live.has(name)) {
-      stale.push(name);
-    }
-    if (reason.trim().length === 0) {
-      reasonless.push(name);
-    }
-  }
-  return { stale, reasonless };
-}

package/src/lib/credential-store.ts

@@ -1,256 +0,0 @@
-import { chmod, mkdir, readFile, unlink, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { z } from "zod";
-import { getConfigDir } from "./cli-config.ts";
-import { makeCliError, isCliFailure } from "./errors.ts";
-
-const KEYCHAIN_ENTRY_SEPARATOR_PATTERN = /\n(?=keychain:)/u;
-const ACCOUNT_PATTERN = /"acct"<blob>="([^"]*)"/u;
-
-const SERVICE_NAME = "dalp-cli";
-const SECURITY_INTERACTIVE_MAX_LINE_BYTES = 4094;
-const SECURITY_QUOTED_ESCAPE_PATTERN = /["\\]/gu;
-const SECURITY_LINE_BREAK_PATTERN = /[\n\r\0]/u;
-
-const StoredCredentialsSchema = z.object({
-  apiKey: z.string().min(1),
-  apiKeyId: z.string().min(1),
-  userEmail: z.string().min(1),
-  userId: z.string().min(1),
-  activeOrgId: z.string().min(1).optional(),
-  apiUrl: z.url(),
-});
-
-export type StoredCredentials = z.infer<typeof StoredCredentialsSchema>;
-
-export interface CredentialStoreOptions {
-  readonly configDir?: string;
-  readonly platform?: NodeJS.Platform;
-  readonly runSecurity?: (
-    args: ReadonlyArray<string>,
-    stdin?: string
-  ) => Promise<{ readonly exitCode: number; readonly stdout: string }>;
-}
-
-const defaultRunSecurity = async (
-  args: ReadonlyArray<string>,
-  stdin?: string
-): Promise<{ readonly exitCode: number; readonly stdout: string }> => {
-  const proc = Bun.spawn(["security", ...args], {
-    stdin: stdin === undefined ? "ignore" : new TextEncoder().encode(stdin),
-    stdout: "pipe",
-    stderr: "pipe",
-  });
-  const [stdout, exitCode] = await Promise.all([new Response(proc.stdout).text(), proc.exited]);
-  return { exitCode, stdout };
-};
-
-function credentialsFile(configDir: string): string {
-  return path.join(configDir, "credentials.json");
-}
-
-async function keychainAccounts(
-  runSecurity: NonNullable<CredentialStoreOptions["runSecurity"]>
-): Promise<Array<string>> {
-  const dump = await runSecurity(["dump-keychain"]);
-  if (dump.exitCode !== 0) {
-    throw makeCliError({
-      code: "kit.cli.CREDENTIAL_STORE_FAILED",
-      message: `Keychain dump failed with exit code ${dump.exitCode}`,
-    });
-  }
-  const accounts = new Set<string>();
-  for (const entry of dump.stdout.split(KEYCHAIN_ENTRY_SEPARATOR_PATTERN)) {
-    if (!entry.includes(`"svce"<blob>="${SERVICE_NAME}"`)) {
-      continue;
-    }
-    const account = entry.match(ACCOUNT_PATTERN)?.[1];
-    if (account !== undefined) {
-      accounts.add(account);
-    }
-  }
-  return [...accounts];
-}
-
-async function deleteKeychainAccount(
-  runSecurity: NonNullable<CredentialStoreOptions["runSecurity"]>,
-  account: string
-): Promise<void> {
-  const result = await runSecurity(["delete-generic-password", "-s", SERVICE_NAME, "-a", account]);
-  if (result.exitCode !== 0) {
-    throw makeCliError({
-      code: "kit.cli.CREDENTIAL_STORE_FAILED",
-      message: `Keychain delete failed for ${account} with exit code ${result.exitCode}`,
-    });
-  }
-}
-
-function quoteSecurityArgument(value: string): string {
-  return `"${value.replaceAll(SECURITY_QUOTED_ESCAPE_PATTERN, (character) => `\\${character}`)}"`;
-}
-
-async function addKeychainPassword(
-  runSecurity: NonNullable<CredentialStoreOptions["runSecurity"]>,
-  account: string,
-  password: string
-): Promise<void> {
-  const command = [
-    "add-generic-password",
-    "-s",
-    quoteSecurityArgument(SERVICE_NAME),
-    "-a",
-    quoteSecurityArgument(account),
-    "-X",
-    Buffer.from(password, "utf8").toString("hex"),
-    "-U",
-  ].join(" ");
-  if (
-    SECURITY_LINE_BREAK_PATTERN.test(account) ||
-    Buffer.byteLength(command, "utf8") > SECURITY_INTERACTIVE_MAX_LINE_BYTES
-  ) {
-    throw makeCliError({
-      code: "kit.cli.CREDENTIAL_STORE_FAILED",
-      message: `The ${SERVICE_NAME} keychain item for ${JSON.stringify(account)} cannot be passed to the macOS security tool as one command line.`,
-    });
-  }
-  const result = await runSecurity(["-i"], `${command}\n`);
-  if (result.exitCode !== 0) {
-    throw makeCliError({
-      code: "kit.cli.CREDENTIAL_STORE_FAILED",
-      message: `Keychain save failed with exit code ${result.exitCode}`,
-    });
-  }
-}
-
-function resolvePlatform(options: CredentialStoreOptions): NodeJS.Platform {
-  if (options.platform !== undefined) {
-    return options.platform;
-  }
-  const override = process.env.DALP_CREDENTIAL_PLATFORM;
-  if (override === "darwin" || override === "linux" || override === "win32") {
-    return override;
-  }
-  return process.platform;
-}
-
-export async function saveCredentials(
-  credentials: StoredCredentials,
-  options: CredentialStoreOptions = {}
-): Promise<void> {
-  const parsed = StoredCredentialsSchema.parse(credentials);
-  const configDir = options.configDir ?? getConfigDir();
-  const platform = resolvePlatform(options);
-  const runSecurity = options.runSecurity ?? defaultRunSecurity;
-  const encoded = JSON.stringify(parsed);
-
-  if (platform === "darwin") {
-    const existing = await keychainAccounts(runSecurity);
-    await addKeychainPassword(runSecurity, parsed.userEmail, encoded);
-    try {
-      for (const account of existing.filter((name) => name !== parsed.userEmail)) {
-        await deleteKeychainAccount(runSecurity, account);
-      }
-    } catch (error) {
-      if (!existing.includes(parsed.userEmail)) {
-        await runSecurity(["delete-generic-password", "-s", SERVICE_NAME, "-a", parsed.userEmail]);
-      }
-      throw error;
-    }
-    return;
-  }
-
-  await mkdir(configDir, { recursive: true, mode: 0o700 });
-  const file = credentialsFile(configDir);
-  await writeFile(file, encoded, { mode: 0o600 });
-  await chmod(file, 0o600);
-}
-
-export async function loadCredentials(options: CredentialStoreOptions = {}): Promise<StoredCredentials | undefined> {
-  const configDir = options.configDir ?? getConfigDir();
-  const platform = resolvePlatform(options);
-  const runSecurity = options.runSecurity ?? defaultRunSecurity;
-
-  let encoded: string;
-  if (platform === "darwin") {
-    const accounts = await keychainAccounts(runSecurity);
-    if (accounts.length === 0) {
-      return undefined;
-    }
-    if (accounts.length > 1) {
-      throw makeCliError({
-        code: "kit.cli.CREDENTIAL_STORE_FAILED",
-        message: `Multiple ${SERVICE_NAME} keychain accounts found (${accounts.join(", ")}). Remove the stale account or keep exactly one DALP CLI login before retrying.`,
-      });
-    }
-    const result = await runSecurity(["find-generic-password", "-s", SERVICE_NAME, "-a", accounts[0]!, "-w"]);
-    if (result.exitCode !== 0) {
-      throw makeCliError({
-        code: "kit.cli.CREDENTIAL_STORE_FAILED",
-        message: `The ${SERVICE_NAME} keychain item for ${accounts[0]!} could not be read (exit code ${result.exitCode}). Run 'dalp logout' to remove it, then 'dalp login'.`,
-      });
-    }
-    encoded = result.stdout.trim();
-  } else {
-    const file = credentialsFile(configDir);
-    try {
-      const stats = await Bun.file(file).stat();
-      if ((stats.mode & 0o077) !== 0) {
-        throw makeCliError({
-          code: "kit.cli.CREDENTIAL_STORE_FAILED",
-          message: `Credentials file has insecure permissions: ${(stats.mode & 0o777).toString(8)}. Run 'chmod 600 ${file}' to fix.`,
-        });
-      }
-      encoded = await readFile(file, "utf8");
-    } catch (error) {
-      if (isCliFailure(error)) {
-        throw error;
-      }
-      if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-        return undefined;
-      }
-      throw makeCliError({
-        code: "kit.cli.CREDENTIAL_STORE_FAILED",
-        message: error instanceof Error ? error.message : "Failed to load credentials",
-        cause: error,
-      });
-    }
-  }
-
-  try {
-    return StoredCredentialsSchema.parse(JSON.parse(encoded));
-  } catch (error) {
-    throw makeCliError({
-      code: "kit.cli.CREDENTIAL_STORE_FAILED",
-      message: "Stored credentials are invalid or corrupt.",
-      why: "The credential payload failed Zod validation.",
-      fix: "Run 'dalp logout' then 'dalp login' to refresh credentials.",
-      cause: error,
-    });
-  }
-}
-
-export async function deleteCredentials(options: CredentialStoreOptions = {}): Promise<void> {
-  const configDir = options.configDir ?? getConfigDir();
-  const platform = resolvePlatform(options);
-  const runSecurity = options.runSecurity ?? defaultRunSecurity;
-
-  if (platform === "darwin") {
-    for (const account of await keychainAccounts(runSecurity)) {
-      await deleteKeychainAccount(runSecurity, account);
-    }
-    return;
-  }
-
-  try {
-    await unlink(credentialsFile(configDir));
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      return;
-    }
-    throw makeCliError({
-      code: "kit.cli.CREDENTIAL_STORE_FAILED",
-      message: error instanceof Error ? error.message : "Failed to delete credentials",
-      cause: error,
-    });
-  }
-}

package/src/lib/errors.ts

@@ -1,207 +0,0 @@
-import { findDalpSdkError, isDalpApiError } from "@settlemint/dalp-sdk";
-import { buildErrorCta, extractResourceLinks, type CliCtaBlock, type ResourceLinks } from "./cli-cta.ts";
-import type { GatedFeature } from "./feature-gated-operations.ts";
-
-export interface CliErrorContext {
-  readonly code: string;
-  readonly fallbackMessage: string;
-  readonly fallbackWhy: string;
-  readonly fallbackFix: string;
-  readonly gatedFeature?: GatedFeature;
-}
-
-export interface RenderedCliError {
-  readonly code: string;
-  readonly message: string;
-  readonly retryable: boolean;
-  readonly cta: CliCtaBlock;
-}
-
-export class CliError extends Error {
-  override readonly name = "CliError";
-  readonly code: string;
-  readonly retryable: boolean;
-  readonly why: string;
-  readonly fix: string;
-  readonly links?: ResourceLinks;
-  readonly category?: string;
-
-  constructor(options: {
-    readonly message: string;
-    readonly code: string;
-    readonly retryable?: boolean;
-    readonly why?: string;
-    readonly fix?: string;
-    readonly cause?: unknown;
-    readonly links?: ResourceLinks;
-    readonly category?: string;
-  }) {
-    super(options.message, options.cause === undefined ? undefined : { cause: options.cause });
-    this.code = options.code;
-    this.retryable = options.retryable ?? false;
-    this.why = options.why ?? "The CLI operation failed.";
-    this.fix = options.fix ?? "Correct the input or environment, then retry.";
-    if (options.links !== undefined) {
-      this.links = options.links;
-    }
-    if (options.category !== undefined) {
-      this.category = options.category;
-    }
-  }
-}
-
-export function makeCliError(options: ConstructorParameters<typeof CliError>[0]): CliError {
-  return new CliError(options);
-}
-
-export function isCliFailure(error: unknown): error is CliError {
-  return (
-    typeof error === "object" &&
-    error !== null &&
-    Reflect.get(error, "name") === "CliError" &&
-    typeof Reflect.get(error, "code") === "string" &&
-    typeof Reflect.get(error, "message") === "string"
-  );
-}
-
-export interface NormalizedFailure {
-  readonly code: string;
-  readonly message: string;
-  readonly why: string;
-  readonly fix: string;
-  readonly retryable: boolean;
-  readonly category?: string;
-  readonly links?: ResourceLinks;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-function extractWireFailure(error: unknown): NormalizedFailure | undefined {
-  if (!isRecord(error)) {
-    return undefined;
-  }
-  const message = typeof error.message === "string" ? error.message : undefined;
-  const code = typeof error.code === "string" ? error.code : undefined;
-  const data = isRecord(error.data) ? error.data : undefined;
-
-  const whyFromData = data !== undefined && typeof data.why === "string" ? data.why : undefined;
-  const fixFromData = data !== undefined && typeof data.fix === "string" ? data.fix : undefined;
-  const whyTop = typeof error.why === "string" ? error.why : undefined;
-  const fixTop = typeof error.fix === "string" ? error.fix : undefined;
-  const why = whyFromData ?? whyTop;
-  const fix = fixFromData ?? fixTop;
-
-  if (message === undefined && why === undefined && code === undefined) {
-    return undefined;
-  }
-  if (code === undefined && why === undefined) {
-    return undefined;
-  }
-
-  const retryableFromData = data !== undefined && typeof data.retryable === "boolean" ? data.retryable : undefined;
-  const retryableTop = typeof error.retryable === "boolean" ? error.retryable : undefined;
-  const categoryFromData = data !== undefined && typeof data.category === "string" ? data.category : undefined;
-  const categoryTop = typeof error.category === "string" ? error.category : undefined;
-  const idFromData = data !== undefined && typeof data.id === "string" ? data.id : undefined;
-
-  const links = extractResourceLinks(error) ?? (data !== undefined ? extractResourceLinks(data) : undefined);
-
-  return {
-    code: code ?? idFromData ?? "API_ERROR",
-    message: message ?? code ?? "Request failed",
-    why: why ?? "The DALP API rejected the request.",
-    fix: fix ?? "Correct the input or environment, then retry.",
-    retryable: retryableFromData ?? retryableTop ?? false,
-    ...(categoryFromData !== undefined || categoryTop !== undefined
-      ? { category: categoryFromData ?? categoryTop }
-      : {}),
-    ...(links === undefined ? {} : { links }),
-  };
-}
-
-function normalizeFailure(error: unknown, context: CliErrorContext): NormalizedFailure {
-  if (isDalpApiError(error)) {
-    return {
-      code: error.code,
-      message: error.message,
-      why: error.why,
-      fix: error.fix,
-      retryable: error.retryable,
-      category: error.category,
-      ...(extractResourceLinks(error) === undefined ? {} : { links: extractResourceLinks(error) }),
-    };
-  }
-
-  const sdkError = findDalpSdkError(error);
-  if (sdkError !== undefined) {
-    return {
-      code: sdkError.code,
-      message: sdkError.message,
-      why: sdkError.why,
-      fix: sdkError.fix,
-      retryable: sdkError.retryable,
-      category: sdkError.category,
-    };
-  }
-
-  if (isCliFailure(error)) {
-    return {
-      code: error.code,
-      message: error.message,
-      why: error.why,
-      fix: error.fix,
-      retryable: error.retryable,
-      ...(error.category === undefined ? {} : { category: error.category }),
-      ...(error.links === undefined ? {} : { links: error.links }),
-    };
-  }
-
-  const wire = extractWireFailure(error);
-  if (wire !== undefined) {
-    return wire;
-  }
-
-  const message = error instanceof Error ? error.message : context.fallbackMessage;
-  return {
-    code: context.code,
-    message,
-    why: context.fallbackWhy,
-    fix: context.fallbackFix,
-    retryable: false,
-  };
-}
-
-const ROUTE_NOT_FOUND_CODE = "ROUTE_NOT_FOUND";
-
-function featureNotEnabledFailure(feature: GatedFeature): NormalizedFailure {
-  return {
-    code: "FEATURE_NOT_ENABLED",
-    message: `${feature.name} is not enabled on this deployment.`,
-    why: `The platform answered with an unknown route because ${feature.name} is switched off (${feature.setting}), so it does not serve this command.`,
-    fix: `Ask the operator of this deployment to switch ${feature.name} on, or use a deployment that has it enabled.`,
-    retryable: false,
-    category: "domain",
-  };
-}
-
-export function renderSdkErrorForCli(error: unknown, context: CliErrorContext): RenderedCliError {
-  const normalized = normalizeFailure(error, context);
-  const failure =
-    context.gatedFeature !== undefined && normalized.code === ROUTE_NOT_FOUND_CODE
-      ? featureNotEnabledFailure(context.gatedFeature)
-      : normalized;
-  return {
-    code: failure.code,
-    message: failure.message,
-    retryable: failure.retryable,
-    cta: buildErrorCta({
-      why: failure.why,
-      fix: failure.fix,
-      code: failure.code,
-      ...(failure.category === undefined ? {} : { category: failure.category }),
-      ...(failure.links === undefined ? {} : { links: failure.links }),
-    }),
-  };
-}

package/src/lib/feature-gated-operations.ts

@@ -1,18 +0,0 @@
-export interface GatedFeature {
-  readonly name: string;
-  readonly setting: string;
-}
-
-const FEATURE_GATED_OPERATION_GROUPS: Readonly<Record<string, GatedFeature>> = {
-  cantonV2: { name: "Canton", setting: "features.canton" },
-};
-
-export const gatedFeatureOfOperation = (operationName: string): GatedFeature | undefined => {
-  const group = operationName.split(".", 1)[0] ?? "";
-  return Object.hasOwn(FEATURE_GATED_OPERATION_GROUPS, group) ? FEATURE_GATED_OPERATION_GROUPS[group] : undefined;
-};
-
-export const gatedFeatureContext = (operationName: string): { readonly gatedFeature?: GatedFeature } => {
-  const gatedFeature = gatedFeatureOfOperation(operationName);
-  return gatedFeature === undefined ? {} : { gatedFeature };
-};

package/src/lib/openapi-surface-types.ts

@@ -1,41 +0,0 @@
-export interface SurfaceParam {
-  readonly name: string;
-  readonly in: "path" | "query" | "header";
-  readonly required: boolean;
-  readonly description: string | null;
-  readonly type: string | null;
-  readonly enum: ReadonlyArray<string> | null;
-  readonly pattern: string | null;
-  readonly examples: ReadonlyArray<string>;
-  readonly default: unknown;
-  readonly fields: ReadonlyArray<SurfaceParam>;
-}
-
-export interface SurfaceOperation {
-  readonly name: string;
-  readonly method: string;
-  readonly url: string;
-  readonly summary: string | null;
-  readonly description: string | null;
-  readonly help: string;
-  readonly tags: ReadonlyArray<string>;
-  readonly pathParams: ReadonlyArray<SurfaceParam>;
-  readonly queryParams: ReadonlyArray<SurfaceParam>;
-  readonly headerParams: ReadonlyArray<SurfaceParam>;
-  readonly requestBodyDescription: string | null;
-  readonly hasRequestBody: boolean;
-  readonly bodyIsComplex: boolean;
-  readonly bodyFields: ReadonlyArray<SurfaceParam>;
-  readonly examples: ReadonlyArray<{
-    readonly description: string;
-    readonly path?: Record<string, string>;
-    readonly query?: Record<string, string>;
-  }>;
-}
-
-export interface OpenApiSurface {
-  readonly openapiSource: string;
-  readonly sdkSource: string;
-  readonly operations: Record<string, SurfaceOperation>;
-  readonly tags: Record<string, string>;
-}

package/src/lib/openapi-surface.ts

@@ -1,17 +0,0 @@
-import path from "node:path";
-import surfaceAssetPath from "../generated/openapi-surface.json" with { type: "file" };
-import type { OpenApiSurface, SurfaceOperation } from "./openapi-surface-types.ts";
-
-export type { OpenApiSurface, SurfaceOperation, SurfaceParam } from "./openapi-surface-types.ts";
-
-const surfaceFile = path.resolve(import.meta.dir, surfaceAssetPath);
-const openApiSurface = (await Bun.file(surfaceFile).json()) as OpenApiSurface;
-
-export function surfaceFor(operationName: string): SurfaceOperation | undefined {
-  return openApiSurface.operations[operationName];
-}
-
-export function tagDescription(tag: string): string | undefined {
-  const value = openApiSurface.tags[tag];
-  return value !== undefined && value.trim() !== "" ? value : undefined;
-}