@mono-agent/webhook-adapter 0.3.0 → 0.4.1

package/README.md

@@ -6,7 +6,11 @@ Category: `communication`
 
 ## Responsibility
 
-HTTP webhook invocation adapter for agent hosts. It starts a small HTTP server, validates JSON invocation requests, maps them into structural `AgentResponder` calls, and returns either a synchronous result or an in-memory async request status.
+HTTP webhook invocation adapter for agent hosts. It starts a small HTTP server, validates JSON invocation requests, maps them into structural `AgentResponder` calls, and returns either a synchronous result or an in-memory async request status. One server can serve **multiple named endpoints**, each with its own path, mode, and optional `prompt`.
+
+## Port ownership
+
+The adapter binds **its own** HTTP port — it is *not* inherited from a parent mono-agent process (mono-agent is not itself an HTTP server; each HTTP-bearing channel binds its own port). `port: 0` (the default) asks the OS for a random free port, so the resolved URL is unpredictable. **Set an explicit port** (e.g. `4310`) when you need a stable URL that skills or webhook `prompt`s can reference. The resolved invoke URL(s) are reported in the channel `summary` (visible via `mono-agent status` and logs).
 
 ## Install / Usage
 
@@ -20,11 +24,20 @@ import { startWebhookAdapter } from "@mono-agent/webhook-adapter";
 const webhook = await startWebhookAdapter({
   host: "127.0.0.1",
   port: 4310,
-  path: "/webhook/invoke",
   responder,
+  endpoints: [
+    { name: "invoke", path: "/webhook/invoke" },
+    { name: "deep-research", path: "/webhook/deep-research", mode: "async", prompt: "Check deep-research/requests/*.md, match the incoming payload, address it, then move the file to deep-research/researched/." },
+  ],
 });
 ```
 
+A single legacy endpoint still works (`path`/`defaultMode` are folded into a one-element `endpoints` list):
+
+```ts
+await startWebhookAdapter({ host: "127.0.0.1", port: 4310, path: "/webhook/invoke", responder });
+```
+
 Send a sync invocation:
 
 ```bash
@@ -35,18 +48,41 @@ curl -X POST "$WEBHOOK_URL/webhook/invoke" \
 
 Async mode returns `202` with `requestId` and `statusUrl`; status is process-local memory and is not durable across restarts.
 
+## Per-webhook prompt
+
+Each endpoint may carry a `prompt` (pre-instructions, same role as a cron job's prompt). When set, the adapter forms the agent's user message as `prompt` + `\n\n` + the posted `text`. The webhook imposes no correlation scheme of its own: it forwards the request's `conversationId` and arbitrary `metadata` through unchanged, so a `prompt` plus filesystem/skill conventions can drive any workflow (e.g. matching incoming results to request files on disk).
+
+> Loopback note: a webhook is request/response — the resumed turn's output is returned on the POST's own HTTP response (sync) or status endpoint (async). History is in-memory per channel harness, and `createConfiguredAgentResponder` applies auto-compaction + daily session rollover, so a result returning long after it was scheduled may resume with compacted context. Skills that need durable correlation should record state in memory or on disk.
+
+## Configuring multiple endpoints (host config)
+
+`loadWebhookAdapterConfig` reads endpoints from, in precedence order: `MONO_AGENT_WEBHOOK_ENDPOINTS_JSON`, the `webhook.endpoints` array, then the legacy single `webhook.path`/`webhook.prompt` fields. Endpoints can also be authored as `*.md` files in the `webhook` folder (override via `webhook.dir` / `MONO_AGENT_WEBHOOK_DIR`), mirroring cron jobs — frontmatter is routing, the body is the `prompt`:
+
+```markdown
+---
+path: /webhook/deep-research
+mode: async
+---
+Check deep-research/requests/*.md, match the incoming payload to an existing
+request, address it, then move that file to deep-research/researched/.
+```
+
+Folder endpoints are merged with config endpoints; a duplicate `name` or `path` is a hard error.
+
 ## Public API
 
 - `startWebhookAdapter`
+- `normalizePath`
+- `loadWebhookEndpointsFromDirectory`, `parseWebhookEndpointMarkdown`
 - `WebhookAdapterError`
 - `loadWebhookAdapterConfig`
 - `redactWebhookAdapterConfig`
 - `webhookFieldGroup`
-- Webhook adapter, config, request metadata, invocation status, and logger types
+- Webhook adapter, config, endpoint, request metadata, invocation status, and logger types
 
 ## Dependency Boundary
 
-This adapter depends on Express plus shared contracts/settings primitives. It must not depend on the agent harness, runtime adapter, operator surfaces, memory, observability, other communication adapters, or host/demo code. Hosts compose it with a structural responder.
+This adapter depends on Express plus shared `@mono-agent/agent-contracts` primitives. It must not depend on the agent harness, runtime adapter, operator surfaces, memory, observability, other communication adapters, or host/demo code. Hosts compose it with a structural responder.
 
 ## What This Package Does Not Own
 

package/dist/config.d.ts

@@ -1,22 +1,52 @@
-import type { FieldGroup, SettingsJson } from "@mono-agent/settings";
+import type { JsonEnvFieldSpec, SettingsJson } from "@mono-agent/agent-contracts";
 import { type WebhookInvocationMode } from "./server.js";
+/** One HTTP endpoint of the webhook server (shares the server's host + port). */
+export interface WebhookEndpointConfig {
+    readonly name: string;
+    readonly path: string;
+    readonly mode: WebhookInvocationMode;
+    readonly enabled: boolean;
+    /** Pre-instructions prepended to the incoming request text. Same role as a cron job's prompt. */
+    readonly prompt?: string;
+    readonly notify?: boolean;
+    readonly notifyConversationId?: string;
+    /** Per-endpoint runtime model override (e.g. `claude:claude-opus-4-8`). A request body `model` wins. */
+    readonly model?: string;
+    /** Per-endpoint reasoning effort override (e.g. `high`). A request body `effort` wins. */
+    readonly effort?: string;
+}
 export interface WebhookAdapterConfig {
     readonly enabled: boolean;
     readonly host: string;
     readonly port: number;
-    readonly path: string;
     readonly allowNonLoopback: boolean;
-    readonly defaultMode: WebhookInvocationMode;
     readonly retentionMs: number;
     readonly maxStoredRequests: number;
+    /** Wall-clock bound (ms) per webhook run. Omit to use the adapter default (20 min). */
+    readonly maxRunMs?: number;
+    readonly endpoints: readonly WebhookEndpointConfig[];
+    /** Back-compat mirror of `endpoints[0].path`. */
+    readonly path: string;
+    /** Back-compat mirror of `endpoints[0].mode`. */
+    readonly defaultMode: WebhookInvocationMode;
 }
 export type RedactedWebhookAdapterConfig = WebhookAdapterConfig;
 export interface LoadWebhookAdapterConfigInput {
     readonly env: Record<string, string | undefined>;
     readonly json?: SettingsJson;
     readonly jsonPath?: string;
+    /** Base directory the webhook endpoints folder resolves against (usually the app cwd). */
+    readonly cwd?: string;
+    /** Overrides the endpoints folder; defaults to `webhook.dir` / `MONO_AGENT_WEBHOOK_DIR` / `webhook`. */
+    readonly dir?: string;
 }
-export declare const webhookFieldGroup: FieldGroup;
 export declare function loadWebhookAdapterConfig(input: LoadWebhookAdapterConfigInput): Promise<WebhookAdapterConfig>;
 export declare function redactWebhookAdapterConfig(config: WebhookAdapterConfig): RedactedWebhookAdapterConfig;
+/**
+ * The `webhook` section's field registry: the single source of truth both the
+ * JSON→env layering below and the app's config provenance view derive from.
+ * Covers the single-endpoint fields (multi-endpoint `endpoints[]` and `dir`
+ * are read straight from JSON / their own env forms).
+ */
+export declare const WEBHOOK_CONFIG_FIELDS: readonly JsonEnvFieldSpec[];
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE9E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEhE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAeD,eAAO,MAAM,iBAAiB,EAAE,UA6E9B,CAAC;AAEH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAa/B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,4BAA4B,CAErG"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGlF,OAAO,EAAsC,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAE7F,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,wGAAwG;IACxG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACrD,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;CAC7C;AAED,MAAM,MAAM,4BAA4B,GAAG,oBAAoB,CAAC;AAEhE,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,wGAAwG;IACxG,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAgBD,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,oBAAoB,CAAC,CAkC/B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,4BAA4B,CAErG;AAmLD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAgB5D,CAAC"}

package/dist/config.js

@@ -1,5 +1,7 @@
-import { defineFieldGroup, layerJsonOntoEnv, readBoolean, readChoice, readInteger, readJsonSection, readSettingsJson, readString, } from "@mono-agent/settings";
-import { WebhookAdapterError } from "./server.js";
+import { resolve } from "node:path";
+import { fieldSpecMappings, layerJsonOntoEnv, normalizeOptionalString, readBoolean, readChoice, readInteger, readJsonSection, readSettingsJson, readString, } from "@mono-agent/agent-contracts";
+import { loadWebhookEndpointsFromDirectory } from "./endpoints-dir.js";
+import { normalizePath, WebhookAdapterError } from "./server.js";
 const DEFAULT_ENABLED = false;
 const DEFAULT_HOST = "127.0.0.1";
 const DEFAULT_PORT = 0;
@@ -7,114 +9,236 @@ const DEFAULT_PATH = "/webhook/invoke";
 const DEFAULT_MODE = "sync";
 const DEFAULT_RETENTION_MS = 300_000;
 const DEFAULT_MAX_STORED_REQUESTS = 100;
+const DEFAULT_WEBHOOK_DIR = "webhook";
 const WEBHOOK_MODES = ["sync", "async"];
 const invalidConfig = (message, details) => new WebhookAdapterError("invalid_config", message, details);
-export const webhookFieldGroup = defineFieldGroup({
-    id: "webhook",
-    label: "Webhook",
-    description: "Optional HTTP webhook invocation adapter configuration.",
-    fields: [
-        {
-            id: "webhook.enabled",
-            label: "Enable webhook",
-            description: "Expose an HTTP endpoint that can invoke the configured agent.",
-            kind: "switch",
-            path: ["webhook", "enabled"],
-        },
-        {
-            id: "webhook.host",
-            label: "Host",
-            description: "Bind host. Defaults to 127.0.0.1.",
-            kind: "string",
-            placeholder: "127.0.0.1",
-            path: ["webhook", "host"],
-        },
-        {
-            id: "webhook.port",
-            label: "Port",
-            description: "Bind port. Use 0 to choose a free loopback port.",
-            kind: "integer",
-            min: 0,
-            max: 65535,
-            placeholder: "0",
-            path: ["webhook", "port"],
-        },
-        {
-            id: "webhook.path",
-            label: "Path",
-            description: "POST path for agent invocation.",
-            kind: "string",
-            placeholder: "/webhook/invoke",
-            path: ["webhook", "path"],
-        },
-        {
-            id: "webhook.allowNonLoopback",
-            label: "Allow non-loopback",
-            description: "Explicitly allow public/non-loopback binding.",
-            kind: "switch",
-            path: ["webhook", "allowNonLoopback"],
-        },
-        {
-            id: "webhook.defaultMode",
-            label: "Default mode",
-            description: "Invocation mode used when the request body omits mode.",
-            kind: "select",
-            options: [
-                { value: "sync", label: "sync" },
-                { value: "async", label: "async" },
-            ],
-            path: ["webhook", "defaultMode"],
-        },
-        {
-            id: "webhook.retentionMs",
-            label: "Status retention",
-            description: "How long async request status remains in memory.",
-            kind: "integer",
-            min: 1,
-            max: 86_400_000,
-            placeholder: "300000",
-            path: ["webhook", "retentionMs"],
-        },
-        {
-            id: "webhook.maxStoredRequests",
-            label: "Max stored requests",
-            description: "Maximum number of in-memory async statuses to retain.",
-            kind: "integer",
-            min: 1,
-            max: 10_000,
-            placeholder: "100",
-            path: ["webhook", "maxStoredRequests"],
-        },
-    ],
-});
 export async function loadWebhookAdapterConfig(input) {
     const json = input.json ?? (input.jsonPath === undefined ? {} : (await readSettingsJson(input.jsonPath)).json);
     const env = layerWebhookJsonOntoEnv(json, input.env);
+    const enabled = readBoolean(env.MONO_AGENT_WEBHOOK_ENABLED, "MONO_AGENT_WEBHOOK_ENABLED", DEFAULT_ENABLED, invalidConfig);
+    const host = readString(env.MONO_AGENT_WEBHOOK_HOST, DEFAULT_HOST);
+    const port = readInteger(env.MONO_AGENT_WEBHOOK_PORT, "MONO_AGENT_WEBHOOK_PORT", DEFAULT_PORT, invalidConfig, { min: 0, max: 65535 });
+    const allowNonLoopback = readBoolean(env.MONO_AGENT_WEBHOOK_ALLOW_NON_LOOPBACK, "MONO_AGENT_WEBHOOK_ALLOW_NON_LOOPBACK", false, invalidConfig);
+    const defaultMode = readChoice(env.MONO_AGENT_WEBHOOK_DEFAULT_MODE, "MONO_AGENT_WEBHOOK_DEFAULT_MODE", WEBHOOK_MODES, DEFAULT_MODE, invalidConfig);
+    const retentionMs = readInteger(env.MONO_AGENT_WEBHOOK_RETENTION_MS, "MONO_AGENT_WEBHOOK_RETENTION_MS", DEFAULT_RETENTION_MS, invalidConfig, { min: 1, max: 86_400_000 });
+    const maxStoredRequests = readInteger(env.MONO_AGENT_WEBHOOK_MAX_STORED_REQUESTS, "MONO_AGENT_WEBHOOK_MAX_STORED_REQUESTS", DEFAULT_MAX_STORED_REQUESTS, invalidConfig, { min: 1, max: 10_000 });
+    const maxRunMsRaw = normalizeOptionalString(env.MONO_AGENT_WEBHOOK_MAX_RUN_MS);
+    const maxRunMs = maxRunMsRaw === undefined
+        ? undefined
+        : readInteger(maxRunMsRaw, "MONO_AGENT_WEBHOOK_MAX_RUN_MS", 0, invalidConfig, { min: 0, max: 86_400_000 });
+    const configEndpoints = loadConfigEndpoints(json, env, defaultMode);
+    const directoryEndpoints = await loadDirectoryEndpoints(json, input, defaultMode);
+    const merged = mergeEndpoints(configEndpoints, directoryEndpoints);
+    const endpoints = merged.length > 0 ? merged : [defaultEndpoint(defaultMode)];
+    const primary = endpoints[0] ?? defaultEndpoint(defaultMode);
     return {
-        enabled: readBoolean(env.MONO_AGENT_WEBHOOK_ENABLED, "MONO_AGENT_WEBHOOK_ENABLED", DEFAULT_ENABLED, invalidConfig),
-        host: readString(env.MONO_AGENT_WEBHOOK_HOST, DEFAULT_HOST),
-        port: readInteger(env.MONO_AGENT_WEBHOOK_PORT, "MONO_AGENT_WEBHOOK_PORT", DEFAULT_PORT, invalidConfig, { min: 0, max: 65535 }),
-        path: readString(env.MONO_AGENT_WEBHOOK_PATH, DEFAULT_PATH),
-        allowNonLoopback: readBoolean(env.MONO_AGENT_WEBHOOK_ALLOW_NON_LOOPBACK, "MONO_AGENT_WEBHOOK_ALLOW_NON_LOOPBACK", false, invalidConfig),
-        defaultMode: readChoice(env.MONO_AGENT_WEBHOOK_DEFAULT_MODE, "MONO_AGENT_WEBHOOK_DEFAULT_MODE", WEBHOOK_MODES, DEFAULT_MODE, invalidConfig),
-        retentionMs: readInteger(env.MONO_AGENT_WEBHOOK_RETENTION_MS, "MONO_AGENT_WEBHOOK_RETENTION_MS", DEFAULT_RETENTION_MS, invalidConfig, { min: 1, max: 86_400_000 }),
-        maxStoredRequests: readInteger(env.MONO_AGENT_WEBHOOK_MAX_STORED_REQUESTS, "MONO_AGENT_WEBHOOK_MAX_STORED_REQUESTS", DEFAULT_MAX_STORED_REQUESTS, invalidConfig, { min: 1, max: 10_000 }),
+        enabled,
+        host,
+        port,
+        allowNonLoopback,
+        retentionMs,
+        maxStoredRequests,
+        ...(maxRunMs === undefined ? {} : { maxRunMs }),
+        endpoints,
+        path: primary.path,
+        defaultMode: primary.mode,
     };
 }
 export function redactWebhookAdapterConfig(config) {
-    return { ...config };
+    return { ...config, endpoints: config.endpoints.map((endpoint) => ({ ...endpoint })) };
 }
-function layerWebhookJsonOntoEnv(json, env) {
+/**
+ * Endpoints defined inline in config: `MONO_AGENT_WEBHOOK_ENDPOINTS_JSON` (highest),
+ * then the `webhook.endpoints` array, then the single legacy `webhook.path`/`prompt`
+ * fields. Returns an empty list when nothing inline is configured (the webhook
+ * folder may still add endpoints, and a default endpoint is synthesized when both
+ * sources are empty).
+ */
+function loadConfigEndpoints(json, env, defaultMode) {
+    const endpointsJson = normalizeOptionalString(env.MONO_AGENT_WEBHOOK_ENDPOINTS_JSON);
+    if (endpointsJson !== undefined) {
+        return [...readEndpointsJson(endpointsJson, defaultMode)];
+    }
+    const section = readJsonSection(json, "webhook");
+    if (section.endpoints !== undefined) {
+        if (!Array.isArray(section.endpoints)) {
+            throw invalidConfig("webhook.endpoints must be an array of endpoint objects.");
+        }
+        return section.endpoints.map((entry, index) => normalizeEndpointConfig(entry, index, defaultMode));
+    }
+    const path = normalizeOptionalString(env.MONO_AGENT_WEBHOOK_PATH);
+    const prompt = normalizeOptionalString(env.MONO_AGENT_WEBHOOK_PROMPT);
+    const notify = readBoolean(env.MONO_AGENT_WEBHOOK_NOTIFY, "MONO_AGENT_WEBHOOK_NOTIFY", false, invalidConfig);
+    const notifyConversationId = normalizeOptionalString(env.MONO_AGENT_WEBHOOK_NOTIFY_CONVERSATION_ID);
+    const model = normalizeOptionalString(env.MONO_AGENT_WEBHOOK_MODEL);
+    const effort = normalizeOptionalString(env.MONO_AGENT_WEBHOOK_EFFORT);
+    if (path === undefined &&
+        prompt === undefined &&
+        !notify &&
+        notifyConversationId === undefined &&
+        model === undefined &&
+        effort === undefined) {
+        return [];
+    }
+    return [{
+            name: "default",
+            path: normalizePath(path ?? DEFAULT_PATH),
+            mode: defaultMode,
+            enabled: true,
+            ...(prompt === undefined ? {} : { prompt }),
+            ...(notify ? { notify } : {}),
+            ...(notifyConversationId === undefined ? {} : { notifyConversationId }),
+            ...(model === undefined ? {} : { model }),
+            ...(effort === undefined ? {} : { effort }),
+        }];
+}
+/**
+ * Endpoints authored as `*.md` files in the webhook folder. Skipped unless a
+ * base directory (`input.cwd`) is known, so a loader called without a host never
+ * scans the process working directory implicitly.
+ */
+async function loadDirectoryEndpoints(json, input, defaultMode) {
+    if (input.cwd === undefined) {
+        return [];
+    }
     const section = readJsonSection(json, "webhook");
-    return layerJsonOntoEnv(env, [
-        { env: "MONO_AGENT_WEBHOOK_ENABLED", value: section.enabled, kind: "boolean" },
-        { env: "MONO_AGENT_WEBHOOK_HOST", value: section.host },
-        { env: "MONO_AGENT_WEBHOOK_PORT", value: section.port, kind: "integer" },
-        { env: "MONO_AGENT_WEBHOOK_PATH", value: section.path },
-        { env: "MONO_AGENT_WEBHOOK_ALLOW_NON_LOOPBACK", value: section.allowNonLoopback, kind: "boolean" },
-        { env: "MONO_AGENT_WEBHOOK_DEFAULT_MODE", value: section.defaultMode },
-        { env: "MONO_AGENT_WEBHOOK_RETENTION_MS", value: section.retentionMs, kind: "integer" },
-        { env: "MONO_AGENT_WEBHOOK_MAX_STORED_REQUESTS", value: section.maxStoredRequests, kind: "integer" },
-    ]);
+    if (section.dir !== undefined && typeof section.dir !== "string") {
+        throw invalidConfig("webhook.dir must be a string.");
+    }
+    const dirName = normalizeOptionalString(input.dir) ??
+        normalizeOptionalString(input.env.MONO_AGENT_WEBHOOK_DIR) ??
+        asOptionalString(section.dir) ??
+        DEFAULT_WEBHOOK_DIR;
+    return await loadWebhookEndpointsFromDirectory(resolve(input.cwd, dirName), defaultMode);
+}
+/** Combine inline-config endpoints with folder endpoints; duplicate name or path is a hard error. */
+function mergeEndpoints(configEndpoints, directoryEndpoints) {
+    const merged = [];
+    const nameSource = new Map();
+    const pathSource = new Map();
+    const append = (endpoint, source) => {
+        const priorName = nameSource.get(endpoint.name);
+        if (priorName !== undefined) {
+            throw invalidConfig(`Duplicate webhook endpoint name "${endpoint.name}" from ${priorName} and ${source}.`, { name: endpoint.name });
+        }
+        const priorPath = pathSource.get(endpoint.path);
+        if (priorPath !== undefined) {
+            throw invalidConfig(`Duplicate webhook endpoint path "${endpoint.path}" from ${priorPath} and ${source}.`, { path: endpoint.path });
+        }
+        nameSource.set(endpoint.name, source);
+        pathSource.set(endpoint.path, source);
+        merged.push(endpoint);
+    };
+    for (const endpoint of configEndpoints) {
+        append(endpoint, "config");
+    }
+    for (const endpoint of directoryEndpoints) {
+        append(endpoint, "webhook folder");
+    }
+    return merged;
+}
+function defaultEndpoint(defaultMode) {
+    return { name: "default", path: DEFAULT_PATH, mode: defaultMode, enabled: true };
+}
+function readEndpointsJson(value, defaultMode) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw invalidConfig("MONO_AGENT_WEBHOOK_ENDPOINTS_JSON must contain valid JSON.", {
+            reason: error instanceof Error ? error.message : String(error),
+        });
+    }
+    if (!Array.isArray(parsed)) {
+        throw invalidConfig("MONO_AGENT_WEBHOOK_ENDPOINTS_JSON must be an array.");
+    }
+    return parsed.map((entry, index) => normalizeEndpointConfig(entry, index, defaultMode));
+}
+function normalizeEndpointConfig(entry, index, defaultMode) {
+    if (!isRecord(entry)) {
+        throw invalidConfig("Webhook endpoint entries must be objects.", { index });
+    }
+    const rawPath = asOptionalString(entry.path);
+    if (rawPath === undefined) {
+        throw invalidConfig("Webhook endpoints require a path.", { index });
+    }
+    const path = normalizePath(rawPath);
+    const mode = readEndpointMode(entry.mode, index, defaultMode);
+    const prompt = asOptionalString(entry.prompt);
+    const notify = asOptionalBoolean(entry.notify, "webhook.endpoints[].notify", { index });
+    const notifyConversationId = asOptionalString(entry.notifyConversationId);
+    const model = asOptionalString(entry.model);
+    const effort = asOptionalString(entry.effort);
+    const name = asOptionalString(entry.name) ?? deriveEndpointName(path);
+    const enabled = typeof entry.enabled === "boolean" ? entry.enabled : true;
+    return {
+        name,
+        path,
+        mode,
+        enabled,
+        ...(prompt === undefined ? {} : { prompt }),
+        ...(notify === undefined ? {} : { notify }),
+        ...(notifyConversationId === undefined ? {} : { notifyConversationId }),
+        ...(model === undefined ? {} : { model }),
+        ...(effort === undefined ? {} : { effort }),
+    };
+}
+function readEndpointMode(value, index, defaultMode) {
+    const mode = asOptionalString(value);
+    if (mode === undefined) {
+        return defaultMode;
+    }
+    if (mode !== "sync" && mode !== "async") {
+        throw invalidConfig("Webhook endpoint mode must be sync or async.", { index });
+    }
+    return mode;
+}
+/** Default an endpoint name to the last path segment (e.g. `/webhook/results` → `results`). */
+function deriveEndpointName(path) {
+    const segments = path.split("/").filter((segment) => segment.length > 0);
+    return segments[segments.length - 1] ?? "default";
+}
+/**
+ * The `webhook` section's field registry: the single source of truth both the
+ * JSON→env layering below and the app's config provenance view derive from.
+ * Covers the single-endpoint fields (multi-endpoint `endpoints[]` and `dir`
+ * are read straight from JSON / their own env forms).
+ */
+export const WEBHOOK_CONFIG_FIELDS = [
+    { id: "webhook.enabled", env: "MONO_AGENT_WEBHOOK_ENABLED", kind: "boolean", fromJson: (s) => s.enabled },
+    { id: "webhook.dir", env: "MONO_AGENT_WEBHOOK_DIR", fromJson: (s) => s.dir },
+    { id: "webhook.host", env: "MONO_AGENT_WEBHOOK_HOST", fromJson: (s) => s.host },
+    { id: "webhook.port", env: "MONO_AGENT_WEBHOOK_PORT", kind: "integer", fromJson: (s) => s.port },
+    { id: "webhook.path", env: "MONO_AGENT_WEBHOOK_PATH", fromJson: (s) => s.path },
+    { id: "webhook.prompt", env: "MONO_AGENT_WEBHOOK_PROMPT", fromJson: (s) => s.prompt },
+    { id: "webhook.notify", env: "MONO_AGENT_WEBHOOK_NOTIFY", kind: "boolean", fromJson: (s) => s.notify },
+    { id: "webhook.notifyConversationId", env: "MONO_AGENT_WEBHOOK_NOTIFY_CONVERSATION_ID", fromJson: (s) => s.notifyConversationId },
+    { id: "webhook.model", env: "MONO_AGENT_WEBHOOK_MODEL", fromJson: (s) => s.model },
+    { id: "webhook.effort", env: "MONO_AGENT_WEBHOOK_EFFORT", fromJson: (s) => s.effort },
+    { id: "webhook.allowNonLoopback", env: "MONO_AGENT_WEBHOOK_ALLOW_NON_LOOPBACK", kind: "boolean", fromJson: (s) => s.allowNonLoopback },
+    { id: "webhook.defaultMode", env: "MONO_AGENT_WEBHOOK_DEFAULT_MODE", fromJson: (s) => s.defaultMode },
+    { id: "webhook.retentionMs", env: "MONO_AGENT_WEBHOOK_RETENTION_MS", kind: "integer", fromJson: (s) => s.retentionMs },
+    { id: "webhook.maxStoredRequests", env: "MONO_AGENT_WEBHOOK_MAX_STORED_REQUESTS", kind: "integer", fromJson: (s) => s.maxStoredRequests },
+    { id: "webhook.maxRunMs", env: "MONO_AGENT_WEBHOOK_MAX_RUN_MS", kind: "integer", fromJson: (s) => s.maxRunMs },
+];
+function layerWebhookJsonOntoEnv(json, env) {
+    return layerJsonOntoEnv(env, fieldSpecMappings(readJsonSection(json, "webhook"), WEBHOOK_CONFIG_FIELDS));
+}
+/** Trim a JSON value to a non-empty string, treating non-strings as absent. */
+function asOptionalString(value) {
+    return typeof value === "string" ? normalizeOptionalString(value) : undefined;
+}
+function asOptionalBoolean(value, field, details) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (typeof value !== "boolean") {
+        throw invalidConfig(`${field} must be a boolean.`, { ...details, value });
+    }
+    return value;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/endpoints-dir.d.ts

@@ -0,0 +1,17 @@
+import type { WebhookEndpointConfig } from "./config.js";
+import { type WebhookInvocationMode } from "./server.js";
+/**
+ * Load every `*.md` webhook endpoint in {@link dir}. A missing directory is not
+ * an error (returns `[]`); files are read in sorted filename order for a stable
+ * endpoint list. Two files that resolve to the same `name` are a hard error.
+ */
+export declare function loadWebhookEndpointsFromDirectory(dir: string, defaultMode: WebhookInvocationMode): Promise<WebhookEndpointConfig[]>;
+/**
+ * Parse one webhook endpoint markdown file: frontmatter holds the routing
+ * metadata and the markdown body is the `prompt` (pre-instructions). `name`
+ * defaults to the filename stem, `mode` to the shared default, and `enabled` to
+ * true. Unlike cron jobs, the body may be empty — an endpoint with no prompt
+ * just forwards the posted text unchanged.
+ */
+export declare function parseWebhookEndpointMarkdown(fileName: string, content: string, defaultMode: WebhookInvocationMode): WebhookEndpointConfig;
+//# sourceMappingURL=endpoints-dir.d.ts.map

package/dist/endpoints-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints-dir.d.ts","sourceRoot":"","sources":["../src/endpoints-dir.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAsC,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAU7F;;;;GAIG;AACH,wBAAsB,iCAAiC,CACrD,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,qBAAqB,GACjC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAsClC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,qBAAqB,GACjC,qBAAqB,CAgCvB"}