@tai42/api-client 1.4.0 → 1.6.0

package/src/schemas.ts

@@ -803,7 +803,7 @@ export const connectionsList = z.object({
   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 this mission, and an older worker mid-rollout omits it.
+  // no UI consumes it, and an older worker mid-rollout omits it.
   unhealthy: z.number().optional(),
 });
 
@@ -1007,6 +1007,14 @@ export type ConversationDeliveryStatus = z.infer<typeof conversationDeliveryStat
 export const conversationAnswerStatus = z.enum(['answered', 'error', 'silent']);
 export type ConversationAnswerStatus = z.infer<typeof conversationAnswerStatus>;
 
+/**
+ * Who authored a record's outgoing side. `client` is the ordinary turn the flow
+ * answered; `operator` is a message a human sent into the thread, whose text
+ * rides `answer` (its `inbound_text` is empty).
+ */
+export const conversationRecordOrigin = z.enum(['client', 'operator']);
+export type ConversationRecordOrigin = z.infer<typeof conversationRecordOrigin>;
+
 /** A stored routing row as a read door returns it, its `callback_secret` withheld. */
 export const conversationRoute = z.object({
   route_name: z.string(),
@@ -1075,6 +1083,7 @@ export const conversationMessage = z.object({
   inbound_text: z.string(),
   answer_status: conversationAnswerStatus.nullable(),
   answer: z.string().nullable(),
+  origin: conversationRecordOrigin,
   delivery_status: conversationDeliveryStatus,
   created_at: z.number(),
   updated_at: z.number(),
@@ -1104,6 +1113,27 @@ export const conversationTranscriptPage = z.object({
 });
 export type ConversationTranscriptPage = z.infer<typeof conversationTranscriptPage>;
 
+/**
+ * Who answers a thread's incoming messages: `agent` lets the flow reply on its
+ * own; `manual` holds the flow back so a human answers. `source` says whether the
+ * setting is the thread's own (`thread`) or inherited from its route (`route`).
+ */
+export const conversationThreadMode = z.enum(['agent', 'manual']);
+export type ConversationThreadMode = z.infer<typeof conversationThreadMode>;
+
+export const conversationThreadModeState = z.object({
+  mode: conversationThreadMode,
+  source: z.enum(['thread', 'route']),
+});
+export type ConversationThreadModeState = z.infer<typeof conversationThreadModeState>;
+
+/** The receipt a thread-message write returns: the stored id and its thread. */
+export const conversationThreadMessageSent = z.object({
+  message_id: z.string(),
+  thread_id: z.string(),
+});
+export type ConversationThreadMessageSent = z.infer<typeof conversationThreadMessageSent>;
+
 // -- channel-web entry gate --------------------------------------------------
 // The web channel's entry gate: a web route can be gated so its chat page is
 // served only to a navigation carrying a live entry code. These four doors are
@@ -1824,26 +1854,52 @@ export type RunTrace = z.infer<typeof runTrace>;
 // -- marketplace -------------------------------------------------------------
 
 /**
- * One contained item of a marketplace plugin (a searchable row): its kind
- * (tool / agent / extension / …), name, description, and free-form tags.
+ * One contained item of a marketplace plugin's published version: its kind
+ * (tool / agent / extension / …), name, description, free-form tags, and the
+ * logical group it belongs to (`null` when ungrouped).
  */
 export const marketplaceItem = z.object({
   kind: z.string(),
   name: z.string(),
   description: z.string(),
   tags: z.array(z.string()),
+  group: z.string().nullable(),
 });
 export type MarketplaceItem = z.infer<typeof marketplaceItem>;
 
 /**
- * One item-level search row (`GET /api/marketplace/search`): the contained item
- * plus the listing it belongs to. `ref` is the "namespace/name" install target
- * (install targets the LISTING), so every row carries enough to group under and
- * link to its plugin. `latest_version` is nullable defensively; the search
- * relation only emits listings with a published version.
+ * One kind summary of a search row: an item kind, how many UNGROUPED items of
+ * that kind the listing's latest published version carries, and their names.
+ * The registry orders the array count DESC then kind ASC, and each entry's
+ * `names` ASC; the UI renders in that order.
+ */
+export const marketplaceSearchKind = z.object({
+  kind: z.string(),
+  count: z.number(),
+  names: z.array(z.string()),
+});
+export type MarketplaceSearchKind = z.infer<typeof marketplaceSearchKind>;
+
+/**
+ * One logical group of a search row: the group name and how many items the
+ * listing's latest published version places in it. The registry orders the
+ * array count DESC then name ASC; the UI renders in that order.
+ */
+export const marketplaceSearchGroup = z.object({
+  name: z.string(),
+  count: z.number(),
+});
+export type MarketplaceSearchGroup = z.infer<typeof marketplaceSearchGroup>;
+
+/**
+ * One listing-level search row (`GET /api/marketplace/search`). `ref` is the
+ * "namespace/name" install target, so every row carries enough to link to its
+ * plugin. `latest_version` is nullable defensively; the search relation only
+ * emits listings with a published version. `kinds` summarizes that latest
+ * version's UNGROUPED items; `groups` summarizes its logical groups (`[]` when
+ * none). Both keys are always present.
  */
 export const marketplaceSearchRow = z.object({
-  item: marketplaceItem,
   ref: z.string(),
   namespace: z.string(),
   name: z.string(),
@@ -1855,21 +1911,23 @@ export const marketplaceSearchRow = z.object({
   tags: z.array(z.string()),
   trust_tier: z.string(),
   pricing: z.string(),
-  // A display-only premium flag (D5: a badge, never a payment surface). Nullable
+  // A display-only premium flag: a badge, never a payment surface. Nullable
   // + optional: an older registry omits it, and it is absent on non-premium rows.
   premium: z.boolean().nullish(),
   latest_version: z.string().nullable(),
   downloads: z.number(),
   updated_at: z.string(),
+  kinds: z.array(marketplaceSearchKind),
+  groups: z.array(marketplaceSearchGroup),
 });
 export type MarketplaceSearchRow = z.infer<typeof marketplaceSearchRow>;
 
 /**
- * One page of search rows. The wire carries no next-page field — has-next is
+ * One page of listing rows. The wire carries no next-page field — has-next is
  * COMPUTED: `page * page_size < total`.
  */
 export const marketplaceSearchPage = z.object({
-  items: z.array(marketplaceSearchRow),
+  listings: z.array(marketplaceSearchRow),
   total: z.number(),
   page: z.number(),
   page_size: z.number(),
@@ -1953,14 +2011,14 @@ export const marketplacePluginDetail = z.object({
   license: z.string().nullable(),
   homepage_url: z.string().nullable(),
   repository_url: z.string().nullable(),
-  // The marketplace-stored docs-site URL (R13: the store is the source, the UI a
-  // link). Nullable + optional: absent on a listing with no published docs.
+  // The marketplace-stored docs-site URL: the store is the source, the UI a
+  // link. Nullable + optional: absent on a listing with no published docs.
   docs_url: z.string().nullish(),
   categories: z.array(z.string()),
   tags: z.array(z.string()),
   trust_tier: z.string(),
   pricing: z.string(),
-  // A display-only premium flag (D5: a badge, never a payment surface).
+  // A display-only premium flag: a badge, never a payment surface.
   premium: z.boolean().nullish(),
   downloads: z.number(),
   latest: marketplaceLatestVersion.nullable(),
@@ -2005,9 +2063,9 @@ export const marketplaceInstalledPlugin = z
     incompatible_newer: z.string().nullable(),
     missing_upstream: z.boolean(),
     compat: marketplaceInstalledCompat,
-    // The `{kind, name}` of every item this plugin's stored spec provides (local
-    // truth). The McpTab joins the mcp-server item names against the manifest's
-    // mcp-entry titles to render an installer-written entry read-only.
+    // The `{kind, name}` of every item this plugin's stored spec provides
+    // (local truth). The McpTab joins the mcp-server item names against the
+    // manifest's mcp-entry titles to render an installer-written entry read-only.
     items: z.array(marketplaceItem.pick({ kind: true, name: true })),
   })
   .strict();