@burdenoff/mcp-libs 2026.522.1 → 2026.525.1

package/dist/modules/files/index.cjs

@@ -64,6 +64,49 @@ var BROWSE_FOLDER = `
     }
   }
 `;
+var LIST_FILES = `
+  query GetFiles($folderId: ID, $pagination: PaginationInput) {
+    getFiles(folderId: $folderId, pagination: $pagination) {
+      files {
+        id name description workspaceId folderId
+        mimeType extension size s3Key s3Bucket
+        downloadUrl status visibility
+        starred downloadCount viewCount sha256Hash
+        uploadedById createdAt updatedAt tags
+      }
+      total page limit hasMore
+    }
+  }
+`;
+var GET_FILE = `
+  query GetFile($id: ID!) {
+    getFile(id: $id) {
+      id name description workspaceId folderId
+      mimeType extension size s3Key s3Bucket
+      downloadUrl status visibility
+      starred downloadCount viewCount sha256Hash
+      uploadedById createdAt updatedAt tags
+    }
+  }
+`;
+var GET_FILE_DOWNLOAD_URL = `
+  query GetFileDownloadUrl($id: ID!, $expiresIn: Int) {
+    getFileDownloadUrl(id: $id, expiresIn: $expiresIn)
+  }
+`;
+var UPLOAD_FILE = `
+  mutation UploadFile($input: UploadFileInput!) {
+    uploadFile(input: $input) {
+      file {
+        id name description workspaceId folderId
+        mimeType extension size s3Key s3Bucket
+        status visibility uploadedById createdAt
+      }
+      uploadProgress
+      message
+    }
+  }
+`;
 var INITIATE_UPLOAD = `
   mutation InitiateUpload($input: InitiateUploadInput!) {
     initiateUpload(input: $input) {
@@ -99,8 +142,9 @@ var REVOKE_SHARE = `
 `;
 
 // src/modules/files/tools.ts
-var VisibilityEnum = zod.z.enum(["PRIVATE", "WORKSPACE", "PUBLIC"]);
-var ShareAccessEnum = zod.z.enum(["VIEW", "DOWNLOAD"]);
+var VisibilityEnum = zod.z.enum(["PRIVATE", "TEAM", "WORKSPACE", "PUBLIC"]);
+var ShareAccessEnum = zod.z.enum(["VIEW", "COMMENT", "DOWNLOAD", "EDIT"]);
+var ShareTypeEnum = zod.z.enum(["PUBLIC_LINK", "EMAIL_INVITE", "GROUP_SHARE"]);
 function registerFilesTools(server, ctx, track) {
   server.registerTool(
     track(mcpToolName(ctx.productName, "files_browse")),
@@ -252,6 +296,204 @@ function registerFilesTools(server, ctx, track) {
       }
     }
   );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "files_list")),
+    {
+      title: "List Files",
+      description: "List files in a workspace, optionally scoped to a folder. Returns { files, total, page, limit, hasMore }.",
+      inputSchema: {
+        folderId: zod.z.string().optional().describe("Folder ID (omit to list workspace root)"),
+        limit: zod.z.number().optional().describe("Page size (default 50)"),
+        offset: zod.z.number().optional().describe("Skip results")
+      }
+    },
+    async ({ folderId, limit, offset }) => {
+      try {
+        const pagination = {};
+        if (limit !== void 0) pagination.limit = limit;
+        if (offset !== void 0) pagination.offset = offset;
+        const data = await ctx.gql.workspace.request(LIST_FILES, {
+          folderId: folderId ?? null,
+          pagination: Object.keys(pagination).length > 0 ? pagination : void 0
+        });
+        return jsonResult(data.getFiles);
+      } catch (error) {
+        ctx.logger.error("files_list failed", { error });
+        return errorResult(
+          `Failed to list files: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "files_get")),
+    {
+      title: "Get File",
+      description: "Get a single file by ID. Returns the file record or an error if not found.",
+      inputSchema: { id: zod.z.string().describe("File ID") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(GET_FILE, { id });
+        if (!data.getFile) return errorResult(`File ${id} not found`);
+        return jsonResult(data.getFile);
+      } catch (error) {
+        ctx.logger.error("files_get failed", { error });
+        return errorResult(
+          `Failed to get file: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "files_download")),
+    {
+      title: "Get File Download URL",
+      description: "Resolve a server-signed presigned download URL for a file. The MCP cannot stream binary bytes itself; callers must GET the returned URL out-of-band. Returns { url, expiresIn }.",
+      inputSchema: {
+        id: zod.z.string().describe("File ID"),
+        expiresIn: zod.z.number().optional().describe("URL TTL in seconds (server default applies when omitted)")
+      }
+    },
+    async ({ id, expiresIn }) => {
+      try {
+        const data = await ctx.gql.workspace.request(
+          GET_FILE_DOWNLOAD_URL,
+          { id, expiresIn }
+        );
+        return jsonResult({ url: data.getFileDownloadUrl, expiresIn: expiresIn ?? null });
+      } catch (error) {
+        ctx.logger.error("files_download failed", { error });
+        return errorResult(
+          `Failed to resolve download URL: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "files_upload")),
+    {
+      title: "Upload File",
+      description: "Single-shot file upload mirroring the SDK files.upload contract (s3Bucket/s3Key/size pre-resolved). For raw-byte uploads from MCP callers, prefer files_upload_initiate + files_upload_complete which use presigned URLs. Returns the persisted file record.",
+      inputSchema: {
+        name: zod.z.string().describe("Display filename including extension"),
+        mimeType: zod.z.string().describe("MIME type"),
+        extension: zod.z.string().describe("File extension without leading dot"),
+        size: zod.z.number().describe("File size in bytes"),
+        s3Bucket: zod.z.string().describe("S3 bucket holding the uploaded object"),
+        s3Key: zod.z.string().describe("S3 key under the bucket"),
+        description: zod.z.string().optional().describe("File description"),
+        folderId: zod.z.string().optional().describe("Target folder ID"),
+        visibility: VisibilityEnum.optional().describe("Visibility (default: WORKSPACE)"),
+        tags: zod.z.unknown().optional().describe("Optional entity-owned tags JSON array")
+      }
+    },
+    async ({
+      name,
+      mimeType,
+      extension,
+      size,
+      s3Bucket,
+      s3Key,
+      description,
+      folderId,
+      visibility,
+      tags
+    }) => {
+      try {
+        const input = {
+          name,
+          mimeType,
+          extension,
+          size: String(size),
+          s3Bucket,
+          s3Key
+        };
+        if (description !== void 0) input.description = description;
+        if (folderId !== void 0) input.folderId = folderId;
+        if (visibility !== void 0) input.visibility = visibility;
+        if (tags !== void 0) input.tags = tags;
+        const data = await ctx.gql.workspace.request(
+          UPLOAD_FILE,
+          { input }
+        );
+        return jsonResult(data.uploadFile);
+      } catch (error) {
+        ctx.logger.error("files_upload failed", { error });
+        return errorResult(
+          `Failed to upload file: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "files_share")),
+    {
+      title: "Share File",
+      description: "Create a share for a file (mirrors SDK files.share). Returns the persisted FileShare record.",
+      inputSchema: {
+        fileId: zod.z.string().describe("File ID to share"),
+        shareType: ShareTypeEnum.describe(
+          "Share type (PUBLIC_LINK = anonymous, EMAIL_INVITE = by email, GROUP_SHARE = by user IDs)"
+        ),
+        accessLevel: ShareAccessEnum.describe("Access level the share grants"),
+        expiresAt: zod.z.string().optional().describe("Expiry timestamp in ISO 8601"),
+        password: zod.z.string().optional().describe("Optional password to gate the share"),
+        maxDownloads: zod.z.number().optional().describe("Maximum download count"),
+        invitedEmail: zod.z.string().optional().describe("Email address for EMAIL_INVITE shares"),
+        invitedUserIds: zod.z.array(zod.z.string()).optional().describe("User IDs to grant access for GROUP_SHARE shares")
+      }
+    },
+    async ({
+      fileId,
+      shareType,
+      accessLevel,
+      expiresAt,
+      password,
+      maxDownloads,
+      invitedEmail,
+      invitedUserIds
+    }) => {
+      try {
+        const input = { fileId, shareType, accessLevel };
+        if (expiresAt !== void 0) input.expiresAt = expiresAt;
+        if (password !== void 0) input.password = password;
+        if (maxDownloads !== void 0) input.maxDownloads = maxDownloads;
+        if (invitedEmail !== void 0) input.invitedEmail = invitedEmail;
+        if (invitedUserIds !== void 0) input.invitedUserIds = invitedUserIds;
+        const data = await ctx.gql.workspace.request(CREATE_SHARE, {
+          input
+        });
+        return jsonResult(data.createShare);
+      } catch (error) {
+        ctx.logger.error("files_share failed", { error });
+        return errorResult(
+          `Failed to share file: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
+  server.registerTool(
+    track(mcpToolName(ctx.productName, "files_revoke")),
+    {
+      title: "Revoke File Share",
+      description: "Revoke an existing file share by ID (mirrors SDK files.shareApi.revoke). Returns the updated share record with revokedAt/revokedBy set.",
+      inputSchema: { id: zod.z.string().describe("Share ID to revoke") }
+    },
+    async ({ id }) => {
+      try {
+        const data = await ctx.gql.workspace.request(REVOKE_SHARE, {
+          id
+        });
+        return jsonResult(data.revokeShare);
+      } catch (error) {
+        ctx.logger.error("files_revoke failed", { error });
+        return errorResult(
+          `Failed to revoke share: ${error instanceof Error ? error.message : String(error)}`
+        );
+      }
+    }
+  );
 }
 
 // src/modules/files/index.ts

package/dist/modules/files/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/result.ts","../../../src/core/tool-name.ts","../../../src/modules/files/operations.ts","../../../src/modules/files/tools.ts","../../../src/modules/files/index.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error classes for MCP SDK.\n *\n * Modules MUST throw these instead of throwing raw Errors. The registerTool\n * wrapper in result.ts catches and maps them to MCP-protocol-compliant\n * `{ isError: true, content: [...] }` responses.\n *\n * Throwing past the wrapper to the protocol surfaces as JSON-RPC -32603 to\n * the client and is a protocol bug.\n */\n\nexport class McpUserError extends Error {\n  public readonly hint: string | undefined;\n\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message);\n    this.name = 'McpUserError';\n    this.hint = opts?.hint;\n  }\n}\n\nexport class McpAuthError extends McpUserError {\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message, {\n      hint: opts?.hint ?? 'Run the auth_login tool to authenticate.',\n    });\n    this.name = 'McpAuthError';\n  }\n}\n\nexport class McpInternalError extends Error {\n  public override readonly cause: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = 'McpInternalError';\n    this.cause = cause;\n  }\n}\n","/**\n * MCP tool result helpers + central handler.\n *\n * Modules NEVER call server.registerTool directly — they use registerTool()\n * from this module so the central try/catch wraps the handler and:\n *   - maps thrown McpUserError / McpAuthError / McpInternalError to\n *     MCP-protocol-compliant `{ isError: true, content: [...] }` shapes\n *   - threads `_meta.progressToken` into ctx.progress for long ops\n *   - emits a structured log line on every error\n *   - never leaks `cause` from McpInternalError to the client\n *\n * This is the analog of cli-sdk's createProgram() central error handler.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { ZodRawShape } from 'zod';\nimport type { McpContext } from './context.js';\nimport { McpAuthError, McpInternalError, McpUserError } from './errors.js';\n\nexport interface ToolTextContent {\n  type: 'text';\n  text: string;\n  [k: string]: unknown;\n}\n\nexport interface ToolResult {\n  content: ToolTextContent[];\n  isError?: boolean;\n  structuredContent?: Record<string, unknown>;\n  [k: string]: unknown;\n}\n\nexport interface ToolMeta {\n  progressToken?: string | number;\n}\n\n/**\n * Build a successful tool result with JSON content (pretty-printed).\n */\nexport function jsonResult(data: unknown, structured?: Record<string, unknown>): ToolResult {\n  const result: ToolResult = {\n    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],\n  };\n  if (structured !== undefined) {\n    result.structuredContent = structured;\n  }\n  return result;\n}\n\n/**\n * Build a successful tool result with plain text content.\n */\nexport function textResult(text: string): ToolResult {\n  return { content: [{ type: 'text', text }] };\n}\n\n/**\n * Build an error tool result. Honors MCP's `{ isError: true, content }` shape.\n * Optional hint is appended on a new line so the LLM can react.\n */\nexport function errorResult(message: string, hint?: string): ToolResult {\n  const text = hint ? `${message}\\n\\nHint: ${hint}` : message;\n  return { content: [{ type: 'text', text }], isError: true };\n}\n\nexport interface ToolMetadata {\n  title: string;\n  description: string;\n  inputSchema?: ZodRawShape;\n}\n\nexport type ToolHandler<TArgs = Record<string, unknown>> = (\n  args: TArgs,\n  ctx: McpContext,\n  meta: ToolMeta,\n) => Promise<unknown>;\n\n/**\n * Register a tool with the central error wrapper.\n *\n * The handler returns a plain value or void. The wrapper:\n *   - wraps non-undefined returns in jsonResult()\n *   - if the value already looks like a ToolResult (has `content`), passes through\n *   - catches McpAuthError / McpUserError / McpInternalError / generic Error\n *   - logs every error via ctx.logger.error\n */\nexport function registerTool<TArgs extends Record<string, unknown>>(\n  server: McpServer,\n  ctx: McpContext,\n  name: string,\n  metadata: ToolMetadata,\n  handler: ToolHandler<TArgs>,\n): void {\n  const sdkConfig = {\n    title: metadata.title,\n    description: metadata.description,\n    ...(metadata.inputSchema ? { inputSchema: metadata.inputSchema } : {}),\n  };\n\n  // The MCP SDK's registerTool signature is `(name, config, handler)`. The\n  // handler arity depends on whether inputSchema is present (1-arg without,\n  // 2-arg with). We accept a unified handler shape and dispatch at runtime.\n  // The SDK's typing is strict and conditional on the inputSchema generic;\n  // bypass with a cast since runtime acceptance is unconditional.\n  const wrapped = async (...callbackArgs: unknown[]): Promise<ToolResult> => {\n    const hasArgs = callbackArgs.length === 2;\n    const args = (hasArgs ? callbackArgs[0] : {}) as TArgs;\n    const extra = (hasArgs ? callbackArgs[1] : callbackArgs[0]) as\n      | { _meta?: { progressToken?: string | number } }\n      | undefined;\n\n    const progressToken = extra?._meta?.progressToken;\n    const meta: ToolMeta = progressToken !== undefined ? { progressToken } : {};\n\n    try {\n      const result = await handler(args, ctx, meta);\n      if (isToolResult(result)) return result;\n      if (result === undefined) return textResult('OK');\n      return jsonResult(result);\n    } catch (error) {\n      return mapErrorToResult(error, ctx, name);\n    }\n  };\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (server as any).registerTool(name, sdkConfig, wrapped);\n}\n\nfunction isToolResult(value: unknown): value is ToolResult {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    'content' in value &&\n    Array.isArray((value as ToolResult).content)\n  );\n}\n\nfunction mapErrorToResult(error: unknown, ctx: McpContext, toolName: string): ToolResult {\n  if (error instanceof McpAuthError) {\n    ctx.logger.warn(`${toolName}: auth required`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpUserError) {\n    ctx.logger.info(`${toolName}: user error`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpInternalError) {\n    ctx.logger.error(`${toolName}: internal error`, {\n      message: error.message,\n      cause: stringifyCause(error.cause),\n    });\n    return errorResult(`Internal error in ${toolName}.`);\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  ctx.logger.error(`${toolName}: unhandled error`, { message });\n  return errorResult(`${toolName}: ${message}`);\n}\n\nfunction stringifyCause(cause: unknown): string | undefined {\n  if (cause === undefined || cause === null) return undefined;\n  if (cause instanceof Error) return cause.message;\n  try {\n    return JSON.stringify(cause);\n  } catch {\n    return String(cause);\n  }\n}\n","/**\n * Tool / resource / prompt naming helpers.\n *\n * Mandatory product prefix avoids collisions when Claude Desktop runs\n * multiple MCP servers concurrently (typical setup is ~6).\n *\n * Tool names are capped at 63 characters — Claude Desktop pre-1.x\n * truncated at 64 in some versions.\n */\n\nimport { McpInternalError } from './errors.js';\n\nconst MAX_TOOL_NAME_LENGTH = 63;\n\nfunction assertSafeName(name: string, kind: 'tool' | 'resource' | 'prompt'): string {\n  if (kind === 'tool' && name.length > MAX_TOOL_NAME_LENGTH) {\n    throw new McpInternalError(\n      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`,\n    );\n  }\n  return name;\n}\n\n/**\n * Build a tool name. Format: `<productName>_<...parts>` (snake_case).\n * Example: mcpToolName('vibecontrols', 'vibes', 'list') -> 'vibecontrols_vibes_list'\n */\nexport function mcpToolName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpToolName: productName is required');\n  }\n  const name = [productName, ...parts].filter(Boolean).join('_');\n  return assertSafeName(name, 'tool');\n}\n\n/**\n * Build a resource URI. Format: `<productName>://<...parts>`.\n * Example: mcpResourceUri('vibecontrols', 'schema') -> 'vibecontrols://schema'\n */\nexport function mcpResourceUri(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpResourceUri: productName is required');\n  }\n  return `${productName}://${parts.filter(Boolean).join('/')}`;\n}\n\n/**\n * Build a prompt name. Format: `<productName>-<...parts>` (kebab-case).\n * Example: mcpPromptName('vibecontrols', 'setup') -> 'vibecontrols-setup'\n */\nexport function mcpPromptName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpPromptName: productName is required');\n  }\n  return [productName, ...parts].filter(Boolean).join('-');\n}\n\nexport const TOOL_NAME_LIMIT = MAX_TOOL_NAME_LENGTH;\n","export const BROWSE_FOLDER = `\n  query BrowseFolder($folderId: ID, $pagination: PaginationInput) {\n    getFolder(id: $folderId) {\n      id name path\n      files { id name size mimeType }\n      subFolders { id name path level }\n    }\n    getFilesInFolder(folderId: $folderId, pagination: $pagination) {\n      files { id name size mimeType extension createdAt }\n      total hasMore\n    }\n  }\n`;\n\nexport const INITIATE_UPLOAD = `\n  mutation InitiateUpload($input: InitiateUploadInput!) {\n    initiateUpload(input: $input) {\n      session { id fileName fileSize s3Bucket s3Key }\n      uploadUrl\n      presignedUrls { partNumber url expiresAt }\n      multipartUploadId\n    }\n  }\n`;\n\nexport const COMPLETE_UPLOAD = `\n  mutation CompleteUpload($input: CompleteUploadInput!) {\n    completeUpload(input: $input) {\n      file { id name size s3Bucket s3Key downloadUrl }\n      fileId\n    }\n  }\n`;\n\nexport const CREATE_SHARE = `\n  mutation CreateShare($input: FileCreateShareInput!) {\n    createShare(input: $input) {\n      id token shareType accessLevel expiresAt requiresPassword\n      downloadCount maxDownloads createdAt\n    }\n  }\n`;\n\nexport const REVOKE_SHARE = `\n  mutation RevokeShare($id: ID!) {\n    revokeShare(id: $id) {\n      id revokedAt revokedBy\n    }\n  }\n`;\n","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport {\n  BROWSE_FOLDER,\n  INITIATE_UPLOAD,\n  COMPLETE_UPLOAD,\n  CREATE_SHARE,\n  REVOKE_SHARE,\n} from './operations.js';\n\nconst VisibilityEnum = z.enum(['PRIVATE', 'WORKSPACE', 'PUBLIC']);\nconst ShareAccessEnum = z.enum(['VIEW', 'DOWNLOAD']);\n\ninterface FolderRow {\n  id: string;\n  name: string;\n  path?: string;\n  subFolders?: Array<{ id: string; name: string; path?: string; level?: number }>;\n  files?: Array<{ id: string; name: string; size?: number; mimeType?: string }>;\n}\n\ninterface FileRow {\n  id: string;\n  name: string;\n  size?: number;\n  mimeType?: string;\n  extension?: string;\n  createdAt?: string;\n}\n\nexport function registerFilesTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_browse')),\n    {\n      title: 'Browse Folder',\n      description:\n        'Browse a workspace folder. Returns subfolders and paginated files. Omit folderId to browse the root.',\n      inputSchema: {\n        folderId: z.string().optional().describe('Folder ID (omit to browse root)'),\n        limit: z.number().optional().describe('Page size (default 100)'),\n        offset: z.number().optional().describe('Skip results'),\n      },\n    },\n    async ({ folderId, limit, offset }) => {\n      try {\n        const pagination: Record<string, unknown> = {};\n        if (limit !== undefined) pagination.limit = limit;\n        if (offset !== undefined) pagination.offset = offset;\n\n        const data = await ctx.gql.workspace.request<{\n          getFolder: FolderRow | null;\n          getFilesInFolder: { files: FileRow[]; total: number; hasMore: boolean };\n        }>(BROWSE_FOLDER, {\n          folderId: folderId ?? null,\n          pagination: Object.keys(pagination).length > 0 ? pagination : undefined,\n        });\n        return jsonResult({\n          folder: data.getFolder,\n          files: data.getFilesInFolder.files,\n          total: data.getFilesInFolder.total,\n          hasMore: data.getFilesInFolder.hasMore,\n        });\n      } catch (error) {\n        ctx.logger.error('files_browse failed', { error });\n        return errorResult(\n          `Failed to browse folder: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_upload_initiate')),\n    {\n      title: 'Initiate File Upload',\n      description:\n        'Initiate a multipart upload session. Returns presigned URL(s) the caller must PUT bytes to, plus a sessionId to use with files_upload_complete. MCP cannot read local files; the caller is responsible for streaming bytes to the returned URL(s).',\n      inputSchema: {\n        fileName: z.string().describe('File name including extension'),\n        fileSize: z.number().describe('File size in bytes'),\n        sha256Hash: z.string().describe('Hex SHA-256 of the file contents'),\n        mimeType: z.string().optional().describe('MIME type (default: application/octet-stream)'),\n        extension: z.string().optional().describe('File extension without leading dot'),\n        folderId: z.string().optional().describe('Target folder ID'),\n        visibility: VisibilityEnum.optional().describe('Visibility (default: WORKSPACE)'),\n      },\n    },\n    async ({ fileName, fileSize, sha256Hash, mimeType, extension, folderId, visibility }) => {\n      try {\n        const input: Record<string, unknown> = {\n          fileName,\n          fileSize,\n          sha256Hash,\n          mimeType: mimeType ?? 'application/octet-stream',\n          visibility: visibility ?? 'WORKSPACE',\n        };\n        if (extension !== undefined) input.extension = extension;\n        if (folderId !== undefined) input.folderId = folderId;\n\n        const data = await ctx.gql.workspace.request<{\n          initiateUpload: {\n            session: { id: string; fileName: string; fileSize: number };\n            uploadUrl?: string;\n            presignedUrls?: Array<{ partNumber: number; url: string; expiresAt?: string }>;\n            multipartUploadId?: string;\n          };\n        }>(INITIATE_UPLOAD, { input });\n        return jsonResult(data.initiateUpload);\n      } catch (error) {\n        ctx.logger.error('files_upload_initiate failed', { error });\n        return errorResult(\n          `Failed to initiate upload: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_upload_complete')),\n    {\n      title: 'Complete File Upload',\n      description:\n        'Complete an in-flight upload session previously initiated by files_upload_initiate.',\n      inputSchema: {\n        sessionId: z.string().describe('Session ID from files_upload_initiate'),\n        folderId: z.string().optional().describe('Target folder ID (overrides initiate)'),\n        description: z.string().optional().describe('File description'),\n      },\n    },\n    async ({ sessionId, folderId, description }) => {\n      try {\n        const input: Record<string, unknown> = { sessionId };\n        if (folderId !== undefined) input.folderId = folderId;\n        if (description !== undefined) input.description = description;\n\n        const data = await ctx.gql.workspace.request<{\n          completeUpload: { file: Record<string, unknown>; fileId: string };\n        }>(COMPLETE_UPLOAD, { input });\n        return jsonResult(data.completeUpload);\n      } catch (error) {\n        ctx.logger.error('files_upload_complete failed', { error });\n        return errorResult(\n          `Failed to complete upload: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_share_create')),\n    {\n      title: 'Create File Share',\n      description: 'Create a shareable link for a file with optional access controls.',\n      inputSchema: {\n        fileId: z.string().describe('File ID to share'),\n        access: ShareAccessEnum.optional().describe('Access level (default: DOWNLOAD)'),\n        expiresAt: z.string().optional().describe('Expiry timestamp in ISO 8601'),\n        password: z.string().optional().describe('Optional password to gate the share'),\n        maxDownloads: z.number().optional().describe('Maximum download count'),\n      },\n    },\n    async ({ fileId, access, expiresAt, password, maxDownloads }) => {\n      try {\n        const input: Record<string, unknown> = {\n          fileId,\n          shareType: 'PUBLIC_LINK',\n          accessLevel: access ?? 'DOWNLOAD',\n        };\n        if (expiresAt !== undefined) input.expiresAt = expiresAt;\n        if (password !== undefined) input.password = password;\n        if (maxDownloads !== undefined) input.maxDownloads = maxDownloads;\n\n        const data = await ctx.gql.workspace.request<{\n          createShare: Record<string, unknown>;\n        }>(CREATE_SHARE, { input });\n        return jsonResult(data.createShare);\n      } catch (error) {\n        ctx.logger.error('files_share_create failed', { error });\n        return errorResult(\n          `Failed to create share: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_share_revoke')),\n    {\n      title: 'Revoke File Share',\n      description: 'Revoke a previously created file share by ID.',\n      inputSchema: {\n        id: z.string().describe('Share ID to revoke'),\n      },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{\n          revokeShare: { id: string; revokedAt?: string; revokedBy?: string };\n        }>(REVOKE_SHARE, { id });\n        return jsonResult(data.revokeShare);\n      } catch (error) {\n        ctx.logger.error('files_share_revoke failed', { error });\n        return errorResult(\n          `Failed to revoke share: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Files module — workspace file browse, upload (initiate/complete), and share\n * (<product>_files_{browse,upload_initiate,upload_complete,share_create,share_revoke}).\n *\n * Backend: ~/products/wspace/files/wspace-files-svc/.\n * Ported from cli-sdk/src/modules/files/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerFilesTools } from './tools.js';\n\nconst filesModule: McpModule = {\n  id: 'files',\n  version: '0.0.1',\n  displayName: 'Files',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\n\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const tools: string[] = [];\n    const track = (n: string): string => {\n      tools.push(n);\n      return n;\n    };\n\n    registerFilesTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default filesModule;\n"]}
+{"version":3,"sources":["../../../src/core/errors.ts","../../../src/core/result.ts","../../../src/core/tool-name.ts","../../../src/modules/files/operations.ts","../../../src/modules/files/tools.ts","../../../src/modules/files/index.ts"],"names":["z"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Error classes for MCP SDK.\n *\n * Modules MUST throw these instead of throwing raw Errors. The registerTool\n * wrapper in result.ts catches and maps them to MCP-protocol-compliant\n * `{ isError: true, content: [...] }` responses.\n *\n * Throwing past the wrapper to the protocol surfaces as JSON-RPC -32603 to\n * the client and is a protocol bug.\n */\n\nexport class McpUserError extends Error {\n  public readonly hint: string | undefined;\n\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message);\n    this.name = 'McpUserError';\n    this.hint = opts?.hint;\n  }\n}\n\nexport class McpAuthError extends McpUserError {\n  constructor(message: string, opts?: { hint?: string }) {\n    super(message, {\n      hint: opts?.hint ?? 'Run the auth_login tool to authenticate.',\n    });\n    this.name = 'McpAuthError';\n  }\n}\n\nexport class McpInternalError extends Error {\n  public override readonly cause: unknown;\n\n  constructor(message: string, cause?: unknown) {\n    super(message);\n    this.name = 'McpInternalError';\n    this.cause = cause;\n  }\n}\n","/**\n * MCP tool result helpers + central handler.\n *\n * Modules NEVER call server.registerTool directly — they use registerTool()\n * from this module so the central try/catch wraps the handler and:\n *   - maps thrown McpUserError / McpAuthError / McpInternalError to\n *     MCP-protocol-compliant `{ isError: true, content: [...] }` shapes\n *   - threads `_meta.progressToken` into ctx.progress for long ops\n *   - emits a structured log line on every error\n *   - never leaks `cause` from McpInternalError to the client\n *\n * This is the analog of cli-sdk's createProgram() central error handler.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { ZodRawShape } from 'zod';\nimport type { McpContext } from './context.js';\nimport { McpAuthError, McpInternalError, McpUserError } from './errors.js';\n\nexport interface ToolTextContent {\n  type: 'text';\n  text: string;\n  [k: string]: unknown;\n}\n\nexport interface ToolResult {\n  content: ToolTextContent[];\n  isError?: boolean;\n  structuredContent?: Record<string, unknown>;\n  [k: string]: unknown;\n}\n\nexport interface ToolMeta {\n  progressToken?: string | number;\n}\n\n/**\n * Build a successful tool result with JSON content (pretty-printed).\n */\nexport function jsonResult(data: unknown, structured?: Record<string, unknown>): ToolResult {\n  const result: ToolResult = {\n    content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],\n  };\n  if (structured !== undefined) {\n    result.structuredContent = structured;\n  }\n  return result;\n}\n\n/**\n * Build a successful tool result with plain text content.\n */\nexport function textResult(text: string): ToolResult {\n  return { content: [{ type: 'text', text }] };\n}\n\n/**\n * Build an error tool result. Honors MCP's `{ isError: true, content }` shape.\n * Optional hint is appended on a new line so the LLM can react.\n */\nexport function errorResult(message: string, hint?: string): ToolResult {\n  const text = hint ? `${message}\\n\\nHint: ${hint}` : message;\n  return { content: [{ type: 'text', text }], isError: true };\n}\n\nexport interface ToolMetadata {\n  title: string;\n  description: string;\n  inputSchema?: ZodRawShape;\n}\n\nexport type ToolHandler<TArgs = Record<string, unknown>> = (\n  args: TArgs,\n  ctx: McpContext,\n  meta: ToolMeta,\n) => Promise<unknown>;\n\n/**\n * Register a tool with the central error wrapper.\n *\n * The handler returns a plain value or void. The wrapper:\n *   - wraps non-undefined returns in jsonResult()\n *   - if the value already looks like a ToolResult (has `content`), passes through\n *   - catches McpAuthError / McpUserError / McpInternalError / generic Error\n *   - logs every error via ctx.logger.error\n */\nexport function registerTool<TArgs extends Record<string, unknown>>(\n  server: McpServer,\n  ctx: McpContext,\n  name: string,\n  metadata: ToolMetadata,\n  handler: ToolHandler<TArgs>,\n): void {\n  const sdkConfig = {\n    title: metadata.title,\n    description: metadata.description,\n    ...(metadata.inputSchema ? { inputSchema: metadata.inputSchema } : {}),\n  };\n\n  // The MCP SDK's registerTool signature is `(name, config, handler)`. The\n  // handler arity depends on whether inputSchema is present (1-arg without,\n  // 2-arg with). We accept a unified handler shape and dispatch at runtime.\n  // The SDK's typing is strict and conditional on the inputSchema generic;\n  // bypass with a cast since runtime acceptance is unconditional.\n  const wrapped = async (...callbackArgs: unknown[]): Promise<ToolResult> => {\n    const hasArgs = callbackArgs.length === 2;\n    const args = (hasArgs ? callbackArgs[0] : {}) as TArgs;\n    const extra = (hasArgs ? callbackArgs[1] : callbackArgs[0]) as\n      | { _meta?: { progressToken?: string | number } }\n      | undefined;\n\n    const progressToken = extra?._meta?.progressToken;\n    const meta: ToolMeta = progressToken !== undefined ? { progressToken } : {};\n\n    try {\n      const result = await handler(args, ctx, meta);\n      if (isToolResult(result)) return result;\n      if (result === undefined) return textResult('OK');\n      return jsonResult(result);\n    } catch (error) {\n      return mapErrorToResult(error, ctx, name);\n    }\n  };\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  (server as any).registerTool(name, sdkConfig, wrapped);\n}\n\nfunction isToolResult(value: unknown): value is ToolResult {\n  return (\n    !!value &&\n    typeof value === 'object' &&\n    'content' in value &&\n    Array.isArray((value as ToolResult).content)\n  );\n}\n\nfunction mapErrorToResult(error: unknown, ctx: McpContext, toolName: string): ToolResult {\n  if (error instanceof McpAuthError) {\n    ctx.logger.warn(`${toolName}: auth required`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpUserError) {\n    ctx.logger.info(`${toolName}: user error`, { message: error.message });\n    return errorResult(error.message, error.hint);\n  }\n  if (error instanceof McpInternalError) {\n    ctx.logger.error(`${toolName}: internal error`, {\n      message: error.message,\n      cause: stringifyCause(error.cause),\n    });\n    return errorResult(`Internal error in ${toolName}.`);\n  }\n  const message = error instanceof Error ? error.message : String(error);\n  ctx.logger.error(`${toolName}: unhandled error`, { message });\n  return errorResult(`${toolName}: ${message}`);\n}\n\nfunction stringifyCause(cause: unknown): string | undefined {\n  if (cause === undefined || cause === null) return undefined;\n  if (cause instanceof Error) return cause.message;\n  try {\n    return JSON.stringify(cause);\n  } catch {\n    return String(cause);\n  }\n}\n","/**\n * Tool / resource / prompt naming helpers.\n *\n * Mandatory product prefix avoids collisions when Claude Desktop runs\n * multiple MCP servers concurrently (typical setup is ~6).\n *\n * Tool names are capped at 63 characters — Claude Desktop pre-1.x\n * truncated at 64 in some versions.\n */\n\nimport { McpInternalError } from './errors.js';\n\nconst MAX_TOOL_NAME_LENGTH = 63;\n\nfunction assertSafeName(name: string, kind: 'tool' | 'resource' | 'prompt'): string {\n  if (kind === 'tool' && name.length > MAX_TOOL_NAME_LENGTH) {\n    throw new McpInternalError(\n      `Tool name '${name}' exceeds ${MAX_TOOL_NAME_LENGTH} characters (some MCP clients truncate at 64).`,\n    );\n  }\n  return name;\n}\n\n/**\n * Build a tool name. Format: `<productName>_<...parts>` (snake_case).\n * Example: mcpToolName('vibecontrols', 'vibes', 'list') -> 'vibecontrols_vibes_list'\n */\nexport function mcpToolName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpToolName: productName is required');\n  }\n  const name = [productName, ...parts].filter(Boolean).join('_');\n  return assertSafeName(name, 'tool');\n}\n\n/**\n * Build a resource URI. Format: `<productName>://<...parts>`.\n * Example: mcpResourceUri('vibecontrols', 'schema') -> 'vibecontrols://schema'\n */\nexport function mcpResourceUri(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpResourceUri: productName is required');\n  }\n  return `${productName}://${parts.filter(Boolean).join('/')}`;\n}\n\n/**\n * Build a prompt name. Format: `<productName>-<...parts>` (kebab-case).\n * Example: mcpPromptName('vibecontrols', 'setup') -> 'vibecontrols-setup'\n */\nexport function mcpPromptName(productName: string, ...parts: string[]): string {\n  if (!productName) {\n    throw new McpInternalError('mcpPromptName: productName is required');\n  }\n  return [productName, ...parts].filter(Boolean).join('-');\n}\n\nexport const TOOL_NAME_LIMIT = MAX_TOOL_NAME_LENGTH;\n","export const BROWSE_FOLDER = `\n  query BrowseFolder($folderId: ID, $pagination: PaginationInput) {\n    getFolder(id: $folderId) {\n      id name path\n      files { id name size mimeType }\n      subFolders { id name path level }\n    }\n    getFilesInFolder(folderId: $folderId, pagination: $pagination) {\n      files { id name size mimeType extension createdAt }\n      total hasMore\n    }\n  }\n`;\n\nexport const LIST_FILES = `\n  query GetFiles($folderId: ID, $pagination: PaginationInput) {\n    getFiles(folderId: $folderId, pagination: $pagination) {\n      files {\n        id name description workspaceId folderId\n        mimeType extension size s3Key s3Bucket\n        downloadUrl status visibility\n        starred downloadCount viewCount sha256Hash\n        uploadedById createdAt updatedAt tags\n      }\n      total page limit hasMore\n    }\n  }\n`;\n\nexport const GET_FILE = `\n  query GetFile($id: ID!) {\n    getFile(id: $id) {\n      id name description workspaceId folderId\n      mimeType extension size s3Key s3Bucket\n      downloadUrl status visibility\n      starred downloadCount viewCount sha256Hash\n      uploadedById createdAt updatedAt tags\n    }\n  }\n`;\n\nexport const GET_FILE_DOWNLOAD_URL = `\n  query GetFileDownloadUrl($id: ID!, $expiresIn: Int) {\n    getFileDownloadUrl(id: $id, expiresIn: $expiresIn)\n  }\n`;\n\nexport const UPLOAD_FILE = `\n  mutation UploadFile($input: UploadFileInput!) {\n    uploadFile(input: $input) {\n      file {\n        id name description workspaceId folderId\n        mimeType extension size s3Key s3Bucket\n        status visibility uploadedById createdAt\n      }\n      uploadProgress\n      message\n    }\n  }\n`;\n\nexport const INITIATE_UPLOAD = `\n  mutation InitiateUpload($input: InitiateUploadInput!) {\n    initiateUpload(input: $input) {\n      session { id fileName fileSize s3Bucket s3Key }\n      uploadUrl\n      presignedUrls { partNumber url expiresAt }\n      multipartUploadId\n    }\n  }\n`;\n\nexport const COMPLETE_UPLOAD = `\n  mutation CompleteUpload($input: CompleteUploadInput!) {\n    completeUpload(input: $input) {\n      file { id name size s3Bucket s3Key downloadUrl }\n      fileId\n    }\n  }\n`;\n\nexport const CREATE_SHARE = `\n  mutation CreateShare($input: FileCreateShareInput!) {\n    createShare(input: $input) {\n      id token shareType accessLevel expiresAt requiresPassword\n      downloadCount maxDownloads createdAt\n    }\n  }\n`;\n\nexport const REVOKE_SHARE = `\n  mutation RevokeShare($id: ID!) {\n    revokeShare(id: $id) {\n      id revokedAt revokedBy\n    }\n  }\n`;\n","import { z } from 'zod';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { jsonResult, errorResult, mcpToolName, type McpContext } from '../../core/index.js';\nimport {\n  BROWSE_FOLDER,\n  INITIATE_UPLOAD,\n  COMPLETE_UPLOAD,\n  CREATE_SHARE,\n  REVOKE_SHARE,\n  LIST_FILES,\n  GET_FILE,\n  GET_FILE_DOWNLOAD_URL,\n  UPLOAD_FILE,\n} from './operations.js';\n\nconst VisibilityEnum = z.enum(['PRIVATE', 'TEAM', 'WORKSPACE', 'PUBLIC']);\nconst ShareAccessEnum = z.enum(['VIEW', 'COMMENT', 'DOWNLOAD', 'EDIT']);\nconst ShareTypeEnum = z.enum(['PUBLIC_LINK', 'EMAIL_INVITE', 'GROUP_SHARE']);\n\ninterface FolderRow {\n  id: string;\n  name: string;\n  path?: string;\n  subFolders?: Array<{ id: string; name: string; path?: string; level?: number }>;\n  files?: Array<{ id: string; name: string; size?: number; mimeType?: string }>;\n}\n\ninterface FileRow {\n  id: string;\n  name: string;\n  size?: number;\n  mimeType?: string;\n  extension?: string;\n  createdAt?: string;\n  description?: string | null;\n  workspaceId?: string;\n  folderId?: string | null;\n  s3Key?: string;\n  s3Bucket?: string;\n  downloadUrl?: string | null;\n  status?: string;\n  visibility?: string;\n  starred?: boolean;\n  downloadCount?: number;\n  viewCount?: number;\n  sha256Hash?: string | null;\n  uploadedById?: string;\n  updatedAt?: string;\n  tags?: unknown;\n}\n\ninterface FileListRow {\n  files: FileRow[];\n  total: number;\n  page?: number;\n  limit?: number;\n  hasMore: boolean;\n}\n\ninterface FileShareRow {\n  id: string;\n  fileId?: string;\n  shareType?: string;\n  accessLevel?: string;\n  token?: string | null;\n  expiresAt?: string | null;\n  requiresPassword?: boolean;\n  downloadCount?: number;\n  maxDownloads?: number | null;\n  revokedAt?: string | null;\n  revokedBy?: string | null;\n}\n\ninterface UploadFileResponseRow {\n  file: FileRow;\n  uploadProgress?: number | null;\n  message?: string | null;\n}\n\nexport function registerFilesTools(\n  server: McpServer,\n  ctx: McpContext,\n  track: (n: string) => string,\n): void {\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_browse')),\n    {\n      title: 'Browse Folder',\n      description:\n        'Browse a workspace folder. Returns subfolders and paginated files. Omit folderId to browse the root.',\n      inputSchema: {\n        folderId: z.string().optional().describe('Folder ID (omit to browse root)'),\n        limit: z.number().optional().describe('Page size (default 100)'),\n        offset: z.number().optional().describe('Skip results'),\n      },\n    },\n    async ({ folderId, limit, offset }) => {\n      try {\n        const pagination: Record<string, unknown> = {};\n        if (limit !== undefined) pagination.limit = limit;\n        if (offset !== undefined) pagination.offset = offset;\n\n        const data = await ctx.gql.workspace.request<{\n          getFolder: FolderRow | null;\n          getFilesInFolder: { files: FileRow[]; total: number; hasMore: boolean };\n        }>(BROWSE_FOLDER, {\n          folderId: folderId ?? null,\n          pagination: Object.keys(pagination).length > 0 ? pagination : undefined,\n        });\n        return jsonResult({\n          folder: data.getFolder,\n          files: data.getFilesInFolder.files,\n          total: data.getFilesInFolder.total,\n          hasMore: data.getFilesInFolder.hasMore,\n        });\n      } catch (error) {\n        ctx.logger.error('files_browse failed', { error });\n        return errorResult(\n          `Failed to browse folder: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_upload_initiate')),\n    {\n      title: 'Initiate File Upload',\n      description:\n        'Initiate a multipart upload session. Returns presigned URL(s) the caller must PUT bytes to, plus a sessionId to use with files_upload_complete. MCP cannot read local files; the caller is responsible for streaming bytes to the returned URL(s).',\n      inputSchema: {\n        fileName: z.string().describe('File name including extension'),\n        fileSize: z.number().describe('File size in bytes'),\n        sha256Hash: z.string().describe('Hex SHA-256 of the file contents'),\n        mimeType: z.string().optional().describe('MIME type (default: application/octet-stream)'),\n        extension: z.string().optional().describe('File extension without leading dot'),\n        folderId: z.string().optional().describe('Target folder ID'),\n        visibility: VisibilityEnum.optional().describe('Visibility (default: WORKSPACE)'),\n      },\n    },\n    async ({ fileName, fileSize, sha256Hash, mimeType, extension, folderId, visibility }) => {\n      try {\n        const input: Record<string, unknown> = {\n          fileName,\n          fileSize,\n          sha256Hash,\n          mimeType: mimeType ?? 'application/octet-stream',\n          visibility: visibility ?? 'WORKSPACE',\n        };\n        if (extension !== undefined) input.extension = extension;\n        if (folderId !== undefined) input.folderId = folderId;\n\n        const data = await ctx.gql.workspace.request<{\n          initiateUpload: {\n            session: { id: string; fileName: string; fileSize: number };\n            uploadUrl?: string;\n            presignedUrls?: Array<{ partNumber: number; url: string; expiresAt?: string }>;\n            multipartUploadId?: string;\n          };\n        }>(INITIATE_UPLOAD, { input });\n        return jsonResult(data.initiateUpload);\n      } catch (error) {\n        ctx.logger.error('files_upload_initiate failed', { error });\n        return errorResult(\n          `Failed to initiate upload: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_upload_complete')),\n    {\n      title: 'Complete File Upload',\n      description:\n        'Complete an in-flight upload session previously initiated by files_upload_initiate.',\n      inputSchema: {\n        sessionId: z.string().describe('Session ID from files_upload_initiate'),\n        folderId: z.string().optional().describe('Target folder ID (overrides initiate)'),\n        description: z.string().optional().describe('File description'),\n      },\n    },\n    async ({ sessionId, folderId, description }) => {\n      try {\n        const input: Record<string, unknown> = { sessionId };\n        if (folderId !== undefined) input.folderId = folderId;\n        if (description !== undefined) input.description = description;\n\n        const data = await ctx.gql.workspace.request<{\n          completeUpload: { file: Record<string, unknown>; fileId: string };\n        }>(COMPLETE_UPLOAD, { input });\n        return jsonResult(data.completeUpload);\n      } catch (error) {\n        ctx.logger.error('files_upload_complete failed', { error });\n        return errorResult(\n          `Failed to complete upload: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_share_create')),\n    {\n      title: 'Create File Share',\n      description: 'Create a shareable link for a file with optional access controls.',\n      inputSchema: {\n        fileId: z.string().describe('File ID to share'),\n        access: ShareAccessEnum.optional().describe('Access level (default: DOWNLOAD)'),\n        expiresAt: z.string().optional().describe('Expiry timestamp in ISO 8601'),\n        password: z.string().optional().describe('Optional password to gate the share'),\n        maxDownloads: z.number().optional().describe('Maximum download count'),\n      },\n    },\n    async ({ fileId, access, expiresAt, password, maxDownloads }) => {\n      try {\n        const input: Record<string, unknown> = {\n          fileId,\n          shareType: 'PUBLIC_LINK',\n          accessLevel: access ?? 'DOWNLOAD',\n        };\n        if (expiresAt !== undefined) input.expiresAt = expiresAt;\n        if (password !== undefined) input.password = password;\n        if (maxDownloads !== undefined) input.maxDownloads = maxDownloads;\n\n        const data = await ctx.gql.workspace.request<{\n          createShare: Record<string, unknown>;\n        }>(CREATE_SHARE, { input });\n        return jsonResult(data.createShare);\n      } catch (error) {\n        ctx.logger.error('files_share_create failed', { error });\n        return errorResult(\n          `Failed to create share: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_share_revoke')),\n    {\n      title: 'Revoke File Share',\n      description: 'Revoke a previously created file share by ID.',\n      inputSchema: {\n        id: z.string().describe('Share ID to revoke'),\n      },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{\n          revokeShare: { id: string; revokedAt?: string; revokedBy?: string };\n        }>(REVOKE_SHARE, { id });\n        return jsonResult(data.revokeShare);\n      } catch (error) {\n        ctx.logger.error('files_share_revoke failed', { error });\n        return errorResult(\n          `Failed to revoke share: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  // ── SDK-parity surface ───────────────────────────────────────────────────\n  // The tools below mirror the SDK files API one-to-one. files_browse +\n  // files_upload_initiate/_complete + files_share_create/_revoke above are\n  // the workspace-native surface; these add the SDK's flat get/list/share/\n  // revoke/download/upload convenience entrypoints.\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_list')),\n    {\n      title: 'List Files',\n      description:\n        'List files in a workspace, optionally scoped to a folder. Returns { files, total, page, limit, hasMore }.',\n      inputSchema: {\n        folderId: z.string().optional().describe('Folder ID (omit to list workspace root)'),\n        limit: z.number().optional().describe('Page size (default 50)'),\n        offset: z.number().optional().describe('Skip results'),\n      },\n    },\n    async ({ folderId, limit, offset }) => {\n      try {\n        const pagination: Record<string, unknown> = {};\n        if (limit !== undefined) pagination.limit = limit;\n        if (offset !== undefined) pagination.offset = offset;\n        const data = await ctx.gql.workspace.request<{ getFiles: FileListRow }>(LIST_FILES, {\n          folderId: folderId ?? null,\n          pagination: Object.keys(pagination).length > 0 ? pagination : undefined,\n        });\n        return jsonResult(data.getFiles);\n      } catch (error) {\n        ctx.logger.error('files_list failed', { error });\n        return errorResult(\n          `Failed to list files: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_get')),\n    {\n      title: 'Get File',\n      description: 'Get a single file by ID. Returns the file record or an error if not found.',\n      inputSchema: { id: z.string().describe('File ID') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{ getFile: FileRow | null }>(GET_FILE, { id });\n        if (!data.getFile) return errorResult(`File ${id} not found`);\n        return jsonResult(data.getFile);\n      } catch (error) {\n        ctx.logger.error('files_get failed', { error });\n        return errorResult(\n          `Failed to get file: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_download')),\n    {\n      title: 'Get File Download URL',\n      description:\n        'Resolve a server-signed presigned download URL for a file. The MCP cannot stream binary bytes itself; callers must GET the returned URL out-of-band. Returns { url, expiresIn }.',\n      inputSchema: {\n        id: z.string().describe('File ID'),\n        expiresIn: z\n          .number()\n          .optional()\n          .describe('URL TTL in seconds (server default applies when omitted)'),\n      },\n    },\n    async ({ id, expiresIn }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{ getFileDownloadUrl: string }>(\n          GET_FILE_DOWNLOAD_URL,\n          { id, expiresIn },\n        );\n        return jsonResult({ url: data.getFileDownloadUrl, expiresIn: expiresIn ?? null });\n      } catch (error) {\n        ctx.logger.error('files_download failed', { error });\n        return errorResult(\n          `Failed to resolve download URL: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_upload')),\n    {\n      title: 'Upload File',\n      description:\n        'Single-shot file upload mirroring the SDK files.upload contract (s3Bucket/s3Key/size pre-resolved). For raw-byte uploads from MCP callers, prefer files_upload_initiate + files_upload_complete which use presigned URLs. Returns the persisted file record.',\n      inputSchema: {\n        name: z.string().describe('Display filename including extension'),\n        mimeType: z.string().describe('MIME type'),\n        extension: z.string().describe('File extension without leading dot'),\n        size: z.number().describe('File size in bytes'),\n        s3Bucket: z.string().describe('S3 bucket holding the uploaded object'),\n        s3Key: z.string().describe('S3 key under the bucket'),\n        description: z.string().optional().describe('File description'),\n        folderId: z.string().optional().describe('Target folder ID'),\n        visibility: VisibilityEnum.optional().describe('Visibility (default: WORKSPACE)'),\n        tags: z.unknown().optional().describe('Optional entity-owned tags JSON array'),\n      },\n    },\n    async ({\n      name,\n      mimeType,\n      extension,\n      size,\n      s3Bucket,\n      s3Key,\n      description,\n      folderId,\n      visibility,\n      tags,\n    }) => {\n      try {\n        const input: Record<string, unknown> = {\n          name,\n          mimeType,\n          extension,\n          size: String(size),\n          s3Bucket,\n          s3Key,\n        };\n        if (description !== undefined) input.description = description;\n        if (folderId !== undefined) input.folderId = folderId;\n        if (visibility !== undefined) input.visibility = visibility;\n        if (tags !== undefined) input.tags = tags;\n\n        const data = await ctx.gql.workspace.request<{ uploadFile: UploadFileResponseRow }>(\n          UPLOAD_FILE,\n          { input },\n        );\n        return jsonResult(data.uploadFile);\n      } catch (error) {\n        ctx.logger.error('files_upload failed', { error });\n        return errorResult(\n          `Failed to upload file: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_share')),\n    {\n      title: 'Share File',\n      description:\n        'Create a share for a file (mirrors SDK files.share). Returns the persisted FileShare record.',\n      inputSchema: {\n        fileId: z.string().describe('File ID to share'),\n        shareType: ShareTypeEnum.describe(\n          'Share type (PUBLIC_LINK = anonymous, EMAIL_INVITE = by email, GROUP_SHARE = by user IDs)',\n        ),\n        accessLevel: ShareAccessEnum.describe('Access level the share grants'),\n        expiresAt: z.string().optional().describe('Expiry timestamp in ISO 8601'),\n        password: z.string().optional().describe('Optional password to gate the share'),\n        maxDownloads: z.number().optional().describe('Maximum download count'),\n        invitedEmail: z.string().optional().describe('Email address for EMAIL_INVITE shares'),\n        invitedUserIds: z\n          .array(z.string())\n          .optional()\n          .describe('User IDs to grant access for GROUP_SHARE shares'),\n      },\n    },\n    async ({\n      fileId,\n      shareType,\n      accessLevel,\n      expiresAt,\n      password,\n      maxDownloads,\n      invitedEmail,\n      invitedUserIds,\n    }) => {\n      try {\n        const input: Record<string, unknown> = { fileId, shareType, accessLevel };\n        if (expiresAt !== undefined) input.expiresAt = expiresAt;\n        if (password !== undefined) input.password = password;\n        if (maxDownloads !== undefined) input.maxDownloads = maxDownloads;\n        if (invitedEmail !== undefined) input.invitedEmail = invitedEmail;\n        if (invitedUserIds !== undefined) input.invitedUserIds = invitedUserIds;\n\n        const data = await ctx.gql.workspace.request<{ createShare: FileShareRow }>(CREATE_SHARE, {\n          input,\n        });\n        return jsonResult(data.createShare);\n      } catch (error) {\n        ctx.logger.error('files_share failed', { error });\n        return errorResult(\n          `Failed to share file: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n\n  server.registerTool(\n    track(mcpToolName(ctx.productName, 'files_revoke')),\n    {\n      title: 'Revoke File Share',\n      description:\n        'Revoke an existing file share by ID (mirrors SDK files.shareApi.revoke). Returns the updated share record with revokedAt/revokedBy set.',\n      inputSchema: { id: z.string().describe('Share ID to revoke') },\n    },\n    async ({ id }) => {\n      try {\n        const data = await ctx.gql.workspace.request<{ revokeShare: FileShareRow }>(REVOKE_SHARE, {\n          id,\n        });\n        return jsonResult(data.revokeShare);\n      } catch (error) {\n        ctx.logger.error('files_revoke failed', { error });\n        return errorResult(\n          `Failed to revoke share: ${error instanceof Error ? error.message : String(error)}`,\n        );\n      }\n    },\n  );\n}\n","/**\n * Files module — workspace file browse, upload (initiate/complete), and share\n * (<product>_files_{browse,upload_initiate,upload_complete,share_create,share_revoke}).\n *\n * Backend: ~/products/wspace/files/wspace-files-svc/.\n * Ported from cli-sdk/src/modules/files/.\n */\n\nimport type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { McpContext, McpModule, ModuleRegistration } from '../../core/index.js';\nimport { registerFilesTools } from './tools.js';\n\nconst filesModule: McpModule = {\n  id: 'files',\n  version: '0.0.1',\n  displayName: 'Files',\n  dependsOn: ['auth'],\n  capabilities: { tools: {} },\n\n  register(server: McpServer, ctx: McpContext): ModuleRegistration {\n    const tools: string[] = [];\n    const track = (n: string): string => {\n      tools.push(n);\n      return n;\n    };\n\n    registerFilesTools(server, ctx, track);\n\n    return { tools, resources: [], prompts: [] };\n  },\n};\n\nexport default filesModule;\n"]}