@macula-io/mcp 0.3.0

package/dist/install/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/install/platform.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,gEAAgE;AAChE,oEAAoE;AACpE,4BAA4B;AAE5B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAYzC,MAAM,UAAU,MAAM;IACpB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,EAAE,CAAC;IAEvB,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7B,OAAO;QACL,EAAE;QACF,IAAI,EAAE,GAAG;QACT,KAAK,EAAE,GAAG,EAAE,IAAI,GAAG,EAAE;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,CAAkB;IAC/B,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACpC,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,MAAM,IAAI,KAAK,CACb,yBAAyB,CAAC,0CAA0C;QAClE,kEAAkE,CAAC,GAAG,CACzE,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,CAAS;IACxB,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IAClC,MAAM,IAAI,KAAK,CACb,qBAAqB,CAAC,kCAAkC,CACzD,CAAC;AACJ,CAAC"}

package/dist/macula_cli.d.ts

@@ -0,0 +1,88 @@
+/** The station this server targets when a tool call doesn't override it. */
+export declare function defaultStation(): string;
+export declare class MaculaCliUnavailable extends Error {
+}
+export declare class MaculaCliError extends Error {
+    readonly bolt4Code?: number | undefined;
+    readonly bolt4Name?: string | undefined;
+    readonly retryable?: boolean | undefined;
+    constructor(message: string, bolt4Code?: number | undefined, bolt4Name?: string | undefined, retryable?: boolean | undefined);
+}
+export interface IdentityResult {
+    node_id: string;
+    path: string;
+    generated: boolean;
+}
+export declare const identity: () => Promise<IdentityResult>;
+export interface CallResult {
+    procedure: string;
+    responded_by: string;
+    payload: unknown;
+    duration_ms: number;
+}
+export declare const call: (args: {
+    host?: string;
+    procedure: string;
+    callArgs?: Record<string, unknown>;
+    timeoutMs?: number;
+}) => Promise<CallResult>;
+export interface PublishResult {
+    topic: string;
+    seq: number;
+    duration_ms: number;
+}
+export declare const publish: (args: {
+    host?: string;
+    topic: string;
+    fact: Record<string, unknown>;
+}) => Promise<PublishResult>;
+export interface WatchEvent {
+    topic: string;
+    publisher: string;
+    seq: number;
+    payload: unknown;
+    delivered_via: string;
+    received_at: string;
+}
+/**
+ * Parses `macula-cli pubsub watch --json`'s stdout: one WatchEvent per
+ * line (NDJSON, not a single envelope -- run() assumes exactly one
+ * envelope and doesn't fit this shape). A real failure mid-watch (e.g.
+ * the connection drops after some events already arrived) prints as a
+ * trailing `{"ok":false,...}` envelope line -- checked by the presence
+ * of an "ok" key, not by JSON.parse throwing, since a wrong-shape
+ * object is still perfectly valid JSON and would otherwise silently
+ * end up in the events array instead of being surfaced as a failure.
+ * Exported standalone so this parsing can be unit-tested without
+ * spawning a real subprocess.
+ */
+export declare function parseWatchOutput(stdout: string): WatchEvent[];
+/**
+ * Watches a topic for up to durationSeconds and returns whatever
+ * arrived. Bounded and synchronous -- the MCP tool call itself blocks
+ * for the duration, which is the honest shape of a one-shot CLI with no
+ * background process to keep a standing subscription alive between
+ * calls.
+ */
+export declare const watch: (args: {
+    host?: string;
+    topic: string;
+    durationSeconds: number;
+    count?: number;
+}) => Promise<WatchEvent[]>;
+export interface ArtifactPutResult {
+    mcid_hex: string;
+    size_bytes: number;
+}
+export declare const artifactPut: (args: {
+    host?: string;
+    contentBase64: string;
+}) => Promise<ArtifactPutResult>;
+export interface ArtifactGetResult {
+    content: string;
+    size_bytes: number;
+}
+export declare const artifactGet: (args: {
+    host?: string;
+    mcidHex: string;
+}) => Promise<ArtifactGetResult>;

package/dist/macula_cli.js

@@ -0,0 +1,189 @@
+// Subprocess client for the `macula-cli` binary (macula-io/macula-cli).
+//
+// macula-mcp does NOT speak QUIC, DHT, or Macula RPC directly, and no
+// longer proxies to a local hecate-daemon (treated as obsolete -- it was
+// a leftover of an abandoned local browser/UI plan). It shells out to
+// macula-cli, a one-shot scriptable CLI built for exactly this: every
+// command takes --json and returns {ok, data} or {ok:false, error}.
+//
+//   agent harness  --MCP/stdio-->  macula-mcp  --spawns, parses stdout-->  macula-cli  --QUIC-->  mesh
+//
+// This is a deliberately lean rework (see macula-cli's own README/HOWTO
+// guide for the command set): no standing subscriptions, no activity/
+// inbox audit log, no peer listing -- macula-cli is a one-shot process
+// with no daemon and no storage, so none of those persist between
+// invocations. Point-in-time operations only.
+import { spawn } from "node:child_process";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir, homedir } from "node:os";
+import { join } from "node:path";
+/** The station this server targets when a tool call doesn't override it. */
+export function defaultStation() {
+    return process.env.MACULA_MESH_STATION ?? "station-de-frankfurt.macula.io:4433";
+}
+/** Name/path of the macula-cli binary; override for testing or a non-PATH install. */
+function binPath() {
+    return process.env.MACULA_CLI_BIN ?? "macula-cli";
+}
+/**
+ * A dedicated, persisted identity for mesh_watch, separate from
+ * macula-cli's own default identity (used by every other tool here).
+ *
+ * Found live (2026-08-29): a station kicks a connection the moment a
+ * SECOND connection arrives under the same node ID -- a real
+ * anti-duplicate-session guard, not a bug (see macula-cli's own HOWTO
+ * guide §1). mesh_watch holds a connection open for up to
+ * MAX_DURATION_SECONDS; any OTHER tool call (mesh_call, mesh_publish,
+ * ...) that fires while a watch is in flight would otherwise share the
+ * same default identity and silently kill the watcher's connection.
+ * A separate persisted identity for watch is the minimum fix that
+ * covers the common case (watch running alongside other calls) without
+ * paying a fresh puzzle-grind on every single tool call the way a
+ * per-invocation ephemeral identity would. Two CONCURRENT mesh_watch
+ * calls would still collide with each other -- not solved here, a
+ * known limitation, not a silent one.
+ */
+function watchIdentityPath() {
+    return process.env.MACULA_MCP_WATCH_IDENTITY ?? join(homedir(), ".macula-mcp", "watch-identity.seed");
+}
+export class MaculaCliUnavailable extends Error {
+}
+export class MaculaCliError extends Error {
+    bolt4Code;
+    bolt4Name;
+    retryable;
+    constructor(message, bolt4Code, bolt4Name, retryable) {
+        super(message);
+        this.bolt4Code = bolt4Code;
+        this.bolt4Name = bolt4Name;
+        this.retryable = retryable;
+    }
+}
+/**
+ * Builds a macula-cli argv: subcommand words, then --json and any other
+ * flags, then positionals -- in that order, always. Go's `flag` package
+ * stops parsing flags at the first non-flag argument, so a flag placed
+ * after a positional (a host, a procedure name, ...) is silently treated
+ * as an extra positional instead and the command fails its arg-count
+ * check. This bit macula-cli's own README/HOWTO guide enough to document
+ * as a top-line gotcha -- and bit this file too, appending --json at the
+ * very end, until caught running the built MCP server for real against a
+ * live macula-cli rather than just typechecking against it. One place to
+ * get the ordering right, not one per call site.
+ */
+function argv(subcommand, flags, positionals) {
+    return [...subcommand, "--json", ...flags, ...positionals];
+}
+/** Runs a macula-cli argv() and parses its JSON envelope. */
+async function run(args) {
+    const { stdout, stderr, code } = await execFile(binPath(), args);
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw new MaculaCliUnavailable(`macula-cli produced no parseable JSON (exit ${code}). stderr: ${stderr.trim() || "(empty)"}. ` +
+            `Is macula-cli installed and on PATH? See MACULA_CLI_BIN to point at a specific binary.`);
+    }
+    if (!parsed.ok) {
+        const e = parsed.error;
+        throw new MaculaCliError(e?.message ?? "macula-cli reported failure with no message", e?.bolt4_code, e?.bolt4_name, e?.retryable);
+    }
+    return parsed.data;
+}
+function execFile(bin, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { stdio: ["ignore", "pipe", "pipe"] });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (c) => (stdout += c.toString("utf8")));
+        child.stderr.on("data", (c) => (stderr += c.toString("utf8")));
+        child.on("error", (e) => reject(new MaculaCliUnavailable(`could not run '${bin}': ${e.message}. Install it (curl -fsSL https://raw.githubusercontent.com/macula-io/macula-cli/master/install.sh | bash) or set MACULA_CLI_BIN.`)));
+        child.on("close", (code) => resolve({ stdout, stderr, code }));
+    });
+}
+export const identity = () => run(argv(["identity"], [], []));
+export const call = (args) => {
+    const flags = [];
+    if (args.timeoutMs)
+        flags.push("--timeout", `${Math.max(1, Math.round(args.timeoutMs / 1000))}s`);
+    if (args.callArgs !== undefined)
+        flags.push("--args", JSON.stringify(args.callArgs));
+    return run(argv(["call"], flags, [args.host ?? defaultStation(), args.procedure]));
+};
+export const publish = (args) => run(argv(["pubsub", "publish"], ["--payload", JSON.stringify(args.fact)], [args.host ?? defaultStation(), args.topic]));
+/**
+ * Parses `macula-cli pubsub watch --json`'s stdout: one WatchEvent per
+ * line (NDJSON, not a single envelope -- run() assumes exactly one
+ * envelope and doesn't fit this shape). A real failure mid-watch (e.g.
+ * the connection drops after some events already arrived) prints as a
+ * trailing `{"ok":false,...}` envelope line -- checked by the presence
+ * of an "ok" key, not by JSON.parse throwing, since a wrong-shape
+ * object is still perfectly valid JSON and would otherwise silently
+ * end up in the events array instead of being surfaced as a failure.
+ * Exported standalone so this parsing can be unit-tested without
+ * spawning a real subprocess.
+ */
+export function parseWatchOutput(stdout) {
+    const events = [];
+    for (const line of stdout.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            continue; // not JSON at all; ignore this line
+        }
+        if (parsed !== null && typeof parsed === "object" && "ok" in parsed) {
+            const envelope = parsed;
+            if (envelope.ok === false) {
+                throw new MaculaCliError(envelope.error?.message ?? "pubsub watch failed");
+            }
+            continue; // an {"ok":true,...} envelope line isn't expected here, but skip rather than misparse it as an event
+        }
+        events.push(parsed);
+    }
+    return events;
+}
+/**
+ * Watches a topic for up to durationSeconds and returns whatever
+ * arrived. Bounded and synchronous -- the MCP tool call itself blocks
+ * for the duration, which is the honest shape of a one-shot CLI with no
+ * background process to keep a standing subscription alive between
+ * calls.
+ */
+export const watch = async (args) => {
+    const flags = ["--identity", watchIdentityPath(), "--duration", `${Math.max(1, Math.round(args.durationSeconds))}s`];
+    if (args.count)
+        flags.push("--count", String(args.count));
+    const full = argv(["pubsub", "watch"], flags, [args.host ?? defaultStation(), args.topic]);
+    const { stdout, stderr, code } = await execFile(binPath(), full);
+    const events = parseWatchOutput(stdout);
+    if (events.length === 0 && code !== 0 && stderr.trim()) {
+        throw new MaculaCliUnavailable(`macula-cli pubsub watch failed: ${stderr.trim()}`);
+    }
+    return events;
+};
+export const artifactPut = async (args) => {
+    const dir = await mkdtemp(join(tmpdir(), "macula-mcp-put-"));
+    const filePath = join(dir, "artifact");
+    try {
+        await writeFile(filePath, Buffer.from(args.contentBase64, "base64"));
+        const result = await run(argv(["content", "put"], [], [args.host ?? defaultStation(), filePath]));
+        return { mcid_hex: result.mcid, size_bytes: result.size_bytes };
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+};
+export const artifactGet = async (args) => {
+    const result = await run(argv(["content", "get"], [], [args.host ?? defaultStation(), args.mcidHex]));
+    if (!result.content_base64) {
+        throw new MaculaCliUnavailable("macula-cli content get returned no content_base64 (unexpected)");
+    }
+    return { content: result.content_base64, size_bytes: result.size_bytes };
+};
+//# sourceMappingURL=macula_cli.js.map

package/dist/macula_cli.js.map

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

package/dist/mesh_artifact.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMeshArtifact(server: McpServer): void;

package/dist/mesh_artifact.js

@@ -0,0 +1,63 @@
+// Tools: mesh_put / mesh_get — content-addressed artifact exchange.
+//
+// The Content Sharing primitive. An agent produces something (a build
+// output, a generated module, a dataset slice), puts it on the mesh, gets
+// back an MCID (Macula Content ID, 34-byte content hash, surfaced as
+// 68 hex chars). Another node's agent fetches it by that hex MCID.
+//
+// mesh_put writes the base64 content to a temp file and runs
+// `macula-cli content put`, deleting the temp file after -- macula-cli's
+// own put command is file-based (composable, scriptable, testable from a
+// real terminal too), while MCP's put tool hands over in-memory base64
+// bytes; the temp file is the bridge between those two shapes. mesh_get
+// needs no such bridge: `macula-cli content get --json` already returns
+// content_base64 directly in its envelope.
+//
+// No accountable fact_id anymore (that was hecate-daemon's ReckonDB audit
+// trail, dropped with the daemon).
+//
+// Caveat (memory: project_inter_station_routing_unshipped): DHT
+// replication is not fully shipped cross-station -- same-station
+// put/get is reliable, cross-station is best-effort.
+import { z } from "zod";
+import { artifactGet, artifactPut, defaultStation } from "./macula_cli.js";
+import { describeCliError, errorContent, jsonContent } from "./reply.js";
+export function registerMeshArtifact(server) {
+    server.tool("mesh_put", "Publish a content-addressed artifact to the mesh. Returns its 68-hex-char MCID. " +
+        `Fetch it elsewhere with mesh_get. Defaults to ${defaultStation()} if host isn't given.`, {
+        content: z.string().describe("Artifact bytes, base64-encoded."),
+        host: z
+            .string()
+            .optional()
+            .describe(`Station to connect through, "host[:port]". Defaults to ${defaultStation()}.`),
+    }, async ({ content, host }) => {
+        try {
+            const res = await artifactPut({ host, contentBase64: content });
+            return jsonContent({ mcid_hex: res.mcid_hex, size_bytes: res.size_bytes });
+        }
+        catch (e) {
+            return errorContent(describeCliError("mesh_put failed", e));
+        }
+    });
+    server.tool("mesh_get", "Fetch a content-addressed artifact from the mesh by its hex MCID (68 chars, " +
+        `as returned by mesh_put). Returns base64 content. Defaults to ${defaultStation()} if host isn't given.`, {
+        mcid_hex: z
+            .string()
+            .length(68)
+            .regex(/^[0-9a-fA-F]+$/, "must be hex")
+            .describe("MCID returned by mesh_put."),
+        host: z
+            .string()
+            .optional()
+            .describe(`Station to connect through, "host[:port]". Defaults to ${defaultStation()}.`),
+    }, async ({ mcid_hex, host }) => {
+        try {
+            const res = await artifactGet({ host, mcidHex: mcid_hex });
+            return jsonContent({ content: res.content, size_bytes: res.size_bytes });
+        }
+        catch (e) {
+            return errorContent(describeCliError("mesh_get failed", e));
+        }
+    });
+}
+//# sourceMappingURL=mesh_artifact.js.map

package/dist/mesh_artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh_artifact.js","sourceRoot":"","sources":["../src/mesh_artifact.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,qEAAqE;AACrE,mEAAmE;AACnE,EAAE;AACF,6DAA6D;AAC7D,yEAAyE;AACzE,yEAAyE;AACzE,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,2CAA2C;AAC3C,EAAE;AACF,0EAA0E;AAC1E,mCAAmC;AACnC,EAAE;AACF,gEAAgE;AAChE,iEAAiE;AACjE,qDAAqD;AAGrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,UAAU,EACV,kFAAkF;QAChF,iDAAiD,cAAc,EAAE,uBAAuB,EAC1F;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QAC/D,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,cAAc,EAAE,GAAG,CAAC;KAC3F,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;YAChE,OAAO,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,YAAY,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,UAAU,EACV,8EAA8E;QAC5E,iEAAiE,cAAc,EAAE,uBAAuB,EAC1G;QACE,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,MAAM,CAAC,EAAE,CAAC;aACV,KAAK,CAAC,gBAAgB,EAAE,aAAa,CAAC;aACtC,QAAQ,CAAC,4BAA4B,CAAC;QACzC,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,cAAc,EAAE,GAAG,CAAC;KAC3F,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3D,OAAO,WAAW,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC3E,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,YAAY,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mesh_call.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMeshCall(server: McpServer): void;

package/dist/mesh_call.js

@@ -0,0 +1,45 @@
+// Tool: mesh_call — invoke a procedure advertised on the mesh (REQUESTER).
+//
+// The agent's hands. A peer advertises a procedure; the agent calls it
+// over the mesh instead of a local sandbox or a US SaaS runner.
+// macula-cli does the actual macula:call over QUIC as a one-shot
+// subprocess (connect, call, exit) and returns the RESULT payload or a
+// BOLT#4-vocabulary error.
+//
+// Unlike the old daemon-backed version, this needs a target station:
+// macula-cli isn't already connected to one the way a standing daemon
+// was. `host` defaults to MACULA_MESH_STATION (or macula-cli's own
+// well-known demo station) so most callers never need to think about it.
+import { z } from "zod";
+import { call, defaultStation } from "./macula_cli.js";
+import { describeCliError, errorContent, jsonContent } from "./reply.js";
+export function registerMeshCall(server) {
+    server.tool("mesh_call", "Invoke a procedure advertised on the mesh (build, test, search, deploy on commons hardware). " +
+        "Macula RPC is procedure-addressed: the target station routes to a peer that advertises it. " +
+        `Returns the peer's result plus duration_ms. Defaults to ${defaultStation()} if host isn't given.`, {
+        procedure: z.string().describe("Procedure URI, e.g. mri:proc:realm:build."),
+        args: z
+            .record(z.unknown())
+            .optional()
+            .describe("Structured arguments for the procedure (plain JSON; macula-cli encodes the wire)."),
+        timeout_ms: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Deadline in milliseconds for the connect + call."),
+        host: z
+            .string()
+            .optional()
+            .describe(`Station to connect through, "host[:port]". Defaults to ${defaultStation()}.`),
+    }, async ({ procedure, args, timeout_ms, host }) => {
+        try {
+            const res = await call({ host, procedure, callArgs: args, timeoutMs: timeout_ms });
+            return jsonContent({ result: res.payload, responded_by: res.responded_by, duration_ms: res.duration_ms });
+        }
+        catch (e) {
+            return errorContent(describeCliError("mesh_call failed", e));
+        }
+    });
+}
+//# sourceMappingURL=mesh_call.js.map

package/dist/mesh_call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh_call.js","sourceRoot":"","sources":["../src/mesh_call.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,uEAAuE;AACvE,gEAAgE;AAChE,iEAAiE;AACjE,uEAAuE;AACvE,2BAA2B;AAC3B,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AACtE,mEAAmE;AACnE,yEAAyE;AAGzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,IAAI,CACT,WAAW,EACX,+FAA+F;QAC7F,6FAA6F;QAC7F,2DAA2D,cAAc,EAAE,uBAAuB,EACpG;QACE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;QAC3E,IAAI,EAAE,CAAC;aACJ,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;aACnB,QAAQ,EAAE;aACV,QAAQ,CAAC,mFAAmF,CAAC;QAChG,UAAU,EAAE,CAAC;aACV,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,kDAAkD,CAAC;QAC/D,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,cAAc,EAAE,GAAG,CAAC;KAC3F,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;YACnF,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC5G,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,YAAY,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mesh_identity.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerIdentity(server: McpServer): void;

package/dist/mesh_identity.js

@@ -0,0 +1,28 @@
+// Resource: who am I on the mesh.
+//
+// An agent SHOULD read this before it acts. macula-cli's identity is a
+// bare Ed25519 node ID -- no realm, no membership state, since macula-cli
+// is a raw wire-protocol client, not a realm-joined daemon (that concept
+// belonged to hecate-daemon, now dropped). Report what's actually true
+// rather than fake the fields the old daemon-backed shape had.
+//
+// mesh://peers was dropped, not reworked: it was already an admitted
+// stub even under the old daemon-backed design ("v1 surfaces an empty
+// list until hecate_mesh:get_peers/0 returns real data"), and
+// macula-go-sdk has no peer-listing API for macula-cli to wrap either.
+// A real stub in both directions isn't worth keeping around.
+import { identity } from "./macula_cli.js";
+export function registerIdentity(server) {
+    server.resource("mesh-identity", "mesh://identity", {
+        description: "This node's Ed25519 identity (node ID), minted and persisted locally by macula-cli.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const id = await identity();
+        return {
+            contents: [
+                { uri: uri.href, mimeType: "application/json", text: JSON.stringify(id, null, 2) },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=mesh_identity.js.map

package/dist/mesh_identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh_identity.js","sourceRoot":"","sources":["../src/mesh_identity.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,uEAAuE;AACvE,0EAA0E;AAC1E,yEAAyE;AACzE,uEAAuE;AACvE,+DAA+D;AAC/D,EAAE;AACF,qEAAqE;AACrE,sEAAsE;AACtE,8DAA8D;AAC9D,uEAAuE;AACvE,6DAA6D;AAG7D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,UAAU,gBAAgB,CAAC,MAAiB;IAChD,MAAM,CAAC,QAAQ,CACb,eAAe,EACf,iBAAiB,EACjB;QACE,WAAW,EAAE,qFAAqF;QAClG,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE;QACZ,MAAM,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC5B,OAAO;YACL,QAAQ,EAAE;gBACR,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;aACnF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mesh_publish.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMeshPublish(server: McpServer): void;

package/dist/mesh_publish.js

@@ -0,0 +1,33 @@
+// Tool: mesh_publish — emit an integration fact to a mesh topic.
+//
+// One-shot: macula-cli connects, publishes, exits. No delivery
+// confirmation beyond the wire send succeeding -- PUBLISH has no ack on
+// this protocol -- and no accountable event/fact_id anymore, since that
+// was hecate-daemon's own ReckonDB-backed audit trail, dropped along with
+// the daemon itself. `seq` is macula-cli's own current-time-millis
+// (see its README) since nothing here persists a real sequence counter
+// between one-shot invocations.
+import { z } from "zod";
+import { defaultStation, publish } from "./macula_cli.js";
+import { describeCliError, errorContent, jsonContent } from "./reply.js";
+export function registerMeshPublish(server) {
+    server.tool("mesh_publish", "Publish an integration fact to a mesh topic so other parties' agents can react. " +
+        "Use a business verb for the fact type (e.g. 'module_generated', 'capability_announced'), " +
+        `never CRUD. Returns the topic and seq macula-cli reported. Defaults to ${defaultStation()} if host isn't given.`, {
+        topic: z.string().describe("Topic name (e.g. 'agents.module_generated')."),
+        fact: z.record(z.unknown()).describe("The integration fact payload (plain JSON; macula-cli encodes the wire)."),
+        host: z
+            .string()
+            .optional()
+            .describe(`Station to connect through, "host[:port]". Defaults to ${defaultStation()}.`),
+    }, async ({ topic, fact, host }) => {
+        try {
+            const res = await publish({ host, topic, fact });
+            return jsonContent({ topic: res.topic, seq: res.seq, duration_ms: res.duration_ms });
+        }
+        catch (e) {
+            return errorContent(describeCliError("mesh_publish failed", e));
+        }
+    });
+}
+//# sourceMappingURL=mesh_publish.js.map

package/dist/mesh_publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh_publish.js","sourceRoot":"","sources":["../src/mesh_publish.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,+DAA+D;AAC/D,wEAAwE;AACxE,wEAAwE;AACxE,0EAA0E;AAC1E,mEAAmE;AACnE,uEAAuE;AACvE,gCAAgC;AAGhC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,IAAI,CACT,cAAc,EACd,kFAAkF;QAChF,2FAA2F;QAC3F,0EAA0E,cAAc,EAAE,uBAAuB,EACnH;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;QAC1E,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,yEAAyE,CAAC;QAC/G,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,cAAc,EAAE,GAAG,CAAC;KAC3F,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;QAC9B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACjD,OAAO,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACvF,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,YAAY,CAAC,gBAAgB,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/mesh_watch.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerMeshWatch(server: McpServer): void;

package/dist/mesh_watch.js

@@ -0,0 +1,53 @@
+// Tool: mesh_watch — bounded, synchronous replacement for the old
+// mesh_subscribe / mesh_unsubscribe / mesh_subscriptions / mesh_inbox
+// quartet.
+//
+// Those four tools leaned entirely on hecate-daemon's own event-sourced
+// state: a standing subscription that outlived any one HTTP call, and a
+// ReckonDB-backed inbox an agent could poll later. macula-cli has no
+// daemon and no storage -- nothing persists between invocations -- so
+// there is no honest way to preserve "register once, poll the inbox
+// later" without macula-mcp itself becoming a stateful daemon (a real
+// design fork, deliberately not taken here; see macula-io/macula-cli's
+// own project memory for the tradeoff that was weighed).
+//
+// mesh_watch is the shape that IS honest for a one-shot subprocess: the
+// tool call blocks for up to duration_seconds and returns whatever
+// arrived. An agent that wants "keep listening" calls it again.
+import { z } from "zod";
+import { defaultStation, watch } from "./macula_cli.js";
+import { describeCliError, errorContent, jsonContent } from "./reply.js";
+const MAX_DURATION_SECONDS = 120;
+export function registerMeshWatch(server) {
+    server.tool("mesh_watch", "Watch a mesh topic for inbound facts for up to duration_seconds, then return whatever " +
+        "arrived. This call BLOCKS for the full duration (or until count events arrive, " +
+        "whichever is first) -- there is no standing/background subscription to poll later; " +
+        `call this again to keep watching. Defaults to ${defaultStation()} if host isn't given.`, {
+        topic: z.string().describe("Topic name (e.g. 'chat.demo')."),
+        duration_seconds: z
+            .number()
+            .positive()
+            .max(MAX_DURATION_SECONDS)
+            .default(10)
+            .describe(`How long to watch, in seconds (max ${MAX_DURATION_SECONDS}).`),
+        count: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Stop early once this many events have arrived."),
+        host: z
+            .string()
+            .optional()
+            .describe(`Station to connect through, "host[:port]". Defaults to ${defaultStation()}.`),
+    }, async ({ topic, duration_seconds, count, host }) => {
+        try {
+            const events = await watch({ host, topic, durationSeconds: duration_seconds, count });
+            return jsonContent({ topic, event_count: events.length, events });
+        }
+        catch (e) {
+            return errorContent(describeCliError("mesh_watch failed", e));
+        }
+    });
+}
+//# sourceMappingURL=mesh_watch.js.map

package/dist/mesh_watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh_watch.js","sourceRoot":"","sources":["../src/mesh_watch.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,sEAAsE;AACtE,WAAW;AACX,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,sEAAsE;AACtE,oEAAoE;AACpE,sEAAsE;AACtE,uEAAuE;AACvE,yDAAyD;AACzD,EAAE;AACF,wEAAwE;AACxE,mEAAmE;AACnE,gEAAgE;AAGhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAEjC,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,wFAAwF;QACtF,iFAAiF;QACjF,qFAAqF;QACrF,iDAAiD,cAAc,EAAE,uBAAuB,EAC1F;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC5D,gBAAgB,EAAE,CAAC;aAChB,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,GAAG,CAAC,oBAAoB,CAAC;aACzB,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CAAC,sCAAsC,oBAAoB,IAAI,CAAC;QAC3E,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,gDAAgD,CAAC;QAC7D,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,cAAc,EAAE,GAAG,CAAC;KAC3F,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE;QACjD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,CAAC;YACtF,OAAO,WAAW,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,YAAY,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/reply.d.ts

@@ -0,0 +1,16 @@
+type ToolReply = {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+};
+export declare function jsonContent(value: unknown): ToolReply;
+export declare function errorContent(message: string): ToolReply;
+/**
+ * Formats an error caught from a macula_cli.ts call, surfacing the
+ * BOLT#4 code/name/retryable when present rather than a bare message —
+ * every tool that shells out to macula-cli wants this same shape.
+ */
+export declare function describeCliError(prefix: string, e: unknown): string;
+export {};

package/dist/reply.js

@@ -0,0 +1,24 @@
+// Small helpers for shaping MCP tool replies. Not a "utils" junk drawer —
+// just the reply shapes every tool returns.
+import { MaculaCliError } from "./macula_cli.js";
+export function jsonContent(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value, null, 2) }] };
+}
+export function errorContent(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/**
+ * Formats an error caught from a macula_cli.ts call, surfacing the
+ * BOLT#4 code/name/retryable when present rather than a bare message —
+ * every tool that shells out to macula-cli wants this same shape.
+ */
+export function describeCliError(prefix, e) {
+    if (e instanceof MaculaCliError) {
+        const bolt4 = e.bolt4Name
+            ? ` (bolt4=${e.bolt4Name}${e.retryable !== undefined ? `, retryable=${e.retryable}` : ""})`
+            : "";
+        return `${prefix}: ${e.message}${bolt4}`;
+    }
+    return `${prefix}: ${e instanceof Error ? e.message : String(e)}`;
+}
+//# sourceMappingURL=reply.js.map

package/dist/reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply.js","sourceRoot":"","sources":["../src/reply.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,4CAA4C;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,CAAU;IACzD,IAAI,CAAC,YAAY,cAAc,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS;YACvB,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;YAC3F,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,EAAE,CAAC;IAC3C,CAAC;IACD,OAAO,GAAG,MAAM,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC"}