@tai42/api-client 16.0.0 → 16.0.1

package/dist/schemas/connectors.js

@@ -0,0 +1,122 @@
+/** Connector provider catalog and connection lifecycle schemas. */
+import { z } from 'zod';
+import { fleetReportFanout } from './fleet';
+export const subServiceView = z.object({
+    id: z.string(),
+    display_name: z.string(),
+    description: z.string(),
+    scopes: z.array(z.string()),
+});
+export const configFieldView = z.object({
+    key: z.string(),
+    label: z.string(),
+    target: z.enum(['env', 'header']),
+    required: z.boolean(),
+    secret: z.boolean(),
+});
+export const providerView = z.object({
+    id: z.string(),
+    display_name: z.string(),
+    description: z.string(),
+    // Required and a real URL: the contract's `ProviderDescriptor.icon_url` runs
+    // `check_web_url(schemes=("https",))`, which rejects an empty/relative value, so
+    // an empty or malformed one here is drift and fails the parse loudly.
+    icon_url: z.url(),
+    kind: z.enum(['oauth', 'none']),
+    origin: z.enum(['system', 'community']),
+    category: z.string(),
+    sub_services: z.array(subServiceView),
+    config_fields: z.array(configFieldView),
+});
+/**
+ * One `connector_category` grouping row served alongside the catalog: the UI's
+ * label and sort key for the providers it groups, so the list can group, order,
+ * and label providers by category without a second read.
+ */
+export const connectorCategoryView = z.object({
+    id: z.string(),
+    display_name: z.string(),
+    sort_order: z.number(),
+});
+/**
+ * `GET /api/connectors/providers` — the provider catalog: the providers plus the
+ * category groupings the UI arranges them under. Reshaped from a bare provider
+ * array so the category label/order surface rides the same read.
+ */
+export const providers = z.object({
+    providers: z.array(providerView),
+    categories: z.array(connectorCategoryView),
+});
+export const connectionView = z.object({
+    connection_id: z.string(),
+    provider_id: z.string(),
+    alias: z.string(),
+    kind: z.enum(['oauth', 'none']),
+    account_identity: z.string().nullable(),
+    enabled_sub_services: z.array(z.string()),
+    granted_scopes: z.array(z.string()),
+    // Sub-services whose MCP server did not answer a live reachability probe.
+    // Populated only on the single-connection GET (the list projection is
+    // probe-free and always sends `[]`). Reachability is distinct from
+    // `auth_health_state`: a healthy connection can still have a down sub-service.
+    // Defaulted so a projection that omits it (an older worker mid-rollout) still
+    // parses rather than false-failing the whole view.
+    unreachable_sub_services: z.array(z.string()).default([]),
+    auth_health_state: z.enum(['healthy', 'reconnect_required', 'refresh_failing']),
+    created_at: z.string(),
+});
+export const connectionsList = z.object({
+    items: z.array(connectionView),
+    total: z.number(),
+    // Count of connections whose `auth_health_state` is not healthy across the whole
+    // set (independent of any filter/limit) — the attention-badge count. Optional:
+    // no UI consumes it, and an older worker mid-rollout omits it.
+    unhealthy: z.number().optional(),
+});
+// A connector mutation that writes the manifest embeds the mode-wrapped fleet
+// `fanout` of the reload it broadcast; it is `null` when the response path mutated no
+// manifest (an OAuth START opens a flow before any write). Parsed EXPLICITLY so the
+// shared fleet-report handler surfaces a failed propagation on every connector flow —
+// zod's unknown-key stripping would otherwise drop it silently.
+export const startConnectResult = z.union([
+    z.object({ flow_id: z.string(), authorize_url: z.string() }),
+    z.object({
+        connection_id: z.string(),
+        added_manifest_entries: z.array(z.string()),
+        fanout: fleetReportFanout.nullable(),
+    }),
+]);
+// A reconnect START opens an OAuth flow and writes no manifest, so it carries no
+// fan-out (the manifest write lands when the flow completes).
+export const reconnectResult = z.object({ flow_id: z.string(), authorize_url: z.string() });
+export const disconnectResult = z.object({
+    connection_id: z.string(),
+    upstream_revoke_outcome: z.enum(['success', 'failed', 'skipped']),
+    upstream_revoke_status: z.number().nullable(),
+    removed_manifest_entries: z.array(z.string()),
+    fanout: fleetReportFanout.nullable(),
+});
+export const patchSubServicesResult = z.object({
+    connection_id: z.string(),
+    enabled_sub_services: z.array(z.string()),
+    consent_required: z.boolean(),
+    flow_id: z.string().nullable(),
+    authorize_url: z.string().nullable(),
+    added_manifest_entries: z.array(z.string()),
+    removed_manifest_entries: z.array(z.string()),
+    // `null` on a consent-only toggle that forks an OAuth flow without a manifest write.
+    fanout: fleetReportFanout.nullable(),
+});
+export const oauthCompleteResult = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('success'),
+        connection_id: z.string(),
+        return_url: z.string(),
+        // `null` when completing the flow mutated no manifest (a reconcile that changed
+        // nothing).
+        fanout: fleetReportFanout.nullable(),
+    }),
+    z.object({ kind: z.literal('failed'), reason: z.string() }),
+    z.object({ kind: z.literal('cancelled'), message: z.string() }),
+]);
+//# sourceMappingURL=connectors.js.map

package/dist/schemas/connectors.js.map

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