SkillKit.Webhook.Message (SkillKit v0.1.0)

Copy Markdown View Source

Composes the user-facing text and send_event/3 opts that an Inbox impl passes when emitting a delivery to the receiving agent.

This is a shared convention — any inbox impl that wants the default pointer-tag format calls these helpers. Impls with custom dispatch text (e.g. coalesced batches) can use pointer/1 as a building block or bypass this module entirely.

Summary

Functions

pointer(delivery)

The standalone pointer tag for a delivery. Attributes carry the cheap metadata inline so the agent can branch without a tool call for trivial cases. This is the user message content for a webhook delivery event.

send_event_opts(prompt, delivery, inbox_ref)

Standard send_event/3 opts for webhook delivery dispatch. Produces a scoped processing context: webhook.prompt becomes the sub-loop's system append, webhook config tools stripped, webhook_inbox injected (bound to the supplied inbox_ref), parent skills kept, activate_skill available, initial messages empty.

Functions

pointer(delivery)

@spec pointer(SkillKit.Webhook.Inbox.delivery()) :: String.t()

The standalone pointer tag for a delivery. Attributes carry the cheap metadata inline so the agent can branch without a tool call for trivial cases. This is the user message content for a webhook delivery event.

send_event_opts(prompt, delivery, inbox_ref)

@spec send_event_opts(
  String.t(),
  SkillKit.Webhook.Inbox.delivery(),
  {module(), term()}
) :: keyword()

Standard send_event/3 opts for webhook delivery dispatch. Produces a scoped processing context: webhook.prompt becomes the sub-loop's system append, webhook config tools stripped, webhook_inbox injected (bound to the supplied inbox_ref), parent skills kept, activate_skill available, initial messages empty.

inbox_ref is {InboxModule, inbox_name} — the Inbox behaviour impl and its registered process name, so the webhook_inbox tool knows which inbox to query at runtime.