npm - @wspc/cli - Versions diffs - 0.1.7 → 0.1.9 - Mend

@wspc/cli 0.1.7 → 0.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/cli.js CHANGED Viewed

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // src/cli.ts
-import { Command as Command81 } from "commander";
+import { Command as Command82 } from "commander";
 import { realpathSync } from "fs";
 import { fileURLToPath } from "url";
@@ -1520,9 +1520,9 @@ function createConsistencyFetch(opts) {
 }
 // src/version.ts
-var VERSION = "0.1.7";
+var VERSION = "0.1.9";
 var SPEC_SHA = "bec760cd";
-var SPEC_FETCHED_AT = "2026-06-30T13:42:06.837Z";
+var SPEC_FETCHED_AT = "2026-07-06T07:30:04.295Z";
 var API_BASE = "https://api.wspc.ai";
 // src/index.ts
@@ -4575,8 +4575,27 @@ accountCommand.command("switch <email>").description("Set the active account for
 `);
 });
-// src/handwritten/commands/todo-done.ts
+// src/handwritten/commands/tour.ts
 import { Command as Command75 } from "commander";
+var GUIDE_URL_DEFAULT = "https://mcp.wspc.ai/guide";
+function resolveGuideUrl(env = process.env) {
+  const override = env.WSPC_GUIDE_URL?.trim();
+  return override ? override : GUIDE_URL_DEFAULT;
+}
+async function fetchGuide(url, fetchImpl = fetch) {
+  const res = await fetchImpl(url);
+  if (!res.ok) throw new Error(`tour_fetch_failed: ${res.status}`);
+  return await res.text();
+}
+var TOUR_HINT = "This is the wspc guided tour for your AI agent \u2014 ask your agent to run `wspc tour` and follow it.\n";
+var tourCommand = new Command75("tour").description("Print the wspc guided-tour script for your AI agent to read and follow").action(async () => {
+  const text = await fetchGuide(resolveGuideUrl());
+  if (process.stdout.isTTY) process.stderr.write(TOUR_HINT);
+  process.stdout.write(text.endsWith("\n") ? text : text + "\n");
+});
+// src/handwritten/commands/todo-done.ts
+import { Command as Command76 } from "commander";
 var TODO_UPDATE_DISPLAY = {
   shape: "object",
   format: {
@@ -4594,7 +4613,7 @@ var TODO_UPDATE_DISPLAY = {
     deleted_at: "relative-time"
   }
 };
-var todoDoneCommand = new Command75("done").description("Mark a todo done (sugar for `update <id> --status done`)").argument("<id>", "Todo id").action(async (id) => {
+var todoDoneCommand = new Command76("done").description("Mark a todo done (sugar for `update <id> --status done`)").argument("<id>", "Todo id").action(async (id) => {
   const client2 = await loadSdkClient();
   const result = await todoUpdate({
     client: client2._rawClient,
@@ -4613,7 +4632,7 @@ var todoDoneCommand = new Command75("done").description("Mark a todo done (sugar
 });
 // src/handwritten/commands/email/send.ts
-import { Command as Command76 } from "commander";
+import { Command as Command77 } from "commander";
 import { randomUUID } from "crypto";
 import { readFile, stat } from "fs/promises";
 import { basename } from "path";
@@ -4672,7 +4691,7 @@ async function resolveAttachment(input) {
     `--attach ${input}: neither a readable file nor a valid <prefix>_<ulid>:<idx> reference.`
   );
 }
-var sendCommand = new Command76("send").description("Send an outbound email").requiredOption("--from <alias-email>", "alias email to send from").option("--to <addr...>", "recipient address (repeatable)", []).option("--subject <text>", "subject").option("--text <body>", "plain-text body").option("--text-file <path>", "read text body from file").option("--reply <id>", "inbound email id to reply to").option("--attach <path-or-ref...>", "attachment (file path or eml_xxx:idx)", []).option("--idempotency-key <key>", "idempotency key (auto-generated if omitted)").action(async (opts) => {
+var sendCommand = new Command77("send").description("Send an outbound email").requiredOption("--from <alias-email>", "alias email to send from").option("--to <addr...>", "recipient address (repeatable)", []).option("--subject <text>", "subject").option("--text <body>", "plain-text body").option("--text-file <path>", "read text body from file").option("--reply <id>", "inbound email id to reply to").option("--attach <path-or-ref...>", "attachment (file path or eml_xxx:idx)", []).option("--idempotency-key <key>", "idempotency key (auto-generated if omitted)").action(async (opts) => {
   const isReply = Boolean(opts.reply);
   const to = opts.to;
   const attachInputs = opts.attach;
@@ -4761,7 +4780,7 @@ var sendCommand = new Command76("send").description("Send an outbound email").re
 });
 // src/handwritten/commands/email/attachment.ts
-import { Command as Command77 } from "commander";
+import { Command as Command78 } from "commander";
 import { createWriteStream } from "fs";
 import { Readable } from "stream";
 import { pipeline } from "stream/promises";
@@ -4779,7 +4798,7 @@ function parseContentDispositionFilename(header) {
 }
 // src/handwritten/commands/email/attachment.ts
-var attachmentCommand = new Command77("attachment").description("Download an inbound email attachment by index").argument("<email-id>").argument("<idx>").option("--output <path>", "output file path").option("--include-deleted", "allow downloads from soft-deleted parent emails").action(async (emailId, idxArg, opts) => {
+var attachmentCommand = new Command78("attachment").description("Download an inbound email attachment by index").argument("<email-id>").argument("<idx>").option("--output <path>", "output file path").option("--include-deleted", "allow downloads from soft-deleted parent emails").action(async (emailId, idxArg, opts) => {
   const idx = Number(idxArg);
   if (!Number.isInteger(idx) || idx < 0) {
     process.stderr.write(`<idx> must be a non-negative integer (got "${idxArg}")
@@ -4811,7 +4830,7 @@ var attachmentCommand = new Command77("attachment").description("Download an inb
 });
 // src/handwritten/commands/drive/bind.ts
-import { Command as Command78 } from "commander";
+import { Command as Command79 } from "commander";
 import { stat as stat3 } from "fs/promises";
 import { resolve } from "path";
@@ -5086,7 +5105,7 @@ async function assertExistingDirectory(path) {
   }
 }
 function driveBindCommand() {
-  return new Command78("bind").description("Bind a local folder to an existing Drive library").requiredOption("--library <id>", "existing Drive library id").argument("[path]", "local folder path", ".").action(async (path, opts) => {
+  return new Command79("bind").description("Bind a local folder to an existing Drive library").requiredOption("--library <id>", "existing Drive library id").argument("[path]", "local folder path", ".").action(async (path, opts) => {
     const root = resolve(path);
     await assertExistingDirectory(root);
     const api = await createDriveApi();
@@ -5104,7 +5123,7 @@ function driveBindCommand() {
 }
 // src/handwritten/commands/drive/sync.ts
-import { Command as Command79 } from "commander";
+import { Command as Command80 } from "commander";
 import { mkdir as mkdir3, readFile as readFile4, rm as rm3, writeFile as writeFile3 } from "fs/promises";
 import { basename as basename3, dirname as dirname2, join as join5, posix as pathPosix2, resolve as resolve3 } from "path";
 import { createHash as createHash3, randomUUID as randomUUID4 } from "crypto";
@@ -5821,7 +5840,7 @@ async function runDriveSyncOnce(root, api, clock = systemDriveClock) {
   });
 }
 function driveSyncCommand(api) {
-  const sync = new Command79("sync").description("Drive sync commands");
+  const sync = new Command80("sync").description("Drive sync commands");
   sync.command("once").description("Run one Drive sync pass").argument("[path]", "local folder path", ".").action(async (path) => {
     const summary = await runDriveSyncOnce(resolve3(path), api);
     render({ kind: "drive_sync_once", display: { shape: "object" } }, summary);
@@ -6274,7 +6293,7 @@ function containsVersionConflict(value) {
 }
 // src/handwritten/commands/drive/watch.ts
-import { Command as Command80 } from "commander";
+import { Command as Command81 } from "commander";
 import chokidar from "chokidar";
 import { relative as relative2, resolve as resolve4 } from "path";
@@ -6312,6 +6331,15 @@ function createDriveRealtimeSource(args) {
     if (stopped || authFailed) return;
     clearReconnectTimer();
     const id = ++connectionId;
+    const headers = args.headers;
+    if (typeof headers !== "function") {
+      openSocket(id, headers);
+      return;
+    }
+    void headers().then((resolved) => openSocket(id, resolved)).catch((error) => closeConnection(id, error));
+  }
+  function openSocket(id, headers) {
+    if (id !== connectionId || stopped || authFailed) return;
     const url = buildDriveRealtimeUrl(args.baseUrl, args.libraryId, currentRealtime);
     activeSocket = connect(url, {
       open() {
@@ -6326,7 +6354,7 @@ function createDriveRealtimeSource(args) {
       close(error) {
         closeConnection(id, error ?? "close");
       }
-    }, args.headers === void 0 ? void 0 : { headers: args.headers });
+    }, headers === void 0 ? void 0 : { headers });
   }
   function closeConnection(id, error) {
     if (id !== connectionId || stopped || authFailed) return;
@@ -6521,6 +6549,9 @@ function isInvalidCursorReason(reason) {
   return /\bcursor[_ -]?(invalid|expired|gone|missing|not[_ -]?found)\b|\binvalid[_ -]?cursor\b/i.test(reason);
 }
 function isRealtimeAuthError(error) {
+  if (typeof error === "object" && error !== null && error.code === "WSPC_AUTH_EXPIRED") {
+    return true;
+  }
   return /\b(401|403|auth|authorization|unauthorized|forbidden)\b/i.test(String(error));
 }
 function nativeWebSocketConnector(url, handlers, init) {
@@ -6664,16 +6695,17 @@ async function runDriveWatch(root, options = {}) {
     realtimeSource = options.once ? void 0 : options.realtimeSource;
     if (!options.once && realtimeSource === void 0) {
       state = await ensureDriveRealtimeState(root);
-      const { baseUrl, headers } = await loadRealtimeAuthHeaders({
-        verifyPath: `/drive/libraries/${encodeURIComponent(state.library_id)}`
-      });
+      const verifyPath = `/drive/libraries/${encodeURIComponent(state.library_id)}`;
+      const { baseUrl } = await loadRealtimeAuthHeaders({ verifyPath });
       const realtime = state.realtime;
       if (realtime === void 0) {
         throw new Error("drive realtime state is required");
       }
       realtimeSource = createDriveRealtimeSource({
         baseUrl,
-        headers,
+        // Tokens expire while watching; resolve fresh headers on every
+        // (re)connect so an idle drop cannot loop on a stale snapshot.
+        headers: async () => (await loadRealtimeAuthHeaders({ verifyPath })).headers,
         libraryId: state.library_id,
         realtime,
         writeRealtimeState: (next) => writeDriveRealtimeState(root, next)
@@ -6724,7 +6756,7 @@ async function runDriveWatch(root, options = {}) {
   }
 }
 function driveWatchCommand(options = {}) {
-  return new Command80("watch").description("Watch a bound Drive folder and sync local changes").argument("[path]", "local folder path", ".").action(async (path) => {
+  return new Command81("watch").description("Watch a bound Drive folder and sync local changes").argument("[path]", "local folder path", ".").action(async (path) => {
     await runDriveWatch(resolve4(path), options);
   });
 }
@@ -6788,7 +6820,7 @@ function waitForStopSignal(onRegistered) {
 function mountDriveCommands(program) {
   let drive = program.commands.find((c) => c.name() === "drive");
   if (!drive) {
-    drive = new Command81("drive").description("Drive commands");
+    drive = new Command82("drive").description("Drive commands");
     program.addCommand(drive);
   }
   if (!drive.commands.some((c) => c.name() === "bind")) {
@@ -6814,7 +6846,7 @@ function isCliEntrypoint(argv = process.argv, metaUrl = import.meta.url) {
   }
 }
 function buildProgram() {
-  const program = new Command81().name("wspc").description("Official CLI for wspc.ai").version(`wspc ${VERSION} (spec ${SPEC_SHA}, fetched ${SPEC_FETCHED_AT})`).option("--json", "Output raw JSON (machine-readable)").option("--account <email>", "Run as a specific account (overrides the active account)").hook("preAction", (_thisCommand, actionCommand) => {
+  const program = new Command82().name("wspc").description("Official CLI for wspc.ai").version(`wspc ${VERSION} (spec ${SPEC_SHA}, fetched ${SPEC_FETCHED_AT})`).option("--json", "Output raw JSON (machine-readable)").option("--account <email>", "Run as a specific account (overrides the active account)").hook("preAction", (_thisCommand, actionCommand) => {
     const globals = actionCommand.optsWithGlobals();
     if (globals.json) process.env.WSPC_OUTPUT = "json";
     if (globals.account) process.env.WSPC_ACCOUNT = String(globals.account);
@@ -6824,6 +6856,7 @@ function buildProgram() {
   program.addCommand(whoamiCommand);
   program.addCommand(configCommand);
   program.addCommand(accountCommand);
+  program.addCommand(tourCommand);
   registerGeneratedCommands(program);
   mountDriveCommands(program);
   const todo = program.commands.find((c) => c.name() === "todo");