@graph8/sdk 0.251.0 → 0.262.0

package/docs/api/mcp.d.ts

@@ -0,0 +1,69 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.mcp` (MCP): 1 operation.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"get_mcp_connection_mcp_connection_get">;
+ *
+ * Reference with examples: mcp.md
+ */
+/* eslint-disable */
+
+/** `g8.api.mcp.<member>` -> the operationId it calls. */
+export interface McpMembers {
+  getMcpConnection: "get_mcp_connection_mcp_connection_get";
+}
+
+/** Input and output of every `g8.api.mcp` operation, keyed by operationId. */
+export interface McpOperations {
+  /**
+   * GET /mcp/connection
+   * Get Mcp Connection
+   * tier: read · scope: account:read
+   */
+  get_mcp_connection_mcp_connection_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_McpConnectionStatus_;
+  };
+}
+
+// 3 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_McpConnectionStatus_ {
+  data: McpConnectionStatus;
+  pagination?: PaginationMeta | null;
+}
+
+export interface McpConnectionStatus {
+  /** False when the facts could not be read (transient DB error) and the zero shape below is a fallback, not evidence — consumers should abstain from first-connect claims when False */
+  determined?: boolean;
+  /** True if ANY MCP session row exists for this org (incl. revoked) */
+  ever_connected: boolean;
+  /** ISO timestamp of the earliest session row */
+  first_connected_at?: string | null;
+  /** Client of the most recent session (e.g. Claude) */
+  last_client_type?: string | null;
+  /** ISO timestamp of the most recent activity */
+  last_connected_at?: string | null;
+  /** Total session rows for this org (incl. expired/revoked) */
+  sessions_count: number;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}

package/docs/api/mcp.md

@@ -0,0 +1,69 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.mcp`: MCP
+
+1 operation (1 read).
+
+No hand-written client covers this area. Call it through `g8.api.mcp.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [mcp.d.ts](mcp.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`getMcpConnection`](#op-getmcpconnection) | `GET /api/v1/mcp/connection` | read | `account:read` | Get Mcp Connection |
+
+---
+
+<a id="op-getmcpconnection"></a>
+
+### `g8.api.mcp.getMcpConnection(input?)`
+
+**Get Mcp Connection**
+
+- HTTP: `GET /api/v1/mcp/connection`
+- operationId: `get_mcp_connection_mcp_connection_get` (also callable as `g8.api.call("get_mcp_connection_mcp_connection_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `account:read`
+
+MCP connection facts for the authenticated org.
+
+Total by construction: any tenant-schema trouble (table not yet created for
+a brand-new org, transient DB error) answers the zero shape with
+``determined=False`` instead of 500 — the caller's collectors treat this
+route as best-effort, and the flag keeps a DB blip from reading as positive
+never-connected evidence.
+
+**Input**: none.
+
+**Returns** `ApiResponse_McpConnectionStatus_`: the envelope `{ data: McpConnectionStatus, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`McpConnectionStatus` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `ever_connected` | `boolean` | yes | True if ANY MCP session row exists for this org (incl. revoked) |
+| `sessions_count` | `integer` | yes | Total session rows for this org (incl. expired/revoked) |
+| `determined` | `boolean` | no | False when the facts could not be read (transient DB error) and the zero shape below is a fallback, not evidence — consumers should abstain from first-connect claims when False default `true` |
+| `first_connected_at` | `string \| null` | no | ISO timestamp of the earliest session row |
+| `last_client_type` | `string \| null` | no | Client of the most recent session (e.g. Claude) |
+| `last_connected_at` | `string \| null` | no | ISO timestamp of the most recent activity |
+
+**Example**
+
+```ts
+const result = await g8.api.mcp.getMcpConnection();
+```

package/docs/api/me.d.ts

@@ -0,0 +1,54 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.me` (Me): 1 operation.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"describe_current_key_me_get">;
+ *
+ * Reference with examples: me.md
+ */
+/* eslint-disable */
+
+/** `g8.api.me.<member>` -> the operationId it calls. */
+export interface MeMembers {
+  describeCurrentKey: "describe_current_key_me_get";
+}
+
+/** Input and output of every `g8.api.me` operation, keyed by operationId. */
+export interface MeOperations {
+  /**
+   * GET /me
+   * Describe Current Key
+   * tier: read · scope: n/a
+   */
+  describe_current_key_me_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_dict_;
+  };
+}
+
+// 2 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_dict_ {
+  data: Record<string, unknown>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface PaginationMeta {
+  /** Whether there are more pages */
+  has_next: boolean;
+  /** Items per page */
+  limit: number;
+  /** Opaque cursor for the next page; null when there are no more items. Pass it back as the `cursor` query param to fetch the following page without computing page numbers. */
+  next_cursor?: string | null;
+  /** Current page number (1-indexed) */
+  page: number;
+  /** Total number of items */
+  total: number;
+}

package/docs/api/me.md

@@ -0,0 +1,56 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.me`: Me
+
+1 operation (1 read).
+
+No hand-written client covers this area. Call it through `g8.api.me.*` as shown below, or by operationId with `g8.api.call(operationId, input)`.
+
+Every example below assumes this setup (server-side, API key):
+
+```ts
+import { g8 } from "@graph8/sdk";
+
+g8.init({ apiKey: process.env.G8_API_KEY! });
+```
+
+Example values are placeholders that match each field's type. Only required fields are shown. Every example is type-checked against the SDK in CI.
+
+Exact TypeScript types for every operation on this page, and every schema they use: [me.d.ts](me.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`describeCurrentKey`](#op-describecurrentkey) | `GET /api/v1/me` | read |  | Describe Current Key |
+
+---
+
+<a id="op-describecurrentkey"></a>
+
+### `g8.api.me.describeCurrentKey(input?)`
+
+**Describe Current Key**
+
+- HTTP: `GET /api/v1/me`
+- operationId: `describe_current_key_me_get` (also callable as `g8.api.call("describe_current_key_me_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: none published
+
+Describe the API key making this call, and what it can reach.
+
+Returns the caller's OWN credential only. There is no disclosure boundary
+crossed: the client already holds this key, and every field here is derived
+from it.
+
+**Input**: none.
+
+**Returns** `ApiResponse_dict_`: the envelope `{ data: Record<string, unknown>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+**Example**
+
+```ts
+const result = await g8.api.me.describeCurrentKey();
+```