@robbeverhelst/do 1.151.0 → 1.152.0

package/dist/do.js

@@ -18050,6 +18050,60 @@ var linkGoogleInputSchema = exports_external.object({
   state: exports_external.string().min(1)
 });
 
+// ../../packages/schema/src/contracts/changes.ts
+var changeOpSchema = exports_external.enum(["created", "updated", "deleted"]);
+var CHANGE_ENTITY_SCOPES = {
+  task: "tasks:read",
+  project: "projects:read",
+  area: "areas:read",
+  routine: "routines:read",
+  habit: "habits:read",
+  occurrence: "occurrences:read",
+  note: "notes:read",
+  contact: "contacts:read",
+  collection_item: "collections:read",
+  inventory_item: "inventory:read",
+  shopping_list: "shopping:read",
+  recipe: "meals:read",
+  meal_plan: "meals:read",
+  event: "calendar:read",
+  time_block: "calendar:read",
+  place: "places:read"
+};
+var CHANGE_ENTITIES = Object.keys(CHANGE_ENTITY_SCOPES);
+var changeEntitySchema = exports_external.enum(CHANGE_ENTITIES);
+var changeSchema = exports_external.object({
+  entity: changeEntitySchema,
+  id: exports_external.string(),
+  op: changeOpSchema,
+  changedAt: exports_external.coerce.date()
+});
+var MAX_CHANGES_LIMIT = 500;
+var CHANGES_SINCE_NOW = "now";
+var CURSOR_RE = /^(\d+)-(\d+)$/;
+function parseChangeCursor(raw) {
+  const m = CURSOR_RE.exec(raw);
+  if (!m)
+    return null;
+  const txid = Number(m[1]);
+  const seq = Number(m[2]);
+  if (!Number.isSafeInteger(txid) || !Number.isSafeInteger(seq))
+    return null;
+  return { txid, seq };
+}
+var changesQuerySchema = exports_external.object({
+  since: exports_external.string().refine((s) => s === CHANGES_SINCE_NOW || parseChangeCursor(s) !== null, {
+    message: "since must be a cursor from a prior page's nextCursor, or 'now'"
+  }).optional(),
+  limit: exports_external.coerce.number().int().positive().transform((n) => Math.min(n, MAX_CHANGES_LIMIT)).optional(),
+  entity: exports_external.string().transform((s) => s.split(",").map((e) => e.trim()).filter((e) => e.length > 0)).pipe(exports_external.array(changeEntitySchema).min(1)).optional()
+});
+var changesPageSchema = exports_external.object({
+  data: exports_external.array(changeSchema),
+  nextCursor: exports_external.string(),
+  hasMore: exports_external.boolean()
+});
+
 // ../../packages/schema/src/contracts/value-sets.ts
 var areaColorSchema = exports_external.enum(areaColor.enumValues);
 var reviewCadenceSchema = exports_external.enum(reviewCadence.enumValues);
@@ -19532,6 +19586,110 @@ var timeBlockRangeQuerySchema = exports_external.object({
   path: ["to"]
 });
 
+// ../../packages/schema/src/contracts/agent-chat.ts
+var agentConnectionSourceSchema = exports_external.enum(["space", "env"]);
+var agentConnectionSchema = exports_external.object({
+  connected: exports_external.boolean(),
+  source: agentConnectionSourceSchema.nullable(),
+  endpoint: exports_external.string().nullable(),
+  model: exports_external.string().nullable(),
+  hasKey: exports_external.boolean(),
+  agentId: exports_external.string().nullable(),
+  autoFile: exports_external.boolean(),
+  updatedAt: exports_external.coerce.date().nullable()
+});
+var agentEndpointSchema = exports_external.string().trim().max(2000).url().refine((value) => /^https?:\/\//i.test(value), "endpoint must be an http(s) URL");
+var saveAgentConnectionInputSchema = exports_external.object({
+  endpoint: agentEndpointSchema,
+  apiKey: exports_external.string().trim().min(1).max(4000).nullable().optional(),
+  model: exports_external.string().trim().min(1).max(200).nullable().optional(),
+  agentId: exports_external.string().trim().min(1).max(64).nullable().optional(),
+  autoFile: exports_external.boolean().optional()
+}).strict();
+var agentPageContextSchema = exports_external.object({
+  route: exports_external.string().trim().min(1).max(500).startsWith("/"),
+  nodeId: exports_external.string().trim().min(1).max(64).nullable()
+}).strict();
+var agentChatInputSchema = exports_external.object({
+  message: exports_external.string().trim().min(1).max(8000),
+  context: agentPageContextSchema
+}).strict();
+var agentChatEventSchema = exports_external.discriminatedUnion("type", [
+  exports_external.object({ type: exports_external.literal("delta"), text: exports_external.string() }),
+  exports_external.object({ type: exports_external.literal("done") }),
+  exports_external.object({ type: exports_external.literal("error"), message: exports_external.string() })
+]);
+var agentChangeValueSchema = exports_external.union([
+  exports_external.string(),
+  exports_external.number(),
+  exports_external.boolean(),
+  exports_external.null(),
+  exports_external.array(exports_external.string())
+]);
+var agentChangeFieldSchema = exports_external.object({
+  field: exports_external.string(),
+  before: agentChangeValueSchema,
+  after: agentChangeValueSchema,
+  beforeLabel: exports_external.string().nullable().optional(),
+  afterLabel: exports_external.string().nullable().optional()
+});
+var agentChangeSchema = exports_external.object({
+  entity: changeEntitySchema,
+  id: exports_external.string(),
+  op: changeOpSchema,
+  changedAt: exports_external.coerce.date(),
+  title: exports_external.string().nullable(),
+  actor: actorRefSchema,
+  fields: exports_external.array(agentChangeFieldSchema).optional()
+});
+var agentChangesPageSchema = exports_external.object({
+  data: exports_external.array(agentChangeSchema),
+  nextCursor: exports_external.string()
+});
+var agentChangesQuerySchema = exports_external.object({
+  since: exports_external.string().refine((s) => s === "now" || /^\d+-\d+$/.test(s), {
+    message: "since must be a cursor from a prior page's nextCursor, or 'now'"
+  })
+});
+var agentConfirmationKindSchema = exports_external.enum(["delete", "cancel", "google", "orca", "bulk"]);
+var agentConfirmationStatusSchema = exports_external.enum([
+  "pending",
+  "confirmed",
+  "done",
+  "failed",
+  "declined"
+]);
+var agentConfirmationSchema = exports_external.object({
+  id: exports_external.string(),
+  kind: agentConfirmationKindSchema,
+  summary: exports_external.string(),
+  items: exports_external.array(exports_external.object({ id: exports_external.string(), title: exports_external.string().nullable() })),
+  method: exports_external.string(),
+  path: exports_external.string(),
+  status: agentConfirmationStatusSchema,
+  agent: exports_external.object({ id: exports_external.string(), name: exports_external.string().nullable() }),
+  createdAt: exports_external.coerce.date(),
+  decidedAt: exports_external.coerce.date().nullable()
+});
+var agentUndoInputSchema = exports_external.object({
+  id: exports_external.string().trim().min(1).max(64),
+  since: exports_external.string().regex(/^\d+-\d+$/, "since must be a change-feed cursor")
+}).strict();
+var agentUndoResultSchema = exports_external.object({
+  id: exports_external.string(),
+  undone: exports_external.enum(["removed", "restored"])
+});
+var agentRedoResultSchema = exports_external.object({
+  id: exports_external.string(),
+  redone: exports_external.literal(true)
+});
+var agentFilingSchema = exports_external.object({
+  confident: exports_external.boolean().default(false),
+  areaId: exports_external.string().nullable().optional(),
+  owner: exports_external.string().nullable().optional(),
+  date: exports_external.string().regex(/^\d{4}-\d{2}-\d{2}$/).nullable().optional()
+});
+
 // ../../packages/schema/src/contracts/roles.ts
 var permissionSetSchema = createSelectSchema(permissionSets, {
   createdAt: exports_external.coerce.date(),
@@ -20631,7 +20789,7 @@ function parseCapture2(input, now) {
 
 // src/meta.ts
 var CLI_NAME = "do";
-var VERSION = "1.151.0";
+var VERSION = "1.152.0";
 var API_PREFIX = "/api/v1";
 var DEFAULT_API_URL = "http://localhost:3001";
 
@@ -21530,6 +21688,68 @@ var COMMAND_SPECS = [
     returns: "None",
     notes: "Gated behind --allow-destructive + an orca:write key. Idempotent."
   },
+  {
+    path: ["agents", "list"],
+    summary: "List the Space's Agents (id + name).",
+    args: [],
+    flags: [],
+    scopes: ["agents:read"],
+    returns: "AgentSummary",
+    notes: "Creating an Agent and minting its keys stays a member's job in the app."
+  },
+  {
+    path: ["agent", "connection", "get"],
+    summary: "Show the agent runtime the Echo panel's chat goes to (never its key).",
+    args: [],
+    flags: [],
+    scopes: ["agents:read"],
+    returns: "AgentConnection",
+    notes: "hasKey says whether a key is set; the key itself is write-only."
+  },
+  {
+    path: ["agent", "connection", "set"],
+    summary: "Point the Echo panel at an agent runtime (replaces the connection).",
+    args: [],
+    flags: [
+      { name: "endpoint", type: "string", description: "The runtime's base URL (required)." },
+      {
+        name: "model",
+        type: "string",
+        description: "The model to ask for, if the runtime needs one."
+      },
+      {
+        name: "agent",
+        type: "string",
+        description: "The Agent the runtime acts as: its id or name (see `agents list`)."
+      },
+      {
+        name: "auto-file",
+        type: "boolean",
+        description: "Let Echo file new captures (needs --agent)."
+      },
+      { name: "no-auto-file", type: "boolean", description: "Stop Echo filing new captures." },
+      {
+        name: "key-stdin",
+        type: "boolean",
+        description: "Read the runtime's API key from stdin's first line instead of DO_AGENT_API_KEY."
+      },
+      { name: "clear-key", type: "boolean", description: "Remove the stored key." }
+    ],
+    scopes: ["agents:write"],
+    returns: "AgentConnection",
+    notes: "The runtime's key is read from DO_AGENT_API_KEY or, with --key-stdin, from stdin \u2014 never a flag. With neither, the stored key is kept. --model and --agent are replaced as sent (left out clears them). Owner/admin only (canManageSpace)."
+  },
+  {
+    path: ["agent", "connection", "remove"],
+    summary: "Forget the Space's agent connection (destructive).",
+    args: [],
+    flags: [
+      { name: "allow-destructive", type: "boolean", description: "Required to actually remove." }
+    ],
+    scopes: ["agents:write"],
+    returns: "None",
+    notes: "Owner/admin only. An Agent's key gets a 428 confirmation_required until the member confirms in the Echo panel."
+  },
   {
     path: ["settings", "get"],
     summary: "Show the caller's settings for the Space.",
@@ -22051,7 +22271,7 @@ var COMMAND_SPECS = [
   }
 ];
 function matchCommandSpec(positionals) {
-  for (const len of [2, 1]) {
+  for (const len of [3, 2, 1]) {
     const candidate = positionals.slice(0, len);
     if (candidate.length < len)
       continue;
@@ -23217,6 +23437,35 @@ var HANDLERS = {
     const input = parseInput(logMetricInputSchema, { value, ...at ? { occurredAt: at } : {} });
     return { data: await requireClient().post(`/metrics/${key}`, input), render: renderRecord };
   },
+  "agents list": async ({ requireClient }) => ({
+    data: await requireClient().getPage("/agents"),
+    render: renderList
+  }),
+  "agent connection get": async ({ requireClient }) => ({
+    data: await requireClient().get("/agent/connection"),
+    render: renderRecord
+  }),
+  "agent connection set": async ({ io, flags, requireClient }) => {
+    const endpoint = flagString(flags, "endpoint");
+    if (endpoint === undefined)
+      throw usageError("agent connection set needs --endpoint <url>");
+    const client = requireClient();
+    const agent = flagString(flags, "agent");
+    const autoFile = flagBool(flags, "auto-file") ? true : flagBool(flags, "no-auto-file") ? false : undefined;
+    const body = parseInput(saveAgentConnectionInputSchema, {
+      endpoint,
+      model: flagString(flags, "model"),
+      agentId: agent === undefined ? undefined : await resolveAgentId(client, agent),
+      autoFile,
+      apiKey: await readAgentKey(io, flags)
+    });
+    return { data: await client.put("/agent/connection", body), render: renderRecord };
+  },
+  "agent connection remove": async ({ flags, requireClient }) => {
+    assertDestructiveAllowed(flags, "remove the agent connection");
+    await requireClient().delete("/agent/connection");
+    return { data: { ok: true, removed: "agent connection" }, render: renderRecord };
+  },
   "settings get": async ({ requireClient }) => ({
     data: await requireClient().get("/settings"),
     render: renderRecord
@@ -23635,6 +23884,38 @@ function redact(secret) {
     return "********";
   return `${secret.slice(0, 6)}\u2026${secret.slice(-2)}`;
 }
+var AGENT_KEY_ENV = "DO_AGENT_API_KEY";
+async function readAgentKey(io, flags) {
+  if (flagBool(flags, "clear-key"))
+    return null;
+  if (flagBool(flags, "key-stdin")) {
+    let first;
+    if (io.stdin) {
+      for await (const line2 of io.stdin) {
+        first = line2;
+        break;
+      }
+    }
+    const key = first?.trim();
+    if (!key)
+      throw usageError("--key-stdin read no key: pipe the key in on stdin");
+    return key;
+  }
+  const fromEnv = io.env[AGENT_KEY_ENV]?.trim();
+  return fromEnv ? fromEnv : undefined;
+}
+var ULID = /^[0-9A-HJKMNP-TV-Z]{26}$/i;
+async function resolveAgentId(client, agent) {
+  if (ULID.test(agent))
+    return agent;
+  const { data } = await client.getPage("/agents");
+  const wanted = agent.trim().toLowerCase();
+  const match = data.find((a) => a.name.toLowerCase() === wanted);
+  if (!match) {
+    throw new CliError("not_found", `no Agent named ${agent} \u2014 see \`do agents list\``, EXIT.NOT_FOUND);
+  }
+  return match.id;
+}
 function requireWrite(entity, op) {
   if (!entity.write) {
     throw usageError(`\`${entity.name}\` is read-only \u2014 \`${op}\` is not available`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robbeverhelst/do",
-  "version": "1.151.0",
+  "version": "1.152.0",
   "private": false,
   "description": "do — the agent-drivable CLI over the public /api/v1 surface",
   "type": "module",