@agent-native/core 0.7.30 → 0.7.31

package/dist/a2a/artifact-response.d.ts

@@ -0,0 +1,9 @@
+export interface A2AToolResultSummary {
+    tool: string;
+    result: string;
+}
+export interface A2AArtifactResponseOptions {
+    baseUrl?: string;
+}
+export declare function appendA2AArtifactLinks(responseText: string, toolResults: A2AToolResultSummary[], options?: A2AArtifactResponseOptions): string;
+//# sourceMappingURL=artifact-response.d.ts.map

package/dist/a2a/artifact-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-response.d.ts","sourceRoot":"","sources":["../../src/a2a/artifact-response.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA6KD,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,oBAAoB,EAAE,EACnC,OAAO,GAAE,0BAA+B,GACvC,MAAM,CA0CR"}

package/dist/a2a/artifact-response.js

@@ -0,0 +1,154 @@
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function parseToolResultJson(result) {
+    const trimmed = result.trim();
+    if (!trimmed || /^Error(?:\s|:)/i.test(trimmed))
+        return null;
+    try {
+        return asRecord(JSON.parse(trimmed));
+    }
+    catch {
+        // Dev shell wrappers may include console output before the returned JSON.
+        const firstBrace = trimmed.indexOf("{");
+        const lastBrace = trimmed.lastIndexOf("}");
+        if (firstBrace < 0 || lastBrace <= firstBrace)
+            return null;
+        try {
+            return asRecord(JSON.parse(trimmed.slice(firstBrace, lastBrace + 1)));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+function normalizeBaseUrl(baseUrl) {
+    const trimmed = baseUrl?.trim();
+    return trimmed ? trimmed.replace(/\/+$/, "") : undefined;
+}
+function artifactUrl(baseUrl, path) {
+    const base = normalizeBaseUrl(baseUrl);
+    return base ? `${base}${path}` : path;
+}
+function responseAlreadyMentionsPath(text, path) {
+    return text.includes(path);
+}
+function responseMentionsDesignShell(text, shell) {
+    if (!text.trim())
+        return true;
+    return text.includes(shell.id) || text.includes(`/design/${shell.id}`);
+}
+function responseAlreadyWarnsIncompleteDesign(text) {
+    return /(?:not ready|still working|processing|no renderable|no files|failed|could not|cannot|can't)/i.test(text);
+}
+function collectArtifacts(results) {
+    const documents = new Map();
+    const designShells = new Map();
+    const generatedDesigns = new Map();
+    for (const toolResult of results) {
+        const parsed = parseToolResultJson(toolResult.result);
+        if (!parsed)
+            continue;
+        if (toolResult.tool === "create-document") {
+            const id = stringValue(parsed.id);
+            if (id) {
+                documents.set(id, { id, title: stringValue(parsed.title) });
+            }
+            continue;
+        }
+        if (toolResult.tool === "create-design") {
+            const id = stringValue(parsed.id);
+            if (id) {
+                designShells.set(id, { id, title: stringValue(parsed.title) });
+            }
+            continue;
+        }
+        if (toolResult.tool === "generate-design") {
+            const id = stringValue(parsed.designId);
+            if (!id)
+                continue;
+            const savedFiles = Array.isArray(parsed.savedFiles)
+                ? parsed.savedFiles
+                : [];
+            const rawFileCount = parsed.fileCount;
+            const fileCount = typeof rawFileCount === "number" && Number.isFinite(rawFileCount)
+                ? rawFileCount
+                : savedFiles.length;
+            if (fileCount > 0) {
+                generatedDesigns.set(id, { id, fileCount });
+            }
+            continue;
+        }
+        if (toolResult.tool === "create-file") {
+            const id = stringValue(parsed.designId);
+            if (!id)
+                continue;
+            const renderable = parsed.renderable === true ||
+                stringValue(parsed.fileType) === "html" ||
+                stringValue(parsed.fileType) === "jsx";
+            if (renderable) {
+                const previous = generatedDesigns.get(id);
+                generatedDesigns.set(id, {
+                    id,
+                    fileCount: (previous?.fileCount ?? 0) + 1,
+                });
+            }
+        }
+    }
+    return {
+        documents: [...documents.values()],
+        designShells: [...designShells.values()],
+        generatedDesigns: [...generatedDesigns.values()],
+    };
+}
+function formatDocumentLine(document, baseUrl) {
+    const label = document.title ? `Document "${document.title}"` : "Document";
+    return `- ${label}: ${artifactUrl(baseUrl, `/page/${document.id}`)} (ID: ${document.id})`;
+}
+function formatDesignLine(design, baseUrl) {
+    const fileLabel = design.fileCount === 1 ? "1 file" : `${design.fileCount} files`;
+    return `- Design: ${artifactUrl(baseUrl, `/design/${design.id}`)} (ID: ${design.id}, ${fileLabel})`;
+}
+function formatIncompleteDesignMessage(shells) {
+    const ids = shells.map((shell) => shell.id).join(", ");
+    const noun = shells.length === 1 ? "project shell" : "project shells";
+    return (`The design is not ready yet. Design ${noun} ${ids} ` +
+        "exists, but no renderable files were saved, so I cannot return it as a completed artifact.");
+}
+export function appendA2AArtifactLinks(responseText, toolResults, options = {}) {
+    const baseUrl = normalizeBaseUrl(options.baseUrl);
+    const { documents, designShells, generatedDesigns } = collectArtifacts(toolResults);
+    const generatedDesignIds = new Set(generatedDesigns.map((design) => design.id));
+    const incompleteShells = designShells.filter((shell) => !generatedDesignIds.has(shell.id));
+    let text = responseText.trim() === "(no response)" ? "" : responseText.trim();
+    if (generatedDesigns.length === 0 &&
+        incompleteShells.length > 0 &&
+        !responseAlreadyWarnsIncompleteDesign(text) &&
+        (incompleteShells.some((shell) => responseMentionsDesignShell(text, shell)) ||
+            /\b(?:done|created|ready|here(?:'s| is)|complete|finished)\b/i.test(text))) {
+        return formatIncompleteDesignMessage(incompleteShells);
+    }
+    const missingLines = [];
+    for (const document of documents) {
+        const path = `/page/${document.id}`;
+        if (!responseAlreadyMentionsPath(text, path)) {
+            missingLines.push(formatDocumentLine(document, baseUrl));
+        }
+    }
+    for (const design of generatedDesigns) {
+        const path = `/design/${design.id}`;
+        if (!responseAlreadyMentionsPath(text, path)) {
+            missingLines.push(formatDesignLine(design, baseUrl));
+        }
+    }
+    if (missingLines.length === 0)
+        return text;
+    const artifactBlock = `Artifacts:\n${missingLines.join("\n")}`;
+    return text ? `${text}\n\n${artifactBlock}` : artifactBlock;
+}
+//# sourceMappingURL=artifact-response.js.map

package/dist/a2a/artifact-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-response.js","sourceRoot":"","sources":["../../src/a2a/artifact-response.ts"],"names":[],"mappings":"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","sourcesContent":["export interface A2AToolResultSummary {\n  tool: string;\n  result: string;\n}\n\nexport interface A2AArtifactResponseOptions {\n  baseUrl?: string;\n}\n\ninterface CreatedDocumentArtifact {\n  id: string;\n  title?: string;\n}\n\ninterface CreatedDesignShell {\n  id: string;\n  title?: string;\n}\n\ninterface GeneratedDesignArtifact {\n  id: string;\n  fileCount: number;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction stringValue(value: unknown): string | undefined {\n  return typeof value === \"string\" && value.trim() ? value.trim() : undefined;\n}\n\nfunction parseToolResultJson(result: string): Record<string, unknown> | null {\n  const trimmed = result.trim();\n  if (!trimmed || /^Error(?:\\s|:)/i.test(trimmed)) return null;\n\n  try {\n    return asRecord(JSON.parse(trimmed));\n  } catch {\n    // Dev shell wrappers may include console output before the returned JSON.\n    const firstBrace = trimmed.indexOf(\"{\");\n    const lastBrace = trimmed.lastIndexOf(\"}\");\n    if (firstBrace < 0 || lastBrace <= firstBrace) return null;\n    try {\n      return asRecord(JSON.parse(trimmed.slice(firstBrace, lastBrace + 1)));\n    } catch {\n      return null;\n    }\n  }\n}\n\nfunction normalizeBaseUrl(baseUrl: string | undefined): string | undefined {\n  const trimmed = baseUrl?.trim();\n  return trimmed ? trimmed.replace(/\\/+$/, \"\") : undefined;\n}\n\nfunction artifactUrl(baseUrl: string | undefined, path: string): string {\n  const base = normalizeBaseUrl(baseUrl);\n  return base ? `${base}${path}` : path;\n}\n\nfunction responseAlreadyMentionsPath(text: string, path: string): boolean {\n  return text.includes(path);\n}\n\nfunction responseMentionsDesignShell(\n  text: string,\n  shell: CreatedDesignShell,\n): boolean {\n  if (!text.trim()) return true;\n  return text.includes(shell.id) || text.includes(`/design/${shell.id}`);\n}\n\nfunction responseAlreadyWarnsIncompleteDesign(text: string): boolean {\n  return /(?:not ready|still working|processing|no renderable|no files|failed|could not|cannot|can't)/i.test(\n    text,\n  );\n}\n\nfunction collectArtifacts(results: A2AToolResultSummary[]): {\n  documents: CreatedDocumentArtifact[];\n  designShells: CreatedDesignShell[];\n  generatedDesigns: GeneratedDesignArtifact[];\n} {\n  const documents = new Map<string, CreatedDocumentArtifact>();\n  const designShells = new Map<string, CreatedDesignShell>();\n  const generatedDesigns = new Map<string, GeneratedDesignArtifact>();\n\n  for (const toolResult of results) {\n    const parsed = parseToolResultJson(toolResult.result);\n    if (!parsed) continue;\n\n    if (toolResult.tool === \"create-document\") {\n      const id = stringValue(parsed.id);\n      if (id) {\n        documents.set(id, { id, title: stringValue(parsed.title) });\n      }\n      continue;\n    }\n\n    if (toolResult.tool === \"create-design\") {\n      const id = stringValue(parsed.id);\n      if (id) {\n        designShells.set(id, { id, title: stringValue(parsed.title) });\n      }\n      continue;\n    }\n\n    if (toolResult.tool === \"generate-design\") {\n      const id = stringValue(parsed.designId);\n      if (!id) continue;\n\n      const savedFiles = Array.isArray(parsed.savedFiles)\n        ? parsed.savedFiles\n        : [];\n      const rawFileCount = parsed.fileCount;\n      const fileCount =\n        typeof rawFileCount === \"number\" && Number.isFinite(rawFileCount)\n          ? rawFileCount\n          : savedFiles.length;\n\n      if (fileCount > 0) {\n        generatedDesigns.set(id, { id, fileCount });\n      }\n      continue;\n    }\n\n    if (toolResult.tool === \"create-file\") {\n      const id = stringValue(parsed.designId);\n      if (!id) continue;\n      const renderable =\n        parsed.renderable === true ||\n        stringValue(parsed.fileType) === \"html\" ||\n        stringValue(parsed.fileType) === \"jsx\";\n\n      if (renderable) {\n        const previous = generatedDesigns.get(id);\n        generatedDesigns.set(id, {\n          id,\n          fileCount: (previous?.fileCount ?? 0) + 1,\n        });\n      }\n    }\n  }\n\n  return {\n    documents: [...documents.values()],\n    designShells: [...designShells.values()],\n    generatedDesigns: [...generatedDesigns.values()],\n  };\n}\n\nfunction formatDocumentLine(\n  document: CreatedDocumentArtifact,\n  baseUrl: string | undefined,\n): string {\n  const label = document.title ? `Document \"${document.title}\"` : \"Document\";\n  return `- ${label}: ${artifactUrl(baseUrl, `/page/${document.id}`)} (ID: ${document.id})`;\n}\n\nfunction formatDesignLine(\n  design: GeneratedDesignArtifact,\n  baseUrl: string | undefined,\n): string {\n  const fileLabel =\n    design.fileCount === 1 ? \"1 file\" : `${design.fileCount} files`;\n  return `- Design: ${artifactUrl(baseUrl, `/design/${design.id}`)} (ID: ${design.id}, ${fileLabel})`;\n}\n\nfunction formatIncompleteDesignMessage(shells: CreatedDesignShell[]): string {\n  const ids = shells.map((shell) => shell.id).join(\", \");\n  const noun = shells.length === 1 ? \"project shell\" : \"project shells\";\n  return (\n    `The design is not ready yet. Design ${noun} ${ids} ` +\n    \"exists, but no renderable files were saved, so I cannot return it as a completed artifact.\"\n  );\n}\n\nexport function appendA2AArtifactLinks(\n  responseText: string,\n  toolResults: A2AToolResultSummary[],\n  options: A2AArtifactResponseOptions = {},\n): string {\n  const baseUrl = normalizeBaseUrl(options.baseUrl);\n  const { documents, designShells, generatedDesigns } =\n    collectArtifacts(toolResults);\n  const generatedDesignIds = new Set(\n    generatedDesigns.map((design) => design.id),\n  );\n  const incompleteShells = designShells.filter(\n    (shell) => !generatedDesignIds.has(shell.id),\n  );\n\n  let text = responseText.trim() === \"(no response)\" ? \"\" : responseText.trim();\n\n  if (\n    generatedDesigns.length === 0 &&\n    incompleteShells.length > 0 &&\n    !responseAlreadyWarnsIncompleteDesign(text) &&\n    (incompleteShells.some((shell) =>\n      responseMentionsDesignShell(text, shell),\n    ) ||\n      /\\b(?:done|created|ready|here(?:'s| is)|complete|finished)\\b/i.test(text))\n  ) {\n    return formatIncompleteDesignMessage(incompleteShells);\n  }\n\n  const missingLines: string[] = [];\n  for (const document of documents) {\n    const path = `/page/${document.id}`;\n    if (!responseAlreadyMentionsPath(text, path)) {\n      missingLines.push(formatDocumentLine(document, baseUrl));\n    }\n  }\n  for (const design of generatedDesigns) {\n    const path = `/design/${design.id}`;\n    if (!responseAlreadyMentionsPath(text, path)) {\n      missingLines.push(formatDesignLine(design, baseUrl));\n    }\n  }\n\n  if (missingLines.length === 0) return text;\n  const artifactBlock = `Artifacts:\\n${missingLines.join(\"\\n\")}`;\n  return text ? `${text}\\n\\n${artifactBlock}` : artifactBlock;\n}\n"]}

package/dist/cli/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAgCvE,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAkGD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAqCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAkCf;AA8HD;;;;;GAKG;AACH,iBAAe,mBAAmB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf;AAsCD;;;;GAIG;AACH,iBAAe,wBAAwB,CACrC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAiEpE;AAgHD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,yCAAyC;AACzC,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,mBAAmB,IAAI,oBAAoB,EAC3C,wBAAwB,IAAI,yBAAyB,EACrD,qBAAqB,IAAI,sBAAsB,EAC/C,WAAW,IAAI,YAAY,EAC3B,kBAAkB,IAAI,mBAAmB,EACzC,eAAe,IAAI,gBAAgB,EACnC,kBAAkB,IAAI,mBAAmB,EACzC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,EAC7C,uBAAuB,IAAI,wBAAwB,GACpD,CAAC;AAkEF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAW1C;AAcD,iBAAS,oBAAoB,IAAI,MAAM,CAMtC;AAiID,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,IAAI,CA0CN;AA2BD,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAyED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CA0BxE"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/cli/create.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAiCvE,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAC7B,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAkGD,iBAAe,qBAAqB,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAqCf;AAMD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAkCf;AA8HD;;;;;GAKG;AACH,iBAAe,mBAAmB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAuCf;AAsCD;;;;GAIG;AACH,iBAAe,wBAAwB,CACrC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA2Ef;AAED;;;GAGG;AACH,iBAAS,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoEpE;AAgHD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7D;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,yCAAyC;AACzC,OAAO,EACL,qBAAqB,IAAI,sBAAsB,EAC/C,mBAAmB,IAAI,oBAAoB,EAC3C,wBAAwB,IAAI,yBAAyB,EACrD,qBAAqB,IAAI,sBAAsB,EAC/C,WAAW,IAAI,YAAY,EAC3B,kBAAkB,IAAI,mBAAmB,EACzC,eAAe,IAAI,gBAAgB,EACnC,kBAAkB,IAAI,mBAAmB,EACzC,wBAAwB,IAAI,yBAAyB,EACrD,oBAAoB,IAAI,qBAAqB,EAC7C,uBAAuB,IAAI,wBAAwB,GACpD,CAAC;AAkEF;;;;;GAKG;AACH,iBAAS,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+B7C;AASD,iBAAS,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED,iBAAS,wBAAwB,IAAI,MAAM,CAW1C;AAcD,iBAAS,oBAAoB,IAAI,MAAM,CAMtC;AAiID,iBAAS,kBAAkB,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,GAAG,WAAW,GAC/B,IAAI,CA0CN;AA2BD,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI1C;AAyED,iBAAS,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CA0BxE"}

package/dist/cli/create.js

@@ -9,6 +9,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const REPO = "BuilderIO/agent-native";
 const TEMPLATES_DIR = "templates";
+const POSTGRES_DEPENDENCY_VERSION = "^3.4.9";
 /**
  * Move "starter" to the top of the list so it lines up with clack's default
  * highlight on the first option — otherwise users have to scroll to see that
@@ -508,6 +509,8 @@ function postProcessStandalone(name, targetDir) {
             // Ensure pnpm.onlyBuiltDependencies is set so native packages
             // (better-sqlite3, esbuild, node-pty) compile their postinstall scripts
             // under pnpm 10+ without prompting for `pnpm approve-builds`.
+            pkg.dependencies = pkg.dependencies ?? {};
+            pkg.dependencies.postgres ??= POSTGRES_DEPENDENCY_VERSION;
             const requiredBuilt = ["better-sqlite3", "esbuild", "node-pty"];
             if (!pkg.pnpm || typeof pkg.pnpm !== "object") {
                 pkg.pnpm = {};