@pitcher/cli-scripts 2.20.1 → 2.21.0

package/README.md

@@ -2,6 +2,8 @@
 
 > Pitcher CLI Tools provide a suite of command-line utilities to streamline your workflow. For the best experience, we recommend installing the tools globally using `npm install -g @pitcher/cli-scripts`.
 
+Releases are published to npm automatically: a merge to `main` that bumps `version` in `package.json` publishes that version, and a merge without a bump publishes nothing (`.github/workflows/cli-scripts-publish.yml`; release flow in `CLAUDE.md`).
+
 ## Help
 
 ```bash
@@ -223,15 +225,12 @@ p canvases get 01CANVASID... --api-key myapikey
 
 ## To run the `shared-links` command:
 
-Create and read share links for canvases or files (returns the `short_url`).
+Create and read share links for canvases (returns the `short_url`).
 
 ```bash
 # Create a share link for a canvas
 p shared-links create --canvas-id 01CANVASID... --api-key myapikey
 
-# Create a share link for a file
-p shared-links create --file-id 01FILEID... --api-key myapikey
-
 # Fetch the existing share link for a canvas
 p shared-links get --canvas-id 01CANVASID... --api-key myapikey
 ```

package/dist/src/commands/sharedLinks.d.ts

@@ -7,10 +7,8 @@ export interface SharedLinksDeps {
 }
 export declare function runSharedLinksCreate(opts: CommonOpts & {
     canvasId?: string;
-    fileId?: string;
 }, deps?: SharedLinksDeps): Promise<Envelope<unknown>>;
 export declare function runSharedLinksGet(opts: CommonOpts & {
     canvasId?: string;
-    fileId?: string;
 }, deps?: SharedLinksDeps): Promise<Envelope<unknown>>;
 export declare function createSharedLinksCommand(): Command;

package/dist/src/commands/sharedLinks.js

@@ -4,22 +4,17 @@ import { ok, fail } from '../core/envelope.js';
 import { createCliError } from '../core/errors.js';
 import { emitEnvelope } from '../core/output.js';
 import { withAuthFlags } from './withAuth.js';
-/** Enforce exactly one of --canvas-id / --file-id. Scope is derived from the target. */
-function requireOneTarget(opts) {
-    if (opts.canvasId && opts.fileId)
-        throw createCliError('VALIDATION', 'pass exactly one of --canvas-id or --file-id');
-    if (opts.canvasId)
-        return 'canvas';
-    if (opts.fileId)
-        return 'file';
-    throw createCliError('VALIDATION', 'pass exactly one of --canvas-id or --file-id');
+/** Only canvases can be shared. */
+function requireCanvasId(opts) {
+    if (!opts.canvasId)
+        throw createCliError('VALIDATION', '--canvas-id is required');
+    return opts.canvasId;
 }
 export async function runSharedLinksCreate(opts, deps = {}) {
     try {
-        const target = requireOneTarget(opts);
+        const canvasId = requireCanvasId(opts);
         const client = clientFor(opts, deps);
-        const body = target === 'canvas' ? { canvas_id: opts.canvasId } : { file_id: opts.fileId };
-        const res = await client.post('/api/v1/shared-links/', body);
+        const res = await client.post('/api/v1/shared-links/', { canvas_id: canvasId });
         return ok(res.data);
     }
     catch (e) {
@@ -28,13 +23,10 @@ export async function runSharedLinksCreate(opts, deps = {}) {
 }
 export async function runSharedLinksGet(opts, deps = {}) {
     try {
-        const target = requireOneTarget(opts);
+        const canvasId = requireCanvasId(opts);
         const client = clientFor(opts, deps);
         // encodeURIComponent so an id containing `/` or `..` can't retarget the request path
-        const path = target === 'canvas'
-            ? `/api/v1/shared-links/canvas/${encodeURIComponent(opts.canvasId)}`
-            : `/api/v1/shared-links/file/${encodeURIComponent(opts.fileId)}`;
-        const res = await client.get(path);
+        const res = await client.get(`/api/v1/shared-links/canvas/${encodeURIComponent(canvasId)}`);
         return ok(res.data);
     }
     catch (e) {
@@ -42,17 +34,15 @@ export async function runSharedLinksGet(opts, deps = {}) {
     }
 }
 export function createSharedLinksCommand() {
-    const cmd = new Command('shared-links').description('create and read share links for canvases and files');
+    const cmd = new Command('shared-links').description('create and read share links for canvases');
     withAuthFlags(cmd.command('create'))
         .option('--canvas-id <id>', 'Canvas to share')
-        .option('--file-id <id>', 'File to share')
         .action(async (options, command) => {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runSharedLinksCreate({ ...options, quiet: globals.quiet }), globals);
     });
     withAuthFlags(cmd.command('get'))
         .option('--canvas-id <id>', 'Canvas whose link to fetch')
-        .option('--file-id <id>', 'File whose link to fetch')
         .action(async (options, command) => {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runSharedLinksGet({ ...options, quiet: globals.quiet }), globals);

package/dist/src/mcp/tools/sharedLinks.js

@@ -4,10 +4,9 @@ export const sharedLinksTools = [
     {
         name: 'pitcher_shared_links_create',
         title: 'Create a shared link',
-        description: 'Create a share link (short_url) for a canvas or a file. Pass exactly one of canvasId or fileId. Additive.',
+        description: 'Create a share link (short_url) for a canvas. Only canvases can be shared. Additive.',
         inputShape: {
-            canvasId: z.string().optional().describe('Canvas to share (exactly one of canvasId/fileId is required)'),
-            fileId: z.string().optional().describe('File to share (exactly one of canvasId/fileId is required)'),
+            canvasId: z.string().describe('Canvas to share'),
         },
         run: runSharedLinksCreate,
         readOnly: false,
@@ -16,10 +15,9 @@ export const sharedLinksTools = [
     {
         name: 'pitcher_shared_links_get',
         title: 'Get a shared link',
-        description: 'Retrieve the existing share link for a canvas or a file. Pass exactly one of canvasId or fileId.',
+        description: 'Retrieve the existing share link for a canvas.',
         inputShape: {
-            canvasId: z.string().optional().describe('Canvas whose link to fetch (exactly one of canvasId/fileId is required)'),
-            fileId: z.string().optional().describe('File whose link to fetch (exactly one of canvasId/fileId is required)'),
+            canvasId: z.string().describe('Canvas whose link to fetch'),
         },
         run: runSharedLinksGet,
         readOnly: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitcher/cli-scripts",
-  "version": "2.20.1",
+  "version": "2.21.0",
   "description": "The Pitcher CLI for various tasks in its ecosystem.",
   "author": "Pitcher AG",
   "license": "MIT",