@openclaw/mxc-sandbox 2026.9.4 → 2026.9.5

package/node_modules/@microsoft/mxc-sdk/bin/x64/_manifest/spdx_2.2/manifest.spdx.json.sha256

@@ -1 +1 @@
-072c25336487841e4b7b9a03f2532bac8835d04f74ad4a0bc9404a07f189e35c
+4f978410a2845a138731d4e59a48729508cffb5771f62b6c2328b41d19e3ed99

package/node_modules/@microsoft/mxc-sdk/dist/errors.d.ts

@@ -2,10 +2,56 @@
  * Closed set of MXC wire-format error codes. Mirrors `MxcErrorCode` on the
  * Rust side one-for-one and serialises as the same snake_case strings on
  * the wire. Backend-specific failures that don't fit one of these codes
- * surface as `backend_error`, with structured information carried in
- * `details`.
+ * surface as `backend_error`, with structured information carried in the
+ * named fields below (or in `details`).
  */
 export type ErrorCode = 'malformed_request' | 'unsupported_containment' | 'unsupported_phase' | 'backend_unavailable' | 'malformed_id' | 'stale_id' | 'not_provisioned' | 'not_started' | 'already_started' | 'already_stopped' | 'policy_validation' | 'backend_error';
+/**
+ * Every field an `MxcError` can carry, in the same flat shape as the wire
+ * error envelope — `operation`, `nativeCode` and `remediation` sit alongside
+ * `code` and `message`, not nested inside `details`.
+ *
+ * **Invariant:** `operation` marks that an underlying API call was in flight.
+ * A failure MXC raises before or outside any API call carries only `code` and
+ * `message`.
+ *
+ * The invariant is guaranteed by the executor, which cannot construct a
+ * violating envelope. This interface mirrors the flat wire shape rather than
+ * re-encoding the constraint in the type.
+ */
+export interface MxcErrorFields {
+    /** Machine-readable category. Branch on this first. */
+    code: ErrorCode;
+    /** Human-readable description of the failure. */
+    message: string;
+    /**
+     * The underlying API call that failed, namespaced by its interface — e.g.
+     * `IsoSessionOps.RunProcessWithOptionsAsync`. Low-cardinality and free of
+     * call parameters, so it is safe to group on in telemetry.
+     */
+    operation?: string;
+    /**
+     * The underlying platform status as a string — an HRESULT such as
+     * `0x80070490` on Windows, an errno or equivalent elsewhere.
+     */
+    nativeCode?: string;
+    /** The API's actionable "how to fix it" hint, when it supplied one. */
+    remediation?: string;
+    /**
+     * Open extension point for backend-specific structured data that has no
+     * dedicated field. Named fields are reserved for backend-neutral concepts.
+     */
+    details?: Record<string, unknown>;
+}
+/**
+ * The `error` arm of a wire response envelope, as received from the
+ * executor. Identical to {@link MxcErrorFields} except that `code` is an
+ * open `string`: an unrecognised code is passed through verbatim rather than
+ * being coerced or dropped.
+ */
+export interface WireError extends Omit<MxcErrorFields, 'code'> {
+    code: string;
+}
 /**
  * Typed error thrown by the MXC SDK in response to a wire-format error
  * envelope. Discriminate by comparing `.code` to a wire-format error code
@@ -14,7 +60,16 @@ export type ErrorCode = 'malformed_request' | 'unsupported_containment' | 'unsup
  */
 export declare class MxcError extends Error {
     readonly code: ErrorCode;
+    readonly operation?: string;
+    readonly nativeCode?: string;
+    readonly remediation?: string;
     readonly details?: Record<string, unknown>;
+    /** Canonical form: pass the full field set as one object. */
+    constructor(fields: MxcErrorFields);
+    /**
+     * Positional form, retained for compatibility. Declared last so that
+     * `ConstructorParameters<typeof MxcError>` keeps resolving to this shape.
+     */
     constructor(code: ErrorCode, message: string, details?: Record<string, unknown>);
 }
 /**
@@ -22,6 +77,17 @@ export declare class MxcError extends Error {
  * `string` so callers parsing a wire envelope don't need to narrow first;
  * unknown codes still produce an `MxcError` with `.code` set to whatever
  * was on the wire.
+ *
+ * For a complete wire envelope prefer {@link mxcErrorFromEnvelope}, which
+ * carries the structured fields too.
  */
 export declare function mxcErrorFromCode(code: string, message: string, details?: Record<string, unknown>): MxcError;
+/**
+ * Constructs an `MxcError` from the `error` arm of a wire response envelope.
+ *
+ * This is the single place the wire's open `code` string is widened to the
+ * closed `ErrorCode` union, so unknown-code passthrough behaves identically
+ * everywhere the SDK parses an envelope.
+ */
+export declare function mxcErrorFromEnvelope(error: WireError): MxcError;
 //# sourceMappingURL=errors.d.ts.map

package/node_modules/@microsoft/mxc-sdk/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GACjB,mBAAmB,GACnB,yBAAyB,GACzB,mBAAmB,GACnB,qBAAqB,GACrB,cAAc,GACd,UAAU,GACV,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,CAAC;AAEpB;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAShF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,CAEV"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GACjB,mBAAmB,GACnB,yBAAyB,GACzB,mBAAmB,GACnB,qBAAqB,GACrB,cAAc,GACd,UAAU,GACV,iBAAiB,GACjB,aAAa,GACb,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,CAAC;AAEpB;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,SAAS,CAAC;IAChB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,6DAA6D;gBACjD,MAAM,EAAE,cAAc;IAClC;;;OAGG;gBACS,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA+BhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,QAAQ,CAEV;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAS/D"}

package/node_modules/@microsoft/mxc-sdk/dist/errors.js

@@ -8,11 +8,28 @@
  */
 export class MxcError extends Error {
     code;
+    operation;
+    nativeCode;
+    remediation;
     details;
-    constructor(code, message, details) {
-        super(message);
-        this.code = code;
-        this.details = details;
+    constructor(codeOrFields, message, details) {
+        // The overload discriminates on `typeof === 'string'`, so anything else
+        // — including `null` and `undefined` from an `any` cast or an absent wire
+        // envelope — would take the object branch and fail inside `super()` with
+        // a `TypeError` naming `message`, which says nothing about the real
+        // mistake. Reject it here instead, where the message can.
+        if (codeOrFields === null || codeOrFields === undefined) {
+            throw new TypeError(`MxcError: expected an error code string or a field object, got ${String(codeOrFields)}`);
+        }
+        const fields = typeof codeOrFields === 'string'
+            ? { code: codeOrFields, message: message ?? '', details }
+            : codeOrFields;
+        super(fields.message);
+        this.code = fields.code;
+        this.operation = fields.operation;
+        this.nativeCode = fields.nativeCode;
+        this.remediation = fields.remediation;
+        this.details = fields.details;
         // Restore the prototype chain so `instanceof MxcError` keeps working
         // after the TypeScript ES2020 → ES5-compatible class downlevelling.
         Object.setPrototypeOf(this, new.target.prototype);
@@ -24,8 +41,28 @@ export class MxcError extends Error {
  * `string` so callers parsing a wire envelope don't need to narrow first;
  * unknown codes still produce an `MxcError` with `.code` set to whatever
  * was on the wire.
+ *
+ * For a complete wire envelope prefer {@link mxcErrorFromEnvelope}, which
+ * carries the structured fields too.
  */
 export function mxcErrorFromCode(code, message, details) {
     return new MxcError(code, message, details);
 }
+/**
+ * Constructs an `MxcError` from the `error` arm of a wire response envelope.
+ *
+ * This is the single place the wire's open `code` string is widened to the
+ * closed `ErrorCode` union, so unknown-code passthrough behaves identically
+ * everywhere the SDK parses an envelope.
+ */
+export function mxcErrorFromEnvelope(error) {
+    return new MxcError({
+        code: error.code,
+        message: error.message,
+        operation: error.operation,
+        nativeCode: error.nativeCode,
+        remediation: error.remediation,
+        details: error.details,
+    });
+}
 //# sourceMappingURL=errors.js.map

package/node_modules/@microsoft/mxc-sdk/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAuBlC;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAY;IAChB,OAAO,CAA2B;IAE3C,YAAY,IAAe,EAAE,OAAe,EAAE,OAAiC;QAC7E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,qEAAqE;QACrE,oEAAoE;QACpE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,QAAQ,CAAC,IAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,kCAAkC;AAuElC;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAY;IAChB,SAAS,CAAU;IACnB,UAAU,CAAU;IACpB,WAAW,CAAU;IACrB,OAAO,CAA2B;IAS3C,YACE,YAAwC,EACxC,OAAgB,EAChB,OAAiC;QAEjC,wEAAwE;QACxE,0EAA0E;QAC1E,yEAAyE;QACzE,oEAAoE;QACpE,0DAA0D;QAC1D,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YACxD,MAAM,IAAI,SAAS,CACjB,kEAAkE,MAAM,CAAC,YAAY,CAAC,EAAE,CACzF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GACV,OAAO,YAAY,KAAK,QAAQ;YAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,OAAO,EAAE;YACzD,CAAC,CAAC,YAAY,CAAC;QACnB,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,qEAAqE;QACrE,oEAAoE;QACpE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,OAAe,EACf,OAAiC;IAEjC,OAAO,IAAI,QAAQ,CAAC,IAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAgB;IACnD,OAAO,IAAI,QAAQ,CAAC;QAClB,IAAI,EAAE,KAAK,CAAC,IAAiB;QAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;AACL,CAAC"}