Interface: ActionRuntime

Defined in: src/action/types.ts:892

Framework-neutral store and execution port for connected actions.

Properties

contractActivation

readonly contractActivation: ActionContractActivation

Defined in: src/action/types.ts:893

Methods

bindingFor()

bindingFor(binding): ActionBindingSnapshot<string> | undefined

Defined in: src/action/types.ts:960

Parameters

binding

ActionBindingRef

Returns

ActionBindingSnapshot<string> | undefined

---

bindings()

bindings(definition?): ActionBindingSnapshot<string>[]

Defined in: src/action/types.ts:959

Parameters

definition?

ActionDefinitionRef<string>

Returns

ActionBindingSnapshot<string>[]

---

channelGaps()

channelGaps(): readonly ChannelGap[]

Defined in: src/action/types.ts:909

Every kind somebody needed served and nothing could, counted.

Returns

readonly ChannelGap[]

---

connect()

Call Signature

connect<F, Id, Mode>(definition, options): ActionConnection<F, Id, true, Mode>

Defined in: src/action/types.ts:926

Connect a scalar binding whose exact payload is owned by a required live options.input reader.

Type Parameters

F

F extends (...args) => any

Id

Id extends string = string

Mode

Mode extends ActionInvocationMode = ActionInvocationMode

Parameters

definition

DefinedAction<F, Id, Mode>

options

Mode extends "scalar" ? ConnectActionOptions<Parameters<F>[0], Awaited<ReturnType<F>>, Id> & object : never

Returns

ActionConnection<F, Id, true, Mode>

Call Signature

connect<F, Id, Mode>(definition, options): ActionConnection<F, Id, false, Mode>

Defined in: src/action/types.ts:942

Connect without a bound input reader. Scalar definitions keep a required direct payload door; inputless/host definitions forbid options.input.

Type Parameters

F

F extends (...args) => any

Id

Id extends string = string

Mode

Mode extends ActionInvocationMode = ActionInvocationMode

Parameters

definition

DefinedAction<F, Id, Mode>

options

Omit<ConnectActionOptions<Mode extends "scalar" ? Parameters<F>[0] : undefined, Awaited<ReturnType<F>>, Id>, "input"> & object

Returns

ActionConnection<F, Id, false, Mode>

---

declareContext()

declareContext(declaration): DeclaredContextHandle

Defined in: src/action/types.ts:978

Declare outcome context — "what the person set with a control, still standing" — folded by the library at settlement time: the newest INVOKED verified value per key, minus any a verified release named. One live context per id.

Parameters

declaration

DeclaredContextDeclaration

Returns

DeclaredContextHandle

---

declareSurface()

declareSurface(declaration): SurfaceHandle

Defined in: src/action/types.ts:899

Declare what one frontend surface can serve — collects and shows, by kind, governed by the mounted catalog. One live surface per id.

Parameters

declaration

SurfaceDeclaration

Returns

SurfaceHandle

---

forgetTransition()

forgetTransition(transition): boolean

Defined in: src/action/types.ts:965

Release a fully settled transition from runtime history.

Parameters

transition

ActionTransitionRef

Returns

boolean

---

forPrincipal()

forPrincipal<P>(principal): PrincipalActionPort<P>

Defined in: src/action/types.ts:921

Bind offer generation and invocation to one explicit reader principal.

Type Parameters

P

P extends Principal

Parameters

principal

P

Returns

PrincipalActionPort<P>

---

kindGovernance()

kindGovernance(): KindGovernanceReport

Defined in: src/action/types.ts:896

What this runtime can say about its own kind governance — mounted or not, the fingerprint, every kind seen, and the ungoverned remainder.

Returns

KindGovernanceReport

---

openRequests()

openRequests(): readonly InputRequestSnapshot[]

Defined in: src/action/types.ts:919

Every request still open, oldest first — what a surface renders.

Returns

readonly InputRequestSnapshot[]

---

requestInput()

requestInput(input): InputRequestHandle

Defined in: src/action/types.ts:912

Ask a person for one value of a governed kind, from an offered list — the HITL request lifecycle, offered-set law included.

Parameters

input

from

Principal

of

string

offered

readonly (string | RequestChoice)[]

question

string

Returns

InputRequestHandle

---

surfacesFor()

surfacesFor(query): readonly SurfaceDeclaration[]

Defined in: src/action/types.ts:905

Who can collect this kind, or show it — and a MISS is recorded, not just returned empty: the degradation record is the backlog written by actual usage.

Parameters

query

SurfaceQuery

Returns

readonly SurfaceDeclaration[]

---

transitionFor()

transitionFor(transition): ActionTransitionSnapshot | undefined

Defined in: src/action/types.ts:961

Parameters

transition

ActionTransitionRef

Returns

ActionTransitionSnapshot | undefined

---

transitions()

transitions(query?): readonly ActionTransitionSnapshot[]

Defined in: src/action/types.ts:971

Every retained transition matching the query, OLDEST INVOCATION FIRST — the order transitions were minted, which is the order a person or agent asked for them (not the order they settled).

Parameters

query?

ActionTransitionQuery

Returns

readonly ActionTransitionSnapshot[]