@perstack/core 0.0.42 → 0.0.44

package/README.md

@@ -48,63 +48,30 @@ export const apiExpertSchema = expertSchema.omit({
 
 2. **Domain Common Types**: Types that represent core domain concepts used throughout the system, for example:
     - `Job` - Top-level execution unit containing Runs
-    - `Run` - Single Expert execution within a Job
+    - `RunParams` - Single Expert execution within a Job (setting + optional checkpoint)
     - `Checkpoint` - Execution state snapshots
     - `Usage` - Resource usage tracking
     - `ProviderConfig` - LLM provider configurations
 
 3. **Configuration Schemas**: System-wide configuration structures, for example:
-    - `PerstackToml` - Project configuration file schema
-    - `JobSetting` - Job execution parameters
+    - `PerstackConfig` - Project configuration file schema
     - `RunSetting` - Run execution parameters
 
-4. **Adapter Abstractions**: Runtime adapter interfaces and base classes:
-    - `RuntimeAdapter` - Interface for runtime adapters
-    - `BaseAdapter` - Abstract base class for CLI-based adapters
-    - `AdapterRunParams`, `AdapterRunResult` - Adapter execution types
-    - Event creators for normalized checkpoint/event handling
-
-5. **Storage Abstractions**: Abstract interface for data persistence:
-    - `Storage` - Interface for storage backends (filesystem, S3, R2)
-    - `EventMeta` - Metadata type for event listings
+4. **Event Creators**: Utility functions for creating normalized events:
+    - `createNormalizedCheckpoint` - Create checkpoint objects
+    - `createStartRunEvent`, `createCompleteRunEvent` - Run lifecycle events
+    - `createCallToolsEvent`, `createResolveToolResultsEvent` - Tool execution events
 
 ### Execution Hierarchy
 
 | Schema       | Description                                  |
 | ------------ | -------------------------------------------- |
 | `Job`        | Top-level execution unit. Contains all Runs. |
-| `Run`        | Single Expert execution within a Job.        |
+| `RunParams`  | Single Expert execution within a Job.        |
 | `Checkpoint` | Snapshot at step end within a Run.           |
 
 For the full hierarchy and execution model, see [State Management](https://github.com/perstack-ai/perstack/blob/main/docs/using-experts/state-management.md).
 
-### Storage Interface
-
-The `Storage` interface provides an abstraction for persisting Perstack data:
-
-```typescript
-import type { Storage, EventMeta } from "@perstack/core"
-
-interface Storage {
-  storeCheckpoint(checkpoint: Checkpoint): Promise<void>
-  retrieveCheckpoint(jobId: string, checkpointId: string): Promise<Checkpoint>
-  getCheckpointsByJobId(jobId: string): Promise<Checkpoint[]>
-  storeEvent(event: RunEvent): Promise<void>
-  getEventsByRun(jobId: string, runId: string): Promise<EventMeta[]>
-  getEventContents(jobId: string, runId: string, maxStep?: number): Promise<RunEvent[]>
-  storeJob(job: Job): Promise<void>
-  retrieveJob(jobId: string): Promise<Job | undefined>
-  getAllJobs(): Promise<Job[]>
-  storeRunSetting(setting: RunSetting): Promise<void>
-  getAllRuns(): Promise<RunSetting[]>
-}
-```
-
-Available implementations:
-- `@perstack/filesystem-storage` - Local filesystem storage (default)
-- `@perstack/s3-storage` - AWS S3 storage
-- `@perstack/r2-storage` - Cloudflare R2 storage
-
 ### What Core Should NOT Contain
 
 1. **Package-Internal Types**: Implementation details that don't cross package boundaries should remain in their respective packages.

package/dist/src/index.d.ts

@@ -471,15 +471,6 @@ declare const messageSchema: z.ZodUnion<readonly [z.ZodObject<{
     cache: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>]>;
 
-type RuntimeName = "local" | "cursor" | "claude-code" | "gemini" | "docker";
-declare const runtimeNameSchema: z.ZodEnum<{
-    local: "local";
-    cursor: "cursor";
-    "claude-code": "claude-code";
-    gemini: "gemini";
-    docker: "docker";
-}>;
-
 /** A tool call made by an Expert during execution */
 interface ToolCall {
     /** Unique identifier for this tool call */
@@ -604,7 +595,7 @@ declare const usageSchema: z.ZodObject<{
 }, z.core.$strip>;
 
 /** Status of a checkpoint in the execution lifecycle */
-type CheckpointStatus = "init" | "proceeding" | "completed" | "stoppedByInteractiveTool" | "stoppedByDelegate" | "stoppedByExceededMaxSteps" | "stoppedByError";
+type CheckpointStatus = "init" | "proceeding" | "completed" | "stoppedByInteractiveTool" | "stoppedByDelegate" | "stoppedByExceededMaxSteps" | "stoppedByError" | "stoppedByCancellation";
 declare const checkpointStatusSchema: z.ZodEnum<{
     init: "init";
     proceeding: "proceeding";
@@ -613,6 +604,7 @@ declare const checkpointStatusSchema: z.ZodEnum<{
     stoppedByDelegate: "stoppedByDelegate";
     stoppedByExceededMaxSteps: "stoppedByExceededMaxSteps";
     stoppedByError: "stoppedByError";
+    stoppedByCancellation: "stoppedByCancellation";
 }>;
 /** Information about a delegation target */
 interface DelegationTarget {
@@ -680,11 +672,8 @@ interface Checkpoint {
     pendingToolCalls?: ToolCall[];
     /** Partial tool results collected before stopping (for resume) */
     partialToolResults?: ToolResult[];
-    /** Optional metadata for runtime-specific information */
+    /** Optional metadata */
     metadata?: {
-        /** Runtime that executed this checkpoint */
-        runtime?: RuntimeName;
-        /** Additional runtime-specific data */
         [key: string]: unknown;
     };
     /** Error information when status is stoppedByError */
@@ -719,6 +708,7 @@ declare const checkpointSchema: z.ZodObject<{
         stoppedByDelegate: "stoppedByDelegate";
         stoppedByExceededMaxSteps: "stoppedByExceededMaxSteps";
         stoppedByError: "stoppedByError";
+        stoppedByCancellation: "stoppedByCancellation";
     }>;
     stepNumber: z.ZodNumber;
     messages: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -929,15 +919,7 @@ declare const checkpointSchema: z.ZodObject<{
             signature: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>], "type">>;
     }, z.core.$strip>>>;
-    metadata: z.ZodOptional<z.ZodObject<{
-        runtime: z.ZodOptional<z.ZodEnum<{
-            local: "local";
-            cursor: "cursor";
-            "claude-code": "claude-code";
-            gemini: "gemini";
-            docker: "docker";
-        }>>;
-    }, z.core.$loose>>;
+    metadata: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
     error: z.ZodOptional<z.ZodObject<{
         name: z.ZodString;
         message: z.ZodString;
@@ -1038,13 +1020,11 @@ declare const providerToolOptionsSchema: z.ZodOptional<z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>>;
 type ProviderToolOptions = z.infer<typeof providerToolOptionsSchema>;
-declare function hasCustomProviderSkills(skills?: AnthropicProviderSkill[]): boolean;
 
-type RuntimeVersion = "v1.0";
-declare const runtimeVersionSchema: z.ZodEnum<{
-    "v1.0": "v1.0";
-}>;
+type RuntimeVersion = `v${number}.${number}`;
+declare const runtimeVersionSchema: z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>;
 
+declare function isPrivateOrLocalIP(hostname: string): boolean;
 /** MCP skill using stdio transport */
 interface McpStdioSkill {
     type: "mcpStdioSkill";
@@ -1331,9 +1311,7 @@ declare const expertSchema: z.ZodObject<{
     }>>>;
     delegates: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
     tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-    minRuntimeVersion: z.ZodDefault<z.ZodEnum<{
-        "v1.0": "v1.0";
-    }>>;
+    minRuntimeVersion: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>>;
     providerTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     providerSkills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         type: z.ZodLiteral<"builtin">;
@@ -1579,8 +1557,6 @@ interface PerstackConfig {
     model?: string;
     /** Reasoning budget for native LLM reasoning (extended thinking) */
     reasoningBudget?: ReasoningBudget;
-    /** Default execution runtime */
-    runtime?: RuntimeName;
     /** Maximum steps per run */
     maxSteps?: number;
     /** Maximum retries on generation failure */
@@ -1661,21 +1637,12 @@ declare const perstackConfigSchema: z.ZodObject<{
         medium: "medium";
         high: "high";
     }>, z.ZodNumber]>>;
-    runtime: z.ZodOptional<z.ZodEnum<{
-        local: "local";
-        cursor: "cursor";
-        "claude-code": "claude-code";
-        gemini: "gemini";
-        docker: "docker";
-    }>>;
     maxSteps: z.ZodOptional<z.ZodNumber>;
     maxRetries: z.ZodOptional<z.ZodNumber>;
     timeout: z.ZodOptional<z.ZodNumber>;
     experts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         version: z.ZodOptional<z.ZodString>;
-        minRuntimeVersion: z.ZodOptional<z.ZodEnum<{
-            "v1.0": "v1.0";
-        }>>;
+        minRuntimeVersion: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>>;
         description: z.ZodOptional<z.ZodString>;
         instruction: z.ZodString;
         skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -2593,9 +2560,7 @@ declare const runSettingSchema: z.ZodObject<{
         }>>>;
         delegates: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-        minRuntimeVersion: z.ZodDefault<z.ZodEnum<{
-            "v1.0": "v1.0";
-        }>>;
+        minRuntimeVersion: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>>;
         providerTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
         providerSkills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
             type: z.ZodLiteral<"builtin">;
@@ -2825,9 +2790,7 @@ declare const runParamsSchema: z.ZodObject<{
             }>>>;
             delegates: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
             tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
-            minRuntimeVersion: z.ZodDefault<z.ZodEnum<{
-                "v1.0": "v1.0";
-            }>>;
+            minRuntimeVersion: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>>;
             providerTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
             providerSkills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"builtin">;
@@ -2885,7 +2848,7 @@ declare const runParamsSchema: z.ZodObject<{
                 };
                 delegates: string[];
                 tags: string[];
-                minRuntimeVersion: "v1.0";
+                minRuntimeVersion: `v${number}.${number}`;
                 description?: string | undefined;
                 providerTools?: string[] | undefined;
                 providerSkills?: ({
@@ -2951,7 +2914,7 @@ declare const runParamsSchema: z.ZodObject<{
             };
             delegates: string[];
             tags: string[];
-            minRuntimeVersion: "v1.0";
+            minRuntimeVersion: `v${number}.${number}`;
             description?: string | undefined;
             providerToolOptions?: {
                 webSearch?: {
@@ -3007,6 +2970,7 @@ declare const runParamsSchema: z.ZodObject<{
             stoppedByDelegate: "stoppedByDelegate";
             stoppedByExceededMaxSteps: "stoppedByExceededMaxSteps";
             stoppedByError: "stoppedByError";
+            stoppedByCancellation: "stoppedByCancellation";
         }>;
         stepNumber: z.ZodNumber;
         messages: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
@@ -3217,15 +3181,7 @@ declare const runParamsSchema: z.ZodObject<{
                 signature: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>], "type">>;
         }, z.core.$strip>>>;
-        metadata: z.ZodOptional<z.ZodObject<{
-            runtime: z.ZodOptional<z.ZodEnum<{
-                local: "local";
-                cursor: "cursor";
-                "claude-code": "claude-code";
-                gemini: "gemini";
-                docker: "docker";
-            }>>;
-        }, z.core.$loose>>;
+        metadata: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
         error: z.ZodOptional<z.ZodObject<{
             name: z.ZodString;
             message: z.ZodString;
@@ -3237,7 +3193,7 @@ declare const runParamsSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Expert state events - state machine transitions during execution.
- * All events contain deeply serializable properties for checkpoint storage.
+ * All events contain deeply serializable properties for checkpoint persistence.
  */
 type ExpertStatePayloads = {
     startRun: {
@@ -3622,7 +3578,6 @@ interface BaseRuntimeEvent {
 type RuntimeEventPayloads = {
     initializeRuntime: {
         runtimeVersion: string;
-        runtime?: string;
         expertName: string;
         experts: string[];
         model: string;
@@ -3660,26 +3615,6 @@ type RuntimeEventPayloads = {
     skillDisconnected: {
         skillName: string;
     };
-    /** Docker build progress event */
-    dockerBuildProgress: {
-        stage: "pulling" | "building" | "complete" | "error";
-        service: string;
-        message: string;
-        progress?: number;
-    };
-    /** Docker container status event */
-    dockerContainerStatus: {
-        status: "starting" | "running" | "healthy" | "unhealthy" | "stopped" | "error";
-        service: string;
-        message?: string;
-    };
-    /** Proxy access event (allow/block) */
-    proxyAccess: {
-        action: "allowed" | "blocked";
-        domain: string;
-        port: number;
-        reason?: string;
-    };
 };
 /** All runtime event types */
 type RuntimeEventType = keyof RuntimeEventPayloads;
@@ -3713,100 +3648,26 @@ type CreateCheckpointParams = {
         version: string;
     };
     output: string;
-    runtime: RuntimeName;
 };
 declare function createNormalizedCheckpoint(params: CreateCheckpointParams): Checkpoint;
 declare function createStartRunEvent(jobId: string, runId: string, expertKey: string, checkpoint: Checkpoint): RunEvent;
-declare function createRuntimeInitEvent(jobId: string, runId: string, expertName: string, runtime: RuntimeName, version: string, query?: string): RuntimeEvent;
+declare function createRuntimeInitEvent(jobId: string, runId: string, expertName: string, version: string, query?: string): RuntimeEvent;
 declare function createCompleteRunEvent(jobId: string, runId: string, expertKey: string, checkpoint: Checkpoint, output: string, startedAt?: number): RunEvent;
 declare function createCallToolsEvent(jobId: string, runId: string, expertKey: string, stepNumber: number, toolCalls: ToolCall[], _checkpoint: Checkpoint): RunEvent;
 declare function createResolveToolResultsEvent(jobId: string, runId: string, expertKey: string, stepNumber: number, toolResults: ToolResult[]): RunEvent;
 declare function createToolMessage(toolCallId: string, toolName: string, resultText: string): ToolMessage;
 
-/** Setting type for adapter run - external input with required jobId and runId added by dispatcher */
-type AdapterRunSetting = RunParamsInput["setting"] & {
-    jobId: string;
-    runId: string;
-};
-type AdapterRunParams = {
-    setting: AdapterRunSetting;
-    config?: PerstackConfig;
-    checkpoint?: Checkpoint;
-    eventListener?: (event: RunEvent | RuntimeEvent) => void;
-    storeCheckpoint?: (checkpoint: Checkpoint) => Promise<void>;
-    storeEvent?: (event: RunEvent) => Promise<void>;
-    retrieveCheckpoint?: (jobId: string, checkpointId: string) => Promise<Checkpoint>;
-    workspace?: string;
-    /** Additional environment variable names to pass to Docker runtime */
-    additionalEnvKeys?: string[];
-    /** Additional volume mounts for Docker runtime (format: "hostPath:containerPath:mode") */
-    additionalVolumes?: string[];
-};
-type AdapterRunResult = {
-    checkpoint: Checkpoint;
-    events: (RunEvent | RuntimeEvent)[];
-};
-interface RuntimeAdapter {
-    readonly name: string;
-    checkPrerequisites(): Promise<PrerequisiteResult>;
-    convertExpert(expert: Expert): RuntimeExpertConfig;
-    run(params: AdapterRunParams): Promise<AdapterRunResult>;
-}
-type PrerequisiteResult = {
-    ok: true;
-} | {
-    ok: false;
-    error: PrerequisiteError;
-};
-type PrerequisiteError = {
-    type: "cli-not-found" | "auth-missing" | "version-mismatch";
-    message: string;
-    helpUrl?: string;
-};
-type RuntimeExpertConfig = {
-    instruction: string;
-};
-
-declare function registerAdapter(runtime: RuntimeName, factory: () => RuntimeAdapter): void;
-declare function getAdapter(runtime: RuntimeName): RuntimeAdapter;
-declare function isAdapterAvailable(runtime: RuntimeName): boolean;
-declare function getRegisteredRuntimes(): RuntimeName[];
-
 declare const defaultPerstackApiBaseUrl = "https://api.perstack.ai";
-declare const organizationNameRegex: RegExp;
-declare const maxOrganizationNameLength = 128;
-declare const maxApplicationNameLength = 255;
 declare const expertKeyRegex: RegExp;
 declare const expertNameRegex: RegExp;
 declare const expertVersionRegex: RegExp;
 declare const tagNameRegex: RegExp;
 declare const maxExpertNameLength = 255;
-declare const maxExpertVersionTagLength = 255;
-declare const maxExpertKeyLength = 511;
-declare const maxExpertDescriptionLength: number;
-declare const maxExpertInstructionLength: number;
-declare const maxExpertSkillItems = 255;
-declare const maxExpertDelegateItems = 255;
-declare const maxExpertTagItems = 8;
 declare const defaultMaxSteps = 100;
 declare const defaultMaxRetries = 5;
 declare const defaultTimeout: number;
-declare const maxExpertJobQueryLength: number;
-declare const maxExpertJobFileNameLength: number;
-declare const packageWithVersionRegex: RegExp;
-declare const urlSafeRegex: RegExp;
 declare const maxSkillNameLength = 255;
-declare const maxSkillDescriptionLength: number;
-declare const maxSkillRuleLength: number;
-declare const maxSkillPickOmitItems = 255;
-declare const maxSkillRequiredEnvItems = 255;
 declare const maxSkillToolNameLength = 255;
-declare const maxSkillEndpointLength: number;
-declare const maxSkillInputJsonSchemaLength: number;
-declare const maxSkillToolItems = 255;
-declare const maxCheckpointToolCallIdLength = 255;
-declare const envNameRegex: RegExp;
-declare const maxEnvNameLength = 255;
 
 declare const knownModels: {
     provider: string;
@@ -6255,11 +6116,12 @@ declare const activityOrGroupSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnio
     }, z.core.$strip>], "type">>;
 }, z.core.$strip>]>;
 
-type JobStatus = "running" | "completed" | "stoppedByMaxSteps" | "stoppedByInteractiveTool" | "stoppedByError";
+type JobStatus = "running" | "completed" | "stoppedByMaxSteps" | "stoppedByInteractiveTool" | "stoppedByError" | "stoppedByCancellation";
 declare const jobStatusSchema: z.ZodEnum<{
     completed: "completed";
     stoppedByInteractiveTool: "stoppedByInteractiveTool";
     stoppedByError: "stoppedByError";
+    stoppedByCancellation: "stoppedByCancellation";
     running: "running";
     stoppedByMaxSteps: "stoppedByMaxSteps";
 }>;
@@ -6280,13 +6142,12 @@ declare const jobSchema: z.ZodObject<{
         completed: "completed";
         stoppedByInteractiveTool: "stoppedByInteractiveTool";
         stoppedByError: "stoppedByError";
+        stoppedByCancellation: "stoppedByCancellation";
         running: "running";
         stoppedByMaxSteps: "stoppedByMaxSteps";
     }>;
     coordinatorExpertKey: z.ZodString;
-    runtimeVersion: z.ZodEnum<{
-        "v1.0": "v1.0";
-    }>;
+    runtimeVersion: z.ZodPipe<z.ZodString, z.ZodTransform<`v${number}.${number}`, string>>;
     totalSteps: z.ZodNumber;
     maxSteps: z.ZodOptional<z.ZodNumber>;
     usage: z.ZodObject<{
@@ -6465,8 +6326,6 @@ interface CommandOptions {
     runId?: string;
     /** Paths to .env files */
     envPath?: string[];
-    /** Environment variable names to pass to Docker runtime */
-    env?: string[];
     /** Enable verbose logging */
     verbose?: boolean;
     /** Continue most recent job */
@@ -6477,12 +6336,6 @@ interface CommandOptions {
     resumeFrom?: string;
     /** Query is interactive tool call result */
     interactiveToolCallResult?: boolean;
-    /** Execution runtime */
-    runtime?: RuntimeName;
-    /** Workspace directory for Docker runtime */
-    workspace?: string;
-    /** Additional volume mounts for Docker runtime (format: hostPath:containerPath:mode) */
-    volume?: string[];
     /** Event types to filter (e.g., completeRun,stopRunByError) */
     filter?: string[];
 }
@@ -6524,21 +6377,11 @@ declare const runCommandInputSchema: z.ZodObject<{
         jobId: z.ZodOptional<z.ZodString>;
         runId: z.ZodOptional<z.ZodString>;
         envPath: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
-        env: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
         verbose: z.ZodOptional<z.ZodBoolean>;
         continue: z.ZodOptional<z.ZodBoolean>;
         continueJob: z.ZodOptional<z.ZodString>;
         resumeFrom: z.ZodOptional<z.ZodString>;
         interactiveToolCallResult: z.ZodOptional<z.ZodBoolean>;
-        runtime: z.ZodOptional<z.ZodEnum<{
-            local: "local";
-            cursor: "cursor";
-            "claude-code": "claude-code";
-            gemini: "gemini";
-            docker: "docker";
-        }>>;
-        workspace: z.ZodOptional<z.ZodString>;
-        volume: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
         filter: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string[] | undefined, string | undefined>>, z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -6580,21 +6423,11 @@ declare const startCommandInputSchema: z.ZodObject<{
         jobId: z.ZodOptional<z.ZodString>;
         runId: z.ZodOptional<z.ZodString>;
         envPath: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
-        env: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
         verbose: z.ZodOptional<z.ZodBoolean>;
         continue: z.ZodOptional<z.ZodBoolean>;
         continueJob: z.ZodOptional<z.ZodString>;
         resumeFrom: z.ZodOptional<z.ZodString>;
         interactiveToolCallResult: z.ZodOptional<z.ZodBoolean>;
-        runtime: z.ZodOptional<z.ZodEnum<{
-            local: "local";
-            cursor: "cursor";
-            "claude-code": "claude-code";
-            gemini: "gemini";
-            docker: "docker";
-        }>>;
-        workspace: z.ZodOptional<z.ZodString>;
-        volume: z.ZodPipe<z.ZodOptional<z.ZodArray<z.ZodString>>, z.ZodTransform<string[] | undefined, string[] | undefined>>;
         filter: z.ZodPipe<z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string[] | undefined, string | undefined>>, z.ZodOptional<z.ZodArray<z.ZodString>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -6661,71 +6494,6 @@ type Resource = {
     blob?: string;
 };
 
-/**
- * Metadata for an event, used for listing events without loading full content.
- */
-type EventMeta = {
-    timestamp: number;
-    stepNumber: number;
-    type: string;
-};
-/**
- * Abstract storage interface for persisting Perstack data.
- *
- * Implementations include:
- * - FileSystemStorage: Local filesystem storage (default)
- * - S3Storage: AWS S3 storage
- * - R2Storage: Cloudflare R2 storage
- */
-interface Storage {
-    /**
-     * Store a checkpoint.
-     */
-    storeCheckpoint(checkpoint: Checkpoint): Promise<void>;
-    /**
-     * Retrieve a checkpoint by job ID and checkpoint ID.
-     * @throws Error if checkpoint not found
-     */
-    retrieveCheckpoint(jobId: string, checkpointId: string): Promise<Checkpoint>;
-    /**
-     * Get all checkpoints for a job, sorted by step number.
-     */
-    getCheckpointsByJobId(jobId: string): Promise<Checkpoint[]>;
-    /**
-     * Store an event.
-     */
-    storeEvent(event: RunEvent): Promise<void>;
-    /**
-     * Get event metadata for a run, sorted by step number.
-     */
-    getEventsByRun(jobId: string, runId: string): Promise<EventMeta[]>;
-    /**
-     * Get full event contents for a run, optionally filtered by max step.
-     */
-    getEventContents(jobId: string, runId: string, maxStep?: number): Promise<RunEvent[]>;
-    /**
-     * Store a job.
-     */
-    storeJob(job: Job): Promise<void>;
-    /**
-     * Retrieve a job by ID.
-     * @returns Job or undefined if not found
-     */
-    retrieveJob(jobId: string): Promise<Job | undefined>;
-    /**
-     * Get all jobs, sorted by start time (newest first).
-     */
-    getAllJobs(): Promise<Job[]>;
-    /**
-     * Store a run setting. Updates updatedAt if run already exists.
-     */
-    storeRunSetting(setting: RunSetting): Promise<void>;
-    /**
-     * Get all run settings, sorted by updated time (newest first).
-     */
-    getAllRuns(): Promise<RunSetting[]>;
-}
-
 declare const BASE_SKILL_PREFIX = "@perstack/base";
 type GetActivitiesParams = {
     checkpoint: Checkpoint;
@@ -6762,4 +6530,4 @@ declare function createFilteredEventListener(listener: (event: PerstackEvent) =>
 declare function formatZodError(error: ZodError): string;
 declare function parseWithFriendlyError<T>(schema: ZodSchema<T>, data: unknown, context?: string): T;
 
-export { type Activity, type ActivityOrGroup, type ActivityType, type AdapterRunParams, type AdapterRunResult, type AmazonBedrockProviderConfig, type AnthropicProviderConfig, type AnthropicProviderSkill, type AnthropicProviderToolName, type AppendTextFileActivity, type AttemptCompletionActivity, type AzureOpenAIProviderToolName, type AzureOpenAiProviderConfig, BASE_SKILL_PREFIX, type BaseEvent, type BasePart, type BuiltinAnthropicSkill, type CallToolResultContent, type Checkpoint, type CheckpointStatus, type ClearTodoActivity, type CommandOptions, type CompleteActivity, type CreateCheckpointParams, type CreateDirectoryActivity, type CustomAnthropicSkill, type DeepseekProviderConfig, type DelegateActivity, type DelegateSkillManagerParams, type DelegationCompleteActivity, type DelegationTarget, type DeleteDirectoryActivity, type DeleteFileActivity, type EditTextFileActivity, type ErrorActivity, type EventForType, type EventMeta, type EventType, type ExecActivity, type Expert, type ExpertMessage, type ExpertStateEvent, type ExpertStateEventType, type FileBinaryPart, type FileInlinePart, type FileUrlPart, type GeneralToolActivity, type GetActivitiesParams, type GetFileInfoActivity, type GoogleGenerativeAiProviderConfig, type GoogleProviderToolName, type GoogleVertexProviderConfig, type Headers, type ImageBinaryPart, type ImageInlinePart, type ImageUrlPart, type InstructionMessage, type InteractiveSkill, type InteractiveSkillManagerParams, type InteractiveTool, type InteractiveToolActivity, type Job, type JobStatus, type ListDirectoryActivity, type Lockfile, type LockfileExpert, type LockfileToolDefinition, type McpSkillManagerParams, type McpSseSkill, type McpStdioSkill, type Message, type MessagePart, type MoveFileActivity, type OllamaProviderConfig, type OpenAIProviderToolName, type OpenAiProviderConfig, type ParallelActivitiesGroup, type PerstackConfig, type PerstackConfigExpert, type PerstackConfigSkill, type PerstackEvent, type PrerequisiteError, type PrerequisiteResult, type ProviderConfig, type ProviderName, type ProviderTable, type ProviderToolOptions, type QueryActivity, type ReadImageFileActivity, type ReadPdfFileActivity, type ReadTextFileActivity, type ReasoningBudget, type Resource, type RetryActivity, type RunCommandInput, type RunEvent, type RunInput, type RunParams, type RunParamsInput, type RunSetting, type RuntimeAdapter, type RuntimeEvent, type RuntimeEventForType, type RuntimeEventType, type RuntimeExpertConfig, type RuntimeName, type RuntimeVersion, SAFE_ENV_VARS, type Skill, type SkillManagerParams, type SkillType, type StartCommandInput, type Step, type Storage, type StreamingEvent, type StreamingEventType, type TextPart, type ThinkingPart, type TodoActivity, type ToolCall, type ToolCallPart, type ToolDefinition, type ToolMessage, type ToolResult, type ToolResultPart, type Usage, type UserMessage, type VertexProviderToolName, type WriteTextFileActivity, activityOrGroupSchema, activitySchema, amazonBedrockProviderConfigSchema, anthropicProviderConfigSchema, anthropicProviderSkillSchema, anthropicProviderToolNameSchema, appendTextFileActivitySchema, attemptCompletion, attemptCompletionActivitySchema, azureOpenAIProviderToolNameSchema, azureOpenAiProviderConfigSchema, basePartSchema, builtinAnthropicSkillSchema, callTools, checkpointSchema, checkpointStatusSchema, clearTodoActivitySchema, completeActivitySchema, completeRun, continueToNextStep, createBaseToolActivity, createCallToolsEvent, createCompleteRunEvent, createDirectoryActivitySchema, createEmptyUsage, createEvent, createFilteredEventListener, createGeneralToolActivity, createNormalizedCheckpoint, createResolveToolResultsEvent, createRuntimeEvent, createRuntimeInitEvent, createStartRunEvent, createStreamingEvent, createToolMessage, customAnthropicSkillSchema, deepseekProviderConfigSchema, defaultMaxRetries, defaultMaxSteps, defaultPerstackApiBaseUrl, defaultReasoningBudget, defaultTimeout, delegateActivitySchema, delegationCompleteActivitySchema, delegationTargetSchema, deleteDirectoryActivitySchema, deleteFileActivitySchema, domainPatternSchema, editTextFileActivitySchema, envNameRegex, errorActivitySchema, execActivitySchema, expertKeyRegex, expertMessageSchema, expertNameRegex, expertSchema, expertVersionRegex, fileBinaryPartSchema, fileInlinePartSchema, fileSearchOptionsSchema, fileUrlPartSchema, finishMcpTools, finishToolCall, formatZodError, generalToolActivitySchema, getActivities, getAdapter, getFileInfoActivitySchema, getFilteredEnv, getRegisteredRuntimes, googleGenerativeAiProviderConfigSchema, googleProviderToolNameSchema, googleVertexProviderConfigSchema, hasCustomProviderSkills, headersSchema, imageBinaryPartSchema, imageInlinePartSchema, imageUrlPartSchema, instructionMessageSchema, interactiveSkillSchema, interactiveToolActivitySchema, interactiveToolSchema, isAdapterAvailable, isValidEventType, isValidRuntimeEventType, jobSchema, jobStatusSchema, knownModels, listDirectoryActivitySchema, lockfileExpertSchema, lockfileSchema, lockfileToolDefinitionSchema, maxApplicationNameLength, maxCheckpointToolCallIdLength, maxEnvNameLength, maxExpertDelegateItems, maxExpertDescriptionLength, maxExpertInstructionLength, maxExpertJobFileNameLength, maxExpertJobQueryLength, maxExpertKeyLength, maxExpertNameLength, maxExpertSkillItems, maxExpertTagItems, maxExpertVersionTagLength, maxOrganizationNameLength, maxSkillDescriptionLength, maxSkillEndpointLength, maxSkillInputJsonSchemaLength, maxSkillNameLength, maxSkillPickOmitItems, maxSkillRequiredEnvItems, maxSkillRuleLength, maxSkillToolItems, maxSkillToolNameLength, mcpSseSkillSchema, mcpStdioSkillSchema, messagePartSchema, messageSchema, moveFileActivitySchema, ollamaProviderConfigSchema, openAiProviderConfigSchema, openaiProviderToolNameSchema, organizationNameRegex, packageWithVersionRegex, parallelActivitiesGroupSchema, parseExpertKey, parseWithFriendlyError, perstackConfigSchema, proceedToInteractiveTools, providerConfigSchema, providerNameSchema, providerTableSchema, providerToolOptionsSchema, queryActivitySchema, readImageFileActivitySchema, readPdfFileActivitySchema, readTextFileActivitySchema, reasoningBudgetSchema, registerAdapter, resolveToolResults, resumeFromStop, resumeToolCalls, retry, retryActivitySchema, runCommandInputSchema, runParamsSchema, runSettingSchema, runtimeNameSchema, runtimeVersionSchema, skillSchema, skipDelegates, startCommandInputSchema, startGeneration, startRun, stepSchema, stopRunByDelegate, stopRunByError, stopRunByExceededMaxSteps, stopRunByInteractiveTool, tagNameRegex, textPartSchema, thinkingPartSchema, todoActivitySchema, toolCallPartSchema, toolCallSchema, toolMessageSchema, toolResultPartSchema, toolResultSchema, urlSafeRegex, usageSchema, userMessageSchema, validateEventFilter, vertexProviderToolNameSchema, webFetchOptionsSchema, webSearchOptionsSchema, writeTextFileActivitySchema };
+export { type Activity, type ActivityOrGroup, type ActivityType, type AmazonBedrockProviderConfig, type AnthropicProviderConfig, type AnthropicProviderSkill, type AnthropicProviderToolName, type AppendTextFileActivity, type AttemptCompletionActivity, type AzureOpenAIProviderToolName, type AzureOpenAiProviderConfig, BASE_SKILL_PREFIX, type BaseEvent, type BasePart, type BuiltinAnthropicSkill, type CallToolResultContent, type Checkpoint, type CheckpointStatus, type ClearTodoActivity, type CommandOptions, type CompleteActivity, type CreateCheckpointParams, type CreateDirectoryActivity, type CustomAnthropicSkill, type DeepseekProviderConfig, type DelegateActivity, type DelegateSkillManagerParams, type DelegationCompleteActivity, type DelegationTarget, type DeleteDirectoryActivity, type DeleteFileActivity, type EditTextFileActivity, type ErrorActivity, type EventForType, type EventType, type ExecActivity, type Expert, type ExpertMessage, type ExpertStateEvent, type ExpertStateEventType, type FileBinaryPart, type FileInlinePart, type FileUrlPart, type GeneralToolActivity, type GetActivitiesParams, type GetFileInfoActivity, type GoogleGenerativeAiProviderConfig, type GoogleProviderToolName, type GoogleVertexProviderConfig, type Headers, type ImageBinaryPart, type ImageInlinePart, type ImageUrlPart, type InstructionMessage, type InteractiveSkill, type InteractiveSkillManagerParams, type InteractiveTool, type InteractiveToolActivity, type Job, type JobStatus, type ListDirectoryActivity, type Lockfile, type LockfileExpert, type LockfileToolDefinition, type McpSkillManagerParams, type McpSseSkill, type McpStdioSkill, type Message, type MessagePart, type MoveFileActivity, type OllamaProviderConfig, type OpenAIProviderToolName, type OpenAiProviderConfig, type ParallelActivitiesGroup, type PerstackConfig, type PerstackConfigExpert, type PerstackConfigSkill, type PerstackEvent, type ProviderConfig, type ProviderName, type ProviderTable, type ProviderToolOptions, type QueryActivity, type ReadImageFileActivity, type ReadPdfFileActivity, type ReadTextFileActivity, type ReasoningBudget, type Resource, type RetryActivity, type RunCommandInput, type RunEvent, type RunInput, type RunParams, type RunParamsInput, type RunSetting, type RuntimeEvent, type RuntimeEventForType, type RuntimeEventType, type RuntimeVersion, SAFE_ENV_VARS, type Skill, type SkillManagerParams, type SkillType, type StartCommandInput, type Step, type StreamingEvent, type StreamingEventType, type TextPart, type ThinkingPart, type TodoActivity, type ToolCall, type ToolCallPart, type ToolDefinition, type ToolMessage, type ToolResult, type ToolResultPart, type Usage, type UserMessage, type VertexProviderToolName, type WriteTextFileActivity, activityOrGroupSchema, activitySchema, amazonBedrockProviderConfigSchema, anthropicProviderConfigSchema, anthropicProviderSkillSchema, anthropicProviderToolNameSchema, appendTextFileActivitySchema, attemptCompletion, attemptCompletionActivitySchema, azureOpenAIProviderToolNameSchema, azureOpenAiProviderConfigSchema, basePartSchema, builtinAnthropicSkillSchema, callTools, checkpointSchema, checkpointStatusSchema, clearTodoActivitySchema, completeActivitySchema, completeRun, continueToNextStep, createBaseToolActivity, createCallToolsEvent, createCompleteRunEvent, createDirectoryActivitySchema, createEmptyUsage, createEvent, createFilteredEventListener, createGeneralToolActivity, createNormalizedCheckpoint, createResolveToolResultsEvent, createRuntimeEvent, createRuntimeInitEvent, createStartRunEvent, createStreamingEvent, createToolMessage, customAnthropicSkillSchema, deepseekProviderConfigSchema, defaultMaxRetries, defaultMaxSteps, defaultPerstackApiBaseUrl, defaultReasoningBudget, defaultTimeout, delegateActivitySchema, delegationCompleteActivitySchema, delegationTargetSchema, deleteDirectoryActivitySchema, deleteFileActivitySchema, domainPatternSchema, editTextFileActivitySchema, errorActivitySchema, execActivitySchema, expertKeyRegex, expertMessageSchema, expertNameRegex, expertSchema, expertVersionRegex, fileBinaryPartSchema, fileInlinePartSchema, fileSearchOptionsSchema, fileUrlPartSchema, finishMcpTools, finishToolCall, formatZodError, generalToolActivitySchema, getActivities, getFileInfoActivitySchema, getFilteredEnv, googleGenerativeAiProviderConfigSchema, googleProviderToolNameSchema, googleVertexProviderConfigSchema, headersSchema, imageBinaryPartSchema, imageInlinePartSchema, imageUrlPartSchema, instructionMessageSchema, interactiveSkillSchema, interactiveToolActivitySchema, interactiveToolSchema, isPrivateOrLocalIP, isValidEventType, isValidRuntimeEventType, jobSchema, jobStatusSchema, knownModels, listDirectoryActivitySchema, lockfileExpertSchema, lockfileSchema, lockfileToolDefinitionSchema, maxExpertNameLength, maxSkillNameLength, maxSkillToolNameLength, mcpSseSkillSchema, mcpStdioSkillSchema, messagePartSchema, messageSchema, moveFileActivitySchema, ollamaProviderConfigSchema, openAiProviderConfigSchema, openaiProviderToolNameSchema, parallelActivitiesGroupSchema, parseExpertKey, parseWithFriendlyError, perstackConfigSchema, proceedToInteractiveTools, providerConfigSchema, providerNameSchema, providerTableSchema, providerToolOptionsSchema, queryActivitySchema, readImageFileActivitySchema, readPdfFileActivitySchema, readTextFileActivitySchema, reasoningBudgetSchema, resolveToolResults, resumeFromStop, resumeToolCalls, retry, retryActivitySchema, runCommandInputSchema, runParamsSchema, runSettingSchema, runtimeVersionSchema, skillSchema, skipDelegates, startCommandInputSchema, startGeneration, startRun, stepSchema, stopRunByDelegate, stopRunByError, stopRunByExceededMaxSteps, stopRunByInteractiveTool, tagNameRegex, textPartSchema, thinkingPartSchema, todoActivitySchema, toolCallPartSchema, toolCallSchema, toolMessageSchema, toolResultPartSchema, toolResultSchema, usageSchema, userMessageSchema, validateEventFilter, vertexProviderToolNameSchema, webFetchOptionsSchema, webSearchOptionsSchema, writeTextFileActivitySchema };