@poncho-ai/sdk 0.5.0 → 1.0.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/sdk@0.5.0 build /Users/cesar/Dev/latitude/poncho-ai/packages/sdk
+> @poncho-ai/sdk@1.0.0 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 49ms
+ESM dist/index.js 6.37 KB
+ESM ⚡️ Build success in 20ms
 DTS Build start
-DTS ⚡️ Build success in 1221ms
-DTS dist/index.d.ts 12.51 KB
+DTS ⚡️ Build success in 1218ms
+DTS dist/index.d.ts 13.27 KB

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @poncho-ai/sdk
 
+## 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
+
+- [`a1df23f`](https://github.com/cesr/poncho-ai/commit/a1df23f339d815c30948ebcd275209366a3d2a72) Thanks [@cesr](https://github.com/cesr)! - Add cooperative run cancellation: stop active runs via Ctrl+C (CLI), stop button (Web UI), or the /stop API endpoint. Partial output is preserved and empty assistant messages are skipped to prevent conversation corruption.
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -302,9 +302,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 +329,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 +352,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 +376,8 @@ interface RunResult {
     steps: number;
     tokens: TokenUsage;
     duration: number;
+    continuation?: boolean;
+    maxSteps?: number;
 }
 interface AgentFailure {
     code: string;
@@ -420,4 +443,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

@@ -236,10 +236,15 @@ var fieldsForScope = (scope) => ONBOARDING_FIELDS.filter(
 );
 
 // 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.5.0",
+  "version": "1.0.0",
   "description": "Core types and utilities for building Poncho skills",
   "repository": {
     "type": "git",

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)
-