@auersperg/flare 0.3.13 → 0.3.15

package/dist/cli/flare.js

@@ -3,7 +3,7 @@
 // packages/flare/package.json
 var package_default = {
   name: "@auersperg/flare",
-  version: "0.3.13",
+  version: "0.3.15",
   license: "MIT",
   type: "module",
   description: "Flare client, server declarations and development CLI",

package/dist/platform/admin.js

@@ -309,7 +309,7 @@ async function collectCatalog(database, now = Date.now()) {
 // packages/core/package.json
 var package_default = {
   name: "@flare/platform",
-  version: "0.3.13",
+  version: "0.3.15",
   type: "module",
   license: "MIT",
   private: true,

package/dist/platform/dashboard/bootstrap/action.js

@@ -182,8 +182,11 @@ var app_default = defineApp({ schema: {}, functions: {} });
 
 // packages/flare/dist/sdk/codex.js
 function codexInput(op, input) {
-  boundedJson(input, 20000);
-  if (!input || Array.isArray(input) || !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(input.id) || !["start", "status", "cancel"].includes(op) || Object.keys(input).some((k) => !["id", ...op === "start" ? ["prompt"] : []].includes(k)) || op === "start" && (typeof input.prompt !== "string" || !input.prompt.trim() || new TextEncoder().encode(input.prompt).length > 16384))
+  boundedJson(input, 40000);
+  if (!input || Array.isArray(input) || !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(input.id) || !["start", "status", "cancel", "discardArtifact"].includes(op) || Object.keys(input).some((k) => ![
+    "id",
+    ...op === "start" ? ["prompt", "instructions", "outputFile"] : []
+  ].includes(k)) || op === "start" && (typeof input.prompt !== "string" || !input.prompt.trim() || new TextEncoder().encode(input.prompt).length > 16384 || input.instructions !== undefined && (typeof input.instructions !== "string" || new TextEncoder().encode(input.instructions).length > 16384) || input.outputFile !== undefined && (typeof input.outputFile !== "string" || !/^[a-zA-Z0-9_-]{1,64}\.json$/.test(input.outputFile))))
     throw new FlareError("INVALID_ARGUMENT", "Invalid Codex task");
 }
 function codexContext(call) {
@@ -194,13 +197,35 @@ function codexContext(call) {
   return {
     start: (input) => invoke("start", input),
     status: (id) => invoke("status", { id }),
-    cancel: (id) => invoke("cancel", { id })
+    cancel: (id) => invoke("cancel", { id }),
+    discardArtifact: async (id) => {
+      await invoke("discardArtifact", { id });
+    }
   };
 }
 
 // packages/flare/dist/sdk/search.js
 function searchContext(command) {
   return {
+    records: {
+      sync: (input) => command("record-sync", input),
+      status: (input) => command("record-status", input),
+      async query(input, authorize) {
+        if (typeof authorize !== "function")
+          throw new FlareError("FORBIDDEN", "A current source access/version check is required");
+        const hits = await command("record-query", input);
+        if (!hits.length)
+          return [];
+        const allowed = await authorize(hits.map(({ id, version }) => ({ id, version })));
+        if (!Array.isArray(allowed) || allowed.some((a) => !hits.some((h) => h.id === a.id && h.version === a.version)))
+          throw new FlareError("FORBIDDEN", "Invalid source access result");
+        const current = await command("record-validate", {
+          partition: input.partition,
+          records: allowed
+        });
+        return hits.filter((h) => current.some((a) => a.id === h.id && a.version === h.version));
+      }
+    },
     index: (fileId) => command("index", { fileId }),
     exclude: (fileId) => command("exclude", { fileId }),
     status: (fileId) => command("status", { fileId }),

package/dist/platform/dashboard/bootstrap/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Flare application contract",
-    "version": "5032f63300c081a5d65203bacac1e41d2fae41658f7774d2e3cd579b295734eb"
+    "version": "46e95c497319ce515538fb3788f93111df98c76d7ca3eafbc6fd8bcbb4cfbff1"
   },
   "components": {
     "schemas": {},

package/dist/platform/dashboard/bootstrap/release.json

@@ -3,9 +3,9 @@
   "compatibilityDate": "2026-10-10",
   "checksums": {
     "facet": "8d7880b99b69d141a58da4c7574b26c39dbc529785512298683239dee657a38b",
-    "action": "2b6c759576b5e75b76eee27697009ee4371f5b5f6d003d82489e21a6440e548b",
+    "action": "551610f76cc588409c0d5f51f23b132a7da1d90f851d49fea5186f6c8e5f7383",
     "schema": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
     "manifest": "006a07907dfd7619fa66152627bc761e581cf8ac538f5002f3b89b71ce92d733"
   },
-  "hash": "5032f63300c081a5d65203bacac1e41d2fae41658f7774d2e3cd579b295734eb"
+  "hash": "46e95c497319ce515538fb3788f93111df98c76d7ca3eafbc6fd8bcbb4cfbff1"
 }

package/dist/platform/manifest.json

@@ -1,6 +1,6 @@
 {
   "format": 1,
-  "version": "0.3.13",
+  "version": "0.3.15",
   "stateFormat": 1,
   "protocol": 1,
   "runtimeAbi": 4,
@@ -13,7 +13,7 @@
     {
       "path": "admin.js",
       "bytes": 37491,
-      "sha256": "c8f7aaab485b4674e57dc1a24a059e4bd08be2fa2cbf9933b6a032425af969fe"
+      "sha256": "4fe2f7a229b217bfc26c0ec5708f6ae1b06306dcacdc1068f642abc901202d5a"
     },
     {
       "path": "dashboard/_astro/ai-view.D6ouaMiL.js",
@@ -122,8 +122,8 @@
     },
     {
       "path": "dashboard/bootstrap/action.js",
-      "bytes": 12421,
-      "sha256": "2b6c759576b5e75b76eee27697009ee4371f5b5f6d003d82489e21a6440e548b"
+      "bytes": 13801,
+      "sha256": "551610f76cc588409c0d5f51f23b132a7da1d90f851d49fea5186f6c8e5f7383"
     },
     {
       "path": "dashboard/bootstrap/api.ts",
@@ -143,12 +143,12 @@
     {
       "path": "dashboard/bootstrap/openapi.json",
       "bytes": 362,
-      "sha256": "db5daeb8a3a83f19cb0eb978028e5860cc290d270c769974d6adc82cd41994cc"
+      "sha256": "d9672f489689ae8053324a9599477a438495609b1034f52b4599f1a154f4f157"
     },
     {
       "path": "dashboard/bootstrap/release.json",
       "bytes": 484,
-      "sha256": "3cae0f2f12eb38d6d431a09890a1944f497de4b79deba9ebe9937a39fc1ac548"
+      "sha256": "46bd000ed0f4b7fe3b3e71d3555849103a773bf8b434af5e52e3060e5d5e4630"
     },
     {
       "path": "dashboard/bootstrap/schema.json",
@@ -192,9 +192,9 @@
     },
     {
       "path": "runtime.js",
-      "bytes": 1220978,
-      "sha256": "db4296fa4e80fdd00ebb9d10a058e29b799c73dd5c85e422c33b27e44439f0bd"
+      "bytes": 1229444,
+      "sha256": "3ffb8eb5dafee479a222d97cb661e49f6f4f919b2f8403ec3d2f689cb5d15082"
     }
   ],
-  "digest": "6f78f2d407a7d7ce377924b9d4dfbcde8a63e5178e031458167a8c29f96e1360"
+  "digest": "53eb87d966d0698a5dab31c3bb1d3279e170df76d77ddcb67e5d8e5190c7b374"
 }

package/dist/platform/runtime.js

@@ -23057,8 +23057,11 @@ async function outbound(request, policy) {
 
 // packages/flare/src/sdk/codex.ts
 function codexInput(op, input) {
-  boundedJson(input, 20000);
-  if (!input || Array.isArray(input) || !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(input.id) || !["start", "status", "cancel"].includes(op) || Object.keys(input).some((k) => !["id", ...op === "start" ? ["prompt"] : []].includes(k)) || op === "start" && (typeof input.prompt !== "string" || !input.prompt.trim() || new TextEncoder().encode(input.prompt).length > 16384))
+  boundedJson(input, 40000);
+  if (!input || Array.isArray(input) || !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(input.id) || !["start", "status", "cancel", "discardArtifact"].includes(op) || Object.keys(input).some((k) => ![
+    "id",
+    ...op === "start" ? ["prompt", "instructions", "outputFile"] : []
+  ].includes(k)) || op === "start" && (typeof input.prompt !== "string" || !input.prompt.trim() || new TextEncoder().encode(input.prompt).length > 16384 || input.instructions !== undefined && (typeof input.instructions !== "string" || new TextEncoder().encode(input.instructions).length > 16384) || input.outputFile !== undefined && (typeof input.outputFile !== "string" || !/^[a-zA-Z0-9_-]{1,64}\.json$/.test(input.outputFile))))
     throw new FlareError("INVALID_ARGUMENT", "Invalid Codex task");
 }
 
@@ -23626,12 +23629,38 @@ class SearchStore {
   }
   static initialize(storage) {
     storage.sql.exec("CREATE TABLE IF NOT EXISTS search_items (id TEXT PRIMARY KEY,key TEXT NOT NULL,version TEXT NOT NULL,binding TEXT NOT NULL,item TEXT,status TEXT NOT NULL,wanted INTEGER NOT NULL,attempts INTEGER NOT NULL DEFAULT 0,uncertain INTEGER NOT NULL DEFAULT 0,error TEXT)");
+    const columns = new Set(storage.sql.exec("PRAGMA table_info(search_items)").toArray().map((r) => r.name));
+    for (const name of ["record_id", "partition", "text", "metadata"])
+      if (!columns.has(name))
+        storage.sql.exec(`ALTER TABLE search_items ADD COLUMN ${name} TEXT`);
+    storage.sql.exec("CREATE TABLE IF NOT EXISTS search_records (id TEXT NOT NULL,partition TEXT NOT NULL,version INTEGER NOT NULL,digest TEXT NOT NULL,wanted INTEGER NOT NULL,current TEXT,PRIMARY KEY(id,partition))");
+    storage.sql.exec("CREATE INDEX IF NOT EXISTS search_record_versions ON search_items(record_id,partition)");
+  }
+  head(id, partition) {
+    this.recordRef(id, partition);
+    return this.storage.sql.exec("SELECT * FROM search_records WHERE id=? AND partition=?", id, partition).toArray()[0];
+  }
+  recordRef(id, partition) {
+    fileKey(this.scope, id);
+    if (typeof partition !== "string" || !partition || new TextEncoder().encode(partition).length > 128)
+      fail("INVALID_INPUT");
+  }
+  async hash(value) {
+    return Array.from(new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(value)))).map((b) => b.toString(16).padStart(2, "0")).join("");
+  }
+  async folder(partition) {
+    return (await this.hash(JSON.stringify([this.scope, partition]))).slice(0, 32) + "/";
   }
   row(id) {
     fileKey(this.scope, id);
     return this.storage.sql.exec("SELECT * FROM search_items WHERE id=?", id).toArray()[0];
   }
   original(id) {
+    const row = this.row(id);
+    if (row?.record_id) {
+      const head = this.head(row.record_id, row.partition);
+      return head?.wanted && head.current === id ? { name: row.record_id, type: "text/plain" } : undefined;
+    }
     return this.storage.sql.exec("SELECT name,type FROM files WHERE id=? AND state='ready'", id).toArray()[0];
   }
   binding(name = appPolicy(this.env, this.scope).search) {
@@ -23652,7 +23681,7 @@ class SearchStore {
     };
   }
   async reconcile() {
-    this.storage.sql.exec("UPDATE search_items SET wanted=0,attempts=0,error=NULL WHERE binding!=? AND wanted=1", appPolicy(this.env, this.scope).search ?? "");
+    this.storage.sql.exec("UPDATE search_items SET wanted=0,attempts=0,error=NULL,text=NULL,metadata=NULL WHERE binding!=? AND wanted=1", appPolicy(this.env, this.scope).search ?? "");
     this.storage.sql.exec("UPDATE search_items SET status='error',error=COALESCE(error,'SEARCH_RECONCILE_REQUIRED') WHERE (wanted=0 OR status IN ('pending','sending')) AND attempts>=3");
     if (this.storage.sql.exec("SELECT 1 FROM search_items WHERE (wanted=0 OR status IN ('pending','sending')) AND attempts<3 LIMIT 1").toArray().length)
       await this.wake();
@@ -23697,7 +23726,8 @@ class SearchStore {
     return this.state(id);
   }
   async clear() {
-    this.storage.sql.exec("UPDATE search_items SET wanted=0,attempts=0,error=NULL");
+    this.storage.sql.exec("UPDATE search_records SET wanted=0");
+    this.storage.sql.exec("UPDATE search_items SET wanted=0,attempts=0,error=NULL,text=NULL,metadata=NULL");
     await this.wake();
     return this.summary();
   }
@@ -23718,6 +23748,8 @@ class SearchStore {
   updateInfo(row, info) {
     if (info.key !== row.key || !states.has(info.status))
       fail("SEARCH_UNAVAILABLE");
+    if (row.record_id && ["queued", "running", "completed"].includes(info.status))
+      this.storage.sql.exec("UPDATE search_items SET text=NULL WHERE id=?", row.id);
     this.storage.sql.exec("UPDATE search_items SET item=?,status=?,error=?,uncertain=0 WHERE id=? AND key=? AND wanted=1", info.id, info.status, info.status === "error" ? "INDEXING_FAILED" : null, row.id, row.key);
     this.storage.sql.exec("UPDATE search_items SET item=?,uncertain=0 WHERE id=? AND key=? AND wanted=0", info.id, row.id, row.key);
   }
@@ -23791,6 +23823,113 @@ class SearchStore {
     boundedJson(hits, LIMITS.outputBytes);
     return hits;
   }
+  async syncRecord(input) {
+    boundedJson(input, 20000);
+    if (!input || Object.keys(input).some((k) => !["id", "partition", "version", "text", "metadata"].includes(k)))
+      fail("INVALID_INPUT");
+    this.recordRef(input.id, input.partition);
+    if (!Number.isSafeInteger(input.version) || input.version < 1 || input.text !== null && (typeof input.text !== "string" || !input.text.trim() || new TextEncoder().encode(input.text).length > 16384))
+      fail("INVALID_INPUT");
+    const metadata = input.metadata ?? {};
+    if (!metadata || Array.isArray(metadata) || typeof metadata !== "object" || Object.keys(metadata).length > 5 || Object.entries(metadata).some(([k, v]) => !/^[a-z][a-z0-9_]{0,31}$/.test(k) || ["folder", "filename", "timestamp"].includes(k) || typeof v !== "string" || new TextEncoder().encode(v).length > 64))
+      fail("INVALID_INPUT");
+    const digest = await this.hash(stableJson({ text: input.text, metadata }));
+    const folder = await this.folder(input.partition);
+    const head = this.head(input.id, input.partition);
+    const binding = appPolicy(this.env, this.scope).search;
+    if (head && input.version < head.version)
+      return this.recordState(input);
+    if (head && input.version === head.version && (digest !== head.digest || Boolean(head.wanted) !== (input.text !== null)))
+      fail("CONFLICT");
+    const current = head?.current ? this.row(head.current) : undefined;
+    if (input.text !== null)
+      this.binding(binding);
+    if (head?.version === input.version && (input.text === null || current?.wanted && current.binding === binding)) {
+      if (current && ["error", "skipped", "outdated"].includes(current.status))
+        this.storage.sql.exec("UPDATE search_items SET status='pending',attempts=0,error=NULL,text=? WHERE id=?", input.text, current.id);
+      await this.wake();
+      return this.recordState(input);
+    }
+    this.storage.sql.exec("UPDATE search_items SET wanted=0,text=NULL,metadata=NULL,attempts=0,error=NULL WHERE record_id=? AND partition=?", input.id, input.partition);
+    const id = input.text === null ? null : crypto.randomUUID();
+    if (id)
+      this.storage.sql.exec("INSERT INTO search_items (id,key,version,binding,status,wanted,record_id,partition,text,metadata) VALUES (?,?,?,?,'pending',1,?,?,?,?)", id, folder + id + ".txt", String(input.version), binding, input.id, input.partition, input.text, Object.keys(metadata).length ? JSON.stringify(metadata) : null);
+    this.storage.sql.exec("INSERT OR REPLACE INTO search_records VALUES (?,?,?,?,?,?)", input.id, input.partition, input.version, digest, Number(input.text !== null), id);
+    await this.wake();
+    return this.recordState(input);
+  }
+  recordState(input) {
+    const head = this.head(input.id, input.partition);
+    const row = head?.current ? this.row(head.current) : undefined;
+    const pending = this.storage.sql.exec("SELECT error FROM search_items WHERE record_id=? AND partition=? AND wanted=0", input.id, input.partition).toArray();
+    return {
+      id: input.id,
+      version: head?.version ?? 0,
+      enabled: Boolean(head?.wanted && row?.wanted && row.binding === appPolicy(this.env, this.scope).search),
+      status: head?.wanted && row?.wanted ? row.status : pending.length ? "deleting" : "excluded",
+      error: row?.error ?? pending.find((r) => r.error)?.error ?? null
+    };
+  }
+  async recordStatus(input) {
+    const head = this.head(input.id, input.partition);
+    if (head?.current)
+      await this.status(head.current);
+    return this.recordState(input);
+  }
+  validateRecords(input) {
+    if (!Array.isArray(input?.records) || input.records.length > 20)
+      fail("INVALID_INPUT");
+    return input.records.filter(({ id, version }) => {
+      const head = this.head(id, input.partition);
+      const row = head?.current ? this.row(head.current) : undefined;
+      return head?.wanted && head.version === version && row?.wanted && row.binding === appPolicy(this.env, this.scope).search;
+    });
+  }
+  async queryRecords(input) {
+    boundedJson(input, 1e4);
+    if (!input || typeof input.query !== "string" || !input.query.trim() || input.query.length > 2000 || Object.keys(input).some((k) => !["query", "partition", "limit"].includes(k)))
+      fail("INVALID_INPUT");
+    this.recordRef("00000000-0000-4000-8000-000000000000", input.partition);
+    const limit = input.limit ?? 10;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > 20)
+      fail("INVALID_INPUT");
+    const binding = appPolicy(this.env, this.scope).search;
+    const instance = this.binding(binding);
+    const folder = await this.folder(input.partition);
+    let result;
+    try {
+      result = await instance.search({
+        query: input.query,
+        ai_search_options: {
+          retrieval: {
+            max_num_results: limit,
+            return_on_failure: false,
+            filters: { folder }
+          },
+          query_rewrite: { enabled: false },
+          reranking: { enabled: false },
+          cache: { enabled: false }
+        }
+      });
+    } catch {
+      fail("SEARCH_UNAVAILABLE");
+    }
+    const hits = [];
+    for (const chunk of result.chunks.slice(0, limit)) {
+      const row = this.storage.sql.exec("SELECT s.record_id,h.version FROM search_items s JOIN search_records h ON h.current=s.id WHERE s.key=? AND s.binding=? AND s.partition=? AND s.wanted=1 AND h.wanted=1", chunk.item.key, binding, input.partition).toArray()[0];
+      if (!row)
+        continue;
+      if (typeof chunk.text !== "string" || !Number.isFinite(chunk.score))
+        fail("SEARCH_UNAVAILABLE");
+      hits.push({
+        id: String(row.record_id),
+        version: Number(row.version),
+        text: chunk.text.slice(0, 2000),
+        score: chunk.score
+      });
+    }
+    return hits;
+  }
   work() {
     return this.working ??= this.process().finally(() => {
       this.working = undefined;
@@ -23833,21 +23972,23 @@ class SearchStore {
         if (existing[0] && !["error", "skipped", "outdated"].includes(existing[0].status)) {
           this.updateInfo(row, existing[0]);
         } else {
-          const object = await this.env.FILES?.get(fileKey(this.scope, row.id));
-          if (!object)
+          const object = row.record_id ? null : await this.env.FILES?.get(fileKey(this.scope, row.id));
+          const content = row.record_id ? this.row(row.id)?.text : object?.body;
+          if (content == null)
             fail("NOT_FOUND");
-          if (row.version && object.version !== row.version) {
+          if (object && row.version && object.version !== row.version) {
             await object.body.cancel();
             fail("NOT_FOUND");
           }
           if (!this.row(row.id)?.wanted || !this.original(row.id)) {
-            await object.body.cancel();
+            await object?.body.cancel();
             continue;
           }
-          this.storage.sql.exec("UPDATE search_items SET status='sending',uncertain=1,version=? WHERE id=? AND wanted=1", object.version, row.id);
-          this.updateInfo(row, await instance.items.uploadAndPoll(row.key, object.body, {
+          this.storage.sql.exec("UPDATE search_items SET status='sending',uncertain=1,version=? WHERE id=? AND wanted=1", object?.version ?? row.version, row.id);
+          this.updateInfo(row, await instance.items.uploadAndPoll(row.key, content, {
             timeoutMs: 30000,
-            pollIntervalMs: 2000
+            pollIntervalMs: 2000,
+            ...row.metadata ? { metadata: JSON.parse(row.metadata) } : {}
           }));
         }
       } catch (error) {
@@ -24208,7 +24349,7 @@ function dashboardIdentity(value) {
 // packages/core/package.json
 var package_default = {
   name: "@flare/platform",
-  version: "0.3.13",
+  version: "0.3.15",
   type: "module",
   license: "MIT",
   private: true,
@@ -32605,6 +32746,14 @@ class EnvironmentSupervisor extends DurableObject {
   async searchCommand(op, input) {
     await this.lifecycle.start();
     this.assertAvailable();
+    if (op === "record-sync")
+      return this.search().syncRecord(input);
+    if (op === "record-status")
+      return this.search().recordStatus(input);
+    if (op === "record-query")
+      return this.search().queryRecords(input);
+    if (op === "record-validate")
+      return this.search().validateRecords(input);
     if (op === "index")
       return this.search().index(input.fileId);
     if (op === "exclude")

package/dist/sdk/codex.d.ts

@@ -2,6 +2,10 @@ export interface CodexTaskInput {
     /** Stable UUID for retries of the same submission; retained for seven days. */
     id: string;
     prompt: string;
+    /** Trusted application instructions, separate from the user's request. */
+    instructions?: string;
+    /** Optional JSON artifact in /workspace; collected only on successful completion. */
+    outputFile?: string;
 }
 export interface CodexTask {
     id: string;
@@ -9,12 +13,15 @@ export interface CodexTask {
     startedAt: number;
     finishedAt?: number;
     result?: string;
+    artifact?: string;
     error?: string;
 }
 export interface CodexContext {
     start(input: CodexTaskInput): Promise<CodexTask>;
     status(id: string): Promise<CodexTask | null>;
     cancel(id: string): Promise<CodexTask | null>;
+    /** Erase the temporary artifact and prevent its later retention. An unstarted ID is fenced. */
+    discardArtifact(id: string): Promise<void>;
 }
 export declare function codexInput(op: string, input: any): void;
 export declare function codexContext(call: (op: string, input: unknown) => Promise<any>): CodexContext;

package/dist/sdk/codex.js

@@ -1,7 +1,10 @@
 import { FlareError, boundedJson } from "./protocol.js";
 export function codexInput(op, input) {
-  boundedJson(input, 20000);
-  if (!input || Array.isArray(input) || !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(input.id) || !["start", "status", "cancel"].includes(op) || Object.keys(input).some((k) => !["id", ...op === "start" ? ["prompt"] : []].includes(k)) || op === "start" && (typeof input.prompt !== "string" || !input.prompt.trim() || new TextEncoder().encode(input.prompt).length > 16384))
+  boundedJson(input, 40000);
+  if (!input || Array.isArray(input) || !/^[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$/.test(input.id) || !["start", "status", "cancel", "discardArtifact"].includes(op) || Object.keys(input).some((k) => ![
+    "id",
+    ...op === "start" ? ["prompt", "instructions", "outputFile"] : []
+  ].includes(k)) || op === "start" && (typeof input.prompt !== "string" || !input.prompt.trim() || new TextEncoder().encode(input.prompt).length > 16384 || input.instructions !== undefined && (typeof input.instructions !== "string" || new TextEncoder().encode(input.instructions).length > 16384) || input.outputFile !== undefined && (typeof input.outputFile !== "string" || !/^[a-zA-Z0-9_-]{1,64}\.json$/.test(input.outputFile))))
     throw new FlareError("INVALID_ARGUMENT", "Invalid Codex task");
 }
 export function codexContext(call) {
@@ -12,6 +15,9 @@ export function codexContext(call) {
   return {
     start: (input) => invoke("start", input),
     status: (id) => invoke("status", { id }),
-    cancel: (id) => invoke("cancel", { id })
+    cancel: (id) => invoke("cancel", { id }),
+    discardArtifact: async (id) => {
+      await invoke("discardArtifact", { id });
+    }
   };
 }

package/dist/sdk/search.d.ts

@@ -11,7 +11,37 @@ export type SearchHit = {
     text: string;
     score: number;
 };
+export type SearchRecord = {
+    /** Stable source UUID and monotonically increasing source revision. */
+    id: string;
+    version: number;
+    /** Server-selected access partition; never accept an unchecked client owner. */
+    partition: string;
+    /** null excludes the record; retain a source tombstone for delayed jobs. */
+    text: string | null;
+    metadata?: Record<string, string>;
+};
+export type SearchRecordRef = Pick<SearchRecord, "id" | "version">;
+export type SearchRecordState = SearchRecordRef & Omit<SearchState, "fileId">;
+export type SearchRecordHit = SearchRecordRef & {
+    text: string;
+    score: number;
+};
+export interface SearchRecords {
+    /** Schedule from a source mutation's transactional outbox; re-read source in the job. */
+    sync(input: SearchRecord): Promise<SearchRecordState>;
+    status(input: {
+        id: string;
+        partition: string;
+    }): Promise<SearchRecordState>;
+    query(input: {
+        query: string;
+        partition: string;
+        limit?: number;
+    }, authorize: (records: SearchRecordRef[]) => Promise<SearchRecordRef[]>): Promise<SearchRecordHit[]>;
+}
 export interface SearchContext {
+    readonly records: SearchRecords;
     index(fileId: string): Promise<SearchState>;
     exclude(fileId: string): Promise<SearchState>;
     status(fileId: string): Promise<SearchState>;

package/dist/sdk/search.js

@@ -1,6 +1,25 @@
 import { FlareError } from "./protocol.js";
 export function searchContext(command) {
   return {
+    records: {
+      sync: (input) => command("record-sync", input),
+      status: (input) => command("record-status", input),
+      async query(input, authorize) {
+        if (typeof authorize !== "function")
+          throw new FlareError("FORBIDDEN", "A current source access/version check is required");
+        const hits = await command("record-query", input);
+        if (!hits.length)
+          return [];
+        const allowed = await authorize(hits.map(({ id, version }) => ({ id, version })));
+        if (!Array.isArray(allowed) || allowed.some((a) => !hits.some((h) => h.id === a.id && h.version === a.version)))
+          throw new FlareError("FORBIDDEN", "Invalid source access result");
+        const current = await command("record-validate", {
+          partition: input.partition,
+          records: allowed
+        });
+        return hits.filter((h) => current.some((a) => a.id === h.id && a.version === h.version));
+      }
+    },
     index: (fileId) => command("index", { fileId }),
     exclude: (fileId) => command("exclude", { fileId }),
     status: (fileId) => command("status", { fileId }),

package/dist/sdk/server.d.ts

@@ -2,7 +2,7 @@ export type { CodexSubscription } from "./codex-stream.js";
 import type { CodexContext } from "./codex.js";
 export type { CodexContext, CodexTask, CodexTaskInput } from "./codex.js";
 import type { SearchContext } from "./search.js";
-export type { SearchContext, SearchHit, SearchState } from "./search.js";
+export type { SearchContext, SearchHit, SearchState, SearchRecord, SearchRecordRef, SearchRecordState, SearchRecordHit, SearchRecords, } from "./search.js";
 export { z } from "zod";
 import type { StandardSchemaV1 } from "@standard-schema/spec";
 import type { Validator, Schema } from "./schema.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@auersperg/flare",
-  "version": "0.3.13",
+  "version": "0.3.15",
   "license": "MIT",
   "type": "module",
   "description": "Flare client, server declarations and development CLI",