@poncho-ai/sdk 0.6.0 → 1.0.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/sdk@0.6.0 build /Users/cesar/Dev/latitude/poncho-ai/packages/sdk
+> @poncho-ai/sdk@1.0.1 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.16 KB
-ESM ⚡️ Build success in 64ms
+ESM dist/index.js 7.48 KB
+ESM ⚡️ Build success in 18ms
 DTS Build start
-DTS ⚡️ Build success in 947ms
-DTS dist/index.d.ts 12.51 KB
+DTS ⚡️ Build success in 1173ms
+DTS dist/index.d.ts 14.79 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @poncho-ai/sdk
 
+## 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
+
+- [`035e8b3`](https://github.com/cesr/poncho-ai/commit/035e8b300ac4de6e7cbc4e2ab6bd06cdfd0e1ae3) Thanks [@cesr](https://github.com/cesr)! - Add multimodal file support for agents — images, PDFs, and text files can be uploaded via the web UI, HTTP API, and terminal CLI. Includes pluggable upload storage (local, Vercel Blob, S3), write-behind caching, build-time dependency injection, and graceful handling of unsupported formats.
+
 ## 0.6.0
 
 ### Minor 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,54 @@ 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 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";
+    };
 }];
 declare const FEATURE_DOMAIN_ORDER: readonly FeatureDomain[];
 declare const fieldsForScope: (scope: OnboardingScope) => OnboardingField[];
@@ -302,9 +350,21 @@ type JsonSchema = {
     [key: string]: unknown;
 };
 type Role = "system" | "user" | "assistant" | "tool";
+interface TextContentPart {
+    type: "text";
+    text: string;
+}
+interface FileContentPart {
+    type: "file";
+    /** base64 data, data: URI, https:// URL, or poncho-upload:// reference */
+    data: string;
+    mediaType: string;
+    filename?: string;
+}
+type ContentPart = TextContentPart | FileContentPart;
 interface Message {
     role: Role;
-    content: string;
+    content: string | ContentPart[];
     metadata?: {
         id?: string;
         timestamp?: number;
@@ -317,6 +377,8 @@ interface Message {
         }>;
     };
 }
+/** Extract the text content from a message, regardless of content format. */
+declare const getTextContent: (message: Message) => string;
 interface ToolContext {
     runId: string;
     agentId: string;
@@ -338,10 +400,17 @@ interface ToolDefinition<TInput extends Record<string, unknown> = Record<string,
 }
 declare const defineTool: <TInput extends Record<string, unknown>, TOutput = unknown>(definition: ToolDefinition<TInput, TOutput>) => ToolDefinition<TInput, TOutput>;
 
+interface FileInput {
+    /** base64 data, data: URI, or https:// URL */
+    data: string;
+    mediaType: string;
+    filename?: string;
+}
 interface RunInput {
     task: string;
     parameters?: Record<string, unknown>;
     messages?: Message[];
+    files?: FileInput[];
     abortSignal?: AbortSignal;
 }
 interface TokenUsage {
@@ -355,6 +424,8 @@ interface RunResult {
     steps: number;
     tokens: TokenUsage;
     duration: number;
+    continuation?: boolean;
+    maxSteps?: number;
 }
 interface AgentFailure {
     code: string;
@@ -420,4 +491,4 @@ type AgentEvent = {
     reason?: string;
 };
 
-export { type AgentEvent, type AgentFailure, FEATURE_DOMAIN_ORDER, type FeatureDomain, 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 TokenUsage, type ToolContext, type ToolDefinition, type ToolHandler, defineTool, fieldsForScope };
+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,48 @@ 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" }
+    ]
+  },
+  {
+    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" }
   }
 ];
 var FEATURE_DOMAIN_ORDER = [
@@ -229,17 +271,23 @@ var FEATURE_DOMAIN_ORDER = [
   "memory",
   "auth",
   "telemetry",
-  "mcp"
+  "mcp",
+  "messaging"
 ];
 var fieldsForScope = (scope) => ONBOARDING_FIELDS.filter(
   (field) => field.scopes.includes(scope)
 );
 
 // src/index.ts
+var getTextContent = (message) => {
+  if (typeof message.content === "string") return message.content;
+  return message.content.filter((p) => p.type === "text").map((p) => p.text).join("");
+};
 var defineTool = (definition) => definition;
 export {
   FEATURE_DOMAIN_ORDER,
   ONBOARDING_FIELDS,
   defineTool,
-  fieldsForScope
+  fieldsForScope,
+  getTextContent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poncho-ai/sdk",
-  "version": "0.6.0",
+  "version": "1.0.1",
   "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,48 @@ 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" },
+    ],
+  },
+  {
+    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" },
+  },
 ] as const satisfies readonly OnboardingField[];
 
 export const FEATURE_DOMAIN_ORDER: readonly FeatureDomain[] = [
@@ -275,6 +318,7 @@ export const FEATURE_DOMAIN_ORDER: readonly FeatureDomain[] = [
   "auth",
   "telemetry",
   "mcp",
+  "messaging",
 ] as const;
 
 export const fieldsForScope = (scope: OnboardingScope): OnboardingField[] =>

package/src/index.ts

@@ -11,9 +11,24 @@ export type JsonSchema = {
 
 export type Role = "system" | "user" | "assistant" | "tool";
 
+export interface TextContentPart {
+  type: "text";
+  text: string;
+}
+
+export interface FileContentPart {
+  type: "file";
+  /** base64 data, data: URI, https:// URL, or poncho-upload:// reference */
+  data: string;
+  mediaType: string;
+  filename?: string;
+}
+
+export type ContentPart = TextContentPart | FileContentPart;
+
 export interface Message {
   role: Role;
-  content: string;
+  content: string | ContentPart[];
   metadata?: {
     id?: string;
     timestamp?: number;
@@ -24,6 +39,15 @@ export interface Message {
   };
 }
 
+/** Extract the text content from a message, regardless of content format. */
+export const getTextContent = (message: Message): string => {
+  if (typeof message.content === "string") return message.content;
+  return message.content
+    .filter((p): p is TextContentPart => p.type === "text")
+    .map((p) => p.text)
+    .join("");
+};
+
 export interface ToolContext {
   runId: string;
   agentId: string;
@@ -61,10 +85,18 @@ export const defineTool = <
 
 export * from "./config-registry.js";
 
+export interface FileInput {
+  /** base64 data, data: URI, or https:// URL */
+  data: string;
+  mediaType: string;
+  filename?: string;
+}
+
 export interface RunInput {
   task: string;
   parameters?: Record<string, unknown>;
   messages?: Message[];
+  files?: FileInput[];
   abortSignal?: AbortSignal;
 }
 
@@ -80,6 +112,8 @@ export interface RunResult {
   steps: number;
   tokens: TokenUsage;
   duration: number;
+  continuation?: boolean;
+  maxSteps?: number;
 }
 
 export interface AgentFailure {

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @poncho-ai/sdk@0.1.0 test /Users/cesar/Dev/latitude/agentl/packages/sdk
-> vitest
-
-
- RUN  v1.6.1 /Users/cesar/Dev/latitude/agentl/packages/sdk
-
- ✓ test/sdk.test.ts  (1 test) 2ms
-
- Test Files  1 passed (1)
-      Tests  1 passed (1)
-   Start at  12:05:57
-   Duration  475ms (transform 97ms, setup 0ms, collect 90ms, tests 2ms, environment 0ms, prepare 102ms)
-