@usenaive-sdk/blueprints 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -174,6 +174,7 @@ declare const AgentDeclSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     allowed_apps: z.ZodOptional<z.ZodArray<z.ZodString>>;
     identity: z.ZodOptional<z.ZodString>;
+    handoffs: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"team">, z.ZodArray<z.ZodString>]>>;
     schedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
         cron: z.ZodString;
         timezone: z.ZodOptional<z.ZodString>;
@@ -229,9 +230,33 @@ 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<{
@@ -317,6 +342,19 @@ declare const IdentityDeclSchema: z.ZodObject<{
         load_micro_usd: z.ZodNumber;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+/**
+ * One card the apply seeds on the organization's board (`canonical-spec §31.11`). `key` is the
+ * card's idempotency handle — `<project>:<key>` on the wire — so a re-apply finds the card it wrote;
+ * `assignee` is an agent NAME, which is what a board card carries (§28.11); `blocked_by` names
+ * sibling tasks by key and becomes their `crd_` ids at apply time.
+ */
+declare const TaskDeclSchema: z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
+    assignee: z.ZodOptional<z.ZodString>;
+    blocked_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
 declare const ProjectSchema: z.ZodObject<{
     name: z.ZodString;
     blueprint: z.ZodOptional<z.ZodString>;
@@ -343,6 +381,24 @@ 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<{
@@ -533,6 +589,7 @@ declare const ProjectSchema: z.ZodObject<{
         metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         allowed_apps: z.ZodOptional<z.ZodArray<z.ZodString>>;
         identity: z.ZodOptional<z.ZodString>;
+        handoffs: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodLiteral<"team">, z.ZodArray<z.ZodString>]>>;
         schedules: z.ZodOptional<z.ZodArray<z.ZodObject<{
             cron: z.ZodString;
             timezone: z.ZodOptional<z.ZodString>;
@@ -551,6 +608,13 @@ declare const ProjectSchema: z.ZodObject<{
         role: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>>;
+    tasks: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        title: z.ZodString;
+        body: z.ZodOptional<z.ZodString>;
+        assignee: z.ZodOptional<z.ZodString>;
+        blocked_by: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
     removed: z.ZodDefault<z.ZodObject<{
         apps: z.ZodDefault<z.ZodArray<z.ZodString>>;
         agents: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -570,6 +634,7 @@ type SkillDecl = z.infer<typeof SkillDeclSchema>;
 type IdentityDecl = z.infer<typeof IdentityDeclSchema>;
 type VaultDecl = z.infer<typeof VaultDeclSchema>;
 type CredentialDecl = z.infer<typeof CredentialDeclSchema>;
+type TaskDecl = z.infer<typeof TaskDeclSchema>;
 type ProjectConfig = z.infer<typeof ProjectSchema>;
 /** Validate an untyped value (a loaded `.json`, an evaluated module) into a frozen project. */
 declare function parseProject(input: unknown): Readonly<ProjectConfig>;
@@ -777,6 +842,10 @@ declare const PLATFORM_ENV: {
     readonly identity_id: "NAIVE_IDENTITY_ID";
     /** The install's `project` — the row the app's own context lookup lands on (§31.8). */
     readonly project: "NAIVE_PROJECT";
+    /** The base URL of the Studio that installed the app, so it can send a signed-out visitor back. */
+    readonly studio_url: "NAIVE_STUDIO_URL";
+    /** The app's own `app_…` id — the one known value learnt from the row, not from the apply. */
+    readonly app_id: "NAIVE_APP_ID";
     /** A scoped organization API key minted for the app that asks for it. */
     readonly api_key: "NAIVE_API_KEY";
 };
@@ -807,6 +876,14 @@ interface PlatformEnv {
      */
     minted?: Record<string, (app: string) => Promise<string>>;
 }
+/** A value nobody has: 256 bits, URL-safe, no alphabet an app secret or a header would mangle. */
+declare const generatedSecret: () => string;
+/**
+ * `kq7m-x2rt-8bvn-pz4h`: four groups of four from a 31-letter alphabet, 16·log2(31) ≈ 79 bits. Each
+ * character is drawn by rejection sampling so the alphabet is used evenly — a modulo over 256 would
+ * not be.
+ */
+declare function generatedPassword(): string;
 
 /**
  * The reconciler behind `naive up` (`workstreams/10-blueprints.md §2`): a pure client of the
@@ -822,7 +899,9 @@ interface PlatformEnv {
  * One thing here is not a reconcile: an agent this apply **created** that declares an `intake` is
  * sent its briefing as a started session (`agents.ts`, `canonical-spec §31.4`). It is what turns a
  * provisioned crew into a crew that has started working, and it is idempotent for the same reason
- * everything else here is — the agent is created exactly once.
+ * everything else here is — the agent is created exactly once. `tasks` (`tasks.ts`, §31.11) is the
+ * reconcile that supersedes it: cards on the organization's board, keyed so a re-apply finds them,
+ * woken by the API's tick rather than started here.
  */
 
 interface UpReport {
@@ -844,6 +923,12 @@ interface UpReport {
      * agent is created once, so it is briefed once (`agents.ts`).
      */
     intake: ResourceReport[];
+    /**
+     * One line per declared task, named by its key, `id` the `crd_` (`tasks.ts`, `canonical-spec
+     * §31.11`): `created` on the apply that seeded the card, `unchanged` on every later one — the
+     * card's key stands for the task. The board's owner is a line under `agents` like any member.
+     */
+    tasks: ResourceReport[];
     /**
      * Live rows this client could not parse, named and stepped over (`report.ts`). One legacy row
      * used to abort the whole apply before any write; it is now a line here and nothing else.
@@ -970,4 +1055,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 Template, type TemplateChoice, type TemplateKind, type UpOptions, type UpReport, type VaultDecl, chooseTemplate, collectFiles, contentHash, defineProject, 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 TemplateKind, type UpOptions, type UpReport, type VaultDecl, chooseTemplate, collectFiles, contentHash, defineProject, generatedPassword, generatedSecret, hasRoster, loadConfig, migrationFiles, parseProject, selectCrew, up };