@adhdev/daemon-core 0.8.78 → 0.8.80

package/dist/session-host/app-name.d.ts

@@ -1,5 +1,14 @@
 export declare const DEFAULT_SESSION_HOST_APP_NAME = "adhdev";
 export declare const DEFAULT_STANDALONE_SESSION_HOST_APP_NAME = "adhdev-standalone";
+export interface SessionHostAppNameResolution {
+    appName: string;
+    warning?: string;
+    source: 'default' | 'explicit' | 'reserved-standalone-fallback';
+}
+export declare function resolveSessionHostAppNameResolution(options?: {
+    standalone?: boolean;
+    env?: NodeJS.ProcessEnv;
+}): SessionHostAppNameResolution;
 export declare function resolveSessionHostAppName(options?: {
     standalone?: boolean;
     env?: NodeJS.ProcessEnv;

package/node_modules/@adhdev/session-host-core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adhdev/session-host-core",
-  "version": "0.8.78",
-  "description": "ADHDev local session host core — session registry, protocol, buffers",
+  "version": "0.8.80",
+  "description": "ADHDev local session host core \u2014 session registry, protocol, buffers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.8.78",
-  "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
+  "version": "0.8.80",
+  "description": "ADHDev daemon core \u2014 CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {

package/src/index.ts

@@ -266,7 +266,9 @@ export {
   DEFAULT_SESSION_HOST_APP_NAME,
   DEFAULT_STANDALONE_SESSION_HOST_APP_NAME,
   resolveSessionHostAppName,
+  resolveSessionHostAppNameResolution,
 } from './session-host/app-name.js';
+export type { SessionHostAppNameResolution } from './session-host/app-name.js';
 export { ensureSessionHostReady, listHostedCliRuntimes } from './session-host/runtime-support.js';
 export {
   getSessionHostRecoveryLabel,

package/src/session-host/app-name.ts

@@ -1,26 +1,48 @@
 export const DEFAULT_SESSION_HOST_APP_NAME = 'adhdev'
 export const DEFAULT_STANDALONE_SESSION_HOST_APP_NAME = 'adhdev-standalone'
 
-function validateStandaloneSessionHostAppName(explicit: string): void {
-  if (explicit !== DEFAULT_SESSION_HOST_APP_NAME) return
-  throw new Error(
-    `Standalone session-host namespace '${DEFAULT_SESSION_HOST_APP_NAME}' is reserved for the global daemon. `
-    + `Use '${DEFAULT_STANDALONE_SESSION_HOST_APP_NAME}' or another non-default namespace.`,
-  )
+export interface SessionHostAppNameResolution {
+  appName: string
+  warning?: string
+  source: 'default' | 'explicit' | 'reserved-standalone-fallback'
 }
 
-export function resolveSessionHostAppName(options: {
+function getReservedStandaloneNamespaceWarning(): string {
+  return `Standalone session-host namespace '${DEFAULT_SESSION_HOST_APP_NAME}' is reserved for the global daemon. `
+    + `Falling back to '${DEFAULT_STANDALONE_SESSION_HOST_APP_NAME}' for this standalone run.`
+}
+
+export function resolveSessionHostAppNameResolution(options: {
   standalone?: boolean
   env?: NodeJS.ProcessEnv
-} = {}): string {
+} = {}): SessionHostAppNameResolution {
   const env = options.env || process.env
   const explicit = typeof env.ADHDEV_SESSION_HOST_NAME === 'string'
     ? env.ADHDEV_SESSION_HOST_NAME.trim()
     : ''
 
   if (explicit) {
-    if (options.standalone) validateStandaloneSessionHostAppName(explicit)
-    return explicit
+    if (options.standalone && explicit === DEFAULT_SESSION_HOST_APP_NAME) {
+      return {
+        appName: DEFAULT_STANDALONE_SESSION_HOST_APP_NAME,
+        warning: getReservedStandaloneNamespaceWarning(),
+        source: 'reserved-standalone-fallback',
+      }
+    }
+    return {
+      appName: explicit,
+      source: 'explicit',
+    }
+  }
+  return {
+    appName: options.standalone ? DEFAULT_STANDALONE_SESSION_HOST_APP_NAME : DEFAULT_SESSION_HOST_APP_NAME,
+    source: 'default',
   }
-  return options.standalone ? DEFAULT_STANDALONE_SESSION_HOST_APP_NAME : DEFAULT_SESSION_HOST_APP_NAME
+}
+
+export function resolveSessionHostAppName(options: {
+  standalone?: boolean
+  env?: NodeJS.ProcessEnv
+} = {}): string {
+  return resolveSessionHostAppNameResolution(options).appName
 }