surface-on-context-match

workflow inform

A skill of the SOM skill library 0.2.2, as SOM Managed Bus checks its configured instances. The library file is the specification; this page is generated from the bus's code.

Skill id	smart-stories/surface-on-context-match
Version	0.2.2 (suite som-1.0.0+lib-0.2.2)
Category	workflow
Severity range	inform
Authority scale	Required: the skill compares authorities, so each configured instance carries your scale, most senior first

Recalls on

An executor running this skill subscribes to these message types, and always to story.context (the executor contract).

Message type	Spec
source.item.observed	pending spec no SOM 1.0 schema: what that means
story.context	SOM 1.0 schema: story-context

1 of these 2 has no SOM 1.0 schema yet: an executor uses it only as a wake-up.

Configuration

A configured instance sets these values, with its own instance_label (every warning it raises carries it as rule_id). Unknown fields are refused, so a typo never falls back to a default.

Field	Kind	Required	What it is
monitored_source	text	Yes	The one source this instance watches
match_field	text	Yes	The dot path of the item's field read (the item's, not the story's)
match_against	path	Yes	The story-side field the item is read against, for example tags[].value
match_threshold	fraction	Yes	The confidence at or above which an item is surfaced, from 0 to 1
surface_as	text	Yes	What the match is shown as, for example enrichment
carry	texts	Yes	The provenance fields required on a surfaced item
max_surfaced_per_window	count	No	A cap on items surfaced in a window
clearing_authority	authority	Yes	The authority at or above which an assertion on the same scope closes a declaration. On the authority scale

What each kind accepts: field kinds.

Check your values

Check a configured instance before you register it, with the skill catalogue API; nothing is stored. A publisher registers it on the portal: Run skills in your house.

---

All skills: skill library catalogue.