@poncho-ai/sdk 1.8.0 → 1.8.1

package/.turbo/turbo-build.log

@@ -1,14 +1,14 @@
 
-> @poncho-ai/sdk@1.7.1 build /Users/cesar/Dev/latitude/poncho-ai/packages/sdk
+> @poncho-ai/sdk@1.8.1 build /home/runner/work/poncho-ai/poncho-ai/packages/sdk
 > tsup src/index.ts --format esm --dts
 
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Target: es2022
-ESM Build start
-ESM dist/index.js 12.46 KB
-ESM ⚡️ Build success in 21ms
-DTS Build start
-DTS ⚡️ Build success in 1577ms
-DTS dist/index.d.ts 24.03 KB
+CLI Building entry: src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Target: es2022
+ESM Build start
+ESM dist/index.js 12.46 KB
+ESM ⚡️ Build success in 16ms
+DTS Build start
+DTS ⚡️ Build success in 1193ms
+DTS dist/index.d.ts 24.92 KB

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @poncho-ai/sdk
 
+## 1.8.1
+
+### Patch Changes
+
+- Add VfsAccess interface and expand ToolContext with optional `vfs` field for tenant-scoped virtual filesystem access in tool handlers.
+
 ## 1.8.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -570,6 +570,27 @@ interface Message {
 }
 /** Extract the text content from a message, regardless of content format. */
 declare const getTextContent: (message: Message) => string;
+/** Virtual filesystem scoped to the current tenant. Available when VFS is enabled. */
+interface VfsAccess {
+    readFile(path: string): Promise<Uint8Array>;
+    readText(path: string): Promise<string>;
+    writeFile(path: string, content: Uint8Array, mimeType?: string): Promise<void>;
+    writeText(path: string, content: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<{
+        size: number;
+        isDirectory: boolean;
+        mimeType?: string;
+        updatedAt: number;
+    }>;
+    readdir(path: string): Promise<string[]>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rm(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+}
 interface ToolContext {
     runId: string;
     agentId: string;
@@ -580,6 +601,8 @@ interface ToolContext {
     conversationId?: string;
     /** The tenant ID when running in multi-tenant mode. */
     tenantId?: string;
+    /** Virtual filesystem scoped to the current tenant. Available when VFS is enabled. */
+    vfs?: VfsAccess;
 }
 type ToolHandler<TInput extends Record<string, unknown>, TOutput> = (input: TInput, context: ToolContext) => Promise<TOutput> | TOutput;
 interface ToolDefinition<TInput extends Record<string, unknown> = Record<string, unknown>, TOutput = unknown> {
@@ -685,6 +708,7 @@ type AgentEvent = {
 } | {
     type: "tool:completed";
     tool: string;
+    input?: unknown;
     output: unknown;
     duration: number;
     outputTokenEstimate?: number;
@@ -771,4 +795,4 @@ type AgentEvent = {
     reason: string;
 };
 
-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 };
+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, type VfsAccess, defineTool, fieldsForScope, getTextContent };

package/package.json

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

package/src/index.ts

@@ -50,6 +50,24 @@ export const getTextContent = (message: Message): string => {
     .join("");
 };
 
+/** Virtual filesystem scoped to the current tenant. Available when VFS is enabled. */
+export interface VfsAccess {
+  readFile(path: string): Promise<Uint8Array>;
+  readText(path: string): Promise<string>;
+  writeFile(path: string, content: Uint8Array, mimeType?: string): Promise<void>;
+  writeText(path: string, content: string): Promise<void>;
+  exists(path: string): Promise<boolean>;
+  stat(path: string): Promise<{
+    size: number;
+    isDirectory: boolean;
+    mimeType?: string;
+    updatedAt: number;
+  }>;
+  readdir(path: string): Promise<string[]>;
+  mkdir(path: string, options?: { recursive?: boolean }): Promise<void>;
+  rm(path: string, options?: { recursive?: boolean }): Promise<void>;
+}
+
 export interface ToolContext {
   runId: string;
   agentId: string;
@@ -60,6 +78,8 @@ export interface ToolContext {
   conversationId?: string;
   /** The tenant ID when running in multi-tenant mode. */
   tenantId?: string;
+  /** Virtual filesystem scoped to the current tenant. Available when VFS is enabled. */
+  vfs?: VfsAccess;
 }
 
 export type ToolHandler<TInput extends Record<string, unknown>, TOutput> = (
@@ -154,7 +174,7 @@ export type AgentEvent =
   | { type: "model:response"; usage: TokenUsage }
   | { type: "tool:generating"; tool: string; toolCallId: string }
   | { type: "tool:started"; tool: string; input: unknown }
-  | { type: "tool:completed"; tool: string; output: unknown; duration: number; outputTokenEstimate?: number }
+  | { type: "tool:completed"; tool: string; input?: unknown; output: unknown; duration: number; outputTokenEstimate?: number }
   | { type: "tool:error"; tool: string; error: string; recoverable: boolean }
   | {
       type: "tool:approval:required";

package/.turbo/turbo-lint.log

@@ -1,6 +0,0 @@
-
-> @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.