Skip to content

@codesoul-co/hypha-core / modules/execution-human-task/index

Using this module

Use the Index module for executing runtime behavior at this boundary. It exports 7 constants, 3 functions, 1 interface.

Import from the package entrypoint

ts
import {
  executionHumanTaskSubjectDefinition,
  executionHumanTaskSubjectDefinitions,
  executionHumanTaskSubjectEnvelopeSchema,
  executionHumanTaskSubjectExample,
  executionHumanTaskSubjectJsonSchema,
  executionHumanTaskSubjectJsonSchemas,
  executionHumanTaskSubjectSchema,
  createExecutionHumanTaskSubject,
} from '@codesoul-co/hypha-core';

import type {
  CreateExecutionHumanTaskSubjectInput,
} from '@codesoul-co/hypha-core';

// The complete export list is documented below.

Usage patterns

  • Use the 1 type/interface export as static contracts in application code, adapters, or tests. Import them with import type; they do not exist at runtime.
  • The module exposes 3 functions as direct operation entrypoints. Every overload, required/optional parameter, and return type is documented below.
  • The 7 constant/enum exports provide stable values, schemas, definitions, or defaults. Reuse these exports instead of copying internal values into an application.

Runtime validation example

ts
import { executionHumanTaskSubjectEnvelopeSchema } from '@codesoul-co/hypha-core';

declare function loadExternalInput(): unknown;
const input: unknown = loadExternalInput();
const parsed = executionHumanTaskSubjectEnvelopeSchema.parse(input);

Parse untrusted configuration, network, or persisted input with the runtime schema before passing it to functions or classes that expect a validated contract.

Public exports

SymbolKindSignatureDescription
executionHumanTaskSubjectDefinitionconstantconst executionHumanTaskSubjectDefinition: SpecSchemaDefinition<ExecutionHumanTaskSubject>Execution Human Task Subject Definition constant exported by the modules/execution-human-task/index module.
executionHumanTaskSubjectDefinitionsconstantconst executionHumanTaskSubjectDefinitions: readonly [SpecSchemaDefinition<ExecutionHumanTaskSubject>]Execution Human Task Subject Definitions constant exported by the modules/execution-human-task/index module.
executionHumanTaskSubjectEnvelopeSchemaconstantconst executionHumanTaskSubjectEnvelopeSchema: z.ZodEffects<z.ZodObject<{ subjectRef: z.ZodString; subjectHash: z.ZodString; subject: z.ZodObject<{ id: z.ZodString; version: z.ZodLiteral<"1.0.0">; kind: z.ZodLiteral<"execution">; capturedAt: z.ZodString; principalId: z.ZodString; inputHash: z.ZodString; activity: z.ZodObject<{ activityId: z.ZodString; operationId: z.ZodString; runId: z.ZodString; stateAttemptId: z...Runtime schema for Execution Human Task Subject Envelope.
executionHumanTaskSubjectExampleconstantconst executionHumanTaskSubjectExample: ExecutionHumanTaskSubjectValid example value for Execution Human Task Subject.
executionHumanTaskSubjectJsonSchemaconstantconst executionHumanTaskSubjectJsonSchema: JsonSchemaJSON Schema for Execution Human Task Subject.
executionHumanTaskSubjectJsonSchemasconstantconst executionHumanTaskSubjectJsonSchemas: Record<string, JsonSchema>Execution Human Task Subject JSON Schemas constant exported by the modules/execution-human-task/index module.
executionHumanTaskSubjectSchemaconstantconst executionHumanTaskSubjectSchema: z.ZodObject<{ id: z.ZodString; version: z.ZodLiteral<"1.0.0">; kind: z.ZodLiteral<"execution">; capturedAt: z.ZodString; principalId: z.ZodString; inputHash: z.ZodString; activity: z.ZodObject<{ activityId: z.ZodString; operationId: z.ZodString; runId: z.ZodString; stateAttemptId: z.ZodString; workspaceId: z.ZodString; fencingToken: z.ZodNumber; deadlineAt: z.ZodOptional<z.Zo...Runtime schema for Execution Human Task Subject.
createExecutionHumanTaskSubjectfunctioncreateExecutionHumanTaskSubject(input: CreateExecutionHumanTaskSubjectInput): ExecutionHumanTaskSubjectEnvelopeCreate Execution Human Task Subject function with 1 public call signature; parameters and return types are listed below.
validateExecutionHumanTaskSubjectfunctionvalidateExecutionHumanTaskSubject(input: unknown): ExecutionHumanTaskSubjectValidate Execution Human Task Subject function with 1 public call signature; parameters and return types are listed below.
validateExecutionHumanTaskSubjectEnvelopefunctionvalidateExecutionHumanTaskSubjectEnvelope(input: unknown): ExecutionHumanTaskSubjectEnvelopeValidate Execution Human Task Subject Envelope function with 1 public call signature; parameters and return types are listed below.
CreateExecutionHumanTaskSubjectInputinterfaceinterface CreateExecutionHumanTaskSubjectInputCreate Execution Human Task Subject Input interface with 10 public fields or methods.

executionHumanTaskSubjectDefinition

Execution Human Task Subject Definition constant exported by the modules/execution-human-task/index module.

Declaration

text
export declare const executionHumanTaskSubjectDefinition: SpecSchemaDefinition<ExecutionHumanTaskSubject>;

executionHumanTaskSubjectDefinitions

Execution Human Task Subject Definitions constant exported by the modules/execution-human-task/index module.

Declaration

text
export declare const executionHumanTaskSubjectDefinitions: readonly [SpecSchemaDefinition<ExecutionHumanTaskSubject>];

executionHumanTaskSubjectEnvelopeSchema

Runtime schema for Execution Human Task Subject Envelope.

Declaration

text
// Exact type resolved from the package entrypoint; see source for the compiler expansion.
export declare const executionHumanTaskSubjectEnvelopeSchema: (typeof import('@codesoul-co/hypha-core'))['executionHumanTaskSubjectEnvelopeSchema'];

This compiler-expanded constant type is compacted. Its public name, top-level type, and source location remain here; use the module’s exported interfaces, types, or runtime schema for input/output fields.

executionHumanTaskSubjectExample

Valid example value for Execution Human Task Subject.

Declaration

text
export declare const executionHumanTaskSubjectExample: ExecutionHumanTaskSubject;

executionHumanTaskSubjectJsonSchema

JSON Schema for Execution Human Task Subject.

Declaration

text
export declare const executionHumanTaskSubjectJsonSchema: JsonSchema;

executionHumanTaskSubjectJsonSchemas

Execution Human Task Subject JSON Schemas constant exported by the modules/execution-human-task/index module.

Declaration

text
export declare const executionHumanTaskSubjectJsonSchemas: Record<string, JsonSchema>;

executionHumanTaskSubjectSchema

Runtime schema for Execution Human Task Subject.

Declaration

text
// Exact type resolved from the package entrypoint; see source for the compiler expansion.
export declare const executionHumanTaskSubjectSchema: (typeof import('@codesoul-co/hypha-core'))['executionHumanTaskSubjectSchema'];

This compiler-expanded constant type is compacted. Its public name, top-level type, and source location remain here; use the module’s exported interfaces, types, or runtime schema for input/output fields.

createExecutionHumanTaskSubject

Create Execution Human Task Subject function with 1 public call signature; parameters and return types are listed below.

Declaration

text
export declare function createExecutionHumanTaskSubject(input: CreateExecutionHumanTaskSubjectInput): ExecutionHumanTaskSubjectEnvelope;

Call signature

text
createExecutionHumanTaskSubject(input: CreateExecutionHumanTaskSubjectInput): ExecutionHumanTaskSubjectEnvelope

Parameters

ParameterTypeRequiredDescription
inputCreateExecutionHumanTaskSubjectInputYesRequired parameter; accepted values are defined by the type column.

Returns

  • Type: ExecutionHumanTaskSubjectEnvelope
  • Description: The return contract is defined by the type shown above.

validateExecutionHumanTaskSubject

Validate Execution Human Task Subject function with 1 public call signature; parameters and return types are listed below.

Declaration

text
export declare function validateExecutionHumanTaskSubject(input: unknown): ExecutionHumanTaskSubject;

Call signature

text
validateExecutionHumanTaskSubject(input: unknown): ExecutionHumanTaskSubject

Parameters

ParameterTypeRequiredDescription
inputunknownYesRequired parameter; accepted values are defined by the type column.

Returns

  • Type: ExecutionHumanTaskSubject
  • Description: The return contract is defined by the type shown above.

validateExecutionHumanTaskSubjectEnvelope

Validate Execution Human Task Subject Envelope function with 1 public call signature; parameters and return types are listed below.

Declaration

text
export declare function validateExecutionHumanTaskSubjectEnvelope(input: unknown): ExecutionHumanTaskSubjectEnvelope;

Call signature

text
validateExecutionHumanTaskSubjectEnvelope(input: unknown): ExecutionHumanTaskSubjectEnvelope

Parameters

ParameterTypeRequiredDescription
inputunknownYesRequired parameter; accepted values are defined by the type column.

Returns

  • Type: ExecutionHumanTaskSubjectEnvelope
  • Description: The return contract is defined by the type shown above.

CreateExecutionHumanTaskSubjectInput

Create Execution Human Task Subject Input interface with 10 public fields or methods.

Declaration

text
export interface CreateExecutionHumanTaskSubjectInput {
    activity: ExecutionActivityRequest;
    binding: ExecutionToolBinding;
    toolRevision?: string;
    riskAssessment: ExecutionRiskAssessment;
    environment: ExecutionEnvironmentSpec;
    providerId: string;
    providerRevision: string;
    inputHash: string;
    policyDecisionRef: string;
    capturedAt: string;
}

Contract members

MemberKindSignatureDescription
activitypropertyactivity: ExecutionActivityRequestPublic property; its type, readonly modifier and optionality are shown in the signature.
bindingpropertybinding: ExecutionToolBindingPublic property; its type, readonly modifier and optionality are shown in the signature.
capturedAtpropertycapturedAt: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
environmentpropertyenvironment: ExecutionEnvironmentSpecPublic property; its type, readonly modifier and optionality are shown in the signature.
inputHashpropertyinputHash: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
policyDecisionRefpropertypolicyDecisionRef: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
providerIdpropertyproviderId: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
providerRevisionpropertyproviderRevision: stringPublic property; its type, readonly modifier and optionality are shown in the signature.
riskAssessmentpropertyriskAssessment: ExecutionRiskAssessmentPublic property; its type, readonly modifier and optionality are shown in the signature.
toolRevisionpropertytoolRevision?: stringPublic property; its type, readonly modifier and optionality are shown in the signature.