@roj-ai/standalone-server 0.1.11 → 0.1.13

package/dist/files-upload-route.d.ts

@@ -0,0 +1,36 @@
+/**
+ * POST /api/v1/files/upload — multipart endpoint matching the `@roj-ai/client/platform.files.upload`
+ * two-phase contract:
+ *
+ *   1. Preflight with `contentHash`, `filename`, `mimeType` only. If we already have
+ *      the bytes (sha-256 match), respond `{ ok, fileId, ..., deduped: true }`.
+ *      Otherwise respond 409 `{ error: 'file-required' }`.
+ *   2. Retry with the same fields plus a `file` blob. We persist the bytes,
+ *      record the file, and respond `{ ok, fileId, ..., deduped: false }`.
+ *
+ * No bearer auth (standalone is open) — but we accept and ignore an
+ * `Authorization: Bearer …` header so client code copy-pasted from the platform
+ * keeps working.
+ */
+import type { Context } from 'hono';
+import type { LocalRegistry } from './local-registry.js';
+interface Deps {
+    registry: LocalRegistry;
+}
+export declare function createFilesUploadRoute(deps: Deps): (c: Context) => Promise<(Response & import("hono").TypedResponse<{
+    ok: false;
+    error: string;
+}, 400, "json">) | (Response & import("hono").TypedResponse<{
+    ok: false;
+    error: "file-required";
+}, 409, "json">) | (Response & import("hono").TypedResponse<{
+    ok: true;
+    fileId: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+    r2Key: string;
+    deduped: boolean;
+}, import("hono/utils/http-status").ContentfulStatusCode, "json">)>;
+export {};
+//# sourceMappingURL=files-upload-route.d.ts.map

package/dist/files-upload-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-upload-route.d.ts","sourceRoot":"","sources":["../src/files-upload-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,UAAU,IAAI;IACb,QAAQ,EAAE,aAAa,CAAA;CACvB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI,IAClC,GAAG,OAAO;;;;;;;;;;;;;;oEAwCxB"}

package/dist/files-upload-route.js

@@ -0,0 +1,50 @@
+/**
+ * POST /api/v1/files/upload — multipart endpoint matching the `@roj-ai/client/platform.files.upload`
+ * two-phase contract:
+ *
+ *   1. Preflight with `contentHash`, `filename`, `mimeType` only. If we already have
+ *      the bytes (sha-256 match), respond `{ ok, fileId, ..., deduped: true }`.
+ *      Otherwise respond 409 `{ error: 'file-required' }`.
+ *   2. Retry with the same fields plus a `file` blob. We persist the bytes,
+ *      record the file, and respond `{ ok, fileId, ..., deduped: false }`.
+ *
+ * No bearer auth (standalone is open) — but we accept and ignore an
+ * `Authorization: Bearer …` header so client code copy-pasted from the platform
+ * keeps working.
+ */
+export function createFilesUploadRoute(deps) {
+    return async (c) => {
+        let form;
+        try {
+            form = await c.req.formData();
+        }
+        catch {
+            return c.json({ ok: false, error: 'invalid_multipart' }, 400);
+        }
+        const contentHash = form.get('contentHash');
+        const filename = form.get('filename');
+        const mimeType = form.get('mimeType');
+        if (typeof contentHash !== 'string' || typeof filename !== 'string' || typeof mimeType !== 'string') {
+            return c.json({ ok: false, error: 'invalid_form' }, 400);
+        }
+        const file = form.get('file');
+        const buffer = file && typeof file !== 'string' && 'arrayBuffer' in file
+            ? Buffer.from(await file.arrayBuffer())
+            : undefined;
+        const result = await deps.registry.uploadFile({ buffer, filename, mimeType, contentHash });
+        if ('error' in result) {
+            // Preflight miss — client retries with body.
+            return c.json({ ok: false, error: result.error }, 409);
+        }
+        return c.json({
+            ok: true,
+            fileId: result.fileId,
+            filename: result.filename,
+            mimeType: result.mimeType,
+            size: result.size,
+            r2Key: '',
+            deduped: result.deduped,
+        });
+    };
+}
+//# sourceMappingURL=files-upload-route.js.map

package/dist/files-upload-route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files-upload-route.js","sourceRoot":"","sources":["../src/files-upload-route.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,MAAM,UAAU,sBAAsB,CAAC,IAAU;IAChD,OAAO,KAAK,EAAE,CAAU,EAAE,EAAE;QAC3B,IAAI,IAAc,CAAA;QAClB,IAAI,CAAC;YACJ,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAA;QAC9B,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAA;QAC9D,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QACrC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACrG,OAAO,CAAC,CAAC,IAAI,CACZ,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,EACpC,GAAG,CACH,CAAA;QACF,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAC7B,MAAM,MAAM,GAAG,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,aAAa,IAAI,IAAI;YACvE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,CAAC,CAAC,SAAS,CAAA;QAEZ,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAA;QAE1F,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;YACvB,6CAA6C;YAC7C,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAA;QACvD,CAAC;QAED,OAAO,CAAC,CAAC,IAAI,CAAC;YACb,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,MAAM,CAAC,OAAO;SACvB,CAAC,CAAA;IACH,CAAC,CAAA;AACF,CAAC"}

package/dist/git-instance-fs.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Per-instance git layout for the standalone server.
+ *
+ * Mirrors what `roj-platform` does inside an E2B sandbox: each instance owns
+ * a bare repo, each session owns a worktree branched from `main`. The SDK
+ * receives the worktree path as `workspaceDir` on `sessions.create` and treats
+ * it as an opaque directory — it doesn't know about git.
+ *
+ *   {dataPath}/instances/{instanceId}/repo.git/        ← bare, branch `main`
+ *   {dataPath}/instances/{instanceId}/sessions/{sid}/  ← worktree, branch `session/{sid}`
+ *
+ * Why a bare repo + worktrees instead of a plain dir per session:
+ *  - Parallel sessions on one instance need independent commit history.
+ *  - `git worktree` shares object storage, so the cost is mostly metadata.
+ *  - Mental model matches platform — agent `git status` / `git log` behave
+ *    identically against standalone and against E2B.
+ *
+ * Idempotent: `initInstance` skips if `repo.git` already exists,
+ * `addSessionWorktree` skips if the target worktree is already registered.
+ * That keeps `roj-standalone` restart-safe — bare repos and worktrees on disk
+ * persist across process restarts the same way `LocalRegistry` does.
+ *
+ * No auto-commit. Resources extracted via `resources.inject` land in the
+ * worktree as untracked files; whether to commit them is the agent's call,
+ * matching platform behavior.
+ */
+import type { Logger } from '@roj-ai/sdk';
+export declare class GitInstanceFs {
+    private readonly dataPath;
+    private readonly logger;
+    constructor(dataPath: string, logger: Logger);
+    instanceDir(instanceId: string): string;
+    repoDir(instanceId: string): string;
+    worktreeDir(instanceId: string, sessionId: string): string;
+    /**
+     * Idempotently initialize the bare repo for an instance with an empty
+     * initial commit on `main`. The commit exists so subsequent
+     * `git worktree add -b session/{sid}` calls have something to branch from.
+     */
+    initInstance(instanceId: string): Promise<void>;
+    /**
+     * Idempotently add a worktree for `sessionId` on branch `session/{sid}`,
+     * branching from `main`. Throws if the target dir exists but is not a valid
+     * worktree of this instance's bare repo (unrecoverable conflict).
+     */
+    addSessionWorktree(instanceId: string, sessionId: string): Promise<string>;
+    /**
+     * Remove a session's worktree (filesystem + bookkeeping). Silently no-ops
+     * if the worktree was never registered.
+     */
+    removeSessionWorktree(instanceId: string, sessionId: string): Promise<void>;
+    /**
+     * Tear down everything for an instance: every worktree, then the
+     * bare repo + on-disk dir. Safe to call when nothing exists.
+     */
+    removeInstance(instanceId: string): Promise<void>;
+    private isLinkedWorktree;
+    private git;
+}
+//# sourceMappingURL=git-instance-fs.d.ts.map

package/dist/git-instance-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-instance-fs.d.ts","sourceRoot":"","sources":["../src/git-instance-fs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAmBzC,qBAAa,aAAa;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;IAGhC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAIvC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAInC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAI1D;;;;OAIG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBrD;;;;OAIG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBhF;;;OAGG;IACG,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjF;;;OAGG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAOzC,gBAAgB;YAYhB,GAAG;CAiBjB"}

package/dist/git-instance-fs.js

@@ -0,0 +1,164 @@
+/**
+ * Per-instance git layout for the standalone server.
+ *
+ * Mirrors what `roj-platform` does inside an E2B sandbox: each instance owns
+ * a bare repo, each session owns a worktree branched from `main`. The SDK
+ * receives the worktree path as `workspaceDir` on `sessions.create` and treats
+ * it as an opaque directory — it doesn't know about git.
+ *
+ *   {dataPath}/instances/{instanceId}/repo.git/        ← bare, branch `main`
+ *   {dataPath}/instances/{instanceId}/sessions/{sid}/  ← worktree, branch `session/{sid}`
+ *
+ * Why a bare repo + worktrees instead of a plain dir per session:
+ *  - Parallel sessions on one instance need independent commit history.
+ *  - `git worktree` shares object storage, so the cost is mostly metadata.
+ *  - Mental model matches platform — agent `git status` / `git log` behave
+ *    identically against standalone and against E2B.
+ *
+ * Idempotent: `initInstance` skips if `repo.git` already exists,
+ * `addSessionWorktree` skips if the target worktree is already registered.
+ * That keeps `roj-standalone` restart-safe — bare repos and worktrees on disk
+ * persist across process restarts the same way `LocalRegistry` does.
+ *
+ * No auto-commit. Resources extracted via `resources.inject` land in the
+ * worktree as untracked files; whether to commit them is the agent's call,
+ * matching platform behavior.
+ */
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdir, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+// Used for the empty initial commit on `main`. Real commits the agent makes
+// will pick up the host's git config; this just keeps `commit-tree` from
+// failing on machines without `user.name`/`user.email` set.
+const BOOTSTRAP_GIT_ENV = {
+    GIT_AUTHOR_NAME: 'roj-standalone',
+    GIT_AUTHOR_EMAIL: 'standalone@roj.local',
+    GIT_COMMITTER_NAME: 'roj-standalone',
+    GIT_COMMITTER_EMAIL: 'standalone@roj.local',
+};
+export class GitInstanceFs {
+    dataPath;
+    logger;
+    constructor(dataPath, logger) {
+        this.dataPath = dataPath;
+        this.logger = logger;
+    }
+    instanceDir(instanceId) {
+        return join(this.dataPath, 'instances', instanceId);
+    }
+    repoDir(instanceId) {
+        return join(this.instanceDir(instanceId), 'repo.git');
+    }
+    worktreeDir(instanceId, sessionId) {
+        return join(this.instanceDir(instanceId), 'sessions', sessionId);
+    }
+    /**
+     * Idempotently initialize the bare repo for an instance with an empty
+     * initial commit on `main`. The commit exists so subsequent
+     * `git worktree add -b session/{sid}` calls have something to branch from.
+     */
+    async initInstance(instanceId) {
+        const repoDir = this.repoDir(instanceId);
+        if (existsSync(repoDir)) {
+            this.logger.debug('Instance bare repo already exists, skipping init', { instanceId });
+            return;
+        }
+        await mkdir(this.instanceDir(instanceId), { recursive: true });
+        await this.git(['init', '--bare', repoDir]);
+        // `git init --bare` may default to `master` on older git; normalize so
+        // the worktree branch starts from a known parent ref.
+        await this.git(['symbolic-ref', 'HEAD', 'refs/heads/main'], { cwd: repoDir });
+        const tree = (await this.git(['mktree'], { cwd: repoDir, input: '' })).trim();
+        const commit = (await this.git(['commit-tree', tree, '-m', 'Initial commit'], { cwd: repoDir, env: BOOTSTRAP_GIT_ENV })).trim();
+        await this.git(['update-ref', 'refs/heads/main', commit], { cwd: repoDir });
+        this.logger.info('Initialized instance bare repo', { instanceId, repoDir });
+    }
+    /**
+     * Idempotently add a worktree for `sessionId` on branch `session/{sid}`,
+     * branching from `main`. Throws if the target dir exists but is not a valid
+     * worktree of this instance's bare repo (unrecoverable conflict).
+     */
+    async addSessionWorktree(instanceId, sessionId) {
+        const repoDir = this.repoDir(instanceId);
+        const worktreePath = this.worktreeDir(instanceId, sessionId);
+        if (!existsSync(repoDir)) {
+            throw new Error(`Cannot add session worktree: instance bare repo missing at ${repoDir}`);
+        }
+        if (existsSync(worktreePath)) {
+            if (await this.isLinkedWorktree(repoDir, worktreePath)) {
+                this.logger.debug('Session worktree already exists, skipping add', { instanceId, sessionId });
+                return worktreePath;
+            }
+            throw new Error(`Path exists but is not a registered worktree of ${repoDir}: ${worktreePath}`);
+        }
+        await mkdir(join(this.instanceDir(instanceId), 'sessions'), { recursive: true });
+        await this.git(['worktree', 'add', '-b', `session/${sessionId}`, worktreePath, 'main'], { cwd: repoDir });
+        this.logger.info('Added session worktree', { instanceId, sessionId, worktreePath });
+        return worktreePath;
+    }
+    /**
+     * Remove a session's worktree (filesystem + bookkeeping). Silently no-ops
+     * if the worktree was never registered.
+     */
+    async removeSessionWorktree(instanceId, sessionId) {
+        const repoDir = this.repoDir(instanceId);
+        const worktreePath = this.worktreeDir(instanceId, sessionId);
+        if (!existsSync(repoDir) || !existsSync(worktreePath))
+            return;
+        try {
+            await this.git(['worktree', 'remove', '--force', worktreePath], { cwd: repoDir });
+        }
+        catch (err) {
+            // worktree may already be detached; fall back to filesystem rm + prune.
+            this.logger.warn('git worktree remove failed, falling back to rm + prune', {
+                instanceId,
+                sessionId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            await rm(worktreePath, { recursive: true, force: true });
+            await this.git(['worktree', 'prune'], { cwd: repoDir }).catch(() => { });
+        }
+    }
+    /**
+     * Tear down everything for an instance: every worktree, then the
+     * bare repo + on-disk dir. Safe to call when nothing exists.
+     */
+    async removeInstance(instanceId) {
+        const dir = this.instanceDir(instanceId);
+        if (!existsSync(dir))
+            return;
+        await rm(dir, { recursive: true, force: true });
+        this.logger.info('Removed instance directory', { instanceId, dir });
+    }
+    async isLinkedWorktree(repoDir, worktreePath) {
+        try {
+            const stdout = await this.git(['worktree', 'list', '--porcelain'], { cwd: repoDir });
+            // `worktree` lines look like: `worktree /abs/path` (one per registration).
+            return stdout
+                .split('\n')
+                .some((line) => line.startsWith('worktree ') && line.slice('worktree '.length) === worktreePath);
+        }
+        catch {
+            return false;
+        }
+    }
+    async git(args, opts = {}) {
+        const env = opts.env ? { ...process.env, ...opts.env } : process.env;
+        const child = execFileAsync('git', args, { cwd: opts.cwd, env });
+        if (opts.input !== undefined) {
+            child.child.stdin?.end(opts.input);
+        }
+        try {
+            const { stdout } = await child;
+            return stdout;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`git ${args.join(' ')} failed: ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=git-instance-fs.js.map

package/dist/git-instance-fs.js.map

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

package/dist/instance.d.ts

@@ -4,16 +4,22 @@
  * A standalone server hosts exactly one "instance" — a workspace containing
  * sessions. The instance id is either supplied via config or auto-generated
  * on startup and remains stable for the process lifetime.
+ *
+ * `metadata` is mutated by `instances.create` calls (last write wins). It is
+ * a single-tenant local-dev convenience; consumers that need per-instance
+ * isolation must run separate processes.
  */
 export interface InstanceState {
     id: string;
     name: string;
     createdAt: string;
     presetIds: string[];
+    metadata: Record<string, unknown> | null;
 }
 export declare function createInstance(options: {
     id?: string;
     name?: string;
     presetIds: string[];
+    metadata?: Record<string, unknown> | null;
 }): InstanceState;
 //# sourceMappingURL=instance.d.ts.map

package/dist/instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,aAAa,CAO1G"}
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACxC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACvC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CACzC,GAAG,aAAa,CAQhB"}

package/dist/instance.js

@@ -4,6 +4,10 @@
  * A standalone server hosts exactly one "instance" — a workspace containing
  * sessions. The instance id is either supplied via config or auto-generated
  * on startup and remains stable for the process lifetime.
+ *
+ * `metadata` is mutated by `instances.create` calls (last write wins). It is
+ * a single-tenant local-dev convenience; consumers that need per-instance
+ * isolation must run separate processes.
  */
 export function createInstance(options) {
     return {
@@ -11,6 +15,7 @@ export function createInstance(options) {
         name: options.name ?? 'standalone',
         createdAt: new Date().toISOString(),
         presetIds: options.presetIds,
+        metadata: options.metadata ?? null,
     };
 }
 //# sourceMappingURL=instance.js.map

package/dist/instance.js.map

@@ -1 +1 @@
-{"version":3,"file":"instance.js","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,UAAU,cAAc,CAAC,OAA4D;IAC1F,OAAO;QACN,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,SAAS;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS;KAC5B,CAAA;AACF,CAAC"}
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,UAAU,cAAc,CAAC,OAK9B;IACA,OAAO;QACN,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,SAAS;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,YAAY;QAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;KAClC,CAAA;AACF,CAAC"}

package/dist/local-registry.d.ts

@@ -0,0 +1,109 @@
+/**
+ * On-disk file + resource registry for the standalone server.
+ *
+ * Stands in for the platform's Contember-backed file/resource service. State
+ * lives in `{dataPath}/.roj-platform-state.json` (JSON manifest) plus
+ * `{dataPath}/.roj-platform-state/files/{fileId}` (raw bytes). Operations are
+ * append-only at the resource level (revisions accumulate), so re-running
+ * `roj-standalone` between sessions preserves uploads and revisions added
+ * during a previous run.
+ *
+ * Files are content-addressable by SHA-256 — re-uploading the same bytes
+ * returns the existing fileId with `deduped: true`, mirroring the platform's
+ * /files/upload contract used by `@roj-ai/client/platform.files.upload`.
+ */
+import type { LocalResource, Logger } from '@roj-ai/sdk';
+interface FileMeta {
+    id: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+    contentHash: string;
+    createdAt: string;
+}
+export interface ResourceOutput {
+    id: string;
+    slug: string;
+    name: string | null;
+    description: string | null;
+    latestRevision: {
+        id: string;
+        label: string | null;
+        file: {
+            id: string;
+            filename: string;
+            mimeType: string;
+            size: number;
+        };
+        createdAt: string;
+    } | null;
+    createdAt: string;
+}
+export interface UploadResult {
+    fileId: string;
+    filename: string;
+    mimeType: string;
+    size: number;
+    deduped: boolean;
+}
+export declare class LocalRegistry {
+    private readonly dataPath;
+    private readonly logger;
+    private state;
+    private statePath;
+    private filesDir;
+    constructor(dataPath: string, logger: Logger);
+    init(): Promise<void>;
+    uploadFile(args: {
+        buffer?: Buffer;
+        filename: string;
+        mimeType: string;
+        contentHash?: string;
+    }): Promise<UploadResult | {
+        error: 'file-required';
+        contentHash: string;
+    }>;
+    readFileById(fileId: string): Promise<{
+        meta: FileMeta;
+        buffer: Buffer;
+    } | null>;
+    createResource(args: {
+        slug: string;
+        name?: string;
+        description?: string;
+        fileId: string;
+        label?: string;
+    }): Promise<{
+        resourceId: string;
+        revisionId: string;
+    }>;
+    addRevision(args: {
+        resourceId?: string;
+        resourceSlug?: string;
+        fileId: string;
+        label?: string;
+    }): Promise<{
+        revisionId: string;
+        noop: boolean;
+    }>;
+    getResource(args: {
+        resourceId?: string;
+        resourceSlug?: string;
+    }): ResourceOutput | null;
+    listResources(): ResourceOutput[];
+    deleteResource(resourceId: string): Promise<{
+        ok: boolean;
+    }>;
+    /**
+     * Idempotent: ensures every config-declared local resource exists in the
+     * registry. Skips slugs that already have a record (so previously uploaded
+     * revisions survive restarts).
+     */
+    bootstrapLocalResources(localResources: LocalResource[]): Promise<void>;
+    private persist;
+    private findResource;
+    private findBySlug;
+}
+export declare function clearLocalRegistry(dataPath: string): Promise<void>;
+export {};
+//# sourceMappingURL=local-registry.d.ts.map

package/dist/local-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-registry.d.ts","sourceRoot":"","sources":["../src/local-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAExD,UAAU,QAAQ;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CACjB;AAuBD,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,cAAc,EAAE;QACf,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;QACtE,SAAS,EAAE,MAAM,CAAA;KACjB,GAAG,IAAI,CAAA;IACR,SAAS,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;CAChB;AAED,qBAAa,aAAa;IAMxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANxB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,QAAQ,CAAQ;gBAGN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM;IAM1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,UAAU,CAAC,IAAI,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,QAAQ,EAAE,MAAM,CAAA;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,CAAA;KACpB,GAAG,OAAO,CAAC,YAAY,GAAG;QAAE,KAAK,EAAE,eAAe,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAqDrE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAWhF,cAAc,CAAC,IAAI,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAuBjD,WAAW,CAAC,IAAI,EAAE;QACvB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,MAAM,EAAE,MAAM,CAAA;QACd,KAAK,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAwBlD,WAAW,CAAC,IAAI,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc,GAAG,IAAI;IAKxF,aAAa,IAAI,cAAc,EAAE;IAI3B,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC;IAOlE;;;;OAIG;IACG,uBAAuB,CAAC,cAAc,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAsB/D,OAAO;IAMrB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,UAAU;CAMlB;AAuCD,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE"}