gipity 1.1.3 → 1.1.5

package/dist/adopt-cwd.js

@@ -167,7 +167,7 @@ export function formatCwdLabel(cwd) {
         const tail = norm.slice(home.length + 1).split(sep);
         if (tail.length <= 2)
             return '~/' + tail.join('/');
-        return '~/…/' + tail.slice(-2).join('/');
+        return '~/.../' + tail.slice(-2).join('/');
     }
     // Outside home: show parent/this for non-root paths.
     const parts = norm.split(sep).filter(Boolean);

package/dist/banner.js

@@ -115,15 +115,13 @@ function padR(s, width) {
     const gap = width - visLen(s);
     return gap > 0 ? s + ' '.repeat(gap) : s;
 }
-/** Truncate from the left with a leading ellipsis if longer than maxW (plain text). */
+/** Truncate from the left with a leading "..." if longer than maxW (plain text). */
 function leadingEllipsify(s, maxW) {
     if (s.length <= maxW)
         return s;
-    if (maxW <= 1)
+    if (maxW <= 4)
         return s.slice(-maxW);
-    if (maxW <= 3)
-        return '…'.padStart(maxW);
-    return '…' + s.slice(-(maxW - 1));
+    return '...' + s.slice(-(maxW - 3));
 }
 function center(s, width) {
     const gap = width - visLen(s);

package/dist/catalog.js

@@ -36,11 +36,9 @@ export const KITS = [
     { key: 'chatbot', hint: 'drop-in chatbot - persona, guardrails, streaming responses' },
     { key: 'audio-align', hint: 'audio + lyrics -> word-level timing JSON (GPU job)' },
     { key: 'i18n', hint: 'multi-language web apps - language picker, RTL, translations' },
-    { key: 'records', hint: 'registry-driven data plane - generic CRUD, validation, search, audit spine' },
-    { key: 'views', hint: 'registry-driven UI over records - table, forms, kanban' },
-    { key: 'agent-api', hint: 'named API keys for agent/script writes through the records kit' },
     { key: 'contacts', hint: 'multi-source contact layer - LinkedIn/Gmail import, dedupe with provenance' },
     { key: 'stripe', hint: 'charge your users - Stripe checkout, subscriptions, brokered webhooks' },
     { key: 'notify', hint: 'web push notifications - platform-owned keys, works on iOS home screen' },
+    { key: 'servicenow', hint: 'ServiceNow tables as a data source - OAuth pull/write-back/real-time sync' },
 ];
 //# sourceMappingURL=catalog.js.map

package/dist/commands/add.js

@@ -207,7 +207,7 @@ export const addCommand = new Command('add')
     const doAdd = () => post(`/projects/${config.projectGuid}/add`, body);
     const res = opts.json
         ? await doAdd()
-        : await withSpinner('Installing…', doAdd, { done: null });
+        : await withSpinner('Installing...', doAdd, { done: null });
     // Pull the created/installed files down to local.
     const syncResult = await sync({ interactive: false, progress: opts.json ? undefined : createProgressReporter() });
     const data = res.data;

package/dist/commands/build.js

@@ -50,7 +50,7 @@ const __clPkg = readOwnPkg(__clDir);
  *  incomplete pull, so we can tell the user plainly that nothing was deleted. */
 function reportSyncResult(result) {
     if (result.aborted) {
-        console.log(`  ${warning('Merge cancelled — this folder was NOT synced with the project.')}`);
+        console.log(`  ${warning('Merge cancelled - this folder was NOT synced with the project.')}`);
         console.log(`  ${muted('For a clean copy, quit and open the project in an empty folder. To merge anyway, run `gipity sync`.')}`);
         return;
     }
@@ -58,11 +58,11 @@ function reportSyncResult(result) {
         console.log(`  Synced ${result.applied} change${result.applied > 1 ? 's' : ''} with Gipity.`);
     }
     if (result.errors.length) {
-        console.log(`  ${warning(`Sync finished with ${result.errors.length} problem${result.errors.length === 1 ? '' : 's'} — your local copy may be incomplete:`)}`);
+        console.log(`  ${warning(`Sync finished with ${result.errors.length} problem${result.errors.length === 1 ? '' : 's'} - your local copy may be incomplete:`)}`);
         for (const e of result.errors.slice(0, 8))
             console.log(`    - ${e}`);
         if (result.errors.length > 8)
-            console.log(`    …and ${result.errors.length - 8} more.`);
+            console.log(`    ...and ${result.errors.length - 8} more.`);
         console.log(`  ${muted('Nothing was deleted. Re-run `gipity sync` to finish the pull.')}`);
     }
 }
@@ -133,7 +133,7 @@ function localFsFallback(dir) {
     };
     walk(dir, 0);
     const topLevel = topLevelEntries.length
-        ? topLevelEntries.slice(0, 20).join(', ') + (topLevelEntries.length > 20 ? ', …' : '')
+        ? topLevelEntries.slice(0, 20).join(', ') + (topLevelEntries.length > 20 ? ', ...' : '')
         : '(empty directory)';
     return { fileCount, folderCount, totalBytes, topLevel };
 }
@@ -502,6 +502,8 @@ async function runLaunch(cmdName, cmdCfg, opts) {
                 console.log(`  ${warning('Could not sync files (will retry on next prompt):')} ${err.message}`);
             }
             setupProjectTools();
+            if (!nonInteractive)
+                console.log(`  ${muted('Installed Gipity plugin, skills, and hooks.')}`);
             if (nonInteractive) {
                 // Headless: the -p message is wrapped later (Step 3). Just record
                 // whether to use the new-project framing for that wrap.
@@ -673,6 +675,8 @@ async function runLaunch(cmdName, cmdCfg, opts) {
             // Claude directly what they want to build or do.
             initialPrompt = '';
             setupProjectTools();
+            if (!nonInteractive)
+                console.log(`  ${muted('Installed Gipity plugin, skills, and hooks.')}`);
             console.log(`  ${success(`Project "${project.name}" ready.`)}\n`);
         }
         // ── Step 3: Pick the coding agent + model ─────────────────────────
@@ -812,9 +816,8 @@ async function runLaunch(cmdName, cmdCfg, opts) {
         }
         if (!nonInteractive) {
             console.log(`  ${bold('Launching Claude Code, powered by Gipity.')}`);
-            console.log(`  ${muted("Just tell Claude what you'd like to build or do - everything Claude can do,")}`);
-            console.log(`  ${muted('plus hosting, databases, and live deploys on Gipity.')}`);
             if (convGuidForHooks) {
+                console.log('');
                 console.log(`  ${muted(`This session is saved to Gipity - watch it live at ${brand('prompt.gipity.ai')}. (--no-capture on init to disable.)`)}`);
             }
             console.log('');
@@ -960,12 +963,11 @@ async function pickAgent(lastUsed) {
     const defaultIdx = AGENT_ADAPTERS.findIndex(a => a.key === defaultKey) + 1;
     console.log(`  ${bold('Which coding agent?')}\n`);
     AGENT_ADAPTERS.forEach((a, i) => {
-        const installed = binaryOnPath(a.binary) || (a.key === 'claude' && isClaudeInstalled());
+        // Keep the list clean: no install-state notes (picking an uninstalled
+        // agent installs it, or fails with the install hint at that point).
         const notes = [];
         if (a.key === lastUsed)
             notes.push('last used');
-        if (!installed)
-            notes.push(a.ensureInstalled ? "not installed - we'll install it" : 'not installed');
         if (a.key === 'codex' && !a.hooksSupportedOnPlatform(process.platform)) {
             notes.push('session recording unavailable on Windows');
         }
@@ -1101,9 +1103,8 @@ async function launchNonClaudeAgent(adapter, ctx) {
     else {
         agentArgs = [...adapter.buildInteractiveArgs({ resume, model }), ...extras];
         console.log(`  ${bold(`Launching ${adapter.displayName}, powered by Gipity.`)}`);
-        console.log(`  ${muted(`Just tell ${adapter.displayName} what you'd like to build or do - plus hosting,`)}`);
-        console.log(`  ${muted('databases, and live deploys on Gipity.')}`);
         if (convGuid) {
+            console.log('');
             console.log(`  ${muted(`This session is saved to Gipity - watch it live at ${brand('prompt.gipity.ai')}. (--no-capture on init to disable.)`)}`);
         }
         if (adapter.oneTimeSetupNote) {
@@ -1171,37 +1172,47 @@ async function pickOrCreateProject(projects, existingSlugs) {
     const showAdopt = canAdoptCwd(cwd);
     // Reserve slot 1 for "create new", slot 2 for "use this dir" when shown.
     const reserved = showAdopt ? 2 : 1;
-    // Pickable single-keypress range is 1-9; leave one slot for "Show all"
-    // when there are more projects than fit.
-    const maxRecent = 9 - reserved - 1; // worst case: keep slot 9 free for "show all"
-    const recent = filtered.slice(0, maxRecent);
-    const hasMore = filtered.length > recent.length;
+    // Pickable single-keypress range is 1-9. When every project fits, list
+    // them all; otherwise the actions grow a "Search projects" slot right
+    // after the reserved ones and "Show more" takes slot 9 - accounts with
+    // hundreds of projects can't scroll a dump. Action rows render in a
+    // different color than project rows so the two groups read apart.
+    const fitsAll = filtered.length <= 9 - reserved;
+    const hasMore = !fitsAll;
+    const searchSlot = hasMore ? reserved + 1 : 0;
+    const projectBase = reserved + (hasMore ? 1 : 0); // slots projectBase+1.. are projects
+    const recent = fitsAll ? filtered : filtered.slice(0, 9 - reserved - 2);
+    const moreSlot = hasMore ? projectBase + recent.length + 1 : 0; // always 9 when shown
     // Loop so that a refused/declined adopt-cwd re-shows the picker rather
     // than dropping the user into a shell.
     while (true) {
         const newProjectLabel = formatNewProjectLabel(existingSlugs);
         console.log(`  ${bold('Choose project to open:')}\n`);
-        console.log(`    ${bold('1.')} Create new project          ${muted(`(${newProjectLabel})`)}`);
+        console.log(`    ${bold('1.')} ${info('Create new project')}          ${muted(`(${newProjectLabel})`)}`);
         if (showAdopt) {
-            console.log(`    ${bold('2.')} Use this directory          ${muted(`(${formatCwdLabel(cwd)})`)}`);
+            console.log(`    ${bold('2.')} ${info('Use this directory')}          ${muted(`(${formatCwdLabel(cwd)})`)}`);
         }
-        recent.forEach((p, i) => console.log(`    ${bold(`${i + reserved + 1}.`)} ${p.name} ${muted(`(${p.slug})`)}`));
         if (hasMore) {
-            console.log(`    ${bold(`${recent.length + reserved + 1}.`)} Show all projects`);
+            console.log(`    ${bold(`${searchSlot}.`)} ${info('Search projects')} ${muted(`(${filtered.length} total)`)}`);
+        }
+        recent.forEach((p, i) => console.log(`    ${bold(`${projectBase + i + 1}.`)} ${p.name} ${muted(`(${p.slug})`)}`));
+        if (hasMore) {
+            console.log(`    ${bold(`${moreSlot}.`)} ${info('Show more')}`);
         }
         console.log('');
-        const maxOption = recent.length + reserved + (hasMore ? 1 : 0);
+        const maxOption = projectBase + recent.length + (hasMore ? 1 : 0);
         const idx = await pickOne('Choose', maxOption, 1);
-        // Recent project (slots reserved+1 .. recent.length+reserved).
-        if (idx > reserved && idx <= recent.length + reserved) {
-            return { kind: 'pick', project: recent[idx - reserved - 1] };
+        // Recent project (slots projectBase+1 .. projectBase+recent.length).
+        if (idx > projectBase && idx <= projectBase + recent.length) {
+            return { kind: 'pick', project: recent[idx - projectBase - 1] };
         }
-        // Show all projects (one past the last recent slot).
-        if (hasMore && idx === recent.length + reserved + 1) {
-            const picked = await pickFromAll(filtered);
+        // Search (right after the reserved slots) / Show more (slot 9).
+        if (hasMore && (idx === searchSlot || idx === moreSlot)) {
+            const picked = await browseProjects(filtered, { search: idx === searchSlot });
             if (picked)
                 return { kind: 'pick', project: picked };
-            continue; // user bailed; re-show top picker
+            console.log('');
+            continue; // user backed out; re-show top picker
         }
         // Slot 2 = "Use this directory" (only when shown).
         if (showAdopt && idx === 2) {
@@ -1217,19 +1228,79 @@ async function pickOrCreateProject(projects, existingSlugs) {
         return { kind: 'create-new', project };
     }
 }
-/** Render "Show all projects" with numbered list; returns the picked
- *  project or null if the user picked "create new" (slot 1) or invalid. */
-async function pickFromAll(filtered) {
-    console.log('');
-    console.log(`  ${bold('All projects:')}\n`);
-    console.log(`    ${bold('1.')} Create new project`);
-    filtered.forEach((p, i) => console.log(`    ${bold(`${i + 2}.`)} ${p.name} ${muted(`(${p.slug})`)}`));
+const PROJECT_PAGE_SIZE = 10;
+/** Case-insensitive substring match on project name or slug. An empty or
+ *  whitespace-only query matches everything. Exported for tests. */
+export function searchProjects(all, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return all;
+    return all.filter(p => p.name.toLowerCase().includes(q) || p.slug.toLowerCase().includes(q));
+}
+/** Paged, searchable project list - the shared renderer behind both the
+ *  "Search projects" and "Show more" picker slots. Shows PROJECT_PAGE_SIZE
+ *  rows at a time with numbering that stays stable across pages, then reads
+ *  a full line (not single-keypress - numbers can exceed 9):
+ *    Enter → next page · <number> → open that project
+ *    s → new search (always over the FULL list, never the current subset)
+ *    q → back to the main picker (returns null).
+ *  `opts.search` starts by prompting for a query instead of listing all.
+ *  Exported for tests. */
+export async function browseProjects(all, opts = {}) {
+    let items = all;
+    let heading = 'All projects';
+    // Prompt for a query and swap the working list to the matches. Returns
+    // false (list unchanged) on empty input or zero matches.
+    const runSearch = async () => {
+        const q = await prompt(`  ${bold('Search projects:')} `);
+        if (!q)
+            return false;
+        const matches = searchProjects(all, q);
+        if (matches.length === 0) {
+            console.log(`  ${muted(`No projects match "${q}".`)}`);
+            return false;
+        }
+        items = matches;
+        heading = `Projects matching "${q}"`;
+        return true;
+    };
     console.log('');
-    const allChoice = await prompt(`  Choose (1-${filtered.length + 1}): `);
-    const allIdx = parseInt(allChoice, 10);
-    if (allIdx >= 2 && allIdx <= filtered.length + 1)
-        return filtered[allIdx - 2];
-    return null;
+    if (opts.search && !(await runSearch()))
+        return null;
+    let shown = 0;
+    while (true) {
+        if (shown < items.length) {
+            const page = items.slice(shown, shown + PROJECT_PAGE_SIZE);
+            if (shown === 0)
+                console.log(`  ${bold(`${heading}`)} ${muted(`(${items.length})`)}\n`);
+            page.forEach((p, i) => console.log(`    ${bold(`${String(shown + i + 1).padStart(3)}.`)} ${p.name} ${muted(`(${p.slug})`)}`));
+            shown += page.length;
+            console.log('');
+        }
+        const more = shown < items.length;
+        const hints = [
+            more ? `Enter = next ${Math.min(PROJECT_PAGE_SIZE, items.length - shown)}` : null,
+            'number = open',
+            's = search',
+            'q = back',
+        ].filter(Boolean).join(' · ');
+        const answer = (await prompt(`  ${bold('Choose')} ${muted(`(${hints})`)}: `)).toLowerCase();
+        if (answer === '' && more)
+            continue; // Enter → next page
+        if (answer === '' || answer === 'q')
+            return null;
+        if (answer === 's') {
+            if (await runSearch()) {
+                shown = 0;
+                console.log('');
+            }
+            continue;
+        }
+        const n = parseInt(answer, 10);
+        if (Number.isInteger(n) && n >= 1 && n <= shown)
+            return items[n - 1];
+        console.log(`  ${muted('Type one of the numbers above, Enter for more, s to search, or q to go back.')}`);
+    }
 }
 /** Show "(~/GipityProjects/project-NNN)" - the exact dir option 1 will
  *  create, so the user can see where their new project will land. */

package/dist/commands/chat.js

@@ -25,7 +25,7 @@ export const chatCommand = new Command('chat')
         const doChat = () => post(endpoint, body);
         const res = opts.json
             ? await doChat()
-            : await withSpinner('Thinking…', doChat, { done: null });
+            : await withSpinner('Thinking...', doChat, { done: null });
         // Save conversation guid for continuity. Skipped in one-off mode: the
         // config was resolved from the server's Home project and there is no
         // local `.gipity.json` to update - persisting here would create one in

package/dist/commands/deploy.js

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import { post } from '../api.js';
-import { requireConfig } from '../config.js';
+import { requireConfig, resolveApiBase } from '../config.js';
 import { formatSize } from '../utils.js';
 import { success, error as clrError, warning, muted, bold, brand } from '../colors.js';
 import { run, syncBeforeAction } from '../helpers/index.js';
@@ -57,7 +57,7 @@ export const deployCommand = new Command('deploy')
     });
     const res = opts.json
         ? await doDeploy()
-        : await withSpinner(`Deploying to ${target}…`, doDeploy, { done: null });
+        : await withSpinner(`Deploying to ${target}...`, doDeploy, { done: null });
     const d = res.data;
     // Deploy + verify in one command: after a successful deploy, run the
     // same inspect pipeline `page inspect` uses against the live URL. An
@@ -150,7 +150,11 @@ export const deployCommand = new Command('deploy')
         // for an API-only app the endpoint address IS the deliverable, so name
         // it instead of leaving it to be inferred from a template comment.
         if (d.phases?.some(p => p.name === 'functions')) {
-            console.log(`${muted('Functions:')} POST ${brand(`${config.apiBase}/api/${config.projectGuid}/fn/<name>`)}`);
+            // Print the base the CLI actually calls (resolveApiBase honors the
+            // --api-base flag and GIPITY_API_BASE env), not the raw stored
+            // config.apiBase - otherwise on any override we'd advertise a host we
+            // didn't deploy to and send the caller probing the wrong instance.
+            console.log(`${muted('Functions:')} POST ${brand(`${resolveApiBase()}/api/${config.projectGuid}/fn/<name>`)}`);
             console.log(muted('  (same address on dev and prod; names: gipity fn list; verify the public path: gipity fn call <name> --anon)'));
         }
         await inspectAfter();

package/dist/commands/file.js

@@ -34,6 +34,24 @@ fileCommand
         process.stdout.write(res.data.content);
     }
 }));
+fileCommand
+    .command('url <path>')
+    .description('Durable public URL for a project file - no deploy needed. Reachable by browsers, GPU jobs, and external services the moment the file syncs; ideal for throwaway test fixtures (delete the file to revoke the link).')
+    .option('--download', 'URL forces a download (Content-Disposition: attachment)')
+    .option('--json', 'Output as JSON')
+    .action((path, opts) => run('Url', async () => {
+    const { config } = await resolveProjectContext();
+    const qs = new URLSearchParams({ path });
+    if (opts.download)
+        qs.set('download', '1');
+    const res = await get(`/projects/${config.projectGuid}/files/url?${qs.toString()}`);
+    if (opts.json) {
+        console.log(JSON.stringify(res.data));
+    }
+    else {
+        console.log(res.data.url);
+    }
+}));
 fileCommand
     .command('tree [path]')
     .description('Show the file tree')

package/dist/commands/fn.js

@@ -1,9 +1,9 @@
 import { Command } from 'commander';
 import { get, post, del, publicPost } from '../api.js';
 import { getAuth } from '../auth.js';
-import { requireConfig } from '../config.js';
+import { requireConfig, resolveApiBase } from '../config.js';
 import { error as clrError, bold, muted, success, warning } from '../colors.js';
-import { run, printList, emitField } from '../helpers/index.js';
+import { run, printList, emitField, resolveBody } from '../helpers/index.js';
 import { confirm } from '../utils.js';
 export const fnCommand = new Command('fn')
     .description('Manage functions');
@@ -21,7 +21,7 @@ fnCommand
     // The callable address is the deliverable for API-only apps - name it here
     // rather than leaving it to be inferred from a template comment.
     if (!opts.json && res.data.length > 0) {
-        console.log(muted(`Endpoint: POST ${config.apiBase}/api/${config.projectGuid}/fn/<name>  (same on dev and prod; public path: gipity fn call <name> --anon)`));
+        console.log(muted(`Endpoint: POST ${resolveApiBase()}/api/${config.projectGuid}/fn/<name>  (same on dev and prod; public path: gipity fn call <name> --anon)`));
     }
 }));
 fnCommand
@@ -73,14 +73,14 @@ async function callAnon(projectGuid, name, body) {
 fnCommand
     .command('call <name> [body]')
     .description('Call a function')
-    .option('--data <json>', 'JSON request body')
+    .option('-d, --data <json>', 'JSON request body: inline JSON, @file to read a file, or @- / - for stdin')
+    .option('--file <field=@path>', 'Attach a file as { data, media_type } under <field> (the vision/media service shape), repeatable, e.g. --file image=@receipt.png', (v, acc) => (acc || []).concat(v))
     .option('--anon', 'Call as an anonymous visitor (the public path a signed-out user hits) instead of as your signed-in account')
     .option('--field <path>', 'Print only this field of the result (dot path, e.g. items.0.short_guid)')
     .option('--json', 'Output as JSON')
     .action((name, bodyArg, opts) => run('Call', async () => {
     const config = requireConfig();
-    const raw = bodyArg || opts.data || '{}';
-    const body = JSON.parse(raw);
+    const body = resolveBody(bodyArg || opts.data, opts.file);
     const path = `/api/${config.projectGuid}/fn/${encodeURIComponent(name)}`;
     // Name the calling identity (stderr, so stdout stays parseable). Without
     // this, a "test the anonymous path" call silently runs authenticated as

package/dist/commands/generate.js

@@ -2,11 +2,12 @@ import { Command } from 'commander';
 import { post } from '../api.js';
 import { resolveProjectContext, getConfigPath } from '../config.js';
 import { pushFile } from '../sync.js';
-import { mkdirSync, writeFileSync } from 'fs';
-import { resolve as resolvePath, dirname, relative, isAbsolute } from 'path';
+import { mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { resolve as resolvePath, dirname, relative, isAbsolute, basename } from 'path';
 import { error as clrError, success, muted } from '../colors.js';
 import { printCommandError } from '../helpers/command.js';
 import { withSpinner } from '../progress.js';
+import { guessMime } from '../upload.js';
 import { IMAGE_MODELS_DOC, IMAGE_GEMINI_ASPECT_RATIOS, IMAGE_GEMINI_SIZES, VIDEO_MODELS_DOC, TTS_PROVIDER_DESCRIPTIONS } from '../provider-docs.js';
 /** Download a URL and save to a local file, then push it up to the project so
  *  the cloud (and anything that mirrors it) immediately matches local disk.
@@ -20,12 +21,25 @@ import { IMAGE_MODELS_DOC, IMAGE_GEMINI_ASPECT_RATIOS, IMAGE_GEMINI_SIZES, VIDEO
  *  that gap so the "sandbox auto-mirrors the project" contract holds right after
  *  generation. Best-effort: the local save already succeeded, so a push failure
  *  only warns and points at `gipity sync`. */
-async function downloadFile(url, filename) {
+async function downloadFile(url, filename, explicit) {
     const res = await fetch(url);
     if (!res.ok)
         throw new Error(`Download failed: ${res.status}`);
     const buffer = Buffer.from(await res.arrayBuffer());
-    const outPath = correctExtension(filename, buffer);
+    // An explicit `-o` path is a name the caller has committed to and will chain
+    // the NEXT command against (`--input src.png`, `page eval --camera src.png`),
+    // so the saved path MUST equal what was asked - a predictable path is worth
+    // more than a tidy extension. The model's output format is non-deterministic
+    // (BFL's "png" request comes back as JPEG), so renaming to match the bytes
+    // moves the file out from under the caller's already-written second command:
+    // that is the "saved as .jpg, retry with the right path" wasted turn. Honour
+    // the request; every downstream consumer (browsers, image/video tools, the
+    // edit + camera services) sniffs the bytes, not the extension, so a jpg-in-a-
+    // .png plays and edits fine. For the auto-generated default there is no
+    // committed path, so there we DO name the file after its real bytes.
+    const outPath = explicit ? filename : correctExtension(filename, buffer);
+    if (explicit)
+        noteFormatMismatch(filename, buffer);
     ensureOutputDir(outPath);
     writeFileSync(outPath, buffer);
     const savedPath = resolvePath(outPath);
@@ -85,6 +99,23 @@ function correctExtension(filename, buf) {
         + `saving as ${corrected} so the extension matches the actual bytes.`));
     return corrected;
 }
+/** When the caller committed to an explicit `-o` path we save to it verbatim
+ *  (see downloadFile), but the model's format may not match the extension. Say
+ *  so, and say plainly that the file is at the requested path — so an agent that
+ *  reads this note does NOT go change the path its already-queued next command
+ *  points at (that "retry with .jpg" turn is the whole bug we're closing). */
+function noteFormatMismatch(filename, buf) {
+    const actual = sniffExt(buf);
+    if (!actual)
+        return;
+    const dot = filename.lastIndexOf('.');
+    const asked = dot > 0 ? filename.slice(dot + 1).toLowerCase() : '';
+    if (!asked || canonicalExt(asked) === actual)
+        return;
+    console.error(muted(`Note: ${basename(filename)} holds ${formatName(actual)} bytes though its name ends .${asked} — `
+        + `that's fine (browsers and image/video/edit tools sniff the bytes, not the name). `
+        + `Saved at the exact path you requested; reference it as-is.`));
+}
 /** Create the parent directory of an -o path, so `-o src/audio/ding.mp3` works
  *  in a tree that has no `src/audio/` yet instead of dying on a raw ENOENT.
  *
@@ -116,22 +147,52 @@ async function pushGenerated(savedPath) {
         console.error(muted(`Note: couldn't sync to the cloud automatically (${err.message}). Run \`gipity sync\` before referencing this file in \`gipity sandbox run\`.`));
     }
 }
+/** Read the `--input` image files an edit request is applied to, as base64 +
+ *  mime type. The CLI reads the bytes itself so a photo never has to travel
+ *  through the shell argv (base64 images blow past ARG_MAX — "Argument list too
+ *  long" — the moment you try to inline them), which is exactly the trap an
+ *  agent falls into hand-rolling an edit call with a python one-liner. */
+function readInputImages(paths) {
+    return paths.map((p) => {
+        let buf;
+        try {
+            buf = readFileSync(p);
+        }
+        catch (e) {
+            throw new Error(`can't read --input image ${p} (${e.code || e.message}).`);
+        }
+        const mime = guessMime(p);
+        if (!mime.startsWith('image/')) {
+            throw new Error(`--input ${p} is not an image (${mime}). Edit inputs must be image files.`);
+        }
+        return { data: buf.toString('base64'), mime_type: mime };
+    });
+}
 // ── IMAGE ──────────────────────────────────────────────────────────────
 const imageCommand = new Command('image')
-    .description(`Generate an image from a text prompt using AI.
+    .description(`Generate an image from a text prompt, or EDIT existing images with --input.
 
 Models: ${IMAGE_MODELS_DOC}
 
+Editing (--input): pass one or more source images and the prompt becomes an edit
+instruction applied to them - "make it night time", "add a hat", "remove the car
+in the background", or compose several inputs together. Editing routes to Gemini
+automatically. This is the first-party way to exercise the image-edit flow from
+the CLI; the CLI reads the file bytes itself, so there is no base64/argv fiddling.
+
 Gemini-specific options:
   --aspect-ratio   Control output shape: ${IMAGE_GEMINI_ASPECT_RATIOS}
   --image-size     Control resolution: ${IMAGE_GEMINI_SIZES} (default: 1K)
 
 Examples:
   gipity generate image "a cat wearing a top hat"
+  gipity generate image "make it night time" --input photo.jpg -o edited.png
+  gipity generate image "put the person in the first photo into the second scene" --input person.png --input scene.png
   gipity generate image "landscape sunset" --provider gemini --aspect-ratio 16:9 --image-size 2K
   gipity generate image "product photo" --provider openai --model gpt-image-2 --size 1536x1024 --quality high
   gipity generate image "abstract art" --provider bfl --model flux-2-pro -o art.png`)
-    .argument('<prompt>', 'Text description of the image to generate')
+    .argument('<prompt>', 'Text description of the image, or (with --input) the edit instruction to apply')
+    .option('--input <file>', 'Source image to edit/compose (repeatable). With --input the prompt is an edit instruction; routes to Gemini.', (v, acc) => (acc || []).concat(v))
     .option('--provider <provider>', 'Image provider: openai, bfl, or gemini (default: bfl)')
     .option('--model <model>', 'Model ID (see provider list above)')
     .option('--size <size>', 'Dimensions as WxH, e.g. "1024x1024" (OpenAI/BFL)')
@@ -146,6 +207,7 @@ Examples:
         const { config } = await resolveProjectContext();
         if (opts.output)
             ensureOutputDir(opts.output);
+        const inputImages = opts.input ? readInputImages(opts.input) : undefined;
         const doGenerate = () => post(`/projects/${config.projectGuid}/generate/image`, {
             prompt,
             provider: opts.provider,
@@ -155,13 +217,15 @@ Examples:
             aspect_ratio: opts.aspectRatio,
             image_size: opts.imageSize,
             seed: Number.isFinite(opts.seed) ? opts.seed : undefined,
+            input_images: inputImages,
         });
+        const verb = inputImages ? 'Editing image...' : 'Generating image...';
         const result = opts.json
             ? await doGenerate()
-            : await withSpinner('Generating image…', doGenerate, { done: null });
+            : await withSpinner(verb, doGenerate, { done: null });
         const ext = result.content_type.includes('png') ? 'png' : 'jpg';
         const filename = opts.output || `generated.${ext}`;
-        const savedPath = await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename, !!opts.output);
         if (opts.json) {
             console.log(JSON.stringify({ ...result, saved: savedPath }));
         }
@@ -221,9 +285,9 @@ Examples:
         // Veo runs 30-120s; the bouncing bar + timer keeps the wait honest.
         const result = opts.json
             ? await doGenerate()
-            : await withSpinner('Generating video…', doGenerate, { done: null });
+            : await withSpinner('Generating video...', doGenerate, { done: null });
         const filename = opts.output || 'generated.mp4';
-        const savedPath = await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename, !!opts.output);
         if (opts.json) {
             console.log(JSON.stringify({ ...result, saved: savedPath }));
         }
@@ -285,9 +349,9 @@ Examples:
         });
         const result = opts.json
             ? await doGenerate()
-            : await withSpinner('Generating speech…', doGenerate, { done: null });
+            : await withSpinner('Generating speech...', doGenerate, { done: null });
         const filename = opts.output || 'speech.mp3';
-        const savedPath = await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename, !!opts.output);
         if (opts.json) {
             console.log(JSON.stringify({ ...result, saved: savedPath }));
         }
@@ -338,9 +402,9 @@ Examples:
         });
         const result = opts.json
             ? await doGenerate()
-            : await withSpinner('Generating music…', doGenerate, { done: null });
+            : await withSpinner('Generating music...', doGenerate, { done: null });
         const filename = opts.output || 'music.mp3';
-        const savedPath = await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename, !!opts.output);
         if (opts.json) {
             console.log(JSON.stringify({ ...result, saved: savedPath }));
         }
@@ -389,9 +453,9 @@ Examples:
         });
         const result = opts.json
             ? await doGenerate()
-            : await withSpinner('Generating sound effect…', doGenerate, { done: null });
+            : await withSpinner('Generating sound effect...', doGenerate, { done: null });
         const filename = opts.output || 'sound.mp3';
-        const savedPath = await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename, !!opts.output);
         if (opts.json) {
             console.log(JSON.stringify({ ...result, saved: savedPath }));
         }

package/dist/commands/gmail.js

@@ -61,7 +61,7 @@ gmailCommand
     .option('--cc <email>', 'Cc recipient (repeatable)', collect, [])
     .option('--bcc <email>', 'Bcc recipient (repeatable)', collect, [])
     .option('--reply-to <email>', 'Reply-To header address')
-    .requiredOption('--subject <s>', 'Subject (usually "Re: …" of the original)')
+    .requiredOption('--subject <s>', 'Subject (usually "Re: ..." of the original)')
     .requiredOption('--body <text>', 'Reply body (you compose the quote header)')
     .option('--json', 'Output as JSON')
     .action((opts) => run('Reply', async () => {