@parall/cli 1.16.0 → 1.18.0

package/dist/commands/no-reply.d.ts

@@ -1,19 +1,17 @@
 import { Command } from 'commander';
 /**
- * `parall no-reply` — explicit "I am not replying this turn" signal.
+ * `parall no-reply` — explicit "I am not replying this turn" audit signal.
  *
- * Runs entirely client-side: no API call, no server state. The agent bridge
- * (agent-core) sniffs the invocation in the Bash tool_call stream and
- * drops all subsequent text projections for this dispatch, so the agent
- * can silence a turn without leaking a polite "No response needed" message
- * into the chat.
+ * Runs entirely client-side: no API call, no server state. Under the unified
+ * runtime output contract (see `docs/engineering-design/agent-dm-loop-prevention.md`
+ * § Layer 0), plain text is never auto-projected as a chat message — agents
+ * produce visible messages only by explicitly invoking `parall messages send`
+ * / `dm`. So silence is the default when the agent simply does nothing.
  *
- * Usage pattern in the agent's workspace CLAUDE.md:
- *
- *   When a dispatched event has `[Hint: no_reply]` or you decide the turn
- *   does not need a visible reply, run this command BEFORE emitting any
- *   plain text — anything you say after it is dropped, but anything before
- *   is already projected as a chat message.
+ * What this command adds: a deterministic, auditable marker in the agent's
+ * session tool-call log saying "this turn was intentionally silent, here's
+ * the optional reason," which helps operators distinguish deliberate silence
+ * from a crashed or timed-out dispatch.
  */
 export declare function registerNoReplyCommands(program: Command): void;
 //# sourceMappingURL=no-reply.d.ts.map

package/dist/commands/no-reply.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"no-reply.d.ts","sourceRoot":"","sources":["../../src/commands/no-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAevD"}
+{"version":3,"file":"no-reply.d.ts","sourceRoot":"","sources":["../../src/commands/no-reply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAevD"}

package/dist/commands/no-reply.js

@@ -1,28 +1,26 @@
 /**
- * `parall no-reply` — explicit "I am not replying this turn" signal.
+ * `parall no-reply` — explicit "I am not replying this turn" audit signal.
  *
- * Runs entirely client-side: no API call, no server state. The agent bridge
- * (agent-core) sniffs the invocation in the Bash tool_call stream and
- * drops all subsequent text projections for this dispatch, so the agent
- * can silence a turn without leaking a polite "No response needed" message
- * into the chat.
+ * Runs entirely client-side: no API call, no server state. Under the unified
+ * runtime output contract (see `docs/engineering-design/agent-dm-loop-prevention.md`
+ * § Layer 0), plain text is never auto-projected as a chat message — agents
+ * produce visible messages only by explicitly invoking `parall messages send`
+ * / `dm`. So silence is the default when the agent simply does nothing.
  *
- * Usage pattern in the agent's workspace CLAUDE.md:
- *
- *   When a dispatched event has `[Hint: no_reply]` or you decide the turn
- *   does not need a visible reply, run this command BEFORE emitting any
- *   plain text — anything you say after it is dropped, but anything before
- *   is already projected as a chat message.
+ * What this command adds: a deterministic, auditable marker in the agent's
+ * session tool-call log saying "this turn was intentionally silent, here's
+ * the optional reason," which helps operators distinguish deliberate silence
+ * from a crashed or timed-out dispatch.
  */
 export function registerNoReplyCommands(program) {
     program
         .command('no-reply')
-        .description('Signal to the bridge that this dispatch turn should produce no visible reply. ' +
-        'Subsequent text output is dropped.')
+        .description('Record an explicit "no visible reply this turn" marker in the session log. ' +
+        'Purely informational — silence is already the default when no `messages send` runs.')
         .option('--reason <reason>', 'Optional human-readable reason, logged for debugging')
         .action((opts) => {
-        // Print a deterministic marker so the bridge (and operators reading
-        // tool_use logs) can confirm the suppression was requested.
+        // Print a deterministic marker so operators reading tool_use logs can
+        // confirm the agent deliberately declared silence this turn.
         const payload = { ack: 'no-reply' };
         if (opts.reason)
             payload.reason = opts.reason;

package/dist/commands/tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAgPpD"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QA4RpD"}

package/dist/commands/tasks.js

@@ -165,7 +165,8 @@ export function registerTaskCommands(program) {
                 cursor: opts.cursor,
                 order: opts.order,
             });
-            const result = await client.getTaskComments(orgId, stripPrllScheme(taskId), params);
+            const { COMMENT_TARGET } = await import('@parall/sdk');
+            const result = await client.getComments(orgId, { target_uri: COMMENT_TARGET.task(stripPrllScheme(taskId)), ...params });
             printJson(result);
         }
         catch (err) {
@@ -180,7 +181,8 @@ export function registerTaskCommands(program) {
         .action(async (taskId, opts) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.createTaskComment(orgId, stripPrllScheme(taskId), { body: opts.body });
+            const { COMMENT_TARGET } = await import('@parall/sdk');
+            const result = await client.createComment(orgId, { target_uri: COMMENT_TARGET.task(stripPrllScheme(taskId)), body: opts.body });
             printJson(result);
             printRefHint(result.id);
         }
@@ -191,13 +193,12 @@ export function registerTaskCommands(program) {
     comments
         .command('update')
         .description('Update a task comment')
-        .argument('<taskId>', 'Task ID')
         .argument('<commentId>', 'Comment ID')
         .requiredOption('--body <text>', 'New comment body')
-        .action(async (taskId, commentId, opts) => {
+        .action(async (commentId, opts) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.updateTaskComment(orgId, stripPrllScheme(taskId), stripPrllScheme(commentId), { body: opts.body });
+            const result = await client.updateComment(orgId, stripPrllScheme(commentId), { body: opts.body });
             printJson(result);
         }
         catch (err) {
@@ -207,12 +208,11 @@ export function registerTaskCommands(program) {
     comments
         .command('delete')
         .description('Delete a task comment')
-        .argument('<taskId>', 'Task ID')
         .argument('<commentId>', 'Comment ID')
-        .action(async (taskId, commentId) => {
+        .action(async (commentId) => {
         try {
             const { client, orgId } = resolveCredentials();
-            await client.deleteTaskComment(orgId, stripPrllScheme(taskId), stripPrllScheme(commentId));
+            await client.deleteComment(orgId, stripPrllScheme(commentId));
             printJson({ ok: true });
         }
         catch (err) {
@@ -240,4 +240,47 @@ export function registerTaskCommands(program) {
             printError(err);
         }
     });
+    // ---- Watchers ----
+    tasks
+        .command('watch')
+        .description('Watch a task (subscribe to comment notifications)')
+        .argument('<taskId>', 'Task ID')
+        .action(async (taskId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.watchTask(orgId, stripPrllScheme(taskId));
+            printJson({ ok: true });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    tasks
+        .command('unwatch')
+        .description('Unwatch a task (stop receiving comment notifications)')
+        .argument('<taskId>', 'Task ID')
+        .action(async (taskId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.unwatchTask(orgId, stripPrllScheme(taskId));
+            printJson({ ok: true });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    tasks
+        .command('watchers')
+        .description('List watchers of a task')
+        .argument('<taskId>', 'Task ID')
+        .action(async (taskId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getTaskWatchers(orgId, stripPrllScheme(taskId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
 }

package/dist/commands/wiki.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../src/commands/wiki.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAyqBpD"}
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../src/commands/wiki.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAwwBpD"}

package/dist/commands/wiki.js

@@ -630,6 +630,99 @@ export function registerWikiCommands(program) {
             printError(error);
         }
     });
+    // ---- Comments ----
+    const comment = wiki.command('comment').description('Manage wiki comments');
+    comment
+        .command('list')
+        .description('List comments on a wiki target')
+        .argument('[wiki]', 'Wiki ID or slug')
+        .requiredOption('--target-type <type>', 'Target type (changeset or page)')
+        .requiredOption('--target-id <id>', 'Target ID (changeset ID or page path)')
+        .option('--limit <n>', 'Maximum number of comments to return', '50')
+        .option('--cursor <cursor>', 'Pagination cursor')
+        .option('--order <order>', 'Sort order (asc or desc)')
+        .action(async (wikiRef, opts) => {
+        try {
+            const ctx = resolveCredentials();
+            const { resolveWikiRefOrDefault } = await import('../lib/wiki.js');
+            const { COMMENT_TARGET } = await import('@parall/sdk');
+            const w = await resolveWikiRefOrDefault(ctx, wikiRef);
+            if (opts.targetType !== 'changeset' && opts.targetType !== 'page') {
+                throw new Error('--target-type must be "changeset" or "page"');
+            }
+            const targetUri = opts.targetType === 'changeset'
+                ? COMMENT_TARGET.changeset(opts.targetId, w.id)
+                : COMMENT_TARGET.wikiPage(w.id, opts.targetId);
+            const result = await ctx.client.getComments(ctx.orgId, {
+                target_uri: targetUri,
+                limit: Number(opts.limit),
+                cursor: opts.cursor,
+                order: opts.order,
+            });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comment
+        .command('add')
+        .description('Add a comment to a wiki target')
+        .argument('[wiki]', 'Wiki ID or slug')
+        .requiredOption('--target-type <type>', 'Target type (changeset or page)')
+        .requiredOption('--target-id <id>', 'Target ID (changeset ID or page path)')
+        .requiredOption('--body <text>', 'Comment body')
+        .action(async (wikiRef, opts) => {
+        try {
+            const ctx = resolveCredentials();
+            const { resolveWikiRefOrDefault } = await import('../lib/wiki.js');
+            const { COMMENT_TARGET } = await import('@parall/sdk');
+            const w = await resolveWikiRefOrDefault(ctx, wikiRef);
+            if (opts.targetType !== 'changeset' && opts.targetType !== 'page') {
+                throw new Error('--target-type must be "changeset" or "page"');
+            }
+            const targetUri = opts.targetType === 'changeset'
+                ? COMMENT_TARGET.changeset(opts.targetId, w.id)
+                : COMMENT_TARGET.wikiPage(w.id, opts.targetId);
+            const result = await ctx.client.createComment(ctx.orgId, {
+                target_uri: targetUri,
+                body: opts.body,
+            });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comment
+        .command('update')
+        .description('Update a wiki comment')
+        .argument('<commentId>', 'Comment ID')
+        .requiredOption('--body <text>', 'New comment body')
+        .action(async (commentId, opts) => {
+        try {
+            const ctx = resolveCredentials();
+            const result = await ctx.client.updateComment(ctx.orgId, commentId, { body: opts.body });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comment
+        .command('delete')
+        .description('Delete a wiki comment')
+        .argument('<commentId>', 'Comment ID')
+        .action(async (commentId) => {
+        try {
+            const ctx = resolveCredentials();
+            await ctx.client.deleteComment(ctx.orgId, commentId);
+            printJson({ ok: true });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
     // ---- Utility (not for direct agent use) ----
     wiki
         .command('list')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/cli",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "CLI client for Parall — universal agent & human access to Parall API",
   "license": "MIT",
   "repository": {
@@ -30,7 +30,7 @@
     "@modelcontextprotocol/sdk": "1.27.1",
     "commander": "^13.0.0",
     "zod": "^4.3.6",
-    "@parall/sdk": "1.16.0"
+    "@parall/sdk": "1.18.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",