NotificationsAPI
Defined in: namespaces-core-plugins.ts:632
Single outbound notification surface (fn-97). Emitters NEVER choose a channel — user-authored routing rules + the filter chain decide delivery.
emit / cancel / history are routed through the fn-89 Invoker.
fn-97
Properties
Section titled “Properties”channels
Section titled “channels”channels:
object
Defined in: namespaces-core-plugins.ts:655
Channel contributor sub-bridge (requires manifest notifications.channel contribution).
bind()
Section titled “bind()”bind(
channelId,handler):unknown
Binds the runtime handler for a manifest-declared channel. [notifications.channel.register]
Parameters
Section titled “Parameters”channelId
Section titled “channelId”string
handler
Section titled “handler”(delivery) => AnyJSONValue | Promise<AnyJSONValue>
Returns
Section titled “Returns”unknown
unbindChannel()
Section titled “unbindChannel()”unbindChannel(
channelId):unknown
Unbinds a channel handler. [notifications.channel.register]
QUIRK: named unbindChannel — unbind collides with
NSObject.unbind(_:) selector in JSExport.
Parameters
Section titled “Parameters”channelId
Section titled “channelId”string
Returns
Section titled “Returns”unknown
filters
Section titled “filters”filters:
object
Defined in: namespaces-core-plugins.ts:666
Filter contributor sub-bridge (requires manifest notifications.filter contribution).
register()
Section titled “register()”register(
filterId,evaluator):unknown
Registers a filter evaluator. [notifications.filter.register]
Parameters
Section titled “Parameters”filterId
Section titled “filterId”string
evaluator
Section titled “evaluator”(notification) => AnyJSONValue | Promise<AnyJSONValue>
Returns
Section titled “Returns”unknown
unregister()
Section titled “unregister()”unregister(
filterId):unknown
Unregisters a filter. [notifications.filter.register]
Parameters
Section titled “Parameters”filterId
Section titled “filterId”string
Returns
Section titled “Returns”unknown
Methods
Section titled “Methods”emit()
Section titled “emit()”emit(
input):Promise<NotificationHandle>
Defined in: namespaces-core-plugins.ts:638
Emits a typed notification. [notifications.emit]
NOTE: .agent-sourced emits fail with
notifications:agentAttributionUnavailable until fn-121 ships.
Parameters
Section titled “Parameters”Returns
Section titled “Returns”Promise<NotificationHandle>
cancel()
Section titled “cancel()”cancel(
notificationId):Promise<boolean>
Defined in: namespaces-core-plugins.ts:645
Cancels by notification id.
QUIRK (AD-FN97-57): returns boolean UNIFORMLY — false collapses
missing / foreign-emitter / already-terminal handles; never throws
unknownNotificationHandle in v1.
Parameters
Section titled “Parameters”notificationId
Section titled “notificationId”string
Returns
Section titled “Returns”Promise<boolean>
history()
Section titled “history()”history(
filter?):Promise<AnyJSONValue[]>
Defined in: namespaces-core-plugins.ts:647
Reads own delivery history. [notifications.log.read]
Parameters
Section titled “Parameters”filter?
Section titled “filter?”Returns
Section titled “Returns”Promise<AnyJSONValue[]>
onAction()
Section titled “onAction()”onAction(
categoryId,actionId,handler):SubscriptionHandle
Defined in: namespaces-core-plugins.ts:653
Subscribes to notification action button invocations (SYNCHRONOUS per AD-FN97-85; filtered per-emitter by the host bridge). [notifications.action.register]
Parameters
Section titled “Parameters”categoryId
Section titled “categoryId”string
actionId
Section titled “actionId”string
handler
Section titled “handler”(invocation) => void