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

package/lib/src/schema.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Model-facing profile contract and AppKit tool description for researched
+ * brand generation. Browser-safe request, event, and package contracts are
+ * owned by `@dbx-tools/shared-generator`.
+ *
+ * @module
+ */
+import type { BrandGenerationRequest as SharedBrandGenerationRequest } from "@dbx-tools/shared-generator/brand";
+import { z } from "zod";
+export { BrandGenerationErrorEventSchema, BrandGenerationEventSchema, BrandGenerationProgressEventSchema, BrandGenerationRequestSchema, BrandGenerationResultEventSchema, BrandGenerationStageSchema, BrandPackageSchema, BrandPackageSourceSchema, BrandVisualImageSchema, BrandVisualReferenceSchema, } from "@dbx-tools/shared-generator/brand";
+export type { BrandGenerationErrorEvent, BrandGenerationEvent, BrandGenerationProgressEvent, BrandGenerationRequest, BrandGenerationResultEvent, BrandGenerationStage, BrandPackage, BrandPackageSource, BrandVisualImage, BrandVisualReference, } from "@dbx-tools/shared-generator/brand";
+/** Resolve the human-readable subject from a validated brand request. */
+export declare function brandRequestSubject(request: SharedBrandGenerationRequest): string;
+/** Description shared by the native AppKit brand-generation tool. */
+export declare const GENERATE_BRAND_TOOL_DESCRIPTION: string;
+/**
+ * Structured model output before deterministic asset references and schema
+ * metadata are attached.
+ */
+export declare const GeneratedBrandProfileSchema: z.ZodObject<{
+    name: z.ZodString;
+    shortName: z.ZodString;
+    tagline: z.ZodString;
+    description: z.ZodString;
+    colors: z.ZodObject<{
+        primary: z.ZodString;
+        primaryHover: z.ZodString;
+        accent: z.ZodString;
+        foreground: z.ZodString;
+        background: z.ZodString;
+        surface: z.ZodString;
+        muted: z.ZodString;
+        border: z.ZodString;
+    }, z.core.$strict>;
+    typography: z.ZodObject<{
+        sans: z.ZodString;
+        mono: z.ZodString;
+    }, z.core.$strict>;
+    voice: z.ZodObject<{
+        audience: z.ZodArray<z.ZodString>;
+        tone: z.ZodArray<z.ZodString>;
+        principles: z.ZodArray<z.ZodString>;
+        avoid: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    links: z.ZodObject<{
+        website: z.ZodString;
+        repository: z.ZodOptional<z.ZodString>;
+        documentation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+/** Structured model output before deterministic package assembly. */
+export type GeneratedBrandProfile = z.infer<typeof GeneratedBrandProfileSchema>;

package/lib/src/schema.js

@@ -0,0 +1,82 @@
+/**
+ * Model-facing profile contract and AppKit tool description for researched
+ * brand generation. Browser-safe request, event, and package contracts are
+ * owned by `@dbx-tools/shared-generator`.
+ *
+ * @module
+ */
+import { stringUtils } from "@dbx-tools/shared-core";
+import { z } from "zod";
+export { BrandGenerationErrorEventSchema, BrandGenerationEventSchema, BrandGenerationProgressEventSchema, BrandGenerationRequestSchema, BrandGenerationResultEventSchema, BrandGenerationStageSchema, BrandPackageSchema, BrandPackageSourceSchema, BrandVisualImageSchema, BrandVisualReferenceSchema, } from "@dbx-tools/shared-generator/brand";
+const nonBlankString = z.string().trim().min(1);
+const color = z.string().regex(/^#(?:[\da-f]{3}|[\da-f]{6}|[\da-f]{8})$/i, "Expected a hex color.");
+/** Resolve the human-readable subject from a validated brand request. */
+export function brandRequestSubject(request) {
+    return request.name ?? request.prompt;
+}
+/** Description shared by the native AppKit brand-generation tool. */
+export const GENERATE_BRAND_TOOL_DESCRIPTION = stringUtils.toDescription(`
+  Research a named organization or product on the web and generate a portable
+  branding package. The result includes a validated BrandContext for
+  application and email presentation plus the sources used. Supply the
+  official website when known to disambiguate brands with similar names.
+`);
+/**
+ * Structured model output before deterministic asset references and schema
+ * metadata are attached.
+ */
+export const GeneratedBrandProfileSchema = z
+    .object({
+    name: nonBlankString.describe("Canonical display name supported by the sources."),
+    shortName: nonBlankString.describe("Compact brand name suitable for constrained UI."),
+    tagline: nonBlankString.describe("Short brand line suitable for a header or metadata."),
+    description: nonBlankString.describe("Plain-language description of the brand."),
+    colors: z
+        .object({
+        primary: color.describe("Primary identity color."),
+        primaryHover: color.describe("Accessible hover or pressed color for the primary color."),
+        accent: color.describe("Secondary accent color."),
+        foreground: color.describe("Default high-contrast text and mark color."),
+        background: color.describe("Default page background."),
+        surface: color.describe("Secondary surface background."),
+        muted: color.describe("Muted text color with readable contrast."),
+        border: color.describe("Default border color."),
+    })
+        .strict()
+        .describe("Usable interface palette based on the researched identity."),
+    typography: z
+        .object({
+        sans: nonBlankString.describe("CSS font-family stack for normal interface text."),
+        mono: nonBlankString.describe("CSS font-family stack for code and tabular text."),
+    })
+        .strict()
+        .describe("Brand-compatible CSS font stacks."),
+    voice: z
+        .object({
+        audience: z
+            .array(nonBlankString)
+            .describe("Primary audiences explicitly supported by the sources."),
+        tone: z.array(nonBlankString).describe("Concise descriptors for the brand's writing tone."),
+        principles: z
+            .array(nonBlankString)
+            .describe("Concrete rules for writing in the brand voice."),
+        avoid: z.array(nonBlankString).describe("Writing patterns the brand should avoid."),
+    })
+        .strict()
+        .describe("Evidence-based writing voice guidance."),
+    links: z
+        .object({
+        website: z.string().url().describe("Official brand website."),
+        repository: z.string().url().optional().describe("Official source repository, if any."),
+        documentation: z
+            .string()
+            .url()
+            .optional()
+            .describe("Official documentation site, if distinct from the website."),
+    })
+        .strict()
+        .describe("Verified first-party brand links."),
+})
+    .strict()
+    .describe("Evidence-based brand profile produced by the synthesis model.");
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NjaGVtYS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7O0dBTUc7QUFFSCxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFckQsT0FBTyxFQUFFLENBQUMsRUFBRSxNQUFNLEtBQUssQ0FBQztBQUV4QixPQUFPLEVBQ0wsK0JBQStCLEVBQy9CLDBCQUEwQixFQUMxQixrQ0FBa0MsRUFDbEMsNEJBQTRCLEVBQzVCLGdDQUFnQyxFQUNoQywwQkFBMEIsRUFDMUIsa0JBQWtCLEVBQ2xCLHdCQUF3QixFQUN4QixzQkFBc0IsRUFDdEIsMEJBQTBCLEdBQzNCLE1BQU0sbUNBQW1DLENBQUM7QUFjM0MsTUFBTSxjQUFjLEdBQUcsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLElBQUksRUFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUNoRCxNQUFNLEtBQUssR0FBRyxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsS0FBSyxDQUFDLDBDQUEwQyxFQUFFLHVCQUF1QixDQUFDLENBQUM7QUFFcEcseUVBQXlFO0FBQ3pFLE1BQU0sVUFBVSxtQkFBbUIsQ0FBQyxPQUFxQztJQUN2RSxPQUFPLE9BQU8sQ0FBQyxJQUFJLElBQUksT0FBTyxDQUFDLE1BQU8sQ0FBQztBQUN6QyxDQUFDO0FBRUQscUVBQXFFO0FBQ3JFLE1BQU0sQ0FBQyxNQUFNLCtCQUErQixHQUFHLFdBQVcsQ0FBQyxhQUFhLENBQUM7Ozs7O0NBS3hFLENBQUMsQ0FBQztBQUVIOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLDJCQUEyQixHQUFHLENBQUM7S0FDekMsTUFBTSxDQUFDO0lBQ04sSUFBSSxFQUFFLGNBQWMsQ0FBQyxRQUFRLENBQUMsa0RBQWtELENBQUM7SUFDakYsU0FBUyxFQUFFLGNBQWMsQ0FBQyxRQUFRLENBQUMsaURBQWlELENBQUM7SUFDckYsT0FBTyxFQUFFLGNBQWMsQ0FBQyxRQUFRLENBQUMscURBQXFELENBQUM7SUFDdkYsV0FBVyxFQUFFLGNBQWMsQ0FBQyxRQUFRLENBQUMsMENBQTBDLENBQUM7SUFDaEYsTUFBTSxFQUFFLENBQUM7U0FDTixNQUFNLENBQUM7UUFDTixPQUFPLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQyx5QkFBeUIsQ0FBQztRQUNsRCxZQUFZLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQywwREFBMEQsQ0FBQztRQUN4RixNQUFNLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQyx5QkFBeUIsQ0FBQztRQUNqRCxVQUFVLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQyw0Q0FBNEMsQ0FBQztRQUN4RSxVQUFVLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQywwQkFBMEIsQ0FBQztRQUN0RCxPQUFPLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQywrQkFBK0IsQ0FBQztRQUN4RCxLQUFLLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQywwQ0FBMEMsQ0FBQztRQUNqRSxNQUFNLEVBQUUsS0FBSyxDQUFDLFFBQVEsQ0FBQyx1QkFBdUIsQ0FBQztLQUNoRCxDQUFDO1NBQ0QsTUFBTSxFQUFFO1NBQ1IsUUFBUSxDQUFDLDREQUE0RCxDQUFDO0lBQ3pFLFVBQVUsRUFBRSxDQUFDO1NBQ1YsTUFBTSxDQUFDO1FBQ04sSUFBSSxFQUFFLGNBQWMsQ0FBQyxRQUFRLENBQUMsa0RBQWtELENBQUM7UUFDakYsSUFBSSxFQUFFLGNBQWMsQ0FBQyxRQUFRLENBQUMsa0RBQWtELENBQUM7S0FDbEYsQ0FBQztTQUNELE1BQU0sRUFBRTtTQUNSLFFBQVEsQ0FBQyxtQ0FBbUMsQ0FBQztJQUNoRCxLQUFLLEVBQUUsQ0FBQztTQUNMLE1BQU0sQ0FBQztRQUNOLFFBQVEsRUFBRSxDQUFDO2FBQ1IsS0FBSyxDQUFDLGNBQWMsQ0FBQzthQUNyQixRQUFRLENBQUMsd0RBQXdELENBQUM7UUFDckUsSUFBSSxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsY0FBYyxDQUFDLENBQUMsUUFBUSxDQUFDLG1EQUFtRCxDQUFDO1FBQzNGLFVBQVUsRUFBRSxDQUFDO2FBQ1YsS0FBSyxDQUFDLGNBQWMsQ0FBQzthQUNyQixRQUFRLENBQUMsZ0RBQWdELENBQUM7UUFDN0QsS0FBSyxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsY0FBYyxDQUFDLENBQUMsUUFBUSxDQUFDLDBDQUEwQyxDQUFDO0tBQ3BGLENBQUM7U0FDRCxNQUFNLEVBQUU7U0FDUixRQUFRLENBQUMsd0NBQXdDLENBQUM7SUFDckQsS0FBSyxFQUFFLENBQUM7U0FDTCxNQUFNLENBQUM7UUFDTixPQUFPLEVBQUUsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLEdBQUcsRUFBRSxDQUFDLFFBQVEsQ0FBQyx5QkFBeUIsQ0FBQztRQUM3RCxVQUFVLEVBQUUsQ0FBQyxDQUFDLE1BQU0sRUFBRSxDQUFDLEdBQUcsRUFBRSxDQUFDLFFBQVEsRUFBRSxDQUFDLFFBQVEsQ0FBQyxxQ0FBcUMsQ0FBQztRQUN2RixhQUFhLEVBQUUsQ0FBQzthQUNiLE1BQU0sRUFBRTthQUNSLEdBQUcsRUFBRTthQUNMLFFBQVEsRUFBRTthQUNWLFFBQVEsQ0FBQyw0REFBNEQsQ0FBQztLQUMxRSxDQUFDO1NBQ0QsTUFBTSxFQUFFO1NBQ1IsUUFBUSxDQUFDLG1DQUFtQyxDQUFDO0NBQ2pELENBQUM7S0FDRCxNQUFNLEVBQUU7S0FDUixRQUFRLENBQUMsK0RBQStELENBQUMsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogTW9kZWwtZmFjaW5nIHByb2ZpbGUgY29udHJhY3QgYW5kIEFwcEtpdCB0b29sIGRlc2NyaXB0aW9uIGZvciByZXNlYXJjaGVkXG4gKiBicmFuZCBnZW5lcmF0aW9uLiBCcm93c2VyLXNhZmUgcmVxdWVzdCwgZXZlbnQsIGFuZCBwYWNrYWdlIGNvbnRyYWN0cyBhcmVcbiAqIG93bmVkIGJ5IGBAZGJ4LXRvb2xzL3NoYXJlZC1nZW5lcmF0b3JgLlxuICpcbiAqIEBtb2R1bGVcbiAqL1xuXG5pbXBvcnQgeyBzdHJpbmdVdGlscyB9IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1jb3JlXCI7XG5pbXBvcnQgdHlwZSB7IEJyYW5kR2VuZXJhdGlvblJlcXVlc3QgYXMgU2hhcmVkQnJhbmRHZW5lcmF0aW9uUmVxdWVzdCB9IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1nZW5lcmF0b3IvYnJhbmRcIjtcbmltcG9ydCB7IHogfSBmcm9tIFwiem9kXCI7XG5cbmV4cG9ydCB7XG4gIEJyYW5kR2VuZXJhdGlvbkVycm9yRXZlbnRTY2hlbWEsXG4gIEJyYW5kR2VuZXJhdGlvbkV2ZW50U2NoZW1hLFxuICBCcmFuZEdlbmVyYXRpb25Qcm9ncmVzc0V2ZW50U2NoZW1hLFxuICBCcmFuZEdlbmVyYXRpb25SZXF1ZXN0U2NoZW1hLFxuICBCcmFuZEdlbmVyYXRpb25SZXN1bHRFdmVudFNjaGVtYSxcbiAgQnJhbmRHZW5lcmF0aW9uU3RhZ2VTY2hlbWEsXG4gIEJyYW5kUGFja2FnZVNjaGVtYSxcbiAgQnJhbmRQYWNrYWdlU291cmNlU2NoZW1hLFxuICBCcmFuZFZpc3VhbEltYWdlU2NoZW1hLFxuICBCcmFuZFZpc3VhbFJlZmVyZW5jZVNjaGVtYSxcbn0gZnJvbSBcIkBkYngtdG9vbHMvc2hhcmVkLWdlbmVyYXRvci9icmFuZFwiO1xuZXhwb3J0IHR5cGUge1xuICBCcmFuZEdlbmVyYXRpb25FcnJvckV2ZW50LFxuICBCcmFuZEdlbmVyYXRpb25FdmVudCxcbiAgQnJhbmRHZW5lcmF0aW9uUHJvZ3Jlc3NFdmVudCxcbiAgQnJhbmRHZW5lcmF0aW9uUmVxdWVzdCxcbiAgQnJhbmRHZW5lcmF0aW9uUmVzdWx0RXZlbnQsXG4gIEJyYW5kR2VuZXJhdGlvblN0YWdlLFxuICBCcmFuZFBhY2thZ2UsXG4gIEJyYW5kUGFja2FnZVNvdXJjZSxcbiAgQnJhbmRWaXN1YWxJbWFnZSxcbiAgQnJhbmRWaXN1YWxSZWZlcmVuY2UsXG59IGZyb20gXCJAZGJ4LXRvb2xzL3NoYXJlZC1nZW5lcmF0b3IvYnJhbmRcIjtcblxuY29uc3Qgbm9uQmxhbmtTdHJpbmcgPSB6LnN0cmluZygpLnRyaW0oKS5taW4oMSk7XG5jb25zdCBjb2xvciA9IHouc3RyaW5nKCkucmVnZXgoL14jKD86W1xcZGEtZl17M318W1xcZGEtZl17Nn18W1xcZGEtZl17OH0pJC9pLCBcIkV4cGVjdGVkIGEgaGV4IGNvbG9yLlwiKTtcblxuLyoqIFJlc29sdmUgdGhlIGh1bWFuLXJlYWRhYmxlIHN1YmplY3QgZnJvbSBhIHZhbGlkYXRlZCBicmFuZCByZXF1ZXN0LiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGJyYW5kUmVxdWVzdFN1YmplY3QocmVxdWVzdDogU2hhcmVkQnJhbmRHZW5lcmF0aW9uUmVxdWVzdCk6IHN0cmluZyB7XG4gIHJldHVybiByZXF1ZXN0Lm5hbWUgPz8gcmVxdWVzdC5wcm9tcHQhO1xufVxuXG4vKiogRGVzY3JpcHRpb24gc2hhcmVkIGJ5IHRoZSBuYXRpdmUgQXBwS2l0IGJyYW5kLWdlbmVyYXRpb24gdG9vbC4gKi9cbmV4cG9ydCBjb25zdCBHRU5FUkFURV9CUkFORF9UT09MX0RFU0NSSVBUSU9OID0gc3RyaW5nVXRpbHMudG9EZXNjcmlwdGlvbihgXG4gIFJlc2VhcmNoIGEgbmFtZWQgb3JnYW5pemF0aW9uIG9yIHByb2R1Y3Qgb24gdGhlIHdlYiBhbmQgZ2VuZXJhdGUgYSBwb3J0YWJsZVxuICBicmFuZGluZyBwYWNrYWdlLiBUaGUgcmVzdWx0IGluY2x1ZGVzIGEgdmFsaWRhdGVkIEJyYW5kQ29udGV4dCBmb3JcbiAgYXBwbGljYXRpb24gYW5kIGVtYWlsIHByZXNlbnRhdGlvbiBwbHVzIHRoZSBzb3VyY2VzIHVzZWQuIFN1cHBseSB0aGVcbiAgb2ZmaWNpYWwgd2Vic2l0ZSB3aGVuIGtub3duIHRvIGRpc2FtYmlndWF0ZSBicmFuZHMgd2l0aCBzaW1pbGFyIG5hbWVzLlxuYCk7XG5cbi8qKlxuICogU3RydWN0dXJlZCBtb2RlbCBvdXRwdXQgYmVmb3JlIGRldGVybWluaXN0aWMgYXNzZXQgcmVmZXJlbmNlcyBhbmQgc2NoZW1hXG4gKiBtZXRhZGF0YSBhcmUgYXR0YWNoZWQuXG4gKi9cbmV4cG9ydCBjb25zdCBHZW5lcmF0ZWRCcmFuZFByb2ZpbGVTY2hlbWEgPSB6XG4gIC5vYmplY3Qoe1xuICAgIG5hbWU6IG5vbkJsYW5rU3RyaW5nLmRlc2NyaWJlKFwiQ2Fub25pY2FsIGRpc3BsYXkgbmFtZSBzdXBwb3J0ZWQgYnkgdGhlIHNvdXJjZXMuXCIpLFxuICAgIHNob3J0TmFtZTogbm9uQmxhbmtTdHJpbmcuZGVzY3JpYmUoXCJDb21wYWN0IGJyYW5kIG5hbWUgc3VpdGFibGUgZm9yIGNvbnN0cmFpbmVkIFVJLlwiKSxcbiAgICB0YWdsaW5lOiBub25CbGFua1N0cmluZy5kZXNjcmliZShcIlNob3J0IGJyYW5kIGxpbmUgc3VpdGFibGUgZm9yIGEgaGVhZGVyIG9yIG1ldGFkYXRhLlwiKSxcbiAgICBkZXNjcmlwdGlvbjogbm9uQmxhbmtTdHJpbmcuZGVzY3JpYmUoXCJQbGFpbi1sYW5ndWFnZSBkZXNjcmlwdGlvbiBvZiB0aGUgYnJhbmQuXCIpLFxuICAgIGNvbG9yczogelxuICAgICAgLm9iamVjdCh7XG4gICAgICAgIHByaW1hcnk6IGNvbG9yLmRlc2NyaWJlKFwiUHJpbWFyeSBpZGVudGl0eSBjb2xvci5cIiksXG4gICAgICAgIHByaW1hcnlIb3ZlcjogY29sb3IuZGVzY3JpYmUoXCJBY2Nlc3NpYmxlIGhvdmVyIG9yIHByZXNzZWQgY29sb3IgZm9yIHRoZSBwcmltYXJ5IGNvbG9yLlwiKSxcbiAgICAgICAgYWNjZW50OiBjb2xvci5kZXNjcmliZShcIlNlY29uZGFyeSBhY2NlbnQgY29sb3IuXCIpLFxuICAgICAgICBmb3JlZ3JvdW5kOiBjb2xvci5kZXNjcmliZShcIkRlZmF1bHQgaGlnaC1jb250cmFzdCB0ZXh0IGFuZCBtYXJrIGNvbG9yLlwiKSxcbiAgICAgICAgYmFja2dyb3VuZDogY29sb3IuZGVzY3JpYmUoXCJEZWZhdWx0IHBhZ2UgYmFja2dyb3VuZC5cIiksXG4gICAgICAgIHN1cmZhY2U6IGNvbG9yLmRlc2NyaWJlKFwiU2Vjb25kYXJ5IHN1cmZhY2UgYmFja2dyb3VuZC5cIiksXG4gICAgICAgIG11dGVkOiBjb2xvci5kZXNjcmliZShcIk11dGVkIHRleHQgY29sb3Igd2l0aCByZWFkYWJsZSBjb250cmFzdC5cIiksXG4gICAgICAgIGJvcmRlcjogY29sb3IuZGVzY3JpYmUoXCJEZWZhdWx0IGJvcmRlciBjb2xvci5cIiksXG4gICAgICB9KVxuICAgICAgLnN0cmljdCgpXG4gICAgICAuZGVzY3JpYmUoXCJVc2FibGUgaW50ZXJmYWNlIHBhbGV0dGUgYmFzZWQgb24gdGhlIHJlc2VhcmNoZWQgaWRlbnRpdHkuXCIpLFxuICAgIHR5cG9ncmFwaHk6IHpcbiAgICAgIC5vYmplY3Qoe1xuICAgICAgICBzYW5zOiBub25CbGFua1N0cmluZy5kZXNjcmliZShcIkNTUyBmb250LWZhbWlseSBzdGFjayBmb3Igbm9ybWFsIGludGVyZmFjZSB0ZXh0LlwiKSxcbiAgICAgICAgbW9ubzogbm9uQmxhbmtTdHJpbmcuZGVzY3JpYmUoXCJDU1MgZm9udC1mYW1pbHkgc3RhY2sgZm9yIGNvZGUgYW5kIHRhYnVsYXIgdGV4dC5cIiksXG4gICAgICB9KVxuICAgICAgLnN0cmljdCgpXG4gICAgICAuZGVzY3JpYmUoXCJCcmFuZC1jb21wYXRpYmxlIENTUyBmb250IHN0YWNrcy5cIiksXG4gICAgdm9pY2U6IHpcbiAgICAgIC5vYmplY3Qoe1xuICAgICAgICBhdWRpZW5jZTogelxuICAgICAgICAgIC5hcnJheShub25CbGFua1N0cmluZylcbiAgICAgICAgICAuZGVzY3JpYmUoXCJQcmltYXJ5IGF1ZGllbmNlcyBleHBsaWNpdGx5IHN1cHBvcnRlZCBieSB0aGUgc291cmNlcy5cIiksXG4gICAgICAgIHRvbmU6IHouYXJyYXkobm9uQmxhbmtTdHJpbmcpLmRlc2NyaWJlKFwiQ29uY2lzZSBkZXNjcmlwdG9ycyBmb3IgdGhlIGJyYW5kJ3Mgd3JpdGluZyB0b25lLlwiKSxcbiAgICAgICAgcHJpbmNpcGxlczogelxuICAgICAgICAgIC5hcnJheShub25CbGFua1N0cmluZylcbiAgICAgICAgICAuZGVzY3JpYmUoXCJDb25jcmV0ZSBydWxlcyBmb3Igd3JpdGluZyBpbiB0aGUgYnJhbmQgdm9pY2UuXCIpLFxuICAgICAgICBhdm9pZDogei5hcnJheShub25CbGFua1N0cmluZykuZGVzY3JpYmUoXCJXcml0aW5nIHBhdHRlcm5zIHRoZSBicmFuZCBzaG91bGQgYXZvaWQuXCIpLFxuICAgICAgfSlcbiAgICAgIC5zdHJpY3QoKVxuICAgICAgLmRlc2NyaWJlKFwiRXZpZGVuY2UtYmFzZWQgd3JpdGluZyB2b2ljZSBndWlkYW5jZS5cIiksXG4gICAgbGlua3M6IHpcbiAgICAgIC5vYmplY3Qoe1xuICAgICAgICB3ZWJzaXRlOiB6LnN0cmluZygpLnVybCgpLmRlc2NyaWJlKFwiT2ZmaWNpYWwgYnJhbmQgd2Vic2l0ZS5cIiksXG4gICAgICAgIHJlcG9zaXRvcnk6IHouc3RyaW5nKCkudXJsKCkub3B0aW9uYWwoKS5kZXNjcmliZShcIk9mZmljaWFsIHNvdXJjZSByZXBvc2l0b3J5LCBpZiBhbnkuXCIpLFxuICAgICAgICBkb2N1bWVudGF0aW9uOiB6XG4gICAgICAgICAgLnN0cmluZygpXG4gICAgICAgICAgLnVybCgpXG4gICAgICAgICAgLm9wdGlvbmFsKClcbiAgICAgICAgICAuZGVzY3JpYmUoXCJPZmZpY2lhbCBkb2N1bWVudGF0aW9uIHNpdGUsIGlmIGRpc3RpbmN0IGZyb20gdGhlIHdlYnNpdGUuXCIpLFxuICAgICAgfSlcbiAgICAgIC5zdHJpY3QoKVxuICAgICAgLmRlc2NyaWJlKFwiVmVyaWZpZWQgZmlyc3QtcGFydHkgYnJhbmQgbGlua3MuXCIpLFxuICB9KVxuICAuc3RyaWN0KClcbiAgLmRlc2NyaWJlKFwiRXZpZGVuY2UtYmFzZWQgYnJhbmQgcHJvZmlsZSBwcm9kdWNlZCBieSB0aGUgc3ludGhlc2lzIG1vZGVsLlwiKTtcblxuLyoqIFN0cnVjdHVyZWQgbW9kZWwgb3V0cHV0IGJlZm9yZSBkZXRlcm1pbmlzdGljIHBhY2thZ2UgYXNzZW1ibHkuICovXG5leHBvcnQgdHlwZSBHZW5lcmF0ZWRCcmFuZFByb2ZpbGUgPSB6LmluZmVyPHR5cGVvZiBHZW5lcmF0ZWRCcmFuZFByb2ZpbGVTY2hlbWE+O1xuIl19

package/lib/src/structured.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Mastra-backed prompt-injected structured generation.
+ *
+ * @module
+ */
+import type { WorkspaceClient } from "@databricks/appkit";
+import type { MessageListInput } from "@mastra/core/agent/message-list";
+import type { z } from "zod";
+/** Options for one isolated structured synthesis pass. */
+export interface StructuredGenerationOptions<TSchema extends z.ZodType> {
+    /** Stable operation identifier. */
+    id: string;
+    /** Trusted system instructions. */
+    instructions: string;
+    /** Data-only prompt. */
+    prompt: MessageListInput;
+    /** Zod-owned output contract. */
+    schema: TSchema;
+    /** Optional model preference. */
+    model?: string;
+    /** Explicit workspace client for standalone callers. */
+    workspaceClient?: WorkspaceClient;
+    /** External cancellation. */
+    signal?: AbortSignal;
+}
+/** Generate and validate one structured object without provider response-format APIs. */
+export declare function generateStructured<TSchema extends z.ZodType>(options: StructuredGenerationOptions<TSchema>): Promise<z.output<TSchema>>;

package/lib/src/structured.js

@@ -0,0 +1,30 @@
+/**
+ * Mastra-backed prompt-injected structured generation.
+ *
+ * @module
+ */
+import { buildModel, RESPONSES_PROVIDER_OPTIONS } from "@dbx-tools/appkit-mastra/model";
+import { Agent } from "@mastra/core/agent";
+/** Generate and validate one structured object without provider response-format APIs. */
+export async function generateStructured(options) {
+    const model = await buildModel({ modelOverride: false }, undefined, {
+        ...(options.model ? { modelId: options.model } : {}),
+        ...(options.workspaceClient ? { workspaceClient: options.workspaceClient } : {}),
+    });
+    const agent = new Agent({
+        id: options.id,
+        name: options.id,
+        instructions: options.instructions,
+        model,
+    });
+    const result = await agent.generate(options.prompt, {
+        structuredOutput: {
+            schema: options.schema,
+            jsonPromptInjection: "system",
+        },
+        providerOptions: RESPONSES_PROVIDER_OPTIONS,
+        ...(options.signal ? { abortSignal: options.signal } : {}),
+    });
+    return options.schema.parse(result.object);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RydWN0dXJlZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zdHJ1Y3R1cmVkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFHSCxPQUFPLEVBQUUsVUFBVSxFQUFFLDBCQUEwQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDeEYsT0FBTyxFQUFFLEtBQUssRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBc0IzQyx5RkFBeUY7QUFDekYsTUFBTSxDQUFDLEtBQUssVUFBVSxrQkFBa0IsQ0FDdEMsT0FBNkM7SUFFN0MsTUFBTSxLQUFLLEdBQUcsTUFBTSxVQUFVLENBQUMsRUFBRSxhQUFhLEVBQUUsS0FBSyxFQUFFLEVBQUUsU0FBUyxFQUFFO1FBQ2xFLEdBQUcsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLE9BQU8sRUFBRSxPQUFPLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUNwRCxHQUFHLENBQUMsT0FBTyxDQUFDLGVBQWUsQ0FBQyxDQUFDLENBQUMsRUFBRSxlQUFlLEVBQUUsT0FBTyxDQUFDLGVBQWUsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7S0FDakYsQ0FBQyxDQUFDO0lBQ0gsTUFBTSxLQUFLLEdBQUcsSUFBSSxLQUFLLENBQUM7UUFDdEIsRUFBRSxFQUFFLE9BQU8sQ0FBQyxFQUFFO1FBQ2QsSUFBSSxFQUFFLE9BQU8sQ0FBQyxFQUFFO1FBQ2hCLFlBQVksRUFBRSxPQUFPLENBQUMsWUFBWTtRQUNsQyxLQUFLO0tBQ04sQ0FBQyxDQUFDO0lBQ0gsTUFBTSxNQUFNLEdBQUcsTUFBTSxLQUFLLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxNQUFNLEVBQUU7UUFDbEQsZ0JBQWdCLEVBQUU7WUFDaEIsTUFBTSxFQUFFLE9BQU8sQ0FBQyxNQUFNO1lBQ3RCLG1CQUFtQixFQUFFLFFBQVE7U0FDOUI7UUFDRCxlQUFlLEVBQUUsMEJBQTBCO1FBQzNDLEdBQUcsQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFFLFdBQVcsRUFBRSxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztLQUMzRCxDQUFDLENBQUM7SUFDSCxPQUFPLE9BQU8sQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsQ0FBQztBQUM3QyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBNYXN0cmEtYmFja2VkIHByb21wdC1pbmplY3RlZCBzdHJ1Y3R1cmVkIGdlbmVyYXRpb24uXG4gKlxuICogQG1vZHVsZVxuICovXG5cbmltcG9ydCB0eXBlIHsgV29ya3NwYWNlQ2xpZW50IH0gZnJvbSBcIkBkYXRhYnJpY2tzL2FwcGtpdFwiO1xuaW1wb3J0IHsgYnVpbGRNb2RlbCwgUkVTUE9OU0VTX1BST1ZJREVSX09QVElPTlMgfSBmcm9tIFwiQGRieC10b29scy9hcHBraXQtbWFzdHJhL21vZGVsXCI7XG5pbXBvcnQgeyBBZ2VudCB9IGZyb20gXCJAbWFzdHJhL2NvcmUvYWdlbnRcIjtcbmltcG9ydCB0eXBlIHsgTWVzc2FnZUxpc3RJbnB1dCB9IGZyb20gXCJAbWFzdHJhL2NvcmUvYWdlbnQvbWVzc2FnZS1saXN0XCI7XG5pbXBvcnQgdHlwZSB7IHogfSBmcm9tIFwiem9kXCI7XG5cbi8qKiBPcHRpb25zIGZvciBvbmUgaXNvbGF0ZWQgc3RydWN0dXJlZCBzeW50aGVzaXMgcGFzcy4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU3RydWN0dXJlZEdlbmVyYXRpb25PcHRpb25zPFRTY2hlbWEgZXh0ZW5kcyB6LlpvZFR5cGU+IHtcbiAgLyoqIFN0YWJsZSBvcGVyYXRpb24gaWRlbnRpZmllci4gKi9cbiAgaWQ6IHN0cmluZztcbiAgLyoqIFRydXN0ZWQgc3lzdGVtIGluc3RydWN0aW9ucy4gKi9cbiAgaW5zdHJ1Y3Rpb25zOiBzdHJpbmc7XG4gIC8qKiBEYXRhLW9ubHkgcHJvbXB0LiAqL1xuICBwcm9tcHQ6IE1lc3NhZ2VMaXN0SW5wdXQ7XG4gIC8qKiBab2Qtb3duZWQgb3V0cHV0IGNvbnRyYWN0LiAqL1xuICBzY2hlbWE6IFRTY2hlbWE7XG4gIC8qKiBPcHRpb25hbCBtb2RlbCBwcmVmZXJlbmNlLiAqL1xuICBtb2RlbD86IHN0cmluZztcbiAgLyoqIEV4cGxpY2l0IHdvcmtzcGFjZSBjbGllbnQgZm9yIHN0YW5kYWxvbmUgY2FsbGVycy4gKi9cbiAgd29ya3NwYWNlQ2xpZW50PzogV29ya3NwYWNlQ2xpZW50O1xuICAvKiogRXh0ZXJuYWwgY2FuY2VsbGF0aW9uLiAqL1xuICBzaWduYWw/OiBBYm9ydFNpZ25hbDtcbn1cblxuLyoqIEdlbmVyYXRlIGFuZCB2YWxpZGF0ZSBvbmUgc3RydWN0dXJlZCBvYmplY3Qgd2l0aG91dCBwcm92aWRlciByZXNwb25zZS1mb3JtYXQgQVBJcy4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBnZW5lcmF0ZVN0cnVjdHVyZWQ8VFNjaGVtYSBleHRlbmRzIHouWm9kVHlwZT4oXG4gIG9wdGlvbnM6IFN0cnVjdHVyZWRHZW5lcmF0aW9uT3B0aW9uczxUU2NoZW1hPixcbik6IFByb21pc2U8ei5vdXRwdXQ8VFNjaGVtYT4+IHtcbiAgY29uc3QgbW9kZWwgPSBhd2FpdCBidWlsZE1vZGVsKHsgbW9kZWxPdmVycmlkZTogZmFsc2UgfSwgdW5kZWZpbmVkLCB7XG4gICAgLi4uKG9wdGlvbnMubW9kZWwgPyB7IG1vZGVsSWQ6IG9wdGlvbnMubW9kZWwgfSA6IHt9KSxcbiAgICAuLi4ob3B0aW9ucy53b3Jrc3BhY2VDbGllbnQgPyB7IHdvcmtzcGFjZUNsaWVudDogb3B0aW9ucy53b3Jrc3BhY2VDbGllbnQgfSA6IHt9KSxcbiAgfSk7XG4gIGNvbnN0IGFnZW50ID0gbmV3IEFnZW50KHtcbiAgICBpZDogb3B0aW9ucy5pZCxcbiAgICBuYW1lOiBvcHRpb25zLmlkLFxuICAgIGluc3RydWN0aW9uczogb3B0aW9ucy5pbnN0cnVjdGlvbnMsXG4gICAgbW9kZWwsXG4gIH0pO1xuICBjb25zdCByZXN1bHQgPSBhd2FpdCBhZ2VudC5nZW5lcmF0ZShvcHRpb25zLnByb21wdCwge1xuICAgIHN0cnVjdHVyZWRPdXRwdXQ6IHtcbiAgICAgIHNjaGVtYTogb3B0aW9ucy5zY2hlbWEsXG4gICAgICBqc29uUHJvbXB0SW5qZWN0aW9uOiBcInN5c3RlbVwiLFxuICAgIH0sXG4gICAgcHJvdmlkZXJPcHRpb25zOiBSRVNQT05TRVNfUFJPVklERVJfT1BUSU9OUyxcbiAgICAuLi4ob3B0aW9ucy5zaWduYWwgPyB7IGFib3J0U2lnbmFsOiBvcHRpb25zLnNpZ25hbCB9IDoge30pLFxuICB9KTtcbiAgcmV0dXJuIG9wdGlvbnMuc2NoZW1hLnBhcnNlKHJlc3VsdC5vYmplY3QpO1xufVxuIl19

package/lib/src/workflow.d.ts

@@ -0,0 +1,314 @@
+/**
+ * Mastra workflow composing reusable generator operations.
+ *
+ * @module
+ */
+import type { GeneratorOperations } from "./operations.ts";
+/** Operation surface consumed by the workflow and implemented by GeneratorOperations. */
+export type GeneratorWorkflowOperations = Pick<GeneratorOperations, "generateBrand" | "researchKpis" | "planData" | "provisionSchema" | "materializeData" | "createDashboard" | "createGenie">;
+/** Construction options for workflow hosts and isolated tests. */
+export interface GeneratorWorkflowOptions {
+    /** Suspend before mutations. Defaults to true. */
+    approval?: boolean;
+}
+/** Build one typed workflow over an isolated generator operation owner. */
+export declare function createGeneratorWorkflow(operations: GeneratorWorkflowOperations, options?: GeneratorWorkflowOptions): import("@mastra/core/workflows").Workflow<import("@mastra/core/workflows").DefaultEngineType, import("@mastra/core/workflows").Step<string, unknown, unknown, unknown, unknown, unknown, any, unknown>[], "generator-demo-assets", unknown, {
+    company: string;
+    purpose: string;
+    queries: string[];
+    presentation: "genie" | "dashboard";
+    rowCount: number;
+    website?: string | undefined;
+}, {
+    request: {
+        company: string;
+        purpose: string;
+        queries: string[];
+        presentation: "genie" | "dashboard";
+        rowCount: number;
+        website?: string | undefined;
+    };
+    schema: {
+        catalog: string;
+        schema: string;
+        fullName: string;
+        principal: string;
+    };
+    tables: string[];
+    brand: {
+        brand: {
+            schemaVersion: "1";
+            name: string;
+            shortName: string;
+            tagline: string;
+            description: string;
+            assets: {
+                icon: {
+                    light: string;
+                    dark?: string | undefined;
+                };
+                logo: {
+                    light: string;
+                    dark?: string | undefined;
+                };
+                favicon: string;
+            };
+            colors: {
+                primary: string;
+                primaryHover: string;
+                accent: string;
+                foreground: string;
+                background: string;
+                surface: string;
+                muted: string;
+                border: string;
+            };
+            typography: {
+                sans: string;
+                mono: string;
+            };
+            voice: {
+                audience: string[];
+                tone: string[];
+                principles: string[];
+                avoid: string[];
+            };
+            links: {
+                website: string;
+                documentation: string;
+                repository?: string | undefined;
+            };
+            extensions: Record<string, unknown>;
+        };
+        sources: {
+            url: string;
+            fetched: boolean;
+            title?: string | undefined;
+            snippet?: string | undefined;
+        }[];
+        visualReferences: {
+            platform: "android" | "ios";
+            appName: string;
+            pageUrl: string;
+            images: {
+                url: string;
+                contentType?: string | undefined;
+                localPath?: string | undefined;
+            }[];
+        }[];
+    };
+    kpiResearch: {
+        kpis: {
+            name: string;
+            label: string;
+            definition: string;
+            unit: "number" | "percent" | "duration" | "currency";
+            targetDirection: "higher" | "lower" | "neutral";
+            sourceUrls: string[];
+        }[];
+        sources: {
+            url: string;
+            fetched: boolean;
+            title?: string | undefined;
+        }[];
+    };
+    plan: {
+        table: string;
+        rowCount: number;
+        columns: ({
+            name: string;
+            generator: "id";
+            description: string;
+        } | {
+            name: string;
+            generator: "date";
+            description: string;
+            days: number;
+        } | {
+            name: string;
+            generator: "category";
+            description: string;
+            values: string[];
+        } | {
+            name: string;
+            generator: "number";
+            description: string;
+            minimum: number;
+            maximum: number;
+            decimals: number;
+        } | {
+            name: string;
+            generator: "boolean";
+            description: string;
+            trueProbability: number;
+        })[];
+        metrics: {
+            name: string;
+            label: string;
+            definition: string;
+            unit: "number" | "percent" | "duration" | "currency";
+            targetDirection: "higher" | "lower" | "neutral";
+            sourceUrls: string[];
+            aggregation: "count" | "sum" | "average";
+            column?: string | undefined;
+        }[];
+        story: string;
+        sampleQuestions: string[];
+    };
+    dashboard?: {
+        dashboardId: string;
+        companionGenie: "AUTO";
+        path?: string | undefined;
+    } | undefined;
+    genie?: {
+        spaceId: string;
+        title: string;
+    } | undefined;
+}, {
+    request: {
+        company: string;
+        purpose: string;
+        queries: string[];
+        presentation: "genie" | "dashboard";
+        rowCount: number;
+        website?: string | undefined;
+    };
+    schema: {
+        catalog: string;
+        schema: string;
+        fullName: string;
+        principal: string;
+    };
+    tables: string[];
+    brand: {
+        brand: {
+            schemaVersion: "1";
+            name: string;
+            shortName: string;
+            tagline: string;
+            description: string;
+            assets: {
+                icon: {
+                    light: string;
+                    dark?: string | undefined;
+                };
+                logo: {
+                    light: string;
+                    dark?: string | undefined;
+                };
+                favicon: string;
+            };
+            colors: {
+                primary: string;
+                primaryHover: string;
+                accent: string;
+                foreground: string;
+                background: string;
+                surface: string;
+                muted: string;
+                border: string;
+            };
+            typography: {
+                sans: string;
+                mono: string;
+            };
+            voice: {
+                audience: string[];
+                tone: string[];
+                principles: string[];
+                avoid: string[];
+            };
+            links: {
+                website: string;
+                documentation: string;
+                repository?: string | undefined;
+            };
+            extensions: Record<string, unknown>;
+        };
+        sources: {
+            url: string;
+            fetched: boolean;
+            title?: string | undefined;
+            snippet?: string | undefined;
+        }[];
+        visualReferences: {
+            platform: "android" | "ios";
+            appName: string;
+            pageUrl: string;
+            images: {
+                url: string;
+                contentType?: string | undefined;
+                localPath?: string | undefined;
+            }[];
+        }[];
+    };
+    kpiResearch: {
+        kpis: {
+            name: string;
+            label: string;
+            definition: string;
+            unit: "number" | "percent" | "duration" | "currency";
+            targetDirection: "higher" | "lower" | "neutral";
+            sourceUrls: string[];
+        }[];
+        sources: {
+            url: string;
+            fetched: boolean;
+            title?: string | undefined;
+        }[];
+    };
+    plan: {
+        table: string;
+        rowCount: number;
+        columns: ({
+            name: string;
+            generator: "id";
+            description: string;
+        } | {
+            name: string;
+            generator: "date";
+            description: string;
+            days: number;
+        } | {
+            name: string;
+            generator: "category";
+            description: string;
+            values: string[];
+        } | {
+            name: string;
+            generator: "number";
+            description: string;
+            minimum: number;
+            maximum: number;
+            decimals: number;
+        } | {
+            name: string;
+            generator: "boolean";
+            description: string;
+            trueProbability: number;
+        })[];
+        metrics: {
+            name: string;
+            label: string;
+            definition: string;
+            unit: "number" | "percent" | "duration" | "currency";
+            targetDirection: "higher" | "lower" | "neutral";
+            sourceUrls: string[];
+            aggregation: "count" | "sum" | "average";
+            column?: string | undefined;
+        }[];
+        story: string;
+        sampleQuestions: string[];
+    };
+    dashboard?: {
+        dashboardId: string;
+        companionGenie: "AUTO";
+        path?: string | undefined;
+    } | undefined;
+    genie?: {
+        spaceId: string;
+        title: string;
+    } | undefined;
+}, unknown>;
+/** Generator workflow type. */
+export type GeneratorWorkflow = ReturnType<typeof createGeneratorWorkflow>;