@soku-ai/cli 0.1.0-alpha.1 → 0.1.0-alpha.10

package/dist/commands/context.js

@@ -0,0 +1,291 @@
+/** `soku context` — manage the brand's Context Hub files.
+ *
+ * The agent can reference these files in chat. All paths are context-relative
+ * (no `context/` prefix); the server pins them into the brand's context/ GCS
+ * subtree. Upload is the same presigned two-step PUT the web Context Hub uses:
+ * POST to mint a signed URL, then PUT the bytes straight to storage.
+ */
+import { basename, extname, join, relative } from 'node:path';
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { apiRequest } from '../http/client.js';
+import { bold, dim, emitError, emitSuccess, emitSuccessExit, ExitCode, table } from '../output/envelope.js';
+const FILES_PATH = '/api/cli/context-hub/files';
+const UPLOAD_PATH = '/api/cli/context-hub/upload';
+const DIRECTORY_PATH = '/api/cli/context-hub/directory';
+const RENAME_PATH = '/api/cli/context-hub/rename';
+/** Minimal extension → MIME map. The content-type signed in the POST must match
+ * the PUT header exactly, so we compute it once and reuse it for both. */
+const MIME_BY_EXT = {
+    '.pdf': 'application/pdf',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.svg': 'image/svg+xml',
+    '.md': 'text/markdown',
+    '.markdown': 'text/markdown',
+    '.txt': 'text/plain',
+    '.csv': 'text/csv',
+    '.json': 'application/json',
+    '.html': 'text/html',
+    '.css': 'text/css',
+    '.js': 'text/javascript',
+    '.mp4': 'video/mp4',
+    '.mov': 'video/quicktime',
+    '.webm': 'video/webm',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+};
+function guessContentType(filename) {
+    return MIME_BY_EXT[extname(filename).toLowerCase()] ?? 'application/octet-stream';
+}
+function renderList(data) {
+    const here = data.dir ? `context-hub:/${data.dir}` : 'context-hub:/';
+    const parts = [bold(here)];
+    if (data.directories.length > 0) {
+        parts.push(data.directories.map((d) => `${dim('dir')}  ${d}/`).join('\n'));
+    }
+    if (data.files.length > 0) {
+        parts.push(table(data.files.map((f) => ({
+            name: f.name,
+            type: f.file_type,
+            size: f.size_bytes,
+            path: f.path,
+        })), [
+            { key: 'name', header: 'NAME' },
+            { key: 'type', header: 'TYPE' },
+            { key: 'size', header: 'BYTES' },
+            { key: 'path', header: 'PATH' },
+        ]));
+    }
+    if (data.directories.length === 0 && data.files.length === 0) {
+        parts.push(dim('(empty)'));
+    }
+    return parts.join('\n');
+}
+/** Files the CLI refuses to upload (operating-system cruft / editor state). */
+const IGNORED_UPLOAD_NAMES = new Set(['.DS_Store', 'Thumbs.db', '.gitignore']);
+/** Expand CLI args (globs, explicit files, and directories) into concrete
+ * upload tasks. Directories recurse, preserving their structure under `--dir`
+ * (so `upload ./assets --dir assets` lays out `assets/a/b.png` → `assets/a/b.png`).
+ * Dotfiles and OS cruft are skipped. */
+export function expandUploadPaths(rawPaths, opts) {
+    const tasks = [];
+    const seen = new Set();
+    const push = (localPath, targetDir, filename) => {
+        if (IGNORED_UPLOAD_NAMES.has(filename))
+            return;
+        if (filename.startsWith('.'))
+            return;
+        const key = `${targetDir}/${filename}`;
+        if (seen.has(key))
+            return;
+        seen.add(key);
+        tasks.push({ localPath, targetDir, filename });
+    };
+    for (const raw of rawPaths) {
+        let info;
+        try {
+            info = statSync(raw);
+        }
+        catch {
+            throw new Error(`No such file or directory: ${raw}`);
+        }
+        if (info.isFile()) {
+            // Shell-expanded globs land here as plain files. `--name` is applied by
+            // the caller only in the single-file case.
+            push(raw, opts.dir, basename(raw));
+            continue;
+        }
+        if (info.isDirectory()) {
+            walk(raw, (abs) => {
+                const rel = relative(raw, abs); // preserve structure: a/b.png
+                const dir = join(opts.dir, rel.slice(0, Math.max(0, rel.lastIndexOf('/'))));
+                push(abs, dir.replace(/\\/g, '/'), basename(abs));
+            });
+            continue;
+        }
+        throw new Error(`Not a file or directory: ${raw}`);
+    }
+    return tasks;
+}
+/** Synchronous recursive directory walk over regular files (no globs/deps). */
+function walk(root, visit) {
+    for (const entry of readdirSync(root, { withFileTypes: true })) {
+        const abs = join(root, entry.name);
+        if (entry.isDirectory())
+            walk(abs, visit);
+        else if (entry.isFile())
+            visit(abs);
+    }
+}
+/** Mint a presigned PUT URL then PUT the bytes — the two-step Context Hub
+ * upload, isolated to one file. The presigned URL carries its own auth; the
+ * Content-Type MUST match the one signed at mint time. */
+async function uploadOne(task, opts) {
+    const { localPath, targetDir, filename } = task;
+    const contentType = opts.contentType ?? guessContentType(filename);
+    let bytes;
+    try {
+        bytes = readFileSync(localPath);
+    }
+    catch (err) {
+        return { task, ok: false, error: `read failed: ${err.message}` };
+    }
+    let minted;
+    try {
+        minted = await apiRequest(UPLOAD_PATH, {
+            method: 'POST',
+            body: { filename, content_type: contentType, target_dir: targetDir },
+            workspace: true,
+        });
+    }
+    catch (err) {
+        return { task, ok: false, error: `mint failed: ${err.message}` };
+    }
+    try {
+        const putRes = await fetch(minted.upload_url, {
+            method: 'PUT',
+            headers: { 'Content-Type': contentType },
+            body: bytes,
+        });
+        if (!putRes.ok) {
+            return { task, ok: false, error: `PUT failed (HTTP ${putRes.status})` };
+        }
+    }
+    catch (err) {
+        return { task, ok: false, error: `PUT failed: ${err.message}` };
+    }
+    return { task, ok: true, path: minted.path, sizeBytes: bytes.length, contentType };
+}
+/** Run upload tasks through a small worker pool so dozens of files don't
+ * hammer the proxy/storage serially, but stay bounded. */
+async function uploadAll(tasks, opts) {
+    const outcomes = new Array(tasks.length);
+    let next = 0;
+    const workers = Array.from({ length: Math.min(opts.concurrency, tasks.length) }, async () => {
+        while (true) {
+            const i = next++;
+            if (i >= tasks.length)
+                return;
+            outcomes[i] = await uploadOne(tasks[i], opts);
+        }
+    });
+    await Promise.all(workers);
+    return outcomes;
+}
+function renderUploadSummary(outcomes) {
+    const ok = outcomes.filter((o) => o.ok);
+    const failed = outcomes.filter((o) => !o.ok);
+    const head = `${bold('Uploaded')} ${ok.length}/${outcomes.length} file${outcomes.length === 1 ? '' : 's'}`;
+    const lines = [head];
+    for (const o of ok) {
+        lines.push(`  ${dim('+')} ${o.path} (${o.sizeBytes} bytes)`);
+    }
+    for (const o of failed) {
+        lines.push(`  ${dim('x')} ${o.task.targetDir}/${o.task.filename} — ${o.error}`);
+    }
+    return lines.join('\n');
+}
+export function registerContextCommands(program) {
+    const context = program
+        .command('context')
+        .description("Manage the brand's Context Hub files (requires the context-hub resource)");
+    context
+        .command('list')
+        .description('List Context Hub files and directories')
+        .option('--dir <dir>', 'Context-relative directory (e.g. docs)', '')
+        .action(async (opts) => {
+        const q = opts.dir ? `?dir=${encodeURIComponent(opts.dir)}` : '';
+        const data = await apiRequest(`${FILES_PATH}${q}`, { workspace: true });
+        emitSuccess(data, renderList);
+    });
+    context
+        .command('upload <paths...>')
+        .description('Upload one or more files (or directories) to the Context Hub. ' +
+        'Directories recurse and preserve structure under --dir; globs expand. ' +
+        'Runs uploads concurrently; failures are isolated and summarized.')
+        .option('--dir <dir>', 'Context-relative target directory (e.g. docs)', '')
+        .option('--name <name>', 'Override the stored filename (only valid with a single input file)')
+        .option('--content-type <type>', 'Override the content type (defaults to a guess by extension)')
+        .option('--concurrency <n>', 'Max simultaneous uploads (default 4)', (v) => {
+        const n = Number(v);
+        if (!Number.isInteger(n) || n < 1) {
+            emitError('usage', `--concurrency must be a positive integer, got: ${v}`, ExitCode.USAGE);
+        }
+        return n;
+    }, 4)
+        .action(async (paths, opts) => {
+        if (paths.length === 0) {
+            emitError('usage', 'upload requires at least one file or directory', ExitCode.USAGE);
+        }
+        // `--name` only makes sense for a single file; reject ambiguity early.
+        if (opts.name && paths.length > 1) {
+            emitError('usage', '--name can only be used with a single input file', ExitCode.USAGE);
+        }
+        let tasks;
+        try {
+            tasks = expandUploadPaths(paths, { dir: opts.dir });
+        }
+        catch (err) {
+            emitError('usage', err.message, ExitCode.USAGE);
+        }
+        if (tasks.length === 0) {
+            emitError('usage', 'no files to upload (only dotfiles/cruft found?)', ExitCode.USAGE);
+        }
+        // Apply a single-file rename last, after expansion validated it.
+        if (opts.name && tasks.length === 1)
+            tasks[0].filename = opts.name;
+        const outcomes = await uploadAll(tasks, {
+            contentType: opts.contentType,
+            concurrency: opts.concurrency,
+        });
+        const ok = outcomes.filter((o) => o.ok);
+        const data = {
+            uploaded: ok.length,
+            failed: outcomes.length - ok.length,
+            total_bytes: ok.reduce((sum, o) => sum + (o.sizeBytes ?? 0), 0),
+            files: ok.map((o) => ({ path: o.path, size_bytes: o.sizeBytes, content_type: o.contentType })),
+            failures: outcomes.filter((o) => !o.ok).map((o) => ({
+                path: `${o.task.targetDir}/${o.task.filename}`,
+                error: o.error,
+            })),
+        };
+        // Partial failure still emits the success-shaped summary (callers want
+        // the JSON results) but exits non-zero so scripts detect the failures.
+        emitSuccessExit(data, data.failed > 0 ? ExitCode.RUNTIME : ExitCode.OK, renderUploadSummary.bind(null, outcomes));
+    });
+    context
+        .command('rm <path>')
+        .description('Delete a Context Hub file')
+        .action(async (path) => {
+        const data = await apiRequest(`${FILES_PATH}?path=${encodeURIComponent(path)}`, { method: 'DELETE', workspace: true });
+        emitSuccess(data, (d) => `${bold('Deleted')} ${d.deleted}`);
+    });
+    context
+        .command('mkdir <path>')
+        .description('Create a Context Hub directory')
+        .action(async (path) => {
+        const data = await apiRequest(DIRECTORY_PATH, {
+            method: 'POST',
+            body: { path },
+            workspace: true,
+        });
+        emitSuccess(data, (d) => `${bold('Created')} ${d.created}/`);
+    });
+    context
+        .command('rename <oldPath> <newPath>')
+        .description('Rename or move a Context Hub file or directory')
+        .action(async (oldPath, newPath) => {
+        const data = await apiRequest(RENAME_PATH, {
+            method: 'POST',
+            body: { old_path: oldPath, new_path: newPath },
+            workspace: true,
+        });
+        emitSuccess(data, (d) => `${bold('Renamed')} ${d.renamed} → ${d.to}`);
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

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

package/dist/commands/files.d.ts

@@ -0,0 +1,10 @@
+/** `soku files publish <file>` — publish a local file to a short-lived public URL.
+
+The URL is a GCS signed URL that expires in ~30 minutes. The CLI always
+surfaces `expires_at` prominently (TTY + JSON) so an agent that reuses a stale
+URL downstream understands why the third-party fetch failed — a published URL
+is not permanent.
+ */
+import { Command } from 'commander';
+export declare function registerFilesCommands(program: Command): void;
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/commands/files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA0BnC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+B5D"}

package/dist/commands/files.js

@@ -0,0 +1,48 @@
+/** `soku files publish <file>` — publish a local file to a short-lived public URL.
+
+The URL is a GCS signed URL that expires in ~30 minutes. The CLI always
+surfaces `expires_at` prominently (TTY + JSON) so an agent that reuses a stale
+URL downstream understands why the third-party fetch failed — a published URL
+is not permanent.
+ */
+import { basename } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { apiRequest } from '../http/client.js';
+import { bold, dim, emitError, emitSuccess, ExitCode, red } from '../output/envelope.js';
+const PUBLISH_PATH = '/api/cli/files/publish';
+function renderPublish(data) {
+    const mins = Math.round(data.expires_in_seconds / 60);
+    return [
+        `${bold('Published')} ${data.brand_path} (${data.size_bytes} bytes, ${data.content_type})`,
+        `${dim('url       ')} ${data.url}`,
+        `${dim('expires_at')} ${data.expires_at} (in ~${mins} min)`,
+        `${red('note      ')} this URL is temporary — re-publish if a downstream fetch fails after the expiry.`,
+    ].join('\n');
+}
+export function registerFilesCommands(program) {
+    const files = program
+        .command('files')
+        .description('Publish local files to short-lived public URLs (requires asset-publish)');
+    files
+        .command('publish <file>')
+        .description('Publish a local file to a ~30-minute public signed URL')
+        .option('--name <name>', 'Override the stored filename (defaults to the local basename)')
+        .action(async (file, opts) => {
+        let bytes;
+        try {
+            bytes = readFileSync(file);
+        }
+        catch (err) {
+            return emitError('usage', `Could not read file: ${file}`, ExitCode.USAGE, err.message);
+        }
+        const form = new FormData();
+        form.append('file', new Blob([bytes]), opts.name ?? basename(file));
+        const data = await apiRequest(PUBLISH_PATH, {
+            method: 'POST',
+            body: form,
+            workspace: true,
+        });
+        emitSuccess(data, renderPublish);
+    });
+}
+//# sourceMappingURL=files.js.map

package/dist/commands/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/commands/files.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAItC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAExF,MAAM,YAAY,GAAG,wBAAwB,CAAA;AAW7C,SAAS,aAAa,CAAC,IAAyB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC,CAAA;IACrD,OAAO;QACL,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,WAAW,IAAI,CAAC,YAAY,GAAG;QAC1F,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE;QAClC,GAAG,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,UAAU,SAAS,IAAI,OAAO;QAC3D,GAAG,GAAG,CAAC,YAAY,CAAC,mFAAmF;KACxG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,yEAAyE,CAAC,CAAA;IAEzF,KAAK;SACF,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,eAAe,EAAE,+DAA+D,CAAC;SACxF,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAuB,EAAE,EAAE;QACtD,IAAI,KAAa,CAAA;QACjB,IAAI,CAAC;YACH,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,SAAS,CACd,OAAO,EACP,wBAAwB,IAAI,EAAE,EAC9B,QAAQ,CAAC,KAAK,EACb,GAAa,CAAC,OAAO,CACvB,CAAA;QACH,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;QAC3B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;QAEnE,MAAM,IAAI,GAAG,MAAM,UAAU,CAAsB,YAAY,EAAE;YAC/D,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;QACF,WAAW,CAAC,IAAI,EAAE,aAAa,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/commands/generated.d.ts

@@ -22,7 +22,7 @@ export interface ManifestAction {
     action: string;
     description: string;
     long_description: string | null;
-    capability_mode: string;
+    mode: string;
     priority: string;
     requires_review: boolean;
     freshness_kind: string;
@@ -33,9 +33,30 @@ export interface ManifestAction {
 export interface CapabilityManifest {
     actions: ManifestAction[];
 }
+/** POST a data action and emit its result. Shared by the generated commands and
+ * the hand-written Tier-2 entity commands (`commands/ads.ts`). */
+export declare function callTypedAction(namespace: string, action: string, payload: Record<string, unknown>): Promise<never>;
+/** Normalize a data-action result and emit it. Review-gated writes return 202 +
+ * a pending-review id; we surface a unified `review_id` (not the wire
+ * `pending_review_id`) with the approve hint, instead of letting
+ * `unwrapDispatch` treat the non-envelope body as opaque data. Non-review
+ * writes and reads pass through. Exported so `soku call` reuses the same
+ * normalization. */
+export declare function emitActionResult(result: unknown, action?: string): never;
 /** Load the committed manifest shipped alongside the compiled CLI. */
 export declare function loadManifest(): CapabilityManifest;
-/** Register one namespace group + typed sub-command per manifest action. */
-export declare function buildGeneratedCommands(program: Command, manifest: CapabilityManifest): void;
+export interface BuildOptions {
+    /** Only render these namespaces (allowlist). */
+    namespaces?: string[];
+    /** Skip these namespaces (e.g. `ads`, which has a dedicated registrar). */
+    exclude?: string[];
+}
+/** Register one namespace group + typed sub-command per manifest action.
+ *
+ * Returns the namespace → group map so a caller (e.g. `commands/ads.ts`) can
+ * attach extra hand-written sub-commands to the same group instead of creating
+ * a second, conflicting `command(namespace)`.
+ */
+export declare function buildGeneratedCommands(program: Command, manifest: CapabilityManifest, opts?: BuildOptions): Map<string, Command>;
 export declare function registerGeneratedCommands(program: Command): void;
 //# sourceMappingURL=generated.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../src/commands/generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,OAAO,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,aAAa,EAAE,CAAA;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAmCD,sEAAsE;AACtE,wBAAgB,YAAY,IAAI,kBAAkB,CAGjD;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAmD3F;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEhE"}
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../src/commands/generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,OAAO,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,aAAa,EAAE,CAAA;IAC7B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,EAAE,CAAA;CAC1B;AAgDD;kEACkE;AAClE,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,KAAK,CAAC,CAMhB;AAED;;;;;oBAKoB;AACpB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAwBxE;AAyBD,sEAAsE;AACtE,wBAAgB,YAAY,IAAI,kBAAkB,CAGjD;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,GAAE,YAAiB,GACtB,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAuEtB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAKhE"}

package/dist/commands/generated.js

@@ -11,7 +11,7 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { apiRequest } from '../http/client.js';
-import { emitError, emitSuccess, ExitCode } from '../output/envelope.js';
+import { dim, emitError, emitSuccess, ExitCode, renderHumanData } from '../output/envelope.js';
 import { unwrapDispatch } from '../output/unwrap.js';
 function toKebab(name) {
     return name.replace(/_/g, '-');
@@ -41,13 +41,81 @@ function parseNumberFlag(param, raw) {
     }
     return n;
 }
+/** Short tag describing an action's write semantics, shown in `--help`. */
+function modeBadge(spec) {
+    if (spec.mode === 'risk') {
+        return '[risk] mutates live ad state — proposes a review; approve with `soku review approve <id>`';
+    }
+    if (spec.mode === 'write') {
+        return spec.requires_review
+            ? '[write] proposes a review; approve with `soku review approve <id>`'
+            : '[write] executes immediately';
+    }
+    return '';
+}
+/** POST a data action and emit its result. Shared by the generated commands and
+ * the hand-written Tier-2 entity commands (`commands/ads.ts`). */
+export async function callTypedAction(namespace, action, payload) {
+    const result = await apiRequest(`/api/cli/call/${encodeURIComponent(namespace)}/${encodeURIComponent(action)}`, { method: 'POST', body: payload, workspace: true });
+    return emitActionResult(result, action);
+}
+/** Normalize a data-action result and emit it. Review-gated writes return 202 +
+ * a pending-review id; we surface a unified `review_id` (not the wire
+ * `pending_review_id`) with the approve hint, instead of letting
+ * `unwrapDispatch` treat the non-envelope body as opaque data. Non-review
+ * writes and reads pass through. Exported so `soku call` reuses the same
+ * normalization. */
+export function emitActionResult(result, action) {
+    if (result &&
+        typeof result === 'object' &&
+        result.status === 'pending_review') {
+        const r = result;
+        return emitSuccess({ status: 'pending_review', review_id: r.pending_review_id, summary: r.summary }, (d) => `Pending review ${d.review_id}\n  ${dim('Approve with:')} soku review approve ${d.review_id}`);
+    }
+    // An empty `rows` array on a query action is usually "no spend/activities in
+    // range" or "wrong dimension/metric selection" — surface a hint so the caller
+    // (human or agent) doesn't mistake it for a broken query. gaql_search returns
+    // `columns`/`rows` too but its own help already warns; limit to cached queries.
+    if (action && action.startsWith('query_') && isEmptyRowsResult(result)) {
+        const data = unwrapDispatch(result);
+        return emitSuccess(data, () => `${renderHumanData(data)}\n${dim('(no rows — try --mode summary, widen the date range, or run `soku ads list-dimensions` to confirm the dimension)')}`);
+    }
+    return emitSuccess(unwrapDispatch(result));
+}
+/** True when a query result body has a `rows` array that is present but empty. */
+function isEmptyRowsResult(result) {
+    if (!result || typeof result !== 'object')
+        return false;
+    const rows = result.rows;
+    return Array.isArray(rows) && rows.length === 0;
+}
+function actionHelpSuffix(spec) {
+    const typedName = `${spec.namespace} ${toKebab(spec.action)}`;
+    const rawName = `${spec.namespace} ${spec.action}`;
+    const naming = `Typed CLI command: soku ${typedName}\nRaw call action: soku call ${rawName}`;
+    if (spec.namespace === 'ads' && spec.action === 'gaql_search') {
+        return [
+            'FALLBACK WARNING:',
+            'Prefer cached ads analytics first: `soku ads list-dimensions`, then `soku ads query-single-dimension` or `soku ads query-multi-dimension`.',
+            'Use GAQL only for Google-native fields or segment combinations not covered by cached query actions. If fields are unknown, run `soku ads get-resource-metadata` before this command.',
+            '',
+            naming,
+        ].join('\n');
+    }
+    return naming;
+}
 /** Load the committed manifest shipped alongside the compiled CLI. */
 export function loadManifest() {
     const path = fileURLToPath(new URL('../generated/capabilities.json', import.meta.url));
     return JSON.parse(readFileSync(path, 'utf8'));
 }
-/** Register one namespace group + typed sub-command per manifest action. */
-export function buildGeneratedCommands(program, manifest) {
+/** Register one namespace group + typed sub-command per manifest action.
+ *
+ * Returns the namespace → group map so a caller (e.g. `commands/ads.ts`) can
+ * attach extra hand-written sub-commands to the same group instead of creating
+ * a second, conflicting `command(namespace)`.
+ */
+export function buildGeneratedCommands(program, manifest, opts = {}) {
     const groups = new Map();
     const groupFor = (namespace) => {
         let group = groups.get(namespace);
@@ -57,11 +125,18 @@ export function buildGeneratedCommands(program, manifest) {
         }
         return group;
     };
-    for (const spec of manifest.actions) {
+    const actions = manifest.actions.filter((spec) => {
+        if (opts.namespaces && !opts.namespaces.includes(spec.namespace))
+            return false;
+        if (opts.exclude && opts.exclude.includes(spec.namespace))
+            return false;
+        return true;
+    });
+    for (const spec of actions) {
         const cmd = groupFor(spec.namespace).command(toKebab(spec.action));
-        cmd.description(spec.description);
-        if (spec.long_description)
-            cmd.addHelpText('after', `\n${spec.long_description}`);
+        cmd.description([modeBadge(spec), spec.description, spec.long_description, actionHelpSuffix(spec)]
+            .filter(Boolean)
+            .join('\n\n'));
         for (const param of spec.input_params) {
             const flag = `--${toKebab(param.name)}`;
             const desc = param.description || param.name;
@@ -88,6 +163,12 @@ export function buildGeneratedCommands(program, manifest) {
                     cmd.option(valueFlag, desc);
             }
         }
+        // Review-gated actions carry a mandatory `--summary`: the server stores it
+        // as the human-readable review card header (`_summary`). Non-review writes
+        // (e.g. upload_image) and reads never get this flag.
+        if (spec.requires_review) {
+            cmd.requiredOption('--summary <text>', 'Human-readable description of this write; becomes the review approval card header');
+        }
         cmd.action(async (opts) => {
             const payload = {};
             for (const param of spec.input_params) {
@@ -95,12 +176,18 @@ export function buildGeneratedCommands(program, manifest) {
                 if (value !== undefined)
                     payload[param.name] = value;
             }
-            const result = await apiRequest(`/api/cli/call/${encodeURIComponent(spec.namespace)}/${encodeURIComponent(spec.action)}`, { method: 'POST', body: payload, workspace: true });
-            emitSuccess(unwrapDispatch(result));
+            if (spec.requires_review && typeof opts.summary === 'string') {
+                payload._summary = opts.summary;
+            }
+            await callTypedAction(spec.namespace, spec.action, payload);
         });
     }
+    return groups;
 }
 export function registerGeneratedCommands(program) {
-    buildGeneratedCommands(program, loadManifest());
+    // `ads` has a dedicated registrar (commands/ads.ts) that owns the `ads` group
+    // and adds Tier-2 entity sub-commands, so it is excluded here to avoid a
+    // duplicate `command('ads')`.
+    buildGeneratedCommands(program, loadManifest(), { exclude: ['ads'] });
 }
 //# sourceMappingURL=generated.js.map

package/dist/commands/generated.js.map

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

package/dist/commands/memory.d.ts

@@ -0,0 +1,18 @@
+/** `soku memory` — read memory entries scoped to the active brand. */
+import { Command } from 'commander';
+export type MemoryType = 'user' | 'feedback' | 'reference' | 'task' | 'reflection';
+export interface MemoryEntry {
+    type: MemoryType;
+    name: string;
+    description: string;
+    content: string;
+    updated_at: string;
+}
+export declare function memoryListPath(opts: {
+    type?: string;
+    query?: string;
+}): string;
+export declare function renderMemoryEntries(entries: MemoryEntry[]): string;
+export declare function renderMemoryEntry(entry: MemoryEntry): string;
+export declare function registerMemoryCommands(program: Command): void;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/commands/memory.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKnC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,GAAG,YAAY,CAAA;AAElF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAcD,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM9E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAiBlE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAM5D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqC7D"}