Example NCP Triggers

Each example is valid against the NCP v0.1 Zod schema and demonstrates route, sensitivity, evidence, delivery policy, and action boundaries.

api.usage.spike

OpenAI API usage spike

OpenAI API usage increased unusually and may create unexpected project costs.

highfinancial
Route
cost_guardian
Urgency
same_hour
Confidence
96%
{
  "ncp_version": "0.1",
  "type": "trigger",
  "id": "trg_openai_cost_spike_2026_05_23",
  "source": {
    "system": "openai",
    "event_type": "api.usage.spike"
  },
  "timestamp": "2026-05-23T18:42:00Z",
  "domain": "cost_management",
  "subject": "OpenAI API usage spike",
  "summary": "OpenAI API usage increased unusually and may create unexpected project costs.",
  "severity": "high",
  "confidence": 0.96,
  "sensitivity": "financial",
  "personal_relevance": 0.94,
  "evidence": [
    {
      "label": "daily_cost",
      "value": 49,
      "unit": "USD",
      "detail": "Daily usage exceeded normal baseline."
    },
    {
      "label": "projected_monthly_cost",
      "value": 1470,
      "unit": "USD",
      "detail": "Projected if usage continues at same rate."
    }
  ],
  "context_refs": [
    {
      "type": "mcp",
      "ref": "mcp://openai/usage/2026-05-23",
      "description": "OpenAI usage details",
      "sensitivity": "financial"
    }
  ],
  "recommended_route": {
    "agent": "cost_guardian",
    "project": "poclab",
    "domain": "finance.ops"
  },
  "action_contract": {
    "allowed_without_approval": [
      "summarize_usage",
      "identify_likely_source",
      "draft_fix"
    ],
    "requires_approval": [
      "disable_function",
      "rotate_api_key",
      "change_billing_limit"
    ],
    "forbidden": [
      "delete_project"
    ]
  },
  "delivery_policy": {
    "urgency": "same_hour",
    "channels": [
      "app",
      "push"
    ],
    "quiet_hours_respected": false
  },
  "tags": [
    "api",
    "cost",
    "billing",
    "anomaly"
  ]
}

security.secret_scanning_alert

Possible compromised GitHub secret

GitHub detected a possible exposed secret in a repository.

criticalsecret
Route
security_agent
Urgency
interrupt_now
Confidence
98%
{
  "ncp_version": "0.1",
  "type": "trigger",
  "id": "trg_github_secret_exposed_2026_05_23",
  "source": {
    "system": "github",
    "event_type": "security.secret_scanning_alert"
  },
  "timestamp": "2026-05-23T20:15:00Z",
  "domain": "security",
  "subject": "Possible compromised GitHub secret",
  "summary": "GitHub detected a possible exposed secret in a repository.",
  "severity": "critical",
  "confidence": 0.98,
  "sensitivity": "secret",
  "personal_relevance": 0.99,
  "evidence": [
    {
      "label": "secret_type",
      "value": "api_key",
      "status": "red"
    },
    {
      "label": "repository",
      "value": "poclab/example-project"
    }
  ],
  "context_refs": [
    {
      "type": "mcp",
      "ref": "mcp://github/security/secret-alerts/123",
      "description": "GitHub secret scanning alert",
      "sensitivity": "secret"
    }
  ],
  "recommended_route": {
    "agent": "security_agent",
    "project": "poclab",
    "domain": "security.ops"
  },
  "action_contract": {
    "allowed_without_approval": [
      "summarize_alert",
      "identify_affected_repo",
      "draft_rotation_steps",
      "check_recent_usage"
    ],
    "requires_approval": [
      "revoke_key",
      "rotate_secret",
      "open_pull_request"
    ],
    "forbidden": [
      "publish_secret",
      "send_secret_to_external_service"
    ]
  },
  "delivery_policy": {
    "urgency": "interrupt_now",
    "channels": [
      "app",
      "push",
      "sms"
    ],
    "quiet_hours_respected": false
  },
  "tags": [
    "security",
    "github",
    "secret",
    "critical"
  ]
}

calendar.conflict

School pickup conflict detected

A calendar event conflicts with protected school pickup time.

criticalfamily
Route
family_logistics_agent
Urgency
interrupt_now
Confidence
91%
{
  "ncp_version": "0.1",
  "type": "trigger",
  "id": "trg_school_pickup_conflict_2026_05_23",
  "source": {
    "system": "calendar",
    "event_type": "calendar.conflict"
  },
  "timestamp": "2026-05-23T16:00:00Z",
  "domain": "family.logistics",
  "subject": "School pickup conflict detected",
  "summary": "A calendar event conflicts with protected school pickup time.",
  "severity": "critical",
  "confidence": 0.91,
  "sensitivity": "family",
  "personal_relevance": 1,
  "evidence": [
    {
      "label": "protected_time",
      "value": "school_pickup"
    },
    {
      "label": "conflicting_event",
      "value": "Customer meeting"
    }
  ],
  "context_refs": [
    {
      "type": "mcp",
      "ref": "mcp://calendar/events/conflict-456",
      "description": "Calendar conflict details",
      "sensitivity": "family"
    }
  ],
  "recommended_route": {
    "agent": "family_logistics_agent",
    "domain": "family"
  },
  "action_contract": {
    "allowed_without_approval": [
      "summarize_conflict",
      "suggest_reschedule_options",
      "draft_message"
    ],
    "requires_approval": [
      "reschedule_event",
      "send_message",
      "create_calendar_event"
    ],
    "forbidden": [
      "cancel_school_pickup"
    ]
  },
  "delivery_policy": {
    "urgency": "interrupt_now",
    "channels": [
      "app",
      "push",
      "sms"
    ],
    "quiet_hours_respected": false
  },
  "tags": [
    "family",
    "calendar",
    "pickup",
    "conflict"
  ]
}

mountain.readiness_window

Mount Rainier climb window is opening

SummitOS detected that weather, wind, route timing, calendar availability, and readiness signals are aligned for a Mount Rainier climb attempt.

opportunityprivate
Route
summitos_mountaineering_agent
Urgency
same_hour
Confidence
89%
{
  "ncp_version": "0.1",
  "type": "trigger",
  "id": "trg_summitos_rainier_window_2026_05_23",
  "source": {
    "system": "summitos.com",
    "event_type": "mountain.readiness_window"
  },
  "timestamp": "2026-05-23T12:00:00Z",
  "domain": "adventure.mountaineering",
  "subject": "Mount Rainier climb window is opening",
  "summary": "SummitOS detected that weather, wind, route timing, calendar availability, and readiness signals are aligned for a Mount Rainier climb attempt.",
  "severity": "opportunity",
  "confidence": 0.89,
  "sensitivity": "private",
  "personal_relevance": 0.97,
  "evidence": [
    {
      "label": "weather_window",
      "value": "favorable",
      "status": "green"
    },
    {
      "label": "wind_forecast",
      "value": "below threshold",
      "status": "green"
    },
    {
      "label": "calendar_availability",
      "value": "available",
      "status": "green"
    },
    {
      "label": "gear_readiness",
      "value": "needs confirmation",
      "status": "yellow"
    }
  ],
  "context_refs": [
    {
      "type": "url",
      "ref": "https://summitos.com/mountains/rainier/windows/next",
      "description": "SummitOS climb window analysis",
      "sensitivity": "private"
    }
  ],
  "recommended_route": {
    "agent": "summitos_mountaineering_agent",
    "project": "summitos",
    "domain": "adventure"
  },
  "action_contract": {
    "allowed_without_approval": [
      "create_climb_brief",
      "generate_gear_checklist",
      "prepare_risk_summary",
      "compare_route_options"
    ],
    "requires_approval": [
      "book_permit",
      "reserve_lodging",
      "message_partner",
      "create_calendar_event"
    ],
    "forbidden": [
      "confirm_climb_without_user"
    ]
  },
  "delivery_policy": {
    "urgency": "same_hour",
    "channels": [
      "app",
      "push"
    ],
    "quiet_hours_respected": true
  },
  "tags": [
    "summitos",
    "rainier",
    "mountaineering",
    "weather-window"
  ]
}

finance.bill_due

Credit card bill due soon

A credit card bill is due soon and should be reviewed before payment.

mediumfinancial
Route
finance_agent
Urgency
daily_digest
Confidence
93%
{
  "ncp_version": "0.1",
  "type": "trigger",
  "id": "trg_credit_card_bill_due_2026_05_23",
  "source": {
    "system": "bank_alerts",
    "event_type": "finance.bill_due"
  },
  "timestamp": "2026-05-23T15:30:00Z",
  "domain": "finance.obligations",
  "subject": "Credit card bill due soon",
  "summary": "A credit card bill is due soon and should be reviewed before payment.",
  "severity": "medium",
  "confidence": 0.93,
  "sensitivity": "financial",
  "personal_relevance": 0.9,
  "evidence": [
    {
      "label": "due_in_hours",
      "value": 72,
      "unit": "hours",
      "detail": "Bill is approaching its due date."
    },
    {
      "label": "payment_status",
      "value": "not_confirmed",
      "status": "yellow"
    }
  ],
  "context_refs": [
    {
      "type": "mcp",
      "ref": "mcp://finance/bills/credit-card/latest",
      "description": "Bill details and payment status",
      "sensitivity": "financial"
    }
  ],
  "recommended_route": {
    "agent": "finance_agent",
    "domain": "finance"
  },
  "action_contract": {
    "allowed_without_approval": [
      "summarize_bill",
      "check_cashflow",
      "draft_payment_plan"
    ],
    "requires_approval": [
      "make_payment",
      "change_autopay",
      "move_funds"
    ],
    "forbidden": [
      "share_bank_details",
      "store_card_number"
    ]
  },
  "delivery_policy": {
    "urgency": "daily_digest",
    "channels": [
      "app",
      "email"
    ],
    "quiet_hours_respected": true
  },
  "tags": [
    "finance",
    "bill",
    "credit-card",
    "obligation"
  ]
}