npm - neoctl - Versions diffs - 0.2.61 → 0.2.63 - Mend

neoctl 0.2.61 → 0.2.63

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.md +58 -58
package/dist/context/compaction.d.ts +7 -0
package/dist/context/compaction.js +103 -18
package/dist/context/compaction.js.map +1 -1
package/dist/context/system.md +18 -18
package/dist/execution/filesystem.js +22 -22
package/dist/execution/process.js +44 -44
package/dist/model/model-metadata.json +144 -144
package/dist/web/index.d.ts +2 -0
package/dist/web/index.js +18 -5
package/dist/web/index.js.map +1 -1
package/docs/prompt-config.md +86 -86
package/package.json +96 -96
package/scripts/copy-prompt-resources.mjs +5 -5

package/dist/execution/filesystem.js CHANGED Viewed

@@ -2,28 +2,28 @@ import localFs from "node:fs/promises";
 import { existsSync as localExistsSync, readFileSync as localReadFileSync, statSync as localStatSync } from "node:fs";
 import { dockerArgs, dockerEnabled, dockerRun, dockerRunSync } from "./docker.js";
 // This small transport program is sent over stdin; no host paths or application code are mounted.
-const program = String.raw `
-const fs = require('node:fs/promises');
-const chunks = [];
-process.stdin.on('data', c => chunks.push(c));
-process.stdin.on('end', async () => {
-  const encode = v => {
-    if (Buffer.isBuffer(v)) return { $buffer: v.toString('base64') };
-    if (v && typeof v.isFile === 'function') return {
-      name: v.name, size: v.size, mode: v.mode, mtimeMs: v.mtimeMs,
-      $kind: v.isFile() ? 'file' : v.isDirectory() ? 'directory' : v.isSymbolicLink() ? 'symlink' : 'other'
-    };
-    if (Array.isArray(v)) return v.map(encode);
-    return v;
-  };
-  try {
-    const { op, args } = JSON.parse(Buffer.concat(chunks).toString());
-    const allowed = ['stat','lstat','readFile','writeFile','appendFile','mkdir','readdir','access','realpath','rename','rm','rmdir','unlink','copyFile','truncate'];
-    if (!allowed.includes(op)) throw new Error('Unsupported file operation');
-    const decoded = args.map(v => v && v.$buffer !== undefined ? Buffer.from(v.$buffer,'base64') : v);
-    const result = await fs[op](...decoded);
-    process.stdout.write(JSON.stringify({ value: encode(result) }));
-  } catch (e) { process.stdout.write(JSON.stringify({ error: e.message, code: e.code })); }
+const program = String.raw `
+const fs = require('node:fs/promises');
+const chunks = [];
+process.stdin.on('data', c => chunks.push(c));
+process.stdin.on('end', async () => {
+  const encode = v => {
+    if (Buffer.isBuffer(v)) return { $buffer: v.toString('base64') };
+    if (v && typeof v.isFile === 'function') return {
+      name: v.name, size: v.size, mode: v.mode, mtimeMs: v.mtimeMs,
+      $kind: v.isFile() ? 'file' : v.isDirectory() ? 'directory' : v.isSymbolicLink() ? 'symlink' : 'other'
+    };
+    if (Array.isArray(v)) return v.map(encode);
+    return v;
+  };
+  try {
+    const { op, args } = JSON.parse(Buffer.concat(chunks).toString());
+    const allowed = ['stat','lstat','readFile','writeFile','appendFile','mkdir','readdir','access','realpath','rename','rm','rmdir','unlink','copyFile','truncate'];
+    if (!allowed.includes(op)) throw new Error('Unsupported file operation');
+    const decoded = args.map(v => v && v.$buffer !== undefined ? Buffer.from(v.$buffer,'base64') : v);
+    const result = await fs[op](...decoded);
+    process.stdout.write(JSON.stringify({ value: encode(result) }));
+  } catch (e) { process.stdout.write(JSON.stringify({ error: e.message, code: e.code })); }
 });`;
 function request(op, args) {
     return JSON.stringify({ op, args: args.map(value => Buffer.isBuffer(value) ? { $buffer: value.toString("base64") } : value) });

package/dist/execution/process.js CHANGED Viewed

@@ -1,50 +1,50 @@
 import { randomUUID } from "node:crypto";
 import { dockerArgs, dockerEnabled, dockerHostEnv, dockerRun } from "./docker.js";
-const runner = String.raw `
-import os,sys,subprocess,signal,pty,select,tty,termios
-marker=sys.argv[1]
-use_pty=sys.argv[2]=='pty'
-del sys.argv[2]
-if use_pty:
-  pid,master=pty.fork()
-  if pid==0: os.execvp(sys.argv[2],sys.argv[2:])
-  with open(marker,'x') as f: f.write(str(pid))
-  previous=termios.tcgetattr(0) if os.isatty(0) else None
-  try:
-    if previous: tty.setraw(0)
-    while True:
-      ready,_,_=select.select([0,master],[],[])
-      if master in ready:
-        try: data=os.read(master,65536)
-        except OSError: break
-        if not data: break
-        os.write(1,data)
-      if 0 in ready:
-        data=os.read(0,65536)
-        if not data: break
-        os.write(master,data)
-    _,status=os.waitpid(pid,0)
-    code=os.waitstatus_to_exitcode(status)
-  finally:
-    if previous: termios.tcsetattr(0,termios.TCSADRAIN,previous)
-    os.close(master)
-    try: os.unlink(marker)
-    except FileNotFoundError: pass
-else:
-  child=subprocess.Popen(sys.argv[2:],start_new_session=True)
-  with open(marker,'x') as f: f.write(str(child.pid))
-  try: code=child.wait()
-  finally:
-    try: os.unlink(marker)
-    except FileNotFoundError: pass
-sys.exit(code if code>=0 else 128-code)
+const runner = String.raw `
+import os,sys,subprocess,signal,pty,select,tty,termios
+marker=sys.argv[1]
+use_pty=sys.argv[2]=='pty'
+del sys.argv[2]
+if use_pty:
+  pid,master=pty.fork()
+  if pid==0: os.execvp(sys.argv[2],sys.argv[2:])
+  with open(marker,'x') as f: f.write(str(pid))
+  previous=termios.tcgetattr(0) if os.isatty(0) else None
+  try:
+    if previous: tty.setraw(0)
+    while True:
+      ready,_,_=select.select([0,master],[],[])
+      if master in ready:
+        try: data=os.read(master,65536)
+        except OSError: break
+        if not data: break
+        os.write(1,data)
+      if 0 in ready:
+        data=os.read(0,65536)
+        if not data: break
+        os.write(master,data)
+    _,status=os.waitpid(pid,0)
+    code=os.waitstatus_to_exitcode(status)
+  finally:
+    if previous: termios.tcsetattr(0,termios.TCSADRAIN,previous)
+    os.close(master)
+    try: os.unlink(marker)
+    except FileNotFoundError: pass
+else:
+  child=subprocess.Popen(sys.argv[2:],start_new_session=True)
+  with open(marker,'x') as f: f.write(str(child.pid))
+  try: code=child.wait()
+  finally:
+    try: os.unlink(marker)
+    except FileNotFoundError: pass
+sys.exit(code if code>=0 else 128-code)
 `;
-const killer = String.raw `
-import os,sys,signal
-try:
-  with open(sys.argv[1]) as f: pid=int(f.read())
-  if pid>1: os.killpg(pid,getattr(signal,sys.argv[2]))
-except (FileNotFoundError,ProcessLookupError): pass
+const killer = String.raw `
+import os,sys,signal
+try:
+  with open(sys.argv[1]) as f: pid=int(f.read())
+  if pid>1: os.killpg(pid,getattr(signal,sys.argv[2]))
+except (FileNotFoundError,ProcessLookupError): pass
 `;
 export function executionLaunch(file, args, cwd, env, tty = false) {
     if (!dockerEnabled())

package/dist/model/model-metadata.json CHANGED Viewed

@@ -1,144 +1,144 @@
-{
-  "updatedAt": "2026-11-03",
-  "notes": [
-    "Bundled metadata for current mainstream Claude models and supported OpenAI models.",
-    "Claude contextWindowTokens is neo's configured 256000-token usage ceiling, not the upstream model maximum or a pricing guarantee.",
-    "MODEL_CONTEXT_WINDOW_TOKENS or OPENAI_CONTEXT_WINDOW_TOKENS overrides contextWindowTokens at runtime.",
-    "Model IDs and aliases are matched case-insensitively. Availability depends on the connected API and account."
-  ],
-  "sources": {
-    "claude-models": "https://platform.claude.com/docs/en/models/overview",
-    "claude-effort": "https://platform.claude.com/docs/en/build-with-claude/effort",
-    "openai-models": "https://developers.openai.com/api/docs/models",
-    "openai-reasoning": "https://developers.openai.com/api/docs/guides/reasoning"
-  },
-  "models": [
-    {"id": "claude-fable-5-1", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-fable-5-1"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "Adaptive thinking; thinking cannot be disabled."},
-    {"id": "claude-haiku-5-5", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-haiku-5-5"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["none", "low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "none disables thinking; other efforts use adaptive thinking."},
-    {"id": "claude-opus-5-5", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-opus-5-5"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "Adaptive thinking; thinking cannot be disabled."},
-    {"id": "claude-sonnet-5-5", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-sonnet-5-5"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "Adaptive thinking; thinking cannot be disabled."},
-    {
-      "id": "gpt-5.6-sol",
-      "provider": "openai",
-      "modelIds": [
-        "gpt-5.6-sol"
-      ],
-      "contextWindowTokens": 256000,
-      "maxOutputTokens": 128000,
-      "knowledgeCutoff": "2026-02-16",
-      "reasoning": true,
-      "imageInput": true,
-      "source": "openai-models",
-      "reasoningEfforts": [
-        "none",
-        "low",
-        "medium",
-        "high",
-        "xhigh",
-        "max"
-      ]
-    },
-    {
-      "id": "gpt-5.6-terra",
-      "provider": "openai",
-      "modelIds": [
-        "gpt-5.6-terra"
-      ],
-      "contextWindowTokens": 256000,
-      "maxOutputTokens": 128000,
-      "knowledgeCutoff": "2026-02-16",
-      "reasoning": true,
-      "imageInput": true,
-      "source": "openai-models",
-      "reasoningEfforts": [
-        "none",
-        "low",
-        "medium",
-        "high",
-        "xhigh",
-        "max"
-      ]
-    },
-    {
-      "id": "gpt-5.6-luna",
-      "provider": "openai",
-      "modelIds": [
-        "gpt-5.6-luna"
-      ],
-      "contextWindowTokens": 256000,
-      "maxOutputTokens": 128000,
-      "knowledgeCutoff": "2026-02-16",
-      "reasoning": true,
-      "imageInput": true,
-      "source": "openai-models",
-      "reasoningEfforts": [
-        "none",
-        "low",
-        "medium",
-        "high",
-        "xhigh",
-        "max"
-      ]
-    },
-    {
-      "id": "gpt-6-sol",
-      "provider": "openai",
-      "modelIds": [
-        "gpt-6-sol"
-      ],
-      "contextWindowTokens": 256000,
-      "maxOutputTokens": 128000,
-      "reasoning": true,
-      "imageInput": true,
-      "source": "openai-models",
-      "reasoningEfforts": [
-        "none",
-        "low",
-        "medium",
-        "high",
-        "xhigh",
-        "max"
-      ]
-    },
-    {
-      "id": "gpt-6.1-sol",
-      "provider": "openai",
-      "modelIds": [
-        "gpt-6.1-sol"
-      ],
-      "contextWindowTokens": 256000,
-      "maxOutputTokens": 128000,
-      "reasoning": true,
-      "imageInput": true,
-      "source": "openai-models",
-      "reasoningEfforts": [
-        "none",
-        "low",
-        "medium",
-        "high",
-        "xhigh",
-        "max"
-      ]
-    },
-    {
-      "id": "gpt-6-astra",
-      "provider": "openai",
-      "modelIds": [
-        "gpt-6-astra"
-      ],
-      "contextWindowTokens": 256000,
-      "maxOutputTokens": 128000,
-      "reasoning": true,
-      "imageInput": true,
-      "source": "openai-models",
-      "reasoningEfforts": [
-        "none",
-        "low",
-        "medium",
-        "high",
-        "xhigh",
-        "max"
-      ]
-    }
-  ]
-}
+{
+  "updatedAt": "2026-11-03",
+  "notes": [
+    "Bundled metadata for current mainstream Claude models and supported OpenAI models.",
+    "Claude contextWindowTokens is neo's configured 256000-token usage ceiling, not the upstream model maximum or a pricing guarantee.",
+    "MODEL_CONTEXT_WINDOW_TOKENS or OPENAI_CONTEXT_WINDOW_TOKENS overrides contextWindowTokens at runtime.",
+    "Model IDs and aliases are matched case-insensitively. Availability depends on the connected API and account."
+  ],
+  "sources": {
+    "claude-models": "https://platform.claude.com/docs/en/models/overview",
+    "claude-effort": "https://platform.claude.com/docs/en/build-with-claude/effort",
+    "openai-models": "https://developers.openai.com/api/docs/models",
+    "openai-reasoning": "https://developers.openai.com/api/docs/guides/reasoning"
+  },
+  "models": [
+    {"id": "claude-fable-5-1", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-fable-5-1"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "Adaptive thinking; thinking cannot be disabled."},
+    {"id": "claude-haiku-5-5", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-haiku-5-5"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["none", "low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "none disables thinking; other efforts use adaptive thinking."},
+    {"id": "claude-opus-5-5", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-opus-5-5"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "Adaptive thinking; thinking cannot be disabled."},
+    {"id": "claude-sonnet-5-5", "provider": "anthropic", "protocols": ["anthropic"], "modelIds": ["claude-sonnet-5-5"], "contextWindowTokens": 256000, "maxOutputTokens": 128000, "knowledgeCutoff": "2026-06", "reasoning": true, "reasoningEfforts": ["low", "medium", "high", "xhigh", "max"], "imageInput": true, "source": "claude-models", "notes": "Adaptive thinking; thinking cannot be disabled."},
+    {
+      "id": "gpt-5.6-sol",
+      "provider": "openai",
+      "modelIds": [
+        "gpt-5.6-sol"
+      ],
+      "contextWindowTokens": 256000,
+      "maxOutputTokens": 128000,
+      "knowledgeCutoff": "2026-02-16",
+      "reasoning": true,
+      "imageInput": true,
+      "source": "openai-models",
+      "reasoningEfforts": [
+        "none",
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ]
+    },
+    {
+      "id": "gpt-5.6-terra",
+      "provider": "openai",
+      "modelIds": [
+        "gpt-5.6-terra"
+      ],
+      "contextWindowTokens": 256000,
+      "maxOutputTokens": 128000,
+      "knowledgeCutoff": "2026-02-16",
+      "reasoning": true,
+      "imageInput": true,
+      "source": "openai-models",
+      "reasoningEfforts": [
+        "none",
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ]
+    },
+    {
+      "id": "gpt-5.6-luna",
+      "provider": "openai",
+      "modelIds": [
+        "gpt-5.6-luna"
+      ],
+      "contextWindowTokens": 256000,
+      "maxOutputTokens": 128000,
+      "knowledgeCutoff": "2026-02-16",
+      "reasoning": true,
+      "imageInput": true,
+      "source": "openai-models",
+      "reasoningEfforts": [
+        "none",
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ]
+    },
+    {
+      "id": "gpt-6-sol",
+      "provider": "openai",
+      "modelIds": [
+        "gpt-6-sol"
+      ],
+      "contextWindowTokens": 256000,
+      "maxOutputTokens": 128000,
+      "reasoning": true,
+      "imageInput": true,
+      "source": "openai-models",
+      "reasoningEfforts": [
+        "none",
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ]
+    },
+    {
+      "id": "gpt-6.1-sol",
+      "provider": "openai",
+      "modelIds": [
+        "gpt-6.1-sol"
+      ],
+      "contextWindowTokens": 256000,
+      "maxOutputTokens": 128000,
+      "reasoning": true,
+      "imageInput": true,
+      "source": "openai-models",
+      "reasoningEfforts": [
+        "none",
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ]
+    },
+    {
+      "id": "gpt-6-astra",
+      "provider": "openai",
+      "modelIds": [
+        "gpt-6-astra"
+      ],
+      "contextWindowTokens": 256000,
+      "maxOutputTokens": 128000,
+      "reasoning": true,
+      "imageInput": true,
+      "source": "openai-models",
+      "reasoningEfforts": [
+        "none",
+        "low",
+        "medium",
+        "high",
+        "xhigh",
+        "max"
+      ]
+    }
+  ]
+}

package/dist/web/index.d.ts CHANGED Viewed

@@ -952,6 +952,8 @@ export declare class WebRepl {
     private scheduleDeltaFlush;
     private flushDeltaOperations;
     private discardPendingDeltaOperations;
+    /** Snapshot for one subscriber; it already includes every currently queued delta operation. */
+    private sendSubscriberSnapshot;
     private dropInactiveTerminalOutput;
     private queueTerminalOutput;
     private flushTerminalOutput;

package/dist/web/index.js CHANGED Viewed

@@ -855,7 +855,7 @@ export class WebRepl {
         });
         if (clientInfo)
             this.send(subscriber, "client.version", clientInfo);
-        this.send(subscriber, "sync", this.snapshot(true));
+        this.sendSubscriberSnapshot(subscriber, this.snapshot(true));
         this.publishRuntimeContext([subscriber]);
         reqKeepAlive(res);
         res.on("close", () => this.subscribers.delete(subscriber));
@@ -2707,7 +2707,7 @@ export class WebRepl {
             }
             if (subscriber.needsSync) {
                 subscriber.needsSync = false;
-                this.send(subscriber, "sync", this.snapshot(false));
+                this.sendSubscriberSnapshot(subscriber, this.snapshot(false));
             }
             if (subscriber.pendingFastModeFallback) {
                 const payload = subscriber.pendingFastModeFallback;
@@ -2773,7 +2773,8 @@ export class WebRepl {
         this.pendingDeltaTimer = undefined;
         if (this.pendingDeltaOperations.length === 0 && !this.pendingDeltaStatus)
             return;
-        const operations = compactLineOperations(this.pendingDeltaOperations);
+        const pending = this.pendingDeltaOperations;
+        const operations = compactLineOperations(pending);
         this.pendingDeltaOperations = [];
         this.pendingDeltaStatus = false;
         const payload = {
@@ -2782,8 +2783,12 @@ export class WebRepl {
             operations,
             status: this.timedStatus(),
         };
-        for (const subscriber of this.subscribers)
-            this.send(subscriber, "delta", payload);
+        for (const subscriber of this.subscribers) {
+            const offset = subscriber.snapshotDeltaOffset ?? 0;
+            subscriber.snapshotDeltaOffset = undefined;
+            // Text appends are not idempotent: skip operations its own snapshot already contains.
+            this.send(subscriber, "delta", offset > 0 ? { ...payload, operations: compactLineOperations(pending.slice(offset)) } : payload);
+        }
     }
     discardPendingDeltaOperations() {
         if (this.pendingDeltaTimer)
@@ -2791,6 +2796,13 @@ export class WebRepl {
         this.pendingDeltaTimer = undefined;
         this.pendingDeltaOperations = [];
         this.pendingDeltaStatus = false;
+        for (const subscriber of this.subscribers)
+            subscriber.snapshotDeltaOffset = undefined;
+    }
+    /** Snapshot for one subscriber; it already includes every currently queued delta operation. */
+    sendSubscriberSnapshot(subscriber, snapshot) {
+        subscriber.snapshotDeltaOffset = this.pendingDeltaOperations.length;
+        this.send(subscriber, "sync", snapshot);
     }
     dropInactiveTerminalOutput() {
         for (const sessionId of this.pendingTerminalOutput.keys()) {
@@ -4003,6 +4015,7 @@ function compactionReportFromBoundary(message) {
         charsFreed: 0,
         modelDriven: message.metadata.modelDriven === true,
         imageCount: Array.isArray(imageRegistry?.images) ? imageRegistry.images.length : 0,
+        ...(typeof message.metadata.compactFallbackReason === "string" ? { fallbackReason: message.metadata.compactFallbackReason } : {}),
     };
 }
 function isCompactionReason(value) {