@usenaive-sdk/blueprints 0.8.0 → 0.10.0

package/dist/index.d.ts

@@ -5,9 +5,10 @@ import { VettaClient } from '@usenaive-sdk/vetta';
  * Blueprints and their templates.
  *
  * A **blueprint** is the machine: screens, `/api/*`, the store, build and deploy, the approval
- * flow. It is one repository, and it is shared across its templates. A **template** is DATA — the
- * crew and its prompts, the tool allow-lists, the kinds of work it files, its schedules, the demo
- * seed and the words its screens print. One repo carries every template its blueprint has, so
+ * flow — or, for a data-only blueprint, none of those. It is one repository, and it is shared across
+ * its templates. A **template** is DATA — the crew and its prompts, the tool allow-lists and its
+ * schedules. What a blueprint's own screens print per template is the blueprint's business, and
+ * the engine never reads it (ADR-0903). One repo carries every template its blueprint has, so
  * switching is an edit plus `naive up`: never a re-clone, never a new app.
  *
  * The pair is checked here and refused at define time (`define.ts`), in the author's own
@@ -15,12 +16,6 @@ import { VettaClient } from '@usenaive-sdk/vetta';
  * discovered against a half-provisioned organization.
  */
 
-/** One kind of work a template files — a deliverable kind, a post kind. `id` is what rows carry. */
-interface TemplateKind {
-    id: string;
-    label: string;
-    description?: string;
-}
 /**
  * The data module a blueprint repo exports, one per template it carries. Everything here is data:
  * nothing in it is a function, a component or a route, because those are the blueprint's and are
@@ -33,12 +28,6 @@ interface Template {
     /** One line for the operator: what this crew does. */
     description: string;
     agents: AgentDecl[];
-    /** The kinds this template's queue holds; the screens list them in this order. */
-    kinds: TemplateKind[];
-    /** The demo rows the store seeds on first run, keyed by collection (`clients`, `posts`, …). */
-    seed: Record<string, unknown>;
-    /** Every word a screen prints that changes with the template — headings, labels, onboarding copy. */
-    words: Record<string, string>;
 }
 /**
  * Every blueprint and the templates it carries. `agency` defaults to `blank` — a working agency
@@ -115,9 +104,9 @@ declare const AgentDeclSchema: z.ZodObject<{
         cap_micro_usd: z.ZodNumber;
         max_task_micro_usd: z.ZodNumber;
         period: z.ZodEnum<{
+            month: "month";
             day: "day";
             week: "week";
-            month: "month";
         }>;
     }, z.core.$strip>;
     description: z.ZodOptional<z.ZodString>;
@@ -128,16 +117,16 @@ declare const AgentDeclSchema: z.ZodObject<{
         default_config: z.ZodObject<{
             permission: z.ZodEnum<{
                 allow: "allow";
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
         }, z.core.$strip>;
         configs: z.ZodRecord<z.ZodString, z.ZodObject<{
             enabled: z.ZodBoolean;
             permission: z.ZodEnum<{
                 allow: "allow";
-                ask: "ask";
                 deny: "deny";
+                ask: "ask";
             }>;
             config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strip>>;
@@ -231,33 +220,9 @@ declare const SkillDeclSchema: z.ZodObject<{
     slug: z.ZodString;
     file: z.ZodString;
 }, z.core.$strip>;
-/**
- * `connections` is the accounts the studio asks an operator to connect to this persona BEFORE the
- * crew exists (`canonical-spec §31.10`): `social.from` names a declared `choice` question and
- * `social.map` maps its option labels to publishing networks. Published on the artifact, never read
- * by the apply.
- */
 declare const IdentityDeclSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     name: z.ZodString;
-    connections: z.ZodOptional<z.ZodObject<{
-        social: z.ZodOptional<z.ZodObject<{
-            from: z.ZodString;
-            map: z.ZodRecord<z.ZodString, z.ZodEnum<{
-                bluesky: "bluesky";
-                facebook: "facebook";
-                instagram: "instagram";
-                linkedin: "linkedin";
-                mastodon: "mastodon";
-                pinterest: "pinterest";
-                reddit: "reddit";
-                threads: "threads";
-                tiktok: "tiktok";
-                x: "x";
-                youtube: "youtube";
-            }>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>>;
     legal: z.ZodOptional<z.ZodArray<z.ZodObject<{
         description: z.ZodString;
         state: z.ZodEnum<{
@@ -360,6 +325,230 @@ declare const ProjectSchema: z.ZodObject<{
     name: z.ZodString;
     blueprint: z.ZodOptional<z.ZodString>;
     template: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    platforms: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        bluesky: "bluesky";
+        facebook: "facebook";
+        instagram: "instagram";
+        linkedin: "linkedin";
+        mastodon: "mastodon";
+        pinterest: "pinterest";
+        reddit: "reddit";
+        threads: "threads";
+        tiktok: "tiktok";
+        x: "x";
+        youtube: "youtube";
+    }>>>;
+    mini_apps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        slug: z.ZodString;
+        name: z.ZodString;
+        icon: z.ZodEnum<{
+            calendar: "calendar";
+            grid: "grid";
+            list: "list";
+            chart: "chart";
+            play: "play";
+        }>;
+        pages: z.ZodArray<z.ZodObject<{
+            slug: z.ZodString;
+            title: z.ZodString;
+            spec: z.ZodObject<{
+                root: z.ZodString;
+                elements: z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"Page">;
+                    props: z.ZodObject<{}, z.core.$strict>;
+                    children: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Section">;
+                    props: z.ZodObject<{
+                        title: z.ZodString;
+                        to: z.ZodOptional<z.ZodString>;
+                        hide_empty: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>;
+                    children: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Stack">;
+                    props: z.ZodObject<{}, z.core.$strict>;
+                    children: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Grid">;
+                    props: z.ZodObject<{
+                        columns: z.ZodLiteral<2 | 1 | 3>;
+                    }, z.core.$strict>;
+                    children: z.ZodArray<z.ZodString>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Metric">;
+                    props: z.ZodObject<{
+                        label: z.ZodString;
+                        value: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                views_total: "views_total";
+                                spend_total: "spend_total";
+                            }>;
+                            days: z.ZodDefault<z.ZodNumber>;
+                        }, z.core.$strict>;
+                        delta: z.ZodOptional<z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                views_change: "views_change";
+                            }>;
+                        }, z.core.$strict>>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"LineChart">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        series: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                spend_by_day: "spend_by_day";
+                            }>;
+                            days: z.ZodDefault<z.ZodNumber>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"BarList">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        bars: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                post_views: "post_views";
+                            }>;
+                            limit: z.ZodDefault<z.ZodNumber>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Progress">;
+                    props: z.ZodObject<{
+                        label: z.ZodString;
+                        progress: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                posts_this_week: "posts_this_week";
+                            }>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Roadmap">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        board: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                roadmap: "roadmap";
+                            }>;
+                            per_group: z.ZodDefault<z.ZodNumber>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Schedule">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        week: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                schedule: "schedule";
+                            }>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Media">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        files: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                latest_media: "latest_media";
+                                newest_media: "newest_media";
+                            }>;
+                            count: z.ZodDefault<z.ZodNumber>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Text">;
+                    props: z.ZodObject<{
+                        text: z.ZodString;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Needs">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        needs: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                needs: "needs";
+                            }>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Activity">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        agents: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                agents_activity: "agents_activity";
+                            }>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Accounts">;
+                    props: z.ZodObject<{
+                        accounts: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                accounts: "accounts";
+                            }>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Posts">;
+                    props: z.ZodObject<{
+                        label: z.ZodOptional<z.ZodString>;
+                        layout: z.ZodOptional<z.ZodEnum<{
+                            grid: "grid";
+                            list: "list";
+                            row: "row";
+                        }>>;
+                        posts: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                posts: "posts";
+                            }>;
+                            status: z.ZodUnion<readonly [z.ZodEnum<{
+                                scheduled: "scheduled";
+                                posted: "posted";
+                                waiting: "waiting";
+                            }>, z.ZodArray<z.ZodEnum<{
+                                scheduled: "scheduled";
+                                posted: "posted";
+                                waiting: "waiting";
+                            }>>]>;
+                            limit: z.ZodDefault<z.ZodNumber>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"Answers">;
+                    props: z.ZodObject<{
+                        answers: z.ZodObject<{
+                            $source: z.ZodEnum<{
+                                answers: "answers";
+                            }>;
+                            keys: z.ZodArray<z.ZodString>;
+                        }, z.core.$strict>;
+                    }, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>, z.ZodObject<{
+                    type: z.ZodLiteral<"MediaLibrary">;
+                    props: z.ZodObject<{}, z.core.$strict>;
+                    children: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>], "type">>;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>>;
     questions: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"text">;
         placeholder: z.ZodOptional<z.ZodString>;
@@ -372,6 +561,18 @@ declare const ProjectSchema: z.ZodObject<{
         options: z.ZodArray<z.ZodString>;
         multiple: z.ZodDefault<z.ZodBoolean>;
         other: z.ZodDefault<z.ZodBoolean>;
+        details: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            option: z.ZodString;
+            note: z.ZodOptional<z.ZodString>;
+            image: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        key: z.ZodString;
+        label: z.ZodString;
+        help: z.ZodOptional<z.ZodString>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"media">;
+        placeholder: z.ZodOptional<z.ZodString>;
         key: z.ZodString;
         label: z.ZodString;
         help: z.ZodOptional<z.ZodString>;
@@ -384,24 +585,6 @@ declare const ProjectSchema: z.ZodObject<{
     identities: z.ZodDefault<z.ZodArray<z.ZodObject<{
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         name: z.ZodString;
-        connections: z.ZodOptional<z.ZodObject<{
-            social: z.ZodOptional<z.ZodObject<{
-                from: z.ZodString;
-                map: z.ZodRecord<z.ZodString, z.ZodEnum<{
-                    bluesky: "bluesky";
-                    facebook: "facebook";
-                    instagram: "instagram";
-                    linkedin: "linkedin";
-                    mastodon: "mastodon";
-                    pinterest: "pinterest";
-                    reddit: "reddit";
-                    threads: "threads";
-                    tiktok: "tiktok";
-                    x: "x";
-                    youtube: "youtube";
-                }>>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>>;
         legal: z.ZodOptional<z.ZodArray<z.ZodObject<{
             description: z.ZodString;
             state: z.ZodEnum<{
@@ -532,9 +715,9 @@ declare const ProjectSchema: z.ZodObject<{
             cap_micro_usd: z.ZodNumber;
             max_task_micro_usd: z.ZodNumber;
             period: z.ZodEnum<{
+                month: "month";
                 day: "day";
                 week: "week";
-                month: "month";
             }>;
         }, z.core.$strip>;
         description: z.ZodOptional<z.ZodString>;
@@ -545,16 +728,16 @@ declare const ProjectSchema: z.ZodObject<{
             default_config: z.ZodObject<{
                 permission: z.ZodEnum<{
                     allow: "allow";
-                    ask: "ask";
                     deny: "deny";
+                    ask: "ask";
                 }>;
             }, z.core.$strip>;
             configs: z.ZodRecord<z.ZodString, z.ZodObject<{
                 enabled: z.ZodBoolean;
                 permission: z.ZodEnum<{
                     allow: "allow";
-                    ask: "ask";
                     deny: "deny";
+                    ask: "ask";
                 }>;
                 config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             }, z.core.$strip>>;
@@ -674,10 +857,10 @@ declare function defineProject({ templates, ...input }: DefineInput): Readonly<P
  * names unchanged, so nothing downstream of it learns a second word for the same thing.
  */
 declare const ResourceActionSchema: z.ZodEnum<{
+    deleted: "deleted";
     created: "created";
     updated: "updated";
     unchanged: "unchanged";
-    deleted: "deleted";
     refused: "refused";
 }>;
 type ResourceAction = z.infer<typeof ResourceActionSchema>;
@@ -685,10 +868,10 @@ type ResourceAction = z.infer<typeof ResourceActionSchema>;
 declare const ResourceReportSchema: z.ZodObject<{
     name: z.ZodString;
     action: z.ZodEnum<{
+        deleted: "deleted";
         created: "created";
         updated: "updated";
         unchanged: "unchanged";
-        deleted: "deleted";
         refused: "refused";
     }>;
     id: z.ZodOptional<z.ZodString>;
@@ -1017,6 +1200,13 @@ interface UpOptions {
      * applied install lands on the row that exists.
      */
     project?: string;
+    /**
+     * An install that shares the organization by its own names (ADR-1104, `scoped.ts`): its crew is
+     * filed under `project` rather than the template, and an identity is stamped with `project` and
+     * adopted only when it already carries it — another project's persona, or one nobody stamped, is
+     * refused rather than taken. Absent is every apply before that rule, exactly as it was.
+     */
+    isolated?: boolean;
     /**
      * What dials an app's own address before its crew is briefed (`awaitServing`). The platform's
      * `fetch` by default; a test hands in a fake. It is NOT the client's `fetch`, which on a hosted
@@ -1033,6 +1223,28 @@ declare function selectCrew(config: Readonly<ProjectConfig>, select: BlueprintSe
 /** Plan → apply → report. Every refusal is one line in the report, never a thrown escape. */
 declare function up(config: Readonly<ProjectConfig>, client: VettaClient, opts?: UpOptions): Promise<UpReport>;
 
+/**
+ * ONE TEMPLATE, TWICE IN ONE ORGANIZATION (`canonical-spec §29.6`, ADR-1104).
+ *
+ * Everything `up()` provisions is keyed by name in the organization, and ADR-0785 refuses a name
+ * another project holds — so a second install of a template found every agent taken and hired no
+ * one. An install that must share the organization with those names takes its own: every agent,
+ * app, identity and vault name, and every reference to one, starts with the install's prefix. The
+ * API decides the prefix once, when the install row is created, and passes it here on every apply.
+ *
+ * `config.name` becomes the install's `project`, so app ownership (ADR-0375), `NAIVE_PROJECT` and
+ * the board's card keys (`<project>:<key>`) are the install's own and never another install's.
+ *
+ * Prose is not rewritten. A system prompt that says "hand the script to the editor" still says it;
+ * the agent is told, in one generated line at the end of its `system`, what each name is here.
+ */
+
+/**
+ * The config an install with `prefix` applies. `""` renames nothing and only files it under `project`.
+ * Skills stay shared by slug, so no install's `removed` deletes one another install's crew runs.
+ */
+declare function scoped(config: Readonly<ProjectConfig>, prefix: string, project: string): ProjectConfig;
+
 /**
  * Agents in `naive up`: upsert by name with a drift-only PATCH, `allowed_apps` names resolved to
  * app ids in the `apps` tool config (§29.3), the platform config passthrough (`system`, `skills`,
@@ -1061,4 +1273,4 @@ declare function up(config: Readonly<ProjectConfig>, client: VettaClient, opts?:
  */
 declare const PROJECT_CONTEXT_PREAMBLE: string;
 
-export { type AgentDecl, type AppDecl, BLUEPRINTS, BlueprintRefusal, CONFIG_CANDIDATES, type ConfigLoad, type CredentialDecl, type CrewPerClientDecl, type DefineInput, type FileSource, type IdentityDecl, type MigrationFile, PLATFORM_ENV, PROJECT_CONTEXT_PREAMBLE, type PlatformEnv, type ProjectConfig, type ResourceAction, type ResourceReport, type ScheduleDecl, type SkillDecl, type TaskDecl, type Template, type TemplateChoice, type TemplateKind, type UpOptions, type UpReport, type VaultDecl, chooseTemplate, collectFiles, contentHash, defineProject, generatedPassword, generatedSecret, hasRoster, loadConfig, migrationFiles, parseProject, selectCrew, up };
+export { type AgentDecl, type AppDecl, BLUEPRINTS, BlueprintRefusal, CONFIG_CANDIDATES, type ConfigLoad, type CredentialDecl, type CrewPerClientDecl, type DefineInput, type FileSource, type IdentityDecl, type MigrationFile, PLATFORM_ENV, PROJECT_CONTEXT_PREAMBLE, type PlatformEnv, type ProjectConfig, type ResourceAction, type ResourceReport, type ScheduleDecl, type SkillDecl, type TaskDecl, type Template, type TemplateChoice, type UpOptions, type UpReport, type VaultDecl, chooseTemplate, collectFiles, contentHash, defineProject, generatedPassword, generatedSecret, hasRoster, loadConfig, migrationFiles, parseProject, scoped, selectCrew, up };