agentful 0.3.7 → 0.3.9

package/dist/index.cjs

@@ -3044,7 +3044,7 @@ var VERSION, brand, useColor, wrap, paint, sym, ui;
 var init_branding = __esm({
   "src/branding.ts"() {
     "use strict";
-    VERSION = "0.3.7" ? "0.3.7" : null.version;
+    VERSION = "0.3.9" ? "0.3.9" : null.version;
     brand = {
       name: "agentful",
       // the command users type
@@ -6753,6 +6753,10 @@ is fine \u2014 but then say clearly that \`agentful push\` cannot deploy it.
   vars (\`database.anon_key\`/\`publishable_key\` expanded as
   \`VITE_\`/\`PUBLIC_\`/\`NEXT_PUBLIC_\`). Never rely on \`.env*\` files reaching the
   cloud \u2014 the CLI and server both strip them.
+- \`.agentful/\` is local CLI control metadata and is excluded from the cloud
+  build source. You may read \`.agentful/project.json\` while authoring, but app
+  code must never import or fetch it. Copy the fixed project ID into an ordinary
+  source constant when the managed backend client needs it.
 
 ## Supported frameworks (the cloud build table)
 
@@ -6778,7 +6782,9 @@ process, and never a script the user must run locally to produce the result.
 
 When the project uses the platform's managed backend, its ONLY API surface is:
 
-- Base: \`/api/p/{projectId}/\` \u2014 projectId comes from \`.agentful/project.json\`.
+- Base: \`/api/p/{projectId}/\` \u2014 while authoring, read projectId from
+  \`.agentful/project.json\` and materialize it in a normal app source constant;
+  never import \`.agentful/\` from app code.
 - End-user auth: \`\u2026/auth/*\` (\`register\`, \`login\`, \`me\`, \`verify\`, \u2026).
 - Data CRUD: \`\u2026/data/{collection}\` and \`\u2026/data/{collection}/{docId}\`.
 - Managed Server Actions: \`POST \u2026/actions/{action-name}\` \u2014 and NOTHING else.
@@ -8084,28 +8090,47 @@ async function shareCommand(opts) {
 }
 
 // src/commands/pull.ts
-var import_node_fs18 = require("fs");
-var import_node_path21 = require("path");
+var import_node_fs19 = require("fs");
+var import_node_path22 = require("path");
 init_branding();
 init_branding();
-function isProbablyBase64Binary(path) {
-  return /\.(png|jpe?g|gif|webp|ico|woff2?|ttf|otf|eot|pdf|zip|mp[34]|webm|avif)$/i.test(path);
+
+// src/lib/pullFiles.ts
+var import_node_fs18 = require("fs");
+var import_node_path21 = require("path");
+var INLINE_BASE64_EXTENSIONS = /\.(?:png|jpe?g|gif|webp|avif|svg|ico|bmp|tiff?|woff2?|ttf|otf|eot|pdf|docx?|xlsx?|pptx?|zip|tar|gz|7z|rar|bz2|mp[34]|m4a|wav|ogg|avi|mov|mkv|flac|webm|exe|dll|so|dylib|bin|wasm)$/i;
+function inlineContent(value) {
+  return typeof value === "object" && value !== null && "content" in value ? String(value.content) : String(value ?? "");
 }
-function writeEntry(root, rel, value) {
+function writePulledWorkspaceEntry(root, rel, value) {
   const target = (0, import_node_path21.join)(root, rel);
   (0, import_node_fs18.mkdirSync)((0, import_node_path21.dirname)(target), { recursive: true });
-  const content = typeof value === "object" && value !== null && "content" in value ? String(value.content) : String(value ?? "");
-  if (isProbablyBase64Binary(rel)) {
+  const content = inlineContent(value);
+  if (INLINE_BASE64_EXTENSIONS.test(rel)) {
     (0, import_node_fs18.writeFileSync)(target, Buffer.from(content, "base64"));
-  } else {
-    (0, import_node_fs18.writeFileSync)(target, content, "utf8");
+    return;
   }
+  (0, import_node_fs18.writeFileSync)(target, content, "utf8");
 }
+function writePulledBackendDeclaration(root, declaration) {
+  const target = (0, import_node_path21.join)(root, ".agentful", "backend.json");
+  (0, import_node_fs18.mkdirSync)((0, import_node_path21.dirname)(target), { recursive: true });
+  const {
+    source: _source,
+    received_at: _receivedAt,
+    last_sync: _lastSync,
+    ...portableDeclaration
+  } = declaration;
+  (0, import_node_fs18.writeFileSync)(target, `${JSON.stringify(portableDeclaration, null, 2)}
+`, "utf8");
+}
+
+// src/commands/pull.ts
 async function pullCommand(opts) {
   console.log(banner());
   const auth = await ensureAuth();
   const project = requireProject();
-  const nonHidden = (0, import_node_fs18.readdirSync)(process.cwd()).filter((n) => n !== ".agentful" && !n.startsWith("."));
+  const nonHidden = (0, import_node_fs19.readdirSync)(process.cwd()).filter((n) => n !== ".agentful" && !n.startsWith("."));
   if (nonHidden.length > 0 && !opts.force) {
     throw new ApiError(
       0,
@@ -8114,10 +8139,13 @@ async function pullCommand(opts) {
     );
   }
   ui.step("Fetching workspace\u2026");
-  const data = await request(
-    `${PB_URL}/api/workspaces/${project.userId}/${project.projectId}`,
-    { token: auth.pb_token, timeoutMs: 12e4 }
-  );
+  const [data, backendState] = await Promise.all([
+    request(
+      `${PB_URL}/api/workspaces/${project.userId}/${project.projectId}`,
+      { token: auth.pb_token, timeoutMs: 12e4 }
+    ),
+    fetchBackendSessionState(auth, project.userId, project.projectId)
+  ]);
   let written = 0;
   if (data.mode === "presigned" && data.urls) {
     for (const [rel, url] of Object.entries(data.urls)) {
@@ -8129,20 +8157,26 @@ async function pullCommand(opts) {
         ui.warn(`Skipped ${rel} (HTTP ${resp.status})`);
         continue;
       }
-      const target = (0, import_node_path21.join)(process.cwd(), rel);
-      (0, import_node_fs18.mkdirSync)((0, import_node_path21.dirname)(target), { recursive: true });
-      (0, import_node_fs18.writeFileSync)(target, Buffer.from(await resp.arrayBuffer()));
+      const target = (0, import_node_path22.join)(process.cwd(), rel);
+      (0, import_node_fs19.mkdirSync)((0, import_node_path22.dirname)(target), { recursive: true });
+      (0, import_node_fs19.writeFileSync)(target, Buffer.from(await resp.arrayBuffer()));
       written++;
     }
   } else if (data.files) {
     for (const [rel, value] of Object.entries(data.files)) {
-      writeEntry(process.cwd(), rel, value);
+      writePulledWorkspaceEntry(process.cwd(), rel, value);
       written++;
     }
   } else {
     throw new ApiError(0, "empty_workspace", "The cloud workspace has no files yet.");
   }
   ui.ok(`Pulled ${written} files from the cloud workspace.`);
+  if (backendState?.declaration) {
+    writePulledBackendDeclaration(process.cwd(), backendState.declaration);
+    ui.ok("Restored .agentful/backend.json from the platform declaration.");
+  } else if (backendState === null) {
+    ui.warn("Could not read the platform backend declaration; .agentful/backend.json was not restored.");
+  }
 }
 
 // THIRD-PARTY-LICENSES.txt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentful",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "Agentful in your terminal — local development with push-to-cloud previews",
   "license": "Apache-2.0",
   "homepage": "https://agentful.dev",