@masons/agent-network 0.5.14 → 0.5.15

package/dist/platform-client.d.ts

@@ -1,18 +1,5 @@
-/**
- * MASONS runtime API client.
- *
- * Pure HTTP functions wrapping `/runtime/v1/*` endpoints on the connector.
- * Zero platform dependencies — only global fetch.
- *
- * Used by `tools.ts` (LLM path: tool execute functions).
- *
- * The pre-0.5.0 setup-flow functions (`initSetup`, `pollSetup`, `listAgents`,
- * `onboard`, `reconnect`) were deleted in this version: onboarding moves to
- * the OAuth Device Authorization Grant flow served by Better Auth at the IdP
- * (#1253), not via bespoke MASONS endpoints on the runtime API.
- */
-/** Default API host. */
-export declare const DEFAULT_API_HOST = "preview-connectorapi.masons.ai";
+export declare const DEFAULT_API_HOST = "preview-api.masons.ai";
+export declare const DEFAULT_CONNECTOR_URL = "wss://preview-connectorapi.masons.ai/gateway";
 export interface PlatformClientConfig {
     apiHost: string;
 }
@@ -25,12 +12,6 @@ export interface RequestConnectionResponse {
     requestIds: string[];
     status: string;
 }
-/**
- * Wire-level NodeRef view emitted by `apps/connector` on Connection
- * responses (per `human-node-capability-obligations.md § 2`). Plugin uses
- * this same shape consumer-side; it intentionally mirrors the
- * `NodeRefView` interface in `./types.ts`.
- */
 export interface ConnectionNodeRef {
     kind: string;
     mstpAddress: string;
@@ -38,31 +19,10 @@ export interface ConnectionNodeRef {
     displayName?: string;
     avatarUrl?: string;
 }
-/**
- * Back-compat counterparty shape on `ListRequestsItem.fromAgent` /
- * `ListRequestsItem.toAgent`. Connector emits `{ handle, name }` only on
- * these (per `apps/connector/src/routes/runtime/v1/connections/requests/`,
- * NodeRef enrichment lives in `fromNode` / `toNode` instead). Marked
- * `@deprecated` since #1450 Phase 1 — readers prefer `fromNode` / `toNode`.
- */
-export interface BackCompatAgent {
-    handle: string;
-    name: string;
-}
 export interface ListRequestsItem {
     id: string;
     direction: "incoming" | "outgoing";
-    /** @deprecated since #1450 Phase 1 — use `fromNode` (NodeRef shape). */
-    fromAgent?: BackCompatAgent;
-    /** @deprecated since #1450 Phase 1 — use `toNode` (NodeRef shape). */
-    toAgent?: BackCompatAgent;
-    /** Present for incoming requests — the sender Node, NodeRef shape per
-     *  `human-node-capability-obligations.md § 2`. Connector emits this
-     *  alongside `fromAgent` since #1450 Phase 1. May be `null` when the
-     *  Connector ran NodeRef enrichment but the entity record is missing. */
     fromNode?: ConnectionNodeRef | null;
-    /** Present for outgoing requests — the target Node, NodeRef shape.
-     *  Connector emits this alongside `toAgent` since #1450 Phase 1. */
     toNode?: ConnectionNodeRef | null;
     variant: string;
     status: string;
@@ -79,15 +39,7 @@ export interface ListRequestsResponse {
 }
 export interface AcceptRequestResponse {
     status: "accepted";
-    /** @deprecated since #1450 Phase 1 — use `counterparty` (NodeRef shape). */
-    connection: {
-        handle: string;
-        name: string;
-    };
-    /** Counterparty NodeRef per `human-node-capability-obligations.md § 2`.
-     *  Connector emits this alongside `connection` since #1450 Phase 1. May
-     *  be `null` when enrichment fails. */
-    counterparty?: ConnectionNodeRef | null;
+    counterparty: ConnectionNodeRef | null;
 }
 export interface DeclineRequestResponse {
     status: "declined";
@@ -109,165 +61,24 @@ export interface UpdateProfileResponse {
 }
 export interface ListConnectionsResponse {
     total: number;
-    items: Array<{
-        /** @deprecated since #1450 Phase 1 — use
-         *  `counterparty.displayName ?? counterparty.handle ?? counterparty.mstpAddress`. */
-        name: string;
-        /** @deprecated since #1450 Phase 1 — use `counterparty.mstpAddress`. */
-        address: string;
-        /** Counterparty NodeRef per `human-node-capability-obligations.md § 2`.
-         *  Connector emits this alongside `name + address` since #1450
-         *  Phase 1. Plugin renderer prefers `counterparty.kind` /
-         *  `displayName` over the legacy fields when present; falls back to
-         *  `name + address` for back-compat with older Connector versions. */
-        counterparty?: ConnectionNodeRef | null;
+    connections: Array<{
+        counterparty: ConnectionNodeRef;
+        access: "mutual" | "outbound" | "inbound" | string;
+        createdAt: string | null;
     }>;
 }
-export interface ConnectionStatusResponse {
-    status: "connected" | "pending" | "not_connected";
-    canCreateSession: boolean;
-}
-/** Successful onboard — returned by all three branches. */
-export interface OnboardSuccess {
-    apiKey: string;
-    connectorUrl: string;
-    agentId: string;
-    handle: string;
-}
-export interface OnboardAgentSummary {
-    id: string;
-    handle: string;
-    name: string;
-}
-/**
- * 422 agent_required — user owns multiple agents and didn't pick one.
- * Plugin should prompter.select() from `agents` and re-call with `{agentId}`.
- */
-export interface OnboardAgentRequiredError {
-    status: 422;
-    code: "agent_required";
-    agents: OnboardAgentSummary[];
-}
-/**
- * 412 no_agents — user owns zero agents. Plugin should prompt for handle
- * and re-call with `{create: {handle}}`.
- */
-export interface OnboardNoAgentsError {
-    status: 412;
-    code: "no_agents";
-    message: string;
-}
-/**
- * 409 handle_taken — handle conflict in create branch. Plugin should
- * re-prompt for a different handle.
- */
-export interface OnboardHandleTakenError {
-    status: 409;
-    code: "handle_taken";
-}
-/**
- * 422 invalid_handle — handle failed server-side validation. Plugin should
- * surface the message and re-prompt.
- */
-export interface OnboardInvalidHandleError {
-    status: 422;
-    code: "invalid_handle";
-    message: string;
-}
-/** Body shape for the onboard endpoint. */
-export type OnboardBody = Record<string, never> | {
-    agentId: string;
-} | {
-    create: {
-        handle: string;
-        name?: string;
-    };
-};
-/**
- * Result discriminator. `kind: "ok"` carries the credentials; `kind: "error"`
- * surfaces structured errors the plugin must handle in its CLI prompter loop
- * (no-agents → prompt handle; agent-required → prompt picker; handle-taken
- * → re-prompt; invalid-handle → re-prompt).
- *
- * Other failure shapes (401, 403, 404, 500) are thrown as `PlatformApiError`.
- */
-export type OnboardResult = {
-    kind: "ok";
-    data: OnboardSuccess;
-} | {
-    kind: "error";
-    data: OnboardAgentRequiredError | OnboardNoAgentsError | OnboardHandleTakenError | OnboardInvalidHandleError;
-};
-/**
- * `POST /connections/requests` — Send a connection request.
- *
- * Requires API Key in Authorization header.
- * Idempotent: returns 201 with empty requestIds if already connected.
- */
-export declare function requestConnection(cfg: PlatformClientConfig, apiKey: string, params: {
+export declare function requestConnection(cfg: PlatformClientConfig, runtimeKey: string, params: {
     targetHandle: string;
     variants: ("distribute" | "receive")[];
 }): Promise<RequestConnectionResponse>;
-/**
- * `GET /connections/requests` — List connection requests.
- *
- * Requires API Key in Authorization header.
- * @param params.direction - "incoming" (default), "outgoing", or "all"
- */
-export declare function listRequests(cfg: PlatformClientConfig, apiKey: string, params?: {
+export declare function listRequests(cfg: PlatformClientConfig, runtimeKey: string, params?: {
     status?: string;
     direction?: string;
     page?: number;
     limit?: number;
 }): Promise<ListRequestsResponse>;
-/**
- * `POST /connections/requests/{id}/accept` — Accept a connection request.
- *
- * Requires API Key in Authorization header.
- */
-export declare function acceptRequest(cfg: PlatformClientConfig, apiKey: string, requestId: string): Promise<AcceptRequestResponse>;
-/**
- * `POST /connections/requests/{id}/decline` — Decline a connection request.
- *
- * Requires API Key in Authorization header.
- */
-export declare function declineRequest(cfg: PlatformClientConfig, apiKey: string, requestId: string): Promise<DeclineRequestResponse>;
-/**
- * `PATCH /me/profile` — Update the calling agent's profile.
- *
- * Requires API Key in Authorization header.
- * Accepts partial updates — only provided fields are changed.
- */
-export declare function updateProfile(cfg: PlatformClientConfig, apiKey: string, params: UpdateProfileParams): Promise<UpdateProfileResponse>;
-/**
- * `GET /connections` — List established connections for the calling agent.
- *
- * Requires API Key in Authorization header.
- * Returns name + MSTP address for each connected agent.
- */
-export declare function listConnections(cfg: PlatformClientConfig, apiKey: string): Promise<ListConnectionsResponse>;
-/**
- * `POST /onboard` — bind a device-class client to an agent.
- *
- * Three branches selected by body shape (#1264):
- *   - `{}` → list / auto-pick
- *   - `{agentId}` → select existing (rotates api_key)
- *   - `{create: {handle, name?}}` → mint new agent
- *
- * Auth: Bearer access_token from Better Auth's device-authorization plugin.
- *
- * Returns `{kind: "ok", data}` on 200. Returns `{kind: "error", data}` for
- * the four structured errors the CLI prompter loop must handle. All other
- * non-2xx responses throw `PlatformApiError`.
- */
-export declare function onboard(cfg: PlatformClientConfig, sessionToken: string, body: OnboardBody): Promise<OnboardResult>;
-/**
- * `GET /connections/status?target={handle}` — Check connection status.
- *
- * Requires API Key in Authorization header.
- * Returns connection status and whether session creation is possible.
- *
- * Returns null if the request fails (advisory — caller should degrade gracefully).
- */
-export declare function getConnectionStatus(cfg: PlatformClientConfig, apiKey: string, targetHandle: string): Promise<ConnectionStatusResponse | null>;
+export declare function acceptRequest(cfg: PlatformClientConfig, runtimeKey: string, requestId: string): Promise<AcceptRequestResponse>;
+export declare function declineRequest(cfg: PlatformClientConfig, runtimeKey: string, requestId: string): Promise<DeclineRequestResponse>;
+export declare function updateProfile(cfg: PlatformClientConfig, runtimeKey: string, params: UpdateProfileParams): Promise<UpdateProfileResponse>;
+export declare function listConnections(cfg: PlatformClientConfig, runtimeKey: string): Promise<ListConnectionsResponse>;
 //# sourceMappingURL=platform-client.d.ts.map

package/dist/platform-client.d.ts.map

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

package/dist/platform-client.js

@@ -1,24 +1,5 @@
-/**
- * MASONS runtime API client.
- *
- * Pure HTTP functions wrapping `/runtime/v1/*` endpoints on the connector.
- * Zero platform dependencies — only global fetch.
- *
- * Used by `tools.ts` (LLM path: tool execute functions).
- *
- * The pre-0.5.0 setup-flow functions (`initSetup`, `pollSetup`, `listAgents`,
- * `onboard`, `reconnect`) were deleted in this version: onboarding moves to
- * the OAuth Device Authorization Grant flow served by Better Auth at the IdP
- * (#1253), not via bespoke MASONS endpoints on the runtime API.
- */
-// ---------------------------------------------------------------------------
-// Config
-// ---------------------------------------------------------------------------
-/** Default API host. */
-export const DEFAULT_API_HOST = "preview-connectorapi.masons.ai";
-// ---------------------------------------------------------------------------
-// Error classes
-// ---------------------------------------------------------------------------
+export const DEFAULT_API_HOST = "preview-api.masons.ai";
+export const DEFAULT_CONNECTOR_URL = "wss://preview-connectorapi.masons.ai/gateway";
 export class PlatformApiError extends Error {
     status;
     code;
@@ -29,14 +10,10 @@ export class PlatformApiError extends Error {
         this.name = "PlatformApiError";
     }
 }
-// ---------------------------------------------------------------------------
-// Internal helpers
-// ---------------------------------------------------------------------------
 function baseUrl(cfg) {
-    // `/runtime/v1/*` is the canonical prefix (renamed from legacy `/openclaw/v1/*`
-    // in connector PR #1248 — shared by OpenClaw plugin + Claude Code + any future
-    // device-class runtime). Atomic server-side change, no dual-serve.
-    return `https://${cfg.apiHost}/runtime/v1`;
+    const trimmed = cfg.apiHost.replace(/\/+$/, "");
+    const origin = /^https?:\/\//.test(trimmed) ? trimmed : `https://${trimmed}`;
+    return `${origin}/v1`;
 }
 async function handleError(res) {
     const body = (await res.json().catch(() => ({})));
@@ -44,21 +21,12 @@ async function handleError(res) {
     const message = typeof body.message === "string" ? body.message : res.statusText;
     throw new PlatformApiError(res.status, code, message);
 }
-// ---------------------------------------------------------------------------
-// API functions
-// ---------------------------------------------------------------------------
-/**
- * `POST /connections/requests` — Send a connection request.
- *
- * Requires API Key in Authorization header.
- * Idempotent: returns 201 with empty requestIds if already connected.
- */
-export async function requestConnection(cfg, apiKey, params) {
-    const res = await fetch(`${baseUrl(cfg)}/connections/requests`, {
+export async function requestConnection(cfg, runtimeKey, params) {
+    const res = await fetch(`${baseUrl(cfg)}/me/connections/requests`, {
         method: "POST",
         headers: {
             "Content-Type": "application/json",
-            Authorization: `Bearer ${apiKey}`,
+            Authorization: `Bearer ${runtimeKey}`,
         },
         body: JSON.stringify(params),
     });
@@ -66,13 +34,7 @@ export async function requestConnection(cfg, apiKey, params) {
         return handleError(res);
     return (await res.json());
 }
-/**
- * `GET /connections/requests` — List connection requests.
- *
- * Requires API Key in Authorization header.
- * @param params.direction - "incoming" (default), "outgoing", or "all"
- */
-export async function listRequests(cfg, apiKey, params) {
+export async function listRequests(cfg, runtimeKey, params) {
     const query = new URLSearchParams();
     if (params?.status != null)
         query.set("status", params.status);
@@ -83,54 +45,38 @@ export async function listRequests(cfg, apiKey, params) {
     if (params?.limit != null)
         query.set("limit", String(params.limit));
     const qs = query.toString();
-    const url = `${baseUrl(cfg)}/connections/requests${qs ? `?${qs}` : ""}`;
+    const url = `${baseUrl(cfg)}/me/connections/requests${qs ? `?${qs}` : ""}`;
     const res = await fetch(url, {
-        headers: { Authorization: `Bearer ${apiKey}` },
+        headers: { Authorization: `Bearer ${runtimeKey}` },
     });
     if (!res.ok)
         return handleError(res);
     return (await res.json());
 }
-/**
- * `POST /connections/requests/{id}/accept` — Accept a connection request.
- *
- * Requires API Key in Authorization header.
- */
-export async function acceptRequest(cfg, apiKey, requestId) {
-    const res = await fetch(`${baseUrl(cfg)}/connections/requests/${encodeURIComponent(requestId)}/accept`, {
+export async function acceptRequest(cfg, runtimeKey, requestId) {
+    const res = await fetch(`${baseUrl(cfg)}/me/connections/requests/${encodeURIComponent(requestId)}/accept`, {
         method: "POST",
-        headers: { Authorization: `Bearer ${apiKey}` },
+        headers: { Authorization: `Bearer ${runtimeKey}` },
     });
     if (!res.ok)
         return handleError(res);
     return (await res.json());
 }
-/**
- * `POST /connections/requests/{id}/decline` — Decline a connection request.
- *
- * Requires API Key in Authorization header.
- */
-export async function declineRequest(cfg, apiKey, requestId) {
-    const res = await fetch(`${baseUrl(cfg)}/connections/requests/${encodeURIComponent(requestId)}/decline`, {
+export async function declineRequest(cfg, runtimeKey, requestId) {
+    const res = await fetch(`${baseUrl(cfg)}/me/connections/requests/${encodeURIComponent(requestId)}/decline`, {
         method: "POST",
-        headers: { Authorization: `Bearer ${apiKey}` },
+        headers: { Authorization: `Bearer ${runtimeKey}` },
     });
     if (!res.ok)
         return handleError(res);
     return (await res.json());
 }
-/**
- * `PATCH /me/profile` — Update the calling agent's profile.
- *
- * Requires API Key in Authorization header.
- * Accepts partial updates — only provided fields are changed.
- */
-export async function updateProfile(cfg, apiKey, params) {
+export async function updateProfile(cfg, runtimeKey, params) {
     const res = await fetch(`${baseUrl(cfg)}/me/profile`, {
         method: "PATCH",
         headers: {
             "Content-Type": "application/json",
-            Authorization: `Bearer ${apiKey}`,
+            Authorization: `Bearer ${runtimeKey}`,
         },
         body: JSON.stringify(params),
     });
@@ -138,106 +84,11 @@ export async function updateProfile(cfg, apiKey, params) {
         return handleError(res);
     return (await res.json());
 }
-/**
- * `GET /connections` — List established connections for the calling agent.
- *
- * Requires API Key in Authorization header.
- * Returns name + MSTP address for each connected agent.
- */
-export async function listConnections(cfg, apiKey) {
-    const res = await fetch(`${baseUrl(cfg)}/connections`, {
-        headers: { Authorization: `Bearer ${apiKey}` },
+export async function listConnections(cfg, runtimeKey) {
+    const res = await fetch(`${baseUrl(cfg)}/me/connections`, {
+        headers: { Authorization: `Bearer ${runtimeKey}` },
     });
     if (!res.ok)
         return handleError(res);
     return (await res.json());
 }
-/**
- * `POST /onboard` — bind a device-class client to an agent.
- *
- * Three branches selected by body shape (#1264):
- *   - `{}` → list / auto-pick
- *   - `{agentId}` → select existing (rotates api_key)
- *   - `{create: {handle, name?}}` → mint new agent
- *
- * Auth: Bearer access_token from Better Auth's device-authorization plugin.
- *
- * Returns `{kind: "ok", data}` on 200. Returns `{kind: "error", data}` for
- * the four structured errors the CLI prompter loop must handle. All other
- * non-2xx responses throw `PlatformApiError`.
- */
-export async function onboard(cfg, sessionToken, body) {
-    const res = await fetch(`${baseUrl(cfg)}/onboard`, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: `Bearer ${sessionToken}`,
-        },
-        body: JSON.stringify(body),
-    });
-    if (res.ok) {
-        const data = (await res.json());
-        return { kind: "ok", data };
-    }
-    // Branch on the structured-error codes the prompter loop knows how to
-    // recover from. Anything else → throw PlatformApiError.
-    const raw = (await res.json().catch(() => ({})));
-    const code = typeof raw.error === "string" ? raw.error : "unknown";
-    const message = typeof raw.message === "string" ? raw.message : res.statusText;
-    if (res.status === 412 && code === "no_agents") {
-        return {
-            kind: "error",
-            data: { status: 412, code: "no_agents", message },
-        };
-    }
-    if (res.status === 422 && code === "agent_required") {
-        const agents = Array.isArray(raw.agents)
-            ? raw.agents
-            : [];
-        return {
-            kind: "error",
-            data: { status: 422, code: "agent_required", agents },
-        };
-    }
-    if (res.status === 422 && code === "invalid_handle") {
-        return {
-            kind: "error",
-            data: { status: 422, code: "invalid_handle", message },
-        };
-    }
-    if (res.status === 409 && code === "handle_taken") {
-        return {
-            kind: "error",
-            data: { status: 409, code: "handle_taken" },
-        };
-    }
-    // 401 unauthorized, 403 forbidden, 404 agent_not_found, 500 internal —
-    // these are programming errors at this stage, propagate via the standard
-    // throw path so the CLI prompter loop sees them as fatal.
-    throw new PlatformApiError(res.status, code, message);
-}
-/**
- * `GET /connections/status?target={handle}` — Check connection status.
- *
- * Requires API Key in Authorization header.
- * Returns connection status and whether session creation is possible.
- *
- * Returns null if the request fails (advisory — caller should degrade gracefully).
- */
-export async function getConnectionStatus(cfg, apiKey, targetHandle) {
-    try {
-        const controller = new AbortController();
-        const timeout = setTimeout(() => controller.abort(), 3000);
-        const res = await fetch(`${baseUrl(cfg)}/connections/status?target=${encodeURIComponent(targetHandle)}`, {
-            headers: { Authorization: `Bearer ${apiKey}` },
-            signal: controller.signal,
-        });
-        clearTimeout(timeout);
-        if (!res.ok)
-            return null; // Advisory — degrade gracefully
-        return (await res.json());
-    }
-    catch {
-        return null; // Network error or timeout — degrade gracefully
-    }
-}

package/dist/plugin.d.ts

@@ -22,6 +22,11 @@ declare const plugin: {
                 description: string;
                 default: string;
             };
+            connectorUrl: {
+                type: string;
+                description: string;
+                default: string;
+            };
             idpBaseUrl: {
                 type: string;
                 description: string;

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAiJA,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CA6XhC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAiJA,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjD,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CACnE;AAED,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAaI,iBAAiB;CA0XhC,CAAC;AAEF,eAAe,MAAM,CAAC"}