@mindstudio-ai/remy 0.1.120 → 0.1.121

package/dist/prompt/compiled/methods.md

@@ -1,6 +1,6 @@
 # Methods
 
-A method is a named async function that runs on the platform. It's the universal unit of backend logic — every interface (web, API, Discord, cron, webhook) invokes methods. Methods run in isolated sandboxes. One file per method, one named export.
+A method is a named async function that runs on the platform. It's the universal unit of backend logic — every interface (web, API, Discord, cron, webhook) invokes methods. One file per method, one named export.
 
 ## Writing a Method
 
@@ -192,6 +192,37 @@ export async function createPurchaseOrder(input: {
 }
 ```
 
+## Fire-and-Forget Background Tasks
+
+A method can return immediately while kicking off slow work (like `runTask()`) that continues in the background. Don't await the slow call — use `.then()` / `.catch()` to update the record when it completes, and return an early result to the caller. The frontend polls the record's status to track progress.
+
+```typescript
+export async function enrichRestaurant(input: { id: string; name: string }) {
+  await Restaurants.update(input.id, { status: 'enriching' });
+
+  // Fire — don't await
+  agent.runTask<RestaurantData>({
+    prompt: '...',
+    input: { name: input.name },
+    tools: ['searchGoogle', 'fetchUrl', 'generateImage'],
+    structuredOutputExample: { /* ... */ },
+    model: 'claude-4-6-sonnet',
+  }).then(async (result) => {
+    if (result.parsedSuccessfully) {
+      await Restaurants.update(input.id, { ...result.output, status: 'complete' });
+    } else {
+      await Restaurants.update(input.id, { status: 'failed' });
+    }
+  }).catch(async () => {
+    await Restaurants.update(input.id, { status: 'failed' });
+  });
+
+  return { status: 'enriching' };
+}
+```
+
+This works because the execution environment persists between requests. The un-awaited promise continues after the method returns. DB, auth, and SDK all work normally in the background chain. For critical workflows, write a "pending" record before firing so incomplete tasks can be detected and retried.
+
 ## Shared Helpers
 
 Code shared between methods goes in `dist/methods/src/common/`. Helpers are not listed in the manifest — they're internal, imported by methods but not directly invocable.

package/dist/prompt/compiled/platform.md

@@ -94,7 +94,7 @@ const { vendor } = await api.approveVendor({ vendorId: '...' });
 - **Managed databases.** SQLite with typed schemas. Push a schema change and the platform diffs, migrates, and promotes atomically.
 - **Built-in auth.** Opt-in via manifest. Developer builds login UI, platform handles verification codes (email/SMS), cookie sessions, and role enforcement. Backend methods use `auth.requireRole('admin')` for access control.
 - **Multiple interfaces, one codebase.** Web, API, Discord, Telegram, Cron, Webhook, Email, MCP — all invoke the same methods. Methods don't know which interface called them.
-- **Sandboxed execution.** Methods run in isolated sandboxes with npm packages pre-installed.
+- **Sandboxed execution.** Each method invocation runs in its own isolated execution context with npm packages pre-installed.
 - **Git-native deployment.** Push to default branch to deploy. Push to feature branch for preview. Rollback is a git revert.
 
 ## Minimum Viable App

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/remy",
-  "version": "0.1.120",
+  "version": "0.1.121",
   "description": "MindStudio coding agent",
   "repository": {
     "type": "git",