@zeabur/ai-sdk 1.0.0

package/README.md

@@ -0,0 +1,244 @@
+# Zeabur AI SDK
+
+The Zeabur AI SDK is a TypeScript toolkit designed to help you build AI-powered deployment agents and automation tools using popular frameworks like Next.js, React, and Node.js.
+
+## Installation
+
+You will need Node.js 18+ and npm (or another package manager) installed on your local development machine.
+
+```bash
+npm install @zeabur/ai-sdk
+```
+
+## Usage
+
+### Executing Commands
+
+```typescript
+import { zeaburTools, createZeaburContext } from '@zeabur/ai-sdk';
+
+const context = createZeaburContext('your-api-token');
+
+const result = await zeaburTools.executeCommand({
+  serviceId: 'service-123',
+  environmentId: 'env-456',
+  command: ['ls', '-la']
+}, context);
+```
+
+### Deploying from Specifications
+
+```typescript
+import { zeaburTools, createZeaburContext } from '@zeabur/ai-sdk';
+
+const context = createZeaburContext('your-api-token');
+
+const result = await zeaburTools.deployFromSpecification({
+  projectID: 'project-123',
+  specification: {
+    services: [
+      {
+        name: 'web',
+        template: 'NODEJS',
+        // ... service configuration
+      }
+    ]
+  }
+}, context);
+```
+
+### Monitoring and Logs
+
+```typescript
+import { zeaburTools } from '@zeabur/ai-sdk';
+
+// Get build logs
+const buildLogs = await zeaburTools.getBuildLogs({
+  projectID: 'project-123',
+  deploymentID: 'deploy-456'
+}, context);
+
+// Get runtime logs
+const runtimeLogs = await zeaburTools.getRuntimeLogs({
+  serviceID: 'service-123',
+  environmentID: 'env-456',
+  type: 'BUILD'
+}, context);
+
+// Get deployment history
+const deployments = await zeaburTools.getDeployments({
+  serviceId: 'service-123'
+}, context);
+```
+
+### Working with Templates
+
+```typescript
+import { zeaburTools } from '@zeabur/ai-sdk';
+
+const templates = await zeaburTools.searchTemplate({
+  query: 'nextjs'
+}, context);
+```
+
+## AI SDK Integration
+
+The Zeabur AI SDK works seamlessly with the Vercel AI SDK to build intelligent deployment agents.
+
+### Agent Example
+
+```typescript
+import { ToolLoopAgent } from 'ai';
+import { zeaburTools, createZeaburContext } from '@zeabur/ai-sdk';
+import { openai } from '@ai-sdk/openai';
+
+const zeaburContext = createZeaburContext(process.env.ZEABUR_API_TOKEN);
+
+const deploymentAgent = new ToolLoopAgent({
+  model: openai('gpt-4o'),
+  system: 'You are a Zeabur deployment assistant.',
+  tools: {
+    execute_command: {
+      description: 'Execute commands on Zeabur services',
+      inputSchema: zeaburSchemas.executeCommandSchema,
+      execute: async (input) => {
+        return await zeaburTools.executeCommand(input, zeaburContext);
+      }
+    },
+    deploy_service: {
+      description: 'Deploy services on Zeabur',
+      inputSchema: zeaburSchemas.deployFromSpecificationSchema,
+      execute: async (input) => {
+        return await zeaburTools.deployFromSpecification(input, zeaburContext);
+      }
+    }
+  }
+});
+```
+
+### Next.js API Route
+
+```typescript
+// app/api/chat/route.ts
+import { createZeaburContext, zeaburTools } from '@zeabur/ai-sdk';
+import { streamText } from 'ai';
+import { openai } from '@ai-sdk/openai';
+
+export async function POST(req: Request) {
+  const { messages } = await req.json();
+  
+  const zeaburContext = createZeaburContext(
+    process.env.ZEABUR_API_TOKEN
+  );
+
+  const result = streamText({
+    model: openai('gpt-4o'),
+    messages,
+    tools: {
+      execute_command: {
+        description: 'Execute commands on services',
+        parameters: zeaburSchemas.executeCommandSchema,
+        execute: async (args) => {
+          return await zeaburTools.executeCommand(args, zeaburContext);
+        }
+      }
+    }
+  });
+
+  return result.toDataStreamResponse();
+}
+```
+
+## Demo Mode
+
+Try the SDK without authentication - perfect for testing and learning:
+
+```typescript
+import { zeaburTools, createZeaburDemoContext } from '@zeabur/ai-sdk';
+
+// No API token required - returns mock data
+const demoContext = createZeaburDemoContext();
+
+const result = await zeaburTools.executeCommand({
+  serviceId: 'demo-service',
+  environmentId: 'demo-env',
+  command: ['ls', '-la']
+}, demoContext);
+
+console.log(result); // Returns: "Mock command output: Hello from demo mode!"
+```
+
+## Available Tools
+
+### Core Operations
+- **executeCommand** - Execute shell commands on services
+- **deployFromSpecification** - Deploy services from YAML/JSON specifications
+- **executeGraphQL** - Run custom GraphQL queries
+
+### File System
+- **decideFilesystem** - Determine GitHub or Upload ID
+- **listFiles** - List directory contents
+- **readFile** - Read file with pagination support
+- **fileDirRead** - Execute safe read-only commands
+
+### Monitoring
+- **getBuildLogs** - Fetch build logs for deployments
+- **getRuntimeLogs** - Get service runtime logs
+- **getDeployments** - List deployment history
+
+### Templates
+- **searchTemplate** - Search deployment templates
+
+### UI Components
+- **renderRegionSelector** - Region selection interface
+- **renderProjectSelector** - Project selection interface
+- **renderServiceCard** - Service status cards
+- **renderDockerfile** - Syntax-highlighted Dockerfile viewer
+- **renderRecommendation** - Smart recommendation buttons
+- **renderFloatingButton** - Floating action buttons
+
+## Authentication
+
+The SDK requires a Zeabur API token to be explicitly passed by your application:
+
+```typescript
+// ✅ Correct - Your application manages the token
+const token = process.env.ZEABUR_API_TOKEN;
+const context = createZeaburContext(token);
+
+// Or from cookies, headers, database, etc.
+const token = cookies().get('token')?.value;
+const context = createZeaburContext(token);
+```
+
+**Note:** This SDK is a library and does NOT read environment variables directly. The consuming application is responsible for managing authentication.
+
+## Development
+
+```bash
+npm install          # Install dependencies
+npm run build        # Build TypeScript
+npm run demo         # Run demo mode
+npm run type-check   # Type checking
+npm run lint         # Linting
+```
+
+## Community
+
+Join the Zeabur community to ask questions, share ideas, and get help:
+
+- [Discord](https://discord.gg/zeabur)
+- [GitHub Discussions](https://github.com/zeabur/zeabur/discussions)
+- [Documentation](https://zeabur.com/docs)
+
+## Contributing
+
+Contributions to the Zeabur AI SDK are welcome and highly appreciated. Please check out our contributing guidelines before getting started.
+
+## Authors
+
+This library is created by the Zeabur team, with contributions from the Open Source Community.
+
+## License
+
+MIT

package/dist/core/command.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import { ZeaburContext } from "../types/index.js";
+export declare const executeCommandSchema: z.ZodObject<{
+    serviceId: z.ZodString;
+    environmentId: z.ZodString;
+    command: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    serviceId: string;
+    environmentId: string;
+    command: string[];
+}, {
+    serviceId: string;
+    environmentId: string;
+    command: string[];
+}>;
+export type ExecuteCommandInput = z.infer<typeof executeCommandSchema>;
+export declare function executeCommand(args: ExecuteCommandInput, context: ZeaburContext): Promise<string>;
+//# sourceMappingURL=command.d.ts.map

package/dist/core/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/core/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAwB,MAAM,mBAAmB,CAAC;AAIxE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE,wBAAsB,cAAc,CAClC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CA+BjB"}

package/dist/core/command.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+const MAX_COMMAND_RESPONSE_LENGTH = 2048;
+export const executeCommandSchema = z.object({
+    serviceId: z.string(),
+    environmentId: z.string(),
+    command: z.array(z.string())
+});
+export async function executeCommand(args, context) {
+    const query = `
+    mutation ExecuteCommand($serviceId: ObjectID!, $environmentId: ObjectID!, $command: [String!]!) {
+      executeCommand(serviceID: $serviceId, environmentID: $environmentId, command: $command) {
+        exitCode
+        output
+      }
+    }
+  `;
+    const variables = {
+        serviceId: args.serviceId,
+        environmentId: args.environmentId,
+        command: args.command
+    };
+    const response = await context.graphql.query(query, variables);
+    if (response.errors) {
+        throw new Error(JSON.stringify(response.errors));
+    }
+    const output = response.data.executeCommand.output ?? "";
+    let truncatedResponse = output.slice(0, MAX_COMMAND_RESPONSE_LENGTH)
+        + (output.length > MAX_COMMAND_RESPONSE_LENGTH ? '... (truncated)' : '');
+    if (response.data.executeCommand.exitCode !== 0) {
+        truncatedResponse = `(exit code ${response.data.executeCommand.exitCode}) ` + truncatedResponse;
+    }
+    return truncatedResponse;
+}
+//# sourceMappingURL=command.js.map

package/dist/core/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/core/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAyB,EACzB,OAAsB;IAEtB,MAAM,KAAK,GAAG;;;;;;;GAOb,CAAC;IAEF,MAAM,SAAS,GAAG;QAChB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAA2C,KAAK,EAAE,SAAS,CAAC,CAAC;IAEzG,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,IAAI,EAAE,CAAC;IACzD,IAAI,iBAAiB,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC;UAChE,CAAC,MAAM,CAAC,MAAM,GAAG,2BAA2B,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE3E,IAAI,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAChD,iBAAiB,GAAG,cAAc,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,IAAI,GAAG,iBAAiB,CAAC;IAClG,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}

package/dist/core/deploy.d.ts

@@ -0,0 +1,175 @@
+import { z } from "zod";
+import { ZeaburContext } from "../types/index.js";
+export declare const deployFromSpecificationSchema: z.ZodObject<{
+    service_id: z.ZodString;
+    source: z.ZodObject<{
+        type: z.ZodEnum<["BUILD_FROM_SOURCE", "DOCKER_IMAGE"]>;
+        build_from_source: z.ZodOptional<z.ZodObject<{
+            source: z.ZodObject<{
+                type: z.ZodEnum<["GITHUB", "UPLOAD_ID"]>;
+                github: z.ZodOptional<z.ZodObject<{
+                    repo_id: z.ZodNumber;
+                    ref: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    repo_id: number;
+                    ref?: string | undefined;
+                }, {
+                    repo_id: number;
+                    ref?: string | undefined;
+                }>>;
+                upload_id: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            }, {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            }>;
+            dockerfile: z.ZodObject<{
+                content: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            }, {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            dockerfile: {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            };
+            source: {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            };
+        }, {
+            dockerfile: {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            };
+            source: {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            };
+        }>>;
+        docker_image: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "BUILD_FROM_SOURCE" | "DOCKER_IMAGE";
+        build_from_source?: {
+            dockerfile: {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            };
+            source: {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            };
+        } | undefined;
+        docker_image?: string | undefined;
+    }, {
+        type: "BUILD_FROM_SOURCE" | "DOCKER_IMAGE";
+        build_from_source?: {
+            dockerfile: {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            };
+            source: {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            };
+        } | undefined;
+        docker_image?: string | undefined;
+    }>;
+    env: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        value: z.ZodString;
+        expose: z.ZodDefault<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        key: string;
+        expose: boolean;
+    }, {
+        value: string;
+        key: string;
+        expose?: boolean | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    service_id: string;
+    source: {
+        type: "BUILD_FROM_SOURCE" | "DOCKER_IMAGE";
+        build_from_source?: {
+            dockerfile: {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            };
+            source: {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            };
+        } | undefined;
+        docker_image?: string | undefined;
+    };
+    env: {
+        value: string;
+        key: string;
+        expose: boolean;
+    }[];
+}, {
+    service_id: string;
+    source: {
+        type: "BUILD_FROM_SOURCE" | "DOCKER_IMAGE";
+        build_from_source?: {
+            dockerfile: {
+                path?: string | null | undefined;
+                content?: string | null | undefined;
+            };
+            source: {
+                type: "GITHUB" | "UPLOAD_ID";
+                github?: {
+                    repo_id: number;
+                    ref?: string | undefined;
+                } | undefined;
+                upload_id?: string | undefined;
+            };
+        } | undefined;
+        docker_image?: string | undefined;
+    };
+    env: {
+        value: string;
+        key: string;
+        expose?: boolean | undefined;
+    }[];
+}>;
+export type DeployFromSpecificationInput = z.infer<typeof deployFromSpecificationSchema>;
+export declare function deployFromSpecification(args: DeployFromSpecificationInput, context: ZeaburContext): Promise<string>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/core/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/core/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAwC,MAAM,mBAAmB,CAAC;AAoBxF,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBxC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEzF,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,4BAA4B,EAClC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/core/deploy.js

@@ -0,0 +1,96 @@
+import { z } from "zod";
+import { decideFilesystemFromSchema } from "./files.js";
+const DEPLOY_FROM_SPECIFICATION_GQL = `
+mutation DeployFromSpecification($serviceId: ObjectID!, $specification: DeploymentSpecification!) {
+  deployFromSpecification(serviceID: $serviceId, specification: $specification) {
+    deploymentID
+  }
+}
+`;
+const sourceSchema = z.object({
+    type: z.enum(["GITHUB", "UPLOAD_ID"]),
+    github: z.object({
+        repo_id: z.number(),
+        ref: z.string().optional(),
+    }).optional(),
+    upload_id: z.string().optional(),
+});
+export const deployFromSpecificationSchema = z.object({
+    service_id: z.string(),
+    source: z.object({
+        type: z.enum(["BUILD_FROM_SOURCE", "DOCKER_IMAGE"]),
+        build_from_source: z.object({
+            source: sourceSchema,
+            dockerfile: z.object({
+                content: z.string().nullable().optional(),
+                path: z.string().nullable().optional(),
+            }),
+        }).optional(),
+        docker_image: z.string().optional(),
+    }),
+    env: z.array(z.object({
+        key: z.string(),
+        value: z.string(),
+        expose: z.boolean().default(false),
+    })),
+});
+export async function deployFromSpecification(args, context) {
+    let spec = {
+        source: {},
+        env: args.env.map((e) => ({
+            key: e.key,
+            default: e.value,
+            expose: e.expose,
+        })),
+    };
+    switch (args.source.type) {
+        case "BUILD_FROM_SOURCE":
+            if (!args.source.build_from_source) {
+                throw new Error("When the source type is 'BUILD_FROM_SOURCE', you must specify the 'build_from_source' object.");
+            }
+            const fs = decideFilesystemFromSchema(context.graphql, args.source.build_from_source.source);
+            const dockerfileContent = await getDockerfileContent(fs, args.source.build_from_source.dockerfile);
+            switch (args.source.build_from_source.source.type) {
+                case "GITHUB":
+                    spec.source = {
+                        source: "GITHUB",
+                        repoID: args.source.build_from_source.source.github?.repo_id,
+                        branch: args.source.build_from_source.source.github?.ref ?? undefined,
+                        dockerfile: dockerfileContent,
+                    };
+                    break;
+                case "UPLOAD_ID":
+                    spec.source = {
+                        source: "UPLOAD_ID",
+                        uploadID: args.source.build_from_source.source.upload_id ?? undefined,
+                        dockerfile: dockerfileContent,
+                    };
+                    break;
+                default:
+                    throw new Error("Invalid 'build_from_source' source type");
+            }
+            break;
+        case "DOCKER_IMAGE":
+            spec.source = {
+                image: args.source.docker_image ?? undefined,
+            };
+            break;
+        default:
+            throw new Error("Invalid 'source' type");
+    }
+    const result = await context.graphql.query(DEPLOY_FROM_SPECIFICATION_GQL, {
+        serviceId: args.service_id,
+        specification: spec,
+    });
+    return JSON.stringify(result);
+}
+async function getDockerfileContent(fs, dockerfile) {
+    if (dockerfile.content) {
+        return dockerfile.content;
+    }
+    if (dockerfile.path) {
+        return await fs.read(dockerfile.path);
+    }
+    throw new Error("No Dockerfile content provided. You should specify 'content' or 'path' in the Dockerfile object.");
+}
+//# sourceMappingURL=deploy.js.map

package/dist/core/deploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/core/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,6BAA6B,GAAG;;;;;;CAMrC,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC3B,CAAC,CAAC,QAAQ,EAAE;IACb,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC;QACnD,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC;YAC1B,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;gBACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;gBACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;aACvC,CAAC;SACH,CAAC,CAAC,QAAQ,EAAE;QACb,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC;IACF,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KACnC,CAAC,CAAC;CACJ,CAAC,CAAC;AAIH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAkC,EAClC,OAAsB;IAEtB,IAAI,IAAI,GAAyC;QAC/C,MAAM,EAAE,EAAE;QACV,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACxB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,OAAO,EAAE,CAAC,CAAC,KAAK;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;KACJ,CAAC;IAEF,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACzB,KAAK,mBAAmB;YACtB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,+FAA+F,CAAC,CAAC;YACnH,CAAC;YAED,MAAM,EAAE,GAAG,0BAA0B,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC7F,MAAM,iBAAiB,GAAG,MAAM,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAEnG,QAAQ,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAClD,KAAK,QAAQ;oBACX,IAAI,CAAC,MAAM,GAAG;wBACZ,MAAM,EAAE,QAAQ;wBAChB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO;wBAC5D,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,SAAS;wBACrE,UAAU,EAAE,iBAAiB;qBAC9B,CAAC;oBACF,MAAM;gBACR,KAAK,WAAW;oBACd,IAAI,CAAC,MAAM,GAAG;wBACZ,MAAM,EAAE,WAAW;wBACnB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,SAAS,IAAI,SAAS;wBACrE,UAAU,EAAE,iBAAiB;qBAC9B,CAAC;oBACF,MAAM;gBACR;oBACE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC/D,CAAC;YACD,MAAM;QACR,KAAK,cAAc;YACjB,IAAI,CAAC,MAAM,GAAG;gBACZ,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,IAAI,SAAS;aAC7C,CAAC;YACF,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE;QACxE,SAAS,EAAE,IAAI,CAAC,UAAU;QAC1B,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,EAAO,EAAE,UAA6D;IACxG,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;AACtH,CAAC"}

package/dist/core/files.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { ZeaburContext, Filesystem, GraphQLClient } from "../types/index.js";
+export declare class UploadIdFilesystem implements Filesystem {
+    private graphql;
+    private uploadId;
+    constructor(graphql: GraphQLClient, uploadId: string);
+    list(path: string): Promise<string[]>;
+    read(path: string): Promise<string>;
+}
+export declare class GitHubFilesystem implements Filesystem {
+    private graphql;
+    private repoId;
+    private ref;
+    constructor(graphql: GraphQLClient, repoId: number, ref: string | null);
+    list(path: string): Promise<string[]>;
+    read(path: string): Promise<string>;
+}
+export declare function decideFilesystemFromSchema(graphql: GraphQLClient, source: any): Filesystem;
+export declare const decideFilesystemSchema: z.ZodObject<{
+    type: z.ZodEnum<["GITHUB", "UPLOAD_ID"]>;
+    github: z.ZodOptional<z.ZodObject<{
+        repo_id: z.ZodNumber;
+        ref: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        repo_id: number;
+        ref?: string | undefined;
+    }, {
+        repo_id: number;
+        ref?: string | undefined;
+    }>>;
+    upload_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "GITHUB" | "UPLOAD_ID";
+    github?: {
+        repo_id: number;
+        ref?: string | undefined;
+    } | undefined;
+    upload_id?: string | undefined;
+}, {
+    type: "GITHUB" | "UPLOAD_ID";
+    github?: {
+        repo_id: number;
+        ref?: string | undefined;
+    } | undefined;
+    upload_id?: string | undefined;
+}>;
+export type DecideFilesystemInput = z.infer<typeof decideFilesystemSchema>;
+export declare function decideFilesystem(args: DecideFilesystemInput, context: ZeaburContext): Promise<string>;
+export declare const listFilesSchema: z.ZodObject<{
+    path: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    limit: number;
+    offset: number;
+}, {
+    path: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ListFilesInput = z.infer<typeof listFilesSchema>;
+export declare function listFiles(args: ListFilesInput, context: ZeaburContext): Promise<string>;
+export declare const readFileSchema: z.ZodObject<{
+    path: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    limit: number;
+    offset: number;
+}, {
+    path: string;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export type ReadFileInput = z.infer<typeof readFileSchema>;
+export declare function readFile(args: ReadFileInput, context: ZeaburContext): Promise<string>;
+export declare const fileDirReadSchema: z.ZodObject<{
+    serviceId: z.ZodString;
+    environmentId: z.ZodString;
+    command: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    serviceId: string;
+    environmentId: string;
+    command: string[];
+}, {
+    serviceId: string;
+    environmentId: string;
+    command: string[];
+}>;
+export type FileDirReadInput = z.infer<typeof fileDirReadSchema>;
+export declare function fileDirRead(args: FileDirReadInput, context: ZeaburContext): Promise<string>;
+//# sourceMappingURL=files.d.ts.map

package/dist/core/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAwB,MAAM,mBAAmB,CAAC;AAInG,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM;IAK9C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAkB1C;AAED,qBAAa,gBAAiB,YAAW,UAAU;IACjD,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAgB;gBAEf,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMhE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoBrC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAmB1C;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,GAAG,UAAU,CAe1F;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOjC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE3E,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,wBAAsB,SAAS,CAC7B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,eAAO,MAAM,cAAc;;;;;;;;;;;;EAIzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,wBAAsB,WAAW,CAC/B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAsCjB"}