norns-sdk 0.3.0 → 0.4.1

package/dist/index.d.cts

@@ -241,8 +241,9 @@ declare class NornsClient {
          *       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: (options?: ListRunsOptions) => Promise<Run[]>;
         events: (runId: number) => Promise<RunEvent[]>;
@@ -480,6 +481,7 @@ interface ToolDefinition<I = unknown> {
  */
 declare function tool<S extends ToolInputSchema>(options: ToolOptions<S>): ToolDefinition<InferToolInput<S>>;
 
+/** @deprecated Norns never read it; a conversation starts from a `conversationKey` on the message. */
 type AgentMode = "task" | "conversation";
 type CheckpointPolicy = "every_step" | "on_tool_call" | "manual";
 type ContextStrategy = "sliding_window" | "none";
@@ -510,6 +512,7 @@ interface AgentOptions {
     systemPrompt?: string;
     /** What this worker serves for the agent (see `allowedTools` for what it is offered). */
     tools?: ToolDefinition[];
+    /** @deprecated Ignored. Norns never read it; send a message with a `conversationKey` instead. */
     mode?: AgentMode;
     checkpointPolicy?: CheckpointPolicy;
     contextStrategy?: ContextStrategy;
@@ -540,7 +543,6 @@ interface AgentDefinition {
     readonly model: string;
     readonly systemPrompt: string;
     readonly tools: readonly ToolDefinition[];
-    readonly mode: AgentMode;
     readonly checkpointPolicy: CheckpointPolicy;
     readonly contextStrategy: ContextStrategy;
     readonly contextWindow: number;

package/dist/index.d.ts

@@ -241,8 +241,9 @@ declare class NornsClient {
          *       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: (options?: ListRunsOptions) => Promise<Run[]>;
         events: (runId: number) => Promise<RunEvent[]>;
@@ -480,6 +481,7 @@ interface ToolDefinition<I = unknown> {
  */
 declare function tool<S extends ToolInputSchema>(options: ToolOptions<S>): ToolDefinition<InferToolInput<S>>;
 
+/** @deprecated Norns never read it; a conversation starts from a `conversationKey` on the message. */
 type AgentMode = "task" | "conversation";
 type CheckpointPolicy = "every_step" | "on_tool_call" | "manual";
 type ContextStrategy = "sliding_window" | "none";
@@ -510,6 +512,7 @@ interface AgentOptions {
     systemPrompt?: string;
     /** What this worker serves for the agent (see `allowedTools` for what it is offered). */
     tools?: ToolDefinition[];
+    /** @deprecated Ignored. Norns never read it; send a message with a `conversationKey` instead. */
     mode?: AgentMode;
     checkpointPolicy?: CheckpointPolicy;
     contextStrategy?: ContextStrategy;
@@ -540,7 +543,6 @@ interface AgentDefinition {
     readonly model: string;
     readonly systemPrompt: string;
     readonly tools: readonly ToolDefinition[];
-    readonly mode: AgentMode;
     readonly checkpointPolicy: CheckpointPolicy;
     readonly contextStrategy: ContextStrategy;
     readonly contextWindow: number;

package/dist/index.js

@@ -34,7 +34,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,
@@ -49,7 +48,6 @@ function defineAgent(options) {
 }
 function agentBody(agent) {
   const modelConfig = {
-    mode: agent.mode,
     checkpoint_policy: agent.checkpointPolicy,
     context_strategy: agent.contextStrategy,
     context_window: agent.contextWindow,
@@ -354,12 +352,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);