@codesoul-co/hypha-core / contracts/execution-cache

• Package index: @codesoul-co/hypha-core
• Source: packages/core/src/contracts/execution-cache.ts
• Exports: 21

Using this module

Use the Execution cache module for declaring and runtime-validating contracts. It exports 15 interfaces, 6 types.

Import from the package entrypoint

import type {
  ExecutionCacheArtifactReference,
  ExecutionCacheArtifactVerifier,
  ExecutionCacheEntryProjection,
  ExecutionCacheEvent,
  ExecutionCacheLookupInput,
  ExecutionCacheRecord,
  ExecutionCacheResultMetadata,
  ExecutionCacheReuseAssessmentInput,
} from '@codesoul-co/hypha-core';

// The complete export list is documented below.

Usage patterns

• Use the 21 type/interface exports as static contracts in application code, adapters, or tests. Import them with import type; they do not exist at runtime.

Public exports

Symbol	Kind	Signature	Description
ExecutionCacheArtifactReference	interface	interface ExecutionCacheArtifactReference	Execution Cache Artifact Reference interface with 2 public fields or methods.
ExecutionCacheArtifactVerifier	interface	interface ExecutionCacheArtifactVerifier	Execution Cache Artifact Verifier interface with 1 public fields or methods.
ExecutionCacheEntryProjection	interface	interface ExecutionCacheEntryProjection	Execution's projection for a generic CacheEntry value. It contains metadata, references, and hashes only; Artifact bytes and stdout/stderr are out of scope.
ExecutionCacheEvent	interface	interface ExecutionCacheEvent	Execution Cache Event interface with 5 public fields or methods.
ExecutionCacheLookupInput	interface	interface ExecutionCacheLookupInput	Execution Cache Lookup Input interface with 5 public fields or methods.
ExecutionCacheRecord	interface	interface ExecutionCacheRecord	Versioned envelope persisted by an Execution Result Cache store.
ExecutionCacheResultMetadata	interface	interface ExecutionCacheResultMetadata	Bounded result fields allowed in a Cache entry.
ExecutionCacheReuseAssessmentInput	interface	interface ExecutionCacheReuseAssessmentInput	Execution Cache Reuse Assessment Input interface with 2 public fields or methods.
ExecutionCacheScope	interface	interface ExecutionCacheScope	Mandatory ownership boundary for persisted Execution Cache records.
ExecutionCacheStore	interface	interface ExecutionCacheStore	Execution Cache Store interface with 5 public fields or methods.
ExecutionCacheValidityInput	interface	interface ExecutionCacheValidityInput	Exact Execution-owned validity input consumed by Cache integrations.
ExecutionCacheWriteInput	interface	interface ExecutionCacheWriteInput extends ExecutionCacheLookupInput	Execution Cache Write Input interface with 7 public fields or methods.
ExecutionCommandFingerprintInput	interface	interface ExecutionCommandFingerprintInput	Canonical, bounded material for a Command fingerprint. Raw environment values, Secret values, stdin, and command output are deliberately excluded.
ExecutionEnvironmentFingerprint	interface	interface ExecutionEnvironmentFingerprint	Resolved environment facts used to prove that a cache key is stable.
ExecutionFingerprintHasher	interface	interface ExecutionFingerprintHasher	Platform-neutral SHA-256 port; adapters hash the canonical UTF-8 string.
ExecutionCacheFailureMode	type	type ExecutionCacheFailureMode = 'bypass' | 'strict'	Public type alias for Execution Cache Failure Mode; the declaration contains its complete type expression.
ExecutionCacheLookupResult	type	type ExecutionCacheLookupResult = { hit: true; key: string; projection: ExecutionCacheEntryProjection; ageMs: number; } | { hit: false; reason: ExecutionCacheMissReason; key?: string; }	Public type alias for Execution Cache Lookup Result; the declaration contains its complete type expression.
ExecutionCacheMissReason	type	type ExecutionCacheMissReason = 'not_found' | 'expired' | 'scope_mismatch' | 'key_mismatch' | 'validity_changed' | 'artifact_verification_unavailable' | 'artifact_verification_failed' | 'environment_fingerprint_unavailable' | 'workspace_write' | 'external_side_effect' | 'irreversible_side_effect' | 'not_cacheable_status' | 'store_unavailable' | 'entry_oversized' | 'corrupt'	Public type alias for Execution Cache Miss Reason; the declaration contains its complete type expression.
ExecutionCacheReuseAssessment	type	type ExecutionCacheReuseAssessment = { reusable: true; } | { reusable: false; reason: ExecutionCacheReuseBlockReason; }	Public type alias for Execution Cache Reuse Assessment; the declaration contains its complete type expression.
ExecutionCacheReuseBlockReason	type	type ExecutionCacheReuseBlockReason = 'environment_fingerprint_unavailable' | 'workspace_write' | 'external_side_effect' | 'irreversible_side_effect'	Public type alias for Execution Cache Reuse Block Reason; the declaration contains its complete type expression.
ExecutionEnvironmentFingerprintResolution	type	type ExecutionEnvironmentFingerprintResolution = { status: 'resolved'; fingerprint: ExecutionEnvironmentFingerprint; } | { status: 'unavailable'; reason: string; }	Public type alias for Execution Environment Fingerprint Resolution; the declaration contains its complete type expression.

ExecutionCacheArtifactReference

Execution Cache Artifact Reference interface with 2 public fields or methods.

• Kind: interface
• Import: import type { ExecutionCacheArtifactReference } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheArtifactReference {
    artifactRef: string;
    contentHash: string;
}

Contract members

Member	Kind	Signature	Description
artifactRef	property	artifactRef: string	Public property; its type, readonly modifier and optionality are shown in the signature.
contentHash	property	contentHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheArtifactVerifier

Execution Cache Artifact Verifier interface with 1 public fields or methods.

• Kind: interface
• Import: import type { ExecutionCacheArtifactVerifier } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheArtifactVerifier {
    verify(scope: ExecutionCacheScope, artifacts: ExecutionCacheArtifactReference[]): Promise<boolean>;
}

Contract members

Member	Kind	Signature	Description
verify	method	verify(scope: ExecutionCacheScope, artifacts: ExecutionCacheArtifactReference[]): Promise<boolean>	Public method; parameters and return type are shown in the signature.

ExecutionCacheEntryProjection

Execution's projection for a generic CacheEntry value. It contains metadata, references, and hashes only; Artifact bytes and stdout/stderr are out of scope.

• Kind: interface
• Import: import type { ExecutionCacheEntryProjection } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheEntryProjection {
    commandHash: string;
    validityHash: string;
    validity: ExecutionCacheValidityInput;
    resultMetadata: ExecutionCacheResultMetadata;
    artifacts: ExecutionCacheArtifactReference[];
}

Contract members

Member	Kind	Signature	Description
artifacts	property	artifacts: ExecutionCacheArtifactReference[]	Public property; its type, readonly modifier and optionality are shown in the signature.
commandHash	property	commandHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
resultMetadata	property	resultMetadata: ExecutionCacheResultMetadata	Public property; its type, readonly modifier and optionality are shown in the signature.
validity	property	validity: ExecutionCacheValidityInput	Public property; its type, readonly modifier and optionality are shown in the signature.
validityHash	property	validityHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheEvent

Execution Cache Event interface with 5 public fields or methods.

• Kind: interface
• Import: import type { ExecutionCacheEvent } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheEvent {
    type: 'execution.cache.lookup' | 'execution.cache.hit' | 'execution.cache.miss' | 'execution.cache.write' | 'execution.cache.invalidate' | 'execution.cache.bypass';
    key?: string;
    scope: ExecutionCacheScope;
    reason?: ExecutionCacheMissReason;
    ageMs?: number;
}

Contract members

Member	Kind	Signature	Description
ageMs	property	ageMs?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
key	property	key?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
reason	property	reason?: ExecutionCacheMissReason	Public property; its type, readonly modifier and optionality are shown in the signature.
scope	property	scope: ExecutionCacheScope	Public property; its type, readonly modifier and optionality are shown in the signature.
type	property	type: "execution.cache.lookup" | "execution.cache.hit" | "execution.cache.miss" | "execution.cache.write" | "execution.cache.invalidate" | "execution.cache.bypass"	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheLookupInput

Execution Cache Lookup Input interface with 5 public fields or methods.

• Kind: interface
• Import: import type { ExecutionCacheLookupInput } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheLookupInput {
    scope: ExecutionCacheScope;
    command: ExecutionCommandFingerprintInput;
    validity: ExecutionCacheValidityInput;
    sideEffectLevel: SideEffectLevel;
    environmentFingerprintStatus: ExecutionEnvironmentFingerprintResolution['status'];
}

Contract members

Member	Kind	Signature	Description
command	property	command: ExecutionCommandFingerprintInput	Public property; its type, readonly modifier and optionality are shown in the signature.
environmentFingerprintStatus	property	environmentFingerprintStatus: "resolved" | "unavailable"	Public property; its type, readonly modifier and optionality are shown in the signature.
scope	property	scope: ExecutionCacheScope	Public property; its type, readonly modifier and optionality are shown in the signature.
sideEffectLevel	property	sideEffectLevel: SideEffectLevel	Public property; its type, readonly modifier and optionality are shown in the signature.
validity	property	validity: ExecutionCacheValidityInput	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheRecord

Versioned envelope persisted by an Execution Result Cache store.

• Kind: interface
• Import: import type { ExecutionCacheRecord } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheRecord {
    schemaVersion: '1.0';
    keyVersion: '1';
    key: string;
    scope: ExecutionCacheScope;
    projection: ExecutionCacheEntryProjection;
    createdAt: number;
    expiresAt?: number;
    sizeBytes?: number;
}

Contract members

Member	Kind	Signature	Description
createdAt	property	createdAt: number	Public property; its type, readonly modifier and optionality are shown in the signature.
expiresAt	property	expiresAt?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
key	property	key: string	Public property; its type, readonly modifier and optionality are shown in the signature.
keyVersion	property	keyVersion: "1"	Public property; its type, readonly modifier and optionality are shown in the signature.
projection	property	projection: ExecutionCacheEntryProjection	Public property; its type, readonly modifier and optionality are shown in the signature.
schemaVersion	property	schemaVersion: "1.0"	Public property; its type, readonly modifier and optionality are shown in the signature.
scope	property	scope: ExecutionCacheScope	Public property; its type, readonly modifier and optionality are shown in the signature.
sizeBytes	property	sizeBytes?: number	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheResultMetadata

Bounded result fields allowed in a Cache entry.

• Kind: interface
• Import: import type { ExecutionCacheResultMetadata } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheResultMetadata {
    executionId: string;
    status: CommandExecutionStatus;
    exitCode: number | null;
    signal?: string;
    resourceUsage?: ExecutionResourceUsage;
    providerReceiptHash?: string;
    startedAt: string;
    completedAt?: string;
    latencyMs?: number;
}

Contract members

Member	Kind	Signature	Description
completedAt	property	completedAt?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
executionId	property	executionId: string	Public property; its type, readonly modifier and optionality are shown in the signature.
exitCode	property	exitCode: number	Public property; its type, readonly modifier and optionality are shown in the signature.
latencyMs	property	latencyMs?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
providerReceiptHash	property	providerReceiptHash?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
resourceUsage	property	resourceUsage?: ExecutionResourceUsage	Public property; its type, readonly modifier and optionality are shown in the signature.
signal	property	signal?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
startedAt	property	startedAt: string	Public property; its type, readonly modifier and optionality are shown in the signature.
status	property	status: CommandExecutionStatus	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheReuseAssessmentInput

Execution Cache Reuse Assessment Input interface with 2 public fields or methods.

• Kind: interface
• Import: import type { ExecutionCacheReuseAssessmentInput } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheReuseAssessmentInput {
    sideEffectLevel: SideEffectLevel;
    environmentFingerprintStatus: ExecutionEnvironmentFingerprintResolution['status'];
}

Contract members

Member	Kind	Signature	Description
environmentFingerprintStatus	property	environmentFingerprintStatus: "resolved" | "unavailable"	Public property; its type, readonly modifier and optionality are shown in the signature.
sideEffectLevel	property	sideEffectLevel: SideEffectLevel	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheScope

Mandatory ownership boundary for persisted Execution Cache records.

• Kind: interface
• Import: import type { ExecutionCacheScope } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheScope {
    tenantId?: string;
    userId: string;
    workspaceId: string;
}

Contract members

Member	Kind	Signature	Description
tenantId	property	tenantId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
userId	property	userId: string	Public property; its type, readonly modifier and optionality are shown in the signature.
workspaceId	property	workspaceId: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheStore

Execution Cache Store interface with 5 public fields or methods.

• Kind: interface
• Import: import type { ExecutionCacheStore } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheStore {
    get(key: string): Promise<ExecutionCacheRecord | null>;
    set(key: string, record: ExecutionCacheRecord): Promise<void>;
    delete(key: string): Promise<void>;
    clear?(): Promise<void>;
    close?(): Promise<void>;
}

Contract members

Member	Kind	Signature	Description
clear	method	clear?(): Promise<void>	Public method; parameters and return type are shown in the signature.
close	method	close?(): Promise<void>	Public method; parameters and return type are shown in the signature.
delete	method	delete(key: string): Promise<void>	Public method; parameters and return type are shown in the signature.
get	method	get(key: string): Promise<ExecutionCacheRecord | null>	Public method; parameters and return type are shown in the signature.
set	method	set(key: string, record: ExecutionCacheRecord): Promise<void>	Public method; parameters and return type are shown in the signature.

ExecutionCacheValidityInput

Exact Execution-owned validity input consumed by Cache integrations.

• Kind: interface
• Import: import type { ExecutionCacheValidityInput } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheValidityInput {
    executable: string;
    argsHash: string;
    sourceTreeHash: string;
    workspaceSnapshotHash?: string;
    environmentHash: string;
    imageDigest?: string;
    dependencyLockHash?: string;
    networkPolicyHash: string;
    secretVersionSetHash?: string;
    commandPolicyRevision?: string;
}

Contract members

Member	Kind	Signature	Description
argsHash	property	argsHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
commandPolicyRevision	property	commandPolicyRevision?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
dependencyLockHash	property	dependencyLockHash?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
environmentHash	property	environmentHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
executable	property	executable: string	Public property; its type, readonly modifier and optionality are shown in the signature.
imageDigest	property	imageDigest?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
networkPolicyHash	property	networkPolicyHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
secretVersionSetHash	property	secretVersionSetHash?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
sourceTreeHash	property	sourceTreeHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
workspaceSnapshotHash	property	workspaceSnapshotHash?: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCacheWriteInput

Execution Cache Write Input interface with 7 public fields or methods.

• Kind: interface
• Import: import type { ExecutionCacheWriteInput } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCacheWriteInput extends ExecutionCacheLookupInput {
    projection: ExecutionCacheEntryProjection;
    ttlMs?: number;
}

Contract members

Member	Kind	Signature	Description
command	property	command: ExecutionCommandFingerprintInput	Public property; its type, readonly modifier and optionality are shown in the signature.
environmentFingerprintStatus	property	environmentFingerprintStatus: "resolved" | "unavailable"	Public property; its type, readonly modifier and optionality are shown in the signature.
projection	property	projection: ExecutionCacheEntryProjection	Public property; its type, readonly modifier and optionality are shown in the signature.
scope	property	scope: ExecutionCacheScope	Public property; its type, readonly modifier and optionality are shown in the signature.
sideEffectLevel	property	sideEffectLevel: SideEffectLevel	Public property; its type, readonly modifier and optionality are shown in the signature.
ttlMs	property	ttlMs?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
validity	property	validity: ExecutionCacheValidityInput	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionCommandFingerprintInput

Canonical, bounded material for a Command fingerprint. Raw environment values, Secret values, stdin, and command output are deliberately excluded.

• Kind: interface
• Import: import type { ExecutionCommandFingerprintInput } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionCommandFingerprintInput {
    executable: string;
    argsHash: string;
    cwd?: string;
    relevantEnvHash: string;
    sourceTreeHash: string;
    environmentHash: string;
    networkPolicyHash: string;
    secretVersionSetHash?: string;
    idempotencyKey: string;
}

Contract members

Member	Kind	Signature	Description
argsHash	property	argsHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
cwd	property	cwd?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
environmentHash	property	environmentHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
executable	property	executable: string	Public property; its type, readonly modifier and optionality are shown in the signature.
idempotencyKey	property	idempotencyKey: string	Public property; its type, readonly modifier and optionality are shown in the signature.
networkPolicyHash	property	networkPolicyHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
relevantEnvHash	property	relevantEnvHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
secretVersionSetHash	property	secretVersionSetHash?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
sourceTreeHash	property	sourceTreeHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionEnvironmentFingerprint

Resolved environment facts used to prove that a cache key is stable.

• Kind: interface
• Import: import type { ExecutionEnvironmentFingerprint } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionEnvironmentFingerprint {
    environmentRef: SpecRef;
    environmentRevision: string;
    providerId: string;
    imageDigest?: string;
    platform?: string;
    executableVersions?: Record<string, string>;
    dependencyLockHash?: string;
    resourcePolicyHash: string;
    networkPolicyHash: string;
    mountPolicyHash: string;
    secretVersionSetHash?: string;
    fingerprintHash: string;
}

Contract members

Member	Kind	Signature	Description
dependencyLockHash	property	dependencyLockHash?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
environmentRef	property	environmentRef: SpecRef	Public property; its type, readonly modifier and optionality are shown in the signature.
environmentRevision	property	environmentRevision: string	Public property; its type, readonly modifier and optionality are shown in the signature.
executableVersions	property	executableVersions?: Record<string, string>	Public property; its type, readonly modifier and optionality are shown in the signature.
fingerprintHash	property	fingerprintHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
imageDigest	property	imageDigest?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
mountPolicyHash	property	mountPolicyHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
networkPolicyHash	property	networkPolicyHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
platform	property	platform?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
providerId	property	providerId: string	Public property; its type, readonly modifier and optionality are shown in the signature.
resourcePolicyHash	property	resourcePolicyHash: string	Public property; its type, readonly modifier and optionality are shown in the signature.
secretVersionSetHash	property	secretVersionSetHash?: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ExecutionFingerprintHasher

Platform-neutral SHA-256 port; adapters hash the canonical UTF-8 string.

• Kind: interface
• Import: import type { ExecutionFingerprintHasher } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export interface ExecutionFingerprintHasher {
    readonly algorithm: 'sha256';
    hashUtf8(canonicalValue: string): Promise<string>;
}

Contract members

Member	Kind	Signature	Description
algorithm	property	readonly algorithm: "sha256"	Public property; its type, readonly modifier and optionality are shown in the signature.
hashUtf8	method	hashUtf8(canonicalValue: string): Promise<string>	Public method; parameters and return type are shown in the signature.

ExecutionCacheFailureMode

Public type alias for Execution Cache Failure Mode; the declaration contains its complete type expression.

• Kind: type
• Import: import type { ExecutionCacheFailureMode } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export type ExecutionCacheFailureMode = 'bypass' | 'strict';

ExecutionCacheLookupResult

Public type alias for Execution Cache Lookup Result; the declaration contains its complete type expression.

• Kind: type
• Import: import type { ExecutionCacheLookupResult } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export type ExecutionCacheLookupResult = {
    hit: true;
    key: string;
    projection: ExecutionCacheEntryProjection;
    ageMs: number;
} | {
    hit: false;
    reason: ExecutionCacheMissReason;
    key?: string;
};

ExecutionCacheMissReason

Public type alias for Execution Cache Miss Reason; the declaration contains its complete type expression.

• Kind: type
• Import: import type { ExecutionCacheMissReason } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export type ExecutionCacheMissReason = 'not_found' | 'expired' | 'scope_mismatch' | 'key_mismatch' | 'validity_changed' | 'artifact_verification_unavailable' | 'artifact_verification_failed' | 'environment_fingerprint_unavailable' | 'workspace_write' | 'external_side_effect' | 'irreversible_side_effect' | 'not_cacheable_status' | 'store_unavailable' | 'entry_oversized' | 'corrupt';

ExecutionCacheReuseAssessment

Public type alias for Execution Cache Reuse Assessment; the declaration contains its complete type expression.

• Kind: type
• Import: import type { ExecutionCacheReuseAssessment } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export type ExecutionCacheReuseAssessment = {
    reusable: true;
} | {
    reusable: false;
    reason: ExecutionCacheReuseBlockReason;
};

ExecutionCacheReuseBlockReason

Public type alias for Execution Cache Reuse Block Reason; the declaration contains its complete type expression.

• Kind: type
• Import: import type { ExecutionCacheReuseBlockReason } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export type ExecutionCacheReuseBlockReason = 'environment_fingerprint_unavailable' | 'workspace_write' | 'external_side_effect' | 'irreversible_side_effect';

ExecutionEnvironmentFingerprintResolution

Public type alias for Execution Environment Fingerprint Resolution; the declaration contains its complete type expression.

• Kind: type
• Import: import type { ExecutionEnvironmentFingerprintResolution } from '@codesoul-co/hypha-core';
• Source module: contracts/execution-cache

Declaration

export type ExecutionEnvironmentFingerprintResolution = {
    status: 'resolved';
    fingerprint: ExecutionEnvironmentFingerprint;
} | {
    status: 'unavailable';
    reason: string;
};