archal 0.9.13 → 0.9.15

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

@@ -1,3 +1,33 @@
+/**
+ * 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>[]>;
@@ -46,6 +76,15 @@ interface DynamicSeedConfig {
      * 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;