archal 0.9.19 → 0.9.20

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

@@ -1,106 +0,0 @@
-/**
- * Shared type-only declarations for the seed-codegen modules.
- *
- * Lives as a leaf module so `test-overrides.ts` can describe its
- * registry shape without importing back into `executor.ts`,
- * `legacy-codegen.ts`, or `seed-llm.ts`. Previously the override file
- * imported types from each producer, and each producer imported the
- * registry value back, forming four interlocking cycles.
- */
-
-/**
- * Audit row reported after a direct (non-proxy) seedgen LLM call.
- *
- * Structurally compatible with `infra/api/llm/usage-log.ts#ManagedLlmUsageInput`
- * so the API route can pass `recordManagedLlmUsageLog` straight through. The
- * proxy path already logs via the proxy hook; this callback closes the
- * cooldown-fallback bypass where direct calls would otherwise miss accounting.
- */
-interface SeedgenDirectUsage {
-    userId: string;
-    sessionId: string | null;
-    intent: 'seedgen';
-    model: string;
-    inputTokens: number;
-    outputTokens: number;
-    clientBringsOwnKey: boolean;
-    authKind: string | null;
-}
-type SeedgenDirectUsageReporter = (usage: SeedgenDirectUsage) => Promise<void>;
-
-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;
-    /**
-     * Server-side direct-fallback accounting hook. The API route wires this to
-     * `recordManagedLlmUsageLog` so cooldown-fallback calls (which use infra
-     * env keys, not the proxy) are still attributed to the requesting user.
-     * Undefined in CLI / vitest contexts — those use BYOK and don't need it.
-     */
-    recordDirectUsage?: SeedgenDirectUsageReporter;
-    /** Auth kind for direct-usage attribution (`user` | `internal_service`). */
-    authKind?: 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 };