@questionbase/deskfree 0.3.0-alpha.38 → 0.3.0-alpha.39

package/dist/index.js

@@ -4995,28 +4995,29 @@ function enqueuePoll(client, ctx, getCursor, setCursor, log, account, getWelcome
   });
   pollChains.set(accountId, next);
 }
-var SEED = "SEED";
 async function pollAndDeliver(client, ctx, cursor, log, account, alreadyWelcomed) {
   try {
-    const isFirstRun = !cursor || cursor === SEED;
-    const apiCursor = cursor && cursor !== SEED ? cursor : void 0;
+    const isFirstRun = !cursor;
     const response = await client.listMessages({
-      ...apiCursor ? { cursor: apiCursor } : {}
+      ...cursor ? { cursor } : {}
     });
     if (isFirstRun) {
+      const seedCursor = response.cursor ?? (/* @__PURE__ */ new Date()).toISOString();
       if (response.cursor) {
         log.info(
           `First run: skipping ${response.items.length} existing message(s), seeding cursor.`
         );
-        saveCursor(ctx, response.cursor, log);
       } else {
-        log.info("First run: no messages yet (empty inbox).");
+        log.info(
+          "First run: no messages yet (empty inbox), seeding cursor with current time."
+        );
       }
+      saveCursor(ctx, seedCursor, log);
       log.info("Connected to DeskFree. Ready to receive messages and tasks.");
       if (alreadyWelcomed) {
         log.info("Welcome already sent, skipping duplicate.");
         return {
-          cursor: response.cursor ?? SEED,
+          cursor: seedCursor,
           ok: true,
           welcomeSent: false
         };
@@ -5028,7 +5029,7 @@ async function pollAndDeliver(client, ctx, cursor, log, account, alreadyWelcomed
         const welcomeMessage = {
           messageId: `welcome-${Date.now()}`,
           botId: "",
-          humanId: "system",
+          humanId: account?.userId ?? ctx.account.userId,
           authorType: "user",
           content: welcomeContent,
           createdAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -5040,7 +5041,7 @@ async function pollAndDeliver(client, ctx, cursor, log, account, alreadyWelcomed
         const msg = err instanceof Error ? err.message : String(err);
         log.warn(`Failed to send welcome message: ${msg}`);
       }
-      return { cursor: response.cursor ?? SEED, ok: true, welcomeSent: true };
+      return { cursor: seedCursor, ok: true, welcomeSent: true };
     }
     if (response.items.length === 0) return { cursor: null, ok: true };
     const newItems = response.items.filter(
@@ -5348,9 +5349,11 @@ async function runWebSocketConnection(opts) {
       try {
         const raw = data.toString();
         if (!raw || raw.length > 65536) {
-          log.warn(
-            `Ignoring oversized or empty WS message (${raw?.length ?? 0} bytes)`
-          );
+          if (raw && raw.length > 65536) {
+            log.warn(`Ignoring oversized WS message (${raw.length} bytes)`);
+          } else {
+            log.debug(`Ignoring empty WS frame (${raw?.length ?? 0} bytes)`);
+          }
           return;
         }
         const msg = JSON.parse(raw);
@@ -8206,7 +8209,7 @@ var ORCHESTRATOR_TOOLS = {
           }),
           instructions: Type.Optional(
             Type.String({
-              description: "Concise instructions in simple markdown (bold, lists, inline code \u2014 no # headers). Brief a contractor: what to do, what done looks like. Skip obvious context."
+              description: "3-8 bullet points max in simple markdown (bold, lists, inline code \u2014 no # headers). What to do, what done looks like, key constraints. Under 500 words. Skip context the worker can infer from the title."
             })
           ),
           file: Type.Optional(
@@ -8293,11 +8296,11 @@ var SHARED_TOOLS = {
         Type.Object(
           {
             reasoning: Type.String({
-              description: "Why these updates matter \u2014 what was learned from this task"
+              description: "1-2 sentences: what changed and why. No restating known context."
             }),
             globalWoW: Type.Optional(
               Type.String({
-                description: "Full updated global Ways of Working markdown content (full replacement, not diff)"
+                description: "Updated global Ways of Working (full replacement). Keep surgical \u2014 only add or modify relevant sections, do not inflate with restated context."
               })
             ),
             initiativeId: Type.Optional(
@@ -8307,7 +8310,7 @@ var SHARED_TOOLS = {
             ),
             initiativeContent: Type.Optional(
               Type.String({
-                description: "Full updated initiative content markdown (full replacement, not diff)"
+                description: "Updated initiative content (full replacement). Keep surgical \u2014 evolve what exists, do not rewrite from scratch."
               })
             )
           },
@@ -8324,7 +8327,7 @@ var SHARED_TOOLS = {
             }),
             instructions: Type.Optional(
               Type.String({
-                description: "Instructions for the follow-up task"
+                description: "Brief handoff: 2-3 bullet points max. The next worker gets parent task context."
               })
             )
           }),
@@ -8394,7 +8397,7 @@ var SHARED_TOOLS = {
           }),
           instructions: Type.Optional(
             Type.String({
-              description: "Concise instructions in simple markdown (bold, lists, inline code \u2014 no # headers). Brief a contractor: what to do, what done looks like. Skip obvious context."
+              description: "3-8 bullet points max in simple markdown (bold, lists, inline code \u2014 no # headers). What to do, what done looks like, key constraints. Under 500 words. Skip context the worker can infer from the title."
             })
           ),
           file: Type.Optional(
@@ -8935,7 +8938,7 @@ You are the orchestrator. Your job: turn human intent into approved tasks, then
 
 You do NOT claim tasks, complete tasks, or do work directly \u2014 you have no access to deskfree_start_task or deskfree_complete_task. Spawn a sub-agent for each approved task and pass it the taskId.
 - When a human writes in a task thread, decide: does it need bot action? If yes \u2192 reopen and spawn sub-agent. If it's just confirmation or deferred \u2014 leave it for now.
-- Write task instructions as rich markdown (bold, lists, inline code \u2014 no # headers). Brief a contractor who has never seen the codebase.
+- Write task instructions as 3-8 bullet points max (bold, lists, inline code \u2014 no # headers). What to do, what done looks like, key constraints. Under 500 words \u2014 brief a contractor, not write a spec.
 - Estimate token cost per task \u2014 consider files to read, reasoning, output.
 - One initiative per proposal \u2014 make multiple calls for multiple initiatives.
 - Initiative titles should reflect aspirations and outcomes, not activities. "AI Thought Leadership on LinkedIn" over "LinkedIn Content."
@@ -8944,10 +8947,10 @@ var DESKFREE_WORKER_DIRECTIVE = `## DeskFree Worker
 You are a worker sub-agent. Call \`deskfree_start_task\` with your taskId to claim and load context.
 Tools: deskfree_start_task, deskfree_update_file, deskfree_complete_task, deskfree_send_message, deskfree_propose.
 - Claim your task first with deskfree_start_task \u2014 this loads instructions, messages, and file context.
-- Save work to linked files with deskfree_update_file (incrementally).
+- Save work to linked files with deskfree_update_file. Build up incrementally \u2014 start with structure/outline, then flesh out. Send an "ask" for review before going deep. The human should see the shape before the details.
 - Use deskfree_send_message with type "notify" for progress updates \u2014 what you're doing, what you found. Keep it brief.
 - Use deskfree_send_message with type "ask" when you need human input OR when your work is done for review. This surfaces to the main thread. Terminate after sending an ask.
-- When completing: pass "learnings" to deskfree_complete_task if you have knowledge updates (WoW or initiative content). Pass "followUps" if the work revealed clear next steps. Knowledge updates and proposals happen atomically with completion \u2014 no separate tool calls needed.
+- When completing: pass "learnings" only if you have genuine new knowledge. WoW updates should be surgical \u2014 add or modify only the relevant section, do not restate existing content. Reasoning should be 1-2 sentences. Pass "followUps" as brief handoffs (title + 2-3 bullets each).
 - Only complete when the human has confirmed or no review is needed.
 - Write like a senior colleague giving a status update \u2014 not a report. 1-3 sentences for messages.
 - On 409 or 404 errors: STOP. Do not retry the same taskId. Call deskfree_state to find available tasks.`;