@xemahq/decision-plane-nest 0.1.0

package/LICENSE

@@ -0,0 +1,176 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work
+(an example is provided in the Appendix below).
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work,
+excluding those notices that do not pertain to any part of
+the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

package/README.md

@@ -0,0 +1,87 @@
+# @xemahq/decision-plane-nest
+
+The **producer** side of the Xema human-decision primitive.
+
+A service that needs a human to decide something opens an ask on `decision-api`
+and acts when somebody answers. Every such service needs the same five calls,
+the same envelope discipline, the same org header and the same "is a decision
+plane even installed here" probe — and two of them had written all of it twice,
+in two different transports.
+
+```ts
+@Module({ imports: [DecisionPlaneModule], providers: [MyAskService] })
+export class MyDecisionPlaneModule {}
+
+const decision = await this.decisions.open(orgId, {
+  idempotencyKey: contentHashOfTheThing,
+  kind: DecisionKind.CONFIRM,
+  title: 'Send the drafted reply?',
+  subjectResourceRef: `resource:mailbox:${mailboxId}`,
+  subjectClassification: DecisionSubjectClassification.CONFIDENTIAL,
+  answerCapabilityRef: 'mailops:mail.dispatch@1',
+  producerRef: holdId,
+  recipients: [{ kind: RecipientKind.HUMAN, target: { userId: ownerId } }],
+  options: [ /* … */ ],
+});
+```
+
+## What it deliberately does NOT do
+
+**The resume.** Reacting to a committed answer is safety-critical and genuinely
+producer-specific: the capability gate replays an invocation under a
+compare-and-set, mailops dispatches mail through the capability plane, the Store
+flips a version lifecycle under its own claim. *Extract the ask; leave the
+resume* is the program's rule, and an SDK that swallowed the resume would be
+centralising the half that must not be.
+
+**Delivery.** `decision-api` emits; `user-hub-api` owns materialisation,
+per-category preferences, presence gating and every channel adapter. Nothing
+here knows a recipient prefers email.
+
+## Withdrawal, and why it exists
+
+`decision-api` runs no sweeper — every terminal status is DERIVED, which only
+ends an ask that has a DEADLINE — and producers routinely open asks without one,
+for good reasons (a review nobody got to must not become un-approvable by the
+passage of time). Together that makes an unanswered ask **immortal**.
+
+So `withdraw()` is not a convenience. A producer that knows its subject is gone
+must call it, and both live producers now do — from a mailbox disconnect and
+from a listing archive. It is best-effort by design (its callers are mid-way
+through something the user asked for) and never silent: 404/409 are the state it
+exists to reach, everything else is logged, and
+`GET /internal/decisions/abandoned` is what surfaces the remainder.
+
+## The wire mirror, and when to delete it
+
+`src/wire.ts` restates decision-api's vocabulary instead of importing
+`@xemahq/kernel-contracts/decision`. That is not a preference:
+
+> The two consumers sit in repositories pinned to kernel-contracts **14.1.0** and
+> **13.0.0**. The `decision` subpath first ships in 15.0.0, and raising
+> xema-store-api's pin is not a local edit — measured 2026-08-20, **nine**
+> packages in that lockfile declare `peer @xemahq/kernel-contracts ^12.0.0`.
+
+An SDK importing the kernel subpath would be unconsumable by the very producer
+whose duplication it exists to delete. So it mirrors the wire ONCE, replacing
+the two hand-written mirrors those producers carry today.
+
+Two things keep that honest:
+
+- it mirrors only what a **producer** sends or reads — the answerer surface, the
+  escalation vocabulary and `Recipient`'s five target variants are absent,
+  because a mirror of a field nobody uses is a field that drifts unnoticed;
+- `test/wire-parity.spec.ts` asserts every value against decision-api's own
+  `prisma/schema.prisma`, in both directions, and is mutation-tested. It reads
+  the schema as TEXT so it needs nothing installed, and it SKIPS LOUDLY in a
+  standalone clone where decision-api does not exist rather than passing
+  vacuously.
+
+**When the fleet upgrade happens, `wire.ts` collapses into an import and is
+deleted.** It says so in the file, so nobody preserves it out of politeness.
+
+`registry.contract.ts` is the same trade for a single method, and
+`test/registry-assignability.spec.ts` pins it against the real signature — an
+earlier draft declared an array and read `.length`, which compiles and is
+`undefined` on the real `ResolvedService`, so "is a plane installed" would have
+answered NO for one that was.

package/dist/decision-plane.client.d.ts

@@ -0,0 +1,19 @@
+import { type TypedServiceClient } from '@xemahq/service-registry-nest';
+import type { ServiceRegistry } from './registry.contract';
+import type { CloseDecisionRequest, DecisionView, OpenDecisionRequest } from './wire';
+export declare const DECISION_API_SERVICE = "decision-api";
+export declare class DecisionPlaneClient {
+    private readonly decisions;
+    private readonly registry?;
+    private readonly logger;
+    constructor(decisions: TypedServiceClient, registry?: ServiceRegistry | undefined);
+    isAvailable(): Promise<boolean>;
+    open(orgId: string, request: OpenDecisionRequest): Promise<DecisionView>;
+    findByProducerRef(orgId: string, producerRef: string): Promise<DecisionView | null>;
+    read(orgId: string, decisionId: string): Promise<DecisionView>;
+    close(orgId: string, decisionId: string, request: CloseDecisionRequest): Promise<void>;
+    withdraw(orgId: string, decisionId: string, reason: string): Promise<boolean>;
+    private assertAvailable;
+    private translate;
+}
+//# sourceMappingURL=decision-plane.client.d.ts.map

package/dist/decision-plane.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-plane.client.d.ts","sourceRoot":"","sources":["../src/decision-plane.client.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,+BAA+B,CAAC;AAUvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACpB,MAAM,QAAQ,CAAC;AAWhB,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAyDnD,qBACa,mBAAmB;IAK5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAO1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAX5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAI5C,SAAS,EAAE,kBAAkB,EAO7B,QAAQ,CAAC,EAAE,eAAe,YAAA;IAWvC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IA6B/B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC;IA2BxE,iBAAiB,CACrB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAwBzB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB9D,KAAK,CACT,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC;IAiCV,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;YAwBL,eAAe;IAgB7B,OAAO,CAAC,SAAS;CAiBlB"}

package/dist/decision-plane.client.js

@@ -0,0 +1,156 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var DecisionPlaneClient_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionPlaneClient = exports.DECISION_API_SERVICE = void 0;
+const common_1 = require("@nestjs/common");
+const service_registry_nest_1 = require("@xemahq/service-registry-nest");
+const errors_1 = require("./errors");
+const wire_1 = require("./wire");
+exports.DECISION_API_SERVICE = 'decision-api';
+const ORG_HEADER = 'X-Xema-Org-Id';
+function unwrap(body, operation) {
+    if (typeof body !== 'object' ||
+        body === null ||
+        !('data' in body) ||
+        body.data === null ||
+        body.data === undefined) {
+        throw new errors_1.DecisionEnvelopeError(operation);
+    }
+    return body.data;
+}
+function statusOf(err) {
+    const status = typeof err === 'object' && err !== null
+        ? err.status
+        : undefined;
+    return typeof status === 'number' ? status : undefined;
+}
+function detailOf(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+let DecisionPlaneClient = DecisionPlaneClient_1 = class DecisionPlaneClient {
+    decisions;
+    registry;
+    logger = new common_1.Logger(DecisionPlaneClient_1.name);
+    constructor(decisions, registry) {
+        this.decisions = decisions;
+        this.registry = registry;
+    }
+    async isAvailable() {
+        if (this.registry === undefined) {
+            return true;
+        }
+        try {
+            await this.registry.resolve(exports.DECISION_API_SERVICE);
+            return true;
+        }
+        catch (err) {
+            this.logger.debug(`${exports.DECISION_API_SERVICE} is not resolvable from the service registry: ` +
+                detailOf(err));
+            return false;
+        }
+    }
+    async open(orgId, request) {
+        await this.assertAvailable();
+        try {
+            const body = await this.decisions.post('/internal/decisions', request, { headers: { [ORG_HEADER]: orgId } });
+            const decision = unwrap(body, 'POST /internal/decisions');
+            this.logger.debug(`Opened decision ${decision.id} attempt=${decision.attempt} ` +
+                `producerRef=${decision.producerRef ?? '(none)'} org=${orgId}`);
+            return decision;
+        }
+        catch (err) {
+            throw this.translate(err, 'POST /internal/decisions', request.subjectResourceRef);
+        }
+    }
+    async findByProducerRef(orgId, producerRef) {
+        await this.assertAvailable();
+        try {
+            const body = await this.decisions.get(`/internal/decisions/by-ref/${encodeURIComponent(producerRef)}`, { headers: { [ORG_HEADER]: orgId } });
+            return unwrap(body, 'GET /internal/decisions/by-ref');
+        }
+        catch (err) {
+            if (statusOf(err) === 404) {
+                return null;
+            }
+            throw this.translate(err, 'GET /internal/decisions/by-ref');
+        }
+    }
+    async read(orgId, decisionId) {
+        await this.assertAvailable();
+        try {
+            const body = await this.decisions.get(`/internal/decisions/${encodeURIComponent(decisionId)}`, { headers: { [ORG_HEADER]: orgId } });
+            return unwrap(body, 'GET /internal/decisions/:id');
+        }
+        catch (err) {
+            throw this.translate(err, 'GET /internal/decisions/:id');
+        }
+    }
+    async close(orgId, decisionId, request) {
+        await this.assertAvailable();
+        try {
+            await this.decisions.post(`/internal/decisions/${encodeURIComponent(decisionId)}/close`, request, { headers: { [ORG_HEADER]: orgId } });
+        }
+        catch (err) {
+            throw this.translate(err, 'POST /internal/decisions/:id/close');
+        }
+    }
+    async withdraw(orgId, decisionId, reason) {
+        if (!(await this.isAvailable())) {
+            return false;
+        }
+        try {
+            await this.close(orgId, decisionId, {
+                outcome: wire_1.DecisionOutcome.WITHDRAWN,
+                reason: reason.slice(0, 2000),
+            });
+            this.logger.log(`Withdrew decision ${decisionId} (org ${orgId}): ${reason}`);
+            return true;
+        }
+        catch (err) {
+            const status = err instanceof errors_1.DecisionPlaneRequestError ? err.status : undefined;
+            if (status === 404 || status === 409) {
+                return false;
+            }
+            this.logger.error(`Could not withdraw decision ${decisionId} (org ${orgId}): ${detailOf(err)}. ` +
+                "The ask stays OPEN and will appear in decision-api's abandoned report.");
+            return false;
+        }
+    }
+    async assertAvailable() {
+        if (!(await this.isAvailable())) {
+            throw new errors_1.DecisionPlaneAbsentError(`no healthy '${exports.DECISION_API_SERVICE}' instance is registered`);
+        }
+    }
+    translate(err, operation, subjectResourceRef) {
+        if (err instanceof errors_1.DecisionEnvelopeError || err instanceof errors_1.DecisionPlaneAbsentError) {
+            return err;
+        }
+        const detail = detailOf(err);
+        if (subjectResourceRef !== undefined &&
+            detail.includes('DECISION_SUBJECT_RESOURCE_UNREGISTERED')) {
+            return new errors_1.DecisionSubjectUnregisteredError(subjectResourceRef, detail);
+        }
+        return new errors_1.DecisionPlaneRequestError(operation, statusOf(err), detail, err);
+    }
+};
+exports.DecisionPlaneClient = DecisionPlaneClient;
+exports.DecisionPlaneClient = DecisionPlaneClient = DecisionPlaneClient_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, service_registry_nest_1.InjectService)(exports.DECISION_API_SERVICE)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(service_registry_nest_1.SERVICE_REGISTRY_TOKEN)),
+    __metadata("design:paramtypes", [Function, Object])
+], DecisionPlaneClient);
+//# sourceMappingURL=decision-plane.client.js.map

package/dist/decision-plane.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-plane.client.js","sourceRoot":"","sources":["../src/decision-plane.client.ts"],"names":[],"mappings":"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"}

package/dist/decision-plane.module.d.ts

@@ -0,0 +1,3 @@
+export declare class DecisionPlaneModule {
+}
+//# sourceMappingURL=decision-plane.module.d.ts.map

package/dist/decision-plane.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-plane.module.d.ts","sourceRoot":"","sources":["../src/decision-plane.module.ts"],"names":[],"mappings":"AAmBA,qBAIa,mBAAmB;CAAG"}

package/dist/decision-plane.module.js

@@ -0,0 +1,21 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionPlaneModule = void 0;
+const common_1 = require("@nestjs/common");
+const decision_plane_client_1 = require("./decision-plane.client");
+let DecisionPlaneModule = class DecisionPlaneModule {
+};
+exports.DecisionPlaneModule = DecisionPlaneModule;
+exports.DecisionPlaneModule = DecisionPlaneModule = __decorate([
+    (0, common_1.Module)({
+        providers: [decision_plane_client_1.DecisionPlaneClient],
+        exports: [decision_plane_client_1.DecisionPlaneClient],
+    })
+], DecisionPlaneModule);
+//# sourceMappingURL=decision-plane.module.js.map

package/dist/decision-plane.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-plane.module.js","sourceRoot":"","sources":["../src/decision-plane.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AAExC,mEAA8D;AAqBvD,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;CAAG,CAAA;AAAtB,kDAAmB;8BAAnB,mBAAmB;IAJ/B,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,2CAAmB,CAAC;QAChC,OAAO,EAAE,CAAC,2CAAmB,CAAC;KAC/B,CAAC;GACW,mBAAmB,CAAG"}

package/dist/errors.d.ts

@@ -0,0 +1,21 @@
+export declare abstract class DecisionPlaneError extends Error {
+    protected constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class DecisionPlaneAbsentError extends DecisionPlaneError {
+    constructor(reason: string);
+}
+export declare class DecisionSubjectUnregisteredError extends DecisionPlaneError {
+    readonly subjectResourceRef: string;
+    constructor(subjectResourceRef: string, detail: string);
+}
+export declare class DecisionPlaneRequestError extends DecisionPlaneError {
+    readonly operation: string;
+    readonly status: number | undefined;
+    constructor(operation: string, status: number | undefined, detail: string, cause?: unknown);
+}
+export declare class DecisionEnvelopeError extends DecisionPlaneError {
+    constructor(operation: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAWA,8BAAsB,kBAAmB,SAAQ,KAAK;IACpD,SAAS,aAAa,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIrE;AAWD,qBAAa,wBAAyB,SAAQ,kBAAkB;gBAClD,MAAM,EAAE,MAAM;CAG3B;AAcD,qBAAa,gCAAiC,SAAQ,kBAAkB;IAEpE,QAAQ,CAAC,kBAAkB,EAAE,MAAM;gBAA1B,kBAAkB,EAAE,MAAM,EACnC,MAAM,EAAE,MAAM;CAQjB;AAGD,qBAAa,yBAA0B,SAAQ,kBAAkB;IAE7D,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS;gBAD1B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EACnC,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO;CASlB;AAeD,qBAAa,qBAAsB,SAAQ,kBAAkB;gBAC/C,SAAS,EAAE,MAAM;CAQ9B"}

package/dist/errors.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DecisionEnvelopeError = exports.DecisionPlaneRequestError = exports.DecisionSubjectUnregisteredError = exports.DecisionPlaneAbsentError = exports.DecisionPlaneError = void 0;
+class DecisionPlaneError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+exports.DecisionPlaneError = DecisionPlaneError;
+class DecisionPlaneAbsentError extends DecisionPlaneError {
+    constructor(reason) {
+        super(`The decision plane is not available: ${reason}`);
+    }
+}
+exports.DecisionPlaneAbsentError = DecisionPlaneAbsentError;
+class DecisionSubjectUnregisteredError extends DecisionPlaneError {
+    subjectResourceRef;
+    constructor(subjectResourceRef, detail) {
+        super(`decision-api refused "${subjectResourceRef}" as an unregistered subject ` +
+            `resource: ${detail}. Answerability resolves against the INSTANCE, so ` +
+            'the resource must carry registered ownership before an ask can name it.');
+        this.subjectResourceRef = subjectResourceRef;
+    }
+}
+exports.DecisionSubjectUnregisteredError = DecisionSubjectUnregisteredError;
+class DecisionPlaneRequestError extends DecisionPlaneError {
+    operation;
+    status;
+    constructor(operation, status, detail, cause) {
+        super(`decision-api ${operation} failed` +
+            (status === undefined ? '' : ` (HTTP ${status})`) +
+            `: ${detail}`, { cause });
+        this.operation = operation;
+        this.status = status;
+    }
+}
+exports.DecisionPlaneRequestError = DecisionPlaneRequestError;
+class DecisionEnvelopeError extends DecisionPlaneError {
+    constructor(operation) {
+        super(`decision-api ${operation} returned a body with no \`data\` envelope. ` +
+            'Every route is wrapped by ResponseEnvelopeInterceptor, so this means ' +
+            'the contract changed or the response came from something else. ' +
+            'Refusing to read it as a bare payload.');
+    }
+}
+exports.DecisionEnvelopeError = DecisionEnvelopeError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAWA,MAAsB,kBAAmB,SAAQ,KAAK;IACpD,YAAsB,OAAe,EAAE,OAA6B;QAClE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AALD,gDAKC;AAWD,MAAa,wBAAyB,SAAQ,kBAAkB;IAC9D,YAAY,MAAc;QACxB,KAAK,CAAC,wCAAwC,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF;AAJD,4DAIC;AAcD,MAAa,gCAAiC,SAAQ,kBAAkB;IAE3D;IADX,YACW,kBAA0B,EACnC,MAAc;QAEd,KAAK,CACH,yBAAyB,kBAAkB,+BAA+B;YACxE,aAAa,MAAM,oDAAoD;YACvE,yEAAyE,CAC5E,CAAC;QAPO,uBAAkB,GAAlB,kBAAkB,CAAQ;IAQrC,CAAC;CACF;AAXD,4EAWC;AAGD,MAAa,yBAA0B,SAAQ,kBAAkB;IAEpD;IACA;IAFX,YACW,SAAiB,EACjB,MAA0B,EACnC,MAAc,EACd,KAAe;QAEf,KAAK,CACH,gBAAgB,SAAS,SAAS;YAChC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,MAAM,GAAG,CAAC;YACjD,KAAK,MAAM,EAAE,EACf,EAAE,KAAK,EAAE,CACV,CAAC;QAVO,cAAS,GAAT,SAAS,CAAQ;QACjB,WAAM,GAAN,MAAM,CAAoB;IAUrC,CAAC;CACF;AAdD,8DAcC;AAeD,MAAa,qBAAsB,SAAQ,kBAAkB;IAC3D,YAAY,SAAiB;QAC3B,KAAK,CACH,gBAAgB,SAAS,8CAA8C;YACrE,uEAAuE;YACvE,iEAAiE;YACjE,wCAAwC,CAC3C,CAAC;IACJ,CAAC;CACF;AATD,sDASC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { DecisionPlaneClient, DECISION_API_SERVICE, } from './decision-plane.client';
+export { DecisionPlaneModule } from './decision-plane.module';
+export { DecisionEnvelopeError, DecisionPlaneAbsentError, DecisionPlaneError, DecisionPlaneRequestError, DecisionSubjectUnregisteredError, } from './errors';
+export { DecisionAnswerRestriction, DecisionDeadlineEffect, DecisionKind, DecisionOptionEffect, DecisionOrgRole, DecisionOutcome, DecisionSettlement, DecisionSubjectClassification, RecipientKind, type CloseDecisionRequest, type DeclaredDecisionOption, type DecisionCommitView, type DecisionFact, type DecisionRecipient, type DecisionView, type OpenDecisionRequest, } from './wire';
+export type { ServiceRegistry } from './registry.contract';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,yBAAyB,EACzB,gCAAgC,GACjC,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,6BAA6B,EAC7B,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecipientKind = exports.DecisionSubjectClassification = exports.DecisionSettlement = exports.DecisionOutcome = exports.DecisionOrgRole = exports.DecisionOptionEffect = exports.DecisionKind = exports.DecisionDeadlineEffect = exports.DecisionAnswerRestriction = exports.DecisionSubjectUnregisteredError = exports.DecisionPlaneRequestError = exports.DecisionPlaneError = exports.DecisionPlaneAbsentError = exports.DecisionEnvelopeError = exports.DecisionPlaneModule = exports.DECISION_API_SERVICE = exports.DecisionPlaneClient = void 0;
+var decision_plane_client_1 = require("./decision-plane.client");
+Object.defineProperty(exports, "DecisionPlaneClient", { enumerable: true, get: function () { return decision_plane_client_1.DecisionPlaneClient; } });
+Object.defineProperty(exports, "DECISION_API_SERVICE", { enumerable: true, get: function () { return decision_plane_client_1.DECISION_API_SERVICE; } });
+var decision_plane_module_1 = require("./decision-plane.module");
+Object.defineProperty(exports, "DecisionPlaneModule", { enumerable: true, get: function () { return decision_plane_module_1.DecisionPlaneModule; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "DecisionEnvelopeError", { enumerable: true, get: function () { return errors_1.DecisionEnvelopeError; } });
+Object.defineProperty(exports, "DecisionPlaneAbsentError", { enumerable: true, get: function () { return errors_1.DecisionPlaneAbsentError; } });
+Object.defineProperty(exports, "DecisionPlaneError", { enumerable: true, get: function () { return errors_1.DecisionPlaneError; } });
+Object.defineProperty(exports, "DecisionPlaneRequestError", { enumerable: true, get: function () { return errors_1.DecisionPlaneRequestError; } });
+Object.defineProperty(exports, "DecisionSubjectUnregisteredError", { enumerable: true, get: function () { return errors_1.DecisionSubjectUnregisteredError; } });
+var wire_1 = require("./wire");
+Object.defineProperty(exports, "DecisionAnswerRestriction", { enumerable: true, get: function () { return wire_1.DecisionAnswerRestriction; } });
+Object.defineProperty(exports, "DecisionDeadlineEffect", { enumerable: true, get: function () { return wire_1.DecisionDeadlineEffect; } });
+Object.defineProperty(exports, "DecisionKind", { enumerable: true, get: function () { return wire_1.DecisionKind; } });
+Object.defineProperty(exports, "DecisionOptionEffect", { enumerable: true, get: function () { return wire_1.DecisionOptionEffect; } });
+Object.defineProperty(exports, "DecisionOrgRole", { enumerable: true, get: function () { return wire_1.DecisionOrgRole; } });
+Object.defineProperty(exports, "DecisionOutcome", { enumerable: true, get: function () { return wire_1.DecisionOutcome; } });
+Object.defineProperty(exports, "DecisionSettlement", { enumerable: true, get: function () { return wire_1.DecisionSettlement; } });
+Object.defineProperty(exports, "DecisionSubjectClassification", { enumerable: true, get: function () { return wire_1.DecisionSubjectClassification; } });
+Object.defineProperty(exports, "RecipientKind", { enumerable: true, get: function () { return wire_1.RecipientKind; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iEAGiC;AAF/B,4HAAA,mBAAmB,OAAA;AACnB,6HAAA,oBAAoB,OAAA;AAEtB,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA;AAC5B,mCAMkB;AALhB,+GAAA,qBAAqB,OAAA;AACrB,kHAAA,wBAAwB,OAAA;AACxB,4GAAA,kBAAkB,OAAA;AAClB,mHAAA,yBAAyB,OAAA;AACzB,0HAAA,gCAAgC,OAAA;AAElC,+BAiBgB;AAhBd,iHAAA,yBAAyB,OAAA;AACzB,8GAAA,sBAAsB,OAAA;AACtB,oGAAA,YAAY,OAAA;AACZ,4GAAA,oBAAoB,OAAA;AACpB,uGAAA,eAAe,OAAA;AACf,uGAAA,eAAe,OAAA;AACf,0GAAA,kBAAkB,OAAA;AAClB,qHAAA,6BAA6B,OAAA;AAC7B,qGAAA,aAAa,OAAA"}

package/dist/registry.contract.d.ts

@@ -0,0 +1,4 @@
+export interface ServiceRegistry {
+    resolve(serviceName: string): Promise<unknown>;
+}
+//# sourceMappingURL=registry.contract.d.ts.map

package/dist/registry.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.contract.d.ts","sourceRoot":"","sources":["../src/registry.contract.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD"}

package/dist/registry.contract.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=registry.contract.js.map

package/dist/registry.contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.contract.js","sourceRoot":"","sources":["../src/registry.contract.ts"],"names":[],"mappings":""}

package/dist/wire.d.ts

@@ -0,0 +1,111 @@
+export declare enum DecisionKind {
+    CONFIRM = "CONFIRM",
+    VERDICT = "VERDICT",
+    PROPOSAL_SET = "PROPOSAL_SET",
+    OPEN = "OPEN"
+}
+export declare enum DecisionOptionEffect {
+    SETTLING_ACT = "SETTLING_ACT",
+    SETTLING_NO_ACT = "SETTLING_NO_ACT",
+    ADDITIVE = "ADDITIVE"
+}
+export declare enum DecisionSettlement {
+    BY_COMMIT = "BY_COMMIT",
+    BY_PRODUCER = "BY_PRODUCER"
+}
+export declare enum DecisionDeadlineEffect {
+    CLOSE = "CLOSE",
+    HIDE = "HIDE",
+    ESCALATE = "ESCALATE"
+}
+export declare enum DecisionAnswerRestriction {
+    ANY_PERMITTED = "ANY_PERMITTED",
+    ADDRESSED_ONLY = "ADDRESSED_ONLY"
+}
+export declare enum DecisionOrgRole {
+    MEMBER = "MEMBER",
+    ADMIN = "ADMIN",
+    OWNER = "OWNER"
+}
+export declare enum DecisionSubjectClassification {
+    PUBLIC = "PUBLIC",
+    INTERNAL = "INTERNAL",
+    CONFIDENTIAL = "CONFIDENTIAL",
+    SECRET = "SECRET",
+    REGULATED = "REGULATED"
+}
+export declare enum DecisionOutcome {
+    COMMITTED_ACTION = "COMMITTED_ACTION",
+    COMMITTED_NO_ACTION = "COMMITTED_NO_ACTION",
+    NO_JUDGEMENT = "NO_JUDGEMENT",
+    WITHDRAWN = "WITHDRAWN"
+}
+export declare enum RecipientKind {
+    HUMAN = "human",
+    AGENT = "agent",
+    ENDPOINT = "endpoint",
+    IDENTITY_GROUP = "identity_group",
+    WORKFLOW = "workflow"
+}
+export interface DecisionFact {
+    readonly label: string;
+    readonly value: string;
+    readonly href?: string;
+}
+export interface DecisionRecipient {
+    readonly kind: RecipientKind;
+    readonly target: Readonly<Record<string, unknown>>;
+    readonly mandatory?: boolean;
+}
+export interface DeclaredDecisionOption {
+    readonly key: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly effect: DecisionOptionEffect;
+    readonly commitThreshold?: number;
+    readonly replySchema?: Readonly<Record<string, unknown>>;
+    readonly capabilityRef?: string;
+    readonly capabilityArguments?: Readonly<Record<string, unknown>>;
+}
+export interface OpenDecisionRequest {
+    readonly idempotencyKey: string;
+    readonly kind: DecisionKind;
+    readonly settlement?: DecisionSettlement;
+    readonly title: string;
+    readonly summary?: string;
+    readonly facts?: readonly DecisionFact[];
+    readonly deepLink?: string;
+    readonly subjectResourceRef: string;
+    readonly subjectClassification: DecisionSubjectClassification;
+    readonly answerCapabilityRef: string;
+    readonly producerRef?: string;
+    readonly recipients?: readonly DecisionRecipient[];
+    readonly answerRestriction?: DecisionAnswerRestriction;
+    readonly minimumOrgRole?: DecisionOrgRole;
+    readonly raisedByActorId?: string;
+    readonly selfAnswerAllowed?: boolean;
+    readonly deadlineAt?: string;
+    readonly deadlineEffect?: DecisionDeadlineEffect;
+    readonly options: readonly DeclaredDecisionOption[];
+    readonly openReplySchema?: Readonly<Record<string, unknown>>;
+}
+export interface DecisionCommitView {
+    readonly id: string;
+    readonly optionKey: string;
+    readonly committedBy: string;
+    readonly reply: Readonly<Record<string, unknown>> | null;
+    readonly note?: string | null;
+}
+export interface DecisionView {
+    readonly id: string;
+    readonly attempt: number;
+    readonly producerRef?: string | null;
+    readonly revision: number;
+    readonly commits?: readonly DecisionCommitView[];
+}
+export interface CloseDecisionRequest {
+    readonly outcome: DecisionOutcome;
+    readonly reason?: string;
+    readonly expectedRevision?: number;
+}
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":"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"}

package/dist/wire.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecipientKind = exports.DecisionOutcome = exports.DecisionSubjectClassification = exports.DecisionOrgRole = exports.DecisionAnswerRestriction = exports.DecisionDeadlineEffect = exports.DecisionSettlement = exports.DecisionOptionEffect = exports.DecisionKind = void 0;
+var DecisionKind;
+(function (DecisionKind) {
+    DecisionKind["CONFIRM"] = "CONFIRM";
+    DecisionKind["VERDICT"] = "VERDICT";
+    DecisionKind["PROPOSAL_SET"] = "PROPOSAL_SET";
+    DecisionKind["OPEN"] = "OPEN";
+})(DecisionKind || (exports.DecisionKind = DecisionKind = {}));
+var DecisionOptionEffect;
+(function (DecisionOptionEffect) {
+    DecisionOptionEffect["SETTLING_ACT"] = "SETTLING_ACT";
+    DecisionOptionEffect["SETTLING_NO_ACT"] = "SETTLING_NO_ACT";
+    DecisionOptionEffect["ADDITIVE"] = "ADDITIVE";
+})(DecisionOptionEffect || (exports.DecisionOptionEffect = DecisionOptionEffect = {}));
+var DecisionSettlement;
+(function (DecisionSettlement) {
+    DecisionSettlement["BY_COMMIT"] = "BY_COMMIT";
+    DecisionSettlement["BY_PRODUCER"] = "BY_PRODUCER";
+})(DecisionSettlement || (exports.DecisionSettlement = DecisionSettlement = {}));
+var DecisionDeadlineEffect;
+(function (DecisionDeadlineEffect) {
+    DecisionDeadlineEffect["CLOSE"] = "CLOSE";
+    DecisionDeadlineEffect["HIDE"] = "HIDE";
+    DecisionDeadlineEffect["ESCALATE"] = "ESCALATE";
+})(DecisionDeadlineEffect || (exports.DecisionDeadlineEffect = DecisionDeadlineEffect = {}));
+var DecisionAnswerRestriction;
+(function (DecisionAnswerRestriction) {
+    DecisionAnswerRestriction["ANY_PERMITTED"] = "ANY_PERMITTED";
+    DecisionAnswerRestriction["ADDRESSED_ONLY"] = "ADDRESSED_ONLY";
+})(DecisionAnswerRestriction || (exports.DecisionAnswerRestriction = DecisionAnswerRestriction = {}));
+var DecisionOrgRole;
+(function (DecisionOrgRole) {
+    DecisionOrgRole["MEMBER"] = "MEMBER";
+    DecisionOrgRole["ADMIN"] = "ADMIN";
+    DecisionOrgRole["OWNER"] = "OWNER";
+})(DecisionOrgRole || (exports.DecisionOrgRole = DecisionOrgRole = {}));
+var DecisionSubjectClassification;
+(function (DecisionSubjectClassification) {
+    DecisionSubjectClassification["PUBLIC"] = "PUBLIC";
+    DecisionSubjectClassification["INTERNAL"] = "INTERNAL";
+    DecisionSubjectClassification["CONFIDENTIAL"] = "CONFIDENTIAL";
+    DecisionSubjectClassification["SECRET"] = "SECRET";
+    DecisionSubjectClassification["REGULATED"] = "REGULATED";
+})(DecisionSubjectClassification || (exports.DecisionSubjectClassification = DecisionSubjectClassification = {}));
+var DecisionOutcome;
+(function (DecisionOutcome) {
+    DecisionOutcome["COMMITTED_ACTION"] = "COMMITTED_ACTION";
+    DecisionOutcome["COMMITTED_NO_ACTION"] = "COMMITTED_NO_ACTION";
+    DecisionOutcome["NO_JUDGEMENT"] = "NO_JUDGEMENT";
+    DecisionOutcome["WITHDRAWN"] = "WITHDRAWN";
+})(DecisionOutcome || (exports.DecisionOutcome = DecisionOutcome = {}));
+var RecipientKind;
+(function (RecipientKind) {
+    RecipientKind["HUMAN"] = "human";
+    RecipientKind["AGENT"] = "agent";
+    RecipientKind["ENDPOINT"] = "endpoint";
+    RecipientKind["IDENTITY_GROUP"] = "identity_group";
+    RecipientKind["WORKFLOW"] = "workflow";
+})(RecipientKind || (exports.RecipientKind = RecipientKind = {}));
+//# sourceMappingURL=wire.js.map

package/dist/wire.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.js","sourceRoot":"","sources":["../src/wire.ts"],"names":[],"mappings":";;;AAsCA,IAAY,YASX;AATD,WAAY,YAAY;IAEtB,mCAAmB,CAAA;IAEnB,mCAAmB,CAAA;IAEnB,6CAA6B,CAAA;IAE7B,6BAAa,CAAA;AACf,CAAC,EATW,YAAY,4BAAZ,YAAY,QASvB;AAGD,IAAY,oBAOX;AAPD,WAAY,oBAAoB;IAE9B,qDAA6B,CAAA;IAE7B,2DAAmC,CAAA;IAEnC,6CAAqB,CAAA;AACvB,CAAC,EAPW,oBAAoB,oCAApB,oBAAoB,QAO/B;AAGD,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAE5B,6CAAuB,CAAA;IAEvB,iDAA2B,CAAA;AAC7B,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B;AAGD,IAAY,sBAOX;AAPD,WAAY,sBAAsB;IAEhC,yCAAe,CAAA;IAEf,uCAAa,CAAA;IAEb,+CAAqB,CAAA;AACvB,CAAC,EAPW,sBAAsB,sCAAtB,sBAAsB,QAOjC;AAGD,IAAY,yBAKX;AALD,WAAY,yBAAyB;IAEnC,4DAA+B,CAAA;IAE/B,8DAAiC,CAAA;AACnC,CAAC,EALW,yBAAyB,yCAAzB,yBAAyB,QAKpC;AAGD,IAAY,eAIX;AAJD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,kCAAe,CAAA;AACjB,CAAC,EAJW,eAAe,+BAAf,eAAe,QAI1B;AAGD,IAAY,6BAMX;AAND,WAAY,6BAA6B;IACvC,kDAAiB,CAAA;IACjB,sDAAqB,CAAA;IACrB,8DAA6B,CAAA;IAC7B,kDAAiB,CAAA;IACjB,wDAAuB,CAAA;AACzB,CAAC,EANW,6BAA6B,6CAA7B,6BAA6B,QAMxC;AAGD,IAAY,eASX;AATD,WAAY,eAAe;IAEzB,wDAAqC,CAAA;IAErC,8DAA2C,CAAA;IAE3C,gDAA6B,CAAA;IAE7B,0CAAuB,CAAA;AACzB,CAAC,EATW,eAAe,+BAAf,eAAe,QAS1B;AAGD,IAAY,aAOX;AAPD,WAAY,aAAa;IACvB,gCAAe,CAAA;IACf,gCAAe,CAAA;IACf,sCAAqB,CAAA;IAErB,kDAAiC,CAAA;IACjC,sCAAqB,CAAA;AACvB,CAAC,EAPW,aAAa,6BAAb,aAAa,QAOxB"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@xemahq/decision-plane-nest",
+  "version": "0.1.0",
+  "description": "Producer-side SDK for the Xema human-decision primitive. One transport, one wire mirror and one consumed-event contract for every service that opens an ask on decision-api — so a producer writes only the two things that are genuinely its own: what the ask SAYS, and what it does when a human answers.",
+  "keywords": [
+    "xema",
+    "xema-platform",
+    "nestjs",
+    "decision",
+    "human-in-the-loop"
+  ],
+  "license": "Apache-2.0",
+  "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",
+  "homepage": "https://docs.xema.dev/decision-plane-nest",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xema-dev/xema-kernel-sdk.git",
+    "directory": "packages/sdks/decision-plane-nest"
+  },
+  "bugs": "https://github.com/xema-dev/xema-kernel-sdk/issues",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "@nestjs/common": "^10 || ^11",
+    "@xemahq/service-registry-nest": "^0.8.0",
+    "reflect-metadata": "^0.2"
+  },
+  "devDependencies": {
+    "@nestjs/common": "11.1.18",
+    "@nestjs/core": "11.1.18",
+    "@nestjs/testing": "11.1.18",
+    "@types/jest": "^30.0.0",
+    "@types/node": "25.2.3",
+    "jest": "^30.3.0",
+    "prettier": "3.6.2",
+    "reflect-metadata": "0.2.2",
+    "rxjs": "7.8.2",
+    "ts-jest": "^29.4.9",
+    "typescript": "5.9.3",
+    "@xemahq/service-registry-nest": "0.8.4"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint .",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "jest"
+  }
+}