@poncho-ai/harness 0.16.1 → 0.18.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.16.1 build /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+> @poncho-ai/harness@0.18.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 187.36 KB
-ESM ⚡️ Build success in 91ms
+ESM dist/index.js 196.78 KB
+ESM ⚡️ Build success in 133ms
 DTS Build start
-DTS ⚡️ Build success in 3621ms
-DTS dist/index.d.ts 22.38 KB
+DTS ⚡️ Build success in 6813ms
+DTS dist/index.d.ts 24.01 KB

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # @poncho-ai/harness
 
+## 0.18.0
+
+### Minor Changes
+
+- [`cd6ccd7`](https://github.com/cesr/poncho-ai/commit/cd6ccd7846e16fbaf17167617666796320ec29ce) Thanks [@cesr](https://github.com/cesr)! - Add MCP custom headers support, tool:generating streaming feedback, and cross-owner subagent recovery
+  - **MCP custom headers**: `poncho mcp add --header "Name: value"` and `headers` config field let servers like Arcade receive extra HTTP headers alongside bearer auth.
+  - **tool:generating event**: the harness now emits `tool:generating` events when the model begins writing tool-call arguments, so the web UI shows real-time "preparing <tool>" feedback instead of appearing stuck during large tool calls.
+  - **Subagent recovery**: `list`/`listSummaries` accept optional `ownerId` so stale-subagent recovery on server restart scans across all owners.
+
+### Patch Changes
+
+- Updated dependencies [[`cd6ccd7`](https://github.com/cesr/poncho-ai/commit/cd6ccd7846e16fbaf17167617666796320ec29ce)]:
+  - @poncho-ai/sdk@1.3.0
+
+## 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

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;
@@ -183,6 +205,7 @@ interface RemoteMcpServerConfig {
         type: "bearer";
         tokenEnv?: string;
     };
+    headers?: Record<string, string>;
     timeoutMs?: number;
     reconnectAttempts?: number;
     reconnectDelayMs?: number;
@@ -400,6 +423,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 +503,7 @@ declare class AgentHarness {
     private _browserMod?;
     private parsedAgent?;
     private mcpBridge?;
+    private subagentManager?;
     private resolveToolAccess;
     private isToolEnabled;
     private registerIfMissing;
@@ -465,6 +513,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 +540,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 +567,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 +574,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 +679,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 };