@inquir/compute-cli 0.2.2 → 0.4.0

package/dist/utils/ensure-auth.js

@@ -1,5 +1,5 @@
 import { requireAuth } from './api.js';
-import { authRequiredError } from './errors.js';
+import { authRequiredError, CliError } from './errors.js';
 import { canPrompt, confirm } from './prompt.js';
 import { printLine } from './output.js';
 /**
@@ -12,7 +12,11 @@ export async function ensureAuth(apiOptions = {}) {
         await requireAuth(apiOptions);
         return;
     }
-    catch {
+    catch (error) {
+        // Invalid environment/configuration is not a missing login. Preserve it
+        // instead of offering to create credentials in an accidentally named scope.
+        if (!(error instanceof CliError) || error.code !== 'AUTH_REQUIRED')
+            throw error;
         if (canPrompt() && (await confirm('You are not logged in. Log in now?', true))) {
             printLine('');
             const { loginCommand } = await import('../commands/login.js');

package/dist/utils/ensure-auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"ensure-auth.js","sourceRoot":"","sources":["../../src/utils/ensure-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,aAAgC,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,SAAS,EAAE,IAAI,CAAC,MAAM,OAAO,CAAC,oCAAoC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAC/E,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAC9D,0EAA0E;YAC1E,wEAAwE;YACxE,oDAAoD;YACpD,MAAM,YAAY,CAAC;gBACjB,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aACrE,CAAC,CAAC;YACH,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,0CAA0C;YACzE,OAAO;QACT,CAAC;QACD,MAAM,iBAAiB,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC"}
+{"version":3,"file":"ensure-auth.js","sourceRoot":"","sources":["../../src/utils/ensure-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,aAAgC,EAAE;IACjE,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,wEAAwE;QACxE,4EAA4E;QAC5E,IAAI,CAAC,CAAC,KAAK,YAAY,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;YAAE,MAAM,KAAK,CAAC;QAChF,IAAI,SAAS,EAAE,IAAI,CAAC,MAAM,OAAO,CAAC,oCAAoC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YAC/E,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YAC9D,0EAA0E;YAC1E,wEAAwE;YACxE,oDAAoD;YACpD,MAAM,YAAY,CAAC;gBACjB,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC9D,GAAG,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aACrE,CAAC,CAAC;YACH,SAAS,CAAC,EAAE,CAAC,CAAC;YACd,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,0CAA0C;YACzE,OAAO;QACT,CAAC;QACD,MAAM,iBAAiB,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/utils/package-metadata.js

@@ -17,6 +17,6 @@ export function getCliVersion() {
     return readCliPackageJson().version ?? '0.1.0';
 }
 export function getSdkDependencyRange() {
-    return readCliPackageJson().dependencies?.['@inquir/compute'] ?? '^0.1.0';
+    return readCliPackageJson().dependencies?.['@inquir/compute'] ?? '^0.4.0';
 }
 //# sourceMappingURL=package-metadata.js.map

package/dist/utils/project-context.d.ts

@@ -0,0 +1,17 @@
+import { type ApiRequestOptions } from './api.js';
+export interface ProjectContext {
+    file: string;
+    /** Pin subsequent reads/writes to the workspace that /v1/me actually selected. */
+    apiOptions: ApiRequestOptions;
+    workspaceId: string;
+}
+/** Never infer identity/workspace from cached login data or a selector slug. */
+export declare function resolveProjectContext(args: string[], apiOptions: ApiRequestOptions): Promise<ProjectContext>;
+export declare function readProjectSelection(context: ProjectContext): Promise<string | undefined>;
+export declare function writeProjectSelection(context: ProjectContext, projectId?: string): Promise<void>;
+/** Explicit flag > selection for this directory/API/workspace/identity > server default. */
+export declare function resolveCreateProject(args: string[], apiOptions: ApiRequestOptions): Promise<{
+    projectId?: string;
+    apiOptions: ApiRequestOptions;
+}>;
+//# sourceMappingURL=project-context.d.ts.map

package/dist/utils/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../src/utils/project-context.ts"],"names":[],"mappings":"AAKA,OAAO,EAAS,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAMzD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAiBD,gFAAgF;AAChF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC,cAAc,CAAC,CAWzB;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiB/F;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAatG;AAED,4FAA4F;AAC5F,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,iBAAiB,GAC5B,OAAO,CAAC;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAAC,CAsBhE"}

package/dist/utils/project-context.js

@@ -0,0 +1,96 @@
+import { createHash, randomUUID } from 'node:crypto';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { loadConfig } from '../sdk.js';
+import { getMe } from './api.js';
+import { readFlagValue, readWorkspaceDir } from './args.js';
+import { resolveAuthConfig } from './auth.js';
+import { CliError, ExitCode, usageError } from './errors.js';
+import { resolveProject } from './project-lookup.js';
+function digest(value) {
+    return createHash('sha256').update(JSON.stringify(value)).digest('hex');
+}
+async function contextDirectory(args, apiOptions) {
+    const auth = await resolveAuthConfig(apiOptions);
+    const api = new URL(auth.apiUrl);
+    api.pathname = api.pathname.replace(/\/+$/, '');
+    const root = await fs.realpath(loadConfig(readWorkspaceDir(args)).rootDir);
+    const directory = process.platform === 'win32' ? root.toLowerCase() : root;
+    return path.join(os.homedir(), '.inquir', 'project-contexts', digest([api.href, directory]));
+}
+/** Never infer identity/workspace from cached login data or a selector slug. */
+export async function resolveProjectContext(args, apiOptions) {
+    const directory = await contextDirectory(args, apiOptions);
+    const auth = await resolveAuthConfig(apiOptions);
+    const me = await getMe(apiOptions);
+    const workspaceId = me.activeWorkspace.id;
+    const identity = me.user?.id ? `user:${me.user.id}` : `key:${digest(auth.token ?? auth.apiKey ?? '')}`;
+    return {
+        file: path.join(directory, `${digest([workspaceId, identity])}.json`),
+        workspaceId,
+        apiOptions: { ...apiOptions, workspaceId },
+    };
+}
+export async function readProjectSelection(context) {
+    let raw;
+    try {
+        raw = await fs.readFile(context.file, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    const selection = JSON.parse(raw);
+    if (typeof selection.projectId !== 'string' || !selection.projectId.trim()) {
+        throw new CliError('Stored project selection is invalid', {
+            code: 'INVALID_PROJECT_CONTEXT',
+            exitCode: ExitCode.ERROR,
+            fix: 'Run `inquir projects use --clear` to return to automatic project creation.',
+        });
+    }
+    return selection.projectId;
+}
+export async function writeProjectSelection(context, projectId) {
+    if (!projectId) {
+        await fs.rm(context.file, { force: true });
+        return;
+    }
+    await fs.mkdir(path.dirname(context.file), { recursive: true, mode: 0o700 });
+    const temporary = `${context.file}.${randomUUID()}.tmp`;
+    try {
+        await fs.writeFile(temporary, `${JSON.stringify({ projectId })}\n`, { mode: 0o600 });
+        await fs.rename(temporary, context.file);
+    }
+    finally {
+        await fs.rm(temporary, { force: true });
+    }
+}
+/** Explicit flag > selection for this directory/API/workspace/identity > server default. */
+export async function resolveCreateProject(args, apiOptions) {
+    const terminator = args.indexOf('--');
+    const flags = terminator === -1 ? args : args.slice(0, terminator);
+    const hasProject = flags.some((arg) => arg === '--project' || arg.startsWith('--project='));
+    if (hasProject) {
+        const selector = readFlagValue(args, '--project')?.trim();
+        if (!selector)
+            throw usageError('Missing project selector', 'inquir apps create <name> --project <project>');
+        // A display name is resolved to its id here; the create endpoint still
+        // validates the project together with the application write.
+        return { projectId: (await resolveProject(selector, apiOptions)).id, apiOptions };
+    }
+    // Fresh CLI installations need no identity request merely to use the server default.
+    const directory = await contextDirectory(args, apiOptions);
+    try {
+        await fs.access(directory);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return { apiOptions };
+        throw error;
+    }
+    const context = await resolveProjectContext(args, apiOptions);
+    return { projectId: await readProjectSelection(context), apiOptions: context.apiOptions };
+}
+//# sourceMappingURL=project-context.js.map

package/dist/utils/project-context.js.map

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

package/dist/utils/project-lookup.d.ts

@@ -0,0 +1,10 @@
+import { type ProjectDetail } from '../sdk.js';
+import { type ApiRequestOptions } from './api.js';
+export declare function isNotFound(error: unknown): boolean;
+/**
+ * A project by the id or slug the API takes, or by its display name — the
+ * only thing the dashboard shows. A name is tried only after the API answered
+ * 404, so an id or slug always wins, and only a unique one is accepted.
+ */
+export declare function resolveProject(selector: string, apiOptions: ApiRequestOptions): Promise<ProjectDetail>;
+//# sourceMappingURL=project-lookup.d.ts.map

package/dist/utils/project-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-lookup.d.ts","sourceRoot":"","sources":["../../src/utils/project-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAM5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD;AAkBD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgB5G"}

package/dist/utils/project-lookup.js

@@ -0,0 +1,52 @@
+import { ApiError } from '../sdk.js';
+import { getProject, listProjects } from './api.js';
+import { CliError, ExitCode } from './errors.js';
+/** A lookup by name reads the project list; bounded like the other list scans. */
+const MAX_PROJECT_LIST_PAGES = 20;
+export function isNotFound(error) {
+    return error instanceof ApiError && error.status === 404;
+}
+async function projectsNamed(name, apiOptions) {
+    const byId = new Map();
+    let cursor;
+    for (let page = 0; page < MAX_PROJECT_LIST_PAGES; page++) {
+        const result = await listProjects({ limit: 100, cursor }, apiOptions);
+        for (const project of result.items)
+            byId.set(project.id, project);
+        if (!result.nextCursor || result.nextCursor === cursor)
+            break;
+        cursor = result.nextCursor;
+    }
+    const projects = [...byId.values()];
+    const exact = projects.filter((project) => project.name === name);
+    if (exact.length > 0)
+        return exact;
+    const folded = name.toLocaleLowerCase();
+    return projects.filter((project) => project.name.toLocaleLowerCase() === folded);
+}
+/**
+ * A project by the id or slug the API takes, or by its display name — the
+ * only thing the dashboard shows. A name is tried only after the API answered
+ * 404, so an id or slug always wins, and only a unique one is accepted.
+ */
+export async function resolveProject(selector, apiOptions) {
+    try {
+        return await getProject(selector, apiOptions);
+    }
+    catch (error) {
+        if (!isNotFound(error))
+            throw error;
+        const named = await projectsNamed(selector, apiOptions);
+        if (named.length === 1)
+            return getProject(named[0].id, apiOptions);
+        if (named.length > 1) {
+            throw new CliError(`Several projects are named '${selector}'`, {
+                code: 'AMBIGUOUS_PROJECT',
+                exitCode: ExitCode.USAGE,
+                fix: `Use the slug of the one you mean: ${named.map((project) => project.slug).join(', ')}`,
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=project-lookup.js.map

package/dist/utils/project-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-lookup.js","sourceRoot":"","sources":["../../src/utils/project-lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAoC,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,YAAY,EAA0B,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEjD,kFAAkF;AAClF,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAElC,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,UAA6B;IACtE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;IACxC,IAAI,MAA0B,CAAC;IAC/B,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,sBAAsB,EAAE,IAAI,EAAE,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,UAAU,CAAC,CAAC;QACtE,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,KAAK;YAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM;YAAE,MAAM;QAC9D,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;IAC7B,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,MAAM,CAAC,CAAC;AACnF,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB,EAAE,UAA6B;IAClF,IAAI,CAAC;QACH,OAAO,MAAM,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAChD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,MAAM,KAAK,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACxD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACnE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,QAAQ,CAAC,+BAA+B,QAAQ,GAAG,EAAE;gBAC7D,IAAI,EAAE,mBAAmB;gBACzB,QAAQ,EAAE,QAAQ,CAAC,KAAK;gBACxB,GAAG,EAAE,qCAAqC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aAC5F,CAAC,CAAC;QACL,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inquir/compute-cli",
-  "version": "0.2.2",
+  "version": "0.4.0",
   "type": "module",
   "description": "Workspace-first CLI for Inquir Compute.",
   "bin": {
@@ -12,16 +12,19 @@
   ],
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "npm --prefix ../.. run build --workspace @inquir/compute && tsc -p tsconfig.json",
+    "build": "npm run clean && npm --prefix ../.. run build --workspace @inquir/compute && tsc -p tsconfig.json",
     "build:self": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run clean && npm run build",
+    "prepack": "npm run build",
     "test": "npx vitest run -c vitest.config.ts"
   },
   "publishConfig": {
     "access": "public"
   },
+  "engines": {
+    "node": ">=22"
+  },
   "dependencies": {
-    "@inquir/compute": "^0.2.0",
+    "@inquir/compute": "^0.4.0",
     "tsx": "^4.19.2"
   },
   "devDependencies": {

package/skill/SKILL.md

@@ -35,21 +35,34 @@ Detection rules:
 
 Overrides when detection guesses wrong: `--runtime`, `--handler <module.export>`, `--mode handler|web`, `--start "<cmd>"`.
 
+## Databases (Postgres / Redis)
+
+- `inquir apps create mydb --template postgres|redis` — one command from nothing to a running database: image, persistent volume, private TCP port, generated password, first release. `--volume-runner <runner>` puts it on a worker; that needs the operator's mirror of the template image, and the refusal (`APP_TEMPLATE_IMAGE_NOT_MIRRORED`) says so.
+- `inquir apps connect mydb web` — writes the connection URL into another app's env as `DATABASE_URL` / `REDIS_URL`; applies on that app's next release. Prefer this: the password never passes through you.
+- `inquir apps connection-url mydb` — prints the live URL with credentials in it (and into shell history); use only when the consumer is not an app on the platform.
+- `inquir apps backups mydb [list|create|restore <id>|delete <id>]` — volume snapshots. `restore` **overwrites the volume** and stops the app while it runs; it asks for confirmation, so non-interactively it needs `--yes`.
+
 ## MCP tools (preferred for agents)
 
 Register once: `claude mcp add inquir -- inquir mcp`
 
 - `deploy {path, name?, start?, env?}` — detect + deploy a directory; returns detection reasons, deploy status, and error logs on failure.
 - `invoke {function, payload}` — run a function and get result + logs.
-- `exec {function, command, target?}` — run a shell command inside the function's container (its runtime image + code). `target: "source"` (default) is read-write: use it for installing deps, running tests, debugging.
+- `exec {function, command, requestId, target?}` — submit an asynchronous command against a private source snapshot. Before calling, generate and retain one lowercase UUID v4 `requestId` per intent. A repeated UUID only observes; it never creates another execution. Finite execution must be enabled on the server; an unavailable response never falls back to writable published source. `target: "release"` uses the existing read-only release execution and needs no UUID.
+- `source_command_status {requestId, waitMs?}` — read execution state/output; optional bounded GET polling. An interrupted wait does not cancel execution or release capacity.
+- `source_command_reconcile {requestId}` — explicitly apply retained output if the original source is still current. Inspect `APPLIED`, `CONFLICT`, or `workspaceFailure`; never automatically rerun a command after conflict.
+- `source_command_cancel {requestId}` — request durable cancellation. `CANCEL_REQUESTED` is intent, not a stopped-container receipt; `PUBLICATION_COMMITTED` means cancellation is too late.
+- `source_command_resume {requestId, action: "status" | "submit"}` — reload the privately retained operation after restart. Use `status` first; `submit` explicitly retries the same saved bytes and UUID after an uncertain submission. Resume requires the same API, credential and workspace. Records contain command/env secrets and no credentials; preserve the CLI user profile's private filesystem permissions. Optional `inquir mcp --source-session <stable-conversation-id>` also binds JSON-RPC request IDs across reconnects; do not reuse that namespace for unrelated conversations.
 - `list_invocations {function}` — recent runs with errors and logs: the debugging entry point.
 - `deploy_status {deployId}`, `rollback {function, deployId}`, `list_functions`.
 
+The stdio server admits four working calls, including at most one deploy/rollback, plus two source-control or deploy-status calls. A busy response starts no work; retain the source UUID when retrying. Ping and cancellation notifications remain available while work waits. Each input frame is limited to 64 KiB. HTTP responses are limited to 2 MiB for source commands and 4 MiB otherwise, with a 60-second timeout per request including body reads. Output waits for the reader, retaining at most sixteen replies or 8 MiB; a broken or stalled pipe closes observation. Disconnecting never sends a job cancellation.
+
 ## Debug loop that works
 
 1. `deploy` → read `deploy.error` and status.
 2. If failing at runtime: `list_invocations` → read logs.
-3. Reproduce inside the container: `exec {command: "npm test"}` or `exec {command: "python -c '...'"}`.
+3. Submit a source command with a retained UUID, then read `source_command_status`. Review output before explicitly reconciling source changes. For a read-only release check use `exec {function: "my-function", command: "npm test", target: "release"}`.
 4. Fix code locally, `deploy` again. Deploys are versioned; `rollback` restores any previous success.
 
 ## Contracts that matter