@poncho-ai/harness 0.16.0 → 0.17.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.16.0 build /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+> @poncho-ai/harness@0.17.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
 > tsup src/index.ts --format esm --dts
 
 CLI Building entry: src/index.ts
@@ -7,8 +7,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js 185.71 KB
-ESM ⚡️ Build success in 140ms
+ESM dist/index.js 196.31 KB
+ESM ⚡️ Build success in 155ms
 DTS Build start
-DTS ⚡️ Build success in 7525ms
-DTS dist/index.d.ts 22.38 KB
+DTS ⚡️ Build success in 6569ms
+DTS dist/index.d.ts 23.97 KB

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @poncho-ai/harness
 
+## 0.17.0
+
+### Minor Changes
+
+- [#16](https://github.com/cesr/poncho-ai/pull/16) [`972577d`](https://github.com/cesr/poncho-ai/commit/972577d255ab43c2c56f3c3464042a8a617b7f9e) Thanks [@cesr](https://github.com/cesr)! - Add subagent support: agents can spawn recursive copies of themselves as independent sub-conversations with blocking tool calls, read-only memory, approval tunneling to the parent thread, and nested sidebar display in the web UI. Also adds ConversationStore.listSummaries() for fast sidebar loading without reading full conversation files from disk.
+
+### Patch Changes
+
+- Updated dependencies [[`972577d`](https://github.com/cesr/poncho-ai/commit/972577d255ab43c2c56f3c3464042a8a617b7f9e)]:
+  - @poncho-ai/sdk@1.2.0
+
+## 0.16.1
+
+### Patch Changes
+
+- [`7475da5`](https://github.com/cesr/poncho-ai/commit/7475da5c0c2399e79064a2622137c0eb2fb16871) Thanks [@cesr](https://github.com/cesr)! - Inject browser usage context into agent system prompt (auth flow, session persistence, tool selection guidance).
+
 ## 0.16.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { Message, ToolDefinition, ToolContext, RunInput, AgentEvent, RunResult, JsonSchema } from '@poncho-ai/sdk';
+import * as _poncho_ai_sdk from '@poncho-ai/sdk';
+import { Message, ToolDefinition, RunResult, AgentFailure, ToolContext, RunInput, AgentEvent, JsonSchema } from '@poncho-ai/sdk';
 export { ToolDefinition, defineTool } from '@poncho-ai/sdk';
 import { LanguageModel } from 'ai';
 import { z } from 'zod';
@@ -96,11 +97,21 @@ interface Conversation {
     }>;
     ownerId: string;
     tenantId: string | null;
+    contextTokens?: number;
+    contextWindow?: number;
+    parentConversationId?: string;
+    subagentMeta?: {
+        task: string;
+        status: "running" | "completed" | "error" | "stopped";
+        result?: _poncho_ai_sdk.RunResult;
+        error?: _poncho_ai_sdk.AgentFailure;
+    };
     createdAt: number;
     updatedAt: number;
 }
 interface ConversationStore {
     list(ownerId?: string): Promise<Conversation[]>;
+    listSummaries(ownerId?: string): Promise<ConversationSummary[]>;
     get(conversationId: string): Promise<Conversation | undefined>;
     create(ownerId?: string, title?: string): Promise<Conversation>;
     update(conversation: Conversation): Promise<void>;
@@ -132,12 +143,23 @@ declare class InMemoryConversationStore implements ConversationStore {
     private isExpired;
     private purgeExpired;
     list(ownerId?: string): Promise<Conversation[]>;
+    listSummaries(ownerId?: string): Promise<ConversationSummary[]>;
     get(conversationId: string): Promise<Conversation | undefined>;
     create(ownerId?: string, title?: string): Promise<Conversation>;
     update(conversation: Conversation): Promise<void>;
     rename(conversationId: string, title: string): Promise<Conversation | undefined>;
     delete(conversationId: string): Promise<boolean>;
 }
+type ConversationSummary = {
+    conversationId: string;
+    title: string;
+    updatedAt: number;
+    createdAt?: number;
+    ownerId: string;
+    parentConversationId?: string;
+    messageCount?: number;
+    hasPendingApprovals?: boolean;
+};
 declare const createStateStore: (config?: StateConfig, options?: {
     workingDir?: string;
     agentId?: string;
@@ -400,6 +422,30 @@ interface ProviderConfig {
  */
 declare const createModelProvider: (provider?: string, config?: ProviderConfig) => ModelProviderFactory;
 
+interface SubagentResult {
+    subagentId: string;
+    status: "completed" | "error" | "stopped";
+    latestMessages?: Message[];
+    result?: RunResult;
+    error?: AgentFailure;
+}
+interface SubagentSummary {
+    subagentId: string;
+    task: string;
+    status: string;
+    messageCount: number;
+}
+interface SubagentManager {
+    spawn(opts: {
+        task: string;
+        parentConversationId: string;
+        ownerId: string;
+    }): Promise<SubagentResult>;
+    sendMessage(subagentId: string, message: string): Promise<SubagentResult>;
+    stop(subagentId: string): Promise<void>;
+    list(parentConversationId: string): Promise<SubagentSummary[]>;
+}
+
 interface ToolCall {
     id: string;
     name: string;
@@ -456,6 +502,7 @@ declare class AgentHarness {
     private _browserMod?;
     private parsedAgent?;
     private mcpBridge?;
+    private subagentManager?;
     private resolveToolAccess;
     private isToolEnabled;
     private registerIfMissing;
@@ -465,6 +512,8 @@ declare class AgentHarness {
      * Tools disabled via `tools` config are skipped.
      */
     registerTools(tools: ToolDefinition[]): void;
+    unregisterTools(names: string[]): void;
+    setSubagentManager(manager: SubagentManager): void;
     private registerConfiguredBuiltInTools;
     private shouldEnableWriteTool;
     constructor(options?: HarnessOptions);
@@ -490,6 +539,8 @@ declare class AgentHarness {
     private initBrowserTools;
     /** Conversation ID of the currently executing run (set during run, cleared after). */
     private _currentRunConversationId?;
+    /** Owner ID of the currently executing run (used by subagent tools). */
+    private _currentRunOwnerId?;
     get browserSession(): unknown;
     shutdown(): Promise<void>;
     listTools(): ToolDefinition[];
@@ -515,16 +566,6 @@ declare class AgentHarness {
     runToCompletion(input: RunInput): Promise<HarnessRunOutput>;
 }
 
-/**
- * Latitude telemetry integration for Vercel AI SDK
- *
- * TODO: Implement proper Vercel AI SDK telemetry integration using:
- * - LatitudeTelemetry.capture() wrapper around streamText()
- * - experimental_telemetry: { isEnabled: true } in streamText() options
- *
- * This requires @latitude-data/telemetry package which has official
- * Vercel AI SDK support.
- */
 interface LatitudeCaptureConfig {
     apiKeyEnv?: string;
     projectIdEnv?: string;
@@ -532,8 +573,9 @@ interface LatitudeCaptureConfig {
     defaultPath?: string;
 }
 /**
- * Placeholder for Latitude telemetry integration
- * This will be properly implemented once Vercel AI SDK migration is complete
+ * Reads and validates Latitude telemetry configuration from environment
+ * variables. The actual telemetry capture is handled by LatitudeTelemetry
+ * from @latitude-data/telemetry in harness.ts (via runWithTelemetry).
  */
 declare class LatitudeCapture {
     private readonly apiKey?;
@@ -636,4 +678,6 @@ declare class TelemetryEmitter {
     private sendOtlp;
 }
 
-export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type BuiltInToolToggles, type Conversation, type ConversationState, type ConversationStore, type CronJobConfig, type HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryStateStore, LatitudeCapture, type LatitudeCaptureConfig, LocalMcpBridge, LocalUploadStore, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PonchoConfig, type ProviderConfig, type RemoteMcpServerConfig, type RuntimeRenderContext, S3UploadStore, STORAGE_SCHEMA_VERSION, type SkillContextEntry, type SkillMetadata, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type TelemetryConfig, TelemetryEmitter, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VercelBlobUploadStore, buildAgentDirectoryName, buildSkillContextWindow, createConversationStore, createDefaultTools, createMemoryStore, createMemoryTools, createModelProvider, createSkillTools, createStateStore, createUploadStore, createWriteTool, deriveUploadKey, ensureAgentIdentity, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent };
+declare const createSubagentTools: (manager: SubagentManager, getConversationId: () => string | undefined, getOwnerId: () => string) => ToolDefinition[];
+
+export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type BuiltInToolToggles, type Conversation, type ConversationState, type ConversationStore, type ConversationSummary, type CronJobConfig, type HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryStateStore, LatitudeCapture, type LatitudeCaptureConfig, LocalMcpBridge, LocalUploadStore, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PonchoConfig, type ProviderConfig, type RemoteMcpServerConfig, type RuntimeRenderContext, S3UploadStore, STORAGE_SCHEMA_VERSION, type SkillContextEntry, type SkillMetadata, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type SubagentManager, type SubagentResult, type SubagentSummary, type TelemetryConfig, TelemetryEmitter, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VercelBlobUploadStore, buildAgentDirectoryName, buildSkillContextWindow, createConversationStore, createDefaultTools, createMemoryStore, createMemoryTools, createModelProvider, createSkillTools, createStateStore, createSubagentTools, createUploadStore, createWriteTool, deriveUploadKey, ensureAgentIdentity, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent };

package/dist/index.js

@@ -466,7 +466,7 @@ var createWriteTool = (workingDir) => defineTool({
 
 // src/harness.ts
 import { randomUUID as randomUUID3 } from "crypto";
-import { getTextContent } from "@poncho-ai/sdk";
+import { getTextContent as getTextContent2 } from "@poncho-ai/sdk";
 
 // src/upload-store.ts
 import { createHash as createHash2 } from "crypto";
@@ -2447,6 +2447,138 @@ var extractRunnableFunction = (value) => {
   return void 0;
 };
 
+// src/subagent-tools.ts
+import { defineTool as defineTool4, getTextContent } from "@poncho-ai/sdk";
+var LAST_MESSAGES_TO_RETURN = 10;
+var summarizeResult = (r) => {
+  const summary = {
+    subagentId: r.subagentId,
+    status: r.status
+  };
+  if (r.result) {
+    summary.result = {
+      status: r.result.status,
+      response: r.result.response,
+      steps: r.result.steps,
+      duration: r.result.duration
+    };
+  }
+  if (r.error) {
+    summary.error = r.error;
+  }
+  if (r.latestMessages && r.latestMessages.length > 0) {
+    summary.latestMessages = r.latestMessages.slice(-LAST_MESSAGES_TO_RETURN).map((m) => ({
+      role: m.role,
+      content: getTextContent(m).slice(0, 2e3)
+    }));
+  }
+  return summary;
+};
+var createSubagentTools = (manager, getConversationId, getOwnerId) => [
+  defineTool4({
+    name: "spawn_subagent",
+    description: "Spawn a subagent to work on a task and wait for it to finish. The subagent is a full copy of yourself running in its own conversation context with access to the same tools (except memory writes). This call blocks until the subagent completes and returns its result.\n\nGuidelines:\n- Use subagents to parallelize work: call spawn_subagent multiple times in one response for independent sub-tasks -- they run concurrently.\n- Prefer doing work yourself for simple or quick tasks. Spawn subagents for substantial, self-contained work.\n- The subagent has no memory of your conversation -- write thorough, self-contained instructions in the task.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task: {
+          type: "string",
+          description: "Thorough, self-contained instructions for the subagent. Include all relevant context, goals, and constraints -- the subagent starts with zero prior conversation history."
+        }
+      },
+      required: ["task"],
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      const task = typeof input.task === "string" ? input.task : "";
+      if (!task.trim()) {
+        return { error: "task is required" };
+      }
+      const conversationId = getConversationId();
+      if (!conversationId) {
+        return { error: "no active conversation to spawn subagent from" };
+      }
+      const result = await manager.spawn({
+        task: task.trim(),
+        parentConversationId: conversationId,
+        ownerId: getOwnerId()
+      });
+      return summarizeResult(result);
+    }
+  }),
+  defineTool4({
+    name: "message_subagent",
+    description: "Send a follow-up message to a completed or stopped subagent and wait for it to finish. This restarts the subagent with the new message and blocks until it completes. Only works when the subagent is not currently running.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subagent_id: {
+          type: "string",
+          description: "The subagent ID (from spawn_subagent result or list_subagents)."
+        },
+        message: {
+          type: "string",
+          description: "The follow-up instructions or message to send."
+        }
+      },
+      required: ["subagent_id", "message"],
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      const subagentId = typeof input.subagent_id === "string" ? input.subagent_id : "";
+      const message = typeof input.message === "string" ? input.message : "";
+      if (!subagentId || !message.trim()) {
+        return { error: "subagent_id and message are required" };
+      }
+      const result = await manager.sendMessage(subagentId, message.trim());
+      return summarizeResult(result);
+    }
+  }),
+  defineTool4({
+    name: "stop_subagent",
+    description: "Stop a running subagent. The subagent's conversation is preserved but it will stop processing. Use this to cancel work that is no longer needed.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subagent_id: {
+          type: "string",
+          description: "The subagent ID (from spawn_subagent result or list_subagents)."
+        }
+      },
+      required: ["subagent_id"],
+      additionalProperties: false
+    },
+    handler: async (input) => {
+      const subagentId = typeof input.subagent_id === "string" ? input.subagent_id : "";
+      if (!subagentId) {
+        return { error: "subagent_id is required" };
+      }
+      await manager.stop(subagentId);
+      return { message: `Subagent "${subagentId}" has been stopped.` };
+    }
+  }),
+  defineTool4({
+    name: "list_subagents",
+    description: "List all subagents that have been spawned in this conversation. Returns each subagent's ID, original task, current status, and message count. Use this to look up subagent IDs before calling message_subagent or stop_subagent.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false
+    },
+    handler: async () => {
+      const conversationId = getConversationId();
+      if (!conversationId) {
+        return { error: "no active conversation" };
+      }
+      const subagents = await manager.list(conversationId);
+      if (subagents.length === 0) {
+        return { message: "No subagents have been spawned in this conversation." };
+      }
+      return { subagents };
+    }
+  })
+];
+
 // src/harness.ts
 import { LatitudeTelemetry } from "@latitude-data/telemetry";
 import { diag, DiagLogLevel } from "@opentelemetry/api";
@@ -2928,6 +3060,7 @@ var AgentHarness = class {
   _browserMod;
   parsedAgent;
   mcpBridge;
+  subagentManager;
   resolveToolAccess(toolName) {
     const tools = this.loadedConfig?.tools;
     if (!tools) return true;
@@ -2964,6 +3097,19 @@ var AgentHarness = class {
       this.dispatcher.register(tool);
     }
   }
+  unregisterTools(names) {
+    this.dispatcher.unregisterMany(names);
+  }
+  setSubagentManager(manager) {
+    this.subagentManager = manager;
+    this.dispatcher.registerMany(
+      createSubagentTools(
+        manager,
+        () => this._currentRunConversationId,
+        () => this._currentRunOwnerId ?? "anonymous"
+      )
+    );
+  }
   registerConfiguredBuiltInTools(config) {
     for (const tool of createDefaultTools(this.workingDir)) {
       if (this.isToolEnabled(tool.name)) {
@@ -3418,6 +3564,8 @@ var AgentHarness = class {
   }
   /** Conversation ID of the currently executing run (set during run, cleared after). */
   _currentRunConversationId;
+  /** Owner ID of the currently executing run (used by subagent tools). */
+  _currentRunOwnerId;
   get browserSession() {
     return this._browserSession;
   }
@@ -3515,6 +3663,10 @@ var AgentHarness = class {
     }
     await this.refreshSkillsIfChanged();
     this._currentRunConversationId = input.conversationId;
+    const ownerParam = input.parameters?.__ownerId;
+    if (typeof ownerParam === "string") {
+      this._currentRunOwnerId = ownerParam;
+    }
     const agent = this.parsedAgent;
     const runId = `run_${randomUUID3()}`;
     const start = now();
@@ -3538,9 +3690,29 @@ var AgentHarness = class {
     const developmentContext = this.environment === "development" ? `
 
 ${DEVELOPMENT_MODE_CONTEXT}` : "";
+    const browserContext = this._browserSession ? `
+
+## Browser Tools
+
+The user has a live browser viewport displayed alongside the conversation. They can see everything the browser shows in real time and interact with it directly (click, type, scroll, paste).
+
+### Authentication
+When a website requires authentication or credentials, do NOT ask the user to send them in the chat. Instead, navigate to the login page and let the user enter their credentials directly in the browser viewport. Wait for them to confirm they have logged in before continuing.
+
+### Session persistence
+Browser sessions (cookies, localStorage, login state) are automatically saved and restored across conversations. If the user logged into a website in a previous conversation, that session is likely still active. Try navigating directly to the authenticated page before asking the user to log in again.
+
+### Reading page content
+- Use \`browser_content\` to read the visible text on a page. This is fast and token-efficient.
+- Use \`browser_snapshot\` to get the accessibility tree with interactive element refs for clicking and typing.
+- Use \`browser_screenshot\` only when you need to see visual layout or images. Screenshots consume significantly more tokens.
+- The accessibility tree may be sparse on some pages. If \`browser_snapshot\` returns little or no content, fall back to \`browser_content\` or \`browser_screenshot\`.
+
+### Tabs and resources
+Each conversation gets its own browser tab sharing a single browser instance. Call \`browser_close\` when done to free the tab. If you don't close it, the tab stays open and the user can continue interacting with it.` : "";
     const promptWithSkills = this.skillContextWindow ? `${systemPrompt}${developmentContext}
 
-${this.skillContextWindow}` : `${systemPrompt}${developmentContext}`;
+${this.skillContextWindow}${browserContext}` : `${systemPrompt}${developmentContext}${browserContext}`;
     const mainMemory = this.memoryStore ? await this.memoryStore.getMainMemory() : void 0;
     const boundedMainMemory = mainMemory && mainMemory.content.length > 4e3 ? `${mainMemory.content.slice(0, 4e3)}
 ...[truncated]` : mainMemory?.content;
@@ -3695,7 +3867,7 @@ ${boundedMainMemory.trim()}` : "";
             if (rich && rich.length > 0) {
               return [{ role: "tool", content: rich }];
             }
-            const textContent = typeof msg.content === "string" ? msg.content : getTextContent(msg);
+            const textContent = typeof msg.content === "string" ? msg.content : getTextContent2(msg);
             try {
               const parsed = JSON.parse(textContent);
               if (!Array.isArray(parsed)) {
@@ -3745,7 +3917,7 @@ ${boundedMainMemory.trim()}` : "";
             }
           }
           if (msg.role === "assistant") {
-            const assistantText = typeof msg.content === "string" ? msg.content : getTextContent(msg);
+            const assistantText = typeof msg.content === "string" ? msg.content : getTextContent2(msg);
             try {
               const parsed = JSON.parse(assistantText);
               if (typeof parsed === "object" && parsed !== null) {
@@ -3784,7 +3956,7 @@ ${boundedMainMemory.trim()}` : "";
           if (msg.role === "system") {
             return [{
               role: "system",
-              content: typeof msg.content === "string" ? msg.content : getTextContent(msg)
+              content: typeof msg.content === "string" ? msg.content : getTextContent2(msg)
             }];
           }
           if (msg.role === "user") {
@@ -4054,7 +4226,8 @@ ${textContent}` };
           step,
           workingDir: this.workingDir,
           parameters: input.parameters ?? {},
-          abortSignal: input.abortSignal
+          abortSignal: input.abortSignal,
+          conversationId: input.conversationId
         };
         const toolResultsForModel = [];
         const richToolResults = [];
@@ -4159,11 +4332,14 @@ ${textContent}` };
             });
           } else {
             span?.end({ result: { value: result2.output ?? null, isError: false } });
+            const serialized = JSON.stringify(result2.output ?? null);
+            const outputTokenEstimate = Math.ceil(serialized.length / 4);
             yield pushEvent({
               type: "tool:completed",
               tool: result2.tool,
               output: result2.output,
-              duration: now() - batchStart
+              duration: now() - batchStart,
+              outputTokenEstimate
             });
             const { mediaItems, strippedOutput } = extractMediaFromToolOutput(result2.output);
             toolResultsForModel.push({
@@ -4521,6 +4697,19 @@ var InMemoryConversationStore = class {
     this.purgeExpired();
     return Array.from(this.conversations.values()).filter((conversation) => conversation.ownerId === ownerId).sort((a, b) => b.updatedAt - a.updatedAt);
   }
+  async listSummaries(ownerId = DEFAULT_OWNER) {
+    this.purgeExpired();
+    return Array.from(this.conversations.values()).filter((c) => c.ownerId === ownerId).sort((a, b) => b.updatedAt - a.updatedAt).map((c) => ({
+      conversationId: c.conversationId,
+      title: c.title,
+      updatedAt: c.updatedAt,
+      createdAt: c.createdAt,
+      ownerId: c.ownerId,
+      parentConversationId: c.parentConversationId,
+      messageCount: c.messages.length,
+      hasPendingApprovals: Array.isArray(c.pendingApprovals) && c.pendingApprovals.length > 0
+    }));
+  }
   async get(conversationId) {
     this.purgeExpired();
     return this.conversations.get(conversationId);
@@ -4622,8 +4811,12 @@ var FileConversationStore = class {
           conversationId: conversation.conversationId,
           title: conversation.title,
           updatedAt: conversation.updatedAt,
+          createdAt: conversation.createdAt,
           ownerId: conversation.ownerId,
-          fileName: entry.name
+          fileName: entry.name,
+          parentConversationId: conversation.parentConversationId,
+          messageCount: conversation.messages.length,
+          hasPendingApprovals: Array.isArray(conversation.pendingApprovals) && conversation.pendingApprovals.length > 0
         });
       }
     } catch {
@@ -4646,6 +4839,16 @@ var FileConversationStore = class {
       for (const conversation of parsed.conversations ?? []) {
         this.conversations.set(conversation.conversationId, conversation);
       }
+      let needsRebuild = false;
+      for (const entry of this.conversations.values()) {
+        if (entry.messageCount === void 0) {
+          needsRebuild = true;
+          break;
+        }
+      }
+      if (needsRebuild) {
+        await this.rebuildIndexFromFiles();
+      }
     } catch {
       await this.rebuildIndexFromFiles();
     }
@@ -4661,8 +4864,12 @@ var FileConversationStore = class {
         conversationId: conversation.conversationId,
         title: conversation.title,
         updatedAt: conversation.updatedAt,
+        createdAt: conversation.createdAt,
         ownerId: conversation.ownerId,
-        fileName
+        fileName,
+        parentConversationId: conversation.parentConversationId,
+        messageCount: conversation.messages.length,
+        hasPendingApprovals: Array.isArray(conversation.pendingApprovals) && conversation.pendingApprovals.length > 0
       });
       await this.writeIndex();
     });
@@ -4680,6 +4887,19 @@ var FileConversationStore = class {
     }
     return conversations;
   }
+  async listSummaries(ownerId = DEFAULT_OWNER) {
+    await this.ensureLoaded();
+    return Array.from(this.conversations.values()).filter((c) => c.ownerId === ownerId).sort((a, b) => b.updatedAt - a.updatedAt).map((c) => ({
+      conversationId: c.conversationId,
+      title: c.title,
+      updatedAt: c.updatedAt,
+      createdAt: c.createdAt,
+      ownerId: c.ownerId,
+      parentConversationId: c.parentConversationId,
+      messageCount: c.messageCount,
+      hasPendingApprovals: c.hasPendingApprovals
+    }));
+  }
   async get(conversationId) {
     await this.ensureLoaded();
     const summary = this.conversations.get(conversationId);
@@ -4914,6 +5134,30 @@ var KeyValueConversationStoreBase = class {
     }
     return conversations.sort((a, b) => b.updatedAt - a.updatedAt);
   }
+  async listSummaries(ownerId = DEFAULT_OWNER) {
+    const kv = await this.client();
+    if (!kv) {
+      return await this.memoryFallback.listSummaries(ownerId);
+    }
+    const ids = await this.getOwnerConversationIds(ownerId);
+    const summaries = [];
+    for (const id of ids) {
+      const meta = await this.getConversationMeta(id);
+      if (meta && meta.ownerId === ownerId) {
+        summaries.push({
+          conversationId: meta.conversationId,
+          title: meta.title,
+          updatedAt: meta.updatedAt,
+          createdAt: meta.createdAt,
+          ownerId: meta.ownerId,
+          parentConversationId: meta.parentConversationId,
+          messageCount: meta.messageCount,
+          hasPendingApprovals: meta.hasPendingApprovals
+        });
+      }
+    }
+    return summaries.sort((a, b) => b.updatedAt - a.updatedAt);
+  }
   async get(conversationId) {
     const kv = await this.client();
     if (!kv) {
@@ -4963,7 +5207,11 @@ var KeyValueConversationStoreBase = class {
         conversationId: nextConversation.conversationId,
         title: nextConversation.title,
         updatedAt: nextConversation.updatedAt,
-        ownerId: nextConversation.ownerId
+        createdAt: nextConversation.createdAt,
+        ownerId: nextConversation.ownerId,
+        parentConversationId: nextConversation.parentConversationId,
+        messageCount: nextConversation.messages.length,
+        hasPendingApprovals: Array.isArray(nextConversation.pendingApprovals) && nextConversation.pendingApprovals.length > 0
       }),
       this.ttl
     );
@@ -5429,7 +5677,7 @@ var TelemetryEmitter = class {
 };
 
 // src/index.ts
-import { defineTool as defineTool4 } from "@poncho-ai/sdk";
+import { defineTool as defineTool5 } from "@poncho-ai/sdk";
 export {
   AgentHarness,
   InMemoryConversationStore,
@@ -5452,9 +5700,10 @@ export {
   createModelProvider,
   createSkillTools,
   createStateStore,
+  createSubagentTools,
   createUploadStore,
   createWriteTool,
-  defineTool4 as defineTool,
+  defineTool5 as defineTool,
   deriveUploadKey,
   ensureAgentIdentity,
   generateAgentId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/harness",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Agent execution runtime - conversation loop, tool dispatch, streaming",
   "repository": {
     "type": "git",
@@ -31,7 +31,7 @@
     "redis": "^5.10.0",
     "yaml": "^2.4.0",
     "zod": "^3.22.0",
-    "@poncho-ai/sdk": "1.1.1"
+    "@poncho-ai/sdk": "1.2.0"
   },
   "devDependencies": {
     "@types/mustache": "^4.2.6",

package/src/harness.ts

@@ -29,6 +29,8 @@ import { addPromptCacheBreakpoints } from "./prompt-cache.js";
 import { jsonSchemaToZod } from "./schema-converter.js";
 import type { SkillMetadata } from "./skill-context.js";
 import { createSkillTools, normalizeScriptPolicyPath } from "./skill-tools.js";
+import { createSubagentTools } from "./subagent-tools.js";
+import type { SubagentManager } from "./subagent-manager.js";
 import { LatitudeTelemetry } from "@latitude-data/telemetry";
 import { diag, DiagLogLevel } from "@opentelemetry/api";
 import {
@@ -502,6 +504,7 @@ export class AgentHarness {
 
   private parsedAgent?: ParsedAgent;
   private mcpBridge?: LocalMcpBridge;
+  private subagentManager?: SubagentManager;
 
   private resolveToolAccess(toolName: string): ToolAccess {
     const tools = this.loadedConfig?.tools;
@@ -547,6 +550,21 @@ export class AgentHarness {
     }
   }
 
+  unregisterTools(names: string[]): void {
+    this.dispatcher.unregisterMany(names);
+  }
+
+  setSubagentManager(manager: SubagentManager): void {
+    this.subagentManager = manager;
+    this.dispatcher.registerMany(
+      createSubagentTools(
+        manager,
+        () => this._currentRunConversationId,
+        () => this._currentRunOwnerId ?? "anonymous",
+      ),
+    );
+  }
+
   private registerConfiguredBuiltInTools(config: PonchoConfig | undefined): void {
     for (const tool of createDefaultTools(this.workingDir)) {
       if (this.isToolEnabled(tool.name)) {
@@ -1060,6 +1078,8 @@ export class AgentHarness {
 
   /** Conversation ID of the currently executing run (set during run, cleared after). */
   private _currentRunConversationId?: string;
+  /** Owner ID of the currently executing run (used by subagent tools). */
+  private _currentRunOwnerId?: string;
 
   get browserSession(): unknown {
     return this._browserSession;
@@ -1180,8 +1200,12 @@ export class AgentHarness {
     }
     await this.refreshSkillsIfChanged();
 
-    // Track which conversation this run belongs to so browser tools resolve the right session
+    // Track which conversation/owner this run belongs to so browser & subagent tools resolve correctly
     this._currentRunConversationId = input.conversationId;
+    const ownerParam = input.parameters?.__ownerId;
+    if (typeof ownerParam === "string") {
+      this._currentRunOwnerId = ownerParam;
+    }
 
     const agent = this.parsedAgent as ParsedAgent;
     const runId = `run_${randomUUID()}`;
@@ -1210,9 +1234,29 @@ export class AgentHarness {
     });
     const developmentContext =
       this.environment === "development" ? `\n\n${DEVELOPMENT_MODE_CONTEXT}` : "";
+    const browserContext = this._browserSession
+      ? `\n\n## Browser Tools
+
+The user has a live browser viewport displayed alongside the conversation. They can see everything the browser shows in real time and interact with it directly (click, type, scroll, paste).
+
+### Authentication
+When a website requires authentication or credentials, do NOT ask the user to send them in the chat. Instead, navigate to the login page and let the user enter their credentials directly in the browser viewport. Wait for them to confirm they have logged in before continuing.
+
+### Session persistence
+Browser sessions (cookies, localStorage, login state) are automatically saved and restored across conversations. If the user logged into a website in a previous conversation, that session is likely still active. Try navigating directly to the authenticated page before asking the user to log in again.
+
+### Reading page content
+- Use \`browser_content\` to read the visible text on a page. This is fast and token-efficient.
+- Use \`browser_snapshot\` to get the accessibility tree with interactive element refs for clicking and typing.
+- Use \`browser_screenshot\` only when you need to see visual layout or images. Screenshots consume significantly more tokens.
+- The accessibility tree may be sparse on some pages. If \`browser_snapshot\` returns little or no content, fall back to \`browser_content\` or \`browser_screenshot\`.
+
+### Tabs and resources
+Each conversation gets its own browser tab sharing a single browser instance. Call \`browser_close\` when done to free the tab. If you don't close it, the tab stays open and the user can continue interacting with it.`
+      : "";
     const promptWithSkills = this.skillContextWindow
-      ? `${systemPrompt}${developmentContext}\n\n${this.skillContextWindow}`
-      : `${systemPrompt}${developmentContext}`;
+      ? `${systemPrompt}${developmentContext}\n\n${this.skillContextWindow}${browserContext}`
+      : `${systemPrompt}${developmentContext}${browserContext}`;
     const mainMemory = this.memoryStore
       ? await this.memoryStore.getMainMemory()
       : undefined;
@@ -1839,6 +1883,7 @@ ${boundedMainMemory.trim()}`
         workingDir: this.workingDir,
         parameters: input.parameters ?? {},
         abortSignal: input.abortSignal,
+        conversationId: input.conversationId,
       };
 
       const toolResultsForModel: Array<{
@@ -1975,11 +2020,14 @@ ${boundedMainMemory.trim()}`
           });
         } else {
           span?.end({ result: { value: result.output ?? null, isError: false } });
+          const serialized = JSON.stringify(result.output ?? null);
+          const outputTokenEstimate = Math.ceil(serialized.length / 4);
           yield pushEvent({
             type: "tool:completed",
             tool: result.tool,
             output: result.output,
             duration: now() - batchStart,
+            outputTokenEstimate,
           });
 
           const { mediaItems, strippedOutput } = extractMediaFromToolOutput(result.output);

package/src/index.ts

@@ -14,5 +14,7 @@ export * from "./state.js";
 export * from "./upload-store.js";
 export * from "./telemetry.js";
 export * from "./tool-dispatcher.js";
+export * from "./subagent-manager.js";
+export * from "./subagent-tools.js";
 export { defineTool } from "@poncho-ai/sdk";
 export type { ToolDefinition } from "@poncho-ai/sdk";

package/src/latitude-capture.ts

@@ -1,14 +1,3 @@
-/**
- * Latitude telemetry integration for Vercel AI SDK
- *
- * TODO: Implement proper Vercel AI SDK telemetry integration using:
- * - LatitudeTelemetry.capture() wrapper around streamText()
- * - experimental_telemetry: { isEnabled: true } in streamText() options
- *
- * This requires @latitude-data/telemetry package which has official
- * Vercel AI SDK support.
- */
-
 export interface LatitudeCaptureConfig {
   apiKeyEnv?: string;
   projectIdEnv?: string;
@@ -17,8 +6,9 @@ export interface LatitudeCaptureConfig {
 }
 
 /**
- * Placeholder for Latitude telemetry integration
- * This will be properly implemented once Vercel AI SDK migration is complete
+ * Reads and validates Latitude telemetry configuration from environment
+ * variables. The actual telemetry capture is handled by LatitudeTelemetry
+ * from @latitude-data/telemetry in harness.ts (via runWithTelemetry).
  */
 export class LatitudeCapture {
   private readonly apiKey?: string;

package/src/state.ts

@@ -38,12 +38,22 @@ export interface Conversation {
   }>;
   ownerId: string;
   tenantId: string | null;
+  contextTokens?: number;
+  contextWindow?: number;
+  parentConversationId?: string;
+  subagentMeta?: {
+    task: string;
+    status: "running" | "completed" | "error" | "stopped";
+    result?: import("@poncho-ai/sdk").RunResult;
+    error?: import("@poncho-ai/sdk").AgentFailure;
+  };
   createdAt: number;
   updatedAt: number;
 }
 
 export interface ConversationStore {
   list(ownerId?: string): Promise<Conversation[]>;
+  listSummaries(ownerId?: string): Promise<ConversationSummary[]>;
   get(conversationId: string): Promise<Conversation | undefined>;
   create(ownerId?: string, title?: string): Promise<Conversation>;
   update(conversation: Conversation): Promise<void>;
@@ -220,6 +230,23 @@ export class InMemoryConversationStore implements ConversationStore {
       .sort((a, b) => b.updatedAt - a.updatedAt);
   }
 
+  async listSummaries(ownerId = DEFAULT_OWNER): Promise<ConversationSummary[]> {
+    this.purgeExpired();
+    return Array.from(this.conversations.values())
+      .filter((c) => c.ownerId === ownerId)
+      .sort((a, b) => b.updatedAt - a.updatedAt)
+      .map((c) => ({
+        conversationId: c.conversationId,
+        title: c.title,
+        updatedAt: c.updatedAt,
+        createdAt: c.createdAt,
+        ownerId: c.ownerId,
+        parentConversationId: c.parentConversationId,
+        messageCount: c.messages.length,
+        hasPendingApprovals: Array.isArray(c.pendingApprovals) && c.pendingApprovals.length > 0,
+      }));
+  }
+
   async get(conversationId: string): Promise<Conversation | undefined> {
     this.purgeExpired();
     return this.conversations.get(conversationId);
@@ -266,14 +293,29 @@ export class InMemoryConversationStore implements ConversationStore {
   }
 }
 
+export type ConversationSummary = {
+  conversationId: string;
+  title: string;
+  updatedAt: number;
+  createdAt?: number;
+  ownerId: string;
+  parentConversationId?: string;
+  messageCount?: number;
+  hasPendingApprovals?: boolean;
+};
+
 type ConversationStoreFile = {
   schemaVersion: string;
   conversations: Array<{
     conversationId: string;
     title: string;
     updatedAt: number;
+    createdAt?: number;
     ownerId: string;
     fileName: string;
+    parentConversationId?: string;
+    messageCount?: number;
+    hasPendingApprovals?: boolean;
   }>;
 };
 
@@ -342,8 +384,12 @@ class FileConversationStore implements ConversationStore {
           conversationId: conversation.conversationId,
           title: conversation.title,
           updatedAt: conversation.updatedAt,
+          createdAt: conversation.createdAt,
           ownerId: conversation.ownerId,
           fileName: entry.name,
+          parentConversationId: conversation.parentConversationId,
+          messageCount: conversation.messages.length,
+          hasPendingApprovals: Array.isArray(conversation.pendingApprovals) && conversation.pendingApprovals.length > 0,
         });
       }
     } catch {
@@ -369,6 +415,17 @@ class FileConversationStore implements ConversationStore {
       for (const conversation of parsed.conversations ?? []) {
         this.conversations.set(conversation.conversationId, conversation);
       }
+      // Rebuild if any entry is from an older index format (missing messageCount)
+      let needsRebuild = false;
+      for (const entry of this.conversations.values()) {
+        if (entry.messageCount === undefined) {
+          needsRebuild = true;
+          break;
+        }
+      }
+      if (needsRebuild) {
+        await this.rebuildIndexFromFiles();
+      }
     } catch {
       await this.rebuildIndexFromFiles();
     }
@@ -385,8 +442,12 @@ class FileConversationStore implements ConversationStore {
         conversationId: conversation.conversationId,
         title: conversation.title,
         updatedAt: conversation.updatedAt,
+        createdAt: conversation.createdAt,
         ownerId: conversation.ownerId,
         fileName,
+        parentConversationId: conversation.parentConversationId,
+        messageCount: conversation.messages.length,
+        hasPendingApprovals: Array.isArray(conversation.pendingApprovals) && conversation.pendingApprovals.length > 0,
       });
       await this.writeIndex();
     });
@@ -408,6 +469,23 @@ class FileConversationStore implements ConversationStore {
     return conversations;
   }
 
+  async listSummaries(ownerId = DEFAULT_OWNER): Promise<ConversationSummary[]> {
+    await this.ensureLoaded();
+    return Array.from(this.conversations.values())
+      .filter((c) => c.ownerId === ownerId)
+      .sort((a, b) => b.updatedAt - a.updatedAt)
+      .map((c) => ({
+        conversationId: c.conversationId,
+        title: c.title,
+        updatedAt: c.updatedAt,
+        createdAt: c.createdAt,
+        ownerId: c.ownerId,
+        parentConversationId: c.parentConversationId,
+        messageCount: c.messageCount,
+        hasPendingApprovals: c.hasPendingApprovals,
+      }));
+  }
+
   async get(conversationId: string): Promise<Conversation | undefined> {
     await this.ensureLoaded();
     const summary = this.conversations.get(conversationId);
@@ -573,7 +651,11 @@ type ConversationMeta = {
   conversationId: string;
   title: string;
   updatedAt: number;
+  createdAt?: number;
   ownerId: string;
+  parentConversationId?: string;
+  messageCount?: number;
+  hasPendingApprovals?: boolean;
 };
 
 abstract class KeyValueConversationStoreBase implements ConversationStore {
@@ -690,6 +772,31 @@ abstract class KeyValueConversationStoreBase implements ConversationStore {
     return conversations.sort((a, b) => b.updatedAt - a.updatedAt);
   }
 
+  async listSummaries(ownerId = DEFAULT_OWNER): Promise<ConversationSummary[]> {
+    const kv = await this.client();
+    if (!kv) {
+      return await this.memoryFallback.listSummaries(ownerId);
+    }
+    const ids = await this.getOwnerConversationIds(ownerId);
+    const summaries: ConversationSummary[] = [];
+    for (const id of ids) {
+      const meta = await this.getConversationMeta(id);
+      if (meta && meta.ownerId === ownerId) {
+        summaries.push({
+          conversationId: meta.conversationId,
+          title: meta.title,
+          updatedAt: meta.updatedAt,
+          createdAt: meta.createdAt,
+          ownerId: meta.ownerId,
+          parentConversationId: meta.parentConversationId,
+          messageCount: meta.messageCount,
+          hasPendingApprovals: meta.hasPendingApprovals,
+        });
+      }
+    }
+    return summaries.sort((a, b) => b.updatedAt - a.updatedAt);
+  }
+
   async get(conversationId: string): Promise<Conversation | undefined> {
     const kv = await this.client();
     if (!kv) {
@@ -741,7 +848,11 @@ abstract class KeyValueConversationStoreBase implements ConversationStore {
         conversationId: nextConversation.conversationId,
         title: nextConversation.title,
         updatedAt: nextConversation.updatedAt,
+        createdAt: nextConversation.createdAt,
         ownerId: nextConversation.ownerId,
+        parentConversationId: nextConversation.parentConversationId,
+        messageCount: nextConversation.messages.length,
+        hasPendingApprovals: Array.isArray(nextConversation.pendingApprovals) && nextConversation.pendingApprovals.length > 0,
       } satisfies ConversationMeta),
       this.ttl,
     );

package/src/subagent-manager.ts

@@ -0,0 +1,30 @@
+import type { AgentFailure, Message, RunResult } from "@poncho-ai/sdk";
+
+export interface SubagentResult {
+  subagentId: string;
+  status: "completed" | "error" | "stopped";
+  latestMessages?: Message[];
+  result?: RunResult;
+  error?: AgentFailure;
+}
+
+export interface SubagentSummary {
+  subagentId: string;
+  task: string;
+  status: string;
+  messageCount: number;
+}
+
+export interface SubagentManager {
+  spawn(opts: {
+    task: string;
+    parentConversationId: string;
+    ownerId: string;
+  }): Promise<SubagentResult>;
+
+  sendMessage(subagentId: string, message: string): Promise<SubagentResult>;
+
+  stop(subagentId: string): Promise<void>;
+
+  list(parentConversationId: string): Promise<SubagentSummary[]>;
+}

package/src/subagent-tools.ts

@@ -0,0 +1,160 @@
+import { defineTool, type Message, type ToolDefinition, getTextContent } from "@poncho-ai/sdk";
+import type { SubagentManager, SubagentResult } from "./subagent-manager.js";
+
+const LAST_MESSAGES_TO_RETURN = 10;
+
+const summarizeResult = (r: SubagentResult): Record<string, unknown> => {
+  const summary: Record<string, unknown> = {
+    subagentId: r.subagentId,
+    status: r.status,
+  };
+  if (r.result) {
+    summary.result = {
+      status: r.result.status,
+      response: r.result.response,
+      steps: r.result.steps,
+      duration: r.result.duration,
+    };
+  }
+  if (r.error) {
+    summary.error = r.error;
+  }
+  if (r.latestMessages && r.latestMessages.length > 0) {
+    summary.latestMessages = r.latestMessages
+      .slice(-LAST_MESSAGES_TO_RETURN)
+      .map((m: Message) => ({
+        role: m.role,
+        content: getTextContent(m).slice(0, 2000),
+      }));
+  }
+  return summary;
+};
+
+export const createSubagentTools = (
+  manager: SubagentManager,
+  getConversationId: () => string | undefined,
+  getOwnerId: () => string,
+): ToolDefinition[] => [
+  defineTool({
+    name: "spawn_subagent",
+    description:
+      "Spawn a subagent to work on a task and wait for it to finish. The subagent is a full copy of " +
+      "yourself running in its own conversation context with access to the same tools (except memory writes). " +
+      "This call blocks until the subagent completes and returns its result.\n\n" +
+      "Guidelines:\n" +
+      "- Use subagents to parallelize work: call spawn_subagent multiple times in one response for independent sub-tasks -- they run concurrently.\n" +
+      "- Prefer doing work yourself for simple or quick tasks. Spawn subagents for substantial, self-contained work.\n" +
+      "- The subagent has no memory of your conversation -- write thorough, self-contained instructions in the task.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        task: {
+          type: "string",
+          description:
+            "Thorough, self-contained instructions for the subagent. Include all relevant context, " +
+            "goals, and constraints -- the subagent starts with zero prior conversation history.",
+        },
+      },
+      required: ["task"],
+      additionalProperties: false,
+    },
+    handler: async (input) => {
+      const task = typeof input.task === "string" ? input.task : "";
+      if (!task.trim()) {
+        return { error: "task is required" };
+      }
+      const conversationId = getConversationId();
+      if (!conversationId) {
+        return { error: "no active conversation to spawn subagent from" };
+      }
+      const result = await manager.spawn({
+        task: task.trim(),
+        parentConversationId: conversationId,
+        ownerId: getOwnerId(),
+      });
+      return summarizeResult(result);
+    },
+  }),
+
+  defineTool({
+    name: "message_subagent",
+    description:
+      "Send a follow-up message to a completed or stopped subagent and wait for it to finish. " +
+      "This restarts the subagent with the new message and blocks until it completes. " +
+      "Only works when the subagent is not currently running.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subagent_id: {
+          type: "string",
+          description: "The subagent ID (from spawn_subagent result or list_subagents).",
+        },
+        message: {
+          type: "string",
+          description: "The follow-up instructions or message to send.",
+        },
+      },
+      required: ["subagent_id", "message"],
+      additionalProperties: false,
+    },
+    handler: async (input) => {
+      const subagentId = typeof input.subagent_id === "string" ? input.subagent_id : "";
+      const message = typeof input.message === "string" ? input.message : "";
+      if (!subagentId || !message.trim()) {
+        return { error: "subagent_id and message are required" };
+      }
+      const result = await manager.sendMessage(subagentId, message.trim());
+      return summarizeResult(result);
+    },
+  }),
+
+  defineTool({
+    name: "stop_subagent",
+    description:
+      "Stop a running subagent. The subagent's conversation is preserved but it will stop processing. " +
+      "Use this to cancel work that is no longer needed.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        subagent_id: {
+          type: "string",
+          description: "The subagent ID (from spawn_subagent result or list_subagents).",
+        },
+      },
+      required: ["subagent_id"],
+      additionalProperties: false,
+    },
+    handler: async (input) => {
+      const subagentId = typeof input.subagent_id === "string" ? input.subagent_id : "";
+      if (!subagentId) {
+        return { error: "subagent_id is required" };
+      }
+      await manager.stop(subagentId);
+      return { message: `Subagent "${subagentId}" has been stopped.` };
+    },
+  }),
+
+  defineTool({
+    name: "list_subagents",
+    description:
+      "List all subagents that have been spawned in this conversation. Returns each subagent's ID, " +
+      "original task, current status, and message count. Use this to look up subagent IDs before " +
+      "calling message_subagent or stop_subagent.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+      additionalProperties: false,
+    },
+    handler: async () => {
+      const conversationId = getConversationId();
+      if (!conversationId) {
+        return { error: "no active conversation" };
+      }
+      const subagents = await manager.list(conversationId);
+      if (subagents.length === 0) {
+        return { message: "No subagents have been spawned in this conversation." };
+      }
+      return { subagents };
+    },
+  }),
+];

package/.turbo/turbo-lint.log

@@ -1,6 +0,0 @@
-
-> @poncho-ai/harness@0.11.2 lint /Users/cesar/Dev/latitude/poncho-ai/packages/harness
-> eslint src/
-
-sh: eslint: command not found
- ELIFECYCLE  Command failed.

package/.turbo/turbo-test.log

@@ -1,139 +0,0 @@
-
-> @poncho-ai/harness@0.14.2 test /Users/cesar/Dev/latitude/poncho-ai/packages/harness
-> vitest
-
-
- RUN  v1.6.1 /Users/cesar/Dev/latitude/poncho-ai/packages/harness
-
-[event] step:completed {"type":"step:completed","step":1,"duration":1}
- ✓ test/telemetry.test.ts  (3 tests) 3ms
-[event] step:started {"type":"step:started","step":2}
- ✓ test/schema-converter.test.ts  (27 tests) 16ms
-stdout | test/mcp.test.ts > mcp bridge protocol transports > discovers and calls tools over streamable HTTP
-[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
-
- ✓ test/agent-parser.test.ts  (10 tests) 17ms
- ✓ test/memory.test.ts  (4 tests) 16ms
-stdout | test/mcp.test.ts > mcp bridge protocol transports > selects discovered tools by requested patterns
-[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":2}
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":2,"filteredByPolicyCount":0,"filteredByIntentCount":0}
-
-stdout | test/mcp.test.ts > mcp bridge protocol transports > skips discovery when bearer token env value is missing
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":0,"filteredByPolicyCount":0,"filteredByIntentCount":0}
-
-stderr | test/mcp.test.ts > mcp bridge protocol transports > skips discovery when bearer token env value is missing
-[poncho][mcp] {"event":"auth.token_missing","server":"remote","tokenEnv":"MISSING_TOKEN_ENV"}
-
-stdout | test/mcp.test.ts > mcp bridge protocol transports > returns actionable errors for 403 permission failures
-[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
-
- ✓ test/mcp.test.ts  (6 tests) 97ms
- ✓ test/state.test.ts  (5 tests) 217ms
- ✓ test/agent-identity.test.ts  (2 tests) 15ms
- ✓ test/model-factory.test.ts  (4 tests) 3ms
-stdout | test/harness.test.ts > agent harness > registers default filesystem tools
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > disables write_file by default in production environment
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > allows disabling built-in tools via poncho.config.js
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > supports per-environment tool overrides
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > supports per-environment tool overrides
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > does not auto-register exported tool objects from skill scripts
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"activate:beta","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > prunes removed active skills after refresh in development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-[poncho][mcp] {"event":"tools.cleared","reason":"activate:obsolete","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > prunes removed active skills after refresh in development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > does not refresh skills outside development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > clears active skills when skill metadata changes in development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-[poncho][mcp] {"event":"tools.cleared","reason":"activate:alpha","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > clears active skills when skill metadata changes in development mode
-[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > lists skill scripts through list_skill_scripts
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > runs JavaScript/TypeScript skill scripts through run_skill_script
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > runs AGENT-scope scripts from root scripts directory
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > blocks path traversal in run_skill_script
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > requires allowed-tools entries for non-standard script directories
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > registers MCP tools dynamically for stacked active skills and supports deactivation
-[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":2}
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
-[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-a","requestedPatterns":["remote/a"],"registeredCount":1,"activeSkills":["skill-a"]}
-
-stdout | test/harness.test.ts > agent harness > registers MCP tools dynamically for stacked active skills and supports deactivation
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":2,"registeredCount":2,"filteredByPolicyCount":0,"filteredByIntentCount":0}
-[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-b","requestedPatterns":["remote/a","remote/b"],"registeredCount":2,"activeSkills":["skill-a","skill-b"]}
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
-[poncho][mcp] {"event":"tools.refreshed","reason":"deactivate:skill-a","requestedPatterns":["remote/b"],"registeredCount":1,"activeSkills":["skill-b"]}
-
-stdout | test/harness.test.ts > agent harness > supports flat tool access config format
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > flat tool access takes priority over legacy defaults
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > byEnvironment overrides flat tool access
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > registerTools skips tools disabled via config
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > approval access level registers the tool but marks it for approval
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > tools without approval config do not require approval
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-
-stdout | test/harness.test.ts > agent harness > allows in-flight MCP calls to finish after skill deactivation
-[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
-[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
-[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
-[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-slow","requestedPatterns":["remote/slow"],"registeredCount":1,"activeSkills":["skill-slow"]}
-[poncho][mcp] {"event":"tools.cleared","reason":"deactivate:skill-slow","requestedPatterns":[]}
-
- ✓ test/harness.test.ts  (25 tests) 365ms
-
- Test Files  9 passed (9)
-      Tests  86 passed (86)
-   Start at  13:30:36
-   Duration  2.19s (transform 1.11s, setup 0ms, collect 2.81s, tests 749ms, environment 5ms, prepare 1.23s)
-