@buildinternet/uploads 0.42.2 → 0.44.0

package/dist/comment-config.generated.d.ts

@@ -12,6 +12,8 @@ export interface RepoCommentConfig {
     linkToFilePage?: boolean;
     note?: string;
     ingestGithubAttachments?: boolean;
+    ingestBotAttachments?: boolean;
+    adoptLinkedFiles?: boolean;
 }
 export interface WorkspaceCommentDefaults {
     imageWidth?: "full" | number;
@@ -20,6 +22,8 @@ export interface WorkspaceCommentDefaults {
     linkToFilePage?: boolean;
     note?: string;
     ingestGithubAttachments?: boolean;
+    ingestBotAttachments?: boolean;
+    adoptLinkedFiles?: boolean;
 }
 export interface ResolvedCommentOptions {
     imageWidth: "auto" | "full" | number;
@@ -29,6 +33,8 @@ export interface ResolvedCommentOptions {
     linkToFilePage: boolean;
     note: string | null;
     ingestGithubAttachments: boolean;
+    ingestBotAttachments: boolean;
+    adoptLinkedFiles: boolean;
 }
 export type OptionSource = "repo" | "workspace" | "auto";
 export declare const AUTO_COMMENT_OPTIONS: ResolvedCommentOptions;

package/dist/comment-config.generated.js

@@ -12,7 +12,11 @@ export const AUTO_COMMENT_OPTIONS = {
     metaState: true,
     linkToFilePage: true,
     note: null,
-    ingestGithubAttachments: false,
+    ingestGithubAttachments: true,
+    ingestBotAttachments: false,
+    // Default ON for bound repos (issue #701) — binding is already an
+    // explicit opt-in relationship, same posture as ingestGithubAttachments.
+    adoptLinkedFiles: true,
 };
 export const NOTE_MAX_CHARS = 500;
 const WIDTH_MIN = 160;
@@ -72,6 +76,22 @@ export function parseRepoCommentConfig(text, format) {
         else
             warnings.push(`ingestGithubAttachments: expected a boolean; dropped`);
     }
+    // ingestBotAttachments: boolean
+    if ("ingestBotAttachments" in c) {
+        const v = c.ingestBotAttachments;
+        if (typeof v === "boolean")
+            config.ingestBotAttachments = v;
+        else
+            warnings.push(`ingestBotAttachments: expected a boolean; dropped`);
+    }
+    // adoptLinkedFiles: boolean
+    if ("adoptLinkedFiles" in c) {
+        const v = c.adoptLinkedFiles;
+        if (typeof v === "boolean")
+            config.adoptLinkedFiles = v;
+        else
+            warnings.push(`adoptLinkedFiles: expected a boolean; dropped`);
+    }
     // meta.path / meta.state: booleans nested under `meta`
     if ("meta" in c) {
         const v = c.meta;
@@ -127,6 +147,10 @@ export function resolveCommentOptions(repo, ws) {
         ...(ws?.ingestGithubAttachments !== undefined
             ? { ingestGithubAttachments: ws.ingestGithubAttachments }
             : {}),
+        ...(ws?.ingestBotAttachments !== undefined
+            ? { ingestBotAttachments: ws.ingestBotAttachments }
+            : {}),
+        ...(ws?.adoptLinkedFiles !== undefined ? { adoptLinkedFiles: ws.adoptLinkedFiles } : {}),
     };
     const options = { ...AUTO_COMMENT_OPTIONS };
     const source = Object.fromEntries(Object.keys(AUTO_COMMENT_OPTIONS).map((k) => [k, "auto"]));
@@ -138,6 +162,8 @@ export function resolveCommentOptions(repo, ws) {
             "metaState",
             "linkToFilePage",
             "ingestGithubAttachments",
+            "ingestBotAttachments",
+            "adoptLinkedFiles",
         ]) {
             if (cfg[key] !== undefined && source[key] === "auto") {
                 options[key] = cfg[key];

package/dist/comment-render.generated.d.ts

@@ -147,5 +147,8 @@ export declare function attachmentImageWidth(filename: string, density?: Attachm
 /**
  * Render the one marker-owned GitHub comment. When there are no galleries this
  * intentionally preserves the legacy attachment-only body byte-for-byte.
+ *
+ * `target` is optional so goldens, the settings preview, and other callers
+ * without a PR/issue stay on the generic `--pr <N>` hint.
  */
-export declare function attachmentsCommentBody(items: AttachmentItem[], galleries?: GalleryCommentItem[], marker?: string, options?: CommentRenderOptions): string;
+export declare function attachmentsCommentBody(items: AttachmentItem[], galleries?: GalleryCommentItem[], marker?: string, options?: CommentRenderOptions, target?: Pick<GhTarget, "kind" | "num">): string;

package/dist/comment-render.generated.js

@@ -390,11 +390,24 @@ function countInlinableMedia(sorted, maxInlineImages) {
     }
     return count;
 }
+/**
+ * Quiet add-media footer. When `target` is a real PR/issue, the command
+ * uses that number (`--pr 12` / `--issue 45`) so anyone reading the comment
+ * can copy it. Without a target the generic `--pr <N>` placeholder stays.
+ */
+function addMediaFooter(target) {
+    const flag = target?.kind === "issues" ? "--issue" : "--pr";
+    const n = target && Number.isInteger(target.num) && target.num > 0 ? String(target.num) : "&lt;N&gt;";
+    return `<sub>Maintained by <a href="https://uploads.sh">uploads.sh</a> · add media: <code>uploads put &lt;file&gt; ${flag} ${n}</code> · <a href="https://uploads.sh/docs/github-app">docs</a></sub>`;
+}
 /**
  * Render the one marker-owned GitHub comment. When there are no galleries this
  * intentionally preserves the legacy attachment-only body byte-for-byte.
+ *
+ * `target` is optional so goldens, the settings preview, and other callers
+ * without a PR/issue stay on the generic `--pr <N>` hint.
  */
-export function attachmentsCommentBody(items, galleries = [], marker = ATTACHMENTS_MARKER, options = AUTO_RENDER_OPTIONS) {
+export function attachmentsCommentBody(items, galleries = [], marker = ATTACHMENTS_MARKER, options = AUTO_RENDER_OPTIONS, target) {
     // Non-mutating sort (equivalent to Array#toSorted) — the api worker's
     // tsconfig targets lib ES2022, which predates Array#toSorted (ES2023);
     // packages/uploads/src/github.ts uses toSorted directly.
@@ -529,6 +542,6 @@ export function attachmentsCommentBody(items, galleries = [], marker = ATTACHMEN
     // Footer condensed to a single quiet line — the old two-line explainer
     // ("re-uploading updates everywhere", full add-media flags) repeats on
     // every PR and lost value with each appearance; details live in the docs.
-    lines.push('<sub>Maintained by <a href="https://uploads.sh">uploads.sh</a> · add media: <code>uploads put &lt;file&gt; --pr &lt;N&gt;</code> · <a href="https://uploads.sh/docs/github-app">docs</a></sub>');
+    lines.push(addMediaFooter(target));
     return lines.join("\n");
 }

package/dist/config-file.d.ts

@@ -1,7 +1,7 @@
 import type { UploadsClientConfig } from "./config.js";
 export declare const UPLOADS_CONFIG_KEYS: readonly ["UPLOADS_API_URL", "UPLOADS_WORKSPACE", "UPLOADS_TOKEN", 
 /** Better Auth device-flow session bearer — keeps session.cliVersion fresh. */
-"UPLOADS_SESSION_TOKEN", "UPLOADS_DEFAULT_PREFIX", "UPLOADS_DEFAULT_REPO", "UPLOADS_DEFAULT_REF", "UPLOADS_DEFAULT_WIDTH", "UPLOADS_NO_GIT", "UPLOADS_NO_OPTIMIZE", "UPLOADS_KEEP_EXIF", "UPLOADS_NO_AUTO_META", "UPLOADS_SCREENSHOT_VIA", "UPLOADS_NO_NUDGE"];
+"UPLOADS_SESSION_TOKEN", "UPLOADS_DEFAULT_PREFIX", "UPLOADS_DEFAULT_REPO", "UPLOADS_DEFAULT_REF", "UPLOADS_DEFAULT_WIDTH", "UPLOADS_NO_GIT", "UPLOADS_NO_OPTIMIZE", "UPLOADS_KEEP_EXIF", "UPLOADS_NO_AUTO_META", "UPLOADS_SCREENSHOT_VIA", "UPLOADS_NO_NUDGE", "UPLOADS_NO_AUTO_PR"];
 export type UploadsConfigKey = (typeof UPLOADS_CONFIG_KEYS)[number];
 export type UploadsConfigValues = Partial<Record<UploadsConfigKey, string>>;
 export interface PutDefaults {
@@ -18,6 +18,9 @@ export interface PutDefaults {
     noAutoMeta?: boolean;
     /** When true, `put` never prints the bare-put --pr/attach nudge (issue #393). */
     noNudge?: boolean;
+    /** When true, a bare put/screenshot never auto-assumes an unambiguous open
+     * PR's context (issue #700) — falls back to the #403/#469 staging default. */
+    noAutoPr?: boolean;
 }
 declare const PUT_DEFAULT_KEY_MAP: Record<keyof PutDefaults, UploadsConfigKey>;
 export declare function putDefaultsToConfigValues(defaults: PutDefaults): UploadsConfigValues;

package/dist/config-file.js

@@ -17,6 +17,7 @@ export const UPLOADS_CONFIG_KEYS = [
     "UPLOADS_NO_AUTO_META",
     "UPLOADS_SCREENSHOT_VIA",
     "UPLOADS_NO_NUDGE",
+    "UPLOADS_NO_AUTO_PR",
 ];
 const PUT_DEFAULT_KEY_MAP = {
     prefix: "UPLOADS_DEFAULT_PREFIX",
@@ -28,6 +29,7 @@ const PUT_DEFAULT_KEY_MAP = {
     keepExif: "UPLOADS_KEEP_EXIF",
     noAutoMeta: "UPLOADS_NO_AUTO_META",
     noNudge: "UPLOADS_NO_NUDGE",
+    noAutoPr: "UPLOADS_NO_AUTO_PR",
 };
 function isTruthyConfigFlag(value) {
     if (!value)
@@ -55,6 +57,8 @@ export function putDefaultsToConfigValues(defaults) {
         out.UPLOADS_NO_AUTO_META = "1";
     if (defaults.noNudge)
         out.UPLOADS_NO_NUDGE = "1";
+    if (defaults.noAutoPr)
+        out.UPLOADS_NO_AUTO_PR = "1";
     return out;
 }
 function parsePutDefaultsFromRaw(raw) {
@@ -80,6 +84,8 @@ function parsePutDefaultsFromRaw(raw) {
         out.noAutoMeta = true;
     if (isTruthyConfigFlag(raw.UPLOADS_NO_NUDGE))
         out.noNudge = true;
+    if (isTruthyConfigFlag(raw.UPLOADS_NO_AUTO_PR))
+        out.noAutoPr = true;
     return out;
 }
 function parsePutDefaultsFromEnv() {
@@ -102,6 +108,8 @@ function parsePutDefaultsFromEnv() {
         raw.UPLOADS_NO_AUTO_META = process.env.UPLOADS_NO_AUTO_META;
     if (process.env.UPLOADS_NO_NUDGE)
         raw.UPLOADS_NO_NUDGE = process.env.UPLOADS_NO_NUDGE;
+    if (process.env.UPLOADS_NO_AUTO_PR)
+        raw.UPLOADS_NO_AUTO_PR = process.env.UPLOADS_NO_AUTO_PR;
     return parsePutDefaultsFromRaw(raw);
 }
 /** XDG default shared across buildinternet skills (github-screenshots, uploads, …). */
@@ -175,6 +183,8 @@ export function mergePutDefaults(...layers) {
             out.noAutoMeta = layer.noAutoMeta;
         if (layer.noNudge != null)
             out.noNudge = layer.noNudge;
+        if (layer.noAutoPr != null)
+            out.noAutoPr = layer.noAutoPr;
     }
     return out;
 }

package/dist/mcp/output-schemas.js

@@ -43,6 +43,25 @@ const promoteResultSchema = objectSchema({
         ]),
     },
 }, ["promoted", "skipped"]);
+/** Hosted `promote` tool's `attached[]` entry (issue #702, `AttachExistingResponse`). */
+const attachExistingResultSchema = objectSchema({
+    key: { type: "string" },
+    url: nullableString,
+    embedUrl: nullableString,
+    pageUrl: { type: "string" },
+    moved: { type: "boolean" },
+    source: objectSchema({ key: { type: "string" } }, ["key"]),
+    comment: commentResultSchema,
+}, ["key", "url", "embedUrl", "moved", "source", "comment"]);
+/** Hosted `promote` tool's `attachFailures[]` entry — one per bad `keys` source. */
+const attachFailureSchema = objectSchema({
+    key: { type: "string" },
+    error: objectSchema({
+        message: { type: "string" },
+        code: { type: "string" },
+        status: { type: "number" },
+    }, ["message"]),
+}, ["key", "error"]);
 const putObjectFields = {
     key: { type: "string" },
     url: nullableString,
@@ -209,10 +228,14 @@ export const healthResultSchema = objectSchema({
     apiUrl: { type: "string" },
 });
 export const promoteToolResultSchema = objectSchema({
+    // `promotion` is optional (issue #702): a `keys`-only call (no `branch`)
+    // never runs the branch sweep, so there's nothing to report under it.
     promotion: promoteResultSchema,
+    attached: { type: "array", items: attachExistingResultSchema },
+    attachFailures: { type: "array", items: attachFailureSchema },
     comment: commentResultSchema,
     commentError: { type: "string" },
-}, ["promotion"]);
+});
 const galleryItemSchema = objectSchema({
     id: { type: "string" },
     objectKey: { type: "string" },