Event builder

The EventBuilder provides a chainable API for constructing events. Start a builder with client.event(), then chain methods to add data.

Starting a builder

const builder = client.event("movie-bot", { agentId: 1, sessionId: 5001 });

Parameter	Type	Required	Description
`agentType`	`string`	Yes	Agent classification (e.g., `"movie-bot"`)
`config`	`EventBuilderConfig`	No	Optional `agentId` and `sessionId` overrides

Builder methods

`action(name, params)`

Define an Action event — use this whenever your agent does something (calls an API, books a seat, sends an email).

client.event("movie-bot")
  .action("book_movie_ticket", { movie: "Interstellar", seat: "H12" })

`outcome(result)`

Attach a success outcome to the previously defined action.

outcome() requires action() earlier in the chain. Calling it without action() will throw an error.

client.event("movie-bot")
  .action("book_movie_ticket", { movie: "Interstellar", seat: "H12" })
  .outcome({ confirmation_id: "CONF-123" })

`observation(type, data, options?)`

Define an Observation event — use this when the agent receives external data that isn’t a direct message (price updates, sensor readings, API responses).

client.event("movie-bot")
  .observation("ticket_availability", { remaining_seats: 5 })

The data parameter is stored verbatim — the SDK does not validate payload fields.

`context(text, type?)`

Define a Context event for claim extraction. Use this for raw text content like conversation messages, documents, or transcripts.

client.event("movie-bot")
  .context("I want to book Interstellar for tonight.", "conversation")

`state(variables)`

Add environmental state variables to the event context.

client.event("movie-bot")
  .action("search_movies", { genre: "sci-fi" })
  .state({ mode: "strict", user_tier: "premium" })

`goal(text, priority?, progress?)`

Attach an active goal. Goals are how Minns Memory Layer groups events into episodes.

client.event("movie-bot")
  .action("book_movie_ticket", { movie: "Interstellar" })
  .goal("book_movie", 5)         // Priority 1-5
  .goal("upsell_snacks", 2, 0.0) // Second goal, lower priority

Set progress to 1.0 on the final event to mark the episode as complete. This triggers memory formation and strategy extraction.

`causedBy(parentId)`

Link the event to a parent event, building a causality chain.

client.event("movie-bot")
  .action("confirm_booking", { booking_id: "BK-42" })
  .causedBy("previous-event-id")

`build()`

Return the raw Event object without submitting it.

const event = client.event("movie-bot")
  .action("search_movies", { genre: "sci-fi" })
  .build();

// Inspect or modify the event before submitting
console.log(JSON.stringify(event, null, 2));

`send()`

Build and submit the event. Returns the server response.

const response = await client.event("movie-bot")
  .action("book_movie_ticket", { movie: "Interstellar" })
  .outcome({ confirmation_id: "CONF-123" })
  .goal("book_movie", 5, 1.0)
  .send();

`enqueue()`

Build and queue the event for background processing. Returns a local receipt immediately.

const receipt = await client.event("movie-bot")
  .observation("price_update", { movie: "Interstellar", price: 12.99 })
  .enqueue();

Full example

// Complete booking flow event
const response = await client.event("movie-bot", { agentId: 1, sessionId: 5001 })
  .action("book_movie_ticket", {
    movie: "Interstellar",
    seat: "H12",
    showtime: "2026-02-06T19:30:00Z"
  })
  .outcome({ confirmation_id: "CONF-123", total: 15.99 })
  .state({ user_tier: "premium", location: "downtown" })
  .goal("book_movie", 5, 1.0)
  .causedBy("evt-search-results")
  .send();

console.log(`Created ${response.nodes_created} nodes in ${response.processing_time_ms}ms`);

Getting started

TypeScript SDK

Guides

Starting a builder

Builder methods

`action(name, params)`

`outcome(result)`

`observation(type, data, options?)`

`context(text, type?)`

`state(variables)`

`goal(text, priority?, progress?)`

`causedBy(parentId)`

`build()`

`send()`

`enqueue()`

Full example

Next steps

Memory & strategies

Event types reference

​Starting a builder

​Builder methods

​action(name, params)

​outcome(result)

​observation(type, data, options?)

​context(text, type?)

​state(variables)

​goal(text, priority?, progress?)

​causedBy(parentId)

​build()

​send()

​enqueue()

​Full example

​Next steps

Memory & strategies

Event types reference

Starting a builder

Builder methods

`action(name, params)`

`outcome(result)`

`observation(type, data, options?)`

`context(text, type?)`

`state(variables)`

`goal(text, priority?, progress?)`

`causedBy(parentId)`

`build()`

`send()`

`enqueue()`

Full example

Next steps