@theokit/sdk-tools 0.10.0 → 0.11.0

package/dist/index.d.cts

@@ -708,6 +708,11 @@ declare function createShellTool(opts: CreateShellToolOptions): CustomTool;
  *   - remove(id)         → remove an item
  *   - list()             → show all items with status
  *   - clear_completed()  → remove all done items
+ *
+ * #119 — state is keyed by `ctx.threadId` (the run's session identity, injected by the
+ * SDK from `Agent.getOrCreate(sessionId, …)`). One tool object served to many sessions
+ * from a single process keeps each session's list isolated. When no `threadId` is present
+ * (single-session CLI usage) every call shares one default session — behavior unchanged.
  */
 interface TodoItem {
     id: string;
@@ -720,9 +725,15 @@ interface TodolistTool {
     name: string;
     description: string;
     inputSchema: unknown;
-    handler: (input: TodoInput) => string;
-    /** Expose items for testing. */
-    getItems: () => TodoItem[];
+    /**
+     * #119 — the optional 2nd `ctx` carries the run's `threadId`; state is scoped to it.
+     * Single-argument callers (CLI / tests) share one default session.
+     */
+    handler: (input: TodoInput, ctx?: {
+        threadId?: string;
+    }) => string;
+    /** Expose a session's items for testing (defaults to the no-threadId session). */
+    getItems: (threadId?: string) => TodoItem[];
 }
 type TodoInput = {
     action: "add";

package/dist/index.d.ts

@@ -708,6 +708,11 @@ declare function createShellTool(opts: CreateShellToolOptions): CustomTool;
  *   - remove(id)         → remove an item
  *   - list()             → show all items with status
  *   - clear_completed()  → remove all done items
+ *
+ * #119 — state is keyed by `ctx.threadId` (the run's session identity, injected by the
+ * SDK from `Agent.getOrCreate(sessionId, …)`). One tool object served to many sessions
+ * from a single process keeps each session's list isolated. When no `threadId` is present
+ * (single-session CLI usage) every call shares one default session — behavior unchanged.
  */
 interface TodoItem {
     id: string;
@@ -720,9 +725,15 @@ interface TodolistTool {
     name: string;
     description: string;
     inputSchema: unknown;
-    handler: (input: TodoInput) => string;
-    /** Expose items for testing. */
-    getItems: () => TodoItem[];
+    /**
+     * #119 — the optional 2nd `ctx` carries the run's `threadId`; state is scoped to it.
+     * Single-argument callers (CLI / tests) share one default session.
+     */
+    handler: (input: TodoInput, ctx?: {
+        threadId?: string;
+    }) => string;
+    /** Expose a session's items for testing (defaults to the no-threadId session). */
+    getItems: (threadId?: string) => TodoItem[];
 }
 type TodoInput = {
     action: "add";

package/dist/index.js

@@ -1801,7 +1801,7 @@ function requireId(input) {
   if (!("id" in input) || !input.id) return null;
   return input.id;
 }
-function createTodolistTool() {
+function makeSessionOps() {
   const items = [];
   let nextId = 1;
   function genId() {
@@ -1870,6 +1870,26 @@ ${done}/${items.length} done | ${inProg} in progress | ${pending} pending`);
     list: () => listResult({}),
     clear_completed: handleClearCompleted
   };
+  return {
+    handle: (input) => {
+      const action = actions[input.action];
+      if (!action) return fail({ error: "invalid_action" });
+      return action(input);
+    },
+    getItems: () => [...items]
+  };
+}
+function createTodolistTool() {
+  const sessions = /* @__PURE__ */ new Map();
+  function ops(threadId) {
+    const key = threadId ?? "__default__";
+    let session = sessions.get(key);
+    if (session === void 0) {
+      session = makeSessionOps();
+      sessions.set(key, session);
+    }
+    return session;
+  }
   return {
     name: "todolist",
     description: "Create and maintain a structured task list for the current session \u2014 tracks progress and keeps a multi-step plan visible across turns. Use it proactively when the work has 3+ steps or the user gave multiple tasks; skip it for a single trivial step. Keep exactly ONE item 'in_progress' at a time, and mark 'complete' only after the work is actually done. Actions: 'add' (create with title), 'in_progress' (mark started by id), 'complete' (mark done by id), 'remove' (delete by id), 'list' (show all), 'clear_completed' (remove done items). Returns { ok, items, items_summary } (items = structured array; items_summary = formatted text).",
@@ -1892,12 +1912,8 @@ ${done}/${items.length} done | ${inProg} in progress | ${pending} pending`);
       },
       required: ["action"]
     },
-    handler: (input) => {
-      const action = actions[input.action];
-      if (!action) return fail({ error: "invalid_action" });
-      return action(input);
-    },
-    getItems: () => [...items]
+    handler: (input, ctx) => ops(ctx?.threadId).handle(input),
+    getItems: (threadId) => ops(threadId).getItems()
   };
 }
 function truncateOutput(output, opts) {