@poncho-ai/harness 0.14.1 → 0.15.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.14.1 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.15.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 175.01 KB
-ESM ⚡️ Build success in 76ms
+ESM dist/index.js 182.55 KB
+ESM ⚡️ Build success in 144ms
 DTS Build start
-DTS ⚡️ Build success in 5663ms
-DTS dist/index.d.ts 21.38 KB
+DTS ⚡️ Build success in 6528ms
+DTS dist/index.d.ts 22.34 KB

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @poncho-ai/harness
 
+## 0.15.0
+
+### Minor Changes
+
+- [`139ed89`](https://github.com/cesr/poncho-ai/commit/139ed89a5df2372cfb0a124c967f51f4d8158c3b) Thanks [@cesr](https://github.com/cesr)! - Add browser automation for Poncho agents with real-time viewport streaming, per-conversation tab management, interactive browser control in the web UI, and shared agent-level profiles for authentication persistence.
+
+### Patch Changes
+
+- Updated dependencies [[`139ed89`](https://github.com/cesr/poncho-ai/commit/139ed89a5df2372cfb0a124c967f51f4d8158c3b)]:
+  - @poncho-ai/sdk@1.1.0
+
+## 0.14.2
+
+### Patch Changes
+
+- [`1f47bb4`](https://github.com/cesr/poncho-ai/commit/1f47bb49e5d48dc17644172012b057190b316469) Thanks [@cesr](https://github.com/cesr)! - Add conversation rename via double-click on the title in the web UI, standardize all credential config fields to the `*Env` naming pattern, and sync the init README template with the repo README.
+
+- Updated dependencies [[`1f47bb4`](https://github.com/cesr/poncho-ai/commit/1f47bb49e5d48dc17644172012b057190b316469)]:
+  - @poncho-ai/sdk@1.0.3
+
 ## 0.14.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -111,8 +111,8 @@ type StateProviderName = "local" | "memory" | "redis" | "upstash" | "dynamodb";
 interface StateConfig {
     provider?: StateProviderName;
     ttl?: number;
-    url?: string;
-    token?: string;
+    urlEnv?: string;
+    tokenEnv?: string;
     table?: string;
     region?: string;
 }
@@ -154,8 +154,8 @@ interface MainMemory {
 interface MemoryConfig {
     enabled?: boolean;
     provider?: StateProviderName;
-    url?: string;
-    token?: string;
+    urlEnv?: string;
+    tokenEnv?: string;
     table?: string;
     region?: string;
     ttl?: number;
@@ -218,8 +218,8 @@ declare class LocalMcpBridge {
 
 interface StorageConfig {
     provider?: "local" | "memory" | "redis" | "upstash" | "dynamodb";
-    url?: string;
-    token?: string;
+    urlEnv?: string;
+    tokenEnv?: string;
     table?: string;
     region?: string;
     ttl?: number | {
@@ -274,6 +274,7 @@ interface PonchoConfig extends McpConfig {
         required?: boolean;
         type?: "bearer" | "header" | "custom";
         headerName?: string;
+        tokenEnv?: string;
         validate?: (token: string, req?: unknown) => Promise<boolean> | boolean;
     };
     state?: {
@@ -283,12 +284,20 @@ interface PonchoConfig extends McpConfig {
     };
     memory?: MemoryConfig;
     storage?: StorageConfig;
+    providers?: {
+        openai?: {
+            apiKeyEnv?: string;
+        };
+        anthropic?: {
+            apiKeyEnv?: string;
+        };
+    };
     telemetry?: {
         enabled?: boolean;
         otlp?: string;
         latitude?: {
-            apiKey?: string;
-            projectId?: string | number;
+            apiKeyEnv?: string;
+            projectIdEnv?: string;
             path?: string;
             documentPath?: string;
         };
@@ -307,6 +316,19 @@ interface PonchoConfig extends McpConfig {
     };
     /** Set to `false` to disable the built-in web UI (headless / API-only mode). */
     webUi?: false;
+    /** Enable browser automation tools. Set `true` for defaults, or provide config. */
+    browser?: boolean | {
+        viewport?: {
+            width?: number;
+            height?: number;
+        };
+        quality?: number;
+        everyNthFrame?: number;
+        profileDir?: string;
+        sessionName?: string;
+        executablePath?: string;
+        headless?: boolean;
+    };
 }
 declare const resolveStateConfig: (config: PonchoConfig | undefined) => StateConfig | undefined;
 declare const resolveMemoryConfig: (config: PonchoConfig | undefined) => MemoryConfig | undefined;
@@ -363,12 +385,20 @@ type ModelProviderFactory = (modelName: string) => LanguageModel;
  * resolve via the base prefix. Longest match wins.
  */
 declare const getModelContextWindow: (modelName: string) => number;
+interface ProviderConfig {
+    openai?: {
+        apiKeyEnv?: string;
+    };
+    anthropic?: {
+        apiKeyEnv?: string;
+    };
+}
 /**
- * Creates a model provider factory for the specified AI provider
- * @param provider - The provider name ('openai' or 'anthropic')
- * @returns A function that takes a model name and returns a LanguageModel instance
+ * Creates a model provider factory for the specified AI provider.
+ * API keys are read from environment variables; override the env var
+ * name via the `providers` config in `poncho.config.js`.
  */
-declare const createModelProvider: (provider?: string) => ModelProviderFactory;
+declare const createModelProvider: (provider?: string, config?: ProviderConfig) => ModelProviderFactory;
 
 interface ToolCall {
     id: string;
@@ -422,6 +452,8 @@ declare class AgentHarness {
     private readonly registeredMcpToolNames;
     private latitudeTelemetry?;
     private insideTelemetryCapture;
+    private _browserSession?;
+    private _browserMod?;
     private parsedAgent?;
     private mcpBridge?;
     private resolveToolAccess;
@@ -454,6 +486,10 @@ declare class AgentHarness {
     private registerSkillTools;
     private refreshSkillsIfChanged;
     initialize(): Promise<void>;
+    private initBrowserTools;
+    /** Conversation ID of the currently executing run (set during run, cleared after). */
+    private _currentRunConversationId?;
+    get browserSession(): unknown;
     shutdown(): Promise<void>;
     listTools(): ToolDefinition[];
     /**
@@ -489,8 +525,8 @@ declare class AgentHarness {
  * Vercel AI SDK support.
  */
 interface LatitudeCaptureConfig {
-    apiKey?: string;
-    projectId?: string | number;
+    apiKeyEnv?: string;
+    projectIdEnv?: string;
     path?: string;
     defaultPath?: string;
 }
@@ -585,8 +621,8 @@ interface TelemetryConfig {
     enabled?: boolean;
     otlp?: string;
     latitude?: {
-        apiKey?: string;
-        projectId?: string | number;
+        apiKeyEnv?: string;
+        projectIdEnv?: string;
         path?: string;
         documentPath?: string;
     };
@@ -599,4 +635,4 @@ 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 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 };
+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 };