@synap-core/cli 1.6.1 → 1.7.0

package/node_modules/@synap/hub-rest-client/src/errors.ts

@@ -0,0 +1,30 @@
+/**
+ * Hub Protocol REST API error class.
+ * Thrown when the server returns a non-2xx response.
+ */
+export class HubApiError extends Error {
+  constructor(
+    message: string,
+    public readonly statusCode: number,
+    public readonly body?: unknown
+  ) {
+    super(message);
+    this.name = "HubApiError";
+  }
+
+  get isUnauthorized(): boolean {
+    return this.statusCode === 401;
+  }
+
+  get isForbidden(): boolean {
+    return this.statusCode === 403;
+  }
+
+  get isNotFound(): boolean {
+    return this.statusCode === 404;
+  }
+
+  get isServerError(): boolean {
+    return this.statusCode >= 500;
+  }
+}

package/node_modules/@synap/hub-rest-client/src/index.ts

@@ -0,0 +1,111 @@
+/**
+ * @synap/hub-rest-client
+ *
+ * Zero-dependency TypeScript client for the Synap Hub Protocol REST API.
+ *
+ * Works in Node.js >= 18, browsers, Deno, Bun, and Raycast extensions.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { HubRestClient } from "@synap/hub-rest-client";
+ *
+ * const client = new HubRestClient({
+ *   podUrl: "https://my-pod.synap.live",
+ *   apiKey: process.env.SYNAP_HUB_API_KEY!,
+ * });
+ *
+ * const entities = await client.searchEntities("meeting notes");
+ * const task = await client.createEntity({ profileSlug: "task", title: "Fix bug" });
+ * ```
+ *
+ * @example Setup flow (new agent)
+ * ```ts
+ * import { setupAgent, checkPodHealth } from "@synap/hub-rest-client";
+ *
+ * const status = await checkPodHealth("https://my-pod.synap.live");
+ * if (status.healthy) {
+ *   const { hubApiKey, workspaceId } = await setupAgent(
+ *     "https://my-pod.synap.live",
+ *     process.env.PROVISIONING_TOKEN!,
+ *     "my-agent"
+ *   );
+ * }
+ * ```
+ */
+
+// Client
+export { HubRestClient } from "./client.js";
+export type { HubRestClientConfig } from "./client.js";
+
+// Errors
+export { HubApiError } from "./errors.js";
+
+// Setup utilities
+export { checkPodHealth, setupAgent } from "./setup.js";
+
+// Types
+export type {
+  // Core entity types
+  HubEntity,
+  HubDocument,
+  HubChannel,
+  HubWorkspace,
+  HubWorkspacesListResponse,
+  HubUser,
+  HubMemoryResult,
+  HubListResponse,
+  HubSingleResponse,
+  // Relations & Graph
+  HubRelation,
+  HubGraphNode,
+  HubGraphEdge,
+  HubGraphResult,
+  HubConnection,
+  HubConnectionsResult,
+  // Profiles & Schema
+  HubProfile,
+  HubPropertyDef,
+  HubDiscoverResult,
+  HubDiscoverProfile,
+  HubDiscoverProperty,
+  // Threads & Channels
+  HubThread,
+  HubMessage,
+  HubThreadContext,
+  // Proposals
+  HubProposal,
+  // Views
+  HubView,
+  // Search
+  HubSearchResult,
+  // Commands & Agents
+  HubCommand,
+  HubAgentUser,
+  // User Context
+  HubUserContext,
+  // Governance
+  HubGovernanceResult,
+  // Input types — Entity
+  CreateEntityInput,
+  UpdateEntityInput,
+  // Input types — Documents
+  CreateDocumentInput,
+  // Input types — Memory
+  StoreMemoryInput,
+  // Input types — Channels
+  SendToChannelInput,
+  // Input types — Relations, Threads, Views, Commands
+  CreateRelationInput,
+  CreateThreadInput,
+  CreateViewInput,
+  ExecuteCommandInput,
+  // Setup
+  AgentSetupResult,
+  PodStatus,
+  // Capture pipeline
+  CaptureProposal,
+  CaptureRelation,
+  CaptureStructureResponse,
+  CaptureExecuteInput,
+  CaptureExecuteResponse,
+} from "./types.js";

package/node_modules/@synap/hub-rest-client/src/setup.ts

@@ -0,0 +1,77 @@
+/**
+ * Pod setup and health utilities.
+ *
+ * These functions are the canonical implementations shared between
+ * the Synap CLI and the Raycast extension. They use the native fetch API
+ * and have zero Node.js-specific dependencies.
+ */
+
+import { HubApiError } from "./errors.js";
+import type { AgentSetupResult, PodStatus } from "./types.js";
+
+function normalizeUrl(url: string): string {
+  return url.replace(/\/$/, "");
+}
+
+/**
+ * Check whether a Synap pod is healthy.
+ * Hits `GET {podUrl}/health` with a 5s timeout.
+ */
+export async function checkPodHealth(podUrl: string): Promise<PodStatus> {
+  const url = normalizeUrl(podUrl);
+  const status: PodStatus = { url, healthy: false };
+
+  try {
+    const res = await fetch(`${url}/health`, {
+      signal: AbortSignal.timeout(5000),
+    });
+    if (res.ok) {
+      status.healthy = true;
+      const data = (await res.json()) as Record<string, unknown>;
+      status.version = data.version as string | undefined;
+    }
+  } catch {
+    // pod unreachable or timed out
+  }
+
+  return status;
+}
+
+/**
+ * Create an agent user + Hub Protocol API key on the pod.
+ *
+ * Auth: `Authorization: Bearer <provisioningToken>`
+ * The provisioning token is either:
+ *   - The pod's `PROVISIONING_TOKEN` env var (self-hosted path)
+ *   - A CP-signed `agent_setup` JWT (managed pod path)
+ *
+ * Endpoint: `POST {podUrl}/api/hub/setup/agent`
+ */
+export async function setupAgent(
+  podUrl: string,
+  provisioningToken: string,
+  agentType = "openclaw"
+): Promise<AgentSetupResult> {
+  const url = normalizeUrl(podUrl);
+
+  const res = await fetch(`${url}/api/hub/setup/agent`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${provisioningToken}`,
+    },
+    body: JSON.stringify({ agentType }),
+    signal: AbortSignal.timeout(15_000),
+  });
+
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new HubApiError(
+      `Agent setup failed (HTTP ${res.status})`,
+      res.status,
+      body
+    );
+  }
+
+  return res.json() as Promise<AgentSetupResult>;
+}