@superblocksteam/vite-plugin-file-sync 1.99.99-next.2 → 2.0.0-SNAPSHOT.2143e2e95d0107ab

package/dist/ai-service/migration-autodispatch-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-autodispatch-metrics.d.ts","sourceRoot":"","sources":["../../src/ai-service/migration-autodispatch-metrics.ts"],"names":[],"mappings":"AAqBA,wBAAgB,2CAA2C,CACzD,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAQR;AA6BD,wBAAgB,kCAAkC,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAExE"}

package/dist/ai-service/migration-autodispatch-metrics.js

@@ -0,0 +1,52 @@
+import { metrics } from "@opentelemetry/api";
+const METER_NAME = "superblocks.migration";
+const METRIC_OUTCOMES = "migration.autodispatch.outcome";
+const BUSY_REASON_PREFIX = "busy:";
+const STATIC_OUTCOME_REASONS = new Set([
+    "already-settled",
+    "already-triggered",
+    "awaiting-interactive-response",
+    "checklist-unavailable",
+    "dead",
+    "dispatched",
+    "jwt-unavailable",
+    "no-pending-items",
+    "other",
+    "pending-tool-permission",
+    "quota-exceeded",
+]);
+export function normalizeMigrationAutoDispatchOutcomeReason(reason) {
+    if (!reason) {
+        return "other";
+    }
+    if (reason.startsWith(BUSY_REASON_PREFIX)) {
+        return reason;
+    }
+    return STATIC_OUTCOME_REASONS.has(reason) ? reason : "other";
+}
+class MigrationAutoDispatchMetrics {
+    cachedMeter;
+    outcomeCounter;
+    getOutcomeCounter() {
+        const meter = metrics.getMeter(METER_NAME);
+        if (meter === this.cachedMeter && this.outcomeCounter) {
+            return this.outcomeCounter;
+        }
+        this.cachedMeter = meter;
+        this.outcomeCounter = meter.createCounter(METRIC_OUTCOMES, {
+            description: "Post-flip migration auto-dispatch outcomes from the dev server.",
+            unit: "1",
+        });
+        return this.outcomeCounter;
+    }
+    recordOutcome(reason) {
+        this.getOutcomeCounter().add(1, {
+            reason: normalizeMigrationAutoDispatchOutcomeReason(reason),
+        });
+    }
+}
+const migrationAutoDispatchMetrics = new MigrationAutoDispatchMetrics();
+export function recordMigrationAutoDispatchOutcome(reason) {
+    migrationAutoDispatchMetrics.recordOutcome(reason);
+}
+//# sourceMappingURL=migration-autodispatch-metrics.js.map

package/dist/ai-service/migration-autodispatch-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-autodispatch-metrics.js","sourceRoot":"","sources":["../../src/ai-service/migration-autodispatch-metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA4B,MAAM,oBAAoB,CAAC;AAEvE,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAC3C,MAAM,eAAe,GAAG,gCAAgC,CAAC;AAEzD,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,iBAAiB;IACjB,mBAAmB;IACnB,+BAA+B;IAC/B,uBAAuB;IACvB,MAAM;IACN,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,OAAO;IACP,yBAAyB;IACzB,gBAAgB;CACjB,CAAC,CAAC;AAEH,MAAM,UAAU,2CAA2C,CACzD,MAAe;IAEf,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/D,CAAC;AAED,MAAM,4BAA4B;IACxB,WAAW,CAAoB;IAC/B,cAAc,CAAsB;IAEpC,iBAAiB;QACvB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtD,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,eAAe,EAAE;YACzD,WAAW,EACT,iEAAiE;YACnE,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED,aAAa,CAAC,MAAe;QAC3B,IAAI,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE;YAC9B,MAAM,EAAE,2CAA2C,CAAC,MAAM,CAAC;SAC5D,CAAC,CAAC;IACL,CAAC;CACF;AAED,MAAM,4BAA4B,GAAG,IAAI,4BAA4B,EAAE,CAAC;AAExE,MAAM,UAAU,kCAAkC,CAAC,MAAe;IAChE,4BAA4B,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;AACrD,CAAC"}

package/dist/ai-service/migration-llm-config.d.ts

@@ -0,0 +1,12 @@
+import type { LLMProviderConfig } from "@superblocksteam/library-shared/types";
+/**
+ * Builds a migration-safe LLM config on the dev server using org flag
+ * bootstrap values. Checklist + migration tools are always enabled.
+ */
+export declare function buildServerMigrationLlmConfig(flagBootstrap?: Record<string, unknown>): LLMProviderConfig;
+/**
+ * Whether the dev server may auto-dispatch the post-flip migration turn.
+ * Default off — soak via LaunchDarkly before enabling broadly.
+ */
+export declare function isMigrationAutoDispatchEnabled(flagBootstrap?: Record<string, unknown>): boolean;
+//# sourceMappingURL=migration-llm-config.d.ts.map

package/dist/ai-service/migration-llm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-llm-config.d.ts","sourceRoot":"","sources":["../../src/ai-service/migration-llm-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,iBAAiB,EAClB,MAAM,uCAAuC,CAAC;AAwG/C;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,iBAAiB,CAsFnB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACtC,OAAO,CAET"}

package/dist/ai-service/migration-llm-config.js

@@ -0,0 +1,132 @@
+import { FALLBACK_STRATEGIES } from "@superblocksteam/library-shared/types";
+/**
+ * LaunchDarkly keys mirrored from the UI `Flag` enum for Clark LLM config.
+ * Keep in sync with `packages/ui/src/app/store/slices/featureFlags/models/Flags.ts`.
+ */
+const FLAG_KEYS = {
+    chaosOptions: "ui.clark-ai.chaos.options",
+    contextOptionsV2: "ai.context-v2.options",
+    coreModelName: "superblocks.ai.core-model.name",
+    defaultThinkingBudget: "ui.clark-ai.default-thinking-budget",
+    fallbackStrategy: "ai.fallback.strategy",
+    llmProvider: "ui.clark-ai.llm-provider",
+    migrationAutoDispatchEnabled: "clark.migration-autodispatch.enabled",
+    navigationToolEnabled: "ui.clark-ai.tool.navigation",
+    screenshotToolEnabled: "ai.screenshot-tool.enabled",
+    serverContextManagement: "ai.server-context-management.options",
+    testingEnabled: "ai.playwright-app-test.enabled",
+    unifiedProviderEnabled: "superblocks.ai.provider.unified",
+};
+const VALID_CORE_MODELS = [
+    "claude-opus-4-5",
+    "claude-opus-4-6",
+    "claude-opus-4-7",
+    "claude-opus-4-8",
+    "claude-opus-5",
+    "claude-sonnet-4-5",
+    "claude-sonnet-4-6",
+];
+const DEFAULT_CORE_MODEL = "claude-sonnet-4-5";
+const isValidProvider = (provider) => provider === "vertex" ||
+    provider === "bedrock" ||
+    provider === "anthropic" ||
+    provider === "snowflake";
+const normalizeProvider = (provider, defaultProvider) => {
+    if (isValidProvider(provider)) {
+        return provider;
+    }
+    return defaultProvider;
+};
+const getDisabledToolsForMigration = (flags) => {
+    const disabledTools = [];
+    if (!flags.isScreenshotToolEnabled) {
+        disabledTools.push("build_captureScreenshot");
+    }
+    if (!flags.isNavigationToolEnabled) {
+        disabledTools.push("build_navigatePreview");
+    }
+    if (!flags.isTestingEnabled) {
+        disabledTools.push("startTestRun");
+        disabledTools.push("endTestRun");
+        disabledTools.push("browser_playwright_action");
+    }
+    return disabledTools;
+};
+const readFlag = (flagBootstrap, key, fallback) => {
+    const raw = flagBootstrap?.[key];
+    // Flag bootstrap values are typed at the LaunchDarkly source; callers supply fallbacks.
+    return raw === undefined ? fallback : raw;
+};
+const readOptionalRecord = (flagBootstrap, key) => {
+    const raw = flagBootstrap?.[key];
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        return undefined;
+    }
+    return raw;
+};
+const readFallbackStrategy = (flagBootstrap) => {
+    const raw = flagBootstrap?.[FLAG_KEYS.fallbackStrategy];
+    if (typeof raw === "string" &&
+        FALLBACK_STRATEGIES.includes(raw)) {
+        return raw;
+    }
+    return undefined;
+};
+/**
+ * Builds a migration-safe LLM config on the dev server using org flag
+ * bootstrap values. Checklist + migration tools are always enabled.
+ */
+export function buildServerMigrationLlmConfig(flagBootstrap) {
+    const llmProvider = readFlag(flagBootstrap, FLAG_KEYS.llmProvider, "vertex");
+    const defaultThinkingBudget = readFlag(flagBootstrap, FLAG_KEYS.defaultThinkingBudget, 5000);
+    const coreModelName = readFlag(flagBootstrap, FLAG_KEYS.coreModelName, DEFAULT_CORE_MODEL);
+    let coreModel = DEFAULT_CORE_MODEL;
+    if (VALID_CORE_MODELS.includes(coreModelName)) {
+        coreModel = coreModelName;
+    }
+    else if (coreModelName !== DEFAULT_CORE_MODEL) {
+        console.warn(`[migration-llm-config] Unrecognized core model "${coreModelName}"; falling back to ${DEFAULT_CORE_MODEL}`);
+    }
+    const unifiedProviderEnabled = readFlag(flagBootstrap, FLAG_KEYS.unifiedProviderEnabled, false);
+    const isNavigationToolEnabled = readFlag(flagBootstrap, FLAG_KEYS.navigationToolEnabled, true);
+    const isScreenshotToolEnabled = readFlag(flagBootstrap, FLAG_KEYS.screenshotToolEnabled, true);
+    const isTestingEnabled = readFlag(flagBootstrap, FLAG_KEYS.testingEnabled, false);
+    const chaosOptionsRaw = readOptionalRecord(flagBootstrap, FLAG_KEYS.chaosOptions);
+    const chaosOptions = chaosOptionsRaw && Object.keys(chaosOptionsRaw).length > 0
+        ? chaosOptionsRaw
+        : undefined;
+    const migrationFlags = {
+        isChecklistEnabled: true,
+        isNavigationToolEnabled,
+        isScreenshotToolEnabled,
+        isTestingEnabled,
+        isFactsEnabled: false,
+        isAppKnowledgeEnabled: false,
+    };
+    return {
+        provider: normalizeProvider(llmProvider, "vertex"),
+        thinkingEnabled: true,
+        thinkingBudgetTokens: String(defaultThinkingBudget),
+        interleavedThinking: true,
+        disabledTools: getDisabledToolsForMigration({
+            isNavigationToolEnabled,
+            isScreenshotToolEnabled,
+            isTestingEnabled,
+        }),
+        contextOptionsV2: readOptionalRecord(flagBootstrap, FLAG_KEYS.contextOptionsV2),
+        serverContextManagement: readOptionalRecord(flagBootstrap, FLAG_KEYS.serverContextManagement),
+        chaosOptions: chaosOptions,
+        coreModel,
+        unifiedProviderEnabled,
+        fallbackStrategy: readFallbackStrategy(flagBootstrap),
+        flags: migrationFlags,
+    };
+}
+/**
+ * Whether the dev server may auto-dispatch the post-flip migration turn.
+ * Default off — soak via LaunchDarkly before enabling broadly.
+ */
+export function isMigrationAutoDispatchEnabled(flagBootstrap) {
+    return readFlag(flagBootstrap, FLAG_KEYS.migrationAutoDispatchEnabled, false);
+}
+//# sourceMappingURL=migration-llm-config.js.map

package/dist/ai-service/migration-llm-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-llm-config.js","sourceRoot":"","sources":["../../src/ai-service/migration-llm-config.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/migration-prompt-gating.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Gates migration-specific prompt surfaces (skills XML, tool registration)
+ * so v2→v3 migration framing does not leak into normal Clark turns.
+ */
+interface MigrationPromptGatingInput {
+    thirdPartyImportEnabled: boolean;
+    v2ToV3MigrationInProgress: boolean;
+}
+interface MigrationPromptGating {
+    registerRunMigrationVerification: boolean;
+    registerSpawnCodingSubagents: boolean;
+    spawnCodingSubagentsUsesMigrationDescription: boolean;
+}
+export declare function resolveMigrationPromptGating(input: MigrationPromptGatingInput): MigrationPromptGating;
+export declare function buildSystemSkillExclusions(args: {
+    sdkApiEnabled: boolean;
+    thirdPartyImportEnabled: boolean;
+    v2ToV3MigrationInProgress: boolean;
+}): string[];
+export {};
+//# sourceMappingURL=migration-prompt-gating.d.ts.map

package/dist/ai-service/migration-prompt-gating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-prompt-gating.d.ts","sourceRoot":"","sources":["../../src/ai-service/migration-prompt-gating.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,0BAA0B;IAClC,uBAAuB,EAAE,OAAO,CAAC;IACjC,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,UAAU,qBAAqB;IAC7B,gCAAgC,EAAE,OAAO,CAAC;IAC1C,4BAA4B,EAAE,OAAO,CAAC;IACtC,4CAA4C,EAAE,OAAO,CAAC;CACvD;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CASvB;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,uBAAuB,EAAE,OAAO,CAAC;IACjC,yBAAyB,EAAE,OAAO,CAAC;CACpC,GAAG,MAAM,EAAE,CAaX"}

package/dist/ai-service/migration-prompt-gating.js

@@ -0,0 +1,27 @@
+/**
+ * Gates migration-specific prompt surfaces (skills XML, tool registration)
+ * so v2→v3 migration framing does not leak into normal Clark turns.
+ */
+export function resolveMigrationPromptGating(input) {
+    const { thirdPartyImportEnabled, v2ToV3MigrationInProgress } = input;
+    return {
+        registerRunMigrationVerification: v2ToV3MigrationInProgress,
+        registerSpawnCodingSubagents: v2ToV3MigrationInProgress || thirdPartyImportEnabled,
+        spawnCodingSubagentsUsesMigrationDescription: v2ToV3MigrationInProgress,
+    };
+}
+export function buildSystemSkillExclusions(args) {
+    const excludeSkills = [];
+    if (args.sdkApiEnabled) {
+        excludeSkills.push("superblocks-api");
+    }
+    if (!args.thirdPartyImportEnabled) {
+        excludeSkills.push("third-party-migration");
+    }
+    if (!args.v2ToV3MigrationInProgress) {
+        excludeSkills.push("migration-api-verification");
+        excludeSkills.push("superblocks-migration");
+    }
+    return excludeSkills;
+}
+//# sourceMappingURL=migration-prompt-gating.js.map

package/dist/ai-service/migration-prompt-gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-prompt-gating.js","sourceRoot":"","sources":["../../src/ai-service/migration-prompt-gating.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,UAAU,4BAA4B,CAC1C,KAAiC;IAEjC,MAAM,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,GAAG,KAAK,CAAC;IAErE,OAAO;QACL,gCAAgC,EAAE,yBAAyB;QAC3D,4BAA4B,EAC1B,yBAAyB,IAAI,uBAAuB;QACtD,4CAA4C,EAAE,yBAAyB;KACxE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAI1C;IACC,MAAM,aAAa,GAAa,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;QACvB,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAClC,aAAa,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACpC,aAAa,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACjD,aAAa,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/ai-service/migration-session-active.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Positive migration-session gate for auto-dispatch. Returns true only while a
+ * migration session is genuinely in flight on disk — the dev server writes
+ * `scratch/migration-state.json` when a migration starts and removes it on
+ * every terminal path (completion removes the scratch dir; abort removes the
+ * file). A never-migrated or cleanly-completed app therefore has no state file,
+ * so a stale `checklist.json` alone can never arm auto-dispatch during normal
+ * app usage. On fresh post-flip pods the file is restored by
+ * `rehydrateMigrationScratchOnBoot`, which only downloads scratch when the
+ * server session phase is active — so presence here is a proxy for a
+ * server-confirmed active session.
+ */
+export declare function isMigrationSessionActive(appRootDirPath: string): Promise<boolean>;
+//# sourceMappingURL=migration-session-active.d.ts.map

package/dist/ai-service/migration-session-active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-session-active.d.ts","sourceRoot":"","sources":["../../src/ai-service/migration-session-active.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAOlB"}

package/dist/ai-service/migration-session-active.js

@@ -0,0 +1,29 @@
+import { access } from "node:fs/promises";
+import { join } from "node:path";
+// Mirrored from `migration/restructure.ts`. Duplicated locally (as
+// `migration-session-reconcile.ts` does) to keep the ai-service free of a
+// dependency edge into the migration route module.
+const SCRATCH_DIR_NAME = "scratch";
+const MIGRATION_STATE_FILE = "migration-state.json";
+/**
+ * Positive migration-session gate for auto-dispatch. Returns true only while a
+ * migration session is genuinely in flight on disk — the dev server writes
+ * `scratch/migration-state.json` when a migration starts and removes it on
+ * every terminal path (completion removes the scratch dir; abort removes the
+ * file). A never-migrated or cleanly-completed app therefore has no state file,
+ * so a stale `checklist.json` alone can never arm auto-dispatch during normal
+ * app usage. On fresh post-flip pods the file is restored by
+ * `rehydrateMigrationScratchOnBoot`, which only downloads scratch when the
+ * server session phase is active — so presence here is a proxy for a
+ * server-confirmed active session.
+ */
+export async function isMigrationSessionActive(appRootDirPath) {
+    try {
+        await access(join(appRootDirPath, SCRATCH_DIR_NAME, MIGRATION_STATE_FILE));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=migration-session-active.js.map

package/dist/ai-service/migration-session-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-session-active.js","sourceRoot":"","sources":["../../src/ai-service/migration-session-active.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,mEAAmE;AACnE,0EAA0E;AAC1E,mDAAmD;AACnD,MAAM,gBAAgB,GAAG,SAAS,CAAC;AACnC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAEpD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,cAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/ai-service/migration-turns-log.d.ts

@@ -0,0 +1,36 @@
+export declare const MIGRATION_TURNS_LOG_FILE = "migration-turns.jsonl";
+export type MigrationTurnTriggeredBy = "auto-dispatch" | "focused-debug" | "ui-rpc";
+export type MigrationTurnRetryMode = "focused-debug" | "none";
+export type MigrationTurnSettleOutcome = "error" | "success";
+export interface MigrationTurnDispatchedRecord {
+    at: string;
+    event: "dispatched";
+    pendingSeedApiCount: number;
+    promptId: string;
+    retryMode: MigrationTurnRetryMode;
+    triggeredBy: MigrationTurnTriggeredBy;
+}
+export interface MigrationTurnSettledRecord {
+    at: string;
+    event: "settled";
+    outcome: MigrationTurnSettleOutcome;
+    promptId: string;
+    retryMode: MigrationTurnRetryMode;
+}
+export declare function recordMigrationTurnDispatched(appRootDirPath: string, entry: Omit<MigrationTurnDispatchedRecord, "at" | "event">): Promise<void>;
+export declare function recordMigrationTurnSettled(appRootDirPath: string, entry: Omit<MigrationTurnSettledRecord, "at" | "event">): Promise<void>;
+/**
+ * Aggregate view of normal (non-focused-debug) migration turns, used by
+ * `GET /sb-migration-status` so the UI can derive "has the initial
+ * generation run and finished?" from server state instead of client
+ * heuristics. `settledOutcome` reflects the most recent normal settle.
+ */
+export interface NormalMigrationTurnSummary {
+    dispatched: boolean;
+    settled: boolean;
+    settledOutcome?: MigrationTurnSettleOutcome;
+}
+export declare function getNormalMigrationTurnSummary(appRootDirPath: string): Promise<NormalMigrationTurnSummary>;
+export declare function hasSettledNormalMigrationTurn(appRootDirPath: string): Promise<boolean>;
+export declare function clearMigrationTurnsLog(appRootDirPath: string): Promise<void>;
+//# sourceMappingURL=migration-turns-log.d.ts.map

package/dist/ai-service/migration-turns-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-turns-log.d.ts","sourceRoot":"","sources":["../../src/ai-service/migration-turns-log.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,wBAAwB,0BAA0B,CAAC;AAEhE,MAAM,MAAM,wBAAwB,GAChC,eAAe,GACf,eAAe,GACf,QAAQ,CAAC;AAEb,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,MAAM,CAAC;AAE9D,MAAM,MAAM,0BAA0B,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,sBAAsB,CAAC;IAClC,WAAW,EAAE,wBAAwB,CAAC;CACvC;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,sBAAsB,CAAC;CACnC;AAuBD,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,IAAI,CAAC,6BAA6B,EAAE,IAAI,GAAG,OAAO,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,0BAA0B,CAC9C,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,IAAI,CAAC,0BAA0B,EAAE,IAAI,GAAG,OAAO,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CAMf;AAkCD;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,0BAA0B,CAAC;CAC7C;AAED,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,0BAA0B,CAAC,CAmBrC;AAED,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED,wBAAsB,sBAAsB,CAC1C,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/ai-service/migration-turns-log.js

@@ -0,0 +1,88 @@
+import { appendFile, mkdir, readFile, rm } from "node:fs/promises";
+import { join } from "node:path";
+const SCRATCH_DIR_NAME = "scratch";
+export const MIGRATION_TURNS_LOG_FILE = "migration-turns.jsonl";
+function migrationTurnsLogPath(appRootDirPath) {
+    return join(appRootDirPath, SCRATCH_DIR_NAME, MIGRATION_TURNS_LOG_FILE);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+async function appendRecord(appRootDirPath, record) {
+    const logPath = migrationTurnsLogPath(appRootDirPath);
+    await mkdir(join(appRootDirPath, SCRATCH_DIR_NAME), { recursive: true });
+    await appendFile(logPath, `${JSON.stringify(record)}\n`, "utf8");
+}
+export async function recordMigrationTurnDispatched(appRootDirPath, entry) {
+    await appendRecord(appRootDirPath, {
+        at: new Date().toISOString(),
+        event: "dispatched",
+        ...entry,
+    });
+}
+export async function recordMigrationTurnSettled(appRootDirPath, entry) {
+    await appendRecord(appRootDirPath, {
+        at: new Date().toISOString(),
+        event: "settled",
+        ...entry,
+    });
+}
+async function readMigrationTurnRecords(appRootDirPath) {
+    let raw;
+    try {
+        raw = await readFile(migrationTurnsLogPath(appRootDirPath), "utf8");
+    }
+    catch {
+        return [];
+    }
+    const records = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            continue;
+        }
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (!isRecord(parsed) ||
+                (parsed.event !== "dispatched" && parsed.event !== "settled")) {
+                continue;
+            }
+            records.push(parsed);
+        }
+        catch {
+            // Skip malformed lines from partial writes.
+        }
+    }
+    return records;
+}
+export async function getNormalMigrationTurnSummary(appRootDirPath) {
+    const records = await readMigrationTurnRecords(appRootDirPath);
+    let dispatched = false;
+    let settledOutcome;
+    for (const record of records) {
+        if (record.retryMode !== "none") {
+            continue;
+        }
+        if (record.event === "dispatched") {
+            dispatched = true;
+        }
+        else {
+            settledOutcome = record.outcome;
+        }
+    }
+    return {
+        dispatched,
+        settled: settledOutcome !== undefined,
+        ...(settledOutcome !== undefined ? { settledOutcome } : {}),
+    };
+}
+export async function hasSettledNormalMigrationTurn(appRootDirPath) {
+    const records = await readMigrationTurnRecords(appRootDirPath);
+    return records.some((record) => record.event === "settled" &&
+        record.retryMode === "none" &&
+        record.outcome === "success");
+}
+export async function clearMigrationTurnsLog(appRootDirPath) {
+    await rm(migrationTurnsLogPath(appRootDirPath), { force: true });
+}
+//# sourceMappingURL=migration-turns-log.js.map

package/dist/ai-service/migration-turns-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-turns-log.js","sourceRoot":"","sources":["../../src/ai-service/migration-turns-log.ts"],"names":[],"mappings":"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"}

package/dist/ai-service/policy-agent-metrics.d.ts

@@ -0,0 +1,29 @@
+export declare const METRIC_POLICY_AGENT_EXECUTIONS = "superblocks.policy_agent.executions";
+export declare const METRIC_POLICY_AGENT_DURATION = "superblocks.policy_agent.execution_duration";
+export declare const METRIC_POLICY_AGENT_STEPS = "superblocks.policy_agent.steps";
+export declare const METRIC_POLICY_AGENT_TOOL_CALLS = "superblocks.policy_agent.tool_calls";
+export declare const METRIC_POLICY_AGENT_TOKENS = "superblocks.policy_agent.tokens";
+export declare const POLICY_AGENT_OUTCOMES: readonly ["aborted", "error", "incomplete_report", "internal_error", "invalid_report", "llm_auth_error", "llm_overloaded", "llm_rate_limited", "llm_refusal", "llm_timeout", "missing_report", "out_of_credits", "output_token_limit", "success"];
+export type PolicyAgentOutcome = (typeof POLICY_AGENT_OUTCOMES)[number];
+export type PolicyAgentErrorCode = Exclude<PolicyAgentOutcome, "error" | "success">;
+export declare const POLICY_AGENT_DURATION_BUCKETS_SECONDS: readonly [1, 5, 15, 30, 60, 120, 300, 600, 900];
+export declare const POLICY_AGENT_STEP_BUCKETS: readonly [1, 2, 5, 10, 15, 20, 30, 50, 80, 100, 150];
+export declare const POLICY_AGENT_TOOL_CALL_BUCKETS: readonly [1, 2, 5, 10, 20, 40, 80, 120, 200];
+export declare const POLICY_AGENT_TOKEN_BUCKETS: readonly [100, 500, 1000, 5000, 10000, 25000, 50000, 100000, 200000, 400000];
+export type PolicyAgentTokenUsageEntry = {
+    cachedReadTokens: number;
+    cachedWriteTokens: number;
+    inputTokens: number;
+    model: string;
+    outputTokens: number;
+};
+export type PolicyAgentExecutionMetricsInput = {
+    durationMs: number;
+    llmUsage?: PolicyAgentTokenUsageEntry[];
+    outcome: PolicyAgentOutcome;
+    stepCount: number;
+    toolCallCount: number;
+};
+export declare function recordPolicyAgentExecution(input: PolicyAgentExecutionMetricsInput): void;
+export declare function _resetPolicyAgentMetricsForTesting(): void;
+//# sourceMappingURL=policy-agent-metrics.d.ts.map

package/dist/ai-service/policy-agent-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-agent-metrics.d.ts","sourceRoot":"","sources":["../../src/ai-service/policy-agent-metrics.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,8BAA8B,wCACJ,CAAC;AACxC,eAAO,MAAM,4BAA4B,gDACM,CAAC;AAChD,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAC1E,eAAO,MAAM,8BAA8B,wCACJ,CAAC;AACxC,eAAO,MAAM,0BAA0B,oCAAoC,CAAC;AAE5E,eAAO,MAAM,qBAAqB,mPAexB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,oBAAoB,GAAG,OAAO,CACxC,kBAAkB,EAClB,OAAO,GAAG,SAAS,CACpB,CAAC;AAGF,eAAO,MAAM,qCAAqC,iDAExC,CAAC;AAGX,eAAO,MAAM,yBAAyB,sDAE5B,CAAC;AAEX,eAAO,MAAM,8BAA8B,8CAEjC,CAAC;AAIX,eAAO,MAAM,0BAA0B,8EAE7B,CAAC;AAeX,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AASF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,0BAA0B,EAAE,CAAC;IACxC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAiGF,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gCAAgC,GACtC,IAAI,CAEN;AAED,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD"}

package/dist/ai-service/policy-agent-metrics.js

@@ -0,0 +1,141 @@
+/**
+ * Policy agent (security agent) run metrics.
+ *
+ * Used to tune stop conditions (time budget, optional step caps) from
+ * production distributions. No org/app labels — keep identity on logs/traces.
+ *
+ *   - `superblocks.policy_agent.executions` counter {outcome}
+ *   - `superblocks.policy_agent.execution_duration` histogram {outcome}
+ *   - `superblocks.policy_agent.steps` histogram {outcome}
+ *   - `superblocks.policy_agent.tool_calls` histogram {outcome}
+ *   - `superblocks.policy_agent.tokens` histogram {outcome, kind, model}
+ */
+import { metrics } from "@opentelemetry/api";
+import { coreModelLabel } from "@superblocksteam/library-shared/types";
+const METER_NAME = "superblocks.policy_agent";
+export const METRIC_POLICY_AGENT_EXECUTIONS = "superblocks.policy_agent.executions";
+export const METRIC_POLICY_AGENT_DURATION = "superblocks.policy_agent.execution_duration";
+export const METRIC_POLICY_AGENT_STEPS = "superblocks.policy_agent.steps";
+export const METRIC_POLICY_AGENT_TOOL_CALLS = "superblocks.policy_agent.tool_calls";
+export const METRIC_POLICY_AGENT_TOKENS = "superblocks.policy_agent.tokens";
+export const POLICY_AGENT_OUTCOMES = [
+    "aborted",
+    "error",
+    "incomplete_report",
+    "internal_error",
+    "invalid_report",
+    "llm_auth_error",
+    "llm_overloaded",
+    "llm_rate_limited",
+    "llm_refusal",
+    "llm_timeout",
+    "missing_report",
+    "out_of_credits",
+    "output_token_limit",
+    "success",
+];
+// Up to the 15-minute wall-clock cap; denser below 2 minutes where most runs land.
+export const POLICY_AGENT_DURATION_BUCKETS_SECONDS = [
+    1, 5, 15, 30, 60, 120, 300, 600, 900,
+];
+// Covers historical 30-step caps and larger apps without exploding cardinality.
+export const POLICY_AGENT_STEP_BUCKETS = [
+    1, 2, 5, 10, 15, 20, 30, 50, 80, 100, 150,
+];
+export const POLICY_AGENT_TOOL_CALL_BUCKETS = [
+    1, 2, 5, 10, 20, 40, 80, 120, 200,
+];
+// Per-LLM-call token counts. Inputs commonly land in the tens of thousands;
+// outputs in the hundreds. Dashboards mostly consume the sum (cost formulas).
+export const POLICY_AGENT_TOKEN_BUCKETS = [
+    100, 500, 1_000, 5_000, 10_000, 25_000, 50_000, 100_000, 200_000, 400_000,
+];
+const TOKEN_KINDS = [
+    ["input", "inputTokens"],
+    ["output", "outputTokens"],
+    ["cached_read", "cachedReadTokens"],
+    ["cached_write", "cachedWriteTokens"],
+];
+const SECONDS_PER_MS = 1 / 1000;
+const toSeconds = (durationMs) => Math.max(0, durationMs) * SECONDS_PER_MS;
+const clampCount = (value) => Number.isFinite(value) ? Math.max(0, value) : 0;
+class PolicyAgentMetrics {
+    cachedMeter;
+    cachedInstruments;
+    getInstruments() {
+        const meter = metrics.getMeter(METER_NAME);
+        if (meter === this.cachedMeter && this.cachedInstruments) {
+            return this.cachedInstruments;
+        }
+        this.cachedMeter = meter;
+        this.cachedInstruments = {
+            durationHistogram: meter.createHistogram(METRIC_POLICY_AGENT_DURATION, {
+                description: "Wall time for a policy agent security run until report or failure.",
+                unit: "s",
+                advice: {
+                    explicitBucketBoundaries: [...POLICY_AGENT_DURATION_BUCKETS_SECONDS],
+                },
+            }),
+            executionsCounter: meter.createCounter(METRIC_POLICY_AGENT_EXECUTIONS, {
+                description: "Policy agent security runs by terminal outcome.",
+                unit: "1",
+            }),
+            stepsHistogram: meter.createHistogram(METRIC_POLICY_AGENT_STEPS, {
+                description: "LLM steps taken during a policy agent security run (finish-step events).",
+                unit: "{step}",
+                advice: {
+                    explicitBucketBoundaries: [...POLICY_AGENT_STEP_BUCKETS],
+                },
+            }),
+            tokensHistogram: meter.createHistogram(METRIC_POLICY_AGENT_TOKENS, {
+                description: "LLM tokens consumed by policy agent security runs, per call, kind, and model.",
+                unit: "{token}",
+                advice: {
+                    explicitBucketBoundaries: [...POLICY_AGENT_TOKEN_BUCKETS],
+                },
+            }),
+            toolCallsHistogram: meter.createHistogram(METRIC_POLICY_AGENT_TOOL_CALLS, {
+                description: "Tool calls made during a policy agent security run.",
+                unit: "{call}",
+                advice: {
+                    explicitBucketBoundaries: [...POLICY_AGENT_TOOL_CALL_BUCKETS],
+                },
+            }),
+        };
+        return this.cachedInstruments;
+    }
+    recordExecution(input) {
+        const attrs = {
+            outcome: input.outcome === "llm_timeout" ? "timeout" : input.outcome,
+        };
+        const instruments = this.getInstruments();
+        instruments.executionsCounter.add(1, attrs);
+        instruments.durationHistogram.record(toSeconds(input.durationMs), attrs);
+        instruments.stepsHistogram.record(clampCount(input.stepCount), attrs);
+        instruments.toolCallsHistogram.record(clampCount(input.toolCallCount), attrs);
+        for (const entry of input.llmUsage ?? []) {
+            for (const [kind, field] of TOKEN_KINDS) {
+                const tokens = clampCount(entry[field]);
+                if (tokens > 0) {
+                    instruments.tokensHistogram.record(tokens, {
+                        ...attrs,
+                        kind,
+                        model: coreModelLabel(entry.model),
+                    });
+                }
+            }
+        }
+    }
+    _resetForTesting() {
+        this.cachedMeter = undefined;
+        this.cachedInstruments = undefined;
+    }
+}
+const policyAgentMetrics = new PolicyAgentMetrics();
+export function recordPolicyAgentExecution(input) {
+    policyAgentMetrics.recordExecution(input);
+}
+export function _resetPolicyAgentMetricsForTesting() {
+    policyAgentMetrics._resetForTesting();
+}
+//# sourceMappingURL=policy-agent-metrics.js.map