@poncho-ai/sdk 1.0.1 → 1.0.3

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.3 build /Users/cesar/Dev/latitude/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 10.17 KB
+ESM ⚡️ Build success in 46ms
 DTS Build start
-DTS ⚡️ Build success in 1173ms
-DTS dist/index.d.ts 14.79 KB
+DTS ⚡️ Build success in 1504ms
+DTS dist/index.d.ts 18.86 KB

package/.turbo/turbo-lint.log

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

package/.turbo/turbo-test.log

@@ -0,0 +1,14 @@
+
+> @poncho-ai/sdk@1.0.1 test /Users/cesar/Dev/latitude/poncho-ai/packages/sdk
+> vitest
+
+
+ RUN  v1.6.1 /Users/cesar/Dev/latitude/poncho-ai/packages/sdk
+
+ ✓ test/sdk.test.ts  (1 test) 1ms
+
+ Test Files  1 passed (1)
+      Tests  1 passed (1)
+   Start at  09:39:17
+   Duration  477ms (transform 131ms, setup 0ms, collect 143ms, tests 1ms, environment 0ms, prepare 103ms)
+

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @poncho-ai/sdk
 
+## 1.0.3
+
+### Patch Changes
+
+- [`1f47bb4`](https://github.com/cesr/poncho-ai/commit/1f47bb49e5d48dc17644172012b057190b316469) Thanks [@cesr](https://github.com/cesr)! - Add conversation rename via double-click on the title in the web UI, standardize all credential config fields to the `*Env` naming pattern, and sync the init README template with the repo README.
+
+## 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

@@ -136,29 +136,47 @@ declare const ONBOARDING_FIELDS: readonly [{
         readonly envVars: ["PONCHO_DYNAMODB_TABLE"];
     }];
 }, {
-    readonly id: "storage.url";
+    readonly id: "env.REDIS_URL";
     readonly domain: "storage";
-    readonly target: "config";
-    readonly path: "storage.url";
+    readonly target: "env";
+    readonly path: "REDIS_URL";
     readonly kind: "string";
     readonly scopes: ["full"];
-    readonly label: "Storage URL";
-    readonly prompt: "Storage URL";
+    readonly label: "Redis URL";
+    readonly prompt: "Redis connection URL";
     readonly defaultValue: "";
+    readonly placeholder: "redis://localhost:6379";
+    readonly secret: true;
     readonly dependsOn: {
         readonly fieldId: "storage.provider";
-        readonly oneOf: ["redis", "upstash"];
+        readonly equals: "redis";
     };
 }, {
-    readonly id: "storage.token";
+    readonly id: "env.UPSTASH_REDIS_REST_URL";
     readonly domain: "storage";
-    readonly target: "config";
-    readonly path: "storage.token";
+    readonly target: "env";
+    readonly path: "UPSTASH_REDIS_REST_URL";
     readonly kind: "string";
     readonly scopes: ["full"];
-    readonly label: "Storage token";
-    readonly prompt: "Storage token";
+    readonly label: "Upstash REST URL";
+    readonly prompt: "Upstash Redis REST URL";
     readonly defaultValue: "";
+    readonly placeholder: "https://...";
+    readonly dependsOn: {
+        readonly fieldId: "storage.provider";
+        readonly equals: "upstash";
+    };
+}, {
+    readonly id: "env.UPSTASH_REDIS_REST_TOKEN";
+    readonly domain: "storage";
+    readonly target: "env";
+    readonly path: "UPSTASH_REDIS_REST_TOKEN";
+    readonly kind: "string";
+    readonly scopes: ["full"];
+    readonly label: "Upstash REST token";
+    readonly prompt: "Upstash Redis REST token";
+    readonly defaultValue: "";
+    readonly secret: true;
     readonly dependsOn: {
         readonly fieldId: "storage.provider";
         readonly equals: "upstash";
@@ -303,6 +321,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 +356,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 +511,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 +542,7 @@ type AgentEvent = {
     type: "run:started";
     runId: string;
     agentId: string;
+    contextWindow?: number;
 } | {
     type: "run:completed";
     runId: string;
@@ -489,6 +596,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

@@ -88,27 +88,43 @@ var ONBOARDING_FIELDS = [
     ]
   },
   {
-    id: "storage.url",
+    id: "env.REDIS_URL",
     domain: "storage",
-    target: "config",
-    path: "storage.url",
+    target: "env",
+    path: "REDIS_URL",
     kind: "string",
     scopes: ["full"],
-    label: "Storage URL",
-    prompt: "Storage URL",
+    label: "Redis URL",
+    prompt: "Redis connection URL",
     defaultValue: "",
-    dependsOn: { fieldId: "storage.provider", oneOf: ["redis", "upstash"] }
+    placeholder: "redis://localhost:6379",
+    secret: true,
+    dependsOn: { fieldId: "storage.provider", equals: "redis" }
   },
   {
-    id: "storage.token",
+    id: "env.UPSTASH_REDIS_REST_URL",
     domain: "storage",
-    target: "config",
-    path: "storage.token",
+    target: "env",
+    path: "UPSTASH_REDIS_REST_URL",
+    kind: "string",
+    scopes: ["full"],
+    label: "Upstash REST URL",
+    prompt: "Upstash Redis REST URL",
+    defaultValue: "",
+    placeholder: "https://...",
+    dependsOn: { fieldId: "storage.provider", equals: "upstash" }
+  },
+  {
+    id: "env.UPSTASH_REDIS_REST_TOKEN",
+    domain: "storage",
+    target: "env",
+    path: "UPSTASH_REDIS_REST_TOKEN",
     kind: "string",
     scopes: ["full"],
-    label: "Storage token",
-    prompt: "Storage token",
+    label: "Upstash REST token",
+    prompt: "Upstash Redis REST token",
     defaultValue: "",
+    secret: true,
     dependsOn: { fieldId: "storage.provider", equals: "upstash" }
   },
   {
@@ -233,7 +249,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 +279,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.3",
   "description": "Core types and utilities for building Poncho skills",
   "repository": {
     "type": "git",

package/src/config-registry.ts

@@ -133,27 +133,43 @@ export const ONBOARDING_FIELDS = [
     ],
   },
   {
-    id: "storage.url",
+    id: "env.REDIS_URL",
     domain: "storage",
-    target: "config",
-    path: "storage.url",
+    target: "env",
+    path: "REDIS_URL",
     kind: "string",
     scopes: ["full"],
-    label: "Storage URL",
-    prompt: "Storage URL",
+    label: "Redis URL",
+    prompt: "Redis connection URL",
     defaultValue: "",
-    dependsOn: { fieldId: "storage.provider", oneOf: ["redis", "upstash"] },
+    placeholder: "redis://localhost:6379",
+    secret: true,
+    dependsOn: { fieldId: "storage.provider", equals: "redis" },
   },
   {
-    id: "storage.token",
+    id: "env.UPSTASH_REDIS_REST_URL",
     domain: "storage",
-    target: "config",
-    path: "storage.token",
+    target: "env",
+    path: "UPSTASH_REDIS_REST_URL",
+    kind: "string",
+    scopes: ["full"],
+    label: "Upstash REST URL",
+    prompt: "Upstash Redis REST URL",
+    defaultValue: "",
+    placeholder: "https://...",
+    dependsOn: { fieldId: "storage.provider", equals: "upstash" },
+  },
+  {
+    id: "env.UPSTASH_REDIS_REST_TOKEN",
+    domain: "storage",
+    target: "env",
+    path: "UPSTASH_REDIS_REST_TOKEN",
     kind: "string",
     scopes: ["full"],
-    label: "Storage token",
-    prompt: "Storage token",
+    label: "Upstash REST token",
+    prompt: "Upstash Redis REST token",
     defaultValue: "",
+    secret: true,
     dependsOn: { fieldId: "storage.provider", equals: "upstash" },
   },
   {
@@ -279,6 +295,7 @@ export const ONBOARDING_FIELDS = [
     options: [
       { value: "none", label: "None" },
       { value: "slack", label: "Slack" },
+      { value: "resend", label: "Email (Resend)" },
     ],
   },
   {
@@ -308,6 +325,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> }>;
+    };