@poncho-ai/harness 0.22.0 → 0.23.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.22.0 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 257.83 KB
-ESM ⚡️ Build success in 146ms
+ESM dist/index.js 261.68 KB
+ESM ⚡️ Build success in 128ms
 DTS Build start
-DTS ⚡️ Build success in 7680ms
-DTS dist/index.d.ts 27.07 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,19 @@
 # @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
+
+- [`096953d`](https://github.com/cesr/poncho-ai/commit/096953d5a64a785950ea0a7f09e2183e481afd29) Thanks [@cesr](https://github.com/cesr)! - Improve time-to-first-token by lazy-loading the recall corpus
+
+  The recall corpus (past conversation summaries) is now fetched on-demand only when the LLM invokes the `conversation_recall` tool, instead of blocking every message with ~1.3s of upfront I/O. Also adds batch `mget` support to Upstash/Redis/DynamoDB conversation stores, parallelizes memory fetch with skill refresh, debounces skill refresh in dev mode, and caches message conversions across multi-step runs.
+
 ## 0.22.0
 
 ### Minor 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;
@@ -562,6 +573,7 @@ declare class AgentHarness {
     private loadedConfig?;
     private loadedSkills;
     private skillFingerprint;
+    private lastSkillRefreshAt;
     private readonly activeSkillNames;
     private readonly registeredMcpToolNames;
     private latitudeTelemetry?;
@@ -601,6 +613,7 @@ declare class AgentHarness {
     private refreshMcpTools;
     private buildSkillFingerprint;
     private registerSkillTools;
+    private static readonly SKILL_REFRESH_DEBOUNCE_MS;
     private refreshSkillsIfChanged;
     initialize(): Promise<void>;
     private buildBrowserStoragePersistence;

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
@@ -2771,10 +2789,9 @@ var createMemoryTools = (store, options) => {
           Math.min(5, typeof input.limit === "number" ? input.limit : 3)
         );
         const excludeConversationId = typeof input.excludeConversationId === "string" ? input.excludeConversationId : "";
-        const corpus = asRecallCorpus(context.parameters.__conversationRecallCorpus).slice(
-          0,
-          maxRecallConversations
-        );
+        const rawCorpus = context.parameters.__conversationRecallCorpus;
+        const resolvedCorpus = typeof rawCorpus === "function" ? await rawCorpus() : rawCorpus;
+        const corpus = asRecallCorpus(resolvedCorpus).slice(0, maxRecallConversations);
         const results = corpus.filter(
           (item) => excludeConversationId ? item.conversationId !== excludeConversationId : true
         ).map((item) => ({
@@ -4366,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.
@@ -4374,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)
 
@@ -4599,7 +4621,7 @@ function extractMediaFromToolOutput(output) {
   const strippedOutput = walk(output);
   return { mediaItems, strippedOutput };
 }
-var AgentHarness = class {
+var AgentHarness = class _AgentHarness {
   workingDir;
   environment;
   modelProvider;
@@ -4611,6 +4633,7 @@ var AgentHarness = class {
   loadedConfig;
   loadedSkills = [];
   skillFingerprint = "";
+  lastSkillRefreshAt = 0;
   activeSkillNames = /* @__PURE__ */ new Set();
   registeredMcpToolNames = /* @__PURE__ */ new Set();
   latitudeTelemetry;
@@ -4899,10 +4922,16 @@ var AgentHarness = class {
       })
     );
   }
+  static SKILL_REFRESH_DEBOUNCE_MS = 3e3;
   async refreshSkillsIfChanged() {
     if (this.environment !== "development") {
       return;
     }
+    const elapsed = Date.now() - this.lastSkillRefreshAt;
+    if (this.lastSkillRefreshAt > 0 && elapsed < _AgentHarness.SKILL_REFRESH_DEBOUNCE_MS) {
+      return;
+    }
+    this.lastSkillRefreshAt = Date.now();
     try {
       const latestSkills = await loadSkillMetadata(
         this.workingDir,
@@ -5228,6 +5257,7 @@ var AgentHarness = class {
     if (!this.parsedAgent) {
       await this.initialize();
     }
+    const memoryPromise = this.memoryStore ? this.memoryStore.getMainMemory() : void 0;
     await this.refreshSkillsIfChanged();
     this._currentRunConversationId = input.conversationId;
     const ownerParam = input.parameters?.__ownerId;
@@ -5280,7 +5310,7 @@ Each conversation gets its own browser tab sharing a single browser instance. Ca
     const promptWithSkills = this.skillContextWindow ? `${systemPrompt}${developmentContext}
 
 ${this.skillContextWindow}${browserContext}` : `${systemPrompt}${developmentContext}${browserContext}`;
-    const mainMemory = this.memoryStore ? await this.memoryStore.getMainMemory() : void 0;
+    const mainMemory = await memoryPromise;
     const boundedMainMemory = mainMemory && mainMemory.content.length > 4e3 ? `${mainMemory.content.slice(0, 4e3)}
 ...[truncated]` : mainMemory?.content;
     const memoryContext = boundedMainMemory && boundedMainMemory.trim().length > 0 ? `
@@ -5375,6 +5405,8 @@ ${boundedMainMemory.trim()}` : "";
     let totalOutputTokens = 0;
     let totalCachedTokens = 0;
     let transientStepRetryCount = 0;
+    let cachedCoreMessages = [];
+    let convertedUpTo = 0;
     for (let step = 1; step <= maxSteps; step += 1) {
       try {
         yield* drainBrowserEvents();
@@ -5651,7 +5683,15 @@ ${textContent}` };
             }
           }
         }
-        const coreMessages = (await Promise.all(messages.map(convertMessage))).flat();
+        if (convertedUpTo > messages.length) {
+          cachedCoreMessages = [];
+          convertedUpTo = 0;
+        }
+        const newMessages = messages.slice(convertedUpTo);
+        const newCoreMessages = newMessages.length > 0 ? (await Promise.all(newMessages.map(convertMessage))).flat() : [];
+        cachedCoreMessages = [...cachedCoreMessages, ...newCoreMessages];
+        convertedUpTo = messages.length;
+        const coreMessages = cachedCoreMessages;
         const temperature = agent.frontmatter.model?.temperature ?? 0.2;
         const maxTokens = agent.frontmatter.model?.maxTokens;
         const cachedMessages = addPromptCacheBreakpoints(coreMessages, modelInstance);
@@ -6333,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) {
@@ -6495,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();
     });
@@ -6523,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) {
@@ -6750,12 +6793,12 @@ var KeyValueConversationStoreBase = class {
       return [];
     }
     const ids = await this.getOwnerConversationIds(ownerId);
+    if (ids.length === 0) return [];
+    const convKeys = await Promise.all(ids.map((id) => this.conversationKey(id)));
+    const rawValues = await kv.mget(convKeys);
     const conversations = [];
-    for (const id of ids) {
-      const raw = await kv.get(await this.conversationKey(id));
-      if (!raw) {
-        continue;
-      }
+    for (const raw of rawValues) {
+      if (!raw) continue;
       try {
         conversations.push(JSON.parse(raw));
       } catch {
@@ -6772,20 +6815,28 @@ var KeyValueConversationStoreBase = class {
       return [];
     }
     const ids = await this.getOwnerConversationIds(ownerId);
+    if (ids.length === 0) return [];
+    const metaKeys = await Promise.all(ids.map((id) => this.conversationMetaKey(id)));
+    const rawValues = await kv.mget(metaKeys);
     const summaries = [];
-    for (const id of ids) {
-      const meta = await this.getConversationMeta(id);
-      if (meta && meta.ownerId === ownerId) {
-        summaries.push({
-          conversationId: meta.conversationId,
-          title: meta.title,
-          updatedAt: meta.updatedAt,
-          createdAt: meta.createdAt,
-          ownerId: meta.ownerId,
-          parentConversationId: meta.parentConversationId,
-          messageCount: meta.messageCount,
-          hasPendingApprovals: meta.hasPendingApprovals
-        });
+    for (const raw of rawValues) {
+      if (!raw) continue;
+      try {
+        const meta = JSON.parse(raw);
+        if (meta.ownerId === ownerId) {
+          summaries.push({
+            conversationId: meta.conversationId,
+            title: meta.title,
+            updatedAt: meta.updatedAt,
+            createdAt: meta.createdAt,
+            ownerId: meta.ownerId,
+            parentConversationId: meta.parentConversationId,
+            messageCount: meta.messageCount,
+            hasPendingApprovals: meta.hasPendingApprovals,
+            channelMeta: meta.channelMeta
+          });
+        }
+      } catch {
       }
     }
     return summaries.sort((a, b) => b.updatedAt - a.updatedAt);
@@ -6843,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
     );
@@ -6923,6 +6975,19 @@ var UpstashConversationStore = class extends KeyValueConversationStoreBase {
         const payload = await response.json();
         return payload.result ?? void 0;
       },
+      mget: async (keys) => {
+        if (keys.length === 0) return [];
+        const path = keys.map((k) => encodeURIComponent(k)).join("/");
+        const response = await fetch(`${this.baseUrl}/mget/${path}`, {
+          method: "POST",
+          headers: this.headers()
+        });
+        if (!response.ok) {
+          return keys.map(() => void 0);
+        }
+        const payload = await response.json();
+        return (payload.result ?? []).map((v) => v ?? void 0);
+      },
       set: async (key, value, ttl) => {
         const endpoint = typeof ttl === "number" ? `${this.baseUrl}/setex/${encodeURIComponent(key)}/${Math.max(
           1,
@@ -7015,6 +7080,11 @@ var RedisLikeConversationStore = class extends KeyValueConversationStoreBase {
         const value = await client.get(key);
         return value ?? void 0;
       },
+      mget: async (keys) => {
+        if (keys.length === 0) return [];
+        const values = await client.mGet(keys);
+        return values.map((v) => v ?? void 0);
+      },
       set: async (key, value, ttl) => {
         if (typeof ttl === "number") {
           await client.set(key, value, { EX: Math.max(1, ttl) });
@@ -7149,6 +7219,18 @@ var DynamoDbConversationStore = class extends KeyValueConversationStoreBase {
           })
         );
       },
+      mget: async (keys) => {
+        if (keys.length === 0) return [];
+        return Promise.all(keys.map(async (key) => {
+          const result = await client.send(
+            new client.GetItemCommand({
+              TableName: this.table,
+              Key: { runId: { S: key } }
+            })
+          );
+          return result.Item?.value?.S;
+        }));
+      },
       del: async (key) => {
         await client.send(
           new client.DeleteItemCommand({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/harness",
-  "version": "0.22.0",
+  "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)
 
@@ -545,6 +550,7 @@ export class AgentHarness {
   private loadedConfig?: PonchoConfig;
   private loadedSkills: SkillMetadata[] = [];
   private skillFingerprint = "";
+  private lastSkillRefreshAt = 0;
   private readonly activeSkillNames = new Set<string>();
   private readonly registeredMcpToolNames = new Set<string>();
   private latitudeTelemetry?: LatitudeTelemetry;
@@ -879,10 +885,17 @@ export class AgentHarness {
     );
   }
 
+  private static readonly SKILL_REFRESH_DEBOUNCE_MS = 3000;
+
   private async refreshSkillsIfChanged(): Promise<void> {
     if (this.environment !== "development") {
       return;
     }
+    const elapsed = Date.now() - this.lastSkillRefreshAt;
+    if (this.lastSkillRefreshAt > 0 && elapsed < AgentHarness.SKILL_REFRESH_DEBOUNCE_MS) {
+      return;
+    }
+    this.lastSkillRefreshAt = Date.now();
     try {
       const latestSkills = await loadSkillMetadata(
         this.workingDir,
@@ -1269,6 +1282,10 @@ export class AgentHarness {
     if (!this.parsedAgent) {
       await this.initialize();
     }
+    // Start memory fetch early so it overlaps with skill refresh I/O
+    const memoryPromise = this.memoryStore
+      ? this.memoryStore.getMainMemory()
+      : undefined;
     await this.refreshSkillsIfChanged();
 
     // Track which conversation/owner this run belongs to so browser & subagent tools resolve correctly
@@ -1328,9 +1345,7 @@ Each conversation gets its own browser tab sharing a single browser instance. Ca
     const promptWithSkills = this.skillContextWindow
       ? `${systemPrompt}${developmentContext}\n\n${this.skillContextWindow}${browserContext}`
       : `${systemPrompt}${developmentContext}${browserContext}`;
-    const mainMemory = this.memoryStore
-      ? await this.memoryStore.getMainMemory()
-      : undefined;
+    const mainMemory = await memoryPromise;
     const boundedMainMemory =
       mainMemory && mainMemory.content.length > 4000
         ? `${mainMemory.content.slice(0, 4000)}\n...[truncated]`
@@ -1445,6 +1460,8 @@ ${boundedMainMemory.trim()}`
     let totalOutputTokens = 0;
     let totalCachedTokens = 0;
     let transientStepRetryCount = 0;
+    let cachedCoreMessages: ModelMessage[] = [];
+    let convertedUpTo = 0;
 
     for (let step = 1; step <= maxSteps; step += 1) {
       try {
@@ -1784,9 +1801,19 @@ ${boundedMainMemory.trim()}`
           }
         }
 
-        const coreMessages: ModelMessage[] = (
-          await Promise.all(messages.map(convertMessage))
-        ).flat();
+        // Only convert messages added since the last step
+        if (convertedUpTo > messages.length) {
+          // Compaction replaced the array — invalidate cache
+          cachedCoreMessages = [];
+          convertedUpTo = 0;
+        }
+        const newMessages = messages.slice(convertedUpTo);
+        const newCoreMessages: ModelMessage[] = newMessages.length > 0
+          ? (await Promise.all(newMessages.map(convertMessage))).flat()
+          : [];
+        cachedCoreMessages = [...cachedCoreMessages, ...newCoreMessages];
+        convertedUpTo = messages.length;
+        const coreMessages = cachedCoreMessages;
 
         const temperature = agent.frontmatter.model?.temperature ?? 0.2;
         const maxTokens = agent.frontmatter.model?.maxTokens;
@@ -1794,6 +1821,7 @@ ${boundedMainMemory.trim()}`
 
         const telemetryEnabled = this.loadedConfig?.telemetry?.enabled !== false;
 
+
         const result = await streamText({
           model: modelInstance,
           system: integrityPrompt,

package/src/memory.ts

@@ -658,10 +658,10 @@ export const createMemoryTools = (
           typeof input.excludeConversationId === "string"
             ? input.excludeConversationId
             : "";
-        const corpus = asRecallCorpus(context.parameters.__conversationRecallCorpus).slice(
-          0,
-          maxRecallConversations,
-        );
+        const rawCorpus = context.parameters.__conversationRecallCorpus;
+        const resolvedCorpus =
+          typeof rawCorpus === "function" ? await (rawCorpus as () => Promise<unknown>)() : rawCorpus;
+        const corpus = asRecallCorpus(resolvedCorpus).slice(0, maxRecallConversations);
         const results = corpus
           .filter((item) =>
             excludeConversationId ? item.conversationId !== excludeConversationId : true,

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,
       }));
   }
 
@@ -646,6 +664,7 @@ class FileStateStore implements StateStore {
 
 interface RawKeyValueClient {
   get(key: string): Promise<string | undefined>;
+  mget(keys: string[]): Promise<(string | undefined)[]>;
   set(key: string, value: string, ttl?: number): Promise<void>;
   del(key: string): Promise<void>;
 }
@@ -659,6 +678,11 @@ type ConversationMeta = {
   parentConversationId?: string;
   messageCount?: number;
   hasPendingApprovals?: boolean;
+  channelMeta?: {
+    platform: string;
+    channelId: string;
+    platformThreadId: string;
+  };
 };
 
 abstract class KeyValueConversationStoreBase implements ConversationStore {
@@ -760,21 +784,18 @@ abstract class KeyValueConversationStoreBase implements ConversationStore {
       return await this.memoryFallback.list(ownerId);
     }
     if (!ownerId) {
-      // KV stores index per-owner; cross-owner listing not supported
       return [];
     }
     const ids = await this.getOwnerConversationIds(ownerId);
+    if (ids.length === 0) return [];
+    const convKeys = await Promise.all(ids.map((id) => this.conversationKey(id)));
+    const rawValues = await kv.mget(convKeys);
     const conversations: Conversation[] = [];
-    for (const id of ids) {
-      const raw = await kv.get(await this.conversationKey(id));
-      if (!raw) {
-        continue;
-      }
+    for (const raw of rawValues) {
+      if (!raw) continue;
       try {
         conversations.push(JSON.parse(raw) as Conversation);
-      } catch {
-        // Skip invalid records.
-      }
+      } catch { /* skip invalid records */ }
     }
     return conversations.sort((a, b) => b.updatedAt - a.updatedAt);
   }
@@ -788,21 +809,28 @@ abstract class KeyValueConversationStoreBase implements ConversationStore {
       return [];
     }
     const ids = await this.getOwnerConversationIds(ownerId);
+    if (ids.length === 0) return [];
+    const metaKeys = await Promise.all(ids.map((id) => this.conversationMetaKey(id)));
+    const rawValues = await kv.mget(metaKeys);
     const summaries: ConversationSummary[] = [];
-    for (const id of ids) {
-      const meta = await this.getConversationMeta(id);
-      if (meta && meta.ownerId === ownerId) {
-        summaries.push({
-          conversationId: meta.conversationId,
-          title: meta.title,
-          updatedAt: meta.updatedAt,
-          createdAt: meta.createdAt,
-          ownerId: meta.ownerId,
-          parentConversationId: meta.parentConversationId,
-          messageCount: meta.messageCount,
-          hasPendingApprovals: meta.hasPendingApprovals,
-        });
-      }
+    for (const raw of rawValues) {
+      if (!raw) continue;
+      try {
+        const meta = JSON.parse(raw) as ConversationMeta;
+        if (meta.ownerId === ownerId) {
+          summaries.push({
+            conversationId: meta.conversationId,
+            title: meta.title,
+            updatedAt: meta.updatedAt,
+            createdAt: meta.createdAt,
+            ownerId: meta.ownerId,
+            parentConversationId: meta.parentConversationId,
+            messageCount: meta.messageCount,
+            hasPendingApprovals: meta.hasPendingApprovals,
+            channelMeta: meta.channelMeta,
+          });
+        }
+      } catch { /* skip invalid records */ }
     }
     return summaries.sort((a, b) => b.updatedAt - a.updatedAt);
   }
@@ -863,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,
     );
@@ -948,6 +977,19 @@ class UpstashConversationStore extends KeyValueConversationStoreBase {
         const payload = (await response.json()) as { result?: string | null };
         return payload.result ?? undefined;
       },
+      mget: async (keys: string[]) => {
+        if (keys.length === 0) return [];
+        const path = keys.map((k) => encodeURIComponent(k)).join("/");
+        const response = await fetch(`${this.baseUrl}/mget/${path}`, {
+          method: "POST",
+          headers: this.headers(),
+        });
+        if (!response.ok) {
+          return keys.map(() => undefined);
+        }
+        const payload = (await response.json()) as { result?: (string | null)[] };
+        return (payload.result ?? []).map((v) => v ?? undefined);
+      },
       set: async (key: string, value: string, ttl?: number) => {
         const endpoint =
           typeof ttl === "number"
@@ -1042,6 +1084,7 @@ class RedisLikeConversationStore extends KeyValueConversationStoreBase {
   private readonly clientPromise: Promise<
     | {
         get: (key: string) => Promise<string | null>;
+        mGet: (keys: readonly string[]) => Promise<(string | null)[]>;
         set: (key: string, value: string, options?: { EX?: number }) => Promise<unknown>;
         del: (key: string) => Promise<unknown>;
       }
@@ -1056,6 +1099,7 @@ class RedisLikeConversationStore extends KeyValueConversationStoreBase {
           createClient: (options: { url: string }) => {
             connect: () => Promise<unknown>;
             get: (key: string) => Promise<string | null>;
+            mGet: (keys: readonly string[]) => Promise<(string | null)[]>;
             set: (key: string, value: string, options?: { EX?: number }) => Promise<unknown>;
             del: (key: string) => Promise<unknown>;
           };
@@ -1079,6 +1123,11 @@ class RedisLikeConversationStore extends KeyValueConversationStoreBase {
         const value = await client.get(key);
         return value ?? undefined;
       },
+      mget: async (keys: string[]) => {
+        if (keys.length === 0) return [];
+        const values = await client.mGet(keys);
+        return values.map((v: string | null) => v ?? undefined);
+      },
       set: async (key: string, value: string, ttl?: number) => {
         if (typeof ttl === "number") {
           await client.set(key, value, { EX: Math.max(1, ttl) });
@@ -1261,6 +1310,18 @@ class DynamoDbConversationStore extends KeyValueConversationStoreBase {
           }),
         );
       },
+      mget: async (keys: string[]) => {
+        if (keys.length === 0) return [];
+        return Promise.all(keys.map(async (key) => {
+          const result = (await client.send(
+            new client.GetItemCommand({
+              TableName: this.table,
+              Key: { runId: { S: key } },
+            }),
+          )) as { Item?: { value?: { S?: string } } };
+          return result.Item?.value?.S;
+        }));
+      },
       del: async (key: string) => {
         await client.send(
           new client.DeleteItemCommand({