@liquidmetal-ai/raindrop 0.13.0 → 0.15.0

package/dist/commands/build/queue/setup.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class QueueSetup extends BaseCommand<typeof QueueSetup> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private generateObserverFile;
+    private updateManifest;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/build/queue/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/queue/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,WAAW,CAAC,OAAO,UAAU,CAAC;IACpE,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SAA+D;IAEjF,MAAM,CAAC,QAAQ,WAOb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;MAUV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA2DZ,oBAAoB;YAKpB,cAAc;CAmC7B"}

package/dist/commands/build/queue/setup.js

@@ -0,0 +1,120 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { BaseCommand } from '../../../base-command.js';
+import { renderTemplateFromFile, TEMPLATES_DIR } from '../../../codegen.js';
+export default class QueueSetup extends BaseCommand {
+    static args = {};
+    static description = 'Add a queue with consumer (observer) to your Raindrop app';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>
+Add queue with default name "my-queue"
+
+<%= config.bin %> <%= command.id %> --name tasks
+Add queue with custom name "tasks"
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        name: Flags.string({
+            description: 'Name for the queue',
+            default: 'my-queue',
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Preview changes without applying them',
+            default: false,
+        }),
+    };
+    async run() {
+        const queueName = this.flags.name;
+        const observerName = `${queueName}-consumer`;
+        const dryRun = this.flags['dry-run'];
+        if (dryRun) {
+            this.log(chalk.blue.bold('DRY RUN - Preview of changes (no files will be modified)'));
+            this.log('');
+            this.log(chalk.blue('Would create:') + ' ' + chalk.bold(`src/${observerName}/index.ts`));
+            this.log(chalk.dim('  - 50 lines of queue consumer code'));
+            this.log(chalk.dim('  - Message processing, error handling, retry logic'));
+            this.log('');
+            this.log(chalk.blue('Would update:') + ' ' + chalk.bold('raindrop.manifest'));
+            this.log(chalk.dim(`  + queue "${queueName}" {}`));
+            this.log(chalk.dim(`  + observer "${observerName}" {`));
+            this.log(chalk.dim(`      source { queue = "${queueName}" ... }`));
+            this.log(chalk.dim(`    }`));
+            this.log('');
+            this.log(chalk.blue('Environment binding:') + ' ' + chalk.bold(`this.env.${queueName.toUpperCase().replace(/-/g, '_')}`));
+            this.log('');
+            this.log(chalk.yellow('Run without --dry-run to apply these changes'));
+            return;
+        }
+        try {
+            // Step 1: Create observer directory
+            const observerDir = path.join(process.cwd(), 'src', observerName);
+            await fs.mkdir(observerDir, { recursive: true });
+            // Step 2: Generate observer file
+            const observerContent = await this.generateObserverFile(queueName);
+            const observerPath = path.join(observerDir, 'index.ts');
+            await fs.writeFile(observerPath, observerContent);
+            this.log(chalk.green('✓') + ' Created ' + chalk.bold(`src/${observerName}/index.ts`));
+            // Step 3: Update manifest
+            await this.updateManifest(queueName, observerName);
+            this.log(chalk.green('✓') + ' Updated ' + chalk.bold('raindrop.manifest'));
+            // Step 4: Show next steps
+            this.log('');
+            this.log(chalk.bold.cyan('Next Steps:'));
+            this.log('');
+            this.log('1. Run ' + chalk.bold('raindrop build generate') + ' to update types');
+            this.log('2. Check out ' + chalk.bold(`src/${observerName}/index.ts`) + ' for the consumer code');
+            this.log('3. Send messages to the queue from your services:');
+            this.log('');
+            this.log(chalk.dim('Example usage:'));
+            this.log(chalk.dim(`  await this.env.${queueName.toUpperCase().replace(/-/g, '_')}.send({`));
+            this.log(chalk.dim(`    task: 'process-order',`));
+            this.log(chalk.dim(`    orderId: '12345'`));
+            this.log(chalk.dim(`  });`));
+            this.log('');
+        }
+        catch (error) {
+            this.error(`Failed to set up queue: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async generateObserverFile(queueName) {
+        const templatePath = path.join(TEMPLATES_DIR, 'handlers', 'queue-consumer-setup.ts.hbs');
+        return renderTemplateFromFile(templatePath, { queueName });
+    }
+    async updateManifest(queueName, observerName) {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            let content = await fs.readFile(manifestPath, 'utf-8');
+            // Check if queue already exists
+            if (content.includes(`queue "${queueName}"`)) {
+                this.log(chalk.yellow('⚠') + ' Queue already exists in manifest');
+                return;
+            }
+            // Find the application block and add the queue and observer
+            const appMatch = content.match(/application\s+"[^"]+"\s+\{/);
+            if (appMatch) {
+                const insertPos = appMatch.index + appMatch[0].length;
+                const binding = `\n  queue "${queueName}" {}\n\n  observer "${observerName}" {
+    source {
+      queue = "${queueName}"
+      max_retries = 5
+      batch_size = 1
+    }
+  }\n`;
+                content = content.slice(0, insertPos) + binding + content.slice(insertPos);
+                await fs.writeFile(manifestPath, content);
+            }
+            else {
+                throw new Error('Could not find application block in raindrop.manifest');
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error('raindrop.manifest not found. Are you in a Raindrop project directory?');
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/build/smartbucket/setup.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class SmartBucketSetup extends BaseCommand<typeof SmartBucketSetup> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private generateExampleFile;
+    private findExistingBinding;
+    private findFirstHandler;
+    private updateManifest;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/build/smartbucket/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/smartbucket/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW,CAAC,OAAO,gBAAgB,CAAC;IAChF,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SAAgF;IAElG,MAAM,CAAC,QAAQ,WAOb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;MAUV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA4EZ,mBAAmB;YAKnB,mBAAmB;YAcnB,gBAAgB;YA2BhB,cAAc;CA6B7B"}

package/dist/commands/build/smartbucket/setup.js

@@ -0,0 +1,167 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { BaseCommand } from '../../../base-command.js';
+import { renderTemplateFromFile, TEMPLATES_DIR } from '../../../codegen.js';
+export default class SmartBucketSetup extends BaseCommand {
+    static args = {};
+    static description = 'Add SmartBucket (file storage with AI-powered search) to your Raindrop app';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>
+Add SmartBucket with default name "my-bucket"
+
+<%= config.bin %> <%= command.id %> --name documents
+Add SmartBucket with custom name "documents"
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        name: Flags.string({
+            description: 'Name for the SmartBucket binding',
+            default: 'my-bucket',
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Preview changes without applying them',
+            default: false,
+        }),
+    };
+    async run() {
+        // Check if binding already exists in manifest, use that name if found
+        const existingBinding = await this.findExistingBinding('smartbucket');
+        const manifestName = existingBinding || this.flags.name;
+        const bindingName = manifestName.toUpperCase().replace(/-/g, '_');
+        const dryRun = this.flags['dry-run'];
+        // Find the first handler (service/actor/observer/task) to determine import path
+        const handlerName = await this.findFirstHandler();
+        // If no handler found, warn user and provide guidance
+        if (!handlerName) {
+            this.log(chalk.yellow.bold('⚠ No service, actor, observer, or task found in manifest'));
+            this.log('');
+            this.log('SmartBucket examples require a handler to generate type-safe code.');
+            this.log('Please add a handler to your manifest first:');
+            this.log('');
+            this.log(chalk.cyan('  service "api" {'));
+            this.log(chalk.cyan('    visibility = "public"'));
+            this.log(chalk.cyan('  }'));
+            this.log('');
+            this.log('Then run:');
+            this.log(chalk.bold('  raindrop build generate'));
+            this.log(chalk.bold('  raindrop build smartbucket setup'));
+            return;
+        }
+        if (dryRun) {
+            this.log(chalk.blue.bold('DRY RUN - Preview of changes (no files will be modified)'));
+            this.log('');
+            this.log(chalk.blue('Would create:') + ' ' + chalk.bold('src/examples/smartbucket-minimal.ts'));
+            this.log(chalk.dim('  - 60 lines of example code'));
+            this.log(chalk.dim('  - Upload, download, list file operations'));
+            this.log('');
+            this.log(chalk.blue('Would update:') + ' ' + chalk.bold('raindrop.manifest'));
+            this.log(chalk.dim(`  + smartbucket "${manifestName}" {}`));
+            this.log('');
+            this.log(chalk.blue('Environment binding:') + ' ' + chalk.bold(`this.env.${bindingName}`));
+            this.log('');
+            this.log(chalk.yellow('Run without --dry-run to apply these changes'));
+            return;
+        }
+        try {
+            // Step 1: Create examples directory if it doesn't exist
+            const examplesDir = path.join(process.cwd(), 'src', 'examples');
+            await fs.mkdir(examplesDir, { recursive: true });
+            // Step 2: Generate example file
+            const exampleContent = await this.generateExampleFile(bindingName, handlerName);
+            const examplePath = path.join(examplesDir, 'smartbucket-minimal.ts');
+            await fs.writeFile(examplePath, exampleContent);
+            this.log(chalk.green('✓') + ' Created ' + chalk.bold('src/examples/smartbucket-minimal.ts'));
+            // Step 3: Update manifest
+            await this.updateManifest(manifestName);
+            this.log(chalk.green('✓') + ' Updated ' + chalk.bold('raindrop.manifest'));
+            // Step 4: Show next steps
+            this.log('');
+            this.log(chalk.bold.cyan('Next Steps:'));
+            this.log('');
+            this.log('1. Run ' + chalk.bold('raindrop build generate') + ' to update types');
+            this.log('2. Check out ' + chalk.bold('src/examples/smartbucket-minimal.ts') + ' for example code');
+            this.log('3. Use ' + chalk.bold(`this.env.${bindingName}`) + ' in your handlers to store and search files');
+            this.log('');
+            this.log(chalk.dim('Example usage:'));
+            this.log(chalk.dim(`  await this.env.${bindingName}.put('file.pdf', pdfData);`));
+            this.log(chalk.dim(`  const file = await this.env.${bindingName}.get('file.pdf');`));
+            this.log('');
+        }
+        catch (error) {
+            this.error(`Failed to set up SmartBucket: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async generateExampleFile(bindingName, handlerName) {
+        const templatePath = path.join(TEMPLATES_DIR, 'examples', 'smartbucket-minimal.ts.hbs');
+        return renderTemplateFromFile(templatePath, { bindingName, handlerName });
+    }
+    async findExistingBinding(bindingType) {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            const content = await fs.readFile(manifestPath, 'utf-8');
+            // Match: smartbucket "name" {} or smartbucket "name" { ... }
+            const regex = new RegExp(`^\\s*${bindingType}\\s+"([^"]+)"`, 'm');
+            const match = content.match(regex);
+            return match?.[1] || null;
+        }
+        catch (_error) {
+            return null;
+        }
+    }
+    async findFirstHandler() {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            const content = await fs.readFile(manifestPath, 'utf-8');
+            // Look for first uncommented service, actor, observer, or task
+            const serviceMatch = content.match(/^\s*service\s+"([^"]+)"/m);
+            if (serviceMatch?.[1])
+                return serviceMatch[1];
+            const actorMatch = content.match(/^\s*actor\s+"([^"]+)"/m);
+            if (actorMatch?.[1])
+                return actorMatch[1];
+            const observerMatch = content.match(/^\s*observer\s+"([^"]+)"/m);
+            if (observerMatch?.[1])
+                return observerMatch[1];
+            const taskMatch = content.match(/^\s*task\s+"([^"]+)"/m);
+            if (taskMatch?.[1])
+                return taskMatch[1];
+            // Return null if no handler found
+            return null;
+        }
+        catch (_error) {
+            // Return null if can't read manifest
+            return null;
+        }
+    }
+    async updateManifest(manifestName) {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            let content = await fs.readFile(manifestPath, 'utf-8');
+            // Check if SmartBucket binding already exists
+            if (content.includes(`smartbucket "${manifestName}"`)) {
+                this.log(chalk.yellow('⚠') + ' SmartBucket binding already exists in manifest');
+                return;
+            }
+            // Find the application block and add the smartbucket binding
+            const appMatch = content.match(/application\s+"[^"]+"\s+\{/);
+            if (appMatch) {
+                const insertPos = appMatch.index + appMatch[0].length;
+                const binding = `\n  smartbucket "${manifestName}" {}\n`;
+                content = content.slice(0, insertPos) + binding + content.slice(insertPos);
+                await fs.writeFile(manifestPath, content);
+            }
+            else {
+                throw new Error('Could not find application block in raindrop.manifest');
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error('raindrop.manifest not found. Are you in a Raindrop project directory?');
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/build/smartmemory/setup.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class SmartMemorySetup extends BaseCommand<typeof SmartMemorySetup> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private generateExampleFile;
+    private findExistingBinding;
+    private findFirstHandler;
+    private updateManifest;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/build/smartmemory/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/smartmemory/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW,CAAC,OAAO,gBAAgB,CAAC;IAChF,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SAA8E;IAEhG,MAAM,CAAC,QAAQ,WAOb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;MAUV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YAkFZ,mBAAmB;YAKnB,mBAAmB;YAanB,gBAAgB;YA2BhB,cAAc;CA6B7B"}

package/dist/commands/build/smartmemory/setup.js

@@ -0,0 +1,172 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { BaseCommand } from '../../../base-command.js';
+import { renderTemplateFromFile, TEMPLATES_DIR } from '../../../codegen.js';
+export default class SmartMemorySetup extends BaseCommand {
+    static args = {};
+    static description = 'Add SmartMemory (AI conversation memory management) to your Raindrop app';
+    static examples = [
+        `<%= config.bin %> <%= command.id %>
+Add SmartMemory with default name "memory"
+
+<%= config.bin %> <%= command.id %> --name chat-memory
+Add SmartMemory with custom name "chat-memory"
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        name: Flags.string({
+            description: 'Name for the SmartMemory binding',
+            default: 'memory',
+        }),
+        'dry-run': Flags.boolean({
+            description: 'Preview changes without applying them',
+            default: false,
+        }),
+    };
+    async run() {
+        // Check if binding already exists in manifest, use that name if found
+        const existingBinding = await this.findExistingBinding('smartmemory');
+        const manifestName = existingBinding || this.flags.name;
+        const bindingName = manifestName.toUpperCase().replace(/-/g, '_');
+        const dryRun = this.flags['dry-run'];
+        // Find the first handler (service/actor/observer/task) to determine import path
+        const handlerName = await this.findFirstHandler();
+        // If no handler found, warn user and provide guidance
+        if (!handlerName) {
+            this.log(chalk.yellow.bold('⚠ No service, actor, observer, or task found in manifest'));
+            this.log('');
+            this.log('SmartMemory examples require a handler to generate type-safe code.');
+            this.log('Please add a handler to your manifest first:');
+            this.log('');
+            this.log(chalk.cyan('  service "api" {'));
+            this.log(chalk.cyan('    visibility = "public"'));
+            this.log(chalk.cyan('  }'));
+            this.log('');
+            this.log('Then run:');
+            this.log(chalk.bold('  raindrop build generate'));
+            this.log(chalk.bold('  raindrop build smartmemory setup'));
+            return;
+        }
+        if (dryRun) {
+            this.log(chalk.blue.bold('DRY RUN - Preview of changes (no files will be modified)'));
+            this.log('');
+            this.log(chalk.blue('Would create:') + ' ' + chalk.bold('src/examples/smartmemory-minimal.ts'));
+            this.log(chalk.dim('  - 50 lines of example code'));
+            this.log(chalk.dim('  - Session management, memory storage/retrieval, search, summarization'));
+            this.log('');
+            this.log(chalk.blue('Would update:') + ' ' + chalk.bold('raindrop.manifest'));
+            this.log(chalk.dim(`  + smartmemory "${manifestName}" {}`));
+            this.log('');
+            this.log(chalk.blue('Environment binding:') + ' ' + chalk.bold(`this.env.${bindingName}`));
+            this.log('');
+            this.log(chalk.yellow('Run without --dry-run to apply these changes'));
+            return;
+        }
+        try {
+            // Step 1: Create examples directory if it doesn't exist
+            const examplesDir = path.join(process.cwd(), 'src', 'examples');
+            await fs.mkdir(examplesDir, { recursive: true });
+            // Step 2: Generate example file
+            const exampleContent = await this.generateExampleFile(bindingName, handlerName);
+            const examplePath = path.join(examplesDir, 'smartmemory-minimal.ts');
+            await fs.writeFile(examplePath, exampleContent);
+            this.log(chalk.green('✓') + ' Created ' + chalk.bold('src/examples/smartmemory-minimal.ts'));
+            // Step 3: Update manifest
+            await this.updateManifest(manifestName);
+            this.log(chalk.green('✓') + ' Updated ' + chalk.bold('raindrop.manifest'));
+            // Step 4: Show next steps
+            this.log('');
+            this.log(chalk.bold.cyan('Next Steps:'));
+            this.log('');
+            this.log('1. Run ' + chalk.bold('raindrop build generate') + ' to update types');
+            this.log('2. Check out ' + chalk.bold('src/examples/smartmemory-minimal.ts') + ' for example code');
+            this.log('3. Use ' + chalk.bold(`this.env.${bindingName}`) + ' in your handlers to manage conversation memory');
+            this.log('');
+            this.log(chalk.bold('Related features:'));
+            this.log(chalk.dim('   • SmartSQL for structured data: raindrop build smartsql setup'));
+            this.log(chalk.dim('   • SmartBucket for document context: raindrop build smartbucket setup'));
+            this.log(chalk.dim('   • Explore all features: raindrop build features'));
+            this.log('');
+            this.log(chalk.dim('Example usage:'));
+            this.log(chalk.dim(`  const { sessionId, workingMemory } =`));
+            this.log(chalk.dim(`    await this.env.${bindingName}.startWorkingMemorySession();`));
+            this.log(chalk.dim(`  await workingMemory.putMemory({ content: 'User message', agent: 'user' });`));
+            this.log('');
+        }
+        catch (error) {
+            this.error(`Failed to set up SmartMemory: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async generateExampleFile(bindingName, handlerName) {
+        const templatePath = path.join(TEMPLATES_DIR, 'examples', 'smartmemory-minimal.ts.hbs');
+        return renderTemplateFromFile(templatePath, { bindingName, handlerName });
+    }
+    async findExistingBinding(bindingType) {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            const content = await fs.readFile(manifestPath, 'utf-8');
+            const regex = new RegExp(`^\\s*${bindingType}\\s+"([^"]+)"`, 'm');
+            const match = content.match(regex);
+            return match?.[1] || null;
+        }
+        catch (_error) {
+            return null;
+        }
+    }
+    async findFirstHandler() {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            const content = await fs.readFile(manifestPath, 'utf-8');
+            // Look for first uncommented service, actor, observer, or task
+            const serviceMatch = content.match(/^\s*service\s+"([^"]+)"/m);
+            if (serviceMatch?.[1])
+                return serviceMatch[1];
+            const actorMatch = content.match(/^\s*actor\s+"([^"]+)"/m);
+            if (actorMatch?.[1])
+                return actorMatch[1];
+            const observerMatch = content.match(/^\s*observer\s+"([^"]+)"/m);
+            if (observerMatch?.[1])
+                return observerMatch[1];
+            const taskMatch = content.match(/^\s*task\s+"([^"]+)"/m);
+            if (taskMatch?.[1])
+                return taskMatch[1];
+            // Return null if no handler found
+            return null;
+        }
+        catch (_error) {
+            // Return null if can't read manifest
+            return null;
+        }
+    }
+    async updateManifest(manifestName) {
+        const manifestPath = path.join(process.cwd(), 'raindrop.manifest');
+        try {
+            let content = await fs.readFile(manifestPath, 'utf-8');
+            // Check if SmartMemory binding already exists
+            if (content.includes(`smartmemory "${manifestName}"`)) {
+                this.log(chalk.yellow('⚠') + ' SmartMemory binding already exists in manifest');
+                return;
+            }
+            // Find the application block and add the smartmemory binding
+            const appMatch = content.match(/application\s+"[^"]+"\s+\{/);
+            if (appMatch) {
+                const insertPos = appMatch.index + appMatch[0].length;
+                const binding = `\n  smartmemory "${manifestName}" {}\n`;
+                content = content.slice(0, insertPos) + binding + content.slice(insertPos);
+                await fs.writeFile(manifestPath, content);
+            }
+            else {
+                throw new Error('Could not find application block in raindrop.manifest');
+            }
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                throw new Error('raindrop.manifest not found. Are you in a Raindrop project directory?');
+            }
+            throw error;
+        }
+    }
+}

package/dist/commands/build/smartsql/setup.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../../base-command.js';
+export default class SmartSqlSetup extends BaseCommand<typeof SmartSqlSetup> {
+    static args: {};
+    static description: string;
+    static examples: string[];
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private generateExampleFile;
+    private findExistingBinding;
+    private findFirstHandler;
+    private updateManifest;
+}
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/build/smartsql/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/commands/build/smartsql/setup.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW,CAAC,OAAO,aAAa,CAAC;IAC1E,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,WAAW,SAAkF;IAEpG,MAAM,CAAC,QAAQ,WAOb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;MAUV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;YA8EZ,mBAAmB;YAKnB,mBAAmB;YAanB,gBAAgB;YA2BhB,cAAc;CA8B7B"}