@poncho-ai/harness 0.11.2 → 0.12.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.11.2 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.12.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 142.84 KB
-ESM ⚡️ Build success in 61ms
+ESM dist/index.js 158.98 KB
+ESM ⚡️ Build success in 59ms
 DTS Build start
-DTS ⚡️ Build success in 3695ms
-DTS dist/index.d.ts 17.16 KB
+DTS ⚡️ Build success in 4596ms
+DTS dist/index.d.ts 19.34 KB

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @poncho-ai/harness
 
+## 0.12.0
+
+### Minor Changes
+
+- [`035e8b3`](https://github.com/cesr/poncho-ai/commit/035e8b300ac4de6e7cbc4e2ab6bd06cdfd0e1ae3) Thanks [@cesr](https://github.com/cesr)! - Add multimodal file support for agents — images, PDFs, and text files can be uploaded via the web UI, HTTP API, and terminal CLI. Includes pluggable upload storage (local, Vercel Blob, S3), write-behind caching, build-time dependency injection, and graceful handling of unsupported formats.
+
+### Patch Changes
+
+- Updated dependencies [[`035e8b3`](https://github.com/cesr/poncho-ai/commit/035e8b300ac4de6e7cbc4e2ab6bd06cdfd0e1ae3)]:
+  - @poncho-ai/sdk@1.0.0
+
 ## 0.11.2
 
 ### Patch Changes

package/dist/index.d.ts

@@ -216,6 +216,14 @@ interface StorageConfig {
         maxRecallConversations?: number;
     };
 }
+interface UploadsConfig {
+    provider?: "local" | "vercel-blob" | "s3";
+    /** Vercel Blob access mode. Must match the store's configuration. Defaults to "public". */
+    access?: "public" | "private";
+    bucket?: string;
+    region?: string;
+    endpoint?: string;
+}
 type BuiltInToolToggles = {
     list_directory?: boolean;
     read_file?: boolean;
@@ -259,6 +267,7 @@ interface PonchoConfig extends McpConfig {
     /** Extra directories (relative to project root) to scan for skills.
      *  `skills/` and `.poncho/skills/` are always scanned. */
     skillPaths?: string[];
+    uploads?: UploadsConfig;
     build?: {
         vercel?: Record<string, unknown>;
         docker?: Record<string, unknown>;
@@ -273,6 +282,47 @@ declare const loadPonchoConfig: (workingDir: string) => Promise<PonchoConfig | u
 declare const createDefaultTools: (workingDir: string) => ToolDefinition[];
 declare const createWriteTool: (workingDir: string) => ToolDefinition;
 
+declare const PONCHO_UPLOAD_SCHEME = "poncho-upload://";
+interface UploadStore {
+    put(key: string, data: Buffer, mediaType: string): Promise<string>;
+    get(urlOrKey: string): Promise<Buffer>;
+    delete(urlOrKey: string): Promise<void>;
+}
+/** Derive a content-addressed key from file data. */
+declare const deriveUploadKey: (data: Buffer, mediaType: string) => string;
+declare class LocalUploadStore implements UploadStore {
+    private readonly uploadsDir;
+    constructor(workingDir: string);
+    put(_key: string, data: Buffer, mediaType: string): Promise<string>;
+    get(urlOrKey: string): Promise<Buffer>;
+    delete(urlOrKey: string): Promise<void>;
+}
+declare class VercelBlobUploadStore implements UploadStore {
+    private sdk;
+    private readonly workingDir?;
+    private readonly access;
+    constructor(workingDir?: string, access?: "public" | "private");
+    loadSdk(): Promise<any>;
+    put(key: string, data: Buffer, mediaType: string): Promise<string>;
+    get(urlOrKey: string): Promise<Buffer>;
+    delete(urlOrKey: string): Promise<void>;
+}
+declare class S3UploadStore implements UploadStore {
+    private s3Sdk;
+    private presignerSdk;
+    private client;
+    private readonly bucket;
+    private readonly region?;
+    private readonly endpoint?;
+    private readonly workingDir?;
+    constructor(bucket: string, region?: string, endpoint?: string, workingDir?: string);
+    ensureClient(): Promise<void>;
+    put(key: string, data: Buffer, mediaType: string): Promise<string>;
+    get(urlOrKey: string): Promise<Buffer>;
+    delete(urlOrKey: string): Promise<void>;
+}
+declare const createUploadStore: (config: UploadsConfig | undefined, workingDir: string) => Promise<UploadStore>;
+
 type ModelProviderFactory = (modelName: string) => LanguageModel;
 /**
  * Creates a model provider factory for the specified AI provider
@@ -293,6 +343,7 @@ interface HarnessOptions {
         approvalId: string;
     }) => Promise<boolean> | boolean;
     modelProvider?: ModelProviderFactory;
+    uploadStore?: UploadStore;
 }
 interface HarnessRunOutput {
     runId: string;
@@ -307,6 +358,7 @@ declare class AgentHarness {
     private readonly modelProviderInjected;
     private readonly dispatcher;
     private readonly approvalHandler?;
+    readonly uploadStore?: UploadStore;
     private skillContextWindow;
     private memoryStore?;
     private loadedConfig?;
@@ -495,4 +547,4 @@ declare class ToolDispatcher {
     executeBatch(calls: ToolCall[], context: ToolContext): Promise<ToolExecutionResult[]>;
 }
 
-export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type BuiltInToolToggles, type Conversation, type ConversationState, type ConversationStore, type HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryStateStore, LatitudeCapture, type LatitudeCaptureConfig, LocalMcpBridge, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type ModelProviderFactory, type ParsedAgent, type PonchoConfig, type RemoteMcpServerConfig, type RuntimeRenderContext, STORAGE_SCHEMA_VERSION, type SkillContextEntry, type SkillMetadata, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type TelemetryConfig, TelemetryEmitter, type ToolCall, ToolDispatcher, type ToolExecutionResult, buildAgentDirectoryName, buildSkillContextWindow, createConversationStore, createDefaultTools, createMemoryStore, createMemoryTools, createModelProvider, createSkillTools, createStateStore, createWriteTool, ensureAgentIdentity, generateAgentId, getAgentStoreDirectory, 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 HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryStateStore, LatitudeCapture, type LatitudeCaptureConfig, LocalMcpBridge, LocalUploadStore, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, 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 ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VercelBlobUploadStore, buildAgentDirectoryName, buildSkillContextWindow, createConversationStore, createDefaultTools, createMemoryStore, createMemoryTools, createModelProvider, createSkillTools, createStateStore, createUploadStore, createWriteTool, deriveUploadKey, ensureAgentIdentity, generateAgentId, getAgentStoreDirectory, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent };