@hotmeshio/long-tail 0.27.0 → 0.28.0

package/build/services/machines/surface.js

@@ -4,11 +4,18 @@
  * controls, one replica leads (an advisory lock), makes sure the line's bot
  * accounts exist, and runs the gateway: escalation events in, machine
  * messages in, verbs performed in process as each machine. Workflows never
- * see any of it; their rows are resolved the way a form resolves them.
+ * see any of it; their rows are resolved the way a form resolves them. The
+ * surface also describes its lines for the dashboard: every replica lists
+ * them, and the leader of a line projects it.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MachineSurface = void 0;
 exports.surfaceConfig = surfaceConfig;
+exports.summarizeLine = summarizeLine;
+exports.commandOpsOf = commandOpsOf;
+const node_util_1 = require("node:util");
+const line_1 = require("../../lib/machines/line");
+const protocol_1 = require("../../lib/machines/protocol");
 const config_1 = require("./config");
 const api_escalations_1 = require("./gateway/api-escalations");
 const gateway_1 = require("./gateway/gateway");
@@ -24,20 +31,42 @@ function surfaceConfig(env) {
     }
     return (0, config_1.loadMachineLineConfig)({ ...env, MACHINE_ESCALATION_FEED: env.MACHINE_ESCALATION_FEED ?? config_1.ESCALATION_FEED.IN_PROCESS });
 }
+/** The line as every replica can describe it: its machines, roles, declared addresses and the codec's own ops. */
+function summarizeLine(line, codec) {
+    const rowOps = (0, protocol_1.declaredRowOps)(codec);
+    return {
+        siteId: line.siteId, lineId: line.lineId,
+        machines: line.machines.map((m) => {
+            const learned = (0, line_1.learnsAddress)(line, m.machineId);
+            return {
+                machineId: m.machineId, process: m.process, role: (0, line_1.machineRole)(m),
+                address: learned ? null : m.address ?? m.machineId, addressing: learned ? 'learned' : 'declared',
+                ...(rowOps.length ? { rowOps } : {}),
+            };
+        }),
+    };
+}
+/** The ops a machine-command row may ask for: the control ops, a snapshot, and the codec's own. */
+function commandOpsOf(codec) {
+    return [...new Set([...protocol_1.CONTROL_OPS, protocol_1.OP.SNAPSHOT, ...(0, protocol_1.declaredRowOps)(codec)])];
+}
 class LineRun {
     constructor(line, config, opts, log) {
         this.line = line;
         this.config = config;
         this.opts = opts;
         this.log = log;
+        this.ready = false;
         this.stopped = false;
         this.leadership = new leadership_1.LineLeadership(`lt-machine-line:${line.siteId}/${line.lineId}`);
+        this.codec = opts.codec ?? (0, select_1.defaultCodec)(config, line);
     }
     start() {
         const where = { site: this.line.siteId, line: this.line.lineId };
         this.log.info(log_1.GATEWAY_LOG.STANDBY, where);
         this.leadership.run(() => (this.leading = this.lead()), async (err) => {
             this.log.warn(log_1.GATEWAY_LOG.LEADERSHIP_LOST, { ...where, error: err.message });
+            this.ready = false;
             await this.gateway?.stop();
             this.gateway = undefined;
         }).catch((err) => this.log.error(log_1.GATEWAY_LOG.START_FAILED, { ...where, error: err.message }));
@@ -45,10 +74,15 @@ class LineRun {
     /** A gateway still starting finishes first, so none is left running after stop. */
     async stop() {
         this.stopped = true;
+        this.ready = false;
         await this.leading?.catch(() => undefined);
         await this.gateway?.stop();
         await this.leadership.stop();
     }
+    /** The gateway, once it leads the line. */
+    leader() {
+        return this.ready ? this.gateway : undefined;
+    }
     async lead() {
         // 1. Identities, 2. gateway on the line's bus and feed, 3. reconcile and consume (gateway.start)
         const ids = await (0, identities_1.ensureLineBots)(this.line);
@@ -60,8 +94,7 @@ class LineRun {
                 throw new Error(`no bot for "${as}" on ${this.line.siteId}/${this.line.lineId}`);
             return id;
         };
-        const { config, line } = this;
-        const codec = this.opts.codec ?? (0, select_1.defaultCodec)(config, line);
+        const { config, line, codec } = this;
         this.gateway = new gateway_1.MachineGateway({
             bus: (0, select_1.createMachineBus)(config, line, codec),
             codec,
@@ -74,31 +107,78 @@ class LineRun {
             settings: {
                 topicRoot: config.topicRoot, replyTimeoutMs: config.replyTimeoutMs, dispatchAttempts: config.dispatchAttempts,
                 offlineDebounceMs: config.offlineDebounceMs, dispatchTtlMs: config.dispatchTtlMs, quietMs: config.quietMs,
-                receiptDelayMs: config.receiptDelayMs, lifecycle: config.lifecycle, progressStep: config.progressStep,
+                receiptDelayMs: config.receiptDelayMs, lifecycle: config.lifecycle, progressStep: config.progressStep, wireTelemetry: config.wireTelemetry,
             },
         });
         await this.gateway.start();
+        this.ready = true;
         this.log.info(log_1.GATEWAY_LOG.LEADING, { site: line.siteId, line: line.lineId });
     }
 }
 class MachineSurface {
-    constructor(runs) {
-        this.runs = runs;
+    constructor(config, opts, log) {
+        this.config = config;
+        this.opts = opts;
+        this.log = log;
+        this.runs = new Map();
     }
-    /** Validate the configuration, then contend for every line in the background. */
+    /** Validate the configuration, then contend for every line in the background. The registry may add lines later. */
     static start(opts) {
-        if (!opts.lines.length)
-            throw new Error('start({ machines }) needs at least one line');
         const config = surfaceConfig(opts.env ?? process.env);
-        const log = opts.log ?? log_1.consoleLog;
-        const runs = opts.lines.map((line) => new LineRun(line, config, opts, log));
-        for (const run of runs)
-            run.start();
-        return new MachineSurface(runs);
+        const surface = new MachineSurface(config, opts, opts.log ?? log_1.consoleLog);
+        for (const line of opts.lines)
+            surface.begin(line);
+        return surface;
     }
     async stop() {
-        for (const run of this.runs)
+        for (const run of this.runs.values())
             await run.stop();
+        this.runs.clear();
+    }
+    async declare(line) {
+        const current = this.run(line.siteId, line.lineId);
+        if (current && (0, node_util_1.isDeepStrictEqual)(current.line, line))
+            return 'unchanged';
+        if (current)
+            await current.stop();
+        this.begin(line);
+        return current ? 'replaced' : 'started';
+    }
+    async retire(siteId, lineId) {
+        const current = this.run(siteId, lineId);
+        if (!current)
+            return false;
+        this.runs.delete(keyOf(siteId, lineId));
+        await current.stop();
+        return true;
+    }
+    describeLines() {
+        return [...this.runs.values()].map((run) => summarizeLine(run.line, run.codec));
+    }
+    describeLine(siteId, lineId) {
+        const gateway = this.run(siteId, lineId)?.leader();
+        return gateway ? gateway.state.project(this.findLine(siteId, lineId)) : null;
+    }
+    inspect(siteId, lineId, probe) {
+        return this.run(siteId, lineId)?.leader()?.inspect(probe) ?? null;
+    }
+    findLine(siteId, lineId) {
+        return this.run(siteId, lineId)?.line;
+    }
+    commandOps(siteId, lineId) {
+        const run = this.run(siteId, lineId);
+        return run ? commandOpsOf(run.codec) : [];
+    }
+    begin(line) {
+        const run = new LineRun(line, this.config, this.opts, (0, log_1.composeLogs)(this.log, (0, log_1.eventsLog)(line)));
+        this.runs.set(keyOf(line.siteId, line.lineId), run);
+        run.start();
+    }
+    run(siteId, lineId) {
+        return this.runs.get(keyOf(siteId, lineId));
     }
 }
 exports.MachineSurface = MachineSurface;
+function keyOf(siteId, lineId) {
+    return `${siteId}/${lineId}`;
+}

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

@@ -8,7 +8,9 @@ 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");
@@ -80,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;
@@ -101,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();

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 };