Skip to content

ActionsAPI

Defined in: namespaces-core-plugins.ts:208

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

register(def, handler): Promise<string>

Defined in: namespaces-core-plugins.ts:210

Registers an executable action. Returns a handle token. [actions.register]

ActionDefinition

(input) => AnyJSONValue | Promise<AnyJSONValue>

Promise<string>


registerFromCommand(commandId, metadata): Promise<string>

Defined in: namespaces-core-plugins.ts:212

Projects an existing command into the action catalog. [actions.register]

string

Partial<ActionDefinition>

Promise<string>


invoke(id, input, source?): Promise<ActionReceipt>

Defined in: namespaces-core-plugins.ts:217

Invokes an action through the full pipeline. [actions.invoke; source “agent” additionally requires actions.invoke.agent]

string

AnyJSONValue

string

Promise<ActionReceipt>


all(): Promise<ActionDefinition[]>

Defined in: namespaces-core-plugins.ts:219

Lists merged executable + manifest-declared actions. [actions.list]

Promise<ActionDefinition[]>


unregister(handleToken): Promise<void>

Defined in: namespaces-core-plugins.ts:221

Unregisters by handle token. [actions.register]

string

Promise<void>