ask-marcel-office-cli 2.2.0 → 2.3.0

package/dist/composition/run-registry-command.d.ts

@@ -1,10 +1,17 @@
 import type { GraphClient } from '../infra/graph-client.js';
 import type { ErrorSource } from '../presenter/error-hints.js';
+import type { RenderSurface, SizeHintContext } from '../presenter/render-to-string.js';
 import type { Command } from '../use-cases/commands/command-types.js';
 import type { OutputDirError, OutputPathError } from '../use-cases/commands/output-path.js';
 import type { Result } from '../domain/result.js';
 import type { FileSystem } from '../use-cases/ports/filesystem.js';
-declare const formatOutputPathError: (error: OutputPathError, commandName: string) => string;
+/**
+ * The facts the oversized-response banner needs to name a remedy this caller
+ * can actually use. Derived from the manifest, so a new command gets an honest
+ * banner for free. See `SizeHintContext` in the presenter for the why.
+ */
+declare const buildSizeHintContext: (commandName: string, command: Command, surface: RenderSurface) => SizeHintContext;
+declare const formatOutputPathError: (error: OutputPathError, commandName: string, surface: RenderSurface) => string;
 declare const formatOutputDirError: (error: OutputDirError, commandName: string) => string;
 export type RunRegistryCommandDeps = {
     readonly graph: GraphClient;
@@ -14,10 +21,12 @@ export type RunRegistryCommandRequest = {
     /** Canonical registry name — drives the manifest-derived error messages. */
     readonly name: string;
     readonly command: Command;
-    /** Raw params, still possibly keyed by an option ALIAS. */
+    /** Raw params, keyed by the canonical camelCase option keys. */
     readonly params: Record<string, string>;
     readonly outputPath?: string;
     readonly outputDir?: string;
+    /** Which front end asked. Decides whether a remedy may mention a shell. */
+    readonly surface: RenderSurface;
 };
 /**
  * `source` / `code` / `retryAfterSeconds` are optional on purpose: the
@@ -31,4 +40,4 @@ export type RunRegistryCommandFailure = {
     readonly retryAfterSeconds?: number;
 };
 export declare const runRegistryCommand: (deps: RunRegistryCommandDeps, request: RunRegistryCommandRequest) => Promise<Result<unknown, RunRegistryCommandFailure>>;
-export { formatOutputDirError, formatOutputPathError };
+export { buildSizeHintContext, formatOutputDirError, formatOutputPathError };