@onlooker-community/schema 0.1.0

package/README.md

@@ -0,0 +1,141 @@
+# @onlooker-community/schema
+
+Canonical event schema for the Onlooker ecosystem. Every plugin, adapter, and the daemon itself depends on this package to agree on the shape of telemetry.
+
+## Install
+
+```bash
+npm install @onlooker-community/schema
+```
+
+## Quick start
+
+```ts
+import {
+  createEvent,
+  validate,
+  isEventOfType,
+  TRIBUNAL_VERDICT,
+} from "@onlooker-community/schema";
+
+const event = createEvent({
+  runtime: "claude-code",
+  plugin: "tribunal",
+  machine_id: "11111111-2222-3333-4444-555555555555",
+  session_id: "session-abc",
+  event_type: TRIBUNAL_VERDICT,
+  payload: {
+    task_id: "task-1",
+    score: 0.92,
+    passed: true,
+    judge_type: "standard",
+  },
+});
+
+const result = validate(event);
+if (!result.valid) {
+  for (const err of result.errors) console.error(`${err.path}: ${err.message}`);
+  process.exit(1);
+}
+
+if (isEventOfType(result.event, TRIBUNAL_VERDICT)) {
+  // result.event.payload is narrowed to TribunalVerdictPayload
+  console.log(result.event.payload.judge_type);
+}
+```
+
+## Event envelope
+
+```ts
+interface OnlookerEvent<T extends EventType = EventType> {
+  id: string;                  // UUID
+  schema_version: "1.0";
+  runtime: RuntimeId;          // "claude-code" | "cursor" | "copilot" | "gemini" | "custom"
+  adapter_id?: string;
+  plugin: string;
+  machine_id: string;          // UUID
+  timestamp: string;           // ISO 8601 UTC
+  session_id: string;
+  sequence: number;            // monotonic, ≥ 0
+  event_type: T;
+  payload: PayloadFor<T>;
+  cost_usd?: number;
+  token_count?: number;
+  redacted?: boolean;
+}
+```
+
+## Namespaces
+
+| Namespace      | Events                                                                                                                  |
+| -------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| `session`      | `start`, `end`, `compact`, `prompt`                                                                                     |
+| `task`         | `start`, `complete`, `fail`                                                                                             |
+| `tool`         | `file.read`, `file.write`, `file.edit`, `shell.exec`, `web.fetch`, `agent.spawn`, `agent.complete`                      |
+| `sentinel`     | `blocked`, `allowed`, `reviewed`                                                                                        |
+| `tribunal`     | `verdict`, `actor.complete`, `meta.complete`                                                                            |
+| `warden`       | `threat.detected`, `threat.cleared`, `gate.blocked`                                                                     |
+| `oracle`       | `calibration.requested`, `calibration.complete`                                                                         |
+| `archivist`    | `extract.complete`, `inject.complete`                                                                                   |
+| `relay`        | `handoff.captured`, `handoff.injected`                                                                                  |
+| `scribe`       | `capture.complete`, `distill.complete`                                                                                  |
+| `cues`         | `matched`, `applied`                                                                                                    |
+| `cartographer` | `audit.complete`, `issue.found`                                                                                         |
+| `ledger`       | `budget.warning`, `budget.exceeded`, `session.complete`                                                                 |
+| `echo`         | `suite.started`, `suite.complete`, `regression.detected`                                                                |
+| `counsel`      | `brief.generated`                                                                                                       |
+| `onlooker`     | `session.summary`                                                                                                       |
+| `meridian`     | `hint.generated`, `hint.delivered`, `outcome.recorded`, `reliance.measured`, `lesson.curated`, `playbook.updated`       |
+
+## API surface
+
+### Values
+
+- `createEvent(params)` — factory that fills in `id`, `timestamp`, `sequence`, `schema_version`, and `redacted: false`.
+- `validate(raw)` — returns `{ valid: true, event } | { valid: false, errors }`.
+- `validateOrThrow(raw)` — returns the typed event or throws with field paths in the message.
+- `isEventOfType(event, type)` — type guard that narrows `payload` to the matching interface.
+- `isEventType(value)` — runtime check that a string is a known event type.
+- `ALL_EVENT_TYPES` — `readonly EventType[]` of every known type.
+- One typed string constant per event (e.g. `SENTINEL_BLOCKED`, `MERIDIAN_HINT_GENERATED`).
+- `_resetSequence()` — resets the module-level sequence counter. Tests only.
+
+### Types
+
+- `OnlookerEvent<T>`, `PayloadFor<T>`, `EventType`, `RuntimeId`.
+- One payload interface per event type (`SentinelBlockedPayload`, `TribunalVerdictPayload`, …).
+- `ValidationResult`, `ValidationErrorDetail`, `CreateEventParams<T>`.
+
+## JSON Schema files
+
+The raw JSON Schema (draft 2020-12) files are shipped alongside the JS for non-TypeScript consumers (Go, Python, Rust, …):
+
+```ts
+import envelope from "@onlooker-community/schema/schemas/event.v1.json" with { type: "json" };
+import sessionPayloads from "@onlooker-community/schema/schemas/payload/session.json" with { type: "json" };
+```
+
+Or resolve paths with `node`'s package resolution:
+
+```bash
+node -p "require.resolve('@onlooker-community/schema/schemas/event.v1.json')"
+```
+
+## Versioning policy
+
+- The `schema_version` field is locked at `"1.0"` for the entire `1.x` line of this package.
+- Adding a new event type, adding an optional payload field, or relaxing an enum is a **minor** release.
+- Removing an event type, making an optional field required, tightening an enum, or changing `additionalProperties` is a **major** release and bumps `schema_version`.
+- Payload schemas for `task.start`, `task.complete`, and `task.fail` are intentionally minimal in `1.0.0` and will be filled in during the `1.x` line.
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run validate-schemas
+npm run build
+```
+
+`npm run prepublishOnly` runs `build`, `validate-schemas`, and `test` and is enforced before publishing.

package/dist/event-types.d.ts

@@ -0,0 +1,53 @@
+export declare const SESSION_START: "session.start";
+export declare const SESSION_END: "session.end";
+export declare const SESSION_COMPACT: "session.compact";
+export declare const SESSION_PROMPT: "session.prompt";
+export declare const TASK_START: "task.start";
+export declare const TASK_COMPLETE: "task.complete";
+export declare const TASK_FAIL: "task.fail";
+export declare const TOOL_FILE_READ: "tool.file.read";
+export declare const TOOL_FILE_WRITE: "tool.file.write";
+export declare const TOOL_FILE_EDIT: "tool.file.edit";
+export declare const TOOL_SHELL_EXEC: "tool.shell.exec";
+export declare const TOOL_WEB_FETCH: "tool.web.fetch";
+export declare const TOOL_AGENT_SPAWN: "tool.agent.spawn";
+export declare const TOOL_AGENT_COMPLETE: "tool.agent.complete";
+export declare const SENTINEL_BLOCKED: "sentinel.blocked";
+export declare const SENTINEL_ALLOWED: "sentinel.allowed";
+export declare const SENTINEL_REVIEWED: "sentinel.reviewed";
+export declare const TRIBUNAL_VERDICT: "tribunal.verdict";
+export declare const TRIBUNAL_ACTOR_COMPLETE: "tribunal.actor.complete";
+export declare const TRIBUNAL_META_COMPLETE: "tribunal.meta.complete";
+export declare const WARDEN_THREAT_DETECTED: "warden.threat.detected";
+export declare const WARDEN_THREAT_CLEARED: "warden.threat.cleared";
+export declare const WARDEN_GATE_BLOCKED: "warden.gate.blocked";
+export declare const ORACLE_CALIBRATION_REQUESTED: "oracle.calibration.requested";
+export declare const ORACLE_CALIBRATION_COMPLETE: "oracle.calibration.complete";
+export declare const ARCHIVIST_EXTRACT_COMPLETE: "archivist.extract.complete";
+export declare const ARCHIVIST_INJECT_COMPLETE: "archivist.inject.complete";
+export declare const RELAY_HANDOFF_CAPTURED: "relay.handoff.captured";
+export declare const RELAY_HANDOFF_INJECTED: "relay.handoff.injected";
+export declare const SCRIBE_CAPTURE_COMPLETE: "scribe.capture.complete";
+export declare const SCRIBE_DISTILL_COMPLETE: "scribe.distill.complete";
+export declare const CUES_MATCHED: "cues.matched";
+export declare const CUES_APPLIED: "cues.applied";
+export declare const LEDGER_BUDGET_WARNING: "ledger.budget.warning";
+export declare const LEDGER_BUDGET_EXCEEDED: "ledger.budget.exceeded";
+export declare const LEDGER_SESSION_COMPLETE: "ledger.session.complete";
+export declare const ECHO_SUITE_STARTED: "echo.suite.started";
+export declare const ECHO_SUITE_COMPLETE: "echo.suite.complete";
+export declare const ECHO_REGRESSION_DETECTED: "echo.regression.detected";
+export declare const CARTOGRAPHER_AUDIT_COMPLETE: "cartographer.audit.complete";
+export declare const CARTOGRAPHER_ISSUE_FOUND: "cartographer.issue.found";
+export declare const COUNSEL_BRIEF_GENERATED: "counsel.brief.generated";
+export declare const ONLOOKER_SESSION_SUMMARY: "onlooker.session.summary";
+export declare const MERIDIAN_HINT_GENERATED: "meridian.hint.generated";
+export declare const MERIDIAN_HINT_DELIVERED: "meridian.hint.delivered";
+export declare const MERIDIAN_OUTCOME_RECORDED: "meridian.outcome.recorded";
+export declare const MERIDIAN_RELIANCE_MEASURED: "meridian.reliance.measured";
+export declare const MERIDIAN_LESSON_CURATED: "meridian.lesson.curated";
+export declare const MERIDIAN_PLAYBOOK_UPDATED: "meridian.playbook.updated";
+export declare const ALL_EVENT_TYPES: readonly ["session.start", "session.end", "session.compact", "session.prompt", "task.start", "task.complete", "task.fail", "tool.file.read", "tool.file.write", "tool.file.edit", "tool.shell.exec", "tool.web.fetch", "tool.agent.spawn", "tool.agent.complete", "sentinel.blocked", "sentinel.allowed", "sentinel.reviewed", "tribunal.verdict", "tribunal.actor.complete", "tribunal.meta.complete", "warden.threat.detected", "warden.threat.cleared", "warden.gate.blocked", "oracle.calibration.requested", "oracle.calibration.complete", "archivist.extract.complete", "archivist.inject.complete", "relay.handoff.captured", "relay.handoff.injected", "scribe.capture.complete", "scribe.distill.complete", "cues.matched", "cues.applied", "ledger.budget.warning", "ledger.budget.exceeded", "ledger.session.complete", "echo.suite.started", "echo.suite.complete", "echo.regression.detected", "cartographer.audit.complete", "cartographer.issue.found", "counsel.brief.generated", "onlooker.session.summary", "meridian.hint.generated", "meridian.hint.delivered", "meridian.outcome.recorded", "meridian.reliance.measured", "meridian.lesson.curated", "meridian.playbook.updated"];
+export type EventType = (typeof ALL_EVENT_TYPES)[number];
+export declare function isEventType(value: string): value is EventType;
+//# sourceMappingURL=event-types.d.ts.map

package/dist/event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../src/event-types.ts"],"names":[],"mappings":"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"}

package/dist/event-types.js

@@ -0,0 +1,105 @@
+export const SESSION_START = "session.start";
+export const SESSION_END = "session.end";
+export const SESSION_COMPACT = "session.compact";
+export const SESSION_PROMPT = "session.prompt";
+export const TASK_START = "task.start";
+export const TASK_COMPLETE = "task.complete";
+export const TASK_FAIL = "task.fail";
+export const TOOL_FILE_READ = "tool.file.read";
+export const TOOL_FILE_WRITE = "tool.file.write";
+export const TOOL_FILE_EDIT = "tool.file.edit";
+export const TOOL_SHELL_EXEC = "tool.shell.exec";
+export const TOOL_WEB_FETCH = "tool.web.fetch";
+export const TOOL_AGENT_SPAWN = "tool.agent.spawn";
+export const TOOL_AGENT_COMPLETE = "tool.agent.complete";
+export const SENTINEL_BLOCKED = "sentinel.blocked";
+export const SENTINEL_ALLOWED = "sentinel.allowed";
+export const SENTINEL_REVIEWED = "sentinel.reviewed";
+export const TRIBUNAL_VERDICT = "tribunal.verdict";
+export const TRIBUNAL_ACTOR_COMPLETE = "tribunal.actor.complete";
+export const TRIBUNAL_META_COMPLETE = "tribunal.meta.complete";
+export const WARDEN_THREAT_DETECTED = "warden.threat.detected";
+export const WARDEN_THREAT_CLEARED = "warden.threat.cleared";
+export const WARDEN_GATE_BLOCKED = "warden.gate.blocked";
+export const ORACLE_CALIBRATION_REQUESTED = "oracle.calibration.requested";
+export const ORACLE_CALIBRATION_COMPLETE = "oracle.calibration.complete";
+export const ARCHIVIST_EXTRACT_COMPLETE = "archivist.extract.complete";
+export const ARCHIVIST_INJECT_COMPLETE = "archivist.inject.complete";
+export const RELAY_HANDOFF_CAPTURED = "relay.handoff.captured";
+export const RELAY_HANDOFF_INJECTED = "relay.handoff.injected";
+export const SCRIBE_CAPTURE_COMPLETE = "scribe.capture.complete";
+export const SCRIBE_DISTILL_COMPLETE = "scribe.distill.complete";
+export const CUES_MATCHED = "cues.matched";
+export const CUES_APPLIED = "cues.applied";
+export const LEDGER_BUDGET_WARNING = "ledger.budget.warning";
+export const LEDGER_BUDGET_EXCEEDED = "ledger.budget.exceeded";
+export const LEDGER_SESSION_COMPLETE = "ledger.session.complete";
+export const ECHO_SUITE_STARTED = "echo.suite.started";
+export const ECHO_SUITE_COMPLETE = "echo.suite.complete";
+export const ECHO_REGRESSION_DETECTED = "echo.regression.detected";
+export const CARTOGRAPHER_AUDIT_COMPLETE = "cartographer.audit.complete";
+export const CARTOGRAPHER_ISSUE_FOUND = "cartographer.issue.found";
+export const COUNSEL_BRIEF_GENERATED = "counsel.brief.generated";
+export const ONLOOKER_SESSION_SUMMARY = "onlooker.session.summary";
+export const MERIDIAN_HINT_GENERATED = "meridian.hint.generated";
+export const MERIDIAN_HINT_DELIVERED = "meridian.hint.delivered";
+export const MERIDIAN_OUTCOME_RECORDED = "meridian.outcome.recorded";
+export const MERIDIAN_RELIANCE_MEASURED = "meridian.reliance.measured";
+export const MERIDIAN_LESSON_CURATED = "meridian.lesson.curated";
+export const MERIDIAN_PLAYBOOK_UPDATED = "meridian.playbook.updated";
+export const ALL_EVENT_TYPES = [
+    SESSION_START,
+    SESSION_END,
+    SESSION_COMPACT,
+    SESSION_PROMPT,
+    TASK_START,
+    TASK_COMPLETE,
+    TASK_FAIL,
+    TOOL_FILE_READ,
+    TOOL_FILE_WRITE,
+    TOOL_FILE_EDIT,
+    TOOL_SHELL_EXEC,
+    TOOL_WEB_FETCH,
+    TOOL_AGENT_SPAWN,
+    TOOL_AGENT_COMPLETE,
+    SENTINEL_BLOCKED,
+    SENTINEL_ALLOWED,
+    SENTINEL_REVIEWED,
+    TRIBUNAL_VERDICT,
+    TRIBUNAL_ACTOR_COMPLETE,
+    TRIBUNAL_META_COMPLETE,
+    WARDEN_THREAT_DETECTED,
+    WARDEN_THREAT_CLEARED,
+    WARDEN_GATE_BLOCKED,
+    ORACLE_CALIBRATION_REQUESTED,
+    ORACLE_CALIBRATION_COMPLETE,
+    ARCHIVIST_EXTRACT_COMPLETE,
+    ARCHIVIST_INJECT_COMPLETE,
+    RELAY_HANDOFF_CAPTURED,
+    RELAY_HANDOFF_INJECTED,
+    SCRIBE_CAPTURE_COMPLETE,
+    SCRIBE_DISTILL_COMPLETE,
+    CUES_MATCHED,
+    CUES_APPLIED,
+    LEDGER_BUDGET_WARNING,
+    LEDGER_BUDGET_EXCEEDED,
+    LEDGER_SESSION_COMPLETE,
+    ECHO_SUITE_STARTED,
+    ECHO_SUITE_COMPLETE,
+    ECHO_REGRESSION_DETECTED,
+    CARTOGRAPHER_AUDIT_COMPLETE,
+    CARTOGRAPHER_ISSUE_FOUND,
+    COUNSEL_BRIEF_GENERATED,
+    ONLOOKER_SESSION_SUMMARY,
+    MERIDIAN_HINT_GENERATED,
+    MERIDIAN_HINT_DELIVERED,
+    MERIDIAN_OUTCOME_RECORDED,
+    MERIDIAN_RELIANCE_MEASURED,
+    MERIDIAN_LESSON_CURATED,
+    MERIDIAN_PLAYBOOK_UPDATED,
+];
+const EVENT_TYPE_SET = new Set(ALL_EVENT_TYPES);
+export function isEventType(value) {
+    return EVENT_TYPE_SET.has(value);
+}
+//# sourceMappingURL=event-types.js.map

package/dist/event-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-types.js","sourceRoot":"","sources":["../src/event-types.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { ALL_EVENT_TYPES, isEventType, SESSION_START, SESSION_END, SESSION_COMPACT, SESSION_PROMPT, TASK_START, TASK_COMPLETE, TASK_FAIL, TOOL_FILE_READ, TOOL_FILE_WRITE, TOOL_FILE_EDIT, TOOL_SHELL_EXEC, TOOL_WEB_FETCH, TOOL_AGENT_SPAWN, TOOL_AGENT_COMPLETE, SENTINEL_BLOCKED, SENTINEL_ALLOWED, SENTINEL_REVIEWED, TRIBUNAL_VERDICT, TRIBUNAL_ACTOR_COMPLETE, TRIBUNAL_META_COMPLETE, WARDEN_THREAT_DETECTED, WARDEN_THREAT_CLEARED, WARDEN_GATE_BLOCKED, ORACLE_CALIBRATION_REQUESTED, ORACLE_CALIBRATION_COMPLETE, ARCHIVIST_EXTRACT_COMPLETE, ARCHIVIST_INJECT_COMPLETE, RELAY_HANDOFF_CAPTURED, RELAY_HANDOFF_INJECTED, SCRIBE_CAPTURE_COMPLETE, SCRIBE_DISTILL_COMPLETE, CUES_MATCHED, CUES_APPLIED, LEDGER_BUDGET_WARNING, LEDGER_BUDGET_EXCEEDED, LEDGER_SESSION_COMPLETE, ECHO_SUITE_STARTED, ECHO_SUITE_COMPLETE, ECHO_REGRESSION_DETECTED, CARTOGRAPHER_AUDIT_COMPLETE, CARTOGRAPHER_ISSUE_FOUND, COUNSEL_BRIEF_GENERATED, ONLOOKER_SESSION_SUMMARY, MERIDIAN_HINT_GENERATED, MERIDIAN_HINT_DELIVERED, MERIDIAN_OUTCOME_RECORDED, MERIDIAN_RELIANCE_MEASURED, MERIDIAN_LESSON_CURATED, MERIDIAN_PLAYBOOK_UPDATED, } from "./event-types.js";
+export type { EventType } from "./event-types.js";
+export type { OnlookerEvent, PayloadFor, RuntimeId, SessionStartPayload, SessionEndPayload, SessionCompactPayload, SessionPromptPayload, ToolFileReadPayload, ToolFileWritePayload, ToolFileEditPayload, ToolShellExecPayload, ToolWebFetchPayload, ToolAgentSpawnPayload, ToolAgentCompletePayload, SentinelBlockedPayload, SentinelAllowedPayload, SentinelReviewedPayload, TribunalVerdictPayload, TribunalActorCompletePayload, TribunalMetaCompletePayload, WardenThreatDetectedPayload, WardenThreatClearedPayload, WardenGateBlockedPayload, OracleCalibrationRequestedPayload, OracleCalibrationCompletePayload, ArchivistExtractCompletePayload, ArchivistInjectCompletePayload, RelayHandoffCapturedPayload, RelayHandoffInjectedPayload, ScribeCaptureCompletePayload, ScribeDistillCompletePayload, CuesMatchedPayload, CuesAppliedPayload, CartographerAuditCompletePayload, CartographerIssueCategories, CartographerIssueFoundPayload, LedgerBudgetWarningPayload, LedgerBudgetExceededPayload, LedgerSessionCompletePayload, EchoSuiteStartedPayload, EchoSuiteCompletePayload, EchoRegressionDetectedPayload, CounselBriefGeneratedPayload, CounselSource, OnlookerSessionSummaryPayload, OnlookerToolCounts, MeridianHintGeneratedPayload, MeridianHintDeliveredPayload, MeridianOutcomeRecordedPayload, MeridianRelianceMeasuredPayload, MeridianLessonCuratedPayload, MeridianPlaybookUpdatedPayload, MeridianTaskType, } from "./types.js";
+export { validate, validateOrThrow, createEvent, isEventOfType, _resetSequence, } from "./validate.js";
+export type { ValidationResult, ValidationErrorDetail, CreateEventParams, } from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,UAAU,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EACV,aAAa,EACb,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,iCAAiC,EACjC,gCAAgC,EAChC,+BAA+B,EAC/B,8BAA8B,EAC9B,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC5B,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,EAClB,gCAAgC,EAChC,2BAA2B,EAC3B,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,aAAa,EACb,6BAA6B,EAC7B,kBAAkB,EAClB,4BAA4B,EAC5B,4BAA4B,EAC5B,8BAA8B,EAC9B,+BAA+B,EAC/B,4BAA4B,EAC5B,8BAA8B,EAC9B,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ALL_EVENT_TYPES, isEventType, SESSION_START, SESSION_END, SESSION_COMPACT, SESSION_PROMPT, TASK_START, TASK_COMPLETE, TASK_FAIL, TOOL_FILE_READ, TOOL_FILE_WRITE, TOOL_FILE_EDIT, TOOL_SHELL_EXEC, TOOL_WEB_FETCH, TOOL_AGENT_SPAWN, TOOL_AGENT_COMPLETE, SENTINEL_BLOCKED, SENTINEL_ALLOWED, SENTINEL_REVIEWED, TRIBUNAL_VERDICT, TRIBUNAL_ACTOR_COMPLETE, TRIBUNAL_META_COMPLETE, WARDEN_THREAT_DETECTED, WARDEN_THREAT_CLEARED, WARDEN_GATE_BLOCKED, ORACLE_CALIBRATION_REQUESTED, ORACLE_CALIBRATION_COMPLETE, ARCHIVIST_EXTRACT_COMPLETE, ARCHIVIST_INJECT_COMPLETE, RELAY_HANDOFF_CAPTURED, RELAY_HANDOFF_INJECTED, SCRIBE_CAPTURE_COMPLETE, SCRIBE_DISTILL_COMPLETE, CUES_MATCHED, CUES_APPLIED, LEDGER_BUDGET_WARNING, LEDGER_BUDGET_EXCEEDED, LEDGER_SESSION_COMPLETE, ECHO_SUITE_STARTED, ECHO_SUITE_COMPLETE, ECHO_REGRESSION_DETECTED, CARTOGRAPHER_AUDIT_COMPLETE, CARTOGRAPHER_ISSUE_FOUND, COUNSEL_BRIEF_GENERATED, ONLOOKER_SESSION_SUMMARY, MERIDIAN_HINT_GENERATED, MERIDIAN_HINT_DELIVERED, MERIDIAN_OUTCOME_RECORDED, MERIDIAN_RELIANCE_MEASURED, MERIDIAN_LESSON_CURATED, MERIDIAN_PLAYBOOK_UPDATED, } from "./event-types.js";
+export { validate, validateOrThrow, createEvent, isEventOfType, _resetSequence, } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,UAAU,EACV,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,mBAAmB,EACnB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AA4D1B,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,eAAe,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,320 @@
+import type { EventType } from "./event-types.js";
+export type RuntimeId = "claude-code" | "cursor" | "copilot" | "gemini" | "custom";
+export interface SessionStartPayload {
+    working_directory: string;
+    git_branch?: string;
+    git_commit?: string;
+    resume_of_session_id?: string;
+}
+export interface SessionEndPayload {
+    duration_ms: number;
+    turn_count: number;
+    total_cost_usd?: number;
+    total_tokens?: number;
+    end_reason?: "user_exit" | "timeout" | "error" | "task_complete" | "unknown";
+}
+export interface SessionCompactPayload {
+    tokens_before: number;
+    tokens_after: number;
+    compression_ratio?: number;
+}
+export interface SessionPromptPayload {
+    turn_number: number;
+    input_summary?: string;
+    context_tokens?: number;
+}
+export interface ToolFileReadPayload {
+    path: string;
+    lines_read?: number;
+    file_size_bytes?: number;
+}
+export interface ToolFileWritePayload {
+    path: string;
+    operation: "create" | "overwrite";
+    bytes_written?: number;
+    lines_written?: number;
+}
+export interface ToolFileEditPayload {
+    path: string;
+    lines_changed?: number;
+}
+export interface ToolShellExecPayload {
+    command: string;
+    exit_code?: number;
+    duration_ms?: number;
+    working_directory?: string;
+    blocked?: boolean;
+}
+export interface ToolWebFetchPayload {
+    url: string;
+    status_code?: number;
+    response_bytes?: number;
+    blocked?: boolean;
+}
+export interface ToolAgentSpawnPayload {
+    subagent_id: string;
+    agent_name?: string;
+    task_summary?: string;
+    blocked?: boolean;
+}
+export interface ToolAgentCompletePayload {
+    subagent_id: string;
+    success: boolean;
+    agent_name?: string;
+    duration_ms?: number;
+    cost_usd?: number;
+    output_summary?: string;
+}
+export interface SentinelBlockedPayload {
+    command: string;
+    risk_level: "critical" | "high" | "medium";
+    matched_pattern: string;
+    reason?: string;
+}
+export interface SentinelAllowedPayload {
+    command: string;
+    risk_level: "low" | "none";
+    review_required?: boolean;
+}
+export interface SentinelReviewedPayload {
+    command: string;
+    decision: "approved" | "rejected";
+    review_duration_ms?: number;
+}
+export interface TribunalVerdictPayload {
+    task_id: string;
+    score: number;
+    passed: boolean;
+    judge_type: "standard" | "security" | "maintainability" | "adversarial" | "domain" | "meta";
+    feedback_summary?: string;
+    file_path?: string;
+}
+export interface TribunalActorCompletePayload {
+    task_id: string;
+    success: boolean;
+    duration_ms?: number;
+    skepticism_rounds?: number;
+}
+export interface TribunalMetaCompletePayload {
+    task_id: string;
+    verdict_quality: "sound" | "questionable" | "biased";
+    bias_detected: boolean;
+    override_recommendation?: "accept" | "reject" | "re-evaluate";
+}
+export interface WardenThreatDetectedPayload {
+    source_type: "web_fetch" | "file_read";
+    threat_type: "prompt_injection" | "instruction_override" | "credential_exfiltration" | "command_injection" | "social_engineering";
+    confidence: number;
+    source_url?: string;
+    source_path?: string;
+    snippet?: string;
+}
+export interface WardenThreatClearedPayload {
+    source_type: "web_fetch" | "file_read";
+    cleared_by?: "timeout" | "user_override" | "subsequent_scan_clean";
+}
+export interface WardenGateBlockedPayload {
+    blocked_operation: "tool.file.write" | "tool.file.edit" | "tool.shell.exec";
+    threat_source_type: "web_fetch" | "file_read";
+}
+export interface OracleCalibrationRequestedPayload {
+    trigger: "user_prompt" | "pre_write" | "pre_bash";
+    task_summary?: string;
+}
+export interface OracleCalibrationCompletePayload {
+    trigger: "user_prompt" | "pre_write" | "pre_bash";
+    confidence_score: number;
+    intervened: boolean;
+    misalignment_detected?: boolean;
+}
+export interface ArchivistExtractCompletePayload {
+    session_id: string;
+    item_count: number;
+    decision_count?: number;
+    dead_end_count?: number;
+    open_question_count?: number;
+    file_count?: number;
+    trigger?: "pre_compact" | "session_end" | "manual";
+}
+export interface ArchivistInjectCompletePayload {
+    source_session_id: string;
+    items_injected: number;
+    items_available?: number;
+}
+export interface RelayHandoffCapturedPayload {
+    session_id: string;
+    tasks_in_progress?: number;
+    blocking_questions?: number;
+    files_in_flight?: number;
+}
+export interface RelayHandoffInjectedPayload {
+    source_session_id: string;
+    age_ms?: number;
+}
+export interface ScribeCaptureCompletePayload {
+    file_path: string;
+    operation: "write" | "edit";
+    intent_summary?: string;
+}
+export interface ScribeDistillCompletePayload {
+    session_id: string;
+    captures_processed: number;
+    artifacts_produced: number;
+}
+export interface CuesMatchedPayload {
+    cue_id: string;
+    match_type: "regex" | "vocabulary" | "semantic";
+    trigger_source: "prompt" | "command" | "file_path";
+    cue_name?: string;
+}
+export interface CuesAppliedPayload {
+    cue_id: string;
+    cue_name?: string;
+    guidance_length?: number;
+}
+export interface CartographerIssueCategories {
+    contradictions?: number;
+    stale_references?: number;
+    orphaned_plugins?: number;
+    dead_tools?: number;
+    duplicates?: number;
+    hierarchy_conflicts?: number;
+}
+export interface CartographerAuditCompletePayload {
+    files_audited: number;
+    issues_found: number;
+    trigger?: "instructions_loaded" | "config_change" | "manual";
+    issue_categories?: CartographerIssueCategories;
+}
+export interface CartographerIssueFoundPayload {
+    issue_type: "contradiction" | "stale_reference" | "orphaned_plugin" | "dead_tool" | "duplicate" | "hierarchy_conflict";
+    file_path: string;
+    severity: "error" | "warning" | "info";
+    description?: string;
+}
+export interface LedgerBudgetWarningPayload {
+    budget_usd: number;
+    spent_usd: number;
+    threshold_pct: number;
+    remaining_usd?: number;
+}
+export interface LedgerBudgetExceededPayload {
+    budget_usd: number;
+    spent_usd: number;
+    blocked_operation: string;
+}
+export interface LedgerSessionCompletePayload {
+    total_cost_usd: number;
+    budget_usd: number;
+    under_budget: boolean;
+    cost_by_plugin?: Record<string, number>;
+}
+export interface EchoSuiteStartedPayload {
+    suite_id: string;
+    test_count: number;
+    suite_name?: string;
+    trigger?: "config_change" | "manual";
+    changed_file?: string;
+}
+export interface EchoSuiteCompletePayload {
+    suite_id: string;
+    test_count: number;
+    improved: number;
+    degraded: number;
+    neutral: number;
+    merge_recommended?: boolean;
+    duration_ms?: number;
+}
+export interface EchoRegressionDetectedPayload {
+    suite_id: string;
+    test_id: string;
+    score_before: number;
+    score_after: number;
+    test_name?: string;
+    delta?: number;
+}
+export type CounselSource = "onlooker_events" | "tribunal_verdicts" | "echo_regressions" | "sentinel_audit" | "warden_audit" | "oracle_calibrations" | "meridian_reliance";
+export interface CounselBriefGeneratedPayload {
+    period_start: string;
+    period_end: string;
+    recommendation_count: number;
+    sources_consulted?: CounselSource[];
+}
+export interface OnlookerToolCounts {
+    file_reads?: number;
+    file_writes?: number;
+    file_edits?: number;
+    shell_execs?: number;
+    web_fetches?: number;
+    agent_spawns?: number;
+}
+export interface OnlookerSessionSummaryPayload {
+    session_id: string;
+    duration_ms: number;
+    event_count: number;
+    tool_counts?: OnlookerToolCounts;
+}
+export type MeridianTaskType = "code" | "reasoning" | "writing" | "general";
+export interface MeridianHintGeneratedPayload {
+    hint_id: string;
+    case_id: string;
+    task_type: MeridianTaskType;
+    failure_type: "wrong_approach" | "missing_concept" | "implementation_error" | "misunderstood_task" | "out_of_scope";
+    hint_direction: "reframe" | "missing_tool" | "intermediate_goal" | "alternative_representation" | "constraint_reminder";
+    target_concept?: string;
+    signal_creation?: number;
+    signal_transfer?: number;
+    playbook_bullets_injected?: number;
+}
+export interface MeridianHintDeliveredPayload {
+    hint_id: string;
+    case_id: string;
+    delivery_mode: "append" | "comment" | "inline" | "aside";
+}
+export interface MeridianOutcomeRecordedPayload {
+    hint_id: string;
+    case_id: string;
+    succeeded: boolean;
+    attempts_after_hint: number;
+    hint_referenced?: boolean;
+    time_to_success_ms?: number;
+}
+export interface MeridianRelianceMeasuredPayload {
+    hint_id: string;
+    case_id: string;
+    score: number;
+    assessment: "low" | "medium" | "high";
+    method: "logprob" | "judge";
+}
+export interface MeridianLessonCuratedPayload {
+    bullet_id: string;
+    case_id: string;
+    category: "failure_pattern" | "successful_hint" | "task_strategy" | "tool_usage";
+    task_type: MeridianTaskType;
+    target_concept: string;
+    origin?: "agent_failure" | "human_session" | "manual";
+}
+export interface MeridianPlaybookUpdatedPayload {
+    scope_id: string;
+    operation: "append" | "update" | "deduplicate" | "promote" | "retire";
+    bullet_count_after: number;
+    bullets_removed?: number;
+}
+export type PayloadFor<T extends EventType> = T extends "session.start" ? SessionStartPayload : T extends "session.end" ? SessionEndPayload : T extends "session.compact" ? SessionCompactPayload : T extends "session.prompt" ? SessionPromptPayload : T extends "tool.file.read" ? ToolFileReadPayload : T extends "tool.file.write" ? ToolFileWritePayload : T extends "tool.file.edit" ? ToolFileEditPayload : T extends "tool.shell.exec" ? ToolShellExecPayload : T extends "tool.web.fetch" ? ToolWebFetchPayload : T extends "tool.agent.spawn" ? ToolAgentSpawnPayload : T extends "tool.agent.complete" ? ToolAgentCompletePayload : T extends "sentinel.blocked" ? SentinelBlockedPayload : T extends "sentinel.allowed" ? SentinelAllowedPayload : T extends "sentinel.reviewed" ? SentinelReviewedPayload : T extends "tribunal.verdict" ? TribunalVerdictPayload : T extends "tribunal.actor.complete" ? TribunalActorCompletePayload : T extends "tribunal.meta.complete" ? TribunalMetaCompletePayload : T extends "warden.threat.detected" ? WardenThreatDetectedPayload : T extends "warden.threat.cleared" ? WardenThreatClearedPayload : T extends "warden.gate.blocked" ? WardenGateBlockedPayload : T extends "oracle.calibration.requested" ? OracleCalibrationRequestedPayload : T extends "oracle.calibration.complete" ? OracleCalibrationCompletePayload : T extends "archivist.extract.complete" ? ArchivistExtractCompletePayload : T extends "archivist.inject.complete" ? ArchivistInjectCompletePayload : T extends "relay.handoff.captured" ? RelayHandoffCapturedPayload : T extends "relay.handoff.injected" ? RelayHandoffInjectedPayload : T extends "scribe.capture.complete" ? ScribeCaptureCompletePayload : T extends "scribe.distill.complete" ? ScribeDistillCompletePayload : T extends "cues.matched" ? CuesMatchedPayload : T extends "cues.applied" ? CuesAppliedPayload : T extends "ledger.budget.warning" ? LedgerBudgetWarningPayload : T extends "ledger.budget.exceeded" ? LedgerBudgetExceededPayload : T extends "ledger.session.complete" ? LedgerSessionCompletePayload : T extends "echo.suite.started" ? EchoSuiteStartedPayload : T extends "echo.suite.complete" ? EchoSuiteCompletePayload : T extends "echo.regression.detected" ? EchoRegressionDetectedPayload : T extends "cartographer.audit.complete" ? CartographerAuditCompletePayload : T extends "cartographer.issue.found" ? CartographerIssueFoundPayload : T extends "counsel.brief.generated" ? CounselBriefGeneratedPayload : T extends "onlooker.session.summary" ? OnlookerSessionSummaryPayload : T extends "meridian.hint.generated" ? MeridianHintGeneratedPayload : T extends "meridian.hint.delivered" ? MeridianHintDeliveredPayload : T extends "meridian.outcome.recorded" ? MeridianOutcomeRecordedPayload : T extends "meridian.reliance.measured" ? MeridianRelianceMeasuredPayload : T extends "meridian.lesson.curated" ? MeridianLessonCuratedPayload : T extends "meridian.playbook.updated" ? MeridianPlaybookUpdatedPayload : Record<string, unknown>;
+export interface OnlookerEvent<T extends EventType = EventType> {
+    id: string;
+    schema_version: "1.0";
+    runtime: RuntimeId;
+    adapter_id?: string;
+    plugin: string;
+    machine_id: string;
+    timestamp: string;
+    session_id: string;
+    sequence: number;
+    event_type: T;
+    payload: PayloadFor<T>;
+    cost_usd?: number;
+    token_count?: number;
+    redacted?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map