@blxzer/pactile 0.6.0-beta.2 → 0.6.0-beta.5

package/dist/pactile/jev/contracts.d.ts

@@ -0,0 +1,104 @@
+export declare const JEV_ENDPOINT_V1 = "https://api.typesafe.ai/v1/systemone";
+export declare const JEV_ORIGIN_V1 = "https://api.typesafe.ai";
+export declare const MODEL_PATTERN: RegExp;
+export declare const MAX_DEADLINE_MS = 5000;
+export type JevQuestionV1 = {
+    readonly type: "noul";
+    readonly instructions: string;
+    readonly criteria?: {
+        readonly true?: string | null;
+        readonly false?: string | null;
+    } | null;
+} | {
+    readonly type: "choice";
+    readonly instructions: string;
+    readonly criteria: Readonly<Record<string, string | null>>;
+} | {
+    readonly type: "score";
+    readonly instructions: string;
+    readonly criteria: readonly (string | null)[];
+};
+export interface JevDecisionRequestV1 {
+    readonly taskSummary: string;
+    readonly sourceSnippets?: readonly {
+        readonly ref: string;
+        readonly text: string;
+    }[];
+    readonly questions: Readonly<Record<string, JevQuestionV1>>;
+    readonly model?: string;
+}
+export interface JevEgressAuthorizationV1 {
+    readonly network: "project-authorized";
+    readonly privacy: "project-approved-egress";
+    readonly credentials: "project-authorized";
+    readonly destination: typeof JEV_ORIGIN_V1;
+    readonly egressDestinations: readonly string[];
+    readonly contentDecision: "task-summary-approved" | "task-summary-and-snippets-approved";
+}
+export interface JevTransportConfigV1 {
+    readonly apiKey?: string;
+    readonly fetchImpl?: typeof fetch;
+    readonly deadlineMs?: number;
+    readonly maxRetries?: number;
+}
+export interface JevCallOptionsV1 {
+    readonly egress: JevEgressAuthorizationV1;
+    readonly signal?: AbortSignal;
+    readonly minimumDecisionConfidence?: number;
+}
+export type JevFallbackCodeV1 = "disabled" | "budget-exhausted" | "runtime-unsupported" | "configuration-missing" | "configuration-invalid" | "egress-denied" | "content-not-approved" | "sensitive-content" | "input-invalid" | "input-too-large" | "cancelled" | "deadline-exceeded" | "authentication" | "invalid-request" | "rate-limited" | "service-unavailable" | "http-error" | "transport-error" | "response-too-large" | "invalid-response" | "low-confidence";
+export interface JevReceiptV1 {
+    readonly provider: "typesafe-jev";
+    readonly outcome: "answered" | "fallback";
+    readonly reasonCode: JevFallbackCodeV1 | null;
+    readonly attempts: number;
+    readonly latencyMs: number;
+    readonly httpStatus: number | null;
+    readonly requestId: string | null;
+    readonly model: string | null;
+    readonly inputTokens: number | null;
+    readonly outputTokens: number | null;
+    readonly estimatedInputCostMicrousd: number | null;
+    /** Provider-reported values only; unavailable entries are never inferred. */
+    readonly confidence: JevConfidenceReceiptV1;
+}
+export type JevConfidenceUnavailableReasonV1 = "not-returned" | "not-provided" | "invalid";
+export type JevConfidenceValueV1 = {
+    readonly status: "available";
+    readonly value: number;
+} | {
+    readonly status: "unavailable";
+    readonly reasonCode: JevConfidenceUnavailableReasonV1;
+};
+export type JevConfidenceReceiptV1 = Readonly<Record<string, JevConfidenceValueV1>>;
+export type JevAnswerV1 = {
+    readonly type: "noul";
+    readonly noul: number;
+} | {
+    readonly type: "choice";
+    readonly choice: string;
+    readonly confidence: number;
+    readonly probabilities: Readonly<Record<string, number>>;
+} | {
+    readonly type: "score";
+    readonly score: number;
+    readonly confidence: number;
+    readonly probabilities: Readonly<Record<string, number>>;
+    readonly legend: Readonly<Record<string, string | null>>;
+};
+export type JevTransportResultV1 = {
+    readonly status: "answered";
+    readonly answers: Readonly<Record<string, JevAnswerV1>>;
+    readonly fallback: null;
+    readonly receipt: JevReceiptV1;
+} | {
+    readonly status: "fallback";
+    readonly answers: null;
+    readonly fallback: {
+        readonly reasonCode: JevFallbackCodeV1;
+        readonly explanation: string;
+    };
+    readonly receipt: JevReceiptV1;
+};
+export declare function fail(code: JevFallbackCodeV1, info?: Partial<Omit<JevReceiptV1, "provider" | "outcome" | "reasonCode">>): JevTransportResultV1;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/pactile/jev/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/pactile/jev/contracts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,yCAAyC,CAAC;AACtE,eAAO,MAAM,aAAa,4BAA4B,CAAC;AACvD,eAAO,MAAM,aAAa,QAAuC,CAAC;AAClE,eAAO,MAAM,eAAe,OAAQ,CAAC;AAErC,MAAM,MAAM,aAAa,GACrB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,GAAG,IAAI,CAAC;CACV,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC5D,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;CAC/C,CAAC;AACN,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS;QACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AACD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,OAAO,aAAa,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,eAAe,EACpB,uBAAuB,GACvB,oCAAoC,CAAC;CAC1C;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AACD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAC;CAC7C;AACD,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,kBAAkB,GAClB,qBAAqB,GACrB,uBAAuB,GACvB,uBAAuB,GACvB,eAAe,GACf,sBAAsB,GACtB,mBAAmB,GACnB,eAAe,GACf,iBAAiB,GACjB,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,cAAc,GACd,qBAAqB,GACrB,YAAY,GACZ,iBAAiB,GACjB,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,CAAC;AACrB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;CAC7C;AACD,MAAM,MAAM,gCAAgC,GACxC,cAAc,GACd,cAAc,GACd,SAAS,CAAC;AACd,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxD;IACE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,gCAAgC,CAAC;CACvD,CAAC;AACN,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CACrC,CAAC;AACF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1D,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC1D,CAAC;AACN,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;QACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;CAChC,CAAC;AAsCN,wBAAgB,IAAI,CAClB,IAAI,EAAE,iBAAiB,EACvB,IAAI,GAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC,CAAM,GAC5E,oBAAoB,CAwBtB"}

package/dist/pactile/jev/contracts.js

@@ -0,0 +1,53 @@
+export const JEV_ENDPOINT_V1 = "https://api.typesafe.ai/v1/systemone";
+export const JEV_ORIGIN_V1 = "https://api.typesafe.ai";
+export const MODEL_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$/u;
+export const MAX_DEADLINE_MS = 5_000;
+const EXPLANATION = {
+    disabled: "Jev is not configured; continue with the local deterministic path.",
+    "budget-exhausted": "The local Jev decision budget is exhausted; continue with the local deterministic path.",
+    "runtime-unsupported": "Jev requires Node.js 20 or newer; continue locally.",
+    "configuration-missing": "No Jev API key is configured; continue locally.",
+    "configuration-invalid": "Jev configuration is invalid; continue locally.",
+    "egress-denied": "Project policy does not authorize this Jev destination; continue locally.",
+    "content-not-approved": "Outgoing content is not approved for this destination; continue locally.",
+    "sensitive-content": "A credential, sensitive marker, or structured key/value field was found; nothing was sent.",
+    "input-invalid": "The Jev request is not a supported plain-data request; continue locally.",
+    "input-too-large": "The Jev request exceeds the configured content bound; continue locally.",
+    cancelled: "The Jev request was cancelled; continue locally.",
+    "deadline-exceeded": "The Jev request exceeded its total deadline; continue locally.",
+    authentication: "Jev rejected authentication; check local configuration and continue locally.",
+    "invalid-request": "Jev rejected the request shape; continue locally.",
+    "rate-limited": "Jev rate-limited the request; continue locally.",
+    "service-unavailable": "Jev is temporarily unavailable; continue locally.",
+    "http-error": "Jev returned an unsupported HTTP status; continue locally.",
+    "transport-error": "Jev could not be reached safely; continue locally.",
+    "response-too-large": "Jev returned a response above the configured bound; continue locally.",
+    "invalid-response": "Jev returned a response that failed local contract checks; continue locally.",
+    "low-confidence": "Jev's decision did not meet the configured confidence threshold; continue locally.",
+};
+export function fail(code, info = {}) {
+    const receipt = Object.freeze({
+        provider: "typesafe-jev",
+        outcome: "fallback",
+        reasonCode: code,
+        attempts: info.attempts ?? 0,
+        latencyMs: info.latencyMs ?? 0,
+        httpStatus: info.httpStatus ?? null,
+        requestId: info.requestId ?? null,
+        model: info.model ?? null,
+        inputTokens: info.inputTokens ?? null,
+        outputTokens: info.outputTokens ?? null,
+        estimatedInputCostMicrousd: info.estimatedInputCostMicrousd ?? null,
+        confidence: info.confidence ?? Object.freeze({}),
+    });
+    return Object.freeze({
+        status: "fallback",
+        answers: null,
+        fallback: Object.freeze({
+            reasonCode: code,
+            explanation: EXPLANATION[code],
+        }),
+        receipt,
+    });
+}
+//# sourceMappingURL=contracts.js.map

package/dist/pactile/jev/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/pactile/jev/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,sCAAsC,CAAC;AACtE,MAAM,CAAC,MAAM,aAAa,GAAG,yBAAyB,CAAC;AACvD,MAAM,CAAC,MAAM,aAAa,GAAG,oCAAoC,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAqIrC,MAAM,WAAW,GAAgD;IAC/D,QAAQ,EACN,oEAAoE;IACtE,kBAAkB,EAChB,yFAAyF;IAC3F,qBAAqB,EAAE,qDAAqD;IAC5E,uBAAuB,EAAE,iDAAiD;IAC1E,uBAAuB,EAAE,iDAAiD;IAC1E,eAAe,EACb,2EAA2E;IAC7E,sBAAsB,EACpB,0EAA0E;IAC5E,mBAAmB,EACjB,4FAA4F;IAC9F,eAAe,EACb,0EAA0E;IAC5E,iBAAiB,EACf,yEAAyE;IAC3E,SAAS,EAAE,kDAAkD;IAC7D,mBAAmB,EACjB,gEAAgE;IAClE,cAAc,EACZ,8EAA8E;IAChF,iBAAiB,EAAE,mDAAmD;IACtE,cAAc,EAAE,iDAAiD;IACjE,qBAAqB,EAAE,mDAAmD;IAC1E,YAAY,EAAE,4DAA4D;IAC1E,iBAAiB,EAAE,oDAAoD;IACvE,oBAAoB,EAClB,uEAAuE;IACzE,kBAAkB,EAChB,8EAA8E;IAChF,gBAAgB,EACd,oFAAoF;CACvF,CAAC;AAEF,MAAM,UAAU,IAAI,CAClB,IAAuB,EACvB,OAA2E,EAAE;IAE7E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,QAAQ,EAAE,cAAuB;QACjC,OAAO,EAAE,UAAmB;QAC5B,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;QAC5B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;QAC9B,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI;QACnC,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;QACrC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;QACvC,0BAA0B,EAAE,IAAI,CAAC,0BAA0B,IAAI,IAAI;QACnE,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;KACjD,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,UAAmB;QAC3B,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC;SAC/B,CAAC;QACF,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/pactile/jev/decision.d.ts

@@ -0,0 +1,58 @@
+import type { JevCallOptionsV1, JevDecisionRequestV1, JevFallbackCodeV1, JevReceiptV1, JevTransportConfigV1, JevTransportResultV1 } from "./contracts.js";
+export declare const JEV_DECISION_NODES_V1: readonly ["tile-selection", "task-scheduling", "execution-routing", "review-routing", "verification-planning", "retrieval-planning"];
+export type JevDecisionNodeV1 = (typeof JEV_DECISION_NODES_V1)[number];
+export interface JevDecisionFacadeConfigV1 {
+    /** Optional kill switch. A configured key and approved egress enable calls unless false. */
+    readonly enabled?: boolean;
+    /** Maximum provider decisions for this facade instance, excluding retries. */
+    readonly maxDecisions?: number;
+    /** Hard cap applied to each request deadline. */
+    readonly maxDeadlineMs?: number;
+    readonly transport?: JevTransportConfigV1;
+}
+export interface JevDecisionInvocationV1 {
+    readonly node: JevDecisionNodeV1;
+    readonly request: JevDecisionRequestV1;
+    readonly options: JevCallOptionsV1;
+}
+export interface JevDecisionBudgetV1 {
+    readonly maxDecisions: number;
+    readonly decisionsUsed: number;
+    readonly decisionsRemaining: number;
+    readonly maximumHttpAttempts: number;
+    /** Sum of the provider's reported-input-token cost estimates for this instance. */
+    readonly observedEstimatedInputCostMicrousd: number;
+}
+export interface JevDecisionReceiptV1 {
+    readonly schemaVersion: 1;
+    readonly node: JevDecisionNodeV1;
+    readonly transport: JevReceiptV1;
+    readonly budget: JevDecisionBudgetV1;
+}
+export type JevDecisionResultV1 = {
+    readonly node: JevDecisionNodeV1;
+    readonly status: "answered";
+    readonly answers: Extract<JevTransportResultV1, {
+        status: "answered";
+    }>["answers"];
+    readonly fallback: null;
+    readonly receipt: JevDecisionReceiptV1;
+} | {
+    readonly node: JevDecisionNodeV1;
+    readonly status: "fallback";
+    readonly answers: null;
+    readonly fallback: {
+        readonly reasonCode: JevFallbackCodeV1;
+        readonly explanation: string;
+    };
+    readonly receipt: JevDecisionReceiptV1;
+};
+export interface JevDecisionFacadeV1 {
+    decide(input: JevDecisionInvocationV1): Promise<JevDecisionResultV1>;
+}
+/**
+ * Build an optional, bounded decision facade. It returns suggestions and
+ * receipts only; callers retain deterministic validation and authority.
+ */
+export declare function createJevDecisionFacadeV1(config?: JevDecisionFacadeConfigV1): JevDecisionFacadeV1;
+//# sourceMappingURL=decision.d.ts.map

package/dist/pactile/jev/decision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.d.ts","sourceRoot":"","sources":["../../../src/pactile/jev/decision.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAIxB,eAAO,MAAM,qBAAqB,sIAOxB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAKvE,MAAM,WAAW,yBAAyB;IACxC,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAC3C;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,mFAAmF;IACnF,QAAQ,CAAC,kCAAkC,EAAE,MAAM,CAAC;CACrD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IACE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CACvB,oBAAoB,EACpB;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,CACvB,CAAC,SAAS,CAAC,CAAC;IACb,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;QACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC,CAAC;AAEN,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtE;AA6DD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,GAAE,yBAA8B,GACrC,mBAAmB,CA6GrB"}

package/dist/pactile/jev/decision.js

@@ -0,0 +1,149 @@
+import process from "node:process";
+import { fail, MAX_DEADLINE_MS } from "./contracts.js";
+import { egressFailure, validateInput } from "./outbound.js";
+import { createJevTransportV1 } from "./transport.js";
+export const JEV_DECISION_NODES_V1 = [
+    "tile-selection",
+    "task-scheduling",
+    "execution-routing",
+    "review-routing",
+    "verification-planning",
+    "retrieval-planning",
+];
+const DEFAULT_MAX_DECISIONS = 1;
+const MAX_DECISIONS = 32;
+function validNode(value) {
+    return (typeof value === "string" &&
+        JEV_DECISION_NODES_V1.includes(value));
+}
+function receiptBudget(maxDecisions, decisionsUsed, maximumHttpAttempts, observedEstimatedInputCostMicrousd) {
+    return Object.freeze({
+        maxDecisions,
+        decisionsUsed,
+        decisionsRemaining: Math.max(0, maxDecisions - decisionsUsed),
+        maximumHttpAttempts,
+        observedEstimatedInputCostMicrousd,
+    });
+}
+function withReceipt(node, result, budget) {
+    const receipt = Object.freeze({
+        schemaVersion: 1,
+        node,
+        transport: result.receipt,
+        budget,
+    });
+    if (result.status === "answered") {
+        return Object.freeze({
+            node,
+            status: "answered",
+            answers: result.answers,
+            fallback: null,
+            receipt,
+        });
+    }
+    return Object.freeze({
+        node,
+        status: "fallback",
+        answers: null,
+        fallback: result.fallback,
+        receipt,
+    });
+}
+function fallback(node, code, budget) {
+    return withReceipt(node, fail(code), budget);
+}
+/**
+ * Build an optional, bounded decision facade. It returns suggestions and
+ * receipts only; callers retain deterministic validation and authority.
+ */
+export function createJevDecisionFacadeV1(config = {}) {
+    const requestedMaxDecisions = config.maxDecisions ?? DEFAULT_MAX_DECISIONS;
+    const maxDecisionsValid = Number.isSafeInteger(requestedMaxDecisions) &&
+        requestedMaxDecisions >= 1 &&
+        requestedMaxDecisions <= MAX_DECISIONS;
+    const maxDecisions = maxDecisionsValid
+        ? requestedMaxDecisions
+        : DEFAULT_MAX_DECISIONS;
+    const requestedMaxDeadlineMs = config.maxDeadlineMs ?? MAX_DEADLINE_MS;
+    const maxDeadlineValid = Number.isSafeInteger(requestedMaxDeadlineMs) &&
+        requestedMaxDeadlineMs >= 1 &&
+        requestedMaxDeadlineMs <= MAX_DEADLINE_MS;
+    const maxDeadlineMs = maxDeadlineValid
+        ? requestedMaxDeadlineMs
+        : MAX_DEADLINE_MS;
+    const requestedDeadlineMs = config.transport?.deadlineMs ?? 2_500;
+    const deadlineValid = Number.isSafeInteger(requestedDeadlineMs) &&
+        requestedDeadlineMs >= 1 &&
+        requestedDeadlineMs <= MAX_DEADLINE_MS;
+    const deadlineMs = deadlineValid
+        ? Math.min(requestedDeadlineMs, maxDeadlineMs)
+        : 2_500;
+    const requestedMaxRetries = config.transport?.maxRetries ?? 1;
+    const retriesValid = Number.isSafeInteger(requestedMaxRetries) &&
+        requestedMaxRetries >= 0 &&
+        requestedMaxRetries <= 1;
+    const maxRetries = retriesValid ? requestedMaxRetries : 1;
+    const enabledValid = config.enabled === undefined || typeof config.enabled === "boolean";
+    const configValid = enabledValid &&
+        maxDecisionsValid &&
+        maxDeadlineValid &&
+        deadlineValid &&
+        retriesValid;
+    const maximumHttpAttempts = maxDecisions * (maxRetries + 1);
+    const transportConfig = {
+        ...config.transport,
+        deadlineMs,
+    };
+    const requestTransport = createJevTransportV1(transportConfig);
+    let decisionsUsed = 0;
+    let observedEstimatedInputCostMicrousd = 0;
+    return Object.freeze({
+        async decide(input) {
+            const node = validNode(input?.node) ? input.node : "retrieval-planning";
+            const budget = () => receiptBudget(maxDecisions, decisionsUsed, maximumHttpAttempts, observedEstimatedInputCostMicrousd);
+            if (!configValid)
+                return fallback(node, "configuration-invalid", budget());
+            if (config.enabled === false)
+                return fallback(node, "disabled", budget());
+            if (Number(process.versions.node.split(".")[0]) < 20)
+                return fallback(node, "runtime-unsupported", budget());
+            const apiKey = config.transport?.apiKey;
+            if (typeof apiKey !== "string" || apiKey.length === 0)
+                return fallback(node, "configuration-missing", budget());
+            if (apiKey.length < 8 ||
+                apiKey.length > 512 ||
+                !/^[\x21-\x7E]+$/u.test(apiKey))
+                return fallback(node, "configuration-invalid", budget());
+            if (!validNode(input?.node) ||
+                input.request === undefined ||
+                input.options === undefined ||
+                input.options === null)
+                return fallback(node, "input-invalid", budget());
+            const checked = validateInput(input.request, apiKey);
+            if (!checked.ok)
+                return fallback(node, checked.code, budget());
+            const egressError = egressFailure(input.options.egress, (checked.request.sourceSnippets?.length ?? 0) > 0);
+            if (egressError !== null)
+                return fallback(node, egressError, budget());
+            const minimumDecisionConfidence = input.options.minimumDecisionConfidence ?? 0.65;
+            if (!Number.isFinite(minimumDecisionConfidence) ||
+                minimumDecisionConfidence < 0 ||
+                minimumDecisionConfidence > 1)
+                return fallback(node, "configuration-invalid", budget());
+            if (input.options.signal?.aborted)
+                return fallback(node, "cancelled", budget());
+            const fetchImpl = config.transport?.fetchImpl ?? globalThis.fetch;
+            if (typeof fetchImpl !== "function")
+                return fallback(node, "runtime-unsupported", budget());
+            if (decisionsUsed >= maxDecisions)
+                return fallback(node, "budget-exhausted", budget());
+            decisionsUsed += 1;
+            const result = await requestTransport(input.request, input.options);
+            const callCost = result.receipt.estimatedInputCostMicrousd;
+            if (callCost !== null)
+                observedEstimatedInputCostMicrousd += callCost;
+            return withReceipt(node, result, budget());
+        },
+    });
+}
+//# sourceMappingURL=decision.js.map

package/dist/pactile/jev/decision.js.map

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

package/dist/pactile/jev/http.d.ts

@@ -0,0 +1,25 @@
+import type { JevFallbackCodeV1 } from "./contracts.js";
+export interface JevHttpMetricsV1 {
+    readonly attempts: number;
+    readonly latencyMs: number;
+    readonly httpStatus: number | null;
+    readonly requestId: string | null;
+}
+export type JevHttpOutcomeV1 = {
+    readonly ok: true;
+    readonly payload: unknown;
+    readonly metrics: JevHttpMetricsV1;
+} | {
+    readonly ok: false;
+    readonly reasonCode: JevFallbackCodeV1;
+    readonly metrics: JevHttpMetricsV1;
+};
+export declare function requestJevHttpV1(input: {
+    readonly apiKey: string;
+    readonly body: string;
+    readonly deadlineMs: number;
+    readonly maxRetries: number;
+    readonly fetchImpl: typeof fetch;
+    readonly signal?: AbortSignal;
+}): Promise<JevHttpOutcomeV1>;
+//# sourceMappingURL=http.d.ts.map

package/dist/pactile/jev/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/pactile/jev/http.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAkIxD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AACD,MAAM,MAAM,gBAAgB,GACxB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;CACpC,CAAC;AAEN,wBAAsB,gBAAgB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,KAAK,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6G5B"}

package/dist/pactile/jev/http.js

@@ -0,0 +1,234 @@
+import { performance } from "node:perf_hooks";
+import { isPlainOwnDataJsonTreeV3 } from "../retrieval/boundary.js";
+import { JEV_ENDPOINT_V1 } from "./contracts.js";
+const SAFE_HEADER_ID = /^req_[A-Za-z0-9_-]{1,76}$/u;
+const MAX_RESPONSE_BYTES = 24 * 1024;
+function getRequestId(response, apiKey) {
+    const value = response.headers.get("x-typesafe-request-id");
+    return value !== null && SAFE_HEADER_ID.test(value) && !value.includes(apiKey)
+        ? value
+        : null;
+}
+function retryDelay(response) {
+    const ms = response.headers.get("retry-after-ms");
+    if (ms !== null && /^\d{1,6}$/u.test(ms.trim()))
+        return Math.min(500, Number(ms.trim()));
+    const s = response.headers.get("retry-after");
+    if (s !== null && /^\d{1,3}(?:\.\d+)?$/u.test(s.trim()))
+        return Math.min(500, Math.max(0, Math.round(Number(s.trim()) * 1_000)));
+    return 100;
+}
+function raceAbort(promise, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted) {
+            resolve(null);
+            return;
+        }
+        let done = false;
+        const finish = (value) => {
+            if (done)
+                return;
+            done = true;
+            signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        };
+        const onAbort = () => finish(null);
+        signal.addEventListener("abort", onAbort, { once: true });
+        promise.then((value) => finish(value), () => finish(null));
+    });
+}
+function cancelBody(response) {
+    try {
+        const cancellation = response.body?.cancel();
+        if (cancellation !== undefined)
+            void cancellation.catch(() => undefined);
+    }
+    catch {
+        /* Never retain raw transport errors. */
+    }
+}
+function cancelReader(reader) {
+    try {
+        void reader.cancel().catch(() => undefined);
+    }
+    catch {
+        /* Never retain raw transport errors. */
+    }
+}
+async function retryWait(ms, signal) {
+    return await new Promise((resolve) => {
+        const timer = setTimeout(() => finish(true), ms);
+        const finish = (complete) => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", abort);
+            resolve(complete);
+        };
+        const abort = () => finish(false);
+        if (signal.aborted)
+            finish(false);
+        else
+            signal.addEventListener("abort", abort, { once: true });
+    });
+}
+async function readBoundedText(response, signal) {
+    const length = response.headers.get("content-length");
+    if (length !== null &&
+        /^\d{1,10}$/u.test(length) &&
+        Number(length) > MAX_RESPONSE_BYTES) {
+        cancelBody(response);
+        return "too-large";
+    }
+    const reader = response.body?.getReader();
+    if (reader === undefined)
+        return "failed";
+    const chunks = [];
+    let total = 0;
+    try {
+        while (true) {
+            const item = await raceAbort(reader.read(), signal);
+            if (item === null) {
+                cancelReader(reader);
+                return signal.aborted ? "aborted" : "failed";
+            }
+            if (item.done)
+                break;
+            total += item.value.byteLength;
+            if (total > MAX_RESPONSE_BYTES) {
+                cancelReader(reader);
+                return "too-large";
+            }
+            chunks.push(item.value);
+        }
+    }
+    finally {
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            /* The reader may already be closed. */
+        }
+    }
+    const bytes = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        bytes.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    try {
+        return { text: new TextDecoder("utf-8", { fatal: true }).decode(bytes) };
+    }
+    catch {
+        return "failed";
+    }
+}
+export async function requestJevHttpV1(input) {
+    const started = performance.now();
+    let attempts = 0;
+    let status = null;
+    let requestId = null;
+    let callerCancelled = false;
+    let expired = false;
+    const controller = new AbortController();
+    const abortCaller = () => {
+        callerCancelled = true;
+        controller.abort();
+    };
+    input.signal?.addEventListener("abort", abortCaller, { once: true });
+    const deadlineTimer = setTimeout(() => {
+        expired = true;
+        controller.abort();
+    }, input.deadlineMs);
+    const latency = () => Math.max(0, Math.min(5_000, Math.round(performance.now() - started)));
+    const metrics = () => ({
+        attempts,
+        latencyMs: latency(),
+        httpStatus: status,
+        requestId,
+    });
+    const error = (reasonCode) => ({
+        ok: false,
+        reasonCode,
+        metrics: metrics(),
+    });
+    try {
+        for (let attempt = 0; attempt <= input.maxRetries; attempt += 1) {
+            if (controller.signal.aborted)
+                return error(callerCancelled ? "cancelled" : "deadline-exceeded");
+            attempts += 1;
+            let response;
+            try {
+                response = await raceAbort(input.fetchImpl(JEV_ENDPOINT_V1, {
+                    method: "POST",
+                    redirect: "error",
+                    headers: {
+                        authorization: "Bearer " + input.apiKey,
+                        "content-type": "application/json",
+                        accept: "application/json",
+                    },
+                    body: input.body,
+                    signal: controller.signal,
+                }), controller.signal);
+            }
+            catch {
+                response = null;
+            }
+            if (response === null)
+                return error(callerCancelled
+                    ? "cancelled"
+                    : expired
+                        ? "deadline-exceeded"
+                        : "transport-error");
+            status = response.status;
+            requestId = getRequestId(response, input.apiKey);
+            if (!response.ok) {
+                cancelBody(response);
+                if (status === 401 || status === 403)
+                    return error("authentication");
+                if (status === 422)
+                    return error("invalid-request");
+                if (status === 408)
+                    return error("deadline-exceeded");
+                if (status === 429 || (status >= 500 && status <= 599)) {
+                    const code = status === 429 ? "rate-limited" : "service-unavailable";
+                    if (attempt < input.maxRetries) {
+                        const delay = retryDelay(response);
+                        if (latency() + delay >= input.deadlineMs)
+                            return error(code);
+                        const completed = await retryWait(delay, controller.signal);
+                        if (completed !== true)
+                            return error(callerCancelled ? "cancelled" : "deadline-exceeded");
+                        continue;
+                    }
+                    return error(code);
+                }
+                return error("http-error");
+            }
+            const contentType = response.headers.get("content-type") ?? "";
+            if (!/^application\/(?:[a-z0-9.+-]+\+)?json(?:\s*;|$)/iu.test(contentType))
+                return error("invalid-response");
+            const bodyResult = await readBoundedText(response, controller.signal);
+            if (bodyResult === "too-large")
+                return error("response-too-large");
+            if (bodyResult === "aborted")
+                return error(callerCancelled ? "cancelled" : "deadline-exceeded");
+            if (bodyResult === "failed")
+                return error("transport-error");
+            let decoded;
+            try {
+                decoded = JSON.parse(bodyResult.text);
+            }
+            catch {
+                return error("invalid-response");
+            }
+            if (!isPlainOwnDataJsonTreeV3(decoded))
+                return error("invalid-response");
+            return { ok: true, payload: decoded, metrics: metrics() };
+        }
+        return error("transport-error");
+    }
+    finally {
+        clearTimeout(deadlineTimer);
+        input.signal?.removeEventListener("abort", abortCaller);
+    }
+}
+//# sourceMappingURL=http.js.map