@lotics/cli 0.97.0 → 0.98.0

package/dist/src/cli.js

@@ -44165,9 +44165,7 @@ import os2 from "node:os";
 import path7 from "node:path";
 import readline from "node:readline";
 
-// src/client.ts
-import fs from "node:fs";
-import path from "node:path";
+// ../shared/src/transport_error.ts
 function gatewayErrorMessage(status) {
   if (status === 524) {
     return "The request took too long to finish (gateway timeout). It may still be running \u2014 check back in a moment, or try again.";
@@ -44181,6 +44179,10 @@ function transportErrorMessage(status, parsed) {
   const jsonMessage = parsed && typeof parsed.message === "string" ? parsed.message : null;
   return parsed === null || status >= 500 || jsonMessage === null ? gatewayErrorMessage(status) : jsonMessage;
 }
+
+// src/client.ts
+import fs from "node:fs";
+import path from "node:path";
 function findAvailableFilename(dir, filename, reserved) {
   const isTaken = (name) => {
     const full = path.join(dir, name);
@@ -64415,7 +64417,8 @@ var aggregateOperationSchema = external_exports.enum([
   "checked",
   "unchecked",
   "percent_checked",
-  "percent_unchecked"
+  "percent_unchecked",
+  "string_agg"
 ]);
 var OPERATION_FIELD_TYPES = {
   empty: ["text", "number", "date", "select", "select_member", "select_record_link", "files", "formula", "rollup"],
@@ -64530,12 +64533,21 @@ var queryProjectionColumnSchema = zod_default.union([
   zod_default.string().describe("Passthrough shorthand: a source field key. Output = the key, type = the field's type."),
   queryProjectionColumnObjectSchema
 ]);
+var STRING_AGG_MAX_VALUES = 100;
+var STRING_AGG_DEFAULT_MAX_VALUES = 20;
 var queryAggregateColumnSchema = zod_default.object({
   output: zod_default.string().describe("Output column name"),
   type: queryColumnTypeSchema.describe("Output column type"),
   operation: aggregateOperationSchema,
   input_column: zod_default.string().optional().describe(
     "Input column to aggregate. Required for non-count operations; ignored for count."
+  ),
+  separator: zod_default.string().max(8).optional().describe('string_agg only. Joins the values. Defaults to ", ".'),
+  distinct: zod_default.boolean().optional().describe(
+    "string_agg only. Collapses repeats \u2014 a group of containers sized 40HC/40HC/20DC aggregates to '20DC, 40HC'. Defaults to true, which is almost always what a summary column wants."
+  ),
+  max_values: zod_default.number().int().min(1).max(STRING_AGG_MAX_VALUES).optional().describe(
+    `string_agg only. Caps how many values are emitted so an unbounded child set cannot produce a giant cell. Defaults to ${STRING_AGG_DEFAULT_MAX_VALUES}. Pair with a \`unique\` aggregate to render an accurate '+N more'.`
   )
 });
 var rankingWindowFunctionSchema = (fn) => zod_default.object({ output: zod_default.string().describe("Output column name"), fn: zod_default.literal(fn) }).strict();
@@ -64892,6 +64904,12 @@ var appAgentDeclarationSchema = zod_default.object({
   knowledge_doc_ids: zod_default.array(zod_default.string().min(1)).optional().describe(
     "Knowledge docs the agent may read, validated at declare time against the app owner's `use` access. Small docs are inlined into the agent's system prompt each run; a doc too large to inline requires the code tools (code_exec) in tool_names and is read by staging it into a code run. Omit for an agent that needs no knowledge."
   ),
+  query_aliases: zod_default.array(zod_default.string().min(1)).optional().describe(
+    "Named queries from this app's manifest the agent may run via `run_app_query`, validated at declare time against the app's own queries. This is the agent's ENTIRE read surface over workspace data \u2014 a template fixes the tables, filters, and projection, so it bounds rows and columns, not just tables. Omit for an agent that reads no records."
+  ),
+  workflow_aliases: zod_default.array(zod_default.string().min(1)).optional().describe(
+    "Workflows from this app's manifest the agent may invoke via `run_app_workflow`, validated at declare time against the app's own workflows. This is the agent's ENTIRE write surface \u2014 the same declared mutation path the app's UI uses, so table hooks and side-effect harvesting apply. Omit for a read-only agent."
+  ),
   model_id: zod_default.string().min(1).optional().describe(
     "Chat model id the agent runs on, validated against ACCEPTED_CHAT_MODEL_IDS. Omit to follow the platform default chat model, resolved at run time \u2014 the preferred choice: the agent tracks model generations with no per-app rewrite. Pin only a deliberate, tested choice."
   ),

package/dist/src/client.d.ts

@@ -1,12 +1,4 @@
 import type { ContractConfigEntry, KnowledgeUpgradeEntry, ModifiedArtifact, PackageContentBinding, UpgradeResolutions } from "./package_content_types";
-/**
- * The error message for a non-ok response. A genuine JSON error (a 4xx carrying
- * a `message`) surfaces verbatim; a non-JSON body (a gateway HTML page), any
- * 5xx, or a JSON body without a `message` falls back to a body-free,
- * status-derived message. `parsed` is the JSON.parse of the body, or `null`.
- * In parity (by value, no shared dep) with `packages/app-sdk/src/rpc.ts`.
- */
-export declare function transportErrorMessage(status: number, parsed: unknown): string;
 /** One sort key forwarded to the app query RPC (wire shape of a `TableRecordSort` entry). */
 export interface AppQuerySortKey {
     field_key: string;
@@ -89,19 +81,20 @@ export interface ToolInfo {
 }
 /**
  * A single knowledge doc with its HYDRATED body — the shape of
- * `GET /v1/knowledge_docs/{id}`. `content` is resolved server-side from the
- * doc's content file (or the parked column for a legacy row), so this is the
- * one content-read path a non-sandbox client has. `content_file_id` is the
- * concurrency token the REST PATCH echoes; the `update_knowledge` TOOL CASes
- * internally, so a CLI caller never needs to pass it.
+ * `GET /v1/knowledge_docs/{id}`, and the one content-read path a non-sandbox
+ * client has. `content_sha` is the concurrency token the REST PATCH echoes back
+ * as `expected_content_sha`; the `update_knowledge` TOOL CASes internally, so a
+ * CLI caller never needs to pass it.
  */
 export interface KnowledgeDocDetail {
     id: string;
     workspace_id: string;
     name: string;
     description: string;
+    /** Folder address; "" is root. */
+    path: string;
     content: string;
-    content_file_id: string | null;
+    content_sha: string | null;
     files: unknown[];
     created_at: string;
     updated_at: string;

package/dist/src/client.js

@@ -1,36 +1,6 @@
+import { transportErrorMessage } from "@lotics/shared/transport_error";
 import fs from "node:fs";
 import path from "node:path";
-/**
- * A user-facing message for a transport/gateway failure — derived from the HTTP
- * status, never from the response body. A 524 (edge timeout on a long run), any
- * 5xx, or a non-JSON body (an HTML error page) must NOT surface its raw body. In
- * parity (by value, no shared dep) with the published transport in
- * `packages/app-sdk/src/rpc.ts`.
- */
-function gatewayErrorMessage(status) {
-    if (status === 524) {
-        return "The request took too long to finish (gateway timeout). It may still be running — check back in a moment, or try again.";
-    }
-    if (status >= 500) {
-        return "The service is temporarily unavailable. Please try again shortly.";
-    }
-    return "The service returned an unexpected response. Please try again.";
-}
-/**
- * The error message for a non-ok response. A genuine JSON error (a 4xx carrying
- * a `message`) surfaces verbatim; a non-JSON body (a gateway HTML page), any
- * 5xx, or a JSON body without a `message` falls back to a body-free,
- * status-derived message. `parsed` is the JSON.parse of the body, or `null`.
- * In parity (by value, no shared dep) with `packages/app-sdk/src/rpc.ts`.
- */
-export function transportErrorMessage(status, parsed) {
-    const jsonMessage = parsed && typeof parsed.message === "string"
-        ? parsed.message
-        : null;
-    return parsed === null || status >= 500 || jsonMessage === null
-        ? gatewayErrorMessage(status)
-        : jsonMessage;
-}
 function findAvailableFilename(dir, filename, reserved) {
     // `reserved` tracks absolute paths claimed by in-flight downloads in the same
     // batch — required for parallel callers because the file may not be on disk

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.97.0",
+  "version": "0.98.0",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {