videobook-engine 2.0.1

package/dist/engine.d.ts

@@ -0,0 +1,213 @@
+import type { EngineConfig, SimilarityApi } from "./engine-types.js";
+import { JobQueue } from "./job-queue.js";
+export declare class Engine {
+    readonly book: {
+        get: () => import("./engine-types.js").Book;
+        rename: (slug: string) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Book, import("./engine-types.js").EngineError>>;
+    };
+    readonly artifacts: {
+        create: (input: import("./engine-types.js").CreateArtifactInput | string, name?: string) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Artifact, import("./engine-types.js").EngineError>>;
+        list: (options?: {
+            sort?: "newest" | "oldest";
+        }) => import("./engine-types.js").Artifact[];
+        get: (artifact: string) => import("./engine-types.js").Result<import("./engine-types.js").Artifact, import("./engine-types.js").EngineError>;
+        resolveSlug: (slug: string) => import("./engine-types.js").Result<import("./engine-types.js").Artifact, import("./engine-types.js").EngineError>;
+        isSlugAvailable: (slug: string) => boolean;
+        rename: (input: import("./engine-types.js").RenameArtifactInput | string, name?: string) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Artifact, import("./engine-types.js").EngineError>>;
+        delete: (artifact: string) => Promise<import("./engine-types.js").Result<{
+            artifactId: string;
+            slug: string;
+        }, import("./engine-types.js").EngineError>>;
+    };
+    readonly files: {
+        write: (artifact: string, filename: string, data: Buffer | string) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        writeFromPath: (artifact: string, filename: string, sourcePath: string) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        read: (artifact: string, filename: string) => Promise<import("./engine-types.js").Result<Buffer, import("./engine-types.js").EngineError>>;
+        delete: (artifact: string, filename: string) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        rename: (artifact: string, oldFilename: string, newFilename: string) => Promise<import("./engine-types.js").Result<{
+            oldPath: string;
+            newPath: string;
+        }, import("./engine-types.js").EngineError>>;
+        copy: (artifact: string, filename: string, destinationArtifact: string, destinationFilename: string) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        manifest: (artifact: string, options?: {
+            includeDotfiles?: boolean;
+        }) => Promise<import("./engine-types.js").Result<import("./engine-types.js").ArtifactManifest, import("./engine-types.js").EngineError>>;
+        listSubdir: (artifact: string, subdir: string) => import("./engine-types.js").Result<string[], import("./engine-types.js").EngineError>;
+        ingestWorkspace: (artifact: string, paths: string[], operation?: string, details?: Record<string, unknown>) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        readAtRevision: (artifactId: string, filename: string, revision: string) => Promise<import("./engine-types.js").Result<Buffer, import("./engine-types.js").EngineError>>;
+        importObject: (sourcePath: string) => Promise<import("./cas.js").StoredObject>;
+    };
+    readonly workspaces: {
+        resolveArtifact: (artifact: string) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        materialize: (artifact: string) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        evict: (artifact: string) => Promise<import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>>;
+    };
+    readonly metadata: {
+        artifacts: {
+            write: (artifact: string, key: string, value: unknown) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+            read: <T>(artifact: string, key: string) => Promise<import("./engine-types.js").Result<T, import("./engine-types.js").EngineError>>;
+            readAtRevision: <T>(artifact: string, key: string, revision: string) => Promise<import("./engine-types.js").Result<T, import("./engine-types.js").EngineError>>;
+            delete: (artifact: string, key: string) => Promise<import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>>;
+        };
+        book: {
+            write: (key: string, value: unknown) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+            read: <T>(key: string) => Promise<import("./engine-types.js").Result<T, import("./engine-types.js").EngineError>>;
+            delete: (key: string) => Promise<import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>>;
+        };
+        waveforms: {
+            write: (artifact: string, peaks: number[]) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+            read: (artifact: string) => Promise<import("./engine-types.js").Result<import("./engine-types.js").AudioWaveformRecord, import("./engine-types.js").EngineError>>;
+            delete: (artifact: string) => Promise<import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>>;
+        };
+    };
+    readonly timeline: {
+        get: () => import("./engine-types.js").Timeline;
+        getAtRevision: (revision: string) => import("./engine-types.js").Result<import("./engine-types.js").Timeline, import("./engine-types.js").EngineError>;
+        set: (input: import("./engine-types.js").TimelineInput) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Timeline, import("./engine-types.js").EngineError>>;
+        reset: () => Promise<import("./engine-types.js").Result<import("./engine-types.js").Timeline, import("./engine-types.js").EngineError>>;
+    };
+    readonly entities: {
+        create: (type: import("./index.js").EntityType, name: string, input?: Partial<import("./index.js").EntityDocument>) => Promise<import("./engine-types.js").Result<import("./index.js").EntityDocument, import("./engine-types.js").EngineError>>;
+        list: (type?: import("./index.js").EntityType) => import("./index.js").EntityDocument[];
+        read: (entityId: string) => import("./engine-types.js").Result<import("./index.js").EntityDocument, import("./engine-types.js").EngineError>;
+        write: (entity: import("./index.js").EntityDocument) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Revision, import("./engine-types.js").EngineError>>;
+        delete: (entityId: string) => Promise<import("./engine-types.js").Result<{
+            entityId: string;
+        }, import("./engine-types.js").EngineError>>;
+    };
+    readonly notebooks: {
+        create: (name: string) => Promise<import("./engine-types.js").Result<import("./index.js").NotebookDocument, import("./engine-types.js").EngineError>>;
+        createCell: (input: Omit<import("./index.js").NotebookCell, "id"> & {
+            id?: string;
+        }) => import("./index.js").NotebookCell;
+        createEdge: (input: Omit<import("./index.js").NotebookEdge, "id"> & {
+            id?: string;
+        }) => import("./index.js").NotebookEdge;
+        list: () => import("./index.js").NotebookDocument[];
+        read: (notebookId: string) => import("./engine-types.js").Result<import("./index.js").NotebookDocument, import("./engine-types.js").EngineError>;
+        write: (notebook: import("./index.js").NotebookDocument) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Revision, import("./engine-types.js").EngineError>>;
+        delete: (notebookId: string) => Promise<import("./engine-types.js").Result<{
+            notebookId: string;
+        }, import("./engine-types.js").EngineError>>;
+        recordRun: (run: import("./index.js").NotebookRun) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Revision, import("./engine-types.js").EngineError>>;
+    };
+    readonly prompts: {
+        record: (input: import("./engine-types.js").RecordPromptArgs) => Promise<import("./engine-types.js").Result<import("./engine-types.js").PromptHistoryEntry, import("./engine-types.js").EngineError>>;
+        list: (options?: import("./engine-types.js").ListPromptHistoryArgs) => import("./engine-types.js").Result<import("./engine-types.js").PromptHistoryEntry[], import("./engine-types.js").EngineError>;
+        count: (options?: Pick<import("./engine-types.js").ListPromptHistoryArgs, "surface">) => import("./engine-types.js").Result<number, import("./engine-types.js").EngineError>;
+    };
+    readonly messages: {
+        append: <T extends Record<string, unknown>>(input: import("./engine-types.js").AppendMessageInput<T>) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Message<T>, import("./engine-types.js").EngineError>>;
+        list: <T = Record<string, unknown>>(options?: {
+            limit?: number;
+            role?: string;
+        }) => import("./engine-types.js").Result<import("./engine-types.js").Message<T>[], import("./engine-types.js").EngineError>;
+    };
+    readonly history: {
+        revisions: (limit?: number) => import("./engine-types.js").Revision[];
+        artifact: (artifact: string, limit?: number) => import("./engine-types.js").Revision[];
+        resolveRevision: (revision: string) => import("./engine-types.js").Revision | null;
+        recordOperation: (operation: string, artifact?: string, details?: Record<string, unknown>) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Revision, import("./engine-types.js").EngineError>>;
+        restoreArtifact: (artifactId: string, revision: string, slug?: string) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Revision, import("./engine-types.js").EngineError>>;
+        restore: (revision: string) => Promise<import("./engine-types.js").Result<import("./engine-types.js").Revision, import("./engine-types.js").EngineError>>;
+        logAction: (action: string, payload: string | Record<string, unknown>) => Promise<import("./engine-types.js").Result<import("./engine-types.js").ActionLogEntry, import("./engine-types.js").EngineError>>;
+        actionLog: (options?: {
+            limit?: number;
+            action?: string;
+        }) => import("./engine-types.js").ActionLogEntry[];
+        actions: (options?: import("./history-types.js").GetHistoryActionsOptions) => import("./engine-types.js").Result<import("./history-types.js").HistoryActionPage, import("./engine-types.js").EngineError>;
+        action: (actionId: string) => import("./engine-types.js").Result<import("./history-types.js").HistoryAction, import("./engine-types.js").EngineError>;
+        recordAction: (input: import("./history-types.js").RecordActionInput) => Promise<import("./engine-types.js").Result<import("./history-types.js").HistoryActionRevision, import("./engine-types.js").EngineError>>;
+    };
+    readonly status: {
+        get: (artifact: string, options?: import("./engine-types.js").GetArtifactStatusOptions) => Promise<import("./engine-types.js").Result<import("./engine-types.js").ArtifactStatus, import("./engine-types.js").EngineError>>;
+        compute: typeof import("./status.js").computeArtifactStatus;
+    };
+    readonly resolver: {
+        parseTags: typeof import("./resolver.js").parseArtifactTags;
+        resolveAll: (text: string) => Promise<import("./engine-types.js").Result<{
+            resolved: import("./engine-types.js").ResolvedArtifact[];
+            unresolved: string[];
+        }, import("./engine-types.js").EngineError>>;
+        expandSlotRefs: typeof import("./resolver.js").expandSlotRefs;
+    };
+    readonly storage: {
+        status: () => import("./engine-types.js").StorageStatus;
+        backup: () => Promise<import("./engine-types.js").Result<import("./engine-types.js").StorageStatus, import("./engine-types.js").EngineError>>;
+    };
+    readonly logs: {
+        append: (name: string, line: Record<string, unknown>) => Promise<import("./engine-types.js").Result<string, import("./engine-types.js").EngineError>>;
+        read: (name: string, options?: {
+            limit?: number;
+        }) => Record<string, unknown>[];
+    };
+    readonly settings: {
+        get: <T>(key: string) => T | null;
+        set: <T>(key: string, value: T) => import("./engine-types.js").Result<T, import("./engine-types.js").EngineError>;
+        delete: (key: string) => import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>;
+    };
+    readonly jobs: {
+        queue: JobQueue;
+        artifactWork: {
+            begin: (artifact: string, input: import("./engine-types.js").BeginArtifactWorkInput) => {
+                ownerId: string;
+            } | null;
+            complete: (artifact: string, ownerId: string) => boolean;
+            fail: (artifact: string, ownerId: string, failure: {
+                message: string;
+                code?: string;
+            }) => Promise<boolean>;
+            renew: (artifact: string, ownerId: string, extendMs: number) => boolean;
+            markSeen: (artifact: string) => boolean;
+            read: (artifact: string) => import("./engine-types.js").Result<import("./engine-types.js").ArtifactView | null, import("./engine-types.js").EngineError>;
+            list: () => import("./engine-types.js").Result<import("./engine-types.js").ArtifactView[], import("./engine-types.js").EngineError>;
+        };
+        pending: {
+            write: (input: import("./engine-types.js").WritePendingTaskInput, expectedOwnerId: string) => Promise<import("./engine-types.js").Result<import("./engine-types.js").WritePendingTaskResult | null, import("./engine-types.js").EngineError>>;
+            read: (artifact: string) => import("./engine-types.js").Result<import("./engine-types.js").PendingTask | null, import("./engine-types.js").EngineError>;
+            delete: (artifact: string, expectedTaskId?: string) => import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>;
+            markCompleting: (artifact: string) => import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>;
+            clearCompleting: (artifact: string) => import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>;
+            findAll: () => import("./engine-types.js").Result<import("./engine-types.js").PendingTask[], import("./engine-types.js").EngineError>;
+            findByExternalId: (taskId: string) => import("./engine-types.js").Result<import("./engine-types.js").PendingTask | null, import("./engine-types.js").EngineError>;
+            getOwner: (artifact: string, taskId: string) => string | null;
+            fail: (artifact: string, taskOrInfo: string | import("./engine-types.js").FailureInfo, maybeInfo?: import("./engine-types.js").FailureInfo) => Promise<import("./engine-types.js").Result<import("./engine-types.js").GenerationError | null, import("./engine-types.js").EngineError>>;
+            forceFail: (artifact: string, info: import("./engine-types.js").FailureInfo) => Promise<import("./engine-types.js").Result<import("./engine-types.js").GenerationError | null, import("./engine-types.js").EngineError>>;
+        };
+        failures: {
+            write: (artifact: string, info: import("./engine-types.js").FailureInfo) => Promise<import("./engine-types.js").Result<import("./engine-types.js").GenerationError, import("./engine-types.js").EngineError>>;
+            read: (artifact: string) => import("./engine-types.js").Result<import("./engine-types.js").GenerationError | null, import("./engine-types.js").EngineError>;
+            clear: (artifact: string) => Promise<import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>>;
+            findAll: () => import("./engine-types.js").Result<import("./engine-types.js").GenerationError[], import("./engine-types.js").EngineError>;
+        };
+        locks: {
+            acquire: (resource: string, options: import("./engine-types.js").LockOptions) => Promise<import("./engine-types.js").Result<import("./engine-types.js").LockData, import("./engine-types.js").EngineError>>;
+            release: (resource: string, ownerId?: string) => import("./engine-types.js").Result<boolean, import("./engine-types.js").EngineError>;
+            isLocked: (resource: string) => boolean;
+            get: (resource: string) => import("./engine-types.js").LockData | null;
+            cleanStale: (resource: string) => boolean;
+        };
+        recoverArtifact: (artifact: string) => import("./engine-types.js").Result<void, import("./engine-types.js").EngineError>;
+        recoverAll: () => import("./engine-types.js").Result<{
+            recovered: number;
+        }, import("./engine-types.js").EngineError>;
+        startReaper: (options: {
+            intervalMs: number;
+        }) => {
+            stop: () => void;
+        };
+        checkSchema: () => import("./engine-types.js").VersionCheckResult;
+    };
+    readonly similarity: SimilarityApi;
+    readonly ready: Promise<void>;
+    private readonly context;
+    private closed;
+    constructor(config: EngineConfig);
+    get head(): string;
+    initialize(): Promise<void>;
+    close(): void;
+    private reconcileTerminalJobs;
+    private recordTerminalJob;
+}
+export declare function createEngine(config: EngineConfig): Engine;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EAGZ,aAAa,EACd,MAAM,mBAAmB,CAAC;AAsB3B,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAK1C,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI;;;MAAC;IACd,QAAQ,CAAC,SAAS;;;gBALE,CAAC;;;;;;;;;;MAKF;IACnB,QAAQ,CAAC,KAAK;;;;;;;;;;;2BA2BW,CAAC;;;;;;MA3BX;IACf,QAAQ,CAAC,UAAU;;;;MAAC;IACpB,QAAQ,CAAC,QAAQ;;;;;;;;;;;;;;;;;MAAC;IAClB,QAAQ,CAAC,QAAQ;;;;;MAAC;IAClB,QAAQ,CAAC,QAAQ;;;;;;;;MAAC;IAClB,QAAQ,CAAC,SAAS;;;;;;;;;;;;;;;MAAC;IACnB,QAAQ,CAAC,OAAO;;;;MAAC;IACjB,QAAQ,CAAC,QAAQ;;;iBAYd,CAAC;gBAAc,CAAC;;MAZD;IAClB,QAAQ,CAAC,OAAO;;;;;;;;;iBA8HN,CAAC;kBAAgB,CAAC;;;;;MA9HX;IACjB,QAAQ,CAAC,MAAM;;;MAAC;IAChB,QAAQ,CAAC,QAAQ;;;;;;;MAAC;IAClB,QAAQ,CAAC,OAAO;;;MAAC;IACjB,QAAQ,CAAC,IAAI;;;iBAyFH,CAAC;;MAzFG;IACd,QAAQ,CAAC,QAAQ;;;;MAAC;IAClB,QAAQ,CAAC,IAAI;;;;;;;;;oBAiI+4D,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAjI/4D;IACd,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,YAAY;IAwChC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,IAAI,IAAI;YAMC,qBAAqB;YAmBrB,iBAAiB;CAsChC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEzD"}

package/dist/engine.js

@@ -0,0 +1,130 @@
+import { createBookApi } from "./books.js";
+import { createArtifactsApi } from "./artifacts.js";
+import { createFilesApi, createWorkspacesApi, } from "./files.js";
+import { createMetadataApi } from "./metadata.js";
+import { createEntitiesApi, createNotebooksApi, } from "./domain.js";
+import { createMessagesApi, createPromptsApi, } from "./communications.js";
+import { createHistoryApi } from "./history.js";
+import { createRuntimeApi, createLogsApi } from "./runtime-services.js";
+import { createStatusApi } from "./status.js";
+import { createResolverApi } from "./resolver.js";
+import { createStorageApi } from "./storage.js";
+import { EngineContext } from "./context.js";
+import { JobQueue } from "./job-queue.js";
+import { canonicalJson } from "./store.js";
+import { createSimilarityApi } from "./similarity.js";
+import { createTimelineApi } from "./timeline.js";
+export class Engine {
+    book;
+    artifacts;
+    files;
+    workspaces;
+    metadata;
+    timeline;
+    entities;
+    notebooks;
+    prompts;
+    messages;
+    history;
+    status;
+    resolver;
+    storage;
+    logs;
+    settings;
+    jobs;
+    similarity;
+    ready;
+    context;
+    closed = false;
+    constructor(config) {
+        this.context = new EngineContext(config);
+        this.book = createBookApi(this.context);
+        this.artifacts = createArtifactsApi(this.context);
+        this.files = createFilesApi(this.context);
+        this.workspaces = createWorkspacesApi(this.context);
+        this.metadata = createMetadataApi(this.context);
+        this.timeline = createTimelineApi(this.context);
+        this.entities = createEntitiesApi(this.context);
+        this.notebooks = createNotebooksApi(this.context);
+        this.prompts = createPromptsApi(this.context);
+        this.messages = createMessagesApi(this.context);
+        this.history = createHistoryApi(this.context);
+        this.status = createStatusApi(this.context);
+        this.resolver = createResolverApi(this.context);
+        this.storage = createStorageApi(this.context);
+        this.logs = createLogsApi(this.context);
+        const runtime = createRuntimeApi(this.context);
+        this.settings = runtime.settings;
+        this.similarity = createSimilarityApi(this.context);
+        const queue = new JobQueue(this.context.store, (reference) => this.context.artifactRow(reference).artifact_id, (job) => this.recordTerminalJob(job));
+        this.jobs = {
+            queue,
+            artifactWork: runtime.artifactWork,
+            pending: runtime.pending,
+            failures: runtime.failures,
+            locks: runtime.locks,
+            recoverArtifact: runtime.recoverArtifact,
+            recoverAll: runtime.recoverAll,
+            startReaper: runtime.startReaper,
+            checkSchema: runtime.checkSchema,
+        };
+        this.ready = this.reconcileTerminalJobs();
+    }
+    get head() {
+        return this.context.store.head;
+    }
+    async initialize() {
+        await this.reconcileTerminalJobs();
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.context.close();
+    }
+    async reconcileTerminalJobs() {
+        const rows = this.context.store.db
+            .prepare(`SELECT j.id
+         FROM runtime_jobs j
+         LEFT JOIN job_runs r ON r.run_id=j.operation_id
+         WHERE j.state IN ('done','failed','aborted')
+           AND r.run_id IS NULL
+         ORDER BY j.finished_at, j.id`)
+            .all();
+        for (const row of rows) {
+            const job = this.jobs.queue.get(row.id);
+            if (job)
+                await this.recordTerminalJob(job);
+        }
+    }
+    async recordTerminalJob(job) {
+        if (!isTerminal(job.state))
+            return;
+        await this.context.store.semantic({
+            operation: `job_${job.state}`,
+            artifactId: job.artifactId ?? undefined,
+            details: {
+                jobOperationId: job.operationId,
+                jobId: job.id,
+                jobType: job.type,
+                state: job.state,
+            },
+            writeSet: [`job-run:${job.operationId}`],
+        }, ["job_runs"], (_operationId, now) => {
+            this.context.store.db
+                .prepare(`INSERT OR IGNORE INTO job_runs(
+              run_id, artifact_id, job_type, state,
+              payload_json, result_json, error_json,
+              started_at, finished_at
+            ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(job.operationId, job.artifactId, job.type, job.state, canonicalJson(job.payload), job.result === null ? null : canonicalJson(job.result), job.error === null ? null : canonicalJson(job.error), job.startedAt, job.finishedAt ?? now);
+        });
+    }
+}
+export function createEngine(config) {
+    return new Engine(config);
+}
+function isTerminal(state) {
+    return state === "done" || state === "failed" || state === "aborted";
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/files.d.ts

@@ -0,0 +1,28 @@
+import type { ArtifactManifest, EngineError, Result } from "./engine-types.js";
+import { EngineContext } from "./context.js";
+export declare function createFilesApi(context: EngineContext): {
+    write: (artifact: string, filename: string, data: Buffer | string) => Promise<Result<string, EngineError>>;
+    writeFromPath: (artifact: string, filename: string, sourcePath: string) => Promise<Result<string, EngineError>>;
+    read: (artifact: string, filename: string) => Promise<Result<Buffer, EngineError>>;
+    delete: (artifact: string, filename: string) => Promise<Result<string, EngineError>>;
+    rename: (artifact: string, oldFilename: string, newFilename: string) => Promise<Result<{
+        oldPath: string;
+        newPath: string;
+    }, EngineError>>;
+    copy: (artifact: string, filename: string, destinationArtifact: string, destinationFilename: string) => Promise<Result<string, EngineError>>;
+    manifest: (artifact: string, options?: {
+        includeDotfiles?: boolean;
+    }) => Promise<Result<ArtifactManifest, EngineError>>;
+    listSubdir: (artifact: string, subdir: string) => Result<string[], EngineError>;
+    ingestWorkspace: (artifact: string, paths: string[], operation?: string, details?: Record<string, unknown>) => Promise<Result<string, EngineError>>;
+    readAtRevision: (artifactId: string, filename: string, revision: string) => Promise<Result<Buffer, EngineError>>;
+    importObject: (sourcePath: string) => Promise<import("./cas.js").StoredObject>;
+};
+export declare function createWorkspacesApi(context: EngineContext): {
+    resolveArtifact: (artifact: string) => Promise<Result<string, EngineError>>;
+    materialize: (artifact: string) => Promise<Result<string, EngineError>>;
+    evict: (artifact: string) => Promise<Result<boolean, EngineError>>;
+};
+export declare function materializeArtifact(context: EngineContext, artifactId: string): Promise<string>;
+export declare function normalizeFilePath(input: string): string;
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,gBAAgB,EAEhB,WAAW,EACX,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,aAAa,EAA0B,MAAM,cAAc,CAAC;AASrE,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa;sBAGrC,MAAM,YACN,MAAM,QACV,MAAM,GAAG,MAAM,KACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;8BAG3B,MAAM,YACN,MAAM,cACJ,MAAM,KACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;qBAG3B,MAAM,YACN,MAAM,KACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;uBAE3B,MAAM,YACN,MAAM,KACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;uBAE3B,MAAM,eACH,MAAM,eACN,MAAM,KAClB,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,WAAW,CAAC,CAAC;qBAGzD,MAAM,YACN,MAAM,uBACK,MAAM,uBACN,MAAM,KAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;yBAS3B,MAAM,YACN;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,KACtC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;2BAGrC,MAAM,UACR,MAAM,KACb,MAAM,CAAC,MAAM,EAAE,EAAE,WAAW,CAAC;gCAEpB,MAAM,SACT,MAAM,EAAE,gCAEN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;iCAGzB,MAAM,YACR,MAAM,YACN,MAAM,KACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;+BAEZ,MAAM;EAEpC;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa;gCAE1B,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;4BAEjD,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;sBAEnD,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;EAGnE;AAicD,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAqID,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWvD"}