@karmaniverous/jeeves-server 3.3.0 → 3.3.1

package/CHANGELOG.md

@@ -2,10 +2,20 @@
 
 All notable changes to this project will be documented in this file. Dates are displayed in UTC.
 
-#### [3.3.0](https://github.com/karmaniverous/jeeves-server/compare/service/3.2.1...3.3.0)
+#### [3.3.1](https://github.com/karmaniverous/jeeves-server/compare/service/3.3.0...3.3.1)
+
+- Add configurable host bind + metaUrl service probe [`#114`](https://github.com/karmaniverous/jeeves-server/pull/114)
+- chore: release @karmaniverous/jeeves-server-openclaw v0.4.0 [`566e438`](https://github.com/karmaniverous/jeeves-server/commit/566e438a5262e5f2e80db4690c9907b6658e5519)
+- [113] feat: add host bind and metaUrl config options [`798d133`](https://github.com/karmaniverous/jeeves-server/commit/798d133825f99f5a5fc19bb0ba9093b757f62f0f)
+- npm audit fix [`a07adac`](https://github.com/karmaniverous/jeeves-server/commit/a07adac906ca032bedeef25b16b9e0c05231b4b0)
+
+#### [service/3.3.0](https://github.com/karmaniverous/jeeves-server/compare/service/3.2.1...service/3.3.0)
+
+> 21 March 2026
 
 - feat: core v0.2.0 SDK adoption [`#111`](https://github.com/karmaniverous/jeeves-server/pull/111)
 - chore: release @karmaniverous/jeeves-server-openclaw v0.3.1 [`11309c1`](https://github.com/karmaniverous/jeeves-server/commit/11309c1c3d82f6950b3d0291546206b523df83fa)
+- chore: release @karmaniverous/jeeves-server v3.3.0 [`1b1aec6`](https://github.com/karmaniverous/jeeves-server/commit/1b1aec644106ce05576e608d278a37860a47de61)
 
 #### [service/3.2.1](https://github.com/karmaniverous/jeeves-server/compare/service/3.2.0...service/3.2.1)
 

package/dist/src/cli/commands/config.js

@@ -20,6 +20,7 @@ export function registerConfigCommand(cli) {
             const cfg = await loadConfig(options.config);
             console.log('\u2713 Configuration valid');
             console.log(`  Port: ${String(cfg.port)}`);
+            console.log(`  Host: ${cfg.host}`);
             console.log(`  Auth modes: ${cfg.authModes.join(', ')}`);
             console.log(`  Keys: ${String(cfg.resolvedKeys.length)}`);
             console.log(`  Insiders: ${String(cfg.resolvedInsiders.length)}`);
@@ -28,6 +29,8 @@ export function registerConfigCommand(cli) {
                 console.log(`  Watcher: ${cfg.watcherUrl}`);
             if (cfg.runnerUrl)
                 console.log(`  Runner: ${cfg.runnerUrl}`);
+            if (cfg.metaUrl)
+                console.log(`  Meta: ${cfg.metaUrl}`);
         }
         catch (error) {
             console.error('\u2717 Configuration invalid');
@@ -46,6 +49,7 @@ export function registerConfigCommand(cli) {
             console.log('');
             console.log('Server:');
             console.log(`  port: ${String(cfg.port)}`);
+            console.log(`  host: ${cfg.host}`);
             console.log(`  chromePath: ${cfg.chromePath}`);
             if (cfg.roots) {
                 console.log(`  roots: ${JSON.stringify(cfg.roots)}`);
@@ -69,6 +73,7 @@ export function registerConfigCommand(cli) {
             console.log('Integrations:');
             console.log(`  watcherUrl: ${cfg.watcherUrl ?? 'not configured'}`);
             console.log(`  runnerUrl: ${cfg.runnerUrl ?? 'not configured'}`);
+            console.log(`  metaUrl: ${cfg.metaUrl ?? 'not configured'}`);
             console.log('');
             console.log('Events:');
             const eventNames = Object.keys(cfg.events);

package/dist/src/config/resolve.js

@@ -186,6 +186,7 @@ export function buildRuntimeConfig(config, rootDir, configPath) {
     const resolvedInsiders = resolveInsiders(config.insiders, config.scopes, stateFile);
     return {
         port: config.port,
+        host: config.host,
         eventTimeoutMs: config.eventTimeoutMs,
         eventLogPurgeMs: config.eventLogPurgeMs,
         maxZipSizeMb: config.maxZipSizeMb,
@@ -216,6 +217,7 @@ export function buildRuntimeConfig(config, rootDir, configPath) {
         internalInsiderKey: deriveInternalKey(resolvedKeys),
         runnerUrl: config.runnerUrl,
         watcherUrl: config.watcherUrl,
+        metaUrl: config.metaUrl,
         diagramCachePath: config.diagramCachePath,
         configPath,
         eventsLog: path.join(rootDir, 'logs', 'webhook-events.jsonl'),

package/dist/src/config/resolve.test.js

@@ -187,6 +187,8 @@ describe('buildRuntimeConfig', () => {
     it('constructs correct path fields', () => {
         const config = {
             port: 1934,
+            host: '0.0.0.0',
+            metaUrl: 'http://127.0.0.1:1938',
             eventTimeoutMs: 30000,
             eventLogPurgeMs: 2592000000,
             maxZipSizeMb: 100,

package/dist/src/config/schema.js

@@ -89,6 +89,12 @@ function getScopeRefs(scopes) {
 export const jeevesConfigSchema = z
     .object({
     port: z.number().int().positive().default(1934),
+    /**
+     * Network interface to bind the server to.
+     * Default: '0.0.0.0' (all interfaces — required for external access by insiders, share links, etc.)
+     * Set to '127.0.0.1' to restrict to loopback only.
+     */
+    host: z.string().min(1).default('0.0.0.0'),
     chromePath: z.string().min(1),
     auth: authSchema,
     /** Named scope definitions, referenced by insiders/keys/outsiderPolicy */
@@ -139,6 +145,11 @@ export const jeevesConfigSchema = z
      * When set, the search UI appears in the header. Example: 'http://localhost:3458'
      */
     watcherUrl: z.url().optional(),
+    /**
+     * URL of the jeeves-meta API for synthesis engine health checks.
+     * Default: 'http://127.0.0.1:1938'
+     */
+    metaUrl: z.url().default('http://127.0.0.1:1938'),
     /**
      * Global outsider policy â€" constrains which paths are eligible for outsider sharing.
      * Uses the same allow/deny model as insider scopes.

package/dist/src/routes/api/status.js

@@ -30,9 +30,10 @@ async function checkService(url) {
 export const statusRoutes = async (fastify) => {
     fastify.get('/api/status', async (request) => {
         const config = getConfig();
-        const [watcher, runner] = await Promise.all([
+        const [watcher, runner, meta] = await Promise.all([
             config.watcherUrl ? checkService(config.watcherUrl) : null,
             config.runnerUrl ? checkService(config.runnerUrl) : null,
+            config.metaUrl ? checkService(config.metaUrl) : null,
         ]);
         return {
             version: packageVersion,
@@ -67,6 +68,7 @@ export const statusRoutes = async (fastify) => {
             services: {
                 watcher,
                 runner,
+                meta,
             },
             ...(request.query.events
                 ? {

package/dist/src/routes/api/status.test.js

@@ -2,6 +2,7 @@ import { describe, expect, it, vi } from 'vitest';
 // Mock config
 const mockConfig = {
     port: 1934,
+    host: '0.0.0.0',
     chromePath: '/usr/bin/chromium',
     authModes: ['keys'],
     resolvedInsiders: [{ email: 'a@b.com' }, { email: 'c@d.com' }],
@@ -17,6 +18,7 @@ const mockConfig = {
     },
     watcherUrl: null,
     runnerUrl: null,
+    metaUrl: null,
     exportFormats: ['pdf', 'docx', 'zip'],
 };
 vi.mock('../../config/index.js', () => ({

package/dist/src/routes/config.js

@@ -3,7 +3,7 @@
  *
  * Uses the core SDK's `createConfigQueryHandler()` for JSONPath support.
  *
- * @module routes/config
+ * @packageDocumentation
  */
 import { createConfigQueryHandler } from '@karmaniverous/jeeves';
 import { getConfig } from '../config/index.js';

package/dist/src/routes/config.test.js

@@ -7,6 +7,7 @@ import { sanitizeConfig } from './config.js';
 function makeConfig(overrides = {}) {
     return {
         port: 1934,
+        host: '0.0.0.0',
         eventTimeoutMs: 30_000,
         eventLogPurgeMs: 604_800_000,
         maxZipSizeMb: 100,

package/dist/src/server.js

@@ -71,8 +71,8 @@ async function start() {
         initExportCache();
         // Start queue processor
         startQueueProcessor();
-        await fastify.listen({ port: config.port, host: '0.0.0.0' });
-        console.log(`Jeeves server listening on port ${String(config.port)}`);
+        await fastify.listen({ port: config.port, host: config.host });
+        console.log(`Jeeves server listening on ${config.host}:${String(config.port)}`);
         console.log(`Endpoints:`);
         console.log(`  GET  /browse/* - File browser SPA`);
         console.log(`  GET  /api/raw/*    - Raw file serving`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@karmaniverous/jeeves-server",
-  "version": "3.3.0",
+  "version": "3.3.1",
   "description": "Secure file browser, markdown viewer, and webhook gateway with PDF/DOCX export and expiring share links",
   "keywords": [
     "fastify",

package/src/cli/commands/config.ts

@@ -27,6 +27,7 @@ export function registerConfigCommand(cli: Command): void {
         const cfg = await loadConfig(options.config);
         console.log('\u2713 Configuration valid');
         console.log(`  Port: ${String(cfg.port)}`);
+        console.log(`  Host: ${cfg.host}`);
         console.log(`  Auth modes: ${cfg.authModes.join(', ')}`);
         console.log(`  Keys: ${String(cfg.resolvedKeys.length)}`);
         console.log(`  Insiders: ${String(cfg.resolvedInsiders.length)}`);
@@ -35,6 +36,7 @@ export function registerConfigCommand(cli: Command): void {
         );
         if (cfg.watcherUrl) console.log(`  Watcher: ${cfg.watcherUrl}`);
         if (cfg.runnerUrl) console.log(`  Runner: ${cfg.runnerUrl}`);
+        if (cfg.metaUrl) console.log(`  Meta: ${cfg.metaUrl}`);
       } catch (error) {
         console.error('\u2717 Configuration invalid');
         console.error(error instanceof Error ? error.message : String(error));
@@ -53,6 +55,7 @@ export function registerConfigCommand(cli: Command): void {
         console.log('');
         console.log('Server:');
         console.log(`  port: ${String(cfg.port)}`);
+        console.log(`  host: ${cfg.host}`);
         console.log(`  chromePath: ${cfg.chromePath}`);
         if (cfg.roots) {
           console.log(`  roots: ${JSON.stringify(cfg.roots)}`);
@@ -78,6 +81,7 @@ export function registerConfigCommand(cli: Command): void {
         console.log('Integrations:');
         console.log(`  watcherUrl: ${cfg.watcherUrl ?? 'not configured'}`);
         console.log(`  runnerUrl: ${cfg.runnerUrl ?? 'not configured'}`);
+        console.log(`  metaUrl: ${cfg.metaUrl ?? 'not configured'}`);
         console.log('');
         console.log('Events:');
         const eventNames = Object.keys(cfg.events);

package/src/config/resolve.test.ts

@@ -236,6 +236,8 @@ describe('buildRuntimeConfig', () => {
   it('constructs correct path fields', () => {
     const config = {
       port: 1934,
+      host: '0.0.0.0',
+      metaUrl: 'http://127.0.0.1:1938',
       eventTimeoutMs: 30000,
       eventLogPurgeMs: 2592000000,
       maxZipSizeMb: 100,

package/src/config/resolve.ts

@@ -250,6 +250,7 @@ export function buildRuntimeConfig(
 
   return {
     port: config.port,
+    host: config.host,
     eventTimeoutMs: config.eventTimeoutMs,
     eventLogPurgeMs: config.eventLogPurgeMs,
     maxZipSizeMb: config.maxZipSizeMb,
@@ -285,6 +286,7 @@ export function buildRuntimeConfig(
     internalInsiderKey: deriveInternalKey(resolvedKeys),
     runnerUrl: config.runnerUrl,
     watcherUrl: config.watcherUrl,
+    metaUrl: config.metaUrl,
     diagramCachePath: config.diagramCachePath,
     configPath,
     eventsLog: path.join(rootDir, 'logs', 'webhook-events.jsonl'),

package/src/config/schema.ts

@@ -100,6 +100,12 @@ function getScopeRefs(scopes: unknown): string[] {
 export const jeevesConfigSchema = z
   .object({
     port: z.number().int().positive().default(1934),
+    /**
+     * Network interface to bind the server to.
+     * Default: '0.0.0.0' (all interfaces — required for external access by insiders, share links, etc.)
+     * Set to '127.0.0.1' to restrict to loopback only.
+     */
+    host: z.string().min(1).default('0.0.0.0'),
     chromePath: z.string().min(1),
     auth: authSchema,
     /** Named scope definitions, referenced by insiders/keys/outsiderPolicy */
@@ -150,6 +156,11 @@ export const jeevesConfigSchema = z
      * When set, the search UI appears in the header. Example: 'http://localhost:3458'
      */
     watcherUrl: z.url().optional(),
+    /**
+     * URL of the jeeves-meta API for synthesis engine health checks.
+     * Default: 'http://127.0.0.1:1938'
+     */
+    metaUrl: z.url().default('http://127.0.0.1:1938'),
     /**
      * Global outsider policy â€" constrains which paths are eligible for outsider sharing.
      * Uses the same allow/deny model as insider scopes.

package/src/config/types.ts

@@ -50,6 +50,7 @@ export interface ResolvedInsider {
  */
 export interface RuntimeConfig {
   port: number;
+  host: string;
   eventTimeoutMs: number;
   eventLogPurgeMs: number;
   maxZipSizeMb: number;
@@ -64,6 +65,7 @@ export interface RuntimeConfig {
   diagramCachePath?: string;
   runnerUrl?: string;
   watcherUrl?: string;
+  metaUrl?: string;
   outsiderPolicy: NormalizedScopes | null;
   events: JeevesConfig['events'];
   authModes: AuthMode[];

package/src/routes/api/status.test.ts

@@ -3,6 +3,7 @@ import { describe, expect, it, vi } from 'vitest';
 // Mock config
 const mockConfig = {
   port: 1934,
+  host: '0.0.0.0',
   chromePath: '/usr/bin/chromium',
   authModes: ['keys'],
   resolvedInsiders: [{ email: 'a@b.com' }, { email: 'c@d.com' }],
@@ -18,6 +19,7 @@ const mockConfig = {
   },
   watcherUrl: null,
   runnerUrl: null,
+  metaUrl: null,
   exportFormats: ['pdf', 'docx', 'zip'],
 };
 

package/src/routes/api/status.ts

@@ -44,9 +44,10 @@ export const statusRoutes: FastifyPluginAsync = async (fastify) => {
     async (request) => {
       const config = getConfig();
 
-      const [watcher, runner] = await Promise.all([
+      const [watcher, runner, meta] = await Promise.all([
         config.watcherUrl ? checkService(config.watcherUrl) : null,
         config.runnerUrl ? checkService(config.runnerUrl) : null,
+        config.metaUrl ? checkService(config.metaUrl) : null,
       ]);
 
       return {
@@ -82,6 +83,7 @@ export const statusRoutes: FastifyPluginAsync = async (fastify) => {
         services: {
           watcher,
           runner,
+          meta,
         },
         ...(request.query.events
           ? {

package/src/routes/config.test.ts

@@ -11,6 +11,7 @@ import { sanitizeConfig } from './config.js';
 function makeConfig(overrides: Partial<RuntimeConfig> = {}): RuntimeConfig {
   return {
     port: 1934,
+    host: '0.0.0.0',
     eventTimeoutMs: 30_000,
     eventLogPurgeMs: 604_800_000,
     maxZipSizeMb: 100,

package/src/routes/config.ts

@@ -3,7 +3,7 @@
  *
  * Uses the core SDK's `createConfigQueryHandler()` for JSONPath support.
  *
- * @module routes/config
+ * @packageDocumentation
  */
 
 import { createConfigQueryHandler } from '@karmaniverous/jeeves';

package/src/server.ts

@@ -85,8 +85,10 @@ async function start() {
     // Start queue processor
     startQueueProcessor();
 
-    await fastify.listen({ port: config.port, host: '0.0.0.0' });
-    console.log(`Jeeves server listening on port ${String(config.port)}`);
+    await fastify.listen({ port: config.port, host: config.host });
+    console.log(
+      `Jeeves server listening on ${config.host}:${String(config.port)}`,
+    );
     console.log(`Endpoints:`);
     console.log(`  GET  /browse/* - File browser SPA`);
     console.log(`  GET  /api/raw/*    - Raw file serving`);