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

• 包索引: @codesoul-co/hypha-core
• 源码: packages/core/src/contracts/execution-port.ts
• 导出数: 6

模块用法

用于声明并运行时校验契约。Execution port 模块公开 6 接口。

从包入口导入

import type {
  ExecutionAuthorizationEvidence,
  ExecutionAuthorizationVerificationResult,
  ExecutionAuthorizationVerifier,
  ExecutionDispatchRequest,
  ExecutionOperationDispatcher,
  ExecutionPort,
} from '@codesoul-co/hypha-core';

使用要点

• 6 个类型/接口用于应用代码、Adapter 或测试中的静态契约；请使用 import type，运行时不应依赖它们。

公共导出

Symbol	种类	签名	说明
ExecutionAuthorizationEvidence	接口	interface ExecutionAuthorizationEvidence	Execution Authorization Evidence 接口，共包含 14 个公开字段或方法。
ExecutionAuthorizationVerificationResult	接口	interface ExecutionAuthorizationVerificationResult	Execution Authorization Verification Result 接口，共包含 5 个公开字段或方法。
ExecutionAuthorizationVerifier	接口	interface ExecutionAuthorizationVerifier	Execution Authorization Verifier 接口，共包含 1 个公开字段或方法。
ExecutionDispatchRequest	接口	interface ExecutionDispatchRequest	Execution Dispatch Request 接口，共包含 4 个公开字段或方法。
ExecutionOperationDispatcher	接口	interface ExecutionOperationDispatcher	Execution Operation Dispatcher 接口，共包含 1 个公开字段或方法。
ExecutionPort	接口	interface ExecutionPort	Execution Port 接口，共包含 1 个公开字段或方法。

ExecutionAuthorizationEvidence

Execution Authorization Evidence 接口，共包含 14 个公开字段或方法。

• 种类: 接口
• 导入: import type { ExecutionAuthorizationEvidence } from '@codesoul-co/hypha-core';
• 源码模块: contracts/execution-port

声明

export interface ExecutionAuthorizationEvidence {
    id: string;
    invocationId: string;
    activityId: string;
    runId: string;
    toolId: string;
    toolRevision?: string;
    contractSnapshotRef?: string;
    principalId: string;
    inputHash: string;
    policyDecisionRef: string;
    riskAssessmentId: string;
    approvalRef?: string;
    authorizedAt: string;
    expiresAt?: string;
}

契约成员

成员	种类	签名	说明
activityId	属性	activityId: string	公开属性；类型、只读和可选状态以签名列为准。
approvalRef	属性	approvalRef?: string	公开属性；类型、只读和可选状态以签名列为准。
authorizedAt	属性	authorizedAt: string	公开属性；类型、只读和可选状态以签名列为准。
contractSnapshotRef	属性	contractSnapshotRef?: string	公开属性；类型、只读和可选状态以签名列为准。
expiresAt	属性	expiresAt?: string	公开属性；类型、只读和可选状态以签名列为准。
id	属性	id: string	公开属性；类型、只读和可选状态以签名列为准。
inputHash	属性	inputHash: string	公开属性；类型、只读和可选状态以签名列为准。
invocationId	属性	invocationId: string	公开属性；类型、只读和可选状态以签名列为准。
policyDecisionRef	属性	policyDecisionRef: string	公开属性；类型、只读和可选状态以签名列为准。
principalId	属性	principalId: string	公开属性；类型、只读和可选状态以签名列为准。
riskAssessmentId	属性	riskAssessmentId: string	公开属性；类型、只读和可选状态以签名列为准。
runId	属性	runId: string	公开属性；类型、只读和可选状态以签名列为准。
toolId	属性	toolId: string	公开属性；类型、只读和可选状态以签名列为准。
toolRevision	属性	toolRevision?: string	公开属性；类型、只读和可选状态以签名列为准。

ExecutionAuthorizationVerificationResult

Execution Authorization Verification Result 接口，共包含 5 个公开字段或方法。

• 种类: 接口
• 导入: import type { ExecutionAuthorizationVerificationResult } from '@codesoul-co/hypha-core';
• 源码模块: contracts/execution-port

声明

export interface ExecutionAuthorizationVerificationResult {
    valid: boolean;
    verificationRef: string;
    verifiedAt: string;
    expiresAt?: string;
    reason?: string;
}

契约成员

成员	种类	签名	说明
expiresAt	属性	expiresAt?: string	公开属性；类型、只读和可选状态以签名列为准。
reason	属性	reason?: string	公开属性；类型、只读和可选状态以签名列为准。
valid	属性	valid: boolean	公开属性；类型、只读和可选状态以签名列为准。
verificationRef	属性	verificationRef: string	公开属性；类型、只读和可选状态以签名列为准。
verifiedAt	属性	verifiedAt: string	公开属性；类型、只读和可选状态以签名列为准。

ExecutionAuthorizationVerifier

Execution Authorization Verifier 接口，共包含 1 个公开字段或方法。

• 种类: 接口
• 导入: import type { ExecutionAuthorizationVerifier } from '@codesoul-co/hypha-core';
• 源码模块: contracts/execution-port

声明

export interface ExecutionAuthorizationVerifier {
    verify(request: ExecutionDispatchRequest, abortSignal: AbortSignal): Promise<ExecutionAuthorizationVerificationResult>;
}

契约成员

成员	种类	签名	说明
verify	方法	verify(request: ExecutionDispatchRequest, abortSignal: AbortSignal): Promise<ExecutionAuthorizationVerificationResult>	公开方法；参数与返回类型以签名列为准。

ExecutionDispatchRequest

Execution Dispatch Request 接口，共包含 4 个公开字段或方法。

• 种类: 接口
• 导入: import type { ExecutionDispatchRequest } from '@codesoul-co/hypha-core';
• 源码模块: contracts/execution-port

声明

export interface ExecutionDispatchRequest {
    activity: ExecutionActivityRequest;
    binding: ExecutionToolBinding;
    riskAssessment: ExecutionRiskAssessment;
    authorization: ExecutionAuthorizationEvidence;
}

契约成员

成员	种类	签名	说明
activity	属性	activity: ExecutionActivityRequest	公开属性；类型、只读和可选状态以签名列为准。
authorization	属性	authorization: ExecutionAuthorizationEvidence	公开属性；类型、只读和可选状态以签名列为准。
binding	属性	binding: ExecutionToolBinding	公开属性；类型、只读和可选状态以签名列为准。
riskAssessment	属性	riskAssessment: ExecutionRiskAssessment	公开属性；类型、只读和可选状态以签名列为准。

ExecutionOperationDispatcher

Execution Operation Dispatcher 接口，共包含 1 个公开字段或方法。

• 种类: 接口
• 导入: import type { ExecutionOperationDispatcher } from '@codesoul-co/hypha-core';
• 源码模块: contracts/execution-port

声明

export interface ExecutionOperationDispatcher {
    dispatch(request: ExecutionActivityRequest, abortSignal: AbortSignal): Promise<ExecutionActivityResult>;
}

契约成员

成员	种类	签名	说明
dispatch	方法	dispatch(request: ExecutionActivityRequest, abortSignal: AbortSignal): Promise<ExecutionActivityResult>	公开方法；参数与返回类型以签名列为准。

ExecutionPort

Execution Port 接口，共包含 1 个公开字段或方法。

• 种类: 接口
• 导入: import type { ExecutionPort } from '@codesoul-co/hypha-core';
• 源码模块: contracts/execution-port

声明

export interface ExecutionPort {
    execute(request: ExecutionDispatchRequest, abortSignal: AbortSignal): Promise<ExecutionActivityResult>;
}

契约成员

成员	种类	签名	说明
execute	方法	execute(request: ExecutionDispatchRequest, abortSignal: AbortSignal): Promise<ExecutionActivityResult>	公开方法；参数与返回类型以签名列为准。