@contentful/experience-design-system-cli 2.35.1-dev-build-98f1ba74.0 → 2.35.1-dev-build-c8bff53c.0

package/legacy/dist/src/map-tokens/tui/MapTokensView.d.ts

@@ -3,6 +3,7 @@ export interface MapTokensViewResult {
     agent: string;
     sessionId: string;
     applied: number;
+    cached: boolean;
 }
 interface MapTokensViewProps {
     result: MapTokensViewResult;

package/legacy/dist/src/session/cache-keys.d.ts

@@ -0,0 +1,22 @@
+import { type Skill } from '@contentful/experience-design-system-generation';
+/** sha256 hex of a string. Stable across runs. */
+export declare function hashContent(content: string): string;
+/** sha256 hex of a file's UTF-8 content. */
+export declare function hashFile(filePath: string): Promise<string>;
+/**
+ * Hash the prompt content for a skill — either the bundled skill file shipped
+ * with the CLI, or a custom override path. Used to key the select_cache and
+ * generation_cache so cache entries invalidate when the prompt itself changes
+ * (including bundled-skill updates across CLI versions).
+ *
+ * Also folds in the resolved agent and model: a cache hit must not stand in
+ * for an agent run that was never made with the currently requested
+ * agent/model, or `--agent`/`--model` overrides would appear to be ignored
+ * whenever a prior cache entry already exists for the same input/prompt.
+ *
+ * @param skill — which skill (matches resolveSkillPath in prompt-builder)
+ * @param agent — resolved agent name for this run
+ * @param model — resolved model for this run (undefined resolves to the agent's default)
+ * @param skillPathOverride — optional absolute/relative path to a custom prompt
+ */
+export declare function hashPromptForSkill(skill: Skill, agent: string, model: string | undefined, skillPathOverride?: string, extraInputs?: string[], skillContentOverride?: string): Promise<string>;

package/legacy/dist/src/session/core/components/hash-component-shape.d.ts

@@ -0,0 +1,5 @@
+import type { RawComponentDefinition } from '../../../types.js';
+export type RawComponentForHash = RawComponentDefinition & {
+    component_id?: string;
+};
+export declare function hashComponentShape(component: RawComponentForHash): string;

package/legacy/dist/src/session/core/tokens/hash-token-content.d.ts

@@ -0,0 +1 @@
+export declare function hashTokenContent(rawTokenContent: string): string;

package/legacy/dist/src/session/db.d.ts

@@ -6,6 +6,8 @@ import type { ComponentTypeSummary } from '@contentful/experience-design-system-
 import type { SlotCycle, SlotEdge } from '../analyze/cycle-detection.js';
 import { type MatchHints as SessionMatchHints } from './repositories/sessions/read.js';
 import { type SessionResolution } from './services/session-resolver.js';
+export { hashComponentShape as computeComponentInputHash } from './core/components/hash-component-shape.js';
+export { hashTokenContent as computeTokenInputHash } from './core/tokens/hash-token-content.js';
 export { getDtcgTokensForSession as loadDTCGTokens, getRawTokenNamePaths as loadRawTokenNamePaths, getRawTokenNamePathRows as loadRawTokenNamePathRows, } from './repositories/tokens/read.js';
 export { storeDtcgTokens as storeDTCGTokens } from './services/tokens/store-dtcg-tokens.js';
 export { applyTokenToolCalls } from './services/tokens/apply-tool-calls.js';
@@ -110,6 +112,29 @@ export declare function seedDefaultsFromChangedItems(db: DatabaseSync, sessionId
     proposed: object;
 }>): number;
 export declare function backfillUnclassifiedProps(db: DatabaseSync, sessionId: string): number;
+export type CacheEntityType = 'component' | 'token_set' | 'token_mapping';
+export interface CacheEntry {
+    inputHash: string;
+    entityType: CacheEntityType;
+    entityId: string;
+    sourceSessionId: string;
+    humanEdited: boolean;
+    promptHash: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function computeMapTokensInputHash(db: DatabaseSync, sessionId: string, componentSourceRefs?: readonly ComponentSourceRef[]): string;
+export declare function lookupCache(db: DatabaseSync, inputHash: string, entityType: CacheEntityType, entityId: string, promptHash?: string): CacheEntry | null;
+export declare function lookupCacheByEntity(db: DatabaseSync, entityType: CacheEntityType, entityId: string): CacheEntry | null;
+export declare function storeCache(db: DatabaseSync, inputHash: string, entityType: CacheEntityType, entityId: string, sourceSessionId: string, humanEdited: boolean, promptHash?: string): void;
+export declare function storeCaches(db: DatabaseSync, entries: Array<{
+    inputHash: string;
+    entityType: CacheEntityType;
+    entityId: string;
+    sourceSessionId: string;
+    humanEdited: boolean;
+    promptHash?: string;
+}>): void;
 export declare function storeScannedFiles(db: DatabaseSync, sessionId: string, filePaths: string[]): void;
 export declare function loadScannedFiles(db: DatabaseSync, sessionId: string): string[];
 export declare function storeSlotCycles(db: DatabaseSync, sessionId: string, cycles: Array<SlotCycle & {
@@ -120,12 +145,57 @@ export interface StoredSlotCycle extends SlotCycle {
 }
 export declare function loadSlotCycles(db: DatabaseSync, sessionId: string): StoredSlotCycle[];
 export declare function clearSlotCycles(db: DatabaseSync, sessionId: string): void;
-interface UnknownSlotAllowedComponent {
+export declare function markCacheHumanEdited(db: DatabaseSync, entityType: 'component' | 'token_set', entityId: string): void;
+export interface UnknownSlotAllowedComponent {
     componentId: string;
     componentName: string;
     slotName: string;
     allowedComponent: string;
 }
+export declare function findUnknownSlotAllowedComponents(db: DatabaseSync, sessionId: string, allowedComponentNames: ReadonlySet<string>, componentId?: string): UnknownSlotAllowedComponent[];
 /** Remove slot references that cannot resolve in the current manifest or target space. */
 export declare function filterUnknownSlotAllowedComponents(db: DatabaseSync, sessionId: string, allowedComponentNames: ReadonlySet<string>): UnknownSlotAllowedComponent[];
-export declare function copyTokensBetweenSessions(db: DatabaseSync, sourceSessionId: string, targetSessionId: string): void;
+export interface CopyComponentFromCacheOptions {
+    allowedComponentNames?: ReadonlySet<string>;
+}
+export declare function copyComponentFromCache(db: DatabaseSync, sourceSessionId: string, targetSessionId: string, componentId: string, manageTransaction?: boolean, options?: CopyComponentFromCacheOptions): void;
+export declare function copyComponentsFromCache(db: DatabaseSync, entries: Array<{
+    sourceSessionId: string;
+    targetSessionId: string;
+    componentId: string;
+}>, options?: CopyComponentFromCacheOptions): void;
+export declare function copyTokensFromCache(db: DatabaseSync, sourceSessionId: string, targetSessionId: string): void;
+export declare function copyMapTokensFromCache(db: DatabaseSync, sourceSessionId: string, targetSessionId: string): number;
+export declare function getCliCacheVersion(): Promise<string>;
+export interface ExtractCacheEntry {
+    filePath: string;
+    fileHash: string;
+    cliVersion: string;
+    createdAt: string;
+    updatedAt: string;
+    components: RawComponentDefinition[];
+}
+export declare function storeExtractCache(db: DatabaseSync, filePath: string, fileHash: string, cliVersion: string, components: RawComponentDefinition[]): void;
+export declare function lookupExtractCache(db: DatabaseSync, fileHash: string, cliVersion: string): ExtractCacheEntry | null;
+/**
+ * Content-addressed cache for the composition resolver's raw agent output
+ * (authored parser source or emitted-edge JSONL). Keyed by a hash of the
+ * candidate files + producer identity (`composition-cache-key.ts`), scoped by
+ * `cli_version` so a prompt/skill change invalidates stale entries. Replaces
+ * the former on-disk `~/.contentful/.../composition-cache` store so all CLI
+ * caches live in the one pipeline DB.
+ */
+export declare function storeCompositionCache(db: DatabaseSync, inputHash: string, cliVersion: string, agentOutput: string): void;
+export declare function lookupCompositionCache(db: DatabaseSync, inputHash: string, cliVersion: string): string | null;
+export type SelectDecision = 'accepted' | 'rejected';
+export interface SelectCacheEntry {
+    componentHash: string;
+    promptHash: string;
+    cliVersion: string;
+    decision: SelectDecision;
+    reason: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function storeSelectCache(db: DatabaseSync, componentHash: string, promptHash: string, cliVersion: string, decision: SelectDecision, reason: string | null): void;
+export declare function lookupSelectCache(db: DatabaseSync, componentHash: string, promptHash: string, cliVersion: string): SelectCacheEntry | null;

package/legacy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.35.1-dev-build-98f1ba74.0",
+  "version": "2.35.1-dev-build-c8bff53c.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/experience-design-system-cli",
-  "version": "2.35.1-dev-build-98f1ba74.0",
+  "version": "2.35.1-dev-build-c8bff53c.0",
   "description": "Contentful Experiences design system import CLI",
   "license": "MIT",
   "type": "module",
@@ -42,7 +42,7 @@
     "svelte": "^5.56.4",
     "ts-morph": "^27.0.2",
     "typescript": "^5.9.3",
-    "@contentful/experience-design-system-types": "2.35.1-dev-build-98f1ba74.0"
+    "@contentful/experience-design-system-types": "2.35.1-dev-build-c8bff53c.0"
   },
   "devDependencies": {
     "@tsconfig/node24": "^24.0.4",