docs: add JSDoc to addons, SteeringOptions, TimeoutOptions, AgentRegistration (#192)

Author: github-actions[bot]

skills/rig/rig.ts

@@ -728,12 +728,17 @@ export type AgentAddon = (
   context: AgentAddonContext,
   next: () => Promise<void>,
 ) => void | Promise<void>;
+/** Options for the {@link steering} addon. */
 export type SteeringOptions = {
+  /** Warning message appended to the prompt on the last available turn. Defaults to a generic "you are running out of turns" notice. */
   message?: string;
 };
+/** Options for the {@link timeout} addon. */
 export type TimeoutOptions = {
+  /** Maximum milliseconds to wait for a single agent turn before raising an `AbortError`. */
   timeout: number;
 };
+/** Callback invoked once per unique {@link Agent} instance when {@link oncePerAgent} is used. */
 export type AgentRegistration = (
   agent: Agent,
   context: AgentAddonContext,
@@ -1421,6 +1426,24 @@ export function oncePerAgent(register: AgentRegistration): AgentAddon {
   };
 }
 
+/**
+ * Namespace of built-in addon factories. Import and combine these to customize
+ * agent behaviour without modifying the core harness.
+ *
+ * | Addon | Purpose |
+ * |---|---|
+ * | `repair` | Re-prompts when the model returns invalid JSON or fails schema validation (up to `maxTurns`). Built in by default. |
+ * | `steering` | Appends a warning to the prompt on the last turn so the model knows it must correct output now. |
+ * | `timeout` | Cancels the in-flight turn via `AbortSignal` after the given number of milliseconds. |
+ * | `oncePerAgent` | Runs a registration callback exactly once per unique `Agent` instance (e.g. to register tools). |
+ *
+ * @example
+ * import { addons, agent, s } from "rig";
+ * const a = agent({
+ *   output: s.object({ answer: s.string }),
+ *   addons: [addons.steering(), addons.timeout({ timeout: 30_000 })],
+ * });
+ */
 export const addons = {
   oncePerAgent,
   timeout,