@dana4/sdk 0.1.0 → 0.6.0

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. */
@@ -18,10 +19,14 @@ export function formatDocumentList(documents) {
         .map((dir) => {
         const entries = groups
             .get(dir)
-            .sort((a, b) => Number(isFolder(b)) - Number(isFolder(a)) || leaf(a).localeCompare(leaf(b)));
+            ?.sort((a, b) => Number(isFolder(b)) - Number(isFolder(a)) ||
+            leaf(a).localeCompare(leaf(b))) ?? [];
         const names = entries.map((d) => leaf(d) + (isFolder(d) ? "/" : ""));
         const width = Math.max(...names.map((n) => n.length));
-        return [`${dir}:`, ...entries.map((d, i) => `  ${names[i].padEnd(width)}  ${d.title}`)].join("\n");
+        return [
+            `${dir}:`,
+            ...entries.map((d, i) => `  ${names[i]?.padEnd(width)}  ${d.title}`),
+        ].join("\n");
     })
         .join("\n\n");
 }
@@ -39,10 +44,13 @@ export function grep(content, pattern, context = 3) {
     const shown = new Set(hits.flatMap((i) => Array.from({ length: 2 * context + 1 }, (_, k) => i - context + k)));
     const out = [];
     let prev = -2;
-    for (const i of [...shown].filter((i) => i >= 0 && i < lines.length).sort((a, b) => a - b)) {
+    for (const i of [...shown]
+        .filter((i) => i >= 0 && i < lines.length)
+        .sort((a, b) => a - b)) {
         if (i !== prev + 1 && out.length)
             out.push("---");
-        out.push(`${regex.test(lines[i]) ? ">" : " "} ${i + 1}: ${lines[i]}`);
+        const line = lines[i] ?? "";
+        out.push(`${regex.test(line) ? ">" : " "} ${i + 1}: ${line}`);
         prev = i;
     }
     return { matches: hits.length, lines: lines.length, text: out.join("\n") };
@@ -52,7 +60,7 @@ export function insertAt(document, line, content) {
     const lines = document.match(/[^\n]*\n|[^\n]+$/g) ?? [];
     const at = Math.max(0, Math.min(line - 1, lines.length));
     // Appending after an unterminated last line: end it first, or the two join.
-    if (at === lines.length && at > 0 && !lines[at - 1].endsWith("\n"))
+    if (at === lines.length && at > 0 && !lines[at - 1]?.endsWith("\n"))
         lines[at - 1] += "\n";
     lines.splice(at, 0, content.endsWith("\n") ? content : `${content}\n`);
     return lines.join("");
@@ -67,11 +75,21 @@ export function capabilityToolSchema(schema) {
         if (["workspace_id", "task_id"].includes(name))
             return false;
         const t = p?.type;
-        return typeof t === "string" ? PRIMITIVE.has(t) : Array.isArray(t) && t.every((x) => typeof x === "string" && PRIMITIVE.has(x));
+        return typeof t === "string"
+            ? PRIMITIVE.has(t)
+            : Array.isArray(t) &&
+                t.every((x) => typeof x === "string" && PRIMITIVE.has(x));
     });
     const kept = new Set(keep.map(([n]) => n));
-    const required = Array.isArray(schema?.required) ? schema.required.filter((r) => typeof r === "string" && kept.has(r)) : [];
-    return { type: "object", additionalProperties: false, properties: Object.fromEntries(keep), required };
+    const required = Array.isArray(schema?.required)
+        ? schema.required.filter((r) => typeof r === "string" && kept.has(r))
+        : [];
+    return {
+        type: "object",
+        additionalProperties: false,
+        properties: Object.fromEntries(keep),
+        required,
+    };
 }
 /** Tools for reading and writing the workspace's documents, messaging, and the
  * thread's plan — plus, unless `delegation: false`, one `<agent>__<capability>`
@@ -80,9 +98,12 @@ export function capabilityToolSchema(schema) {
 export async function dana4Tools(ctx, opts = {}) {
     const tools = {
         list_documents: tool({
-            description: "List documents in a folder with their paths and titles. Optionally recurse into subfolders.",
+            description: "List documents in a folder with their paths and titles. Optionally recurse into subfolders. To find documents about a topic, use search_documents instead: listing returns every document and costs far more tokens.",
             inputSchema: z.object({
-                path: z.string().default("/").describe("Folder to list, as a path (e.g. '/foo/bar'). Defaults to the root."),
+                path: z
+                    .string()
+                    .default("/")
+                    .describe("Folder to list, as a path (e.g. '/foo/bar'). Defaults to the root."),
                 recursive: z
                     .boolean()
                     .default(false)
@@ -94,19 +115,33 @@ export async function dana4Tools(ctx, opts = {}) {
             description: "Search for a text pattern within a document. Returns matching lines with line numbers and surrounding context. Use this BEFORE read_document to find relevant sections without reading the entire file.",
             inputSchema: z.object({
                 path: z.string().describe("Path of the document to search in."),
-                pattern: z.string().describe("Text or regex pattern to search for. Case-insensitive."),
-                context_lines: z.number().int().default(3).describe("Number of lines to show before and after each match."),
+                pattern: z
+                    .string()
+                    .describe("Text or regex pattern to search for. Case-insensitive."),
+                context_lines: z
+                    .number()
+                    .int()
+                    .default(3)
+                    .describe("Number of lines to show before and after each match."),
             }),
             execute: async ({ path, pattern, context_lines }) => {
                 const r = grep((await ctx.docs.get(path)).content, pattern, context_lines);
-                return r.matches ? `Found ${r.matches} match(es) in ${path} (${r.lines} lines total):\n${r.text}` : `No matches for '${pattern}' in ${path}`;
+                return r.matches
+                    ? `Found ${r.matches} match(es) in ${path} (${r.lines} lines total):\n${r.text}`
+                    : `No matches for '${pattern}' in ${path}`;
             },
         }),
         search_documents: tool({
             description: "Search across ALL documents in the workspace by meaning or keyword, returning the most relevant documents with a snippet and relevance score. Use this when you don't know which document holds the content you need. Use grep_document instead to search within a single known document.",
             inputSchema: z.object({
-                query: z.string().describe("Natural-language or keyword query to search across all documents in the workspace."),
-                limit: z.number().int().optional().describe("Max number of results to return. Defaults to the server default."),
+                query: z
+                    .string()
+                    .describe("Natural-language or keyword query to search across all documents in the workspace."),
+                limit: z
+                    .number()
+                    .int()
+                    .optional()
+                    .describe("Max number of results to return. Defaults to the server default."),
             }),
             execute: async ({ query, limit }) => {
                 const results = await ctx.docs.search(query, limit);
@@ -114,7 +149,10 @@ export async function dana4Tools(ctx, opts = {}) {
                     return `No documents matched '${query}'.`;
                 return [
                     `Found ${results.length} result(s) for '${query}':\n`,
-                    ...results.flatMap((r) => [`- ${r.path} — ${r.title} (score: ${r.score.toFixed(3)})`, ...(r.snippet ? [`    ${r.snippet}`] : [])]),
+                    ...results.flatMap((r) => [
+                        `- ${r.path} — ${r.title} (score: ${r.score.toFixed(3)})`,
+                        ...(r.snippet ? [`    ${r.snippet}`] : []),
+                    ]),
                 ].join("\n");
             },
         }),
@@ -122,7 +160,11 @@ export async function dana4Tools(ctx, opts = {}) {
             description: `Read a document's content with line numbers. Returns up to ${MAX_LINES_PER_READ} lines.\n\nUsage:\n- Use grep_document first to find relevant line numbers, then read targeted ranges.\n- Use offset and limit to read specific sections. Avoid reading entire large documents.\n- Lines are prefixed with line numbers: \`42: content here\`.\n- Call this tool in parallel when reading multiple documents.`,
             inputSchema: z.object({
                 path: z.string().describe("The path to the document to read."),
-                offset: z.number().int().optional().describe("Line number to start reading from (1-indexed). Defaults to 1."),
+                offset: z
+                    .number()
+                    .int()
+                    .optional()
+                    .describe("Line number to start reading from (1-indexed). Defaults to 1."),
                 limit: z
                     .number()
                     .int()
@@ -138,18 +180,24 @@ export async function dana4Tools(ctx, opts = {}) {
                     .slice(start, end)
                     .map((l, i) => `${start + i + 1}: ${l}`)
                     .join("\n");
-                const more = end < lines.length ? `\n\n[Showing lines ${start + 1}-${end} of ${lines.length}. Use offset=${end + 1} to read more.]` : "";
+                const more = end < lines.length
+                    ? `\n\n[Showing lines ${start + 1}-${end} of ${lines.length}. Use offset=${end + 1} to read more.]`
+                    : "";
                 return `Title: ${doc.title}\nPath: ${path}\nTotal lines: ${lines.length}\nContent:\n\n${body}${more}\n`;
             },
         }),
         get_step_result: tool({
             description: "Fetch the result produced by an earlier step in the current journey, by its step id. Returns the result as JSON, or a note if the step has not produced a result yet.",
             inputSchema: z.object({
-                step_id: z.string().describe("The id of the step whose result to fetch (e.g. 'step_brand_questions')."),
+                step_id: z
+                    .string()
+                    .describe("The id of the step whose result to fetch (e.g. 'step_brand_questions')."),
             }),
             execute: async ({ step_id }) => {
                 const result = await ctx.stepResult(step_id);
-                return result == null ? `No result available for step '${step_id}' yet (it may not have run or completed).` : JSON.stringify(result, null, 2);
+                return result == null
+                    ? `No result available for step '${step_id}' yet (it may not have run or completed).`
+                    : JSON.stringify(result, null, 2);
             },
         }),
         create_document: tool({
@@ -173,7 +221,10 @@ export async function dana4Tools(ctx, opts = {}) {
             description: `Overwrite a document's entire content. Max ~${MAX_LINES_PER_WRITE} lines.\n\nONLY use for small documents. For anything larger, use create_document + append_document.\nFor targeted changes, prefer edit_document or insert_in_document instead.`,
             inputSchema: z.object({
                 path: z.string().describe("Path to the document to overwrite."),
-                content: z.string().default("").describe("Full replacement content. Must be under ~200 lines."),
+                content: z
+                    .string()
+                    .default("")
+                    .describe("Full replacement content. Must be under ~200 lines."),
             }),
             execute: async ({ path, content }) => {
                 if (!content)
@@ -189,7 +240,9 @@ export async function dana4Tools(ctx, opts = {}) {
             description: "Append content to the end of an existing document.\n\nUse this for building large documents incrementally:\n1. create_document with opening structure\n2. append_document for each section\nKeep each append under ~300 lines.",
             inputSchema: z.object({
                 path: z.string().describe("Path of the document to append to."),
-                content: z.string().describe("Content to append to the end of the document."),
+                content: z
+                    .string()
+                    .describe("Content to append to the end of the document."),
             }),
             execute: async ({ path, content }) => {
                 await ctx.docs.append(path, content);
@@ -200,9 +253,16 @@ export async function dana4Tools(ctx, opts = {}) {
             description: "Find and replace exact text in a document.\n\nUsage:\n- You MUST read_document or grep_document first to see the exact text.\n- old_str must match exactly (whitespace, indentation, line breaks).\n- old_str must be unique in the document. Include surrounding lines if needed, or set replace_all to change every occurrence.\n- Do NOT include line number prefixes (e.g. `42: `) in old_str/new_str.",
             inputSchema: z.object({
                 path: z.string().describe("Path to the document to modify."),
-                old_str: z.string().describe("Exact text to find and replace. Must match uniquely. Include surrounding lines for context if needed."),
-                new_str: z.string().describe("Replacement text. Must differ from old_str."),
-                replace_all: z.boolean().default(false).describe("Replace every occurrence instead of requiring a unique match."),
+                old_str: z
+                    .string()
+                    .describe("Exact text to find and replace. Must match uniquely. Include surrounding lines for context if needed."),
+                new_str: z
+                    .string()
+                    .describe("Replacement text. Must differ from old_str."),
+                replace_all: z
+                    .boolean()
+                    .default(false)
+                    .describe("Replace every occurrence instead of requiring a unique match."),
             }),
             execute: async ({ path, old_str, new_str, replace_all }) => {
                 try {
@@ -222,15 +282,47 @@ export async function dana4Tools(ctx, opts = {}) {
                     .number()
                     .int()
                     .describe("Line number to insert BEFORE (1-indexed). Use 0 to insert at the very beginning. Use a line number beyond the end to append."),
-                content: z.string().describe("Content to insert at the specified line."),
+                content: z
+                    .string()
+                    .describe("Content to insert at the specified line."),
             }),
             execute: async ({ path, line, content }) => {
                 const doc = await ctx.docs.get(path, "editing");
                 await ctx.docs.replace(path, insertAt(doc.content, line, content));
-                const n = (content.endsWith("\n") ? content : `${content}\n`).split("\n").length - 1;
+                const n = (content.endsWith("\n") ? content : `${content}\n`).split("\n")
+                    .length - 1;
                 return `Inserted ${n} line(s) at line ${line} in ${path}`;
             },
         }),
+        create_ticket: tool({
+            description: "Create a ticket on the workspace's board. Tickets are identified by their number (#42), unique within the workspace; blocked_by takes those numbers.",
+            inputSchema: z.object({
+                title: z.string().describe("The ticket's title."),
+                description: z
+                    .string()
+                    .optional()
+                    .describe("What needs doing, in markdown."),
+                status: z
+                    .enum([
+                    "backlog",
+                    "todo",
+                    "in_progress",
+                    "in_review",
+                    "done",
+                    "canceled",
+                ])
+                    .optional()
+                    .describe("The board column. Defaults to backlog."),
+                blocked_by: z
+                    .array(z.number().int())
+                    .default([])
+                    .describe("Numbers of the tickets that must finish first."),
+            }),
+            execute: async (ticket) => {
+                const t = await ctx.tickets.create(ticket);
+                return `Ticket #${t.number} created in workspace ${ctx.workspaceId}`;
+            },
+        }),
         send_message: tool({
             description: "Send a message to a channel. Uses the current channel if channel_id is omitted.",
             inputSchema: z.object({
@@ -248,20 +340,42 @@ export async function dana4Tools(ctx, opts = {}) {
                 plan: z
                     .string()
                     .describe("The full plan as a markdown checklist, e.g. `- [x] research\n- [ ] draft`. This REPLACES the existing plan, so include every item, not just the changed ones. Use this to author the initial plan; prefer complete_plan_item / add_plan_item for incremental edits."),
-                channel_id: z.string().optional().describe("The id of the channel. Defaults to the current channel."),
+                channel_id: z
+                    .string()
+                    .optional()
+                    .describe("The id of the channel. Defaults to the current channel."),
             }),
             execute: async ({ plan, channel_id }) => {
                 const ch = await ctx.plan.set(plan, channel_id ?? ctx.channelId);
                 return planStatus(ch.id, ch.plan_completed);
             },
         }),
+        set_memory: tool({
+            description: "Overwrite this message thread's memory: markdown notes shared by its agents and people.\n\nUse it to log what happened, what worked, what failed and what to remember next run. The current memory is in your instructions; send the whole updated text, not just the new notes.",
+            inputSchema: z.object({
+                memory: z
+                    .string()
+                    .describe("The full memory as markdown. This REPLACES the existing memory, so start from the current one in your instructions and edit it: keep what is still useful, add what happened, what worked, what failed and what to remember next run, and drop what is stale."),
+                channel_id: z
+                    .string()
+                    .optional()
+                    .describe("The id of the channel. Defaults to the current channel."),
+            }),
+            execute: async ({ memory, channel_id }) => {
+                const ch = await ctx.memory.set(memory, channel_id ?? ctx.channelId);
+                return `Memory updated for channel ${ch.id}.`;
+            },
+        }),
         complete_plan_item: tool({
             description: "Check off one item in this message thread's plan as you finish it.\n\nUsage:\n- The current plan (a markdown checklist) is in your instructions.\n- Pass the item's exact label text — just that one item, not the whole plan.\n- If the text matches no item or several, you'll get an error; retry with more of the item's wording.\n- The thread is complete once every item is checked.",
             inputSchema: z.object({
                 item: z
                     .string()
                     .describe("The exact label text of the checklist item to check off (the words after the `[ ]`), as shown in the current plan in your instructions. Matched ignoring case and extra spaces; it must be unambiguous."),
-                channel_id: z.string().optional().describe("The id of the channel. Defaults to the current channel."),
+                channel_id: z
+                    .string()
+                    .optional()
+                    .describe("The id of the channel. Defaults to the current channel."),
             }),
             execute: async ({ item, channel_id }) => {
                 try {
@@ -276,8 +390,13 @@ export async function dana4Tools(ctx, opts = {}) {
         add_plan_item: tool({
             description: "Append a new unchecked item to this message thread's plan.\n\nUse this to record a step you've discovered; pass just the new item's text, not the whole plan.",
             inputSchema: z.object({
-                item: z.string().describe("The text of the new unchecked checklist item to append."),
-                channel_id: z.string().optional().describe("The id of the channel. Defaults to the current channel."),
+                item: z
+                    .string()
+                    .describe("The text of the new unchecked checklist item to append."),
+                channel_id: z
+                    .string()
+                    .optional()
+                    .describe("The id of the channel. Defaults to the current channel."),
             }),
             execute: async ({ item, channel_id }) => {
                 const ch = await ctx.plan.add(item, channel_id ?? ctx.channelId);
@@ -290,7 +409,9 @@ export async function dana4Tools(ctx, opts = {}) {
     if (opts.delegation === false)
         return tools;
     // Without the lookup the chat still has every other tool, so don't fail it.
-    const agents = await ctx.client.workspaces.agents(ctx.workspaceId).catch((e) => {
+    const agents = await ctx.client.workspaces
+        .agents(ctx.workspaceId)
+        .catch((e) => {
         console.warn("dana4: listing agents failed; no delegation tools:", e instanceof Error ? e.message : e);
         return [];
     });
@@ -302,7 +423,8 @@ export async function dana4Tools(ctx, opts = {}) {
             for (let i = 2; name in tools; i++)
                 name = `${base.slice(0, 63 - String(i).length)}_${i}`;
             tools[name] = tool({
-                description: cap.description || `Trigger \`${cap.key}\` from agent \`${agent.username}\`.`,
+                description: cap.description ||
+                    `Trigger \`${cap.key}\` from agent \`${agent.username}\`.`,
                 inputSchema: jsonSchema(capabilityToolSchema(cap.input_schema)),
                 execute: async (inputs) => {
                     const taskId = await ctx.delegate(agent.username, cap.key, inputs);
@@ -315,23 +437,38 @@ 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}`;
-        return m.from_username === me ? { role: "assistant", content } : { role: "user", content };
+        return m.from_username === me
+            ? { role: "assistant", content }
+            : { role: "user", content };
     });
 }
-/** `base` followed by the thread's topics, intent and plan, so the model knows
- * what the conversation is for. */
+/** `base` followed by the thread's topics, the board, intent, plan and memory, so the
+ * model knows what the conversation is for. */
 export function threadInstructions(base, thread) {
+    const tickets = thread.tickets ?? [];
     const context = [
         ...thread.topics.map((t) => `Thread topic: ${t.title} — ${t.summary}`),
+        ...(tickets.length
+            ? [
+                `Board:\n${tickets
+                    .map((t) => `- ${t.number != null ? `#${t.number} ` : ""}${t.title} [${t.board_status}]${t.assignee ? ` @${t.assignee}` : ""}`)
+                    .join("\n")}`,
+            ]
+            : []),
         ...(thread.intent ? [`Thread intent: ${thread.intent}`] : []),
         ...(thread.plan ? [`Thread plan:\n${thread.plan}`] : []),
+        ...(thread.memory ? [`Thread memory:\n${thread.memory}`] : []),
     ].join("\n");
     return [base, context].filter(Boolean).join("\n\n");
 }

package/dist/cli.js

@@ -3,7 +3,12 @@ import { parseArgs } from "node:util";
 import { enroll } from "./enroll.js";
 const { values, positionals } = parseArgs({
     allowPositionals: true,
-    options: { username: { type: "string" }, bio: { type: "string" }, description: { type: "string" }, url: { type: "string" } },
+    options: {
+        username: { type: "string" },
+        bio: { type: "string" },
+        description: { type: "string" },
+        url: { type: "string" },
+    },
 });
 const username = values.username;
 if (positionals[0] !== "enroll" || !username) {
@@ -11,6 +16,10 @@ if (positionals[0] !== "enroll" || !username) {
     process.exitCode = 2;
 }
 else {
-    const key = await enroll({ ...values, username, url: values.url ?? process.env.DANA4_URL });
+    const key = await enroll({
+        ...values,
+        username,
+        url: values.url ?? process.env.DANA4_URL,
+    });
     console.log(`\nApproved. Your API key (shown once), e.g. for DANA4_API_KEY:\n\n${key}`);
 }

package/dist/client.d.ts

@@ -6,6 +6,7 @@ export type Automation = S["Automation"];
 export type Channel = S["Channel"];
 export type ChatThread = S["ChatThread"];
 export type CreateAutomationBody = S["CreateAutomationBody"];
+export type CreateTicketBody = S["CreateTicketBody"];
 export type CreateWorkflowPayload = S["CreateWorkflowPayload"];
 export type Document = S["Document"];
 export type DocumentHeader = S["DocumentHeader"];
@@ -13,9 +14,13 @@ 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"];
+export type SdkTicket = S["SdkTicket"];
 export type Task = S["Task"];
 export type TaskStatus = S["TaskStatus"];
 /** `cost_details` is optional on the wire; utoipa marks it required. */
@@ -95,6 +100,7 @@ export declare class Dana4Client {
             execution_duration?: number | null;
             id: string;
             journey_id: string;
+            number?: number | null;
             order: number;
             params?: {
                 [key: string]: unknown;
@@ -106,6 +112,9 @@ export declare class Dana4Client {
             step_id: string;
             step_type: components["schemas"]["JourneyStepType"];
             time: components["schemas"]["Timestamps"];
+            tool_calls?: {
+                [key: string]: unknown;
+            }[];
         }[]>;
         assigned: () => Promise<{
             channel_id: string;
@@ -116,6 +125,7 @@ export declare class Dana4Client {
             execution_duration?: number | null;
             id: string;
             journey_id: string;
+            number?: number | null;
             order: number;
             params?: {
                 [key: string]: unknown;
@@ -127,6 +137,9 @@ export declare class Dana4Client {
             step_id: string;
             step_type: components["schemas"]["JourneyStepType"];
             time: components["schemas"]["Timestamps"];
+            tool_calls?: {
+                [key: string]: unknown;
+            }[];
         }[]>;
         unassigned: () => Promise<{
             channel_id: string;
@@ -137,6 +150,7 @@ export declare class Dana4Client {
             execution_duration?: number | null;
             id: string;
             journey_id: string;
+            number?: number | null;
             order: number;
             params?: {
                 [key: string]: unknown;
@@ -148,6 +162,9 @@ export declare class Dana4Client {
             step_id: string;
             step_type: components["schemas"]["JourneyStepType"];
             time: components["schemas"]["Timestamps"];
+            tool_calls?: {
+                [key: string]: unknown;
+            }[];
         }[]>;
         claim: (taskId: string, capability: string) => Promise<{
             channel_id: string;
@@ -158,6 +175,7 @@ export declare class Dana4Client {
             execution_duration?: number | null;
             id: string;
             journey_id: string;
+            number?: number | null;
             order: number;
             params?: {
                 [key: string]: unknown;
@@ -169,6 +187,9 @@ export declare class Dana4Client {
             step_id: string;
             step_type: components["schemas"]["JourneyStepType"];
             time: components["schemas"]["Timestamps"];
+            tool_calls?: {
+                [key: string]: unknown;
+            }[];
         }>;
         /** Start a one-step journey (e.g. `read_message`); answers its task id. */
         start: (body: {
@@ -289,9 +310,11 @@ export declare class Dana4Client {
             direct?: boolean;
             document_id?: string | null;
             intent?: string | null;
+            memory?: string | null;
             messages: components["schemas"]["Message"][];
             parent_channel_id?: string | null;
             plan?: string | null;
+            tickets?: components["schemas"]["TicketSummary"][];
             topics: components["schemas"]["TopicSummary"][];
         }[]>;
         create: (body: S["CreateDocumentPayload"]) => Promise<string>;
@@ -311,9 +334,11 @@ export declare class Dana4Client {
             direct?: boolean;
             document_id?: string | null;
             intent?: string | null;
+            memory?: string | null;
             messages: components["schemas"]["Message"][];
             parent_channel_id?: string | null;
             plan?: string | null;
+            tickets?: components["schemas"]["TicketSummary"][];
             topics: components["schemas"]["TopicSummary"][];
         }>;
         messages: (channelId: string, range?: {
@@ -324,9 +349,11 @@ export declare class Dana4Client {
             direct?: boolean;
             document_id?: string | null;
             intent?: string | null;
+            memory?: string | null;
             messages: components["schemas"]["Message"][];
             parent_channel_id?: string | null;
             plan?: string | null;
+            tickets?: components["schemas"]["TicketSummary"][];
             topics: components["schemas"]["TopicSummary"][];
         }>;
         send: (body: S["SendMessagePayload"]) => Promise<{
@@ -343,6 +370,7 @@ export declare class Dana4Client {
             document_id: string;
             id: string;
             intent?: string | null;
+            memory?: string | null;
             owners: string[];
             parent_channel_id?: string | null;
             parent_message_id?: string | null;
@@ -357,6 +385,22 @@ export declare class Dana4Client {
             document_id: string;
             id: string;
             intent?: string | null;
+            memory?: string | null;
+            owners: string[];
+            parent_channel_id?: string | null;
+            parent_message_id?: string | null;
+            plan?: string | null;
+            plan_completed: boolean;
+            private: boolean;
+            time: components["schemas"]["Timestamps"];
+            title: string;
+            workspace_id: string;
+        }>;
+        setMemory: (channelId: string, memory: string) => Promise<{
+            document_id: string;
+            id: string;
+            intent?: string | null;
+            memory?: string | null;
             owners: string[];
             parent_channel_id?: string | null;
             parent_message_id?: string | null;
@@ -371,6 +415,7 @@ export declare class Dana4Client {
             document_id: string;
             id: string;
             intent?: string | null;
+            memory?: string | null;
             owners: string[];
             parent_channel_id?: string | null;
             parent_message_id?: string | null;
@@ -385,6 +430,7 @@ export declare class Dana4Client {
             document_id: string;
             id: string;
             intent?: string | null;
+            memory?: string | null;
             owners: string[];
             parent_channel_id?: string | null;
             parent_message_id?: string | null;
@@ -469,6 +515,17 @@ export declare class Dana4Client {
         }>;
         delete: (automationId: string) => Promise<string>;
     };
+    readonly tickets: {
+        /** Put a ticket on the workspace's board. Tickets are referred to by their
+         * per-workspace number (`blocked_by: [12]` means #12). */
+        create: (body: CreateTicketBody) => Promise<{
+            blocked_by: number[];
+            number: number;
+            status: components["schemas"]["BoardStatus"];
+            title: string;
+            workspace_id: string;
+        }>;
+    };
     readonly workflows: {
         create: (body: CreateWorkflowPayload) => Promise<{
             definition: string;