@poncho-ai/sdk 1.0.0 → 1.0.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/sdk@1.0.0 build /home/runner/work/poncho-ai/poncho-ai/packages/sdk
+> @poncho-ai/sdk@1.0.2 build /home/runner/work/poncho-ai/poncho-ai/packages/sdk
 > 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 6.37 KB
-ESM ⚡️ Build success in 20ms
+ESM dist/index.js 9.72 KB
+ESM ⚡️ Build success in 17ms
 DTS Build start
-DTS ⚡️ Build success in 1218ms
-DTS dist/index.d.ts 13.27 KB
+DTS ⚡️ Build success in 1275ms
+DTS dist/index.d.ts 18.25 KB

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @poncho-ai/sdk
 
+## 1.0.2
+
+### Patch Changes
+
+- [`e000b96`](https://github.com/cesr/poncho-ai/commit/e000b96837cbbb8d95c868c91a614f458868c444) Thanks [@cesr](https://github.com/cesr)! - Durable approval checkpoints, email conversation improvements, and web UI fixes
+  - Simplify approval system to checkpoint-only (remove legacy blocking approvalHandler)
+  - Optimize checkpoint storage with delta messages instead of full history
+  - Add sidebar sections for conversations awaiting approval with status indicator
+  - Fix nested checkpoint missing baseMessageCount in resumeRunFromCheckpoint
+  - Improve email conversation titles (sender email + subject)
+  - Remove email threading — each incoming email creates its own conversation
+  - Fix streaming after approval to preserve existing messages (liveOnly mode)
+  - Preserve newlines in user messages in web UI
+
+## 1.0.1
+
+### Patch Changes
+
+- [#10](https://github.com/cesr/poncho-ai/pull/10) [`d5bce7b`](https://github.com/cesr/poncho-ai/commit/d5bce7be5890c657bea915eb0926feb6de66b218) Thanks [@cesr](https://github.com/cesr)! - Add generic messaging layer with Slack as the first adapter. Agents can now respond to @mentions in Slack by adding `messaging: [{ platform: 'slack' }]` to `poncho.config.js`. Includes signature verification, threaded conversations, processing indicators, and Vercel `waitUntil` support.
+
 ## 1.0.0
 
 ### Major Changes

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 type OnboardingScope = "light" | "full";
-type FeatureDomain = "model" | "deploy" | "storage" | "memory" | "auth" | "telemetry" | "mcp";
+type FeatureDomain = "model" | "deploy" | "storage" | "memory" | "auth" | "telemetry" | "mcp" | "messaging";
 type OnboardingFieldTarget = "agent" | "config" | "env";
 type OnboardingFieldKind = "select" | "boolean" | "string" | "number";
 type OnboardingFieldCondition = {
@@ -287,6 +287,140 @@ declare const ONBOARDING_FIELDS: readonly [{
         readonly fieldId: "telemetry.enabled";
         readonly equals: true;
     };
+}, {
+    readonly id: "messaging.platform";
+    readonly domain: "messaging";
+    readonly target: "agent";
+    readonly path: "messaging.platform";
+    readonly kind: "select";
+    readonly scopes: ["full"];
+    readonly label: "Messaging platform";
+    readonly prompt: "Connect to a messaging platform? (optional)";
+    readonly defaultValue: "none";
+    readonly options: [{
+        readonly value: "none";
+        readonly label: "None";
+    }, {
+        readonly value: "slack";
+        readonly label: "Slack";
+    }, {
+        readonly value: "resend";
+        readonly label: "Email (Resend)";
+    }];
+}, {
+    readonly id: "env.SLACK_BOT_TOKEN";
+    readonly domain: "messaging";
+    readonly target: "env";
+    readonly path: "SLACK_BOT_TOKEN";
+    readonly kind: "string";
+    readonly scopes: ["full"];
+    readonly label: "Slack Bot Token";
+    readonly prompt: "Slack Bot Token (from OAuth & Permissions)";
+    readonly defaultValue: "";
+    readonly placeholder: "xoxb-...";
+    readonly secret: true;
+    readonly dependsOn: {
+        readonly fieldId: "messaging.platform";
+        readonly equals: "slack";
+    };
+}, {
+    readonly id: "env.SLACK_SIGNING_SECRET";
+    readonly domain: "messaging";
+    readonly target: "env";
+    readonly path: "SLACK_SIGNING_SECRET";
+    readonly kind: "string";
+    readonly scopes: ["full"];
+    readonly label: "Slack Signing Secret";
+    readonly prompt: "Slack Signing Secret (from Basic Information)";
+    readonly defaultValue: "";
+    readonly secret: true;
+    readonly dependsOn: {
+        readonly fieldId: "messaging.platform";
+        readonly equals: "slack";
+    };
+}, {
+    readonly id: "env.RESEND_API_KEY";
+    readonly domain: "messaging";
+    readonly target: "env";
+    readonly path: "RESEND_API_KEY";
+    readonly kind: "string";
+    readonly scopes: ["full"];
+    readonly label: "Resend API Key";
+    readonly prompt: "Resend API Key (from resend.com/api-keys)";
+    readonly defaultValue: "";
+    readonly placeholder: "re_...";
+    readonly secret: true;
+    readonly dependsOn: {
+        readonly fieldId: "messaging.platform";
+        readonly equals: "resend";
+    };
+}, {
+    readonly id: "env.RESEND_WEBHOOK_SECRET";
+    readonly domain: "messaging";
+    readonly target: "env";
+    readonly path: "RESEND_WEBHOOK_SECRET";
+    readonly kind: "string";
+    readonly scopes: ["full"];
+    readonly label: "Resend Webhook Secret";
+    readonly prompt: "Resend Webhook Signing Secret (from webhook details page)";
+    readonly defaultValue: "";
+    readonly placeholder: "whsec_...";
+    readonly secret: true;
+    readonly dependsOn: {
+        readonly fieldId: "messaging.platform";
+        readonly equals: "resend";
+    };
+}, {
+    readonly id: "env.RESEND_FROM";
+    readonly domain: "messaging";
+    readonly target: "env";
+    readonly path: "RESEND_FROM";
+    readonly kind: "string";
+    readonly scopes: ["full"];
+    readonly label: "From Address";
+    readonly prompt: "Email address the agent sends from (e.g. Agent <agent@yourdomain.com>)";
+    readonly defaultValue: "";
+    readonly placeholder: "Agent <agent@yourdomain.com>";
+    readonly dependsOn: {
+        readonly fieldId: "messaging.platform";
+        readonly equals: "resend";
+    };
+}, {
+    readonly id: "messaging.resend.mode";
+    readonly domain: "messaging";
+    readonly target: "agent";
+    readonly path: "messaging.resend.mode";
+    readonly kind: "select";
+    readonly scopes: ["full"];
+    readonly label: "Email response mode";
+    readonly prompt: "How should the agent respond to emails?";
+    readonly defaultValue: "auto-reply";
+    readonly options: [{
+        readonly value: "auto-reply";
+        readonly label: "Auto-reply (agent response sent as email reply)";
+    }, {
+        readonly value: "tool";
+        readonly label: "Tool (agent uses send_email tool for full control)";
+    }];
+    readonly dependsOn: {
+        readonly fieldId: "messaging.platform";
+        readonly equals: "resend";
+    };
+}, {
+    readonly id: "messaging.resend.allowedRecipients";
+    readonly domain: "messaging";
+    readonly target: "agent";
+    readonly path: "messaging.resend.allowedRecipients";
+    readonly kind: "string";
+    readonly scopes: ["full"];
+    readonly label: "Allowed recipients";
+    readonly prompt: "Allowed recipient patterns for send_email tool (comma-separated, e.g. *@mycompany.com). Leave empty for no restrictions.";
+    readonly defaultValue: "";
+    readonly placeholder: "*@mycompany.com, partner@external.com";
+    readonly dependsOn: {
+        readonly fieldId: "messaging.resend.mode";
+        readonly equals: "tool";
+    };
 }];
 declare const FEATURE_DOMAIN_ORDER: readonly FeatureDomain[];
 declare const fieldsForScope: (scope: OnboardingScope) => OnboardingField[];
@@ -359,11 +493,13 @@ interface FileInput {
     filename?: string;
 }
 interface RunInput {
-    task: string;
+    task?: string;
     parameters?: Record<string, unknown>;
     messages?: Message[];
     files?: FileInput[];
     abortSignal?: AbortSignal;
+    /** When set, Latitude telemetry groups all turns in this conversation under a single trace. */
+    conversationId?: string;
 }
 interface TokenUsage {
     input: number;
@@ -388,6 +524,7 @@ type AgentEvent = {
     type: "run:started";
     runId: string;
     agentId: string;
+    contextWindow?: number;
 } | {
     type: "run:completed";
     runId: string;
@@ -441,6 +578,18 @@ type AgentEvent = {
     type: "tool:approval:denied";
     approvalId: string;
     reason?: string;
+} | {
+    type: "tool:approval:checkpoint";
+    approvalId: string;
+    tool: string;
+    toolCallId: string;
+    input: Record<string, unknown>;
+    checkpointMessages: Message[];
+    pendingToolCalls: Array<{
+        id: string;
+        name: string;
+        input: Record<string, unknown>;
+    }>;
 };
 
 export { type AgentEvent, type AgentFailure, type ContentPart, FEATURE_DOMAIN_ORDER, type FeatureDomain, type FileContentPart, type FileInput, type JsonSchema, type Message, ONBOARDING_FIELDS, type OnboardingField, type OnboardingFieldCondition, type OnboardingFieldKind, type OnboardingFieldTarget, type OnboardingOption, type OnboardingScope, type Role, type RunInput, type RunResult, type TextContentPart, type TokenUsage, type ToolContext, type ToolDefinition, type ToolHandler, defineTool, fieldsForScope, getTextContent };

package/dist/index.js

@@ -220,6 +220,119 @@ var ONBOARDING_FIELDS = [
     prompt: "OTLP endpoint (optional)",
     defaultValue: "",
     dependsOn: { fieldId: "telemetry.enabled", equals: true }
+  },
+  {
+    id: "messaging.platform",
+    domain: "messaging",
+    target: "agent",
+    path: "messaging.platform",
+    kind: "select",
+    scopes: ["full"],
+    label: "Messaging platform",
+    prompt: "Connect to a messaging platform? (optional)",
+    defaultValue: "none",
+    options: [
+      { value: "none", label: "None" },
+      { value: "slack", label: "Slack" },
+      { value: "resend", label: "Email (Resend)" }
+    ]
+  },
+  {
+    id: "env.SLACK_BOT_TOKEN",
+    domain: "messaging",
+    target: "env",
+    path: "SLACK_BOT_TOKEN",
+    kind: "string",
+    scopes: ["full"],
+    label: "Slack Bot Token",
+    prompt: "Slack Bot Token (from OAuth & Permissions)",
+    defaultValue: "",
+    placeholder: "xoxb-...",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "slack" }
+  },
+  {
+    id: "env.SLACK_SIGNING_SECRET",
+    domain: "messaging",
+    target: "env",
+    path: "SLACK_SIGNING_SECRET",
+    kind: "string",
+    scopes: ["full"],
+    label: "Slack Signing Secret",
+    prompt: "Slack Signing Secret (from Basic Information)",
+    defaultValue: "",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "slack" }
+  },
+  {
+    id: "env.RESEND_API_KEY",
+    domain: "messaging",
+    target: "env",
+    path: "RESEND_API_KEY",
+    kind: "string",
+    scopes: ["full"],
+    label: "Resend API Key",
+    prompt: "Resend API Key (from resend.com/api-keys)",
+    defaultValue: "",
+    placeholder: "re_...",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" }
+  },
+  {
+    id: "env.RESEND_WEBHOOK_SECRET",
+    domain: "messaging",
+    target: "env",
+    path: "RESEND_WEBHOOK_SECRET",
+    kind: "string",
+    scopes: ["full"],
+    label: "Resend Webhook Secret",
+    prompt: "Resend Webhook Signing Secret (from webhook details page)",
+    defaultValue: "",
+    placeholder: "whsec_...",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" }
+  },
+  {
+    id: "env.RESEND_FROM",
+    domain: "messaging",
+    target: "env",
+    path: "RESEND_FROM",
+    kind: "string",
+    scopes: ["full"],
+    label: "From Address",
+    prompt: "Email address the agent sends from (e.g. Agent <agent@yourdomain.com>)",
+    defaultValue: "",
+    placeholder: "Agent <agent@yourdomain.com>",
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" }
+  },
+  {
+    id: "messaging.resend.mode",
+    domain: "messaging",
+    target: "agent",
+    path: "messaging.resend.mode",
+    kind: "select",
+    scopes: ["full"],
+    label: "Email response mode",
+    prompt: "How should the agent respond to emails?",
+    defaultValue: "auto-reply",
+    options: [
+      { value: "auto-reply", label: "Auto-reply (agent response sent as email reply)" },
+      { value: "tool", label: "Tool (agent uses send_email tool for full control)" }
+    ],
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" }
+  },
+  {
+    id: "messaging.resend.allowedRecipients",
+    domain: "messaging",
+    target: "agent",
+    path: "messaging.resend.allowedRecipients",
+    kind: "string",
+    scopes: ["full"],
+    label: "Allowed recipients",
+    prompt: "Allowed recipient patterns for send_email tool (comma-separated, e.g. *@mycompany.com). Leave empty for no restrictions.",
+    defaultValue: "",
+    placeholder: "*@mycompany.com, partner@external.com",
+    dependsOn: { fieldId: "messaging.resend.mode", equals: "tool" }
   }
 ];
 var FEATURE_DOMAIN_ORDER = [
@@ -229,7 +342,8 @@ var FEATURE_DOMAIN_ORDER = [
   "memory",
   "auth",
   "telemetry",
-  "mcp"
+  "mcp",
+  "messaging"
 ];
 var fieldsForScope = (scope) => ONBOARDING_FIELDS.filter(
   (field) => field.scopes.includes(scope)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/sdk",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Core types and utilities for building Poncho skills",
   "repository": {
     "type": "git",

package/src/config-registry.ts

@@ -7,7 +7,8 @@ export type FeatureDomain =
   | "memory"
   | "auth"
   | "telemetry"
-  | "mcp";
+  | "mcp"
+  | "messaging";
 
 export type OnboardingFieldTarget = "agent" | "config" | "env";
 
@@ -265,6 +266,119 @@ export const ONBOARDING_FIELDS = [
     defaultValue: "",
     dependsOn: { fieldId: "telemetry.enabled", equals: true },
   },
+  {
+    id: "messaging.platform",
+    domain: "messaging",
+    target: "agent",
+    path: "messaging.platform",
+    kind: "select",
+    scopes: ["full"],
+    label: "Messaging platform",
+    prompt: "Connect to a messaging platform? (optional)",
+    defaultValue: "none",
+    options: [
+      { value: "none", label: "None" },
+      { value: "slack", label: "Slack" },
+      { value: "resend", label: "Email (Resend)" },
+    ],
+  },
+  {
+    id: "env.SLACK_BOT_TOKEN",
+    domain: "messaging",
+    target: "env",
+    path: "SLACK_BOT_TOKEN",
+    kind: "string",
+    scopes: ["full"],
+    label: "Slack Bot Token",
+    prompt: "Slack Bot Token (from OAuth & Permissions)",
+    defaultValue: "",
+    placeholder: "xoxb-...",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "slack" },
+  },
+  {
+    id: "env.SLACK_SIGNING_SECRET",
+    domain: "messaging",
+    target: "env",
+    path: "SLACK_SIGNING_SECRET",
+    kind: "string",
+    scopes: ["full"],
+    label: "Slack Signing Secret",
+    prompt: "Slack Signing Secret (from Basic Information)",
+    defaultValue: "",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "slack" },
+  },
+  {
+    id: "env.RESEND_API_KEY",
+    domain: "messaging",
+    target: "env",
+    path: "RESEND_API_KEY",
+    kind: "string",
+    scopes: ["full"],
+    label: "Resend API Key",
+    prompt: "Resend API Key (from resend.com/api-keys)",
+    defaultValue: "",
+    placeholder: "re_...",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" },
+  },
+  {
+    id: "env.RESEND_WEBHOOK_SECRET",
+    domain: "messaging",
+    target: "env",
+    path: "RESEND_WEBHOOK_SECRET",
+    kind: "string",
+    scopes: ["full"],
+    label: "Resend Webhook Secret",
+    prompt: "Resend Webhook Signing Secret (from webhook details page)",
+    defaultValue: "",
+    placeholder: "whsec_...",
+    secret: true,
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" },
+  },
+  {
+    id: "env.RESEND_FROM",
+    domain: "messaging",
+    target: "env",
+    path: "RESEND_FROM",
+    kind: "string",
+    scopes: ["full"],
+    label: "From Address",
+    prompt: "Email address the agent sends from (e.g. Agent <agent@yourdomain.com>)",
+    defaultValue: "",
+    placeholder: "Agent <agent@yourdomain.com>",
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" },
+  },
+  {
+    id: "messaging.resend.mode",
+    domain: "messaging",
+    target: "agent",
+    path: "messaging.resend.mode",
+    kind: "select",
+    scopes: ["full"],
+    label: "Email response mode",
+    prompt: "How should the agent respond to emails?",
+    defaultValue: "auto-reply",
+    options: [
+      { value: "auto-reply", label: "Auto-reply (agent response sent as email reply)" },
+      { value: "tool", label: "Tool (agent uses send_email tool for full control)" },
+    ],
+    dependsOn: { fieldId: "messaging.platform", equals: "resend" },
+  },
+  {
+    id: "messaging.resend.allowedRecipients",
+    domain: "messaging",
+    target: "agent",
+    path: "messaging.resend.allowedRecipients",
+    kind: "string",
+    scopes: ["full"],
+    label: "Allowed recipients",
+    prompt: "Allowed recipient patterns for send_email tool (comma-separated, e.g. *@mycompany.com). Leave empty for no restrictions.",
+    defaultValue: "",
+    placeholder: "*@mycompany.com, partner@external.com",
+    dependsOn: { fieldId: "messaging.resend.mode", equals: "tool" },
+  },
 ] as const satisfies readonly OnboardingField[];
 
 export const FEATURE_DOMAIN_ORDER: readonly FeatureDomain[] = [
@@ -275,6 +389,7 @@ export const FEATURE_DOMAIN_ORDER: readonly FeatureDomain[] = [
   "auth",
   "telemetry",
   "mcp",
+  "messaging",
 ] as const;
 
 export const fieldsForScope = (scope: OnboardingScope): OnboardingField[] =>

package/src/index.ts

@@ -93,11 +93,13 @@ export interface FileInput {
 }
 
 export interface RunInput {
-  task: string;
+  task?: string;
   parameters?: Record<string, unknown>;
   messages?: Message[];
   files?: FileInput[];
   abortSignal?: AbortSignal;
+  /** When set, Latitude telemetry groups all turns in this conversation under a single trace. */
+  conversationId?: string;
 }
 
 export interface TokenUsage {
@@ -123,7 +125,7 @@ export interface AgentFailure {
 }
 
 export type AgentEvent =
-  | { type: "run:started"; runId: string; agentId: string }
+  | { type: "run:started"; runId: string; agentId: string; contextWindow?: number }
   | { type: "run:completed"; runId: string; result: RunResult }
   | { type: "run:cancelled"; runId: string }
   | { type: "run:error"; runId: string; error: AgentFailure }
@@ -142,4 +144,13 @@ export type AgentEvent =
       approvalId: string;
     }
   | { type: "tool:approval:granted"; approvalId: string }
-  | { type: "tool:approval:denied"; approvalId: string; reason?: string };
+  | { type: "tool:approval:denied"; approvalId: string; reason?: string }
+  | {
+      type: "tool:approval:checkpoint";
+      approvalId: string;
+      tool: string;
+      toolCallId: string;
+      input: Record<string, unknown>;
+      checkpointMessages: Message[];
+      pendingToolCalls: Array<{ id: string; name: string; input: Record<string, unknown> }>;
+    };