@inquir/compute-cli 0.1.4 → 0.2.1

package/dist/utils/detect.js

@@ -0,0 +1,358 @@
+/**
+ * Zero-config app detection (Railway-style).
+ *
+ * Given a directory, figure out: runtime, entry file, mode (lambda handler vs
+ * web server), handler spec or start command, and a deployable name — without
+ * requiring an inquir config or the TypeScript SDK contract.
+ *
+ * Detection is intentionally boring and transparent: every decision appends a
+ * human-readable line to `reasons` so `inquir deploy` can print exactly why it
+ * chose what it chose (and how to override it).
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+export class DetectionError extends Error {
+    hints;
+    constructor(message, hints = []) {
+        super(message);
+        this.hints = hints;
+        this.name = 'DetectionError';
+    }
+}
+const NODE_EXTENSIONS = ['.mjs', '.cjs', '.js', '.ts', '.mts', '.cts'];
+const NODE_ENTRY_BASENAMES = ['index', 'main', 'app', 'server', 'handler'];
+const PYTHON_ENTRY_FILES = ['main.py', 'app.py', 'index.py', 'server.py', 'handler.py', 'application.py'];
+/** Handler export patterns per runtime family. */
+const NODE_HANDLER_PATTERN = /(?:exports\.handler\s*=|module\.exports\.handler\s*=|export\s+(?:async\s+)?function\s+handler\b|export\s+const\s+handler\s*=|module\.exports\s*=\s*{[^}]*\bhandler\b)/;
+const PYTHON_HANDLER_PATTERN = /^def\s+(?:handler|lambda_handler)\s*\(/m;
+const GO_HANDLER_PATTERN = /func\s+Handler\s*\(/;
+/** Signals that a Node entry file is a server, not a handler module. */
+const NODE_SERVER_PATTERN = /(?:\.listen\s*\(|createServer\s*\(|require\(['"](?:express|fastify|koa|hapi|@hapi\/hapi|restify)['"]\)|from\s+['"](?:express|fastify|koa|hapi|@hapi\/hapi|restify)['"])/;
+/** Web-server frameworks in dependencies count as server evidence. */
+const NODE_WEB_FRAMEWORK_DEPS = [
+    'express', 'fastify', 'koa', 'hapi', '@hapi/hapi', 'restify',
+    'next', '@nestjs/core', '@remix-run/serve', 'astro', 'nuxt',
+];
+/** Web-server evidence for Python (deps text or entry source). */
+const PYTHON_WEB_DEPS_PATTERN = /\b(?:fastapi|flask|django|uvicorn|gunicorn|starlette|aiohttp|sanic|tornado)\b/;
+const PYTHON_WEB_SOURCE_PATTERN = /(?:app\.run\s*\(|http\.server|make_server\s*\(|run_simple\s*\()/;
+/** Dirs the deploy artifact never includes (mirrors the SDK zip excludes) —
+ * an entry inside them would deploy as a dangling reference. */
+const ARTIFACT_EXCLUDED_ENTRY = /^(?:dist|node_modules|\.git|\.inquir)\//;
+function exists(dir, rel) {
+    try {
+        return fs.existsSync(path.join(dir, rel));
+    }
+    catch {
+        return false;
+    }
+}
+function readText(dir, rel) {
+    try {
+        return fs.readFileSync(path.join(dir, rel), 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function readPackageJson(dir) {
+    const raw = readText(dir, 'package.json');
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** List top-level files with any of the given extensions (sorted, non-recursive). */
+function listByExtension(dir, extensions) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((e) => e.isFile() && extensions.includes(path.extname(e.name)))
+        .map((e) => e.name)
+        .sort();
+}
+/** Sanitize an arbitrary string into a deployable function name. */
+export function sanitizeName(raw) {
+    const cleaned = raw
+        .toLowerCase()
+        .replace(/^@[^/]+\//, '') // scoped npm package → drop scope
+        .replace(/[^a-z0-9-]+/g, '-')
+        .replace(/-{2,}/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return cleaned || 'app';
+}
+/** Find the first existing entry file among conventional Node names. */
+function findNodeEntry(dir, pkg) {
+    // package.json "main" wins when it exists on disk — unless it points into a
+    // dir the artifact excludes (dist/ etc.): deploying that reference would 404.
+    if (pkg?.main) {
+        const main = pkg.main.replace(/\\/g, '/');
+        if (exists(dir, main) && !ARTIFACT_EXCLUDED_ENTRY.test(main))
+            return main;
+    }
+    for (const prefix of ['', 'src/']) {
+        for (const base of NODE_ENTRY_BASENAMES) {
+            for (const ext of NODE_EXTENSIONS) {
+                const candidate = `${prefix}${base}${ext}`;
+                if (exists(dir, candidate))
+                    return candidate;
+            }
+        }
+    }
+    // Single top-level source file → that's the entry.
+    const files = listByExtension(dir, NODE_EXTENSIONS);
+    return files.length === 1 ? files[0] : null;
+}
+function findPythonEntry(dir) {
+    for (const prefix of ['', 'src/']) {
+        for (const name of PYTHON_ENTRY_FILES) {
+            const candidate = `${prefix}${name}`;
+            if (exists(dir, candidate))
+                return candidate;
+        }
+    }
+    const files = listByExtension(dir, ['.py']);
+    return files.length === 1 ? files[0] : null;
+}
+/** "src/api.mjs" → "src/api" (handler module spec base). */
+function stripExtension(rel) {
+    return rel.replace(/\.[^./]+$/, '');
+}
+function detectRuntime(dir, reasons) {
+    if (exists(dir, 'go.mod')) {
+        reasons.push('runtime: go122 (go.mod present)');
+        return 'go122';
+    }
+    const hasPyMarker = exists(dir, 'requirements.txt') || exists(dir, 'pyproject.toml') || exists(dir, 'Pipfile');
+    const pkg = readPackageJson(dir);
+    if (hasPyMarker && !pkg) {
+        reasons.push('runtime: python312 (requirements.txt/pyproject.toml present)');
+        return 'python312';
+    }
+    if (pkg) {
+        reasons.push('runtime: nodejs22 (package.json present)');
+        return 'nodejs22';
+    }
+    // No manifests — fall back to source files.
+    if (listByExtension(dir, ['.go']).length > 0) {
+        reasons.push('runtime: go122 (.go sources present)');
+        return 'go122';
+    }
+    if (listByExtension(dir, ['.py']).length > 0 || findPythonEntry(dir)) {
+        reasons.push('runtime: python312 (.py sources present)');
+        return 'python312';
+    }
+    if (listByExtension(dir, NODE_EXTENSIONS).length > 0 || findNodeEntry(dir, null)) {
+        reasons.push('runtime: nodejs22 (JS/TS sources present)');
+        return 'nodejs22';
+    }
+    throw new DetectionError(`Could not detect a runtime in ${dir}`, [
+        'Supported: Node.js (package.json / *.js), Python (requirements.txt / *.py), Go (go.mod).',
+        'Override with --runtime nodejs22|python312|go122.',
+    ]);
+}
+/**
+ * Resolve the command that starts a Node web app.
+ * npm start is inlined (its script body) so the runtime image does not need npm
+ * at all — the harness runs the command through sh with PORT set.
+ */
+function nodeStartCommand(entryFile, pkg, reasons) {
+    const start = pkg?.scripts?.start?.trim();
+    if (start && !/^npm\s+/.test(start) && !/^yarn\s+/.test(start) && !/^pnpm\s+/.test(start)) {
+        reasons.push(`start: "${start}" (package.json scripts.start, inlined)`);
+        return start;
+    }
+    if (/\.(?:ts|mts|cts)$/.test(entryFile)) {
+        // Web deploys skip bundling; Node 22 cannot execute .ts directly.
+        throw new DetectionError(`Web entry ${entryFile} is TypeScript, which the runtime cannot run directly`, [
+            'Add a scripts.start that runs compiled output, or pass --start "<command>".',
+            'Handler-mode functions support TypeScript via bundling; web apps run your sources as-is.',
+        ]);
+    }
+    reasons.push(`start: "node ${entryFile}" (entry file)`);
+    return `node ${entryFile}`;
+}
+/** Resolve the command that starts a Python web app. */
+function pythonStartCommand(dir, entryFile, reasons) {
+    const requirements = (readText(dir, 'requirements.txt') ?? '').toLowerCase();
+    const pyproject = (readText(dir, 'pyproject.toml') ?? '').toLowerCase();
+    const deps = requirements + '\n' + pyproject;
+    const module = stripExtension(entryFile).replace(/\//g, '.');
+    const entrySource = readText(dir, entryFile) ?? '';
+    if (/\bfastapi\b/.test(deps)) {
+        const cmd = `python -m uvicorn ${module}:app --host 0.0.0.0 --port \${PORT}`;
+        reasons.push(`start: "${cmd}" (FastAPI detected)`);
+        return cmd;
+    }
+    if (/\bflask\b/.test(deps)) {
+        if (/\bgunicorn\b/.test(deps)) {
+            const cmd = `python -m gunicorn -b 0.0.0.0:\${PORT} ${module}:app`;
+            reasons.push(`start: "${cmd}" (Flask + gunicorn detected)`);
+            return cmd;
+        }
+        if (/app\.run\s*\(/.test(entrySource) && /\bPORT\b/.test(entrySource)) {
+            // Only trust app.run() when the app reads the PORT env itself — a bare
+            // app.run() binds Flask's default 5000 and the adapter waits forever.
+            reasons.push(`start: "python ${entryFile}" (Flask app.run entry, PORT-aware)`);
+            return `python ${entryFile}`;
+        }
+        const cmd = `python -m flask --app ${module} run --host 0.0.0.0 --port \${PORT}`;
+        reasons.push(`start: "${cmd}" (Flask detected)`);
+        return cmd;
+    }
+    reasons.push(`start: "python ${entryFile}" (entry file)`);
+    return `python ${entryFile}`;
+}
+function assertRuntimeOverride(value) {
+    if (value === 'nodejs22' || value === 'python312' || value === 'go122')
+        return value;
+    throw new DetectionError(`Unknown --runtime "${value}"`, [
+        'Supported runtimes: nodejs22, python312, go122.',
+    ]);
+}
+function assertModeOverride(value) {
+    if (value === 'handler' || value === 'web')
+        return value;
+    throw new DetectionError(`Unknown --mode "${value}"`, ['Supported modes: handler, web.']);
+}
+/**
+ * Detect a deployable app in `dir`. Overrides always win over sniffing; every
+ * decision is recorded in `reasons` for the deploy plan output.
+ */
+export function detectApp(dir, overrides = {}) {
+    const resolved = path.resolve(dir);
+    if (!fs.existsSync(resolved) || !fs.statSync(resolved).isDirectory()) {
+        throw new DetectionError(`Not a directory: ${dir}`);
+    }
+    const reasons = [];
+    if (exists(resolved, 'Dockerfile') && !overrides.runtime) {
+        reasons.push('Dockerfile found but Dockerfile builds are not supported yet — using language detection');
+    }
+    const runtime = overrides.runtime
+        ? assertRuntimeOverride(overrides.runtime)
+        : detectRuntime(resolved, reasons);
+    if (overrides.runtime)
+        reasons.push(`runtime: ${runtime} (--runtime)`);
+    const pkg = runtime === 'nodejs22' ? readPackageJson(resolved) : null;
+    // Name resolution: flag > manifest name > directory basename.
+    let name;
+    if (overrides.name) {
+        name = sanitizeName(overrides.name);
+        reasons.push(`name: ${name} (--name)`);
+    }
+    else if (pkg?.name) {
+        name = sanitizeName(pkg.name);
+        reasons.push(`name: ${name} (package.json name)`);
+    }
+    else {
+        name = sanitizeName(path.basename(resolved));
+        reasons.push(`name: ${name} (directory name)`);
+    }
+    // Entry file.
+    let entryFile = null;
+    if (runtime === 'nodejs22')
+        entryFile = findNodeEntry(resolved, pkg);
+    else if (runtime === 'python312')
+        entryFile = findPythonEntry(resolved);
+    else
+        entryFile = exists(resolved, 'main.go') ? 'main.go' : listByExtension(resolved, ['.go'])[0] ?? null;
+    if (overrides.handler) {
+        // Explicit handler spec: trust it, derive the entry from its module part.
+        const moduleBase = overrides.handler.replace(/\.[^.]+$/, '');
+        reasons.push(`handler: ${overrides.handler} (--handler)`);
+        return {
+            name,
+            runtime,
+            mode: 'handler',
+            handler: overrides.handler,
+            entryFile: entryFile ?? `${moduleBase}.*`,
+            reasons,
+        };
+    }
+    if (!entryFile) {
+        throw new DetectionError(`Could not find an entry file in ${dir} (runtime ${runtime})`, [
+            runtime === 'nodejs22'
+                ? 'Expected index/main/app/server.(js|mjs|ts) at the root or in src/, or package.json "main".'
+                : runtime === 'python312'
+                    ? 'Expected main.py/app.py/index.py at the root or in src/.'
+                    : 'Expected main.go.',
+            'Override with --handler <module>.<export> or --start "<command>".',
+        ]);
+    }
+    const entryPosix = entryFile.replace(/\\/g, '/');
+    reasons.push(`entry: ${entryPosix}`);
+    const entrySource = readText(resolved, entryPosix) ?? '';
+    const forcedMode = overrides.mode ? assertModeOverride(overrides.mode) : null;
+    // Handler sniffing per runtime.
+    const hasHandlerExport = runtime === 'nodejs22'
+        ? NODE_HANDLER_PATTERN.test(entrySource)
+        : runtime === 'python312'
+            ? PYTHON_HANDLER_PATTERN.test(entrySource)
+            : GO_HANDLER_PATTERN.test(entrySource);
+    // Web mode needs positive server evidence — a lone scripts.start or a plain
+    // Python script without one would deploy as a crash-looping "web app".
+    const nodeDeps = { ...pkg?.dependencies, ...pkg?.devDependencies };
+    const pyDepsText = runtime === 'python312'
+        ? `${readText(resolved, 'requirements.txt') ?? ''}\n${readText(resolved, 'pyproject.toml') ?? ''}`.toLowerCase()
+        : '';
+    const serverEvidence = runtime === 'nodejs22'
+        ? NODE_SERVER_PATTERN.test(entrySource) || NODE_WEB_FRAMEWORK_DEPS.some((d) => d in nodeDeps)
+        : runtime === 'python312'
+            ? PYTHON_WEB_DEPS_PATTERN.test(pyDepsText) || PYTHON_WEB_SOURCE_PATTERN.test(entrySource)
+            : false;
+    const wantsWeb = forcedMode === 'web' ||
+        Boolean(overrides.start) ||
+        (forcedMode !== 'handler' && !hasHandlerExport && serverEvidence);
+    if (wantsWeb) {
+        if (runtime === 'go122') {
+            throw new DetectionError('Web mode is not supported for Go yet', [
+                'Export a handler instead: func Handler(event map[string]any, ctx obs.Context) (any, error).',
+            ]);
+        }
+        let startCommand;
+        if (overrides.start) {
+            startCommand = overrides.start;
+            reasons.push(`start: "${startCommand}" (--start)`);
+        }
+        else if (runtime === 'nodejs22') {
+            startCommand = nodeStartCommand(entryPosix, pkg, reasons);
+        }
+        else {
+            startCommand = pythonStartCommand(resolved, entryPosix, reasons);
+        }
+        reasons.push('mode: web (server app — the platform will run it with PORT and proxy requests)');
+        return { name, runtime, mode: 'web', entryFile: entryPosix, startCommand, reasons };
+    }
+    if (!hasHandlerExport) {
+        if (runtime === 'go122') {
+            throw new DetectionError(`No exported Handler found in ${entryPosix}`, [
+                'Go apps must export: func Handler(event map[string]any, ctx obs.Context) (any, error).',
+            ]);
+        }
+        // Handler mode was forced (or nothing server-like found): default export name,
+        // let it fail loudly at invoke time if truly absent — but say so.
+        reasons.push(`handler: ${stripExtension(entryPosix)}.handler (default — no handler export detected, verify)`);
+    }
+    else {
+        reasons.push(`handler: ${stripExtension(entryPosix)}.handler (handler export found)`);
+    }
+    reasons.push('mode: handler');
+    return {
+        name,
+        runtime,
+        mode: 'handler',
+        handler: `${stripExtension(entryPosix)}.handler`,
+        entryFile: entryPosix,
+        reasons,
+    };
+}
+//# sourceMappingURL=detect.js.map

package/dist/utils/detect.js.map

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

package/dist/utils/ensure-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensure-auth.d.ts","sourceRoot":"","sources":["../../src/utils/ensure-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAK/D;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,UAAU,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAelF"}
+{"version":3,"file":"ensure-auth.d.ts","sourceRoot":"","sources":["../../src/utils/ensure-auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAK/D;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,UAAU,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBlF"}

package/dist/utils/ensure-auth.js

@@ -16,7 +16,13 @@ export async function ensureAuth(apiOptions = {}) {
         if (canPrompt() && (await confirm('You are not logged in. Log in now?', true))) {
             printLine('');
             const { loginCommand } = await import('../commands/login.js');
-            await loginCommand([]);
+            // Forward the original command's API URL / named environment — logging in
+            // with bare defaults would pair the device against the wrong server and
+            // store the token under the wrong environment slice
+            await loginCommand([
+                ...(apiOptions.apiUrl ? ['--api-url', apiOptions.apiUrl] : []),
+                ...(apiOptions.environment ? ['--env', apiOptions.environment] : []),
+            ]);
             printLine('');
             await requireAuth(apiOptions); // still throws (mapped) if it didn't take
             return;

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,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC;YACvB,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,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"}

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@inquir/compute-cli",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "type": "module",
   "description": "Workspace-first CLI for Inquir Compute.",
   "bin": {
     "inquir": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "skill"
   ],
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
@@ -20,11 +21,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@inquir/compute": "^0.1.2",
+    "@inquir/compute": "^0.2.0",
     "tsx": "^4.19.2"
   },
   "devDependencies": {
     "@types/node": "^22.9.0",
     "typescript": "^5.6.3"
   }
-}
+}

package/skill/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: inquir-compute
+description: Deploy and run functions, background jobs, and web apps on Inquir Compute — use when code needs to run remotely, on a schedule, longer than a request cycle, or behind a stable URL. Zero-config deploys via `inquir deploy` or the inquir MCP tools.
+---
+
+# Inquir Compute — deploy & run workloads
+
+Inquir Compute runs three kinds of workloads in isolated containers:
+
+1. **Functions** — Lambda-compatible handlers (`exports.handler`, `def handler`, Go `Handler`). Best for event processing, API routes, webhooks, cron.
+2. **Web apps** — any HTTP server (Express, Fastify, FastAPI, Flask, raw `http`). Deployed as-is; the platform runs it with `PORT` set and proxies requests. No code changes needed.
+3. **Jobs / durable orchestrations** — async invocations with retries, queues, timers, `waitForEvent`, and human-approval waits that survive process restarts.
+
+## When to reach for Inquir instead of local code
+
+- The user's code must run **after this session ends** (schedules, webhooks, background processing).
+- A task will outlive an HTTP request → use `invoke-async` (jobs) or a durable orchestration, not a long request.
+- The user asks to "deploy", "host", or "get a URL for" something.
+
+## Deploying (zero config)
+
+From a directory — no config file, no SDK, any of Node / Python / Go:
+
+```bash
+inquir deploy               # deploy current directory, auto-detect everything
+inquir deploy ./api --name billing --set LOG_LEVEL=debug
+inquir deploy --dry-run     # show the detection plan without deploying
+```
+
+Detection rules:
+- `exports.handler` / `def handler` / `func Handler` in the entry file → **function**.
+- A server app (`.listen(`, Express/FastAPI/Flask imports, or a `start` script) → **web app**; start command is auto-derived (`node server.js`, `python -m uvicorn main:app …`). Override with `--start "<cmd>"`.
+- Entry file: package.json `main`, then `index/main/app/server.*` at root or `src/`.
+- Dependencies are installed **server-side at deploy** (npm/pip) — never commit `node_modules`.
+
+Overrides when detection guesses wrong: `--runtime`, `--handler <module.export>`, `--mode handler|web`, `--start "<cmd>"`.
+
+## 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.
+- `list_invocations {function}` — recent runs with errors and logs: the debugging entry point.
+- `deploy_status {deployId}`, `rollback {function, deployId}`, `list_functions`.
+
+## 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 '...'"}`.
+4. Fix code locally, `deploy` again. Deploys are versioned; `rollback` restores any previous success.
+
+## Contracts that matter
+
+- Handlers: return JSON-serializable values; HTTP-fronted functions return `{statusCode, headers, body}`.
+- Web apps MUST listen on `process.env.PORT` / `$PORT` (any host binding on `0.0.0.0`).
+- Web apps get no streaming invocations (SSE) yet; use a function for streaming responses.
+- Secrets: pass with `--set KEY=VALUE` or `--env-file`; never hardcode.