@dana4/sdk 0.5.0 → 0.6.0

package/dist/agent.d.ts

@@ -56,6 +56,8 @@ export type Logger = Pick<Console, "info" | "warn" | "error">;
 /** The JSON schema advertised for a capability. The server only forwards the
  * payload keys a schema declares, so the base fields must be declared too. */
 export declare function capabilitySchema(key: string, cap: Capability): JsonObject;
+/** Usernames @-mentioned in `body`, lowercased; the server's `extract_tagged_usernames`. */
+export declare const taggedUsernames: (body: string) => string[];
 /** Everything a handler needs, bound to its workspace, channel and task, so ids
  * never have to be threaded through calls. */
 export declare class Context {

package/dist/agent.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { skippedFromHistory } from "./client.js";
 /** Typed helper: infers `input` in `run` from the schema. */
 export const capability = (c) => c;
 export const defineAgent = (agent) => agent;
@@ -26,7 +27,7 @@ export function capabilitySchema(key, cap) {
 }
 const errorMessage = (e) => e instanceof Error ? e.message : String(e);
 /** Usernames @-mentioned in `body`, lowercased; the server's `extract_tagged_usernames`. */
-const taggedUsernames = (body) => body
+export const taggedUsernames = (body) => body
     .split(/\s+/)
     .map((w) => w.replace(/^[^\p{L}\p{N}@._-]+|[^\p{L}\p{N}@._-]+$/gu, ""))
     .filter((w) => w.length > 1 && w.startsWith("@"))
@@ -263,7 +264,7 @@ export class AgentRuntime {
      * messages (no `from`, e.g. a failed task's error) never count in a DM, or
      * the agent would answer its own errors forever. */
     addressed(thread) {
-        const theirs = thread.messages.filter((m) => m.from_username !== this.me);
+        const theirs = thread.messages.filter((m) => m.from_username !== this.me && !skippedFromHistory(m));
         const last = theirs.filter((m) => m.from).at(-1);
         if (thread.direct && last)
             return [{ kind: "chat", message: last, thread }];
@@ -346,7 +347,7 @@ export class AgentRuntime {
         try {
             const thinking = this.agent.thinking ?? "*Thinking...*";
             if (thinking)
-                await ctx.send(thinking, { category: "transient" });
+                await ctx.send(thinking, { category: "skip_from_history" });
             await this.agent.onChat({ message, thread }, ctx);
             await this.client.tasks.update(taskId, {
                 status: "completed",

package/dist/ai.d.ts

@@ -1,7 +1,7 @@
 /** Glue for the Vercel AI SDK (`ai`): Dana4 tools ready for `generateText`,
  * and chat threads turned into model messages. */
 import { type ModelMessage, type ToolSet } from "ai";
-import type { Context } from "./agent.js";
+import { type Context } from "./agent.js";
 import type { ChatThread, DocumentHeader, JsonObject, Message } from "./client.js";
 /** `ls -R`-style listing: grouped per directory, folders first, titles aligned. */
 export declare function formatDocumentList(documents: DocumentHeader[]): string;
@@ -27,7 +27,8 @@ export declare function dana4Tools(ctx: Context, opts?: {
 }): Promise<ToolSet>;
 /** A thread's messages as model messages, oldest first: this agent's own
  * messages become assistant turns, everyone else's user turns prefixed with
- * the author. Only conversational messages (and errors) are kept. */
+ * the author. Only conversation is kept; orchestrator notices and errors only
+ * when they @-tag the agent, and status lines never. */
 export declare function chatHistory(messages: Message[], { me, exclude }: {
     me: string;
     exclude?: string;

package/dist/ai.js

@@ -2,6 +2,7 @@
  * and chat threads turned into model messages. */
 import { jsonSchema, tool } from "ai";
 import { z } from "zod";
+import { taggedUsernames } from "./agent.js";
 const MAX_LINES_PER_READ = 500;
 const MAX_LINES_PER_WRITE = 400;
 /** `ls -R`-style listing: grouped per directory, folders first, titles aligned. */
@@ -436,11 +437,14 @@ export async function dana4Tools(ctx, opts = {}) {
 }
 /** A thread's messages as model messages, oldest first: this agent's own
  * messages become assistant turns, everyone else's user turns prefixed with
- * the author. Only conversational messages (and errors) are kept. */
+ * the author. Only conversation is kept; orchestrator notices and errors only
+ * when they @-tag the agent, and status lines never. */
 export function chatHistory(messages, { me, exclude }) {
     return messages
-        .filter((m) => (m.category === "default" || m.category === "error") &&
-        m.id !== exclude)
+        .filter((m) => m.id !== exclude &&
+        (m.category === "default" ||
+            ((m.category === "error" || m.category === "notice") &&
+                taggedUsernames(m.message).includes(me.toLowerCase()))))
         .sort((a, b) => a.time.created_at.localeCompare(b.time.created_at))
         .map((m) => {
         const content = `${m.from_username}: ${m.category === "error" ? "ERROR: " : ""}${m.message}`;

package/dist/client.d.ts

@@ -14,6 +14,9 @@ export type DocumentType = S["DocumentType"];
 export type EnrollAgentResponse = S["EnrollAgentResponse"];
 export type Message = S["Message"];
 export type MessageCategory = S["MessageCategory"];
+/** Routine status lines (progress, "Thinking...", blockers): never conversation.
+ * `transient` and `dependencies_status` are legacy values on old rows. */
+export declare const skippedFromHistory: (m: Pick<Message, "category">) => boolean;
 export type Pipe = S["Pipe"];
 export type PresenceActivity = S["PresenceActivity"];
 export type SearchResult = S["SearchResult"];

package/dist/client.js

@@ -1,3 +1,8 @@
+/** Routine status lines (progress, "Thinking...", blockers): never conversation.
+ * `transient` and `dependencies_status` are legacy values on old rows. */
+export const skippedFromHistory = (m) => m.category === "skip_from_history" ||
+    m.category === "transient" ||
+    m.category === "dependencies_status";
 export const DEFAULT_URL = "https://app.dana4.io";
 /** A non-2xx answer from Dana4. `status` 401 means a revoked key or a workspace
  * the agent is not a member of; 409 on a document edit means a stale read. */

package/dist/schema.d.ts

@@ -635,6 +635,9 @@ export interface paths {
 		 *     `channel_id`. Every `dana4-asset://` reference inside it has already been rewritten to
 		 *     a short-lived presigned HTTPS URL.
 		 *
+		 *     Tasks with an open blocker (`blocked_by` tickets not yet Done or Canceled) are skipped
+		 *     until it clears.
+		 *
 		 *     Only dispatched agent tasks arrive here. Work assigned to you as a person comes from
 		 *     `GET /api-sdk/v1/tasks/assigned`, and unclaimed work from
 		 *     `GET /api-sdk/v1/tasks/unassigned`.
@@ -1500,15 +1503,27 @@ export interface components {
 			workspace_id: string;
 		};
 		/**
-		 * @description Should match MessageCategory enum in ai/dana4_sdk/src/dana4_sdk/__init__.py
+		 * @description Should match MessageCategory enum in ai/dana4_sdk/src/dana4_sdk/definitions.py
+		 *
+		 *     - `Default`: conversation. Rendered as a chat bubble, part of agent history.
+		 *     - `Notice` / `Error`: an orchestrator event a person should see (rendered as
+		 *       a line, no bubble). Kept out of agent history unless it @-tags the agent.
+		 *     - `SkipFromHistory`: routine status (progress, "Thinking...", blockers). Never
+		 *       in agent history and never notifies an agent, even when it tags one.
+		 *     - `InvitedToWorkspace`: the invitation an agent reads to join a workspace.
+		 *
+		 *     `DependenciesStatus` and `Transient` are legacy: nothing writes them any
+		 *     more, but old rows still hold them, and they behave as `SkipFromHistory`.
 		 * @enum {string}
 		 */
 		MessageCategory:
 			| "default"
-			| "dependencies_status"
+			| "notice"
 			| "error"
-			| "transient"
-			| "invited_to_workspace";
+			| "skip_from_history"
+			| "invited_to_workspace"
+			| "dependencies_status"
+			| "transient";
 		Pipe: {
 			always: boolean;
 			/** Format: date-time */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dana4/sdk",
-	"version": "0.5.0",
+	"version": "0.6.0",
 	"description": "Connect your agent to Dana4: capabilities, chat, documents and workspaces over the Dana4 SDK API.",
 	"license": "MIT",
 	"author": "Dana4 Labs",