@hotmeshio/long-tail 0.1.4 → 0.1.5

package/README.md

@@ -1,6 +1,6 @@
 # Long Tail
 
-Durable workflows with IAM, Human in the Loop, and MCP tool orchestration. Backed by PostgreSQL.
+Turn your PostgreSQL database into a workflow engine with identity-aware durable execution, human-in-the-loop escalation, and MCP tool orchestration.
 
 ```bash
 npm install @hotmeshio/long-tail

package/build/examples/seed.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.seedExamples = seedExamples;
 const hotmesh_1 = require("@hotmeshio/hotmesh");
 const defaults_1 = require("../modules/defaults");
-const logger_1 = require("../services/logger");
+const logger_1 = require("../lib/logger");
 const user_1 = require("../services/user");
 const roles_1 = require("../services/user/roles");
 const role_1 = require("../services/role");

package/build/examples/workflows/basic-echo/activities.d.ts

@@ -6,9 +6,9 @@
  *
  * 1. `getActivityIdentity()` — recommended: one-call access to principal + credential exchange
  * 2. `getToolContext()` — lower-level access to ToolContext (principal, scopes, trace)
- * 3. `Durable.activity.getContext()` — raw HotMesh API for argumentMetadata
+ * 3. `Durable.activity.getContext()` — raw HotMesh API for headers
  *
- * All work across process boundaries because argumentMetadata travels
+ * All work across process boundaries because headers travels
  * with the activity call via HotMesh's schema pipeline.
  */
 export declare function echo(input: {

package/build/examples/workflows/basic-echo/activities.js

@@ -7,9 +7,9 @@
  *
  * 1. `getActivityIdentity()` — recommended: one-call access to principal + credential exchange
  * 2. `getToolContext()` — lower-level access to ToolContext (principal, scopes, trace)
- * 3. `Durable.activity.getContext()` — raw HotMesh API for argumentMetadata
+ * 3. `Durable.activity.getContext()` — raw HotMesh API for headers
  *
- * All work across process boundaries because argumentMetadata travels
+ * All work across process boundaries because headers travels
  * with the activity call via HotMesh's schema pipeline.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -20,11 +20,11 @@ async function echo(input) {
     // Recommended: getActivityIdentity() — principal + getCredential() in one call
     // const identity = getActivityIdentity();
     // const token = await identity.getCredential('anthropic'); // credential exchange
-    // Primary: getToolContext() reads from argumentMetadata (injected by activity interceptor)
+    // Primary: getToolContext() reads from headers (injected by activity interceptor)
     const ctx = (0, context_1.getToolContext)();
-    // Direct access: Durable.activity.getContext() shows the raw argumentMetadata
+    // Direct access: Durable.activity.getContext() shows the raw headers
     const activityCtx = hotmesh_1.Durable.activity.getContext();
-    const rawPrincipal = activityCtx?.argumentMetadata?.principal;
+    const rawPrincipal = activityCtx?.headers?.principal;
     const identity = ctx
         ? {
             source: 'getActivityIdentity',
@@ -40,12 +40,12 @@ async function echo(input) {
         }
         : rawPrincipal
             ? {
-                source: 'argumentMetadata',
+                source: 'headers',
                 principal: rawPrincipal,
             }
             : {
                 source: 'unavailable',
-                note: 'no principal in envelope or argumentMetadata',
+                note: 'no principal in envelope or headers',
             };
     return {
         message: input.message,

package/build/examples/workflows/basic-echo/index.js

@@ -53,7 +53,7 @@ const { echo } = hotmesh_1.Durable.workflow.proxyActivities({
 });
 async function basicEcho(envelope) {
     const { message = 'Hello, Long Tail!', sleepSeconds = 1 } = envelope.data;
-    await hotmesh_1.Durable.workflow.sleepFor(`${sleepSeconds} seconds`);
+    await hotmesh_1.Durable.workflow.sleep(`${sleepSeconds} seconds`);
     const echoResult = await echo({ message });
     return {
         type: 'return',

package/build/examples/workflows/kitchen-sink/index.js

@@ -58,7 +58,7 @@ const hotmesh_1 = require("@hotmeshio/hotmesh");
 const activities = __importStar(require("./activities"));
 const { greet, fetchData, transformData, notifyComplete } = hotmesh_1.Durable.workflow.proxyActivities({
     activities,
-    retryPolicy: {
+    retry: {
         maximumAttempts: 3,
         backoffCoefficient: 2,
         maximumInterval: '10 seconds',
@@ -74,7 +74,7 @@ async function kitchenSink(envelope) {
     // ── 2. Durable sleep ──────────────────────────────────────────────────
     // Survives crashes. If the process restarts during the sleep, it resumes
     // where it left off — no drift, no double-execution.
-    await hotmesh_1.Durable.workflow.sleepFor('2 seconds');
+    await hotmesh_1.Durable.workflow.sleep('2 seconds');
     // ── 3. Parallel activities ────────────────────────────────────────────
     // Promise.all works naturally. Both activities run concurrently and each
     // is independently checkpointed.

package/build/index.d.ts

@@ -10,15 +10,15 @@ export * as EscalationService from './services/escalation';
 export * as ConfigService from './services/config';
 export * as UserService from './services/user';
 export { ltConfig } from './modules/ltconfig';
-export { eventRegistry } from './services/events';
-export { NatsEventAdapter } from './services/events/nats';
-export { InMemoryEventAdapter } from './services/events/memory';
-export { SocketIOEventAdapter } from './services/events/socketio';
-export { publishMilestoneEvent, publishTaskEvent, publishEscalationEvent, publishWorkflowEvent } from './services/events/publish';
-export { telemetryRegistry } from './services/telemetry';
-export { HoneycombTelemetryAdapter } from './services/telemetry/honeycomb';
-export { loggerRegistry } from './services/logger';
-export { PinoLoggerAdapter } from './services/logger/pino';
+export { eventRegistry } from './lib/events';
+export { NatsEventAdapter } from './lib/events/nats';
+export { InMemoryEventAdapter } from './lib/events/memory';
+export { SocketIOEventAdapter } from './lib/events/socketio';
+export { publishMilestoneEvent, publishTaskEvent, publishEscalationEvent, publishWorkflowEvent } from './lib/events/publish';
+export { telemetryRegistry } from './lib/telemetry';
+export { HoneycombTelemetryAdapter } from './lib/telemetry/honeycomb';
+export { loggerRegistry } from './lib/logger';
+export { PinoLoggerAdapter } from './lib/logger/pino';
 export { maintenanceRegistry } from './services/maintenance';
 export { defaultMaintenanceConfig } from './modules/maintenance';
 export { mcpRegistry } from './services/mcp';
@@ -26,7 +26,8 @@ export { BuiltInMcpAdapter } from './services/mcp/adapter';
 export * as McpService from './services/mcp/db';
 export * as McpClient from './services/mcp/client';
 export * as McpServer from './services/mcp/server';
-export * as McpVisionServer from './services/mcp/vision-server';
+export * as McpTranslationServer from './system/mcp-servers/translation';
+export * as McpVisionServer from './system/mcp-servers/vision';
 export { escalationStrategyRegistry } from './services/escalation-strategy';
 export { DefaultEscalationStrategy } from './services/escalation-strategy/default';
 export { McpEscalationStrategy } from './services/escalation-strategy/mcp';

package/build/index.js

@@ -36,9 +36,9 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.seedSystemMcpServers = exports.builtinMcpServerFactories = exports.getSystemWorkers = exports.registerMcpTool = exports.getToolContext = exports.getActivityIdentity = exports.seedExamples = exports.exampleWorkers = exports.McpEscalationStrategy = exports.DefaultEscalationStrategy = exports.escalationStrategyRegistry = exports.McpVisionServer = exports.McpServer = exports.McpClient = exports.McpService = exports.BuiltInMcpAdapter = exports.mcpRegistry = exports.defaultMaintenanceConfig = exports.maintenanceRegistry = exports.PinoLoggerAdapter = exports.loggerRegistry = exports.HoneycombTelemetryAdapter = exports.telemetryRegistry = exports.publishWorkflowEvent = exports.publishEscalationEvent = exports.publishTaskEvent = exports.publishMilestoneEvent = exports.SocketIOEventAdapter = exports.InMemoryEventAdapter = exports.NatsEventAdapter = exports.eventRegistry = exports.ltConfig = exports.UserService = exports.ConfigService = exports.EscalationService = exports.TaskService = exports.signToken = exports.requireAdmin = exports.requireAuth = exports.createAuthMiddleware = exports.JwtAuthAdapter = exports.executeLT = exports.createLTActivityInterceptor = exports.createLTInterceptor = exports.registerLT = exports.start = void 0;
+exports.seedSystemMcpServers = exports.builtinMcpServerFactories = exports.getSystemWorkers = exports.registerMcpTool = exports.getToolContext = exports.getActivityIdentity = exports.seedExamples = exports.exampleWorkers = exports.McpEscalationStrategy = exports.DefaultEscalationStrategy = exports.escalationStrategyRegistry = exports.McpVisionServer = exports.McpTranslationServer = exports.McpServer = exports.McpClient = exports.McpService = exports.BuiltInMcpAdapter = exports.mcpRegistry = exports.defaultMaintenanceConfig = exports.maintenanceRegistry = exports.PinoLoggerAdapter = exports.loggerRegistry = exports.HoneycombTelemetryAdapter = exports.telemetryRegistry = exports.publishWorkflowEvent = exports.publishEscalationEvent = exports.publishTaskEvent = exports.publishMilestoneEvent = exports.SocketIOEventAdapter = exports.InMemoryEventAdapter = exports.NatsEventAdapter = exports.eventRegistry = exports.ltConfig = exports.UserService = exports.ConfigService = exports.EscalationService = exports.TaskService = exports.signToken = exports.requireAdmin = exports.requireAuth = exports.createAuthMiddleware = exports.JwtAuthAdapter = exports.executeLT = exports.createLTActivityInterceptor = exports.createLTInterceptor = exports.registerLT = exports.start = void 0;
 const config_1 = require("./modules/config");
-const logger_1 = require("./services/logger");
+const logger_1 = require("./lib/logger");
 const start_1 = require("./start");
 // ─── Package Exports ─────────────────────────────────────────────────────────
 var start_2 = require("./start");
@@ -63,26 +63,26 @@ exports.ConfigService = __importStar(require("./services/config"));
 exports.UserService = __importStar(require("./services/user"));
 var ltconfig_1 = require("./modules/ltconfig");
 Object.defineProperty(exports, "ltConfig", { enumerable: true, get: function () { return ltconfig_1.ltConfig; } });
-var events_1 = require("./services/events");
+var events_1 = require("./lib/events");
 Object.defineProperty(exports, "eventRegistry", { enumerable: true, get: function () { return events_1.eventRegistry; } });
-var nats_1 = require("./services/events/nats");
+var nats_1 = require("./lib/events/nats");
 Object.defineProperty(exports, "NatsEventAdapter", { enumerable: true, get: function () { return nats_1.NatsEventAdapter; } });
-var memory_1 = require("./services/events/memory");
+var memory_1 = require("./lib/events/memory");
 Object.defineProperty(exports, "InMemoryEventAdapter", { enumerable: true, get: function () { return memory_1.InMemoryEventAdapter; } });
-var socketio_1 = require("./services/events/socketio");
+var socketio_1 = require("./lib/events/socketio");
 Object.defineProperty(exports, "SocketIOEventAdapter", { enumerable: true, get: function () { return socketio_1.SocketIOEventAdapter; } });
-var publish_1 = require("./services/events/publish");
+var publish_1 = require("./lib/events/publish");
 Object.defineProperty(exports, "publishMilestoneEvent", { enumerable: true, get: function () { return publish_1.publishMilestoneEvent; } });
 Object.defineProperty(exports, "publishTaskEvent", { enumerable: true, get: function () { return publish_1.publishTaskEvent; } });
 Object.defineProperty(exports, "publishEscalationEvent", { enumerable: true, get: function () { return publish_1.publishEscalationEvent; } });
 Object.defineProperty(exports, "publishWorkflowEvent", { enumerable: true, get: function () { return publish_1.publishWorkflowEvent; } });
-var telemetry_1 = require("./services/telemetry");
+var telemetry_1 = require("./lib/telemetry");
 Object.defineProperty(exports, "telemetryRegistry", { enumerable: true, get: function () { return telemetry_1.telemetryRegistry; } });
-var honeycomb_1 = require("./services/telemetry/honeycomb");
+var honeycomb_1 = require("./lib/telemetry/honeycomb");
 Object.defineProperty(exports, "HoneycombTelemetryAdapter", { enumerable: true, get: function () { return honeycomb_1.HoneycombTelemetryAdapter; } });
-var logger_2 = require("./services/logger");
+var logger_2 = require("./lib/logger");
 Object.defineProperty(exports, "loggerRegistry", { enumerable: true, get: function () { return logger_2.loggerRegistry; } });
-var pino_1 = require("./services/logger/pino");
+var pino_1 = require("./lib/logger/pino");
 Object.defineProperty(exports, "PinoLoggerAdapter", { enumerable: true, get: function () { return pino_1.PinoLoggerAdapter; } });
 var maintenance_1 = require("./services/maintenance");
 Object.defineProperty(exports, "maintenanceRegistry", { enumerable: true, get: function () { return maintenance_1.maintenanceRegistry; } });
@@ -95,7 +95,8 @@ Object.defineProperty(exports, "BuiltInMcpAdapter", { enumerable: true, get: fun
 exports.McpService = __importStar(require("./services/mcp/db"));
 exports.McpClient = __importStar(require("./services/mcp/client"));
 exports.McpServer = __importStar(require("./services/mcp/server"));
-exports.McpVisionServer = __importStar(require("./services/mcp/vision-server"));
+exports.McpTranslationServer = __importStar(require("./system/mcp-servers/translation"));
+exports.McpVisionServer = __importStar(require("./system/mcp-servers/vision"));
 var escalation_strategy_1 = require("./services/escalation-strategy");
 Object.defineProperty(exports, "escalationStrategyRegistry", { enumerable: true, get: function () { return escalation_strategy_1.escalationStrategyRegistry; } });
 var default_1 = require("./services/escalation-strategy/default");

package/build/lib/db/index.d.ts

@@ -0,0 +1,18 @@
+import { Client, Pool } from 'pg';
+export declare function getPool(): Pool;
+export declare function closePool(): Promise<void>;
+/**
+ * HotMesh connection descriptor: `{ class: Client, options: postgres_options }`.
+ * Use this everywhere HotMesh / Durable APIs need a connection config
+ * instead of importing `pg` and `postgres_options` directly.
+ */
+export declare function getConnection(): {
+    class: typeof Client;
+    options: {
+        host: string;
+        port: number;
+        user: string;
+        password: string;
+        database: string;
+    };
+};

package/build/{services → lib}/db/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPool = getPool;
 exports.closePool = closePool;
+exports.getConnection = getConnection;
 const pg_1 = require("pg");
 const config_1 = require("../../modules/config");
 let pool = null;
@@ -17,3 +18,11 @@ async function closePool() {
         pool = null;
     }
 }
+/**
+ * HotMesh connection descriptor: `{ class: Client, options: postgres_options }`.
+ * Use this everywhere HotMesh / Durable APIs need a connection config
+ * instead of importing `pg` and `postgres_options` directly.
+ */
+function getConnection() {
+    return { class: pg_1.Client, options: config_1.postgres_options };
+}

package/build/{services → lib}/db/migrate.js

@@ -38,8 +38,8 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const index_1 = require("./index");
 const logger_1 = require("../logger");
-// In dev: __dirname = services/db → schemas is ./schemas
-// In built/published: __dirname = build/services/db → schemas is ../../../services/db/schemas
+// In dev: __dirname = lib/db → schemas is ./schemas
+// In built/published: __dirname = build/lib/db → schemas is ../../../lib/db/schemas
 const devPath = path.join(__dirname, 'schemas');
 const SCHEMAS_DIR = fs.existsSync(devPath)
     ? devPath
@@ -68,7 +68,7 @@ async function migrate() {
         }
     }
 }
-// run directly: npx ts-node services/db/migrate.ts
+// run directly: npx ts-node lib/db/migrate.ts
 if (require.main === module) {
     require('dotenv').config();
     migrate()

package/build/{services → lib}/telemetry/honeycomb.d.ts

@@ -26,8 +26,8 @@ export interface HoneycombOptions {
  *
  * Usage:
  * ```typescript
- * import { telemetryRegistry } from './services/telemetry';
- * import { HoneycombTelemetryAdapter } from './services/telemetry/honeycomb';
+ * import { telemetryRegistry } from './lib/telemetry';
+ * import { HoneycombTelemetryAdapter } from './lib/telemetry/honeycomb';
  *
  * telemetryRegistry.register(new HoneycombTelemetryAdapter({
  *   apiKey: process.env.HONEYCOMB_API_KEY,

package/build/{services → lib}/telemetry/honeycomb.js

@@ -19,8 +19,8 @@ const logger_1 = require("../logger");
  *
  * Usage:
  * ```typescript
- * import { telemetryRegistry } from './services/telemetry';
- * import { HoneycombTelemetryAdapter } from './services/telemetry/honeycomb';
+ * import { telemetryRegistry } from './lib/telemetry';
+ * import { HoneycombTelemetryAdapter } from './lib/telemetry/honeycomb';
  *
  * telemetryRegistry.register(new HoneycombTelemetryAdapter({
  *   apiKey: process.env.HONEYCOMB_API_KEY,

package/build/modules/defaults.d.ts

@@ -23,6 +23,8 @@ export declare const LLM_MAX_TOKENS_VISION: number;
 export declare const LLM_MAX_ARRAY_ITEMS: number;
 /** Hard character cap on serialized input payloads sent to the LLM. */
 export declare const LLM_MAX_INPUT_CHARS: number;
+/** Max characters for a single tool result before truncation in the agentic loop. */
+export declare const TOOL_RESULT_MAX_CHARS: number;
 /** Max agentic loop iterations for MCP triage workflows. */
 export declare const TOOL_ROUNDS_TRIAGE: number;
 /** Max agentic loop iterations for mcpQuery (higher — includes recall + discover + persist phases). */

package/build/modules/defaults.js

@@ -9,7 +9,7 @@
  * Grouped by domain so related knobs live together.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.YAML_LINE_WIDTH = exports.STOP_WORDS = exports.CLAIM_DURATION_OPTIONS = exports.YAML_VERSION_LIMIT = exports.YAML_LIST_LIMIT = exports.QUERY_LIMIT_MAX = exports.QUERY_LIMIT_DEFAULT = exports.CONFIG_CACHE_TTL_MS = exports.MCP_TOOL_TIMEOUT_MS = exports.WORKFLOW_SYNC_TIMEOUT_MS = exports.JOB_EXPIRE_SECS = exports.WORKFLOW_EXPIRE_SECS = exports.TOOL_ARG_LIMIT_CAP = exports.TOOL_ROUNDS_MCP_QUERY = exports.TOOL_ROUNDS_TRIAGE = exports.LLM_MAX_INPUT_CHARS = exports.LLM_MAX_ARRAY_ITEMS = exports.LLM_MAX_TOKENS_VISION = exports.LLM_MAX_TOKENS_JSON = exports.LLM_MAX_TOKENS_DEFAULT = exports.LLM_BASE_URL = exports.LLM_MODEL_SECONDARY = exports.LLM_MODEL_PRIMARY = void 0;
+exports.YAML_LINE_WIDTH = exports.STOP_WORDS = exports.CLAIM_DURATION_OPTIONS = exports.YAML_VERSION_LIMIT = exports.YAML_LIST_LIMIT = exports.QUERY_LIMIT_MAX = exports.QUERY_LIMIT_DEFAULT = exports.CONFIG_CACHE_TTL_MS = exports.MCP_TOOL_TIMEOUT_MS = exports.WORKFLOW_SYNC_TIMEOUT_MS = exports.JOB_EXPIRE_SECS = exports.WORKFLOW_EXPIRE_SECS = exports.TOOL_ARG_LIMIT_CAP = exports.TOOL_ROUNDS_MCP_QUERY = exports.TOOL_ROUNDS_TRIAGE = exports.TOOL_RESULT_MAX_CHARS = exports.LLM_MAX_INPUT_CHARS = exports.LLM_MAX_ARRAY_ITEMS = exports.LLM_MAX_TOKENS_VISION = exports.LLM_MAX_TOKENS_JSON = exports.LLM_MAX_TOKENS_DEFAULT = exports.LLM_BASE_URL = exports.LLM_MODEL_SECONDARY = exports.LLM_MODEL_PRIMARY = void 0;
 function envInt(key, fallback) {
     const v = process.env[key];
     if (v === undefined || v === '')
@@ -37,6 +37,8 @@ exports.LLM_MAX_TOKENS_VISION = envInt('LT_LLM_MAX_TOKENS_VISION', 2000);
 exports.LLM_MAX_ARRAY_ITEMS = envInt('LT_LLM_MAX_ARRAY_ITEMS', 25);
 /** Hard character cap on serialized input payloads sent to the LLM. */
 exports.LLM_MAX_INPUT_CHARS = envInt('LT_LLM_MAX_INPUT_CHARS', 12_000);
+/** Max characters for a single tool result before truncation in the agentic loop. */
+exports.TOOL_RESULT_MAX_CHARS = envInt('LT_TOOL_RESULT_MAX_CHARS', 50_000);
 // ── Tool execution ───────────────────────────────────────────────────
 /** Max agentic loop iterations for MCP triage workflows. */
 exports.TOOL_ROUNDS_TRIAGE = envInt('LT_TOOL_ROUNDS_TRIAGE', 10);

package/build/routes/controlplane.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const express_1 = require("express");
 const auth_1 = require("../modules/auth");
 const controlplane = __importStar(require("../services/controlplane"));
-const events_1 = require("../services/events");
+const events_1 = require("../lib/events");
 const router = (0, express_1.Router)();
 /**
  * GET /api/controlplane/apps

package/build/routes/dba.js

@@ -58,6 +58,10 @@ router.post('/prune', auth_1.requireAdmin, async (req, res) => {
             expire: req.body.expire,
             jobs: req.body.jobs,
             streams: req.body.streams,
+            engineStreams: req.body.engineStreams,
+            engineStreamsExpire: req.body.engineStreamsExpire,
+            workerStreams: req.body.workerStreams,
+            workerStreamsExpire: req.body.workerStreamsExpire,
             attributes: req.body.attributes,
             entities: req.body.entities,
             pruneTransient: req.body.pruneTransient,

package/build/routes/docs.d.ts

@@ -0,0 +1,2 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;

package/build/routes/docs.js

@@ -0,0 +1,87 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = require("express");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const router = (0, express_1.Router)();
+function docsDir() {
+    const candidates = [
+        path.join(__dirname, '..', 'docs'),
+        path.join(__dirname, '..', '..', 'docs'),
+    ];
+    for (const dir of candidates) {
+        if (fs.existsSync(dir))
+            return dir;
+    }
+    return candidates[0];
+}
+function listDocs(dir, prefix = '') {
+    if (!fs.existsSync(dir))
+        return [];
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            results.push(...listDocs(path.join(dir, entry.name), rel));
+        }
+        else if (entry.name.endsWith('.md')) {
+            const content = fs.readFileSync(path.join(dir, entry.name), 'utf-8');
+            const firstLine = content.split('\n').find(l => l.startsWith('# '));
+            const title = firstLine ? firstLine.replace(/^#\s+/, '') : entry.name;
+            results.push({ path: rel, title });
+        }
+    }
+    return results;
+}
+router.get('/', (_req, res) => {
+    res.json({ docs: listDocs(docsDir()) });
+});
+// Use query param for doc path to avoid Express wildcard issues
+router.get('/read', (req, res) => {
+    const docPath = req.query.path;
+    if (!docPath || docPath.includes('..')) {
+        res.status(400).json({ error: 'Invalid path' });
+        return;
+    }
+    const filePath = path.join(docsDir(), docPath);
+    if (!fs.existsSync(filePath)) {
+        res.status(404).json({ error: 'Document not found' });
+        return;
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    res.json({ path: docPath, content });
+});
+exports.default = router;