@poncho-ai/harness 0.26.0 → 0.28.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.26.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.28.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
 > node scripts/embed-docs.js && tsup src/index.ts --format esm --dts
 
 [embed-docs] Generated poncho-docs.ts with 4 topics
@@ -8,8 +8,8 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js 276.38 KB
+ESM dist/index.js 284.05 KB
 ESM ⚡️ Build success in 147ms
 DTS Build start
-DTS ⚡️ Build success in 7090ms
-DTS dist/index.d.ts 28.59 KB
+DTS ⚡️ Build success in 7926ms
+DTS dist/index.d.ts 29.26 KB

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @poncho-ai/harness
 
+## 0.28.0
+
+### Minor Changes
+
+- [`c0ca56b`](https://github.com/cesr/poncho-ai/commit/c0ca56b54bb877d96ba8088537d6f1c7461d2a55) Thanks [@cesr](https://github.com/cesr)! - Add built-in `web_search` and `web_fetch` tools so agents can search the web and fetch page content without a browser or API keys. Remove the scaffolded `fetch-page` skill (superseded by `web_fetch`). Fix `browser_open` crash when agent projects have an older `@poncho-ai/browser` installed.
+
+## 0.27.0
+
+### Minor Changes
+
+- [#42](https://github.com/cesr/poncho-ai/pull/42) [`e58a984`](https://github.com/cesr/poncho-ai/commit/e58a984efaa673b649318102bbf735fb4c2f9172) Thanks [@cesr](https://github.com/cesr)! - Add continuation model and fire-and-forget subagents
+
+  **Continuation model**: Agents no longer send a synthetic `"Continue"` user message between steps. Instead, the harness injects a transient signal when needed, and the full internal message chain is preserved across continuations so the LLM never loses context. `RunInput` gains `disableSoftDeadline` and `RunResult` gains `continuationMessages`.
+
+  **Fire-and-forget subagents**: Subagents now run asynchronously in the background. `spawn_subagent` returns immediately with a subagent ID; results are delivered back to the parent conversation as a callback once the subagent completes. Subagents cannot spawn their own subagents. The web UI shows results in a collapsible disclosure and reconnects the live event stream automatically when the parent agent resumes.
+
+  **Bug fixes**:
+  - Fixed a race condition where concurrent runs on the same harness instance could assign a subagent or browser tab to the wrong parent conversation (shared `_currentRunConversationId` field replaced with per-run `ToolContext.conversationId`).
+  - Fixed Upstash KV store silently dropping large values by switching from URL-path encoding to request body format for `SET`/`SETEX` commands.
+  - Fixed empty assistant content blocks causing Anthropic `text content blocks must be non-empty` errors.
+
+  **Client**: Added `getConversationStatus()` and `waitForSubagents` option on `sendMessage()`.
+
+### Patch Changes
+
+- Updated dependencies [[`e58a984`](https://github.com/cesr/poncho-ai/commit/e58a984efaa673b649318102bbf735fb4c2f9172)]:
+  - @poncho-ai/sdk@1.6.0
+
 ## 0.26.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -123,6 +123,14 @@ interface StateStore {
     set(state: ConversationState): Promise<void>;
     delete(runId: string): Promise<void>;
 }
+interface PendingSubagentResult {
+    subagentId: string;
+    task: string;
+    status: "completed" | "error" | "stopped";
+    result?: _poncho_ai_sdk.RunResult;
+    error?: _poncho_ai_sdk.AgentFailure;
+    timestamp: number;
+}
 interface Conversation {
     conversationId: string;
     title: string;
@@ -161,6 +169,13 @@ interface Conversation {
         channelId: string;
         platformThreadId: string;
     };
+    pendingSubagentResults?: PendingSubagentResult[];
+    subagentCallbackCount?: number;
+    runningCallbackSince?: number;
+    lastActivityAt?: number;
+    /** Harness-internal message chain preserved across continuation runs.
+     *  Cleared when a run completes without continuation. */
+    _continuationMessages?: Message[];
     createdAt: number;
     updatedAt: number;
 }
@@ -172,6 +187,7 @@ interface ConversationStore {
     update(conversation: Conversation): Promise<void>;
     rename(conversationId: string, title: string): Promise<Conversation | undefined>;
     delete(conversationId: string): Promise<boolean>;
+    appendSubagentResult(conversationId: string, result: PendingSubagentResult): Promise<void>;
 }
 type StateProviderName = "local" | "memory" | "redis" | "upstash" | "dynamodb";
 interface StateConfig {
@@ -204,6 +220,7 @@ declare class InMemoryConversationStore implements ConversationStore {
     update(conversation: Conversation): Promise<void>;
     rename(conversationId: string, title: string): Promise<Conversation | undefined>;
     delete(conversationId: string): Promise<boolean>;
+    appendSubagentResult(conversationId: string, result: PendingSubagentResult): Promise<void>;
 }
 type ConversationSummary = {
     conversationId: string;
@@ -334,6 +351,8 @@ type BuiltInToolToggles = {
     todo_add?: boolean;
     todo_update?: boolean;
     todo_remove?: boolean;
+    web_search?: boolean;
+    web_fetch?: boolean;
 };
 interface MessagingChannelConfig {
     platform: "slack" | "resend" | "telegram";
@@ -530,13 +549,16 @@ interface SubagentSummary {
     status: string;
     messageCount: number;
 }
+interface SubagentSpawnResult {
+    subagentId: string;
+}
 interface SubagentManager {
     spawn(opts: {
         task: string;
         parentConversationId: string;
         ownerId: string;
-    }): Promise<SubagentResult>;
-    sendMessage(subagentId: string, message: string): Promise<SubagentResult>;
+    }): Promise<SubagentSpawnResult>;
+    sendMessage(subagentId: string, message: string): Promise<SubagentSpawnResult>;
     stop(subagentId: string): Promise<void>;
     list(parentConversationId: string): Promise<SubagentSummary[]>;
 }
@@ -653,10 +675,6 @@ declare class AgentHarness {
     initialize(): Promise<void>;
     private buildBrowserStoragePersistence;
     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[];
@@ -722,6 +740,8 @@ declare class LatitudeCapture {
  */
 declare function jsonSchemaToZod(schema: JsonSchema): z.ZodType;
 
+declare const createSearchTools: () => ToolDefinition[];
+
 /**
  * Resolve the full list of skill directories to scan.
  * Merges the defaults with any extra paths provided via config.
@@ -795,6 +815,6 @@ declare class TelemetryEmitter {
     private sendOtlp;
 }
 
-declare const createSubagentTools: (manager: SubagentManager, getConversationId: () => string | undefined, getOwnerId: () => string) => ToolDefinition[];
+declare const createSubagentTools: (manager: SubagentManager) => ToolDefinition[];
 
-export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type BuiltInToolToggles, type CompactMessagesOptions, type CompactResult, type CompactionConfig, 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, compactMessages, createConversationStore, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryTools, createModelProvider, createSkillTools, createStateStore, createSubagentTools, createUploadStore, createWriteTool, deriveUploadKey, ensureAgentIdentity, estimateTokens, estimateTotalTokens, findSafeSplitPoint, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, ponchoDocsTool, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent };
+export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type BuiltInToolToggles, type CompactMessagesOptions, type CompactResult, type CompactionConfig, 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 PendingSubagentResult, 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 SubagentSpawnResult, type SubagentSummary, type TelemetryConfig, TelemetryEmitter, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VercelBlobUploadStore, buildAgentDirectoryName, buildSkillContextWindow, compactMessages, createConversationStore, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryTools, createModelProvider, createSearchTools, createSkillTools, createStateStore, createSubagentTools, createUploadStore, createWriteTool, deriveUploadKey, ensureAgentIdentity, estimateTokens, estimateTotalTokens, findSafeSplitPoint, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, ponchoDocsTool, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent };