norns-sdk 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to `norns-sdk` are documented in this file.
 
+## [0.4.1] - 2026-10-23
+
+### Changed
+- `runs.list()` sends `status` and `agentId` to the server, which filters
+  before applying `limit` (Norns ≥ the `GET /runs` filter change). The page
+  is still filtered locally for older servers.
+
+## [0.4.0] - 2026-10-23
+
+### Changed
+- `mode` is no longer sent on agent registration and is deprecated on
+  `defineAgent()`. Norns never read it: a conversation starts from a
+  `conversationKey` on the message, not from the definition.
+
 ## [0.3.0] - 2026-10-22
 
 ### Added

package/README.md

@@ -44,7 +44,6 @@ const supportBot = defineAgent({
   model: "claude-sonnet-5",
   systemPrompt: "You are a customer support agent. Look up docs and help customers.",
   tools: [searchDocs, sendEmail],
-  mode: "conversation",
 });
 
 const worker = new NornsWorker({ agents: [supportBot] });
@@ -208,7 +207,6 @@ const agent = defineAgent({
   model: "claude-sonnet-5",
   systemPrompt: "You are helpful.",
   tools: [search, sendEmail],
-  mode: "conversation",              // "task" or "conversation"
   checkpointPolicy: "on_tool_call",  // "every_step", "on_tool_call", "manual"
   contextWindow: 20,
   maxSteps: 50,

package/dist/index.cjs

@@ -75,7 +75,6 @@ function defineAgent(options) {
     model: options.model ?? DEFAULT_MODEL,
     systemPrompt: options.systemPrompt ?? "",
     tools: Object.freeze([...tools]),
-    mode: options.mode ?? "task",
     checkpointPolicy: options.checkpointPolicy ?? "on_tool_call",
     contextStrategy: options.contextStrategy ?? "sliding_window",
     contextWindow: options.contextWindow ?? 20,
@@ -90,7 +89,6 @@ function defineAgent(options) {
 }
 function agentBody(agent) {
   const modelConfig = {
-    mode: agent.mode,
     checkpoint_policy: agent.checkpointPolicy,
     context_strategy: agent.contextStrategy,
     context_window: agent.contextWindow,
@@ -395,12 +393,16 @@ var NornsClient = class {
      *       console.log(run.id, run.waitingFor?.question);
      *     }
      *
-     * `status` and `agentId` filter the page the server returned, so a
-     * narrow filter over a busy tenant may need a larger `limit`.
+     * `status` and `agentId` are sent to the server, which filters before
+     * applying `limit`. (A Norns older than the filters ignores them, so
+     * the page is filtered here as well.)
      */
     list: async (options = {}) => {
+      const query = { limit: options.limit ?? 50 };
+      if (options.status) query.status = options.status;
+      if (options.agentId !== void 0) query.agent_id = options.agentId;
       const res = await this.#request("GET", "/api/v1/runs", {
-        query: { limit: options.limit ?? 50 }
+        query
       });
       let runs = res.data.map(parseRun);
       if (options.status) runs = runs.filter((r) => r.status === options.status);