@dana4/sdk 0.1.0 → 0.5.0

package/dist/client.js

@@ -57,9 +57,13 @@ export class Dana4Client {
         active: () => this.request("GET", "/tasks/active"),
         assigned: () => this.request("GET", "/tasks/assigned"),
         unassigned: () => this.request("GET", "/tasks/unassigned"),
-        claim: (taskId, capability) => this.request("POST", `/tasks/${taskId}/claim`, { body: { capability } }),
+        claim: (taskId, capability) => this.request("POST", `/tasks/${taskId}/claim`, {
+            body: { capability },
+        }),
         /** Start a one-step journey (e.g. `read_message`); answers its task id. */
-        start: (body) => this.request("POST", "/tasks", { body: { params: null, ...body } }),
+        start: (body) => this.request("POST", "/tasks", {
+            body: { params: null, ...body },
+        }),
         update: (taskId, body) => this.request("PATCH", `/tasks/${taskId}`, { body }),
         /** Workspace params merged with the journey's params. */
         params: (taskId) => this.request("GET", `/tasks/${taskId}/params`),
@@ -73,23 +77,40 @@ export class Dana4Client {
         source: (documentId) => this.request("GET", `/documents/${documentId}/source`),
         search: (workspaceId, q, limit) => this.request("GET", `/workspaces/${workspaceId}/documents/search`, { query: { q, limit } }),
         /** Every thread on a document; the root discussion has no `parent_channel_id`. */
-        messages: (documentId, range = {}) => this.request("GET", `/documents/${documentId}/messages`, { query: range }),
+        messages: (documentId, range = {}) => this.request("GET", `/documents/${documentId}/messages`, {
+            query: range,
+        }),
         create: (body) => this.request("POST", "/documents", { body }),
         replace: (body) => this.request("POST", "/documents/replace", { body }),
         append: (body) => this.request("POST", "/documents/append", { body }),
-        edit: (body) => this.request("POST", "/documents/edit", { body }),
-        presence: (documentId, activity) => this.request("PUT", `/documents/${documentId}/presence`, { body: { activity } }),
+        edit: (body) => this.request("POST", "/documents/edit", {
+            body,
+        }),
+        presence: (documentId, activity) => this.request("PUT", `/documents/${documentId}/presence`, {
+            body: { activity },
+        }),
     };
     chat = {
         /** The next channel with unread messages for this agent. Marks them read:
          * delivery is at-most-once. `channel_id` is "" when there is nothing. */
         take: () => this.request("POST", "/chats/take"),
-        messages: (channelId, range = {}) => this.request("GET", `/channels/${channelId}/messages`, { query: range }),
+        messages: (channelId, range = {}) => this.request("GET", `/channels/${channelId}/messages`, {
+            query: range,
+        }),
         send: (body) => this.request("POST", "/messages", { body }),
         privateChannels: (workspaceId) => this.request("GET", `/workspaces/${workspaceId}/private-channels`),
-        setPlan: (channelId, plan) => this.request("PUT", `/channels/${channelId}/plan`, { body: { plan } }),
-        completePlanItem: (channelId, item) => this.request("POST", `/channels/${channelId}/plan/complete`, { body: { item } }),
-        addPlanItem: (channelId, item) => this.request("POST", `/channels/${channelId}/plan/items`, { body: { item } }),
+        setPlan: (channelId, plan) => this.request("PUT", `/channels/${channelId}/plan`, {
+            body: { plan },
+        }),
+        setMemory: (channelId, memory) => this.request("PUT", `/channels/${channelId}/memory`, {
+            body: { memory },
+        }),
+        completePlanItem: (channelId, item) => this.request("POST", `/channels/${channelId}/plan/complete`, {
+            body: { item },
+        }),
+        addPlanItem: (channelId, item) => this.request("POST", `/channels/${channelId}/plan/items`, {
+            body: { item },
+        }),
     };
     workspaces = {
         list: () => this.request("GET", "/workspaces"),
@@ -104,6 +125,11 @@ export class Dana4Client {
         create: (body) => this.request("POST", "/automations", { body }),
         delete: (automationId) => this.request("DELETE", `/automations/${automationId}`),
     };
+    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) => this.request("POST", "/tickets", { body }),
+    };
     workflows = {
         create: (body) => this.request("POST", "/workflows", { body }),
     };
@@ -117,7 +143,9 @@ export class Dana4Client {
             const put = await this.#fetch(url, { method: "PUT", body: data });
             if (!put.ok)
                 throw new Dana4Error(put.status, await put.text(), "asset upload");
-            const assetId = await this.request("POST", "/assets", { body: { task_id: taskId, key } });
+            const assetId = await this.request("POST", "/assets", {
+                body: { task_id: taskId, key },
+            });
             return { key, assetId, url: `dana4-asset://${key}` };
         },
     };

package/dist/cloudflare.js

@@ -21,17 +21,24 @@ export class Dana4Agent extends Agent {
     pollInterval = 5;
     #runtime;
     get runtime() {
-        this.#runtime ??= new AgentRuntime(this.agent, new Dana4Client({ apiKey: this.env.DANA4_API_KEY, url: this.env.DANA4_URL }));
+        this.#runtime ??= new AgentRuntime(this.agent, new Dana4Client({
+            apiKey: this.env.DANA4_API_KEY,
+            url: this.env.DANA4_URL,
+        }));
         return this.#runtime;
     }
     async onStart() {
         // Idempotent: one schedule however often the object wakes.
         await this.scheduleEvery(this.pollInterval, "poll");
-        await this.runtime.register().catch((e) => console.error("dana4: register failed:", e));
+        await this.runtime
+            .register()
+            .catch((e) => console.error("dana4: register failed:", e));
         // A fresh instance runs no tasks yet, so any still active were stranded by
         // an eviction, e.g. between `tasks/take` and their fiber's first stash.
         // Fibers recovered just before this already re-queued theirs (idempotent).
-        await this.runtime.requeueActive().catch((e) => console.error("dana4: re-queuing failed:", e));
+        await this.runtime
+            .requeueActive()
+            .catch((e) => console.error("dana4: re-queuing failed:", e));
     }
     /** One round: take work, run each item in its own fiber. Overlapping rounds
      * are skipped by the scheduler, and fibers aren't awaited, so a long task

package/dist/enroll.js

@@ -1,16 +1,25 @@
-import { DEFAULT_URL, Dana4Error } from "./client.js";
+import { Dana4Error, DEFAULT_URL } from "./client.js";
 /** Get an API key for a new agent through the device flow. `onLink` gets the
  * link (and code) for a person to open; once they sign in and approve, the
  * agent exists, owned by them, in the workspaces they picked, and this answers
  * its key. The key is shown once: store it (e.g. as `DANA4_API_KEY`). */
 export async function enroll(opts) {
     const base = `${(opts.url ?? DEFAULT_URL).replace(/\/+$/, "")}/api-sdk/v1/agents/enroll`;
-    const post = (path, body) => fetch(base + path, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body) });
-    const r = await post("", { username: opts.username, bio: opts.bio, description: opts.description });
+    const post = (path, body) => fetch(base + path, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    const r = await post("", {
+        username: opts.username,
+        bio: opts.bio,
+        description: opts.description,
+    });
     if (!r.ok)
         throw new Dana4Error(r.status, await r.text(), "enroll");
     const start = (await r.json());
-    (opts.onLink ?? ((link, code) => console.log(`To connect @${opts.username}, open\n\n  ${link}\n\nand check the code ${code}. Waiting for approval...`)))(start.verification_uri_complete, start.user_code);
+    (opts.onLink ??
+        ((link, code) => console.log(`To connect @${opts.username}, open\n\n  ${link}\n\nand check the code ${code}. Waiting for approval...`)))(start.verification_uri_complete, start.user_code);
     const deadline = Date.now() + start.expires_in * 1000;
     while (Date.now() < deadline) {
         await new Promise((resolve) => setTimeout(resolve, start.interval * 1000));

package/dist/run.js

@@ -1,6 +1,7 @@
 import { AgentRuntime } from "./agent.js";
 import { Dana4Client } from "./client.js";
-const env = (name) => globalThis.process?.env[name];
+const env = (name) => globalThis
+    .process?.env[name];
 /** Run an agent as a long-lived process (Node, Bun, Deno): register, re-queue
  * tasks a previous crash left open, then poll every `interval` seconds until
  * `signal` aborts. Work runs concurrently, so a long task never delays chat.
@@ -8,7 +9,11 @@ const env = (name) => globalThis.process?.env[name];
  * `apiKey` and `url` default to `DANA4_API_KEY` and `DANA4_URL`. */
 export async function run(agent, opts = {}) {
     const { interval = 5, signal, log = console, ...client } = opts;
-    const rt = new AgentRuntime(agent, new Dana4Client({ apiKey: client.apiKey ?? env("DANA4_API_KEY") ?? "", url: client.url ?? env("DANA4_URL"), fetch: client.fetch }), log);
+    const rt = new AgentRuntime(agent, new Dana4Client({
+        apiKey: client.apiKey ?? env("DANA4_API_KEY") ?? "",
+        url: client.url ?? env("DANA4_URL"),
+        fetch: client.fetch,
+    }), log);
     log.info(`dana4: connected as @${await rt.register()}`);
     await rt.requeueActive();
     while (!signal?.aborted) {