sim 2.1.0-preview.29.1 → 2.1.0-preview.33.1

package/dist/index.js

@@ -6579,6 +6579,24 @@ var V2_OPERATIONS = {
     responseMode: "json",
     summary: "Cancel Workflow Run"
   },
+  chat: {
+    method: "POST",
+    path: "/api/v2/chat",
+    pathParams: [],
+    responseMode: "json",
+    body: {
+      workspaceId: {
+        kind: "string",
+        required: true,
+        describe: "Workspace the conversation runs in."
+      },
+      message: { kind: "string", required: true, describe: "The message to send to Sim." },
+      conversationId: {
+        kind: "string",
+        describe: "Conversation to continue; a new one starts when omitted."
+      }
+    }
+  },
   completeFileUpload: {
     method: "POST",
     path: "/api/v2/files/uploads/[uploadId]/complete",
@@ -9044,7 +9062,7 @@ var V2_OPERATIONS = {
       workspaceId: { kind: "string", required: true, describe: "Unique workspace identifier." },
       predicate: {
         kind: "unknown",
-        describe: 'Recursive predicate tree. Each group node is exactly one non-empty `all` or `any` array whose members are further groups or `{ field, op, value }` conditions; the root must be a group, not a bare condition. At most 100 members per group, 10 levels of nesting, and 500 nodes in total. The negating operators include nulls: `ne`, `nin`, `ncontains`, `nlike`, and `nilike` match rows whose column is null or absent, so "not X" is not the complement of "X" over a nullable column. That holds for every column type, multi-select included. To exclude nulls, `all`-combine the negation with `isNotEmpty` (multi-select) or `isNotNull`. Comparison: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`. Membership: `in`, `nin` (array operand). Emptiness: `isEmpty`, `isNotEmpty`, `isNull`, `isNotNull` (no operand). Substring, always case-insensitive, operand matched literally: `contains`, `ncontains`, `startsWith`, `endsWith`. Pattern: `like`/`nlike` (case-sensitive), `ilike`/`nilike` (case-insensitive). **`*` is the only wildcard** and stands for any run of characters; `%`, `_`, and backslash match themselves. Use `like: "Hi*"`, not `like: "Hi%"`. A `select` column compares by option id and restricts its operators: single-select accepts `eq`, `ne`, `in`, `nin`; multi-select accepts `contains`, `ncontains`. Option names are accepted as operands and resolved to ids.'
+        describe: 'A single `{ field, op, value }` condition or a recursive `all`/`any` group; either form is normalized to a grouped predicate after validation. At most 100 members per group, 10 levels of nesting, and 500 nodes in total. The negating operators include nulls: `ne`, `nin`, `ncontains`, `nlike`, and `nilike` match rows whose column is null or absent, so "not X" is not the complement of "X" over a nullable column. That holds for every column type, multi-select included. To exclude nulls, `all`-combine the negation with `isNotEmpty` (multi-select) or `isNotNull`. Comparison: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`. Membership: `in`, `nin` (array operand). Emptiness: `isEmpty`, `isNotEmpty`, `isNull`, `isNotNull` (no operand). Substring, always case-insensitive, operand matched literally: `contains`, `ncontains`, `startsWith`, `endsWith`. Pattern: `like`/`nlike` (case-sensitive), `ilike`/`nilike` (case-insensitive). **`*` is the only wildcard** and stands for any run of characters; `%`, `_`, and backslash match themselves. Use `like: "Hi*"`, not `like: "Hi%"`. A `select` column compares by option id and restricts its operators: single-select accepts `eq`, `ne`, `in`, `nin`; multi-select accepts `contains`, `ncontains`. Option names are accepted as operands and resolved to ids.'
       },
       sort: { kind: "array", describe: "Ordered table-row sort specification." },
       limit: {
@@ -9065,7 +9083,7 @@ var V2_OPERATIONS = {
       workspaceId: { kind: "string", required: true, describe: "Unique workspace identifier." },
       predicate: {
         kind: "unknown",
-        describe: 'Recursive predicate tree. Each group node is exactly one non-empty `all` or `any` array whose members are further groups or `{ field, op, value }` conditions; the root must be a group, not a bare condition. At most 100 members per group, 10 levels of nesting, and 500 nodes in total. The negating operators include nulls: `ne`, `nin`, `ncontains`, `nlike`, and `nilike` match rows whose column is null or absent, so "not X" is not the complement of "X" over a nullable column. That holds for every column type, multi-select included. To exclude nulls, `all`-combine the negation with `isNotEmpty` (multi-select) or `isNotNull`. Comparison: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`. Membership: `in`, `nin` (array operand). Emptiness: `isEmpty`, `isNotEmpty`, `isNull`, `isNotNull` (no operand). Substring, always case-insensitive, operand matched literally: `contains`, `ncontains`, `startsWith`, `endsWith`. Pattern: `like`/`nlike` (case-sensitive), `ilike`/`nilike` (case-insensitive). **`*` is the only wildcard** and stands for any run of characters; `%`, `_`, and backslash match themselves. Use `like: "Hi*"`, not `like: "Hi%"`. A `select` column compares by option id and restricts its operators: single-select accepts `eq`, `ne`, `in`, `nin`; multi-select accepts `contains`, `ncontains`. Option names are accepted as operands and resolved to ids.'
+        describe: 'A single `{ field, op, value }` condition or a recursive `all`/`any` group; either form is normalized to a grouped predicate after validation. At most 100 members per group, 10 levels of nesting, and 500 nodes in total. The negating operators include nulls: `ne`, `nin`, `ncontains`, `nlike`, and `nilike` match rows whose column is null or absent, so "not X" is not the complement of "X" over a nullable column. That holds for every column type, multi-select included. To exclude nulls, `all`-combine the negation with `isNotEmpty` (multi-select) or `isNotNull`. Comparison: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`. Membership: `in`, `nin` (array operand). Emptiness: `isEmpty`, `isNotEmpty`, `isNull`, `isNotNull` (no operand). Substring, always case-insensitive, operand matched literally: `contains`, `ncontains`, `startsWith`, `endsWith`. Pattern: `like`/`nlike` (case-sensitive), `ilike`/`nilike` (case-insensitive). **`*` is the only wildcard** and stands for any run of characters; `%`, `_`, and backslash match themselves. Use `like: "Hi*"`, not `like: "Hi%"`. A `select` column compares by option id and restricts its operators: single-select accepts `eq`, `ne`, `in`, `nin`; multi-select accepts `contains`, `ncontains`. Option names are accepted as operands and resolved to ids.'
       }
     }
   },
@@ -10193,6 +10211,7 @@ import { existsSync as existsSync2, readFileSync as readFileSync3, readSync } fr
 // src/contract/commands.ts
 var TABLE_NAME_HELP = "Identifier: letters, numbers, and underscores; cannot start with a number";
 var TABLE_FILTER_HELP = 'Predicate: {"all":[{"field":"status","op":"eq","value":"active"}]}; groups use all/any. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull';
+var TABLE_READ_FILTER_HELP = 'Condition: {"field":"status","op":"eq","value":"active"}. Groups: {"all":[{"field":"status","op":"eq","value":"active"}]} or {"any":[{"field":"status","op":"eq","value":"active"}]}; group entries may also be nested groups. Operators: eq, ne, gt, gte, lt, lte, in, nin, contains, ncontains, startsWith, endsWith, like, ilike, nlike, nilike, isEmpty, isNotEmpty, isNull, isNotNull';
 var TABLE_SORT_HELP = 'Ordered sort keys: [{"field":"createdAt","direction":"desc"}] (direction: asc or desc)';
 var CUSTOM_TOOL_SCHEMA_HELP = 'OpenAI function schema: {"type":"function","function":{"name":"...","parameters":{"type":"object","properties":{}}}}';
 var FOLDER_PATH_INPUT = {
@@ -10231,6 +10250,7 @@ function moveResource(command, resource) {
   };
 }
 var CLI_CONTRACT = {
+  chat: { hidden: true },
   createCredentialConnection: { hidden: true },
   createServiceAccountCredential: { hidden: true },
   getBillingStatus: {
@@ -10431,7 +10451,7 @@ var CLI_CONTRACT = {
   queryRows: {
     command: "tables rows query",
     flags: {
-      predicate: { name: "filter", json: true, describe: TABLE_FILTER_HELP },
+      predicate: { name: "filter", json: true, describe: TABLE_READ_FILTER_HELP },
       sort: { json: true, describe: TABLE_SORT_HELP }
     },
     expand: "data"
@@ -10859,7 +10879,7 @@ var CLI_CONTRACT = {
         name: "filter",
         renamedFrom: ["predicate"],
         json: true,
-        describe: TABLE_FILTER_HELP
+        describe: TABLE_READ_FILTER_HELP
       }
     }
   },
@@ -11655,21 +11675,129 @@ function attachCredentialCommands(program2) {
   credentials.command("reconnect").argument("<credentialId>", "Existing OAuth credential to re-authorize").description("Create a short-lived link for reconnecting an OAuth credential").action((credentialId, _options, command) => createConnectionLink(command, { credentialId }));
 }
 
-// src/commands/protocol/files-get.ts
-import { once as once2 } from "node:events";
-import { createWriteStream } from "node:fs";
-import { link, lstat, mkdtemp, readlink, rename, rm } from "node:fs/promises";
-import { dirname as dirname2, join as join2, resolve as resolve2 } from "node:path";
-import { Readable } from "node:stream";
-import { pipeline } from "node:stream/promises";
-
 // src/commands/protocol/result.ts
 function printProtocolResult(format, result) {
   const fields = Object.entries(result).map(([key, value]) => [key, text(value)]);
   printRecord(format, fields, result);
 }
 
+// src/commands/protocol/chat.ts
+function parseChatStreamLine(line) {
+  const trimmed = line.trim();
+  if (!trimmed)
+    return;
+  try {
+    return JSON.parse(trimmed);
+  } catch {
+    throw new SimApiError("Chat stream returned malformed data", 0);
+  }
+}
+async function readChatStream(response, onChunk) {
+  if (!response.body) {
+    throw new SimApiError("Chat stream ended without a response body", 0);
+  }
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder;
+  let buffer = "";
+  let finalResult;
+  const processLine = (line) => {
+    const event = parseChatStreamLine(line);
+    if (!event || event.type === "heartbeat")
+      return;
+    if (event.type === "chunk") {
+      if (event.content)
+        onChunk(sanitize(event.content));
+      return;
+    }
+    if (event.type === "error") {
+      throw new SimApiError(event.error || "Chat request failed", 0);
+    }
+    if (event.type === "final") {
+      finalResult = event.data;
+      return;
+    }
+    throw new SimApiError("Chat stream returned an unknown event", 0);
+  };
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done)
+        break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split(`
+`);
+      buffer = lines.pop() ?? "";
+      for (const line of lines) {
+        processLine(line);
+      }
+    }
+    buffer += decoder.decode();
+    processLine(buffer);
+    if (!finalResult) {
+      throw new SimApiError("Chat stream ended without a final result", 0);
+    }
+    return finalResult;
+  } finally {
+    reader.releaseLock();
+  }
+}
+function attachChat(program2) {
+  program2.command("chat").description("Ask Sim and print the reply").argument("<message>", "What to ask Sim").option("-c, --conversation <id>", "Continue the conversation with this ID").addHelpText("after", `
+Each turn prints the reply on stdout and the conversation ID on stderr; pass
+that ID back with -c to continue the same conversation. With --output json or
+yaml the reply is not streamed — the finished result is printed as one
+document, conversation ID included.
+
+Examples:
+  $ sim chat "What workflows do I have?"
+  $ sim chat -c 3f2a… "Which of those run on a schedule?"
+  $ sim --output json chat "Summarize yesterday's failed runs" | jq -r '.content'
+`).action(async (message, options, command) => {
+    const { client, profile } = clientFrom(command);
+    const workspaceId = client.requireWorkspace();
+    const response = await client.requestRaw(V2_OPERATIONS.chat.path, {
+      method: "POST",
+      body: {
+        workspaceId,
+        message,
+        ...options.conversation ? { conversationId: options.conversation } : {}
+      },
+      headers: { accept: "application/x-ndjson" }
+    });
+    const streaming = profile.output === "table" || profile.output === "text";
+    let streamed = "";
+    const result = await readChatStream(response, (content2) => {
+      if (!streaming)
+        return;
+      streamed += content2;
+      process.stdout.write(content2);
+    });
+    if (!streaming) {
+      printProtocolResult(profile.output, result);
+      return;
+    }
+    const content = sanitize(result.content ?? "");
+    if (content.startsWith(streamed) && content.length > streamed.length) {
+      process.stdout.write(content.slice(streamed.length));
+      streamed = content;
+    }
+    if (streamed.length > 0 && !streamed.endsWith(`
+`)) {
+      process.stdout.write(`
+`);
+    }
+    process.stderr.write(`${source_default.dim(`conversation: ${result.conversationId}`)}
+`);
+  });
+}
+
 // src/commands/protocol/files-get.ts
+import { once as once2 } from "node:events";
+import { createWriteStream } from "node:fs";
+import { link, lstat, mkdtemp, readlink, rename, rm } from "node:fs/promises";
+import { dirname as dirname2, join as join2, resolve as resolve2 } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
 function writeFailure(path, error) {
   if (isRequestTimeout(error)) {
     return new SimApiError(`Downloading ${path} timed out. ${RAISE_TIMEOUT_HINT}`, 0);
@@ -13051,6 +13179,7 @@ function attachProtocolCommands(program2) {
   attachWorkflowRunFollow(workflows);
   attachWorkflowRunWait(group(workflows, "runs"));
   attachLogsFollow(group(program2, "logs"));
+  attachChat(program2);
 }
 
 // src/terminal/secret-input.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sim",
-  "version": "2.1.0-preview.29.1",
+  "version": "2.1.0-preview.33.1",
   "description": "Sim CLI - talk to the Sim API from your terminal",
   "type": "module",
   "bin": {