ActionsAPI
Defined in: namespaces-core-plugins.ts:232
Public Action Fabric (fn-89): validate → permission → approve → execute → receipt.
NOTE: all() may return manifest-only entries (badged “manifest only”)
that surface ACTION_NOT_FOUND on invoke until the executable handler
binds via register().
fn-89
Methods
Section titled “Methods”register()
Section titled “register()”register(
def,handler):Promise<string>
Defined in: namespaces-core-plugins.ts:241
Registers an executable action. Returns a handle token. [actions.register]
The handler is invoked with a single ActionExecutionContext
argument carrying the validated input plus invocation metadata
(invocationId, source, optional sourceId) — NOT the raw input
value. Read the action input via exec.input.
Parameters
Section titled “Parameters”handler
Section titled “handler”(exec) => AnyJSONValue | Promise<AnyJSONValue>
Returns
Section titled “Returns”Promise<string>
registerFromCommand()
Section titled “registerFromCommand()”registerFromCommand(
commandId,metadata):Promise<string>
Defined in: namespaces-core-plugins.ts:243
Projects an existing command into the action catalog. [actions.register]
Parameters
Section titled “Parameters”commandId
Section titled “commandId”string
metadata
Section titled “metadata”Partial<ActionDefinition>
Returns
Section titled “Returns”Promise<string>
invoke()
Section titled “invoke()”invoke(
id,input,source?):Promise<ActionReceipt>
Defined in: namespaces-core-plugins.ts:248
Invokes an action through the full pipeline. [actions.invoke; source “agent” additionally requires actions.invoke.agent]
Parameters
Section titled “Parameters”string
source?
Section titled “source?”string
Returns
Section titled “Returns”Promise<ActionReceipt>
all():
Promise<ActionDefinition[]>
Defined in: namespaces-core-plugins.ts:250
Lists merged executable + manifest-declared actions. [actions.list]
Returns
Section titled “Returns”Promise<ActionDefinition[]>
unregister()
Section titled “unregister()”unregister(
handleToken):Promise<void>
Defined in: namespaces-core-plugins.ts:252
Unregisters by handle token. [actions.register]
Parameters
Section titled “Parameters”handleToken
Section titled “handleToken”string
Returns
Section titled “Returns”Promise<void>