Reactive Triggers

// MCP tool — create_trigger
{
  "name": "auto-pin-preferences",
  "event": "on_store",
  "action": "pin",
  "filter_memory_type": "preference",
  "cooldown_seconds": 0,
  "max_fires": null,
  "enabled": true
}

// MCP tool — list_triggers  (event filter optional)
{ "event": "on_store" }

// Response
[{
  "id": "trig_01J...", "name": "auto-pin-preferences",
  "event": "on_store", "action": "pin",
  "filter_memory_type": "preference",
  "fire_count": 4, "enabled": true,
  "created_at": "2026-03-16T18:23:11Z"
}]

// MCP tool — update_trigger
{
  "trigger_id": "trig_01J...",
  "enabled": false,           // pause the trigger
  "cooldown_seconds": 300,    // add 5-minute cooldown
  "reset_fire_count": true    // reset counter to 0
}

// MCP tool — trigger_history
{ "trigger_id": "trig_01J...", "limit": 10 }

// Response
[{
  "id": "fire_01J...",
  "trigger_name": "auto-pin-preferences",
  "event": "on_store", "action": "pin",
  "node_id": "node_01J...",
  "node_label": "User prefers dark mode",
  "fired_at": "2026-03-19T09:45:01Z"
}]

from sulcus import Sulcus
client = Sulcus(api_key="sk-...")

# 1. Auto-pin preferences on store
client.create_trigger(event="on_store", action="pin",
    name="auto-pin-preferences", filter_memory_type="preference")

# 2. Spaced-repetition boost on every recall
client.create_trigger(event="on_recall", action="boost",
    name="reinforce-on-recall", action_config={"strength": 0.15})

# 3. Cold memory alert — notify when procedure cools below 0.3
client.create_trigger(event="on_decay", action="notify",
    name="cold-memory-alert", filter_memory_type="procedural",
    filter_heat_below=0.3,
    action_config={"template": "Warning: '{label}' cooling (heat: {heat:.2f})"})

# 4. Webhook to Slack when deployment procedures change
client.create_trigger(event="on_store", action="webhook",
    name="deploy-webhook", filter_memory_type="procedural",
    filter_label_pattern="deploy",
    action_config={"url": "https://hooks.slack.com/services/T000/B000/xxxx"})

# 5. Tag new episodic memories for review
client.create_trigger(event="on_store", action="tag",
    name="tag-new-episodic", filter_memory_type="episodic",
    action_config={"tag": "needs-review"})

# List
for t in client.list_triggers():
    print(f"[{'on' if t['enabled'] else 'off'}] {t['name']}  fired {t['fire_count']}x")

# History
for h in client.trigger_history(limit=10):
    print(f"  {h['fired_at']}  {h['trigger_name']}")

# Update
client.update_trigger("trig_01J...", cooldown_seconds=300, enabled=False)

# Delete
client.delete_trigger("trig_01J...")

import { Sulcus } from "@digitalforgestudios/sulcus";
const client = new Sulcus({ apiKey: "sk-..." });

// 1. Auto-pin preferences on store
await client.createTrigger("on_store", "pin", {
  name: "auto-pin-preferences", filterMemoryType: "preference" });

// 2. Spaced-repetition boost on every recall
await client.createTrigger("on_recall", "boost", {
  name: "reinforce-on-recall", actionConfig: { strength: 0.15 } });

// 3. Cold memory alert
await client.createTrigger("on_decay", "notify", {
  name: "cold-memory-alert", filterMemoryType: "procedural",
  filterHeatBelow: 0.3,
  actionConfig: { template: "Warning: '{label}' cooling (heat: {heat})" } });

// 4. Webhook to Slack on deploy procedure changes
await client.createTrigger("on_store", "webhook", {
  name: "deploy-webhook", filterMemoryType: "procedural",
  filterLabelPattern: "deploy",
  actionConfig: { url: "https://hooks.slack.com/services/T000/B000/xxxx" } });

// 5. Tag new episodic memories
await client.createTrigger("on_store", "tag", {
  name: "tag-new-episodic", filterMemoryType: "episodic",
  actionConfig: { tag: "needs-review" } });

// List
const triggers = await client.listTriggers();
triggers.forEach(t =>
  console.log(`[${t.enabled ? "on" : "off"}] ${t.name}  fired ${t.fire_count}x`));

// Update, delete, history
await client.updateTrigger("trig_01J...", { cooldownSeconds: 300, enabled: false });
await client.deleteTrigger("trig_01J...");
const history = await client.triggerHistory({ limit: 10 });