@miosa/sdk 2.0.7 → 3.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -55,7 +55,6 @@ await sbx.pause();
55
55
  | `miosa.sandboxes` | Lightweight code-execution VMs — exec, files, snapshots, previews |
56
56
  | `miosa.computers` | Full Linux desktop VMs with desktop control for agents |
57
57
  | `miosa.deployments` | Versioned production releases with rollback |
58
- | `miosa.appDocuments` | Durable generated apps with exact-version review approvals and immutable publication bindings |
59
58
  | `miosa.databases` | Managed Postgres / Redis lifecycle |
60
59
  | `miosa.storage` | S3-compatible object storage |
61
60
  | `miosa.volumes` | Persistent block storage |
@@ -70,38 +69,6 @@ await sbx.pause();
70
69
  | `miosa.completions` | OpenAI-compatible chat completions with SSE streaming |
71
70
  | `miosa.embeddings` | OpenAI-compatible embedding vectors |
72
71
 
73
- ## Durable generated apps
74
-
75
- App Documents persist the generated app contract outside the browser.
76
- They are workspace-scoped and include the view, declared capabilities, connectors, collections, automations, and component pins.
77
- Native rendering authority is a separate approval pinned to the current canonical version hash.
78
- Editing the document changes the hash and invalidates the old approval.
79
-
80
- ```ts
81
- const app = await miosa.appDocuments.create({
82
- workspaceId: "workspace-id",
83
- name: "Clinic triage",
84
- document: {
85
- id: crypto.randomUUID(),
86
- name: "Clinic triage",
87
- format: "miosa-app/v1",
88
- view: { kind: "generated", source: "<main>Triage</main>" },
89
- capabilities: ["computer.exec"],
90
- collections: ["tickets"],
91
- connectors: ["linear"],
92
- automations: [],
93
- pins: [],
94
- },
95
- });
96
-
97
- const approval = await miosa.appDocuments.approveExactVersion(
98
- app.id,
99
- "Reviewed for exact release publishing",
100
- );
101
-
102
- await miosa.appDocuments.revokeApproval(app.id, approval.id);
103
- ```
104
-
105
72
  ## Connect vs Egress
106
73
 
107
74
  Use **Connect** when your product needs to manage provider credentials for
@@ -291,30 +258,6 @@ const deployment = await sbx.deploy({
291
258
  });
292
259
  ```
293
260
 
294
- To publish the exact snapshot that passed QA instead of whatever the editable
295
- sandbox holds right now, use `deploySnapshot`. It forks the snapshot into a
296
- temporary release sandbox, deploys that fork, and destroys it again, so the
297
- source sandbox is never mutated:
298
-
299
- ```ts
300
- const snap = await sbx.snapshots.create("qa-approved");
301
-
302
- const release = await sbx.deploySnapshot(snap.id, {
303
- name: "clinic-intake",
304
- outputPath: "/workspace/dist",
305
- entrypoint: "index.html",
306
- });
307
-
308
- console.log(release.source_snapshot_id, release.release_sandbox_id);
309
- ```
310
-
311
- The result always carries `source_snapshot_id` and `release_sandbox_id` for
312
- provenance. Pass `{ cleanup: false }` as the third argument to keep the release
313
- sandbox for inspection. If the release sandbox could not be destroyed, the
314
- deployment still succeeds and `release.release_cleanup_error` explains why; when
315
- the deploy itself fails and the release sandbox survives, the thrown error
316
- carries the same fields so the leftover sandbox can be cleaned up by id.
317
-
318
261
  For workspace App Engine, publish from the same sandbox but choose the
319
262
  App Engine target:
320
263