@astrale-os/adapter-astrale 0.5.0-beta.76 → 0.5.0-beta.78

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## [0.5.0-beta.78](https://github.com/astrale-os/sdk/compare/adapter-astrale-v0.5.0-beta.77...adapter-astrale-v0.5.0-beta.78) (2026-08-29)
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @astrale-os/adapter-cloudflare bumped to 0.5.0-beta.85
+    * @astrale-os/sdk bumped to 0.5.0-beta.82
+
+## [0.5.0-beta.77](https://github.com/astrale-os/sdk/compare/adapter-astrale-v0.5.0-beta.76...adapter-astrale-v0.5.0-beta.77) (2026-08-29)
+
+
+### Features
+
+* **app:** add development session file ([#339](https://github.com/astrale-os/sdk/issues/339)) ([f28e9c6](https://github.com/astrale-os/sdk/commit/f28e9c6fb707b8791a5bc63eba3b616aa7b02342))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @astrale-os/adapter-cloudflare bumped to 0.5.0-beta.84
+    * @astrale-os/sdk bumped to 0.5.0-beta.81
+
 ## [0.5.0-beta.76](https://github.com/astrale-os/sdk/compare/adapter-astrale-v0.5.0-beta.75...adapter-astrale-v0.5.0-beta.76) (2026-08-29)
 
 

package/README.md

@@ -22,7 +22,10 @@ npm install @astrale-os/sdk@beta @astrale-os/adapter-astrale@beta
 
 Bare installs return to stable releases when the package set is promoted and npm `latest` advances.
 
-The adapter admits the exact Services deployment response. Expected `invalid-deployment`,
+The adapter sends provider-neutral deployment material: Services receives no Schema revision,
+Publication identity, issuer, or callable inventory. It admits the exact generic Services response,
+then assembles the expected Release from its local Build and verifies the live Publication before
+installation. Expected `invalid-deployment`,
 `service-unavailable`, and `artifact-mode-conflict` rejections preserve their actionable Domain
 message; malformed or unknown response evidence still fails closed.
 
@@ -33,3 +36,8 @@ processes and retains the installation plus a non-secret local reconciliation re
 `pnpm dev` replaces a stale Quick issuer only when that record still matches fresh Kernel
 introspection; drift fails safely with an explicit recovery command. Use
 `pnpm dev --host https://your-ingress.example --port 8787` to supply stable ingress.
+
+Automation may add `--session-file /private/path/development-session.json`. The SDK exclusively
+creates that non-existent path inside a caller-owned private directory and retains one atomic,
+versioned `DevelopmentSessionFileV1` snapshot after termination. It is the machine contract for
+session phase and exact installed Release identity; stdout and stderr remain human diagnostics.

package/dist/deploy/deploy.js

@@ -101,7 +101,7 @@ export async function deployAstrale(parameters, context, dependencies) {
     const expectedServiceKey = serviceKeyFromOrigin(origin);
     let observation;
     try {
-        observation = deployedService(deployed, expectedServiceKey, context.artifact.build.schema.compiled.root.revision);
+        observation = deployedService(deployed, expectedServiceKey);
     }
     catch (cause) {
         return failed('provider', progress({

package/dist/deploy/service/request.d.ts

@@ -17,7 +17,6 @@ export interface DeploymentRequest {
     readonly serviceKey: string;
     readonly name: string;
     readonly revisioned: {
-        readonly revision: string;
         readonly requiredSecrets: readonly string[];
         readonly release: EncodedArtifact;
     };

package/dist/deploy/service/request.js

@@ -25,7 +25,6 @@ export function deploymentRequest(artifact, input) {
         serviceKey: serviceKeyFromOrigin(worker.origin),
         name: input.name,
         revisioned: Object.freeze({
-            revision: worker.revision,
             requiredSecrets: worker.bindings.requiredSecrets,
             release: executable(worker.release),
         }),

package/dist/deploy/service/response.d.ts

@@ -1,4 +1,4 @@
-export declare function deployedService(input: unknown, expectedServiceKey: string, expectedRevision: string): {
+export declare function deployedService(input: unknown, expectedServiceKey: string): {
     readonly url?: string;
     readonly digest: string;
 };

package/dist/deploy/service/response.js

@@ -1,11 +1,9 @@
-export function deployedService(input, expectedServiceKey, expectedRevision) {
+export function deployedService(input, expectedServiceKey) {
     if (input === null || typeof input !== 'object' || Array.isArray(input))
         invalidDeployment();
     const value = input;
     if (value.kind === 'rejected')
         rejectDeployment(value);
-    if (value.error !== undefined && value.error !== null)
-        invalidDeployment();
     if (value.state !== 'ready') {
         throw new TypeError('Astrale Services deployment did not report ready provider state.');
     }
@@ -15,9 +13,6 @@ export function deployedService(input, expectedServiceKey, expectedRevision) {
     if (typeof value.digest !== 'string' || value.digest.length === 0) {
         throw new TypeError('Astrale Services deployment returned an invalid provider digest.');
     }
-    if (value.revision !== expectedRevision) {
-        throw new TypeError('Astrale Services deployment returned a different Schema revision.');
-    }
     let url;
     if (typeof value.url === 'string') {
         try {

package/dist/development/develop.js

@@ -94,6 +94,7 @@ export async function developAstrale(parameters, context, dependencies = default
     let port = requestedPort;
     let ingress;
     let localSession;
+    let installedRelease;
     let stopping = false;
     let terminal = false;
     let generation = 0;
@@ -116,7 +117,7 @@ export async function developAstrale(parameters, context, dependencies = default
                 throw new TypeError('Domain origin changed during development; restart pnpm dev to acquire the new target coordinate.');
             }
             const release = assemble(current.artifact.build, addressing(placement.releaseUrl));
-            await dependencies.reconcileInstallation({
+            const observed = await dependencies.reconcileInstallation({
                 executable: toolchain.cli,
                 projectDir: context.projectDir,
                 instance,
@@ -124,6 +125,7 @@ export async function developAstrale(parameters, context, dependencies = default
                 signal,
                 ...(recordPath === undefined ? {} : { recordPath }),
             }, release, installation);
+            installedRelease = observed;
             let pageUrl;
             try {
                 pageUrl = await view.refresh(release, placement.localUrl, signal);
@@ -131,7 +133,7 @@ export async function developAstrale(parameters, context, dependencies = default
             catch (cause) {
                 report('View unavailable', message(cause));
             }
-            await context.onPlacement(placement);
+            await context.onPlacement(Object.freeze({ ...placement, installedRelease: observed }));
             report('Installed', `${instance} · ${release.build.schema.compiled.root.revision}`);
             if (pageUrl !== undefined)
                 report('View', pageUrl);
@@ -206,6 +208,7 @@ export async function developAstrale(parameters, context, dependencies = default
     const recover = async (observedGeneration, kind, original) => {
         if (stopping || observedGeneration !== generation)
             return;
+        await context.onRecovering?.();
         report('Recovering', kind === 'ingress' ? 'public ingress' : 'local runtime');
         generation += 1;
         const previousLocal = localSession;
@@ -265,7 +268,7 @@ export async function developAstrale(parameters, context, dependencies = default
     generation += 1;
     supervise(localSession, ingress, generation);
     const result = Object.freeze({
-        current: () => localSession.current(),
+        current: () => Object.freeze({ ...localSession.current(), installedRelease }),
         update(next) {
             if (terminal)
                 return Promise.reject(new Error('Astrale development session is terminal.'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/adapter-astrale",
-  "version": "0.5.0-beta.76",
+  "version": "0.5.0-beta.78",
   "description": "Deploy an Astrale domain as a managed service through the Astrale platform",
   "keywords": [
     "adapter",
@@ -37,8 +37,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dependencies": {
-    "@astrale-os/adapter-cloudflare": "0.5.0-beta.83",
-    "@astrale-os/sdk": "0.5.0-beta.80"
+    "@astrale-os/adapter-cloudflare": "0.5.0-beta.85",
+    "@astrale-os/sdk": "0.5.0-beta.82"
   },
   "devDependencies": {
     "@astrale-os/ox": "0.1.3",