pi-subagentura 1.0.9 → 1.0.12

package/helpers.ts

@@ -433,6 +433,11 @@ export async function startSubagentJob(
   }
 
   // Create session
+  debugLog("info", "session_creating", {
+    jobId,
+    model: modelLabel ?? "default",
+    cwd,
+  });
   const session = (
     await createAgentSession({
       sessionManager: SessionManager.inMemory(),
@@ -442,10 +447,15 @@ export async function startSubagentJob(
       cwd,
     })
   ).session;
+  debugLog("info", "session_created", {
+    jobId,
+    sessionModel: session.model ? `${session.model.provider}/${session.model.id}` : null,
+  });
 
   // Wire abort signal
   if (signal) {
     handleAbort = () => {
+      debugLog("warn", "job_abort", { jobId });
       session.abort().catch(() => {});
     };
     if (signal.aborted) {
@@ -462,10 +472,16 @@ export async function startSubagentJob(
         liveStatus.turn++;
         liveStatus.usage.turns = liveStatus.turn;
         liveStatus.output = "";
+        debugLog("info", "turn_start", { jobId, turn: liveStatus.turn });
         onUpdate?.(buildLiveUpdate(liveStatus, modelLabel));
         break;
       }
       case "tool_execution_start": {
+        debugLog("info", "tool_start", {
+          jobId,
+          toolName: event.toolName,
+          args: event.args as Record<string, unknown>,
+        });
         setActiveToolDebounced({
           name: event.toolName,
           args: event.args as Record<string, unknown>,
@@ -473,10 +489,17 @@ export async function startSubagentJob(
         break;
       }
       case "tool_execution_end": {
+        debugLog("info", "tool_end", { jobId, toolName: liveStatus.activeTool?.name });
         setActiveToolDebounced(undefined);
         break;
       }
       case "turn_end": {
+        debugLog("info", "turn_end", {
+          jobId,
+          turn: liveStatus.turn,
+          outputLength: liveStatus.output.length,
+          activeTool: liveStatus.activeTool?.name ?? null,
+        });
         if (activeToolTimer) {
           clearTimeout(activeToolTimer);
           activeToolTimer = undefined;
@@ -486,8 +509,20 @@ export async function startSubagentJob(
         break;
       }
       case "message_update": {
-        if (event.assistantMessageEvent.type === "text_delta") {
-          liveStatus.output += event.assistantMessageEvent.delta;
+        const evt = event.assistantMessageEvent;
+        debugLog("info", "message_update", {
+          jobId,
+          updateType: evt.type,
+          ...(evt.type === "text_delta" && {
+            delta: evt.delta.slice(0, 200),
+            outputLength: liveStatus.output.length,
+          }),
+          ...(evt.type === "thinking_delta" && { delta: evt.delta.slice(0, 200) }),
+          ...(evt.type === "toolcall_delta" && { partial: String(evt.partial).slice(0, 200) }),
+          ...(evt.type === "toolcall_end" && { toolCallId: evt.toolCall?.id }),
+        });
+        if (evt.type === "text_delta") {
+          liveStatus.output += evt.delta;
           onUpdate?.(buildLiveUpdate(liveStatus, modelLabel));
         }
         break;
@@ -501,18 +536,44 @@ export async function startSubagentJob(
     ? `${personaPrefix}You are a SEPARATE background sub-agent. Your ONLY job is the task below.\nThe conversation history above is CONTEXT ONLY — do NOT comment on it, do NOT role-play as the main assistant, do NOT describe the spawning process. Execute ONLY the task and return ONLY the result.\n\n## Conversation History (context only — do not respond to this)\n${contextText}\n\n## Your Task (respond ONLY to this)\n${task}`
     : `${personaPrefix}Task: ${task}`;
 
+  debugLog("info", "prompt_built", {
+    jobId,
+    hasContext: !!contextText,
+    contextLength: contextText?.length ?? 0,
+    taskLength: task.length,
+    persona: persona ?? null,
+    promptPreview: finalPrompt.slice(0, 500),
+  });
+
   // Launch the prompt in a promise chain (NOT awaited — returns immediately).
   // The jobPromise represents the full lifecycle: prompt → extraction → cleanup.
   const jobPromise = (async (): Promise<SubagentResult> => {
     let result: SubagentResult;
     try {
+      debugLog("info", "prompt_start", { jobId });
       await session.prompt(finalPrompt);
+      debugLog("info", "prompt_complete", { jobId });
 
       // Extract final assistant output
       const messages = session.agent.state.messages;
+      debugLog("info", "messages_extracted", {
+        jobId,
+        messageCount: messages.length,
+        messageRoles: messages.map((m) => m.role),
+        lastMessageContentType: typeof (messages[messages.length - 1] as any)?.content,
+        lastMessageContentIsArray: Array.isArray((messages[messages.length - 1] as any)?.content),
+      });
+
       let finalOutput = liveStatus.output;
       for (let i = messages.length - 1; i >= 0; i--) {
         const msg = messages[i];
+        debugLog("info", "message_check", {
+          jobId,
+          index: i,
+          role: msg.role,
+          contentType: typeof (msg as any).content,
+          contentIsArray: Array.isArray((msg as any).content),
+        });
         if (msg.role === "assistant") {
           const textParts = extractTextFromContent(msg.content);
           if (textParts) {
@@ -552,6 +613,13 @@ export async function startSubagentJob(
       };
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
+      const stack = err instanceof Error ? err.stack : undefined;
+      debugLog("error", "subagent_error", {
+        jobId,
+        error: msg,
+        stack: stack ?? null,
+        errorName: err instanceof Error ? err.name : typeof err,
+      });
       result = {
         output: `Sub-agent crashed: ${msg}`,
         usage: {
@@ -567,6 +635,14 @@ export async function startSubagentJob(
         errorMessage: msg,
       };
     } finally {
+      debugLog("info", "job_complete", {
+        jobId,
+        outputLength: result.output.length,
+        output: result.output.slice(0, 200),
+        isError: result.isError,
+        errorMessage: result.errorMessage ?? null,
+        usage: result.usage,
+      });
       if (activeToolTimer) {
         clearTimeout(activeToolTimer);
         activeToolTimer = undefined;
@@ -575,6 +651,7 @@ export async function startSubagentJob(
         signal.removeEventListener("abort", handleAbort);
       if (unsubscribe) unsubscribe();
       session?.dispose();
+      debugLog("info", "session_disposed", { jobId });
     }
     return result;
   })();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-subagentura",
-  "version": "1.0.9",
+  "version": "1.0.12",
   "description": "Public Pi package that adds in-process sub-agents via the SDK",
   "main": "subagent.ts",
   "type": "module",