@drakon-systems/ekho-sdk 0.2.1

package/dist/adapter.d.ts

@@ -0,0 +1,36 @@
+import type { AgentCredentials, InboxMessage, ControlMessage, SendMessagePayload, ProposeActionPayload, ActionResultPayload } from "./types";
+export type AdapterHooks = {
+    onMessage?: (message: InboxMessage, adapter: EkhoAgentAdapter) => Promise<void>;
+    beforeAction?: (action: ProposeActionPayload, adapter: EkhoAgentAdapter) => Promise<void>;
+    onControl?: (control: ControlMessage, adapter: EkhoAgentAdapter) => Promise<void>;
+    onApprovalPending?: (approvalId: string, adapter: EkhoAgentAdapter) => Promise<void>;
+};
+export declare class EkhoAgentAdapter {
+    private readonly client;
+    private readonly hooks;
+    private running;
+    private paused;
+    private activeConversationIds;
+    constructor(credentials: AgentCredentials, hooks?: AdapterHooks);
+    get agentId(): string;
+    start(): Promise<void>;
+    stop(): void;
+    send(payload: SendMessagePayload): Promise<{
+        message_id: string;
+        status: string;
+        queued_at: string;
+    }>;
+    proposeAction(action: ProposeActionPayload): Promise<{
+        decision: "allow";
+    } | {
+        decision: "pending_approval";
+        approval_id: string;
+    }>;
+    reportActionResult(payload: ActionResultPayload): Promise<{
+        ok: boolean;
+    }>;
+    private heartbeatLoop;
+    private inboxLoop;
+    private handleControl;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,iBAAiB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtF,CAAC;AAMF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,qBAAqB,CAAqB;gBAEtC,WAAW,EAAE,gBAAgB,EAAE,KAAK,GAAE,YAAiB;IAKnE,IAAI,OAAO,WAAkC;IAEvC,KAAK;IAOX,IAAI;IAEE,IAAI,CAAC,OAAO,EAAE,kBAAkB;;;;;IAIhC,aAAa,CAAC,MAAM,EAAE,oBAAoB;;;;;;IAqB1C,kBAAkB,CAAC,OAAO,EAAE,mBAAmB;;;YAIvC,aAAa;YAeb,SAAS;YAmBT,aAAa;CAK5B"}

package/dist/adapter.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EkhoAgentAdapter = void 0;
+const client_1 = require("./client");
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+class EkhoAgentAdapter {
+    client;
+    hooks;
+    running = false;
+    paused = false;
+    activeConversationIds = new Set();
+    constructor(credentials, hooks = {}) {
+        this.client = new client_1.EkhoAgentClient(credentials);
+        this.hooks = hooks;
+    }
+    get agentId() { return this.client.agentId; }
+    async start() {
+        if (this.running)
+            return;
+        this.running = true;
+        void this.heartbeatLoop();
+        void this.inboxLoop();
+    }
+    stop() { this.running = false; }
+    async send(payload) {
+        return this.client.sendMessage(payload);
+    }
+    async proposeAction(action) {
+        if (this.hooks.beforeAction)
+            await this.hooks.beforeAction(action, this);
+        if (this.paused)
+            throw new Error("agent is paused by control plane");
+        const decision = await this.client.proposeAction(action);
+        if (decision.decision === "allow")
+            return decision;
+        if (decision.decision === "deny")
+            throw new Error("action denied by Ekho policy");
+        if (this.hooks.onApprovalPending)
+            await this.hooks.onApprovalPending(decision.approval_id, this);
+        while (this.running) {
+            const approval = await this.client.getApproval(decision.approval_id);
+            if (approval.status === "approved" || approval.status === "executed")
+                return decision;
+            if (approval.status === "rejected" || approval.status === "cancelled" || approval.status === "expired") {
+                throw new Error(`action ${approval.status} by operator`);
+            }
+            await sleep(1500);
+        }
+        throw new Error("adapter stopped while waiting for approval");
+    }
+    async reportActionResult(payload) {
+        return this.client.actionResult(payload);
+    }
+    async heartbeatLoop() {
+        while (this.running) {
+            try {
+                await this.client.heartbeat({
+                    status: this.paused ? "degraded" : "healthy",
+                    active_conversation_ids: [...this.activeConversationIds],
+                    metrics: { paused: this.paused }
+                });
+            }
+            catch (error) {
+                console.error("[ekho-adapter] heartbeat failed", error);
+            }
+            await sleep(this.client.heartbeatIntervalSeconds * 1000);
+        }
+    }
+    async inboxLoop() {
+        while (this.running) {
+            try {
+                const inbox = await this.client.getInbox();
+                for (const control of inbox.controls)
+                    await this.handleControl(control);
+                for (const raw of inbox.messages) {
+                    this.activeConversationIds.add(raw.conversation_id);
+                    if (this.hooks.onMessage)
+                        await this.hooks.onMessage(raw, this);
+                    await this.client.ackMessages([
+                        { message_id: raw.message_id, status: "received", received_at: new Date().toISOString() }
+                    ]);
+                }
+            }
+            catch (error) {
+                console.error("[ekho-adapter] inbox loop failed", error);
+            }
+            await sleep(this.client.pollIntervalSeconds * 1000);
+        }
+    }
+    async handleControl(control) {
+        if (control.action === "pause" || control.action === "quarantine")
+            this.paused = true;
+        if (control.action === "resume")
+            this.paused = false;
+        if (this.hooks.onControl)
+            await this.hooks.onControl(control, this);
+    }
+}
+exports.EkhoAgentAdapter = EkhoAgentAdapter;
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,44 @@
+import type { AgentCredentials, ActionDecision, SendMessagePayload, HeartbeatPayload, ProposeActionPayload, ActionResultPayload } from "./types";
+export declare class EkhoAgentClient {
+    private readonly credentials;
+    constructor(credentials: AgentCredentials);
+    private signedHeaders;
+    private request;
+    get agentId(): string;
+    get pollIntervalSeconds(): number;
+    get heartbeatIntervalSeconds(): number;
+    sendMessage(payload: SendMessagePayload): Promise<{
+        message_id: string;
+        status: string;
+        queued_at: string;
+    }>;
+    getInbox(limit?: number): Promise<{
+        messages: Array<Record<string, unknown>>;
+        controls: Array<Record<string, unknown>>;
+    }>;
+    ackMessages(acks: Array<{
+        message_id: string;
+        status: "received";
+        received_at: string;
+    }>): Promise<{
+        updated: number;
+    }>;
+    heartbeat(payload: HeartbeatPayload): Promise<{
+        ok: boolean;
+        next_heartbeat_due_seconds: number;
+    }>;
+    proposeAction(payload: ProposeActionPayload): Promise<ActionDecision>;
+    getApproval(approvalId: string): Promise<{
+        id: string;
+        status: string;
+        action_type: string;
+        risk_level: string;
+        summary: string;
+        requested_at: string;
+        resolved_at: string | null;
+    }>;
+    actionResult(payload: ActionResultPayload): Promise<{
+        ok: boolean;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AASjB,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,gBAAgB;IAE1D,OAAO,CAAC,aAAa;YAeP,OAAO;IAiBrB,IAAI,OAAO,WAAuC;IAClD,IAAI,mBAAmB,WAA4E;IACnG,IAAI,wBAAwB,WAAsF;IAElH,WAAW,CAAC,OAAO,EAAE,kBAAkB;oBACH,MAAM;gBAAU,MAAM;mBAAa,MAAM;;IAG7E,QAAQ,CAAC,KAAK,SAAK;kBACe,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;kBAAY,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;;IAG1G,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;iBACvD,MAAM;;IAGvC,SAAS,CAAC,OAAO,EAAE,gBAAgB;YACP,OAAO;oCAA8B,MAAM;;IAGvE,aAAa,CAAC,OAAO,EAAE,oBAAoB;IAI3C,WAAW,CAAC,UAAU,EAAE,MAAM;YAEtB,MAAM;gBAAU,MAAM;qBAAe,MAAM;oBAAc,MAAM;iBAC1D,MAAM;sBAAgB,MAAM;qBAAe,MAAM,GAAG,IAAI;;IAIrE,YAAY,CAAC,OAAO,EAAE,mBAAmB;YACb,OAAO;;CAEpC"}

package/dist/client.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EkhoAgentClient = void 0;
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const DEFAULT_POLL_INTERVAL = 5;
+const DEFAULT_HEARTBEAT_INTERVAL = 30;
+function sha256(input) {
+    return node_crypto_1.default.createHash("sha256").update(input).digest("hex");
+}
+class EkhoAgentClient {
+    credentials;
+    constructor(credentials) {
+        this.credentials = credentials;
+    }
+    signedHeaders(method, signaturePath, body) {
+        const timestamp = new Date().toISOString();
+        const nonce = node_crypto_1.default.randomUUID();
+        const payload = `${method}\n${signaturePath}\n${timestamp}\n${nonce}\n${sha256(body)}`;
+        const signature = node_crypto_1.default.createHmac("sha256", this.credentials.secret).update(payload).digest("hex");
+        return {
+            "content-type": "application/json",
+            "x-ekho-agent-id": this.credentials.agentId,
+            "x-ekho-agent-secret": this.credentials.secret,
+            "x-ekho-timestamp": timestamp,
+            "x-ekho-nonce": nonce,
+            "x-ekho-signature": signature
+        };
+    }
+    async request(method, routePath, payload) {
+        const body = payload ? JSON.stringify(payload) : "";
+        const signaturePath = routePath.split("?")[0] ?? routePath;
+        const response = await fetch(`${this.credentials.relayBaseUrl}${routePath}`, {
+            method,
+            headers: this.signedHeaders(method, signaturePath, body),
+            body: method === "GET" ? undefined : body
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`Ekho request failed for ${routePath}: ${response.status} ${text}`);
+        }
+        return response.json();
+    }
+    get agentId() { return this.credentials.agentId; }
+    get pollIntervalSeconds() { return this.credentials.pollIntervalSeconds ?? DEFAULT_POLL_INTERVAL; }
+    get heartbeatIntervalSeconds() { return this.credentials.heartbeatIntervalSeconds ?? DEFAULT_HEARTBEAT_INTERVAL; }
+    sendMessage(payload) {
+        return this.request("POST", "/v1/messages", payload);
+    }
+    getInbox(limit = 25) {
+        return this.request("GET", `/v1/inbox?limit=${limit}`);
+    }
+    ackMessages(acks) {
+        return this.request("POST", "/v1/acks", { acks });
+    }
+    heartbeat(payload) {
+        return this.request("POST", "/v1/heartbeats", payload);
+    }
+    proposeAction(payload) {
+        return this.request("POST", "/v1/actions/propose", payload);
+    }
+    getApproval(approvalId) {
+        return this.request("GET", `/v1/actions/${approvalId}`);
+    }
+    actionResult(payload) {
+        return this.request("POST", "/v1/actions/result", payload);
+    }
+}
+exports.EkhoAgentClient = EkhoAgentClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { EkhoAgentClient } from "./client";
+export { EkhoAgentAdapter } from "./adapter";
+export type { AdapterHooks } from "./adapter";
+export type { AgentCredentials, ActionDecision, InboxMessage, ControlMessage, SendMessagePayload, HeartbeatPayload, ProposeActionPayload, ActionResultPayload } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EkhoAgentAdapter = exports.EkhoAgentClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "EkhoAgentClient", { enumerable: true, get: function () { return client_1.EkhoAgentClient; } });
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "EkhoAgentAdapter", { enumerable: true, get: function () { return adapter_1.EkhoAgentAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAA2C;AAAlC,yGAAA,eAAe,OAAA;AACxB,qCAA6C;AAApC,2GAAA,gBAAgB,OAAA"}

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+export type AgentCredentials = {
+    agentId: string;
+    secret: string;
+    relayBaseUrl: string;
+    heartbeatIntervalSeconds?: number;
+    pollIntervalSeconds?: number;
+};
+export type ActionDecision = {
+    decision: "allow";
+} | {
+    decision: "deny";
+} | {
+    decision: "pending_approval";
+    approval_id: string;
+};
+export type InboxMessage = {
+    message_id: string;
+    conversation_id: string;
+    correlation_id: string;
+    sender_agent_id: string;
+    message_type: string;
+    priority: string;
+    body: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    deadline_at: string;
+};
+export type ControlMessage = {
+    control_id: string;
+    action: string;
+    reason: string;
+};
+export type SendMessagePayload = {
+    recipient: {
+        kind: "agent" | "group" | "broadcast";
+        id?: string;
+    };
+    message_type: "direct" | "broadcast" | "alert" | "handoff" | "claim" | "complete" | "heartbeat" | "control";
+    priority?: "low" | "normal" | "high" | "urgent";
+    ttl_seconds?: number;
+    requires_approval?: boolean;
+    body: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+    conversation_id: string;
+    correlation_id: string;
+};
+export type HeartbeatPayload = {
+    status: "healthy" | "degraded" | "busy" | "idle";
+    active_conversation_ids?: string[];
+    metrics?: Record<string, unknown>;
+};
+export type ProposeActionPayload = {
+    conversation_id: string;
+    action_type: string;
+    summary: string;
+    risk_level: "low" | "medium" | "high" | "critical";
+    payload: Record<string, unknown>;
+};
+export type ActionResultPayload = {
+    approval_id: string;
+    result: "executed" | "cancelled" | "failed";
+    completed_at: string;
+    output?: Record<string, unknown>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GACrB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,QAAQ,EAAE,kBAAkB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,YAAY,EAAE,QAAQ,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5G,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@drakon-systems/ekho-sdk",
+  "version": "0.2.1",
+  "description": "Agent SDK for Ekho — the private communication layer for distributed AI agents.",
+  "license": "MIT",
+  "author": "Drakon Systems <hello@drakonsystems.com> (https://drakonsystems.com)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Drakon-Systems-Ltd/ekho.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://drakonsystems.com/products/ekho",
+  "keywords": [
+    "ai",
+    "agents",
+    "messaging",
+    "relay",
+    "sdk",
+    "ekho",
+    "tailscale"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0"
+  }
+}