@usenaive-sdk/blueprints 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -146,6 +146,10 @@ declare const AgentDeclSchema: z.ZodObject<{
         identity: z.ZodOptional<z.ZodString>;
         enabled: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>>;
+    intake: z.ZodOptional<z.ZodObject<{
+        message: z.ZodString;
+        budget_micro_usd: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 /**
  * A vault credential (§23) minus what `up` fills in. `value` is a real third-party secret, so it is
@@ -197,6 +201,21 @@ declare const ProjectSchema: z.ZodObject<{
     name: z.ZodString;
     blueprint: z.ZodOptional<z.ZodString>;
     template: z.ZodOptional<z.ZodString>;
+    questions: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        placeholder: z.ZodOptional<z.ZodString>;
+        key: z.ZodString;
+        label: z.ZodString;
+        help: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"choice">;
+        options: z.ZodArray<z.ZodString>;
+        multiple: z.ZodDefault<z.ZodBoolean>;
+        other: z.ZodDefault<z.ZodBoolean>;
+        key: z.ZodString;
+        label: z.ZodString;
+        help: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "type">>>;
     skills: z.ZodDefault<z.ZodArray<z.ZodObject<{
         slug: z.ZodString;
         file: z.ZodString;
@@ -283,6 +302,10 @@ declare const ProjectSchema: z.ZodObject<{
             identity: z.ZodOptional<z.ZodString>;
             enabled: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
+        intake: z.ZodOptional<z.ZodObject<{
+            message: z.ZodString;
+            budget_micro_usd: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     removed: z.ZodDefault<z.ZodObject<{
         apps: z.ZodDefault<z.ZodArray<z.ZodString>>;
@@ -343,6 +366,31 @@ type ConfigLoad = {
 };
 declare function loadConfig(dir: string): Promise<ConfigLoad>;
 
+/**
+ * A built tree, from either place one can be. A **directory** is the apply a person runs: a
+ * checkout on their laptop or in CI. A **file map** is the apply the platform runs on their
+ * behalf — the tree comes out of a published artifact's object-store entry (`canonical-spec §31.1`)
+ * and there is no checkout anywhere, because a hosted run never clones a blueprint.
+ */
+type FileSource = string | Record<string, string>;
+/**
+ * ONE FILTER, ONE DIGEST, BOTH SOURCES — which is the whole of why the map arm exists rather than
+ * the caller handing its map straight to `contentHash`.
+ *
+ * A published artifact's `content_hash` is compared against the newest deployment's to decide
+ * whether to upload at all (§31.1), and the two sides of that comparison are collected in different
+ * places: the deployment's from a directory here, the artifact's from a map on the server. If the
+ * map arm skipped one exclusion or one size cap, the digests would differ for two trees that ship
+ * the same bytes and every hosted install would re-upload, forever, with nothing to point at.
+ */
+declare function collectFiles(source: FileSource): Record<string, string>;
+/**
+ * sha-256 over the files in path order, each as `path NUL byte-length NUL bytes`: the same tree
+ * hashes the same from any walk order, and the length prefix keeps two trees from sharing an
+ * encoding. Hex, so it travels as a plain string.
+ */
+declare function contentHash(files: Record<string, string>): string;
+
 /**
  * The report vocabulary `up` speaks (`workstreams/10-blueprints.md §2` item 4) and the handful of
  * client-side moves every resource kind shares: one line per attempt with refusals caught into
@@ -370,6 +418,11 @@ interface ResourceReport {
  * bounded exception — a declared agent's `schedules` are owned as a complete set (`agents.ts`).
  * Skills and identities live here; apps, agents and vaults each have their own module, sharing the
  * report vocabulary in `report.ts`.
+ *
+ * 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.
  */
 
 interface UpReport {
@@ -385,6 +438,12 @@ interface UpReport {
     agents: ResourceReport[];
     /** One line per declared cron and per pruned live row, named `<agent> @ <cron>`. */
     schedules: ResourceReport[];
+    /**
+     * One line per agent this apply **created** that declares an `intake` — the session that was
+     * started, named by the agent, `id` the `ses_`. Empty on every later apply of the same crew: an
+     * agent is created once, so it is briefed once (`agents.ts`).
+     */
+    intake: 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.
@@ -405,4 +464,4 @@ interface UpOptions {
 /** 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>;
 
-export { type AgentDecl, type AppDecl, BLUEPRINTS, BlueprintRefusal, CONFIG_CANDIDATES, type ConfigLoad, type CredentialDecl, type DefineInput, type IdentityDecl, type ProjectConfig, type ResourceAction, type ResourceReport, type ScheduleDecl, type SkillDecl, type Template, type TemplateChoice, type TemplateKind, type UpOptions, type UpReport, type VaultDecl, chooseTemplate, defineProject, loadConfig, parseProject, up };
+export { type AgentDecl, type AppDecl, BLUEPRINTS, BlueprintRefusal, CONFIG_CANDIDATES, type ConfigLoad, type CredentialDecl, type DefineInput, type FileSource, type IdentityDecl, 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, loadConfig, parseProject, up };