pando-ai 1.1.9 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pando-ai",
-  "version": "1.1.9",
+  "version": "1.2.0",
   "description": "AI coding firewall for Codex and Claude Code",
   "bin": {
     "pando-ai": "bin/pando-ai.js"

package/resources/tools/generated_pando-tools.json

@@ -43,7 +43,7 @@
     "replace-body(path, expectedHash, with, forceReplaceWillBreakSyntax)",
     "change-signature(path, expectedHash, parameters, returnType, makeAsync, makeSyncFromAsync, forceChangeWillBreakSyntax, boundary, batchSaves)",
     "filter-map-reduce(query, transforms, apply)",
-    "shell-command(command, reasonWhyNotUsingPandoNativeTools, timeoutMs, shell, maxOutputBytes)",
+    "shell-command(command, reasonWhyNotUsingPandoNativeTools, timeoutMs, shell, maxOutputBytes, maxLines, lineOffset)",
     "list-snapshots(offset, limit)",
     "diff-snapshots(head, base, page)",
     "get-snapshot-trailers(snapshotId, keys)",
@@ -2077,7 +2077,7 @@
     {
       "name": "shell-command",
       "category": "pando",
-      "signature": "shell-command(command, reasonWhyNotUsingPandoNativeTools, timeoutMs, shell, maxOutputBytes)",
+      "signature": "shell-command(command, reasonWhyNotUsingPandoNativeTools, timeoutMs, shell, maxOutputBytes, maxLines, lineOffset)",
       "description": "Strongly discouraged: prefer Pando AST/index tools before raw shell for code search, navigation, references, and supported source-code edits. Use find-nodes for structural code search and edit targets, find-references/find-callers for usages, list-exports/analyze-imports for module shape, query-db for indexed metadata, and workspace-overview for inventory. Use shell freely for tests, builds/compiles, package managers, git, generated files, non-code files, unsupported languages/file types, and anything Pando itself does not support. Pando AST writers are for supported source-code and AST-addressable edits; use shell-based patching for unsupported non-code files such as Markdown docs. Every operation that goes through Pando, including this shell command, is snapshotted before and after; snapshots are not touchable by the agent. Shell results repeat this reminder so agents reconsider Pando-native tools before the next shell call. Run a shell command with cwd fixed to the selected Pando project root, then synchronously snapshot any worktree changes before another modifying Pando operation can run. The project-root confinement is also enforced by the host environment. reasonWhyNotUsingPandoNativeTools is required and is written into the snapshot receipt/trailers for auditability. Command failures are returned to the agent with exit code, stdout, stderr, timeout state, and snapshot metadata. Example: { command:'npm test', reasonWhyNotUsingPandoNativeTools:'Run the project test suite; this is execution, not code navigation.' }",
       "parameters": {
         "type": "object",
@@ -2101,6 +2101,14 @@
           "reasonWhyNotUsingPandoNativeTools": {
             "type": "string",
             "description": "Required audit reason for running this command. Explain why a Pando-native tool is not appropriate: use find-nodes for code search/edit targets, find-references/find-callers for usages, list-exports/analyze-imports for module shape, and shell for tests/builds/package managers/git/generated files/non-code files/unsupported languages. This is persisted in snapshot metadata."
+          },
+          "maxLines": {
+            "type": "number",
+            "description": "Optional number of stdout lines to show in the result digest before the rest collapse to a '+N more lines' note. Display only — does not change captured bytes. Defaults to 200. 0 = show all. To see more, re-run with a higher lineOffset rather than re-reading lines you already have."
+          },
+          "lineOffset": {
+            "type": "number",
+            "description": "Optional first stdout line to display (default 0). Use this to page long output: the '+N more lines' footer prints the exact lineOffset to pass next so you fetch only the part you don't already have."
           }
         },
         "required": [