@devflow-tools/provider-runtime 0.18.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 shilongfeicool
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @devflow-tools/provider-runtime
+
+Shared execution boundary for optional semantic, Memory, Knowledge, embedding, and reranking providers.
+
+## Install
+
+```bash
+npm install @devflow-tools/provider-runtime
+```
+
+The runtime preserves `ready`, `empty_valid`, `invalid`, `unavailable`, `timeout`, and `cancelled` as distinct outcomes. It applies bounded timeouts, abort propagation, reentrancy protection, cooldown after provider failures, validation before receipt finalization, and privacy-safe execution receipts.
+
+This package owns no task semantics, lifecycle transitions, retrieval eligibility, action authorization, persistence, or terminal decisions. Providers return untrusted values; the owning domain validates and compiles them.
+
+```ts
+import { ProviderExecutionEnvelope } from '@devflow-tools/provider-runtime';
+
+const envelope = new ProviderExecutionEnvelope();
+const result = await envelope.run({
+  requestHash: 'sha256:request',
+  providerId: 'host-sampling',
+  providerVersion: '1',
+  capability: 'semantic_claims',
+  scopeKey: 'project/session/turn',
+  timeoutMs: 3_000,
+  execute: async signal => {
+    const proposals = await provider.sample(signal);
+    return {
+      status: proposals.length > 0 ? 'ready' : 'empty_valid',
+      value: proposals,
+      proposalCount: proposals.length,
+    };
+  },
+});
+```

package/dist/__tests__/embedding-response-validator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedding-response-validator.test.d.ts.map

package/dist/__tests__/embedding-response-validator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-response-validator.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/embedding-response-validator.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/embedding-response-validator.test.js

@@ -0,0 +1,50 @@
+import { describe, expect, it } from 'vitest';
+import { validateEmbeddingBatch } from '../embedding-response-validator.js';
+describe('validateEmbeddingBatch', () => {
+    it('orders indexed responses and validates profile, count and vectors', () => {
+        const vectors = validateEmbeddingBatch({
+            response: [
+                { index: 1, vector: new Float32Array([0, 1]) },
+                { index: 0, vector: new Float32Array([1, 0]) },
+            ],
+            expectedCount: 2, expectedDimension: 2,
+            expectedProfileHash: 'profile:1', responseProfileHash: 'profile:1',
+        });
+        expect(vectors.map(vector => [...vector])).toEqual([[1, 0], [0, 1]]);
+        expect(() => validateEmbeddingBatch({
+            response: [new Float32Array([1, 0])], expectedCount: 2, expectedDimension: 2,
+        })).toThrow('embedding_batch_count_mismatch');
+        expect(() => validateEmbeddingBatch({
+            response: [{ index: 0, vector: new Float32Array([1, 0]) }, { index: 0, vector: new Float32Array([0, 1]) }],
+            expectedCount: 2, expectedDimension: 2,
+        })).toThrow('embedding_batch_index_duplicate');
+        expect(() => validateEmbeddingBatch({
+            response: [new Float32Array([1, Number.NaN])], expectedCount: 1, expectedDimension: 2,
+        })).toThrow('embedding_vector_non_finite');
+        expect(() => validateEmbeddingBatch({
+            response: [new Float32Array([1])], expectedCount: 1, expectedDimension: 2,
+        })).toThrow('embedding_vector_dimension_mismatch');
+        expect(() => validateEmbeddingBatch({
+            response: [], expectedCount: 0, expectedDimension: 2,
+            expectedProfileHash: 'profile:1', responseProfileHash: 'profile:2',
+        })).toThrow('embedding_profile_mismatch');
+    });
+    it('rejects incomplete indexes and empty vectors with stable codes', () => {
+        expect(() => validateEmbeddingBatch({
+            response: [{ index: 0, vector: new Float32Array([1, 0]) }],
+            expectedCount: 2,
+            expectedDimension: 2,
+        })).toThrow('embedding_batch_index_missing');
+        expect(() => validateEmbeddingBatch({
+            response: [{ index: 2, vector: new Float32Array([1, 0]) }],
+            expectedCount: 1,
+            expectedDimension: 2,
+        })).toThrow('embedding_batch_index_invalid');
+        expect(() => validateEmbeddingBatch({
+            response: [new Float32Array()],
+            expectedCount: 1,
+            expectedDimension: 2,
+        })).toThrow('embedding_vector_empty');
+    });
+});
+//# sourceMappingURL=embedding-response-validator.test.js.map

package/dist/__tests__/embedding-response-validator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-response-validator.test.js","sourceRoot":"","sources":["../../src/__tests__/embedding-response-validator.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/provider-execution-envelope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider-execution-envelope.test.d.ts.map

package/dist/__tests__/provider-execution-envelope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-execution-envelope.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/provider-execution-envelope.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/provider-execution-envelope.test.js

@@ -0,0 +1,93 @@
+import { describe, expect, it, vi } from 'vitest';
+import { ProviderExecutionEnvelope, } from '../provider-execution-envelope.js';
+const base = {
+    requestHash: 'request-hash',
+    providerId: 'test-provider',
+    providerVersion: '1',
+    capability: 'semantic_claims',
+    scopeKey: 'project/session/turn',
+    timeoutMs: 100,
+};
+describe('ProviderExecutionEnvelope', () => {
+    it('finalizes a validated ready receipt', async () => {
+        const result = await new ProviderExecutionEnvelope().run({
+            ...base,
+            execute: async () => ({ status: 'ready', value: ['one', 'two'], proposalCount: 2 }),
+            validate: value => ({ value: value.slice(0, 1), acceptedCount: 1, rejectedCount: 1,
+                reasonCodes: ['claim_rejected'] }),
+        });
+        expect(result.status).toBe('ready');
+        expect(result.value).toEqual(['one']);
+        expect(result.receipt).toMatchObject({ proposalCount: 2, acceptedCount: 1, rejectedCount: 1,
+            reasonCodes: ['claim_rejected'] });
+    });
+    it('preserves a valid empty result', async () => {
+        const result = await new ProviderExecutionEnvelope().run({
+            ...base,
+            execute: async () => ({ status: 'empty_valid', value: [], proposalCount: 0 }),
+        });
+        expect(result.status).toBe('empty_valid');
+        expect(result.receipt).toMatchObject({ proposalCount: 0, acceptedCount: 0, rejectedCount: 0 });
+    });
+    it('aborts and records a timeout', async () => {
+        let aborted = false;
+        const result = await new ProviderExecutionEnvelope({ cooldownMs: 1 }).run({
+            ...base,
+            timeoutMs: 10,
+            execute: signal => new Promise(resolve => {
+                signal.addEventListener('abort', () => {
+                    aborted = true;
+                    resolve({ status: 'unavailable', proposalCount: 0 });
+                }, { once: true });
+            }),
+        });
+        expect(result.status).toBe('timeout');
+        expect(result.receipt.reasonCodes).toEqual(['provider_timeout']);
+        expect(aborted).toBe(true);
+    });
+    it('rejects a concurrent execution for the same capability and scope', async () => {
+        let release;
+        const envelope = new ProviderExecutionEnvelope();
+        const first = envelope.run({
+            ...base,
+            execute: () => new Promise(resolve => {
+                release = () => resolve({ status: 'empty_valid', proposalCount: 0 });
+            }),
+        });
+        await Promise.resolve();
+        const second = await envelope.run({
+            ...base,
+            execute: async () => ({ status: 'empty_valid', proposalCount: 0 }),
+        });
+        expect(second.status).toBe('unavailable');
+        expect(second.receipt.reasonCodes).toEqual(['provider_reentrant']);
+        release();
+        await first;
+    });
+    it('opens a bounded cooldown after provider unavailability', async () => {
+        const envelope = new ProviderExecutionEnvelope({ cooldownMs: 10_000 });
+        const first = await envelope.run({
+            ...base,
+            execute: async () => ({ status: 'unavailable', proposalCount: 0,
+                reasonCodes: ['host_unavailable'] }),
+        });
+        const execute = vi.fn(async () => ({ status: 'empty_valid', proposalCount: 0 }));
+        const second = await envelope.run({ ...base, execute });
+        expect(first.status).toBe('unavailable');
+        expect(second.status).toBe('unavailable');
+        expect(second.receipt.reasonCodes).toEqual(['provider_unavailable_cooldown']);
+        expect(execute).not.toHaveBeenCalled();
+    });
+    it('does not let observer failure alter the provider result', async () => {
+        const envelope = new ProviderExecutionEnvelope({ observer: { record: () => {
+                    throw new Error('sink unavailable');
+                } } });
+        const result = await envelope.run({
+            ...base,
+            execute: async () => ({ status: 'ready', value: ['one'], proposalCount: 1 }),
+        });
+        expect(result.status).toBe('ready');
+        expect(result.value).toEqual(['one']);
+    });
+});
+//# sourceMappingURL=provider-execution-envelope.test.js.map

package/dist/__tests__/provider-execution-envelope.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-execution-envelope.test.js","sourceRoot":"","sources":["../../src/__tests__/provider-execution-envelope.test.ts"],"names":[],"mappings":"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"}

package/dist/embedding-response-validator.d.ts

@@ -0,0 +1,38 @@
+import { type EmbeddingBatchResponseV1, type EmbeddingProviderContract, type EmbeddingPurpose } from '@devflow-tools/sdk';
+/**
+ * Provider-facing embedding batch response. Providers may return vectors in
+ * request order or attach an explicit input index to each vector.
+ */
+export type EmbeddingBatchResponse = EmbeddingBatchResponseV1;
+export interface ValidateEmbeddingBatchInput {
+    response: unknown;
+    expectedCount: number;
+    expectedDimension: number;
+    expectedProfileHash?: string;
+    responseProfileHash?: string;
+}
+/** Stable error codes emitted by the embedding boundary. */
+export type EmbeddingValidationErrorCode = 'embedding_batch_count_mismatch' | 'embedding_batch_index_invalid' | 'embedding_batch_index_duplicate' | 'embedding_batch_index_missing' | 'embedding_vector_invalid' | 'embedding_vector_empty' | 'embedding_vector_non_finite' | 'embedding_vector_dimension_mismatch' | 'embedding_profile_mismatch';
+export declare class EmbeddingBatchValidationError extends Error {
+    readonly code: EmbeddingValidationErrorCode;
+    constructor(code: EmbeddingValidationErrorCode, detail?: string);
+}
+/**
+ * Validate and canonicalize an embedding provider response.
+ *
+ * The returned array is always ordered by input position and contains only
+ * finite Float32Arrays with the requested dimension. No caller should need to
+ * perform a second, partial validation before persisting or scoring vectors.
+ */
+export declare function validateEmbeddingBatch(input: ValidateEmbeddingBatchInput): Float32Array[];
+export declare function requestValidatedEmbeddingBatch(input: {
+    provider: EmbeddingProviderContract;
+    purpose: EmbeddingPurpose;
+    texts: string[];
+}): Promise<Float32Array[]>;
+export declare function requestValidatedEmbedding(input: {
+    provider: EmbeddingProviderContract;
+    purpose: EmbeddingPurpose;
+    text: string;
+}): Promise<Float32Array>;
+//# sourceMappingURL=embedding-response-validator.d.ts.map

package/dist/embedding-response-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-response-validator.d.ts","sourceRoot":"","sources":["../src/embedding-response-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,wBAAwB,CAAC;AAE9D,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,4DAA4D;AAC5D,MAAM,MAAM,4BAA4B,GACpC,gCAAgC,GAChC,+BAA+B,GAC/B,iCAAiC,GACjC,+BAA+B,GAC/B,0BAA0B,GAC1B,wBAAwB,GACxB,6BAA6B,GAC7B,qCAAqC,GACrC,4BAA4B,CAAC;AAEjC,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;gBAEhC,IAAI,EAAE,4BAA4B,EAAE,MAAM,CAAC,EAAE,MAAM;CAKhE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,YAAY,EAAE,CA6CzF;AAED,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,QAAQ,EAAE,yBAAyB,CAAC;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAY1B;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,EAAE,yBAAyB,CAAC;IACpC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,YAAY,CAAC,CAWxB"}

package/dist/embedding-response-validator.js

@@ -0,0 +1,110 @@
+export class EmbeddingBatchValidationError extends Error {
+    code;
+    constructor(code, detail) {
+        super(detail ? `${code}: ${detail}` : code);
+        this.name = 'EmbeddingBatchValidationError';
+        this.code = code;
+    }
+}
+/**
+ * Validate and canonicalize an embedding provider response.
+ *
+ * The returned array is always ordered by input position and contains only
+ * finite Float32Arrays with the requested dimension. No caller should need to
+ * perform a second, partial validation before persisting or scoring vectors.
+ */
+export function validateEmbeddingBatch(input) {
+    const { response, expectedCount, expectedDimension, expectedProfileHash, responseProfileHash, } = input;
+    if (expectedProfileHash !== undefined && responseProfileHash !== expectedProfileHash) {
+        throw new EmbeddingBatchValidationError('embedding_profile_mismatch', `expected ${expectedProfileHash}, received ${responseProfileHash ?? 'missing'}`);
+    }
+    if (!Number.isSafeInteger(expectedCount) || expectedCount < 0
+        || !Number.isSafeInteger(expectedDimension) || expectedDimension <= 0) {
+        throw new EmbeddingBatchValidationError('embedding_vector_dimension_mismatch');
+    }
+    if (!Array.isArray(response)) {
+        throw new EmbeddingBatchValidationError('embedding_batch_count_mismatch');
+    }
+    const indexed = response.length > 0 && response.every(isIndexedEmbedding);
+    const ordered = response.length === 0 || response.every(value => value instanceof Float32Array);
+    if (!indexed && !ordered) {
+        throw new EmbeddingBatchValidationError('embedding_vector_invalid');
+    }
+    let vectors;
+    if (indexed) {
+        vectors = orderIndexedEmbeddings(response, expectedCount);
+    }
+    else {
+        if (response.length !== expectedCount) {
+            throw new EmbeddingBatchValidationError('embedding_batch_count_mismatch', `expected ${expectedCount}, received ${response.length}`);
+        }
+        vectors = response;
+    }
+    vectors.forEach((vector, index) => validateVector(vector, index, expectedDimension));
+    return vectors.slice();
+}
+export async function requestValidatedEmbeddingBatch(input) {
+    if (input.texts.length === 0)
+        return [];
+    const expectedProfile = input.provider.getCapability(input.purpose).profile;
+    const response = await input.provider.embedBatch(input.texts);
+    const responseProfile = input.provider.getCapability(input.purpose).profile;
+    return validateEmbeddingBatch({
+        response,
+        expectedCount: input.texts.length,
+        expectedDimension: expectedProfile.dimension,
+        expectedProfileHash: expectedProfile.profileHash,
+        responseProfileHash: responseProfile.profileHash,
+    });
+}
+export async function requestValidatedEmbedding(input) {
+    const expectedProfile = input.provider.getCapability(input.purpose).profile;
+    const response = await input.provider.embed(input.text);
+    const responseProfile = input.provider.getCapability(input.purpose).profile;
+    return validateEmbeddingBatch({
+        response: [response],
+        expectedCount: 1,
+        expectedDimension: expectedProfile.dimension,
+        expectedProfileHash: expectedProfile.profileHash,
+        responseProfileHash: responseProfile.profileHash,
+    })[0];
+}
+function isIndexedEmbedding(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const candidate = value;
+    return typeof candidate.index === 'number' && candidate.vector instanceof Float32Array;
+}
+function orderIndexedEmbeddings(response, expectedCount) {
+    const ordered = new Array(expectedCount);
+    for (const item of response) {
+        if (!Number.isSafeInteger(item.index) || item.index < 0 || item.index >= expectedCount) {
+            throw new EmbeddingBatchValidationError('embedding_batch_index_invalid', `index ${String(item.index)} is outside [0, ${expectedCount})`);
+        }
+        if (ordered[item.index] !== undefined) {
+            throw new EmbeddingBatchValidationError('embedding_batch_index_duplicate', `index ${item.index}`);
+        }
+        ordered[item.index] = item.vector;
+    }
+    for (let index = 0; index < ordered.length; index += 1) {
+        if (ordered[index] === undefined) {
+            throw new EmbeddingBatchValidationError('embedding_batch_index_missing');
+        }
+    }
+    return ordered;
+}
+function validateVector(vector, index, expectedDimension) {
+    if (!(vector instanceof Float32Array)) {
+        throw new EmbeddingBatchValidationError('embedding_vector_invalid', `vector ${index}`);
+    }
+    if (vector.length === 0) {
+        throw new EmbeddingBatchValidationError('embedding_vector_empty', `vector ${index}`);
+    }
+    if (vector.length !== expectedDimension) {
+        throw new EmbeddingBatchValidationError('embedding_vector_dimension_mismatch', `vector ${index} has ${vector.length}; expected ${expectedDimension}`);
+    }
+    if (vector.some(value => !Number.isFinite(value))) {
+        throw new EmbeddingBatchValidationError('embedding_vector_non_finite', `vector ${index}`);
+    }
+}
+//# sourceMappingURL=embedding-response-validator.js.map

package/dist/embedding-response-validator.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './provider-execution-envelope.js';
+export * from './embedding-response-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './provider-execution-envelope.js';
+export * from './embedding-response-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC"}

package/dist/provider-execution-envelope.d.ts

@@ -0,0 +1,53 @@
+import { type ProviderCapability, type ProviderExecutionReceiptV1, type ProviderExecutionStatus } from '@devflow-tools/sdk';
+export interface ProviderExecutionObserver {
+    record(receipt: ProviderExecutionReceiptV1): void;
+}
+export interface ProviderExecutionValue<T> {
+    status: 'ready' | 'empty_valid' | 'invalid' | 'unavailable';
+    value?: T;
+    proposalCount: number;
+    reasonCodes?: string[];
+}
+export interface ProviderValidationResult<T> {
+    value: T;
+    acceptedCount: number;
+    rejectedCount: number;
+    reasonCodes: string[];
+}
+export interface ProviderRunInput<T> {
+    requestHash: string;
+    providerId: string;
+    providerVersion: string;
+    capability: ProviderCapability;
+    scopeKey: string;
+    timeoutMs: number;
+    signal?: AbortSignal;
+    execute(signal: AbortSignal): Promise<ProviderExecutionValue<T>>;
+    validate?(value: T): ProviderValidationResult<T>;
+}
+export interface ProviderRunResult<T> {
+    status: ProviderExecutionStatus;
+    value?: T;
+    receipt: ProviderExecutionReceiptV1;
+}
+export interface ProviderExecutionEnvelopeOptions {
+    cooldownMs?: number;
+    maxCooldownEntries?: number;
+    observer?: ProviderExecutionObserver;
+    now?: () => number;
+}
+export declare class ProviderExecutionEnvelope {
+    private readonly active;
+    private readonly cooldowns;
+    private readonly cooldownMs;
+    private readonly maxCooldownEntries;
+    private readonly observer?;
+    private readonly now;
+    private sequence;
+    constructor(options?: ProviderExecutionEnvelopeOptions);
+    run<T>(input: ProviderRunInput<T>): Promise<ProviderRunResult<T>>;
+    private finish;
+    private openCooldown;
+    private pruneCooldowns;
+}
+//# sourceMappingURL=provider-execution-envelope.d.ts.map

package/dist/provider-execution-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-execution-envelope.d.ts","sourceRoot":"","sources":["../src/provider-execution-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,MAAM,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,0BAA0B,CAAC;CACrC;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAUD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAK;gBAET,OAAO,GAAE,gCAAqC;IAOpD,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAgFvE,OAAO,CAAC,MAAM;IAwCd,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,cAAc;CAKvB"}

package/dist/provider-execution-envelope.js

@@ -0,0 +1,179 @@
+import { stableRuntimeHash, } from '@devflow-tools/sdk';
+class ProviderTimeoutError extends Error {
+}
+class ProviderCancelledError extends Error {
+}
+export class ProviderExecutionEnvelope {
+    active = new Set();
+    cooldowns = new Map();
+    cooldownMs;
+    maxCooldownEntries;
+    observer;
+    now;
+    sequence = 0;
+    constructor(options = {}) {
+        this.cooldownMs = positiveInteger(options.cooldownMs, 5_000);
+        this.maxCooldownEntries = positiveInteger(options.maxCooldownEntries, 1_000);
+        this.observer = options.observer;
+        this.now = options.now ?? Date.now;
+    }
+    async run(input) {
+        assertInput(input);
+        const startedAt = this.now();
+        const executionId = `provider-execution:${stableRuntimeHash({
+            requestHash: input.requestHash,
+            providerId: input.providerId,
+            providerVersion: input.providerVersion,
+            capability: input.capability,
+            scopeKey: input.scopeKey,
+            startedAt,
+            sequence: this.sequence++,
+        }).slice(0, 32)}`;
+        const key = `${input.capability}\0${input.scopeKey}`;
+        this.pruneCooldowns(startedAt);
+        if (input.signal?.aborted) {
+            return this.finish(input, executionId, startedAt, 'cancelled', 0, 0, 0, ['provider_cancelled']);
+        }
+        const cooldown = this.cooldowns.get(key);
+        if (cooldown && cooldown.retryAt > startedAt) {
+            return this.finish(input, executionId, startedAt, 'unavailable', 0, 0, 0, [cooldown.reasonCode]);
+        }
+        if (this.active.has(key)) {
+            return this.finish(input, executionId, startedAt, 'unavailable', 0, 0, 0, ['provider_reentrant']);
+        }
+        this.active.add(key);
+        try {
+            const output = await executeBounded(input);
+            const baseReasons = stableReasons(output.reasonCodes ?? []);
+            if (output.status !== 'ready') {
+                if (output.status === 'invalid' || output.status === 'unavailable') {
+                    this.openCooldown(key, output.status === 'invalid' ? 'provider_invalid_cooldown' : 'provider_unavailable_cooldown');
+                }
+                return this.finish(input, executionId, startedAt, output.status, output.proposalCount, 0, output.status === 'empty_valid' ? 0 : output.proposalCount, baseReasons);
+            }
+            if (output.value === undefined) {
+                this.openCooldown(key, 'provider_invalid_cooldown');
+                return this.finish(input, executionId, startedAt, 'invalid', output.proposalCount, 0, output.proposalCount, [...baseReasons, 'provider_value_missing']);
+            }
+            if (!input.validate) {
+                return this.finish(input, executionId, startedAt, 'ready', output.proposalCount, output.proposalCount, 0, baseReasons, output.value);
+            }
+            try {
+                const validated = input.validate(output.value);
+                assertValidationCounts(validated, output.proposalCount);
+                return this.finish(input, executionId, startedAt, 'ready', output.proposalCount, validated.acceptedCount, validated.rejectedCount, [...baseReasons, ...validated.reasonCodes], validated.value);
+            }
+            catch {
+                this.openCooldown(key, 'provider_invalid_cooldown');
+                return this.finish(input, executionId, startedAt, 'invalid', output.proposalCount, 0, output.proposalCount, [...baseReasons, 'provider_validation_failed']);
+            }
+        }
+        catch (error) {
+            if (error instanceof ProviderTimeoutError) {
+                this.openCooldown(key, 'provider_timeout_cooldown');
+                return this.finish(input, executionId, startedAt, 'timeout', 0, 0, 0, ['provider_timeout']);
+            }
+            if (error instanceof ProviderCancelledError) {
+                return this.finish(input, executionId, startedAt, 'cancelled', 0, 0, 0, ['provider_cancelled']);
+            }
+            this.openCooldown(key, 'provider_unavailable_cooldown');
+            return this.finish(input, executionId, startedAt, 'unavailable', 0, 0, 0, ['provider_exception']);
+        }
+        finally {
+            this.active.delete(key);
+        }
+    }
+    finish(input, executionId, startedAt, status, proposalCount, acceptedCount, rejectedCount, reasonCodes, value) {
+        const completedAt = this.now();
+        const body = {
+            schemaVersion: 'provider-execution-receipt.v1',
+            receiptId: `provider-execution-receipt:${stableRuntimeHash(executionId).slice(0, 32)}`,
+            executionId,
+            requestHash: input.requestHash,
+            providerId: input.providerId,
+            providerVersion: input.providerVersion,
+            capability: input.capability,
+            status,
+            proposalCount,
+            acceptedCount,
+            rejectedCount,
+            reasonCodes: stableReasons(reasonCodes),
+            latencyMs: Math.max(0, completedAt - startedAt),
+            createdAt: completedAt,
+        };
+        const receipt = Object.freeze({
+            ...body,
+            receiptHash: stableRuntimeHash(body),
+        });
+        try {
+            this.observer?.record(receipt);
+        }
+        catch {
+            // Observability cannot change provider or domain semantics.
+        }
+        return { status, ...(value === undefined ? {} : { value }), receipt };
+    }
+    openCooldown(key, reasonCode) {
+        if (this.cooldowns.size >= this.maxCooldownEntries && !this.cooldowns.has(key)) {
+            const oldest = this.cooldowns.keys().next().value;
+            if (oldest !== undefined)
+                this.cooldowns.delete(oldest);
+        }
+        this.cooldowns.set(key, { retryAt: this.now() + this.cooldownMs, reasonCode });
+    }
+    pruneCooldowns(now) {
+        for (const [key, entry] of this.cooldowns) {
+            if (entry.retryAt <= now)
+                this.cooldowns.delete(key);
+        }
+    }
+}
+async function executeBounded(input) {
+    const controller = new AbortController();
+    let timeout;
+    let removeAbortListener;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeout = setTimeout(() => {
+            reject(new ProviderTimeoutError());
+            controller.abort();
+        }, input.timeoutMs);
+    });
+    const cancellationPromise = new Promise((_, reject) => {
+        if (!input.signal)
+            return;
+        const cancelled = () => {
+            reject(new ProviderCancelledError());
+            controller.abort();
+        };
+        input.signal.addEventListener('abort', cancelled, { once: true });
+        removeAbortListener = () => input.signal?.removeEventListener('abort', cancelled);
+    });
+    try {
+        return await Promise.race([input.execute(controller.signal), timeoutPromise, cancellationPromise]);
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+        removeAbortListener?.();
+    }
+}
+function assertInput(input) {
+    if (!input.requestHash || !input.providerId || !input.providerVersion || !input.scopeKey
+        || !Number.isSafeInteger(input.timeoutMs) || input.timeoutMs <= 0) {
+        throw new Error('PROVIDER_EXECUTION_INPUT_INVALID');
+    }
+}
+function assertValidationCounts(result, proposalCount) {
+    if (!Number.isSafeInteger(result.acceptedCount) || result.acceptedCount < 0
+        || !Number.isSafeInteger(result.rejectedCount) || result.rejectedCount < 0
+        || result.acceptedCount + result.rejectedCount !== proposalCount) {
+        throw new Error('PROVIDER_VALIDATION_COUNTS_INVALID');
+    }
+}
+function positiveInteger(value, fallback) {
+    return Number.isSafeInteger(value) && value > 0 ? value : fallback;
+}
+function stableReasons(reasonCodes) {
+    return [...new Set(reasonCodes.filter(reason => /^[a-z][a-z0-9_]{1,63}$/u.test(reason)))].sort();
+}
+//# sourceMappingURL=provider-execution-envelope.js.map

package/dist/provider-execution-envelope.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@devflow-tools/provider-runtime",
+  "version": "0.18.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "node ../../node_modules/.bin/vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@devflow-tools/sdk": "0.18.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "description": "Bounded execution boundary for optional semantic and retrieval providers.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shilongfeicool/dev-flow.git"
+  },
+  "homepage": "https://github.com/shilongfeicool/dev-flow#readme"
+}