@codori/server 0.0.3 → 0.0.5

package/client-dist/_nuxt/builds/latest.json

@@ -1 +1 @@
-{"id":"5f4263d4-eac2-4ff0-9a82-eb8be28751d5","timestamp":1775888199612}
+{"id":"468a0ff2-bd27-45c6-bd89-5ac776d98662","timestamp":1776094853390}

package/client-dist/_nuxt/builds/meta/468a0ff2-bd27-45c6-bd89-5ac776d98662.json

@@ -0,0 +1 @@
+{"id":"468a0ff2-bd27-45c6-bd89-5ac776d98662","timestamp":1776094853390,"prerendered":[]}

package/client-dist/_nuxt/{ClvUKBzL.js → ecRbsnab.js}

@@ -1 +1 @@
-import{_ as o,u as s,o as a,d as i,a as t,t as r}from"./B9M-aXlQ.js";const u={class:"antialiased bg-white dark:bg-[#020420] dark:text-white font-sans grid min-h-screen overflow-hidden place-content-center text-[#020420] tracking-wide"},l={class:"max-w-520px text-center"},c=["textContent"],d=["textContent"],p=["textContent"],f={__name:"error-500",props:{appName:{type:String,default:"Nuxt"},status:{type:Number,default:500},statusText:{type:String,default:"Internal server error"},description:{type:String,default:"This page is temporarily unavailable."},refresh:{type:String,default:"Refresh this page"}},setup(e){const n=e;return s({title:`${n.status} - ${n.statusText} | ${n.appName}`,script:[{innerHTML:`!function(){const e=document.createElement("link").relList;if(!(e&&e.supports&&e.supports("modulepreload"))){for(const e of document.querySelectorAll('link[rel="modulepreload"]'))r(e);new MutationObserver(e=>{for(const o of e)if("childList"===o.type)for(const e of o.addedNodes)"LINK"===e.tagName&&"modulepreload"===e.rel&&r(e)}).observe(document,{childList:!0,subtree:!0})}function r(e){if(e.ep)return;e.ep=!0;const r=function(e){const r={};return e.integrity&&(r.integrity=e.integrity),e.referrerPolicy&&(r.referrerPolicy=e.referrerPolicy),"use-credentials"===e.crossOrigin?r.credentials="include":"anonymous"===e.crossOrigin?r.credentials="omit":r.credentials="same-origin",r}(e);fetch(e.href,r)}}();`}],style:[{innerHTML:'*,:after,:before{border-color:var(--un-default-border-color,#e5e7eb);border-style:solid;border-width:0;box-sizing:border-box}:after,:before{--un-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-feature-settings:normal;font-variation-settings:normal;-moz-tab-size:4;tab-size:4;-webkit-tap-highlight-color:transparent}body{line-height:inherit;margin:0}h1,h2{font-size:inherit;font-weight:inherit}h1,h2,p{margin:0}*,:after,:before{--un-rotate:0;--un-rotate-x:0;--un-rotate-y:0;--un-rotate-z:0;--un-scale-x:1;--un-scale-y:1;--un-scale-z:1;--un-skew-x:0;--un-skew-y:0;--un-translate-x:0;--un-translate-y:0;--un-translate-z:0;--un-pan-x: ;--un-pan-y: ;--un-pinch-zoom: ;--un-scroll-snap-strictness:proximity;--un-ordinal: ;--un-slashed-zero: ;--un-numeric-figure: ;--un-numeric-spacing: ;--un-numeric-fraction: ;--un-border-spacing-x:0;--un-border-spacing-y:0;--un-ring-offset-shadow:0 0 transparent;--un-ring-shadow:0 0 transparent;--un-shadow-inset: ;--un-shadow:0 0 transparent;--un-ring-inset: ;--un-ring-offset-width:0px;--un-ring-offset-color:#fff;--un-ring-width:0px;--un-ring-color:rgba(147,197,253,.5);--un-blur: ;--un-brightness: ;--un-contrast: ;--un-drop-shadow: ;--un-grayscale: ;--un-hue-rotate: ;--un-invert: ;--un-saturate: ;--un-sepia: ;--un-backdrop-blur: ;--un-backdrop-brightness: ;--un-backdrop-contrast: ;--un-backdrop-grayscale: ;--un-backdrop-hue-rotate: ;--un-backdrop-invert: ;--un-backdrop-opacity: ;--un-backdrop-saturate: ;--un-backdrop-sepia: }'}]}),(h,m)=>(a(),i("div",u,[t("div",l,[t("h1",{class:"font-semibold leading-none mb-4 sm:text-[110px] tabular-nums text-[80px]",textContent:r(e.status)},null,8,c),t("h2",{class:"font-semibold mb-2 sm:text-3xl text-2xl",textContent:r(e.statusText)},null,8,d),t("p",{class:"mb-4 px-2 text-[#64748B] text-md",textContent:r(e.description)},null,8,p)])]))}},g=o(f,[["__scopeId","data-v-a8fa9b54"]]);export{g as default};
+import{_ as o,u as s,o as a,d as i,a as t,t as r}from"./OylMiRf9.js";const u={class:"antialiased bg-white dark:bg-[#020420] dark:text-white font-sans grid min-h-screen overflow-hidden place-content-center text-[#020420] tracking-wide"},l={class:"max-w-520px text-center"},c=["textContent"],d=["textContent"],p=["textContent"],f={__name:"error-500",props:{appName:{type:String,default:"Nuxt"},status:{type:Number,default:500},statusText:{type:String,default:"Internal server error"},description:{type:String,default:"This page is temporarily unavailable."},refresh:{type:String,default:"Refresh this page"}},setup(e){const n=e;return s({title:`${n.status} - ${n.statusText} | ${n.appName}`,script:[{innerHTML:`!function(){const e=document.createElement("link").relList;if(!(e&&e.supports&&e.supports("modulepreload"))){for(const e of document.querySelectorAll('link[rel="modulepreload"]'))r(e);new MutationObserver(e=>{for(const o of e)if("childList"===o.type)for(const e of o.addedNodes)"LINK"===e.tagName&&"modulepreload"===e.rel&&r(e)}).observe(document,{childList:!0,subtree:!0})}function r(e){if(e.ep)return;e.ep=!0;const r=function(e){const r={};return e.integrity&&(r.integrity=e.integrity),e.referrerPolicy&&(r.referrerPolicy=e.referrerPolicy),"use-credentials"===e.crossOrigin?r.credentials="include":"anonymous"===e.crossOrigin?r.credentials="omit":r.credentials="same-origin",r}(e);fetch(e.href,r)}}();`}],style:[{innerHTML:'*,:after,:before{border-color:var(--un-default-border-color,#e5e7eb);border-style:solid;border-width:0;box-sizing:border-box}:after,:before{--un-content:""}html{line-height:1.5;-webkit-text-size-adjust:100%;font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-feature-settings:normal;font-variation-settings:normal;-moz-tab-size:4;tab-size:4;-webkit-tap-highlight-color:transparent}body{line-height:inherit;margin:0}h1,h2{font-size:inherit;font-weight:inherit}h1,h2,p{margin:0}*,:after,:before{--un-rotate:0;--un-rotate-x:0;--un-rotate-y:0;--un-rotate-z:0;--un-scale-x:1;--un-scale-y:1;--un-scale-z:1;--un-skew-x:0;--un-skew-y:0;--un-translate-x:0;--un-translate-y:0;--un-translate-z:0;--un-pan-x: ;--un-pan-y: ;--un-pinch-zoom: ;--un-scroll-snap-strictness:proximity;--un-ordinal: ;--un-slashed-zero: ;--un-numeric-figure: ;--un-numeric-spacing: ;--un-numeric-fraction: ;--un-border-spacing-x:0;--un-border-spacing-y:0;--un-ring-offset-shadow:0 0 transparent;--un-ring-shadow:0 0 transparent;--un-shadow-inset: ;--un-shadow:0 0 transparent;--un-ring-inset: ;--un-ring-offset-width:0px;--un-ring-offset-color:#fff;--un-ring-width:0px;--un-ring-color:rgba(147,197,253,.5);--un-blur: ;--un-brightness: ;--un-contrast: ;--un-drop-shadow: ;--un-grayscale: ;--un-hue-rotate: ;--un-invert: ;--un-saturate: ;--un-sepia: ;--un-backdrop-blur: ;--un-backdrop-brightness: ;--un-backdrop-contrast: ;--un-backdrop-grayscale: ;--un-backdrop-hue-rotate: ;--un-backdrop-invert: ;--un-backdrop-opacity: ;--un-backdrop-saturate: ;--un-backdrop-sepia: }'}]}),(h,m)=>(a(),i("div",u,[t("div",l,[t("h1",{class:"font-semibold leading-none mb-4 sm:text-[110px] tabular-nums text-[80px]",textContent:r(e.status)},null,8,c),t("h2",{class:"font-semibold mb-2 sm:text-3xl text-2xl",textContent:r(e.statusText)},null,8,d),t("p",{class:"mb-4 px-2 text-[#64748B] text-md",textContent:r(e.description)},null,8,p)])]))}},g=o(f,[["__scopeId","data-v-a8fa9b54"]]);export{g as default};

package/client-dist/index.html

@@ -1 +1 @@
-<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="stylesheet" href="/_nuxt/entry.BFUss7SH.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/_nuxt/B9M-aXlQ.js"><script type="module" src="/_nuxt/B9M-aXlQ.js" crossorigin></script><script>"use strict";(()=>{const t=window,e=document.documentElement,c=["dark","light"],n=getStorageValue("localStorage","nuxt-color-mode")||"system";let i=n==="system"?u():n;const r=e.getAttribute("data-color-mode-forced");r&&(i=r),l(i),t["__NUXT_COLOR_MODE__"]={preference:n,value:i,getColorScheme:u,addColorScheme:l,removeColorScheme:d};function l(o){const s=""+o+"",a="";e.classList?e.classList.add(s):e.className+=" "+s,a&&e.setAttribute("data-"+a,o)}function d(o){const s=""+o+"",a="";e.classList?e.classList.remove(s):e.className=e.className.replace(new RegExp(s,"g"),""),a&&e.removeAttribute("data-"+a)}function f(o){return t.matchMedia("(prefers-color-scheme"+o+")")}function u(){if(t.matchMedia&&f("").media!=="not all"){for(const o of c)if(f(":"+o).matches)return o}return"light"}})();function getStorageValue(t,e){switch(t){case"localStorage":return window.localStorage.getItem(e);case"sessionStorage":return window.sessionStorage.getItem(e);case"cookie":return getCookie(e);default:return null}}function getCookie(t){const c=("; "+window.document.cookie).split("; "+t+"=");if(c.length===2)return c.pop()?.split(";").shift()}</script></head><body><div id="__nuxt" class="isolate"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{serverBase:"",serverWsBase:""},app:{baseURL:"/",buildId:"5f4263d4-eac2-4ff0-9a82-eb8be28751d5",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1775888214387,false]</script></body></html>
+<!DOCTYPE html><html><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><link rel="stylesheet" href="/_nuxt/entry.BFUss7SH.css" crossorigin><link rel="modulepreload" as="script" crossorigin href="/_nuxt/OylMiRf9.js"><script type="module" src="/_nuxt/OylMiRf9.js" crossorigin></script><script>"use strict";(()=>{const t=window,e=document.documentElement,c=["dark","light"],n=getStorageValue("localStorage","nuxt-color-mode")||"system";let i=n==="system"?u():n;const r=e.getAttribute("data-color-mode-forced");r&&(i=r),l(i),t["__NUXT_COLOR_MODE__"]={preference:n,value:i,getColorScheme:u,addColorScheme:l,removeColorScheme:d};function l(o){const s=""+o+"",a="";e.classList?e.classList.add(s):e.className+=" "+s,a&&e.setAttribute("data-"+a,o)}function d(o){const s=""+o+"",a="";e.classList?e.classList.remove(s):e.className=e.className.replace(new RegExp(s,"g"),""),a&&e.removeAttribute("data-"+a)}function f(o){return t.matchMedia("(prefers-color-scheme"+o+")")}function u(){if(t.matchMedia&&f("").media!=="not all"){for(const o of c)if(f(":"+o).matches)return o}return"light"}})();function getStorageValue(t,e){switch(t){case"localStorage":return window.localStorage.getItem(e);case"sessionStorage":return window.sessionStorage.getItem(e);case"cookie":return getCookie(e);default:return null}}function getCookie(t){const c=("; "+window.document.cookie).split("; "+t+"=");if(c.length===2)return c.pop()?.split(";").shift()}</script></head><body><div id="__nuxt" class="isolate"></div><div id="teleports"></div><script>window.__NUXT__={};window.__NUXT__.config={public:{serverBase:"",serverWsBase:""},app:{baseURL:"/",buildId:"468a0ff2-bd27-45c6-bd89-5ac776d98662",buildAssetsDir:"/_nuxt/",cdnURL:""}}</script><script type="application/json" data-nuxt-data="nuxt-app" data-ssr="false" id="__NUXT_DATA__">[{"prerenderedAt":1,"serverRendered":2},1776094868508,false]</script></body></html>

package/dist/cli.d.ts

@@ -1,2 +1,6 @@
 #!/usr/bin/env node
-export {};
+import { type ServiceCommandDependencies } from './service.js';
+export declare const CLI_USAGE: string;
+export declare const resolveCliEntrypointPath: (value: string | undefined) => string | null;
+export declare const isCliEntrypointPath: (argvPath: string | undefined, moduleUrl: string) => boolean;
+export declare const runCli: (argv?: string[], dependencies?: ServiceCommandDependencies) => Promise<void>;

package/dist/cli.js

@@ -1,8 +1,12 @@
 #!/usr/bin/env node
+import { realpathSync } from 'node:fs';
+import { resolve as resolvePath } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { parseArgs } from 'node:util';
 import { asErrorMessage, CodoriError } from './errors.js';
 import { startHttpServer } from './http-server.js';
 import { createRuntimeManager } from './process-manager.js';
+import { installService, restartService, uninstallService } from './service.js';
 const printJson = (value) => {
     process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
 };
@@ -35,6 +39,16 @@ const optionConfig = {
     },
     json: {
         type: 'boolean'
+    },
+    scope: {
+        type: 'string'
+    },
+    yes: {
+        type: 'boolean'
+    },
+    help: {
+        type: 'boolean',
+        short: 'h'
     }
 };
 const coercePort = (value) => {
@@ -45,22 +59,125 @@ const coercePort = (value) => {
     return Number.isFinite(parsed) ? parsed : undefined;
 };
 const resolveCliRoot = (value) => value ?? process.cwd();
-const main = async () => {
+export const CLI_USAGE = [
+    'Usage:',
+    '  npx @codori/server <command> [projectId] [options]',
+    '  codori <command> [projectId] [options]',
+    '',
+    'Runtime commands:',
+    '  serve',
+    '  list',
+    '  status [projectId]',
+    '  start <projectId>',
+    '  stop <projectId>',
+    '',
+    'Service commands:',
+    '  install-service',
+    '  setup-service',
+    '  restart-service',
+    '  uninstall-service',
+    '',
+    'Options:',
+    '  --root <path>',
+    '  --host <host>',
+    '  --port <port>',
+    '  --scope <user|system>',
+    '  --yes',
+    '  --json',
+    '  --help',
+    '',
+    'Canonical service examples:',
+    '  npx @codori/server install-service',
+    '  npx @codori/server restart-service --root ~/Project/codori',
+    '  npx @codori/server uninstall-service --root ~/Project/codori',
+    '',
+    'Installed binary examples:',
+    '  codori install-service',
+    '  codori restart-service --root ~/Project/codori'
+].join('\n');
+const printUsage = (stdout = process.stdout) => {
+    stdout.write(`${CLI_USAGE}\n`);
+};
+export const resolveCliEntrypointPath = (value) => {
+    if (!value) {
+        return null;
+    }
+    const resolved = resolvePath(value);
+    try {
+        return realpathSync(resolved);
+    }
+    catch {
+        return resolved;
+    }
+};
+export const isCliEntrypointPath = (argvPath, moduleUrl) => {
+    const entryPath = resolveCliEntrypointPath(argvPath);
+    const modulePath = resolveCliEntrypointPath(fileURLToPath(moduleUrl));
+    return entryPath !== null && entryPath === modulePath;
+};
+const executeServiceCommand = async (command, values, dependencies = {}) => {
+    const stdout = dependencies.stdout ?? process.stdout;
+    const options = {
+        root: values.root,
+        host: values.host,
+        port: values.port,
+        scope: values.scope,
+        yes: values.yes ?? false
+    };
+    switch (command) {
+        case 'install-service':
+        case 'setup-service': {
+            const result = await installService(options, dependencies);
+            stdout.write(`Installed service ${result.metadata.serviceName}\n`);
+            return;
+        }
+        case 'restart-service': {
+            const result = await restartService({
+                root: values.root,
+                scope: values.scope,
+                yes: values.yes ?? false
+            }, dependencies);
+            stdout.write(`Restarted service ${result.metadata.serviceName}\n`);
+            return;
+        }
+        case 'uninstall-service': {
+            const result = await uninstallService({
+                root: values.root,
+                yes: values.yes ?? false
+            }, dependencies);
+            stdout.write(`Removed service ${result.metadata.serviceName}\n`);
+        }
+    }
+};
+export const runCli = async (argv = process.argv.slice(2), dependencies = {}) => {
     const parsed = parseArgs({
+        args: argv,
         allowPositionals: true,
         options: optionConfig
     });
+    const values = parsed.values;
     const [command = 'serve', maybeProjectId] = parsed.positionals;
-    const manager = createRuntimeManager({
-        configOverrides: {
-            root: resolveCliRoot(parsed.values.root),
-            host: parsed.values.host,
-            port: coercePort(parsed.values.port)
-        }
-    });
-    const json = parsed.values.json ?? false;
+    if (values.help) {
+        printUsage(dependencies.stdout ?? process.stdout);
+        return;
+    }
+    if (command === 'install-service'
+        || command === 'setup-service'
+        || command === 'restart-service'
+        || command === 'uninstall-service') {
+        await executeServiceCommand(command, values, dependencies);
+        return;
+    }
     switch (command) {
         case 'list': {
+            const manager = createRuntimeManager({
+                configOverrides: {
+                    root: resolveCliRoot(values.root),
+                    host: values.host,
+                    port: coercePort(values.port)
+                }
+            });
+            const json = values.json ?? false;
             const statuses = manager.listProjectStatuses();
             if (json) {
                 printJson(statuses);
@@ -71,6 +188,14 @@ const main = async () => {
             return;
         }
         case 'status': {
+            const manager = createRuntimeManager({
+                configOverrides: {
+                    root: resolveCliRoot(values.root),
+                    host: values.host,
+                    port: coercePort(values.port)
+                }
+            });
+            const json = values.json ?? false;
             if (maybeProjectId) {
                 const status = manager.getProjectStatus(maybeProjectId);
                 if (json) {
@@ -91,6 +216,14 @@ const main = async () => {
             return;
         }
         case 'start': {
+            const manager = createRuntimeManager({
+                configOverrides: {
+                    root: resolveCliRoot(values.root),
+                    host: values.host,
+                    port: coercePort(values.port)
+                }
+            });
+            const json = values.json ?? false;
             if (!maybeProjectId) {
                 throw new CodoriError('MISSING_PROJECT_ID', 'The start command requires a project id.');
             }
@@ -104,6 +237,14 @@ const main = async () => {
             return;
         }
         case 'stop': {
+            const manager = createRuntimeManager({
+                configOverrides: {
+                    root: resolveCliRoot(values.root),
+                    host: values.host,
+                    port: coercePort(values.port)
+                }
+            });
+            const json = values.json ?? false;
             if (!maybeProjectId) {
                 throw new CodoriError('MISSING_PROJECT_ID', 'The stop command requires a project id.');
             }
@@ -117,22 +258,33 @@ const main = async () => {
             return;
         }
         case 'serve': {
+            const manager = createRuntimeManager({
+                configOverrides: {
+                    root: resolveCliRoot(values.root),
+                    host: values.host,
+                    port: coercePort(values.port)
+                }
+            });
             const app = await startHttpServer(manager);
             process.stdout.write(`Running codori server with project root directory: ${manager.config.root}\n`);
             process.stdout.write(`Codori listening on http://${manager.config.server.host}:${manager.config.server.port}\n`);
+            process.stdout.write('Private tunnel is not included. Expose Codori through your own network layer such as Tailscale or Cloudflare Tunnel when you need remote access.\n');
             await app.ready();
             return;
         }
         default:
-            process.stdout.write('Usage: npx @codori/server [serve|list|status|start|stop] [projectId] --root <path> [--host <host>] [--port <port>] [--json]\n');
+            printUsage(dependencies.stdout ?? process.stdout);
     }
 };
-void main().catch((error) => {
-    if (error instanceof CodoriError) {
-        process.stderr.write(`${error.code}: ${error.message}\n`);
-    }
-    else {
-        process.stderr.write(`${asErrorMessage(error)}\n`);
-    }
-    process.exitCode = 1;
-});
+const isEntrypoint = isCliEntrypointPath(process.argv[1], import.meta.url);
+if (isEntrypoint) {
+    void runCli().catch((error) => {
+        if (error instanceof CodoriError) {
+            process.stderr.write(`${error.code}: ${error.message}\n`);
+        }
+        else {
+            process.stderr.write(`${asErrorMessage(error)}\n`);
+        }
+        process.exitCode = 1;
+    });
+}

package/dist/config.d.ts

@@ -1,4 +1,6 @@
 import type { CodoriConfig, ConfigOverrides } from './types.js';
+export declare const DEFAULT_SERVER_HOST = "127.0.0.1";
+export declare const DEFAULT_SERVER_PORT = 4310;
 export declare const resolveCodoriHome: (homeDir?: string) => string;
 export declare const resolveCodoriConfigPath: (homeDir?: string) => string;
 export declare const ensureCodoriDirectories: (homeDir?: string) => {

package/dist/config.js

@@ -2,10 +2,12 @@ import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import os from 'node:os';
 import { join, resolve } from 'node:path';
 import { CodoriError } from './errors.js';
-const DEFAULT_SERVER_HOST = '127.0.0.1';
-const DEFAULT_SERVER_PORT = 4310;
+export const DEFAULT_SERVER_HOST = '127.0.0.1';
+export const DEFAULT_SERVER_PORT = 4310;
 const DEFAULT_PORT_START = 46000;
 const DEFAULT_PORT_END = 46999;
+const DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1000;
+const DEFAULT_IDLE_SWEEP_INTERVAL_MS = 60 * 1000;
 const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
 export const resolveCodoriHome = (homeDir = os.homedir()) => join(homeDir, '.codori');
 export const resolveCodoriConfigPath = (homeDir = os.homedir()) => join(resolveCodoriHome(homeDir), 'config.json');
@@ -41,6 +43,18 @@ const ensureValidPort = (value, label) => {
     }
     return value;
 };
+const ensureValidDurationMs = (value, label) => {
+    if (typeof value !== 'number' || !Number.isInteger(value) || value <= 0) {
+        throw new CodoriError('INVALID_CONFIG', `${label} must be a positive integer in milliseconds.`);
+    }
+    return value;
+};
+const ensureValidBoolean = (value, label) => {
+    if (typeof value !== 'boolean') {
+        throw new CodoriError('INVALID_CONFIG', `${label} must be a boolean.`);
+    }
+    return value;
+};
 export const resolveConfig = (overrides = {}, homeDir = os.homedir()) => {
     const fileConfig = loadUserConfig(homeDir);
     const root = overrides.root ?? fileConfig.root;
@@ -62,6 +76,11 @@ export const resolveConfig = (overrides = {}, homeDir = os.homedir()) => {
     const resolvedPort = ensureValidPort(port, 'server.port');
     const resolvedPortStart = ensureValidPort(portStart, 'ports.start');
     const resolvedPortEnd = ensureValidPort(portEnd, 'ports.end');
+    const idleShutdownEnabled = ensureValidBoolean(overrides.idleShutdownEnabled ?? fileConfig.idleShutdown?.enabled ?? true, 'idleShutdown.enabled');
+    const idleShutdownTimeoutMs = ensureValidDurationMs(overrides.idleShutdownTimeoutMs ?? fileConfig.idleShutdown?.timeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS, 'idleShutdown.timeoutMs');
+    const idleShutdownSweepIntervalMs = ensureValidDurationMs(overrides.idleShutdownSweepIntervalMs
+        ?? fileConfig.idleShutdown?.sweepIntervalMs
+        ?? DEFAULT_IDLE_SWEEP_INTERVAL_MS, 'idleShutdown.sweepIntervalMs');
     if (resolvedPortStart > resolvedPortEnd) {
         throw new CodoriError('INVALID_CONFIG', 'ports.start must be less than or equal to ports.end.');
     }
@@ -75,6 +94,11 @@ export const resolveConfig = (overrides = {}, homeDir = os.homedir()) => {
         ports: {
             start: resolvedPortStart,
             end: resolvedPortEnd
+        },
+        idleShutdown: {
+            enabled: idleShutdownEnabled,
+            timeoutMs: idleShutdownTimeoutMs,
+            sweepIntervalMs: idleShutdownSweepIntervalMs
         }
     };
 };

package/dist/http-server.d.ts

@@ -1,4 +1,5 @@
 import Fastify, { type FastifyInstance } from 'fastify';
+import { type ServiceUpdateController } from './service-update.js';
 import type { ProjectStatusRecord, StartProjectResult } from './types.js';
 type MaybePromise<T> = T | Promise<T>;
 export type RuntimeManagerLike = {
@@ -6,6 +7,12 @@ export type RuntimeManagerLike = {
     getProjectStatus: (projectId: string) => MaybePromise<ProjectStatusRecord>;
     startProject: (projectId: string) => MaybePromise<StartProjectResult>;
     stopProject: (projectId: string) => MaybePromise<ProjectStatusRecord>;
+    noteProjectActivity?: (projectId: string) => MaybePromise<ProjectStatusRecord | void>;
+    acquireProjectSession?: (projectId: string) => {
+        touchActivity?: (at?: number) => MaybePromise<ProjectStatusRecord | void>;
+        release: () => void;
+    };
+    dispose?: () => MaybePromise<void>;
     config?: {
         server: {
             host: string;
@@ -16,6 +23,7 @@ export type RuntimeManagerLike = {
 export type HttpServerOptions = {
     clientBundleDir?: string | null;
     attachmentsRootDir?: string | null;
+    serviceUpdateController?: ServiceUpdateController | null;
 };
 export declare const createHttpServer: (manager: RuntimeManagerLike, options?: HttpServerOptions) => Promise<FastifyInstance>;
 export declare const startHttpServer: (manager?: import("./process-manager.js").RuntimeManager) => Promise<Fastify.FastifyInstance<Fastify.RawServerDefault, import("http").IncomingMessage, import("http").ServerResponse<import("http").IncomingMessage>, Fastify.FastifyBaseLogger, Fastify.FastifyTypeProviderDefault>>;

package/dist/http-server.js

@@ -12,6 +12,7 @@ import WebSocket from 'ws';
 import { isPathInsideDirectory, persistThreadAttachmentStream, readAttachmentMetadata, resolveProjectAttachmentsDir } from './attachment-store.js';
 import { CodoriError } from './errors.js';
 import { createRuntimeManager } from './process-manager.js';
+import { createServiceUpdateController } from './service-update.js';
 const isCodoriError = (error) => error instanceof CodoriError;
 const resolveBundledClientDir = () => {
     const candidates = [
@@ -39,6 +40,9 @@ const toStatusCode = (error) => {
         case 'INVALID_ATTACHMENT':
         case 'MISSING_ROOT':
             return 400;
+        case 'SERVICE_UPDATE_UNAVAILABLE':
+        case 'SERVICE_UPDATE_IN_PROGRESS':
+            return 409;
         default:
             return 500;
     }
@@ -68,6 +72,18 @@ const normalizeImageMediaType = (input) => {
     }
     return null;
 };
+const touchProjectActivity = async (manager, projectId) => {
+    if (!manager.noteProjectActivity) {
+        return;
+    }
+    await resolveValue(manager.noteProjectActivity(projectId));
+};
+const touchProjectActivityInBackground = (manager, projectId, session) => {
+    const task = session?.touchActivity
+        ? resolveValue(session.touchActivity())
+        : touchProjectActivity(manager, projectId);
+    void task.catch(() => { });
+};
 const wait = async (ms) => new Promise((resolvePromise) => {
     setTimeout(resolvePromise, ms);
 });
@@ -101,9 +117,13 @@ export const createHttpServer = async (manager, options = {}) => {
     const app = Fastify({
         logger: false
     });
+    app.addHook('onClose', async () => {
+        await resolveValue(manager.dispose?.());
+    });
     const clientBundleDir = options.clientBundleDir === undefined
         ? resolveBundledClientDir()
         : options.clientBundleDir;
+    const serviceUpdateController = options.serviceUpdateController ?? null;
     await app.register(multipart, {
         limits: {
             files: MAX_ATTACHMENTS_PER_MESSAGE,
@@ -147,6 +167,26 @@ export const createHttpServer = async (manager, options = {}) => {
     app.get('/api/projects', async () => ({
         projects: await resolveValue(manager.listProjectStatuses())
     }));
+    app.get('/api/service/update', async () => ({
+        serviceUpdate: serviceUpdateController
+            ? await serviceUpdateController.getStatus()
+            : {
+                enabled: false,
+                updateAvailable: false,
+                updating: false,
+                installedVersion: null,
+                latestVersion: null
+            }
+    }));
+    app.post('/api/service/update', async (_request, reply) => {
+        if (!serviceUpdateController) {
+            throw new CodoriError('SERVICE_UPDATE_UNAVAILABLE', 'Self-update is only available while Codori is running as a registered service.');
+        }
+        reply.status(202);
+        return {
+            serviceUpdate: await serviceUpdateController.requestUpdate()
+        };
+    });
     app.get('/api/projects/:projectId', async (request) => ({
         project: await resolveValue(manager.getProjectStatus(getProjectIdFromRequest(request.params.projectId)))
     }));
@@ -162,6 +202,7 @@ export const createHttpServer = async (manager, options = {}) => {
     app.post('/api/projects/:projectId/attachments', async (request, reply) => {
         const projectId = getProjectIdFromRequest(request.params.projectId);
         const project = await resolveValue(manager.getProjectStatus(projectId));
+        await touchProjectActivity(manager, projectId);
         const files = [];
         let threadId = null;
         for await (const part of request.parts()) {
@@ -212,6 +253,7 @@ export const createHttpServer = async (manager, options = {}) => {
             throw new CodoriError('INVALID_ATTACHMENT', 'Missing attachment path.');
         }
         const project = await resolveValue(manager.getProjectStatus(projectId));
+        await touchProjectActivity(manager, projectId);
         const allowedRoot = resolveProjectAttachmentsDir(project.projectPath, options.attachmentsRootDir);
         const resolvedPath = resolve(requestedPath);
         if (!isPathInsideDirectory(resolvedPath, allowedRoot)) {
@@ -270,7 +312,16 @@ export const createHttpServer = async (manager, options = {}) => {
     app.get('/api/projects/:projectId/rpc', { websocket: true }, async (clientSocket, request) => {
         const projectId = getProjectIdFromRequest(request.params.projectId);
         const pendingClientMessages = [];
+        const session = manager.acquireProjectSession?.(projectId) ?? null;
         let upstream = null;
+        let sessionReleased = false;
+        const releaseSession = () => {
+            if (sessionReleased) {
+                return;
+            }
+            sessionReleased = true;
+            session?.release();
+        };
         const closeBoth = (code = 1011, reason = 'proxy error') => {
             if (clientSocket.readyState === clientSocket.OPEN || clientSocket.readyState === clientSocket.CONNECTING) {
                 clientSocket.close(code, reason);
@@ -280,6 +331,7 @@ export const createHttpServer = async (manager, options = {}) => {
             }
         };
         clientSocket.on('message', (message, isBinary) => {
+            touchProjectActivityInBackground(manager, projectId, session);
             if (upstream?.readyState === WebSocket.OPEN) {
                 upstream.send(message, { binary: isBinary });
                 return;
@@ -290,6 +342,7 @@ export const createHttpServer = async (manager, options = {}) => {
             closeBoth(1011, 'client websocket failed');
         });
         clientSocket.on('close', () => {
+            releaseSession();
             if (upstream && (upstream.readyState === WebSocket.OPEN || upstream.readyState === WebSocket.CONNECTING)) {
                 upstream.close();
             }
@@ -312,6 +365,7 @@ export const createHttpServer = async (manager, options = {}) => {
                 }
             });
             upstream.on('message', (message, isBinary) => {
+                touchProjectActivityInBackground(manager, projectId, session);
                 clientSocket.send(message, { binary: isBinary });
             });
             upstream.on('error', () => {
@@ -360,10 +414,14 @@ export const createHttpServer = async (manager, options = {}) => {
     return app;
 };
 export const startHttpServer = async (manager = createRuntimeManager()) => {
-    const app = await createHttpServer(manager);
     if (!manager.config) {
         throw new CodoriError('INVALID_CONFIG', 'Manager config is required to start the HTTP server.');
     }
+    const app = await createHttpServer(manager, {
+        serviceUpdateController: createServiceUpdateController({
+            root: manager.config.root
+        })
+    });
     await app.listen({
         host: manager.config.server.host,
         port: manager.config.server.port

package/dist/index.d.ts

@@ -4,5 +4,8 @@ export { createHttpServer, startHttpServer } from './http-server.js';
 export { findAvailablePort } from './ports.js';
 export { createRuntimeManager, RuntimeManager } from './process-manager.js';
 export { scanProjects } from './project-scanner.js';
+export * from './service-adapters.js';
+export * from './service-update.js';
 export { RuntimeStore } from './runtime-store.js';
+export * from './service.js';
 export type * from './types.js';

package/dist/index.js

@@ -4,4 +4,7 @@ export { createHttpServer, startHttpServer } from './http-server.js';
 export { findAvailablePort } from './ports.js';
 export { createRuntimeManager, RuntimeManager } from './process-manager.js';
 export { scanProjects } from './project-scanner.js';
+export * from './service-adapters.js';
+export * from './service-update.js';
 export { RuntimeStore } from './runtime-store.js';
+export * from './service.js';

package/dist/process-manager.d.ts

@@ -4,6 +4,10 @@ type CommandFactory = (port: number, project: ProjectRecord) => {
     command: string;
     args: string[];
 };
+type ProjectSessionLease = {
+    touchActivity: (at?: number) => ProjectStatusRecord;
+    release: () => void;
+};
 type RuntimeManagerOptions = {
     homeDir?: string;
     configOverrides?: ConfigOverrides;
@@ -14,15 +18,30 @@ export declare class RuntimeManager {
     readonly config: CodoriConfig;
     readonly store: RuntimeStore;
     private readonly commandFactory;
+    private readonly activeSessions;
+    private idleReaper;
+    private idleSweepInFlight;
     constructor(options?: RuntimeManagerOptions);
     listProjects(): ProjectRecord[];
     private resolveProject;
     private normalizeStatus;
+    private getActiveSessionCount;
+    private resolveIdleDeadline;
+    private writeRuntime;
+    private touchRuntimeRecord;
+    private incrementActiveSessions;
+    private decrementActiveSessions;
+    private loadActiveRuntime;
     private readRunningRuntime;
+    private touchProjectRuntime;
+    noteProjectActivity(projectId: string, at?: number): ProjectStatusRecord;
+    acquireProjectSession(projectId: string): ProjectSessionLease;
     listProjectStatuses(): ProjectStatusRecord[];
     getProjectStatus(projectId: string): ProjectStatusRecord;
     startProject(projectId: string): Promise<StartProjectResult>;
     stopProject(projectId: string): Promise<ProjectStatusRecord>;
+    reapIdleRuntimes(): Promise<number>;
+    dispose(): void;
 }
 export declare const createRuntimeManager: (options?: RuntimeManagerOptions) => RuntimeManager;
 export {};