@buildinternet/uploads 0.53.0 → 0.55.0

package/dist/mcp/output-schemas.js

@@ -263,6 +263,20 @@ export const changelogResultSchema = objectSchema({
     feed: { type: "string" },
     entries: { type: "array", items: changelogEntrySchema },
 }, ["url", "entries"]);
+const docsSearchHitSchema = objectSchema({
+    title: { type: "string" },
+    url: { type: "string" },
+    page: { type: "string" },
+    snippet: { type: "string" },
+    body: { type: "string" },
+    truncated: { type: "boolean" },
+}, ["title", "url", "page", "snippet"]);
+export const searchDocsResultSchema = objectSchema({
+    url: { type: "string" },
+    query: { type: "string" },
+    results: { type: "array", items: docsSearchHitSchema },
+    total: { type: "number" },
+}, ["url", "results", "total"]);
 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.
@@ -323,6 +337,39 @@ export const galleryFindResultSchema = objectSchema({
     galleries: { type: "array", items: galleryResultSchema },
     nextCursor: nullableString,
 });
+const feedItemSchema = objectSchema({
+    id: { type: "string" },
+    objectKey: { type: "string" },
+    filename: { type: "string" },
+    status: { type: "string" },
+    url: nullableString,
+    embedUrl: nullableString,
+    pageUrl: { type: "string" },
+    contentType: nullableString,
+    size: { type: ["number", "null"] },
+    uploaded: nullableString,
+    modified: nullableString,
+    path: nullableString,
+    state: nullableString,
+    posterUrl: { type: "string" },
+    videoDimensions: {
+        type: "object",
+        additionalProperties: true,
+    },
+});
+export const feedResultSchema = objectSchema({
+    id: { type: "string" },
+    url: { type: "string" },
+    workspace: { type: "string" },
+    repo: { type: "string" },
+    path: nullableString,
+    number: { type: ["number", "null"] },
+    kind: nullableString,
+    title: { type: "string" },
+    createdAt: { type: "string" },
+    updatedAt: { type: "string" },
+    items: { type: "array", items: feedItemSchema },
+});
 /** Hosted catalog — every tool must have an entry. */
 export const hostedOutputSchemas = {
     gallery_create: galleryResultSchema,
@@ -330,6 +377,8 @@ export const hostedOutputSchemas = {
     gallery_add: galleryItemSchema,
     gallery_link: galleryReferenceSchema,
     gallery_find_by_reference: galleryFindResultSchema,
+    feed_create: feedResultSchema,
+    feed_get: feedResultSchema,
     put: putResultSchema,
     list: listResultSchema,
     delete: deleteResultSchema,
@@ -345,6 +394,7 @@ export const hostedOutputSchemas = {
     purge_expired: purgeExpiredResultSchema,
     whoami: whoamiResultSchema,
     changelog: changelogResultSchema,
+    search_docs: searchDocsResultSchema,
 };
 /** Shared-shape stdio tools. Hosted-only tools (`promote`, `repo_link_status`) omitted. */
 export const stdioOutputSchemas = {
@@ -353,6 +403,8 @@ export const stdioOutputSchemas = {
     gallery_add: galleryItemSchema,
     gallery_link: galleryReferenceSchema,
     gallery_find_by_reference: galleryFindResultSchema,
+    feed_create: feedResultSchema,
+    feed_get: feedResultSchema,
     put: putResultSchema,
     list: listResultSchema,
     delete: deleteResultSchema,
@@ -379,6 +431,7 @@ export const stdioOutputSchemas = {
     purge_expired: purgeExpiredResultSchema,
     whoami: whoamiResultSchema,
     changelog: changelogResultSchema,
+    search_docs: searchDocsResultSchema,
     report: objectSchema({
         ok: { type: "boolean" },
         id: { type: "string" },

package/dist/mcp/server.d.ts

@@ -20,6 +20,7 @@
 import { McpServer, type Implementation, type jsonSchemaValidator } from "@modelcontextprotocol/server";
 export { appProp, canonicalMetaFromArgs, METADATA_DESCRIPTION, METADATA_PATH_CUE, MCP_EXAMPLE_PNG_BASE64, metadataArgWithCanonical, metadataProp, stateProp, optBool, optPosInt, optString, optStringArray, optStringRecord, usage, type ToolArgs, } from "./args.js";
 export { ToolBatchError, batchFailureMessage } from "./batch-error.js";
+export { SEARCH_DOCS_DESCRIPTION, SEARCH_DOCS_INPUT_SCHEMA, runSearchDocsTool, } from "./docs-tool.js";
 export { mapBounded } from "../async.js";
 export { McpServer, type jsonSchemaValidator };
 export { commentResultSchema, deleteResultSchema, findFilesResultSchema, galleryFindResultSchema, galleryResultSchema, hostedOutputSchemas, listResultSchema, metadataFacetsResultSchema, metadataResultSchema, promoteToolResultSchema, purgeExpiredResultSchema, putResultSchema, reconcileResultSchema, repoLinkStatusResultSchema, stdioOutputSchemas, usageResultSchema, withOutputSchemas, } from "./output-schemas.js";

package/dist/mcp/server.js

@@ -23,6 +23,7 @@ import { errorCodeFromUnknown, recordEvent } from "../telemetry.js";
 import { ToolBatchError } from "./batch-error.js";
 export { appProp, canonicalMetaFromArgs, METADATA_DESCRIPTION, METADATA_PATH_CUE, MCP_EXAMPLE_PNG_BASE64, metadataArgWithCanonical, metadataProp, stateProp, optBool, optPosInt, optString, optStringArray, optStringRecord, usage, } from "./args.js";
 export { ToolBatchError, batchFailureMessage } from "./batch-error.js";
+export { SEARCH_DOCS_DESCRIPTION, SEARCH_DOCS_INPUT_SCHEMA, runSearchDocsTool, } from "./docs-tool.js";
 export { mapBounded } from "../async.js";
 export { McpServer };
 export { commentResultSchema, deleteResultSchema, findFilesResultSchema, galleryFindResultSchema, galleryResultSchema, hostedOutputSchemas, listResultSchema, metadataFacetsResultSchema, metadataResultSchema, promoteToolResultSchema, purgeExpiredResultSchema, putResultSchema, reconcileResultSchema, repoLinkStatusResultSchema, stdioOutputSchemas, usageResultSchema, withOutputSchemas, } from "./output-schemas.js";

package/dist/mcp/tools.d.ts

@@ -1,6 +1,7 @@
 /**
  * MCP tool set mirroring the CLI commands (put, attach, list, delete,
- * usage, reconcile, purge_expired, comment, whoami, doctor, changelog). Config is
+ * usage, reconcile, purge_expired, comment, whoami, doctor, changelog,
+ * search_docs). Config is
  * resolved fresh per tool call so a
  * per-call `workspace` argument behaves like the CLI's --workspace flag, and
  * a missing token surfaces as a tool error rather than a startup failure.

package/dist/mcp/tools.js

@@ -4,7 +4,7 @@ import { resolveFrameId } from "../frame.js";
 import { resolveConfig, resolvePutDefaults, } from "../config.js";
 import { resolvePutPrefix } from "../destinations.js";
 import { fetchUploadSource, resolveUploadFilename } from "../fetch-upload-source.js";
-import { ghKeyPrefix, ghPrivateKeyPrefix } from "../github.js";
+import { ghKeyPrefix, ghPrivateKeyPrefix, parseGithubIssueRef } from "../github.js";
 import { safeCaptureFacts } from "../capture-facts.js";
 import { deriveRepoSlugFromGit } from "../keys.js";
 import { validateMetaMap } from "../metadata.js";
@@ -15,6 +15,7 @@ import { batchFailureMessage, mcpDestroyPublic, mcpNoAuth, mcpOAuthAny, mcpOAuth
 import { attachmentFromText, buildReportPayload, parseReportType, REPORT_TYPES, submitReport, validateReportMessage, } from "../report.js";
 import { resolveApiUrl } from "../config.js";
 import { DEFAULT_CHANGELOG_LIMIT, MAX_CHANGELOG_LIMIT, fetchChangelog } from "../changelog.js";
+import { SEARCH_DOCS_DESCRIPTION, SEARCH_DOCS_INPUT_SCHEMA, runSearchDocsTool, } from "./docs-tool.js";
 function mcpOptimizeOptions(args, defaults) {
     const quality = optPosInt(args, "optimizeQuality");
     if (quality !== undefined && quality > 100)
@@ -74,6 +75,12 @@ function galleryId(args) {
         usage("galleryId is required");
     return id;
 }
+function feedId(args) {
+    const id = optString(args, "feedId");
+    if (!id)
+        usage("feedId is required");
+    return id;
+}
 function galleryReference(args) {
     const provider = optString(args, "provider");
     const coordinate = optString(args, "coordinate");
@@ -85,6 +92,33 @@ function galleryReference(args) {
         usage("provider must be github");
     return { provider, coordinate };
 }
+function feedCreateOptions(args) {
+    const github = optString(args, "github");
+    const repo = optString(args, "repo");
+    const path = optString(args, "path");
+    const pr = optPosInt(args, "pr");
+    const issue = optPosInt(args, "issue");
+    if (pr != null && issue != null)
+        usage("pr and issue are mutually exclusive");
+    if (github && (pr != null || issue != null))
+        usage("github cannot be combined with pr or issue");
+    if (github) {
+        const ref = parseGithubIssueRef(github);
+        if (!ref)
+            usage("github must be owner/repo#number or a GitHub issue/PR URL");
+        if (repo && repo.trim().toLowerCase() !== ref.repo)
+            usage("repo does not match github");
+        return { repo: ref.repo, path, number: ref.number, kind: ref.kind };
+    }
+    if (!repo)
+        usage("repo is required");
+    return {
+        repo,
+        path,
+        ...(pr != null ? { number: pr, kind: "pull" } : {}),
+        ...(issue != null ? { number: issue, kind: "issue" } : {}),
+    };
+}
 const workspaceProp = {
     type: "string",
     description: "Override the workspace for this call (like the CLI's --workspace flag).",
@@ -288,6 +322,66 @@ export function createUploadsMcpTools(opts) {
                 });
             },
         },
+        {
+            name: "feed_create",
+            title: "Create change feed",
+            annotations: mcpWritePublic,
+            securitySchemes: mcpOAuthWrite,
+            description: "Create a public newest-first screenshot feed (same product as CLI `uploads feed create`). Pass `repo` alone for the whole GitHub repo. Pass `pr` plus `repo` — or `github` as owner/repo#123 / a GitHub PR URL — to scope that same feed to one pull request. `issue` does the same for an issue. Optional `path` filters by page-path metadata. Creating the same scope again returns the existing URL. This is a live query, not a curated gallery. Anyone who knows the URL can view it.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    repo: {
+                        type: "string",
+                        description: "GitHub owner/repo, for example acme/app. Required unless github is set.",
+                    },
+                    pr: {
+                        type: "integer",
+                        minimum: 1,
+                        description: "Scope the feed to this pull request. Same product as a repo feed — one extra filter. Mutually exclusive with issue and github.",
+                    },
+                    issue: {
+                        type: "integer",
+                        minimum: 1,
+                        description: "Scope the feed to this issue. Mutually exclusive with pr and github.",
+                    },
+                    github: {
+                        type: "string",
+                        description: "Scope via owner/repo#number or a GitHub issue/PR URL. Supplies repo when omitted. Mutually exclusive with pr and issue.",
+                    },
+                    path: {
+                        type: "string",
+                        description: "Optional exact page-path metadata filter, for example /settings.",
+                    },
+                    workspace: workspaceProp,
+                },
+                additionalProperties: false,
+            },
+            async handler(args) {
+                const { client } = await clientFor(args);
+                return client.createFeed(feedCreateOptions(args));
+            },
+        },
+        {
+            name: "feed_get",
+            title: "Get change feed",
+            annotations: mcpRead,
+            securitySchemes: mcpOAuthRead,
+            description: "Get a workspace-owned change feed by ID, including its current newest-first screenshots and the canonical public /c/<id> URL. Each item includes pageUrl (`/c/<id>/<item>`) for the pager. The feed may be repo-wide or scoped to one pull request / issue (see `number` and `kind` on the result). Anyone with the URL can view the media.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    feedId: { type: "string", description: "Opaque feed ID." },
+                    workspace: workspaceProp,
+                },
+                required: ["feedId"],
+                additionalProperties: false,
+            },
+            async handler(args) {
+                const { client } = await clientFor(args);
+                return client.getFeed(feedId(args));
+            },
+        },
         {
             name: "put",
             title: "Upload file",
@@ -1553,6 +1647,19 @@ export function createUploadsMcpTools(opts) {
                 return { ...target, ...result };
             },
         },
+        {
+            name: "search_docs",
+            title: "Search uploads.sh docs",
+            annotations: {
+                readOnlyHint: true,
+                destructiveHint: false,
+                openWorldHint: true,
+            },
+            securitySchemes: mcpNoAuth,
+            description: SEARCH_DOCS_DESCRIPTION,
+            inputSchema: SEARCH_DOCS_INPUT_SCHEMA,
+            handler: runSearchDocsTool,
+        },
         {
             name: "changelog",
             title: "Product changelog",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildinternet/uploads",
-  "version": "0.53.0",
+  "version": "0.55.0",
   "mcpName": "sh.uploads/mcp",
   "description": "CLI and client for uploads.sh — workspace-scoped image hosting for GitHub embeds",
   "type": "module",