agent-mockingbird 0.0.1

package/docs/opencode-startup-sync-plan.md

@@ -0,0 +1,94 @@
+# OpenCode Startup Sync Plan
+
+## Problem
+
+Hosted startup logs showed:
+
+```text
+[opencode] Config sync failed: Unable to connect. Is the computer able to access the url?
+```
+
+This happened during `agent-mockingbird` boot even though the app itself still started.
+
+## Diagnosis
+
+The failure was a startup race between:
+
+- `agent-mockingbird.service`
+- `opencode.service`
+
+`agent-mockingbird` constructed `OpencodeRuntime` during process boot, and the runtime constructor immediately kicked off OpenCode config sync. Under systemd, `After=opencode.service` only guarantees service ordering, not that OpenCode is already accepting HTTP connections on `127.0.0.1:4096`.
+
+That meant startup could log a sync failure if Agent Mockingbird reached OpenCode before the sidecar had finished binding its port.
+
+## Fix
+
+Remove eager OpenCode config sync from the `OpencodeRuntime` constructor.
+
+Keep runtime config sync lazy so it still runs before real OpenCode operations, such as:
+
+- health checks
+- normal prompts
+- background session creation
+- background prompt dispatch
+
+This preserves runtime behavior while avoiding noisy false failures during service startup.
+
+## Important Clarification
+
+This change does **not** remove runtime config sync.
+
+It only changes **when** sync happens:
+
+- before: immediately during process construction
+- after: on first actual runtime use
+
+## Code Change
+
+Updated:
+
+- `apps/server/src/backend/runtime/opencodeRuntime.ts`
+
+Removed the constructor-triggered call that forced sync during startup.
+
+## Regression Coverage
+
+Updated:
+
+- `apps/server/src/backend/runtime/opencodeRuntime.test.ts`
+
+Added coverage to assert that constructing the runtime does not hit OpenCode config immediately, while normal prompt flow still performs sync later.
+
+## Verification
+
+Run:
+
+```sh
+bun test apps/server/src/backend/runtime/opencodeRuntime.test.ts
+```
+
+Expected result:
+
+- tests pass
+- runtime construction does not contact OpenCode
+- prompt path still performs runtime config sync
+
+## Rollout
+
+1. Push the fix.
+2. Redeploy or update the hosted install.
+3. Restart the user services if needed.
+4. Check:
+
+```sh
+journalctl --user -u agent-mockingbird
+```
+
+Expected startup behavior:
+
+- Agent Mockingbird starts cleanly
+- no immediate OpenCode config sync connection error during boot
+
+## Follow-up
+
+If we want stronger startup guarantees later, we can add an explicit retry/backoff around first OpenCode sync or a readiness probe for the sidecar, but that is not required for this fix.

package/docs/vendor-opencode.md

@@ -0,0 +1,41 @@
+# OpenCode Workflow
+
+## Layout
+
+- `opencode.lock.json` is the source of truth for the shipped OpenCode tag, commit, package version, local paths, and patch branch name.
+- `cleanroom/opencode` is a local-only pristine upstream clone managed by `bun run opencode:sync`.
+- `vendor/opencode` is a generated git worktree on the Agent Mockingbird patch branch. It is editable, but it is not tracked by the main repo.
+- `patches/opencode/*.patch` is the tracked serialized patch stack exported from the patch branch.
+
+## Commands
+
+- `bun run opencode:sync --status`
+  - Show the locked version, cleanroom state, vendor worktree state, and whether the patch series matches the branch.
+- `bun run opencode:sync --status --json`
+  - Machine-readable version of the same state.
+- `bun run opencode:sync --rebuild-only`
+  - Recreate `vendor/opencode` from `opencode.lock.json` plus the tracked patches.
+- `bun run opencode:sync --export-patches`
+  - Export committed OpenCode changes from the patch branch back into `patches/opencode`.
+- `bun run opencode:sync --ref vX.Y.Z`
+  - Fetch a new upstream release tag, apply the tracked patch series, validate it, and update the lock only after success.
+- `bun run opencode:sync --check`
+  - CI-safe validation that reproduces the generated tree from the lock and patches in temporary state.
+- `bun run check:ship`
+  - Canonical ship gate. Bootstraps the generated vendor worktree if needed, requires a clean/exported patch state, runs `opencode:sync --check`, and compares full cleanroom vs vendor OpenCode typecheck results so upstream-only baseline failures do not fail the ship check.
+
+## Edit Loop
+
+1. Run `bun run opencode:sync --rebuild-only`.
+2. Edit files in `vendor/opencode`.
+3. Commit those changes inside the `vendor/opencode` worktree on branch `agent-mockingbird/opencode`.
+4. Run `bun run opencode:sync --export-patches`.
+5. Run `bun run check:ship`.
+
+## Rules
+
+- Never edit `cleanroom/opencode` directly.
+- Never hand-maintain a copied `vendor/opencode` tree.
+- If `vendor/opencode` is dirty, do not run `--ref` or `--export-patches`.
+- `bun run check:ship` only validates clean, exported vendor state. Dirty `vendor/opencode` is a hard failure.
+- Treat `patches/opencode` as exported artifacts of the patch branch, not as the primary editing surface.

package/drizzle/0000_famous_turbo.sql

@@ -0,0 +1,49 @@
+CREATE TABLE `heartbeat_events` (
+	`id` text PRIMARY KEY NOT NULL,
+	`online` integer DEFAULT true NOT NULL,
+	`source` text DEFAULT 'system' NOT NULL,
+	`created_at` integer DEFAULT (strftime('%s', 'now') * 1000) NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX `heartbeat_events_created_idx` ON `heartbeat_events` (`created_at`);--> statement-breakpoint
+CREATE TABLE `messages` (
+	`id` text PRIMARY KEY NOT NULL,
+	`session_id` text NOT NULL,
+	`role` text NOT NULL,
+	`content` text NOT NULL,
+	`created_at` integer DEFAULT (strftime('%s', 'now') * 1000) NOT NULL,
+	FOREIGN KEY (`session_id`) REFERENCES `sessions`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `messages_session_created_idx` ON `messages` (`session_id`,`created_at`);--> statement-breakpoint
+CREATE TABLE `runtime_config` (
+	`key` text PRIMARY KEY NOT NULL,
+	`value_json` text NOT NULL,
+	`updated_at` integer DEFAULT (strftime('%s', 'now') * 1000) NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `sessions` (
+	`id` text PRIMARY KEY NOT NULL,
+	`title` text NOT NULL,
+	`model` text NOT NULL,
+	`status` text DEFAULT 'idle' NOT NULL,
+	`message_count` integer DEFAULT 0 NOT NULL,
+	`created_at` integer DEFAULT (strftime('%s', 'now') * 1000) NOT NULL,
+	`updated_at` integer DEFAULT (strftime('%s', 'now') * 1000) NOT NULL,
+	`last_active_at` integer DEFAULT (strftime('%s', 'now') * 1000) NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX `sessions_last_active_idx` ON `sessions` (`last_active_at`);--> statement-breakpoint
+CREATE TABLE `usage_events` (
+	`id` text PRIMARY KEY NOT NULL,
+	`session_id` text,
+	`request_count_delta` integer DEFAULT 0 NOT NULL,
+	`input_tokens_delta` integer DEFAULT 0 NOT NULL,
+	`output_tokens_delta` integer DEFAULT 0 NOT NULL,
+	`estimated_cost_usd_delta_micros` integer DEFAULT 0 NOT NULL,
+	`source` text DEFAULT 'system' NOT NULL,
+	`created_at` integer DEFAULT (strftime('%s', 'now') * 1000) NOT NULL,
+	FOREIGN KEY (`session_id`) REFERENCES `sessions`(`id`) ON UPDATE no action ON DELETE set null
+);
+--> statement-breakpoint
+CREATE INDEX `usage_events_created_idx` ON `usage_events` (`created_at`);

package/drizzle/0001_cron_memory_aux.sql

@@ -0,0 +1,160 @@
+CREATE TABLE IF NOT EXISTS `message_memory_traces` (
+	`message_id` text PRIMARY KEY NOT NULL,
+	`session_id` text NOT NULL,
+	`trace_json` text NOT NULL,
+	`created_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `message_memory_traces_session_idx`
+	ON `message_memory_traces` (`session_id`, `created_at` DESC);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `cron_job_definitions` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL,
+	`enabled` integer NOT NULL DEFAULT 1,
+	`schedule_kind` text NOT NULL CHECK (`schedule_kind` IN ('at', 'every', 'cron')),
+	`schedule_expr` text,
+	`every_ms` integer,
+	`at_iso` text,
+	`timezone` text,
+	`run_mode` text NOT NULL CHECK (`run_mode` IN ('background', 'conditional_agent', 'agent')),
+	`handler_key` text,
+	`agent_prompt_template` text,
+	`agent_model_override` text,
+	`max_attempts` integer NOT NULL DEFAULT 3,
+	`retry_backoff_ms` integer NOT NULL DEFAULT 30000,
+	`payload_json` text NOT NULL DEFAULT '{}',
+	`last_enqueued_for` integer,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `cron_job_definitions_enabled_idx`
+	ON `cron_job_definitions` (`enabled`, `schedule_kind`);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `cron_job_instances` (
+	`id` text PRIMARY KEY NOT NULL,
+	`job_definition_id` text NOT NULL REFERENCES `cron_job_definitions`(`id`) ON DELETE CASCADE,
+	`scheduled_for` integer NOT NULL,
+	`state` text NOT NULL CHECK (`state` IN ('queued', 'leased', 'running', 'completed', 'failed', 'dead')),
+	`attempt` integer NOT NULL DEFAULT 0,
+	`next_attempt_at` integer,
+	`lease_owner` text,
+	`lease_expires_at` integer,
+	`last_heartbeat_at` integer,
+	`result_summary` text,
+	`error_json` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	UNIQUE(`job_definition_id`, `scheduled_for`)
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `cron_job_instances_ready_idx`
+	ON `cron_job_instances` (`state`, `next_attempt_at`, `scheduled_for`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `cron_job_instances_job_idx`
+	ON `cron_job_instances` (`job_definition_id`, `created_at` DESC);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `cron_job_steps` (
+	`id` text PRIMARY KEY NOT NULL,
+	`job_instance_id` text NOT NULL REFERENCES `cron_job_instances`(`id`) ON DELETE CASCADE,
+	`step_kind` text NOT NULL CHECK (`step_kind` IN ('background', 'conditional_agent', 'agent')),
+	`status` text NOT NULL CHECK (`status` IN ('pending', 'running', 'completed', 'failed', 'skipped')),
+	`input_json` text,
+	`output_json` text,
+	`error_json` text,
+	`started_at` integer,
+	`finished_at` integer,
+	`created_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `cron_job_steps_instance_idx`
+	ON `cron_job_steps` (`job_instance_id`, `created_at` ASC);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `memory_meta` (
+	`key` text PRIMARY KEY NOT NULL,
+	`value_json` text NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `memory_files` (
+	`path` text PRIMARY KEY NOT NULL,
+	`source` text NOT NULL DEFAULT 'memory',
+	`hash` text NOT NULL,
+	`mtime` integer NOT NULL,
+	`size` integer NOT NULL,
+	`indexed_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `memory_chunks` (
+	`id` text PRIMARY KEY NOT NULL,
+	`path` text NOT NULL,
+	`source` text NOT NULL DEFAULT 'memory',
+	`start_line` integer NOT NULL,
+	`end_line` integer NOT NULL,
+	`hash` text NOT NULL,
+	`text` text NOT NULL,
+	`embedding_json` text,
+	`updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_chunks_path_idx` ON `memory_chunks` (`path`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_chunks_updated_idx` ON `memory_chunks` (`updated_at`);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `memory_embedding_cache` (
+	`provider` text NOT NULL,
+	`model` text NOT NULL,
+	`hash` text NOT NULL,
+	`embedding_json` text NOT NULL,
+	`dims` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	PRIMARY KEY(`provider`, `model`, `hash`)
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_embedding_cache_updated_idx`
+	ON `memory_embedding_cache` (`updated_at`);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `memory_records` (
+	`id` text PRIMARY KEY NOT NULL,
+	`path` text NOT NULL,
+	`type` text NOT NULL,
+	`source` text NOT NULL,
+	`content` text NOT NULL,
+	`entities_json` text NOT NULL,
+	`confidence` real NOT NULL,
+	`supersedes_json` text NOT NULL,
+	`superseded_by` text,
+	`recorded_at` integer NOT NULL,
+	`updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_records_path_idx` ON `memory_records` (`path`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_records_superseded_idx` ON `memory_records` (`superseded_by`);
+--> statement-breakpoint
+CREATE TABLE IF NOT EXISTS `memory_write_events` (
+	`id` text PRIMARY KEY NOT NULL,
+	`status` text NOT NULL,
+	`reason` text NOT NULL,
+	`type` text NOT NULL,
+	`source` text NOT NULL,
+	`content` text NOT NULL,
+	`confidence` real NOT NULL,
+	`session_id` text,
+	`topic` text,
+	`record_id` text,
+	`path` text,
+	`created_at` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_write_events_created_idx`
+	ON `memory_write_events` (`created_at` DESC);
+--> statement-breakpoint
+CREATE VIRTUAL TABLE IF NOT EXISTS `memory_chunks_fts` USING fts5(
+	`text`,
+	`chunk_id` UNINDEXED,
+	`path` UNINDEXED,
+	`start_line` UNINDEXED,
+	`end_line` UNINDEXED,
+	`updated_at` UNINDEXED
+);

package/drizzle/0002_runtime_session_bindings.sql

@@ -0,0 +1,28 @@
+CREATE TABLE IF NOT EXISTS `runtime_session_bindings` (
+	`runtime` text NOT NULL,
+	`session_id` text NOT NULL,
+	`external_session_id` text NOT NULL,
+	`updated_at` integer NOT NULL,
+	PRIMARY KEY(`runtime`, `session_id`)
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `runtime_session_bindings_external_idx`
+	ON `runtime_session_bindings` (`runtime`, `external_session_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `runtime_session_bindings_updated_idx`
+	ON `runtime_session_bindings` (`updated_at`);
+--> statement-breakpoint
+INSERT INTO `runtime_session_bindings` (`runtime`, `session_id`, `external_session_id`, `updated_at`)
+SELECT
+	substr(j.key, 1, instr(j.key, ':') - 1) AS runtime,
+	substr(j.key, instr(j.key, ':') + 1) AS session_id,
+	CAST(j.value AS TEXT) AS external_session_id,
+	CAST(strftime('%s', 'now') * 1000 AS INTEGER) AS updated_at
+FROM `runtime_config` rc
+JOIN json_each(rc.value_json) j
+WHERE rc.`key` = 'sessionBindings'
+	AND instr(j.key, ':') > 0
+	AND trim(CAST(j.value AS TEXT)) <> ''
+ON CONFLICT(`runtime`, `session_id`) DO UPDATE SET
+	`external_session_id` = excluded.`external_session_id`,
+	`updated_at` = excluded.`updated_at`;

package/drizzle/0003_background_runs.sql

@@ -0,0 +1,27 @@
+CREATE TABLE IF NOT EXISTS `background_runs` (
+	`id` text PRIMARY KEY NOT NULL,
+	`runtime` text NOT NULL,
+	`parent_session_id` text NOT NULL,
+	`parent_external_session_id` text NOT NULL,
+	`child_external_session_id` text NOT NULL,
+	`requested_by` text NOT NULL DEFAULT 'system',
+	`prompt` text NOT NULL DEFAULT '',
+	`status` text NOT NULL DEFAULT 'created',
+	`result_summary` text,
+	`error` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	`started_at` integer,
+	`completed_at` integer,
+	FOREIGN KEY (`parent_session_id`) REFERENCES `sessions`(`id`) ON UPDATE no action ON DELETE cascade,
+	CHECK (`status` IN ('created', 'running', 'retrying', 'idle', 'completed', 'failed', 'aborted'))
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX IF NOT EXISTS `background_runs_child_external_idx`
+	ON `background_runs` (`runtime`, `child_external_session_id`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `background_runs_parent_created_idx`
+	ON `background_runs` (`parent_session_id`, `created_at` DESC);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `background_runs_status_updated_idx`
+	ON `background_runs` (`status`, `updated_at` DESC);

package/drizzle/0004_memory_open_write.sql

@@ -0,0 +1,63 @@
+PRAGMA foreign_keys=OFF;
+--> statement-breakpoint
+DROP TABLE IF EXISTS `memory_records_new`;
+--> statement-breakpoint
+CREATE TABLE `memory_records_new` (
+	`id` text PRIMARY KEY NOT NULL,
+	`path` text NOT NULL,
+	`source` text NOT NULL,
+	`content` text NOT NULL,
+	`entities_json` text NOT NULL,
+	`confidence` real NOT NULL,
+	`supersedes_json` text NOT NULL,
+	`superseded_by` text,
+	`recorded_at` integer NOT NULL,
+	`updated_at` integer NOT NULL
+);
+--> statement-breakpoint
+INSERT INTO `memory_records_new` (
+	`id`, `path`, `source`, `content`, `entities_json`, `confidence`, `supersedes_json`, `superseded_by`, `recorded_at`, `updated_at`
+)
+SELECT
+	`id`, `path`, `source`, `content`, `entities_json`, `confidence`, `supersedes_json`, `superseded_by`, `recorded_at`, `updated_at`
+FROM `memory_records`;
+--> statement-breakpoint
+DROP TABLE `memory_records`;
+--> statement-breakpoint
+ALTER TABLE `memory_records_new` RENAME TO `memory_records`;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_records_path_idx` ON `memory_records` (`path`);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_records_superseded_idx` ON `memory_records` (`superseded_by`);
+--> statement-breakpoint
+DROP TABLE IF EXISTS `memory_write_events_new`;
+--> statement-breakpoint
+CREATE TABLE `memory_write_events_new` (
+	`id` text PRIMARY KEY NOT NULL,
+	`status` text NOT NULL,
+	`reason` text NOT NULL,
+	`source` text NOT NULL,
+	`content` text NOT NULL,
+	`confidence` real NOT NULL,
+	`session_id` text,
+	`topic` text,
+	`record_id` text,
+	`path` text,
+	`created_at` integer NOT NULL
+);
+--> statement-breakpoint
+INSERT INTO `memory_write_events_new` (
+	`id`, `status`, `reason`, `source`, `content`, `confidence`, `session_id`, `topic`, `record_id`, `path`, `created_at`
+)
+SELECT
+	`id`, `status`, `reason`, `source`, `content`, `confidence`, `session_id`, `topic`, `record_id`, `path`, `created_at`
+FROM `memory_write_events`;
+--> statement-breakpoint
+DROP TABLE `memory_write_events`;
+--> statement-breakpoint
+ALTER TABLE `memory_write_events_new` RENAME TO `memory_write_events`;
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS `memory_write_events_created_idx`
+	ON `memory_write_events` (`created_at` DESC);
+--> statement-breakpoint
+PRAGMA foreign_keys=ON;

package/drizzle/0005_signal_channel.sql

@@ -0,0 +1,47 @@
+CREATE TABLE `channel_conversation_bindings` (
+	`channel` text NOT NULL,
+	`conversation_key` text NOT NULL,
+	`session_id` text NOT NULL,
+	`last_target` text,
+	`updated_at` integer NOT NULL,
+	PRIMARY KEY(`channel`, `conversation_key`),
+	FOREIGN KEY (`session_id`) REFERENCES `sessions`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE INDEX `channel_conversation_bindings_session_idx` ON `channel_conversation_bindings` (`session_id`);
+--> statement-breakpoint
+CREATE INDEX `channel_conversation_bindings_updated_idx` ON `channel_conversation_bindings` (`updated_at`);
+--> statement-breakpoint
+CREATE TABLE `channel_pairing_requests` (
+	`channel` text NOT NULL,
+	`sender_id` text NOT NULL,
+	`code` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`last_seen_at` integer NOT NULL,
+	`expires_at` integer NOT NULL,
+	`meta_json` text NOT NULL DEFAULT '{}',
+	PRIMARY KEY(`channel`, `sender_id`)
+);
+--> statement-breakpoint
+CREATE INDEX `channel_pairing_requests_code_idx` ON `channel_pairing_requests` (`channel`, `code`);
+--> statement-breakpoint
+CREATE INDEX `channel_pairing_requests_expires_idx` ON `channel_pairing_requests` (`expires_at`);
+--> statement-breakpoint
+CREATE TABLE `channel_allowlist_entries` (
+	`channel` text NOT NULL,
+	`sender_id` text NOT NULL,
+	`source` text NOT NULL DEFAULT 'pairing',
+	`created_at` integer NOT NULL,
+	PRIMARY KEY(`channel`, `sender_id`)
+);
+--> statement-breakpoint
+CREATE INDEX `channel_allowlist_entries_channel_idx` ON `channel_allowlist_entries` (`channel`, `created_at`);
+--> statement-breakpoint
+CREATE TABLE `channel_inbound_dedupe` (
+	`channel` text NOT NULL,
+	`event_id` text NOT NULL,
+	`seen_at` integer NOT NULL,
+	PRIMARY KEY(`channel`, `event_id`)
+);
+--> statement-breakpoint
+CREATE INDEX `channel_inbound_dedupe_seen_idx` ON `channel_inbound_dedupe` (`seen_at`);

package/drizzle/0006_usage_event_dimensions.sql

@@ -0,0 +1,7 @@
+ALTER TABLE `usage_events` ADD `provider_id` text;
+--> statement-breakpoint
+ALTER TABLE `usage_events` ADD `model_id` text;
+--> statement-breakpoint
+CREATE INDEX `usage_events_provider_created_idx` ON `usage_events` (`provider_id`, `created_at`);
+--> statement-breakpoint
+CREATE INDEX `usage_events_provider_model_created_idx` ON `usage_events` (`provider_id`, `model_id`, `created_at`);