La bibliothèque se documente elle-même · Agents et conversation

stzAgentHost

46 méthodes propres · 4 formes avec extensions, rangées sous leur méthode

la source: base/agentic/stzAgentHost.ring(s'ouvre dans un nouvel onglet) · Toutes les classes · La référence du domaine : Agents et conversation

Sous chaque méthode, ses extensions (Q CS XT Z ZZ IB W U) : en gras et cochée, elle existe ; barrée, elle n'existe pas. Les extensions et leur sens

Aucune méthode de cette classe n'est exécutée sur cette page : la classe touche aux fichiers, au réseau, aux processus, à l'horloge, au hasard ou au son, et un exemple exécuté ici ne serait que l'exemple de ses effets. Chaque méthode porte l'explication que la bibliothèque donne d'elle-même.

Méthode

Explication, telle que la source la porte

init

(sans commentaire dans la source : le nom se lit comme une phrase) initaucune extension

SetReactor

Share another host's loop (e.g. an stzAppServer's) instead of owning one -- "the agent host is the same host".aucune extension

ReactorQ

(sans commentaire dans la source : le nom se lit comme une phrase) reactor qaucune extension

Why

(sans commentaire dans la source : le nom se lit comme une phrase) whyaucune extension

SetRetirementGovernance

The governance whose decommission contract gates Retire(). NOTE: the stored @oGov is a COPY (governance is pure Haro lists -- no shared engine handle), so the decommission contract MUST be declared and fulfilled THROUGH THE HOST (below), which mutates this live copy. Fulfilling on the caller's original would leave the host's copy stale (the Haro aliasing doctrine).aucune extension

DeclareDecommission

Declare an agent's decommission obligations (retirement is earned only once all are fulfilled).aucune extension

FulfillObligation

Fulfill one obligation (mutates the host's live governance copy).aucune extension

GovernanceQ

(sans commentaire dans la source : le nom se lit comme une phrase) governance qaucune extension

Supervise

supervision ----------------------------------------------------- Register an agent to be ticked every nTickMs. The agent must be fully configured (skills, governance) BEFORE this call.aucune extension

SuperviseOnEvent

EVENT-DRIVEN supervision (R5 reactor-runtime): tick the agent once per EVENT emitted on pcChannel (the engine event bus, stzEventBus), not on a timer. The perceive-decide-act loop becomes a true event loop -- the agent reacts to what happens, when it happens. Past events are NOT replayed (the baseline is the channel's current count at registration).aucune extension

ChannelOf

The channel an agent is event-supervised on ("" if timer-supervised).aucune extension

NumberOfAgents

(sans commentaire dans la source : le nom se lit comme une phrase) number of agentsaucune extension

NameAt

The nth supervised agent's NAME -- enumeration for an observer (the appserver's /agents surface) that must not hold the agent itself.aucune extension

IsSupervising

(sans commentaire dans la source : le nom se lit comme une phrase) is supervisingaucune extension

IsActive

(sans commentaire dans la source : le nom se lit comme une phrase) is activeaucune extension

TicksOf

(sans commentaire dans la source : le nom se lit comme une phrase) ticks ofaucune extension

AgentQ

The live supervised agent (reach it here, not via a stale ref).aucune extension

Trace

(sans commentaire dans la source : le nom se lit comme une phrase) traceaucune extension

UseAgentsFrom

AND THE REFUSALS ARE NOT SWALLOWED. AgentLoadRefusals() carries every file the folder would not admit, in the unified finding shape, and CiteAgentLoadRefusals() prints them. A host that mounted three agents out of five and said nothing is the shape this exists to prevent.QCSXTZZZIBWU

AgentFolderQ

(sans commentaire dans la source : le nom se lit comme une phrase) agent folder qaucune extension

IsUsingAgentFolder

(sans commentaire dans la source : le nom se lit comme une phrase) is using agent folderaucune extension

AgentLoadRefusals

(sans commentaire dans la source : le nom se lit comme une phrase) agent load refusalsaucune extension

CiteAgentLoadRefusals

(sans commentaire dans la source : le nom se lit comme une phrase) cite agent load refusalsaucune extension

RescanAgents

Returns [ :added, :changed, :removed ] -- the file names that moved.aucune extension

Declare

the engine loop (Zig owns the tick) ----------------------------- Declare an agent's COVERAGE STATEMENT and REVERSIBILITY CLASS -- what law 18 obliges before anything schedules it. Needed only for agents that do not answer CoverageStatement() / ReversibilityClass() themselves; the host asks the agent first.QCSXTZZZIBWU

SetPriority

Higher runs first in a pass. Ties break on registration order, so the order is total and reproducible whether or not priorities are set.QCSXTZZZIBWU

PriorityOf

(sans commentaire dans la source : le nom se lit comme une phrase) priority ofaucune extension

UseEngineLoop

Adopt the Zig loop as this host's pump. Agents already supervised are registered now, so the call order does not matter -- and a refusal raises HERE, carrying the engine's own diagnostic.QCSXTZZZIBWU

UseRingLoop

(sans commentaire dans la source : le nom se lit comme une phrase) use ring loopaucune extension

IsUsingEngineLoop

(sans commentaire dans la source : le nom se lit comme une phrase) is using engine loopaucune extension

EngineLoopWhy

The engine's last refusal, verbatim. A refusal names its code, its subject and what to do -- do not paraphrase it.aucune extension

EngineSlotOf

The engine slot an agent occupies (-1 when the Haro pump is driving).aucune extension

TickDue

the perceive-act runtime --------------------------------------- Tick every ACTIVE, non-retired agent whose interval has elapsed: run ONE Cycle() (perceive-decide-act) through the live index. Returns the number of skill-firings verified this pass.aucune extension

RunFor

Drive the loop for nMs, ticking due agents. The inter-tick wait is a REAL libuv timer awaited on the engine loop thread (falls back to a Haro sleep only when no reactor DLL is present -- LAW 2).aucune extension

RunToQuiet

Run until every supervised agent reaches fixpoint (a full pass with zero firings) or the cap is hit -- the cascade at host level.aucune extension

Cancel

cancellation + governed decommission --------------------------- Stop ticking an agent WITHOUT retiring it (reversible pause).aucune extension

Resume

(sans commentaire dans la source : le nom se lit comme une phrase) resumeaucune extension

SetActionBudget

One agent acting in a loop floods everything downstream of it -- the cascading failure. A budget caps the ACTIONS (skill firings: what causes effects) an agent may take in a sliding window. An agent that exceeds it is QUARANTINED, not merely slowed: a runaway is a containment event, it stays stopped until an effectful actor releases it, and the reason says how far over it went. Both pumps account.aucune extension

ActionBudgetOf

[ :max, :windowMs, :acts ] -- the acts counted in the current windowaucune extension

Quarantine

Between a pause and a retirement: the agent stops being run, with the REASON kept, and it stays stopped -- Resume() refuses while it is quarantined. Only Release(), by an effectful, non-sandboxed actor, lifts it. A Cancel is an operator's pause; a quarantine is a containment act.aucune extension

IsQuarantined

(sans commentaire dans la source : le nom se lit comme une phrase) is quarantinedaucune extension

QuarantineOf

[ :reason, :at ] or [] when the agent is not quarantinedaucune extension

Release

(sans commentaire dans la source : le nom se lit comme une phrase) releaseaucune extension

Retire

DECOMMISSION (R4b): retirement is EARNED. When a governance is wired, the agent may retire ONLY once every declared obligation is fulfilled (MayRetire). A retired agent stops ticking permanently. Returns TRUE on retirement, FALSE (with Why()) on refusal.aucune extension

IsRetired

(sans commentaire dans la source : le nom se lit comme une phrase) is retiredaucune extension

Shutdown

teardownaucune extension