@robbeverhelst/do 1.166.1 → 1.167.0

package/dist/do.js

@@ -3576,6 +3576,9 @@ var agents = pgTable("agents", {
   name: text("name").notNull(),
   revokedAt: timestamp("revoked_at", { withTimezone: true }),
   trustedDesks: text("trusted_desks").array().notNull().default([]),
+  gatewayConnectedAt: timestamp("gateway_connected_at", { withTimezone: true }),
+  gatewaySeenAt: timestamp("gateway_seen_at", { withTimezone: true }),
+  gatewayDisconnectedAt: timestamp("gateway_disconnected_at", { withTimezone: true }),
   createdAt: timestamp("created_at", { withTimezone: true }).notNull().defaultNow(),
   updatedAt: timestamp("updated_at", { withTimezone: true }).notNull().defaultNow()
 }, (t) => [
@@ -18189,6 +18192,9 @@ var reflectionKindSchema = _enum2(reflectionKind.enumValues);
 var agentSchema = createSelectSchema(agents, {
   trustedDesks: array(string2()).default([]),
   revokedAt: exports_coerce.date().nullable(),
+  gatewayConnectedAt: exports_coerce.date().nullable().default(null),
+  gatewaySeenAt: exports_coerce.date().nullable().default(null),
+  gatewayDisconnectedAt: exports_coerce.date().nullable().default(null),
   createdAt: exports_coerce.date(),
   updatedAt: exports_coerce.date()
 });
@@ -18618,6 +18624,10 @@ var collectionCoverResultSchema = object({
   found: boolean3(),
   item: collectionItemViewSchema
 });
+var COVER_CANDIDATES_LIMIT = 6;
+var collectionCoverCandidatesSchema = object({
+  candidates: array(object({ url: string2().url() })).max(COVER_CANDIDATES_LIMIT)
+});
 var collectionCoverBackfillResultSchema = object({
   checked: number2().int().min(0),
   found: number2().int().min(0),
@@ -19864,6 +19874,13 @@ var timeBlockRangeQuerySchema = object({
 
 // ../../packages/schema/src/contracts/agent-chat.ts
 var agentConnectionSourceSchema = _enum2(["space", "env"]);
+var agentGatewayStatusSchema = _enum2(["connected", "offline", "not_connected"]);
+var agentGatewayStateSchema = object({
+  status: agentGatewayStatusSchema,
+  connectedAt: exports_coerce.date().nullable(),
+  seenAt: exports_coerce.date().nullable(),
+  disconnectedAt: exports_coerce.date().nullable()
+});
 var agentConnectionSchema = object({
   connected: boolean3(),
   source: agentConnectionSourceSchema.nullable(),
@@ -19871,17 +19888,22 @@ var agentConnectionSchema = object({
   model: string2().nullable(),
   hasKey: boolean3(),
   agentId: string2().nullable(),
+  agentName: string2().nullable().default(null),
   autoFile: boolean3(),
-  updatedAt: exports_coerce.date().nullable()
+  updatedAt: exports_coerce.date().nullable(),
+  gateway: agentGatewayStateSchema.nullable().default(null)
 });
 var agentEndpointSchema = string2().trim().max(2000).url().refine((value) => /^https?:\/\//i.test(value), "endpoint must be an http(s) URL");
 var saveAgentConnectionInputSchema = object({
-  endpoint: agentEndpointSchema,
+  endpoint: agentEndpointSchema.nullable(),
   apiKey: string2().trim().min(1).max(4000).nullable().optional(),
   model: string2().trim().min(1).max(200).nullable().optional(),
   agentId: string2().trim().min(1).max(64).nullable().optional(),
   autoFile: boolean3().optional()
-}).strict();
+}).strict().refine((input) => input.endpoint !== null || Boolean(input.agentId), {
+  message: "a connection without an endpoint names its agent",
+  path: ["agentId"]
+});
 var agentPageContextSchema = object({
   route: string2().trim().min(1).max(500).startsWith("/"),
   nodeId: string2().trim().min(1).max(64).nullable()
@@ -19900,7 +19922,13 @@ var agentChatEventSchema = discriminatedUnion("type", [
   }),
   object({ type: literal("delta"), text: string2() }),
   object({ type: literal("done") }),
-  object({ type: literal("error"), message: string2() })
+  object({ type: literal("error"), message: string2() }),
+  object({
+    type: literal("posted"),
+    threadId: string2(),
+    postId: string2(),
+    delivery: _enum2(["sent", "waiting"])
+  })
 ]);
 var agentChangeValueSchema = union([
   string2(),
@@ -20825,9 +20853,15 @@ function blankMatches(input, regexes) {
 
 // ../../packages/schema/src/presets/collection-types.ts
 var coverUrl = string2().url().max(2048).nullish();
+var COVER_SOURCES_REJECTED_MAX = 50;
+var coverSourcesSchema = object({
+  current: string2().url().max(2048).nullish(),
+  rejected: array(string2().url().max(2048)).max(COVER_SOURCES_REJECTED_MAX).optional()
+}).strict();
 var bookFacetSchema = object({
   author: string2().min(1).max(200).nullish(),
   coverUrl,
+  coverSources: coverSourcesSchema.nullish(),
   pageCount: number2().int().min(1).max(1e5).nullish(),
   currentPage: number2().int().min(0).max(1e5).nullish(),
   isbn: string2().regex(/^[0-9Xx][0-9Xx\s-]{8,20}$/, "must be an ISBN").nullish()
@@ -20843,6 +20877,7 @@ var filmFacetSchema = object({
 var gameFacetSchema = object({
   platform: string2().min(1).max(120).nullish(),
   coverUrl,
+  coverSources: coverSourcesSchema.nullish(),
   completion: number2().int().min(0).max(100).nullish()
 }).strict();
 var musicFacetSchema = object({
@@ -21264,7 +21299,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.166.1";
+var VERSION = "1.167.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -22872,7 +22907,16 @@ var COMMAND_SPECS = [
     ],
     scopes: ["collections:write"],
     returns: "CollectionCoverResult",
-    notes: "Without --url: books from Open Library, games from IGDB then Steam; replaces the current cover when one is found. Returns { found, item }."
+    notes: "Without --url: books from Open Library, games from IGDB then Steam; replaces the current cover with the next one (the one showing and ones passed over before are skipped). found: false when no other is left. Returns { found, item }."
+  },
+  {
+    path: ["collection", "cover-candidates"],
+    summary: "List other covers for an Item, best first (up to 6).",
+    args: [{ name: "id", required: true, description: "Item ULID." }],
+    flags: [],
+    scopes: ["collections:read"],
+    returns: "CollectionCoverCandidates",
+    notes: "The providers' image URLs without the one showing and the ones passed over. Nothing is fetched; use one with `do collection cover <id> --url <url>`. Returns { candidates: [{ url }] }."
   },
   {
     path: ["collection", "covers"],
@@ -25102,6 +25146,11 @@ var HANDLERS = {
       render: renderRecord
     };
   },
+  "collection cover-candidates": async ({ args, requireClient }) => {
+    const id = requireArg(args, 0, "item id");
+    const result = collectionCoverCandidatesSchema.parse(await requireClient().get(`/collection/${id}/cover/candidates`));
+    return { data: result, render: renderRecord };
+  },
   "collection covers": async ({ requireClient }) => {
     const result = collectionCoverBackfillResultSchema.parse(await requireClient().post("/collection/covers", undefined));
     return { data: result, render: renderRecord };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.166.1",
+  "version": "1.167.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "homepage": "https://github.com/robbeverhelst/do/tree/main/apps/cli",