orbitx 0.2.4 → 0.2.6

package/dist/tests/tools/todo/remove-list.test.js

@@ -0,0 +1,41 @@
+import { test, before, after, describe } from "node:test";
+import assert from "node:assert/strict";
+import { TodoCreateListTool, TodoCreateTaskTool, TodoRemoveListTool, TodoGetListsTool, TodoGetListTool, MCPClient, MCPConnection, MCPServer, } from "../../../index.js";
+describe("todo/remove-list", () => {
+    let mcpConnection;
+    let mcpClient;
+    let mcpServer;
+    before(async () => {
+        mcpConnection = new MCPConnection();
+        mcpClient = new MCPClient("1234", mcpConnection);
+        mcpServer = new MCPServer(mcpConnection);
+        mcpServer.registerTool(TodoCreateListTool());
+        mcpServer.registerTool(TodoCreateTaskTool());
+        mcpServer.registerTool(TodoRemoveListTool());
+        mcpServer.registerTool(TodoGetListsTool());
+        mcpServer.registerTool(TodoGetListTool());
+    });
+    after(async () => {
+        mcpConnection?.close();
+    });
+    test("TodoRemoveListTool: removes a list (and its tasks), no longer reachable afterwards", async () => {
+        const list = await mcpClient.callTool("todo-create-list", { name: "To remove" });
+        const listId = list.output.todoListId;
+        await mcpClient.callTool("todo-create-task", { list: listId, tasks: [{ name: "Task" }] });
+        const result = await mcpClient.callTool("todo-remove-list", { lists: [listId] });
+        assert.strictEqual(result.output.message, "success");
+        const lists = await mcpClient.callTool("todo-get-lists", {});
+        assert.ok(!lists.output.lists.includes(listId));
+        const getResult = await mcpClient.callTool("todo-get-list", { list: listId });
+        assert.match(getResult.output.error, /no todo list found with id/);
+    });
+    test("TodoRemoveListTool: removing an unknown list id is a no-op success, not an error", async () => {
+        const result = await mcpClient.callTool("todo-remove-list", { lists: ["0xdoesnotexist"] });
+        assert.strictEqual(result.output.message, "success");
+    });
+    test("TodoRemoveListTool: a non-array lists input is rejected", async () => {
+        const result = await mcpClient.callTool("todo-remove-list", { lists: "not-an-array" });
+        assert.match(result.output.error, /lists must be an array of list id strings/);
+    });
+});
+//# sourceMappingURL=remove-list.test.js.map

package/dist/tests/tools/todo/remove-list.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-list.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/todo/remove-list.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,aAAa,EACb,SAAS,GACZ,MAAM,mBAAmB,CAAC;AAE3B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,IAAI,aAAwC,CAAC;IAC7C,IAAI,SAAoB,CAAC;IACzB,IAAI,SAAoB,CAAC;IAEzB,MAAM,CAAC,KAAK,IAAI,EAAE;QACd,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACjD,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC;QACzC,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7C,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7C,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7C,SAAS,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC3C,SAAS,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,IAAI,EAAE;QACb,aAAa,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oFAAoF,EAAE,KAAK,IAAI,EAAE;QAClG,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACjF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QACtC,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAE1F,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAErD,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAEhD,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,4BAA4B,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;QAChG,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAE3F,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,cAAqB,EAAE,CAAC,CAAC;QAE9F,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,2CAA2C,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/tests/tools/todo/remove-task.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=remove-task.test.d.ts.map

package/dist/tests/tools/todo/remove-task.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-task.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/tools/todo/remove-task.test.ts"],"names":[],"mappings":""}

package/dist/tests/tools/todo/remove-task.test.js

@@ -0,0 +1,45 @@
+import { test, before, after, describe } from "node:test";
+import assert from "node:assert/strict";
+import { TodoCreateListTool, TodoCreateTaskTool, TodoRemoveTaskTool, TodoGetListTool, MCPClient, MCPConnection, MCPServer, } from "../../../index.js";
+describe("todo/remove-task", () => {
+    let mcpConnection;
+    let mcpClient;
+    let mcpServer;
+    let listId;
+    let taskIds;
+    before(async () => {
+        mcpConnection = new MCPConnection();
+        mcpClient = new MCPClient("1234", mcpConnection);
+        mcpServer = new MCPServer(mcpConnection);
+        mcpServer.registerTool(TodoCreateListTool());
+        mcpServer.registerTool(TodoCreateTaskTool());
+        mcpServer.registerTool(TodoRemoveTaskTool());
+        mcpServer.registerTool(TodoGetListTool());
+        const list = await mcpClient.callTool("todo-create-list", { name: "Tasks" });
+        listId = list.output.todoListId;
+        const created = await mcpClient.callTool("todo-create-task", {
+            list: listId,
+            tasks: [{ name: "Keep me" }, { name: "Remove me" }],
+        });
+        taskIds = created.output.todoTaskIds;
+    });
+    after(async () => {
+        mcpConnection?.close();
+    });
+    test("TodoRemoveTaskTool: removes a task from its list", async () => {
+        const result = await mcpClient.callTool("todo-remove-task", { tasks: [taskIds[1]] });
+        assert.strictEqual(result.output.message, "success");
+        const listResult = await mcpClient.callTool("todo-get-list", { list: listId });
+        const names = listResult.output.tasks.map((t) => t.name);
+        assert.deepStrictEqual(names, ["Keep me"]);
+    });
+    test("TodoRemoveTaskTool: removing an unknown task id is a no-op success, not an error", async () => {
+        const result = await mcpClient.callTool("todo-remove-task", { tasks: ["0xdoesnotexist"] });
+        assert.strictEqual(result.output.message, "success");
+    });
+    test("TodoRemoveTaskTool: a non-array tasks input is rejected", async () => {
+        const result = await mcpClient.callTool("todo-remove-task", { tasks: "not-an-array" });
+        assert.match(result.output.error, /tasks must be an array of task id strings/);
+    });
+});
+//# sourceMappingURL=remove-task.test.js.map

package/dist/tests/tools/todo/remove-task.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-task.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/todo/remove-task.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EACH,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,aAAa,EACb,SAAS,GACZ,MAAM,mBAAmB,CAAC;AAE3B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,IAAI,aAAwC,CAAC;IAC7C,IAAI,SAAoB,CAAC;IACzB,IAAI,SAAoB,CAAC;IACzB,IAAI,MAAc,CAAC;IACnB,IAAI,OAAiB,CAAC;IAEtB,MAAM,CAAC,KAAK,IAAI,EAAE;QACd,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACjD,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC;QACzC,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7C,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7C,SAAS,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC,CAAC;QAC7C,SAAS,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;QAE1C,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7E,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAChC,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE;YACzD,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;SACtD,CAAC,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,IAAI,EAAE;QACb,aAAa,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAErD,MAAM,UAAU,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kFAAkF,EAAE,KAAK,IAAI,EAAE;QAChG,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAE3F,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,yDAAyD,EAAE,KAAK,IAAI,EAAE;QACvE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,cAAqB,EAAE,CAAC,CAAC;QAE9F,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,2CAA2C,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/tests/tools/utils/delay.test.js

@@ -1,28 +1,30 @@
-import { test, before, after } from "node:test";
+import { test, before, after, describe } from "node:test";
 import assert from "node:assert/strict";
 import { DelayTool, MCPClient, MCPConnection, MCPServer } from "../../../index.js";
-let mcpConnection;
-let mcpClient;
-let mcpServer;
-before(async () => {
-    mcpConnection = new MCPConnection();
-    mcpClient = new MCPClient("1234", mcpConnection);
-    mcpServer = new MCPServer(mcpConnection);
-    mcpServer.registerTool(DelayTool());
-});
-after(async () => {
-    mcpConnection?.close();
-});
-test("DelayTool: delay tool call returns waited field matching requested ms", async () => {
-    const requestedMs = 50;
-    const start = Date.now();
-    const result = await mcpClient.callTool("delay", { ms: requestedMs });
-    const elapsed = Date.now() - start;
-    assert.ok(result, "callTool should return a result");
-    assert.ok(result.output, "result should have an output field");
-    const { output } = result;
-    assert.ok("waited" in output, "output should contain 'waited'");
-    assert.strictEqual(output.waited, requestedMs, "waited should equal the requested ms");
-    assert.ok(elapsed >= requestedMs, `actual elapsed time (${elapsed}ms) should be at least the requested delay (${requestedMs}ms)`);
+describe("utils/delay", () => {
+    let mcpConnection;
+    let mcpClient;
+    let mcpServer;
+    before(async () => {
+        mcpConnection = new MCPConnection();
+        mcpClient = new MCPClient("1234", mcpConnection);
+        mcpServer = new MCPServer(mcpConnection);
+        mcpServer.registerTool(DelayTool());
+    });
+    after(async () => {
+        mcpConnection?.close();
+    });
+    test("DelayTool: delay tool call returns waited field matching requested ms", async () => {
+        const requestedMs = 50;
+        const start = Date.now();
+        const result = await mcpClient.callTool("delay", { ms: requestedMs });
+        const elapsed = Date.now() - start;
+        assert.ok(result, "callTool should return a result");
+        assert.ok(result.output, "result should have an output field");
+        const { output } = result;
+        assert.ok("waited" in output, "output should contain 'waited'");
+        assert.strictEqual(output.waited, requestedMs, "waited should equal the requested ms");
+        assert.ok(elapsed >= requestedMs, `actual elapsed time (${elapsed}ms) should be at least the requested delay (${requestedMs}ms)`);
+    });
 });
 //# sourceMappingURL=delay.test.js.map

package/dist/tests/tools/utils/delay.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"delay.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/utils/delay.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnF,IAAI,aAAwC,CAAC;AAC7C,IAAI,SAAoB,CAAC;AACzB,IAAI,SAAoB,CAAC;AAEzB,MAAM,CAAC,KAAK,IAAI,EAAE;IACd,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IACpC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjD,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC;IACzC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,KAAK,IAAI,EAAE;IACb,aAAa,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;IACrF,MAAM,WAAW,GAAG,EAAE,CAAC;IAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IAEnC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;IACrD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;IAE/D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1B,MAAM,CAAC,EAAE,CAAC,QAAQ,IAAI,MAAM,EAAE,gCAAgC,CAAC,CAAC;IAChE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,sCAAsC,CAAC,CAAC;IACvF,MAAM,CAAC,EAAE,CACL,OAAO,IAAI,WAAW,EACtB,wBAAwB,OAAO,+CAA+C,WAAW,KAAK,CACjG,CAAC;AACN,CAAC,CAAC,CAAC"}
+{"version":3,"file":"delay.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/utils/delay.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnF,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IACzB,IAAI,aAAwC,CAAC;IAC7C,IAAI,SAAoB,CAAC;IACzB,IAAI,SAAoB,CAAC;IAEzB,MAAM,CAAC,KAAK,IAAI,EAAE;QACd,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QACpC,SAAS,GAAG,IAAI,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QACjD,SAAS,GAAG,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC;QACzC,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,IAAI,EAAE;QACb,aAAa,EAAE,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uEAAuE,EAAE,KAAK,IAAI,EAAE;QACrF,MAAM,WAAW,GAAG,EAAE,CAAC;QAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAEnC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;QACrD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;QAE/D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAE1B,MAAM,CAAC,EAAE,CAAC,QAAQ,IAAI,MAAM,EAAE,gCAAgC,CAAC,CAAC;QAChE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,sCAAsC,CAAC,CAAC;QACvF,MAAM,CAAC,EAAE,CACL,OAAO,IAAI,WAAW,EACtB,wBAAwB,OAAO,+CAA+C,WAAW,KAAK,CACjG,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/tests/tools/utils/get-current-time.test.js

@@ -1,45 +1,47 @@
-import { test, before, after } from "node:test";
+import { test, before, after, describe } from "node:test";
 import assert from "node:assert/strict";
 import { GetCurrentTimeTool, MCPClient, MCPConnection, MCPServer } from "../../../index.js";
-let mcpConnection;
-let mcpClient;
-let mcpServer;
-before(async () => {
-    mcpConnection = new MCPConnection();
-    mcpClient = new MCPClient("1234", mcpConnection);
-    mcpServer = new MCPServer(mcpConnection);
-    mcpServer.registerTool(GetCurrentTimeTool());
-});
-after(async () => {
-    mcpConnection?.close();
-});
-test("GetCurrentTimeTool: iso field is a valid ISO 8601 timestamp close to now", async () => {
-    const before = Date.now();
-    const result = await mcpClient.callTool("get-current-time", {});
-    const after = Date.now();
-    assert.ok(result, "callTool should return a result");
-    assert.ok(result.output, "result should have an output field");
-    const { output } = result;
-    // iso should parse to a valid date
-    const parsed = new Date(output.iso);
-    assert.ok(!Number.isNaN(parsed.getTime()), "iso field should be a valid date string");
-    // iso should correspond to roughly "now" (within the call window)
-    const parsedMs = parsed.getTime();
-    assert.ok(parsedMs >= before && parsedMs <= after, `iso timestamp (${parsedMs}) should fall between ${before} and ${after}`);
-});
-test("GetCurrentTimeTool: unix field matches iso field and timezone is a non-empty string", async () => {
-    const result = await mcpClient.callTool("get-current-time", {});
-    assert.ok(result, "callTool should return a result");
-    assert.ok(result.output, "result should have an output field");
-    const { output } = result;
-    // unix should be a number
-    assert.strictEqual(typeof output.unix, "number", "unix field should be a number");
-    // unix (assumed seconds) should match iso when converted
-    const isoMs = new Date(output.iso).getTime();
-    const unixMs = output.unix * 1000;
-    assert.ok(Math.abs(isoMs - unixMs) < 1000, `unix field (${output.unix}) should correspond to iso field (${output.iso})`);
-    // timezone should be a non-empty string
-    assert.strictEqual(typeof output.timezone, "string", "timezone field should be a string");
-    assert.ok(output.timezone.length > 0, "timezone field should not be empty");
+describe("utils/get-current-time", () => {
+    let mcpConnection;
+    let mcpClient;
+    let mcpServer;
+    before(async () => {
+        mcpConnection = new MCPConnection();
+        mcpClient = new MCPClient("1234", mcpConnection);
+        mcpServer = new MCPServer(mcpConnection);
+        mcpServer.registerTool(GetCurrentTimeTool());
+    });
+    after(async () => {
+        mcpConnection?.close();
+    });
+    test("GetCurrentTimeTool: iso field is a valid ISO 8601 timestamp close to now", async () => {
+        const before = Date.now();
+        const result = await mcpClient.callTool("get-current-time", {});
+        const after = Date.now();
+        assert.ok(result, "callTool should return a result");
+        assert.ok(result.output, "result should have an output field");
+        const { output } = result;
+        // iso should parse to a valid date
+        const parsed = new Date(output.iso);
+        assert.ok(!Number.isNaN(parsed.getTime()), "iso field should be a valid date string");
+        // iso should correspond to roughly "now" (within the call window)
+        const parsedMs = parsed.getTime();
+        assert.ok(parsedMs >= before && parsedMs <= after, `iso timestamp (${parsedMs}) should fall between ${before} and ${after}`);
+    });
+    test("GetCurrentTimeTool: unix field matches iso field and timezone is a non-empty string", async () => {
+        const result = await mcpClient.callTool("get-current-time", {});
+        assert.ok(result, "callTool should return a result");
+        assert.ok(result.output, "result should have an output field");
+        const { output } = result;
+        // unix should be a number
+        assert.strictEqual(typeof output.unix, "number", "unix field should be a number");
+        // unix (assumed seconds) should match iso when converted
+        const isoMs = new Date(output.iso).getTime();
+        const unixMs = output.unix * 1000;
+        assert.ok(Math.abs(isoMs - unixMs) < 1000, `unix field (${output.unix}) should correspond to iso field (${output.iso})`);
+        // timezone should be a non-empty string
+        assert.strictEqual(typeof output.timezone, "string", "timezone field should be a string");
+        assert.ok(output.timezone.length > 0, "timezone field should not be empty");
+    });
 });
 //# sourceMappingURL=get-current-time.test.js.map

package/dist/tests/tools/utils/get-current-time.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-current-time.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/utils/get-current-time.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-current-time.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/utils/get-current-time.test.ts"],"names":[],"mappings":"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"}

package/dist/tests/tools/utils/read-image.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=read-image.test.d.ts.map

package/dist/tests/tools/utils/read-image.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-image.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/tools/utils/read-image.test.ts"],"names":[],"mappings":""}

package/dist/tests/tools/utils/read-image.test.js

@@ -0,0 +1,54 @@
+import { test, before, after, describe } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, rmSync, writeFileSync } from "fs";
+import { tmpdir } from "os";
+import { join } from "path";
+import { ReadImageTool, MCPClient, MCPConnection, MCPServer } from "../../../index.js";
+describe("utils/read-image", () => {
+    let mcpConnection;
+    let mcpClient;
+    let mcpServer;
+    let tmpDir;
+    // smallest possible valid PNG (1x1 transparent pixel)
+    const PNG_BASE64 = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=";
+    before(async () => {
+        tmpDir = mkdtempSync(join(tmpdir(), "orbitx-read-image-"));
+        writeFileSync(join(tmpDir, "pixel.png"), Buffer.from(PNG_BASE64, "base64"));
+        writeFileSync(join(tmpDir, "not-an-image.txt"), "hello");
+        mcpConnection = new MCPConnection();
+        mcpClient = new MCPClient("1234", mcpConnection);
+        mcpServer = new MCPServer(mcpConnection);
+        mcpServer.registerTool(ReadImageTool());
+    });
+    after(async () => {
+        mcpConnection?.close();
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    // Like BrowserScreenshotTool, the image content only gets interpreted
+    // further downstream by an AI vision model (see
+    // BaseAgent#resolveToolOutputForModel); none of that runs here, so this only
+    // confirms the tool itself returns an image output, not anything about what
+    // the image shows.
+    test("ReadImageTool: reads a png file and returns an image tool-output with the right mimeType", async () => {
+        const path = join(tmpDir, "pixel.png");
+        const result = await mcpClient.callTool("read-image", { path });
+        assert.strictEqual(result.type, "image");
+        assert.strictEqual(result.output.mimeType, "image/png");
+        assert.strictEqual(typeof result.output.image, "string");
+        assert.ok(result.output.image.length > 0, "image should not be empty");
+    });
+    test("ReadImageTool: includes focusHint in the output only when provided", async () => {
+        const path = join(tmpDir, "pixel.png");
+        const withHint = await mcpClient.callTool("read-image", { path, focusHint: "check the color" });
+        assert.strictEqual(withHint.output.focusHint, "check the color");
+        const withoutHint = await mcpClient.callTool("read-image", { path });
+        assert.strictEqual("focusHint" in withoutHint.output, false);
+    });
+    test("ReadImageTool: a missing file surfaces a descriptive error instead of throwing raw ENOENT", async () => {
+        const path = join(tmpDir, "does-not-exist.png");
+        const result = await mcpClient.callTool("read-image", { path });
+        assert.ok(result.output.error, "output should contain an error field");
+        assert.match(result.output.error, /no file found at/);
+    });
+});
+//# sourceMappingURL=read-image.test.js.map

package/dist/tests/tools/utils/read-image.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-image.test.js","sourceRoot":"","sources":["../../../../src/tests/tools/utils/read-image.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/browser/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/session-manager.ts"],"names":[],"mappings":"AACA,OAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAMD;;;;GAIG;AACH,cAAM,cAAc;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,eAAe,EAAE,CAAM;IACpC,WAAW,EAAE,eAAe,EAAE,CAAM;gBAExB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI;IAMpD,cAAc,CAAC,KAAK,EAAE,eAAe;IAOrC,cAAc,CAAC,KAAK,EAAE,eAAe;CAMxC;AAQD,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAgD3F;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAM5D;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;AAED,eAAe,cAAc,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../src/tools/browser/session-manager.ts"],"names":[],"mappings":"AACA,OAAkB,EAAE,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;CACpB;AAMD;;;;GAIG;AACH,cAAM,cAAc;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,EAAE,eAAe,EAAE,CAAM;IACpC,WAAW,EAAE,eAAe,EAAE,CAAM;gBAExB,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI;IAMpD,cAAc,CAAC,KAAK,EAAE,eAAe;IAOrC,cAAc,CAAC,KAAK,EAAE,eAAe;CAMxC;AAQD,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA4D3F;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAM5D;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKpE;AAED,eAAe,cAAc,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/tools/browser/session-manager.js

@@ -38,11 +38,24 @@ function truncate(str, cap) {
 }
 export async function createSession(url, sessionId) {
     const browser = await puppeteer.launch({
-        executablePath: process.env.CHROME_PATH || (os.platform() == "win32" ?
+        executablePath: process.env.CHROME_PATH || (os.platform() === "win32" ?
             "C:/Program Files/Google/Chrome/Application/chrome.exe" :
             "/usr/bin/google-chrome-stable"),
-        headless: Boolean(process.env.HEADLESS_BROWSER_SESSIONS || true),
-        args: ["--no-sandbox"],
+        headless: process.env.HEADLESS_BROWSER_SESSIONS !== "false",
+        defaultViewport: { width: 1280, height: 800, deviceScaleFactor: 1 },
+        args: [
+            "--no-sandbox",
+            "--disable-dev-shm-usage",
+            "--disable-background-networking",
+            "--disable-background-timer-throttling",
+            "--disable-backgrounding-occluded-windows",
+            "--disable-renderer-backgrounding",
+            "--disable-sync",
+            "--mute-audio",
+            "--no-first-run",
+            "--force-color-profile=srgb",
+            "--font-render-hinting=none",
+        ],
     });
     const page = await browser.newPage();
     const session = new BrowserSession(sessionId, browser, page);

package/dist/tools/browser/session-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/tools/browser/session-manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-manager.js","sourceRoot":"","sources":["../../../src/tools/browser/session-manager.ts"],"names":[],"mappings":"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"}

package/docs/agents.md

@@ -56,7 +56,13 @@ This is a deliberate design for absorbing multiple user prompts that arrive whil
 
 Practical implication: don't treat an early queued call's resolved `run()` promise as "the model has now answered this prompt" — for anything but the last queued call, it only means the prompt was recorded. Drive replies off `streamCallback` if you need to know when the model has actually responded.
 
-`stop()` requests the current run stop at the next safe point; it resolves once the loop has actually stopped, or rejects if it doesn't stop within 4 minutes.
+`safeStop()` requests the current run stop at the next safe point; it resolves once the loop has actually stopped, or rejects if it doesn't stop within 4 minutes. It does not interrupt an in-flight model call — that call is left to finish normally, and the loop stops right after.
+
+`immediateStop()` requests the same stop but returns right away without waiting for confirmation, **and** aborts the in-flight `chat()` call to the main provider immediately — the underlying HTTP request is cancelled rather than left to run to completion, so no further output tokens get generated (and billed) past that point. Input tokens, and any output already generated before the abort landed, are already committed — cancelling can't retroactively make those free. This is the one to reach for when a call has to be killed regardless of how far through it is (e.g. a credit balance that just went negative). A tool dispatch already in progress isn't aborted (tools have no generic cancellation hook) — the loop stops as soon as that call returns. Abort support is real for Anthropic, OpenAI, and DeepSeek (both streaming and non-streaming); for Ollama it only takes effect on streaming calls — see the note in `ollama-provider.ts`.
+
+For a **streaming** call, an abort doesn't throw the turn away: `chat()` resolves normally with whatever text, thinking, and tool calls were already accumulated before the cutoff — the same as if the model had naturally stopped there — so anything already sent to `streamCallback` still ends up recorded in message history instead of vanishing. A tool call the model was still in the middle of generating when the abort hit is dropped even then (its arguments may be truncated JSON); only tool calls that had already fully finished are included — e.g. if the model requested 3 tool calls and the abort landed while the 3rd was still streaming, only the first 2 come back. For a **non-streaming** call there's nothing to salvage (the API only returns a response once, in full) — abort there still surfaces as a thrown error, and `BaseAgent` discards that turn entirely rather than recording a broken one.
+
+`stop()` is a deprecated alias for `safeStop()` and will be removed in the 1.0.0 major release.
 
 ### Native tool-calling is required
 

package/docs/mcp-architecture.md

@@ -86,7 +86,7 @@ Requires the `aliafsordeh/orbitx-sandbox:0.1` image (pull it, or build it yourse
 
 ## Storage and RNG
 
-- **`MCPStorage`** — abstract `{ get(key): Promise<string>; set(key, value): Promise<void> }`. `MCPFSStorage` is the default filesystem-backed implementation (`new MCPFSStorage(path?)`, defaults to a randomly-named folder under `./data`). `MCPStorage` and `MCPFSStorage` are both exported if you want to implement your own backend (Redis, a database, etc.) or point the default one at a specific path.
+- **`MCPStorage`** — abstract `{ get(key): Promise<string>; set(key, value): Promise<void> }`. `MCPFSStorage` is the default filesystem-backed implementation (`new MCPFSStorage(path?)`, defaults to a randomly-named folder under the OS temp directory). `MCPStorage` and `MCPFSStorage` are both exported if you want to implement your own backend (Redis, a database, etc.) or point the default one at a specific path.
 - **`MCPRNG`** — deterministic-ish id generator backed by an `MCPStorage` instance (used internally for things like `generateRefId()`, the helper behind ref ids in `BrowserReadTool`'s output).
 
 ## `MCPFilter` — redacting tool output

package/docs/providers.md

@@ -7,7 +7,8 @@ abstract class AIProvider {
   abstract chat(
     messages: Message[],
     streamCallback?: StreamCallback,
-    tools?: ToolSchema[]
+    tools?: ToolSchema[],
+    signal?: AbortSignal
   ): Promise<ChatResponse>;
 
   abstract getCapabilities(): ProviderCapabilities;
@@ -15,6 +16,9 @@ abstract class AIProvider {
 ```
 
 - `chat` sends the full message history (plus a provider-agnostic `tools` schema, when supplied) and returns a `ChatResponse` (`{ content, inputTokens, outputTokens, toolCalls? }`). If `streamCallback` is passed, text is streamed to it incrementally as it arrives — see [Streaming](./streaming.md).
+- `signal`, when passed and later aborted, cancels the in-flight request to the provider's API immediately rather than just abandoning it client-side — `BaseAgent.immediateStop()` uses this so the call stops generating (and billing for) further output right away. It doesn't retroactively waive input tokens or output already generated before the abort. Anthropic, OpenAI, and DeepSeek honor it for both streaming and non-streaming calls (their SDKs forward it straight to `fetch`). Ollama only honors it for streaming calls — its client has no way to abort a non-streaming request — so a `chat()` call made without a `streamCallback` against `OllamaProvider` can't be cancelled mid-flight; see the retry-loop guard in `ollama-provider.ts`.
+  - **Streaming calls resolve normally on abort**, returning a `ChatResponse` built from whatever content/thinking/tool-calls were accumulated before the cutoff, instead of throwing — so text already delivered via `streamCallback` still ends up recorded rather than discarded. A tool call still being generated when the abort lands is dropped (its arguments may be truncated JSON); only tool calls that had already fully finished streaming are included in `toolCalls`.
+  - **Non-streaming calls still throw on abort** — there's no partial response to salvage since the API only returns once, in full — and `BaseAgent` discards that turn.
 - `getCapabilities()` returns a static description used by `BaseAgent` to decide things like when to trigger memory compaction — it is **not** re-queried per call:
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orbitx",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "An AI SDK providing agents, swarms, planners, skills, MCP tools, workflows, and multi-provider AI integrations.",
   "repository": {
     "type": "git",