@inf-minds/jobs 0.0.1

package/dist/schema.d.ts.map

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

package/dist/schema.js

@@ -0,0 +1,225 @@
+// ABOUTME: Drizzle ORM schema for jobs and job_events tables
+// ABOUTME: Defines PostgreSQL tables for job management and event streaming
+import { pgTable, uuid, text, timestamp, jsonb, real, bigserial, index, integer, boolean, unique, bigint, } from 'drizzle-orm/pg-core';
+/**
+ * Job status enum values.
+ */
+export const JOB_STATUS = {
+    PENDING: 'pending',
+    QUEUED: 'queued',
+    BLOCKED: 'blocked',
+    RUNNING: 'running',
+    COMPLETED: 'completed',
+    FAILED: 'failed',
+    CANCELLED: 'cancelled',
+};
+/**
+ * Job priority levels.
+ * Lower number = higher priority.
+ */
+export const JOB_PRIORITY = {
+    URGENT: 0,
+    HIGH: 25,
+    NORMAL: 50,
+    LOW: 75,
+};
+/**
+ * Jobs table - tracks background job execution.
+ */
+export const jobs = pgTable('jobs', {
+    /** Unique job identifier */
+    id: uuid('id').primaryKey().defaultRandom(),
+    /** Job type (e.g., 'ai-organize', 'haiku-build') */
+    type: text('type').notNull(),
+    /** Current job status */
+    status: text('status').notNull().default(JOB_STATUS.PENDING),
+    /** Account this job belongs to */
+    accountId: uuid('account_id').notNull(),
+    /** Job-specific input data */
+    input: jsonb('input'),
+    /** Job result (on completion) */
+    output: jsonb('output'),
+    /** Error message (on failure) */
+    error: text('error'),
+    /** Progress from 0.0 to 1.0 */
+    progress: real('progress'),
+    /** ID of worker processing this job (legacy) */
+    workerId: text('worker_id'),
+    /** When job started processing */
+    startedAt: timestamp('started_at', { withTimezone: true }),
+    /** When job completed (success or failure) */
+    completedAt: timestamp('completed_at', { withTimezone: true }),
+    /** When job was created */
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    /** When job was last updated */
+    updatedAt: timestamp('updated_at', { withTimezone: true }).defaultNow().notNull(),
+    // Coordinator columns
+    /** Priority: 0=urgent, 25=high, 50=normal, 75=low */
+    priority: integer('priority').default(JOB_PRIORITY.NORMAL),
+    /** Lease expiration for running jobs */
+    leaseUntil: timestamp('lease_until', { withTimezone: true }),
+    /** Current attempt number (0-indexed) */
+    attempt: integer('attempt').default(0),
+    /** Maximum retry attempts */
+    maxAttempts: integer('max_attempts').default(5),
+    /** When job should next be considered for dispatch */
+    nextRunAt: timestamp('next_run_at', { withTimezone: true }).defaultNow(),
+    /** ID of assigned worker from coordinator */
+    assignedWorkerId: text('assigned_worker_id'),
+    /** Distributed tracing ID */
+    traceId: text('trace_id'),
+    // Kernel orchestration columns
+    /** Links child mind-execution jobs to their parent kernel-session job */
+    parentJobId: uuid('parent_job_id'),
+    /** Tracks which graph node this mind-execution job corresponds to */
+    nodeId: text('node_id'),
+    /** Stores execution graph state (active nodes, completed nodes, outputs) */
+    graphState: jsonb('graph_state'),
+    /** Root path for this sessions materialized artifact paths */
+    artifactBasePath: text('artifact_base_path'),
+}, (table) => [
+    index('jobs_account_id_idx').on(table.accountId),
+    index('jobs_status_idx').on(table.status),
+    index('jobs_type_status_idx').on(table.type, table.status),
+    // Scheduler index
+    index('idx_jobs_scheduler').on(table.accountId, table.status, table.priority, table.nextRunAt),
+    // Lease recovery index
+    index('idx_jobs_lease').on(table.status, table.leaseUntil),
+    // Status lookup for dependency resolution
+    index('idx_jobs_status_lookup').on(table.id, table.status),
+    // Kernel orchestration indexes
+    index('idx_jobs_parent').on(table.parentJobId),
+    index('idx_jobs_kernel_session').on(table.id, table.accountId),
+    index('idx_jobs_mind_execution').on(table.parentJobId, table.nodeId),
+]);
+/**
+ * Job events table - append-only event log for each job.
+ *
+ * Uses BIGSERIAL for offset encoding (lexicographically sortable).
+ */
+export const jobEvents = pgTable('job_events', {
+    /** Sequential event ID (used for offset encoding) */
+    id: bigserial('id', { mode: 'bigint' }).primaryKey(),
+    /** Job this event belongs to */
+    jobId: uuid('job_id')
+        .notNull()
+        .references(() => jobs.id, { onDelete: 'cascade' }),
+    /** Event type (e.g., 'status', 'progress', 'log', 'result', 'error', 'complete') */
+    eventType: text('event_type').notNull(),
+    /** Event payload data */
+    payload: jsonb('payload').notNull(),
+    /** When event was created */
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+}, (table) => [
+    index('job_events_job_id_idx').on(table.jobId),
+    index('job_events_job_id_id_idx').on(table.jobId, table.id),
+]);
+/**
+ * Job workers table - tracks registered job workers.
+ */
+export const jobWorkers = pgTable('job_workers', {
+    /** Unique worker record identifier */
+    id: uuid('id').primaryKey().defaultRandom(),
+    /** Worker identifier (e.g., 'ai-worker-1') */
+    workerId: text('worker_id').notNull().unique(),
+    /** Job types this worker handles (e.g., ['ai-organize', 'ai-summarize']) */
+    jobTypes: text('job_types').array().notNull(),
+    /** Callback URL or relay client ID */
+    callbackUrl: text('callback_url').notNull(),
+    /** Whether callbacks should be routed through relay */
+    callbackViaRelay: boolean('callback_via_relay').default(true),
+    /** Maximum concurrent jobs this worker can handle */
+    capacity: integer('capacity').default(10),
+    /** Current number of active jobs */
+    currentLoad: integer('current_load').default(0),
+    /** Last heartbeat timestamp */
+    lastHeartbeatAt: timestamp('last_heartbeat_at', { withTimezone: true }).defaultNow().notNull(),
+    /** When worker was first registered */
+    registeredAt: timestamp('registered_at', { withTimezone: true }).defaultNow().notNull(),
+    /** Additional worker metadata */
+    metadata: jsonb('metadata'),
+}, (table) => [
+    index('idx_job_workers_heartbeat').on(table.lastHeartbeatAt),
+]);
+/**
+ * Job dependencies table - tracks job-to-job dependencies.
+ * Job A depends on Job B means A cannot run until B completes.
+ */
+export const jobDependencies = pgTable('job_dependencies', {
+    /** Unique dependency record identifier */
+    id: uuid('id').primaryKey().defaultRandom(),
+    /** Job that has the dependency (waits for depends_on_job to complete) */
+    jobId: uuid('job_id')
+        .notNull()
+        .references(() => jobs.id, { onDelete: 'cascade' }),
+    /** Job that must complete first */
+    dependsOnJobId: uuid('depends_on_job_id')
+        .notNull()
+        .references(() => jobs.id, { onDelete: 'cascade' }),
+    /** When dependency was created */
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+}, (table) => [
+    index('idx_job_deps_job').on(table.jobId),
+    index('idx_job_deps_depends').on(table.dependsOnJobId),
+    unique('job_dependency_unique').on(table.jobId, table.dependsOnJobId),
+]);
+/**
+ * Artifact visibility scope values.
+ */
+export const ARTIFACT_VISIBILITY = {
+    /** Only visible to the creating job/mind */
+    PRIVATE: 'private',
+    /** Visible to all jobs/minds within the kernel session */
+    SESSION: 'session',
+    /** Persisted beyond session lifetime */
+    PERSISTENT: 'persistent',
+};
+/**
+ * Job artifacts table - stores files produced by jobs.
+ * Text artifacts stored in JSONB content column.
+ * Binary artifacts reference external storage (R2).
+ */
+export const jobArtifacts = pgTable('job_artifacts', {
+    /** Unique artifact identifier */
+    id: uuid('id').primaryKey().defaultRandom(),
+    /** Job that owns this artifact */
+    jobId: uuid('job_id')
+        .notNull()
+        .references(() => jobs.id, { onDelete: 'cascade' }),
+    /** Artifact name (path within job scope) */
+    name: text('name').notNull(),
+    /** MIME type */
+    mimeType: text('mime_type').notNull(),
+    /** Storage type: 'postgres' for text, 'external' for binaries */
+    storageType: text('storage_type').notNull(),
+    /** Content for postgres-stored artifacts */
+    content: jsonb('content'),
+    /** External storage key (R2 object key) */
+    externalKey: text('external_key'),
+    /** Size in bytes */
+    sizeBytes: bigint('size_bytes', { mode: 'number' }).notNull(),
+    /** Custom metadata */
+    metadata: jsonb('metadata').default({}),
+    /** When artifact expires (null = no expiration) */
+    expiresAt: timestamp('expires_at', { withTimezone: true }),
+    /** When artifact was created */
+    createdAt: timestamp('created_at', { withTimezone: true }).defaultNow().notNull(),
+    // Artifact routing columns (for kernel orchestration)
+    /** Visibility scope: private, session, or persistent */
+    visibility: text('visibility').default(ARTIFACT_VISIBILITY.SESSION),
+    /** Kernel session this artifact belongs to (NULL for non-kernel jobs) */
+    sessionId: uuid('session_id'),
+    /** Named channels this artifact is published to */
+    channels: text('channels').array(),
+    /** Graph node that created this artifact */
+    nodeId: text('node_id'),
+}, (table) => [
+    index('idx_job_artifacts_job').on(table.jobId),
+    index('idx_job_artifacts_expires').on(table.expiresAt),
+    unique('job_artifact_unique').on(table.jobId, table.name),
+    // Artifact routing indexes
+    index('idx_artifacts_session').on(table.sessionId),
+    index('idx_artifacts_visibility').on(table.visibility),
+    index('idx_artifacts_node').on(table.sessionId, table.nodeId),
+]);
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,4EAA4E;AAE5E,OAAO,EACL,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,KAAK,EACL,IAAI,EACJ,SAAS,EACT,KAAK,EACL,OAAO,EACP,OAAO,EACP,MAAM,EACN,MAAM,GACP,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;CACd,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,EAAE;IACR,MAAM,EAAE,EAAE;IACV,GAAG,EAAE,EAAE;CACC,CAAC;AAMX;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,OAAO,CACzB,MAAM,EACN;IACE,4BAA4B;IAC5B,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE;IAC3C,oDAAoD;IACpD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,yBAAyB;IACzB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAC5D,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,8BAA8B;IAC9B,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;IACvB,iCAAiC;IACjC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC;IAC1B,gDAAgD;IAChD,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC;IAC3B,kCAAkC;IAClC,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1D,8CAA8C;IAC9C,WAAW,EAAE,SAAS,CAAC,cAAc,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC9D,2BAA2B;IAC3B,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;IACjF,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;IAEjF,sBAAsB;IACtB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC;IAC1D,wCAAwC;IACxC,UAAU,EAAE,SAAS,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC5D,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACtC,6BAA6B;IAC7B,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,sDAAsD;IACtD,SAAS,EAAE,SAAS,CAAC,aAAa,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE;IACxE,6CAA6C;IAC7C,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC;IAC5C,6BAA6B;IAC7B,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC;IAEzB,+BAA+B;IAC/B,yEAAyE;IACzE,WAAW,EAAE,IAAI,CAAC,eAAe,CAAC;IAClC,qEAAqE;IACrE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;IACvB,4EAA4E;IAC5E,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC;IAChC,8DAA8D;IAC9D,gBAAgB,EAAE,IAAI,CAAC,oBAAoB,CAAC;CAC7C,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAChD,KAAK,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC;IACzC,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;IAC1D,kBAAkB;IAClB,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9F,uBAAuB;IACvB,KAAK,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC;IAC1D,0CAA0C;IAC1C,KAAK,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;IAC1D,+BAA+B;IAC/B,KAAK,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC;IAC9C,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC;IAC9D,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;CACrE,CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAC9B,YAAY,EACZ;IACE,qDAAqD;IACrD,EAAE,EAAE,SAAS,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,UAAU,EAAE;IACpD,gCAAgC;IAChC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC;SAClB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACrD,oFAAoF;IACpF,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE;IACvC,yBAAyB;IACzB,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IACnC,6BAA6B;IAC7B,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;CAClF,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;IAC9C,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC;CAC5D,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,OAAO,CAC/B,aAAa,EACb;IACE,sCAAsC;IACtC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE;IAC3C,8CAA8C;IAC9C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE;IAC9C,4EAA4E;IAC5E,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE;IAC7C,sCAAsC;IACtC,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC3C,uDAAuD;IACvD,gBAAgB,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7D,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,+BAA+B;IAC/B,eAAe,EAAE,SAAS,CAAC,mBAAmB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;IAC9F,uCAAuC;IACvC,YAAY,EAAE,SAAS,CAAC,eAAe,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;IACvF,iCAAiC;IACjC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC;CAC5B,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC;CAC7D,CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CACpC,kBAAkB,EAClB;IACE,0CAA0C;IAC1C,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE;IAC3C,yEAAyE;IACzE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC;SAClB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACrD,mCAAmC;IACnC,cAAc,EAAE,IAAI,CAAC,mBAAmB,CAAC;SACtC,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACrD,kCAAkC;IAClC,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;CAClF,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;IACzC,KAAK,CAAC,sBAAsB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC;IACtD,MAAM,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC;CACtE,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,4CAA4C;IAC5C,OAAO,EAAE,SAAS;IAClB,0DAA0D;IAC1D,OAAO,EAAE,SAAS;IAClB,wCAAwC;IACxC,UAAU,EAAE,YAAY;CAChB,CAAC;AAKX;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CACjC,eAAe,EACf;IACE,iCAAiC;IACjC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC,aAAa,EAAE;IAC3C,kCAAkC;IAClC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC;SAClB,OAAO,EAAE;SACT,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACrD,4CAA4C;IAC5C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,gBAAgB;IAChB,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE;IACrC,iEAAiE;IACjE,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;IAC3C,4CAA4C;IAC5C,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC;IACzB,2CAA2C;IAC3C,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC;IACjC,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IAC7D,sBAAsB;IACtB,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACvC,mDAAmD;IACnD,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC1D,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,OAAO,EAAE;IAEjF,sDAAsD;IACtD,wDAAwD;IACxD,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC;IACnE,yEAAyE;IACzE,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE;IAClC,4CAA4C;IAC5C,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;CACxB,EACD,CAAC,KAAK,EAAE,EAAE,CAAC;IACT,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC;IAC9C,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACtD,MAAM,CAAC,qBAAqB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC;IACzD,2BAA2B;IAC3B,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAClD,KAAK,CAAC,0BAA0B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACtD,KAAK,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;CAC9D,CACF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,434 @@
+import type { Job, JobStatus } from './schema.js';
+import type { ArtifactManager } from './artifact-manager.js';
+import type { ArtifactMaterializer } from './artifact-materializer.js';
+/**
+ * Well-known job types for kernel orchestration.
+ */
+export declare const JOB_TYPE: {
+    /** Parent session that orchestrates mind execution graph */
+    readonly KERNEL_SESSION: "kernel-session";
+    /** Child job executing a single mind/node in the graph */
+    readonly MIND_EXECUTION: "mind-execution";
+};
+export type KernelJobType = (typeof JOB_TYPE)[keyof typeof JOB_TYPE];
+/**
+ * State of a node in the execution graph.
+ */
+export interface GraphNodeState {
+    /** Node ID from the coordination mode definition */
+    nodeId: string;
+    /** Current execution status */
+    status: 'pending' | 'active' | 'completed' | 'failed' | 'skipped';
+    /** Job ID if execution has started */
+    jobId?: string;
+    /** Output data if completed */
+    output?: unknown;
+    /** Error message if failed */
+    error?: string;
+    /** When the node started execution */
+    startedAt?: string;
+    /** When the node completed */
+    completedAt?: string;
+}
+/**
+ * Execution state for a kernel session's graph.
+ * Stored in jobs.graph_state for kernel-session jobs.
+ */
+export interface GraphState {
+    /** All nodes and their current states */
+    nodes: Record<string, GraphNodeState>;
+    /** IDs of nodes currently executing */
+    activeNodes: string[];
+    /** IDs of nodes that have completed successfully */
+    completedNodes: string[];
+    /** IDs of nodes that failed */
+    failedNodes: string[];
+    /** IDs of nodes that were skipped (condition not met) */
+    skippedNodes: string[];
+    /** Session start time */
+    startedAt: string;
+    /** Session end time (when all nodes complete or fatal failure) */
+    completedAt?: string;
+    /** Overall session status */
+    status: 'running' | 'completed' | 'failed';
+}
+/**
+ * Options for creating a new job.
+ */
+export interface CreateJobOptions<TInput = unknown> {
+    /** Job type identifier */
+    type: string;
+    /** Account ID this job belongs to */
+    accountId: string;
+    /** Job-specific input data */
+    input?: TInput;
+    /** Parent job ID (for mind-execution jobs linked to a kernel-session) */
+    parentJobId?: string;
+    /** Graph node ID (for mind-execution jobs) */
+    nodeId?: string;
+    /** Initial graph state (for kernel-session jobs) */
+    graphState?: GraphState;
+    /** Base path for artifact materialization */
+    artifactBasePath?: string;
+}
+/**
+ * Options for listing jobs.
+ */
+export interface ListJobsOptions {
+    /** Filter by account ID (required) */
+    accountId: string;
+    /** Filter by job type */
+    type?: string;
+    /** Filter by status */
+    status?: JobStatus;
+    /** Maximum number of jobs to return */
+    limit?: number;
+    /** Number of jobs to skip */
+    offset?: number;
+}
+/**
+ * Result of listing jobs.
+ */
+export interface ListJobsResult {
+    /** Jobs matching the query */
+    jobs: Job[];
+    /** Total count (for pagination) */
+    total?: number;
+}
+/**
+ * Job manager interface for CRUD operations.
+ */
+export interface JobManager {
+    /**
+     * Create a new job.
+     */
+    create<TInput = unknown>(options: CreateJobOptions<TInput>): Promise<Job>;
+    /**
+     * Get a job by ID.
+     */
+    get(jobId: string): Promise<Job | null>;
+    /**
+     * List jobs with filtering and pagination.
+     */
+    list(options: ListJobsOptions): Promise<ListJobsResult>;
+    /**
+     * Cancel a job (only if pending or running).
+     */
+    cancel(jobId: string): Promise<void>;
+    /**
+     * Update job progress.
+     */
+    updateProgress(jobId: string, progress: number): Promise<void>;
+    /**
+     * Mark job as completed with output.
+     */
+    complete<TOutput = unknown>(jobId: string, output?: TOutput): Promise<void>;
+    /**
+     * Mark job as failed with error message.
+     */
+    fail(jobId: string, error: string): Promise<void>;
+}
+/**
+ * Database client interface (subset of Drizzle).
+ */
+export interface DbClient {
+    insert: (table: unknown) => {
+        values: (values: unknown) => {
+            returning: () => Promise<unknown[]>;
+        };
+    };
+    select: (fields?: unknown) => {
+        from: (table: unknown) => {
+            where: (condition: unknown) => DbQueryChain;
+        };
+    };
+    update: (table: unknown) => {
+        set: (values: unknown) => {
+            where: (condition: unknown) => Promise<unknown[]>;
+        };
+    };
+}
+/**
+ * Chainable query result type.
+ */
+export interface DbQueryChain extends Promise<unknown[]> {
+    orderBy: (order: unknown) => {
+        limit: (n: number) => Promise<unknown[]> & {
+            offset: (n: number) => Promise<unknown[]>;
+        };
+    };
+}
+/**
+ * Options for appending an event.
+ */
+export interface AppendEventOptions<TPayload = unknown> {
+    /** Job ID this event belongs to */
+    jobId: string;
+    /** Event type (e.g., 'progress', 'log', 'error') */
+    type: string;
+    /** Event payload data */
+    payload: TPayload;
+}
+/**
+ * Result of appending an event.
+ */
+export interface AppendEventResult {
+    /** Encoded offset of the appended event */
+    offset: string;
+}
+/**
+ * Options for getting events.
+ */
+export interface GetEventsOptions {
+    /** Job ID to get events for */
+    jobId: string;
+    /** Starting offset (default: '-1' for beginning) */
+    offset?: string;
+    /** Maximum number of events to return (default: 100) */
+    limit?: number;
+}
+/**
+ * Result of getting events.
+ */
+export interface GetEventsResult<TPayload = unknown> {
+    /** Events matching the query */
+    events: Array<{
+        id: string;
+        type: string;
+        payload: TPayload;
+        createdAt: Date;
+    }>;
+    /** Next offset to use for pagination */
+    nextOffset: string;
+    /** True when caught up to current tail */
+    upToDate: boolean;
+    /** True when stream is permanently closed */
+    closed: boolean;
+}
+/**
+ * EventAppender interface for event streaming.
+ */
+export interface EventAppender {
+    /**
+     * Append an event to a job's event stream.
+     */
+    append<TPayload = unknown>(options: AppendEventOptions<TPayload>): Promise<AppendEventResult>;
+    /**
+     * Get events from a job's event stream.
+     */
+    getEvents<TPayload = unknown>(options: GetEventsOptions): Promise<GetEventsResult<TPayload>>;
+    /**
+     * Check if a job's stream is closed (job completed/failed/cancelled).
+     */
+    isStreamClosed(jobId: string): Promise<boolean>;
+}
+/**
+ * Options for saving an artifact.
+ */
+export interface SaveArtifactOptions {
+    /** MIME type (auto-detected from name if not provided) */
+    mimeType?: string;
+    /** Custom metadata */
+    metadata?: Record<string, unknown>;
+    /** Expiry in seconds from now (overrides job default) */
+    expiresIn?: number;
+}
+/**
+ * Reference to a stored artifact.
+ */
+export interface ArtifactRef {
+    /** Artifact name (path within job) */
+    name: string;
+    /** MIME type */
+    mimeType: string;
+    /** Size in bytes */
+    sizeBytes: number;
+    /** Storage location */
+    storageType: 'postgres' | 'external';
+    /** Custom metadata */
+    metadata: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: Date;
+}
+/**
+ * Artifact with content.
+ */
+export interface ArtifactContent extends ArtifactRef {
+    /** Artifact content */
+    content: string | Buffer;
+}
+/**
+ * Default TTL values for artifact retention.
+ */
+export declare const ARTIFACT_TTL: {
+    /** Completed jobs: 365 days */
+    readonly COMPLETED: number;
+    /** Failed jobs: 28 days */
+    readonly FAILED: number;
+};
+/**
+ * Context provided to job handlers for emitting events and controlling execution.
+ */
+export interface JobContext<TInput = unknown> {
+    /** The job being processed */
+    readonly job: Job;
+    /** Typed input data */
+    readonly input: TInput;
+    /** Abort signal for cancellation */
+    readonly signal: AbortSignal;
+    /**
+     * Emit a custom event to the job's stream.
+     */
+    emit<TPayload = unknown>(type: string, payload: TPayload): Promise<void>;
+    /**
+     * Update job progress (0.0 - 1.0) with optional message.
+     */
+    progress(value: number, message?: string): Promise<void>;
+    /**
+     * Log a message to the job's stream.
+     */
+    log(message: string, level?: 'info' | 'warn' | 'error'): Promise<void>;
+    /**
+     * Save an artifact.
+     */
+    saveArtifact(name: string, content: string | Buffer, options?: SaveArtifactOptions): Promise<ArtifactRef>;
+    /**
+     * Load an artifact from this job.
+     */
+    loadArtifact(name: string): Promise<ArtifactContent | null>;
+    /**
+     * Load an artifact from a dependency job.
+     */
+    loadDependencyArtifact(path: string): Promise<ArtifactContent | null>;
+    /**
+     * List all artifacts for this job.
+     */
+    listArtifacts(): Promise<ArtifactRef[]>;
+    /**
+     * Get signed URL for external artifact.
+     */
+    getArtifactUrl(name: string, expiresIn?: number): Promise<string | null>;
+}
+/**
+ * Handler function that processes a job.
+ */
+export type JobHandler<TInput = unknown, TOutput = unknown> = (ctx: JobContext<TInput>) => Promise<TOutput>;
+/**
+ * Options for creating a JobRunner.
+ */
+export interface JobRunnerOptions {
+    /** JobManager instance for job lifecycle */
+    jobManager: JobManager;
+    /** EventAppender instance for event streaming */
+    eventAppender: EventAppender;
+    /** Optional: Relay callback URL for real-time push */
+    relayCallbackUrl?: string;
+    /** Optional: Fetch function for relay callbacks (for CF Worker compatibility) */
+    fetch?: typeof globalThis.fetch;
+    /** ArtifactManager for artifact operations (optional) */
+    artifactManager?: ArtifactManager;
+    /** ArtifactMaterializer for dependency artifacts (optional) */
+    artifactMaterializer?: ArtifactMaterializer;
+}
+/**
+ * Options for running a job.
+ */
+export interface RunJobOptions<TInput = unknown> {
+    /** Job type identifier */
+    type: string;
+    /** Account ID */
+    accountId: string;
+    /** Job input data */
+    input: TInput;
+    /** Optional: existing job ID to resume */
+    jobId?: string;
+    /** Optional: abort signal from request */
+    signal?: AbortSignal;
+}
+/**
+ * Result of running a job.
+ */
+export interface RunJobResult<TOutput = unknown> {
+    /** The job record */
+    job: Job;
+    /** Job output (if completed successfully) */
+    output?: TOutput;
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * JobRunner for direct execution of jobs.
+ */
+export interface JobRunner {
+    /**
+     * Run a job with the given handler.
+     * Creates the job, executes the handler, and marks complete/failed.
+     */
+    run<TInput = unknown, TOutput = unknown>(options: RunJobOptions<TInput>, handler: JobHandler<TInput, TOutput>): Promise<RunJobResult<TOutput>>;
+    /**
+     * Resume a job that was previously started.
+     * Useful for Durable Object alarm-based execution.
+     */
+    resume<TInput = unknown, TOutput = unknown>(jobId: string, handler: JobHandler<TInput, TOutput>, signal?: AbortSignal): Promise<RunJobResult<TOutput>>;
+}
+/**
+ * Extended context for mind-execution jobs with parent session awareness.
+ */
+export interface MindJobContext<TInput = unknown> extends JobContext<TInput> {
+    /** Parent kernel session job ID */
+    readonly parentJobId: string;
+    /** This mind's node ID in the graph */
+    readonly nodeId: string;
+    /**
+     * Load an artifact from a sibling node in the same session.
+     * @param nodeId - Node ID of the sibling
+     * @param name - Artifact name
+     */
+    loadSiblingArtifact(nodeId: string, name: string): Promise<ArtifactContent | null>;
+    /**
+     * Load all artifacts from a sibling node.
+     * @param nodeId - Node ID of the sibling
+     */
+    listSiblingArtifacts(nodeId: string): Promise<ArtifactRef[]>;
+}
+/**
+ * Options for creating a mind-execution child job.
+ */
+export interface CreateMindJobOptions<TInput = unknown> {
+    /** Node ID in the graph */
+    nodeId: string;
+    /** Mind-specific input data */
+    input: TInput;
+    /** Optional priority override */
+    priority?: number;
+}
+/**
+ * Context for kernel-session jobs to manage graph execution.
+ */
+export interface KernelSessionContext<TInput = unknown> extends JobContext<TInput> {
+    /** Current graph execution state */
+    readonly graphState: GraphState;
+    /** Base path for artifact materialization */
+    readonly artifactBasePath: string;
+    /**
+     * Create a child mind-execution job for a graph node.
+     */
+    createMindJob<TNodeInput = unknown>(options: CreateMindJobOptions<TNodeInput>): Promise<Job>;
+    /**
+     * Update the graph state (active nodes, completed nodes, etc.).
+     */
+    updateGraphState(update: Partial<GraphState>): Promise<void>;
+    /**
+     * Mark a node as completed with output.
+     */
+    completeNode(nodeId: string, output?: unknown): Promise<void>;
+    /**
+     * Mark a node as failed with error.
+     */
+    failNode(nodeId: string, error: string): Promise<void>;
+    /**
+     * Mark a node as skipped (condition not met).
+     */
+    skipNode(nodeId: string, reason?: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map