@poncho-ai/sdk 1.0.1 → 1.0.2

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/sdk@1.0.1 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 7.48 KB
-ESM ⚡️ Build success in 18ms
+ESM dist/index.js 9.72 KB
+ESM ⚡️ Build success in 17ms
 DTS Build start
-DTS ⚡️ Build success in 1173ms
-DTS dist/index.d.ts 14.79 KB
+DTS ⚡️ Build success in 1275ms
+DTS dist/index.d.ts 18.25 KB

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @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

package/dist/index.d.ts

@@ -303,6 +303,9 @@ declare const ONBOARDING_FIELDS: readonly [{
     }, {
         readonly value: "slack";
         readonly label: "Slack";
+    }, {
+        readonly value: "resend";
+        readonly label: "Email (Resend)";
     }];
 }, {
     readonly id: "env.SLACK_BOT_TOKEN";
@@ -335,6 +338,89 @@ declare const ONBOARDING_FIELDS: readonly [{
         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[];
@@ -407,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;
@@ -436,6 +524,7 @@ type AgentEvent = {
     type: "run:started";
     runId: string;
     agentId: string;
+    contextWindow?: number;
 } | {
     type: "run:completed";
     runId: string;
@@ -489,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

@@ -233,7 +233,8 @@ var ONBOARDING_FIELDS = [
     defaultValue: "none",
     options: [
       { value: "none", label: "None" },
-      { value: "slack", label: "Slack" }
+      { value: "slack", label: "Slack" },
+      { value: "resend", label: "Email (Resend)" }
     ]
   },
   {
@@ -262,6 +263,76 @@ var ONBOARDING_FIELDS = [
     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 = [

package/package.json

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

package/src/config-registry.ts

@@ -279,6 +279,7 @@ export const ONBOARDING_FIELDS = [
     options: [
       { value: "none", label: "None" },
       { value: "slack", label: "Slack" },
+      { value: "resend", label: "Email (Resend)" },
     ],
   },
   {
@@ -308,6 +309,76 @@ export const ONBOARDING_FIELDS = [
     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[] = [

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> }>;
+    };