@astrale-os/cli 1.0.0-beta.44 → 1.0.0-beta.45

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.0.0-beta.45](https://github.com/astrale-os/cli/compare/cli/v1.0.0-beta.44...cli/v1.0.0-beta.45) (2026-08-28)
+
+
+### Bug Fixes
+
+* **cli:** generate protocol-safe operation ids ([#254](https://github.com/astrale-os/cli/issues/254)) ([f38d09f](https://github.com/astrale-os/cli/commit/f38d09f55fb1fa450a8fac66c1c7233a6c56c077))
+
 ## [1.0.0-beta.44](https://github.com/astrale-os/cli/compare/cli/v1.0.0-beta.43...cli/v1.0.0-beta.44) (2026-08-28)
 
 

package/dist/astrale.js

@@ -2578,7 +2578,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@astrale-os/cli",
-    version: "1.0.0-beta.44",
+    version: "1.0.0-beta.45",
     description: "Astrale CLI — connect to existing Astrale kernels",
     keywords: [
       "astrale",
@@ -84614,6 +84614,22 @@ var init_query3 = __esm(() => {
   init_query();
 });
 
+// src/lib/idempotency.ts
+function idempotencyKey(...segments) {
+  const value2 = segments.join(".");
+  if (value2.length < 1 || value2.length > MAXIMUM_KEY_LENGTH || !URL_SAFE_KEY.test(value2)) {
+    throw new TypeError("Idempotency key must contain 1-128 URL-safe ASCII characters.");
+  }
+  return value2;
+}
+function randomOperationId(...namespace) {
+  return idempotencyKey(...namespace, globalThis.crypto.randomUUID());
+}
+var MAXIMUM_KEY_LENGTH = 128, URL_SAFE_KEY;
+var init_idempotency2 = __esm(() => {
+  URL_SAFE_KEY = /^[A-Za-z0-9._~-]+$/u;
+});
+
 // node_modules/.pnpm/@astrale-os+kernel-dsl@0.2.0-beta.15/node_modules/@astrale-os/kernel-dsl/dist/v1/builder/schema/diagnostic.js
 function diagnostic(code, pointer, message2, ref) {
   return Object.freeze({ code, pointer, message: message2, ...ref === undefined ? {} : { ref } });
@@ -98905,7 +98921,7 @@ async function connectAdminInstances(context, dependencies = {}) {
       maximum: MAXIMUM_INSTANCES,
       maximumPages: MAXIMUM_PAGES
     });
-    return nodes.map(instanceFromNode);
+    return nodes.map(instanceFromNode).filter((instance) => instance.state !== "deleted");
   };
   const requireInstance = async (identifier) => {
     const found = findOwnedInstance(await list3(), identifier);
@@ -99023,13 +99039,14 @@ function record7(input, label) {
   return input;
 }
 function defaultOperationId(kind) {
-  return `cli.instance.${kind}:${globalThis.crypto.randomUUID()}`;
+  return randomOperationId("cli", "instance", kind);
 }
 var PAGE_SIZE = 256, MAXIMUM_INSTANCES = 1e4, MAXIMUM_PAGES;
 var init_client4 = __esm(() => {
   init_class();
   init_path3();
   init_query3();
+  init_idempotency2();
   init_contract();
   init_graph5();
   init_model6();
@@ -101373,11 +101390,11 @@ function remainingSessionTime(operation) {
     throw new SessionError("Session operation timed out.", { failure: "timeout" });
   return remaining;
 }
-function sessionTransportOptions(operation, idempotencyKey) {
+function sessionTransportOptions(operation, idempotencyKey2) {
   return Object.freeze({
     signal: operation.signal,
     timeoutMs: remainingSessionTime(operation),
-    ...idempotencyKey === undefined ? {} : { idempotencyKey }
+    ...idempotencyKey2 === undefined ? {} : { idempotencyKey: idempotencyKey2 }
   });
 }
 async function runSessionOperation(operation, task) {
@@ -102604,10 +102621,10 @@ function admitRequestOptions2(input = {}) {
   if (fields.some((field) => !["signal", "timeoutMs", "idempotencyKey"].includes(String(field)))) {
     throw new TypeError("Session request options contain unsupported fields.");
   }
-  const idempotencyKey = input.idempotencyKey === undefined ? undefined : acceptIdempotencyKey(input.idempotencyKey, "request.idempotencyKey");
+  const idempotencyKey2 = input.idempotencyKey === undefined ? undefined : acceptIdempotencyKey(input.idempotencyKey, "request.idempotencyKey");
   return Object.freeze({
     ...control,
-    ...idempotencyKey === undefined ? {} : { idempotencyKey }
+    ...idempotencyKey2 === undefined ? {} : { idempotencyKey: idempotencyKey2 }
   });
 }
 function admitEnvelopeTransport(input) {
@@ -113155,12 +113172,13 @@ function record13(input, label) {
   return input;
 }
 function defaultOperationId2(kind) {
-  return `cli.domain.${kind}:${globalThis.crypto.randomUUID()}`;
+  return randomOperationId("cli", "domain", kind);
 }
 var PAGE_SIZE2 = 256, MAXIMUM_DOMAINS = 1e4, MAXIMUM_PAGES2;
 var init_client5 = __esm(() => {
   init_path3();
   init_query3();
+  init_idempotency2();
   init_contract();
   init_graph5();
   init_model9();
@@ -114173,9 +114191,9 @@ async function prepareIdentityProvision(input) {
     builder.createNode({ as: binding6, class: input.classPath, props: input.properties });
     return;
   });
-  const idempotencyKey = `identity-register:${input.name}`;
+  const registrationKey = idempotencyKey("identity-register", input.name);
   const unsigned = exports_provision.accept({
-    idempotencyKey,
+    idempotencyKey: registrationKey,
     mutation,
     identities: [
       {
@@ -114193,7 +114211,7 @@ async function prepareIdentityProvision(input) {
     binding: binding6,
     authentication: Object.freeze({ iss: issuer, sub: "self" }),
     request: exports_provision.accept({
-      idempotencyKey,
+      idempotencyKey: registrationKey,
       mutation,
       identities: [
         {
@@ -114220,6 +114238,7 @@ var init_register = __esm(() => {
   init_graph6();
   init_identity7();
   init_keys();
+  init_idempotency2();
   init_log();
   init_output();
   register_default = {

package/dist/types/lib/idempotency.d.ts

@@ -0,0 +1,4 @@
+/** Build one protocol-compatible key for an operation that may cross nested Kernel calls. */
+export declare function idempotencyKey(...segments: readonly string[]): string;
+/** Generate a fresh operation id while retaining a short diagnostic namespace. */
+export declare function randomOperationId(...namespace: readonly string[]): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/cli",
-  "version": "1.0.0-beta.44",
+  "version": "1.0.0-beta.45",
   "description": "Astrale CLI — connect to existing Astrale kernels",
   "keywords": [
     "astrale",