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

package/dist/ai-service/features.d.ts

@@ -0,0 +1,237 @@
+import z from "zod";
+/**
+ * Feature flag definition with key and Zod schema for parsing.
+ */
+interface FeatureFlag<T = unknown> {
+    key: string;
+    schema: z.ZodType<T>;
+    defaultValue?: T;
+}
+/**
+ * Extract the output type from a Zod schema.
+ */
+type InferSchemaType<T> = T extends z.ZodType<infer U> ? U : never;
+/**
+ * Convert a flag definitions object into a type with inferred return types.
+ */
+type FlagValue<T extends FeatureFlag> = T extends {
+    defaultValue: infer _Default;
+} ? InferSchemaType<T["schema"]> : InferSchemaType<T["schema"]> | undefined;
+type FlagGetters<T extends Record<string, FeatureFlag>> = {
+    readonly [K in keyof T]: FlagValue<T[K]>;
+};
+interface StreamTimeoutBudgetFlag {
+    firstTokenMs?: number;
+    standardIdleMs?: number;
+    extendedIdleMs?: number;
+    standardContentSilenceMs?: number;
+    extendedContentSilenceMs?: number;
+}
+/**
+ * Feature flag definitions for AI service.
+ *
+ * To add a new flag, simply add a property here with key and schema:
+ * ```
+ * myNewFlag: {
+ *   key: 'ai.my-new-flag',
+ *   schema: z.number()
+ * }
+ * ```
+ *
+ * Then access it type-safely: `flags.myNewFlag`
+ */
+declare const FLAG_DEFINITIONS: {
+    readonly metadataCacheMaxTotalSizeMB: {
+        readonly key: "ai.metadata-cache-size-mb";
+        readonly schema: z.ZodNumber;
+    };
+    readonly metadataCacheMaxSingleFileSizeMB: {
+        readonly key: "ai.metadata-file-size-mb";
+        readonly schema: z.ZodNumber;
+    };
+    readonly unifiedProviderEnabled: {
+        readonly key: "superblocks.ai.provider.unified";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly safetyGuidancePrompt: {
+        readonly key: "ai.prompt.safety-guidance";
+        readonly schema: z.ZodString;
+    };
+    readonly appBuilderModelGuidance: {
+        readonly key: "ai.prompt.app-builder.model-guidance";
+        readonly schema: z.ZodRecord<z.ZodString, z.ZodString>;
+        readonly defaultValue: {};
+    };
+    readonly safetyClassificationEnabled: {
+        readonly key: "superblocks.ai.safety-classification.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly packageInstallGateEnabled: {
+        readonly key: "superblocks.code-security.package-install-gate.enabled";
+        readonly schema: z.ZodBoolean;
+        readonly defaultValue: false;
+    };
+    readonly secretRedactionLevel: {
+        readonly key: "superblocks.ai.secret-redaction.level";
+        readonly schema: z.ZodEnum<["full", "initial-prompt", "off"]>;
+    };
+    readonly fallbackStrategy: {
+        readonly key: "ai.fallback.strategy";
+        readonly schema: z.ZodEnum<["model-then-provider", "provider-then-model", "model-then-provider-no-retry", "provider-then-model-no-retry", "only-model", "only-provider", "disabled"]>;
+    };
+    readonly parameterizedApisEnabled: {
+        readonly key: "clark.parameterized-apis.v2.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly webToolsEnabled: {
+        readonly key: "superblocks.ai.web-tools.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly superblocksDocsMcpEnabled: {
+        readonly key: "superblocks.ai.docs-mcp.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly enableClarkAiReadAccessPermission: {
+        readonly key: "ui.clark-ai.read-access-permission";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly thirdPartyImportEnabled: {
+        readonly key: "ui.third-party-import.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly apiRunLogsEnabled: {
+        readonly key: "ai.get-logs.api-runs.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly useSystemSkills: {
+        readonly key: "clark.use_system_skills";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly sessionRecordingEnabled: {
+        readonly key: "clark.session-recording.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly sessionManagementEnabled: {
+        readonly key: "clark.session-management.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly promptUsageAlarmThreshold: {
+        readonly key: "superblocks.ai.prompt.usage-alarm-threshold";
+        readonly schema: z.ZodNumber;
+        readonly defaultValue: 10;
+    };
+    /** Derived from application templateName in CLI (not LD). See isSdkApiTemplate(). */
+    readonly sdkApiEnabled: {
+        readonly key: "clark.sdk-api.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly aiFileUploadEnabled: {
+        readonly key: "ai.file-upload.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly clarkAttachmentDownloadEnabled: {
+        readonly key: "ai.clark-attachment-download.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly appKnowledgeEnabled: {
+        readonly key: "ai.app-knowledge.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly nativeGitEnabled: {
+        readonly key: "superblocks.native-git.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly nativeGitRawEnabled: {
+        readonly key: "superblocks.native-git-raw.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly enableDeletingLockfiles: {
+        readonly key: "ai.clark-delete-package-lock.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly suggestWhatsNext: {
+        readonly key: "ai.suggest-whats-next";
+        readonly schema: z.ZodBoolean;
+    };
+    readonly integrationSetupEnabled: {
+        readonly key: "clark.integration-setup.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    /**
+     * Rollout gate for Clark's app-environment mutation tool
+     * (`updateAppEnvironment`). Default off so orgs keep read-only
+     * environment compatibility until the write path is enabled.
+     */
+    readonly appEnvironmentMutationEnabled: {
+        readonly key: "clark.app-environment-mutation.enabled";
+        readonly schema: z.ZodBoolean;
+        readonly defaultValue: false;
+    };
+    /**
+     * Rollout gate for the plan-generation system prompt variant. When on,
+     * exitPlanMode's nested tool-less plan stream replaces the seeded agent
+     * system prompt with the subtractive plan-writing variant (prevents
+     * hallucinated textual tool-call markup from rendering on plan cards).
+     * When off, the legacy behavior: the plan stream inherits the agent
+     * system prompt. Default off so cloud-prem file-based flag sets that
+     * predate the flag keep legacy behavior.
+     */
+    readonly planGenerationSystemPromptEnabled: {
+        readonly key: "clark.plan-generation-system-prompt.enabled";
+        readonly schema: z.ZodBoolean;
+        readonly defaultValue: false;
+    };
+    readonly npmRegistryEnabled: {
+        readonly key: "superblocks.npm-registry.enabled";
+        readonly schema: z.ZodBoolean;
+    };
+    /**
+     * Demo-only: when `{ enabled: true }`, agent-planning emits a mock
+     * "Preparing development environment" card on the user's first prompt of
+     * an empty app. Card is rendered by `AwsInfrastructureMock` in the UI and
+     * has no real backend wiring — it exists purely for the BYO-DB demo flow.
+     */
+    readonly byoDbDemo: {
+        readonly key: "superblocks.byo-db.demo";
+        readonly schema: z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+        }, {
+            enabled: boolean;
+        }>;
+    };
+    /**
+     * Feature-rollout gate for managed Native DB (the App Databases dashboard
+     * page + Clark dev-DB provisioning). Single source of truth for whether
+     * Clark wires up the background-tasks framework (TaskStore, generic
+     * check/wait/cancel/list tools, on-disk persistence, peer push, UI
+     * indicator) and the `provisionDatabase` / `startApplyDevDatabaseMigrations`
+     * start tools. Dev-DB provisioning is the only producer of background
+     * tasks today, so the rollout flag doubles as the framework gate.
+     */
+    readonly managedNativeDbEnabled: {
+        readonly key: "managed-native-db.enabled";
+        readonly schema: z.ZodBoolean;
+        readonly defaultValue: false;
+    };
+    readonly streamTimeoutBudgets: {
+        readonly key: "superblocks.ai.stream-timeout-budgets";
+        readonly schema: z.ZodType<StreamTimeoutBudgetFlag>;
+    };
+};
+/**
+   Type-safe feature flags for AI service.
+
+   Automatically parses and validates flag values using Zod schemas.
+ * All flag definitions are in FLAG_DEFINITIONS above.
+ */
+export type AiServiceFeatureFlags = FlagGetters<typeof FLAG_DEFINITIONS>;
+export declare const AiServiceFeatureFlags: {
+    /**
+     * Create a new feature flags instance with the given flag values.
+     */
+    create(flags?: Record<string, unknown>): AiServiceFeatureFlags;
+};
+export {};
+//# sourceMappingURL=features.d.ts.map

package/dist/ai-service/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/ai-service/features.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAIpB;;GAEG;AACH,UAAU,WAAW,CAAC,CAAC,GAAG,OAAO;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,CAAC;CAClB;AAED;;GAEG;AACH,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEnE;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS;IAChD,YAAY,EAAE,MAAM,QAAQ,CAAC;CAC9B,GACG,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAC5B,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC;AAE7C,KAAK,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI;IACxD,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC,CAAC;AAUF,UAAU,uBAAuB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAgBD;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkFpB,qFAAqF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqCrF;;;;OAIG;;;;;;IAMH;;;;;;;;OAQG;;;;;;;;;;IAcH;;;;;OAKG;;;;;;;;;;;IAKH;;;;;;;;OAQG;;;;;;;;yBAkBM,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;;CAEG,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEzE,eAAO,MAAM,qBAAqB;IAChC;;OAEG;mBACW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAQ,qBAAqB;CAoBnE,CAAC"}

package/dist/ai-service/features.js

@@ -0,0 +1,238 @@
+import z from "zod";
+import { FALLBACK_STRATEGIES } from "@superblocksteam/library-shared/types";
+const optionalPositiveMs = z.preprocess((value) => typeof value === "number" && Number.isFinite(value) && value > 0
+    ? value
+    : undefined, z.number().optional());
+function compactStreamTimeoutBudgetFlag(value) {
+    const budgets = {};
+    for (const key of Object.keys(value)) {
+        if (typeof value[key] === "number") {
+            budgets[key] = value[key];
+        }
+    }
+    return budgets;
+}
+/**
+ * Feature flag definitions for AI service.
+ *
+ * To add a new flag, simply add a property here with key and schema:
+ * ```
+ * myNewFlag: {
+ *   key: 'ai.my-new-flag',
+ *   schema: z.number()
+ * }
+ * ```
+ *
+ * Then access it type-safely: `flags.myNewFlag`
+ */
+const FLAG_DEFINITIONS = {
+    metadataCacheMaxTotalSizeMB: {
+        key: "ai.metadata-cache-size-mb",
+        schema: z.number(),
+    },
+    metadataCacheMaxSingleFileSizeMB: {
+        key: "ai.metadata-file-size-mb",
+        schema: z.number(),
+    },
+    unifiedProviderEnabled: {
+        key: "superblocks.ai.provider.unified",
+        schema: z.boolean(),
+    },
+    safetyGuidancePrompt: {
+        key: "ai.prompt.safety-guidance",
+        schema: z.string().nonempty(),
+    },
+    // Server-evaluated JSON map: { "<coreModel>": "<guidance text>" } for app-editor Clark only.
+    // AiServiceFeatureFlags is frozen at dev-server startup — LD edits require a new session.
+    appBuilderModelGuidance: {
+        key: "ai.prompt.app-builder.model-guidance",
+        schema: z.record(z.string(), z.string()),
+        defaultValue: {},
+    },
+    safetyClassificationEnabled: {
+        key: "superblocks.ai.safety-classification.enabled",
+        schema: z.boolean(),
+    },
+    packageInstallGateEnabled: {
+        key: "superblocks.code-security.package-install-gate.enabled",
+        schema: z.boolean(),
+        defaultValue: false,
+    },
+    secretRedactionLevel: {
+        key: "superblocks.ai.secret-redaction.level",
+        schema: z.enum(["full", "initial-prompt", "off"]),
+    },
+    fallbackStrategy: {
+        key: "ai.fallback.strategy",
+        schema: z.enum(FALLBACK_STRATEGIES),
+    },
+    parameterizedApisEnabled: {
+        key: "clark.parameterized-apis.v2.enabled",
+        schema: z.boolean(),
+    },
+    webToolsEnabled: {
+        key: "superblocks.ai.web-tools.enabled",
+        schema: z.boolean(),
+    },
+    superblocksDocsMcpEnabled: {
+        key: "superblocks.ai.docs-mcp.enabled",
+        schema: z.boolean(),
+    },
+    enableClarkAiReadAccessPermission: {
+        key: "ui.clark-ai.read-access-permission",
+        schema: z.boolean(),
+    },
+    thirdPartyImportEnabled: {
+        key: "ui.third-party-import.enabled",
+        schema: z.boolean(),
+    },
+    apiRunLogsEnabled: {
+        key: "ai.get-logs.api-runs.enabled",
+        schema: z.boolean(),
+    },
+    useSystemSkills: {
+        key: "clark.use_system_skills",
+        schema: z.boolean(),
+    },
+    sessionRecordingEnabled: {
+        key: "clark.session-recording.enabled",
+        schema: z.boolean(),
+    },
+    sessionManagementEnabled: {
+        key: "clark.session-management.enabled",
+        schema: z.boolean(),
+    },
+    promptUsageAlarmThreshold: {
+        key: "superblocks.ai.prompt.usage-alarm-threshold",
+        schema: z.number().nonnegative().finite(),
+        defaultValue: 10,
+    },
+    /** Derived from application templateName in CLI (not LD). See isSdkApiTemplate(). */
+    sdkApiEnabled: {
+        key: "clark.sdk-api.enabled",
+        schema: z.boolean(),
+    },
+    aiFileUploadEnabled: {
+        key: "ai.file-upload.enabled",
+        schema: z.boolean(),
+    },
+    clarkAttachmentDownloadEnabled: {
+        key: "ai.clark-attachment-download.enabled",
+        schema: z.boolean(),
+    },
+    appKnowledgeEnabled: {
+        key: "ai.app-knowledge.enabled",
+        schema: z.boolean(),
+    },
+    nativeGitEnabled: {
+        key: "superblocks.native-git.enabled",
+        schema: z.boolean(),
+    },
+    nativeGitRawEnabled: {
+        key: "superblocks.native-git-raw.enabled",
+        schema: z.boolean(),
+    },
+    enableDeletingLockfiles: {
+        key: "ai.clark-delete-package-lock.enabled",
+        schema: z.boolean(),
+    },
+    suggestWhatsNext: {
+        key: "ai.suggest-whats-next",
+        schema: z.boolean(),
+    },
+    integrationSetupEnabled: {
+        key: "clark.integration-setup.enabled",
+        schema: z.boolean(),
+    },
+    /**
+     * Rollout gate for Clark's app-environment mutation tool
+     * (`updateAppEnvironment`). Default off so orgs keep read-only
+     * environment compatibility until the write path is enabled.
+     */
+    appEnvironmentMutationEnabled: {
+        key: "clark.app-environment-mutation.enabled",
+        schema: z.boolean(),
+        defaultValue: false,
+    },
+    /**
+     * Rollout gate for the plan-generation system prompt variant. When on,
+     * exitPlanMode's nested tool-less plan stream replaces the seeded agent
+     * system prompt with the subtractive plan-writing variant (prevents
+     * hallucinated textual tool-call markup from rendering on plan cards).
+     * When off, the legacy behavior: the plan stream inherits the agent
+     * system prompt. Default off so cloud-prem file-based flag sets that
+     * predate the flag keep legacy behavior.
+     */
+    planGenerationSystemPromptEnabled: {
+        key: "clark.plan-generation-system-prompt.enabled",
+        schema: z.boolean(),
+        defaultValue: false,
+    },
+    npmRegistryEnabled: {
+        // Gates the per-org NPM Registry feature end-to-end. When off, the CLI
+        // does NOT fetch /api/v1/organizations/:orgId/npm-registry and falls
+        // through to today's behaviour (no `.npmrc` materialisation). Mirrors
+        // the server-side `NPM_REGISTRY_ENABLED` gate added in APPS-4228.
+        key: "superblocks.npm-registry.enabled",
+        schema: z.boolean(),
+    },
+    /**
+     * Demo-only: when `{ enabled: true }`, agent-planning emits a mock
+     * "Preparing development environment" card on the user's first prompt of
+     * an empty app. Card is rendered by `AwsInfrastructureMock` in the UI and
+     * has no real backend wiring — it exists purely for the BYO-DB demo flow.
+     */
+    byoDbDemo: {
+        key: "superblocks.byo-db.demo",
+        schema: z.object({ enabled: z.boolean() }),
+    },
+    /**
+     * Feature-rollout gate for managed Native DB (the App Databases dashboard
+     * page + Clark dev-DB provisioning). Single source of truth for whether
+     * Clark wires up the background-tasks framework (TaskStore, generic
+     * check/wait/cancel/list tools, on-disk persistence, peer push, UI
+     * indicator) and the `provisionDatabase` / `startApplyDevDatabaseMigrations`
+     * start tools. Dev-DB provisioning is the only producer of background
+     * tasks today, so the rollout flag doubles as the framework gate.
+     */
+    managedNativeDbEnabled: {
+        key: "managed-native-db.enabled",
+        schema: z.boolean(),
+        defaultValue: false,
+    },
+    streamTimeoutBudgets: {
+        key: "superblocks.ai.stream-timeout-budgets",
+        schema: z
+            .object({
+            firstTokenMs: optionalPositiveMs,
+            standardIdleMs: optionalPositiveMs,
+            extendedIdleMs: optionalPositiveMs,
+            standardContentSilenceMs: optionalPositiveMs,
+            extendedContentSilenceMs: optionalPositiveMs,
+        })
+            .transform(compactStreamTimeoutBudgetFlag),
+    },
+};
+export const AiServiceFeatureFlags = {
+    /**
+     * Create a new feature flags instance with the given flag values.
+     */
+    create(flags = {}) {
+        return new Proxy({}, {
+            get(_target, prop) {
+                if (typeof prop !== "string" || !(prop in FLAG_DEFINITIONS)) {
+                    return undefined;
+                }
+                const def = FLAG_DEFINITIONS[prop];
+                const raw = flags[def.key];
+                const defaultValue = "defaultValue" in def ? def.defaultValue : undefined;
+                if (raw === undefined) {
+                    return defaultValue;
+                }
+                const result = def.schema.safeParse(raw);
+                return result.success ? result.data : defaultValue;
+            },
+        });
+    },
+};
+//# sourceMappingURL=features.js.map

package/dist/ai-service/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../src/ai-service/features.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AA6B5E,MAAM,kBAAkB,GAAG,CAAC,CAAC,UAAU,CACrC,CAAC,KAAK,EAAE,EAAE,CACR,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;IAC9D,CAAC,CAAC,KAAK;IACP,CAAC,CAAC,SAAS,EACf,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CACtB,CAAC;AAUF,SAAS,8BAA8B,CACrC,KAA8D;IAE9D,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAElC,EAAE,CAAC;QACF,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,gBAAgB,GAAG;IACvB,2BAA2B,EAAE;QAC3B,GAAG,EAAE,2BAA2B;QAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB;IACD,gCAAgC,EAAE;QAChC,GAAG,EAAE,0BAA0B;QAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB;IACD,sBAAsB,EAAE;QACtB,GAAG,EAAE,iCAAiC;QACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,oBAAoB,EAAE;QACpB,GAAG,EAAE,2BAA2B;QAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC9B;IACD,6FAA6F;IAC7F,0FAA0F;IAC1F,uBAAuB,EAAE;QACvB,GAAG,EAAE,sCAAsC;QAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QACxC,YAAY,EAAE,EAAE;KACjB;IACD,2BAA2B,EAAE;QAC3B,GAAG,EAAE,8CAA8C;QACnD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,yBAAyB,EAAE;QACzB,GAAG,EAAE,wDAAwD;QAC7D,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,YAAY,EAAE,KAAK;KACpB;IACD,oBAAoB,EAAE;QACpB,GAAG,EAAE,uCAAuC;QAC5C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;KAClD;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,sBAAsB;QAC3B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;KACpC;IACD,wBAAwB,EAAE;QACxB,GAAG,EAAE,qCAAqC;QAC1C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,eAAe,EAAE;QACf,GAAG,EAAE,kCAAkC;QACvC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,yBAAyB,EAAE;QACzB,GAAG,EAAE,iCAAiC;QACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,iCAAiC,EAAE;QACjC,GAAG,EAAE,oCAAoC;QACzC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,uBAAuB,EAAE;QACvB,GAAG,EAAE,+BAA+B;QACpC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,iBAAiB,EAAE;QACjB,GAAG,EAAE,8BAA8B;QACnC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,eAAe,EAAE;QACf,GAAG,EAAE,yBAAyB;QAC9B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,uBAAuB,EAAE;QACvB,GAAG,EAAE,iCAAiC;QACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,wBAAwB,EAAE;QACxB,GAAG,EAAE,kCAAkC;QACvC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,yBAAyB,EAAE;QACzB,GAAG,EAAE,6CAA6C;QAClD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE;QACzC,YAAY,EAAE,EAAE;KACjB;IACD,qFAAqF;IACrF,aAAa,EAAE;QACb,GAAG,EAAE,uBAAuB;QAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,mBAAmB,EAAE;QACnB,GAAG,EAAE,wBAAwB;QAC7B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,8BAA8B,EAAE;QAC9B,GAAG,EAAE,sCAAsC;QAC3C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,mBAAmB,EAAE;QACnB,GAAG,EAAE,0BAA0B;QAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,gCAAgC;QACrC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,mBAAmB,EAAE;QACnB,GAAG,EAAE,oCAAoC;QACzC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,uBAAuB,EAAE;QACvB,GAAG,EAAE,sCAAsC;QAC3C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,gBAAgB,EAAE;QAChB,GAAG,EAAE,uBAAuB;QAC5B,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD,uBAAuB,EAAE;QACvB,GAAG,EAAE,iCAAiC;QACtC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD;;;;OAIG;IACH,6BAA6B,EAAE;QAC7B,GAAG,EAAE,wCAAwC;QAC7C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,YAAY,EAAE,KAAK;KACpB;IACD;;;;;;;;OAQG;IACH,iCAAiC,EAAE;QACjC,GAAG,EAAE,6CAA6C;QAClD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,YAAY,EAAE,KAAK;KACpB;IACD,kBAAkB,EAAE;QAClB,uEAAuE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,kEAAkE;QAClE,GAAG,EAAE,kCAAkC;QACvC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;KACpB;IACD;;;;;OAKG;IACH,SAAS,EAAE;QACT,GAAG,EAAE,yBAAyB;QAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;KAC3C;IACD;;;;;;;;OAQG;IACH,sBAAsB,EAAE;QACtB,GAAG,EAAE,2BAA2B;QAChC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;QACnB,YAAY,EAAE,KAAK;KACpB;IACD,oBAAoB,EAAE;QACpB,GAAG,EAAE,uCAAuC;QAC5C,MAAM,EAAE,CAAC;aACN,MAAM,CAAC;YACN,YAAY,EAAE,kBAAkB;YAChC,cAAc,EAAE,kBAAkB;YAClC,cAAc,EAAE,kBAAkB;YAClC,wBAAwB,EAAE,kBAAkB;YAC5C,wBAAwB,EAAE,kBAAkB;SAC7C,CAAC;aACD,SAAS,CACR,8BAA8B,CACO;KAC1C;CAC6C,CAAC;AAUjD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC;;OAEG;IACH,MAAM,CAAC,QAAiC,EAAE;QACxC,OAAO,IAAI,KAAK,CAAC,EAA2B,EAAE;YAC5C,GAAG,CAAC,OAAO,EAAE,IAAqB;gBAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,gBAAgB,CAAC,EAAE,CAAC;oBAC5D,OAAO,SAAS,CAAC;gBACnB,CAAC;gBACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAqC,CAAC,CAAC;gBACpE,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3B,MAAM,YAAY,GAChB,cAAc,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;gBAEvD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,OAAO,YAAY,CAAC;gBACtB,CAAC;gBAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;gBACzC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;YACrD,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/ai-service/filter-disabled-tools-for-migration.d.ts

@@ -0,0 +1,6 @@
+import type { LLMProviderConfig } from "@superblocksteam/library-shared/types";
+export declare function filterDisabledToolsForMigration(llmConfig: LLMProviderConfig): {
+    config: LLMProviderConfig;
+    removedTools: string[];
+};
+//# sourceMappingURL=filter-disabled-tools-for-migration.d.ts.map

package/dist/ai-service/filter-disabled-tools-for-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-disabled-tools-for-migration.d.ts","sourceRoot":"","sources":["../../src/ai-service/filter-disabled-tools-for-migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AA8B/E,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,iBAAiB,GAAG;IAC7E,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAiBA"}

package/dist/ai-service/filter-disabled-tools-for-migration.js

@@ -0,0 +1,42 @@
+/**
+ * Tools that must remain enabled during migration turns.
+ *
+ * Extracted from {@link AiService.getMigrationSafeLlmConfig} so the
+ * contract is unit-testable without instantiating the full service.
+ */
+const REQUIRED_MIGRATION_TOOLS = new Set([
+    // Preflight step 0 in superblocks-migration/SKILL.md installs
+    // recommendedUserDeps via this tool. If the caller disabled it, Clark
+    // would mark migration_dependency_verification completed with zero
+    // installs and every user-imported package would crash at runtime.
+    "build_installPackages",
+    "build_manageChecklist",
+    "build_manage_checklist",
+    // Focused-debug retries instruct the agent to ask the user via
+    // askMultiChoice when the blocker is informational (e.g. the
+    // original SQL was stubbed before backup). If the caller
+    // disabled that tool, we'd loop on the ZERO-judgment rule.
+    "askMultiChoice",
+    // Page route verification in superblocks-migration/SKILL.md navigates
+    // the preview per route before capturing a screenshot.
+    "build_captureScreenshot",
+    "build_navigatePreview",
+    // Mid-migration write-policy updates when the user explicitly asks Clark
+    // to test integrations they previously marked "Don't test".
+    "updateMigrationWritePolicy",
+]);
+export function filterDisabledToolsForMigration(llmConfig) {
+    const disabledTools = Array.isArray(llmConfig.disabledTools)
+        ? llmConfig.disabledTools
+        : [];
+    if (disabledTools.length === 0) {
+        return { config: llmConfig, removedTools: [] };
+    }
+    const filteredDisabledTools = disabledTools.filter((tool) => !REQUIRED_MIGRATION_TOOLS.has(tool));
+    const removedTools = disabledTools.filter((tool) => REQUIRED_MIGRATION_TOOLS.has(tool));
+    return {
+        config: { ...llmConfig, disabledTools: filteredDisabledTools },
+        removedTools,
+    };
+}
+//# sourceMappingURL=filter-disabled-tools-for-migration.js.map

package/dist/ai-service/filter-disabled-tools-for-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-disabled-tools-for-migration.js","sourceRoot":"","sources":["../../src/ai-service/filter-disabled-tools-for-migration.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC;IACvC,8DAA8D;IAC9D,sEAAsE;IACtE,mEAAmE;IACnE,mEAAmE;IACnE,uBAAuB;IACvB,uBAAuB;IACvB,wBAAwB;IACxB,+DAA+D;IAC/D,6DAA6D;IAC7D,yDAAyD;IACzD,2DAA2D;IAC3D,gBAAgB;IAChB,sEAAsE;IACtE,uDAAuD;IACvD,yBAAyB;IACzB,uBAAuB;IACvB,yEAAyE;IACzE,4DAA4D;IAC5D,4BAA4B;CAC7B,CAAC,CAAC;AAEH,MAAM,UAAU,+BAA+B,CAAC,SAA4B;IAI1E,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC;QAC1D,CAAC,CAAC,SAAS,CAAC,aAAa;QACzB,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,qBAAqB,GAAG,aAAa,CAAC,MAAM,CAChD,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,CAC9C,CAAC;IACF,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACjD,wBAAwB,CAAC,GAAG,CAAC,IAAI,CAAC,CACnC,CAAC;IACF,OAAO;QACL,MAAM,EAAE,EAAE,GAAG,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE;QAC9D,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/ai-service/helper-system-ai-attributes.d.ts

@@ -0,0 +1,19 @@
+import type { AiAttributes } from "@superblocksteam/library-shared/types";
+import type { AiSystemTriggerType } from "@superblocksteam/shared";
+type HelperSystemTriggerType = AiSystemTriggerType.API_USAGE_SUMMARY | AiSystemTriggerType.ATTACHMENT_LABEL | AiSystemTriggerType.ERROR_SUMMARY;
+/**
+ * Billing attributes for non-chat Clark helpers (error summary, API usage
+ * summary, attachment labeling).
+ *
+ * These must omit `prompt_id` so the AI proxy classifies them as system
+ * events (`AI_BILLING_SYSTEM`) and stamps `trigger_type`. Minting a
+ * random `prompt_id` previously made them look like untagged builder
+ * prompts in Snowflake.
+ */
+export declare function helperSystemAiAttributes(args: {
+    applicationId: string;
+    sessionId: string;
+    triggerType: HelperSystemTriggerType;
+}): AiAttributes;
+export {};
+//# sourceMappingURL=helper-system-ai-attributes.d.ts.map

package/dist/ai-service/helper-system-ai-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-system-ai-attributes.d.ts","sourceRoot":"","sources":["../../src/ai-service/helper-system-ai-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,KAAK,uBAAuB,GACxB,mBAAmB,CAAC,iBAAiB,GACrC,mBAAmB,CAAC,gBAAgB,GACpC,mBAAmB,CAAC,aAAa,CAAC;AAEtC;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,uBAAuB,CAAC;CACtC,GAAG,YAAY,CAMf"}

package/dist/ai-service/helper-system-ai-attributes.js

@@ -0,0 +1,17 @@
+/**
+ * Billing attributes for non-chat Clark helpers (error summary, API usage
+ * summary, attachment labeling).
+ *
+ * These must omit `prompt_id` so the AI proxy classifies them as system
+ * events (`AI_BILLING_SYSTEM`) and stamps `trigger_type`. Minting a
+ * random `prompt_id` previously made them look like untagged builder
+ * prompts in Snowflake.
+ */
+export function helperSystemAiAttributes(args) {
+    return {
+        application_id: args.applicationId,
+        session_id: args.sessionId,
+        trigger_type: args.triggerType,
+    };
+}
+//# sourceMappingURL=helper-system-ai-attributes.js.map

package/dist/ai-service/helper-system-ai-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper-system-ai-attributes.js","sourceRoot":"","sources":["../../src/ai-service/helper-system-ai-attributes.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAIxC;IACC,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,aAAa;QAClC,UAAU,EAAE,IAAI,CAAC,SAAS;QAC1B,YAAY,EAAE,IAAI,CAAC,WAAW;KAC/B,CAAC;AACJ,CAAC"}