@wildo-ai/saas-models 1.0.1

package/dist/esm/flows-actors/tasks.actors.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.actors.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/flows-actors/tasks.actors.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAiC,iCAAiC,EAAE,uBAAuB,EAAmE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAgBvO,oBAAY,mBAAmB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;uCAOpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;uCAIpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAgBhF,oBAAY,iBAAiB;IAC3B,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,cAAc,mBAAmB;IACjC,YAAY,iBAAiB;CAC9B;AAED,eAAO,MAAM,0BAA0B,sDAErC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE7E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAqD7B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAgB7D,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAgBjD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAErG,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAmC5C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAM3F,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAQpC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/esm/flows-actors/tasks.actors.shared.schemas.js

@@ -0,0 +1,164 @@
+import { z } from "zod";
+import { ArtifactInstanceSchema } from "./flows-actors.io.shared.schemas.js";
+import { FlowsActors_Checkpoint_Schema, FlowsActors_CircuitBreaker_Status, FlowsActors_RelationshipSchema, FlowsActors_Status } from "./flows-actors.commons.shared.schemas.js";
+import { WildoError_BackendSchema } from "../errors/errors.shared.schemas.js";
+import { ExecutionContext_InitiatorIdsSchema } from "../runtime/execution-context.shared.schemas.js";
+//===============================================================
+// Actors_Memory
+// --------
+// Actors_Memory provides contextual storage for agents and tasks across
+// different time horizons: short-term (immediate context),
+// long-term (persistent knowledge), and working (active processing).
+// This enables stateful conversations, knowledge accumulation,
+// and context-aware decision making in AI-powered workflows.
+//===============================================================
+export var Actors_Memory_Scope;
+(function (Actors_Memory_Scope) {
+    Actors_Memory_Scope["SHORT_TERM"] = "short_term";
+    Actors_Memory_Scope["LONG_TERM"] = "long_term";
+    Actors_Memory_Scope["WORKING"] = "working";
+})(Actors_Memory_Scope || (Actors_Memory_Scope = {}));
+export const Actors_Memory_EntrySchema = z.object({
+    key: z.string(),
+    value: z.any(),
+    type: z.enum(["text", "json", "binary"]),
+    timestamp: z.string(),
+    expiresAt: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+export const Actors_Memory_StoreSchema = z.object({
+    entries: z.array(Actors_Memory_EntrySchema),
+    maxSize: z.number().optional(),
+    ttl: z.number().optional(),
+});
+export const Actors_Memory_ContextSchema = z.object({
+    shortTerm: Actors_Memory_StoreSchema,
+    longTerm: Actors_Memory_StoreSchema,
+    working: Actors_Memory_StoreSchema,
+});
+//===============================================================
+//  Actors_Task
+// --------
+// Actors_Tasks represent individual execution instances of flows or actors,
+// tracking their lifecycle from creation to completion. They maintain
+// execution context, budget constraints, error states, and detailed
+// history for monitoring, debugging, and cost management across
+// the distributed workflow execution environment.
+//===============================================================
+export var Actor_Task_Topics;
+(function (Actor_Task_Topics) {
+    Actor_Task_Topics["WEB_SEARCH"] = "WEB_SEARCH";
+    Actor_Task_Topics["RESEARCH"] = "RESEARCH";
+    Actor_Task_Topics["PLANNING"] = "PLANNING";
+    Actor_Task_Topics["IMPLEMENTATION"] = "IMPLEMENTATION";
+    Actor_Task_Topics["VERIFICATION"] = "VERIFICATION";
+})(Actor_Task_Topics || (Actor_Task_Topics = {}));
+export const Actors_Task_Context_Schema = z.object({});
+export const Actors_Task_Schema = z.object({
+    _id: z.string(),
+    title: z.string(),
+    description: z.string(),
+    topic: z.enum(Actor_Task_Topics),
+    status: z.enum(FlowsActors_Status),
+    initiator: ExecutionContext_InitiatorIdsSchema,
+    relationships: z.array(FlowsActors_RelationshipSchema),
+    actors: z.object({
+        // actorKind: z.enum(Actor_Role_Category), // circular dependencies
+        actorRef: z.string(),
+    }),
+    input: z.any(),
+    output: z.any().optional(),
+    memory: Actors_Memory_ContextSchema,
+    context: Actors_Task_Context_Schema,
+    artifacts: z.array(ArtifactInstanceSchema).optional(),
+    actorStates: z.object({
+        actorRef: z.string(),
+        status: z.enum(FlowsActors_Status),
+        updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+        statusChanges: z.array(z.object({
+            status: z.enum(FlowsActors_Status),
+            timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+        })),
+    }).array(),
+    errorStates: z.object({
+        circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),
+        errorItems: WildoError_BackendSchema.extend({
+            actorRef: z.string(),
+        }).array().optional(),
+        checkpointChecks: z.array(z.object({
+            checkpoint: FlowsActors_Checkpoint_Schema,
+            timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+        })),
+        availableCheckpoints: FlowsActors_Checkpoint_Schema.array().optional(),
+    }).optional(),
+    createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+    updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+    startedAt: z.string().optional(),
+    completedAt: z.string().optional(),
+});
+//===============================================================
+//  ActorsSystem_ExecutionPlan
+// --------
+// ActorsSystem_ExecutionPlans represent AI-generated execution strategies that outline
+// the steps needed to accomplish complex tasks. They provide
+// cost and duration estimates, dependency mapping, and can be
+// approved before execution, enabling predictable and controlled
+// automated workflow generation by intelligent agents.
+//===============================================================
+export const ActorsSystem_ExecutionPlan_Step_Schema = z.object({
+    _id: z.string(),
+    name: z.string().optional(),
+    description: z.string().optional(),
+    topic: z.string(),
+    relationships: z.array(FlowsActors_RelationshipSchema),
+    status: z.enum(FlowsActors_Status),
+    statusChanges: z.array(z.object({
+        status: z.enum(FlowsActors_Status),
+        timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+    })),
+    createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+    updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+});
+export const ActorsSystem_ExecutionPlan_Schema = z.object({
+    _id: z.string(),
+    goalDescription: z.string(),
+    status: z.enum(FlowsActors_Status),
+    initiator: ExecutionContext_InitiatorIdsSchema,
+    relationships: z.array(FlowsActors_RelationshipSchema),
+    planSteps: z.array(ActorsSystem_ExecutionPlan_Step_Schema),
+    stepStates: z.object({
+        planStepId: z.string(),
+        status: z.enum(FlowsActors_Status),
+        updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+        statusChanges: z.array(z.object({
+            status: z.enum(FlowsActors_Status),
+            timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+        })),
+    }).array(),
+    errorStates: z.object({
+        circuitBreakerStatus: z.enum(FlowsActors_CircuitBreaker_Status).optional(),
+        errorItems: WildoError_BackendSchema.extend({
+            planStepId: z.string(),
+        }).array().optional(),
+        checkpointChecks: z.array(z.object({
+            checkpoint: FlowsActors_Checkpoint_Schema,
+            timestamp: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+        })),
+        availableCheckpoints: FlowsActors_Checkpoint_Schema.array().optional(),
+    }).optional(),
+    createdAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+    updatedAt: z.string().refine((val) => !isNaN(Date.parse(val)), { error: 'Invalid datetime string' }),
+});
+//===============================================================
+//  Walkthrough
+//===============================================================
+export const Actors_Walkthrough_Schema = z.object({
+    _id: z.string(),
+    name: z.string(),
+    description: z.string(),
+    status: z.enum(FlowsActors_Status),
+    initiator: ExecutionContext_InitiatorIdsSchema,
+    relationships: z.array(FlowsActors_RelationshipSchema),
+    // TODO for real
+});
+//# sourceMappingURL=tasks.actors.shared.schemas.js.map

package/dist/esm/flows-actors/tasks.actors.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.actors.shared.schemas.js","sourceRoot":"","sources":["../../../src/flows-actors/tasks.actors.shared.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/flows-actors/utils/flow-actors.context-builder.apps-context.shared.utils.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flow-actors.context-builder.apps-context.shared.utils.d.ts.map

package/dist/esm/flows-actors/utils/flow-actors.context-builder.apps-context.shared.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-actors.context-builder.apps-context.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/flows-actors/utils/flow-actors.context-builder.apps-context.shared.utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC"}

package/dist/esm/flows-actors/utils/flow-actors.context-builder.apps-context.shared.utils.js

@@ -0,0 +1 @@
+//# sourceMappingURL=flow-actors.context-builder.apps-context.shared.utils.js.map

package/dist/esm/flows-actors/utils/flow-actors.context-builder.apps-context.shared.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-actors.context-builder.apps-context.shared.utils.js","sourceRoot":"","sources":["../../../../src/flows-actors/utils/flow-actors.context-builder.apps-context.shared.utils.ts"],"names":[],"mappings":""}

package/dist/esm/frontend-definitions/frontend-notification-custom-message-ref.definitions.d.ts

@@ -0,0 +1,4 @@
+export declare enum FrontendNotificationCustomMessageRefs {
+    A_TEMP_REF = "A_TEMP_REF"
+}
+//# sourceMappingURL=frontend-notification-custom-message-ref.definitions.d.ts.map

package/dist/esm/frontend-definitions/frontend-notification-custom-message-ref.definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-notification-custom-message-ref.definitions.d.ts","sourceRoot":"","sources":["../../../src/frontend-definitions/frontend-notification-custom-message-ref.definitions.ts"],"names":[],"mappings":"AAEA,oBAAY,qCAAqC;IAC/C,UAAU,eAAe;CAC1B"}

package/dist/esm/frontend-definitions/frontend-notification-custom-message-ref.definitions.js

@@ -0,0 +1,5 @@
+export var FrontendNotificationCustomMessageRefs;
+(function (FrontendNotificationCustomMessageRefs) {
+    FrontendNotificationCustomMessageRefs["A_TEMP_REF"] = "A_TEMP_REF";
+})(FrontendNotificationCustomMessageRefs || (FrontendNotificationCustomMessageRefs = {}));
+//# sourceMappingURL=frontend-notification-custom-message-ref.definitions.js.map

package/dist/esm/frontend-definitions/frontend-notification-custom-message-ref.definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontend-notification-custom-message-ref.definitions.js","sourceRoot":"","sources":["../../../src/frontend-definitions/frontend-notification-custom-message-ref.definitions.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,qCAEX;AAFD,WAAY,qCAAqC;IAC/C,kEAAyB,CAAA;AAC3B,CAAC,EAFW,qCAAqC,KAArC,qCAAqC,QAEhD"}

package/dist/esm/guidance/guidance-flow.shared.schemas.d.ts

@@ -0,0 +1,287 @@
+import { z } from 'zod';
+import { OnboardingElementType } from '../config/frontend/onboarding.shared.schemas.js';
+import { CoreResourceType } from '../resources/resources.shared.core.definitions.js';
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Render Modes
+ * ────────────────────────────────────────────────────────────── */
+export declare enum GuidanceRenderMode {
+    /** Modal, banner, announcement — rendered on top of the current view */
+    OVERLAY = "overlay",
+    /** Tooltip, spotlight — attached to DOM elements in the current view */
+    INLINE = "inline",
+    /** Floating checklist panel — persistent sidebar/widget */
+    CHECKLIST = "checklist"
+}
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Scope
+ * ────────────────────────────────────────────────────────────── */
+/** Which scope resource stores this flow's state */
+export declare enum GuidanceFlowScope {
+    /** State stored in USER_GUIDANCE_STATE — personal flows (default) */
+    USER = "user",
+    /** State stored in ORGANIZATION_GUIDANCE_STATE — org-wide flows (completion shared across members) */
+    ORGANIZATION = "organization"
+}
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Audience
+ * ────────────────────────────────────────────────────────────── */
+/** Audience targeting — who sees this flow */
+export declare const GuidanceAudienceSchema: z.ZodObject<{
+    roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+        features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        mode: z.ZodOptional<z.ZodEnum<{
+            OR: "OR";
+            AND: "AND";
+        }>>;
+        limitChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            featureId: z.ZodString;
+            increment: z.ZodOptional<z.ZodNumber>;
+            countingOverride: z.ZodOptional<z.ZodObject<{
+                resourceType: z.ZodString;
+                filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                aggregate: z.ZodOptional<z.ZodObject<{
+                    field: z.ZodString;
+                    operation: z.ZodEnum<typeof import("../index.js").AggregationOperation>;
+                }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip, core.$ZodObjectExtra>>;
+        }, z.core.$strip, core.$ZodObjectExtra>>>;
+    }, z.core.$strip, core.$ZodObjectExtra>]>>;
+    excludeIfCompleted: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    createdAfter: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type GuidanceAudience = z.infer<typeof GuidanceAudienceSchema>;
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Definition
+ * ────────────────────────────────────────────────────────────── */
+/** GuidanceFlowDefinition — declarative flow configuration */
+export declare const GuidanceFlowDefinitionSchema: z.ZodObject<{
+    ref: z.ZodString;
+    scope: z.ZodDefault<z.ZodEnum<typeof GuidanceFlowScope>>;
+    renderMode: z.ZodEnum<typeof GuidanceRenderMode>;
+    trigger: z.ZodObject<{
+        type: z.ZodDefault<z.ZodEnum<{
+            readonly FIRST_VISIT: "first-visit";
+            readonly ROUTE_MATCH: "route-match";
+            readonly EVENT: "event";
+            readonly MANUAL: "manual";
+            readonly DELAYED: "delayed";
+        }>>;
+        routePattern: z.ZodOptional<z.ZodString>;
+        eventName: z.ZodOptional<z.ZodString>;
+        delayMs: z.ZodOptional<z.ZodNumber>;
+        conditions: z.ZodOptional<z.ZodObject<{
+            newUsersOnly: z.ZodDefault<z.ZodBoolean>;
+            triggerOnce: z.ZodDefault<z.ZodBoolean>;
+            requiredRoles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip, core.$ZodObjectExtra>>;
+    }, z.core.$strip, core.$ZodObjectExtra>;
+    audience: z.ZodOptional<z.ZodObject<{
+        roles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        requiredFeatures: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodObject<{
+            features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            mode: z.ZodOptional<z.ZodEnum<{
+                OR: "OR";
+                AND: "AND";
+            }>>;
+            limitChecks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                featureId: z.ZodString;
+                increment: z.ZodOptional<z.ZodNumber>;
+                countingOverride: z.ZodOptional<z.ZodObject<{
+                    resourceType: z.ZodString;
+                    filter: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    aggregate: z.ZodOptional<z.ZodObject<{
+                        field: z.ZodString;
+                        operation: z.ZodEnum<typeof import("../index.js").AggregationOperation>;
+                    }, z.core.$strip, core.$ZodObjectExtra>>;
+                }, z.core.$strip, core.$ZodObjectExtra>>;
+            }, z.core.$strip, core.$ZodObjectExtra>>>;
+        }, z.core.$strip, core.$ZodObjectExtra>]>>;
+        excludeIfCompleted: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        createdAfter: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    elements: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        showProgress: z.ZodDefault<z.ZodBoolean>;
+        type: z.ZodLiteral<OnboardingElementType.CHECKLIST>;
+        items: z.ZodArray<z.ZodString>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        actionLabel: z.ZodOptional<z.ZodString>;
+        actionRef: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<OnboardingElementType.CHECKLIST_ITEM>;
+        completed: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            order: z.ZodNumber;
+            placement: z.ZodDefault<z.ZodEnum<typeof import("../index.js").TourStepPlacement>>;
+            targetSelector: z.ZodOptional<z.ZodString>;
+            targetField: z.ZodOptional<z.ZodString>;
+            content: z.ZodOptional<z.ZodString>;
+            imageUrl: z.ZodOptional<z.ZodURL>;
+            videoUrl: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strip, core.$ZodObjectExtra>>>;
+        autoStart: z.ZodDefault<z.ZodBoolean>;
+        allowSkip: z.ZodDefault<z.ZodBoolean>;
+        type: z.ZodLiteral<OnboardingElementType.TOUR>;
+        currentStepIndex: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        targetSelector: z.ZodString;
+        placement: z.ZodDefault<z.ZodEnum<typeof import("../index.js").TourStepPlacement>>;
+        content: z.ZodString;
+        showOnce: z.ZodDefault<z.ZodBoolean>;
+        type: z.ZodLiteral<OnboardingElementType.TOOLTIP>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        imageUrl: z.ZodOptional<z.ZodURL>;
+        videoUrl: z.ZodOptional<z.ZodURL>;
+        ctaText: z.ZodOptional<z.ZodString>;
+        ctaAction: z.ZodOptional<z.ZodString>;
+        dismissible: z.ZodDefault<z.ZodBoolean>;
+        type: z.ZodLiteral<OnboardingElementType.MODAL>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        variant: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingVariant>>;
+        dismissible: z.ZodDefault<z.ZodBoolean>;
+        position: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingBannerPosition>>;
+        actionLabel: z.ZodOptional<z.ZodString>;
+        actionRef: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<OnboardingElementType.BANNER>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        variant: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingVariant>>;
+        dismissible: z.ZodDefault<z.ZodBoolean>;
+        icon: z.ZodOptional<z.ZodString>;
+        actionLabel: z.ZodOptional<z.ZodString>;
+        actionRef: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<OnboardingElementType.ANNOUNCEMENT>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        content: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        variant: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingBadgeVariant>>;
+        color: z.ZodOptional<z.ZodString>;
+        unlocked: z.ZodDefault<z.ZodBoolean>;
+        actionLabel: z.ZodOptional<z.ZodString>;
+        actionRef: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<OnboardingElementType.BADGE>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        icon: z.ZodOptional<z.ZodString>;
+        imageUrl: z.ZodOptional<z.ZodURL>;
+        variant: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingCardVariant>>;
+        actionLabel: z.ZodOptional<z.ZodString>;
+        actionRef: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<OnboardingElementType.CARD>;
+    }, z.core.$strip, core.$ZodObjectExtra>, z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodDefault<z.ZodEnum<typeof import("../index.js").OnboardingStatus>>;
+        order: z.ZodNumber;
+        targetField: z.ZodOptional<z.ZodString>;
+        questions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            question: z.ZodString;
+            type: z.ZodEnum<typeof import("../index.js").OnboardingSurveyQuestionType>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                ref: z.ZodString;
+                value: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip, core.$ZodObjectExtra>>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip, core.$ZodObjectExtra>>>;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        allowSkip: z.ZodDefault<z.ZodBoolean>;
+        type: z.ZodLiteral<OnboardingElementType.SURVEY>;
+    }, z.core.$strip, core.$ZodObjectExtra>], "type">>;
+    options: z.ZodOptional<z.ZodObject<{
+        showProgress: z.ZodDefault<z.ZodBoolean>;
+        allowDismiss: z.ZodDefault<z.ZodBoolean>;
+        persistState: z.ZodDefault<z.ZodBoolean>;
+        autoStart: z.ZodDefault<z.ZodBoolean>;
+        allowSkip: z.ZodDefault<z.ZodBoolean>;
+        className: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+    labels: z.ZodOptional<z.ZodObject<{
+        description: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip, core.$ZodObjectExtra>>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type GuidanceFlowDefinition = z.infer<typeof GuidanceFlowDefinitionSchema>;
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Reference
+ * ────────────────────────────────────────────────────────────── */
+/** Lightweight reference for toggling/prioritizing flows without repeating the full definition */
+export declare const GuidanceFlowReferenceSchema: z.ZodObject<{
+    ref: z.ZodString;
+    priority: z.ZodOptional<z.ZodNumber>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type GuidanceFlowReference = z.infer<typeof GuidanceFlowReferenceSchema>;
+/** ──────────────────────────────────────────────────────────────
+ * Guidance — Scope to Resource Mapping
+ * ────────────────────────────────────────────────────────────── */
+/** Maps GuidanceFlowScope to the CoreResourceType that stores its state */
+export declare const GUIDANCE_SCOPE_TO_RESOURCE: Record<GuidanceFlowScope, CoreResourceType>;
+/** ──────────────────────────────────────────────────────────────
+ * Guidance — Per-Element-Type i18n Field Map
+ * ────────────────────────────────────────────────────────────── */
+/** Controls which i18n keys are generated per element type.
+ *  Follows the ERROR_GUIDANCE_REFS pattern — avoids wasteful cartesian product generation. */
+export declare const GUIDANCE_ELEMENT_FIELDS: Record<OnboardingElementType, string[]>;
+//# sourceMappingURL=guidance-flow.shared.schemas.d.ts.map

package/dist/esm/guidance/guidance-flow.shared.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-flow.shared.schemas.d.ts","sourceRoot":"","sources":["../../../src/guidance/guidance-flow.shared.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAoD,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAGvI,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAElF;;oEAEoE;AAEpE,oBAAY,kBAAkB;IAC5B,wEAAwE;IACxE,OAAO,YAAY;IACnB,wEAAwE;IACxE,MAAM,WAAW;IACjB,2DAA2D;IAC3D,SAAS,cAAc;CACxB;AAED;;oEAEoE;AAEpE,oDAAoD;AACpD,oBAAY,iBAAiB;IAC3B,qEAAqE;IACrE,IAAI,SAAS;IACb,sGAAsG;IACtG,YAAY,iBAAiB;CAC9B;AAED;;oEAEoE;AAEpE,8CAA8C;AAC9C,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;uCASjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;oEAEoE;AAEpE,8DAA8D;AAC9D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAuBvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;oEAEoE;AAEpE,kGAAkG;AAClG,eAAO,MAAM,2BAA2B;;;;uCAItC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;oEAEoE;AAEpE,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAGlF,CAAC;AAEF;;oEAEoE;AAEpE;8FAC8F;AAC9F,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,qBAAqB,EAAE,MAAM,EAAE,CAW3E,CAAC"}

package/dist/esm/guidance/guidance-flow.shared.schemas.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+import { OnboardingTriggerSchema, OnboardingElementSchema, OnboardingElementType } from '../config/frontend/onboarding.shared.schemas.js';
+import { OnboardingViewOptionsSchema } from '../config/frontend/onboarding.shared.schemas.js';
+import { RequiredFeaturesConfigSchema } from '../features/feature-definition.shared.schemas.js';
+import { CoreResourceType } from '../resources/resources.shared.core.definitions.js';
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Render Modes
+ * ────────────────────────────────────────────────────────────── */
+export var GuidanceRenderMode;
+(function (GuidanceRenderMode) {
+    /** Modal, banner, announcement — rendered on top of the current view */
+    GuidanceRenderMode["OVERLAY"] = "overlay";
+    /** Tooltip, spotlight — attached to DOM elements in the current view */
+    GuidanceRenderMode["INLINE"] = "inline";
+    /** Floating checklist panel — persistent sidebar/widget */
+    GuidanceRenderMode["CHECKLIST"] = "checklist";
+})(GuidanceRenderMode || (GuidanceRenderMode = {}));
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Scope
+ * ────────────────────────────────────────────────────────────── */
+/** Which scope resource stores this flow's state */
+export var GuidanceFlowScope;
+(function (GuidanceFlowScope) {
+    /** State stored in USER_GUIDANCE_STATE — personal flows (default) */
+    GuidanceFlowScope["USER"] = "user";
+    /** State stored in ORGANIZATION_GUIDANCE_STATE — org-wide flows (completion shared across members) */
+    GuidanceFlowScope["ORGANIZATION"] = "organization";
+})(GuidanceFlowScope || (GuidanceFlowScope = {}));
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Audience
+ * ────────────────────────────────────────────────────────────── */
+/** Audience targeting — who sees this flow */
+export const GuidanceAudienceSchema = z.object({
+    /** Required user roles (any match = eligible). Empty/omitted = all roles. */
+    roles: z.array(z.string()).optional(),
+    /** Required features using the shared `RequiredFeaturesConfig` semantics. */
+    requiredFeatures: RequiredFeaturesConfigSchema.optional(),
+    /** Exclude users who have completed these flows */
+    excludeIfCompleted: z.array(z.string()).optional(),
+    /** Only show to users created after this date (for new-user flows) */
+    createdAfter: z.coerce.date().optional(),
+});
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Definition
+ * ────────────────────────────────────────────────────────────── */
+/** GuidanceFlowDefinition — declarative flow configuration */
+export const GuidanceFlowDefinitionSchema = z.object({
+    /** Unique flow reference (e.g., 'welcome-tour', 'org-setup-wizard') */
+    ref: z.string().min(1),
+    /** State scope — determines which resource stores this flow's state.
+     *  USER (default): personal guidance, each user has their own state.
+     *  ORGANIZATION: org-wide guidance, shared across all members. */
+    scope: z.enum(GuidanceFlowScope).default(GuidanceFlowScope.USER),
+    /** Rendering mode */
+    renderMode: z.enum(GuidanceRenderMode),
+    /** When/how to activate this flow */
+    trigger: OnboardingTriggerSchema,
+    /** Audience targeting */
+    audience: GuidanceAudienceSchema.optional(),
+    /** Priority for ordering when multiple flows are eligible (lower = higher priority) */
+    priority: z.number().int().default(100),
+    /** Elements in this flow — reuses existing OnboardingElement discriminated union */
+    elements: z.array(OnboardingElementSchema),
+    /** Flow-level options */
+    options: OnboardingViewOptionsSchema.optional(),
+    /** i18n: label configuration */
+    labels: z.object({
+        description: z.boolean().default(false),
+    }).optional(),
+});
+/** ──────────────────────────────────────────────────────────────
+ * Guidance Flow — Reference
+ * ────────────────────────────────────────────────────────────── */
+/** Lightweight reference for toggling/prioritizing flows without repeating the full definition */
+export const GuidanceFlowReferenceSchema = z.object({
+    ref: z.string().min(1),
+    priority: z.number().int().optional(),
+    enabled: z.boolean().default(true),
+});
+/** ──────────────────────────────────────────────────────────────
+ * Guidance — Scope to Resource Mapping
+ * ────────────────────────────────────────────────────────────── */
+/** Maps GuidanceFlowScope to the CoreResourceType that stores its state */
+export const GUIDANCE_SCOPE_TO_RESOURCE = {
+    [GuidanceFlowScope.USER]: CoreResourceType.USER_GUIDANCE_STATE,
+    [GuidanceFlowScope.ORGANIZATION]: CoreResourceType.ORGANIZATION_GUIDANCE_STATE,
+};
+/** ──────────────────────────────────────────────────────────────
+ * Guidance — Per-Element-Type i18n Field Map
+ * ────────────────────────────────────────────────────────────── */
+/** Controls which i18n keys are generated per element type.
+ *  Follows the ERROR_GUIDANCE_REFS pattern — avoids wasteful cartesian product generation. */
+export const GUIDANCE_ELEMENT_FIELDS = {
+    [OnboardingElementType.CHECKLIST]: ['title', 'description'],
+    [OnboardingElementType.CHECKLIST_ITEM]: ['title', 'description', 'actionLabel'],
+    [OnboardingElementType.TOUR]: ['title', 'description'],
+    [OnboardingElementType.TOOLTIP]: ['title', 'description', 'content'],
+    [OnboardingElementType.MODAL]: ['title', 'description', 'content', 'actionLabel'],
+    [OnboardingElementType.BANNER]: ['title', 'description', 'content', 'actionLabel'],
+    [OnboardingElementType.ANNOUNCEMENT]: ['title', 'description', 'content', 'actionLabel'],
+    [OnboardingElementType.BADGE]: ['title', 'content'],
+    [OnboardingElementType.CARD]: ['title', 'description', 'content', 'actionLabel'],
+    [OnboardingElementType.SURVEY]: ['title', 'description'],
+};
+//# sourceMappingURL=guidance-flow.shared.schemas.js.map

package/dist/esm/guidance/guidance-flow.shared.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-flow.shared.schemas.js","sourceRoot":"","sources":["../../../src/guidance/guidance-flow.shared.schemas.ts"],"names":[],"mappings":"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"}