@contentful/experience-design-system-cli 2.37.1-dev-build-2582b468.0 → 2.37.1-dev-build-41b62bf7.0

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-2582b468.0",
+  "version": "2.37.1-dev-build-41b62bf7.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/dist/src/tui/settings/configuration/agents/AgentDetail.d.ts

@@ -5,9 +5,11 @@ import { type AgentConfig } from './agent-store.js';
  * One agent's screen: what was found for it, its two settings, and the test. Saving writes the whole agent config, so the
  * default agent and the other agents are kept. The test uses the values on screen, saved or not.
  */
-export declare function AgentDetail({ name, config, setConfig, onBack, }: {
+export declare function AgentDetail({ name, config, setConfig, onBack, record, }: {
     name: AgentName;
     config: AgentConfig;
     setConfig: (config: AgentConfig) => void;
     onBack: () => void;
+    /** Adds a line to the debug log of this visit. The Agents list owns the log, since it is the screen that is open. */
+    record: (action: string, error?: unknown) => void;
 }): React.ReactElement;

package/dist/src/tui/settings/configuration/agents/agent-debug.d.ts

@@ -0,0 +1,25 @@
+import { type AgentName } from '@contentful/experience-design-system-backend-pipeline';
+import type { Snapshot } from '../../shared/debug-trail.js';
+import type { AgentConfig } from './agent-store.js';
+/**
+ * The agent settings as flat text, for `diffSnapshots`: `default_agent`, then `<agent>.model` and `<agent>.binary` for
+ * every agent. Taken on entry and on exit, so the log shows what a visit changed.
+ */
+export declare function agentSnapshot(config: AgentConfig): Snapshot;
+export type AgentEnvironment = {
+    /** Whether the command was found, and the path it resolved to. */
+    found: boolean;
+    resolved_path: string;
+    version: string;
+    /**
+     * The `EDS_AGENT_BINARY_<AGENT>` variable when it points somewhere other than the saved path. Settings copies a saved
+     * path into that variable at startup, so a value equal to the saved path is not an override and is left out.
+     */
+    env_override: string;
+};
+/**
+ * What is true about each agent on this machine, so "my agent does not work" can be read from the log: found or not,
+ * where, its version, and whether a shell variable is overriding the saved path. Uses the quick checks only, so it never
+ * spends a prompt.
+ */
+export declare function describeAgents(config: AgentConfig): Promise<Record<AgentName, AgentEnvironment>>;

package/dist/src/tui/settings/shared/debug-trail.d.ts

@@ -0,0 +1,35 @@
+/** One screen's values, as flat text, taken when the screen opens and again when it closes. */
+export type Snapshot = Record<string, string>;
+export type Change = {
+    changed: boolean;
+    /** Field names that differ between the two snapshots, in the order the fields appear. Never the values. */
+    changed_fields: string[];
+};
+/**
+ * Compares the snapshot taken on entry with the one taken on exit. A field that exists in only one of them counts as
+ * changed. Only names are returned, so the result can be logged without repeating a secret.
+ */
+export declare function diffSnapshots(before: Snapshot, after: Snapshot): Change;
+export type Trail = {
+    /** Adds one action, such as `edited spaceId`, `saved`, or `made Codex the default`. Field names, never values. */
+    record(action: string): void;
+    /** The recorded actions in order, oldest first. Once the limit is passed the oldest are dropped. */
+    entries(): string[];
+};
+/** Keeps the last `limit` actions of a visit, so a long visit cannot make the log grow without bound. */
+export declare function createTrail(limit?: number): Trail;
+/**
+ * The message of a failed load or save, safe to log: any of `secrets` that appears in it is replaced. The CMA token is
+ * only redacted by key elsewhere, so an error that quotes it would otherwise get through. A secret is matched as it is
+ * and as it looks URL-encoded, which is how it appears in a request error.
+ */
+export declare function scrubError(error: unknown, secrets: readonly string[]): string;
+/**
+ * Where Project's settings live and what could be moving them: the settings file path, whether `EDS_HOME` relocated it,
+ * and whether the file exists. Facts for the log, with no values read from the file.
+ */
+export declare function describeSettingsFile(): {
+    path: string;
+    eds_home_set: boolean;
+    exists: boolean;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.37.1-dev-build-2582b468.0",
+  "version": "2.37.1-dev-build-41b62bf7.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -45,8 +45,8 @@
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
     "zod": "^4.6.5",
-    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-2582b468.0",
-    "@contentful/experience-design-system-types": "2.37.1-dev-build-2582b468.0"
+    "@contentful/experience-design-system-backend-pipeline": "2.37.1-dev-build-41b62bf7.0",
+    "@contentful/experience-design-system-types": "2.37.1-dev-build-41b62bf7.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",