@secondlayer/shared 0.10.2 → 0.12.0

package/dist/src/schemas/workflows.d.ts

@@ -0,0 +1,66 @@
+import { z } from "zod/v4";
+interface DeployWorkflowRequest {
+	name: string;
+	trigger: Record<string, unknown>;
+	handlerCode: string;
+	retries?: {
+		maxAttempts?: number
+		backoffMs?: number
+		backoffMultiplier?: number
+	};
+	timeout?: number;
+}
+declare const DeployWorkflowRequestSchema: z.ZodType<DeployWorkflowRequest>;
+interface DeployWorkflowResponse {
+	action: "created" | "updated";
+	workflowId: string;
+	message: string;
+}
+interface WorkflowSummaryResponse {
+	name: string;
+	version: string;
+	status: string;
+	triggerType: string;
+	totalRuns: number;
+	lastRunAt: string | null;
+	createdAt: string;
+	updatedAt: string;
+}
+interface WorkflowDetailResponse extends WorkflowSummaryResponse {
+	triggerConfig: Record<string, unknown>;
+	retriesConfig: Record<string, unknown> | null;
+	timeoutMs: number | null;
+}
+interface WorkflowRunResponse {
+	id: string;
+	workflowName: string;
+	status: string;
+	triggerType: string;
+	triggerData: Record<string, unknown> | null;
+	error: string | null;
+	startedAt: string | null;
+	completedAt: string | null;
+	durationMs: number | null;
+	totalAiTokens: number;
+	createdAt: string;
+	steps: WorkflowStepResponse[];
+}
+interface WorkflowStepResponse {
+	id: string;
+	stepIndex: number;
+	stepId: string;
+	stepType: string;
+	status: string;
+	output: unknown | null;
+	error: string | null;
+	retryCount: number;
+	aiTokensUsed: number;
+	startedAt: string | null;
+	completedAt: string | null;
+	durationMs: number | null;
+}
+interface TriggerWorkflowRequest {
+	input?: Record<string, unknown>;
+}
+declare const TriggerWorkflowRequestSchema: z.ZodType<TriggerWorkflowRequest>;
+export { WorkflowSummaryResponse, WorkflowStepResponse, WorkflowRunResponse, WorkflowDetailResponse, TriggerWorkflowRequestSchema, TriggerWorkflowRequest, DeployWorkflowResponse, DeployWorkflowRequestSchema, DeployWorkflowRequest };

package/dist/src/schemas/workflows.js

@@ -0,0 +1,39 @@
+import { createRequire } from "node:module";
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/schemas/workflows.ts
+import { z } from "zod/v4";
+var DeployWorkflowRequestSchema = z.object({
+  name: z.string().regex(/^[a-z][a-z0-9-]*$/, "lowercase alphanumeric + hyphens, must start with letter").max(63),
+  trigger: z.record(z.string(), z.unknown()),
+  handlerCode: z.string().max(1048576, "handler code exceeds 1MB limit"),
+  retries: z.object({
+    maxAttempts: z.number().int().positive().optional(),
+    backoffMs: z.number().int().nonnegative().optional(),
+    backoffMultiplier: z.number().positive().optional()
+  }).optional(),
+  timeout: z.number().int().positive().optional()
+});
+var TriggerWorkflowRequestSchema = z.object({
+  input: z.record(z.string(), z.unknown()).optional()
+});
+export {
+  TriggerWorkflowRequestSchema,
+  DeployWorkflowRequestSchema
+};
+
+//# debugId=C5C0F7222546009064756E2164756E21
+//# sourceMappingURL=workflows.js.map

package/dist/src/schemas/workflows.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/schemas/workflows.ts"],
+  "sourcesContent": [
+    "import { z } from \"zod/v4\";\n\n// ── Deploy Workflow Request ──────────────────────────────────────────\n\nexport interface DeployWorkflowRequest {\n\tname: string;\n\ttrigger: Record<string, unknown>;\n\thandlerCode: string;\n\tretries?: { maxAttempts?: number; backoffMs?: number; backoffMultiplier?: number };\n\ttimeout?: number;\n}\n\nexport const DeployWorkflowRequestSchema: z.ZodType<DeployWorkflowRequest> =\n\tz.object({\n\t\tname: z\n\t\t\t.string()\n\t\t\t.regex(/^[a-z][a-z0-9-]*$/, \"lowercase alphanumeric + hyphens, must start with letter\")\n\t\t\t.max(63),\n\t\ttrigger: z.record(z.string(), z.unknown()),\n\t\thandlerCode: z.string().max(1_048_576, \"handler code exceeds 1MB limit\"),\n\t\tretries: z\n\t\t\t.object({\n\t\t\t\tmaxAttempts: z.number().int().positive().optional(),\n\t\t\t\tbackoffMs: z.number().int().nonnegative().optional(),\n\t\t\t\tbackoffMultiplier: z.number().positive().optional(),\n\t\t\t})\n\t\t\t.optional(),\n\t\ttimeout: z.number().int().positive().optional(),\n\t});\n\nexport interface DeployWorkflowResponse {\n\taction: \"created\" | \"updated\";\n\tworkflowId: string;\n\tmessage: string;\n}\n\n// ── API Response Types ───────────────────────────────────────────────\n\nexport interface WorkflowSummaryResponse {\n\tname: string;\n\tversion: string;\n\tstatus: string;\n\ttriggerType: string;\n\ttotalRuns: number;\n\tlastRunAt: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n}\n\nexport interface WorkflowDetailResponse extends WorkflowSummaryResponse {\n\ttriggerConfig: Record<string, unknown>;\n\tretriesConfig: Record<string, unknown> | null;\n\ttimeoutMs: number | null;\n}\n\nexport interface WorkflowRunResponse {\n\tid: string;\n\tworkflowName: string;\n\tstatus: string;\n\ttriggerType: string;\n\ttriggerData: Record<string, unknown> | null;\n\terror: string | null;\n\tstartedAt: string | null;\n\tcompletedAt: string | null;\n\tdurationMs: number | null;\n\ttotalAiTokens: number;\n\tcreatedAt: string;\n\tsteps: WorkflowStepResponse[];\n}\n\nexport interface WorkflowStepResponse {\n\tid: string;\n\tstepIndex: number;\n\tstepId: string;\n\tstepType: string;\n\tstatus: string;\n\toutput: unknown | null;\n\terror: string | null;\n\tretryCount: number;\n\taiTokensUsed: number;\n\tstartedAt: string | null;\n\tcompletedAt: string | null;\n\tdurationMs: number | null;\n}\n\nexport interface TriggerWorkflowRequest {\n\tinput?: Record<string, unknown>;\n}\n\nexport const TriggerWorkflowRequestSchema: z.ZodType<TriggerWorkflowRequest> =\n\tz.object({\n\t\tinput: z.record(z.string(), z.unknown()).optional(),\n\t});\n"
+  ],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAYO,IAAM,8BACZ,EAAE,OAAO;AAAA,EACR,MAAM,EACJ,OAAO,EACP,MAAM,qBAAqB,0DAA0D,EACrF,IAAI,EAAE;AAAA,EACR,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC;AAAA,EACzC,aAAa,EAAE,OAAO,EAAE,IAAI,SAAW,gCAAgC;AAAA,EACvE,SAAS,EACP,OAAO;AAAA,IACP,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AAAA,IAClD,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,IACnD,mBAAmB,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS;AAAA,EACnD,CAAC,EACA,SAAS;AAAA,EACX,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AAC/C,CAAC;AA6DK,IAAM,+BACZ,EAAE,OAAO;AAAA,EACR,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,EAAE,SAAS;AACnD,CAAC;",
+  "debugId": "C5C0F7222546009064756E2164756E21",
+  "names": []
+}

package/dist/src/types.d.ts

@@ -40,6 +40,7 @@ interface StreamsTable {
 	endpoint_url: string;
 	signing_secret: string | null;
 	api_key_id: string;
+	project_id: string | null;
 	created_at: Generated<Date>;
 	updated_at: Generated<Date>;
 }

package/migrations/0022_marketplace.ts

@@ -0,0 +1,88 @@
+import { sql, type Kysely } from "kysely";
+
+/**
+ * Add marketplace columns to subgraphs and accounts.
+ * Create per-subgraph usage tracking table.
+ */
+export async function up(db: Kysely<any>): Promise<void> {
+	// Subgraph marketplace columns
+	await db.schema
+		.alterTable("subgraphs")
+		.addColumn("is_public", "boolean", (c) => c.notNull().defaultTo(false))
+		.execute();
+	await db.schema
+		.alterTable("subgraphs")
+		.addColumn("tags", sql`text[]`, (c) => c.notNull().defaultTo(sql`'{}'`))
+		.execute();
+	await db.schema
+		.alterTable("subgraphs")
+		.addColumn("description", "text")
+		.execute();
+	await db.schema
+		.alterTable("subgraphs")
+		.addColumn("forked_from_id", "uuid", (c) =>
+			c.references("subgraphs.id").onDelete("set null"),
+		)
+		.execute();
+
+	// Account profile columns
+	await db.schema
+		.alterTable("accounts")
+		.addColumn("display_name", "text")
+		.execute();
+	await db.schema.alterTable("accounts").addColumn("bio", "text").execute();
+	await db.schema
+		.alterTable("accounts")
+		.addColumn("avatar_url", "text")
+		.execute();
+	await db.schema
+		.alterTable("accounts")
+		.addColumn("slug", "text", (c) => c.unique())
+		.execute();
+
+	// Per-subgraph usage tracking
+	await db.schema
+		.createTable("subgraph_usage_daily")
+		.addColumn("subgraph_id", "uuid", (c) =>
+			c.notNull().references("subgraphs.id").onDelete("cascade"),
+		)
+		.addColumn("date", "date", (c) => c.notNull())
+		.addColumn("query_count", "integer", (c) => c.notNull().defaultTo(0))
+		.addPrimaryKeyConstraint("subgraph_usage_daily_pk", [
+			"subgraph_id",
+			"date",
+		])
+		.execute();
+
+	// Indexes
+	await sql`CREATE INDEX subgraphs_is_public_idx ON subgraphs (is_public) WHERE is_public = true`.execute(
+		db,
+	);
+	await sql`CREATE INDEX subgraphs_tags_idx ON subgraphs USING gin (tags)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX accounts_slug_idx ON accounts (slug) WHERE slug IS NOT NULL`.execute(
+		db,
+	);
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+	await db.schema.dropTable("subgraph_usage_daily").execute();
+
+	await sql`DROP INDEX IF EXISTS accounts_slug_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS subgraphs_tags_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS subgraphs_is_public_idx`.execute(db);
+
+	await db.schema.alterTable("accounts").dropColumn("slug").execute();
+	await db.schema.alterTable("accounts").dropColumn("avatar_url").execute();
+	await db.schema.alterTable("accounts").dropColumn("bio").execute();
+	await db.schema.alterTable("accounts").dropColumn("display_name").execute();
+
+	await db.schema
+		.alterTable("subgraphs")
+		.dropColumn("forked_from_id")
+		.execute();
+	await db.schema.alterTable("subgraphs").dropColumn("description").execute();
+	await db.schema.alterTable("subgraphs").dropColumn("tags").execute();
+	await db.schema.alterTable("subgraphs").dropColumn("is_public").execute();
+}

package/migrations/0023_projects.ts

@@ -0,0 +1,149 @@
+import { sql, type Kysely } from "kysely";
+
+/**
+ * Add projects, team_members, and team_invitations tables.
+ * Add project_id to streams and subgraphs.
+ * Backfill: create a default project per account and assign existing resources.
+ */
+export async function up(db: Kysely<any>): Promise<void> {
+	// Projects table
+	await db.schema
+		.createTable("projects")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("name", "text", (c) => c.notNull())
+		.addColumn("slug", "text", (c) => c.notNull())
+		.addColumn("account_id", "uuid", (c) =>
+			c.notNull().references("accounts.id").onDelete("cascade"),
+		)
+		.addColumn("settings", "jsonb", (c) => c.notNull().defaultTo(sql`'{}'`))
+		.addColumn("network", "varchar(20)", (c) =>
+			c.notNull().defaultTo("mainnet"),
+		)
+		.addColumn("node_rpc", "text")
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.addColumn("updated_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	// Unique slug per account
+	await sql`CREATE UNIQUE INDEX projects_account_slug_idx ON projects (account_id, slug)`.execute(
+		db,
+	);
+
+	// Team members table
+	await db.schema
+		.createTable("team_members")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("project_id", "uuid", (c) =>
+			c.notNull().references("projects.id").onDelete("cascade"),
+		)
+		.addColumn("account_id", "uuid", (c) =>
+			c.notNull().references("accounts.id").onDelete("cascade"),
+		)
+		.addColumn("role", "varchar(20)", (c) => c.notNull().defaultTo("member"))
+		.addColumn("invited_by", "uuid", (c) =>
+			c.references("accounts.id").onDelete("set null"),
+		)
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	await sql`CREATE UNIQUE INDEX team_members_project_account_idx ON team_members (project_id, account_id)`.execute(
+		db,
+	);
+
+	// Team invitations table
+	await db.schema
+		.createTable("team_invitations")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("project_id", "uuid", (c) =>
+			c.notNull().references("projects.id").onDelete("cascade"),
+		)
+		.addColumn("email", "text", (c) => c.notNull())
+		.addColumn("role", "varchar(20)", (c) => c.notNull().defaultTo("member"))
+		.addColumn("token", "varchar(64)", (c) => c.notNull())
+		.addColumn("invited_by", "uuid", (c) =>
+			c.references("accounts.id").onDelete("set null"),
+		)
+		.addColumn("expires_at", "timestamptz", (c) => c.notNull())
+		.addColumn("accepted_at", "timestamptz")
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	// Add project_id to streams and subgraphs
+	await db.schema
+		.alterTable("streams")
+		.addColumn("project_id", "uuid", (c) =>
+			c.references("projects.id").onDelete("set null"),
+		)
+		.execute();
+
+	await db.schema
+		.alterTable("subgraphs")
+		.addColumn("project_id", "uuid", (c) =>
+			c.references("projects.id").onDelete("set null"),
+		)
+		.execute();
+
+	// Backfill: create default project per account, assign resources
+	await sql`
+		INSERT INTO projects (id, name, slug, account_id)
+		SELECT gen_random_uuid(), 'my-project', 'my-project', id
+		FROM accounts
+	`.execute(db);
+
+	await sql`
+		UPDATE streams SET project_id = p.id
+		FROM api_keys ak
+		JOIN projects p ON p.account_id = ak.account_id
+		WHERE streams.api_key_id = ak.id AND streams.project_id IS NULL
+	`.execute(db);
+
+	await sql`
+		UPDATE subgraphs SET project_id = p.id
+		FROM api_keys ak
+		JOIN projects p ON p.account_id = ak.account_id
+		WHERE subgraphs.api_key_id = ak.id AND subgraphs.project_id IS NULL
+	`.execute(db);
+
+	// Add owner team_member for each project
+	await sql`
+		INSERT INTO team_members (id, project_id, account_id, role)
+		SELECT gen_random_uuid(), id, account_id, 'owner'
+		FROM projects
+	`.execute(db);
+
+	// Indexes
+	await sql`CREATE INDEX streams_project_id_idx ON streams (project_id) WHERE project_id IS NOT NULL`.execute(
+		db,
+	);
+	await sql`CREATE INDEX subgraphs_project_id_idx ON subgraphs (project_id) WHERE project_id IS NOT NULL`.execute(
+		db,
+	);
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+	await sql`DROP INDEX IF EXISTS subgraphs_project_id_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS streams_project_id_idx`.execute(db);
+
+	await db.schema.alterTable("subgraphs").dropColumn("project_id").execute();
+	await db.schema.alterTable("streams").dropColumn("project_id").execute();
+
+	await db.schema.dropTable("team_invitations").execute();
+	await db.schema.dropTable("team_members").execute();
+
+	await sql`DROP INDEX IF EXISTS projects_account_slug_idx`.execute(db);
+	await db.schema.dropTable("projects").execute();
+}

package/migrations/0024_chat_sessions.ts

@@ -0,0 +1,51 @@
+import { sql, type Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+	await db.schema
+		.createTable("chat_sessions")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("account_id", "uuid", (c) =>
+			c.notNull().references("accounts.id").onDelete("cascade"),
+		)
+		.addColumn("title", "text")
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.addColumn("updated_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	await sql`CREATE INDEX chat_sessions_account_idx ON chat_sessions (account_id, created_at DESC)`.execute(
+		db,
+	);
+
+	await db.schema
+		.createTable("chat_messages")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("chat_session_id", "uuid", (c) =>
+			c.notNull().references("chat_sessions.id").onDelete("cascade"),
+		)
+		.addColumn("role", "varchar(20)", (c) => c.notNull())
+		.addColumn("parts", "jsonb", (c) => c.notNull())
+		.addColumn("metadata", "jsonb")
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	await sql`CREATE INDEX chat_messages_session_idx ON chat_messages (chat_session_id, created_at)`.execute(
+		db,
+	);
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+	await sql`DROP INDEX IF EXISTS chat_messages_session_idx`.execute(db);
+	await db.schema.dropTable("chat_messages").execute();
+	await sql`DROP INDEX IF EXISTS chat_sessions_account_idx`.execute(db);
+	await db.schema.dropTable("chat_sessions").execute();
+}

package/migrations/0025_chat_session_summary.ts

@@ -0,0 +1,15 @@
+import type { Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+	await db.schema
+		.alterTable("chat_sessions")
+		.addColumn("summary", "jsonb")
+		.execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+	await db.schema
+		.alterTable("chat_sessions")
+		.dropColumn("summary")
+		.execute();
+}

package/migrations/0026_workflows.ts

@@ -0,0 +1,204 @@
+import { sql, type Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+	// ── workflow_definitions ──────────────────────────────────────────
+	await db.schema
+		.createTable("workflow_definitions")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("name", "text", (c) => c.notNull())
+		.addColumn("version", "text", (c) => c.notNull().defaultTo("1.0.0"))
+		.addColumn("status", "text", (c) => c.notNull().defaultTo("active"))
+		.addColumn("trigger_type", "text", (c) => c.notNull())
+		.addColumn("trigger_config", "jsonb", (c) => c.notNull())
+		.addColumn("handler_path", "text", (c) => c.notNull())
+		.addColumn("retries_config", "jsonb")
+		.addColumn("timeout_ms", "integer")
+		.addColumn("api_key_id", "uuid", (c) =>
+			c.notNull().references("api_keys.id"),
+		)
+		.addColumn("project_id", "uuid", (c) =>
+			c.references("projects.id").onDelete("set null"),
+		)
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.addColumn("updated_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	await sql`CREATE UNIQUE INDEX workflow_definitions_name_key_idx ON workflow_definitions (name, api_key_id)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX workflow_definitions_status_idx ON workflow_definitions (status)`.execute(
+		db,
+	);
+
+	// ── workflow_runs ─────────────────────────────────────────────────
+	await db.schema
+		.createTable("workflow_runs")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("definition_id", "uuid", (c) =>
+			c.notNull().references("workflow_definitions.id").onDelete("cascade"),
+		)
+		.addColumn("status", "text", (c) => c.notNull().defaultTo("pending"))
+		.addColumn("trigger_type", "text", (c) => c.notNull())
+		.addColumn("trigger_data", "jsonb")
+		.addColumn("dedup_key", "text")
+		.addColumn("error", "text")
+		.addColumn("started_at", "timestamptz")
+		.addColumn("completed_at", "timestamptz")
+		.addColumn("duration_ms", "integer")
+		.addColumn("total_ai_tokens", "integer", (c) => c.notNull().defaultTo(0))
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	await sql`CREATE INDEX workflow_runs_definition_idx ON workflow_runs (definition_id, created_at DESC)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX workflow_runs_status_idx ON workflow_runs (status)`.execute(
+		db,
+	);
+	await sql`CREATE UNIQUE INDEX workflow_runs_dedup_idx ON workflow_runs (definition_id, dedup_key) WHERE dedup_key IS NOT NULL`.execute(
+		db,
+	);
+
+	// ── workflow_steps ────────────────────────────────────────────────
+	await db.schema
+		.createTable("workflow_steps")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("run_id", "uuid", (c) =>
+			c.notNull().references("workflow_runs.id").onDelete("cascade"),
+		)
+		.addColumn("step_index", "integer", (c) => c.notNull())
+		.addColumn("step_id", "text", (c) => c.notNull())
+		.addColumn("step_type", "text", (c) => c.notNull())
+		.addColumn("status", "text", (c) => c.notNull().defaultTo("pending"))
+		.addColumn("input", "jsonb")
+		.addColumn("output", "jsonb")
+		.addColumn("error", "text")
+		.addColumn("retry_count", "integer", (c) => c.notNull().defaultTo(0))
+		.addColumn("ai_tokens_used", "integer", (c) => c.notNull().defaultTo(0))
+		.addColumn("started_at", "timestamptz")
+		.addColumn("completed_at", "timestamptz")
+		.addColumn("duration_ms", "integer")
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	await sql`CREATE INDEX workflow_steps_run_idx ON workflow_steps (run_id, step_index)`.execute(
+		db,
+	);
+	await sql`CREATE UNIQUE INDEX workflow_steps_dedup_idx ON workflow_steps (run_id, step_id)`.execute(
+		db,
+	);
+
+	// ── workflow_queue ────────────────────────────────────────────────
+	await db.schema
+		.createTable("workflow_queue")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("run_id", "uuid", (c) =>
+			c.notNull().references("workflow_runs.id").onDelete("cascade"),
+		)
+		.addColumn("status", "text", (c) => c.notNull().defaultTo("pending"))
+		.addColumn("attempts", "integer", (c) => c.notNull().defaultTo(0))
+		.addColumn("max_attempts", "integer", (c) => c.notNull().defaultTo(3))
+		.addColumn("scheduled_for", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.addColumn("locked_at", "timestamptz")
+		.addColumn("locked_by", "text")
+		.addColumn("error", "text")
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.addColumn("completed_at", "timestamptz")
+		.execute();
+
+	await sql`CREATE INDEX workflow_queue_poll_idx ON workflow_queue (scheduled_for, status, locked_at)`.execute(
+		db,
+	);
+
+	// ── workflow_schedules ────────────────────────────────────────────
+	await db.schema
+		.createTable("workflow_schedules")
+		.addColumn("id", "uuid", (c) =>
+			c.primaryKey().defaultTo(sql`gen_random_uuid()`),
+		)
+		.addColumn("definition_id", "uuid", (c) =>
+			c
+				.notNull()
+				.references("workflow_definitions.id")
+				.onDelete("cascade"),
+		)
+		.addColumn("cron_expr", "text", (c) => c.notNull())
+		.addColumn("timezone", "text", (c) => c.notNull().defaultTo("UTC"))
+		.addColumn("next_run_at", "timestamptz", (c) => c.notNull())
+		.addColumn("last_run_at", "timestamptz")
+		.addColumn("enabled", "boolean", (c) => c.notNull().defaultTo(true))
+		.addColumn("created_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+
+	await sql`CREATE UNIQUE INDEX workflow_schedules_definition_idx ON workflow_schedules (definition_id)`.execute(
+		db,
+	);
+	await sql`CREATE INDEX workflow_schedules_poll_idx ON workflow_schedules (enabled, next_run_at)`.execute(
+		db,
+	);
+
+	// ── PG NOTIFY trigger on workflow_queue ───────────────────────────
+	await sql`
+		CREATE OR REPLACE FUNCTION notify_workflow_job() RETURNS trigger AS $$
+		BEGIN
+			PERFORM pg_notify('workflows:new_job', NEW.run_id::text);
+			RETURN NEW;
+		END;
+		$$ LANGUAGE plpgsql
+	`.execute(db);
+
+	await sql`
+		CREATE TRIGGER workflow_queue_notify
+			AFTER INSERT ON workflow_queue
+			FOR EACH ROW EXECUTE FUNCTION notify_workflow_job()
+	`.execute(db);
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+	await sql`DROP TRIGGER IF EXISTS workflow_queue_notify ON workflow_queue`.execute(
+		db,
+	);
+	await sql`DROP FUNCTION IF EXISTS notify_workflow_job`.execute(db);
+
+	await sql`DROP INDEX IF EXISTS workflow_schedules_poll_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS workflow_schedules_definition_idx`.execute(db);
+	await db.schema.dropTable("workflow_schedules").execute();
+
+	await sql`DROP INDEX IF EXISTS workflow_queue_poll_idx`.execute(db);
+	await db.schema.dropTable("workflow_queue").execute();
+
+	await sql`DROP INDEX IF EXISTS workflow_steps_dedup_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS workflow_steps_run_idx`.execute(db);
+	await db.schema.dropTable("workflow_steps").execute();
+
+	await sql`DROP INDEX IF EXISTS workflow_runs_dedup_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS workflow_runs_status_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS workflow_runs_definition_idx`.execute(db);
+	await db.schema.dropTable("workflow_runs").execute();
+
+	await sql`DROP INDEX IF EXISTS workflow_definitions_status_idx`.execute(db);
+	await sql`DROP INDEX IF EXISTS workflow_definitions_name_key_idx`.execute(db);
+	await db.schema.dropTable("workflow_definitions").execute();
+}

package/migrations/0027_workflow_cursors.ts

@@ -0,0 +1,16 @@
+import { sql, type Kysely } from "kysely";
+
+export async function up(db: Kysely<any>): Promise<void> {
+	await db.schema
+		.createTable("workflow_cursors")
+		.addColumn("name", "text", (c) => c.primaryKey())
+		.addColumn("block_height", "integer", (c) => c.notNull().defaultTo(0))
+		.addColumn("updated_at", "timestamptz", (c) =>
+			c.notNull().defaultTo(sql`now()`),
+		)
+		.execute();
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+	await db.schema.dropTable("workflow_cursors").execute();
+}