hypervibes 0.0.0-stage → 0.4.0-beta

package/dist/db/database.js

@@ -0,0 +1,31 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+/** Owns a fresh-app SQLite connection; does not create domain or Durable tables. */
+export function openDatabase(path) {
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const database = new DatabaseSync(path);
+    try {
+        // Set pointer-map support only for fresh profiles. Existing NONE profiles
+        // require an explicitly planned VACUUM conversion, never a startup rebuild.
+        const schema = database.prepare("SELECT count(*) AS total FROM sqlite_schema WHERE type='table'").get();
+        if (schema?.total === 0)
+            database.exec("PRAGMA auto_vacuum = INCREMENTAL");
+        // Connection-local settings must also be applied to any future connections.
+        database.exec("PRAGMA busy_timeout = 5000");
+        const mode = database.prepare("PRAGMA journal_mode = WAL").get();
+        if (mode?.journal_mode !== "wal") {
+            throw new Error("The application database requires file-backed SQLite WAL mode");
+        }
+        database.exec(`
+      PRAGMA synchronous = FULL;
+      PRAGMA foreign_keys = ON;
+      PRAGMA wal_autocheckpoint = 1000;
+    `);
+        return database;
+    }
+    catch (error) {
+        database.close();
+        throw error;
+    }
+}

package/dist/db/exchange-schema.js

@@ -0,0 +1,23 @@
+import { check, integer, sqliteTable, text, blob } from "drizzle-orm/sqlite-core";
+import { sql } from "drizzle-orm";
+import { hvUsers } from "./auth-schema.js";
+/**
+ * Per-user Hyperliquid settings: the single trading signer (API wallet) and
+ * builder-fee approval state. The private key is encrypted at rest and is
+ * loaded only by exchange-signing code.
+ */
+export const hvHyperliquidSettings = sqliteTable("hv_hyperliquid_settings", {
+    userId: text("user_id").primaryKey().references(() => hvUsers.id, { onDelete: "restrict" }),
+    apiWalletAddress: text("api_wallet_address"),
+    privateKeyCiphertext: blob("private_key_ciphertext", { mode: "buffer" }),
+    privateKeyKeyId: text("private_key_key_id"),
+    apiWalletApprovedAt: integer("api_wallet_approved_at"),
+    apiWalletExpiresAt: integer("api_wallet_expires_at"),
+    apiWalletExpiryCheckedAt: integer("api_wallet_expiry_checked_at"),
+    builderFeeTenthsOfBp: integer("builder_fee_tenths_of_bp").notNull().default(0),
+    builderFeeApprovedAt: integer("builder_fee_approved_at"),
+    createdAt: integer("created_at").notNull(),
+    updatedAt: integer("updated_at").notNull(),
+}, (table) => [
+    check("hv_hyperliquid_settings_builder_fee_check", sql `${table.builderFeeTenthsOfBp} BETWEEN 0 AND 100`),
+]);

package/dist/db/gateway-schema.js

@@ -0,0 +1,24 @@
+import { blob, integer, primaryKey, sqliteTable, text, uniqueIndex } from "drizzle-orm/sqlite-core";
+import { hvAgents } from "./agent-schema.js";
+/** The gateway kinds the application understands; each is owned by its connector module. */
+export const GATEWAY_TYPES = ["telegram"];
+/** One external gateway per Agent and type: bridges a bound chat with the Agent's persistent main conversation. */
+export const hvGateways = sqliteTable("hv_gateways", {
+    agentId: text("agent_id").notNull().references(() => hvAgents.id, { onDelete: "cascade" }),
+    type: text("type", { enum: GATEWAY_TYPES }).notNull(),
+    /** AES-256-GCM sealed bot token; never rendered, logged, or returned to clients. */
+    botTokenCiphertext: blob("bot_token_ciphertext", { mode: "buffer" }).notNull(),
+    /** SHA-256 of the plaintext token; a unique index stops two Agents sharing one bot. */
+    botTokenHash: text("bot_token_hash").notNull(),
+    /** Encryption key id that sealed the token, for future key rotation. */
+    keyId: text("key_id").notNull(),
+    /** The bot's own username on the gateway platform. */
+    botUsername: text("bot_username").notNull(),
+    /** The external chat that completed the link flow; null until linked. */
+    chatId: integer("chat_id"),
+    chatUsername: text("chat_username"),
+    updatedAt: integer("updated_at").notNull(),
+}, (table) => [
+    primaryKey({ columns: [table.agentId, table.type] }),
+    uniqueIndex("hv_gateways_token_hash_idx").on(table.botTokenHash),
+]);

package/dist/db/indicator-schema.js

@@ -0,0 +1,19 @@
+import { sql } from "drizzle-orm";
+import { check, index, integer, primaryKey, sqliteTable, text } from "drizzle-orm/sqlite-core";
+import { hvAgents } from "./agent-schema.js";
+export const hvIndicators = sqliteTable("hv_indicators", {
+    id: text("id").primaryKey(), agentId: text("agent_id").notNull().references(() => hvAgents.id, { onDelete: "cascade" }),
+    name: text("name").notNull(), description: text("description").notNull(), interpretation: text("interpretation").notNull(),
+    currentVersion: integer("current_version").notNull(), createdAt: integer("created_at").notNull(), updatedAt: integer("updated_at").notNull(),
+}, (t) => [index("hv_indicators_agent_idx").on(t.agentId, t.updatedAt), check("hv_indicators_version_positive", sql `${t.currentVersion} > 0`)]);
+export const hvIndicatorVersions = sqliteTable("hv_indicator_versions", {
+    indicatorId: text("indicator_id").notNull().references(() => hvIndicators.id, { onDelete: "cascade" }), version: integer("version").notNull(),
+    source: text("source").notNull(), sourceHash: text("source_hash").notNull(), metadata: text("metadata").notNull(),
+    engineVersion: text("engine_version").notNull(), wrapperVersion: integer("wrapper_version").notNull(),
+    createdAt: integer("created_at").notNull(), actorKind: text("actor_kind", { enum: ["user", "agent"] }).notNull(),
+    userId: text("user_id"), subagentId: text("subagent_id"), runId: text("run_id"), conversationId: text("conversation_id"), taskId: text("task_id"),
+}, (t) => [primaryKey({ columns: [t.indicatorId, t.version] }), check("hv_indicator_versions_positive", sql `${t.version} > 0`)]);
+export const hvIndicatorOperations = sqliteTable("hv_indicator_operations", {
+    agentId: text("agent_id").notNull().references(() => hvAgents.id, { onDelete: "cascade" }),
+    key: text("key").notNull(), hash: text("hash").notNull(), result: text("result").notNull(),
+}, (t) => [primaryKey({ columns: [t.agentId, t.key] })]);

package/dist/db/migrations/20261015221717_auth/migration.sql

@@ -0,0 +1,62 @@
+CREATE TABLE `hv_auth_accounts` (
+	`id` text PRIMARY KEY,
+	`account_id` text NOT NULL,
+	`provider_id` text NOT NULL,
+	`user_id` text NOT NULL,
+	`access_token` text,
+	`refresh_token` text,
+	`id_token` text,
+	`access_token_expires_at` integer,
+	`refresh_token_expires_at` integer,
+	`scope` text,
+	`password` text,
+	`created_at` integer DEFAULT (cast(unixepoch('subsecond') * 1000 as integer)) NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_auth_accounts_user_id_hv_users_id_fk` FOREIGN KEY (`user_id`) REFERENCES `hv_users`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `hv_auth_verifications` (
+	`id` text PRIMARY KEY,
+	`identifier` text NOT NULL,
+	`value` text NOT NULL,
+	`expires_at` integer NOT NULL,
+	`created_at` integer DEFAULT (cast(unixepoch('subsecond') * 1000 as integer)) NOT NULL,
+	`updated_at` integer DEFAULT (cast(unixepoch('subsecond') * 1000 as integer)) NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `hv_sessions` (
+	`id` text PRIMARY KEY,
+	`expires_at` integer NOT NULL,
+	`token` text NOT NULL UNIQUE,
+	`created_at` integer DEFAULT (cast(unixepoch('subsecond') * 1000 as integer)) NOT NULL,
+	`updated_at` integer NOT NULL,
+	`ip_address` text,
+	`user_agent` text,
+	`user_id` text NOT NULL,
+	CONSTRAINT `fk_hv_sessions_user_id_hv_users_id_fk` FOREIGN KEY (`user_id`) REFERENCES `hv_users`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `hv_users` (
+	`id` text PRIMARY KEY,
+	`name` text NOT NULL,
+	`email` text NOT NULL UNIQUE,
+	`email_verified` integer DEFAULT false NOT NULL,
+	`image` text,
+	`created_at` integer DEFAULT (cast(unixepoch('subsecond') * 1000 as integer)) NOT NULL,
+	`updated_at` integer DEFAULT (cast(unixepoch('subsecond') * 1000 as integer)) NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `hv_wallet_addresses` (
+	`id` text PRIMARY KEY,
+	`user_id` text NOT NULL,
+	`address` text NOT NULL,
+	`chain_id` integer NOT NULL,
+	`is_primary` integer DEFAULT false,
+	`created_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_wallet_addresses_user_id_hv_users_id_fk` FOREIGN KEY (`user_id`) REFERENCES `hv_users`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE INDEX `hvAuthAccounts_userId_idx` ON `hv_auth_accounts` (`user_id`);--> statement-breakpoint
+CREATE INDEX `hvAuthVerifications_identifier_idx` ON `hv_auth_verifications` (`identifier`);--> statement-breakpoint
+CREATE INDEX `hvSessions_userId_idx` ON `hv_sessions` (`user_id`);--> statement-breakpoint
+CREATE INDEX `hvWalletAddresses_userId_idx` ON `hv_wallet_addresses` (`user_id`);

package/dist/db/migrations/20261015231224_agents/migration.sql

@@ -0,0 +1,35 @@
+CREATE TABLE `hv_agents` (
+	`id` text PRIMARY KEY,
+	`user_id` text NOT NULL,
+	`name` text NOT NULL,
+	`creation_request_id` text NOT NULL,
+	`state` text DEFAULT 'provisioning' NOT NULL,
+	`enabled` integer DEFAULT true NOT NULL,
+	`conversation_id` integer,
+	`error` text,
+	`trading_account_address` text,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_agents_user_id_hv_users_id_fk` FOREIGN KEY (`user_id`) REFERENCES `hv_users`(`id`) ON DELETE RESTRICT,
+	CONSTRAINT "hv_agents_name_check" CHECK(length(trim("name")) BETWEEN 1 AND 80),
+	CONSTRAINT "hv_agents_state_check" CHECK("state" IN ('provisioning', 'ready', 'failed', 'stopping', 'stopped'))
+);
+--> statement-breakpoint
+CREATE INDEX `hv_agents_owner_idx` ON `hv_agents` (`user_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_agents_creation_request_idx` ON `hv_agents` (`user_id`,`creation_request_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_agents_trading_account_idx` ON `hv_agents` (`trading_account_address`);--> statement-breakpoint
+CREATE TABLE `hv_hyperliquid_settings` (
+	`user_id` text PRIMARY KEY,
+	`api_wallet_address` text,
+	`private_key_ciphertext` blob,
+	`private_key_key_id` text,
+	`api_wallet_approved_at` integer,
+	`api_wallet_expires_at` integer,
+	`api_wallet_expiry_checked_at` integer,
+	`builder_fee_tenths_of_bp` integer DEFAULT 0 NOT NULL,
+	`builder_fee_approved_at` integer,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_hyperliquid_settings_user_id_hv_users_id_fk` FOREIGN KEY (`user_id`) REFERENCES `hv_users`(`id`) ON DELETE RESTRICT,
+	CONSTRAINT "hv_hyperliquid_settings_builder_fee_check" CHECK("builder_fee_tenths_of_bp" BETWEEN 0 AND 100)
+);

package/dist/db/migrations/20261016040641_provider_connections/migration.sql

@@ -0,0 +1,19 @@
+CREATE TABLE `hv_installation` (
+	`id` integer PRIMARY KEY,
+	`device_id` text NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `hv_provider_connections` (
+	`user_id` text NOT NULL,
+	`provider_id` text NOT NULL,
+	`auth_type` text NOT NULL,
+	`ciphertext` blob NOT NULL,
+	`key_id` text NOT NULL,
+	`catalog` text,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `hv_provider_connections_pk` PRIMARY KEY(`user_id`, `provider_id`),
+	CONSTRAINT `fk_hv_provider_connections_user_id_hv_users_id_fk` FOREIGN KEY (`user_id`) REFERENCES `hv_users`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+ALTER TABLE `hv_agents` ADD `initial_provider` text;--> statement-breakpoint
+ALTER TABLE `hv_agents` ADD `initial_model_id` text;

package/dist/db/migrations/20261016061831_trade_journal/migration.sql

@@ -0,0 +1,48 @@
+CREATE TABLE `hv_journal_accounts` (
+	`account` text PRIMARY KEY,
+	`revision` integer DEFAULT 0 NOT NULL,
+	`projected_revision` integer DEFAULT -1 NOT NULL,
+	`history_limited` integer DEFAULT 0 NOT NULL,
+	CONSTRAINT "hv_journal_history_limited" CHECK("history_limited" IN (0, 1))
+);
+--> statement-breakpoint
+CREATE TABLE `hv_journal_entries` (
+	`account` text NOT NULL,
+	`id` text NOT NULL,
+	`kind` text NOT NULL,
+	`time` integer NOT NULL,
+	`data` text NOT NULL,
+	`balance` text,
+	`active` integer DEFAULT 1 NOT NULL,
+	CONSTRAINT `hv_journal_entries_pk` PRIMARY KEY(`account`, `id`),
+	CONSTRAINT `fk_hv_journal_entries_account_hv_journal_accounts_account_fk` FOREIGN KEY (`account`) REFERENCES `hv_journal_accounts`(`account`),
+	CONSTRAINT "hv_journal_entry_kind" CHECK("kind" IN ('fill', 'funding', 'ledger', 'trade')),
+	CONSTRAINT "hv_journal_entry_active" CHECK("active" IN (0, 1))
+);
+--> statement-breakpoint
+CREATE TABLE `hv_journal_notes` (
+	`id` text PRIMARY KEY,
+	`account` text NOT NULL,
+	`target` text NOT NULL,
+	`author_id` text NOT NULL,
+	`body` text NOT NULL,
+	`created_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_journal_notes_author_id_hv_users_id_fk` FOREIGN KEY (`author_id`) REFERENCES `hv_users`(`id`),
+	CONSTRAINT `fk_hv_journal_notes_account_target_hv_journal_entries_account_id_fk` FOREIGN KEY (`account`,`target`) REFERENCES `hv_journal_entries`(`account`,`id`),
+	CONSTRAINT "hv_journal_note_body" CHECK(length(trim("body")) > 0 AND length("body") <= 4000)
+);
+--> statement-breakpoint
+CREATE TABLE `hv_journal_sync` (
+	`account` text NOT NULL,
+	`stream` text NOT NULL,
+	`cursor` integer DEFAULT 0 NOT NULL,
+	`updated_at` integer,
+	`error` text,
+	CONSTRAINT `hv_journal_sync_pk` PRIMARY KEY(`account`, `stream`),
+	CONSTRAINT `fk_hv_journal_sync_account_hv_journal_accounts_account_fk` FOREIGN KEY (`account`) REFERENCES `hv_journal_accounts`(`account`),
+	CONSTRAINT "hv_journal_sync_stream" CHECK("stream" IN ('fill', 'funding', 'ledger'))
+);
+--> statement-breakpoint
+CREATE INDEX `hv_journal_entries_page` ON `hv_journal_entries` (`account`,`kind`,`active`,`time`,`id`);--> statement-breakpoint
+CREATE INDEX `hv_journal_entries_timeline` ON `hv_journal_entries` (`account`,`time`,`id`);--> statement-breakpoint
+CREATE INDEX `hv_journal_notes_target` ON `hv_journal_notes` (`account`,`target`,`created_at`,`id`);

package/dist/db/migrations/20261016080320_order_execution/migration.sql

@@ -0,0 +1,62 @@
+CREATE TABLE `hv_exchange_nonces` (
+	`signer` text PRIMARY KEY,
+	`nonce` integer NOT NULL
+);
+--> statement-breakpoint
+CREATE TABLE `hv_order_actions` (
+	`id` text PRIMARY KEY,
+	`request_id` text NOT NULL,
+	`ordinal` integer NOT NULL,
+	`payload` text NOT NULL,
+	`state` text NOT NULL,
+	`nonce` integer,
+	`expires_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_order_actions_request_id_hv_order_requests_id_fk` FOREIGN KEY (`request_id`) REFERENCES `hv_order_requests`(`id`) ON DELETE CASCADE,
+	CONSTRAINT "hv_order_action_state" CHECK("state" IN ('prepared', 'submitting', 'unknown', 'done', 'not_sent'))
+);
+--> statement-breakpoint
+CREATE TABLE `hv_order_events` (
+	`id` integer PRIMARY KEY AUTOINCREMENT,
+	`item_id` text NOT NULL,
+	`source` text NOT NULL,
+	`time` integer NOT NULL,
+	`data` text NOT NULL,
+	CONSTRAINT `fk_hv_order_events_item_id_hv_order_items_id_fk` FOREIGN KEY (`item_id`) REFERENCES `hv_order_items`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `hv_order_items` (
+	`id` text PRIMARY KEY,
+	`action_id` text NOT NULL,
+	`ordinal` integer NOT NULL,
+	`symbol` text NOT NULL,
+	`cloid` text,
+	`oid` text,
+	`active` integer NOT NULL,
+	`view` text NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_order_items_action_id_hv_order_actions_id_fk` FOREIGN KEY (`action_id`) REFERENCES `hv_order_actions`(`id`) ON DELETE CASCADE,
+	CONSTRAINT "hv_order_item_active" CHECK("active" IN (0, 1))
+);
+--> statement-breakpoint
+CREATE TABLE `hv_order_requests` (
+	`id` text PRIMARY KEY,
+	`agent_id` text NOT NULL,
+	`account` text NOT NULL,
+	`request_key` text NOT NULL,
+	`kind` text NOT NULL,
+	`input` text NOT NULL,
+	`created_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_order_requests_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE,
+	CONSTRAINT "hv_order_request_kind" CHECK("kind" IN ('submit', 'cancel', 'cancel_all', 'close_position'))
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_order_action_ordinal` ON `hv_order_actions` (`request_id`,`ordinal`);--> statement-breakpoint
+CREATE INDEX `hv_order_actions_state` ON `hv_order_actions` (`state`,`updated_at`);--> statement-breakpoint
+CREATE INDEX `hv_order_events_item` ON `hv_order_events` (`item_id`,`id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_order_item_ordinal` ON `hv_order_items` (`action_id`,`ordinal`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_order_item_cloid` ON `hv_order_items` (`cloid`);--> statement-breakpoint
+CREATE INDEX `hv_order_items_active` ON `hv_order_items` (`active`,`updated_at`);--> statement-breakpoint
+CREATE INDEX `hv_order_items_oid` ON `hv_order_items` (`oid`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_order_request_key` ON `hv_order_requests` (`agent_id`,`request_key`);--> statement-breakpoint
+CREATE INDEX `hv_order_requests_agent` ON `hv_order_requests` (`agent_id`,`created_at`);

package/dist/db/migrations/20261016181110_subagents/migration.sql

@@ -0,0 +1,51 @@
+CREATE TABLE `hv_subagent_runs` (
+	`id` text PRIMARY KEY,
+	`agent_id` text NOT NULL,
+	`subagent_id` text NOT NULL,
+	`request_id` text NOT NULL,
+	`source` text NOT NULL,
+	`task` text NOT NULL,
+	`config` text NOT NULL,
+	`status` text DEFAULT 'queued' NOT NULL,
+	`task_id` integer,
+	`conversation_id` integer,
+	`result` text DEFAULT '' NOT NULL,
+	`created_at` integer NOT NULL,
+	`finished_at` integer,
+	`reported_at` integer,
+	CONSTRAINT `fk_hv_subagent_runs_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_subagent_runs_subagent_id_hv_subagents_id_fk` FOREIGN KEY (`subagent_id`) REFERENCES `hv_subagents`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `hv_subagents` (
+	`id` text PRIMARY KEY,
+	`agent_id` text NOT NULL,
+	`kind` text NOT NULL,
+	`name` text NOT NULL,
+	`description` text DEFAULT '' NOT NULL,
+	`instructions` text NOT NULL,
+	`provider` text NOT NULL,
+	`model_id` text NOT NULL,
+	`thinking_level` text DEFAULT '' NOT NULL,
+	`tools` text NOT NULL,
+	`enabled` integer DEFAULT true NOT NULL,
+	`archived` integer DEFAULT false NOT NULL,
+	`delegatable` integer DEFAULT true NOT NULL,
+	`persistent` integer DEFAULT false NOT NULL,
+	`conversation_id` integer,
+	`schedule` text DEFAULT '' NOT NULL,
+	`delay_seconds` integer DEFAULT 30 NOT NULL,
+	`next_run_at` integer,
+	`completion` text DEFAULT 'wake' NOT NULL,
+	`timeout_seconds` integer DEFAULT 900 NOT NULL,
+	`created_at` integer NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_subagents_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE,
+	CONSTRAINT "hv_subagents_main_protected" CHECK("kind" != 'orchestrator' OR ("enabled" = 1 AND "archived" = 0 AND "schedule" = ''))
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_subagent_runs_request_idx` ON `hv_subagent_runs` (`agent_id`,`request_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_subagent_runs_active_idx` ON `hv_subagent_runs` (`subagent_id`) WHERE "hv_subagent_runs"."status" IN ('queued', 'running');--> statement-breakpoint
+CREATE INDEX `hv_subagent_runs_history_idx` ON `hv_subagent_runs` (`subagent_id`,`created_at`);--> statement-breakpoint
+CREATE INDEX `hv_subagents_agent_idx` ON `hv_subagents` (`agent_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_subagents_main_idx` ON `hv_subagents` (`agent_id`) WHERE "hv_subagents"."kind" = 'orchestrator';

package/dist/db/migrations/20261017222959_research_artifacts/migration.sql

@@ -0,0 +1,37 @@
+CREATE TABLE `hv_artifact_links` (
+	`parent` text NOT NULL,
+	`child` text NOT NULL,
+	CONSTRAINT `fk_hv_artifact_links_parent_hv_artifacts_id_fk` FOREIGN KEY (`parent`) REFERENCES `hv_artifacts`(`id`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_artifact_links_child_hv_artifacts_id_fk` FOREIGN KEY (`child`) REFERENCES `hv_artifacts`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `hv_artifact_receipts` (
+	`agent_id` text NOT NULL,
+	`operation_key` text NOT NULL,
+	`request_hash` text NOT NULL,
+	`artifact_id` text NOT NULL,
+	CONSTRAINT `fk_hv_artifact_receipts_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `hv_artifacts` (
+	`id` text PRIMARY KEY,
+	`agent_id` text NOT NULL,
+	`title` text NOT NULL,
+	`description` text NOT NULL,
+	`media_type` text NOT NULL,
+	`payload` blob NOT NULL,
+	`size` integer NOT NULL,
+	`tags` text NOT NULL,
+	`instrument` text NOT NULL,
+	`interval` text NOT NULL,
+	`conversation_id` integer,
+	`task_id` integer,
+	`created_at` integer NOT NULL,
+	`expires_at` integer,
+	CONSTRAINT `fk_hv_artifacts_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_artifact_links_pair_idx` ON `hv_artifact_links` (`parent`,`child`);--> statement-breakpoint
+CREATE INDEX `hv_artifact_links_child_idx` ON `hv_artifact_links` (`child`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_artifact_receipts_operation_idx` ON `hv_artifact_receipts` (`agent_id`,`operation_key`);--> statement-breakpoint
+CREATE INDEX `hv_artifacts_agent_idx` ON `hv_artifacts` (`agent_id`,`created_at`);

package/dist/db/migrations/20261018061531_memories_and_insights/migration.sql

@@ -0,0 +1,162 @@
+CREATE TABLE `hv_memories` (
+	`agent_id` text NOT NULL,
+	`number` integer NOT NULL,
+	`kind` text NOT NULL,
+	`topic` text NOT NULL,
+	`instrument` text,
+	`interval` text,
+	`summary` text NOT NULL,
+	`content` text NOT NULL,
+	`payload` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`evidence_as_of` integer,
+	`valid_until` integer,
+	`producer_subagent_id` text,
+	`source_run_id` text,
+	`conversation_id` integer,
+	`tool_task_id` integer,
+	`retracted_at` integer,
+	`retraction_reason` text,
+	CONSTRAINT `hv_memories_pk` PRIMARY KEY(`agent_id`, `number`),
+	CONSTRAINT `fk_hv_memories_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_memories_agent_id_producer_subagent_id_hv_subagents_agent_id_id_fk` FOREIGN KEY (`agent_id`,`producer_subagent_id`) REFERENCES `hv_subagents`(`agent_id`,`id`),
+	CONSTRAINT `fk_hv_memories_agent_id_source_run_id_producer_subagent_id_hv_subagent_runs_agent_id_id_subagent_id_fk` FOREIGN KEY (`agent_id`,`source_run_id`,`producer_subagent_id`) REFERENCES `hv_subagent_runs`(`agent_id`,`id`,`subagent_id`),
+	CONSTRAINT "hv_memory_number_positive" CHECK("number" BETWEEN 1 AND 9007199254740990),
+	CONSTRAINT "hv_memory_kind" CHECK("kind" IN ('research','decision','review')),
+	CONSTRAINT "hv_memory_text_bounds" CHECK(length("summary") BETWEEN 1 AND 500 AND length("content") BETWEEN 1 AND 16000 AND length(CAST("payload" AS BLOB)) <= 16384 AND json_valid("payload")),
+	CONSTRAINT "hv_memory_research_deadline" CHECK("kind" != 'research' OR ("evidence_as_of" IS NOT NULL AND "valid_until" IS NOT NULL AND "valid_until" > "evidence_as_of" AND "instrument" IS NOT NULL AND "interval" IS NOT NULL)),
+	CONSTRAINT "hv_memory_run_producer" CHECK("source_run_id" IS NULL OR "producer_subagent_id" IS NOT NULL),
+	CONSTRAINT "hv_memory_retraction" CHECK(("retracted_at" IS NULL) = ("retraction_reason" IS NULL))
+);
+--> statement-breakpoint
+CREATE TABLE `hv_memory_artifacts` (
+	`agent_id` text NOT NULL,
+	`memory_number` integer NOT NULL,
+	`artifact_id` text NOT NULL,
+	CONSTRAINT `hv_memory_artifacts_pk` PRIMARY KEY(`agent_id`, `memory_number`, `artifact_id`),
+	CONSTRAINT `fk_hv_memory_artifacts_agent_id_memory_number_hv_memories_agent_id_number_fk` FOREIGN KEY (`agent_id`,`memory_number`) REFERENCES `hv_memories`(`agent_id`,`number`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_memory_artifacts_agent_id_artifact_id_hv_artifacts_agent_id_id_fk` FOREIGN KEY (`agent_id`,`artifact_id`) REFERENCES `hv_artifacts`(`agent_id`,`id`)
+);
+--> statement-breakpoint
+CREATE TABLE `hv_memory_counters` (
+	`agent_id` text PRIMARY KEY,
+	`next_number` integer DEFAULT 1 NOT NULL,
+	CONSTRAINT `fk_hv_memory_counters_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE,
+	CONSTRAINT "hv_memory_counter_positive" CHECK("next_number" BETWEEN 1 AND 9007199254740991)
+);
+--> statement-breakpoint
+CREATE TABLE `hv_memory_links` (
+	`agent_id` text NOT NULL,
+	`source_number` integer NOT NULL,
+	`target_number` integer NOT NULL,
+	`relation` text NOT NULL,
+	CONSTRAINT `hv_memory_links_pk` PRIMARY KEY(`agent_id`, `source_number`, `target_number`, `relation`),
+	CONSTRAINT `fk_hv_memory_links_agent_id_source_number_hv_memories_agent_id_number_fk` FOREIGN KEY (`agent_id`,`source_number`) REFERENCES `hv_memories`(`agent_id`,`number`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_memory_links_agent_id_target_number_hv_memories_agent_id_number_fk` FOREIGN KEY (`agent_id`,`target_number`) REFERENCES `hv_memories`(`agent_id`,`number`),
+	CONSTRAINT "hv_memory_link_backward" CHECK("target_number" < "source_number"),
+	CONSTRAINT "hv_memory_link_relation" CHECK("relation" IN ('based_on','corrects','supersedes','reviews'))
+);
+--> statement-breakpoint
+CREATE TABLE `hv_memory_operations` (
+	`agent_id` text NOT NULL,
+	`operation_key` text NOT NULL,
+	`operation_kind` text NOT NULL,
+	`request_hash` text NOT NULL,
+	`result` text NOT NULL,
+	`created_at` integer NOT NULL,
+	CONSTRAINT `hv_memory_operations_pk` PRIMARY KEY(`agent_id`, `operation_key`),
+	CONSTRAINT `fk_hv_memory_operations_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE
+);
+--> statement-breakpoint
+CREATE TABLE `hv_insight_revision_memories` (
+	`agent_id` text NOT NULL,
+	`set_id` text NOT NULL,
+	`version` integer NOT NULL,
+	`memory_number` integer NOT NULL,
+	CONSTRAINT `hv_insight_revision_memories_pk` PRIMARY KEY(`agent_id`, `set_id`, `version`, `memory_number`),
+	CONSTRAINT `fk_hv_insight_revision_memories_agent_id_set_id_version_hv_insight_revisions_agent_id_set_id_version_fk` FOREIGN KEY (`agent_id`,`set_id`,`version`) REFERENCES `hv_insight_revisions`(`agent_id`,`set_id`,`version`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_insight_revision_memories_agent_id_memory_number_hv_memories_agent_id_number_fk` FOREIGN KEY (`agent_id`,`memory_number`) REFERENCES `hv_memories`(`agent_id`,`number`)
+);
+--> statement-breakpoint
+CREATE TABLE `hv_insight_revisions` (
+	`agent_id` text NOT NULL,
+	`set_id` text NOT NULL,
+	`version` integer NOT NULL,
+	`content` text NOT NULL,
+	`operation` text NOT NULL,
+	`reason` text NOT NULL,
+	`created_at` integer NOT NULL,
+	`actor_user_id` text,
+	`producer_subagent_id` text,
+	`source_run_id` text,
+	`conversation_id` integer,
+	`tool_task_id` integer,
+	CONSTRAINT `hv_insight_revisions_pk` PRIMARY KEY(`set_id`, `version`),
+	CONSTRAINT `fk_hv_insight_revisions_agent_id_set_id_hv_insight_sets_agent_id_id_fk` FOREIGN KEY (`agent_id`,`set_id`) REFERENCES `hv_insight_sets`(`agent_id`,`id`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_insight_revisions_agent_id_producer_subagent_id_hv_subagents_agent_id_id_fk` FOREIGN KEY (`agent_id`,`producer_subagent_id`) REFERENCES `hv_subagents`(`agent_id`,`id`),
+	CONSTRAINT `fk_hv_insight_revisions_agent_id_source_run_id_producer_subagent_id_hv_subagent_runs_agent_id_id_subagent_id_fk` FOREIGN KEY (`agent_id`,`source_run_id`,`producer_subagent_id`) REFERENCES `hv_subagent_runs`(`agent_id`,`id`,`subagent_id`),
+	CONSTRAINT "hv_insight_revision_version" CHECK("version" BETWEEN 1 AND 9007199254740990),
+	CONSTRAINT "hv_insight_content_bound" CHECK(length("content") <= 8000),
+	CONSTRAINT "hv_insight_operation" CHECK("operation" IN ('append','replace')),
+	CONSTRAINT "hv_insight_revision_actor" CHECK(("actor_user_id" IS NOT NULL AND "source_run_id" IS NULL) OR ("actor_user_id" IS NULL AND "producer_subagent_id" IS NOT NULL))
+);
+--> statement-breakpoint
+CREATE TABLE `hv_insight_sets` (
+	`id` text PRIMARY KEY,
+	`agent_id` text NOT NULL,
+	`scope_kind` text NOT NULL,
+	`subagent_id` text,
+	`current_version` integer DEFAULT 0 NOT NULL,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_insight_sets_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_insight_sets_agent_id_subagent_id_hv_subagents_agent_id_id_fk` FOREIGN KEY (`agent_id`,`subagent_id`) REFERENCES `hv_subagents`(`agent_id`,`id`),
+	CONSTRAINT "hv_insight_scope" CHECK(("scope_kind" = 'agent' AND "subagent_id" IS NULL) OR ("scope_kind" = 'worker' AND "subagent_id" IS NOT NULL)),
+	CONSTRAINT "hv_insight_head" CHECK("current_version" BETWEEN 0 AND 9007199254740990)
+);
+--> statement-breakpoint
+CREATE TABLE `hv_subagent_run_contexts` (
+	`agent_id` text NOT NULL,
+	`run_id` text PRIMARY KEY,
+	`context` text NOT NULL,
+	CONSTRAINT `fk_hv_subagent_run_contexts_agent_id_run_id_hv_subagent_runs_agent_id_id_fk` FOREIGN KEY (`agent_id`,`run_id`) REFERENCES `hv_subagent_runs`(`agent_id`,`id`) ON DELETE CASCADE,
+	CONSTRAINT "hv_run_context_bound" CHECK(length("context") <= 120000)
+);
+--> statement-breakpoint
+CREATE TABLE `hv_risk_settings` (
+	`agent_id` text PRIMARY KEY,
+	`trading_enabled` integer DEFAULT false NOT NULL,
+	`allowed_instruments` text,
+	`max_order_notional` text,
+	`max_total_notional` text,
+	`updated_at` integer NOT NULL,
+	CONSTRAINT `fk_hv_risk_settings_agent_id_hv_agents_id_fk` FOREIGN KEY (`agent_id`) REFERENCES `hv_agents`(`id`) ON DELETE CASCADE,
+	CONSTRAINT "hv_risk_instruments_bound" CHECK(length(coalesce("allowed_instruments", '[]')) <= 4000 AND json_valid(coalesce("allowed_instruments", '[]')))
+);
+--> statement-breakpoint
+ALTER TABLE `hv_subagents` ADD `template_origin` text;--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_order_request_identity` ON `hv_order_requests` (`agent_id`,`id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_subagent_runs_producer_idx` ON `hv_subagent_runs` (`agent_id`,`id`,`subagent_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_subagent_runs_identity_idx` ON `hv_subagent_runs` (`agent_id`,`id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_subagents_identity_idx` ON `hv_subagents` (`agent_id`,`id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_artifacts_identity_idx` ON `hv_artifacts` (`agent_id`,`id`);--> statement-breakpoint
+CREATE INDEX `hv_memories_history_idx` ON `hv_memories` (`agent_id`,`created_at`,`number`);--> statement-breakpoint
+CREATE INDEX `hv_memories_stream_idx` ON `hv_memories` (`agent_id`,`kind`,`instrument`,`topic`,`interval`,`producer_subagent_id`,`number`);--> statement-breakpoint
+CREATE INDEX `hv_memories_run_idx` ON `hv_memories` (`agent_id`,`source_run_id`);--> statement-breakpoint
+CREATE INDEX `hv_memory_artifacts_evidence_idx` ON `hv_memory_artifacts` (`agent_id`,`artifact_id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_insight_revision_identity_idx` ON `hv_insight_revisions` (`agent_id`,`set_id`,`version`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_insight_sets_identity_idx` ON `hv_insight_sets` (`agent_id`,`id`);--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_insight_sets_agent_idx` ON `hv_insight_sets` (`agent_id`) WHERE "hv_insight_sets"."scope_kind" = 'agent';--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_insight_sets_worker_idx` ON `hv_insight_sets` (`agent_id`,`subagent_id`) WHERE "hv_insight_sets"."scope_kind" = 'worker';--> statement-breakpoint
+CREATE TABLE `hv_order_request_provenance` (
+	`request_id` text PRIMARY KEY,
+	`agent_id` text NOT NULL,
+	`producer_subagent_id` text NOT NULL,
+	`source_run_id` text,
+	`conversation_id` integer NOT NULL,
+	`tool_task_id` integer NOT NULL,
+	CONSTRAINT `fk_hv_order_request_provenance_agent_id_request_id_hv_order_requests_agent_id_id_fk` FOREIGN KEY (`agent_id`,`request_id`) REFERENCES `hv_order_requests`(`agent_id`,`id`) ON DELETE CASCADE,
+	CONSTRAINT `fk_hv_order_request_provenance_agent_id_producer_subagent_id_hv_subagents_agent_id_id_fk` FOREIGN KEY (`agent_id`,`producer_subagent_id`) REFERENCES `hv_subagents`(`agent_id`,`id`),
+	CONSTRAINT `fk_hv_order_request_provenance_agent_id_source_run_id_producer_subagent_id_hv_subagent_runs_agent_id_id_subagent_id_fk` FOREIGN KEY (`agent_id`,`source_run_id`,`producer_subagent_id`) REFERENCES `hv_subagent_runs`(`agent_id`,`id`,`subagent_id`)
+);
+--> statement-breakpoint
+CREATE INDEX `hv_order_provenance_run_idx` ON `hv_order_request_provenance` (`agent_id`,`source_run_id`);

package/dist/db/migrations/20261020091156_worker_event_inbox/migration.sql

@@ -0,0 +1,54 @@
+ALTER TABLE `hv_subagents` ADD `triggers` text DEFAULT '{"inboxEnabled":false,"workerDelegates":[],"researchSources":[],"fills":false,"orderChanges":false}' NOT NULL;
+--> statement-breakpoint
+CREATE TABLE `hv_worker_requests` (
+  `id` text PRIMARY KEY,
+  `agent_id` text NOT NULL REFERENCES `hv_agents` (`id`) ON DELETE CASCADE,
+  `subagent_id` text NOT NULL,
+  `event_key` text NOT NULL,
+  `payload` text NOT NULL,
+  `created_at` integer NOT NULL,
+  `run_id` text,
+  `discarded_reason` text,
+  FOREIGN KEY (`agent_id`, `subagent_id`) REFERENCES `hv_subagents` (`agent_id`, `id`),
+  FOREIGN KEY (`agent_id`, `run_id`, `subagent_id`) REFERENCES `hv_subagent_runs` (`agent_id`, `id`, `subagent_id`)
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `hv_worker_requests_event_idx` ON `hv_worker_requests` (`agent_id`, `subagent_id`, `event_key`);
+--> statement-breakpoint
+CREATE INDEX `hv_worker_requests_pending_idx` ON `hv_worker_requests` (`subagent_id`, `created_at`) WHERE `run_id` IS NULL AND `discarded_reason` IS NULL;
+
+--> statement-breakpoint
+CREATE TABLE hv_worker_subscriptions (
+  subagent_id text NOT NULL REFERENCES hv_subagents(id) ON DELETE CASCADE,
+  event_type text NOT NULL,
+  source_id text NOT NULL,
+  activated_at integer NOT NULL,
+  PRIMARY KEY (subagent_id, event_type, source_id)
+);
+--> statement-breakpoint
+CREATE VIEW hv_enabled_worker_subscriptions AS
+  SELECT s.id AS subagent_id, 'research' AS event_type, j.value AS source_id, s.updated_at AS activated_at
+  FROM hv_subagents s, json_each(s.triggers, '$.researchSources') j
+  WHERE s.enabled=1 AND s.archived=0 AND json_extract(s.triggers,'$.inboxEnabled')=1
+  UNION ALL
+  SELECT id, 'fill', '', updated_at FROM hv_subagents
+  WHERE enabled=1 AND archived=0 AND json_extract(triggers,'$.inboxEnabled')=1 AND json_extract(triggers,'$.fills')=1
+  UNION ALL
+  SELECT id, 'order_status', '', updated_at FROM hv_subagents
+  WHERE enabled=1 AND archived=0 AND json_extract(triggers,'$.inboxEnabled')=1 AND json_extract(triggers,'$.orderChanges')=1;
+--> statement-breakpoint
+INSERT INTO hv_worker_subscriptions SELECT * FROM hv_enabled_worker_subscriptions;
+--> statement-breakpoint
+CREATE TRIGGER hv_worker_subscriptions_insert AFTER INSERT ON hv_subagents BEGIN
+  INSERT INTO hv_worker_subscriptions SELECT * FROM hv_enabled_worker_subscriptions WHERE subagent_id=NEW.id;
+END;
+--> statement-breakpoint
+CREATE TRIGGER hv_worker_subscriptions_update AFTER UPDATE OF triggers, enabled, archived ON hv_subagents BEGIN
+  DELETE FROM hv_worker_subscriptions WHERE subagent_id=NEW.id AND NOT EXISTS (
+    SELECT 1 FROM hv_enabled_worker_subscriptions v WHERE v.subagent_id=NEW.id
+      AND v.event_type=hv_worker_subscriptions.event_type AND v.source_id=hv_worker_subscriptions.source_id
+  );
+  INSERT INTO hv_worker_subscriptions SELECT * FROM hv_enabled_worker_subscriptions WHERE subagent_id=NEW.id
+    AND NOT EXISTS (SELECT 1 FROM hv_worker_subscriptions old WHERE old.subagent_id=NEW.id
+      AND old.event_type=hv_enabled_worker_subscriptions.event_type AND old.source_id=hv_enabled_worker_subscriptions.source_id);
+END;