archal 0.9.7 → 0.9.9

package/dist/seed/dynamic-generator.d.cts

@@ -0,0 +1,67 @@
+interface SeedPatch {
+    add?: Record<string, Record<string, unknown>[]>;
+    modify?: Record<string, Record<string, unknown>[]>;
+    remove?: Record<string, number[]>;
+}
+
+interface SeedIntentEntityRef {
+    kind: string;
+    key: string;
+    value: string | number | boolean;
+}
+interface SeedIntent {
+    twinName: string;
+    setupSummary: string;
+    requiredSlots: string[];
+    extractedSlots: Record<string, string | number | boolean>;
+    entities: SeedIntentEntityRef[];
+    quotedStrings: string[];
+}
+
+/**
+ * LLM routing and cooldown logic for seed codegen.
+ *
+ * Extracted from dynamic-generator.ts so this module can be imported by the
+ * infra server without pulling in the full generator machinery.
+ */
+
+declare function resetManagedSeedBackendStateForTests(): void;
+
+declare class DynamicSeedError extends Error {
+    readonly twinName: string;
+    readonly validationErrors: string[];
+    constructor(twinName: string, validationErrors: string[], hint?: string);
+}
+
+interface DynamicSeedConfig {
+    noCache?: boolean;
+    /** When true, FK validation failures and coverage gaps become hard errors instead of warnings. */
+    strictSeed?: boolean;
+    /** When true, use the caller-prepared seed input verbatim instead of re-scoping it to one twin. */
+    skipTwinScoping?: boolean;
+    /**
+     * User identifier used to scope the managed-backend cooldown.
+     * When omitted (CLI usage), a global key is used — safe because each CLI
+     * invocation is a separate process. In the infra server, pass the userId so
+     * a 503 from one user's request does not block other users.
+     */
+    userId?: string;
+}
+interface SeedPromptContext {
+    scenarioTitle?: string;
+    expectedBehavior?: string;
+    successCriteria?: string[];
+}
+interface DynamicSeedResult {
+    seed: Record<string, unknown[]>;
+    patch: SeedPatch;
+    fromCache: boolean;
+    source: 'llm' | 'cache';
+    /** The JavaScript code that produced this seed (only set when source==='llm'). */
+    generatedCode?: string;
+    /** SQL seed for Supabase twins — used instead of seed JSON when present. */
+    seedSql?: string;
+}
+declare function generateDynamicSeed(twinName: string, baseSeedName: string, baseSeedData: Record<string, unknown[]>, setupDescription: string, config: DynamicSeedConfig, intent?: SeedIntent, context?: SeedPromptContext): Promise<DynamicSeedResult>;
+
+export { type DynamicSeedConfig, DynamicSeedError, type SeedPromptContext, generateDynamicSeed, resetManagedSeedBackendStateForTests };