@poncho-ai/harness 0.22.1 → 0.23.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.22.1 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.23.0 build /Users/cesar/Dev/latitude/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 260.03 KB
-ESM ⚡️ Build success in 131ms
+ESM dist/index.js 261.68 KB
+ESM ⚡️ Build success in 128ms
 DTS Build start
-DTS ⚡️ Build success in 6723ms
-DTS dist/index.d.ts 27.15 KB
+DTS ⚡️ Build success in 4463ms
+DTS dist/index.d.ts 27.40 KB

package/.turbo/turbo-lint.log

@@ -0,0 +1,6 @@
+
+> @poncho-ai/harness@0.11.2 lint /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+> eslint src/
+
+sh: eslint: command not found
+ ELIFECYCLE  Command failed.

package/.turbo/turbo-test.log

@@ -0,0 +1,135 @@
+
+> @poncho-ai/harness@0.16.1 test /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+> vitest
+
+
+ RUN  v1.6.1 /Users/cesar/Dev/latitude/poncho-ai/packages/harness
+
+ ✓ test/telemetry.test.ts  (3 tests) 2ms
+[event] step:completed {"type":"step:completed","step":1,"duration":1}
+[event] step:started {"type":"step:started","step":2}
+ ✓ test/schema-converter.test.ts  (27 tests) 19ms
+stdout | test/mcp.test.ts > mcp bridge protocol transports > discovers and calls tools over streamable HTTP
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+stdout | test/mcp.test.ts > mcp bridge protocol transports > selects discovered tools by requested patterns
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":2}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":2,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+ ✓ test/agent-parser.test.ts  (10 tests) 24ms
+stdout | test/mcp.test.ts > mcp bridge protocol transports > skips discovery when bearer token env value is missing
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":0,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+stderr | test/mcp.test.ts > mcp bridge protocol transports > skips discovery when bearer token env value is missing
+[poncho][mcp] {"event":"auth.token_missing","server":"remote","tokenEnv":"MISSING_TOKEN_ENV"}
+
+stdout | test/mcp.test.ts > mcp bridge protocol transports > returns actionable errors for 403 permission failures
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+
+ ✓ test/mcp.test.ts  (6 tests) 81ms
+ ✓ test/memory.test.ts  (4 tests) 56ms
+ ✓ test/state.test.ts  (5 tests) 237ms
+ ✓ test/model-factory.test.ts  (4 tests) 2ms
+ ✓ test/agent-identity.test.ts  (2 tests) 43ms
+stdout | test/harness.test.ts > agent harness > registers default filesystem tools
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > disables write_file by default in production environment
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > allows disabling built-in tools via poncho.config.js
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > supports per-environment tool overrides
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > supports per-environment tool overrides
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > does not auto-register exported tool objects from skill scripts
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > refreshes skill metadata and tools in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.cleared","reason":"activate:beta","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > prunes removed active skills after refresh in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.cleared","reason":"activate:obsolete","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > prunes removed active skills after refresh in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > does not refresh skills outside development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > clears active skills when skill metadata changes in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.cleared","reason":"activate:alpha","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > clears active skills when skill metadata changes in development mode
+[poncho][mcp] {"event":"tools.cleared","reason":"skills:changed","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > lists skill scripts through list_skill_scripts
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > runs JavaScript/TypeScript skill scripts through run_skill_script
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > runs AGENT-scope scripts from root scripts directory
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > blocks path traversal in run_skill_script
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > requires allowed-tools entries for non-standard script directories
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > registers MCP tools dynamically for stacked active skills and supports deactivation
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":2}
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
+[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-a","requestedPatterns":["remote/a"],"registeredCount":1,"activeSkills":["skill-a"]}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":2,"registeredCount":2,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-b","requestedPatterns":["remote/a","remote/b"],"registeredCount":2,"activeSkills":["skill-a","skill-b"]}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":1}
+[poncho][mcp] {"event":"tools.refreshed","reason":"deactivate:skill-a","requestedPatterns":["remote/b"],"registeredCount":1,"activeSkills":["skill-b"]}
+
+stdout | test/harness.test.ts > agent harness > supports flat tool access config format
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > flat tool access takes priority over legacy defaults
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > byEnvironment overrides flat tool access
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > registerTools skips tools disabled via config
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > approval access level registers the tool but marks it for approval
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > tools without approval config do not require approval
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+
+stdout | test/harness.test.ts > agent harness > allows in-flight MCP calls to finish after skill deactivation
+[poncho][mcp] {"event":"catalog.loaded","server":"remote","discoveredCount":1}
+[poncho][mcp] {"event":"tools.cleared","reason":"initialize","requestedPatterns":[]}
+[poncho][mcp] {"event":"tools.selected","requestedPatternCount":1,"registeredCount":1,"filteredByPolicyCount":0,"filteredByIntentCount":0}
+[poncho][mcp] {"event":"tools.refreshed","reason":"activate:skill-slow","requestedPatterns":["remote/slow"],"registeredCount":1,"activeSkills":["skill-slow"]}
+[poncho][mcp] {"event":"tools.cleared","reason":"deactivate:skill-slow","requestedPatterns":[]}
+
+ ✓ test/harness.test.ts  (25 tests) 291ms
+
+ Test Files  9 passed (9)
+      Tests  86 passed (86)
+   Start at  17:47:43
+   Duration  1.88s (transform 684ms, setup 1ms, collect 2.34s, tests 755ms, environment 2ms, prepare 1.27s)
+

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @poncho-ai/harness
 
+## 0.23.0
+
+### Minor Changes
+
+- [`d1e1bfb`](https://github.com/cesr/poncho-ai/commit/d1e1bfbf35b18788ab79231ca675774e949f5116) Thanks [@cesr](https://github.com/cesr)! - Add proactive scheduled messaging via channel-targeted cron jobs. Cron jobs with `channel: telegram` (or `slack`) now automatically discover known conversations and send the agent's response directly to each chat, continuing the existing conversation history.
+
 ## 0.22.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -19,6 +19,7 @@ interface CronJobConfig {
     schedule: string;
     task: string;
     timezone?: string;
+    channel?: string;
 }
 interface AgentFrontmatter {
     name: string;
@@ -155,6 +156,11 @@ interface Conversation {
         result?: _poncho_ai_sdk.RunResult;
         error?: _poncho_ai_sdk.AgentFailure;
     };
+    channelMeta?: {
+        platform: string;
+        channelId: string;
+        platformThreadId: string;
+    };
     createdAt: number;
     updatedAt: number;
 }
@@ -208,6 +214,11 @@ type ConversationSummary = {
     parentConversationId?: string;
     messageCount?: number;
     hasPendingApprovals?: boolean;
+    channelMeta?: {
+        platform: string;
+        channelId: string;
+        platformThreadId: string;
+    };
 };
 declare const createStateStore: (config?: StateConfig, options?: {
     workingDir?: string;

package/dist/index.js

@@ -112,10 +112,12 @@ var parseCronJobs = (value) => {
     if (timezone) {
       validateTimezone(timezone, path);
     }
+    const channel = typeof jobValue.channel === "string" && jobValue.channel.trim() ? jobValue.channel.trim() : void 0;
     jobs[jobName] = {
       schedule: jobValue.schedule.trim(),
       task: jobValue.task,
-      timezone
+      timezone,
+      channel
     };
   }
   return jobs;
@@ -1030,6 +1032,22 @@ messaging: [
 ]
 \`\`\`
 
+#### Proactive scheduled messages
+
+You can have the agent proactively message Telegram chats on a cron schedule. Add \`channel: telegram\` to any cron job in your \`AGENT.md\` frontmatter:
+
+\`\`\`yaml
+cron:
+  daily-checkin:
+    schedule: "0 9 * * *"
+    task: "Check in with the user about their plans for today"
+    channel: telegram
+\`\`\`
+
+The system auto-discovers all Telegram chats the bot has interacted with and sends the agent's response to each one. No chat IDs need to be configured -- filtering is handled by \`allowedUserIds\` if set. The agent runs with the full conversation history for each chat, so it has context from prior interactions.
+
+The bot must have received at least one message from a user before it can send proactive messages to that chat (Telegram API requirement).
+
 ### Email (Resend)
 
 #### 1. Set up Resend
@@ -4365,6 +4383,10 @@ cron:
     schedule: "0 9 * * *"        # Standard 5-field cron expression
     timezone: "America/New_York" # Optional IANA timezone (default: UTC)
     task: "Generate the daily sales report"
+  telegram-checkin:
+    schedule: "0 18 * * 1-5"
+    channel: telegram              # Proactive message to all known Telegram chats
+    task: "Send an end-of-day summary to the user"
 \`\`\`
 
 - Each cron job triggers an autonomous agent run with the specified task, creating a fresh conversation.
@@ -4373,6 +4395,7 @@ cron:
 - Jobs can also be triggered manually: \`GET /api/cron/<jobName>\`.
 - To carry context across cron runs, enable memory.
 - **IMPORTANT**: When adding a new cron job, always PRESERVE all existing cron jobs. Never remove or overwrite existing jobs unless the user explicitly asks you to replace or delete them. Read the full current \`cron:\` block before editing, and append the new job alongside the existing ones.
+- **Proactive channel messaging**: Adding \`channel: telegram\` (or \`slack\`) makes the cron job send its response directly to all known conversations on that platform, instead of creating a standalone conversation. The agent continues the existing conversation history for context. A chat must have at least one prior user message for auto-discovery to find it.
 
 ## Messaging Integrations (Slack, Telegram, Email)
 
@@ -6350,7 +6373,8 @@ var InMemoryConversationStore = class {
       ownerId: c.ownerId,
       parentConversationId: c.parentConversationId,
       messageCount: c.messages.length,
-      hasPendingApprovals: Array.isArray(c.pendingApprovals) && c.pendingApprovals.length > 0
+      hasPendingApprovals: Array.isArray(c.pendingApprovals) && c.pendingApprovals.length > 0,
+      channelMeta: c.channelMeta
     }));
   }
   async get(conversationId) {
@@ -6512,7 +6536,8 @@ var FileConversationStore = class {
         fileName,
         parentConversationId: conversation.parentConversationId,
         messageCount: conversation.messages.length,
-        hasPendingApprovals: Array.isArray(conversation.pendingApprovals) && conversation.pendingApprovals.length > 0
+        hasPendingApprovals: Array.isArray(conversation.pendingApprovals) && conversation.pendingApprovals.length > 0,
+        channelMeta: conversation.channelMeta
       });
       await this.writeIndex();
     });
@@ -6540,7 +6565,8 @@ var FileConversationStore = class {
       ownerId: c.ownerId,
       parentConversationId: c.parentConversationId,
       messageCount: c.messageCount,
-      hasPendingApprovals: c.hasPendingApprovals
+      hasPendingApprovals: c.hasPendingApprovals,
+      channelMeta: c.channelMeta
     }));
   }
   async get(conversationId) {
@@ -6806,7 +6832,8 @@ var KeyValueConversationStoreBase = class {
             ownerId: meta.ownerId,
             parentConversationId: meta.parentConversationId,
             messageCount: meta.messageCount,
-            hasPendingApprovals: meta.hasPendingApprovals
+            hasPendingApprovals: meta.hasPendingApprovals,
+            channelMeta: meta.channelMeta
           });
         }
       } catch {
@@ -6867,7 +6894,8 @@ var KeyValueConversationStoreBase = class {
         ownerId: nextConversation.ownerId,
         parentConversationId: nextConversation.parentConversationId,
         messageCount: nextConversation.messages.length,
-        hasPendingApprovals: Array.isArray(nextConversation.pendingApprovals) && nextConversation.pendingApprovals.length > 0
+        hasPendingApprovals: Array.isArray(nextConversation.pendingApprovals) && nextConversation.pendingApprovals.length > 0,
+        channelMeta: nextConversation.channelMeta
       }),
       this.ttl
     );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/harness",
-  "version": "0.22.1",
+  "version": "0.23.0",
   "description": "Agent execution runtime - conversation loop, tool dispatch, streaming",
   "repository": {
     "type": "git",

package/src/agent-parser.ts

@@ -27,6 +27,7 @@ export interface CronJobConfig {
   schedule: string;
   task: string;
   timezone?: string;
+  channel?: string;
 }
 
 export interface AgentFrontmatter {
@@ -138,10 +139,16 @@ const parseCronJobs = (
       validateTimezone(timezone, path);
     }
 
+    const channel =
+      typeof jobValue.channel === "string" && jobValue.channel.trim()
+        ? jobValue.channel.trim()
+        : undefined;
+
     jobs[jobName] = {
       schedule: jobValue.schedule.trim(),
       task: jobValue.task,
       timezone,
+      channel,
     };
   }
   return jobs;

package/src/harness.ts

@@ -280,6 +280,10 @@ cron:
     schedule: "0 9 * * *"        # Standard 5-field cron expression
     timezone: "America/New_York" # Optional IANA timezone (default: UTC)
     task: "Generate the daily sales report"
+  telegram-checkin:
+    schedule: "0 18 * * 1-5"
+    channel: telegram              # Proactive message to all known Telegram chats
+    task: "Send an end-of-day summary to the user"
 \`\`\`
 
 - Each cron job triggers an autonomous agent run with the specified task, creating a fresh conversation.
@@ -288,6 +292,7 @@ cron:
 - Jobs can also be triggered manually: \`GET /api/cron/<jobName>\`.
 - To carry context across cron runs, enable memory.
 - **IMPORTANT**: When adding a new cron job, always PRESERVE all existing cron jobs. Never remove or overwrite existing jobs unless the user explicitly asks you to replace or delete them. Read the full current \`cron:\` block before editing, and append the new job alongside the existing ones.
+- **Proactive channel messaging**: Adding \`channel: telegram\` (or \`slack\`) makes the cron job send its response directly to all known conversations on that platform, instead of creating a standalone conversation. The agent continues the existing conversation history for context. A chat must have at least one prior user message for auto-discovery to find it.
 
 ## Messaging Integrations (Slack, Telegram, Email)
 

package/src/state.ts

@@ -50,6 +50,11 @@ export interface Conversation {
     result?: import("@poncho-ai/sdk").RunResult;
     error?: import("@poncho-ai/sdk").AgentFailure;
   };
+  channelMeta?: {
+    platform: string;
+    channelId: string;
+    platformThreadId: string;
+  };
   createdAt: number;
   updatedAt: number;
 }
@@ -247,6 +252,7 @@ export class InMemoryConversationStore implements ConversationStore {
         parentConversationId: c.parentConversationId,
         messageCount: c.messages.length,
         hasPendingApprovals: Array.isArray(c.pendingApprovals) && c.pendingApprovals.length > 0,
+        channelMeta: c.channelMeta,
       }));
   }
 
@@ -305,6 +311,11 @@ export type ConversationSummary = {
   parentConversationId?: string;
   messageCount?: number;
   hasPendingApprovals?: boolean;
+  channelMeta?: {
+    platform: string;
+    channelId: string;
+    platformThreadId: string;
+  };
 };
 
 type ConversationStoreFile = {
@@ -319,6 +330,11 @@ type ConversationStoreFile = {
     parentConversationId?: string;
     messageCount?: number;
     hasPendingApprovals?: boolean;
+    channelMeta?: {
+      platform: string;
+      channelId: string;
+      platformThreadId: string;
+    };
   }>;
 };
 
@@ -451,6 +467,7 @@ class FileConversationStore implements ConversationStore {
         parentConversationId: conversation.parentConversationId,
         messageCount: conversation.messages.length,
         hasPendingApprovals: Array.isArray(conversation.pendingApprovals) && conversation.pendingApprovals.length > 0,
+        channelMeta: conversation.channelMeta,
       });
       await this.writeIndex();
     });
@@ -486,6 +503,7 @@ class FileConversationStore implements ConversationStore {
         parentConversationId: c.parentConversationId,
         messageCount: c.messageCount,
         hasPendingApprovals: c.hasPendingApprovals,
+        channelMeta: c.channelMeta,
       }));
   }
 
@@ -660,6 +678,11 @@ type ConversationMeta = {
   parentConversationId?: string;
   messageCount?: number;
   hasPendingApprovals?: boolean;
+  channelMeta?: {
+    platform: string;
+    channelId: string;
+    platformThreadId: string;
+  };
 };
 
 abstract class KeyValueConversationStoreBase implements ConversationStore {
@@ -804,6 +827,7 @@ abstract class KeyValueConversationStoreBase implements ConversationStore {
             parentConversationId: meta.parentConversationId,
             messageCount: meta.messageCount,
             hasPendingApprovals: meta.hasPendingApprovals,
+            channelMeta: meta.channelMeta,
           });
         }
       } catch { /* skip invalid records */ }
@@ -867,6 +891,7 @@ abstract class KeyValueConversationStoreBase implements ConversationStore {
         parentConversationId: nextConversation.parentConversationId,
         messageCount: nextConversation.messages.length,
         hasPendingApprovals: Array.isArray(nextConversation.pendingApprovals) && nextConversation.pendingApprovals.length > 0,
+        channelMeta: nextConversation.channelMeta,
       } satisfies ConversationMeta),
       this.ttl,
     );