@north-light/crouter 0.3.317 → 0.3.319

package/dist/core/runtime/front-door.js

@@ -1,183 +1,7 @@
-// The front door — bare `crtr` boots a resident root node.
-//
-//   crtr                         → boot a root in this terminal (no prompt)
-//   crtr [dir]                   → root pinned to dir
-//   crtr [dir] ["prompt"]        → root with a starter prompt
-//   crtr -c | --continue         → resume the MRU root pinned to cwd (no picker)
-//   crtr -r | --resume           → resume a root pinned to cwd, chosen from a menu
-//   crtr --name NAME ...         → named root
-//   crtr --profile <id-or-name>  → root under an explicit profile (else the
-//                                  startup selector: a per-cwd pinned default,
-//                                  else MRU covering cwd, else a synchronous
-//                                  create-or-root-profile prompt)
-//   crtr --pick-profile          → force the profile chooser open even when a
-//                                  per-cwd default is pinned (to re-pin/unpin)
-//   crtr <subcommand> ...        → falls through to the normal dispatcher
-//   crtr -h | --help             → root help (dispatcher)
-//
-// This is the only place that distinguishes "I want to live here" (root) from
-// the subcommand surface. It runs before the dispatcher; if it boots, pi takes
-// over the terminal and the process never returns.
-import { existsSync, statSync } from 'node:fs';
-import { resolve as resolvePath } from 'node:path';
-import { SUBTREE_NAMES } from '../../build-root.js';
-import { FRONT_DOOR_ENV } from './front-door-env.js';
-// NOTE: the boot-path deps — ./boot-root.js (bootRoot), ./resume-root.js (resumeRoot),
-// ./package-health.js (missingPackageWarning + piAgentDir) — are DYNAMICALLY
-// imported inside maybeBootRoot, NOT statically here. `cli.ts` calls
-// maybeBootRoot on every invocation, and a static import chain that reaches the
-// pi engine costs ~365ms of cold start that every leaf subcommand (`crtr memory
-// list`, etc.) would pay despite never booting a root. The dynamic imports below
-// are reached only after the early-return guards, i.e. only on a genuine
-// front-door boot. Note we DELIBERATELY do NOT import `@earendil-works/pi-coding-agent`
-// even on the boot path — the one thing we needed from it (getAgentDir) is
-// reimplemented as package-health's `piAgentDir()` so the whole pi engine never
-// loads in the FOREGROUND boot process (the broker loads it in parallel).
-function isDir(p) {
-    try {
-        return existsSync(p) && statSync(p).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-/** The `--`flags the front door OWNS (everything else after a bare `crtr` is a
- *  positional dir/prompt). A leading token in this set still boots a root —
- *  without it, `crtr --name X` would fall through to the dispatcher and error as
- *  an unknown subcommand. */
-const FRONT_DOOR_FLAGS = new Set(['--name', '--kind', '--profile', '--pick-profile', '--continue', '-c', '--resume', '-r']);
-/** Parse `[dir] [prompt]` positionals + the front-door flags out of the leftover
- *  tokens after the bare `crtr`. */
-function parseRootArgs(tokens) {
-    let cwd = process.cwd();
-    let name;
-    let kind;
-    let profile;
-    let pickProfile = false;
-    let resume;
-    const positionals = [];
-    for (let i = 0; i < tokens.length; i++) {
-        const t = tokens[i];
-        if (t === '--name') {
-            name = tokens[++i];
-        }
-        else if (t === '--kind') {
-            kind = tokens[++i];
-        }
-        else if (t === '--profile') {
-            profile = tokens[++i];
-        }
-        else if (t === '--pick-profile') {
-            pickProfile = true;
-        }
-        else if (t === '--continue' || t === '-c') {
-            resume = 'continue';
-        }
-        else if (t === '--resume' || t === '-r') {
-            resume = 'pick';
-        }
-        else if (t.startsWith('--')) {
-            // ignore unknown flags for the front door
-        }
-        else {
-            positionals.push(t);
-        }
-    }
-    // First positional that is an existing dir → cwd; the rest → prompt.
-    if (positionals.length > 0 && isDir(resolvePath(positionals[0]))) {
-        cwd = resolvePath(positionals.shift());
-    }
-    const prompt = positionals.length > 0 ? positionals.join(' ') : undefined;
-    return { cwd, prompt, name, kind, profile, pickProfile, resume };
-}
-export { FRONT_DOOR_ENV } from './front-door-env.js';
-/** If this invocation is a front-door (root) launch, boot it and never return.
- *  Returns false when it's a recognized subcommand / help / unknown token (let
- *  the dispatcher handle it — for unknown tokens it errors cleanly).
- *
- *  Takes NO command tree: it decides from argv plus the static `SUBTREE_NAMES`
- *  list, so bare `crtr` never pays for assembling the full tree (measured 520ms
- *  of the front door's ~1.6s — every subtree's module graph plus external
- *  plugin/HTTP-transport plugin discovery, none of which a root boot reads). The one
- *  case that genuinely needs external command names — a bare word that is also
- *  an existing directory — builds the tree lazily, below. */
-export async function maybeBootRoot(argv) {
-    const tokens = argv.slice(2);
-    const first = tokens[0];
-    // Recursion guard: never boot a root from inside a front-door-booted pi.
-    // This is the hard backstop against fork bombs — even a future footgun where
-    // a child re-invokes a removed subcommand cannot loop, because the second
-    // boot is refused and falls through to the dispatcher.
-    if (process.env[FRONT_DOOR_ENV])
-        return false;
-    // `crtr -h` / `crtr --help` / `crtr --version` → dispatcher (root help).
-    if (first === '-h' || first === '--help' || first === '--version' || first === '-v') {
-        return false;
-    }
-    // A recognized CORE subcommand → dispatcher. Name-only check: no subtree
-    // module is loaded to answer it.
-    if (first !== undefined && SUBTREE_NAMES.includes(first))
-        return false;
-    // The front door boots pi ONLY on an unambiguous "live here" signal:
-    //   • bare `crtr`                  (no tokens)
-    //   • `crtr <dir> [prompt]`        (first positional is an existing dir)
-    //   • `crtr "multi word prompt"`   (first token contains whitespace)
-    //   • `crtr --name X`              (a leading front-door flag)
-    // Anything else — a bare word like `job`, or an UNKNOWN leading flag — is
-    // treated as a mistyped/removed subcommand and handed to the dispatcher, which
-    // errors with "unknown subcommand: <token>". Booting pi for such tokens is what
-    // let the renamed `agent`/`job` subcommands fork-bomb the front door.
-    if (first !== undefined) {
-        const looksLikePrompt = /\s/.test(first);
-        const looksLikeDir = !first.startsWith('-') && isDir(resolvePath(first));
-        const looksLikeFrontDoorFlag = FRONT_DOOR_FLAGS.has(first);
-        if (!looksLikePrompt && !looksLikeDir && !looksLikeFrontDoorFlag)
-            return false;
-        // A bare word that is an existing directory is the ONLY token shape that
-        // could also be an EXTERNAL top-level command name (a command plugin or a
-        // HTTP-transport plugin) — a prompt carries whitespace and a front-door flag is
-        // `-`-prefixed, and neither can name a command. Resolve the full tree only
-        // for that collision check, keeping it off the bare-`crtr` boot path.
-        if (looksLikeDir) {
-            const { buildRoot } = await import('../../build-root.js');
-            const full = await buildRoot();
-            if (full.subtrees.some((s) => s.name === first))
-                return false;
-        }
-    }
-    // Unambiguous front-door launch → boot a resident root inline (exec pi in
-    // this terminal). Does not return. Load the heavy boot-path deps lazily now
-    // that we've committed to booting (see the import note at the top of file).
-    const [{ bootRoot }, { resumeRoot }, { rendererWarning, missingPackageWarning, piAgentDir }] = await Promise.all([
-        import('./boot-root.js'),
-        import('./resume-root.js'),
-        import('./package-health.js'),
-    ]);
-    const args = parseRootArgs(tokens);
-    // Surface any stale/missing local-path pi package BEFORE the viewer takes over
-    // the terminal — pi discards a missing package silently, so this is the only
-    // moment the user sees why (e.g.) their ~/.claude commands vanished.
-    try {
-        const warn = missingPackageWarning(piAgentDir());
-        if (warn !== null)
-            process.stderr.write(`\n${warn}\n\n`);
-        const rendererWarn = rendererWarning();
-        if (rendererWarn !== null)
-            process.stderr.write(`\n${rendererWarn}\n\n`);
-    }
-    catch {
-        /* best-effort diagnostic — never block a boot */
-    }
-    // `-c`/`-r`: resume the last root pinned to this cwd (MRU, or via picker) by
-    // taking over THIS terminal as its viewer. Falls through to a fresh boot when
-    // nothing here is resumable, or when the picker was aborted.
-    if (args.resume !== undefined) {
-        const outcome = await resumeRoot(args.cwd, args.resume === 'pick');
-        // 'empty' → nothing to resume here, fall through to a fresh boot.
-        // 'aborted' → the user dismissed the picker; exit without surprise-booting.
-        if (outcome === 'aborted')
-            return true;
-    }
-    await bootRoot({ ...args });
-    return true;
-}
+var w=Object.defineProperty;var u=(r,n)=>w(r,"name",{value:n,configurable:!0});import{existsSync as R,statSync as g}from"node:fs";import{resolve as m}from"node:path";import{SUBTREE_NAMES as O}from"../../build-root.js";import{FRONT_DOOR_ENV as D}from"./front-door-env.js";function p(r){try{return R(r)&&g(r).isDirectory()}catch{return!1}}u(p,"isDir");const y=new Set(["--name","--kind","--profile","--pick-profile","--continue","-c","--resume","-r"]);function _(r){let n=process.cwd(),t,c,f,a=!1,l;const o=[];for(let i=0;i<r.length;i++){const e=r[i];e==="--name"?t=r[++i]:e==="--kind"?c=r[++i]:e==="--profile"?f=r[++i]:e==="--pick-profile"?a=!0:e==="--continue"||e==="-c"?l="continue":e==="--resume"||e==="-r"?l="pick":e.startsWith("--")||o.push(e)}o.length>0&&p(m(o[0]))&&(n=m(o.shift()));const s=o.length>0?o.join(" "):void 0;return{cwd:n,prompt:s,name:t,kind:c,profile:f,pickProfile:a,resume:l}}u(_,"parseRootArgs");import{FRONT_DOOR_ENV as L}from"./front-door-env.js";async function P(r){const n=r.slice(2),t=n[0];if(process.env[D]||t==="-h"||t==="--help"||t==="--version"||t==="-v"||t!==void 0&&O.includes(t))return!1;if(t!==void 0){const i=/\s/.test(t),e=!t.startsWith("-")&&p(m(t)),d=y.has(t);if(!i&&!e&&!d)return!1;if(e){const{buildRoot:h}=await import("../../build-root.js");if((await h()).subtrees.some(k=>k.name===t))return!1}}const[{bootRoot:c},{resumeRoot:f},{rendererWarning:a,missingPackageWarning:l,piAgentDir:o}]=await Promise.all([import("./boot-root.js"),import("./resume-root.js"),import("./package-health.js")]),s=_(n);try{const i=l(o());i!==null&&process.stderr.write(`
+${i}
+
+`);const e=a();e!==null&&process.stderr.write(`
+${e}
+
+`)}catch{}return s.resume!==void 0&&await f(s.cwd,s.resume==="pick")==="aborted"||await c({...s}),!0}u(P,"maybeBootRoot");export{L as FRONT_DOOR_ENV,P as maybeBootRoot};

package/dist/core/runtime/headless-pi.js

@@ -1,161 +1 @@
-// Isolated in-process Pi one-shots for lightweight model work.
-//
-// Each call uses crouter's credential pool and route policy, an in-memory session,
-// and only the inline provider-rotation extension. No conversation resources or
-// canvas lifecycle hooks enter the helper session.
-import { envNodeCwd, envProfileId } from '../../shared/env.js';
-import { join } from 'node:path';
-import { PoolCredentialStore } from '../pool-credential-store.js';
-import { modelRequestFromConfig, selectInitialModelRoute } from '../model-routes.js';
-function lastAssistantText(messages) {
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const message = messages[i];
-        if (message?.role !== 'assistant')
-            continue;
-        if (typeof message.content === 'string')
-            return message.content.trim();
-        if (!Array.isArray(message.content))
-            continue;
-        const text = message.content
-            .map((part) => {
-            const value = part;
-            return value.type === 'text' && typeof value.text === 'string' ? value.text : '';
-        })
-            .join('')
-            .trim();
-        if (text !== '')
-            return text;
-    }
-    return '';
-}
-async function runHeadless(request, fallback, collect) {
-    let session;
-    let disposed = false;
-    let timedOut = false;
-    let timeout;
-    const disposeSession = (abort) => {
-        if (session === undefined || disposed)
-            return;
-        disposed = true;
-        if (abort)
-            void session.abort().catch(() => undefined);
-        session.dispose();
-    };
-    const deadline = new Promise((resolve) => {
-        timeout = setTimeout(() => {
-            timedOut = true;
-            disposeSession(true);
-            resolve(fallback);
-        }, request.timeoutMs);
-    });
-    const run = (async () => {
-        try {
-            const [sdk, rotation] = await Promise.all([
-                import('@earendil-works/pi-coding-agent'),
-                import('../../builtin-pi-packages/pi-crtr-extensions/extensions/provider-rotation.js'),
-            ]);
-            if (timedOut)
-                return fallback;
-            const nodeCwd = envNodeCwd() ?? process.cwd();
-            const profileId = envProfileId();
-            const agentDir = sdk.getAgentDir();
-            const modelRuntime = await sdk.ModelRuntime.create({
-                credentials: new PoolCredentialStore(join(agentDir, 'auth.json')),
-                modelsPath: join(agentDir, 'models.json'),
-            });
-            if (timedOut)
-                return fallback;
-            const services = await sdk.createAgentSessionServices({
-                cwd: nodeCwd,
-                agentDir,
-                modelRuntime,
-                settingsManager: sdk.SettingsManager.inMemory(),
-                resourceLoaderOptions: {
-                    noExtensions: true,
-                    noContextFiles: true,
-                    noSkills: true,
-                    noPromptTemplates: true,
-                    noThemes: true,
-                    systemPrompt: request.systemPrompt,
-                    extensionFactories: [rotation.createProviderRotationExtension({
-                            modelIntent: request.modelIntent,
-                            nodeCwd,
-                            profileId,
-                        })],
-                },
-            });
-            if (timedOut)
-                return fallback;
-            const modelRequest = modelRequestFromConfig(request.modelSpec, request.modelIntent, false);
-            if (modelRequest === undefined)
-                return fallback;
-            const selected = selectInitialModelRoute(modelRequest, new sdk.ModelRegistry(services.modelRuntime), {
-                cwd: nodeCwd,
-                profileId,
-            }).selected;
-            if (selected === undefined)
-                return fallback;
-            let captured;
-            const tool = request.tool;
-            const customTool = tool === undefined ? undefined : sdk.defineTool({
-                name: tool.name,
-                label: tool.label,
-                description: tool.description,
-                parameters: tool.parameters,
-                ...(tool.constrainedSampling === undefined ? {} : { constrainedSampling: tool.constrainedSampling }),
-                async execute(_toolCallId, params) {
-                    captured = params;
-                    return {
-                        content: [{ type: 'text', text: 'Recorded.' }],
-                        details: { recorded: true },
-                        terminate: true,
-                    };
-                },
-            });
-            const sessionManager = sdk.SessionManager.inMemory(nodeCwd, request.sessionId === undefined ? undefined : { id: request.sessionId });
-            for (const message of request.seedMessages ?? []) {
-                sessionManager.appendMessage(message);
-            }
-            ({ session } = await sdk.createAgentSessionFromServices({
-                services,
-                sessionManager,
-                model: selected.model,
-                thinkingLevel: 'off',
-                ...(tool === undefined
-                    ? request.toolPolicy === 'builtin' ? {} : { noTools: 'all' }
-                    : { tools: [tool.name], customTools: [customTool] }),
-            }));
-            if (timedOut)
-                return fallback;
-            await session.bindExtensions({});
-            if (timedOut)
-                return fallback;
-            await session.prompt(request.userPrompt);
-            return timedOut ? fallback : collect(session, captured);
-        }
-        catch {
-            return fallback;
-        }
-        finally {
-            disposeSession(false);
-        }
-    })();
-    try {
-        return await Promise.race([run, deadline]);
-    }
-    finally {
-        clearTimeout(timeout);
-    }
-}
-/** Run a one-shot call whose only output channel is one structured tool call. */
-export function headlessToolCall(request) {
-    return runHeadless(request, null, (_session, captured) => captured);
-}
-/** Run a one-shot call and return the final assistant text. */
-export function headlessText(request) {
-    return runHeadless(request, '', (session) => lastAssistantText(session.messages));
-}
-/** Run a tool-capable, extension-free in-memory turn against seeded context. */
-export function headlessTurn(request) {
-    return runHeadless(request, 'failed', () => 'completed');
-}
+var A=Object.defineProperty;var d=(e,t)=>A(e,"name",{value:t,configurable:!0});import{envNodeCwd as j,envProfileId as F}from"../../shared/env.js";import{join as P}from"node:path";import{PoolCredentialStore as E}from"../pool-credential-store.js";import{modelRequestFromConfig as D,selectInitialModelRoute as L}from"../model-routes.js";function O(e){for(let t=e.length-1;t>=0;t--){const s=e[t];if(s?.role!=="assistant")continue;if(typeof s.content=="string")return s.content.trim();if(!Array.isArray(s.content))continue;const i=s.content.map(a=>{const o=a;return o.type==="text"&&typeof o.text=="string"?o.text:""}).join("").trim();if(i!=="")return i}return""}d(O,"lastAssistantText");async function c(e,t,s){let i,a=!1,o=!1,u;const f=d(n=>{i===void 0||a||(a=!0,n&&i.abort().catch(()=>{}),i.dispose())},"disposeSession"),T=new Promise(n=>{u=setTimeout(()=>{o=!0,f(!0),n(t)},e.timeoutMs)}),h=(async()=>{try{const[n,v]=await Promise.all([import("@earendil-works/pi-coding-agent"),import("../../builtin-pi-packages/pi-crtr-extensions/extensions/provider-rotation.js")]);if(o)return t;const l=j()??process.cwd(),p=F(),m=n.getAgentDir(),I=await n.ModelRuntime.create({credentials:new E(P(m,"auth.json")),modelsPath:P(m,"models.json")});if(o)return t;const g=await n.createAgentSessionServices({cwd:l,agentDir:m,modelRuntime:I,settingsManager:n.SettingsManager.inMemory(),resourceLoaderOptions:{noExtensions:!0,noContextFiles:!0,noSkills:!0,noPromptTemplates:!0,noThemes:!0,systemPrompt:e.systemPrompt,extensionFactories:[v.createProviderRotationExtension({modelIntent:e.modelIntent,nodeCwd:l,profileId:p})]}});if(o)return t;const y=D(e.modelSpec,e.modelIntent,!1);if(y===void 0)return t;const x=L(y,new n.ModelRegistry(g.modelRuntime),{cwd:l,profileId:p}).selected;if(x===void 0)return t;let w;const r=e.tool,R=r===void 0?void 0:n.defineTool({name:r.name,label:r.label,description:r.description,parameters:r.parameters,...r.constrainedSampling===void 0?{}:{constrainedSampling:r.constrainedSampling},async execute(M,C){return w=C,{content:[{type:"text",text:"Recorded."}],details:{recorded:!0},terminate:!0}}}),S=n.SessionManager.inMemory(l,e.sessionId===void 0?void 0:{id:e.sessionId});for(const M of e.seedMessages??[])S.appendMessage(M);return{session:i}=await n.createAgentSessionFromServices({services:g,sessionManager:S,model:x.model,thinkingLevel:"off",...r===void 0?e.toolPolicy==="builtin"?{}:{noTools:"all"}:{tools:[r.name],customTools:[R]}}),o||(await i.bindExtensions({}),o)?t:(await i.prompt(e.userPrompt),o?t:s(i,w))}catch{return t}finally{f(!1)}})();try{return await Promise.race([h,T])}finally{clearTimeout(u)}}d(c,"runHeadless");function G(e){return c(e,null,(t,s)=>s)}d(G,"headlessToolCall");function J(e){return c(e,"",t=>O(t.messages))}d(J,"headlessText");function K(e){return c(e,"failed",()=>"completed")}d(K,"headlessTurn");export{J as headlessText,G as headlessToolCall,K as headlessTurn};