@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/core/pactile/validation.d.ts

@@ -0,0 +1,91 @@
+export declare const PACTILE_CONTRACT_SCHEMA_VERSION: 1;
+export type PactileContractIssueCodeV1 = "required" | "unknown-field" | "invalid-type" | "invalid-value" | "invalid-enum" | "duplicate" | "policy-violation" | "conflict";
+export interface PactileContractIssueV1 {
+    readonly code: PactileContractIssueCodeV1;
+    readonly path: string;
+    readonly message: string;
+}
+export interface PactileContractParseSuccessV1<T> {
+    readonly success: true;
+    readonly data: T;
+    readonly fingerprint: string;
+}
+export interface PactileContractParseFailureV1 {
+    readonly success: false;
+    readonly issues: readonly PactileContractIssueV1[];
+}
+export type PactileContractParseResultV1<T> = PactileContractParseSuccessV1<T> | PactileContractParseFailureV1;
+export interface PactileContractSchemaV1<T> {
+    readonly kind: string;
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    parse(input: unknown): PactileContractParseResultV1<T>;
+    fingerprint(value: T): string;
+}
+export type PactileJsonPrimitiveV1 = string | number | boolean | null;
+export type PactileJsonValueV1 = PactileJsonPrimitiveV1 | readonly PactileJsonValueV1[] | {
+    readonly [key: string]: PactileJsonValueV1;
+};
+type DecoderV1<T> = (input: unknown, decoder: ContractDecoderV1, path: string) => T;
+/**
+ * Stable JSON used by every Pactile v1 contract fingerprint.
+ *
+ * Object keys are sorted recursively, array order is retained, and no
+ * insignificant whitespace is emitted. Only finite JSON values are accepted.
+ */
+export declare function canonicalizePactileJsonV1(value: unknown): string;
+/** Return `sha256:<lowercase hex>` for the stable Pactile JSON encoding. */
+export declare function fingerprintPactileContractV1(value: unknown): string;
+export declare function definePactileContractSchemaV1<T>(kind: string, decode: DecoderV1<T>): PactileContractSchemaV1<T>;
+export declare class ContractDecoderV1 {
+    readonly issues: PactileContractIssueV1[];
+    issue(code: PactileContractIssueCodeV1, path: string, message: string): void;
+    object(value: unknown, path: string, allowedKeys: readonly string[]): Record<string, unknown>;
+    required(record: Record<string, unknown>, key: string, path: string): unknown;
+    optional(record: Record<string, unknown>, key: string): unknown;
+    literal<T extends string | number | boolean>(value: unknown, expected: T, path: string): T;
+    string(value: unknown, path: string, options?: {
+        readonly nonEmpty?: boolean;
+        readonly pattern?: RegExp;
+        readonly patternDescription?: string;
+    }): string;
+    nullableString(value: unknown, path: string, options?: {
+        readonly nonEmpty?: boolean;
+        readonly pattern?: RegExp;
+        readonly patternDescription?: string;
+    }): string | null;
+    boolean(value: unknown, path: string): boolean;
+    integer(value: unknown, path: string, options?: {
+        readonly min?: number;
+        readonly max?: number;
+    }): number;
+    enumValue<T extends string>(value: unknown, values: readonly T[], path: string): T;
+    array<T>(value: unknown, path: string, decodeItem: (value: unknown, path: string, index: number) => T): T[];
+    stringArray(value: unknown, path: string, options?: {
+        readonly nonEmptyItems?: boolean;
+        readonly unique?: boolean;
+        readonly pattern?: RegExp;
+        readonly patternDescription?: string;
+    }): string[];
+    unique<T>(values: readonly T[], keyOf: (value: T) => string, path: string, label: string): void;
+}
+export declare const PACTILE_LOGICAL_ID_PATTERN: RegExp;
+export declare const PACTILE_SEMVER_PATTERN: RegExp;
+export declare const PACTILE_FINGERPRINT_PATTERN: RegExp;
+export declare function decodeSchemaVersionV1(record: Record<string, unknown>, decoder: ContractDecoderV1, path: string): typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+export declare function decodeLogicalIdV1(value: unknown, decoder: ContractDecoderV1, path: string): string;
+export declare function decodeSemverV1(value: unknown, decoder: ContractDecoderV1, path: string): string;
+export declare function decodeFingerprintV1(value: unknown, decoder: ContractDecoderV1, path: string): string;
+export declare function decodeNullableFingerprintV1(value: unknown, decoder: ContractDecoderV1, path: string): string | null;
+/**
+ * Decode a scheme-scoped logical reference, never a network URL or inline
+ * payload. Query strings, fragments, user-info, percent encoding, whitespace,
+ * and arbitrary prose are intentionally outside this grammar.
+ */
+export declare function decodeOpaqueReferenceV1(value: unknown, decoder: ContractDecoderV1, path: string, allowedSchemes: readonly string[]): string;
+export declare function decodeTimestampV1(value: unknown, decoder: ContractDecoderV1, path: string): string;
+export declare function decodeNullableTimestampV1(value: unknown, decoder: ContractDecoderV1, path: string): string | null;
+export declare function decodeRelativePosixPathV1(value: unknown, decoder: ContractDecoderV1, path: string): string;
+export declare function childPathV1(parent: string, key: string): string;
+export declare function isPlainRecordV1(value: unknown): value is Record<string, unknown>;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/pactile/validation.d.ts.map

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

package/dist/core/pactile/validation.js

@@ -0,0 +1,301 @@
+import { createHash } from "node:crypto";
+export const PACTILE_CONTRACT_SCHEMA_VERSION = 1;
+/**
+ * Stable JSON used by every Pactile v1 contract fingerprint.
+ *
+ * Object keys are sorted recursively, array order is retained, and no
+ * insignificant whitespace is emitted. Only finite JSON values are accepted.
+ */
+export function canonicalizePactileJsonV1(value) {
+    return canonicalJson(value, "$", new Set());
+}
+/** Return `sha256:<lowercase hex>` for the stable Pactile JSON encoding. */
+export function fingerprintPactileContractV1(value) {
+    return `sha256:${createHash("sha256")
+        .update(canonicalizePactileJsonV1(value), "utf8")
+        .digest("hex")}`;
+}
+export function definePactileContractSchemaV1(kind, decode) {
+    return {
+        kind,
+        schemaVersion: PACTILE_CONTRACT_SCHEMA_VERSION,
+        parse(input) {
+            const decoder = new ContractDecoderV1();
+            const data = decode(input, decoder, "$");
+            if (decoder.issues.length > 0) {
+                return { success: false, issues: decoder.issues };
+            }
+            return {
+                success: true,
+                data,
+                fingerprint: fingerprintPactileContractV1(data),
+            };
+        },
+        fingerprint(value) {
+            return fingerprintPactileContractV1(value);
+        },
+    };
+}
+export class ContractDecoderV1 {
+    issues = [];
+    issue(code, path, message) {
+        this.issues.push({ code, path, message });
+    }
+    object(value, path, allowedKeys) {
+        if (!isPlainRecordV1(value)) {
+            this.issue("invalid-type", path, "must be a JSON object");
+            return {};
+        }
+        const allowed = new Set(allowedKeys);
+        for (const key of Object.keys(value)) {
+            if (!allowed.has(key)) {
+                this.issue("unknown-field", childPathV1(path, key), `field '${key}' is not part of the v1 contract`);
+            }
+        }
+        return value;
+    }
+    required(record, key, path) {
+        if (!Object.prototype.hasOwnProperty.call(record, key)) {
+            this.issue("required", childPathV1(path, key), "is required");
+            return undefined;
+        }
+        return record[key];
+    }
+    optional(record, key) {
+        return Object.prototype.hasOwnProperty.call(record, key)
+            ? record[key]
+            : undefined;
+    }
+    literal(value, expected, path) {
+        if (value !== expected) {
+            this.issue("invalid-value", path, `must be the literal ${JSON.stringify(expected)}`);
+        }
+        return expected;
+    }
+    string(value, path, options = {}) {
+        if (typeof value !== "string") {
+            this.issue("invalid-type", path, "must be a string");
+            return "";
+        }
+        if (options.nonEmpty === true && value.trim().length === 0) {
+            this.issue("invalid-value", path, "must not be empty");
+        }
+        if (options.pattern && !options.pattern.test(value)) {
+            this.issue("invalid-value", path, `must be ${options.patternDescription ?? "in the required format"}`);
+        }
+        return value;
+    }
+    nullableString(value, path, options = {}) {
+        if (value === null)
+            return null;
+        return this.string(value, path, options);
+    }
+    boolean(value, path) {
+        if (typeof value !== "boolean") {
+            this.issue("invalid-type", path, "must be a boolean");
+            return false;
+        }
+        return value;
+    }
+    integer(value, path, options = {}) {
+        if (typeof value !== "number" || !Number.isSafeInteger(value)) {
+            this.issue("invalid-type", path, "must be a safe integer");
+            return 0;
+        }
+        if (options.min !== undefined && value < options.min) {
+            this.issue("invalid-value", path, `must be at least ${options.min}`);
+        }
+        if (options.max !== undefined && value > options.max) {
+            this.issue("invalid-value", path, `must be at most ${options.max}`);
+        }
+        return value;
+    }
+    enumValue(value, values, path) {
+        if (typeof value !== "string" || !values.includes(value)) {
+            this.issue("invalid-enum", path, `must be one of: ${values.join(", ")}`);
+            return values[0];
+        }
+        return value;
+    }
+    array(value, path, decodeItem) {
+        if (!Array.isArray(value)) {
+            this.issue("invalid-type", path, "must be an array");
+            return [];
+        }
+        return value.map((item, index) => decodeItem(item, `${path}[${index}]`, index));
+    }
+    stringArray(value, path, options = {}) {
+        const values = this.array(value, path, (item, itemPath) => this.string(item, itemPath, {
+            nonEmpty: options.nonEmptyItems,
+            pattern: options.pattern,
+            patternDescription: options.patternDescription,
+        }));
+        if (options.unique === true) {
+            this.unique(values, (item) => item, path, "value");
+        }
+        return values;
+    }
+    unique(values, keyOf, path, label) {
+        const seen = new Map();
+        values.forEach((value, index) => {
+            const key = keyOf(value);
+            const firstIndex = seen.get(key);
+            if (firstIndex !== undefined) {
+                this.issue("duplicate", `${path}[${index}]`, `duplicate ${label} '${key}' (first declared at ${path}[${firstIndex}])`);
+                return;
+            }
+            seen.set(key, index);
+        });
+    }
+}
+export const PACTILE_LOGICAL_ID_PATTERN = /^[a-z][a-z0-9]*(?:[._:-][a-z0-9]+)*$/;
+export const PACTILE_SEMVER_PATTERN = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z]+(?:\.[0-9A-Za-z]+)*)?(?:\+[0-9A-Za-z]+(?:\.[0-9A-Za-z]+)*)?$/;
+export const PACTILE_FINGERPRINT_PATTERN = /^sha256:[0-9a-f]{64}$/;
+const PACTILE_OPAQUE_REFERENCE_PATTERN = /^([a-z][a-z0-9-]{0,31}):\/\/([a-z0-9]+(?:[._-][a-z0-9]+)*(?:\/[a-z0-9]+(?:[._-][a-z0-9]+)*)*)$/;
+const PACTILE_OPAQUE_REFERENCE_MAX_LENGTH = 256;
+const PACTILE_SENSITIVE_REFERENCE_TERMS = new Set([
+    "credential",
+    "credentials",
+    "passwd",
+    "password",
+    "secret",
+    "token",
+]);
+function containsSensitiveReferenceTermV1(payload) {
+    return payload
+        .replaceAll("/", ".")
+        .split(/[_.-]/u)
+        .some((term) => PACTILE_SENSITIVE_REFERENCE_TERMS.has(term));
+}
+export function decodeSchemaVersionV1(record, decoder, path) {
+    return decoder.literal(decoder.required(record, "schemaVersion", path), PACTILE_CONTRACT_SCHEMA_VERSION, childPathV1(path, "schemaVersion"));
+}
+export function decodeLogicalIdV1(value, decoder, path) {
+    return decoder.string(value, path, {
+        nonEmpty: true,
+        pattern: PACTILE_LOGICAL_ID_PATTERN,
+        patternDescription: "a lowercase logical id using '.', '_', ':', or '-' separators",
+    });
+}
+export function decodeSemverV1(value, decoder, path) {
+    return decoder.string(value, path, {
+        nonEmpty: true,
+        pattern: PACTILE_SEMVER_PATTERN,
+        patternDescription: "a semantic version",
+    });
+}
+export function decodeFingerprintV1(value, decoder, path) {
+    return decoder.string(value, path, {
+        pattern: PACTILE_FINGERPRINT_PATTERN,
+        patternDescription: "a sha256:<lowercase hex> fingerprint",
+    });
+}
+export function decodeNullableFingerprintV1(value, decoder, path) {
+    if (value === null)
+        return null;
+    return decodeFingerprintV1(value, decoder, path);
+}
+/**
+ * Decode a scheme-scoped logical reference, never a network URL or inline
+ * payload. Query strings, fragments, user-info, percent encoding, whitespace,
+ * and arbitrary prose are intentionally outside this grammar.
+ */
+export function decodeOpaqueReferenceV1(value, decoder, path, allowedSchemes) {
+    const reference = decoder.string(value, path, { nonEmpty: true });
+    if (reference.length > PACTILE_OPAQUE_REFERENCE_MAX_LENGTH) {
+        decoder.issue("invalid-value", path, `must be at most ${PACTILE_OPAQUE_REFERENCE_MAX_LENGTH} characters`);
+    }
+    const match = PACTILE_OPAQUE_REFERENCE_PATTERN.exec(reference);
+    if (match === null) {
+        decoder.issue("invalid-value", path, "must be a scheme-scoped logical reference without URL credentials, query, fragment, or inline content");
+        return reference;
+    }
+    const scheme = match[1] ?? "";
+    const payload = match[2] ?? "";
+    if (!allowedSchemes.includes(scheme)) {
+        decoder.issue("invalid-value", path, `must use one of these reference schemes: ${allowedSchemes.join(", ")}`);
+    }
+    if (containsSensitiveReferenceTermV1(payload)) {
+        decoder.issue("invalid-value", path, "must be a non-secret registry handle without credential-bearing terms");
+    }
+    return reference;
+}
+export function decodeTimestampV1(value, decoder, path) {
+    const timestamp = decoder.string(value, path, { nonEmpty: true });
+    if (timestamp.length > 0 &&
+        (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/.test(timestamp) ||
+            Number.isNaN(Date.parse(timestamp)))) {
+        decoder.issue("invalid-value", path, "must be an RFC 3339 timestamp");
+    }
+    return timestamp;
+}
+export function decodeNullableTimestampV1(value, decoder, path) {
+    if (value === null)
+        return null;
+    return decodeTimestampV1(value, decoder, path);
+}
+export function decodeRelativePosixPathV1(value, decoder, path) {
+    const candidate = decoder.string(value, path, { nonEmpty: true });
+    if (candidate.length === 0)
+        return candidate;
+    const segments = candidate.split("/");
+    if (candidate.includes("\\") ||
+        candidate.startsWith("/") ||
+        /^[A-Za-z]:/.test(candidate) ||
+        segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
+        decoder.issue("invalid-value", path, "must be a normalized project-relative POSIX path without traversal");
+    }
+    return candidate;
+}
+export function childPathV1(parent, key) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key)
+        ? `${parent}.${key}`
+        : `${parent}[${JSON.stringify(key)}]`;
+}
+export function isPlainRecordV1(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.getPrototypeOf(value) === Object.prototype);
+}
+function canonicalJson(value, path, ancestors) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string" || typeof value === "boolean") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new TypeError(`${path} must be a finite JSON number`);
+        }
+        return JSON.stringify(value);
+    }
+    if (typeof value !== "object") {
+        throw new TypeError(`${path} must contain only JSON values`);
+    }
+    if (ancestors.has(value)) {
+        throw new TypeError(`${path} must not contain a circular reference`);
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return `[${value
+                .map((item, index) => canonicalJson(item, `${path}[${index}]`, ancestors))
+                .join(",")}]`;
+        }
+        if (!isPlainRecordV1(value)) {
+            throw new TypeError(`${path} must contain only plain JSON objects`);
+        }
+        const members = Object.keys(value)
+            .sort()
+            .map((key) => {
+            const child = value[key];
+            return `${JSON.stringify(key)}:${canonicalJson(child, childPathV1(path, key), ancestors)}`;
+        });
+        return `{${members.join(",")}}`;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/pactile/validation.js.map

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

package/dist/core/task/adapter-middleware.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Stage 6 Adapter + Middleware compatibility facade.
+ *
+ * Pure helpers persisted through existing create extras / patch. Does not
+ * write Kernel store or task.json. Field names here are an implementation
+ * choice — not a frozen Manifest / Event ABI schema.
+ */
+export type { ProviderRuntimeReadinessV1, ProviderRuntimeFactV1, ProviderResolutionInputV1, ProviderCandidateRoleV1, ProviderCandidateExplainV1, ProviderExplainV1, ProviderResolutionResultV1, ProviderResolutionReasonCodeV1, } from "../pactile/middleware/resolver.js";
+export { PROVIDER_RESOLUTION_REASON_CODES_V1, resolveProviderV1, } from "../pactile/middleware/resolver.js";
+export declare const STAGE6_SOURCE = "stage6-adapter-middleware";
+export declare const STAGE6_SCHEMA_VERSION: 1;
+export declare const STAGE6_HOOK_EVENTS: readonly ["sessionStart", "preToolUse", "beforeSubmitPrompt", "beforeShellExecution", "afterShellExecution", "stop"];
+export type Stage6HookEvent = (typeof STAGE6_HOOK_EVENTS)[number];
+export declare const RETRIEVAL_INTENTS: readonly ["exact", "semantic", "structural", "external"];
+export type RetrievalIntent = (typeof RETRIEVAL_INTENTS)[number];
+export type MiddlewareProbeKind = "cli" | "mcp" | "host";
+export declare const SHIPPED_MIDDLEWARE_PROVIDERS: readonly [];
+/** @deprecated Provider identities are project-manifest data in Pactile v1. */
+export type ShippedMiddlewareProvider = string;
+/** Default `registered` catalog (Protocol v1 shipped table). */
+export declare const DEFAULT_MIDDLEWARE_PROVIDERS: readonly [];
+export declare const DEFAULT_REQUIRED_MIDDLEWARE_PROVIDERS: readonly [];
+export declare const OPTIONAL_CODE_INTEL_PROVIDERS: readonly [];
+/** @deprecated Compatibility alias; no concrete Provider is auto-registered. */
+export declare const SMART_SEARCH_PROVIDER = "legacy.external";
+export declare const EXTERNAL_KNOWLEDGE_CAPABILITY = "external-knowledge";
+export declare const SHIPPED_PROVIDER_CAPABILITY: Record<ShippedMiddlewareProvider, string>;
+export declare const SHIPPED_PROVIDER_PROBE: Record<ShippedMiddlewareProvider, MiddlewareProbeKind>;
+export type Stage6CommandPhase = "create" | "start" | "archive" | "patch";
+export type ProviderReadinessStatus = "ready" | "missing" | "failed" | "unknown";
+export interface EventSubscription {
+    event: string;
+    module: string;
+}
+export interface EventBridgeLastEvent {
+    event: string;
+    at: string;
+    source: string;
+    delivered: string[];
+    skipped: string[];
+}
+export interface EventBridgeState {
+    schema_version: typeof STAGE6_SCHEMA_VERSION;
+    source: typeof STAGE6_SOURCE;
+    subscriptions: EventSubscription[];
+    last_event?: EventBridgeLastEvent;
+}
+export interface ProviderReadiness {
+    status: ProviderReadinessStatus;
+    capability: string;
+    evidence?: string | null;
+}
+export interface MiddlewareProviders {
+    schema_version: typeof STAGE6_SCHEMA_VERSION;
+    source: typeof STAGE6_SOURCE;
+    registered: string[];
+    required: string[];
+    active: string[];
+    degraded: string[];
+    readiness: Record<string, ProviderReadiness>;
+}
+export interface CapabilityRouter {
+    schema_version: typeof STAGE6_SCHEMA_VERSION;
+    source: typeof STAGE6_SOURCE;
+    exact?: true;
+    semantic?: true;
+    structural?: true;
+    external?: true;
+}
+export interface DispatchHookEventInput {
+    event: string;
+    source?: string;
+    at?: string;
+}
+export declare function defaultEventBridge(): EventBridgeState;
+export declare function defaultMiddlewareProviders(): MiddlewareProviders;
+export declare function defaultCapabilityRouter(): CapabilityRouter;
+export declare function subscribeEvent(extras: Record<string, unknown>, event: string, moduleName: string): EventBridgeState;
+/**
+ * Record and dispatch one hook event. Unsubscribed modules are skipped and
+ * never fail the hook.
+ */
+export declare function recordHookEvent(extras: Record<string, unknown>, input: DispatchHookEventInput): EventBridgeLastEvent;
+export declare function shippedProviderCapability(id: string): string;
+export declare function shippedProviderProbeKind(id: string): MiddlewareProbeKind | null;
+export declare function classifyTransportProbe(input: {
+    kind?: MiddlewareProbeKind;
+    present?: boolean;
+    reachable?: boolean;
+    available?: boolean;
+    status?: ProviderReadinessStatus;
+    evidence?: string | null;
+}): Pick<ProviderReadiness, "status" | "evidence">;
+export declare function mcpServerIdsFromConfig(raw: unknown): string[];
+export declare function selectRegisteredMcpServers(configuredServerIds: readonly string[], registered?: readonly string[]): string[];
+export declare function probeShippedProviderReadiness(id: string, input?: {
+    present?: boolean;
+    reachable?: boolean;
+    available?: boolean;
+    status?: ProviderReadinessStatus;
+    evidence?: string | null;
+    capability?: string;
+}): ProviderReadiness;
+export declare function probeSmartSearchReadiness(input?: {
+    available?: boolean;
+    status?: ProviderReadinessStatus;
+    evidence?: string | null;
+}): ProviderReadiness;
+export declare function applyShippedProviderReadiness(extras: Record<string, unknown>, id: string, readiness: ProviderReadiness): MiddlewareProviders;
+export declare function applySmartSearchReadiness(extras: Record<string, unknown>, readiness: ProviderReadiness): MiddlewareProviders;
+export declare function normalizeEventBridge(raw: unknown): EventBridgeState;
+export declare function normalizeMiddlewareProviders(raw: unknown): MiddlewareProviders;
+export declare function normalizeCapabilityRouter(raw: unknown): CapabilityRouter;
+export declare function readEventBridge(extras: Record<string, unknown>): EventBridgeState;
+export declare function readMiddlewareProviders(extras: Record<string, unknown>): MiddlewareProviders;
+export declare function readCapabilityRouter(extras: Record<string, unknown>): CapabilityRouter;
+export declare function requiredCapabilities(extras: Record<string, unknown>): string[];
+export declare function externalKnowledgeReady(providers: MiddlewareProviders): boolean;
+export declare function normalizeStage6InExtras(extras: Record<string, unknown>): void;
+export declare function assertStage6ForPhase(extras: Record<string, unknown>, phase: Stage6CommandPhase): void;
+export declare function normalizeStage6InExtrasAndAssert(extras: Record<string, unknown>, phase: Stage6CommandPhase): void;
+//# sourceMappingURL=adapter-middleware.d.ts.map

package/dist/core/task/adapter-middleware.d.ts.map

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