@agentuity/cli 0.0.58 → 0.0.60

package/dist/cmd/cloud/storage/list.js

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+import { listResources } from '@agentuity/server';
+import { createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getCatalystAPIClient } from '../../../config';
+import { getCommand } from '../../../command-prefix';
+import { ErrorCode } from '../../../errors';
+import { createS3Client } from './utils';
+const StorageListResponseSchema = z.object({
+    buckets: z
+        .array(z.object({
+        bucket_name: z.string().describe('Storage bucket name'),
+        access_key: z.string().optional().describe('S3 access key'),
+        secret_key: z.string().optional().describe('S3 secret key'),
+        region: z.string().optional().describe('S3 region'),
+        endpoint: z.string().optional().describe('S3 endpoint URL'),
+    }))
+        .optional()
+        .describe('List of storage resources'),
+    files: z
+        .array(z.object({
+        key: z.string().describe('File key/path'),
+        size: z.number().describe('File size in bytes'),
+        lastModified: z.string().describe('Last modified timestamp'),
+    }))
+        .optional()
+        .describe('List of files in bucket'),
+});
+export const listSubcommand = createSubcommand({
+    name: 'list',
+    aliases: ['ls'],
+    description: 'List storage resources or files in a bucket',
+    tags: ['read-only', 'fast', 'requires-auth'],
+    requires: { auth: true, org: true, region: true },
+    idempotent: true,
+    examples: [
+        getCommand('cloud storage list'),
+        getCommand('cloud storage list my-bucket'),
+        getCommand('cloud storage list my-bucket path/prefix'),
+        getCommand('--json cloud storage list'),
+        getCommand('cloud storage ls'),
+        getCommand('cloud storage list --show-credentials'),
+    ],
+    schema: {
+        args: z.object({
+            name: z.string().optional().describe('Bucket name to list files from'),
+            prefix: z.string().optional().describe('Path prefix to filter files'),
+        }),
+        options: z.object({
+            showCredentials: z
+                .boolean()
+                .optional()
+                .describe('Show credentials in plain text (default: masked in terminal, unmasked in JSON)'),
+        }),
+        response: StorageListResponseSchema,
+    },
+    async handler(ctx) {
+        const { logger, args, opts, options, orgId, region, config, auth } = ctx;
+        const catalystClient = getCatalystAPIClient(config, logger, auth);
+        const resources = await tui.spinner({
+            message: `Fetching storage for ${orgId} in ${region}`,
+            clearOnSuccess: true,
+            callback: async () => {
+                return listResources(catalystClient, orgId, region);
+            },
+        });
+        // If bucket name is provided, list files in the bucket
+        if (args.name) {
+            const bucket = resources.s3.find((s3) => s3.bucket_name === args.name);
+            if (!bucket) {
+                tui.fatal(`Storage bucket '${args.name}' not found`, ErrorCode.RESOURCE_NOT_FOUND);
+            }
+            if (!bucket.access_key || !bucket.secret_key || !bucket.endpoint) {
+                tui.fatal(`Storage bucket '${args.name}' is missing credentials`, ErrorCode.CONFIG_INVALID);
+            }
+            const s3Client = createS3Client({
+                endpoint: bucket.endpoint,
+                access_key: bucket.access_key,
+                secret_key: bucket.secret_key,
+                region: bucket.region,
+            });
+            const result = await tui.spinner({
+                message: `Listing files in ${args.name}${args.prefix ? ` with prefix ${args.prefix}` : ''}`,
+                clearOnSuccess: true,
+                callback: async () => {
+                    return s3Client.list(args.prefix
+                        ? {
+                            prefix: args.prefix,
+                        }
+                        : null);
+                },
+            });
+            const objects = result.contents || [];
+            if (!options.json) {
+                if (objects.length === 0) {
+                    tui.info('No files found');
+                }
+                else {
+                    tui.info(tui.bold(`Files in ${args.name}${args.prefix ? ` (prefix: ${args.prefix})` : ''}`));
+                    tui.newline();
+                    for (const obj of objects) {
+                        console.log(`${obj.key}  ${tui.muted(`(${obj.size} bytes, ${obj.lastModified})`)}`);
+                    }
+                }
+            }
+            return {
+                files: objects.map((obj) => {
+                    const lastModified = obj.lastModified;
+                    let lastModifiedStr = '';
+                    if (typeof lastModified === 'string') {
+                        lastModifiedStr = lastModified;
+                    }
+                    else if (lastModified &&
+                        typeof lastModified === 'object' &&
+                        'toISOString' in lastModified) {
+                        lastModifiedStr = lastModified.toISOString();
+                    }
+                    return {
+                        key: obj.key,
+                        size: obj.size ?? 0,
+                        lastModified: lastModifiedStr,
+                    };
+                }),
+            };
+        }
+        // Otherwise, list buckets
+        // Mask credentials in terminal output by default, unless --show-credentials is passed
+        const shouldShowCredentials = opts.showCredentials === true;
+        const shouldMask = !options.json && !shouldShowCredentials;
+        if (!options.json) {
+            if (resources.s3.length === 0) {
+                tui.info('No storage buckets found');
+            }
+            else {
+                tui.info(tui.bold('Storage'));
+                tui.newline();
+                for (const s3 of resources.s3) {
+                    console.log(tui.bold(s3.bucket_name));
+                    if (s3.access_key) {
+                        const displayAccessKey = shouldMask
+                            ? tui.maskSecret(s3.access_key)
+                            : s3.access_key;
+                        console.log(` Access Key: ${tui.muted(displayAccessKey)}`);
+                    }
+                    if (s3.secret_key) {
+                        const displaySecretKey = shouldMask
+                            ? tui.maskSecret(s3.secret_key)
+                            : s3.secret_key;
+                        console.log(` Secret Key: ${tui.muted(displaySecretKey)}`);
+                    }
+                    if (s3.region)
+                        console.log(` Region:     ${tui.muted(s3.region)}`);
+                    if (s3.endpoint)
+                        console.log(` Endpoint:   ${tui.muted(s3.endpoint)}`);
+                    tui.newline();
+                }
+            }
+        }
+        return {
+            buckets: resources.s3.map((s3) => ({
+                bucket_name: s3.bucket_name,
+                access_key: s3.access_key ?? undefined,
+                secret_key: s3.secret_key ?? undefined,
+                region: s3.region ?? undefined,
+                endpoint: s3.endpoint ?? undefined,
+            })),
+        };
+    },
+});
+//# sourceMappingURL=list.js.map

package/dist/cmd/cloud/storage/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/storage/list.ts"],"names":[],"mappings":"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"}

package/dist/cmd/cloud/storage/upload.d.ts

@@ -0,0 +1,2 @@
+export declare const uploadSubcommand: import("../../..").SubcommandDefinition;
+//# sourceMappingURL=upload.d.ts.map

package/dist/cmd/cloud/storage/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/storage/upload.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB,yCA2I3B,CAAC"}

package/dist/cmd/cloud/storage/upload.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+import { basename } from 'path';
+import { listResources } from '@agentuity/server';
+import { createSubcommand } from '../../../types';
+import * as tui from '../../../tui';
+import { getCatalystAPIClient } from '../../../config';
+import { getCommand } from '../../../command-prefix';
+import { ErrorCode } from '../../../errors';
+import { createS3Client } from './utils';
+export const uploadSubcommand = createSubcommand({
+    name: 'upload',
+    aliases: ['put'],
+    description: 'Upload a file to storage bucket',
+    tags: ['write', 'requires-auth'],
+    requires: { auth: true, org: true, region: true },
+    idempotent: false,
+    examples: [
+        `${getCommand('cloud storage upload')} my-bucket file.txt`,
+        `${getCommand('cloud storage put')} my-bucket file.txt --content-type text/plain`,
+        `cat file.txt | ${getCommand('cloud storage upload')} my-bucket -`,
+    ],
+    schema: {
+        args: z.object({
+            name: z.string().describe('Bucket name'),
+            filename: z.string().describe('File path to upload or "-" for STDIN'),
+        }),
+        options: z.object({
+            contentType: z
+                .string()
+                .optional()
+                .describe('Content type (auto-detected if not provided)'),
+        }),
+        response: z.object({
+            success: z.boolean().describe('Whether upload succeeded'),
+            bucket: z.string().describe('Bucket name'),
+            filename: z.string().describe('Uploaded filename'),
+            size: z.number().describe('File size in bytes'),
+        }),
+    },
+    async handler(ctx) {
+        const { logger, args, opts, options, orgId, region, config, auth } = ctx;
+        const catalystClient = getCatalystAPIClient(config, logger, auth);
+        // Fetch bucket credentials
+        const resources = await tui.spinner({
+            message: `Fetching credentials for ${args.name}`,
+            clearOnSuccess: true,
+            callback: async () => {
+                return listResources(catalystClient, orgId, region);
+            },
+        });
+        const bucket = resources.s3.find((s3) => s3.bucket_name === args.name);
+        if (!bucket) {
+            tui.fatal(`Storage bucket '${args.name}' not found`, ErrorCode.RESOURCE_NOT_FOUND);
+        }
+        if (!bucket.access_key || !bucket.secret_key || !bucket.endpoint) {
+            tui.fatal(`Storage bucket '${args.name}' is missing credentials`, ErrorCode.CONFIG_INVALID);
+        }
+        // Read file content
+        let fileContent;
+        let actualFilename;
+        if (args.filename === '-') {
+            // Read from STDIN
+            const chunks = [];
+            for await (const chunk of Bun.stdin.stream()) {
+                chunks.push(Buffer.from(chunk));
+            }
+            fileContent = Buffer.concat(chunks);
+            actualFilename = 'stdin';
+        }
+        else {
+            // Read from file
+            const file = Bun.file(args.filename);
+            if (!(await file.exists())) {
+                tui.fatal(`File not found: ${args.filename}`, ErrorCode.FILE_NOT_FOUND);
+            }
+            fileContent = Buffer.from(await file.arrayBuffer());
+            actualFilename = basename(args.filename);
+        }
+        // Auto-detect content type
+        let contentType = opts.contentType;
+        if (!contentType && args.filename !== '-') {
+            const filename = basename(args.filename);
+            const dotIndex = filename.lastIndexOf('.');
+            const ext = dotIndex > 0 ? filename.substring(dotIndex + 1).toLowerCase() : undefined;
+            const mimeTypes = {
+                txt: 'text/plain',
+                html: 'text/html',
+                css: 'text/css',
+                yaml: 'application/x-yaml',
+                yml: 'application/x-yaml',
+                js: 'application/javascript',
+                json: 'application/json',
+                xml: 'application/xml',
+                pdf: 'application/pdf',
+                zip: 'application/zip',
+                jpg: 'image/jpeg',
+                jpeg: 'image/jpeg',
+                png: 'image/png',
+                gif: 'image/gif',
+                svg: 'image/svg+xml',
+                mp4: 'video/mp4',
+                mp3: 'audio/mpeg',
+            };
+            contentType = ext ? mimeTypes[ext] : 'application/octet-stream';
+        }
+        // Upload using Bun.s3
+        const s3Client = createS3Client({
+            endpoint: bucket.endpoint,
+            access_key: bucket.access_key,
+            secret_key: bucket.secret_key,
+            region: bucket.region,
+        });
+        await tui.spinner({
+            message: `Uploading ${actualFilename} to ${args.name}`,
+            clearOnSuccess: true,
+            callback: async () => {
+                await s3Client.write(actualFilename, fileContent, {
+                    type: contentType,
+                });
+            },
+        });
+        if (!options.json) {
+            tui.success(`Uploaded ${tui.bold(actualFilename)} to ${tui.bold(args.name)} (${fileContent.length} bytes)`);
+        }
+        return {
+            success: true,
+            bucket: args.name,
+            filename: actualFilename,
+            size: fileContent.length,
+        };
+    },
+});
+//# sourceMappingURL=upload.js.map

package/dist/cmd/cloud/storage/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/storage/upload.ts"],"names":[],"mappings":"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"}

package/dist/cmd/cloud/storage/utils.d.ts

@@ -0,0 +1,18 @@
+import { S3Client } from 'bun';
+/**
+ * Creates an S3Client configured for Agentuity storage buckets
+ *
+ * Agentuity provides bucket-specific endpoints in virtual-hosted-style format.
+ * The endpoint is already bucket-specific (e.g., bucket-name.agentuity.run),
+ * so we use virtualHostedStyle: true WITHOUT passing a bucket parameter.
+ *
+ * @param bucket - Bucket configuration with endpoint, credentials, and region
+ * @returns Configured S3Client instance
+ */
+export declare function createS3Client(bucket: {
+    endpoint: string;
+    access_key: string;
+    secret_key: string;
+    region?: string | null;
+}): S3Client;
+//# sourceMappingURL=utils.d.ts.map

package/dist/cmd/cloud/storage/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/storage/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,GAAG,QAAQ,CAQX"}

package/dist/cmd/cloud/storage/utils.js

@@ -0,0 +1,21 @@
+import { S3Client } from 'bun';
+/**
+ * Creates an S3Client configured for Agentuity storage buckets
+ *
+ * Agentuity provides bucket-specific endpoints in virtual-hosted-style format.
+ * The endpoint is already bucket-specific (e.g., bucket-name.agentuity.run),
+ * so we use virtualHostedStyle: true WITHOUT passing a bucket parameter.
+ *
+ * @param bucket - Bucket configuration with endpoint, credentials, and region
+ * @returns Configured S3Client instance
+ */
+export function createS3Client(bucket) {
+    return new S3Client({
+        endpoint: bucket.endpoint.startsWith('http') ? bucket.endpoint : `https://${bucket.endpoint}`,
+        accessKeyId: bucket.access_key,
+        secretAccessKey: bucket.secret_key,
+        region: bucket.region || 'auto',
+        virtualHostedStyle: true,
+    });
+}
+//# sourceMappingURL=utils.js.map

package/dist/cmd/cloud/storage/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/storage/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAE/B;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,MAK9B;IACA,OAAO,IAAI,QAAQ,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,MAAM,CAAC,QAAQ,EAAE;QAC7F,WAAW,EAAE,MAAM,CAAC,UAAU;QAC9B,eAAe,EAAE,MAAM,CAAC,UAAU;QAClC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,MAAM;QAC/B,kBAAkB,EAAE,IAAI;KACxB,CAAC,CAAC;AACJ,CAAC"}

package/dist/cmd/cloud/stream/delete.d.ts

@@ -0,0 +1,3 @@
+export declare const deleteSubcommand: import("../../..").CommandDefinition;
+export default deleteSubcommand;
+//# sourceMappingURL=delete.d.ts.map

package/dist/cmd/cloud/stream/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/delete.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB,sCAoC3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/cmd/cloud/stream/delete.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+const DeleteStreamResponseSchema = z.object({
+    id: z.string().describe('Stream ID'),
+});
+export const deleteSubcommand = createCommand({
+    name: 'delete',
+    aliases: ['del', 'rm'],
+    description: 'Delete a stream by ID (soft delete)',
+    tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
+    idempotent: true,
+    requires: { auth: true, project: true },
+    examples: [
+        `${getCommand('stream delete stream-id-123')} - Delete a stream`,
+        `${getCommand('stream rm stream-id-456')} - Delete stream (using alias)`,
+        `${getCommand('stream del stream-id-789')} - Delete stream (using alias)`,
+    ],
+    schema: {
+        args: z.object({
+            id: z.string().min(1).describe('the stream ID to delete'),
+        }),
+        response: DeleteStreamResponseSchema,
+    },
+    async handler(ctx) {
+        const { args, options } = ctx;
+        const started = Date.now();
+        const storage = await createStorageAdapter(ctx);
+        await storage.delete(args.id);
+        const durationMs = Date.now() - started;
+        if (!options.json) {
+            tui.success(`deleted stream ${args.id} in ${durationMs.toFixed(1)}ms`);
+        }
+        return {
+            id: args.id,
+        };
+    },
+});
+export default deleteSubcommand;
+//# sourceMappingURL=delete.js.map

package/dist/cmd/cloud/stream/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,aAAa,CAAC;IAC7C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;IACtB,WAAW,EAAE,qCAAqC;IAClD,IAAI,EAAE,CAAC,aAAa,EAAE,kBAAkB,EAAE,MAAM,EAAE,eAAe,CAAC;IAClE,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACvC,QAAQ,EAAE;QACT,GAAG,UAAU,CAAC,6BAA6B,CAAC,oBAAoB;QAChE,GAAG,UAAU,CAAC,yBAAyB,CAAC,gCAAgC;QACxE,GAAG,UAAU,CAAC,0BAA0B,CAAC,gCAAgC;KACzE;IACD,MAAM,EAAE;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SACzD,CAAC;QACF,QAAQ,EAAE,0BAA0B;KACpC;IAED,KAAK,CAAC,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAEhD,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE9B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;QAExC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnB,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,EAAE,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;QAED,OAAO;YACN,EAAE,EAAE,IAAI,CAAC,EAAE;SACX,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/cmd/cloud/stream/get.d.ts

@@ -0,0 +1,3 @@
+export declare const getSubcommand: import("../../..").CommandDefinition;
+export default getSubcommand;
+//# sourceMappingURL=get.d.ts.map

package/dist/cmd/cloud/stream/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/get.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,aAAa,sCA6FxB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/cloud/stream/get.js

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+const GetStreamResponseSchema = z.object({
+    id: z.string().describe('Stream ID'),
+    name: z.string().describe('Stream name'),
+    metadata: z.record(z.string(), z.string()).describe('Stream metadata'),
+    url: z.string().describe('Public URL'),
+    sizeBytes: z.number().describe('Size in bytes'),
+});
+export const getSubcommand = createCommand({
+    name: 'get',
+    description: 'Get detailed information about a specific stream',
+    tags: ['read-only', 'slow', 'requires-auth'],
+    requires: { auth: true, project: true },
+    idempotent: true,
+    examples: [
+        `${getCommand('stream get stream-id-123')} - Get stream details`,
+        `${getCommand('stream get stream-id-123 --json')} - Get stream as JSON`,
+        `${getCommand('stream get stream-id-123 --output stream.dat')} - Download stream to file`,
+        `${getCommand('stream get stream-id-123 -o stream.dat')} - Download stream (short flag)`,
+    ],
+    schema: {
+        args: z.object({
+            id: z.string().min(1).describe('the stream ID'),
+        }),
+        options: z.object({
+            output: z.string().optional().describe('download stream content to file'),
+        }),
+        response: GetStreamResponseSchema,
+    },
+    async handler(ctx) {
+        const { args, opts, options } = ctx;
+        const started = Date.now();
+        const storage = await createStorageAdapter(ctx);
+        // If --output is specified, download the stream content
+        if (opts.output) {
+            const readable = await storage.download(args.id);
+            const file = Bun.file(opts.output);
+            const writer = file.writer();
+            const reader = readable.getReader();
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    writer.write(value);
+                }
+                await writer.end();
+                const durationMs = Date.now() - started;
+                const stats = await Bun.file(opts.output).stat();
+                tui.success(`downloaded ${formatBytes(stats.size)} to ${opts.output} in ${durationMs.toFixed(1)}ms`);
+                // Fetch stream metadata to populate the response
+                const stream = await storage.get(args.id);
+                return {
+                    id: args.id,
+                    name: stream.name ?? '',
+                    metadata: stream.metadata ?? {},
+                    url: stream.url ?? '',
+                    sizeBytes: stats.size,
+                };
+            }
+            finally {
+                reader.releaseLock();
+            }
+        }
+        // Otherwise, get metadata
+        const stream = await storage.get(args.id);
+        const durationMs = Date.now() - started;
+        if (!options.json) {
+            if (!stream) {
+                tui.fatal(`Failed to retrieve stream metadata for ${args.id}`);
+            }
+            const sizeBytes = stream.sizeBytes ?? 0;
+            console.log(`Name:     ${tui.bold(stream.name ?? 'unknown')}`);
+            console.log(`ID:       ${stream.id}`);
+            console.log(`Size:     ${formatBytes(sizeBytes)}`);
+            console.log(`URL:      ${tui.link(stream.url ?? 'unknown')}`);
+            if (stream.metadata && Object.keys(stream.metadata).length > 0) {
+                console.log(`Metadata:`);
+                for (const [key, value] of Object.entries(stream.metadata)) {
+                    console.log(`  ${key}: ${value}`);
+                }
+            }
+            tui.success(`retrieved in ${durationMs.toFixed(1)}ms`);
+        }
+        return {
+            id: stream.id,
+            name: stream.name,
+            metadata: stream.metadata,
+            url: stream.url,
+            sizeBytes: stream.sizeBytes,
+        };
+    },
+});
+export default getSubcommand;
+//# sourceMappingURL=get.js.map

package/dist/cmd/cloud/stream/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/get.ts"],"names":[],"mappings":"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"}

package/dist/cmd/cloud/stream/index.d.ts

@@ -0,0 +1,3 @@
+export declare const streamCommand: import("../../..").CommandDefinition;
+export default streamCommand;
+//# sourceMappingURL=index.d.ts.map

package/dist/cmd/cloud/stream/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,sCAMxB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/cloud/stream/index.js

@@ -0,0 +1,13 @@
+import { createCommand } from '../../../types';
+import listSubcommand from './list';
+import getSubcommand from './get';
+import deleteSubcommand from './delete';
+export const streamCommand = createCommand({
+    name: 'stream',
+    aliases: ['streams'],
+    description: 'Manage streams',
+    tags: ['slow', 'requires-auth'],
+    subcommands: [listSubcommand, getSubcommand, deleteSubcommand],
+});
+export default streamCommand;
+//# sourceMappingURL=index.js.map

package/dist/cmd/cloud/stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,cAAc,MAAM,QAAQ,CAAC;AACpC,OAAO,aAAa,MAAM,OAAO,CAAC;AAClC,OAAO,gBAAgB,MAAM,UAAU,CAAC;AAExC,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,SAAS,CAAC;IACpB,WAAW,EAAE,gBAAgB;IAC7B,IAAI,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC;IAC/B,WAAW,EAAE,CAAC,cAAc,EAAE,aAAa,EAAE,gBAAgB,CAAC;CAC9D,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/cloud/stream/list.d.ts

@@ -0,0 +1,3 @@
+export declare const listSubcommand: import("../../..").CommandDefinition;
+export default listSubcommand;
+//# sourceMappingURL=list.d.ts.map

package/dist/cmd/cloud/stream/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/list.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,cAAc,sCAoHzB,CAAC;AAEH,eAAe,cAAc,CAAC"}