@andrzejchm/notion-cli 0.10.0 → 0.12.0

package/dist/cli.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import { readFileSync } from "fs";
-import { dirname, join as join3 } from "path";
+import { readFileSync as readFileSync2 } from "fs";
+import { dirname as dirname2, join as join4 } from "path";
 import { fileURLToPath } from "url";
-import { Command as Command25 } from "commander";
+import { Command as Command27 } from "commander";
 
 // src/commands/append.ts
 import { Command } from "commander";
@@ -542,7 +542,196 @@ function reportTokenSource(source) {
   stderrWrite(dim(`Using token from ${source}`));
 }
 
+// src/services/upload.service.ts
+import { createReadStream, existsSync, statSync } from "fs";
+import { basename, extname } from "path";
+var PART_SIZE = 20 * 1024 * 1024;
+var MIME_MAP = {
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".gif": "image/gif",
+  ".webp": "image/webp",
+  ".svg": "image/svg+xml",
+  ".bmp": "image/bmp",
+  ".ico": "image/x-icon",
+  ".tiff": "image/tiff",
+  ".tif": "image/tiff",
+  ".heic": "image/heic",
+  ".avif": "image/avif",
+  ".pdf": "application/pdf",
+  ".mp3": "audio/mpeg",
+  ".wav": "audio/wav",
+  ".ogg": "audio/ogg",
+  ".m4a": "audio/mp4",
+  ".flac": "audio/flac",
+  ".aac": "audio/aac",
+  ".mp4": "video/mp4",
+  ".mov": "video/quicktime",
+  ".avi": "video/x-msvideo",
+  ".webm": "video/webm",
+  ".mkv": "video/x-matroska",
+  ".csv": "text/csv",
+  ".json": "application/json",
+  ".txt": "text/plain",
+  ".md": "text/markdown",
+  ".html": "text/html",
+  ".xml": "application/xml",
+  ".zip": "application/zip",
+  ".gz": "application/gzip",
+  ".doc": "application/msword",
+  ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  ".xls": "application/vnd.ms-excel",
+  ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ".ppt": "application/vnd.ms-powerpoint",
+  ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation"
+};
+function detectMimeType(filePath) {
+  const ext = extname(filePath).toLowerCase();
+  return MIME_MAP[ext] ?? "application/octet-stream";
+}
+function resolveBlockType(contentType) {
+  const base = contentType.split(";")[0].trim().toLowerCase();
+  if (base.startsWith("image/")) return "image";
+  if (base.startsWith("audio/")) return "audio";
+  if (base.startsWith("video/")) return "video";
+  if (base === "application/pdf") return "pdf";
+  return "file";
+}
+async function readStreamChunk(filePath, start, end) {
+  return new Promise((resolve, reject) => {
+    const chunks = [];
+    const stream = createReadStream(filePath, { start, end });
+    stream.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+    stream.on("end", () => resolve(Buffer.concat(chunks)));
+    stream.on("error", reject);
+  });
+}
+async function uploadSinglePart(client, filePath, filename, contentType, fileSize) {
+  const upload = await client.fileUploads.create({
+    mode: "single_part",
+    filename,
+    content_type: contentType
+  });
+  const data = await readStreamChunk(filePath, 0, fileSize - 1);
+  const blob = new Blob(
+    [
+      data.buffer.slice(
+        data.byteOffset,
+        data.byteOffset + data.byteLength
+      )
+    ],
+    { type: contentType }
+  );
+  await client.fileUploads.send({
+    file_upload_id: upload.id,
+    file: { data: blob, filename }
+  });
+  return upload.id;
+}
+async function uploadMultiPart(client, filePath, filename, contentType, fileSize) {
+  const numberOfParts = Math.ceil(fileSize / PART_SIZE);
+  const upload = await client.fileUploads.create({
+    mode: "multi_part",
+    filename,
+    content_type: contentType,
+    number_of_parts: numberOfParts
+  });
+  for (let part = 0; part < numberOfParts; part++) {
+    const start = part * PART_SIZE;
+    const end = Math.min(start + PART_SIZE, fileSize) - 1;
+    const data = await readStreamChunk(filePath, start, end);
+    const blob = new Blob(
+      [
+        data.buffer.slice(
+          data.byteOffset,
+          data.byteOffset + data.byteLength
+        )
+      ],
+      { type: contentType }
+    );
+    await client.fileUploads.send({
+      file_upload_id: upload.id,
+      file: { data: blob, filename },
+      part_number: String(part + 1)
+    });
+  }
+  await client.fileUploads.complete({ file_upload_id: upload.id });
+  return upload.id;
+}
+async function uploadFile(client, filePath) {
+  const filename = basename(filePath);
+  const contentType = detectMimeType(filePath);
+  const { size: fileSize } = statSync(filePath);
+  if (fileSize === 0) {
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      `Cannot upload empty file: ${filename}`,
+      "Provide a file with content"
+    );
+  }
+  const fileUploadId = fileSize <= PART_SIZE ? await uploadSinglePart(
+    client,
+    filePath,
+    filename,
+    contentType,
+    fileSize
+  ) : await uploadMultiPart(
+    client,
+    filePath,
+    filename,
+    contentType,
+    fileSize
+  );
+  return { fileUploadId, filename, contentType };
+}
+function buildFileBlock(fileUploadId, blockType, caption) {
+  const captionRichText = caption ? [{ type: "text", text: { content: caption } }] : [];
+  const fileContent = {
+    file_upload: { id: fileUploadId },
+    type: "file_upload",
+    caption: captionRichText
+  };
+  switch (blockType) {
+    case "image":
+      return { type: "image", image: fileContent };
+    case "audio":
+      return { type: "audio", audio: fileContent };
+    case "video":
+      return { type: "video", video: fileContent };
+    case "pdf":
+      return { type: "pdf", pdf: fileContent };
+    case "file":
+      return { type: "file", file: fileContent };
+    default:
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Unknown block type: ${blockType}`,
+        "Valid types are: image, file, pdf, audio, video"
+      );
+  }
+}
+async function uploadFilesAsBlocks(files, opts, client) {
+  for (const filePath of files) {
+    if (!existsSync(filePath)) {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `File not found: ${filePath}`,
+        "Provide a valid file path"
+      );
+    }
+  }
+  return Promise.all(
+    files.map(async (filePath) => {
+      const result = await uploadFile(client, filePath);
+      const blockType = opts.type ?? resolveBlockType(result.contentType);
+      return buildFileBlock(result.fileUploadId, blockType, opts.caption);
+    })
+  );
+}
+
 // src/services/write.service.ts
+import { existsSync as existsSync2 } from "fs";
 async function addComment(client, target, text, options = {}) {
   const richText = [
     {
@@ -661,22 +850,44 @@ async function replaceMarkdown(client, pageId, newMarkdown, options) {
     }
   });
 }
-function buildIconCover(options) {
+async function buildIconCover(client, options) {
   const result = {};
   if (options?.icon) {
     const isUrl = /^https?:\/\//i.test(options.icon);
     if (isUrl) {
       result.icon = { type: "external", external: { url: options.icon } };
+    } else if (existsSync2(options.icon)) {
+      const uploaded = await uploadFile(client, options.icon);
+      result.icon = {
+        type: "file_upload",
+        file_upload: { id: uploaded.fileUploadId }
+      };
     } else {
       result.icon = { type: "emoji", emoji: options.icon };
     }
   }
   if (options?.cover) {
-    result.cover = { type: "external", external: { url: options.cover } };
+    const isUrl = /^https?:\/\//i.test(options.cover);
+    if (isUrl) {
+      result.cover = { type: "external", external: { url: options.cover } };
+    } else if (existsSync2(options.cover)) {
+      const uploaded = await uploadFile(client, options.cover);
+      result.cover = {
+        type: "file_upload",
+        file_upload: { id: uploaded.fileUploadId }
+      };
+    } else {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Cover not found: "${options.cover}" is not a valid URL or existing file path.`,
+        "Provide an http(s):// URL or a valid local file path for --cover"
+      );
+    }
   }
   return result;
 }
 async function createPage(client, parentId, title, markdown, options) {
+  const iconCover = await buildIconCover(client, options);
   const response = await client.pages.create({
     parent: { type: "page_id", page_id: parentId },
     properties: {
@@ -685,7 +896,7 @@ async function createPage(client, parentId, title, markdown, options) {
       }
     },
     ...markdown.trim() ? { markdown } : {},
-    ...buildIconCover(options)
+    ...iconCover
   });
   const url = "url" in response ? response.url : response.id;
   return url;
@@ -697,11 +908,12 @@ async function createPageInDatabase(client, databaseId, titlePropName, title, ex
       title: [{ type: "text", text: { content: title, link: null } }]
     }
   };
+  const iconCover = await buildIconCover(client, options);
   const response = await client.pages.create({
     parent: { type: "database_id", database_id: databaseId },
     properties,
     ...markdown.trim() ? { markdown } : {},
-    ...buildIconCover(options)
+    ...iconCover
   });
   const url = "url" in response ? response.url : response.id;
   return url;
@@ -717,54 +929,92 @@ async function readStdin() {
 }
 
 // src/commands/append.ts
+function collectFiles(val, acc) {
+  acc.push(val);
+  return acc;
+}
+async function resolveMarkdown(message, hasFiles) {
+  if (message) return message;
+  if (!process.stdin.isTTY && !hasFiles) return readStdin();
+  if (!hasFiles) {
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      "No content to append.",
+      "Pass markdown via -m/--message, pipe it through stdin, or use --file to attach files"
+    );
+  }
+  return "";
+}
+async function appendMarkdownWithErrorHandling(client, uuid, markdown, after) {
+  try {
+    await appendMarkdown(client, uuid, markdown, after ? { after } : void 0);
+  } catch (error2) {
+    if (after && isNotionValidationError(error2)) {
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Selector not found: "${after}". ${error2.message}`,
+        SELECTOR_HINT,
+        error2
+      );
+    }
+    throw error2;
+  }
+}
+async function appendFileBlocks(client, uuid, filePaths) {
+  const blocks = await uploadFilesAsBlocks(filePaths, {}, client);
+  await client.blocks.children.append({
+    block_id: uuid,
+    children: blocks
+  });
+}
 function appendCommand() {
   const cmd = new Command("append");
   cmd.description("append markdown content to a Notion page").argument("<id/url>", "Notion page ID or URL").option("-m, --message <markdown>", "markdown content to append").option(
     "--after <selector>",
     'insert after matched content \u2014 ellipsis selector, e.g. "## Section...end of section"'
+  ).option(
+    "--file <path>",
+    "attach a local file to the page (repeatable)",
+    collectFiles,
+    []
   ).action(
     withErrorHandling(
       async (idOrUrl, opts) => {
         const { token, source } = await resolveToken();
         reportTokenSource(source);
         const client = createNotionClient(token);
-        let markdown = "";
-        if (opts.message) {
-          markdown = opts.message;
-        } else if (!process.stdin.isTTY) {
-          markdown = await readStdin();
-        } else {
+        const hasFiles = opts.file.length > 0;
+        const markdown = await resolveMarkdown(opts.message, hasFiles);
+        const uuid = toUuid(parseNotionId(idOrUrl));
+        if (opts.after && !markdown.trim()) {
           throw new CliError(
             ErrorCodes.INVALID_ARG,
-            "No content to append.",
-            "Pass markdown via -m/--message or pipe it through stdin"
+            "--after requires markdown content (-m or stdin)",
+            "Provide markdown via -m/--message or pipe it through stdin"
           );
         }
-        if (!markdown.trim()) {
-          process.stdout.write("Nothing to append.\n");
-          return;
-        }
-        const pageId = parseNotionId(idOrUrl);
-        const uuid = toUuid(pageId);
-        try {
-          await appendMarkdown(
+        if (markdown.trim()) {
+          await appendMarkdownWithErrorHandling(
             client,
             uuid,
             markdown,
-            opts.after ? { after: opts.after } : void 0
+            opts.after
           );
-        } catch (error2) {
-          if (opts.after && isNotionValidationError(error2)) {
-            throw new CliError(
-              ErrorCodes.INVALID_ARG,
-              `Selector not found: "${opts.after}". ${error2.message}`,
-              SELECTOR_HINT,
-              error2
-            );
-          }
-          throw error2;
         }
-        process.stdout.write("Appended.\n");
+        if (hasFiles) {
+          await appendFileBlocks(client, uuid, opts.file);
+        }
+        if (hasFiles && markdown.trim()) {
+          process.stdout.write(
+            `Appended and attached ${opts.file.length} file(s).
+`
+          );
+        } else if (hasFiles) {
+          process.stdout.write(`Attached ${opts.file.length} file(s).
+`);
+        } else {
+          process.stdout.write("Appended.\n");
+        }
       }
     )
   );
@@ -867,6 +1117,49 @@ function archiveCommand() {
   return cmd;
 }
 
+// src/commands/attach.ts
+import { Command as Command3, Option } from "commander";
+function attachCommand() {
+  const cmd = new Command3("attach");
+  cmd.description("upload and attach file(s) to a Notion page").argument("<id/url>", "Notion page ID or URL").argument("<file>", "file to attach").argument("[files...]", "additional files to attach").option("--caption <text>", "caption for the file block(s)").addOption(
+    new Option(
+      "--type <type>",
+      "override auto-detected block type (image|file|pdf|audio|video)"
+    ).choices(["image", "file", "pdf", "audio", "video"])
+  ).action(
+    withErrorHandling(
+      async (idOrUrl, firstFile, extraFiles, opts) => {
+        const { token, source } = await resolveToken();
+        reportTokenSource(source);
+        const client = createNotionClient(token);
+        const pageId = toUuid(parseNotionId(idOrUrl));
+        const allFiles = [firstFile, ...extraFiles];
+        const blocks = await uploadFilesAsBlocks(
+          allFiles,
+          { caption: opts.caption, type: opts.type },
+          client
+        );
+        const response = await client.blocks.children.append({
+          block_id: pageId,
+          children: blocks
+        });
+        const mode = getOutputMode();
+        if (mode === "json") {
+          process.stdout.write(`${formatJSON(response)}
+`);
+        } else {
+          const pageUrl = `https://www.notion.so/${parseNotionId(idOrUrl)}`;
+          process.stdout.write(
+            `Attached ${allFiles.length} file(s) to ${pageUrl}
+`
+          );
+        }
+      }
+    )
+  );
+  return cmd;
+}
+
 // src/commands/auth/index.ts
 function authDefaultAction(authCmd2) {
   return async () => {
@@ -876,7 +1169,7 @@ function authDefaultAction(authCmd2) {
 
 // src/commands/auth/login.ts
 import { input } from "@inquirer/prompts";
-import { Command as Command3 } from "commander";
+import { Command as Command4 } from "commander";
 
 // src/oauth/oauth-flow.ts
 import { spawn } from "child_process";
@@ -1123,7 +1416,7 @@ Waiting for callback (up to 120 seconds)...
 
 // src/commands/auth/login.ts
 function loginCommand() {
-  const cmd = new Command3("login");
+  const cmd = new Command4("login");
   cmd.description("authenticate with Notion via OAuth").option("--profile <name>", "profile name to store credentials in").option(
     "--manual",
     "print auth URL instead of opening browser (for headless OAuth)"
@@ -1186,7 +1479,7 @@ function loginCommand() {
 
 // src/commands/auth/logout.ts
 import { select } from "@inquirer/prompts";
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 function profileLabel(name, profile) {
   const parts = [];
   if (profile.oauth_access_token)
@@ -1199,7 +1492,7 @@ function profileLabel(name, profile) {
   return `${bold(name)}  ${dim(authDesc)}${workspace}`;
 }
 function logoutCommand() {
-  const cmd = new Command4("logout");
+  const cmd = new Command5("logout");
   cmd.description("remove a profile and its credentials").option(
     "--profile <name>",
     "profile name to remove (skips interactive selector)"
@@ -1257,9 +1550,9 @@ function logoutCommand() {
 }
 
 // src/commands/auth/status.ts
-import { Command as Command5 } from "commander";
+import { Command as Command6 } from "commander";
 function statusCommand() {
-  const cmd = new Command5("status");
+  const cmd = new Command6("status");
   cmd.description("show authentication status for the active profile").option("--profile <name>", "profile name to check").action(
     withErrorHandling(async (opts) => {
       let profileName = opts.profile;
@@ -1317,7 +1610,7 @@ function statusCommand() {
 }
 
 // src/commands/comment-add.ts
-import { Command as Command6 } from "commander";
+import { Command as Command7 } from "commander";
 function resolveTarget(idOrUrl, opts) {
   const targetCount = [idOrUrl, opts.replyTo, opts.block].filter(
     Boolean
@@ -1345,7 +1638,7 @@ function resolveTarget(idOrUrl, opts) {
   );
 }
 function commentAddCommand() {
-  const cmd = new Command6("comment");
+  const cmd = new Command7("comment");
   cmd.description("add a comment to a Notion page, block, or discussion thread").argument("[id/url]", "Notion page ID or URL").requiredOption("-m, --message <text>", "comment text to post").option(
     "--reply-to <discussion-id>",
     "reply to an existing discussion thread"
@@ -1367,7 +1660,7 @@ function commentAddCommand() {
 }
 
 // src/commands/comments.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/output/paginate.ts
 async function paginateResults(fetcher) {
@@ -1393,7 +1686,7 @@ function formatParent(parent) {
   }
 }
 function commentsCommand() {
-  const cmd = new Command7("comments");
+  const cmd = new Command8("comments");
   cmd.description("list comments on a Notion page").argument("<id/url>", "Notion page ID or URL").option("--json", "output as JSON").action(
     withErrorHandling(async (idOrUrl, opts) => {
       if (opts.json) setOutputMode("json");
@@ -1430,13 +1723,13 @@ function commentsCommand() {
 }
 
 // src/commands/completion.ts
-import { Command as Command8 } from "commander";
+import { Command as Command9 } from "commander";
 var BASH_COMPLETION = `# notion bash completion
 _notion_completion() {
   local cur prev words cword
   _init_completion || return
 
-  local commands="init profile completion --help --version --verbose --color"
+  local commands="init profile completion skill --help --version --verbose --color"
   local profile_commands="list use remove"
 
   case "$prev" in
@@ -1469,6 +1762,7 @@ _notion() {
     'init:authenticate with Notion and save a profile'
     'profile:manage authentication profiles'
     'completion:output shell completion script'
+    'skill:install the agent skill file'
   )
 
   local -a global_opts
@@ -1520,6 +1814,7 @@ complete -c notion -l color -d 'force color output'
 complete -c notion -n '__fish_use_subcommand' -a init -d 'authenticate with Notion and save a profile'
 complete -c notion -n '__fish_use_subcommand' -a profile -d 'manage authentication profiles'
 complete -c notion -n '__fish_use_subcommand' -a completion -d 'output shell completion script'
+complete -c notion -n '__fish_use_subcommand' -a skill -d 'install the agent skill file'
 
 # profile subcommands
 complete -c notion -n '__fish_seen_subcommand_from profile' -a list -d 'list all authentication profiles'
@@ -1532,7 +1827,7 @@ complete -c notion -n '__fish_seen_subcommand_from completion' -a zsh -d 'zsh co
 complete -c notion -n '__fish_seen_subcommand_from completion' -a fish -d 'fish completion script'
 `;
 function completionCommand() {
-  const cmd = new Command8("completion");
+  const cmd = new Command9("completion");
   cmd.description("output shell completion script").argument("<shell>", "shell type (bash, zsh, fish)").action(
     withErrorHandling(async (shell) => {
       switch (shell) {
@@ -1558,7 +1853,7 @@ function completionCommand() {
 }
 
 // src/commands/create-page.ts
-import { Command as Command9 } from "commander";
+import { Command as Command10 } from "commander";
 
 // src/services/database.service.ts
 import { isFullPage } from "@notionhq/client";
@@ -1846,6 +2141,7 @@ function displayPropertyValue(prop) {
 }
 
 // src/services/update.service.ts
+import { existsSync as existsSync3 } from "fs";
 var UNSUPPORTED_TYPES = /* @__PURE__ */ new Set([
   "relation",
   "formula",
@@ -1854,7 +2150,6 @@ var UNSUPPORTED_TYPES = /* @__PURE__ */ new Set([
   "created_by",
   "last_edited_time",
   "last_edited_by",
-  "files",
   "unique_id",
   "verification",
   "button"
@@ -1864,7 +2159,7 @@ function buildPropertyUpdate(propName, propType, value) {
     throw new CliError(
       ErrorCodes.INVALID_ARG,
       `Property "${propName}" has type "${propType}" which cannot be set via the CLI.`,
-      "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date"
+      "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date, files"
     );
   }
   if (value === "") {
@@ -1910,41 +2205,54 @@ function buildPropertyUpdate(propName, propType, value) {
       const end = parts[1]?.trim();
       return { date: end ? { start, end } : { start } };
     }
+    case "files":
+      throw new CliError(
+        ErrorCodes.INVALID_ARG,
+        `Property "${propName}" has type "files" which requires async upload \u2014 use buildPropertiesPayloadAsync instead.`,
+        "Use buildPropertiesPayloadAsync with a Notion client to handle file uploads"
+      );
     default:
       throw new CliError(
         ErrorCodes.INVALID_ARG,
         `Property "${propName}" has unsupported type "${propType}".`,
-        "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date"
+        "Supported types: title, rich_text, select, status, multi_select, number, checkbox, url, email, phone_number, date, files"
       );
   }
 }
-function buildPropertiesPayload(propStrings, schemaOrPage) {
+function normalizeSchema(schemaOrPage) {
   const isPage = "object" in schemaOrPage && schemaOrPage.object === "page";
-  const schema = isPage ? schemaOrPage.properties : schemaOrPage;
+  return isPage ? schemaOrPage.properties : schemaOrPage;
+}
+function parsePropString(propString) {
+  const eqIdx = propString.indexOf("=");
+  if (eqIdx === -1) {
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      `Invalid --prop value: "${propString}". Expected format: "PropertyName=Value".`,
+      'Example: --prop "Status=Done"'
+    );
+  }
+  return [propString.slice(0, eqIdx).trim(), propString.slice(eqIdx + 1)];
+}
+function lookupSchemaProp(propName, schema) {
+  const schemaProp = schema[propName];
+  if (!schemaProp) {
+    const available = Object.keys(schema).join(", ");
+    throw new CliError(
+      ErrorCodes.INVALID_ARG,
+      `Property "${propName}" not found on this page.`,
+      `Available properties: ${available}`
+    );
+  }
+  return schemaProp;
+}
+function buildPropertiesPayload(propStrings, schemaOrPage) {
+  const schema = normalizeSchema(schemaOrPage);
   const result = {};
   for (const propString of propStrings) {
-    const eqIdx = propString.indexOf("=");
-    if (eqIdx === -1) {
-      throw new CliError(
-        ErrorCodes.INVALID_ARG,
-        `Invalid --prop value: "${propString}". Expected format: "PropertyName=Value".`,
-        'Example: --prop "Status=Done"'
-      );
-    }
-    const propName = propString.slice(0, eqIdx).trim();
-    const value = propString.slice(eqIdx + 1);
-    const schemaProp = schema[propName];
-    if (!schemaProp) {
-      const available = Object.keys(schema).join(", ");
-      throw new CliError(
-        ErrorCodes.INVALID_ARG,
-        `Property "${propName}" not found on this page.`,
-        `Available properties: ${available}`
-      );
-    }
-    const propType = schemaProp.type;
-    const payload = buildPropertyUpdate(propName, propType, value);
-    result[propName] = payload;
+    const [propName, value] = parsePropString(propString);
+    const schemaProp = lookupSchemaProp(propName, schema);
+    result[propName] = buildPropertyUpdate(propName, schemaProp.type, value);
   }
   return result;
 }
@@ -1957,7 +2265,7 @@ async function updatePageProperties(client, pageId, properties) {
 }
 
 // src/commands/create-page.ts
-function collectProps(val, acc) {
+function collectValues(val, acc) {
   acc.push(val);
   return acc;
 }
@@ -1969,16 +2277,21 @@ async function tryGetDatabaseSchema(client, uuid) {
   }
 }
 function createPageCommand() {
-  const cmd = new Command9("create-page");
+  const cmd = new Command10("create-page");
   cmd.description("create a new Notion page under a parent page or database").requiredOption("--parent <id/url>", "parent page or database ID/URL").requiredOption("--title <title>", "page title").option(
     "-m, --message <markdown>",
     "inline markdown content for the page body"
   ).option(
     "--prop <property=value>",
     "set a property value (repeatable, database parents only)",
-    collectProps,
+    collectValues,
     []
-  ).option("--icon <emoji-or-url>", "page icon \u2014 emoji character or image URL").option("--cover <url>", "page cover image URL").action(
+  ).option("--icon <emoji-or-url>", "page icon \u2014 emoji character or image URL").option("--cover <url>", "page cover image URL").option(
+    "--file <path>",
+    "attach a local file to the page after creation (repeatable)",
+    collectValues,
+    []
+  ).action(
     withErrorHandling(async (opts) => {
       const { token, source } = await resolveToken();
       reportTokenSource(source);
@@ -1986,12 +2299,13 @@ function createPageCommand() {
       let markdown = "";
       if (opts.message) {
         markdown = opts.message;
-      } else if (!process.stdin.isTTY) {
+      } else if (!process.stdin.isTTY && opts.file.length === 0) {
         markdown = await readStdin();
       }
       const parentUuid = toUuid(parseNotionId(opts.parent));
       const iconCover = { icon: opts.icon, cover: opts.cover };
       const dbSchema = await tryGetDatabaseSchema(client, parentUuid);
+      let createdPageUrl;
       if (dbSchema) {
         const titleEntry = Object.entries(dbSchema.properties).find(
           ([, prop]) => prop.type === "title"
@@ -2005,7 +2319,7 @@ function createPageCommand() {
         }
         const [titlePropName] = titleEntry;
         const extraProperties = opts.prop.length > 0 ? buildPropertiesPayload(opts.prop, dbSchema.properties) : {};
-        const url = await createPageInDatabase(
+        createdPageUrl = await createPageInDatabase(
           client,
           dbSchema.databaseId,
           titlePropName,
@@ -2014,8 +2328,6 @@ function createPageCommand() {
           markdown,
           iconCover
         );
-        process.stdout.write(`${url}
-`);
       } else {
         if (opts.prop.length > 0) {
           throw new CliError(
@@ -2024,32 +2336,40 @@ function createPageCommand() {
             "To set properties, use a database ID/URL as --parent"
           );
         }
-        const url = await createPage(
+        createdPageUrl = await createPage(
           client,
           parentUuid,
           opts.title,
           markdown,
           iconCover
         );
-        process.stdout.write(`${url}
-`);
       }
+      if (opts.file.length > 0) {
+        const createdPageId = toUuid(parseNotionId(createdPageUrl));
+        const blocks = await uploadFilesAsBlocks(opts.file, {}, client);
+        await client.blocks.children.append({
+          block_id: createdPageId,
+          children: blocks
+        });
+      }
+      process.stdout.write(`${createdPageUrl}
+`);
     })
   );
   return cmd;
 }
 
 // src/commands/db/create.ts
-import { Command as Command10 } from "commander";
-function collectProps2(val, acc) {
+import { Command as Command11 } from "commander";
+function collectProps(val, acc) {
   acc.push(val);
   return acc;
 }
 function dbCreateCommand() {
-  return new Command10("create").description("Create a new database under a parent page").requiredOption("--parent <id/url>", "parent page ID or URL").requiredOption("--title <title>", "database title").option(
+  return new Command11("create").description("Create a new database under a parent page").requiredOption("--parent <id/url>", "parent page ID or URL").requiredOption("--title <title>", "database title").option(
     "--prop <definition>",
     'property definition (repeatable): --prop "Name:type:options"',
-    collectProps2,
+    collectProps,
     []
   ).action(
     withErrorHandling(async (opts) => {
@@ -2078,7 +2398,7 @@ function dbCreateCommand() {
 }
 
 // src/commands/db/query.ts
-import { Command as Command11 } from "commander";
+import { Command as Command12 } from "commander";
 var SKIP_TYPES_IN_AUTO = /* @__PURE__ */ new Set(["relation", "rich_text", "people"]);
 function autoSelectColumns(schema, entries) {
   const termWidth = process.stdout.columns || 120;
@@ -2106,7 +2426,7 @@ function autoSelectColumns(schema, entries) {
   return selected;
 }
 function dbQueryCommand() {
-  return new Command11("query").description("Query database entries with optional filtering and sorting").argument("<id>", "Notion database ID or URL").option(
+  return new Command12("query").description("Query database entries with optional filtering and sorting").argument("<id>", "Notion database ID or URL").option(
     "--filter <filter>",
     'Filter entries (repeatable): --filter "Status=Done"',
     collect,
@@ -2161,9 +2481,9 @@ function collect(value, previous) {
 }
 
 // src/commands/db/schema.ts
-import { Command as Command12 } from "commander";
+import { Command as Command13 } from "commander";
 function dbSchemaCommand() {
-  return new Command12("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").action(
+  return new Command13("schema").description("Show database schema (property names, types, and options)").argument("<id>", "Notion database ID or URL").action(
     withErrorHandling(async (id) => {
       const { token } = await resolveToken();
       const client = createNotionClient(token);
@@ -2187,13 +2507,13 @@ function dbSchemaCommand() {
 }
 
 // src/commands/edit-page.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 function collect2(val, acc) {
   acc.push(val);
   return acc;
 }
 function editPageCommand() {
-  const cmd = new Command13("edit-page");
+  const cmd = new Command14("edit-page");
   cmd.description(
     "replace a Notion page's content \u2014 full page or a targeted section"
   ).argument("<id/url>", "Notion page ID or URL").option(
@@ -2291,7 +2611,7 @@ function editPageCommand() {
 
 // src/commands/init.ts
 import { confirm, input as input2, password } from "@inquirer/prompts";
-import { Command as Command14 } from "commander";
+import { Command as Command15 } from "commander";
 async function runInitFlow() {
   const profileName = await input2({
     message: "Profile name:",
@@ -2371,7 +2691,7 @@ async function runInitFlow() {
   stderrWrite(dim("  notion auth login"));
 }
 function initCommand() {
-  const cmd = new Command14("init");
+  const cmd = new Command15("init");
   cmd.description("authenticate with Notion and save a profile").action(
     withErrorHandling(async () => {
       if (!process.stdin.isTTY) {
@@ -2389,7 +2709,7 @@ function initCommand() {
 
 // src/commands/ls.ts
 import { isFullPageOrDataSource } from "@notionhq/client";
-import { Command as Command15 } from "commander";
+import { Command as Command16 } from "commander";
 function getTitle(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -2406,7 +2726,7 @@ function displayType(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function lsCommand() {
-  const cmd = new Command15("ls");
+  const cmd = new Command16("ls");
   cmd.description("list accessible Notion pages and databases").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -2480,9 +2800,9 @@ function lsCommand() {
 }
 
 // src/commands/move.ts
-import { Command as Command16 } from "commander";
+import { Command as Command17 } from "commander";
 function moveCommand() {
-  const cmd = new Command16("move");
+  const cmd = new Command17("move");
   cmd.description("move pages to a new parent").argument("<ids/urls...>", "Notion page IDs or URLs to move").option("--to <id/url>", "target page parent ID or URL").option(
     "--to-db <id/url>",
     "target database parent ID or URL (resolves to data source)"
@@ -2540,10 +2860,10 @@ function moveCommand() {
 // src/commands/open.ts
 import { exec } from "child_process";
 import { promisify } from "util";
-import { Command as Command17 } from "commander";
+import { Command as Command18 } from "commander";
 var execAsync = promisify(exec);
 function openCommand() {
-  const cmd = new Command17("open");
+  const cmd = new Command18("open");
   cmd.description("open a Notion page in the default browser").argument("<id/url>", "Notion page ID or URL").action(
     withErrorHandling(async (idOrUrl) => {
       const id = parseNotionId(idOrUrl);
@@ -2559,9 +2879,9 @@ function openCommand() {
 }
 
 // src/commands/profile/list.ts
-import { Command as Command18 } from "commander";
+import { Command as Command19 } from "commander";
 function profileListCommand() {
-  const cmd = new Command18("list");
+  const cmd = new Command19("list");
   cmd.description("list all authentication profiles").action(
     withErrorHandling(async () => {
       const config = await readGlobalConfig();
@@ -2590,9 +2910,9 @@ function profileListCommand() {
 }
 
 // src/commands/profile/remove.ts
-import { Command as Command19 } from "commander";
+import { Command as Command20 } from "commander";
 function profileRemoveCommand() {
-  const cmd = new Command19("remove");
+  const cmd = new Command20("remove");
   cmd.description("remove an authentication profile").argument("<name>", "profile name to remove").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2618,9 +2938,9 @@ function profileRemoveCommand() {
 }
 
 // src/commands/profile/use.ts
-import { Command as Command20 } from "commander";
+import { Command as Command21 } from "commander";
 function profileUseCommand() {
-  const cmd = new Command20("use");
+  const cmd = new Command21("use");
   cmd.description("switch the active profile").argument("<name>", "profile name to activate").action(
     withErrorHandling(async (name) => {
       const config = await readGlobalConfig();
@@ -2643,7 +2963,7 @@ function profileUseCommand() {
 }
 
 // src/commands/read.ts
-import { Command as Command21 } from "commander";
+import { Command as Command22 } from "commander";
 
 // src/output/markdown.ts
 import { Chalk as Chalk2 } from "chalk";
@@ -2783,7 +3103,7 @@ async function fetchPageMarkdown(client, pageId) {
 
 // src/commands/read.ts
 function readCommand() {
-  return new Command21("read").description("Read a Notion page as markdown").argument("<id>", "Notion page ID or URL").action(
+  return new Command22("read").description("Read a Notion page as markdown").argument("<id>", "Notion page ID or URL").action(
     withErrorHandling(async (id) => {
       const { token } = await resolveToken();
       const client = createNotionClient(token);
@@ -2809,7 +3129,7 @@ function readCommand() {
 
 // src/commands/search.ts
 import { isFullPageOrDataSource as isFullPageOrDataSource2 } from "@notionhq/client";
-import { Command as Command22 } from "commander";
+import { Command as Command23 } from "commander";
 function getTitle2(item) {
   if (item.object === "data_source") {
     return item.title.map((t) => t.plain_text).join("") || "(untitled)";
@@ -2829,7 +3149,7 @@ function displayType2(item) {
   return item.object === "data_source" ? "database" : item.object;
 }
 function searchCommand() {
-  const cmd = new Command22("search");
+  const cmd = new Command23("search");
   cmd.description("search Notion workspace by keyword").argument("<query>", "search keyword").option(
     "--type <type>",
     "filter by object type (page or database)",
@@ -2899,18 +3219,144 @@ function searchCommand() {
   return cmd;
 }
 
+// src/commands/skill.ts
+import {
+  copyFileSync,
+  existsSync as existsSync4,
+  mkdirSync,
+  readFileSync,
+  realpathSync
+} from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname, join as join3 } from "path";
+import chalk from "chalk";
+import { Command as Command24 } from "commander";
+function skillPath() {
+  if (!process.argv[1]) {
+    throw new Error("Cannot determine install path. Run with: notion skill");
+  }
+  const entryPoint = realpathSync(process.argv[1]);
+  const packageRoot = dirname(dirname(entryPoint));
+  const candidates = [
+    join3(packageRoot, ".agents", "skills", "using-notion-cli", "SKILL.md"),
+    join3(
+      dirname(entryPoint),
+      "..",
+      ".agents",
+      "skills",
+      "using-notion-cli",
+      "SKILL.md"
+    )
+  ];
+  for (const c2 of candidates) {
+    if (existsSync4(c2)) return c2;
+  }
+  throw new Error(
+    "SKILL.md not found. Reinstall with: npm install -g @andrzejchm/notion-cli"
+  );
+}
+function getAgentTargets() {
+  const home = homedir2();
+  const targets = [
+    {
+      name: "Claude Code",
+      dir: join3(home, ".claude", "skills", "using-notion-cli")
+    },
+    { name: "Codex", dir: join3(home, ".agents", "skills", "using-notion-cli") },
+    {
+      name: "OpenCode",
+      dir: join3(home, ".config", "opencode", "skills", "using-notion-cli")
+    }
+  ];
+  return targets.map((t) => ({
+    ...t,
+    detected: existsSync4(dirname(t.dir))
+  }));
+}
+function installTo(source, target) {
+  if (!existsSync4(target.dir)) mkdirSync(target.dir, { recursive: true });
+  const dest = join3(target.dir, "SKILL.md");
+  copyFileSync(source, dest);
+  return dest;
+}
+async function installInteractive(source, targets) {
+  const { checkbox } = await import("@inquirer/prompts");
+  const selected = await checkbox({
+    message: "Install skill for which agents?",
+    choices: targets.map((t) => ({
+      name: `${t.name}${t.detected ? chalk.dim(" (detected)") : ""}`,
+      value: t.name,
+      checked: t.detected
+    }))
+  });
+  if (selected.length === 0) {
+    process.stderr.write("No agents selected.\n");
+    return;
+  }
+  process.stdout.write("\n");
+  for (const name of selected) {
+    const target = targets.find((t) => t.name === name);
+    if (!target) continue;
+    const dest = installTo(source, target);
+    process.stdout.write(`  Installed: ${target.name}: ${dest}
+`);
+  }
+}
+function installNonInteractive(source, targets) {
+  const detected = targets.filter((t) => t.detected);
+  if (detected.length === 0) {
+    process.stderr.write(
+      "No agents detected. Use --path to specify install location:\n  notion skill --path ~/.claude/skills/using-notion-cli/SKILL.md\n"
+    );
+    return;
+  }
+  for (const target of detected) {
+    const dest = installTo(source, target);
+    process.stdout.write(`Installed: ${target.name}: ${dest}
+`);
+  }
+}
+function skillCommand() {
+  const cmd = new Command24("skill");
+  cmd.description("Install the agent skill file for your coding agents").option("--print", "Print the skill file content instead of installing").option("--path <path>", "Install to a specific file path").action(
+    withErrorHandling(async (opts) => {
+      if (opts.print) {
+        process.stdout.write(readFileSync(skillPath(), "utf-8"));
+        return;
+      }
+      const source = skillPath();
+      if (opts.path) {
+        const dir = dirname(opts.path);
+        if (!existsSync4(dir)) mkdirSync(dir, { recursive: true });
+        copyFileSync(source, opts.path);
+        process.stdout.write(`Installed to ${opts.path}
+`);
+        return;
+      }
+      const targets = getAgentTargets();
+      const isTTY = process.stdout.isTTY ?? false;
+      if (isTTY) {
+        await installInteractive(source, targets);
+      } else {
+        installNonInteractive(source, targets);
+      }
+    })
+  );
+  return cmd;
+}
+
 // src/commands/update.ts
-import { Command as Command23 } from "commander";
-function collectProps3(val, acc) {
+import { Command as Command25 } from "commander";
+function collectProps2(val, acc) {
   acc.push(val);
   return acc;
 }
 function updateCommand() {
-  const cmd = new Command23("update");
+  const cmd = new Command25("update");
   cmd.description("update properties on a Notion page").argument("<id/url>", "Notion page ID or URL").option(
     "--prop <property=value>",
     "set a property value (repeatable)",
-    collectProps3,
+    collectProps2,
     []
   ).option("--title <title>", "set the page title").action(
     withErrorHandling(async (idOrUrl, opts) => {
@@ -2964,7 +3410,7 @@ function updateCommand() {
 }
 
 // src/commands/users.ts
-import { Command as Command24 } from "commander";
+import { Command as Command26 } from "commander";
 function getEmailOrWorkspace(user) {
   if (user.type === "person") {
     return user.person.email ?? "\u2014";
@@ -2976,7 +3422,7 @@ function getEmailOrWorkspace(user) {
   return "\u2014";
 }
 function usersCommand() {
-  const cmd = new Command24("users");
+  const cmd = new Command26("users");
   cmd.description("list all users in the workspace").option("--json", "output as JSON").action(
     withErrorHandling(async (opts) => {
       if (opts.json) setOutputMode("json");
@@ -3003,11 +3449,11 @@ function usersCommand() {
 
 // src/cli.ts
 var __filename = fileURLToPath(import.meta.url);
-var __dirname = dirname(__filename);
+var __dirname = dirname2(__filename);
 var pkg = JSON.parse(
-  readFileSync(join3(__dirname, "../package.json"), "utf-8")
+  readFileSync2(join4(__dirname, "../package.json"), "utf-8")
 );
-var program = new Command25();
+var program = new Command27();
 program.name("notion").description("Notion CLI \u2014 read Notion pages and databases from the terminal").version(pkg.version);
 program.option("--verbose", "show API requests/responses").option("--color", "force color output").option("--json", "force JSON output (overrides TTY detection)").option("--md", "force markdown output for page content");
 program.configureOutput({
@@ -3028,7 +3474,7 @@ program.hook("preAction", (thisCommand) => {
     setOutputMode("md");
   }
 });
-var authCmd = new Command25("auth").description("manage Notion authentication");
+var authCmd = new Command27("auth").description("manage Notion authentication");
 authCmd.action(authDefaultAction(authCmd));
 authCmd.addCommand(loginCommand());
 authCmd.addCommand(logoutCommand());
@@ -3038,7 +3484,7 @@ authCmd.addCommand(profileUseCommand());
 authCmd.addCommand(profileRemoveCommand());
 program.addCommand(authCmd);
 program.addCommand(initCommand(), { hidden: true });
-var profileCmd = new Command25("profile").description(
+var profileCmd = new Command27("profile").description(
   "manage authentication profiles"
 );
 profileCmd.addCommand(profileListCommand());
@@ -3053,16 +3499,18 @@ program.addCommand(commentsCommand());
 program.addCommand(readCommand());
 program.addCommand(commentAddCommand());
 program.addCommand(appendCommand());
+program.addCommand(attachCommand());
 program.addCommand(createPageCommand());
 program.addCommand(editPageCommand());
 program.addCommand(updateCommand());
 program.addCommand(archiveCommand());
 program.addCommand(moveCommand());
-var dbCmd = new Command25("db").description("Database operations");
+var dbCmd = new Command27("db").description("Database operations");
 dbCmd.addCommand(dbCreateCommand());
 dbCmd.addCommand(dbSchemaCommand());
 dbCmd.addCommand(dbQueryCommand());
 program.addCommand(dbCmd);
 program.addCommand(completionCommand());
+program.addCommand(skillCommand());
 await program.parseAsync();
 //# sourceMappingURL=cli.js.map