@poncho-ai/harness 0.37.1 → 0.38.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.37.1 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.38.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,9 +8,9 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js            389.90 KB
+ESM dist/index.js            402.58 KB
 ESM dist/isolate-TCWTUVG4.js 47.34 KB
-ESM ⚡️ Build success in 211ms
+ESM ⚡️ Build success in 197ms
 DTS Build start
-DTS ⚡️ Build success in 6845ms
-DTS dist/index.d.ts 56.62 KB
+DTS ⚡️ Build success in 7534ms
+DTS dist/index.d.ts 58.26 KB

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @poncho-ai/harness
 
+## 0.38.0
+
+### Minor Changes
+
+- [`620a0c8`](https://github.com/cesr/poncho-ai/commit/620a0c89efaafce28968fca5cbde2e2b19bd1595) Thanks [@cesr](https://github.com/cesr)! - feat: add recurrent reminders (daily, weekly, monthly, cron)
+
+  The `set_reminder` tool now accepts an optional `recurrence` parameter that makes reminders repeat on a schedule instead of firing once. Supports daily, weekly (with specific days-of-week), monthly, and cron expressions. Recurring reminders are rescheduled after each firing and can be bounded by `maxOccurrences` or `endsAt`. Cancel a recurring reminder to stop all future occurrences.
+
+### Patch Changes
+
+- [`6486de2`](https://github.com/cesr/poncho-ai/commit/6486de2242a2976068e4bd09f7c0f2d978c35c96) Thanks [@cesr](https://github.com/cesr)! - fix: persist subagent `parentConversationId` atomically so children never appear top-level in the sidebar.
+
+  `SubagentManager.spawn` previously did a two-step write: `conversationStore.create(...)` followed by `conversationStore.update(...)` to attach `parentConversationId`, `subagentMeta`, and the initial user message. If the follow-up update was interrupted (serverless timeout, transient DB error), the child row was left in the database with `parent_conversation_id = NULL`, so it slipped past the `!c.parentConversationId` filter on `/api/conversations` and showed up as a top-level conversation. This was especially visible with cron-driven research subagents.
+
+  `ConversationStore.create` now accepts an optional `init` bag (`parentConversationId`, `subagentMeta`, `messages`, `channelMeta`) that is written in the single INSERT — both into the `data` blob and into the dedicated `parent_conversation_id` column. `spawn` passes those fields through and drops the redundant update, eliminating the orphan window. All existing `create(ownerId, title, tenantId)` callers keep working since `init` is optional.
+
+- [`0d0578f`](https://github.com/cesr/poncho-ai/commit/0d0578fbc97a3d2644c4e22cab14ff02a79f805f) Thanks [@cesr](https://github.com/cesr)! - fix: route file tools through MountableFs so `/project/` paths resolve correctly
+
+  `edit_file`, `read_file`, and `write_file` were hitting `engine.vfs` directly, which has no knowledge of the `/project/` mount that bash uses via `MountableFs`. This caused `edit_file` to throw "File not found" on `/project/` paths that bash could see fine. All three file tools now receive a filesystem factory from `BashEnvironmentManager.getFs()` that returns the same combined filesystem (VFS + `/project/` overlay) that bash uses.
+
+## 0.37.2
+
+### Patch Changes
+
+- [`2229f74`](https://github.com/cesr/poncho-ai/commit/2229f74ae4d02c5618c60787a7db925060cc1313) Thanks [@cesr](https://github.com/cesr)! - fix: stop invalidating the prompt cache across runs and preserve cache reads when tool results are in flight.
+
+  Two issues were degrading prompt-cache hit rates to ~0 between turns:
+  1. The system prompt embedded `new Date().toISOString()` (millisecond precision) on every run when a reminder store was active, which changed the very first block of the prefix and prevented any cross-run cache match. The timestamp is now quantized to the hour, which keeps the system prompt stable across runs while still giving the agent a usable sense of time.
+  2. When the message history contained untruncated tool results from the previous run, prompt caching was disabled entirely — no `cache_control` breakpoint was emitted, which also killed cache _reads_ of the stable prefix (system prompt + earlier turns). The breakpoint is now placed immediately before the first untruncated tool result instead, so the stable prefix is still cached and read while the soon-to-be-truncated tail stays out of the cache.
+
+  `addPromptCacheBreakpoints` now takes an optional `targetIndex` to support this.
+
 ## 0.37.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -196,11 +196,17 @@ interface Conversation {
     createdAt: number;
     updatedAt: number;
 }
+interface ConversationCreateInit {
+    parentConversationId?: string;
+    subagentMeta?: Conversation["subagentMeta"];
+    messages?: Message[];
+    channelMeta?: Conversation["channelMeta"];
+}
 interface ConversationStore {
     list(ownerId?: string, tenantId?: string | null): Promise<Conversation[]>;
     listSummaries(ownerId?: string, tenantId?: string | null): Promise<ConversationSummary[]>;
     get(conversationId: string): Promise<Conversation | undefined>;
-    create(ownerId?: string, title?: string, tenantId?: string | null): Promise<Conversation>;
+    create(ownerId?: string, title?: string, tenantId?: string | null, init?: ConversationCreateInit): Promise<Conversation>;
     update(conversation: Conversation): Promise<void>;
     rename(conversationId: string, title: string): Promise<Conversation | undefined>;
     delete(conversationId: string): Promise<boolean>;
@@ -234,7 +240,7 @@ declare class InMemoryConversationStore implements ConversationStore {
     list(ownerId?: string, tenantId?: string | null): Promise<Conversation[]>;
     listSummaries(ownerId?: string, tenantId?: string | null): Promise<ConversationSummary[]>;
     get(conversationId: string): Promise<Conversation | undefined>;
-    create(ownerId?: string, title?: string, tenantId?: string | null): Promise<Conversation>;
+    create(ownerId?: string, title?: string, tenantId?: string | null, init?: ConversationCreateInit): Promise<Conversation>;
     update(conversation: Conversation): Promise<void>;
     rename(conversationId: string, title: string): Promise<Conversation | undefined>;
     delete(conversationId: string): Promise<boolean>;
@@ -682,6 +688,20 @@ interface TodoStore {
 }
 
 type ReminderStatus = "pending" | "fired" | "cancelled";
+type RecurrenceType = "daily" | "weekly" | "monthly" | "cron";
+interface Recurrence {
+    type: RecurrenceType;
+    /** Repeat every N units (e.g. every 2 days). Defaults to 1. */
+    interval?: number;
+    /** For weekly: which days (0=Sun … 6=Sat). */
+    daysOfWeek?: number[];
+    /** For type "cron": a 5-field cron expression. */
+    expression?: string;
+    /** Stop recurring after this epoch-ms timestamp. */
+    endsAt?: number;
+    /** Stop recurring after this many total firings. */
+    maxOccurrences?: number;
+}
 interface Reminder {
     id: string;
     task: string;
@@ -692,20 +712,35 @@ interface Reminder {
     conversationId: string;
     ownerId?: string;
     tenantId?: string | null;
+    recurrence?: Recurrence | null;
+    occurrenceCount?: number;
+}
+interface ReminderCreateInput {
+    task: string;
+    scheduledAt: number;
+    timezone?: string;
+    conversationId: string;
+    ownerId?: string;
+    tenantId?: string | null;
+    recurrence?: Recurrence | null;
 }
 interface ReminderStore {
     list(): Promise<Reminder[]>;
-    create(input: {
-        task: string;
-        scheduledAt: number;
-        timezone?: string;
-        conversationId: string;
-        ownerId?: string;
-        tenantId?: string | null;
+    create(input: ReminderCreateInput): Promise<Reminder>;
+    update(id: string, fields: {
+        scheduledAt?: number;
+        occurrenceCount?: number;
+        status?: ReminderStatus;
     }): Promise<Reminder>;
     cancel(id: string): Promise<Reminder>;
     delete(id: string): Promise<void>;
 }
+/**
+ * Given a reminder's current scheduledAt and its recurrence config, compute the
+ * next fire time. Returns null if the recurrence is exhausted (maxOccurrences
+ * reached or endsAt passed).
+ */
+declare const computeNextOccurrence: (reminder: Reminder) => number | null;
 declare const createReminderStore: (_agentId: string, _config?: StateConfig, _options?: {
     workingDir?: string;
 }) => ReminderStore;
@@ -731,7 +766,7 @@ interface StorageEngine {
     conversations: {
         list(ownerId?: string, tenantId?: string | null): Promise<ConversationSummary[]>;
         get(conversationId: string): Promise<Conversation | undefined>;
-        create(ownerId?: string, title?: string, tenantId?: string | null): Promise<Conversation>;
+        create(ownerId?: string, title?: string, tenantId?: string | null, init?: ConversationCreateInit): Promise<Conversation>;
         update(conversation: Conversation): Promise<void>;
         rename(conversationId: string, title: string): Promise<Conversation | undefined>;
         delete(conversationId: string): Promise<boolean>;
@@ -749,13 +784,11 @@ interface StorageEngine {
     };
     reminders: {
         list(tenantId?: string | null): Promise<Reminder[]>;
-        create(input: {
-            task: string;
-            scheduledAt: number;
-            timezone?: string;
-            conversationId: string;
-            ownerId?: string;
-            tenantId?: string | null;
+        create(input: ReminderCreateInput): Promise<Reminder>;
+        update(id: string, fields: {
+            scheduledAt?: number;
+            occurrenceCount?: number;
+            status?: ReminderStatus;
         }): Promise<Reminder>;
         cancel(id: string): Promise<Reminder>;
         delete(id: string): Promise<void>;
@@ -1165,7 +1198,7 @@ declare class InMemoryEngine implements StorageEngine {
     conversations: {
         list: (ownerId?: string, tenantId?: string | null) => Promise<ConversationSummary[]>;
         get: (conversationId: string) => Promise<Conversation | undefined>;
-        create: (ownerId?: string, title?: string, tenantId?: string | null) => Promise<Conversation>;
+        create: (ownerId?: string, title?: string, tenantId?: string | null, init?: ConversationCreateInit) => Promise<Conversation>;
         update: (conversation: Conversation) => Promise<void>;
         rename: (conversationId: string, title: string) => Promise<Conversation | undefined>;
         delete: (conversationId: string) => Promise<boolean>;
@@ -1183,13 +1216,11 @@ declare class InMemoryEngine implements StorageEngine {
     };
     reminders: {
         list: (tenantId?: string | null) => Promise<Reminder[]>;
-        create: (input: {
-            task: string;
-            scheduledAt: number;
-            timezone?: string;
-            conversationId: string;
-            ownerId?: string;
-            tenantId?: string | null;
+        create: (input: ReminderCreateInput) => Promise<Reminder>;
+        update: (id: string, fields: {
+            scheduledAt?: number;
+            occurrenceCount?: number;
+            status?: ReminderStatus;
         }) => Promise<Reminder>;
         cancel: (id: string) => Promise<Reminder>;
         delete: (id: string) => Promise<void>;
@@ -1262,7 +1293,7 @@ declare abstract class SqlStorageEngine implements StorageEngine {
     conversations: {
         list: (ownerId?: string, tenantId?: string | null) => Promise<ConversationSummary[]>;
         get: (conversationId: string) => Promise<Conversation | undefined>;
-        create: (ownerId?: string, title?: string, tenantId?: string | null) => Promise<Conversation>;
+        create: (ownerId?: string, title?: string, tenantId?: string | null, init?: ConversationCreateInit) => Promise<Conversation>;
         update: (conversation: Conversation) => Promise<void>;
         rename: (conversationId: string, title: string) => Promise<Conversation | undefined>;
         delete: (conversationId: string) => Promise<boolean>;
@@ -1280,13 +1311,11 @@ declare abstract class SqlStorageEngine implements StorageEngine {
     };
     reminders: {
         list: (tenantId?: string | null) => Promise<Reminder[]>;
-        create: (input: {
-            task: string;
-            scheduledAt: number;
-            timezone?: string;
-            conversationId: string;
-            ownerId?: string;
-            tenantId?: string | null;
+        create: (input: ReminderCreateInput) => Promise<Reminder>;
+        update: (id: string, fields: {
+            scheduledAt?: number;
+            occurrenceCount?: number;
+            status?: ReminderStatus;
         }) => Promise<Reminder>;
         cancel: (id: string) => Promise<Reminder>;
         delete: (id: string) => Promise<void>;
@@ -1419,12 +1448,15 @@ declare class BashEnvironmentManager {
     private engine;
     private limits;
     private environments;
+    private filesystems;
     private readonly workingDir;
     private readonly bashOptions;
     constructor(engine: StorageEngine, limits: {
         maxFileSize: number;
         maxTotalStorage: number;
     }, workingDir: string | null, bashConfig?: BashConfig, network?: NetworkConfig);
+    /** Return the combined IFileSystem (VFS + optional /project mount) for a tenant. */
+    getFs(tenantId: string): IFileSystem;
     getOrCreate(tenantId: string): Bash;
     getAdapter(tenantId: string): PonchoFsAdapter;
     /** Refresh the PostgreSQL path cache before a bash.exec() call. */
@@ -1447,4 +1479,4 @@ declare function verifyTenantToken(signingKey: string, token: string): Promise<T
 
 declare const createSubagentTools: (manager: SubagentManager) => ToolDefinition[];
 
-export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type ArchivedToolResult$1 as ArchivedToolResult, type BashConfig, BashEnvironmentManager, type BashExecutionLimits, type BuiltInToolToggles, type CompactMessagesOptions, type CompactResult, type CompactionConfig, type Conversation, type ConversationState, type ConversationStore, type ConversationSummary, type CronJobConfig, type HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryEngine, InMemoryStateStore, type IsolateBinding, type IsolateConfig, LocalMcpBridge, LocalUploadStore, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, type NetworkConfig, OPENAI_CODEX_CLIENT_ID, type OpenAICodexAuthConfig, type OpenAICodexDeviceAuthRequest, type OpenAICodexSession, type OtlpConfig, type OtlpOption, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PendingSubagentResult, type PonchoConfig, PonchoFsAdapter, PostgresEngine, type ProviderConfig, type Reminder, type ReminderStatus, type ReminderStore, type RemoteMcpServerConfig, type RuntimeRenderContext, S3UploadStore, STORAGE_SCHEMA_VERSION, type SecretsStore, type SkillContextEntry, type SkillMetadata, SqliteEngine, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type StorageEngine, type StorageFactoryOptions, type StorageProvider, type SubagentManager, type SubagentResult, type SubagentSpawnResult, type SubagentSummary, type TelemetryConfig, TelemetryEmitter, type TenantTokenPayload, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VFS_SCHEME, VercelBlobUploadStore, type VfsDirEntry, type VfsStat, buildAgentDirectoryName, buildSkillContextWindow, compactMessages, completeOpenAICodexDeviceAuth, createBashTool, createConversationStore, createConversationStoreFromEngine, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryStoreFromEngine, createMemoryTools, createModelProvider, createReminderStore, createReminderStoreFromEngine, createReminderTools, createSearchTools, createSecretsStore, createSkillTools, createStateStore, createStorageEngine, createSubagentTools, createTodoStoreFromEngine, createUploadStore, createWriteTool, deleteOpenAICodexSession, deriveUploadKey, ensureAgentIdentity, estimateTokens, estimateTotalTokens, findSafeSplitPoint, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getOpenAICodexAccessToken, getOpenAICodexAuthFilePath, getOpenAICodexRequiredScopes, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeOtlp, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, ponchoDocsTool, readOpenAICodexSession, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveEnv, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent, startOpenAICodexDeviceAuth, verifyTenantToken, writeOpenAICodexSession };
+export { type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, type ArchivedToolResult$1 as ArchivedToolResult, type BashConfig, BashEnvironmentManager, type BashExecutionLimits, type BuiltInToolToggles, type CompactMessagesOptions, type CompactResult, type CompactionConfig, type Conversation, type ConversationCreateInit, type ConversationState, type ConversationStore, type ConversationSummary, type CronJobConfig, type HarnessOptions, type HarnessRunOutput, InMemoryConversationStore, InMemoryEngine, InMemoryStateStore, type IsolateBinding, type IsolateConfig, LocalMcpBridge, LocalUploadStore, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, type NetworkConfig, OPENAI_CODEX_CLIENT_ID, type OpenAICodexAuthConfig, type OpenAICodexDeviceAuthRequest, type OpenAICodexSession, type OtlpConfig, type OtlpOption, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PendingSubagentResult, type PonchoConfig, PonchoFsAdapter, PostgresEngine, type ProviderConfig, type Recurrence, type RecurrenceType, type Reminder, type ReminderCreateInput, type ReminderStatus, type ReminderStore, type RemoteMcpServerConfig, type RuntimeRenderContext, S3UploadStore, STORAGE_SCHEMA_VERSION, type SecretsStore, type SkillContextEntry, type SkillMetadata, SqliteEngine, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type StorageEngine, type StorageFactoryOptions, type StorageProvider, type SubagentManager, type SubagentResult, type SubagentSpawnResult, type SubagentSummary, type TelemetryConfig, TelemetryEmitter, type TenantTokenPayload, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type UploadStore, type UploadsConfig, VFS_SCHEME, VercelBlobUploadStore, type VfsDirEntry, type VfsStat, buildAgentDirectoryName, buildSkillContextWindow, compactMessages, completeOpenAICodexDeviceAuth, computeNextOccurrence, createBashTool, createConversationStore, createConversationStoreFromEngine, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryStoreFromEngine, createMemoryTools, createModelProvider, createReminderStore, createReminderStoreFromEngine, createReminderTools, createSearchTools, createSecretsStore, createSkillTools, createStateStore, createStorageEngine, createSubagentTools, createTodoStoreFromEngine, createUploadStore, createWriteTool, deleteOpenAICodexSession, deriveUploadKey, ensureAgentIdentity, estimateTokens, estimateTotalTokens, findSafeSplitPoint, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getOpenAICodexAccessToken, getOpenAICodexAuthFilePath, getOpenAICodexRequiredScopes, getPonchoStoreRoot, jsonSchemaToZod, loadPonchoConfig, loadSkillContext, loadSkillInstructions, loadSkillMetadata, normalizeOtlp, normalizeScriptPolicyPath, parseAgentFile, parseAgentMarkdown, ponchoDocsTool, readOpenAICodexSession, readSkillResource, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveEnv, resolveMemoryConfig, resolveSkillDirs, resolveStateConfig, slugifyStorageComponent, startOpenAICodexDeviceAuth, verifyTenantToken, writeOpenAICodexSession };