@parall/cli 1.55.3 → 1.55.5

package/dist/commands/profile.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerProfileCommands(program: Command): void;
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/commands/profile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA8GvD"}

package/dist/commands/profile.js

@@ -0,0 +1,114 @@
+import { readFileSync } from 'node:fs';
+import { resolveCredentials } from '../lib/client.js';
+import { printJson, printError } from '../lib/output.js';
+// Profile commands follow the platform's uniform permission loop: `set` calls
+// the ATOMIC endpoints directly. Callers with edit power (humans on personal
+// keys) mutate immediately; a denied caller (an agent editing itself) gets the
+// structured 403 whose printed `Request approval:` command carries the exact
+// payload that was attempted — running it files the proposal for a human to
+// decide. There is no separate "propose" verb.
+export function registerProfileCommands(program) {
+    const profile = program.command('profile').description('Read and edit your profile');
+    profile
+        .command('show')
+        .description('Show your identity, org profile, Instructions and manager')
+        .action(async () => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const me = await client.getMe();
+            const result = { user: me };
+            try {
+                result.org_profile = await client.getMemberProfile(orgId, me.id);
+            }
+            catch {
+                /* display-only enrichment */
+            }
+            if (me.type === 'agent') {
+                try {
+                    result.instructions = await client.getAgentInstructions(orgId, me.id);
+                }
+                catch {
+                    /* not readable */
+                }
+                try {
+                    result.manager = await client.getAgentManager(orgId, me.id);
+                }
+                catch {
+                    /* not readable */
+                }
+            }
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    profile
+        .command('set')
+        .description('Edit your profile (title/about, Instructions, display name). If you lack permission, the error prints a ready-made approval request carrying exactly what you tried to write.')
+        .option('--title <text>', 'Org-profile title')
+        .option('--about <text>', 'Org-profile about/description')
+        .option('--instructions <text>', 'Full replacement Instructions')
+        .option('--instructions-file <path>', 'Read replacement Instructions from a file')
+        .option('--display-name <name>', 'Display name')
+        .action(async (opts) => {
+        if (opts.instructions !== undefined && opts.instructionsFile !== undefined) {
+            printError(new Error('--instructions and --instructions-file are mutually exclusive'));
+        }
+        const wantsProfile = opts.title !== undefined || opts.about !== undefined;
+        const instructionsBody = opts.instructions ??
+            (opts.instructionsFile ? readFileSync(opts.instructionsFile, 'utf8') : undefined);
+        if (!wantsProfile && instructionsBody === undefined && opts.displayName === undefined) {
+            printError(new Error('Nothing to change. Provide --title/--about, --instructions(-file), or --display-name.'));
+        }
+        const { client, orgId } = resolveCredentials();
+        const me = await client.getMe().catch((err) => printError(err));
+        const applied = {};
+        // Field groups apply independently, in order; the first denial exits
+        // with the prefilled proposal command for THAT group.
+        if (wantsProfile) {
+            // Read-modify-write like any client: a missing profile row is a
+            // successful empty read at version 0. Unspecified fields keep their
+            // current value so the write (and any resulting proposal) is always
+            // the full final state.
+            const current = await client.getMemberProfile(orgId, me.id).catch((err) => printError(err));
+            const body = {
+                title: opts.title ?? current.title,
+                description: opts.about ?? current.description,
+                expected_version: current.profile_version,
+            };
+            try {
+                applied.org_profile = await client.updateMemberProfile(orgId, me.id, body);
+            }
+            catch (err) {
+                printError(err, body);
+            }
+        }
+        if (instructionsBody !== undefined) {
+            const current = await client
+                .getAgentInstructions(orgId, me.id)
+                .catch((err) => printError(err));
+            const body = { instructions: instructionsBody, expected_version: current.version };
+            try {
+                applied.instructions = await client.updateAgentInstructions(orgId, me.id, body);
+            }
+            catch (err) {
+                printError(err, body);
+            }
+        }
+        if (opts.displayName !== undefined) {
+            try {
+                applied.user = await client.updateMe({ display_name: opts.displayName });
+            }
+            catch (err) {
+                // The identity proposal needs the CAS base (name at filing time),
+                // which the direct PATCH body does not carry — prefill it here.
+                printError(err, {
+                    display_name: opts.displayName,
+                    previous_display_name: me.display_name,
+                });
+            }
+        }
+        printJson(applied);
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/commands/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA8FvD"}
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/commands/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAyOvD"}

package/dist/commands/projects.js

@@ -1,5 +1,6 @@
 import { resolveCredentials } from '../lib/client.js';
 import { printJson, printError, stripPrllScheme } from '../lib/output.js';
+const VISIBILITY_HELP = 'public (any org member self-joins), restricted (join by approved request), or private (invite only); reading requires roster membership, with org owners/admins implicit';
 export function registerProjectCommands(program) {
     const projects = program.command('projects').description('Manage projects');
     projects
@@ -35,7 +36,7 @@ export function registerProjectCommands(program) {
         .requiredOption('--name <name>', 'Project name')
         .requiredOption('--key <key>', 'Project key')
         .option('--description <text>', 'Project description')
-        .option('--visibility <visibility>', 'public (whole org) or private (roster only)')
+        .option('--visibility <visibility>', VISIBILITY_HELP)
         .option('--color <hex>', 'Project color (hex)')
         .action(async (opts) => {
         try {
@@ -60,7 +61,7 @@ export function registerProjectCommands(program) {
         .argument('<projectId>', 'Project ID')
         .option('--name <name>', 'Project name')
         .option('--description <text>', 'Project description')
-        .option('--visibility <visibility>', 'public (whole org) or private (roster only)')
+        .option('--visibility <visibility>', VISIBILITY_HELP)
         .option('--color <hex>', 'Project color (hex)')
         .option('--status <status>', 'Project status')
         .action(async (projectId, opts) => {
@@ -102,4 +103,133 @@ export function registerProjectCommands(program) {
             printError(err);
         }
     });
+    projects
+        .command('library')
+        .description('Browse joinable projects (public + restricted) with your admission state. If task creation fails with no available projects, start here.')
+        .action(async () => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getProjectLibrary(orgId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    projects
+        .command('join')
+        .description('Join a public project immediately (restricted projects need `projects request-join`)')
+        .argument('<projectId>', 'Project ID')
+        .action(async (projectId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.joinProject(orgId, stripPrllScheme(projectId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    projects
+        .command('request-join')
+        .description('File a join request for a restricted project; a project manager approves it')
+        .argument('<projectId>', 'Project ID')
+        .option('--cancel', 'Withdraw your pending join request instead')
+        .action(async (projectId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const id = stripPrllScheme(projectId);
+            if (opts.cancel) {
+                await client.cancelProjectJoinRequest(orgId, id);
+                printJson({ cancelled: id });
+                return;
+            }
+            const result = await client.createProjectJoinRequest(orgId, id);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    projects
+        .command('join-requests')
+        .description('List pending join requests for a project (manager standing required)')
+        .argument('<projectId>', 'Project ID')
+        .action(async (projectId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.listProjectJoinRequests(orgId, stripPrllScheme(projectId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    const members = projects.command('members').description('Manage a project roster');
+    members
+        .command('list')
+        .description('List roster members (readable by anyone who can read the project)')
+        .argument('<projectId>', 'Project ID')
+        .action(async (projectId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getProjectMembers(orgId, stripPrllScheme(projectId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    members
+        .command('add')
+        .description('Add a user or team to the roster (manager standing required)')
+        .argument('<projectId>', 'Project ID')
+        .argument('<subject>', 'User ID (usr_...) or team ID (team_...)')
+        .option('--role <role>', 'member or manager', 'member')
+        .action(async (projectId, subject, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.addProjectMember(orgId, stripPrllScheme(projectId), {
+                subject: stripPrllScheme(subject),
+                role: opts.role,
+            });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    members
+        .command('remove')
+        .description('Remove a roster entry (manager standing required)')
+        .argument('<projectId>', 'Project ID')
+        .argument('<subject>', 'User ID or team ID')
+        .action(async (projectId, subject) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const id = stripPrllScheme(projectId);
+            const sub = stripPrllScheme(subject);
+            await client.removeProjectMember(orgId, id, sub);
+            printJson({ removed: sub, project: id });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    members
+        .command('set-role')
+        .description('Change a roster entry role (manager standing required)')
+        .argument('<projectId>', 'Project ID')
+        .argument('<subject>', 'User ID or team ID')
+        .requiredOption('--role <role>', 'member or manager')
+        .action(async (projectId, subject, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.updateProjectMember(orgId, stripPrllScheme(projectId), stripPrllScheme(subject), { role: opts.role });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
 }

package/dist/commands/refs.d.ts

@@ -4,8 +4,9 @@ import type { Command } from 'commander';
  * none. --strict forces none and cannot be combined with --from; non-message
  * runtime triggers are never accepted as message authority.
  */
-export declare function buildResolveRefsOptions(explicitFrom: string | undefined, triggerMessageId: string | undefined, strict?: boolean): {
-    sourceMessageId: string;
+export declare function buildResolveRefsOptions(explicitFrom: string | undefined, triggerMessageId: string | undefined, strict?: boolean, full?: boolean): {
+    sourceMessageId?: string;
+    full?: boolean;
 } | undefined;
 /** Build the SDK ref-graph params from the positional URI + CLI flags. */
 export declare function buildRefGraphParams(uri: string, opts: {

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

@@ -1 +1 @@
-{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/commands/refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,UAAQ,GACb;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAqBzC;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAOjC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAsEnD"}
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/commands/refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,MAAM,UAAQ,EACd,IAAI,UAAQ,GACX;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAsB1D;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAOjC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA0EnD"}

package/dist/commands/refs.js

@@ -5,28 +5,30 @@ import { ensurePrllScheme, parsePositiveInt, printError, printJson, stripPrllSch
  * none. --strict forces none and cannot be combined with --from; non-message
  * runtime triggers are never accepted as message authority.
  */
-export function buildResolveRefsOptions(explicitFrom, triggerMessageId, strict = false) {
+export function buildResolveRefsOptions(explicitFrom, triggerMessageId, strict = false, full = false) {
     const explicit = explicitFrom?.trim();
     if (strict && explicit) {
         throw new Error('--strict cannot be combined with --from');
     }
     if (strict)
-        return undefined;
+        return full ? { full: true } : undefined;
     if (explicit) {
         const sourceMessageId = stripPrllScheme(explicit);
         if (!sourceMessageId.startsWith('msg_')) {
             throw new Error('--from must be a message ID (msg_...) or prll://msg_... URI');
         }
-        return { sourceMessageId };
+        return full ? { sourceMessageId, full: true } : { sourceMessageId };
     }
     // Typed task dispatches can carry a task ID in trigger_message_id. Only a
     // real message can grant the server's cross-chat reference access; omitting
     // non-message triggers preserves the normal membership-filtered resolve.
     const trigger = triggerMessageId?.trim();
     if (!trigger)
-        return undefined;
+        return full ? { full: true } : undefined;
     const sourceMessageId = stripPrllScheme(trigger);
-    return sourceMessageId.startsWith('msg_') ? { sourceMessageId } : undefined;
+    if (!sourceMessageId.startsWith('msg_'))
+        return full ? { full: true } : undefined;
+    return full ? { sourceMessageId, full: true } : { sourceMessageId };
 }
 /** Build the SDK ref-graph params from the positional URI + CLI flags. */
 export function buildRefGraphParams(uri, opts) {
@@ -45,11 +47,15 @@ export function registerRefCommands(program) {
         .description('Batch resolve prll:// URIs to entity metadata')
         .option('--from <messageId>', 'Forwarding message for cross-chat access (defaults to trigger)')
         .option('--strict', 'Ignore runtime trigger and enforce direct membership checks')
+        .option('--full', 'Return complete text for authorized message references')
         .action(async (uris, opts) => {
         try {
             const { client, orgId } = resolveCredentials();
             const runtime = resolveRuntimeContext();
-            const result = await client.resolveRefs(orgId, uris, buildResolveRefsOptions(opts.from, runtime.triggerMessageId, opts.strict));
+            // Normalize schemeless args (msg_x, cht_x#range=…) like `refs graph`
+            // does: the server drops non-prll URIs without an error, so a raw id
+            // would silently resolve to nothing.
+            const result = await client.resolveRefs(orgId, uris.map(ensurePrllScheme), buildResolveRefsOptions(opts.from, runtime.triggerMessageId, opts.strict, opts.full));
             printJson(result);
         }
         catch (err) {

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;GAaA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;YAS0B,iBAAiB,CAAC,QAAQ,CAAC;cACvB,iBAAiB,CAAC,UAAU,CAAC;;;;;;;;GAS3D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QA2WpD"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiEpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;GAaA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;YAS0B,iBAAiB,CAAC,QAAQ,CAAC;cACvB,iBAAiB,CAAC,UAAU,CAAC;;;;;;;;GAS3D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAkXpD"}

package/dist/commands/tasks.js

@@ -1,4 +1,5 @@
 import { ApiError } from '@parall/sdk';
+import { createHash } from 'node:crypto';
 import { resolveCredentials, resolveTypedDispatchBinding } from '../lib/client.js';
 import { printJson, printError, printRefHint, stripPrllScheme } from '../lib/output.js';
 function stripUndefined(obj) {
@@ -201,10 +202,18 @@ export function registerTaskCommands(program) {
             const binding = resolveTypedDispatchBinding(taskId);
             const req = { ...data };
             if (binding) {
-                req.dispatch_lane = binding.lane;
+                if (binding.lane)
+                    req.dispatch_lane = binding.lane;
                 req.dispatch_event_id = binding.dispatchEventId;
-                if (binding.effectKey)
-                    req.dispatch_effect_key = binding.effectKey;
+                if (binding.generation !== undefined)
+                    req.dispatch_generation = binding.generation;
+                if (binding.effectKey) {
+                    req.dispatch_effect_key = binding.lane
+                        ? binding.effectKey
+                        : // Converged: content-address the key so a same-payload retry
+                            // replays idempotently and a different update mints a new key.
+                            `${binding.effectKey}:${createHash('sha256').update(JSON.stringify(data)).digest('hex').slice(0, 12)}`;
+                }
             }
             const result = await client.updateTask(orgId, taskId, req);
             if (binding?.effectKey) {

package/dist/commands/teams.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerTeamCommands(program: Command): void;
+//# sourceMappingURL=teams.d.ts.map

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

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

package/dist/commands/teams.js

@@ -0,0 +1,102 @@
+import { resolveCredentials } from '../lib/client.js';
+import { printJson, printError, stripPrllScheme } from '../lib/output.js';
+// Teams are pure permission rosters (ACL subjects for wiki/project ACLs);
+// server-side authorization decides who may mutate them — the CLI only
+// exposes the same surface the web Teams settings use.
+export function registerTeamCommands(program) {
+    const teams = program.command('teams').description('Manage permission teams');
+    teams
+        .command('list')
+        .description('List teams in the organization')
+        .action(async () => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getTeams(orgId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    teams
+        .command('get')
+        .description('Get a team by ID')
+        .argument('<teamId>', 'Team ID')
+        .action(async (teamId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getTeam(orgId, stripPrllScheme(teamId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    const members = teams.command('members').description('Manage a team roster');
+    members
+        .command('list')
+        .description('List team members')
+        .argument('<teamId>', 'Team ID')
+        .action(async (teamId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getTeamMembers(orgId, stripPrllScheme(teamId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    members
+        .command('add')
+        .description('Add a member (team manager or org admin)')
+        .argument('<teamId>', 'Team ID')
+        .argument('<userId>', 'User ID (usr_...)')
+        .option('--role <role>', 'member or manager', 'member')
+        .action(async (teamId, userId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.addTeamMember(orgId, stripPrllScheme(teamId), {
+                user_id: stripPrllScheme(userId),
+                role: opts.role,
+            });
+            printJson({ added: stripPrllScheme(userId), team: stripPrllScheme(teamId) });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    members
+        .command('remove')
+        .description('Remove a member (team manager or org admin)')
+        .argument('<teamId>', 'Team ID')
+        .argument('<userId>', 'User ID')
+        .action(async (teamId, userId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.removeTeamMember(orgId, stripPrllScheme(teamId), stripPrllScheme(userId));
+            printJson({ removed: stripPrllScheme(userId), team: stripPrllScheme(teamId) });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    members
+        .command('set-role')
+        .description('Change a member role (org admin; managers manage plain members only)')
+        .argument('<teamId>', 'Team ID')
+        .argument('<userId>', 'User ID')
+        .requiredOption('--role <role>', 'member or manager')
+        .action(async (teamId, userId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.updateTeamMember(orgId, stripPrllScheme(teamId), stripPrllScheme(userId), {
+                role: opts.role,
+            });
+            printJson({ updated: stripPrllScheme(userId), role: opts.role });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

package/dist/commands/wechat.d.ts

@@ -7,9 +7,10 @@ import { Command } from 'commander';
  * performs the vendor call in-process.
  *
  * Verb surface = the vendor's in-scope interface aggregated: postText
- * (send), fetchContactsList + getBriefInfo + getChatroomInfo (contacts),
- * getProfile (profile), checkOnline (status). Every verb renders
- * agent-readable text by default and `--json` for machine output.
+ * (send), platform-retained context (history), fetchContactsList +
+ * getBriefInfo + getChatroomInfo (contacts), getProfile (profile),
+ * checkOnline (status). History always emits its stable page JSON; the other
+ * verbs render agent-readable text by default and accept `--json`.
  *
  * INTERNAL research preview: the capability is flag-gated to the internal
  * org. Design: docs/engineering-design/wechat-channel-design.md §3, §4.

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

@@ -1 +1 @@
-{"version":3,"file":"wechat.d.ts","sourceRoot":"","sources":["../../src/commands/wechat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAwItD"}
+{"version":3,"file":"wechat.d.ts","sourceRoot":"","sources":["../../src/commands/wechat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QA0KtD"}

package/dist/commands/wechat.js

@@ -9,9 +9,10 @@ import { resolveMessageText, TEXT_FILE_OPTION_DESC, TEXT_OPTION_DESC } from '../
  * performs the vendor call in-process.
  *
  * Verb surface = the vendor's in-scope interface aggregated: postText
- * (send), fetchContactsList + getBriefInfo + getChatroomInfo (contacts),
- * getProfile (profile), checkOnline (status). Every verb renders
- * agent-readable text by default and `--json` for machine output.
+ * (send), platform-retained context (history), fetchContactsList +
+ * getBriefInfo + getChatroomInfo (contacts), getProfile (profile),
+ * checkOnline (status). History always emits its stable page JSON; the other
+ * verbs render agent-readable text by default and accept `--json`.
  *
  * INTERNAL research preview: the capability is flag-gated to the internal
  * org. Design: docs/engineering-design/wechat-channel-design.md §3, §4.
@@ -52,6 +53,33 @@ export function registerWechatCommands(program) {
             printError(err);
         }
     });
+    wechat
+        .command('history')
+        .description('Read platform-retained context for a WeChat DM or group')
+        .requiredOption('--conversation <id>', 'Vendor-native conversation id (a friend wxid, or a room id ending in @chatroom)')
+        .option('--before <messageId>', 'Read messages strictly older than this external message id')
+        .option('--since <time>', 'Inclusive lower bound: RFC3339 timestamp or YYYY-MM-DD')
+        .option('--limit <n>', 'Page size (default 20, max 100)')
+        .action(async (opts) => {
+        try {
+            let limit;
+            if (opts.limit !== undefined) {
+                limit = Number(opts.limit);
+                if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+                    throw new Error('--limit must be an integer between 1 and 100');
+                }
+            }
+            const { client, orgId } = resolveCredentials();
+            printJson(await client.wechatHistory(orgId, opts.conversation, {
+                ...(opts.before ? { before: opts.before } : {}),
+                ...(opts.since ? { since: opts.since } : {}),
+                ...(limit !== undefined ? { limit } : {}),
+            }));
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
     wechat
         .command('contacts')
         .description('List the account address book with display names: friends, saved groups, followed official accounts')

package/dist/index.js

@@ -9,6 +9,8 @@ import { registerMessageCommands } from './commands/messages.js';
 import { registerTaskCommands } from './commands/tasks.js';
 import { registerCommentCommands } from './commands/comments.js';
 import { registerProjectCommands } from './commands/projects.js';
+import { registerProfileCommands } from './commands/profile.js';
+import { registerTeamCommands } from './commands/teams.js';
 import { registerScheduleCommands } from './commands/schedules.js';
 import { registerExternalTriggerCommands } from './commands/external-triggers.js';
 import { registerUserCommands } from './commands/users.js';
@@ -22,6 +24,7 @@ import { registerMachineCommands } from './commands/machines.js';
 import { registerClipCommands } from './commands/clip.js';
 import { registerSlackCommands } from './commands/slack.js';
 import { registerWechatCommands } from './commands/wechat.js';
+import { createUpdateNotifier } from './lib/update-check.js';
 const require = createRequire(import.meta.url);
 const pkg = require('../package.json');
 const program = new Command();
@@ -37,6 +40,8 @@ registerMessageCommands(program);
 registerTaskCommands(program);
 registerCommentCommands(program);
 registerProjectCommands(program);
+registerProfileCommands(program);
+registerTeamCommands(program);
 registerScheduleCommands(program);
 registerExternalTriggerCommands(program);
 registerUserCommands(program);
@@ -50,4 +55,10 @@ registerMachineCommands(program);
 registerClipCommands(program);
 registerSlackCommands(program);
 registerWechatCommands(program);
+const updateNotifier = createUpdateNotifier(pkg.version);
+program.hook('postAction', () => {
+    if (process.exitCode === undefined || process.exitCode === 0) {
+        updateNotifier.afterSuccessfulCommand();
+    }
+});
 program.parse();