@blxzer/cursor-trellis 0.3.4 → 0.3.6

package/dist/commands/rpc/client.js

@@ -0,0 +1,147 @@
+import { randomUUID } from "node:crypto";
+import { RPC_PROTOCOL_VERSION, parseRpcAddress, } from "@blxzer/cursor-trellis-core/rpc";
+export const DEFAULT_RPC_URL = "http://127.0.0.1:7843";
+export function resolveRpcUrl(explicit) {
+    const fromArg = explicit?.trim();
+    if (fromArg)
+        return fromArg;
+    const fromEnv = process.env.TRELLIS_RPC_URL?.trim();
+    if (fromEnv)
+        return fromEnv;
+    return DEFAULT_RPC_URL;
+}
+export function resolveRpcToken(explicit) {
+    const fromArg = explicit?.trim();
+    if (fromArg)
+        return fromArg;
+    const fromEnv = process.env.TRELLIS_RPC_TOKEN?.trim();
+    if (fromEnv)
+        return fromEnv;
+    return undefined;
+}
+/** Parse `kind:id` address strings. */
+export function parseAddressArg(value) {
+    const idx = value.indexOf(":");
+    if (idx <= 0 || idx === value.length - 1) {
+        throw new Error(`Invalid address '${value}'. Expected kind:id (e.g. worker:w1)`);
+    }
+    return parseRpcAddress({
+        kind: value.slice(0, idx),
+        id: value.slice(idx + 1),
+    });
+}
+export function formatAddress(address) {
+    return `${address.kind}:${address.id}`;
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+export async function postRpc(url, body) {
+    const res = await fetch(`${url.replace(/\/$/, "")}/rpc`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    const json = (await res.json());
+    return json;
+}
+export async function getJson(url, path) {
+    const res = await fetch(`${url.replace(/\/$/, "")}${path}`);
+    if (!res.ok) {
+        throw new Error(`HTTP ${res.status} for ${path}`);
+    }
+    return res.json();
+}
+export function buildReq(options) {
+    const payload = { ...(options.payload ?? {}) };
+    if (options.token !== undefined) {
+        payload.token = options.token;
+    }
+    return {
+        v: RPC_PROTOCOL_VERSION,
+        id: randomUUID(),
+        type: "req",
+        method: options.method,
+        from: options.from,
+        ...(options.to !== undefined ? { to: options.to } : {}),
+        ...(options.topic !== undefined ? { topic: options.topic } : {}),
+        ...(options.campaignId !== undefined
+            ? { campaignId: options.campaignId }
+            : {}),
+        ...(options.correlationId !== undefined
+            ? { correlationId: options.correlationId }
+            : {}),
+        ts: nowIso(),
+        payload,
+    };
+}
+export async function rpcRegister(options) {
+    const from = { kind: options.kind, id: options.id };
+    return postRpc(options.url, buildReq({
+        method: "register",
+        from,
+        campaignId: options.campaignId ?? null,
+        token: options.token,
+        payload: {
+            kind: options.kind,
+            id: options.id,
+            ...(options.campaignId ? { campaignId: options.campaignId } : {}),
+        },
+    }));
+}
+export async function rpcSend(options) {
+    return postRpc(options.url, buildReq({
+        method: "send",
+        from: options.from,
+        to: options.to,
+        token: options.token,
+        payload: { body: options.body },
+    }));
+}
+export async function rpcSubscribe(options) {
+    return postRpc(options.url, buildReq({
+        method: "subscribe",
+        from: options.from,
+        topic: options.topic,
+        token: options.token,
+        payload: {},
+    }));
+}
+export async function rpcPublish(options) {
+    return postRpc(options.url, buildReq({
+        method: "publish",
+        from: options.from,
+        topic: options.topic,
+        campaignId: options.campaignId ?? null,
+        token: options.token,
+        payload: { body: options.body },
+    }));
+}
+export function parseJsonObject(raw, flag) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`${flag} must be valid JSON object`);
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`${flag} must be a JSON object`);
+    }
+    return parsed;
+}
+export function printEnvelope(envelope, json) {
+    if (json) {
+        console.log(JSON.stringify(envelope, null, 2));
+        return;
+    }
+    if (envelope.error) {
+        console.error(`RPC error ${envelope.error.code}: ${envelope.error.message}`);
+        return;
+    }
+    console.log(JSON.stringify(envelope.payload, null, 2));
+}
+export function exitForEnvelope(envelope) {
+    return envelope.error ? 1 : 0;
+}
+//# sourceMappingURL=client.js.map

package/dist/commands/rpc/client.js.map

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

package/dist/commands/rpc/index.d.ts

@@ -0,0 +1,10 @@
+import { type Command } from "commander";
+/**
+ * Register `cstl rpc` — localhost RPC-FULL CORE control plane.
+ * Does not replace durable `channel` event logs. Does not auto-approve HITL gates.
+ */
+export declare function registerRpcCommand(program: Command): void;
+export { startRpcServe, runRpcServeCommand, type RpcServeOptions, type RpcServeHandle, } from "./serve.js";
+export { runRpcSmoke, type RpcSmokeResult } from "./smoke.js";
+export { resolveRpcUrl, resolveRpcToken, parseAddressArg, postRpc, rpcRegister, rpcSend, rpcSubscribe, rpcPublish, getJson, } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/rpc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/rpc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAuC/D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA+LzD;AAED,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,eAAe,EACf,eAAe,EACf,OAAO,EACP,WAAW,EACX,OAAO,EACP,YAAY,EACZ,UAAU,EACV,OAAO,GACR,MAAM,aAAa,CAAC"}

package/dist/commands/rpc/index.js

@@ -0,0 +1,157 @@
+import { InvalidArgumentError } from "commander";
+import { RPC_ADDRESS_KINDS, } from "@blxzer/cursor-trellis-core/rpc";
+import { exitForEnvelope, getJson, parseAddressArg, parseJsonObject, printEnvelope, resolveRpcToken, resolveRpcUrl, rpcPublish, rpcRegister, rpcSend, rpcSubscribe, } from "./client.js";
+import { runRpcServeCommand } from "./serve.js";
+import { runRpcSmoke } from "./smoke.js";
+function parsePort(value) {
+    if (!/^\d+$/.test(value)) {
+        throw new InvalidArgumentError(`expected port integer, got '${value}'`);
+    }
+    return Number(value);
+}
+function parseKind(value) {
+    if (!RPC_ADDRESS_KINDS.includes(value)) {
+        throw new InvalidArgumentError(`kind must be one of: ${RPC_ADDRESS_KINDS.join(", ")}`);
+    }
+    return value;
+}
+/**
+ * Register `cstl rpc` — localhost RPC-FULL CORE control plane.
+ * Does not replace durable `channel` event logs. Does not auto-approve HITL gates.
+ */
+export function registerRpcCommand(program) {
+    const rpc = program
+        .command("rpc")
+        .description("Localhost RPC-FULL CORE broker (register/send/push/topics). Non-goals: multi-machine, A2A impl, ops console. Never auto-approves Trellis HITL gates.");
+    rpc
+        .command("serve")
+        .description("Start localhost broker on 127.0.0.1 (HTTP+/WS). Non-goals: multi-machine / A2A / ops console.")
+        .option("--host <host>", "loopback host only", "127.0.0.1")
+        .option("--port <port>", "listen port (0 = ephemeral)", parsePort, 7843)
+        .option("--token <token>", "shared local token (or TRELLIS_RPC_TOKEN)")
+        .option("--journal-dir <dir>", "audit journal directory (default: ~/.cstl/rpc)")
+        .option("--no-journal", "disable on-disk audit journal")
+        .action(async (opts) => {
+        const code = await runRpcServeCommand({
+            host: opts.host,
+            port: opts.port,
+            token: resolveRpcToken(opts.token),
+            journalDir: opts.journal === false ? null : opts.journalDir,
+        });
+        process.exitCode = code;
+    });
+    rpc
+        .command("status")
+        .description("Fetch broker status snapshot")
+        .option("--url <url>", "broker base URL (or TRELLIS_RPC_URL)")
+        .option("--json", "print raw JSON")
+        .action(async (opts) => {
+        const url = resolveRpcUrl(opts.url);
+        const status = await getJson(url, "/status");
+        console.log(JSON.stringify(status, null, opts.json ? 2 : 2));
+    });
+    rpc
+        .command("register")
+        .description("Register a client address with the broker")
+        .requiredOption("--kind <kind>", "worker|session|cli|sdk|broker", parseKind)
+        .requiredOption("--id <id>", "address id")
+        .option("--campaign <id>", "optional campaign id")
+        .option("--url <url>", "broker base URL")
+        .option("--token <token>", "shared local token")
+        .option("--json", "print full envelope JSON")
+        .action(async (opts) => {
+        const envelope = await rpcRegister({
+            url: resolveRpcUrl(opts.url),
+            kind: opts.kind,
+            id: opts.id,
+            campaignId: opts.campaign,
+            token: resolveRpcToken(opts.token),
+        });
+        printEnvelope(envelope, Boolean(opts.json));
+        process.exitCode = exitForEnvelope(envelope);
+    });
+    rpc
+        .command("send")
+        .description("Send an addressable one-way message")
+        .requiredOption("--from <addr>", "kind:id sender")
+        .requiredOption("--to <addr>", "kind:id recipient")
+        .option("--body <json>", "JSON object payload", "{}")
+        .option("--url <url>", "broker base URL")
+        .option("--token <token>", "shared local token")
+        .option("--json", "print full envelope JSON")
+        .action(async (opts) => {
+        const envelope = await rpcSend({
+            url: resolveRpcUrl(opts.url),
+            from: parseAddressArg(opts.from),
+            to: parseAddressArg(opts.to),
+            body: parseJsonObject(opts.body, "--body"),
+            token: resolveRpcToken(opts.token),
+        });
+        printEnvelope(envelope, Boolean(opts.json));
+        process.exitCode = exitForEnvelope(envelope);
+    });
+    rpc
+        .command("subscribe")
+        .description("Subscribe an address to a campaign topic")
+        .requiredOption("--from <addr>", "kind:id subscriber")
+        .requiredOption("--topic <topic>", "campaign:<id>:broadcast|stage:<sid>")
+        .option("--url <url>", "broker base URL")
+        .option("--token <token>", "shared local token")
+        .option("--json", "print full envelope JSON")
+        .action(async (opts) => {
+        const envelope = await rpcSubscribe({
+            url: resolveRpcUrl(opts.url),
+            from: parseAddressArg(opts.from),
+            topic: opts.topic,
+            token: resolveRpcToken(opts.token),
+        });
+        printEnvelope(envelope, Boolean(opts.json));
+        process.exitCode = exitForEnvelope(envelope);
+    });
+    rpc
+        .command("publish")
+        .description("Publish to a campaign topic")
+        .requiredOption("--from <addr>", "kind:id publisher")
+        .requiredOption("--topic <topic>", "campaign topic")
+        .option("--body <json>", "JSON object payload", "{}")
+        .option("--campaign <id>", "campaign id stamp")
+        .option("--url <url>", "broker base URL")
+        .option("--token <token>", "shared local token")
+        .option("--json", "print full envelope JSON")
+        .action(async (opts) => {
+        const envelope = await rpcPublish({
+            url: resolveRpcUrl(opts.url),
+            from: parseAddressArg(opts.from),
+            topic: opts.topic,
+            body: parseJsonObject(opts.body, "--body"),
+            campaignId: opts.campaign,
+            token: resolveRpcToken(opts.token),
+        });
+        printEnvelope(envelope, Boolean(opts.json));
+        process.exitCode = exitForEnvelope(envelope);
+    });
+    rpc
+        .command("smoke")
+        .description("Run two-client + topic round-trip against an ephemeral localhost broker")
+        .option("--token <token>", "optional shared token for the smoke broker")
+        .option("--json", "print machine-readable result")
+        .action(async (opts) => {
+        const result = await runRpcSmoke({
+            token: resolveRpcToken(opts.token),
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (result.ok) {
+            console.log(`RPC smoke OK (url=${result.url}, clients=${result.statusClients}, topicDelivered=${result.topicDelivered})`);
+        }
+        else {
+            console.error(`RPC smoke FAILED: ${result.errors.join("; ")}`);
+        }
+        process.exitCode = result.ok ? 0 : 1;
+    });
+}
+export { startRpcServe, runRpcServeCommand, } from "./serve.js";
+export { runRpcSmoke } from "./smoke.js";
+export { resolveRpcUrl, resolveRpcToken, parseAddressArg, postRpc, rpcRegister, rpcSend, rpcSubscribe, rpcPublish, getJson, } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/rpc/index.js.map

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

package/dist/commands/rpc/serve.d.ts

@@ -0,0 +1,23 @@
+import { LocalhostRpcServer, type LocalhostRpcServerInfo } from "@blxzer/cursor-trellis-core/rpc";
+export interface RpcServeOptions {
+    host?: string;
+    port?: number;
+    token?: string;
+    /** Omit or pass undefined for default `~/.cstl/rpc`; pass `null` to disable. */
+    journalDir?: string | null;
+    heartbeatTimeoutMs?: number;
+    /** When set, return after listen instead of waiting (tests). */
+    listenOnly?: boolean;
+}
+export interface RpcServeHandle {
+    server: LocalhostRpcServer;
+    info: LocalhostRpcServerInfo;
+    close(): Promise<void>;
+}
+/**
+ * Start localhost RPC-FULL CORE broker.
+ * Non-goals (printed in help): multi-machine, A2A runtime, ops console.
+ */
+export declare function startRpcServe(options?: RpcServeOptions): Promise<RpcServeHandle>;
+export declare function runRpcServeCommand(options?: RpcServeOptions): Promise<number>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/commands/rpc/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/commands/rpc/serve.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,KAAK,sBAAsB,EAC5B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA6BzB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/commands/rpc/serve.js

@@ -0,0 +1,60 @@
+import os from "node:os";
+import path from "node:path";
+import { LocalhostRpcServer, } from "@blxzer/cursor-trellis-core/rpc";
+function defaultJournalDir() {
+    return path.join(os.homedir(), ".cstl", "rpc");
+}
+/**
+ * Start localhost RPC-FULL CORE broker.
+ * Non-goals (printed in help): multi-machine, A2A runtime, ops console.
+ */
+export async function startRpcServe(options = {}) {
+    const host = options.host ?? "127.0.0.1";
+    const port = options.port ??
+        (process.env.TRELLIS_RPC_PORT
+            ? Number(process.env.TRELLIS_RPC_PORT)
+            : 7843);
+    if (!Number.isInteger(port) || port < 0) {
+        throw new Error(`Invalid RPC port: ${String(port)}`);
+    }
+    const journalDir = options.journalDir === null
+        ? undefined
+        : (options.journalDir ?? defaultJournalDir());
+    const server = new LocalhostRpcServer({
+        host,
+        port,
+        token: options.token,
+        ...(journalDir !== undefined ? { journalDir } : {}),
+        heartbeatTimeoutMs: options.heartbeatTimeoutMs ?? 30_000,
+    });
+    const info = await server.listen();
+    return {
+        server,
+        info,
+        close: () => server.close(),
+    };
+}
+export async function runRpcServeCommand(options = {}) {
+    const handle = await startRpcServe(options);
+    console.log("RPC-FULL CORE listening (localhost only)");
+    console.log(`  url:      ${handle.info.url}`);
+    console.log(`  health:   ${handle.info.url}/health`);
+    console.log(`  rpc:      POST ${handle.info.url}/rpc`);
+    console.log(`  ws:       ws://${handle.info.host}:${handle.info.port}/ws`);
+    console.log(`  events:   ${handle.info.url}/events?kind=&id=`);
+    console.log("Non-goals: multi-machine, A2A implementation, standalone ops console.");
+    console.log("HITL gates are never auto-approved by this broker.");
+    if (options.listenOnly) {
+        await handle.close();
+        return 0;
+    }
+    await new Promise((resolve) => {
+        const shutdown = () => {
+            void handle.close().finally(resolve);
+        };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+    });
+    return 0;
+}
+//# sourceMappingURL=serve.js.map

package/dist/commands/rpc/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/commands/rpc/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAEnB,MAAM,iCAAiC,CAAC;AAmBzC,SAAS,iBAAiB;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAA2B,EAAE;IAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,IAAI,GACR,OAAO,CAAC,IAAI;QACZ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB;YAC3B,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;YACtC,CAAC,CAAC,IAAI,CAAC,CAAC;IACZ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,UAAU,GACd,OAAO,CAAC,UAAU,KAAK,IAAI;QACzB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC;QACpC,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,MAAM;KACzD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;IACnC,OAAO;QACL,MAAM;QACN,IAAI;QACJ,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAA2B,EAAE;IAE7B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,CACT,uEAAuE,CACxE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,oDAAoD,CAAC,CAAC;IAElE,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/rpc/smoke.d.ts

@@ -0,0 +1,16 @@
+export interface RpcSmokeResult {
+    ok: boolean;
+    url: string;
+    sendDelivered: boolean;
+    topicDelivered: number;
+    statusClients: number;
+    errors: string[];
+}
+/**
+ * Two-client + campaign topic round-trip against a fresh localhost broker.
+ * Used by tests and `cstl rpc smoke`.
+ */
+export declare function runRpcSmoke(options?: {
+    token?: string;
+}): Promise<RpcSmokeResult>;
+//# sourceMappingURL=smoke.d.ts.map

package/dist/commands/rpc/smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","sourceRoot":"","sources":["../../../src/commands/rpc/smoke.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,OAAO,CAAC,cAAc,CAAC,CAsF/B"}

package/dist/commands/rpc/smoke.js

@@ -0,0 +1,92 @@
+import { campaignBroadcastTopic } from "@blxzer/cursor-trellis-core/rpc";
+import { getJson, rpcPublish, rpcRegister, rpcSend, rpcSubscribe, } from "./client.js";
+import { startRpcServe } from "./serve.js";
+/**
+ * Two-client + campaign topic round-trip against a fresh localhost broker.
+ * Used by tests and `cstl rpc smoke`.
+ */
+export async function runRpcSmoke(options = {}) {
+    const errors = [];
+    const handle = await startRpcServe({
+        port: 0,
+        token: options.token,
+        heartbeatTimeoutMs: 0,
+        journalDir: null,
+    });
+    const url = handle.info.url;
+    const a = { kind: "cli", id: "smoke-a" };
+    const b = { kind: "worker", id: "smoke-b" };
+    const topic = campaignBroadcastTopic("smoke-camp");
+    try {
+        const regA = await rpcRegister({
+            url,
+            kind: a.kind,
+            id: a.id,
+            campaignId: "smoke-camp",
+            token: options.token,
+        });
+        const regB = await rpcRegister({
+            url,
+            kind: b.kind,
+            id: b.id,
+            token: options.token,
+        });
+        if (regA.error)
+            errors.push(`register A: ${regA.error.message}`);
+        if (regB.error)
+            errors.push(`register B: ${regB.error.message}`);
+        const sent = await rpcSend({
+            url,
+            from: a,
+            to: b,
+            body: { hello: "smoke" },
+            token: options.token,
+        });
+        if (sent.error)
+            errors.push(`send: ${sent.error.message}`);
+        const sub = await rpcSubscribe({
+            url,
+            from: b,
+            topic,
+            token: options.token,
+        });
+        if (sub.error)
+            errors.push(`subscribe: ${sub.error.message}`);
+        const published = await rpcPublish({
+            url,
+            from: a,
+            topic,
+            body: { stage: "ready" },
+            campaignId: "smoke-camp",
+            token: options.token,
+        });
+        if (published.error)
+            errors.push(`publish: ${published.error.message}`);
+        const status = (await getJson(url, "/status"));
+        const sendDelivered = sent.payload.delivered === true;
+        const topicDelivered = typeof published.payload.delivered === "number"
+            ? published.payload.delivered
+            : 0;
+        const statusClients = Array.isArray(status.clients)
+            ? status.clients.length
+            : 0;
+        if (topicDelivered < 1)
+            errors.push("topic deliver count < 1");
+        if (statusClients < 2)
+            errors.push("status clients < 2");
+        if (!sendDelivered)
+            errors.push("send not delivered");
+        return {
+            ok: errors.length === 0,
+            url,
+            sendDelivered,
+            topicDelivered,
+            statusClients,
+            errors,
+        };
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=smoke.js.map

package/dist/commands/rpc/smoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.js","sourceRoot":"","sources":["../../../src/commands/rpc/smoke.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,EACL,OAAO,EACP,UAAU,EACV,WAAW,EACX,OAAO,EACP,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAW3C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAE9B,EAAE;IACJ,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QACjC,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,kBAAkB,EAAE,CAAC;QACrB,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IAC5B,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,KAAc,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IAClD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,QAAiB,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAEnD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC;YAC7B,GAAG;YACH,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,UAAU,EAAE,YAAY;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC;YAC7B,GAAG;YACH,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAEjE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;YACzB,GAAG;YACH,IAAI,EAAE,CAAC;YACP,EAAE,EAAE,CAAC;YACL,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAE3D,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC;YAC7B,GAAG;YACH,IAAI,EAAE,CAAC;YACP,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAE9D,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC;YACjC,GAAG;YACH,IAAI,EAAE,CAAC;YACP,KAAK;YACL,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;YACxB,UAAU,EAAE,YAAY;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,SAAS,CAAC,KAAK;YAAE,MAAM,CAAC,IAAI,CAAC,YAAY,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAExE,MAAM,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAE5C,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC;QACtD,MAAM,cAAc,GAClB,OAAO,SAAS,CAAC,OAAO,CAAC,SAAS,KAAK,QAAQ;YAC7C,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS;YAC7B,CAAC,CAAC,CAAC,CAAC;QACR,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACjD,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;YACvB,CAAC,CAAC,CAAC,CAAC;QAEN,IAAI,cAAc,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC/D,IAAI,aAAa,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACzD,IAAI,CAAC,aAAa;YAAE,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAEtD,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YACvB,GAAG;YACH,aAAa;YACb,cAAc;YACd,aAAa;YACb,MAAM;SACP,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/commands/sdk/index.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from "commander";
+/**
+ * Register `cstl sdk` — Trellis↔Cursor SDK RUN path (CAP: safe-task/SDK only).
+ * Non-goals: fake IDE chat tab, Parent integrate, MIX UI, broker rewrite.
+ */
+export declare function registerSdkCommand(program: Command): void;
+export { runSdkRun, runSdkRunCommand, type SdkRunOptions, type SdkRunResult } from "./run.js";
+export { collectSdkStatus, runSdkStatusCommand, type SdkStatusResult, } from "./status.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0EzD;AAED,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAC9F,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAC"}

package/dist/commands/sdk/index.js

@@ -0,0 +1,58 @@
+import { resolveRpcToken, resolveRpcUrl } from "../rpc/client.js";
+import { runSdkRunCommand } from "./run.js";
+import { runSdkStatusCommand } from "./status.js";
+/**
+ * Register `cstl sdk` — Trellis↔Cursor SDK RUN path (CAP: safe-task/SDK only).
+ * Non-goals: fake IDE chat tab, Parent integrate, MIX UI, broker rewrite.
+ */
+export function registerSdkCommand(program) {
+    const sdk = program
+        .command("sdk")
+        .description("Cursor SDK RUN bridge for Trellis (explicit --task; mock/live; RPC kind=sdk). Non-goals: IDE chat tab, Parent integrate, MIX UI.");
+    sdk
+        .command("status")
+        .description("Show whether CURSOR_API_KEY is present and whether cursor-sdk can be enabled (never prints the key)")
+        .option("--cwd <dir>", "Project directory to inspect for capabilities.json")
+        .option("--json", "Print machine-readable status JSON")
+        .action(async (opts) => {
+        const code = await runSdkStatusCommand({
+            cwd: opts.cwd,
+            json: opts.json === true,
+        });
+        process.exitCode = code;
+    });
+    sdk
+        .command("run")
+        .description("Bind an explicit task path, run mock or live Agent.prompt, write dogfood evidence, emit campaign RPC events")
+        .requiredOption("--task <path>", "Explicit Trellis task directory (must contain prd.md). Required — SDK has no selected_task.")
+        .option("--campaign <id>", "Campaign id for RPC topic (no colon)", "08-01-trellis-intent-multisession")
+        .option("--prompt <text>", "Prompt body for the SDK / mock agent")
+        .option("--cwd <dir>", "Working directory for live local Agent (default: process.cwd())")
+        .option("--live", "Call @cursor/sdk Agent.prompt (requires consent + CURSOR_API_KEY)")
+        .option("--mock", "Force mock adapter (default when --live is absent)")
+        .option("--rpc-url <url>", "RPC CORE URL (default TRELLIS_RPC_URL or http://127.0.0.1:7843)")
+        .option("--token <token>", "RPC token (or TRELLIS_RPC_TOKEN)")
+        .option("--no-rpc", "Skip RPC register/publish (still writes dogfood)")
+        .action(async (opts) => {
+        if (opts.live && opts.mock) {
+            console.error("SDK RUN error: use only one of --live or --mock");
+            process.exitCode = 1;
+            return;
+        }
+        const mode = opts.live ? "live" : "mock";
+        const code = await runSdkRunCommand({
+            task: opts.task,
+            campaign: opts.campaign ?? "08-01-trellis-intent-multisession",
+            mode,
+            prompt: opts.prompt,
+            cwd: opts.cwd,
+            rpcUrl: opts.rpcUrl ? resolveRpcUrl(opts.rpcUrl) : undefined,
+            token: resolveRpcToken(opts.token),
+            noRpc: opts.rpc === false,
+        });
+        process.exitCode = code;
+    });
+}
+export { runSdkRun, runSdkRunCommand } from "./run.js";
+export { collectSdkStatus, runSdkStatusCommand, } from "./status.js";
+//# sourceMappingURL=index.js.map

package/dist/commands/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/sdk/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAmB,MAAM,UAAU,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CACV,kIAAkI,CACnI,CAAC;IAEJ,GAAG;SACA,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,qGAAqG,CACtG;SACA,MAAM,CAAC,aAAa,EAAE,oDAAoD,CAAC;SAC3E,MAAM,CAAC,QAAQ,EAAE,oCAAoC,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAsC,EAAE,EAAE;QACvD,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC;YACrC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,IAAI;SACzB,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CACV,6GAA6G,CAC9G;SACA,cAAc,CACb,eAAe,EACf,6FAA6F,CAC9F;SACA,MAAM,CACL,iBAAiB,EACjB,sCAAsC,EACtC,mCAAmC,CACpC;SACA,MAAM,CAAC,iBAAiB,EAAE,sCAAsC,CAAC;SACjE,MAAM,CAAC,aAAa,EAAE,iEAAiE,CAAC;SACxF,MAAM,CAAC,QAAQ,EAAE,mEAAmE,CAAC;SACrF,MAAM,CAAC,QAAQ,EAAE,oDAAoD,CAAC;SACtE,MAAM,CAAC,iBAAiB,EAAE,iEAAiE,CAAC;SAC5F,MAAM,CAAC,iBAAiB,EAAE,kCAAkC,CAAC;SAC7D,MAAM,CAAC,UAAU,EAAE,kDAAkD,CAAC;SACtE,MAAM,CACL,KAAK,EAAE,IAUN,EAAE,EAAE;QACH,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAe,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QACrD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC;YAClC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,mCAAmC;YAC9D,IAAI;YACJ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5D,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;YAClC,KAAK,EAAE,IAAI,CAAC,GAAG,KAAK,KAAK;SAC1B,CAAC,CAAC;QACH,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CACF,CAAC;AACN,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAyC,MAAM,UAAU,CAAC;AAC9F,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,aAAa,CAAC"}