Interface CatalogIntentResolver

A IntentResolver backed by a catalog, with a host hook to announce catalog/default changes.

interface CatalogIntentResolver {
    available(
        archetype: string,
    ): IntentAvailability | Promise<IntentAvailability>;
    handlers(): IntentAvailability[] | Promise<IntentAvailability[]>;
    invoke(
        request: IntentRequest,
        context: IntentResolverContext,
    ): IntentResult | Promise<IntentResult>;
    notifyChanged(archetype: string): void;
    onChanged?(
        listener: (availability: IntentAvailability) => void,
    ): () => void;
}

Hierarchy (View Summary)

IntentResolver
- CatalogIntentResolver

Index

Methods

available handlers invoke notifyChanged onChanged?

Methods

available

available(archetype: string): IntentAvailability | Promise<IntentAvailability>
Report whether the runtime can currently satisfy archetype, and how.
Parameters
- archetype: string
Returns IntentAvailability | Promise<IntentAvailability>
Inherited from IntentResolver.available
- Defined in packages/services/src/intent-service.ts:75

handlers

handlers(): IntentAvailability[] | Promise<IntentAvailability[]>
Report availability for every archetype the runtime can currently satisfy.

Returns IntentAvailability[] | Promise<IntentAvailability[]>
Inherited from IntentResolver.handlers
- Defined in packages/services/src/intent-service.ts:77

invoke

invoke(
request: IntentRequest,
context: IntentResolverContext,
): IntentResult | Promise<IntentResult>
Resolve and dispatch the request.
Parameters
- request: IntentRequest
  Validated normalized intent request.
- context: IntentResolverContext
  Runtime-attested source identity.
Returns IntentResult | Promise<IntentResult>
The canonical structured dispatch result.
Inherited from IntentResolver.invoke
- Defined in packages/services/src/intent-service.ts:70

notifyChanged

notifyChanged(archetype: string): void
Announce that the catalog or default handler for archetype changed.
Parameters
- archetype: string
  Changed archetype slug.
Returns void
Nothing.
- Defined in packages/services/src/catalog-intent-resolver.ts:147

`Optional`onChanged

onChanged?(listener: (availability: IntentAvailability) => void): () => void
Register for availability changes (a napplet installed/removed, or a default handler changed). The service forwards each change to served napplets as an intent.changed push. Returns an unsubscribe handle. Resolvers whose catalog never changes at runtime MAY omit this.
Parameters
- listener: (availability: IntentAvailability) => void
Returns () => void
Inherited from IntentResolver.onChanged
- Defined in packages/services/src/intent-service.ts:84