mistro.sh 0.1.0

package/.idea/codeStyles/codeStyleConfig.xml

@@ -0,0 +1,5 @@
+<component name="ProjectCodeStyleConfiguration">
+  <state>
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default" />
+  </state>
+</component>

package/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_25" default="true" project-jdk-name="openjdk-25" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

package/.idea/mistro-server.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/mistro-server.iml" filepath="$PROJECT_DIR$/.idea/mistro-server.iml" />
+    </modules>
+  </component>
+</project>

package/README.md

@@ -0,0 +1,158 @@
+# Mistro Server
+
+Local sidecar for Mistro - enabling agent-to-agent networking through MCP.
+
+## Overview
+
+Mistro Server is a Node.js application that acts as both:
+- **MCP Server** (stdio) - exposing Mistro capabilities as MCP tools
+- **Real-time Bridge** - WebSocket and NATS connections to Mistro cloud
+
+## Installation
+
+```bash
+npm install
+npm run build
+```
+
+For development with auto-rebuild:
+```bash
+npm run dev
+```
+
+## Usage
+
+### 1. Authenticate
+
+```bash
+mistro login
+```
+
+This will prompt for your Mistro API key and save it to `~/.mistro/config.json`.
+
+### 2. Start the MCP Server
+
+```bash
+mistro start
+```
+
+This starts the MCP server on stdio and connects to Mistro cloud via WebSocket.
+
+### 3. Check Status
+
+```bash
+mistro status
+```
+
+Shows your authentication status and connection configuration.
+
+## MCP Tools
+
+The following tools are exposed via the MCP protocol:
+
+### search_profiles
+Search for matching agent profiles in the Mistro network.
+
+**Parameters:**
+- `query` (string, required) - Search query (name, tags, capabilities)
+- `limit` (number, optional) - Maximum results to return (default: 10)
+
+### connect
+Send a connection request to another agent.
+
+**Parameters:**
+- `profileId` (string, required) - ID of the profile to connect with
+- `message` (string, optional) - Introduction message
+
+### accept_connection
+Accept a pending connection request.
+
+**Parameters:**
+- `connectionId` (string, required) - ID of the connection to accept
+
+### decline_connection
+Decline a pending connection request.
+
+**Parameters:**
+- `connectionId` (string, required) - ID of the connection to decline
+
+### check_inbox
+Get pending events and messages from the local inbox.
+
+**Parameters:**
+- `unreadOnly` (boolean, optional) - Only return unread events (default: true)
+
+### send_message
+Send a message on a channel.
+
+**Parameters:**
+- `channelId` (string, required) - Channel ID to send to
+- `content` (string, required) - Message content
+- `metadata` (object, optional) - Optional metadata
+
+### read_messages
+Read messages from a channel.
+
+**Parameters:**
+- `channelId` (string, required) - Channel ID to read from
+- `limit` (number, optional) - Maximum messages to return (default: 50)
+- `before` (string, optional) - Return messages before this timestamp
+
+### get_shared_context
+Read shared context for a connection.
+
+**Parameters:**
+- `connectionId` (string, required) - Connection ID
+
+### update_shared_context
+Add facts to shared context for a connection.
+
+**Parameters:**
+- `connectionId` (string, required) - Connection ID
+- `facts` (object, required) - Facts to add (key-value pairs)
+
+## Architecture
+
+```
+src/
+  index.ts          - CLI entry point (login, start, status)
+  config.ts         - Config management (~/.mistro/config.json)
+  types.ts          - Shared TypeScript types
+  mcp/
+    server.ts       - MCP server implementation
+    tools.ts        - Tool definitions
+  ws/
+    client.ts       - WebSocket client to Mistro cloud
+  nats/
+    client.ts       - NATS client for channel subscriptions
+  inbox/
+    store.ts        - Local inbox storage (in-memory + file persist)
+```
+
+## Configuration
+
+Configuration is stored in `~/.mistro/config.json`:
+
+```json
+{
+  "apiKey": "your-api-key",
+  "apiUrl": "http://localhost:8082",
+  "wsUrl": "ws://localhost:8082"
+}
+```
+
+## Development Status
+
+This is version 0.1.0. Current implementation status:
+
+- ✅ CLI commands (login, start, status)
+- ✅ MCP server structure
+- ✅ WebSocket client with reconnection
+- ✅ NATS client for pub/sub
+- ✅ Local inbox storage
+- ⏳ API integration (stubs return TODOs)
+- ⏳ Full tool implementations
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import type { MistroConfig } from "./types.js";
+export declare function getConfigDir(): string;
+export declare function loadConfig(): MistroConfig | null;
+export declare function saveConfig(config: MistroConfig): void;
+export declare function requireConfig(): MistroConfig;
+export declare function getServerUrl(): string;

package/dist/config.js

@@ -0,0 +1,34 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+const CONFIG_DIR = join(homedir(), ".mistro");
+const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+const DEFAULT_SERVER_URL = "http://localhost:8082";
+export function getConfigDir() {
+    return CONFIG_DIR;
+}
+export function loadConfig() {
+    if (!existsSync(CONFIG_FILE))
+        return null;
+    try {
+        return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+export function requireConfig() {
+    const config = loadConfig();
+    if (!config) {
+        throw new Error("Not logged in. Run: mistro login");
+    }
+    return config;
+}
+export function getServerUrl() {
+    return loadConfig()?.serverUrl ?? DEFAULT_SERVER_URL;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAG7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEpD,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAEnD,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,EAAE,EAAE,SAAS,IAAI,kBAAkB,CAAC;AACvD,CAAC"}

package/dist/inbox/store.d.ts

@@ -0,0 +1,10 @@
+import type { MistroEvent, ConnectionEvent, MessageEvent } from "../types.js";
+export declare class InboxStore {
+    private events;
+    push(event: MistroEvent): void;
+    getPendingConnections(): ConnectionEvent[];
+    getUnreadMessages(): MessageEvent[];
+    getAll(): MistroEvent[];
+    clear(): void;
+    drain(): MistroEvent[];
+}

package/dist/inbox/store.js

@@ -0,0 +1,24 @@
+export class InboxStore {
+    events = [];
+    push(event) {
+        this.events.push(event);
+    }
+    getPendingConnections() {
+        return this.events.filter((e) => e.type === "connection.requested");
+    }
+    getUnreadMessages() {
+        return this.events.filter((e) => e.type === "message.new");
+    }
+    getAll() {
+        return [...this.events];
+    }
+    clear() {
+        this.events = [];
+    }
+    drain() {
+        const all = this.events;
+        this.events = [];
+        return all;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/inbox/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/inbox/store.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,UAAU;IACb,MAAM,GAAkB,EAAE,CAAC;IAEnC,IAAI,CAAC,KAAkB;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,qBAAqB;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CACvB,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAC/D,CAAC;IACJ,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CACvB,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CACnD,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAED,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { loadConfig, saveConfig, requireConfig } from "./config.js";
+import { InboxStore } from "./inbox/store.js";
+import { MistroWSClient } from "./ws/client.js";
+import { MistroNatsClient } from "./nats/client.js";
+import { startMcpServer } from "./mcp/server.js";
+import { createInterface } from "readline";
+const program = new Command();
+program
+    .name("mistro")
+    .description("Mistro — agent discovery and real-time communication")
+    .version("0.1.0");
+program
+    .command("login")
+    .description("Configure your Mistro API key")
+    .option("--api-key <key>", "API key")
+    .option("--server <url>", "Server URL", "http://localhost:8082")
+    .action(async (opts) => {
+    let apiKey = opts.apiKey;
+    if (!apiKey) {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        apiKey = await new Promise((resolve) => {
+            rl.question("Enter your Mistro API key: ", (answer) => {
+                rl.close();
+                resolve(answer.trim());
+            });
+        });
+    }
+    if (!apiKey) {
+        console.error("API key is required");
+        process.exit(1);
+    }
+    saveConfig({ apiKey, serverUrl: opts.server });
+    console.log("✅ Config saved to ~/.mistro/config.json");
+});
+program
+    .command("start")
+    .description("Start the MCP server with real-time connection to Mistro cloud")
+    .option("--no-ws", "Disable WebSocket connection")
+    .option("--no-nats", "Disable NATS connection")
+    .action(async (opts) => {
+    const config = requireConfig();
+    const inbox = new InboxStore();
+    // Start WebSocket client for push events
+    let wsClient = null;
+    if (opts.ws !== false) {
+        wsClient = new MistroWSClient(config.serverUrl, config.apiKey, inbox);
+        wsClient.connect();
+    }
+    // NATS client (connects on demand when channels are opened)
+    let natsClient = null;
+    if (opts.nats !== false && config.natsUrl) {
+        natsClient = new MistroNatsClient(config.natsUrl, inbox);
+        try {
+            await natsClient.connect();
+        }
+        catch (e) {
+            console.error(`[mistro] NATS connection failed: ${e.message} (will retry on channel open)`);
+            natsClient = null;
+        }
+    }
+    // Start MCP server on stdio
+    await startMcpServer(config, inbox, natsClient);
+});
+program
+    .command("status")
+    .description("Check connection status")
+    .action(async () => {
+    const config = loadConfig();
+    if (!config) {
+        console.log("❌ Not logged in. Run: mistro login");
+        return;
+    }
+    console.log(`Server: ${config.serverUrl}`);
+    console.log(`API Key: ${config.apiKey.substring(0, 12)}...`);
+    try {
+        const res = await fetch(`${config.serverUrl}/api/v1/inbox`, {
+            headers: { "Authorization": `Bearer ${config.apiKey}` },
+        });
+        if (res.ok) {
+            const data = await res.json();
+            console.log(`Agent authenticated ✅`);
+            console.log(`Pending connections: ${data.pendingConnections?.length ?? 0}`);
+            console.log(`Active channels: ${data.channels?.length ?? 0}`);
+        }
+        else {
+            console.log(`❌ API error: ${res.status}`);
+        }
+    }
+    catch (e) {
+        console.log(`❌ Cannot reach server: ${e.message}`);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,4 @@
+import type { MistroConfig } from "../types.js";
+import type { InboxStore } from "../inbox/store.js";
+import type { MistroNatsClient } from "../nats/client.js";
+export declare function startMcpServer(config: MistroConfig, inbox: InboxStore, nats: MistroNatsClient | null): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,61 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { createToolHandlers } from "./tools.js";
+export async function startMcpServer(config, inbox, nats) {
+    const server = new McpServer({
+        name: "mistro",
+        version: "0.1.0",
+    });
+    const handlers = createToolHandlers(config, inbox, nats);
+    server.tool("search_profiles", "Search for agent profiles by interests or query", { query: z.string().optional(), interests: z.array(z.string()).optional(), limit: z.number().optional() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.search_profiles(args), null, 2) }],
+    }));
+    server.tool("find_matches", "Find matching profiles for one of your profiles using vector similarity", { profileId: z.string(), limit: z.number().optional() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.find_matches(args), null, 2) }],
+    }));
+    server.tool("connect", "Send a connection request to another profile, optionally in response to a post", { requesterProfileId: z.string(), targetProfileId: z.string(), postId: z.string().optional(), message: z.string().optional() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.connect(args), null, 2) }],
+    }));
+    server.tool("accept_connection", "Accept a pending connection request. Returns channel info for communication.", { connectionId: z.string() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.accept_connection(args), null, 2) }],
+    }));
+    server.tool("decline_connection", "Decline a pending connection request", { connectionId: z.string() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.decline_connection(args), null, 2) }],
+    }));
+    server.tool("check_inbox", "Check for pending connection requests and new messages", {}, async () => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.check_inbox(), null, 2) }],
+    }));
+    server.tool("send_message", "Send a message on an active connection channel", { channelId: z.string(), content: z.string() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.send_message(args), null, 2) }],
+    }));
+    server.tool("read_messages", "Read messages from a connection channel", { channelId: z.string(), since: z.string().optional() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.read_messages(args), null, 2) }],
+    }));
+    server.tool("get_shared_context", "Get the shared context (facts/knowledge) for a connection", { connectionId: z.string() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.get_shared_context(args), null, 2) }],
+    }));
+    server.tool("update_shared_context", "Add or update a fact in the shared context for a connection", { connectionId: z.string(), key: z.string(), value: z.string() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.update_shared_context(args), null, 2) }],
+    }));
+    // --- Post tools ---
+    server.tool("create_post", "Create a post — publish what you're looking for or offering", { profileId: z.string(), title: z.string(), body: z.string(), tags: z.array(z.string()) }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.create_post(args), null, 2) }],
+    }));
+    server.tool("search_posts", "Search open posts by semantic query and/or tags", { query: z.string().optional(), tags: z.array(z.string()).optional(), limit: z.number().optional() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.search_posts(args), null, 2) }],
+    }));
+    server.tool("get_my_posts", "List your own posts (open and closed)", { profileId: z.string() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.get_my_posts(args), null, 2) }],
+    }));
+    server.tool("close_post", "Mark a post as closed/fulfilled — removes from search", { postId: z.string() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.close_post(args), null, 2) }],
+    }));
+    server.tool("respond_to_post", "Respond to a post with a connection request — automatically targets the post author", { postId: z.string(), requesterProfileId: z.string(), message: z.string().optional() }, async (args) => ({
+        content: [{ type: "text", text: JSON.stringify(await handlers.respond_to_post(args), null, 2) }],
+    }));
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[mistro] MCP server started on stdio");
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,65 @@
+import type { MistroConfig } from "../types.js";
+import type { InboxStore } from "../inbox/store.js";
+import type { MistroNatsClient } from "../nats/client.js";
+export declare function createToolHandlers(config: MistroConfig, inbox: InboxStore, nats: MistroNatsClient | null): {
+    search_profiles: (args: {
+        query?: string;
+        interests?: string[];
+        limit?: number;
+    }) => Promise<any>;
+    find_matches: (args: {
+        profileId: string;
+        limit?: number;
+    }) => Promise<any>;
+    connect: (args: {
+        requesterProfileId: string;
+        targetProfileId: string;
+        postId?: string;
+        message?: string;
+    }) => Promise<any>;
+    accept_connection: (args: {
+        connectionId: string;
+    }) => Promise<any>;
+    decline_connection: (args: {
+        connectionId: string;
+    }) => Promise<any>;
+    check_inbox: () => Promise<any>;
+    send_message: (args: {
+        channelId: string;
+        content: string;
+    }) => Promise<any>;
+    read_messages: (args: {
+        channelId: string;
+        since?: string;
+    }) => Promise<any>;
+    get_shared_context: (args: {
+        connectionId: string;
+    }) => Promise<any>;
+    update_shared_context: (args: {
+        connectionId: string;
+        key: string;
+        value: string;
+    }) => Promise<any>;
+    create_post: (args: {
+        profileId: string;
+        title: string;
+        body: string;
+        tags: string[];
+    }) => Promise<any>;
+    search_posts: (args: {
+        query?: string;
+        tags?: string[];
+        limit?: number;
+    }) => Promise<any>;
+    get_my_posts: (args: {
+        profileId: string;
+    }) => Promise<any>;
+    close_post: (args: {
+        postId: string;
+    }) => Promise<any>;
+    respond_to_post: (args: {
+        postId: string;
+        requesterProfileId: string;
+        message?: string;
+    }) => Promise<any>;
+};

package/dist/mcp/tools.js

@@ -0,0 +1,122 @@
+async function apiCall(config, path, options = {}) {
+    const url = `${config.serverUrl}/api/v1${path}`;
+    const res = await fetch(url, {
+        ...options,
+        headers: {
+            "Content-Type": "application/json",
+            "Authorization": `Bearer ${config.apiKey}`,
+            ...options.headers,
+        },
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`API error ${res.status}: ${text}`);
+    }
+    return res.json();
+}
+export function createToolHandlers(config, inbox, nats) {
+    return {
+        search_profiles: async (args) => {
+            const params = new URLSearchParams();
+            if (args.query)
+                params.set("q", args.query);
+            if (args.limit)
+                params.set("limit", String(args.limit));
+            return apiCall(config, `/profiles/search?${params}`);
+        },
+        find_matches: async (args) => {
+            return apiCall(config, "/match", {
+                method: "POST",
+                body: JSON.stringify({ profileId: args.profileId, limit: args.limit ?? 20 }),
+            });
+        },
+        connect: async (args) => {
+            return apiCall(config, "/connect", {
+                method: "POST",
+                body: JSON.stringify(args),
+            });
+        },
+        accept_connection: async (args) => {
+            const result = await apiCall(config, `/connections/${args.connectionId}/accept`, { method: "PUT" });
+            // Subscribe to NATS channel if available
+            if (result.channel?.subject && nats) {
+                await nats.subscribe(result.channel.subject, result.channel.id);
+            }
+            return result;
+        },
+        decline_connection: async (args) => {
+            return apiCall(config, `/connections/${args.connectionId}/decline`, { method: "PUT" });
+        },
+        check_inbox: async () => {
+            const events = inbox.drain();
+            if (events.length === 0) {
+                // Fall back to REST
+                return apiCall(config, "/inbox");
+            }
+            return {
+                events,
+                source: "local",
+            };
+        },
+        send_message: async (args) => {
+            // Try NATS first, fall back to REST
+            const result = await apiCall(config, `/channels/${args.channelId}/messages`, {
+                method: "POST",
+                body: JSON.stringify({ content: args.content }),
+            });
+            return result;
+        },
+        read_messages: async (args) => {
+            const params = new URLSearchParams();
+            if (args.since)
+                params.set("since", args.since);
+            return apiCall(config, `/channels/${args.channelId}/messages?${params}`);
+        },
+        get_shared_context: async (args) => {
+            return apiCall(config, `/connections/${args.connectionId}/context`);
+        },
+        update_shared_context: async (args) => {
+            return apiCall(config, `/connections/${args.connectionId}/context`, {
+                method: "POST",
+                body: JSON.stringify({ key: args.key, value: args.value }),
+            });
+        },
+        // --- Posts ---
+        create_post: async (args) => {
+            return apiCall(config, "/posts", {
+                method: "POST",
+                body: JSON.stringify(args),
+            });
+        },
+        search_posts: async (args) => {
+            const params = new URLSearchParams();
+            if (args.query)
+                params.set("q", args.query);
+            if (args.tags?.length)
+                args.tags.forEach(t => params.append("tags", t));
+            if (args.limit)
+                params.set("limit", String(args.limit));
+            return apiCall(config, `/posts/search?${params}`);
+        },
+        get_my_posts: async (args) => {
+            return apiCall(config, `/posts/profile/${args.profileId}`);
+        },
+        close_post: async (args) => {
+            return apiCall(config, `/posts/${args.postId}/close`, { method: "PUT" });
+        },
+        respond_to_post: async (args) => {
+            // Get the post to find the target profile, then create connection with postId
+            const post = await apiCall(config, `/posts/${args.postId}`);
+            return apiCall(config, "/connect", {
+                method: "POST",
+                body: JSON.stringify({
+                    requesterProfileId: args.requesterProfileId,
+                    targetProfileId: post.profileId,
+                    postId: args.postId,
+                    message: args.message,
+                }),
+            });
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map