执行与工作流

Core · 接口与运行保证 · 返回本层目录

符号	类别	用途
AgentBranch	interface	Immutable identity of one branch of an agent. The three required ids are generated per engine unless the host restores a branch; the optional ids are only present on a fork and record the exact origin, so a forked run can be attributed without consulting external storage.
AgentCacheAddress	interface	Exact immutable address passed to the App port, including cancellation for this visit.
AgentCacheOptions	interface	Persistent and volatile storage are independent; there is no implicit fallback or mirroring.
AgentCachePort	interface	App-owned storage. Capacity, expiry, serialization and user isolation belong to the App.
AgentCheckpoint	interface	In-memory checkpoint with a copy-on-read accessor. The stored data is already a clone, and read clones again, so a caller cannot mutate the checkpoint by mutating what it read.
AgentCheckpointRecord	interface	Host-owned serializable data, never a saved credential, model budget or executable handler.
AgentCoreEngine	class	Bounded execution shared by applications; business rules are registered by each host. Configuration is bound before a run and may be bound only once per model, tool runtime and workflow. A run resolves its signal from the engine, the request runtime and the caller, then executes either the bound workflow or a supplied step function until the round budget, cancellation or a completion stops it.
AgentCoreEngineOptions	interface	Engine construction options.
AgentCoreEngineSetup	type	Engine construction options. Combines round budget and error factories with exactly one model shape (a single bound model or a named catalog), an optional tool runtime, an optional branch identity, and an optional workflow together with its App dependencies.
AgentModelBinding	type	Model binding accepted by the engine. Execution scope belongs to the engine, so a bound model may not carry its own signal or execution options.
AgentModelRuntime	type	The subset of a runner an engine may drive; kept small so the App can supply it.
AgentWorkflow	class	Executable catalog: validate references and bounded cycles before any handler runs. Validation happens once, at construction, so traversal can assume every target exists and every cycle is budget-bounded.
AgentWorkflowDefinition	type	The graph an engine executes.
AttemptBudget	class	Successful acquisitions consume attempts; a refused acquisition never grants another. available is a snapshot of the counter, not a reservation: a caller must still call take and honor its boolean result before acting.
CacheContext	interface	Cache access shared by workflow visits and the low-level $step loop.
CacheReadOptions	interface	Only reads may name another node. Partition names are not authorization boundaries.
CoreStep	type	One loop iteration. Must be re-entrant: the same step object runs every round.
defineWorkflow	function	Build a validated workflow from a definition.
EngineCacheOptions	interface	Optional Engine memory bounds; TTL is measured from the latest write.
ExecutionEventDescriptor	interface	Event name, content class and the producing execution identity.
ExecutionObserver	interface	Live consumer of Core facts.
LoopEvent	interface	Progress fact for one loop round, correlated with the enclosing diagnostics span.
NodeAgentCache	interface	Async node view. Writes and clear can only address the current partition.
NodeCache	interface	Synchronous view of the current node's Engine-owned memory. Values retain identity.
requireWorkflowValue	function	Read a state field that must already be present. Used by requires declarations and terminal deliveries, so a node cannot observe a field as undefined and silently produce a wrong result.
route	function
StepOutcome	type	Decision a step returns to the engine.
WorkflowChain	interface	Observed visits, never merged by static node id or synthesized from adjacency.
WorkflowChainCoverage	interface	Capture completeness is independent of whether diagnostic content was included.
WorkflowChainNode	interface	A single node visit, with flat ordered subflow records including every independent fix.
WorkflowChainNodeEvent	interface	Node-local lifecycle facts; payload remains subject to the source's content policy.
WorkflowChainSource	type	App resolves authorization, retention, pagination and storage paths before returning.
WorkflowChainTransition	interface	Actual handoff evidence; a target span does not prove its enter event was captured.
WorkflowContext	interface	Execution facts available to every node of a running workflow.
WorkflowEvent	interface	Metadata only: never includes state, prompt, parameters, results or raw errors.
WorkflowExtension	interface	Additional nodes and routes merged into an existing definition.
WorkflowFailure	interface	Error retained only while entering a registered failure phase.
WorkflowGraph	interface	Pure registered topology; routes sharing a target share an edge within one kind.
WorkflowGraphEdge	interface	Completion has no target node; recovery edges remain distinct from normal edges.
WorkflowGraphNode	interface	Node metadata and derived incident edges, without executable callbacks.
WorkflowGraphRoute	interface	Declaration order is retained even when multiple routes share a topology edge.
WorkflowModel	interface	Model and tool access for one workflow invocation. Every call is charged to the workflow's shared budget. Overloads select the transport: a prepared call, the default plain-text transport, or one registered transport with its typed result.
WorkflowNode	type	One node of the graph.
WorkflowNodeReport	interface	Detail an App node reports about its current visit.
WorkflowRoute	type	One route out of a node. Routes are evaluated in array order and the first match wins. A route either continues at targetNodeId or completes the workflow through complete; declaring both is invalid.
WorkflowSubflowRecord	type	Historical subflow snapshots may omit recorder fields or descriptive content.