@dbx-tools/appkit-generator 0.0.0-stage → 0.9.138

package/lib/src/workflow.js

@@ -0,0 +1,171 @@
+/**
+ * Mastra workflow composing reusable generator operations.
+ *
+ * @module
+ */
+import { BrandPackageSchema } from "@dbx-tools/shared-generator/brand";
+import { KpiResearchResultSchema } from "@dbx-tools/shared-generator/kpi";
+import { GeneratedAssetsSchema, GeneratedSchemaSchema, GeneratorPlanSchema, GeneratorRequestSchema, MaterializedGeneratorDataSchema, } from "@dbx-tools/shared-generator/workflow";
+import { createStep, createWorkflow } from "@mastra/core/workflows";
+import { z } from "zod";
+const ResearchOutputSchema = z
+    .object({
+    request: GeneratorRequestSchema,
+    brand: BrandPackageSchema,
+    kpiResearch: KpiResearchResultSchema,
+})
+    .strict();
+const PlanOutputSchema = ResearchOutputSchema.extend({
+    plan: GeneratorPlanSchema,
+}).strict();
+const ProvisionOutputSchema = PlanOutputSchema.extend({
+    location: GeneratedSchemaSchema,
+}).strict();
+const MaterializeOutputSchema = ProvisionOutputSchema.extend({
+    materialized: MaterializedGeneratorDataSchema,
+}).strict();
+/** Build one typed workflow over an isolated generator operation owner. */
+export function createGeneratorWorkflow(operations, options = {}) {
+    const research = createStep({
+        id: "research-brand-and-kpis",
+        inputSchema: GeneratorRequestSchema,
+        outputSchema: ResearchOutputSchema,
+        execute: async ({ inputData, abortSignal, writer }) => {
+            await writer?.write({ type: "generator-progress", stage: "research", status: "started" });
+            const brandRequest = {
+                name: inputData.company,
+                ...(inputData.website ? { website: inputData.website } : {}),
+            };
+            const [brand, kpiResearch] = await Promise.all([
+                operations.generateBrand(brandRequest, abortSignal),
+                operations.researchKpis({
+                    company: inputData.company,
+                    purpose: inputData.purpose,
+                    queries: inputData.queries,
+                }, abortSignal),
+            ]);
+            return { request: inputData, brand, kpiResearch };
+        },
+    });
+    const plan = createStep({
+        id: "plan-demo-data",
+        inputSchema: ResearchOutputSchema,
+        outputSchema: PlanOutputSchema,
+        execute: async ({ inputData, abortSignal, writer }) => {
+            await writer?.write({ type: "generator-progress", stage: "plan", status: "started" });
+            const generatedPlan = await operations.planData(inputData, abortSignal);
+            return { ...inputData, plan: generatedPlan };
+        },
+    });
+    const approval = createStep({
+        id: "approve-mutation-plan",
+        inputSchema: PlanOutputSchema,
+        outputSchema: PlanOutputSchema,
+        resumeSchema: z.object({
+            approved: z.boolean().describe("Whether the generated mutation plan is approved."),
+        }),
+        suspendSchema: z.object({
+            reason: z.string().describe("Why approval is required."),
+            plan: GeneratorPlanSchema,
+        }),
+        execute: async ({ inputData, resumeData, suspend }) => {
+            if (options.approval === false)
+                return inputData;
+            if (resumeData === undefined) {
+                return suspend({
+                    reason: "Approve schema, data, and presentation creation.",
+                    plan: inputData.plan,
+                });
+            }
+            if (!resumeData.approved) {
+                throw new Error("Generator mutation plan was rejected");
+            }
+            return inputData;
+        },
+    });
+    const provision = createStep({
+        id: "provision-schema",
+        inputSchema: PlanOutputSchema,
+        outputSchema: ProvisionOutputSchema,
+        execute: async ({ inputData, abortSignal, writer }) => {
+            await writer?.write({ type: "generator-progress", stage: "schema", status: "started" });
+            const location = await operations.provisionSchema({
+                request: {
+                    company: inputData.request.company,
+                    purpose: inputData.request.purpose,
+                },
+            }, abortSignal);
+            return { ...inputData, location };
+        },
+    });
+    const materialize = createStep({
+        id: "materialize-and-validate-data",
+        inputSchema: ProvisionOutputSchema,
+        outputSchema: MaterializeOutputSchema,
+        execute: async ({ inputData, abortSignal, writer }) => {
+            await writer?.write({ type: "generator-progress", stage: "data", status: "started" });
+            const materialized = await operations.materializeData({
+                location: inputData.location,
+                plan: inputData.plan,
+            }, abortSignal);
+            return { ...inputData, materialized };
+        },
+    });
+    const presentation = createStep({
+        id: "create-presentation",
+        inputSchema: MaterializeOutputSchema,
+        outputSchema: GeneratedAssetsSchema,
+        execute: async ({ inputData, abortSignal, writer }) => {
+            await writer?.write({
+                type: "generator-progress",
+                stage: "presentation",
+                status: "started",
+            });
+            const presentationInput = {
+                request: {
+                    company: inputData.request.company,
+                    purpose: inputData.request.purpose,
+                },
+                location: inputData.location,
+                plan: inputData.plan,
+                brand: inputData.brand,
+            };
+            if (inputData.request.presentation === "dashboard") {
+                const dashboard = await operations.createDashboard(presentationInput, abortSignal);
+                return GeneratedAssetsSchema.parse({
+                    request: inputData.request,
+                    schema: inputData.location,
+                    tables: inputData.materialized.tables,
+                    brand: inputData.brand,
+                    kpiResearch: inputData.kpiResearch,
+                    plan: inputData.plan,
+                    dashboard,
+                });
+            }
+            const genie = await operations.createGenie(presentationInput, abortSignal);
+            return GeneratedAssetsSchema.parse({
+                request: inputData.request,
+                schema: inputData.location,
+                tables: inputData.materialized.tables,
+                brand: inputData.brand,
+                kpiResearch: inputData.kpiResearch,
+                plan: inputData.plan,
+                genie,
+            });
+        },
+    });
+    return createWorkflow({
+        id: "generator-demo-assets",
+        inputSchema: GeneratorRequestSchema,
+        outputSchema: GeneratedAssetsSchema,
+        options: { autoRestartActiveRuns: false },
+    })
+        .then(research)
+        .then(plan)
+        .then(approval)
+        .then(provision)
+        .then(materialize)
+        .then(presentation)
+        .commit();
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ya2Zsb3cuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvd29ya2Zsb3cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7R0FJRztBQUVILE9BQU8sRUFBRSxrQkFBa0IsRUFBK0IsTUFBTSxtQ0FBbUMsQ0FBQztBQUNwRyxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUMxRSxPQUFPLEVBQ0wscUJBQXFCLEVBQ3JCLHFCQUFxQixFQUNyQixtQkFBbUIsRUFDbkIsc0JBQXNCLEVBQ3RCLCtCQUErQixHQUNoQyxNQUFNLHNDQUFzQyxDQUFDO0FBQzlDLE9BQU8sRUFBRSxVQUFVLEVBQUUsY0FBYyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDcEUsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQXFCeEIsTUFBTSxvQkFBb0IsR0FBRyxDQUFDO0tBQzNCLE1BQU0sQ0FBQztJQUNOLE9BQU8sRUFBRSxzQkFBc0I7SUFDL0IsS0FBSyxFQUFFLGtCQUFrQjtJQUN6QixXQUFXLEVBQUUsdUJBQXVCO0NBQ3JDLENBQUM7S0FDRCxNQUFNLEVBQUUsQ0FBQztBQUVaLE1BQU0sZ0JBQWdCLEdBQUcsb0JBQW9CLENBQUMsTUFBTSxDQUFDO0lBQ25ELElBQUksRUFBRSxtQkFBbUI7Q0FDMUIsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDO0FBRVosTUFBTSxxQkFBcUIsR0FBRyxnQkFBZ0IsQ0FBQyxNQUFNLENBQUM7SUFDcEQsUUFBUSxFQUFFLHFCQUFxQjtDQUNoQyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7QUFFWixNQUFNLHVCQUF1QixHQUFHLHFCQUFxQixDQUFDLE1BQU0sQ0FBQztJQUMzRCxZQUFZLEVBQUUsK0JBQStCO0NBQzlDLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQztBQUVaLDJFQUEyRTtBQUMzRSxNQUFNLFVBQVUsdUJBQXVCLENBQ3JDLFVBQXVDLEVBQ3ZDLFVBQW9D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USxDQUFDO1NBQ2QsSUFBSSxDQUFDLFNBQVMsQ0FBQztTQUNmLElBQUksQ0FBQyxXQUFXLENBQUM7U0FDakIsSUFBSSxDQUFDLFlBQVksQ0FBQztTQUNsQixNQUFNLEVBQUUsQ0FBQztBQUNkLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIE1hc3RyYSB3b3JrZmxvdyBjb21wb3NpbmcgcmV1c2FibGUgZ2VuZXJhdG9yIG9wZXJhdGlvbnMuXG4gKlxuICogQG1vZHVsZVxuICovXG5cbmltcG9ydCB7IEJyYW5kUGFja2FnZVNjaGVtYSwgdHlwZSBCcmFuZEdlbmVyYXRpb25SZXF1ZXN0IH0gZnJvbSBcIkBkYngtdG9vbHMvc2hhcmVkLWdlbmVyYXRvci9icmFuZFwiO1xuaW1wb3J0IHsgS3BpUmVzZWFyY2hSZXN1bHRTY2hlbWEgfSBmcm9tIFwiQGRieC10b29scy9zaGFyZWQtZ2VuZXJhdG9yL2twaVwiO1xuaW1wb3J0IHtcbiAgR2VuZXJhdGVkQXNzZXRzU2NoZW1hLFxuICBHZW5lcmF0ZWRTY2hlbWFTY2hlbWEsXG4gIEdlbmVyYXRvclBsYW5TY2hlbWEsXG4gIEdlbmVyYXRvclJlcXVlc3RTY2hlbWEsXG4gIE1hdGVyaWFsaXplZEdlbmVyYXRvckRhdGFTY2hlbWEsXG59IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1nZW5lcmF0b3Ivd29ya2Zsb3dcIjtcbmltcG9ydCB7IGNyZWF0ZVN0ZXAsIGNyZWF0ZVdvcmtmbG93IH0gZnJvbSBcIkBtYXN0cmEvY29yZS93b3JrZmxvd3NcIjtcbmltcG9ydCB7IHogfSBmcm9tIFwiem9kXCI7XG5pbXBvcnQgdHlwZSB7IEdlbmVyYXRvck9wZXJhdGlvbnMgfSBmcm9tIFwiLi9vcGVyYXRpb25zLnRzXCI7XG5cbi8qKiBPcGVyYXRpb24gc3VyZmFjZSBjb25zdW1lZCBieSB0aGUgd29ya2Zsb3cgYW5kIGltcGxlbWVudGVkIGJ5IEdlbmVyYXRvck9wZXJhdGlvbnMuICovXG5leHBvcnQgdHlwZSBHZW5lcmF0b3JXb3JrZmxvd09wZXJhdGlvbnMgPSBQaWNrPFxuICBHZW5lcmF0b3JPcGVyYXRpb25zLFxuICB8IFwiZ2VuZXJhdGVCcmFuZFwiXG4gIHwgXCJyZXNlYXJjaEtwaXNcIlxuICB8IFwicGxhbkRhdGFcIlxuICB8IFwicHJvdmlzaW9uU2NoZW1hXCJcbiAgfCBcIm1hdGVyaWFsaXplRGF0YVwiXG4gIHwgXCJjcmVhdGVEYXNoYm9hcmRcIlxuICB8IFwiY3JlYXRlR2VuaWVcIlxuPjtcblxuLyoqIENvbnN0cnVjdGlvbiBvcHRpb25zIGZvciB3b3JrZmxvdyBob3N0cyBhbmQgaXNvbGF0ZWQgdGVzdHMuICovXG5leHBvcnQgaW50ZXJmYWNlIEdlbmVyYXRvcldvcmtmbG93T3B0aW9ucyB7XG4gIC8qKiBTdXNwZW5kIGJlZm9yZSBtdXRhdGlvbnMuIERlZmF1bHRzIHRvIHRydWUuICovXG4gIGFwcHJvdmFsPzogYm9vbGVhbjtcbn1cblxuY29uc3QgUmVzZWFyY2hPdXRwdXRTY2hlbWEgPSB6XG4gIC5vYmplY3Qoe1xuICAgIHJlcXVlc3Q6IEdlbmVyYXRvclJlcXVlc3RTY2hlbWEsXG4gICAgYnJhbmQ6IEJyYW5kUGFja2FnZVNjaGVtYSxcbiAgICBrcGlSZXNlYXJjaDogS3BpUmVzZWFyY2hSZXN1bHRTY2hlbWEsXG4gIH0pXG4gIC5zdHJpY3QoKTtcblxuY29uc3QgUGxhbk91dHB1dFNjaGVtYSA9IFJlc2VhcmNoT3V0cHV0U2NoZW1hLmV4dGVuZCh7XG4gIHBsYW46IEdlbmVyYXRvclBsYW5TY2hlbWEsXG59KS5zdHJpY3QoKTtcblxuY29uc3QgUHJvdmlzaW9uT3V0cHV0U2NoZW1hID0gUGxhbk91dHB1dFNjaGVtYS5leHRlbmQoe1xuICBsb2NhdGlvbjogR2VuZXJhdGVkU2NoZW1hU2NoZW1hLFxufSkuc3RyaWN0KCk7XG5cbmNvbnN0IE1hdGVyaWFsaXplT3V0cHV0U2NoZW1hID0gUHJvdmlzaW9uT3V0cHV0U2NoZW1hLmV4dGVuZCh7XG4gIG1hdGVyaWFsaXplZDogTWF0ZXJpYWxpemVkR2VuZXJhdG9yRGF0YVNjaGVtYSxcbn0pLnN0cmljdCgpO1xuXG4vKiogQnVpbGQgb25lIHR5cGVkIHdvcmtmbG93IG92ZXIgYW4gaXNvbGF0ZWQgZ2VuZXJhdG9yIG9wZXJhdGlvbiBvd25lci4gKi9cbmV4cG9ydCBmdW5jdGlvbiBjcmVhdGVHZW5lcmF0b3JXb3JrZmxvdyhcbiAgb3BlcmF0aW9uczogR2VuZXJhdG9yV29ya2Zsb3dPcGVyYXRpb25zLFxuICBvcHRpb25zOiBHZW5lcmF0b3JXb3JrZmxvd09wdGlvbnMgPSB7fSxcbikge1xuICBjb25zdCByZXNlYXJjaCA9IGNyZWF0ZVN0ZXAoe1xuICAgIGlkOiBcInJlc2VhcmNoLWJyYW5kLWFuZC1rcGlzXCIsXG4gICAgaW5wdXRTY2hlbWE6IEdlbmVyYXRvclJlcXVlc3RTY2hlbWEsXG4gICAgb3V0cHV0U2NoZW1hOiBSZXNlYXJjaE91dHB1dFNjaGVtYSxcbiAgICBleGVjdXRlOiBhc3luYyAoeyBpbnB1dERhdGEsIGFib3J0U2lnbmFsLCB3cml0ZXIgfSkgPT4ge1xuICAgICAgYXdhaXQgd3JpdGVyPy53cml0ZSh7IHR5cGU6IFwiZ2VuZXJhdG9yLXByb2dyZXNzXCIsIHN0YWdlOiBcInJlc2VhcmNoXCIsIHN0YXR1czogXCJzdGFydGVkXCIgfSk7XG4gICAgICBjb25zdCBicmFuZFJlcXVlc3Q6IEJyYW5kR2VuZXJhdGlvblJlcXVlc3QgPSB7XG4gICAgICAgIG5hbWU6IGlucHV0RGF0YS5jb21wYW55LFxuICAgICAgICAuLi4oaW5wdXREYXRhLndlYnNpdGUgPyB7IHdlYnNpdGU6IGlucHV0RGF0YS53ZWJzaXRlIH0gOiB7fSksXG4gICAgICB9O1xuICAgICAgY29uc3QgW2JyYW5kLCBrcGlSZXNlYXJjaF0gPSBhd2FpdCBQcm9taXNlLmFsbChbXG4gICAgICAgIG9wZXJhdGlvbnMuZ2VuZXJhdGVCcmFuZChicmFuZFJlcXVlc3QsIGFib3J0U2lnbmFsKSxcbiAgICAgICAgb3BlcmF0aW9ucy5yZXNlYXJjaEtwaXMoXG4gICAgICAgICAge1xuICAgICAgICAgICAgY29tcGFueTogaW5wdXREYXRhLmNvbXBhbnksXG4gICAgICAgICAgICBwdXJwb3NlOiBpbnB1dERhdGEucHVycG9zZSxcbiAgICAgICAgICAgIHF1ZXJpZXM6IGlucHV0RGF0YS5xdWVyaWVzLFxuICAgICAgICAgIH0sXG4gICAgICAgICAgYWJvcnRTaWduYWwsXG4gICAgICAgICksXG4gICAgICBdKTtcbiAgICAgIHJldHVybiB7IHJlcXVlc3Q6IGlucHV0RGF0YSwgYnJhbmQsIGtwaVJlc2VhcmNoIH07XG4gICAgfSxcbiAgfSk7XG5cbiAgY29uc3QgcGxhbiA9IGNyZWF0ZVN0ZXAoe1xuICAgIGlkOiBcInBsYW4tZGVtby1kYXRhXCIsXG4gICAgaW5wdXRTY2hlbWE6IFJlc2VhcmNoT3V0cHV0U2NoZW1hLFxuICAgIG91dHB1dFNjaGVtYTogUGxhbk91dHB1dFNjaGVtYSxcbiAgICBleGVjdXRlOiBhc3luYyAoeyBpbnB1dERhdGEsIGFib3J0U2lnbmFsLCB3cml0ZXIgfSkgPT4ge1xuICAgICAgYXdhaXQgd3JpdGVyPy53cml0ZSh7IHR5cGU6IFwiZ2VuZXJhdG9yLXByb2dyZXNzXCIsIHN0YWdlOiBcInBsYW5cIiwgc3RhdHVzOiBcInN0YXJ0ZWRcIiB9KTtcbiAgICAgIGNvbnN0IGdlbmVyYXRlZFBsYW4gPSBhd2FpdCBvcGVyYXRpb25zLnBsYW5EYXRhKGlucHV0RGF0YSwgYWJvcnRTaWduYWwpO1xuICAgICAgcmV0dXJuIHsgLi4uaW5wdXREYXRhLCBwbGFuOiBnZW5lcmF0ZWRQbGFuIH07XG4gICAgfSxcbiAgfSk7XG5cbiAgY29uc3QgYXBwcm92YWwgPSBjcmVhdGVTdGVwKHtcbiAgICBpZDogXCJhcHByb3ZlLW11dGF0aW9uLXBsYW5cIixcbiAgICBpbnB1dFNjaGVtYTogUGxhbk91dHB1dFNjaGVtYSxcbiAgICBvdXRwdXRTY2hlbWE6IFBsYW5PdXRwdXRTY2hlbWEsXG4gICAgcmVzdW1lU2NoZW1hOiB6Lm9iamVjdCh7XG4gICAgICBhcHByb3ZlZDogei5ib29sZWFuKCkuZGVzY3JpYmUoXCJXaGV0aGVyIHRoZSBnZW5lcmF0ZWQgbXV0YXRpb24gcGxhbiBpcyBhcHByb3ZlZC5cIiksXG4gICAgfSksXG4gICAgc3VzcGVuZFNjaGVtYTogei5vYmplY3Qoe1xuICAgICAgcmVhc29uOiB6LnN0cmluZygpLmRlc2NyaWJlKFwiV2h5IGFwcHJvdmFsIGlzIHJlcXVpcmVkLlwiKSxcbiAgICAgIHBsYW46IEdlbmVyYXRvclBsYW5TY2hlbWEsXG4gICAgfSksXG4gICAgZXhlY3V0ZTogYXN5bmMgKHsgaW5wdXREYXRhLCByZXN1bWVEYXRhLCBzdXNwZW5kIH0pID0+IHtcbiAgICAgIGlmIChvcHRpb25zLmFwcHJvdmFsID09PSBmYWxzZSkgcmV0dXJuIGlucHV0RGF0YTtcbiAgICAgIGlmIChyZXN1bWVEYXRhID09PSB1bmRlZmluZWQpIHtcbiAgICAgICAgcmV0dXJuIHN1c3BlbmQoe1xuICAgICAgICAgIHJlYXNvbjogXCJBcHByb3ZlIHNjaGVtYSwgZGF0YSwgYW5kIHByZXNlbnRhdGlvbiBjcmVhdGlvbi5cIixcbiAgICAgICAgICBwbGFuOiBpbnB1dERhdGEucGxhbixcbiAgICAgICAgfSk7XG4gICAgICB9XG4gICAgICBpZiAoIXJlc3VtZURhdGEuYXBwcm92ZWQpIHtcbiAgICAgICAgdGhyb3cgbmV3IEVycm9yKFwiR2VuZXJhdG9yIG11dGF0aW9uIHBsYW4gd2FzIHJlamVjdGVkXCIpO1xuICAgICAgfVxuICAgICAgcmV0dXJuIGlucHV0RGF0YTtcbiAgICB9LFxuICB9KTtcblxuICBjb25zdCBwcm92aXNpb24gPSBjcmVhdGVTdGVwKHtcbiAgICBpZDogXCJwcm92aXNpb24tc2NoZW1hXCIsXG4gICAgaW5wdXRTY2hlbWE6IFBsYW5PdXRwdXRTY2hlbWEsXG4gICAgb3V0cHV0U2NoZW1hOiBQcm92aXNpb25PdXRwdXRTY2hlbWEsXG4gICAgZXhlY3V0ZTogYXN5bmMgKHsgaW5wdXREYXRhLCBhYm9ydFNpZ25hbCwgd3JpdGVyIH0pID0+IHtcbiAgICAgIGF3YWl0IHdyaXRlcj8ud3JpdGUoeyB0eXBlOiBcImdlbmVyYXRvci1wcm9ncmVzc1wiLCBzdGFnZTogXCJzY2hlbWFcIiwgc3RhdHVzOiBcInN0YXJ0ZWRcIiB9KTtcbiAgICAgIGNvbnN0IGxvY2F0aW9uID0gYXdhaXQgb3BlcmF0aW9ucy5wcm92aXNpb25TY2hlbWEoXG4gICAgICAgIHtcbiAgICAgICAgICByZXF1ZXN0OiB7XG4gICAgICAgICAgICBjb21wYW55OiBpbnB1dERhdGEucmVxdWVzdC5jb21wYW55LFxuICAgICAgICAgICAgcHVycG9zZTogaW5wdXREYXRhLnJlcXVlc3QucHVycG9zZSxcbiAgICAgICAgICB9LFxuICAgICAgICB9LFxuICAgICAgICBhYm9ydFNpZ25hbCxcbiAgICAgICk7XG4gICAgICByZXR1cm4geyAuLi5pbnB1dERhdGEsIGxvY2F0aW9uIH07XG4gICAgfSxcbiAgfSk7XG5cbiAgY29uc3QgbWF0ZXJpYWxpemUgPSBjcmVhdGVTdGVwKHtcbiAgICBpZDogXCJtYXRlcmlhbGl6ZS1hbmQtdmFsaWRhdGUtZGF0YVwiLFxuICAgIGlucHV0U2NoZW1hOiBQcm92aXNpb25PdXRwdXRTY2hlbWEsXG4gICAgb3V0cHV0U2NoZW1hOiBNYXRlcmlhbGl6ZU91dHB1dFNjaGVtYSxcbiAgICBleGVjdXRlOiBhc3luYyAoeyBpbnB1dERhdGEsIGFib3J0U2lnbmFsLCB3cml0ZXIgfSkgPT4ge1xuICAgICAgYXdhaXQgd3JpdGVyPy53cml0ZSh7IHR5cGU6IFwiZ2VuZXJhdG9yLXByb2dyZXNzXCIsIHN0YWdlOiBcImRhdGFcIiwgc3RhdHVzOiBcInN0YXJ0ZWRcIiB9KTtcbiAgICAgIGNvbnN0IG1hdGVyaWFsaXplZCA9IGF3YWl0IG9wZXJhdGlvbnMubWF0ZXJpYWxpemVEYXRhKFxuICAgICAgICB7XG4gICAgICAgICAgbG9jYXRpb246IGlucHV0RGF0YS5sb2NhdGlvbixcbiAgICAgICAgICBwbGFuOiBpbnB1dERhdGEucGxhbixcbiAgICAgICAgfSxcbiAgICAgICAgYWJvcnRTaWduYWwsXG4gICAgICApO1xuICAgICAgcmV0dXJuIHsgLi4uaW5wdXREYXRhLCBtYXRlcmlhbGl6ZWQgfTtcbiAgICB9LFxuICB9KTtcblxuICBjb25zdCBwcmVzZW50YXRpb24gPSBjcmVhdGVTdGVwKHtcbiAgICBpZDogXCJjcmVhdGUtcHJlc2VudGF0aW9uXCIsXG4gICAgaW5wdXRTY2hlbWE6IE1hdGVyaWFsaXplT3V0cHV0U2NoZW1hLFxuICAgIG91dHB1dFNjaGVtYTogR2VuZXJhdGVkQXNzZXRzU2NoZW1hLFxuICAgIGV4ZWN1dGU6IGFzeW5jICh7IGlucHV0RGF0YSwgYWJvcnRTaWduYWwsIHdyaXRlciB9KSA9PiB7XG4gICAgICBhd2FpdCB3cml0ZXI/LndyaXRlKHtcbiAgICAgICAgdHlwZTogXCJnZW5lcmF0b3ItcHJvZ3Jlc3NcIixcbiAgICAgICAgc3RhZ2U6IFwicHJlc2VudGF0aW9uXCIsXG4gICAgICAgIHN0YXR1czogXCJzdGFydGVkXCIsXG4gICAgICB9KTtcbiAgICAgIGNvbnN0IHByZXNlbnRhdGlvbklucHV0ID0ge1xuICAgICAgICByZXF1ZXN0OiB7XG4gICAgICAgICAgY29tcGFueTogaW5wdXREYXRhLnJlcXVlc3QuY29tcGFueSxcbiAgICAgICAgICBwdXJwb3NlOiBpbnB1dERhdGEucmVxdWVzdC5wdXJwb3NlLFxuICAgICAgICB9LFxuICAgICAgICBsb2NhdGlvbjogaW5wdXREYXRhLmxvY2F0aW9uLFxuICAgICAgICBwbGFuOiBpbnB1dERhdGEucGxhbixcbiAgICAgICAgYnJhbmQ6IGlucHV0RGF0YS5icmFuZCxcbiAgICAgIH07XG4gICAgICBpZiAoaW5wdXREYXRhLnJlcXVlc3QucHJlc2VudGF0aW9uID09PSBcImRhc2hib2FyZFwiKSB7XG4gICAgICAgIGNvbnN0IGRhc2hib2FyZCA9IGF3YWl0IG9wZXJhdGlvbnMuY3JlYXRlRGFzaGJvYXJkKHByZXNlbnRhdGlvbklucHV0LCBhYm9ydFNpZ25hbCk7XG4gICAgICAgIHJldHVybiBHZW5lcmF0ZWRBc3NldHNTY2hlbWEucGFyc2Uoe1xuICAgICAgICAgIHJlcXVlc3Q6IGlucHV0RGF0YS5yZXF1ZXN0LFxuICAgICAgICAgIHNjaGVtYTogaW5wdXREYXRhLmxvY2F0aW9uLFxuICAgICAgICAgIHRhYmxlczogaW5wdXREYXRhLm1hdGVyaWFsaXplZC50YWJsZXMsXG4gICAgICAgICAgYnJhbmQ6IGlucHV0RGF0YS5icmFuZCxcbiAgICAgICAgICBrcGlSZXNlYXJjaDogaW5wdXREYXRhLmtwaVJlc2VhcmNoLFxuICAgICAgICAgIHBsYW46IGlucHV0RGF0YS5wbGFuLFxuICAgICAgICAgIGRhc2hib2FyZCxcbiAgICAgICAgfSk7XG4gICAgICB9XG4gICAgICBjb25zdCBnZW5pZSA9IGF3YWl0IG9wZXJhdGlvbnMuY3JlYXRlR2VuaWUocHJlc2VudGF0aW9uSW5wdXQsIGFib3J0U2lnbmFsKTtcbiAgICAgIHJldHVybiBHZW5lcmF0ZWRBc3NldHNTY2hlbWEucGFyc2Uoe1xuICAgICAgICByZXF1ZXN0OiBpbnB1dERhdGEucmVxdWVzdCxcbiAgICAgICAgc2NoZW1hOiBpbnB1dERhdGEubG9jYXRpb24sXG4gICAgICAgIHRhYmxlczogaW5wdXREYXRhLm1hdGVyaWFsaXplZC50YWJsZXMsXG4gICAgICAgIGJyYW5kOiBpbnB1dERhdGEuYnJhbmQsXG4gICAgICAgIGtwaVJlc2VhcmNoOiBpbnB1dERhdGEua3BpUmVzZWFyY2gsXG4gICAgICAgIHBsYW46IGlucHV0RGF0YS5wbGFuLFxuICAgICAgICBnZW5pZSxcbiAgICAgIH0pO1xuICAgIH0sXG4gIH0pO1xuXG4gIHJldHVybiBjcmVhdGVXb3JrZmxvdyh7XG4gICAgaWQ6IFwiZ2VuZXJhdG9yLWRlbW8tYXNzZXRzXCIsXG4gICAgaW5wdXRTY2hlbWE6IEdlbmVyYXRvclJlcXVlc3RTY2hlbWEsXG4gICAgb3V0cHV0U2NoZW1hOiBHZW5lcmF0ZWRBc3NldHNTY2hlbWEsXG4gICAgb3B0aW9uczogeyBhdXRvUmVzdGFydEFjdGl2ZVJ1bnM6IGZhbHNlIH0sXG4gIH0pXG4gICAgLnRoZW4ocmVzZWFyY2gpXG4gICAgLnRoZW4ocGxhbilcbiAgICAudGhlbihhcHByb3ZhbClcbiAgICAudGhlbihwcm92aXNpb24pXG4gICAgLnRoZW4obWF0ZXJpYWxpemUpXG4gICAgLnRoZW4ocHJlc2VudGF0aW9uKVxuICAgIC5jb21taXQoKTtcbn1cblxuLyoqIEdlbmVyYXRvciB3b3JrZmxvdyB0eXBlLiAqL1xuZXhwb3J0IHR5cGUgR2VuZXJhdG9yV29ya2Zsb3cgPSBSZXR1cm5UeXBlPHR5cGVvZiBjcmVhdGVHZW5lcmF0b3JXb3JrZmxvdz47XG4iXX0=

package/lib/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/assets.ts","../src/config.ts","../src/dashboard.ts","../src/data.ts","../src/defaults.ts","../src/generate.ts","../src/genie.ts","../src/kpi.ts","../src/namespace.ts","../src/operations.ts","../src/palette.ts","../src/plan.ts","../src/plugin.ts","../src/research.ts","../src/schema.ts","../src/structured.ts","../src/workflow.ts","../index.ts"],"version":"5.9.3"}

package/package.json

@@ -1,6 +1,220 @@
 {
   "name": "@dbx-tools/appkit-generator",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "description": "AppKit tools and Mastra workflows for researched Databricks demo assets",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/reggie-db/dbx-tools.git",
+    "directory": "packages/js/node/appkit-generator"
+  },
+  "scripts": {
+    "build": "projen build",
+    "compile": "projen compile",
+    "default": "projen default",
+    "package": "projen package",
+    "post-compile": "projen post-compile",
+    "pre-compile": "projen pre-compile",
+    "prepack": "projen prepack",
+    "test": "projen test",
+    "watch": "projen watch",
+    "projen": "projen"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@databricks/appkit": "0.81.0",
+    "@databricks/sdk-experimental": "^0.17.0",
+    "@dbx-tools/appkit": "^0.9.138",
+    "@dbx-tools/appkit-mastra": "^0.9.138",
+    "@dbx-tools/appkit-web-search": "^0.9.138",
+    "@dbx-tools/core": "^0.9.138",
+    "@dbx-tools/genie": "^0.9.138",
+    "@dbx-tools/shared-core": "^0.9.138",
+    "@dbx-tools/shared-generator": "^0.9.138",
+    "@dbx-tools/shared-genie": "^0.9.138",
+    "@mastra/core": "1.71.0",
+    "ai": "^7.0.0",
+    "cheerio": "^1.2.0",
+    "zod": "4.3.6"
+  },
+  "main": "./lib/index.js",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public",
+    "main": "./lib/index.js",
+    "types": "./lib/index.d.ts",
+    "exports": {
+      ".": {
+        "types": "./lib/index.d.ts",
+        "default": "./lib/index.js"
+      },
+      "./assets": {
+        "types": "./lib/src/assets.d.ts",
+        "default": "./lib/src/assets.js"
+      },
+      "./config": {
+        "types": "./lib/src/config.d.ts",
+        "default": "./lib/src/config.js"
+      },
+      "./dashboard": {
+        "types": "./lib/src/dashboard.d.ts",
+        "default": "./lib/src/dashboard.js"
+      },
+      "./data": {
+        "types": "./lib/src/data.d.ts",
+        "default": "./lib/src/data.js"
+      },
+      "./defaults": {
+        "types": "./lib/src/defaults.d.ts",
+        "default": "./lib/src/defaults.js"
+      },
+      "./generate": {
+        "types": "./lib/src/generate.d.ts",
+        "default": "./lib/src/generate.js"
+      },
+      "./genie": {
+        "types": "./lib/src/genie.d.ts",
+        "default": "./lib/src/genie.js"
+      },
+      "./kpi": {
+        "types": "./lib/src/kpi.d.ts",
+        "default": "./lib/src/kpi.js"
+      },
+      "./namespace": {
+        "types": "./lib/src/namespace.d.ts",
+        "default": "./lib/src/namespace.js"
+      },
+      "./operations": {
+        "types": "./lib/src/operations.d.ts",
+        "default": "./lib/src/operations.js"
+      },
+      "./palette": {
+        "types": "./lib/src/palette.d.ts",
+        "default": "./lib/src/palette.js"
+      },
+      "./plan": {
+        "types": "./lib/src/plan.d.ts",
+        "default": "./lib/src/plan.js"
+      },
+      "./plugin": {
+        "types": "./lib/src/plugin.d.ts",
+        "default": "./lib/src/plugin.js"
+      },
+      "./research": {
+        "types": "./lib/src/research.d.ts",
+        "default": "./lib/src/research.js"
+      },
+      "./schema": {
+        "types": "./lib/src/schema.d.ts",
+        "default": "./lib/src/schema.js"
+      },
+      "./structured": {
+        "types": "./lib/src/structured.d.ts",
+        "default": "./lib/src/structured.js"
+      },
+      "./workflow": {
+        "types": "./lib/src/workflow.d.ts",
+        "default": "./lib/src/workflow.js"
+      },
+      "./*": {
+        "types": "./lib/src/*/index.d.ts",
+        "default": "./lib/src/*/index.js"
+      },
+      "./package.json": "./package.json"
+    }
+  },
+  "version": "0.9.138",
+  "types": "./lib/index.d.ts",
+  "dbxToolsConfig": {
+    "tags": [
+      "node"
+    ]
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./assets": {
+      "types": "./lib/src/assets.d.ts",
+      "default": "./lib/src/assets.js"
+    },
+    "./config": {
+      "types": "./lib/src/config.d.ts",
+      "default": "./lib/src/config.js"
+    },
+    "./dashboard": {
+      "types": "./lib/src/dashboard.d.ts",
+      "default": "./lib/src/dashboard.js"
+    },
+    "./data": {
+      "types": "./lib/src/data.d.ts",
+      "default": "./lib/src/data.js"
+    },
+    "./defaults": {
+      "types": "./lib/src/defaults.d.ts",
+      "default": "./lib/src/defaults.js"
+    },
+    "./generate": {
+      "types": "./lib/src/generate.d.ts",
+      "default": "./lib/src/generate.js"
+    },
+    "./genie": {
+      "types": "./lib/src/genie.d.ts",
+      "default": "./lib/src/genie.js"
+    },
+    "./kpi": {
+      "types": "./lib/src/kpi.d.ts",
+      "default": "./lib/src/kpi.js"
+    },
+    "./namespace": {
+      "types": "./lib/src/namespace.d.ts",
+      "default": "./lib/src/namespace.js"
+    },
+    "./operations": {
+      "types": "./lib/src/operations.d.ts",
+      "default": "./lib/src/operations.js"
+    },
+    "./palette": {
+      "types": "./lib/src/palette.d.ts",
+      "default": "./lib/src/palette.js"
+    },
+    "./plan": {
+      "types": "./lib/src/plan.d.ts",
+      "default": "./lib/src/plan.js"
+    },
+    "./plugin": {
+      "types": "./lib/src/plugin.d.ts",
+      "default": "./lib/src/plugin.js"
+    },
+    "./research": {
+      "types": "./lib/src/research.d.ts",
+      "default": "./lib/src/research.js"
+    },
+    "./schema": {
+      "types": "./lib/src/schema.d.ts",
+      "default": "./lib/src/schema.js"
+    },
+    "./structured": {
+      "types": "./lib/src/structured.d.ts",
+      "default": "./lib/src/structured.js"
+    },
+    "./workflow": {
+      "types": "./lib/src/workflow.d.ts",
+      "default": "./lib/src/workflow.js"
+    },
+    "./*": {
+      "types": "./lib/src/*/index.d.ts",
+      "default": "./lib/src/*/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "lib"
+  ],
+  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"bunx projen\"."
+}

package/src/assets.ts

@@ -0,0 +1,248 @@
+/**
+ * Deterministic brand-asset discovery from an official page.
+ *
+ * @module
+ */
+
+import { object } from "@dbx-tools/shared-core";
+import type { BrandAssetSet } from "@dbx-tools/shared-core/brand-utils";
+import { load } from "cheerio";
+
+/** Asset references extracted from one official HTML page. */
+export interface DiscoveredBrandAssets {
+  /** Theme-aware icon reference. */
+  icon: BrandAssetSet;
+  /** Theme-aware logo reference. */
+  logo: BrandAssetSet;
+  /** Browser favicon reference. */
+  favicon: string;
+}
+
+/** Visual references extracted from an official mobile-store page. */
+export interface DiscoveredMobileAppVisuals {
+  /** Store listing application name. */
+  appName: string;
+  /** App icon and screenshot URLs in page order. */
+  imageUrls: string[];
+}
+
+/** Normalize a page-relative asset reference to a public HTTPS URL. */
+function assetUrl(value: string | undefined, baseUrl: string): string | undefined {
+  if (!value?.trim()) return undefined;
+  try {
+    const resolved = new URL(value.trim(), baseUrl);
+    return resolved.protocol === "https:" ? resolved.toString() : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/** Add a normalized URL to a candidate list once. */
+function appendCandidate(candidates: string[], value: string | undefined, baseUrl: string): void {
+  const resolved = assetUrl(value, baseUrl);
+  if (resolved && !candidates.includes(resolved)) candidates.push(resolved);
+}
+
+/** Collapse CDN size and format variants of the same mobile artwork. */
+function mobileImageIdentity(value: string): string {
+  const url = new URL(value);
+  if (/googleusercontent\.com$/i.test(url.hostname)) {
+    return `${url.origin}${url.pathname.replace(/=[^/]+$/, "")}`;
+  }
+  if (/mzstatic\.com$/i.test(url.hostname)) {
+    return `${url.origin}${url.pathname.replace(/\/[^/]+$/, "")}`;
+  }
+  return url.toString();
+}
+
+/**
+ * Find logo-like URLs nested in JSON-LD organization metadata.
+ *
+ * JSON-LD permits `logo` and `image` to be a URL, an object with a `url` or
+ * `contentUrl`, or an array. The bounded recursive walk accepts those forms
+ * without treating unrelated strings elsewhere in the document as assets.
+ */
+function jsonLdAssetUrls(value: unknown, depth = 0, assetContext = false): string[] {
+  if (depth > 8 || value === null || value === undefined) return [];
+  if (typeof value === "string") return assetContext ? [value] : [];
+  if (Array.isArray(value)) {
+    return value.flatMap((entry) => jsonLdAssetUrls(entry, depth + 1, assetContext));
+  }
+  if (!object.isRecord(value)) return [];
+
+  const direct = assetContext
+    ? [value.url, value.contentUrl].flatMap((entry) => (typeof entry === "string" ? [entry] : []))
+    : [];
+  return [
+    ...direct,
+    ...jsonLdAssetUrls(value.logo, depth + 1, true),
+    ...jsonLdAssetUrls(value.image, depth + 1, true),
+    ...jsonLdAssetUrls(value["@graph"], depth + 1, false),
+  ];
+}
+
+/** Collect mobile screenshots and image objects from JSON-LD. */
+function jsonLdMobileImageUrls(value: unknown, depth = 0, imageContext = false): string[] {
+  if (depth > 10 || value === null || value === undefined) return [];
+  if (typeof value === "string") return imageContext ? [value] : [];
+  if (Array.isArray(value)) {
+    return value.flatMap((entry) => jsonLdMobileImageUrls(entry, depth + 1, imageContext));
+  }
+  if (!object.isRecord(value)) return [];
+  const direct = imageContext
+    ? [value.url, value.contentUrl].flatMap((entry) => (typeof entry === "string" ? [entry] : []))
+    : [];
+  return [
+    ...direct,
+    ...jsonLdMobileImageUrls(value.screenshot, depth + 1, true),
+    ...jsonLdMobileImageUrls(value.image, depth + 1, true),
+    ...jsonLdMobileImageUrls(value.thumbnailUrl, depth + 1, true),
+    ...jsonLdMobileImageUrls(value["@graph"], depth + 1, false),
+  ];
+}
+
+/**
+ * Discover icon, logo, and favicon URLs from an official page.
+ *
+ * The function only returns URLs present in page metadata or markup. When the
+ * page omits an icon, it uses the conventional `/favicon.ico` URL on the same
+ * origin. The logo falls back to that icon so a generated context never points
+ * at the dbx-tools default artwork.
+ */
+export function discoverBrandAssets(html: string, pageUrl: string): DiscoveredBrandAssets {
+  const $ = load(html);
+  const icons: string[] = [];
+  const logos: string[] = [];
+
+  $("link[rel]").each((_index, element) => {
+    const rel = ($(element).attr("rel") ?? "").toLowerCase();
+    if (rel.split(/\s+/).some((part) => part === "icon" || part === "apple-touch-icon")) {
+      appendCandidate(icons, $(element).attr("href"), pageUrl);
+    }
+  });
+
+  for (const selector of [
+    'meta[property="og:image"]',
+    'meta[property="og:logo"]',
+    'meta[name="twitter:image"]',
+  ]) {
+    $(selector).each((_index, element) => {
+      appendCandidate(logos, $(element).attr("content"), pageUrl);
+    });
+  }
+
+  $("img").each((_index, element) => {
+    const descriptor = [
+      $(element).attr("alt"),
+      $(element).attr("class"),
+      $(element).attr("id"),
+      $(element).attr("data-testid"),
+    ]
+      .filter(Boolean)
+      .join(" ");
+    if (/\b(?:brand|logo|wordmark)\b/i.test(descriptor)) {
+      appendCandidate(logos, $(element).attr("src"), pageUrl);
+    }
+  });
+
+  $('script[type="application/ld+json"]').each((_index, element) => {
+    try {
+      const value: unknown = JSON.parse($(element).text());
+      for (const candidate of jsonLdAssetUrls(value)) {
+        appendCandidate(logos, candidate, pageUrl);
+      }
+    } catch {
+      return;
+    }
+  });
+
+  const fallbackIcon = new URL("/favicon.ico", pageUrl).toString();
+  const icon = icons[0] ?? logos[0] ?? fallbackIcon;
+  const logo = logos[0] ?? icons[0] ?? fallbackIcon;
+  return {
+    icon: { light: icon },
+    logo: { light: logo },
+    favicon: icon,
+  };
+}
+
+/** Extract an app name plus representative screenshots/icons from a store page. */
+export function discoverMobileAppVisuals(
+  html: string,
+  pageUrl: string,
+): DiscoveredMobileAppVisuals {
+  const $ = load(html);
+  const metadataImages: string[] = [];
+  const structuredImages: string[] = [];
+  const screenshotImages: string[] = [];
+  const iconImages: string[] = [];
+  const otherStoreImages: string[] = [];
+  for (const selector of ['meta[property="og:image"]', 'meta[name="twitter:image"]']) {
+    $(selector).each((_index, element) => {
+      appendCandidate(metadataImages, $(element).attr("content"), pageUrl);
+    });
+  }
+  $('script[type="application/ld+json"]').each((_index, element) => {
+    try {
+      const value: unknown = JSON.parse($(element).text());
+      for (const candidate of jsonLdMobileImageUrls(value)) {
+        appendCandidate(structuredImages, candidate, pageUrl);
+      }
+    } catch {
+      return;
+    }
+  });
+  $("img").each((_index, element) => {
+    const descriptor = [
+      $(element).attr("alt"),
+      $(element).attr("class"),
+      $(element).attr("aria-label"),
+    ]
+      .filter(Boolean)
+      .join(" ");
+    const source = $(element).attr("src") ?? $(element).attr("data-src");
+    const isStoreImageHost = /(?:mzstatic|ggpht|googleusercontent)\./i.test(source ?? "");
+    const target = /\b(?:phone|screen|screenshot|tablet)\b/i.test(descriptor)
+      ? screenshotImages
+      : /\b(?:app|icon)\b/i.test(descriptor)
+        ? iconImages
+        : isStoreImageHost
+          ? otherStoreImages
+          : undefined;
+    if (target) {
+      appendCandidate(target, source, pageUrl);
+      const srcset = ($(element).attr("srcset") ?? $(element).attr("data-srcset"))
+        ?.split(",")
+        .at(-1)
+        ?.trim()
+        .split(/\s+/)[0];
+      appendCandidate(target, srcset, pageUrl);
+    }
+  });
+  $("picture source[srcset]").each((_index, element) => {
+    const srcset = $(element).attr("srcset")?.split(",").at(-1)?.trim().split(/\s+/)[0];
+    appendCandidate(screenshotImages, srcset, pageUrl);
+  });
+  const images: string[] = [];
+  const seenImages = new Set<string>();
+  for (const candidate of [
+    ...metadataImages.slice(0, 1),
+    ...screenshotImages,
+    ...iconImages,
+    ...structuredImages,
+    ...otherStoreImages,
+  ]) {
+    const resolved = assetUrl(candidate, pageUrl);
+    if (!resolved) continue;
+    const identity = mobileImageIdentity(resolved);
+    if (seenImages.has(identity)) continue;
+    seenImages.add(identity);
+    images.push(resolved);
+  }
+  const rawName =
+    $('meta[property="og:title"]').attr("content") ?? $("h1").first().text() ?? $("title").text();
+  const appName =
+    rawName.replace(/\s+(?:on the App Store|- Apps on Google Play).*$/i, "").trim() ||
+    new URL(pageUrl).hostname;
+  return { appName, imageUrls: images.slice(0, 6) };
+}