@graph8/sdk 0.251.0 → 0.260.0

package/docs/api/ops.d.ts

@@ -0,0 +1,299 @@
+/* Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. */
+
+/**
+ * Types for `g8.api.ops` (Ops (internal, cross-tenant, read-only)): 5 operations.
+ *
+ * For reading. In code, import from the package instead:
+ *   import type { ApiInput, ApiOutput, G8Contract } from "@graph8/sdk";
+ *   type In = ApiInput<"get_sequence_bindings_ops_orgs__org_id__linkedin_sequence_bindings_get">;
+ *
+ * Reference with examples: ops.md
+ */
+/* eslint-disable */
+
+/** `g8.api.ops.<member>` -> the operationId it calls. */
+export interface OpsMembers {
+  getSequenceBindings: "get_sequence_bindings_ops_orgs__org_id__linkedin_sequence_bindings_get";
+  listLinkedinActions: "list_linkedin_actions_ops_orgs__org_id__linkedin_actions_get";
+  opsIndex: "ops_index_ops_get";
+  summarizeLinkedinActions: "summarize_linkedin_actions_ops_orgs__org_id__linkedin_actions_summary_get";
+  summarizeWebhookEvents: "summarize_webhook_events_ops_orgs__org_id__linkedin_webhook_events_get";
+}
+
+/** Input and output of every `g8.api.ops` operation, keyed by operationId. */
+export interface OpsOperations {
+  /**
+   * GET /ops/orgs/{org_id}/linkedin/sequence-bindings
+   * Get Sequence Bindings
+   * tier: read · scope: ops:read
+   */
+  get_sequence_bindings_ops_orgs__org_id__linkedin_sequence_bindings_get: {
+    input: {
+    path: {
+      org_id: string;
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_OpsSequenceBindingsReport_;
+  };
+  /**
+   * GET /ops/orgs/{org_id}/linkedin/actions
+   * List Linkedin Actions
+   * tier: read · scope: ops:read
+   */
+  list_linkedin_actions_ops_orgs__org_id__linkedin_actions_get: {
+    input: {
+    path: {
+      org_id: string;
+    };
+    query?: {
+      /** QUEUED | SENDING | SENT | ACCEPTED | FAILED */
+      status?: string | null;
+      /** INVITE | MESSAGE */
+      kind?: string | null;
+      /** Sender arlink account id (lia_...) */
+      account_id?: string | null;
+      sequence_id?: string | null;
+      /** ISO timestamp; requested_at >= since */
+      since?: string | null;
+      /** ISO timestamp; requested_at < until */
+      until?: string | null;
+      page?: number;
+      limit?: number;
+      format?: "json" | "csv";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_OpsActionRow__;
+  };
+  /**
+   * GET /ops
+   * Ops Index
+   * tier: read · scope: ops:read
+   */
+  ops_index_ops_get: {
+    input: {
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: OpsIndex;
+  };
+  /**
+   * GET /ops/orgs/{org_id}/linkedin/actions/summary
+   * Summarize Linkedin Actions
+   * tier: read · scope: ops:read
+   */
+  summarize_linkedin_actions_ops_orgs__org_id__linkedin_actions_summary_get: {
+    input: {
+    path: {
+      org_id: string;
+    };
+    query?: {
+      format?: "json" | "csv";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_OpsActionSummaryRow__;
+  };
+  /**
+   * GET /ops/orgs/{org_id}/linkedin/webhook-events
+   * Summarize Webhook Events
+   * tier: read · scope: ops:read
+   */
+  summarize_webhook_events_ops_orgs__org_id__linkedin_webhook_events_get: {
+    input: {
+    path: {
+      org_id: string;
+    };
+    query?: {
+      format?: "json" | "csv";
+    };
+    headers?: {
+      "X-Target-Org-Id"?: string | null;
+    };
+  };
+    output: ApiResponse_list_OpsWebhookEventSummary__;
+  };
+}
+
+// 13 schemas referenced above (the same as G8Contract.<Name>).
+
+export interface ApiResponse_OpsSequenceBindingsReport_ {
+  data: OpsSequenceBindingsReport;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_OpsActionRow__ {
+  data: Array<OpsActionRow>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_OpsActionSummaryRow__ {
+  data: Array<OpsActionSummaryRow>;
+  pagination?: PaginationMeta | null;
+}
+
+export interface ApiResponse_list_OpsWebhookEventSummary__ {
+  data: Array<OpsWebhookEventSummary>;
+  pagination?: PaginationMeta | null;
+}
+
+/** One `linkedin_action_queue` row with its full per-contact drill-down. */
+export interface OpsActionRow {
+  action_id: string;
+  /** CONNECTION_REQUEST | MESSAGE */
+  action_type?: string | null;
+  attempts?: number;
+  budget_day?: string | null;
+  company_id?: number | null;
+  /** ~49% populated (company-enrichment gap) — never assume present. */
+  company_name?: string | null;
+  contact_current_step_order?: number | null;
+  /** PII */
+  contact_first_name?: string | null;
+  contact_id?: number | null;
+  /** PII */
+  contact_job_title?: string | null;
+  /** PII */
+  contact_last_name?: string | null;
+  /** PII */
+  contact_linkedin_url?: string | null;
+  /** seqsequencecontacts.state. `waiting_netrion` = parked with a live queue row outstanding. `skipped` = channel skip (e.g. no LinkedIn URL), NOT a send. */
+  contact_seq_state?: string | null;
+  /** PII; ~87% populated */
+  contact_work_email?: string | null;
+  /** Connection degree arlink observed; only set after a provider round-trip. */
+  degree_observed?: string | null;
+  due_at?: string | null;
+  /** COALESCE of the executed-step skip_reason (richer) and the queue row's last_error. `skipped_too_distant` = target not 1st/2nd-degree reachable — an ELIGIBILITY skip, not a provider error or account-health problem. */
+  failure_reason?: string | null;
+  /** INVITE | MESSAGE */
+  kind: string;
+  /** Rendered message body. Null for INVITE rows by design. */
+  message_text?: string | null;
+  /** Connection-request note, POST-RENDER. Null is the NORM for bare-invite plays (intentional strategy) — never report a null note as missing data. */
+  note?: string | null;
+  requested_at: string;
+  resolved_at?: string | null;
+  sender_account_id?: string | null;
+  sender_display_name?: string | null;
+  sender_public_identifier?: string | null;
+  sent_at?: string | null;
+  sequence_id?: string | null;
+  sequence_name?: string | null;
+  /** SEQUENCER | WORKFLOW | AI_INBOX */
+  source?: string | null;
+  /** QUEUED | SENDING | SENT | ACCEPTED | FAILED */
+  status: string;
+  step_id?: string | null;
+  /** Prospect LinkedIn slug (PII) */
+  target_identifier?: string | null;
+}
+
+/** One cell of the sequence × sender × kind × status matrix. */
+export interface OpsActionSummaryRow {
+  account_id?: string | null;
+  count: number;
+  first_requested_at?: string | null;
+  kind: string;
+  last_requested_at?: string | null;
+  last_sent_at?: string | null;
+  sender_display_name?: string | null;
+  sequence_id?: string | null;
+  sequence_name?: string | null;
+  status: string;
+}
+
+/**
+ * Self-describing index so an LLM consumer can discover the surface
+ * without parsing the full OpenAPI document.
+ */
+export interface OpsIndex {
+  description: string;
+  org_id_formats: string;
+  resources: Array<OpsIndexEntry>;
+}
+
+export interface OpsIndexEntry {
+  description: string;
+  path: string;
+  resource: string;
+}
+
+/** One live sequence↔sender binding (`channel_type='LINKEDIN_NETRION'`). */
+export interface OpsSequenceBindingRow {
+  account_display_name?: string | null;
+  /** arlink lia_... id */
+  account_id?: string | null;
+  /** OK = healthy. Only `deletedAt IS NULL AND status='OK'` counts as connected. */
+  account_status?: string | null;
+  bound_at?: string | null;
+  channel_id?: number | null;
+  /** seqsequencecontacts states for this sequence. Absent state = 0. `waiting_netrion` is the in-flight park state. */
+  contact_state_counts?: Record<string, number>;
+  created_at?: string | null;
+  invite_daily_cap?: number | null;
+  is_archived?: boolean;
+  message_daily_cap?: number | null;
+  /** Internal team member (PII, low sensitivity) */
+  owner_email?: string | null;
+  paused_at?: string | null;
+  resumed_at?: string | null;
+  sender_public_identifier?: string | null;
+  sequence_id: string;
+  sequence_name?: string | null;
+  sequence_status?: string | null;
+}
+
+export interface OpsSequenceBindingsReport {
+  bound: Array<OpsSequenceBindingRow>;
+  unbound_live_sequences: Array<OpsUnboundSequenceRow>;
+}
+
+/**
+ * A live, non-archived sequence with a NETRION step but NO active channel
+ * binding — configured but can never send. This is the population behind
+ * 'connected but not sending'.
+ */
+export interface OpsUnboundSequenceRow {
+  created_at?: string | null;
+  owner_email?: string | null;
+  sequence_id: string;
+  sequence_name?: string | null;
+  sequence_status?: string | null;
+}
+
+/**
+ * Per-event-type aggregate. The events table stores NO payload (dedupe
+ * ledger only) — to learn *what happened*, read the effects instead:
+ * `linkedin_action_queue.status` and the contact's sequencer state.
+ *
+ * `inbox.message_received` is NOT a sequence reply — only `lead.message_received`
+ * carries reply semantics. Never conflate the two counts.
+ */
+export interface OpsWebhookEventSummary {
+  count: number;
+  event: string;
+  first_seen?: string | null;
+  last_seen?: string | 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/ops.md

@@ -0,0 +1,339 @@
+<!-- Generated by sdk/js/scripts/generate-agent-docs.ts from developer-contract/openapi.json. Regenerated on every build. -->
+
+# `g8.api.ops`: Ops (internal, cross-tenant, read-only)
+
+5 operations (5 read).
+
+No hand-written client covers this area. Call it through `g8.api.ops.*` 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: [ops.d.ts](ops.d.ts).
+
+## Operations
+
+| Call | HTTP | Tier | Scope | Summary |
+|---|---|---|---|---|
+| [`getSequenceBindings`](#op-getsequencebindings) | `GET /api/v1/ops/orgs/{org_id}/linkedin/sequence-bindings` | read | `ops:read` | Get Sequence Bindings |
+| [`listLinkedinActions`](#op-listlinkedinactions) | `GET /api/v1/ops/orgs/{org_id}/linkedin/actions` | read | `ops:read` | List Linkedin Actions |
+| [`opsIndex`](#op-opsindex) | `GET /api/v1/ops` | read | `ops:read` | Ops Index |
+| [`summarizeLinkedinActions`](#op-summarizelinkedinactions) | `GET /api/v1/ops/orgs/{org_id}/linkedin/actions/summary` | read | `ops:read` | Summarize Linkedin Actions |
+| [`summarizeWebhookEvents`](#op-summarizewebhookevents) | `GET /api/v1/ops/orgs/{org_id}/linkedin/webhook-events` | read | `ops:read` | Summarize Webhook Events |
+
+---
+
+<a id="op-getsequencebindings"></a>
+
+### `g8.api.ops.getSequenceBindings(input)`
+
+**Get Sequence Bindings**
+
+- HTTP: `GET /api/v1/ops/orgs/{org_id}/linkedin/sequence-bindings`
+- operationId: `get_sequence_bindings_ops_orgs__org_id__linkedin_sequence_bindings_get` (also callable as `g8.api.call("get_sequence_bindings_ops_orgs__org_id__linkedin_sequence_bindings_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `ops:read`
+
+Sequence↔LinkedIn-sender bindings for one org, plus the unbound list.
+
+`unbound_live_sequences` is the high-signal field: a live sequence with a
+LinkedIn step but no active binding is configured but can NEVER send —
+the measured platform-wide root cause of 'connected but not sending'.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.org_id` | `string` | yes |  |
+
+**Returns** `ApiResponse_OpsSequenceBindingsReport_`: the envelope `{ data: OpsSequenceBindingsReport, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OpsSequenceBindingsReport` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `bound` | `Array<OpsSequenceBindingRow>` | yes |  |
+| `unbound_live_sequences` | `Array<OpsUnboundSequenceRow>` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.ops.getSequenceBindings({ path: { org_id: "id" } });
+```
+
+---
+
+<a id="op-listlinkedinactions"></a>
+
+### `g8.api.ops.listLinkedinActions(input)`
+
+**List Linkedin Actions**
+
+- HTTP: `GET /api/v1/ops/orgs/{org_id}/linkedin/actions`
+- operationId: `list_linkedin_actions_ops_orgs__org_id__linkedin_actions_get` (also callable as `g8.api.call("list_linkedin_actions_ops_orgs__org_id__linkedin_actions_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `ops:read`
+
+Per-contact LinkedIn action drill-down for one org, newest first.
+
+Interpretation guide (so counts are reported truthfully):
+- `failure_reason='skipped_too_distant'` (~90% of failures) = the target is
+  not 1st/2nd-degree reachable. An ELIGIBILITY skip — NOT a provider error,
+  rate limit, or account-health problem.
+- `note` null is the NORM (bare-invite strategy), not missing data.
+- A contact's `waiting_netrion` state = parked with this queue row in flight.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.org_id` | `string` | yes |  |
+| `query.status` | `string \| null` | no | QUEUED \| SENDING \| SENT \| ACCEPTED \| FAILED |
+| `query.kind` | `string \| null` | no | INVITE \| MESSAGE |
+| `query.account_id` | `string \| null` | no | Sender arlink account id (lia_...) |
+| `query.sequence_id` | `string \| null` | no |  |
+| `query.since` | `string \| null` | no | ISO timestamp; requested_at >= since |
+| `query.until` | `string \| null` | no | ISO timestamp; requested_at < until |
+| `query.page` | `integer` | no | default `1` |
+| `query.limit` | `integer` | no | default `100` |
+| `query.format` | `"json" \| "csv"` | no | default `"json"` |
+
+**Returns** `ApiResponse_list_OpsActionRow__`: the envelope `{ data: Array<OpsActionRow>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OpsActionRow` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `action_id` | `string` | yes |  |
+| `kind` | `string` | yes | INVITE \| MESSAGE |
+| `requested_at` | `string (date-time)` | yes |  |
+| `status` | `string` | yes | QUEUED \| SENDING \| SENT \| ACCEPTED \| FAILED |
+| `action_type` | `string \| null` | no | CONNECTION_REQUEST \| MESSAGE |
+| `attempts` | `integer` | no | default `0` |
+| `budget_day` | `string \| null` | no |  |
+| `company_id` | `integer \| null` | no |  |
+| `company_name` | `string \| null` | no | ~49% populated (company-enrichment gap) — never assume present. |
+| `contact_current_step_order` | `integer \| null` | no |  |
+| `contact_first_name` | `string \| null` | no | PII |
+| `contact_id` | `integer \| null` | no |  |
+| `contact_job_title` | `string \| null` | no | PII |
+| `contact_last_name` | `string \| null` | no | PII |
+| `contact_linkedin_url` | `string \| null` | no | PII |
+| `contact_seq_state` | `string \| null` | no | seqsequencecontacts.state. `waiting_netrion` = parked with a live queue row outstanding. `skipped` = channel skip (e.g. no LinkedIn URL), NOT a send. |
+| `contact_work_email` | `string \| null` | no | PII; ~87% populated |
+| `degree_observed` | `string \| null` | no | Connection degree arlink observed; only set after a provider round-trip. |
+| `due_at` | `string (date-time) \| null` | no |  |
+| `failure_reason` | `string \| null` | no | COALESCE of the executed-step skip_reason (richer) and the queue row's last_error. `skipped_too_distant` = target not 1st/2nd-degree reachable — an ELIGIBILITY skip, not a provider error or account-health problem. |
+| `message_text` | `string \| null` | no | Rendered message body. Null for INVITE rows by design. |
+| `note` | `string \| null` | no | Connection-request note, POST-RENDER. Null is the NORM for bare-invite plays (intentional strategy) — never report a null note as missing data. |
+| `resolved_at` | `string (date-time) \| null` | no |  |
+| `sender_account_id` | `string \| null` | no |  |
+| `sender_display_name` | `string \| null` | no |  |
+| `sender_public_identifier` | `string \| null` | no |  |
+| `sent_at` | `string (date-time) \| null` | no |  |
+| `sequence_id` | `string \| null` | no |  |
+| `sequence_name` | `string \| null` | no |  |
+| `source` | `string \| null` | no | SEQUENCER \| WORKFLOW \| AI_INBOX |
+| `step_id` | `string \| null` | no |  |
+| `target_identifier` | `string \| null` | no | Prospect LinkedIn slug (PII) |
+
+**Example**
+
+```ts
+const result = await g8.api.ops.listLinkedinActions({ path: { org_id: "id" } });
+```
+
+---
+
+<a id="op-opsindex"></a>
+
+### `g8.api.ops.opsIndex(input?)`
+
+**Ops Index**
+
+- HTTP: `GET /api/v1/ops`
+- operationId: `ops_index_ops_get` (also callable as `g8.api.call("ops_index_ops_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `ops:read`
+
+Self-describing index of the ops surface — start here.
+
+Every list endpoint also accepts `?format=csv` for a spreadsheet-ready
+download. All endpoints are read-only.
+
+**Input**: none.
+
+**Returns** `OpsIndex`.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `description` | `string` | yes |  |
+| `org_id_formats` | `string` | yes |  |
+| `resources` | `Array<OpsIndexEntry>` | yes |  |
+
+**Example**
+
+```ts
+const result = await g8.api.ops.opsIndex();
+```
+
+---
+
+<a id="op-summarizelinkedinactions"></a>
+
+### `g8.api.ops.summarizeLinkedinActions(input)`
+
+**Summarize Linkedin Actions**
+
+- HTTP: `GET /api/v1/ops/orgs/{org_id}/linkedin/actions/summary`
+- operationId: `summarize_linkedin_actions_ops_orgs__org_id__linkedin_actions_summary_get` (also callable as `g8.api.call("summarize_linkedin_actions_ops_orgs__org_id__linkedin_actions_summary_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `ops:read`
+
+Sequence × sender × kind × status matrix — the at-a-glance volume view.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.org_id` | `string` | yes |  |
+| `query.format` | `"json" \| "csv"` | no | default `"json"` |
+
+**Returns** `ApiResponse_list_OpsActionSummaryRow__`: the envelope `{ data: Array<OpsActionSummaryRow>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OpsActionSummaryRow` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `count` | `integer` | yes |  |
+| `kind` | `string` | yes |  |
+| `status` | `string` | yes |  |
+| `account_id` | `string \| null` | no |  |
+| `first_requested_at` | `string (date-time) \| null` | no |  |
+| `last_requested_at` | `string (date-time) \| null` | no |  |
+| `last_sent_at` | `string (date-time) \| null` | no |  |
+| `sender_display_name` | `string \| null` | no |  |
+| `sequence_id` | `string \| null` | no |  |
+| `sequence_name` | `string \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.ops.summarizeLinkedinActions({ path: { org_id: "id" } });
+```
+
+---
+
+<a id="op-summarizewebhookevents"></a>
+
+### `g8.api.ops.summarizeWebhookEvents(input)`
+
+**Summarize Webhook Events**
+
+- HTTP: `GET /api/v1/ops/orgs/{org_id}/linkedin/webhook-events`
+- operationId: `summarize_webhook_events_ops_orgs__org_id__linkedin_webhook_events_get` (also callable as `g8.api.call("summarize_webhook_events_ops_orgs__org_id__linkedin_webhook_events_get", input)`)
+- Tier: `read`: reads data; safe to call and to retry
+- API-key scope: `ops:read`
+
+Inbound webhook event-type counts + first/last seen for one org.
+
+The underlying table is a dedupe ledger — NO payload is stored, so this
+endpoint cannot say *what* happened per event; read the effects instead
+(action status via /actions, contact state via /sequence-bindings).
+`inbox.message_received` explicitly EXCLUDES sequence-reply semantics; only
+`lead.message_received` means a tracked lead replied.
+
+**Input**
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `path.org_id` | `string` | yes |  |
+| `query.format` | `"json" \| "csv"` | no | default `"json"` |
+
+**Returns** `ApiResponse_list_OpsWebhookEventSummary__`: the envelope `{ data: Array<OpsWebhookEventSummary>, ... }`. `g8.api` returns the envelope as-is, so read `result.data`.
+
+Other envelope fields: `pagination` (PaginationMeta).
+
+`OpsWebhookEventSummary` fields:
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `count` | `integer` | yes |  |
+| `event` | `string` | yes |  |
+| `first_seen` | `string (date-time) \| null` | no |  |
+| `last_seen` | `string (date-time) \| null` | no |  |
+
+**Example**
+
+```ts
+const result = await g8.api.ops.summarizeWebhookEvents({ path: { org_id: "id" } });
+```
+
+---
+
+## Referenced types
+
+Named types that appear in the tables above. Full TypeScript definitions: `G8Contract.<Name>` (`import type { G8Contract } from "@graph8/sdk"`).
+
+<a id="type-opsindexentry"></a>
+
+### `OpsIndexEntry`
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `description` | `string` | yes |  |
+| `path` | `string` | yes |  |
+| `resource` | `string` | yes |  |
+
+<a id="type-opssequencebindingrow"></a>
+
+### `OpsSequenceBindingRow`
+
+One live sequence↔sender binding (`channel_type='LINKEDIN_NETRION'`).
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `sequence_id` | `string` | yes |  |
+| `account_display_name` | `string \| null` | no |  |
+| `account_id` | `string \| null` | no | arlink lia_... id |
+| `account_status` | `string \| null` | no | OK = healthy. Only `deletedAt IS NULL AND status='OK'` counts as connected. |
+| `bound_at` | `string (date-time) \| null` | no |  |
+| `channel_id` | `integer \| null` | no |  |
+| `contact_state_counts` | `Record<string, integer>` | no | seqsequencecontacts states for this sequence. Absent state = 0. `waiting_netrion` is the in-flight park state. |
+| `created_at` | `string (date-time) \| null` | no |  |
+| `invite_daily_cap` | `integer \| null` | no |  |
+| `is_archived` | `boolean` | no | default `false` |
+| `message_daily_cap` | `integer \| null` | no |  |
+| `owner_email` | `string \| null` | no | Internal team member (PII, low sensitivity) |
+| `paused_at` | `string (date-time) \| null` | no |  |
+| `resumed_at` | `string (date-time) \| null` | no |  |
+| `sender_public_identifier` | `string \| null` | no |  |
+| `sequence_name` | `string \| null` | no |  |
+| `sequence_status` | `string \| null` | no |  |
+
+<a id="type-opsunboundsequencerow"></a>
+
+### `OpsUnboundSequenceRow`
+
+A live, non-archived sequence with a NETRION step but NO active channel binding — configured but can never send. This is the population behind 'connected but not sending'.
+
+| Field | Type | Required | Description |
+|---|---|---|---|
+| `sequence_id` | `string` | yes |  |
+| `created_at` | `string (date-time) \| null` | no |  |
+| `owner_email` | `string \| null` | no |  |
+| `sequence_name` | `string \| null` | no |  |
+| `sequence_status` | `string \| null` | no |  |