@hotmeshio/long-tail 0.26.0 → 0.28.0

package/build/start/adapters.js

@@ -6,6 +6,8 @@ const pino_1 = require("../lib/logger/pino");
 const telemetry_1 = require("../lib/telemetry");
 const honeycomb_1 = require("../lib/telemetry/honeycomb");
 const events_1 = require("../lib/events");
+const messaging_1 = require("../lib/messaging");
+const config_1 = require("../lib/messaging/config");
 const nats_1 = require("../lib/events/nats");
 const socketio_1 = require("../lib/events/socketio");
 const maintenance_1 = require("../services/maintenance");
@@ -44,6 +46,10 @@ function registerAdapters(startConfig) {
     else if (startConfig.telemetry?.honeycomb) {
         telemetry_1.telemetryRegistry.register(new honeycomb_1.HoneycombTelemetryAdapter(startConfig.telemetry.honeycomb));
     }
+    // Messaging: one provider shared by events and the machine surface.
+    const messaging = (0, config_1.resolveMessaging)(startConfig);
+    if (messaging.provider)
+        messaging_1.messagingRegistry.register(messaging.provider);
     // Events — register the configured transport.
     // Socket.IO is the default for single-container ("nothing but Postgres").
     // When NATS or custom adapters are configured, Socket.IO is NOT registered —
@@ -54,8 +60,11 @@ function registerAdapters(startConfig) {
             events_1.eventRegistry.register(adapter);
         }
     }
-    else if (startConfig.events?.nats) {
-        events_1.eventRegistry.register(new nats_1.NatsEventAdapter(startConfig.events.nats));
+    else if (messaging.provider?.name === config_1.MESSAGING_KIND.NATS) {
+        events_1.eventRegistry.register(new nats_1.NatsEventAdapter({
+            messaging: messaging.provider, wsUrl: messaging.ws.url, wsProxy: messaging.ws.proxy, token: messaging.ws.token,
+            subjectPrefix: startConfig.events?.nats?.subjectPrefix,
+        }));
     }
     else {
         events_1.eventRegistry.register(new socketio_1.SocketIOEventAdapter({

package/build/start/apply-report.d.ts

@@ -18,7 +18,7 @@ export interface SurfaceReport {
 export declare function newSurfaceReport(): SurfaceReport;
 /** Record one entry's outcome on the surface report. */
 export declare function recordOutcome(report: SurfaceReport, name: string, outcome: ApplyOutcome): void;
-export declare function withConfigLock<T>(fn: () => Promise<T>): Promise<T>;
+export { withConfigLock } from '../lib/db/config-lock';
 /**
  * One boot line per surface. Warn level when orphans exist so operators see
  * "declared set no longer matches the DB" without grepping.

package/build/start/apply-report.js

@@ -1,11 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.withConfigLock = void 0;
 exports.ownedByCode = ownedByCode;
 exports.newSurfaceReport = newSurfaceReport;
 exports.recordOutcome = recordOutcome;
-exports.withConfigLock = withConfigLock;
 exports.logSurfaceReport = logSurfaceReport;
-const db_1 = require("../lib/db");
 const logger_1 = require("../lib/logger");
 /**
  * Effective ownership for one declared entry: the per-entry `reset` flag wins
@@ -26,29 +25,8 @@ function recordOutcome(report, name, outcome) {
     else
         report.dbOwned.push(name);
 }
-/**
- * Serializes multi-statement config writes (role-list replaces, escalation
- * target replaces) across concurrently booting containers. Single-statement
- * upserts are individually race-safe; the lock exists for the replace
- * transactions and keeps boot reports coherent. Distinct from the migration
- * lock so a slow migration on one container never blocks another's config
- * pass behind two locks at once.
- */
-const CONFIG_APPLY_LOCK_ID = 8675310;
-async function withConfigLock(fn) {
-    const pool = (0, db_1.getPool)();
-    const client = await pool.connect();
-    try {
-        await client.query(`SELECT pg_advisory_lock(${CONFIG_APPLY_LOCK_ID})`);
-        return await fn();
-    }
-    finally {
-        await client
-            .query(`SELECT pg_advisory_unlock(${CONFIG_APPLY_LOCK_ID})`)
-            .catch(() => { });
-        client.release();
-    }
-}
+var config_lock_1 = require("../lib/db/config-lock");
+Object.defineProperty(exports, "withConfigLock", { enumerable: true, get: function () { return config_lock_1.withConfigLock; } });
 /**
  * One boot line per surface. Warn level when orphans exist so operators see
  * "declared set no longer matches the DB" without grepping.

package/build/start/index.js

@@ -5,9 +5,12 @@ const hotmesh_1 = require("@hotmeshio/hotmesh");
 const logger_1 = require("../lib/logger");
 const telemetry_1 = require("../lib/telemetry");
 const events_1 = require("../lib/events");
+const messaging_1 = require("../lib/messaging");
 const callback_1 = require("../lib/events/callback");
 const surface_1 = require("../services/machines/surface");
+const machines_1 = require("../modules/machines");
 const roles_1 = require("../services/machines/roles");
+const registry_sync_1 = require("../services/machines/registry-sync");
 const maintenance_1 = require("../services/maintenance");
 const cron_1 = require("../services/cron");
 const mcp_1 = require("../services/mcp");
@@ -66,8 +69,12 @@ async function start(startConfig) {
     (0, config_1.applyDatabaseConfig)(startConfig.database);
     // 2. Apply server/auth config
     await (0, config_1.applyServerAuthConfig)(startConfig);
-    // 3. Register adapters
+    // 3. Register adapters; messaging connects first, since events and machines use it.
+    // An unreachable NATS is logged and Long Tail starts, as events always have; what needs streams fails then.
     (0, adapters_1.registerAdapters)(startConfig);
+    await messaging_1.messagingRegistry.connect().catch((err) => {
+        logger_1.loggerRegistry.error(`${messaging_1.MESSAGING_LOG.CONNECT_FAILED} ${err instanceof Error ? err.message : String(err)}`);
+    });
     logger_1.loggerRegistry.info('[long-tail] starting...');
     // 4-5. Collect workers, run migrations, start workers, seed data
     if (startConfig.machines && startConfig.machines.declareRoles !== false) {
@@ -75,10 +82,18 @@ async function start(startConfig) {
     }
     const { workers, builtinMcpServerFactories } = await (0, workers_1.collectWorkers)(startConfig);
     const { adminUserId } = await (0, workers_1.startWorkers)(startConfig, workers, builtinMcpServerFactories);
-    // 5b. Machines, after the workers exist so their rows publish lifecycle events
-    const machines = startConfig.machines
-        ? surface_1.MachineSurface.start({ ...startConfig.machines, callbacks: events_1.eventRegistry.getAdapter(callback_1.CallbackEventAdapter) })
-        : null;
+    // 5b. Machines, after the workers exist so their rows publish lifecycle events.
+    // Code lines land in the registry under the configSource rules; the surface runs every line the registry holds.
+    let machines = null;
+    let unwatchLines = null;
+    if (startConfig.machines) {
+        const callbacks = events_1.eventRegistry.getAdapter(callback_1.CallbackEventAdapter);
+        const { lines } = await (0, registry_sync_1.syncDeclaredLines)(startConfig.machines.lines, (startConfig.configSource ?? 'db') === 'code');
+        machines = surface_1.MachineSurface.start({ ...startConfig.machines, lines, callbacks });
+        if (callbacks)
+            unwatchLines = (0, registry_sync_1.watchLineRegistry)(machines, callbacks);
+    }
+    (0, machines_1.registerMachineSurface)(machines);
     // 6. Start embedded server (if enabled)
     const serverEnabled = startConfig.server?.enabled !== false;
     let httpServer = null;
@@ -96,7 +111,9 @@ async function start(startConfig) {
             await new Promise((resolve) => httpServer.close(() => resolve()));
         }
         if (machines) {
+            unwatchLines?.();
             await machines.stop();
+            (0, machines_1.registerMachineSurface)(null);
         }
         if (mcp_1.mcpRegistry.hasAdapter) {
             await mcp_1.mcpRegistry.disconnect();
@@ -110,6 +127,7 @@ async function start(startConfig) {
         if (events_1.eventRegistry.hasAdapters) {
             await events_1.eventRegistry.disconnect();
         }
+        await messaging_1.messagingRegistry.disconnect();
         if (telemetry_1.telemetryRegistry.hasAdapter) {
             await telemetry_1.telemetryRegistry.disconnect();
         }

package/build/system/index.js

@@ -60,6 +60,7 @@ const tool_manifests_workflows_1 = require("./seed/tool-manifests-workflows");
 const tool_manifests_admin_1 = require("./seed/tool-manifests-admin");
 const tool_manifests_knowledge_1 = require("./seed/tool-manifests-knowledge");
 const tool_manifests_events_1 = require("./seed/tool-manifests-events");
+const tool_manifests_machines_1 = require("./seed/tool-manifests-machines");
 // Example connectors — loaded conditionally (not in npm package)
 let GMAIL_TOOLS = [];
 try {
@@ -296,6 +297,18 @@ exports.builtinMcpServerFactories = {
             toolManifest: tool_manifests_data_1.SCHEMA_EXCHANGE_TOOLS,
         },
     },
+    'long-tail-machines': {
+        factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/machines'))).then((m) => m.createMachinesServer()),
+        config: {
+            description: 'The machine surface: the lines index with health, a line as its leader sees it, a wire message dry run, machine-command rows, and the registry\'s declare and retire.',
+            tags: ['machines', 'lines', 'mqtt', 'factory'],
+            category: 'Data',
+            compileHints: 'list_machine_lines answers which lines need attention; get_machine_line reads one line. ' +
+                'send_machine_command parks a machine-command row that the gateway resolves with the machine\'s reply; ' +
+                'read the row to learn the outcome. declare_machine_line and retire_machine_line change the registry and need admin.',
+            toolManifest: tool_manifests_machines_1.MACHINE_TOOLS,
+        },
+    },
     'long-tail-events': {
         factory: () => Promise.resolve().then(() => __importStar(require('./mcp-servers/events'))).then((m) => m.createEventsServer()),
         config: {

package/build/system/mcp-servers/admin/schemas.d.ts

@@ -210,14 +210,14 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     }, {
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     }>>;
     initiatedBy: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -229,8 +229,8 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     } | undefined;
     initiatedBy?: string | undefined;
 }, {
@@ -242,8 +242,8 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     } | undefined;
     initiatedBy?: string | undefined;
 }>;
@@ -1277,14 +1277,14 @@ export declare const applyThrottleSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     appId: string;
     throttle: number;
-    scope?: string | undefined;
     topic?: string | undefined;
+    scope?: string | undefined;
     guid?: string | undefined;
 }, {
     throttle: number;
+    topic?: string | undefined;
     appId?: string | undefined;
     scope?: string | undefined;
-    topic?: string | undefined;
     guid?: string | undefined;
 }>;
 export declare const getStreamStatsSchema: z.ZodObject<{
@@ -1320,10 +1320,10 @@ export declare const listStreamMessagesSchema: z.ZodObject<{
     offset: number;
     namespace: string;
     status?: string | undefined;
+    topic?: string | undefined;
     order?: "asc" | "desc" | undefined;
     sort_by?: string | undefined;
     workflow_name?: string | undefined;
-    topic?: string | undefined;
     jid?: string | undefined;
     stream_name?: string | undefined;
     msg_type?: string | undefined;
@@ -1331,12 +1331,12 @@ export declare const listStreamMessagesSchema: z.ZodObject<{
 }, {
     source: string;
     status?: string | undefined;
+    topic?: string | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     order?: "asc" | "desc" | undefined;
     sort_by?: string | undefined;
     workflow_name?: string | undefined;
-    topic?: string | undefined;
     jid?: string | undefined;
     namespace?: string | undefined;
     stream_name?: string | undefined;
@@ -1396,12 +1396,12 @@ export declare const interruptJobSchema: z.ZodObject<{
     topic: z.ZodString;
     app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
+    topic: string;
     app_id: string;
     job_id: string;
-    topic: string;
 }, {
-    job_id: string;
     topic: string;
+    job_id: string;
     app_id?: string | undefined;
 }>;
 export declare const listTopicsSchema: z.ZodObject<{
@@ -1435,15 +1435,15 @@ export declare const createTopicSchema: z.ZodObject<{
     example_payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
-    category: string;
     topic: string;
+    category: string;
     description?: string | undefined;
     tags?: string[] | undefined;
     payload_schema?: Record<string, any> | undefined;
     example_payload?: Record<string, any> | undefined;
 }, {
-    category: string;
     topic: string;
+    category: string;
     description?: string | undefined;
     tags?: string[] | undefined;
     payload_schema?: Record<string, any> | undefined;
@@ -2989,8 +2989,8 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             requireActingIdentity: z.ZodOptional<z.ZodBoolean>;
             code: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            label: string;
             verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "hold";
+            label: string;
             code?: string | undefined;
             confirm?: {
                 prompt: string;
@@ -3041,8 +3041,8 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             } | undefined;
             requireActingIdentity?: boolean | undefined;
         }, {
-            label: string;
             verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "hold";
+            label: string;
             code?: string | undefined;
             confirm?: {
                 prompt: string;
@@ -3148,6 +3148,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             markdown: string;
         }>>;
     }, "strip", z.ZodTypeAny, {
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3156,15 +3157,14 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             subtypes?: string[] | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         subject?: {
             schemes: number[];
             facets?: Record<string, string | number | boolean> | undefined;
             claimedByOther?: "refuse" | "allow" | undefined;
         } | undefined;
         choices?: {
-            label: string;
             verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "hold";
+            label: string;
             code?: string | undefined;
             confirm?: {
                 prompt: string;
@@ -3282,6 +3282,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
         }[] | undefined;
         autoSelectSingle?: boolean | undefined;
     }, {
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3290,15 +3291,14 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             subtypes?: string[] | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         subject?: {
             schemes: number[];
             facets?: Record<string, string | number | boolean> | undefined;
             claimedByOther?: "refuse" | "allow" | undefined;
         } | undefined;
         choices?: {
-            label: string;
             verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "hold";
+            label: string;
             code?: string | undefined;
             confirm?: {
                 prompt: string;
@@ -3442,6 +3442,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
     category: string;
     scheme_version: number;
     steps: {
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3450,15 +3451,14 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             subtypes?: string[] | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         subject?: {
             schemes: number[];
             facets?: Record<string, string | number | boolean> | undefined;
             claimedByOther?: "refuse" | "allow" | undefined;
         } | undefined;
         choices?: {
-            label: string;
             verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "hold";
+            label: string;
             code?: string | undefined;
             confirm?: {
                 prompt: string;
@@ -3590,6 +3590,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
     category: string;
     scheme_version: number;
     steps: {
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3598,15 +3599,14 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             subtypes?: string[] | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
         subject?: {
             schemes: number[];
             facets?: Record<string, string | number | boolean> | undefined;
             claimedByOther?: "refuse" | "allow" | undefined;
         } | undefined;
         choices?: {
-            label: string;
             verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "hold";
+            label: string;
             code?: string | undefined;
             confirm?: {
                 prompt: string;

package/build/system/mcp-servers/human-queue-schemas.d.ts

@@ -11,8 +11,8 @@ export declare const escalateSchema: z.ZodObject<{
     role: string;
     subtype: string;
     type: string;
-    priority: number;
     message: string;
+    priority: number;
     schema_version?: number | undefined;
     data?: Record<string, any> | undefined;
 }, {
@@ -69,12 +69,12 @@ export declare const resolveBatchItemSchema: z.ZodObject<{
     item_key: z.ZodString;
     payload: z.ZodRecord<z.ZodString, z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
-    item_key: string;
     payload: Record<string, any>;
+    item_key: string;
     escalation_id: string;
 }, {
-    item_key: string;
     payload: Record<string, any>;
+    item_key: string;
     escalation_id: string;
 }>;
 export declare const accumulateItemSchema: z.ZodObject<{
@@ -91,14 +91,14 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     }, {
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     item_key: string;
@@ -108,8 +108,8 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     } | undefined;
 }, {
     item_key: string;
@@ -119,8 +119,8 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     } | undefined;
 }>;
 export declare const removeItemSchema: z.ZodObject<{

package/build/system/mcp-servers/machines-schemas.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+export declare const listMachineLinesSchema: {
+    q: z.ZodOptional<z.ZodString>;
+    site: z.ZodOptional<z.ZodString>;
+    attention: z.ZodOptional<z.ZodBoolean>;
+    sort: z.ZodOptional<z.ZodEnum<["attention", "site", "updated"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+};
+export declare const getMachineLineSchema: {
+    siteId: z.ZodString;
+    lineId: z.ZodString;
+};
+export declare const inspectMachineMessageSchema: {
+    topic: z.ZodString;
+    payload: z.ZodOptional<z.ZodAny>;
+    retained: z.ZodOptional<z.ZodBoolean>;
+    siteId: z.ZodString;
+    lineId: z.ZodString;
+};
+export declare const sendMachineCommandSchema: {
+    machineId: z.ZodString;
+    op: z.ZodString;
+    args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    siteId: z.ZodString;
+    lineId: z.ZodString;
+};
+export declare const declareMachineLineSchema: {
+    definition: z.ZodRecord<z.ZodString, z.ZodAny>;
+    version: z.ZodOptional<z.ZodNumber>;
+};
+export declare const retireMachineLineSchema: {
+    siteId: z.ZodString;
+    lineId: z.ZodString;
+};

package/build/system/mcp-servers/machines-schemas.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.retireMachineLineSchema = exports.declareMachineLineSchema = exports.sendMachineCommandSchema = exports.inspectMachineMessageSchema = exports.getMachineLineSchema = exports.listMachineLinesSchema = void 0;
+const zod_1 = require("zod");
+/** Zod input schemas for the machines MCP server; the manifest mirrors them as JSON schema. */
+const siteLine = {
+    siteId: zod_1.z.string().min(1).describe('Site id'),
+    lineId: zod_1.z.string().min(1).describe('Line id'),
+};
+exports.listMachineLinesSchema = {
+    q: zod_1.z.string().optional().describe('Search site, line, machine ids, processes, roles and addresses'),
+    site: zod_1.z.string().optional().describe('Only this site'),
+    attention: zod_1.z.boolean().optional().describe('Only lines with an offline machine, an active alarm or a row waiting on a person'),
+    sort: zod_1.z.enum(['attention', 'site', 'updated']).optional().describe('attention first (default), site, or recently changed'),
+    limit: zod_1.z.number().int().min(1).max(200).optional(),
+    offset: zod_1.z.number().int().min(0).optional(),
+};
+exports.getMachineLineSchema = { ...siteLine };
+exports.inspectMachineMessageSchema = {
+    ...siteLine,
+    topic: zod_1.z.string().min(1).describe('The MQTT topic the message would arrive on'),
+    payload: zod_1.z.any().optional().describe('The message body: an object is serialized as JSON, a string passes through'),
+    retained: zod_1.z.boolean().optional().describe('Whether the broker would deliver it as retained'),
+};
+exports.sendMachineCommandSchema = {
+    ...siteLine,
+    machineId: zod_1.z.string().min(1).describe('The machine on the line'),
+    op: zod_1.z.string().min(1).describe('A control op, snapshot, or an op the line\'s codec declares'),
+    args: zod_1.z.record(zod_1.z.any()).optional().describe('Arguments the op takes, such as jobId or recipe'),
+};
+exports.declareMachineLineSchema = {
+    definition: zod_1.z.record(zod_1.z.any()).describe('The line definition: siteId, lineId, machines in route order (machineId, process, cycleSec), roles, addressing'),
+    version: zod_1.z.number().int().min(1).optional().describe('The version the row is expected to be at; a mismatch is a conflict'),
+};
+exports.retireMachineLineSchema = { ...siteLine };

package/build/system/mcp-servers/machines.d.ts

@@ -0,0 +1,20 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const MACHINES_SERVER_NAME = "long-tail-machines";
+export declare const MACHINE_TOOL: {
+    readonly LIST: "list_machine_lines";
+    readonly GET: "get_machine_line";
+    readonly INSPECT: "inspect_machine_message";
+    readonly COMMAND: "send_machine_command";
+    readonly DECLARE: "declare_machine_line";
+    readonly RETIRE: "retire_machine_line";
+};
+/**
+ * The machines MCP server: the Lines index and views, a message dry run,
+ * command rows, and the registry's declare and retire, for agents.
+ */
+export declare function createMachinesServer(options?: {
+    name?: string;
+    fresh?: boolean;
+}): Promise<McpServer>;
+export declare function getMachinesServer(): McpServer | null;
+export declare function stopMachinesServer(): Promise<void>;