@interop/did-cli 0.13.0 → 0.15.0

package/dist/commands/was/shell/session.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The mutable interactive-shell session state. The signing server/DID defaults
+ * ride the `WAS_SERVER_URL` / `WAS_DID` environment channel (see
+ * `runWasShell`), so the session only tracks the working directory.
+ */
+export interface ShellSession {
+    /** The current path segments: `[]`, `[space]`, or `[space, collection]`. */
+    cwd: string[];
+}
+/**
+ * Computes a new working directory from a `cd`/`use` argument. Supports an
+ * absolute path (leading `/`), `.`/`..` navigation, a relative path joined onto
+ * the current cwd, and a full space URL (which also yields the server origin to
+ * adopt as the session default). Throws when the result would descend past a
+ * collection.
+ *
+ * @param options {object}
+ * @param options.cwd {string[]}   The current working directory segments.
+ * @param options.arg {string}   The `cd`/`use` argument.
+ * @returns {{cwd: string[], server?: string}}
+ */
+export declare function resolveCwdChange({ cwd, arg }: {
+    cwd: string[];
+    arg: string;
+}): {
+    cwd: string[];
+    server?: string;
+};
+/**
+ * Formats a working directory for display in the prompt (`/`, `/space`, or
+ * `/space/collection`).
+ *
+ * @param cwd {string[]}
+ * @returns {string}
+ */
+export declare function formatCwd(cwd: string[]): string;
+//# sourceMappingURL=session.d.ts.map

package/dist/commands/was/shell/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../src/commands/was/shell/session.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,GAAG,EACJ,EAAE;IACD,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;CACZ,GAAG;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAyCrC;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,CAE/C"}

package/dist/commands/was/shell/session.js

@@ -0,0 +1,67 @@
+/**
+ * The interactive shell's working-directory model: a current path of up to two
+ * segments (`[]` root, `[space]`, or `[space, collection]`) plus the `cd`/`use`
+ * math that walks it. A WAS path is at most `SPACE/COLLECTION/RESOURCE` deep,
+ * so the cwd never descends past a collection (resources are leaves you `get`,
+ * not directories you enter).
+ */
+import { parseWasAddress, tryParseHttpUrl } from '../../../was/address.js';
+/**
+ * Computes a new working directory from a `cd`/`use` argument. Supports an
+ * absolute path (leading `/`), `.`/`..` navigation, a relative path joined onto
+ * the current cwd, and a full space URL (which also yields the server origin to
+ * adopt as the session default). Throws when the result would descend past a
+ * collection.
+ *
+ * @param options {object}
+ * @param options.cwd {string[]}   The current working directory segments.
+ * @param options.arg {string}   The `cd`/`use` argument.
+ * @returns {{cwd: string[], server?: string}}
+ */
+export function resolveCwdChange({ cwd, arg }) {
+    if (tryParseHttpUrl(arg)) {
+        const parsed = parseWasAddress(arg);
+        if (parsed.resourceId !== undefined) {
+            throw new Error(`Cannot cd to "${arg}": it addresses a resource, not a directory.`);
+        }
+        const next = [parsed.spaceRef];
+        if (parsed.collectionId !== undefined) {
+            next.push(parsed.collectionId);
+        }
+        return { cwd: next, server: parsed.server };
+    }
+    let next;
+    let path = arg;
+    if (path.startsWith('/')) {
+        next = [];
+        path = path.slice(1);
+    }
+    else {
+        next = [...cwd];
+    }
+    for (const segment of path.split('/')) {
+        if (segment === '' || segment === '.') {
+            continue;
+        }
+        if (segment === '..') {
+            next = next.slice(0, -1);
+            continue;
+        }
+        next.push(segment);
+    }
+    if (next.length > 2) {
+        throw new Error(`Cannot cd to "${arg}": a WAS path is at most SPACE/COLLECTION deep.`);
+    }
+    return { cwd: next };
+}
+/**
+ * Formats a working directory for display in the prompt (`/`, `/space`, or
+ * `/space/collection`).
+ *
+ * @param cwd {string[]}
+ * @returns {string}
+ */
+export function formatCwd(cwd) {
+    return `/${cwd.join('/')}`;
+}
+//# sourceMappingURL=session.js.map

package/dist/commands/was/shell/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../../src/commands/was/shell/session.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAY1E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,GAAG,EACH,GAAG,EAIJ;IACC,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,iBAAiB,GAAG,8CAA8C,CACnE,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QAC9B,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;QAChC,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;IAC7C,CAAC;IAED,IAAI,IAAc,CAAA;IAClB,IAAI,IAAI,GAAG,GAAG,CAAA;IACd,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,GAAG,EAAE,CAAA;QACT,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACtB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CAAA;IACjB,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YACtC,SAAQ;QACV,CAAC;QACD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YACxB,SAAQ;QACV,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,iBAAiB,GAAG,iDAAiD,CACtE,CAAA;IACH,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAA;AACtB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAa;IACrC,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AAC5B,CAAC"}

package/dist/commands/was/shell/tokenize.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Splits an interactive-shell input line into argv tokens, honoring single
+ * quotes, double quotes, and backslash escapes so quoted paths and payloads
+ * survive the trip to commander. Kept dependency-free, consistent with the
+ * project's no-inquirer / no-chalk stance.
+ *
+ * Quoting rules mirror a POSIX shell closely enough for path entry: single
+ * quotes are literal (no escapes inside), double quotes allow backslash to
+ * escape the next character, and a bare backslash escapes the next character.
+ * An unterminated quote throws.
+ */
+/**
+ * Tokenizes a shell input line into argv-style tokens.
+ *
+ * @param line {string}
+ * @returns {string[]}
+ */
+export declare function tokenizeShellLine(line: string): string[];
+//# sourceMappingURL=tokenize.d.ts.map

package/dist/commands/was/shell/tokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../../../src/commands/was/shell/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA8DxD"}

package/dist/commands/was/shell/tokenize.js

@@ -0,0 +1,77 @@
+/**
+ * Splits an interactive-shell input line into argv tokens, honoring single
+ * quotes, double quotes, and backslash escapes so quoted paths and payloads
+ * survive the trip to commander. Kept dependency-free, consistent with the
+ * project's no-inquirer / no-chalk stance.
+ *
+ * Quoting rules mirror a POSIX shell closely enough for path entry: single
+ * quotes are literal (no escapes inside), double quotes allow backslash to
+ * escape the next character, and a bare backslash escapes the next character.
+ * An unterminated quote throws.
+ */
+/**
+ * Tokenizes a shell input line into argv-style tokens.
+ *
+ * @param line {string}
+ * @returns {string[]}
+ */
+export function tokenizeShellLine(line) {
+    const tokens = [];
+    let current = '';
+    let hasToken = false;
+    let quote;
+    for (let index = 0; index < line.length; index++) {
+        const char = line[index];
+        if (quote) {
+            if (char === quote) {
+                quote = undefined;
+            }
+            else if (char === '\\' && quote === '"') {
+                const next = line[index + 1];
+                if (next === undefined) {
+                    current += char;
+                }
+                else {
+                    current += next;
+                    index++;
+                }
+            }
+            else {
+                current += char;
+            }
+            continue;
+        }
+        if (char === '"' || char === "'") {
+            quote = char;
+            hasToken = true;
+            continue;
+        }
+        if (char === '\\') {
+            const next = line[index + 1];
+            if (next !== undefined) {
+                current += next;
+                index++;
+            }
+            hasToken = true;
+            continue;
+        }
+        if (char === ' ' || char === '\t') {
+            if (hasToken) {
+                tokens.push(current);
+                current = '';
+                hasToken = false;
+            }
+            continue;
+        }
+        current += char;
+        hasToken = true;
+    }
+    if (quote) {
+        throw new Error('Unterminated quote in input.');
+    }
+    if (hasToken) {
+        tokens.push(current);
+    }
+    return tokens;
+}
+//# sourceMappingURL=tokenize.js.map

package/dist/commands/was/shell/tokenize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../../../src/commands/was/shell/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,OAAO,GAAG,EAAE,CAAA;IAChB,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,KAA4B,CAAA;IAEhC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAA;QAExB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,KAAK,GAAG,SAAS,CAAA;YACnB,CAAC;iBAAM,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;gBAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;gBAC5B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACvB,OAAO,IAAI,IAAI,CAAA;gBACjB,CAAC;qBAAM,CAAC;oBACN,OAAO,IAAI,IAAI,CAAA;oBACf,KAAK,EAAE,CAAA;gBACT,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,IAAI,CAAA;YACjB,CAAC;YACD,SAAQ;QACV,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjC,KAAK,GAAG,IAAI,CAAA;YACZ,QAAQ,GAAG,IAAI,CAAA;YACf,SAAQ;QACV,CAAC;QAED,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAA;YAC5B,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,IAAI,IAAI,CAAA;gBACf,KAAK,EAAE,CAAA;YACT,CAAC;YACD,QAAQ,GAAG,IAAI,CAAA;YACf,SAAQ;QACV,CAAC;QAED,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClC,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACpB,OAAO,GAAG,EAAE,CAAA;gBACZ,QAAQ,GAAG,KAAK,CAAA;YAClB,CAAC;YACD,SAAQ;QACV,CAAC;QAED,OAAO,IAAI,IAAI,CAAA;QACf,QAAQ,GAAG,IAAI,CAAA;IACjB,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;IACjD,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACtB,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/commands/was/shell.d.ts

@@ -0,0 +1,30 @@
+import { Command } from 'commander';
+/**
+ * Builds the `shell [path]` command. `[path]` is the initial working directory
+ * and `--server`/`--did` seed the session defaults.
+ *
+ * @returns {Command}
+ */
+export declare function makeWasShellCommand(): Command;
+/**
+ * Runs the interactive WAS shell: snapshots the env defaults, builds and
+ * shell-configures the command tree, and drives a readline question loop until
+ * `exit`/`quit` or end-of-input. Server/DID env defaults and the address base
+ * are restored on exit.
+ *
+ * @param options {object}
+ * @param [options.path] {string}   Initial working directory.
+ * @param [options.server] {string}   Initial `WAS_SERVER_URL` default.
+ * @param [options.did] {string}   Initial `WAS_DID` default.
+ * @param [options.input] {NodeJS.ReadableStream}   REPL input (defaults to stdin).
+ * @param [options.output] {NodeJS.WritableStream}   REPL output (defaults to stderr).
+ * @returns {Promise<number>}   The process exit code (always 0).
+ */
+export declare function runWasShell({ path, server, did, input, output }?: {
+    path?: string;
+    server?: string;
+    did?: string;
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+}): Promise<number>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/commands/was/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/commands/was/shell.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAWnC;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAiB7C;AA+CD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,EAChC,IAAI,EACJ,MAAM,EACN,GAAG,EACH,KAAqB,EACrB,MAAuB,EACxB,GAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAC1B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFvB"}

package/dist/commands/was/shell.js

@@ -0,0 +1,170 @@
+/**
+ * `was shell` -- an interactive REPL over the `was` command tree. It builds the
+ * existing `makeWasCommand()` tree once and re-`parseAsync`es it per input
+ * line, so every subcommand, the space registry, signer loading, and the
+ * address grammar are reused verbatim. A "current directory" (`cd`/`use`) makes
+ * paths relative via the `setWasAddressBase` seam, and the `setRunAndExitReporter`
+ * seam keeps a failing command from exiting the process.
+ *
+ * Session server/DID defaults ride the `WAS_SERVER_URL` / `WAS_DID` environment
+ * channel that `resolveWasTarget`/`buildWasClient` already read at the right
+ * precedence; the shell snapshots both at startup and restores them on exit.
+ *
+ * The prompt and diagnostics go to stderr (the readline `output`); command data
+ * stays on stdout via the commands' own `console.log`, so `di was shell < script`
+ * keeps a pipe-clean stdout.
+ */
+import { createInterface } from 'node:readline/promises';
+import { Command } from 'commander';
+import { setWasAddressBase } from '../../was/address.js';
+import { didOption, serverOption, setRunAndExitReporter } from './shared.js';
+import { makeWasShellDispatcher } from './shell/dispatcher.js';
+import { makeShellCompleter } from './shell/completer.js';
+import { formatCwd, resolveCwdChange } from './shell/session.js';
+/**
+ * Builds the `shell [path]` command. `[path]` is the initial working directory
+ * and `--server`/`--did` seed the session defaults.
+ *
+ * @returns {Command}
+ */
+export function makeWasShellCommand() {
+    return new Command('shell')
+        .argument('[path]', 'initial working directory (SPACE[/COLLECTION])')
+        .description('Start an interactive WAS shell (REPL) for exploring spaces')
+        .addOption(serverOption())
+        .addOption(didOption())
+        .action(async (path, options) => {
+        const code = await runWasShell({ path, ...options });
+        if (code !== 0) {
+            process.exit(code);
+        }
+    });
+}
+/**
+ * Recursively applies `exitOverride()` (throw instead of `process.exit`) and
+ * routes commander's own output to the shell's stream, across the whole tree.
+ * `addCommand()` does not inherit these settings, so every subcommand must be
+ * configured explicitly.
+ *
+ * @param options {object}
+ * @param options.command {Command}
+ * @param options.output {NodeJS.WritableStream}
+ * @returns {void}
+ */
+function configureTreeForShell({ command, output }) {
+    command.exitOverride();
+    command.configureOutput({
+        writeOut: str => output.write(str),
+        writeErr: str => output.write(str)
+    });
+    for (const sub of command.commands) {
+        configureTreeForShell({ command: sub, output });
+    }
+}
+/**
+ * Sets or clears a process environment variable, deleting it when the value is
+ * undefined (so a snapshot restore removes vars that were unset at startup).
+ *
+ * @param options {object}
+ * @param options.key {string}
+ * @param [options.value] {string}
+ * @returns {void}
+ */
+function assignEnv({ key, value }) {
+    if (value === undefined) {
+        delete process.env[key];
+    }
+    else {
+        process.env[key] = value;
+    }
+}
+/**
+ * Runs the interactive WAS shell: snapshots the env defaults, builds and
+ * shell-configures the command tree, and drives a readline question loop until
+ * `exit`/`quit` or end-of-input. Server/DID env defaults and the address base
+ * are restored on exit.
+ *
+ * @param options {object}
+ * @param [options.path] {string}   Initial working directory.
+ * @param [options.server] {string}   Initial `WAS_SERVER_URL` default.
+ * @param [options.did] {string}   Initial `WAS_DID` default.
+ * @param [options.input] {NodeJS.ReadableStream}   REPL input (defaults to stdin).
+ * @param [options.output] {NodeJS.WritableStream}   REPL output (defaults to stderr).
+ * @returns {Promise<number>}   The process exit code (always 0).
+ */
+export async function runWasShell({ path, server, did, input = process.stdin, output = process.stderr } = {}) {
+    // `makeWasCommand` is imported lazily to break the module cycle with was.ts
+    // (which wires this shell command into the tree).
+    const { makeWasCommand } = await import('../was.js');
+    const tree = makeWasCommand();
+    configureTreeForShell({ command: tree, output });
+    const savedServer = process.env.WAS_SERVER_URL;
+    const savedDid = process.env.WAS_DID;
+    if (server !== undefined) {
+        process.env.WAS_SERVER_URL = server;
+    }
+    if (did !== undefined) {
+        process.env.WAS_DID = did;
+    }
+    const session = { cwd: [] };
+    if (path) {
+        try {
+            const change = resolveCwdChange({ cwd: [], arg: path });
+            session.cwd = change.cwd;
+            if (change.server) {
+                process.env.WAS_SERVER_URL = change.server;
+            }
+        }
+        catch (err) {
+            output.write(`${err.message}\n`);
+        }
+    }
+    // Keep failing commands from exiting the process.
+    setRunAndExitReporter(() => { });
+    const terminal = Boolean(input.isTTY);
+    const rl = createInterface({
+        input,
+        output,
+        terminal,
+        completer: makeShellCompleter({ tree, session })
+    });
+    const dispatch = makeWasShellDispatcher({ tree });
+    // Ctrl+C clears the current line and re-prompts (best effort) rather than
+    // exiting; Ctrl+D / end-of-input ends the readline async iterator below.
+    let currentPrompt = '';
+    rl.on('SIGINT', () => {
+        output.write(`\n${currentPrompt}`);
+    });
+    if (terminal) {
+        output.write('Interactive WAS shell. Type "help" for builtins, "exit" to quit.\n');
+    }
+    // The readline async iterator (unlike a `question` loop) buffers input lines
+    // instead of dropping any that arrive between prompts -- essential for
+    // scripted input (`di was shell < script`).
+    const lines = rl[Symbol.asyncIterator]();
+    try {
+        for (;;) {
+            setWasAddressBase(session.cwd);
+            currentPrompt = `was:${formatCwd(session.cwd)}> `;
+            output.write(currentPrompt);
+            const next = await lines.next();
+            if (next.done) {
+                output.write('\n');
+                break;
+            }
+            const outcome = await dispatch({ line: next.value, session, output });
+            if (outcome === 'exit') {
+                break;
+            }
+        }
+    }
+    finally {
+        setWasAddressBase([]);
+        setRunAndExitReporter();
+        rl.close();
+        assignEnv({ key: 'WAS_SERVER_URL', value: savedServer });
+        assignEnv({ key: 'WAS_DID', value: savedDid });
+    }
+    return 0;
+}
+//# sourceMappingURL=shell.js.map

package/dist/commands/was/shell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../../src/commands/was/shell.ts"],"names":[],"mappings":"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"}

package/dist/commands/was/tree.d.ts

@@ -24,13 +24,17 @@ export declare function runLs(options: {
 /**
  * The `was rm` shorthand: deletes whatever the path (or a `--capability`'s
  * invocation target) points at -- a space, a collection, or a resource (the
- * client's uniform `delete()` design).
+ * client's uniform `delete()` design). A collection capability deletes one
+ * resource inside it with `--resource <id>`, the counterpart of writing at a
+ * chosen id through the same grant.
  *
  * @param options {object}
  * @param [options.address] {string}   A space, collection, or resource
  *   address.
  * @param [options.capability] {string}   A capability reference instead of
  *   a path.
+ * @param [options.resource] {string}   The resource id beneath a collection
+ *   capability.
  * @param [options.server] {string}   The server base URL.
  * @param [options.did] {string}   The signing DID or stored-DID handle.
  * @returns {Promise<number>}   The process exit code.
@@ -38,6 +42,7 @@ export declare function runLs(options: {
 export declare function runRm(options: {
     address?: string;
     capability?: string;
+    resource?: string;
     server?: string;
     did?: string;
 }): Promise<number>;

package/dist/commands/was/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/commands/was/tree.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BlB"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/commands/was/tree.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CA0DlB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAiClB"}

package/dist/commands/was/tree.js

@@ -6,7 +6,7 @@
  */
 import { parseWasAddress } from '../../was/address.js';
 import { resolveCapabilityTarget } from '../../was/capability.js';
-import { assertOneAddressing, printCollectionListing, printResourceListing, reportDeleted, reportError, reportNotFound } from './shared.js';
+import { assertOneAddressing, printCollectionListing, printResourceListing, reportDeleted, reportError, reportNotFound, withResourceId } from './shared.js';
 import { runCollectionDelete, runCollectionList } from './collection.js';
 import { runResourceDelete, runResourceList } from './resource.js';
 import { runSpaceDelete } from './space.js';
@@ -86,13 +86,17 @@ export async function runLs(options) {
 /**
  * The `was rm` shorthand: deletes whatever the path (or a `--capability`'s
  * invocation target) points at -- a space, a collection, or a resource (the
- * client's uniform `delete()` design).
+ * client's uniform `delete()` design). A collection capability deletes one
+ * resource inside it with `--resource <id>`, the counterpart of writing at a
+ * chosen id through the same grant.
  *
  * @param options {object}
  * @param [options.address] {string}   A space, collection, or resource
  *   address.
  * @param [options.capability] {string}   A capability reference instead of
  *   a path.
+ * @param [options.resource] {string}   The resource id beneath a collection
+ *   capability.
  * @param [options.server] {string}   The server base URL.
  * @param [options.did] {string}   The signing DID or stored-DID handle.
  * @returns {Promise<number>}   The process exit code.
@@ -101,9 +105,12 @@ export async function runRm(options) {
     if (options.capability) {
         try {
             assertOneAddressing(options);
-            const resolved = await resolveCapabilityTarget({
-                ref: options.capability,
-                did: options.did
+            const resolved = withResourceId({
+                resolved: await resolveCapabilityTarget({
+                    ref: options.capability,
+                    did: options.did
+                }),
+                resourceId: options.resource
             });
             await resolved.handle.delete();
             reportDeleted(resolved.url);

package/dist/commands/was/tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../src/commands/was/tree.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../../../src/commands/was/tree.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"was.d.ts","sourceRoot":"","sources":["../../src/commands/was.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmHnC,wBAAgB,cAAc,IAAI,OAAO,CA+rBxC"}
+{"version":3,"file":"was.d.ts","sourceRoot":"","sources":["../../src/commands/was.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA0HnC,wBAAgB,cAAc,IAAI,OAAO,CAuxBxC"}

package/dist/commands/was.js

@@ -29,13 +29,15 @@
  * this module wires them onto the commander command tree.
  */
 import { Command } from 'commander';
-import { capabilityOption, contentTypeOption, didOption, disambiguatePayloadArgs, runAndExit, serverOption } from './was/shared.js';
+import { capabilityOption, contentTypeOption, didOption, disambiguatePayloadArgs, resourceIdOption, runAndExit, serverOption } from './was/shared.js';
 import { runSpaceAdd, runSpaceBackends, runSpaceCreate, runSpaceDelete, runSpaceExport, runSpaceForget, runSpaceImport, runSpaceList, runSpaceMeta, runSpaceQuotas, runSpaceShow, runSpaceUpdate } from './was/space.js';
 import { runCollectionBackend, runCollectionCreate, runCollectionDelete, runCollectionList, runCollectionQuota, runCollectionShow, runCollectionUpdate } from './was/collection.js';
 import { runResourceAdd, runResourceDelete, runResourceGet, runResourceList, runResourceMetaGet, runResourceMetaPut, runResourcePut } from './was/resource.js';
 import { runLs, runRm } from './was/tree.js';
 import { runPolicyClear, runPolicySet, runPolicyShow } from './was/policy.js';
 import { runGrant, runPublish, runUnpublish } from './was/publish.js';
+import { runRequestGrant } from './was/request-grant.js';
+import { makeWasShellCommand } from './was/shell.js';
 /**
  * Adds a resource `get [path]` verb to a parent command. Shared by
  * `was resource get` and the top-level `was get` shorthand, which differ only
@@ -51,6 +53,7 @@ function addGetCommand(parent, description) {
         .description(description)
         .option('--output <file>', 'write the resource content to a file')
         .addOption(capabilityOption())
+        .addOption(resourceIdOption())
         .addOption(serverOption())
         .addOption(didOption())
         .action(async (address, options) => {
@@ -72,6 +75,7 @@ function addPutCommand(parent, description) {
         .description(description)
         .addOption(contentTypeOption())
         .addOption(capabilityOption())
+        .addOption(resourceIdOption())
         .addOption(serverOption())
         .addOption(didOption())
         .action(async (address, file, options) => {
@@ -326,6 +330,7 @@ export function makeWasCommand() {
         .description("Show a resource's metadata: content type, size, timestamps, and " +
         'custom name/tags')
         .addOption(capabilityOption())
+        .addOption(resourceIdOption())
         .addOption(serverOption())
         .addOption(didOption())
         .action(async (address, options) => {
@@ -341,6 +346,7 @@ export function makeWasCommand() {
         .option('--json <jsonOrFile>', 'full custom-metadata replacement as inline JSON or a JSON file path ' +
         '(clears any omitted field)')
         .addOption(capabilityOption())
+        .addOption(resourceIdOption())
         .addOption(serverOption())
         .addOption(didOption())
         .action(async (address, options) => {
@@ -365,6 +371,7 @@ export function makeWasCommand() {
         .description('Delete whatever the path points at: a space, a collection, or a ' +
         'resource')
         .addOption(capabilityOption())
+        .addOption(resourceIdOption())
         .addOption(serverOption())
         .addOption(didOption())
         .action(async (address, options) => {
@@ -434,6 +441,32 @@ export function makeWasCommand() {
         .action(async (address, options) => {
         await runAndExit(runGrant({ address, ...options }));
     });
+    was
+        .command('request-grant')
+        .description('Ask a wallet for a capability on one of its public collections ' +
+        '(the inverse of grant: mints a key, prints a link for the user to ' +
+        'approve, and stores what comes back)')
+        .option('--collection <name>', 'the public collection to request access to (default web)')
+        .option('--action <verb...>', 'requested action(s): GET, HEAD, PUT, POST, DELETE (lowercase accepted)')
+        .option('--reason <text>', 'why access is wanted, shown to the user')
+        .option('--name <name>', 'what the agent calls itself, shown to the user beside its key ' +
+        '(self-declared; at most 64 characters)')
+        .option('--wallet <url>', "the user's wallet base URL, to also print a link that opens it " +
+        'straight onto the approval page')
+        .option('--save', 'store the minted key and the received capabilities (the default; ' +
+        'accepted so scripts can say it explicitly)')
+        .option('--no-save', 'do not store the minted key or the received capabilities (they cannot ' +
+        'then be invoked by a later command)')
+        .option('--handle <handle>', 'short tag for the minted key and received capabilities (default agent)')
+        .option('--description <description>', 'longer description for the saved items (requires --save)')
+        .option('--timeout <seconds>', 'how long to wait for approval (default 600, the server exchange TTL)')
+        .option('--json', 'print the DID, handle, and capabilities as JSON')
+        .option('--exchange <url>', 'base URL of the WAS server that hosts the ephemeral exchange (or ' +
+        'WAS_SERVER_URL)')
+        .action(async (options) => {
+        await runAndExit(runRequestGrant(options));
+    });
+    was.addCommand(makeWasShellCommand());
     return was;
 }
 //# sourceMappingURL=was.js.map