@astrale-os/kernel-protocol 1.0.0-beta.5 → 1.0.0-beta.6

package/dist/invocation/index.d.ts

@@ -12,7 +12,7 @@ export { decodeRequest, type Request } from './request.js';
 export { admitTrace, MAXIMUM_TRACEPARENT_BYTES, MAXIMUM_TRACESTATE_BYTES, MAXIMUM_TRACESTATE_MEMBERS, type Trace, } from './trace.js';
 export { acceptRouting, routedDigest, routedRevision, type Refresh, type Routing, type Via, } from './routing.js';
 export { acceptSchemaTarget, type SchemaTarget } from './schema.js';
-export { decodeResponse, type ErrorResponse, type Response, type ResponseContext, type SuccessResponse, } from './response.js';
+export { decodeResponse, type ErrorResponse, type ExecutionResponse, type Response, type ResponseContext, type SuccessResponse, } from './response.js';
 export { CALLABLE_FINGERPRINT_MISMATCH, DEPLOYMENT_RETIRED, SERVICE_CANDIDATE_INVALID, SERVICE_TRUST_REQUIRED, SERVICE_UNAVAILABLE, serviceErrorOf, type CallableFingerprintMismatchDetails, type CallableFingerprintMismatchReason, type DeploymentRetiredDetails, type DeploymentRetiredReason, type ServiceCandidateInvalidDetails, type ServiceCandidateInvalidReason, type ServiceErrorPayload, type ServiceReason, type ServiceTrustRequiredDetails, type ServiceTrustRequiredReason, type ServiceUnavailableDetails, type ServiceUnavailableReason, } from './service-reason.js';
 export { decodeStale, stale, type Stale } from './stale-route.js';
 export { decodeStreamFrame, type StreamEndFrame, type StreamErrorFrame, type StreamFrame, type StreamItemFrame, type StreamStartFrame, } from './stream.js';

package/dist/invocation/response.d.ts

@@ -1,4 +1,5 @@
 import type { Value } from '@astrale-os/kernel-dsl/value';
+import { type NodeId } from '@astrale-os/kernel-core/graph/node';
 import type { ErrorPayload } from '../errors/index.js';
 import type { RequestId } from './correlation.js';
 import type { InvocationId } from './identity.js';
@@ -15,5 +16,9 @@ export interface SuccessResponse<Result extends Value = Value> extends ResponseC
 export interface ErrorResponse extends ResponseContext {
     readonly error: ErrorPayload;
 }
-export type Response<Result extends Value = Value> = SuccessResponse<Result> | ErrorResponse | RedirectResponse | Stale | Miss;
+/** A durable call's answer: the Execution it started or recovered, never a handler result. */
+export interface ExecutionResponse extends ResponseContext {
+    readonly execution: NodeId;
+}
+export type Response<Result extends Value = Value> = SuccessResponse<Result> | ErrorResponse | ExecutionResponse | RedirectResponse | Stale | Miss;
 export declare function decodeResponse(input: unknown): Response;

package/dist/invocation/response.js

@@ -1,17 +1,18 @@
+import { isNodeId } from '@astrale-os/kernel-core/graph/node';
 import { errorPayload, exactFields, invalid, invocation, portableObject, requestId, required, } from './admission.js';
 import { decodeMiss } from './miss.js';
 import { decodeRedirectResponse } from './redirect.js';
 import { decodeStale } from './stale-route.js';
 const SUCCESS_FIELDS = new Set(['result', 'requestId', 'invocation']);
 const ERROR_FIELDS = new Set(['error', 'requestId', 'invocation']);
+const EXECUTION_FIELDS = new Set(['execution', 'requestId', 'invocation']);
 export function decodeResponse(input) {
     const object = portableObject(input, 'response');
-    const hasResult = Object.hasOwn(object, 'result');
-    const hasError = Object.hasOwn(object, 'error');
-    if (hasResult || hasError) {
-        if (hasResult === hasError)
-            invalid('response must contain exactly one of result or error');
-        if (hasResult) {
+    const outcomes = ['result', 'error', 'execution'].filter((field) => Object.hasOwn(object, field));
+    if (outcomes.length > 1)
+        invalid('response must contain exactly one of result, error or execution');
+    switch (outcomes[0]) {
+        case 'result':
             exactFields(object, SUCCESS_FIELDS, 'response');
             required(object, ['requestId', 'invocation'], 'response');
             return Object.freeze({
@@ -19,14 +20,24 @@ export function decodeResponse(input) {
                 requestId: requestId(object.requestId, 'response.requestId'),
                 invocation: invocation(object.invocation, 'response.invocation'),
             });
-        }
-        exactFields(object, ERROR_FIELDS, 'response');
-        required(object, ['requestId', 'error', 'invocation'], 'response');
-        return Object.freeze({
-            error: errorPayload(object.error, 'response.error'),
-            requestId: requestId(object.requestId, 'response.requestId'),
-            invocation: invocation(object.invocation, 'response.invocation'),
-        });
+        case 'error':
+            exactFields(object, ERROR_FIELDS, 'response');
+            required(object, ['requestId', 'error', 'invocation'], 'response');
+            return Object.freeze({
+                error: errorPayload(object.error, 'response.error'),
+                requestId: requestId(object.requestId, 'response.requestId'),
+                invocation: invocation(object.invocation, 'response.invocation'),
+            });
+        case 'execution':
+            exactFields(object, EXECUTION_FIELDS, 'response');
+            required(object, ['requestId', 'execution', 'invocation'], 'response');
+            if (!isNodeId(object.execution))
+                invalid('response.execution must be a NodeId');
+            return Object.freeze({
+                execution: object.execution,
+                requestId: requestId(object.requestId, 'response.requestId'),
+                invocation: invocation(object.invocation, 'response.invocation'),
+            });
     }
     if (object.kind === 'redirect')
         return decodeRedirectResponse(object);
@@ -34,5 +45,5 @@ export function decodeResponse(input) {
         return decodeStale(object);
     if (object.kind === 'miss')
         return decodeMiss(object);
-    return invalid('response must contain a result, error, redirect, stale, or miss control');
+    return invalid('response must contain a result, error, execution, redirect, stale, or miss control');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/kernel-protocol",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.6",
   "description": "Portable Astrale invocation, Release, installation, routing, and issuer protocols",
   "license": "Apache-2.0",
   "repository": {
@@ -89,7 +89,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@astrale-os/kernel-core": "1.0.0-beta.5",
+    "@astrale-os/kernel-core": "1.0.0-beta.6",
     "@astrale-os/kernel-dsl": "1.0.0-beta.3",
     "@noble/hashes": "2.3.0"
   },