@blxzer/pactile 0.5.0 → 0.6.0-beta.4

package/dist/constants/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,sCAAsC;AACtC,eAAO,MAAM,aAAa,iDAA6B,CAAC;AAExD,eAAO,MAAM,SAAS;IACpB,8BAA8B;;IAE9B,mEAAmE;;IAEnE,+DAA+D;;IAE/D,uCAAuC;;IAEvC,kDAAkD;;IAElD,mFAAmF;;IAEnF,0CAA0C;;IAE1C,8CAA8C;;IAE9C,+EAA+E;;IAE/E,sFAAsF;;CAE9E,CAAC;AAGX,eAAO,MAAM,UAAU;IACrB,mCAAmC;;IAEnC,8BAA8B;;IAE9B,2BAA2B;;IAE3B,oBAAoB;;IAEpB,4BAA4B;;IAE5B,qBAAqB;;IAErB,0BAA0B;;CAElB,CAAC;AAGX,eAAO,MAAM,KAAK;IAChB,gBAAgB;;IAEhB,0BAA0B;;IAE1B,sBAAsB;;IAEtB,qBAAqB;;IAErB,0BAA0B;;IAE1B,wBAAwB;;IAExB,qBAAqB;;IAErB,wEAAwE;;IAExE,mFAAmF;;IAEnF,0BAA0B;;IAE1B,6BAA6B;;IAE7B,2BAA2B;;CAEnB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAMzE"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/constants/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,sCAAsC;AACtC,eAAO,MAAM,aAAa,6CAA6B,CAAC;AAExD,eAAO,MAAM,SAAS;IACpB,8BAA8B;;IAE9B,mEAAmE;;IAEnE,+DAA+D;;IAE/D,uCAAuC;;IAEvC,kDAAkD;;IAElD,mFAAmF;;IAEnF,0CAA0C;;IAE1C,+EAA+E;;IAE/E,sFAAsF;;CAE9E,CAAC;AAGX,eAAO,MAAM,UAAU;IACrB,mCAAmC;;IAEnC,8BAA8B;;IAE9B,2BAA2B;;IAE3B,oBAAoB;;IAEpB,4BAA4B;;IAE5B,qBAAqB;;IAErB,0BAA0B;;CAElB,CAAC;AAGX,eAAO,MAAM,KAAK;IAChB,gBAAgB;;IAEhB,0BAA0B;;IAE1B,sBAAsB;;IAEtB,qBAAqB;;IAErB,0BAA0B;;IAE1B,wBAAwB;;IAExB,wEAAwE;;IAExE,mFAAmF;;IAEnF,0BAA0B;;IAE1B,6BAA6B;;IAE7B,2BAA2B;;CAEnB,CAAC;AAEX;;;GAGG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAMzE"}

package/dist/constants/paths.js

@@ -4,7 +4,7 @@
  * Change these values to rename directories across the entire project.
  * All paths should be relative to the project root.
  */
-import { DEFAULT_CANONICAL_PATHS_V1 } from "@blxzer/pactile-core";
+import { DEFAULT_CANONICAL_PATHS_V1 } from "../core/index.js";
 /** Canonical Pactile Runtime SSOT. */
 export const PACTILE_PATHS = DEFAULT_CANONICAL_PATHS_V1;
 export const DIR_NAMES = {
@@ -22,8 +22,6 @@ export const DIR_NAMES = {
     FRAMEWORK: "framework",
     /** Scripts directory (under .pactile/) */
     SCRIPTS: "scripts",
-    /** Review-pool directory (under .pactile/) */
-    POOL: "pool",
     /** Short-contract modules (under .pactile/) — index.json + <id>/contract.md */
     MODULES: "modules",
     /** User middleware overlay (under .pactile/) — never written/hashed by init/update */
@@ -60,8 +58,6 @@ export const PATHS = {
     FRAMEWORK: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.FRAMEWORK}`,
     /** .pactile/scripts/ */
     SCRIPTS: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.SCRIPTS}`,
-    /** .pactile/pool/ */
-    POOL: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.POOL}`,
     /** .pactile/modules/ — user-shipped short contracts (not catalog.ts) */
     MODULES: `${DIR_NAMES.WORKFLOW}/${DIR_NAMES.MODULES}`,
     /** .pactile/middleware/ — user overlay; update never writes, deletes, or hashes */

package/dist/constants/paths.js.map

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

package/dist/core/compat/environment.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Canonical Pactile environment access with a bounded 0.5.x legacy-read
+ * bridge.  Callers write only the canonical key; legacy values are never
+ * copied back into the process environment.
+ */
+export declare const PACTILE_ENVIRONMENT_KEYS: {
+    readonly debug: "PACTILE_DEBUG";
+    readonly allowHomeDirectory: "PACTILE_ALLOW_HOMEDIR";
+    readonly skipPythonCheck: "PACTILE_SKIP_PYTHON_CHECK";
+    readonly pythonCommand: "PACTILE_PYTHON_CMD";
+    readonly channelRoot: "PACTILE_CHANNEL_ROOT";
+    readonly channelProject: "PACTILE_CHANNEL_PROJECT";
+    readonly hooks: "PACTILE_HOOKS";
+    readonly channel: "PACTILE_CHANNEL";
+    readonly channelActor: "PACTILE_CHANNEL_AS";
+    readonly channelWorkerIdleTimeout: "PACTILE_CHANNEL_WORKER_IDLE_TIMEOUT";
+    readonly channelMaxLiveWorkers: "PACTILE_CHANNEL_MAX_LIVE_WORKERS";
+    readonly kernelCli: "PACTILE_KERNEL_CLI";
+};
+export type PactileEnvironmentKey = (typeof PACTILE_ENVIRONMENT_KEYS)[keyof typeof PACTILE_ENVIRONMENT_KEYS];
+export interface PactileEnvironmentDiagnostic {
+    readonly code: "legacy-environment-read";
+    readonly canonicalKey: PactileEnvironmentKey;
+    readonly legacyKey: string;
+    readonly compatibilityWindow: "0.5.x";
+}
+export interface ReadPactileEnvironmentOptions {
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly report?: (diagnostic: PactileEnvironmentDiagnostic) => void;
+    readonly warnOnce?: boolean;
+}
+/**
+ * Read one public Pactile environment value. Canonical always wins. A legacy
+ * fallback reports key names only, never the value, and warns once per process
+ * by default.
+ */
+export declare function readPactileEnvironment(key: PactileEnvironmentKey, options?: ReadPactileEnvironmentOptions): string | undefined;
+/** Write only the canonical key. This intentionally never mirrors aliases. */
+export declare function writePactileEnvironment(key: PactileEnvironmentKey, value: string, env?: Record<string, string | undefined>): void;
+/** Test-only hook for deterministic once-per-process diagnostic assertions. */
+export declare function resetPactileEnvironmentWarningsForTest(): void;
+//# sourceMappingURL=environment.d.ts.map

package/dist/core/compat/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/core/compat/environment.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;CAa3B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAC/B,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAC;AA0B3E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,4BAA4B,KAAK,IAAI,CAAC;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAUD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,qBAAqB,EAC1B,OAAO,GAAE,6BAAkC,GAC1C,MAAM,GAAG,SAAS,CAoBpB;AAED,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,qBAAqB,EAC1B,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,IAAI,CAEN;AAED,+EAA+E;AAC/E,wBAAgB,sCAAsC,IAAI,IAAI,CAE7D"}

package/dist/core/compat/environment.js

@@ -0,0 +1,83 @@
+/**
+ * Canonical Pactile environment access with a bounded 0.5.x legacy-read
+ * bridge.  Callers write only the canonical key; legacy values are never
+ * copied back into the process environment.
+ */
+export const PACTILE_ENVIRONMENT_KEYS = {
+    debug: "PACTILE_DEBUG",
+    allowHomeDirectory: "PACTILE_ALLOW_HOMEDIR",
+    skipPythonCheck: "PACTILE_SKIP_PYTHON_CHECK",
+    pythonCommand: "PACTILE_PYTHON_CMD",
+    channelRoot: "PACTILE_CHANNEL_ROOT",
+    channelProject: "PACTILE_CHANNEL_PROJECT",
+    hooks: "PACTILE_HOOKS",
+    channel: "PACTILE_CHANNEL",
+    channelActor: "PACTILE_CHANNEL_AS",
+    channelWorkerIdleTimeout: "PACTILE_CHANNEL_WORKER_IDLE_TIMEOUT",
+    channelMaxLiveWorkers: "PACTILE_CHANNEL_MAX_LIVE_WORKERS",
+    kernelCli: "PACTILE_KERNEL_CLI",
+};
+const LEGACY_ENVIRONMENT_KEYS = {
+    PACTILE_DEBUG: ["CSTL_DEBUG", "TRELLIS_DEBUG"],
+    PACTILE_ALLOW_HOMEDIR: ["CSTL_ALLOW_HOMEDIR", "TRELLIS_ALLOW_HOMEDIR"],
+    PACTILE_SKIP_PYTHON_CHECK: [
+        "CSTL_SKIP_PYTHON_CHECK",
+        "TRELLIS_SKIP_PYTHON_CHECK",
+    ],
+    PACTILE_PYTHON_CMD: ["CSTL_PYTHON_CMD", "TRELLIS_PYTHON_CMD"],
+    PACTILE_CHANNEL_ROOT: ["CSTL_CHANNEL_ROOT", "TRELLIS_CHANNEL_ROOT"],
+    PACTILE_CHANNEL_PROJECT: ["CSTL_CHANNEL_PROJECT", "TRELLIS_CHANNEL_PROJECT"],
+    PACTILE_HOOKS: ["CSTL_HOOKS", "TRELLIS_HOOKS"],
+    PACTILE_CHANNEL: ["CSTL_CHANNEL", "TRELLIS_CHANNEL"],
+    PACTILE_CHANNEL_AS: ["CSTL_CHANNEL_AS", "TRELLIS_CHANNEL_AS"],
+    PACTILE_CHANNEL_WORKER_IDLE_TIMEOUT: [
+        "CSTL_CHANNEL_WORKER_IDLE_TIMEOUT",
+        "TRELLIS_CHANNEL_WORKER_IDLE_TIMEOUT",
+    ],
+    PACTILE_CHANNEL_MAX_LIVE_WORKERS: [
+        "CSTL_CHANNEL_MAX_LIVE_WORKERS",
+        "TRELLIS_CHANNEL_MAX_LIVE_WORKERS",
+    ],
+    PACTILE_KERNEL_CLI: ["CSTL_KERNEL_CLI", "TRELLIS_KERNEL_CLI"],
+};
+const warnedLegacyKeys = new Set();
+function defaultReporter(diagnostic) {
+    process.stderr.write(`[pactile compatibility] ${diagnostic.legacyKey} is deprecated; use ${diagnostic.canonicalKey}. Legacy reads end no earlier than 0.6.0.\n`);
+}
+/**
+ * Read one public Pactile environment value. Canonical always wins. A legacy
+ * fallback reports key names only, never the value, and warns once per process
+ * by default.
+ */
+export function readPactileEnvironment(key, options = {}) {
+    const env = options.env ?? process.env;
+    const canonical = env[key];
+    if (canonical !== undefined)
+        return canonical;
+    for (const legacyKey of LEGACY_ENVIRONMENT_KEYS[key]) {
+        const legacy = env[legacyKey];
+        if (legacy === undefined)
+            continue;
+        if (options.warnOnce === false || !warnedLegacyKeys.has(legacyKey)) {
+            (options.report ?? defaultReporter)({
+                code: "legacy-environment-read",
+                canonicalKey: key,
+                legacyKey,
+                compatibilityWindow: "0.5.x",
+            });
+            if (options.warnOnce !== false)
+                warnedLegacyKeys.add(legacyKey);
+        }
+        return legacy;
+    }
+    return undefined;
+}
+/** Write only the canonical key. This intentionally never mirrors aliases. */
+export function writePactileEnvironment(key, value, env = process.env) {
+    env[key] = value;
+}
+/** Test-only hook for deterministic once-per-process diagnostic assertions. */
+export function resetPactileEnvironmentWarningsForTest() {
+    warnedLegacyKeys.clear();
+}
+//# sourceMappingURL=environment.js.map

package/dist/core/compat/environment.js.map

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

package/dist/core/compat/index.d.ts

@@ -0,0 +1,2 @@
+export { PACTILE_ENVIRONMENT_KEYS, readPactileEnvironment, resetPactileEnvironmentWarningsForTest, writePactileEnvironment, type PactileEnvironmentDiagnostic, type PactileEnvironmentKey, type ReadPactileEnvironmentOptions, } from "./environment.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/compat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/compat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,sCAAsC,EACtC,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC"}

package/dist/core/compat/index.js

@@ -0,0 +1,2 @@
+export { PACTILE_ENVIRONMENT_KEYS, readPactileEnvironment, resetPactileEnvironmentWarningsForTest, writePactileEnvironment, } from "./environment.js";
+//# sourceMappingURL=index.js.map

package/dist/core/compat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/compat/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,sCAAsC,EACtC,uBAAuB,GAIxB,MAAM,kBAAkB,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./task/index.js";
+export * from "./pactile/index.js";
+export * from "./compat/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAGA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,6 @@
+// Core contract API ships inside the single @blxzer/pactile package.
+// External callers can use @blxzer/pactile/core or its task subpath.
+export * from "./task/index.js";
+export * from "./pactile/index.js";
+export * from "./compat/index.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qEAAqE;AAErE,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/core/pactile/bounded-capabilities.d.ts

@@ -0,0 +1,127 @@
+import { type PactileContractIssueV1, type PactileContractParseResultV1 } from "./validation.js";
+export declare const BOUNDED_CAPABILITY_SCHEMA_VERSION_V1: 1;
+export declare const BOUNDED_CAPABILITY_OPERATIONS_V1: readonly ["discover", "read", "search", "run"];
+export type BoundedCapabilityOperationV1 = (typeof BOUNDED_CAPABILITY_OPERATIONS_V1)[number];
+export declare const BOUNDED_CAPABILITY_OUTCOMES_V1: readonly ["complete", "empty", "partial", "out_of_scope", "timed_out", "cancelled", "failed"];
+export type BoundedCapabilityOutcomeV1 = (typeof BOUNDED_CAPABILITY_OUTCOMES_V1)[number];
+export declare const BOUNDED_CAPABILITY_ERROR_CODES_V1: readonly ["OUT_OF_SCOPE", "NOT_FOUND", "PERMISSION_DENIED", "TIMEOUT", "CANCELLED", "OUTPUT_LIMIT", "SCAN_LIMIT", "FILE_TOO_LARGE", "EXECUTION_FAILED", "ADAPTER_UNAVAILABLE", "REQUEST_ID_REUSED", "REQUEST_CLAIM_RETAINED", "REQUEST_CLAIM_LIMIT", "RECEIPT_UNAVAILABLE"];
+export type BoundedCapabilityErrorCodeV1 = (typeof BOUNDED_CAPABILITY_ERROR_CODES_V1)[number];
+export interface BoundedCapabilityLimitsV1 {
+    readonly timeoutMs: number;
+    readonly maxOutputBytes: number;
+    readonly maxFilesScanned: number;
+    readonly maxResults: number;
+    readonly maxFileBytes: number;
+    readonly maxBytesRead: number;
+}
+interface BoundedCapabilityRequestBaseV1 {
+    readonly schemaVersion: typeof BOUNDED_CAPABILITY_SCHEMA_VERSION_V1;
+    readonly requestId: string;
+    readonly limits: BoundedCapabilityLimitsV1;
+}
+export interface DiscoverCapabilityRequestV1 extends BoundedCapabilityRequestBaseV1 {
+    readonly operation: "discover";
+    readonly directory: string | null;
+    /** Zero-based page offset from the adapter's stable path ordering. */
+    readonly offset: number;
+}
+export interface ReadCapabilityRequestV1 extends BoundedCapabilityRequestBaseV1 {
+    readonly operation: "read";
+    readonly path: string;
+}
+export interface SearchCapabilityRequestV1 extends BoundedCapabilityRequestBaseV1 {
+    readonly operation: "search";
+    readonly query: string;
+    readonly directory: string | null;
+    readonly caseSensitive: boolean;
+    /** Zero-based match offset; continue with the prior result's nextPage. */
+    readonly offset: number;
+}
+export interface RunCapabilityRequestV1 extends BoundedCapabilityRequestBaseV1 {
+    readonly operation: "run";
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly cwd: string | null;
+}
+export type BoundedCapabilityRequestV1 = DiscoverCapabilityRequestV1 | ReadCapabilityRequestV1 | SearchCapabilityRequestV1 | RunCapabilityRequestV1;
+export interface BoundedCapabilityPolicyV1 {
+    readonly allowedOperations: readonly BoundedCapabilityOperationV1[];
+    readonly allowedCommands: readonly string[];
+}
+export interface CapabilityPolicyDecisionV1 {
+    readonly allowed: boolean;
+    readonly code: "OUT_OF_SCOPE" | null;
+    readonly message: string | null;
+}
+export interface BoundedCapabilityFailureV1 {
+    readonly code: BoundedCapabilityErrorCodeV1;
+    readonly message: string;
+}
+export interface DiscoverCapabilityDataV1 {
+    readonly files: readonly string[];
+    readonly entriesScanned: number;
+}
+export interface ReadCapabilityDataV1 {
+    readonly path: string;
+    readonly content: string;
+    readonly bytesRead: number;
+    readonly totalBytes: number;
+    readonly truncated: boolean;
+}
+export interface SearchCapabilityMatchV1 {
+    readonly path: string;
+    readonly line: number;
+    readonly preview: string;
+}
+export interface SearchCapabilityDataV1 {
+    readonly matches: readonly SearchCapabilityMatchV1[];
+    readonly filesScanned: number;
+    readonly bytesRead: number;
+}
+export interface RunCapabilityDataV1 {
+    readonly command: string;
+    readonly exitCode: number | null;
+    readonly signal: string | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly bytesCaptured: number;
+    readonly truncated: boolean;
+}
+export type BoundedCapabilityDataV1 = DiscoverCapabilityDataV1 | ReadCapabilityDataV1 | SearchCapabilityDataV1 | RunCapabilityDataV1;
+export interface BoundedCapabilityReceiptV1 {
+    readonly schemaVersion: typeof BOUNDED_CAPABILITY_SCHEMA_VERSION_V1;
+    readonly requestId: string;
+    readonly operation: BoundedCapabilityOperationV1;
+    readonly adapterId: string;
+    readonly requestFingerprint: string;
+    readonly resultFingerprint: string | null;
+    readonly outcome: BoundedCapabilityOutcomeV1;
+    readonly errorCode: BoundedCapabilityErrorCodeV1 | null;
+    readonly entriesReturned: number;
+    readonly bytesReturned: number;
+    readonly startedAt: string;
+    readonly completedAt: string;
+    readonly durationMs: number;
+    readonly receiptRef: string;
+}
+export interface BoundedCapabilityResultV1 {
+    readonly schemaVersion: typeof BOUNDED_CAPABILITY_SCHEMA_VERSION_V1;
+    readonly requestId: string;
+    readonly operation: BoundedCapabilityOperationV1;
+    readonly outcome: BoundedCapabilityOutcomeV1;
+    readonly partial: boolean;
+    /** Offset for the next discover/search page, or null when exhausted. */
+    readonly nextPage: number | null;
+    readonly data: BoundedCapabilityDataV1 | null;
+    readonly error: BoundedCapabilityFailureV1 | null;
+    readonly receipt: BoundedCapabilityReceiptV1 | null;
+}
+export declare class BoundedCapabilityRequestValidationError extends Error {
+    readonly issues: readonly PactileContractIssueV1[];
+    constructor(issues: readonly PactileContractIssueV1[]);
+}
+export declare const boundedCapabilityRequestV1Schema: import("./validation.js").PactileContractSchemaV1<BoundedCapabilityRequestV1>;
+export declare function parseBoundedCapabilityRequestV1(input: unknown): PactileContractParseResultV1<BoundedCapabilityRequestV1>;
+export declare function authorizeBoundedCapabilityRequestV1(request: BoundedCapabilityRequestV1, policy: BoundedCapabilityPolicyV1): CapabilityPolicyDecisionV1;
+export {};
+//# sourceMappingURL=bounded-capabilities.d.ts.map

package/dist/core/pactile/bounded-capabilities.d.ts.map

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

package/dist/core/pactile/bounded-capabilities.js

@@ -0,0 +1,188 @@
+import { childPathV1, decodeSchemaVersionV1, decodeRelativePosixPathV1, definePactileContractSchemaV1, isPlainRecordV1, } from "./validation.js";
+export const BOUNDED_CAPABILITY_SCHEMA_VERSION_V1 = 1;
+export const BOUNDED_CAPABILITY_OPERATIONS_V1 = [
+    "discover",
+    "read",
+    "search",
+    "run",
+];
+export const BOUNDED_CAPABILITY_OUTCOMES_V1 = [
+    "complete",
+    "empty",
+    "partial",
+    "out_of_scope",
+    "timed_out",
+    "cancelled",
+    "failed",
+];
+export const BOUNDED_CAPABILITY_ERROR_CODES_V1 = [
+    "OUT_OF_SCOPE",
+    "NOT_FOUND",
+    "PERMISSION_DENIED",
+    "TIMEOUT",
+    "CANCELLED",
+    "OUTPUT_LIMIT",
+    "SCAN_LIMIT",
+    "FILE_TOO_LARGE",
+    "EXECUTION_FAILED",
+    "ADAPTER_UNAVAILABLE",
+    "REQUEST_ID_REUSED",
+    "REQUEST_CLAIM_RETAINED",
+    "REQUEST_CLAIM_LIMIT",
+    "RECEIPT_UNAVAILABLE",
+];
+export class BoundedCapabilityRequestValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super("PACTILE_BOUNDED_CAPABILITY_REQUEST_INVALID");
+        this.name = "BoundedCapabilityRequestValidationError";
+        this.issues = issues;
+    }
+}
+const REQUEST_ID = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
+const COMMAND_ID = /^[A-Za-z0-9][A-Za-z0-9._+-]{0,63}$/;
+const MAX_QUERY_BYTES = 4096;
+const WINDOWS_RESERVED_FILE_NAME = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])(?:\..*)?$/iu;
+function decodeLimits(value, decoder, path) {
+    const record = decoder.object(value, path, [
+        "timeoutMs",
+        "maxOutputBytes",
+        "maxFilesScanned",
+        "maxResults",
+        "maxFileBytes",
+        "maxBytesRead",
+    ]);
+    return {
+        timeoutMs: decoder.integer(decoder.required(record, "timeoutMs", path), childPathV1(path, "timeoutMs"), { min: 1, max: 120_000 }),
+        maxOutputBytes: decoder.integer(decoder.required(record, "maxOutputBytes", path), childPathV1(path, "maxOutputBytes"), { min: 2_048, max: 1_048_576 }),
+        maxFilesScanned: decoder.integer(decoder.required(record, "maxFilesScanned", path), childPathV1(path, "maxFilesScanned"), { min: 1, max: 10_000 }),
+        maxResults: decoder.integer(decoder.required(record, "maxResults", path), childPathV1(path, "maxResults"), { min: 1, max: 1_000 }),
+        maxFileBytes: decoder.integer(decoder.required(record, "maxFileBytes", path), childPathV1(path, "maxFileBytes"), { min: 1, max: 1_048_576 }),
+        maxBytesRead: decoder.integer(decoder.required(record, "maxBytesRead", path), childPathV1(path, "maxBytesRead"), { min: 1, max: 33_554_432 }),
+    };
+}
+function decodeOptionalPath(record, key, decoder, path) {
+    const value = decoder.optional(record, key);
+    if (value === undefined || value === null)
+        return null;
+    return decodeWorkspacePath(value, decoder, childPathV1(path, key));
+}
+function decodePageOffset(record, decoder, path) {
+    return decoder.integer(decoder.optional(record, "offset") ?? 0, childPathV1(path, "offset"), { min: 0, max: 1_000_000 });
+}
+function decodeWorkspacePath(value, decoder, path) {
+    const relative = decodeRelativePosixPathV1(value, decoder, path);
+    if (!relative)
+        return relative;
+    const segments = relative.split("/");
+    if (segments.some((segment) => segment.includes(":") ||
+        segment.endsWith(".") ||
+        WINDOWS_RESERVED_FILE_NAME.test(segment.replace(/[ .]+$/u, "")))) {
+        decoder.issue("invalid-value", path, "must not contain Windows alternate streams or reserved device names");
+    }
+    return relative;
+}
+function decodeBoundedCapabilityRequestV1(input, decoder, path) {
+    const operation = decoder.enumValue(isPlainRecordV1(input) ? input.operation : undefined, BOUNDED_CAPABILITY_OPERATIONS_V1, childPathV1(path, "operation"));
+    const fields = {
+        discover: ["directory", "offset"],
+        read: ["path"],
+        search: ["query", "directory", "caseSensitive", "offset"],
+        run: ["command", "args", "cwd"],
+    };
+    const record = decoder.object(input, path, [
+        "schemaVersion",
+        "requestId",
+        "operation",
+        "limits",
+        ...(fields[operation] ?? []),
+    ]);
+    const requestId = decoder.string(decoder.required(record, "requestId", path), childPathV1(path, "requestId"), {
+        nonEmpty: true,
+        pattern: REQUEST_ID,
+        patternDescription: "a safe request id",
+    });
+    if (WINDOWS_RESERVED_FILE_NAME.test(requestId) || requestId.endsWith(".")) {
+        decoder.issue("invalid-value", childPathV1(path, "requestId"), "must be safe as a receipt filename on Windows");
+    }
+    const base = {
+        schemaVersion: decodeSchemaVersionV1(record, decoder, path),
+        requestId,
+        limits: decodeLimits(decoder.required(record, "limits", path), decoder, childPathV1(path, "limits")),
+    };
+    switch (operation) {
+        case "discover":
+            return {
+                ...base,
+                operation,
+                directory: decodeOptionalPath(record, "directory", decoder, path),
+                offset: decodePageOffset(record, decoder, path),
+            };
+        case "read":
+            return {
+                ...base,
+                operation,
+                path: decodeWorkspacePath(decoder.required(record, "path", path), decoder, childPathV1(path, "path")),
+            };
+        case "search": {
+            const query = decoder.string(decoder.required(record, "query", path), childPathV1(path, "query"), { nonEmpty: true });
+            if (Buffer.byteLength(query, "utf8") > MAX_QUERY_BYTES) {
+                decoder.issue("invalid-value", childPathV1(path, "query"), `must be at most ${MAX_QUERY_BYTES} UTF-8 bytes`);
+            }
+            return {
+                ...base,
+                operation,
+                query,
+                directory: decodeOptionalPath(record, "directory", decoder, path),
+                offset: decodePageOffset(record, decoder, path),
+                caseSensitive: decoder.boolean(decoder.required(record, "caseSensitive", path), childPathV1(path, "caseSensitive")),
+            };
+        }
+        case "run": {
+            const args = decoder.stringArray(decoder.required(record, "args", path), childPathV1(path, "args"));
+            if (args.length > 64)
+                decoder.issue("invalid-value", childPathV1(path, "args"), "must contain at most 64 arguments");
+            if (args.some((arg) => arg.includes("\0") || Buffer.byteLength(arg, "utf8") > 4096)) {
+                decoder.issue("invalid-value", childPathV1(path, "args"), "arguments must be NUL-free and at most 4096 UTF-8 bytes each");
+            }
+            if (args.reduce((total, arg) => total + Buffer.byteLength(arg, "utf8"), 0) >
+                16_384) {
+                decoder.issue("invalid-value", childPathV1(path, "args"), "combined argument data must be at most 16384 UTF-8 bytes");
+            }
+            return {
+                ...base,
+                operation,
+                command: decoder.string(decoder.required(record, "command", path), childPathV1(path, "command"), {
+                    nonEmpty: true,
+                    pattern: COMMAND_ID,
+                    patternDescription: "a command id, not a path or shell expression",
+                }),
+                args,
+                cwd: decodeOptionalPath(record, "cwd", decoder, path),
+            };
+        }
+    }
+}
+export const boundedCapabilityRequestV1Schema = definePactileContractSchemaV1("bounded-capability-request", decodeBoundedCapabilityRequestV1);
+export function parseBoundedCapabilityRequestV1(input) {
+    return boundedCapabilityRequestV1Schema.parse(input);
+}
+export function authorizeBoundedCapabilityRequestV1(request, policy) {
+    if (!policy.allowedOperations.includes(request.operation)) {
+        return {
+            allowed: false,
+            code: "OUT_OF_SCOPE",
+            message: "The requested capability is outside the caller policy.",
+        };
+    }
+    if (request.operation === "run" &&
+        !policy.allowedCommands.includes(request.command)) {
+        return {
+            allowed: false,
+            code: "OUT_OF_SCOPE",
+            message: "The requested command is outside the caller allowlist.",
+        };
+    }
+    return { allowed: true, code: null, message: null };
+}
+//# sourceMappingURL=bounded-capabilities.js.map

package/dist/core/pactile/bounded-capabilities.js.map

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

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

@@ -0,0 +1,65 @@
+import { type PactileIntentV1 } from "./provider.js";
+import { PACTILE_CONTRACT_SCHEMA_VERSION, type PactileContractParseResultV1 } from "./validation.js";
+export declare const INSTALL_HINT_MECHANISMS_V1: readonly ["host-native", "package-manager", "manual"];
+export type InstallHintMechanismV1 = (typeof INSTALL_HINT_MECHANISMS_V1)[number];
+export interface InstallHintV1 {
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    readonly mechanism: InstallHintMechanismV1;
+    /** Symbolic localization key, never user-authored prose or credential data. */
+    readonly label: string;
+    /** Optional non-network logical reference; never a credential-bearing URL. */
+    readonly reference: string | null;
+    readonly requiresAuthentication: boolean;
+}
+export declare const EXTERNAL_ASSET_KINDS_V1: readonly ["skill", "mcp", "plugin", "executable", "service"];
+export type ExternalAssetKindV1 = (typeof EXTERNAL_ASSET_KINDS_V1)[number];
+export declare const EXTERNAL_ASSET_SOURCES_V1: readonly ["host-native", "user-installed", "pactile-bundled", "project-vendored"];
+export type ExternalAssetSourceV1 = (typeof EXTERNAL_ASSET_SOURCES_V1)[number];
+export declare const EXTERNAL_ASSET_SCOPES_V1: readonly ["project", "user", "host"];
+export type ExternalAssetScopeV1 = (typeof EXTERNAL_ASSET_SCOPES_V1)[number];
+export declare const EXTERNAL_ASSET_OWNER_KINDS_V1: readonly ["user", "host", "pactile", "third-party"];
+export type ExternalAssetOwnerKindV1 = (typeof EXTERNAL_ASSET_OWNER_KINDS_V1)[number];
+export interface ExternalAssetOwnerV1 {
+    readonly kind: ExternalAssetOwnerKindV1;
+    readonly id: string | null;
+}
+export declare const CAPABILITY_READINESS_V1: readonly ["ready", "degraded", "missing", "unknown"];
+export type CapabilityReadinessV1 = (typeof CAPABILITY_READINESS_V1)[number];
+export interface ExternalAssetRefV1 {
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    readonly id: string;
+    readonly kind: ExternalAssetKindV1;
+    readonly source: ExternalAssetSourceV1;
+    readonly scope: ExternalAssetScopeV1;
+    readonly owner: ExternalAssetOwnerV1;
+    /** Source-scoped logical locator. It is never a URL or copied asset content. */
+    readonly locator: string;
+    readonly fingerprint: string | null;
+    readonly readiness: CapabilityReadinessV1;
+    readonly installHint: InstallHintV1 | null;
+}
+export declare const CAPABILITY_BINDING_MODES_V1: readonly ["native", "adopted", "composed"];
+export type CapabilityBindingModeV1 = (typeof CAPABILITY_BINDING_MODES_V1)[number];
+export declare const CAPABILITY_CONTROL_V1: readonly ["borrowed", "pactile-owned"];
+export type CapabilityControlV1 = (typeof CAPABILITY_CONTROL_V1)[number];
+export declare const CAPABILITY_DELETE_BOUNDARIES_V1: readonly ["preserve", "remove-when-unclaimed"];
+export type CapabilityDeleteBoundaryV1 = (typeof CAPABILITY_DELETE_BOUNDARIES_V1)[number];
+export interface CapabilityBindingV1 {
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    readonly id: string;
+    readonly capabilityId: string;
+    readonly mode: CapabilityBindingModeV1;
+    readonly control: CapabilityControlV1;
+    readonly deleteBoundary: CapabilityDeleteBoundaryV1;
+    readonly asset: ExternalAssetRefV1;
+    readonly intents: readonly PactileIntentV1[];
+    /** MCP and other middleware-backed assets bind through a logical Provider. */
+    readonly providerId: string | null;
+}
+export declare const installHintV1Schema: import("./validation.js").PactileContractSchemaV1<InstallHintV1>;
+export declare const externalAssetRefV1Schema: import("./validation.js").PactileContractSchemaV1<ExternalAssetRefV1>;
+export declare const capabilityBindingV1Schema: import("./validation.js").PactileContractSchemaV1<CapabilityBindingV1>;
+export declare function parseInstallHintV1(input: unknown): PactileContractParseResultV1<InstallHintV1>;
+export declare function parseExternalAssetRefV1(input: unknown): PactileContractParseResultV1<ExternalAssetRefV1>;
+export declare function parseCapabilityBindingV1(input: unknown): PactileContractParseResultV1<CapabilityBindingV1>;
+//# sourceMappingURL=capability.d.ts.map