@inf-minds/jobs 0.0.1

package/dist/artifact-cleanup.d.ts

@@ -0,0 +1,30 @@
+import type { StorageProvider } from '@inf-minds/storage';
+export interface CleanupDb {
+    select(): {
+        from(table: unknown): {
+            where(condition: unknown): Promise<ExpiredArtifact[]>;
+        };
+    };
+    delete(table: unknown): {
+        where(condition: unknown): Promise<unknown>;
+    };
+}
+interface ExpiredArtifact {
+    id: string;
+    storageType: 'postgres' | 'external';
+    externalKey: string | null;
+}
+export interface CleanupOptions {
+    db: CleanupDb;
+    externalStorage: Pick<StorageProvider, 'delete'>;
+    batchSize?: number;
+    table?: unknown;
+}
+export interface CleanupResult {
+    postgresDeleted: number;
+    externalDeleted: number;
+    errors: string[];
+}
+export declare function cleanupExpiredArtifacts(options: CleanupOptions): Promise<CleanupResult>;
+export {};
+//# sourceMappingURL=artifact-cleanup.d.ts.map

package/dist/artifact-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-cleanup.d.ts","sourceRoot":"","sources":["../src/artifact-cleanup.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,MAAM,WAAW,SAAS;IACxB,MAAM,IAAI;QACR,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG;YACpB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;SACvD,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG;QACtB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7C,CAAC;CACH;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,UAAU,GAAG,UAAU,CAAC;IACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,SAAS,CAAC;IACd,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA6CxB"}

package/dist/artifact-cleanup.js

@@ -0,0 +1,44 @@
+// ABOUTME: TTL-based artifact cleanup
+// ABOUTME: Removes expired artifacts from PostgreSQL and external storage
+import { jobArtifacts } from './schema.js';
+import { lte } from 'drizzle-orm';
+export async function cleanupExpiredArtifacts(options) {
+    const { db, externalStorage, batchSize = 100, table = jobArtifacts } = options;
+    const result = {
+        postgresDeleted: 0,
+        externalDeleted: 0,
+        errors: [],
+    };
+    // Find expired artifacts (WHERE expires_at <= NOW())
+    const expired = await db
+        .select()
+        .from(table)
+        .where(lte(table.expiresAt, new Date()));
+    // Apply batch size limit
+    const batch = expired.slice(0, batchSize);
+    if (batch.length === 0) {
+        return result;
+    }
+    // Delete external storage objects first
+    for (const artifact of batch) {
+        if (artifact.storageType === 'external' && artifact.externalKey) {
+            try {
+                await externalStorage.delete(artifact.externalKey);
+                result.externalDeleted++;
+            }
+            catch (error) {
+                result.errors.push(`Failed to delete ${artifact.externalKey}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        else if (artifact.storageType === 'postgres') {
+            result.postgresDeleted++;
+        }
+    }
+    // Delete from database
+    // Note: In real Drizzle usage, this would use inArray(table.id, ids)
+    // but for now we use a simplified approach
+    const ids = batch.map((a) => a.id);
+    await db.delete(table).where({ ids });
+    return result;
+}
+//# sourceMappingURL=artifact-cleanup.js.map

package/dist/artifact-cleanup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-cleanup.js","sourceRoot":"","sources":["../src/artifact-cleanup.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,0EAA0E;AAG1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAgClC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuB;IAEvB,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,SAAS,GAAG,GAAG,EAAE,KAAK,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAE/E,MAAM,MAAM,GAAkB;QAC5B,eAAe,EAAE,CAAC;QAClB,eAAe,EAAE,CAAC;QAClB,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,qDAAqD;IACrD,MAAM,OAAO,GAAG,MAAM,EAAE;SACrB,MAAM,EAAE;SACR,IAAI,CAAC,KAAK,CAAC;SACX,KAAK,CAAC,GAAG,CAAE,KAAa,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAEpD,yBAAyB;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAE1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,wCAAwC;IACxC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YAChE,IAAI,CAAC;gBACH,MAAM,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;gBACnD,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,MAAM,CAAC,IAAI,CAChB,oBAAoB,QAAQ,CAAC,WAAW,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACtG,CAAC;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;YAC/C,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,uBAAuB;IACvB,qEAAqE;IACrE,2CAA2C;IAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAkB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAEtC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/artifact-manager.d.ts

@@ -0,0 +1,41 @@
+import type { StorageProvider } from '@inf-minds/storage';
+import type { ArtifactRef, ArtifactContent, SaveArtifactOptions } from './types.js';
+export interface ArtifactManagerDb {
+    insert(table: unknown): {
+        values(record: unknown): {
+            returning(): Promise<unknown[]>;
+        };
+    };
+    select(): {
+        from(table: unknown): {
+            where(condition: unknown): Promise<unknown[]>;
+        };
+    };
+    delete(table: unknown): {
+        where(condition: unknown): Promise<unknown>;
+    };
+}
+export interface ArtifactManagerOptions {
+    db: ArtifactManagerDb;
+    postgresStorage: StorageProvider;
+    externalStorage: StorageProvider;
+    table?: unknown;
+}
+export interface ArtifactManager {
+    save(jobId: string, name: string, content: string | Buffer, options: SaveArtifactOptions): Promise<ArtifactRef>;
+    load(jobId: string, name: string): Promise<ArtifactContent | null>;
+    list(jobId: string): Promise<ArtifactRef[]>;
+    getSignedUrl(jobId: string, name: string, expiresIn?: number): Promise<string | null>;
+    delete(jobId: string, name: string): Promise<void>;
+    deleteAll(jobId: string): Promise<void>;
+    /** List all artifacts for a kernel session */
+    listBySession(sessionId: string): Promise<ArtifactRef[]>;
+    /** List artifacts for a specific node in a session */
+    listByNode(sessionId: string, nodeId: string): Promise<ArtifactRef[]>;
+    /** List artifacts by visibility scope in a session */
+    listByVisibility(sessionId: string, visibility: string): Promise<ArtifactRef[]>;
+    /** List artifacts published to specific channels in a session */
+    listByChannels(sessionId: string, channels: string[]): Promise<ArtifactRef[]>;
+}
+export declare function createArtifactManager(options: ArtifactManagerOptions): ArtifactManager;
+//# sourceMappingURL=artifact-manager.d.ts.map

package/dist/artifact-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-manager.d.ts","sourceRoot":"","sources":["../src/artifact-manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIpF,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG;QACtB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG;YACvB,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;SACjC,CAAC;KACH,CAAC;IACF,MAAM,IAAI;QACR,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG;YACpB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;SAC/C,CAAC;KACH,CAAC;IACF,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG;QACtB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,iBAAiB,CAAC;IACtB,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAChH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGxC,8CAA8C;IAC9C,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACzD,sDAAsD;IACtD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtE,sDAAsD;IACtD,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChF,iEAAiE;IACjE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC/E;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAsStF"}

package/dist/artifact-manager.js

@@ -0,0 +1,254 @@
+// ABOUTME: ArtifactManager for job artifact CRUD operations
+// ABOUTME: Routes artifacts to appropriate storage backend
+import { detectMimeType, getStorageType } from '@inf-minds/storage';
+import { jobArtifacts } from './schema.js';
+import { and, eq, sql } from 'drizzle-orm';
+export function createArtifactManager(options) {
+    const { db, postgresStorage, externalStorage } = options;
+    const table = options.table ?? jobArtifacts;
+    return {
+        async save(jobId, name, content, options) {
+            // Determine MIME type
+            const mimeType = options.mimeType ?? detectMimeType(name);
+            // Determine storage type based on MIME type
+            const storageType = getStorageType(mimeType);
+            // Select appropriate storage backend
+            const storage = storageType === 'postgres' ? postgresStorage : externalStorage;
+            // Build storage key
+            const storageKey = storageType === 'postgres' ? name : `${jobId}/${name}`;
+            // Store content in appropriate backend
+            const putResult = await storage.put(storageKey, content, {
+                mimeType,
+                metadata: options.metadata,
+            });
+            // Calculate expiry timestamp
+            let expiresAt = null;
+            if (options.expiresIn) {
+                expiresAt = new Date(Date.now() + options.expiresIn * 1000);
+            }
+            // Build artifact record
+            const artifactRecord = {
+                jobId,
+                name,
+                mimeType,
+                storageType,
+                content: storageType === 'postgres' ? (typeof content === 'string' ? { text: content } : content) : null,
+                externalKey: storageType === 'external' ? putResult.key : null,
+                sizeBytes: putResult.sizeBytes,
+                metadata: options.metadata ?? {},
+                expiresAt,
+            };
+            // Insert into database
+            const [inserted] = await db
+                .insert(table)
+                .values(artifactRecord)
+                .returning();
+            if (!inserted) {
+                throw new Error('Failed to insert artifact record');
+            }
+            const artifact = inserted;
+            // Return artifact reference
+            return {
+                name: artifact.name,
+                mimeType: artifact.mimeType,
+                sizeBytes: artifact.sizeBytes,
+                storageType: artifact.storageType,
+                metadata: artifact.metadata ?? {},
+                createdAt: artifact.createdAt,
+            };
+        },
+        async load(jobId, name) {
+            // Query database for artifact record
+            const results = await db
+                .select()
+                .from(table)
+                .where(and(eq(jobArtifacts.jobId, jobId), eq(jobArtifacts.name, name)));
+            if (results.length === 0) {
+                return null;
+            }
+            const artifact = results[0];
+            // Fetch content from appropriate storage
+            let content;
+            if (artifact.storageType === 'postgres') {
+                const storageResult = await postgresStorage.get(artifact.name);
+                if (!storageResult) {
+                    throw new Error(`Artifact content not found in postgres storage: ${artifact.name}`);
+                }
+                content = storageResult.content;
+            }
+            else {
+                if (!artifact.externalKey) {
+                    throw new Error(`External key missing for artifact: ${artifact.name}`);
+                }
+                const storageResult = await externalStorage.get(artifact.externalKey);
+                if (!storageResult) {
+                    throw new Error(`Artifact content not found in external storage: ${artifact.externalKey}`);
+                }
+                content = storageResult.content;
+            }
+            // Return artifact with content
+            return {
+                name: artifact.name,
+                mimeType: artifact.mimeType,
+                sizeBytes: artifact.sizeBytes,
+                storageType: artifact.storageType,
+                metadata: artifact.metadata ?? {},
+                createdAt: artifact.createdAt,
+                content,
+            };
+        },
+        async list(jobId) {
+            // Query database for all artifacts for this job
+            const results = await db
+                .select()
+                .from(table)
+                .where(eq(jobArtifacts.jobId, jobId));
+            // Map to artifact references
+            return results.map((artifact) => {
+                const a = artifact;
+                return {
+                    name: a.name,
+                    mimeType: a.mimeType,
+                    sizeBytes: a.sizeBytes,
+                    storageType: a.storageType,
+                    metadata: a.metadata ?? {},
+                    createdAt: a.createdAt,
+                };
+            });
+        },
+        async getSignedUrl(jobId, name, expiresIn) {
+            // Query database for artifact record
+            const results = await db
+                .select()
+                .from(table)
+                .where(and(eq(jobArtifacts.jobId, jobId), eq(jobArtifacts.name, name)));
+            if (results.length === 0) {
+                return null;
+            }
+            const artifact = results[0];
+            // Only external artifacts can have signed URLs
+            if (artifact.storageType !== 'external' || !artifact.externalKey) {
+                return null;
+            }
+            // Get signed URL from external storage
+            return await externalStorage.getSignedUrl(artifact.externalKey, expiresIn);
+        },
+        async delete(jobId, name) {
+            // Query database for artifact record
+            const results = await db
+                .select()
+                .from(table)
+                .where(and(eq(jobArtifacts.jobId, jobId), eq(jobArtifacts.name, name)));
+            if (results.length === 0) {
+                return;
+            }
+            const artifact = results[0];
+            // Delete from appropriate storage
+            if (artifact.storageType === 'postgres') {
+                await postgresStorage.delete(artifact.name);
+            }
+            else if (artifact.externalKey) {
+                await externalStorage.delete(artifact.externalKey);
+            }
+            // Delete database record
+            await db
+                .delete(table)
+                .where(and(eq(jobArtifacts.jobId, jobId), eq(jobArtifacts.name, name)));
+        },
+        async deleteAll(jobId) {
+            // Get all artifacts for this job
+            const artifacts = await db
+                .select()
+                .from(table)
+                .where(eq(jobArtifacts.jobId, jobId));
+            // Delete from storage backends
+            for (const artifact of artifacts) {
+                const a = artifact;
+                if (a.storageType === 'postgres') {
+                    await postgresStorage.delete(a.name);
+                }
+                else if (a.externalKey) {
+                    await externalStorage.delete(a.externalKey);
+                }
+            }
+            // Delete all database records
+            await db
+                .delete(table)
+                .where(eq(jobArtifacts.jobId, jobId));
+        },
+        // Session/visibility query implementations
+        async listBySession(sessionId) {
+            const results = await db
+                .select()
+                .from(table)
+                .where(eq(jobArtifacts.sessionId, sessionId));
+            return results.map((artifact) => {
+                const a = artifact;
+                return {
+                    name: a.name,
+                    mimeType: a.mimeType,
+                    sizeBytes: a.sizeBytes,
+                    storageType: a.storageType,
+                    metadata: a.metadata ?? {},
+                    createdAt: a.createdAt,
+                };
+            });
+        },
+        async listByNode(sessionId, nodeId) {
+            const results = await db
+                .select()
+                .from(table)
+                .where(and(eq(jobArtifacts.sessionId, sessionId), eq(jobArtifacts.nodeId, nodeId)));
+            return results.map((artifact) => {
+                const a = artifact;
+                return {
+                    name: a.name,
+                    mimeType: a.mimeType,
+                    sizeBytes: a.sizeBytes,
+                    storageType: a.storageType,
+                    metadata: a.metadata ?? {},
+                    createdAt: a.createdAt,
+                };
+            });
+        },
+        async listByVisibility(sessionId, visibility) {
+            const results = await db
+                .select()
+                .from(table)
+                .where(and(eq(jobArtifacts.sessionId, sessionId), eq(jobArtifacts.visibility, visibility)));
+            return results.map((artifact) => {
+                const a = artifact;
+                return {
+                    name: a.name,
+                    mimeType: a.mimeType,
+                    sizeBytes: a.sizeBytes,
+                    storageType: a.storageType,
+                    metadata: a.metadata ?? {},
+                    createdAt: a.createdAt,
+                };
+            });
+        },
+        async listByChannels(sessionId, channels) {
+            if (channels.length === 0) {
+                return [];
+            }
+            // Query for artifacts where channels array overlaps with requested channels
+            const results = await db
+                .select()
+                .from(table)
+                .where(and(eq(jobArtifacts.sessionId, sessionId), sql `${jobArtifacts.channels} && ARRAY[${sql.join(channels.map((c) => sql `${c}`), sql `, `)}]::text[]`));
+            return results.map((artifact) => {
+                const a = artifact;
+                return {
+                    name: a.name,
+                    mimeType: a.mimeType,
+                    sizeBytes: a.sizeBytes,
+                    storageType: a.storageType,
+                    metadata: a.metadata ?? {},
+                    createdAt: a.createdAt,
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=artifact-manager.js.map

package/dist/artifact-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-manager.js","sourceRoot":"","sources":["../src/artifact-manager.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,2DAA2D;AAG3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,YAAY,EAAyC,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AA4C3C,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAE5C,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,IAAY,EAAE,OAAwB,EAAE,OAA4B;YAC5F,sBAAsB;YACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;YAE1D,4CAA4C;YAC5C,MAAM,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YAE7C,qCAAqC;YACrC,MAAM,OAAO,GAAG,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC;YAE/E,oBAAoB;YACpB,MAAM,UAAU,GAAG,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;YAE1E,uCAAuC;YACvC,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE;gBACvD,QAAQ;gBACR,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC,CAAC;YAEH,6BAA6B;YAC7B,IAAI,SAAS,GAAgB,IAAI,CAAC;YAClC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;YAC9D,CAAC;YAED,wBAAwB;YACxB,MAAM,cAAc,GAAmB;gBACrC,KAAK;gBACL,IAAI;gBACJ,QAAQ;gBACR,WAAW;gBACX,OAAO,EAAE,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;gBACxG,WAAW,EAAE,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI;gBAC9D,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;gBAChC,SAAS;aACV,CAAC;YAEF,uBAAuB;YACvB,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM,EAAE;iBACxB,MAAM,CAAC,KAAK,CAAC;iBACb,MAAM,CAAC,cAAc,CAAC;iBACtB,SAAS,EAAE,CAAC;YAEf,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,QAAQ,GAAG,QAAuB,CAAC;YAEzC,4BAA4B;YAC5B,OAAO;gBACL,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,WAAW,EAAE,QAAQ,CAAC,WAAsC;gBAC5D,QAAQ,EAAG,QAAQ,CAAC,QAAoC,IAAI,EAAE;gBAC9D,SAAS,EAAE,QAAQ,CAAC,SAAS;aAC9B,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,IAAY;YACpC,qCAAqC;YACrC,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAE1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAgB,CAAC;YAE3C,yCAAyC;YACzC,IAAI,OAAwB,CAAC;YAE7B,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC/D,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtF,CAAC;gBACD,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;oBAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzE,CAAC;gBACD,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;gBACtE,IAAI,CAAC,aAAa,EAAE,CAAC;oBACnB,MAAM,IAAI,KAAK,CAAC,mDAAmD,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC7F,CAAC;gBACD,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;YAClC,CAAC;YAED,+BAA+B;YAC/B,OAAO;gBACL,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,WAAW,EAAE,QAAQ,CAAC,WAAsC;gBAC5D,QAAQ,EAAG,QAAQ,CAAC,QAAoC,IAAI,EAAE;gBAC9D,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,OAAO;aACR,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAa;YACtB,gDAAgD;YAChD,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAExC,6BAA6B;YAC7B,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC9B,MAAM,CAAC,GAAG,QAAuB,CAAC;gBAClC,OAAO;oBACL,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,WAAW,EAAE,CAAC,CAAC,WAAsC;oBACrD,QAAQ,EAAG,CAAC,CAAC,QAAoC,IAAI,EAAE;oBACvD,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,IAAY,EAAE,SAAkB;YAChE,qCAAqC;YACrC,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAE1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAgB,CAAC;YAE3C,+CAA+C;YAC/C,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACjE,OAAO,IAAI,CAAC;YACd,CAAC;YAED,uCAAuC;YACvC,OAAO,MAAM,eAAe,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC7E,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAAY;YACtC,qCAAqC;YACrC,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;YAE1E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO;YACT,CAAC;YAED,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAgB,CAAC;YAE3C,kCAAkC;YAClC,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;gBACxC,MAAM,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAChC,MAAM,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACrD,CAAC;YAED,yBAAyB;YACzB,MAAM,EAAE;iBACL,MAAM,CAAC,KAAK,CAAC;iBACb,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,KAAa;YAC3B,iCAAiC;YACjC,MAAM,SAAS,GAAG,MAAM,EAAE;iBACvB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YAExC,+BAA+B;YAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,GAAG,QAAuB,CAAC;gBAClC,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;oBACjC,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACvC,CAAC;qBAAM,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;oBACzB,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;gBAC9C,CAAC;YACH,CAAC;YAED,8BAA8B;YAC9B,MAAM,EAAE;iBACL,MAAM,CAAC,KAAK,CAAC;iBACb,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC;QAED,2CAA2C;QAE3C,KAAK,CAAC,aAAa,CAAC,SAAiB;YACnC,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;YAEhD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC9B,MAAM,CAAC,GAAG,QAAuB,CAAC;gBAClC,OAAO;oBACL,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,WAAW,EAAE,CAAC,CAAC,WAAsC;oBACrD,QAAQ,EAAG,CAAC,CAAC,QAAoC,IAAI,EAAE;oBACvD,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,MAAc;YAChD,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;YAEtF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC9B,MAAM,CAAC,GAAG,QAAuB,CAAC;gBAClC,OAAO;oBACL,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,WAAW,EAAE,CAAC,CAAC,WAAsC;oBACrD,QAAQ,EAAG,CAAC,CAAC,QAAoC,IAAI,EAAE;oBACvD,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,UAAkB;YAC1D,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;YAE9F,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC9B,MAAM,CAAC,GAAG,QAAuB,CAAC;gBAClC,OAAO;oBACL,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,WAAW,EAAE,CAAC,CAAC,WAAsC;oBACrD,QAAQ,EAAG,CAAC,CAAC,QAAoC,IAAI,EAAE;oBACvD,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,QAAkB;YACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,4EAA4E;YAC5E,MAAM,OAAO,GAAG,MAAM,EAAE;iBACrB,MAAM,EAAE;iBACR,IAAI,CAAC,KAAK,CAAC;iBACX,KAAK,CACJ,GAAG,CACD,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,CAAC,EACrC,GAAG,CAAA,GAAG,YAAY,CAAC,QAAQ,aAAa,GAAG,CAAC,IAAI,CAC9C,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAA,GAAG,CAAC,EAAE,CAAC,EAC9B,GAAG,CAAA,IAAI,CACR,WAAW,CACb,CACF,CAAC;YAEJ,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAC9B,MAAM,CAAC,GAAG,QAAuB,CAAC;gBAClC,OAAO;oBACL,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,WAAW,EAAE,CAAC,CAAC,WAAsC;oBACrD,QAAQ,EAAG,CAAC,CAAC,QAAoC,IAAI,EAAE;oBACvD,SAAS,EAAE,CAAC,CAAC,SAAS;iBACvB,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/artifact-materializer.d.ts

@@ -0,0 +1,21 @@
+import type { ArtifactManager } from './artifact-manager.js';
+import type { MaterializedArtifacts } from './job-context.js';
+export interface ArtifactMaterializerDb {
+    select(): {
+        from(table: unknown): {
+            where(condition: unknown): Promise<{
+                dependsOnJobId: string;
+            }[]>;
+        };
+    };
+}
+export interface ArtifactMaterializerOptions {
+    db: ArtifactMaterializerDb;
+    artifactManager: Pick<ArtifactManager, 'list' | 'load'>;
+    dependenciesTable?: unknown;
+}
+export interface ArtifactMaterializer {
+    materialize(jobId: string): Promise<MaterializedArtifacts>;
+}
+export declare function createArtifactMaterializer(options: ArtifactMaterializerOptions): ArtifactMaterializer;
+//# sourceMappingURL=artifact-materializer.d.ts.map

package/dist/artifact-materializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-materializer.d.ts","sourceRoot":"","sources":["../src/artifact-materializer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,MAAM,IAAI;QACR,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG;YACpB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;gBAAE,cAAc,EAAE,MAAM,CAAA;aAAE,EAAE,CAAC,CAAC;SAClE,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,sBAAsB,CAAC;IAC3B,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACxD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC5D;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,oBAAoB,CAoCtB"}

package/dist/artifact-materializer.js

@@ -0,0 +1,33 @@
+// ABOUTME: Materializes artifacts from job dependencies
+// ABOUTME: Makes parent job artifacts available via deps/{jobId}/{name} paths
+export function createArtifactMaterializer(options) {
+    const { db, artifactManager } = options;
+    return {
+        async materialize(jobId) {
+            const artifacts = new Map();
+            // Get job dependencies
+            const dependencies = await db.select()
+                .from(null)
+                .where({ jobId });
+            if (dependencies.length === 0) {
+                return { artifacts };
+            }
+            // Load artifacts from each dependency
+            for (const dep of dependencies) {
+                const parentJobId = dep.dependsOnJobId;
+                // List artifacts for parent job
+                const parentArtifacts = await artifactManager.list(parentJobId);
+                // Load each artifact
+                for (const ref of parentArtifacts) {
+                    const content = await artifactManager.load(parentJobId, ref.name);
+                    if (content) {
+                        const path = `deps/${parentJobId}/${ref.name}`;
+                        artifacts.set(path, content);
+                    }
+                }
+            }
+            return { artifacts };
+        },
+    };
+}
+//# sourceMappingURL=artifact-materializer.js.map

package/dist/artifact-materializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-materializer.js","sourceRoot":"","sources":["../src/artifact-materializer.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,8EAA8E;AAwB9E,MAAM,UAAU,0BAA0B,CACxC,OAAoC;IAEpC,MAAM,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAExC,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,KAAa;YAC7B,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;YAErD,uBAAuB;YACvB,MAAM,YAAY,GAAG,MAAO,EAAE,CAAC,MAAc,EAAE;iBAC5C,IAAI,CAAC,IAAI,CAAC;iBACV,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAEpB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC9B,OAAO,EAAE,SAAS,EAAE,CAAC;YACvB,CAAC;YAED,sCAAsC;YACtC,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;gBAC/B,MAAM,WAAW,GAAG,GAAG,CAAC,cAAc,CAAC;gBAEvC,gCAAgC;gBAChC,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAEhE,qBAAqB;gBACrB,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;oBAClC,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;oBAClE,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,IAAI,GAAG,QAAQ,WAAW,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;wBAC/C,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,EAAE,SAAS,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/artifact-router.d.ts

@@ -0,0 +1,131 @@
+import type { ArtifactRef, GraphState } from './types.js';
+import type { ArtifactVisibility } from './schema.js';
+/**
+ * Graph edge definition (simplified for routing context).
+ */
+export interface GraphEdge {
+    /** Source node ID */
+    source: string;
+    /** Target node ID */
+    target: string;
+    /** Named channel for artifact routing (optional) */
+    channel?: string;
+}
+/**
+ * Context provided for artifact routing decisions.
+ */
+export interface RoutingContext {
+    /** Kernel session ID (the parent job ID) */
+    sessionId: string;
+    /** Current node ID in the graph */
+    nodeId: string;
+    /** Mind ID being executed (e.g., 'researcher', 'coordinator') */
+    mindId: string;
+    /** The incoming edge that triggered this node (optional for start nodes) */
+    edge?: GraphEdge;
+    /** Current graph execution state */
+    graphState: GraphState;
+    /** Account ID for the session */
+    accountId: string;
+}
+/**
+ * Hints provided by minds when saving artifacts.
+ */
+export interface VisibilityHints {
+    /** Explicit visibility scope override */
+    scope?: ArtifactVisibility;
+    /** Specific recipient node IDs */
+    recipients?: string[];
+    /** Named channels to publish to */
+    channels?: string[];
+    /** Whether this artifact should persist beyond session */
+    persistent?: boolean;
+}
+/**
+ * Artifact with routing metadata.
+ */
+export interface RoutedArtifact extends ArtifactRef {
+    /** Resolved visibility scope */
+    visibility: ArtifactVisibility;
+    /** Session this artifact belongs to */
+    sessionId: string;
+    /** Node that created this artifact */
+    nodeId: string;
+    /** Channels this artifact is published to */
+    channels: string[];
+}
+/**
+ * Options for resolving input artifacts.
+ */
+export interface ResolveInputOptions {
+    /** Filter by visibility scopes */
+    visibilities?: ArtifactVisibility[];
+    /** Filter by specific channels */
+    channels?: string[];
+    /** Filter by source node IDs */
+    sourceNodes?: string[];
+    /** Include artifacts from all completed predecessor nodes */
+    includePredecessors?: boolean;
+}
+/**
+ * Options for routing output artifacts.
+ */
+export interface RouteOutputOptions {
+    /** Artifact reference to route */
+    artifact: ArtifactRef;
+    /** Visibility hints from the mind */
+    hints: VisibilityHints;
+}
+/**
+ * Interface for artifact routing in kernel sessions.
+ *
+ * The router is responsible for:
+ * 1. Determining which artifacts a node can access as inputs
+ * 2. Routing output artifacts with appropriate visibility
+ *
+ * Implementation is decoupled from storage - the router only
+ * handles visibility and routing logic, not persistence.
+ */
+export interface ArtifactRouter {
+    /**
+     * Resolve which artifacts are available as inputs for a node.
+     *
+     * This considers:
+     * - Artifacts from predecessor nodes (via edges)
+     * - Session-visible artifacts
+     * - Channel subscriptions
+     *
+     * @param context - Current routing context
+     * @param options - Optional filtering options
+     * @returns List of accessible artifact references
+     */
+    resolveInputArtifacts(context: RoutingContext, options?: ResolveInputOptions): Promise<ArtifactRef[]>;
+    /**
+     * Route output artifacts with visibility and channel assignments.
+     *
+     * This determines:
+     * - Final visibility scope (from hints or defaults)
+     * - Channel assignments
+     * - Session and node attribution
+     *
+     * @param outputs - Artifacts with visibility hints
+     * @param context - Current routing context
+     * @returns Routed artifacts with resolved metadata
+     */
+    routeOutputArtifacts(outputs: RouteOutputOptions[], context: RoutingContext): Promise<RoutedArtifact[]>;
+    /**
+     * Get default visibility for a given artifact path.
+     *
+     * Visibility can be inferred from path patterns:
+     * - `/sessions/{s}/nodes/{n}/private/**` → private
+     * - `/sessions/{s}/nodes/{n}/outputs/**` → session
+     * - `/sessions/{s}/shared/**` → session
+     * - `/persistent/**` → persistent
+     *
+     * @param path - Artifact path
+     * @param context - Routing context
+     * @returns Default visibility scope
+     */
+    getDefaultVisibility(path: string, context: RoutingContext): ArtifactVisibility;
+}
+//# sourceMappingURL=artifact-router.d.ts.map

package/dist/artifact-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-router.d.ts","sourceRoot":"","sources":["../src/artifact-router.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,gCAAgC;IAChC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,YAAY,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACpC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,EAAE,WAAW,CAAC;IACtB,qCAAqC;IACrC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;OAWG;IACH,qBAAqB,CACnB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,oBAAoB,CAClB,OAAO,EAAE,kBAAkB,EAAE,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE7B;;;;;;;;;;;;OAYG;IACH,oBAAoB,CAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,kBAAkB,CAAC;CACvB"}

package/dist/artifact-router.js

@@ -0,0 +1,4 @@
+// ABOUTME: ArtifactRouter interface for kernel artifact visibility and routing
+// ABOUTME: Determines which artifacts nodes can access and how outputs are routed
+export {};
+//# sourceMappingURL=artifact-router.js.map

package/dist/artifact-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-router.js","sourceRoot":"","sources":["../src/artifact-router.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kFAAkF"}

package/dist/default-artifact-router.d.ts

@@ -0,0 +1,26 @@
+import type { ArtifactRouter } from './artifact-router.js';
+/**
+ * Database interface for artifact routing queries.
+ */
+export interface ArtifactRouterDb {
+    select(fields?: unknown): {
+        from(table: unknown): {
+            where(condition: unknown): Promise<unknown[]>;
+        };
+    };
+}
+/**
+ * Options for creating a DefaultArtifactRouter.
+ */
+export interface DefaultArtifactRouterOptions {
+    /** Database client for queries */
+    db: ArtifactRouterDb;
+}
+/**
+ * Default implementation of ArtifactRouter.
+ *
+ * Uses path-based visibility inference and queries artifacts
+ * from the database based on session, node, and visibility.
+ */
+export declare function createDefaultArtifactRouter(options: DefaultArtifactRouterOptions): ArtifactRouter;
+//# sourceMappingURL=default-artifact-router.d.ts.map

package/dist/default-artifact-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-artifact-router.d.ts","sourceRoot":"","sources":["../src/default-artifact-router.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,sBAAsB,CAAC;AAG9B;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG;QACxB,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG;YACpB,KAAK,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;SAC/C,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,kCAAkC;IAClC,EAAE,EAAE,gBAAgB,CAAC;CACtB;AAcD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,cAAc,CAoIhB"}