@parall/cli 1.35.0 → 1.36.1

package/dist/commands/search.js

@@ -0,0 +1,70 @@
+import { resolveCredentials } from '../lib/client.js';
+import { parsePositiveInt, printError, printJson, stripPrllScheme } from '../lib/output.js';
+// Short aliases agents pass via --types map to the server's entity names.
+const TYPE_ALIASES = {
+    m: 'message',
+    message: 'message',
+    messages: 'message',
+    t: 'task',
+    task: 'task',
+    tasks: 'task',
+    w: 'wiki',
+    wiki: 'wiki',
+};
+/**
+ * Normalize a `--types m,t,w` flag into the server's CSV of canonical entity
+ * names (`message,task,wiki`). Unknown tokens pass through unchanged so the
+ * server can reject/ignore them. Returns undefined for an empty/absent flag so
+ * the server applies its default (search all three).
+ */
+export function normalizeSearchTypes(raw) {
+    if (!raw)
+        return undefined;
+    const mapped = raw
+        .split(',')
+        .map((s) => s.trim().toLowerCase())
+        .filter(Boolean)
+        .map((s) => TYPE_ALIASES[s] ?? s);
+    const unique = [...new Set(mapped)];
+    return unique.length > 0 ? unique.join(',') : undefined;
+}
+/** Build the SDK search params from the positional query + CLI flags. */
+export function buildSearchParams(query, opts) {
+    const params = { q: query };
+    const types = normalizeSearchTypes(opts.types);
+    if (types)
+        params.types = types;
+    if (opts.channel !== undefined)
+        params.chat_id = stripPrllScheme(opts.channel);
+    // Only forward a clean positive integer; a bad --limit falls through to the
+    // server default rather than sending NaN/1.5/-2.
+    const limit = parsePositiveInt(opts.limit);
+    if (limit !== undefined)
+        params.limit = limit;
+    if (opts.wikiType !== undefined)
+        params.wiki_type = opts.wikiType;
+    if (opts.since !== undefined)
+        params.since = opts.since;
+    return params;
+}
+export function registerSearchCommands(program) {
+    program
+        .command('search')
+        .description('Unified semantic search across messages, tasks, and wiki (org-scoped)')
+        .argument('<query>', 'Search query')
+        .option('--types <list>', 'Comma-separated entity types: m[essage], t[ask], w[iki] (default: all)')
+        .option('--channel <chatId>', 'Narrow MESSAGE results to one chat — tasks/wiki unaffected (prll://cht_… or cht_…)')
+        .option('--limit <n>', 'Max results per entity type (server caps at 50)')
+        .option('--wiki-type <type>', 'Narrow wiki results to a frontmatter document type')
+        .option('--since <date>', 'Only messages/tasks at or after this time (RFC3339 or YYYY-MM-DD); not applied to wiki')
+        .action(async (query, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.search(orgId, buildSearchParams(query, opts));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

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,QAoSpD"}
+{"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,QAqTpD"}

package/dist/commands/tasks.js

@@ -148,6 +148,21 @@ export function registerTaskCommands(program) {
             printError(err);
         }
     });
+    tasks
+        .command('assigned')
+        .description("List pending tasks (todo + in_progress) on a member's plate, including subtasks assigned to them")
+        .argument('[memberId]', 'Member user ID (defaults to the authenticated user)')
+        .action(async (memberId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const targetId = memberId ? stripPrllScheme(memberId) : (await client.getMe()).id;
+            const result = await client.getMemberTasksAll(orgId, targetId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
     // ---- Comments subgroup ----
     const comments = tasks.command('comments').description('Manage task comments');
     comments

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,QAy3BpD"}
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../src/commands/wiki.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAk/BpD"}

package/dist/commands/wiki.js

@@ -1,5 +1,7 @@
+import { promises as fs } from 'node:fs';
 import { resolveCredentials, resolveRuntimeContext } from '../lib/client.js';
 import { printError, printJson } from '../lib/output.js';
+import { deleteWikiFile, downloadWikiFile, uploadWikiFile } from '../lib/wiki-files.js';
 import { getAfcsDiff, getAfcsStatus, getWikiBlob, getWikiChangesetDetail, getWikiChangesetDiff, getWikiLog, getWikiOutline, getWikiSection, getWikiTree, listWikiChangesets, queryWiki, requestWikiAccess, resetWikiWorkspace, listWikis, proposeWikiChangeset, searchWiki, syncAllMounts, watchMounts, } from '../lib/wiki.js';
 export function registerWikiCommands(program) {
     const wiki = program.command('wiki').description('Parall Wiki — read, edit, and propose changes');
@@ -354,6 +356,94 @@ export function registerWikiCommands(program) {
             printError(error);
         }
     });
+    // ---- Binary files (upload / get / delete) ----
+    const file = wiki
+        .command('file')
+        .description('Upload, download, and delete binary wiki files (images, PDFs, archives)');
+    file
+        .command('upload')
+        .description('Upload a binary file. Direct-commits to the default branch (maintain); with --changeset, writes into a proposal branch (read + author). Text files go through changesets, not uploads.')
+        .argument('<localPath>', 'Local file to upload')
+        .argument('<repoPath>', 'Destination path inside the wiki (e.g. assets/diagram.png)')
+        .argument('[wiki]', 'Wiki ID or slug (auto-resolves if org has one wiki)')
+        .option('--changeset <changesetId>', "Upload into this changeset's feature branch instead of the default branch")
+        .option('--message <message>', 'Commit message (default: "Upload <path>")')
+        .action(async (localPath, repoPath, wikiRef, options) => {
+        try {
+            const ctx = resolveCredentials();
+            const content = await fs.readFile(localPath);
+            const result = await uploadWikiFile(ctx, wikiRef, {
+                content,
+                toPath: repoPath,
+                changesetId: options.changeset,
+                message: options.message,
+            });
+            const where = result.target === 'changeset' ? `changeset ${result.changeset_id}` : 'default branch';
+            process.stderr.write(`Uploaded ${result.path} (${result.size} bytes, ${result.stored_as}) → ${where}\n`);
+            printJson(result);
+        }
+        catch (error) {
+            printError(error);
+        }
+    });
+    file
+        .command('get')
+        .description('Download a wiki file as raw bytes (LFS pointers are smudged to real bytes). Writes to stdout, or to --output. Use --ref to read a specific commit / changeset branch.')
+        .argument('<repoPath>', 'File path inside the wiki')
+        .argument('[wiki]', 'Wiki ID or slug (auto-resolves if org has one wiki)')
+        .option('--ref <ref>', 'Branch, commit SHA, or changeset branch ref (default: wiki default branch)')
+        .option('-o, --output <localPath>', 'Write bytes to this local file instead of stdout')
+        .action(async (repoPath, wikiRef, options) => {
+        try {
+            const ctx = resolveCredentials();
+            const result = await downloadWikiFile(ctx, wikiRef, {
+                path: repoPath,
+                ref: options.ref,
+            });
+            if (options.output) {
+                await fs.writeFile(options.output, result.content);
+                process.stderr.write(`Wrote ${result.size} bytes → ${options.output}\n`);
+                // Buffer is omitted from JSON output; report metadata + where it went.
+                printJson({
+                    wiki_id: result.wiki_id,
+                    wiki_slug: result.wiki_slug,
+                    path: result.path,
+                    ref: result.ref,
+                    size: result.size,
+                    output: options.output,
+                });
+            }
+            else {
+                // Raw bytes to stdout (binary-safe); metadata to stderr. No JSON on
+                // stdout here — it would corrupt the byte stream.
+                process.stderr.write(`${result.path}  (${result.size} bytes${result.ref ? `, ref: ${result.ref}` : ''})\n`);
+                process.stdout.write(result.content);
+            }
+        }
+        catch (error) {
+            printError(error);
+        }
+    });
+    file
+        .command('delete')
+        .description('Delete a binary file from the wiki default branch (maintain). Text deletes must go through a changeset. The blob stays reachable in git history.')
+        .argument('<repoPath>', 'File path inside the wiki')
+        .argument('[wiki]', 'Wiki ID or slug (auto-resolves if org has one wiki)')
+        .option('--message <message>', 'Commit message (default: "Delete <path>")')
+        .action(async (repoPath, wikiRef, options) => {
+        try {
+            const ctx = resolveCredentials();
+            const result = await deleteWikiFile(ctx, wikiRef, {
+                path: repoPath,
+                message: options.message,
+            });
+            process.stderr.write(`Deleted ${result.path}\n`);
+            printJson(result);
+        }
+        catch (error) {
+            printError(error);
+        }
+    });
     // ---- Content browsing (search, query, outline, section) ----
     wiki
         .command('search')

package/dist/index.js

@@ -10,11 +10,13 @@ import { registerTaskCommands } from './commands/tasks.js';
 import { registerCommentCommands } from './commands/comments.js';
 import { registerProjectCommands } from './commands/projects.js';
 import { registerScheduleCommands } from './commands/schedules.js';
+import { registerExternalTriggerCommands } from './commands/external-triggers.js';
 import { registerUserCommands } from './commands/users.js';
 import { registerWikiCommands } from './commands/wiki.js';
 import { registerMcpCommands } from './commands/mcp.js';
 import { registerNoReplyCommands } from './commands/no-reply.js';
 import { registerRefCommands } from './commands/refs.js';
+import { registerSearchCommands } from './commands/search.js';
 import { registerFileCommands } from './commands/files.js';
 import { registerMachineCommands } from './commands/machines.js';
 import { registerClipCommands } from './commands/clip.js';
@@ -34,11 +36,13 @@ registerTaskCommands(program);
 registerCommentCommands(program);
 registerProjectCommands(program);
 registerScheduleCommands(program);
+registerExternalTriggerCommands(program);
 registerUserCommands(program);
 registerWikiCommands(program);
 registerMcpCommands(program);
 registerNoReplyCommands(program);
 registerRefCommands(program);
+registerSearchCommands(program);
 registerFileCommands(program);
 registerMachineCommands(program);
 registerClipCommands(program);

package/dist/lib/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAiCtD;AAED,wBAAgB,kBAAkB,IAAI,mBAAmB,CAwBxD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAiCtD;AAED,wBAAgB,kBAAkB,IAAI,mBAAmB,CA8BxD"}

package/dist/lib/client.js

@@ -59,6 +59,12 @@ export function resolveCredentials() {
     return {
         client: new ParallClient({
             baseUrl: url,
+            // Wiki endpoints (/wiki/v1) are served by wiki-service. Staging/prod front
+            // both behind one gateway (PRLL_WIKI_URL unset → falls back to the api URL,
+            // unchanged); local dev runs them on separate ports, so PRLL_WIKI_URL routes
+            // wiki calls (changeset, upload, file get, …) to :8090 while chat/task/
+            // comment/ref calls stay on PRLL_API_URL.
+            wikiBaseUrl: process.env.PRLL_WIKI_URL?.trim() || url,
             token: apiKey,
             swimlaneName: process.env.PRLL_SWIMLANE_NAME,
         }),

package/dist/lib/output.d.ts

@@ -9,5 +9,17 @@ export declare function printRefHint(entityId: string, action?: string): void;
  * Allows CLI commands to accept both raw IDs (`tsk_abc`) and URIs (`prll://tsk_abc`).
  */
 export declare function stripPrllScheme(idOrUri: string): string;
+/**
+ * Ensure a value carries the `prll://` scheme — the inverse of stripPrllScheme.
+ * Lets URI-consuming commands accept both `tsk_abc` and `prll://tsk_abc`.
+ */
+export declare function ensurePrllScheme(idOrUri: string): string;
+/**
+ * Parse a CLI numeric flag (string) into a positive integer, or undefined when
+ * absent or not a clean positive integer (NaN / fractional / <= 0). Callers omit
+ * the param on undefined so the server applies its own default + bounds rather
+ * than receiving a malformed value.
+ */
+export declare function parsePositiveInt(raw: string | undefined): number | undefined;
 export declare function printError(err: unknown): never;
 //# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,IAAI,CAEvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAwC9C"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,IAAI,CAEvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAW5E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAwC9C"}

package/dist/lib/output.js

@@ -16,6 +16,33 @@ export function printRefHint(entityId, action = 'Created') {
 export function stripPrllScheme(idOrUri) {
     return idOrUri.startsWith('prll://') ? idOrUri.slice(7) : idOrUri;
 }
+/**
+ * Ensure a value carries the `prll://` scheme — the inverse of stripPrllScheme.
+ * Lets URI-consuming commands accept both `tsk_abc` and `prll://tsk_abc`.
+ */
+export function ensurePrllScheme(idOrUri) {
+    return idOrUri.startsWith('prll://') ? idOrUri : `prll://${idOrUri}`;
+}
+/**
+ * Parse a CLI numeric flag (string) into a positive integer, or undefined when
+ * absent or not a clean positive integer (NaN / fractional / <= 0). Callers omit
+ * the param on undefined so the server applies its own default + bounds rather
+ * than receiving a malformed value.
+ */
+export function parsePositiveInt(raw) {
+    if (raw === undefined)
+        return undefined;
+    // Plain decimal digits only — reject the scientific/hex/float forms Number()
+    // would otherwise coerce (1e2, 0x10, 1.5) so "clean positive integer" holds.
+    const t = raw.trim();
+    if (!/^\d+$/.test(t))
+        return undefined;
+    // The regex alone is NOT enough: a digit-only string of hundreds of digits
+    // overflows Number() to Infinity, which Number.isInteger rejects — so this
+    // guard still does real work (keeps `limit=Infinity` off the wire).
+    const n = Number(t);
+    return Number.isInteger(n) && n > 0 ? n : undefined;
+}
 export function printError(err) {
     if (err instanceof ApiError) {
         // Faithful, parseable line: the server's real message + machine anchors.

package/dist/lib/wiki-files.d.ts

@@ -0,0 +1,76 @@
+import type { WikiStoredAs } from '@parall/sdk';
+import { type ParallContext } from './wiki.js';
+/** Hard upload ceiling — mirrors server `handler.MaxWikiUploadBytes` (100 MiB). */
+export declare const MAX_WIKI_UPLOAD_BYTES: number;
+export type WikiFileUploadResult = {
+    wiki_id: string;
+    wiki_slug: string;
+    wiki_name: string;
+    path: string;
+    size: number;
+    stored_as: WikiStoredAs;
+    commit_sha: string;
+    content_sha: string;
+    /** Where the write landed: the default branch (direct) or a changeset branch. */
+    target: 'default_branch' | 'changeset';
+    /** Present only when uploaded into a changeset's feature branch. */
+    changeset_id?: string;
+};
+export type WikiFileDownloadResult = {
+    wiki_id: string;
+    wiki_slug: string;
+    wiki_name: string;
+    path: string;
+    /** The ref that was read (omitted when defaulting to the wiki's default branch). */
+    ref?: string;
+    size: number;
+    /** Raw file bytes (LFS pointers are smudged server-side — these are the real bytes). */
+    content: Buffer;
+};
+export type WikiFileDeleteResult = {
+    wiki_id: string;
+    wiki_slug: string;
+    wiki_name: string;
+    path: string;
+};
+export type UploadWikiFileOptions = {
+    /** Destination path inside the wiki repo, e.g. "assets/diagram.png". */
+    toPath: string;
+    /** Raw file bytes to upload. */
+    content: Buffer;
+    /** When set, write into this changeset's feature branch (read + author) instead
+     * of direct-committing to the default branch (maintain). */
+    changesetId?: string;
+    /** Optional commit message (server defaults to "Upload {path}"). */
+    message?: string;
+};
+/**
+ * Upload a binary file to a wiki. With `changesetId`, writes into that
+ * changeset's feature branch (the reader "propose with an image" path);
+ * without it, direct-commits to the default branch (maintain). Text content is
+ * rejected locally with a pointer to the changeset flow so the agent doesn't
+ * round-trip into a 422.
+ */
+export declare function uploadWikiFile(ctx: ParallContext, wikiRef: string | undefined, options: UploadWikiFileOptions): Promise<WikiFileUploadResult>;
+/**
+ * Download a wiki file's raw bytes via the bearer-authenticated
+ * `GET /files/{path}?ref=` endpoint. The server smudges LFS pointers, so the
+ * agent gets the real binary — never the few-line pointer that lands on disk
+ * from a plain `wiki sync` (the runtime image has no git-lfs). `ref` reads any
+ * branch / commit (including a changeset feature branch); it defaults to the
+ * wiki's default branch.
+ */
+export declare function downloadWikiFile(ctx: ParallContext, wikiRef: string | undefined, options: {
+    path: string;
+    ref?: string;
+}): Promise<WikiFileDownloadResult>;
+/**
+ * Delete a binary file from the wiki's default branch (maintain). Text deletes
+ * must go through a changeset; the server returns 422 USE_CHANGESET for those.
+ * The blob stays reachable via git history — this only removes it from HEAD.
+ */
+export declare function deleteWikiFile(ctx: ParallContext, wikiRef: string | undefined, options: {
+    path: string;
+    message?: string;
+}): Promise<WikiFileDeleteResult>;
+//# sourceMappingURL=wiki-files.d.ts.map

package/dist/lib/wiki-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-files.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAGL,KAAK,aAAa,EAKnB,MAAM,WAAW,CAAC;AAoBnB,mFAAmF;AACnF,eAAO,MAAM,qBAAqB,QAAoB,CAAC;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,YAAY,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IACvC,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB;gEAC4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CA4D/B;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAAC,sBAAsB,CAAC,CAsCjC;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,OAAO,CAAC,oBAAoB,CAAC,CAa/B"}

package/dist/lib/wiki-files.js

@@ -0,0 +1,169 @@
+import { isWikiTextContent, normalizeRequiredWikiPath, resolveApiToken, resolveWikiRef, resolveWikiServiceBaseUrl, TEXT_MAX_BYTES, } from './wiki.js';
+// ---------------------------------------------------------------------------
+// Wiki binary file CRUD (Phase 4 of wiki-file-storage-design).
+//
+// Text files keep flowing through the changeset workspace (sync → edit →
+// propose); this module is the agent-facing surface for *binary* assets —
+// images, PDFs, archives — that can't be diffed and must not be base64-inlined
+// into changeset JSON. It wraps the wiki-service endpoints:
+//   - POST   /uploads                  (maintain, direct-commit default branch)
+//   - POST   /changesets/{csId}/files  (read + author, into a feature branch)
+//   - GET    /files/{path}?ref=        (read, raw bytes — bearer auth, never a
+//                                       browser <img> which can't send a token)
+//   - DELETE /files?path=              (maintain)
+//
+// Routing/size/text classification is the server's authority; the local
+// pre-checks here just turn the common mistakes into instant, actionable CLI
+// errors instead of a wasted upload that bounces off a 422/413.
+// ---------------------------------------------------------------------------
+/** Hard upload ceiling — mirrors server `handler.MaxWikiUploadBytes` (100 MiB). */
+export const MAX_WIKI_UPLOAD_BYTES = 100 * 1024 * 1024;
+/**
+ * Upload a binary file to a wiki. With `changesetId`, writes into that
+ * changeset's feature branch (the reader "propose with an image" path);
+ * without it, direct-commits to the default branch (maintain). Text content is
+ * rejected locally with a pointer to the changeset flow so the agent doesn't
+ * round-trip into a 422.
+ */
+export async function uploadWikiFile(ctx, wikiRef, options) {
+    const wiki = await resolveWikiRef(ctx, wikiRef);
+    const toPath = normalizeRequiredWikiPath(options.toPath);
+    const content = options.content;
+    const changesetId = options.changesetId?.trim() || undefined;
+    if (content.length === 0) {
+        throw new Error(`cannot upload ${toPath}: file is empty`);
+    }
+    if (content.length > MAX_WIKI_UPLOAD_BYTES) {
+        throw new Error(`cannot upload ${toPath}: file is ${content.length} bytes, ` +
+            `over the ${MAX_WIKI_UPLOAD_BYTES}-byte (100 MiB) upload limit`);
+    }
+    // LFS pointer text is a server-generated artifact; uploading it directly
+    // would commit a dangling pointer. Reject before the text check (a pointer
+    // is valid UTF-8 and would otherwise be misrouted to "use a changeset").
+    if (looksLikeLfsPointer(content)) {
+        throw new Error(`cannot upload ${toPath}: this is a Git-LFS pointer, not real bytes. ` +
+            'Upload the underlying binary and the server generates the pointer.');
+    }
+    // Mirror the server's text gate (filetype: len <= TextMaxBytes && IsText):
+    // text goes through changesets so the diff stays reviewable.
+    if (content.length <= TEXT_MAX_BYTES && isWikiTextContent(content)) {
+        throw new Error(`cannot upload ${toPath}: it looks like a text file, and text changes go ` +
+            'through changesets (sync → edit → `parall wiki changeset create`), not uploads. ' +
+            'Uploads are for binary assets (images, PDFs, archives).');
+    }
+    // Node Buffer is a Uint8Array (a valid BlobPart); Blob copies the bytes.
+    const blob = new Blob([content]);
+    const resp = changesetId
+        ? await ctx.client.uploadWikiFileToChangeset(ctx.orgId, wiki.id, changesetId, {
+            path: toPath,
+            file: blob,
+            message: options.message,
+        })
+        : await ctx.client.uploadWikiFile(ctx.orgId, wiki.id, {
+            path: toPath,
+            file: blob,
+            message: options.message,
+        });
+    return {
+        wiki_id: wiki.id,
+        wiki_slug: wiki.slug,
+        wiki_name: wiki.name,
+        path: resp.path,
+        size: resp.size,
+        stored_as: resp.stored_as,
+        commit_sha: resp.commit_sha,
+        content_sha: resp.content_sha,
+        target: changesetId ? 'changeset' : 'default_branch',
+        ...(changesetId ? { changeset_id: changesetId } : {}),
+    };
+}
+/**
+ * Download a wiki file's raw bytes via the bearer-authenticated
+ * `GET /files/{path}?ref=` endpoint. The server smudges LFS pointers, so the
+ * agent gets the real binary — never the few-line pointer that lands on disk
+ * from a plain `wiki sync` (the runtime image has no git-lfs). `ref` reads any
+ * branch / commit (including a changeset feature branch); it defaults to the
+ * wiki's default branch.
+ */
+export async function downloadWikiFile(ctx, wikiRef, options) {
+    const wiki = await resolveWikiRef(ctx, wikiRef);
+    const filePath = normalizeRequiredWikiPath(options.path);
+    const ref = options.ref?.trim() || undefined;
+    const token = resolveApiToken(ctx);
+    const base = wikiServiceBaseUrl(ctx);
+    // Encode each path segment so spaces / unicode in the path don't break the
+    // URL; the server's chi `/files/*` wildcard decodes them back.
+    const encodedPath = filePath.split('/').map(encodeURIComponent).join('/');
+    let url = `${base}/wiki/v1/orgs/${ctx.orgId}/wikis/${wiki.id}/files/${encodedPath}`;
+    if (ref) {
+        url += `?ref=${encodeURIComponent(ref)}`;
+    }
+    const headers = { Authorization: `Bearer ${token}` };
+    if (process.env.PRLL_SWIMLANE_NAME) {
+        headers['X-Prll-Swimlane'] = process.env.PRLL_SWIMLANE_NAME;
+    }
+    const response = await fetch(url, { headers });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`wiki-service GET ${url}: ${response.status} ${response.statusText}${text ? ` — ${text}` : ''}`);
+    }
+    const content = Buffer.from(await response.arrayBuffer());
+    return {
+        wiki_id: wiki.id,
+        wiki_slug: wiki.slug,
+        wiki_name: wiki.name,
+        path: filePath,
+        ref,
+        size: content.length,
+        content,
+    };
+}
+/**
+ * Delete a binary file from the wiki's default branch (maintain). Text deletes
+ * must go through a changeset; the server returns 422 USE_CHANGESET for those.
+ * The blob stays reachable via git history — this only removes it from HEAD.
+ */
+export async function deleteWikiFile(ctx, wikiRef, options) {
+    const wiki = await resolveWikiRef(ctx, wikiRef);
+    const filePath = normalizeRequiredWikiPath(options.path);
+    await ctx.client.deleteWikiFile(ctx.orgId, wiki.id, {
+        path: filePath,
+        message: options.message?.trim() || undefined,
+    });
+    return {
+        wiki_id: wiki.id,
+        wiki_slug: wiki.slug,
+        wiki_name: wiki.name,
+        path: filePath,
+    };
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/**
+ * Wiki-service base URL for the raw-byte download, reusing the shared resolver
+ * (SSOT in wiki.ts, same chain as sync/bulk-download) and turning a missing
+ * base into an actionable error instead of a malformed-URL fetch failure.
+ */
+function wikiServiceBaseUrl(ctx) {
+    const base = resolveWikiServiceBaseUrl(ctx);
+    if (!base) {
+        throw new Error('wiki-service base URL is required (set PRLL_WIKI_URL or PRLL_API_URL) to download wiki files');
+    }
+    return base;
+}
+/**
+ * Pre-check mirror of the server's `gitea.IsLFSPointer` first-line gate. A
+ * full parse isn't needed — matching the version line is enough to give the
+ * LFS-specific message and avoid the changeset↔upload loop the design warns
+ * about. Anything pointer-shaped but malformed falls through to the server's
+ * authoritative classifier.
+ */
+function looksLikeLfsPointer(content) {
+    if (content.length === 0 || content.length > 1024) {
+        return false;
+    }
+    const nl = content.indexOf(0x0a);
+    const firstLine = content.subarray(0, nl >= 0 ? nl : content.length).toString('utf8');
+    return firstLine.startsWith('version https://git-lfs.github.com/spec/v1');
+}

package/dist/lib/wiki-tools.d.ts

@@ -26,8 +26,9 @@ export type WikiToolDefinition = {
 /**
  * Build the full wiki native tool registry bound to a Parall context (credentials,
  * agent env, local mount). Returns one definition per wiki capability (list, tree,
- * status, diff, blob, search, query, outline, section, changeset diff, propose),
- * each finalized with input validation. Shared by the MCP server and the eval harness.
+ * status, diff, blob, search, query, outline, section, changeset diff, propose,
+ * binary file upload/get/delete), each finalized with input validation. Shared by
+ * the MCP server and the eval harness.
  */
 export declare function buildWikiTools(ctx: ParallContext): WikiToolDefinition[];
 //# sourceMappingURL=wiki-tools.d.ts.map

package/dist/lib/wiki-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki-tools.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EASL,KAAK,aAAa,EAInB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;;GASG;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,YAAY,EAAE,CAAC,CAAC,WAAW,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC9E,CAAC;AAoBF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,kBAAkB,EAAE,CAiiBvE"}
+{"version":3,"file":"wiki-tools.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EASL,KAAK,aAAa,EAInB,MAAM,WAAW,CAAC;AAUnB;;;;;;;;;GASG;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC;IAC3B,YAAY,EAAE,CAAC,CAAC,WAAW,CAAC;IAC5B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC9E,CAAC;AAmCF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,kBAAkB,EAAE,CAwrBvE"}