recess-cli 2.9.0 → 2.10.0

package/dist/cli.js

@@ -9,6 +9,7 @@ import { clearStoredSession, deleteProfile, listProfiles, resolveConfig, savePro
 import { agentContext, buildCommandSchema, findCommandSchema, remoteCommands, scopedHelp, validateInvocation, } from "./command-schema.js";
 import { runApplicationsCommand } from "./commands/applications.js";
 import { runAppsCommand } from "./commands/apps.js";
+import { runChatLogsCommand } from "./commands/chat-logs.js";
 import { runMasteryCommand } from "./commands/mastery.js";
 import { runOnboardingCommand } from "./commands/onboarding.js";
 import { runSchoolCommand } from "./commands/school.js";
@@ -4400,6 +4401,9 @@ export async function executeRecessCommand(argv, options = {}) {
         }
         throw new CliError("invalid_arguments", "Use goals list|create|edit|delete|restore|archive|unarchive|complete|undo-completion|queue|files|pdf.");
     }
+    if (noun === "chat-logs") {
+        return runChatLogsCommand({ parsed, api, writeCommand });
+    }
     if (noun === "students") {
         if (verb === "list") {
             const requestedScope = flagString(parsed, "scope");

package/dist/command-schema.js

@@ -138,6 +138,9 @@ const AUTHENTICATED_COMMAND_PREFIXES = [
     "village render",
 ];
 const FAMILY_AI_COMMANDS = new Set([
+    "chat-logs by-todo",
+    "chat-logs get",
+    "chat-logs list",
     "content-library search",
     "goal-templates apply",
     "goal-templates apply-starter",

package/dist/commands/chat-logs.js

@@ -0,0 +1,43 @@
+import { unwrap } from "../api.js";
+import { flagNumber, flagString } from "../args.js";
+import { CliError } from "../errors.js";
+import { positional } from "./shared.js";
+export async function runChatLogsCommand({ parsed, api, }) {
+    const verb = parsed.positionals[1];
+    if (verb === "list") {
+        const limit = flagNumber(parsed, "limit");
+        if (limit !== undefined &&
+            (!Number.isInteger(limit) || limit < 1 || limit > 500)) {
+            throw new CliError("invalid_arguments", "--limit must be an integer from 1 to 500.");
+        }
+        return unwrap(await api.client.GET("/ai/chat-logs", {
+            params: {
+                query: {
+                    studentId: flagString(parsed, "student", { required: true }),
+                    limit,
+                    cursor: flagString(parsed, "cursor"),
+                },
+            },
+        }));
+    }
+    const query = verb === "get"
+        ? { conversationId: positional(parsed, 2, "conversation ID") }
+        : { todoId: positional(parsed, 2, "todo ID") };
+    const messages = [];
+    let cursor;
+    const seenCursors = new Set();
+    do {
+        const page = unwrap(await api.client.GET("/ai/chat-logs/messages", {
+            params: { query: { ...query, limit: 500, cursor } },
+        }));
+        messages.push(...page.messages);
+        if (!page.nextCursor)
+            return { ...page, messages, complete: true };
+        if (seenCursors.has(page.nextCursor)) {
+            throw new CliError("pagination_error", "Chat-log pagination did not advance; no complete download was produced.");
+        }
+        seenCursors.add(page.nextCursor);
+        cursor = page.nextCursor;
+    } while (cursor);
+}
+//# sourceMappingURL=chat-logs.js.map

package/dist/help.js

@@ -51,6 +51,9 @@ Usage:
     --first-name TEXT [--last-name TEXT] [--no-invite] [--confirm]
   recess [--json] students upload-map-scores --student <kid-id>
     --file </path/to/map-report.pdf> [--confirm]
+  recess [--json] chat-logs list --student <user-id> [--limit 100] [--cursor <cursor>]
+  recess [--json] chat-logs get <conversation-id>
+  recess [--json] chat-logs by-todo <todo-id>
   recess [--json] students list [--scope mine|family]
   recess [--json] students today --student <kid-id> [--date YYYY-MM-DD]
   recess [--json] students schedule --student <kid-id> [--days 14]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "recess-cli",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "Safe Recess administration and family AI tools from the command line.",
   "license": "UNLICENSED",
   "repository": {