forge-openclaw-plugin 0.3.17 → 0.3.19

package/dist/server/apps/api/src/openapi.js

@@ -5639,7 +5639,13 @@ export function buildOpenApiDocument() {
             },
             sourceKind: {
                 type: "string",
-                enum: ["upload", "agent_upload", "wiki_ingest", "external_reference", "manual"]
+                enum: [
+                    "upload",
+                    "agent_upload",
+                    "wiki_ingest",
+                    "external_reference",
+                    "manual"
+                ]
             },
             sourceLabel: { type: "string" },
             uploadedByUserId: nullable({ type: "string" }),
@@ -5650,7 +5656,10 @@ export function buildOpenApiDocument() {
                 enum: ["active", "quarantined", "blocked", "archived", "metadata_only"]
             },
             dangerScore: { type: "integer", minimum: 0, maximum: 100 },
-            dangerLevel: { type: "string", enum: ["low", "moderate", "high", "blocked"] },
+            dangerLevel: {
+                type: "string",
+                enum: ["low", "moderate", "high", "blocked"]
+            },
             downloadPolicy: { type: "string", enum: ["human_only", "disabled"] },
             scanResults: artifactScanResult,
             enrichmentResults: { type: "object", additionalProperties: true },
@@ -5660,6 +5669,17 @@ export function buildOpenApiDocument() {
             updatedAt: { type: "string", format: "date-time" }
         }
     };
+    const artifactListResponse = {
+        type: "object",
+        required: ["artifacts", "total", "limit", "offset", "hasMore"],
+        properties: {
+            artifacts: arrayOf({ $ref: "#/components/schemas/Artifact" }),
+            total: { type: "integer", minimum: 0 },
+            limit: { type: "integer", minimum: 1, maximum: 500 },
+            offset: { type: "integer", minimum: 0 },
+            hasMore: { type: "boolean" }
+        }
+    };
     const artifactUploadInput = {
         type: "object",
         required: ["originalFileName", "contentBase64"],
@@ -5675,7 +5695,13 @@ export function buildOpenApiDocument() {
             },
             sourceKind: {
                 type: "string",
-                enum: ["upload", "agent_upload", "wiki_ingest", "external_reference", "manual"]
+                enum: [
+                    "upload",
+                    "agent_upload",
+                    "wiki_ingest",
+                    "external_reference",
+                    "manual"
+                ]
             },
             sourceLabel: { type: "string" },
             uploadedByUserId: nullable({ type: "string" }),
@@ -5758,7 +5784,15 @@ export function buildOpenApiDocument() {
     };
     const artifactAuditEvent = {
         type: "object",
-        required: ["id", "artifactId", "eventType", "actor", "source", "metadata", "createdAt"],
+        required: [
+            "id",
+            "artifactId",
+            "eventType",
+            "actor",
+            "source",
+            "metadata",
+            "createdAt"
+        ],
         properties: {
             id: { type: "string" },
             artifactId: { type: "string" },
@@ -5880,6 +5914,7 @@ export function buildOpenApiDocument() {
                 ArtifactScanFinding: artifactScanFinding,
                 ArtifactScanResult: artifactScanResult,
                 Artifact: artifact,
+                ArtifactListResponse: artifactListResponse,
                 ArtifactUploadInput: artifactUploadInput,
                 ArtifactMetadataPatchInput: artifactMetadataPatchInput,
                 ArtifactTrustPatchInput: artifactTrustPatchInput,
@@ -5933,13 +5968,22 @@ export function buildOpenApiDocument() {
                             in: "query",
                             schema: {
                                 type: "string",
-                                enum: ["active", "quarantined", "blocked", "archived", "metadata_only"]
+                                enum: [
+                                    "active",
+                                    "quarantined",
+                                    "blocked",
+                                    "archived",
+                                    "metadata_only"
+                                ]
                             }
                         },
                         {
                             name: "dangerLevel",
                             in: "query",
-                            schema: { type: "string", enum: ["low", "moderate", "high", "blocked"] }
+                            schema: {
+                                type: "string",
+                                enum: ["low", "moderate", "high", "blocked"]
+                            }
                         },
                         {
                             name: "formatFamily",
@@ -5957,16 +6001,25 @@ export function buildOpenApiDocument() {
                                 ]
                             }
                         },
-                        { name: "linkedEntityType", in: "query", schema: { type: "string" } },
+                        {
+                            name: "linkedEntityType",
+                            in: "query",
+                            schema: { type: "string" }
+                        },
                         { name: "linkedEntityId", in: "query", schema: { type: "string" } },
-                        { name: "limit", in: "query", schema: { type: "integer", minimum: 1, maximum: 500 } }
+                        {
+                            name: "limit",
+                            in: "query",
+                            schema: { type: "integer", minimum: 1, maximum: 500 }
+                        },
+                        {
+                            name: "offset",
+                            in: "query",
+                            schema: { type: "integer", minimum: 0 }
+                        }
                     ],
                     responses: {
-                        "200": jsonResponse({
-                            type: "object",
-                            required: ["artifacts"],
-                            properties: { artifacts: arrayOf({ $ref: "#/components/schemas/Artifact" }) }
-                        }, "Artifact list"),
+                        "200": jsonResponse({ $ref: "#/components/schemas/ArtifactListResponse" }, "Artifact list"),
                         default: { $ref: "#/components/responses/Error" }
                     }
                 },
@@ -5985,7 +6038,9 @@ export function buildOpenApiDocument() {
                         "201": jsonResponse({
                             type: "object",
                             required: ["artifact"],
-                            properties: { artifact: { $ref: "#/components/schemas/Artifact" } }
+                            properties: {
+                                artifact: { $ref: "#/components/schemas/Artifact" }
+                            }
                         }, "Created artifact"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6006,7 +6061,9 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["artifact"],
-                            properties: { artifact: { $ref: "#/components/schemas/Artifact" } }
+                            properties: {
+                                artifact: { $ref: "#/components/schemas/Artifact" }
+                            }
                         }, "Artifact metadata"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6017,7 +6074,9 @@ export function buildOpenApiDocument() {
                         required: true,
                         content: {
                             "application/json": {
-                                schema: { $ref: "#/components/schemas/ArtifactMetadataPatchInput" }
+                                schema: {
+                                    $ref: "#/components/schemas/ArtifactMetadataPatchInput"
+                                }
                             }
                         }
                     },
@@ -6025,7 +6084,9 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["artifact"],
-                            properties: { artifact: { $ref: "#/components/schemas/Artifact" } }
+                            properties: {
+                                artifact: { $ref: "#/components/schemas/Artifact" }
+                            }
                         }, "Updated artifact"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6071,7 +6132,9 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["artifact"],
-                            properties: { artifact: { $ref: "#/components/schemas/Artifact" } }
+                            properties: {
+                                artifact: { $ref: "#/components/schemas/Artifact" }
+                            }
                         }, "Rescanned artifact"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6101,7 +6164,9 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["artifact"],
-                            properties: { artifact: { $ref: "#/components/schemas/Artifact" } }
+                            properties: {
+                                artifact: { $ref: "#/components/schemas/Artifact" }
+                            }
                         }, "Enriched artifact"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6127,7 +6192,9 @@ export function buildOpenApiDocument() {
                                     type: "object",
                                     required: ["links"],
                                     properties: {
-                                        links: arrayOf({ $ref: "#/components/schemas/EntityLinkInput" })
+                                        links: arrayOf({
+                                            $ref: "#/components/schemas/EntityLinkInput"
+                                        })
                                     }
                                 }
                             }
@@ -6137,7 +6204,9 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["artifact"],
-                            properties: { artifact: { $ref: "#/components/schemas/Artifact" } }
+                            properties: {
+                                artifact: { $ref: "#/components/schemas/Artifact" }
+                            }
                         }, "Relinked artifact"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6166,7 +6235,9 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["artifact"],
-                            properties: { artifact: { $ref: "#/components/schemas/Artifact" } }
+                            properties: {
+                                artifact: { $ref: "#/components/schemas/Artifact" }
+                            }
                         }, "Trust-updated artifact"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6187,7 +6258,11 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["versions"],
-                            properties: { versions: arrayOf({ $ref: "#/components/schemas/ArtifactVersion" }) }
+                            properties: {
+                                versions: arrayOf({
+                                    $ref: "#/components/schemas/ArtifactVersion"
+                                })
+                            }
                         }, "Artifact versions"),
                         default: { $ref: "#/components/responses/Error" }
                     }
@@ -6208,7 +6283,11 @@ export function buildOpenApiDocument() {
                         "200": jsonResponse({
                             type: "object",
                             required: ["events"],
-                            properties: { events: arrayOf({ $ref: "#/components/schemas/ArtifactAuditEvent" }) }
+                            properties: {
+                                events: arrayOf({
+                                    $ref: "#/components/schemas/ArtifactAuditEvent"
+                                })
+                            }
                         }, "Artifact audit events"),
                         default: { $ref: "#/components/responses/Error" }
                     }

package/dist/server/apps/api/src/services/artifacts.js

@@ -5,7 +5,7 @@ import path from "node:path";
 import AdmZip from "adm-zip";
 import { z } from "zod";
 import { getDatabase, resolveDataDir, runInTransaction } from "../db.js";
-import { filterDeletedEntities, isEntityDeleted } from "../repositories/deleted-entities.js";
+import { isEntityDeleted } from "../repositories/deleted-entities.js";
 import { listEntityLinksForSources, replaceEntityLinksForSource } from "../repositories/entity-links.js";
 import { recordEventLog } from "../repositories/event-log.js";
 import { listWikiLlmProfiles } from "../repositories/wiki-memory.js";
@@ -64,10 +64,7 @@ export const artifactDangerLevelSchema = z.enum([
     "high",
     "blocked"
 ]);
-export const artifactDownloadPolicySchema = z.enum([
-    "human_only",
-    "disabled"
-]);
+export const artifactDownloadPolicySchema = z.enum(["human_only", "disabled"]);
 export const artifactFormatFamilySchema = z.enum([
     "spreadsheet",
     "document",
@@ -141,7 +138,8 @@ export const artifactListQuerySchema = z.object({
     formatFamily: artifactFormatFamilySchema.optional(),
     linkedEntityType: z.string().trim().optional(),
     linkedEntityId: z.string().trim().optional(),
-    limit: z.coerce.number().int().min(1).max(500).optional().default(100)
+    limit: z.coerce.number().int().min(1).max(500).optional().default(100),
+    offset: z.coerce.number().int().min(0).optional().default(0)
 });
 export const artifactTrustPatchSchema = z.object({
     artifactState: artifactStateSchema,
@@ -181,10 +179,16 @@ function normalizeNullableText(value) {
     return text && text.length > 0 ? text : null;
 }
 function sanitizeFileName(fileName) {
-    return path.basename(fileName).replace(/[^\w.\- ()[\]]+/g, "_").slice(0, 180);
+    return path
+        .basename(fileName)
+        .replace(/[^\w.\- ()[\]]+/g, "_")
+        .slice(0, 180);
 }
 function extensionFromFileName(fileName) {
-    return path.extname(sanitizeFileName(fileName)).replace(/^\./, "").toLowerCase();
+    return path
+        .extname(sanitizeFileName(fileName))
+        .replace(/^\./, "")
+        .toLowerCase();
 }
 function formatFamilyForExtension(extension) {
     return extensionToFormatFamily[extension] ?? null;
@@ -305,11 +309,21 @@ function severityScore(severity) {
 function computeDanger(findings) {
     const score = Math.min(100, findings.reduce((max, finding) => Math.max(max, severityScore(finding.severity)), 0) +
         Math.max(0, findings.length - 1) * 4);
-    const level = score >= 90 ? "blocked" : score >= 70 ? "high" : score >= 35 ? "moderate" : "low";
+    const level = score >= 90
+        ? "blocked"
+        : score >= 70
+            ? "high"
+            : score >= 35
+                ? "moderate"
+                : "low";
     return { score, level };
 }
 function safeUtf8(buffer, limit = MAX_TEXT_EXTRACTION_CHARS) {
-    return buffer.subarray(0, limit).toString("utf8").replace(/\u0000/g, "").trim();
+    return buffer
+        .subarray(0, limit)
+        .toString("utf8")
+        .replace(/\u0000/g, "")
+        .trim();
 }
 function stripXml(xml) {
     return xml
@@ -321,7 +335,9 @@ function stripXml(xml) {
         .trim();
 }
 function zipEntryText(zip, name) {
-    const entry = zip.getEntries().find((candidate) => candidate.entryName === name);
+    const entry = zip
+        .getEntries()
+        .find((candidate) => candidate.entryName === name);
     return entry ? entry.getData().toString("utf8") : "";
 }
 function extractOfficeText(zip, extension) {
@@ -344,7 +360,10 @@ function extractOfficeText(zip, extension) {
             .slice(0, 5)
             .map((entry) => stripXml(entry.getData().toString("utf8")))
             .join("\n");
-        return [sharedStrings, sheetText].filter(Boolean).join("\n").slice(0, MAX_TEXT_EXTRACTION_CHARS);
+        return [sharedStrings, sheetText]
+            .filter(Boolean)
+            .join("\n")
+            .slice(0, MAX_TEXT_EXTRACTION_CHARS);
     }
     return "";
 }
@@ -359,7 +378,8 @@ function scanOfficeZip(buffer, extension, findings) {
         if (entries.length > MAX_ZIP_ENTRY_COUNT) {
             addFinding(findings, "blocked", "zip_entry_limit", "The archive has too many entries for safe static inspection.");
         }
-        if (totalUncompressed > MAX_ZIP_UNCOMPRESSED_BYTES || ratio > MAX_ZIP_RATIO) {
+        if (totalUncompressed > MAX_ZIP_UNCOMPRESSED_BYTES ||
+            ratio > MAX_ZIP_RATIO) {
             addFinding(findings, "blocked", "zip_bomb_indicator", "The archive has unsafe compressed-to-uncompressed size characteristics.");
         }
         if (entries.some((entry) => entry.entryName.endsWith("EncryptedPackage"))) {
@@ -400,7 +420,9 @@ function scanOfficeZip(buffer, extension, findings) {
     return extractedTextSample;
 }
 function scanPdf(buffer, findings) {
-    const text = buffer.subarray(0, Math.min(buffer.byteLength, 2_000_000)).toString("latin1");
+    const text = buffer
+        .subarray(0, Math.min(buffer.byteLength, 2_000_000))
+        .toString("latin1");
     if (/\/JavaScript|\/JS\b/i.test(text)) {
         addFinding(findings, "high", "pdf_javascript", "The PDF contains JavaScript actions.");
     }
@@ -436,17 +458,21 @@ export function scanArtifactBytes(input) {
     const detectedMimeType = detectMimeType(input.buffer, detectedExtension);
     const formatFamily = formatFamilyForExtension(detectedExtension);
     const findings = [];
-    if (!formatFamily || !ALLOWED_EXTENSIONS.includes(detectedExtension)) {
+    if (!formatFamily ||
+        !ALLOWED_EXTENSIONS.includes(detectedExtension)) {
         addFinding(findings, "blocked", "unsupported_extension", `Files with extension .${detectedExtension || "unknown"} are not allowed.`);
     }
     if (input.buffer.byteLength > MAX_ARTIFACT_BYTES) {
         addFinding(findings, "blocked", "size_limit_exceeded", "The file exceeds Forge's artifact size limit.");
     }
-    if (input.declaredMimeType?.trim() && input.declaredMimeType !== detectedMimeType) {
+    if (input.declaredMimeType?.trim() &&
+        input.declaredMimeType !== detectedMimeType) {
         addFinding(findings, "low", "mime_mismatch", "The declared MIME type differs from static file detection.");
     }
     let extractedTextSample = "";
-    if (formatFamily === "document" || formatFamily === "presentation" || formatFamily === "spreadsheet") {
+    if (formatFamily === "document" ||
+        formatFamily === "presentation" ||
+        formatFamily === "spreadsheet") {
         if (["docx", "pptx", "xlsx", "xlsm"].includes(detectedExtension)) {
             extractedTextSample = scanOfficeZip(input.buffer, detectedExtension, findings);
         }
@@ -467,7 +493,11 @@ export function scanArtifactBytes(input) {
         addFinding(findings, "info", "static_scan_clean", "Static inspection found no configured danger signal.");
     }
     const danger = computeDanger(findings);
-    const artifactState = danger.level === "blocked" ? "blocked" : danger.level === "high" ? "quarantined" : "active";
+    const artifactState = danger.level === "blocked"
+        ? "blocked"
+        : danger.level === "high"
+            ? "quarantined"
+            : "active";
     return {
         detectedExtension,
         detectedMimeType,
@@ -532,31 +562,66 @@ function mapArtifact(row, links = []) {
         updatedAt: row.updated_at
     };
 }
-function getArtifactRow(id) {
-    return getDatabase()
-        .prepare(`SELECT id, title, short_description, description, original_file_name,
+const ARTIFACT_SELECT_COLUMNS = `id, title, short_description, description, original_file_name,
               storage_key, storage_path, content_sha256, byte_size,
               detected_extension, declared_mime_type, detected_mime_type,
               format_family, source_kind, source_label, uploaded_by_user_id,
               uploaded_by_agent_id, acting_for_user_id, artifact_state,
               danger_score, danger_level, download_policy, scan_results_json,
-              enrichment_results_json, metadata_json, created_at, updated_at
+              enrichment_results_json, metadata_json, created_at, updated_at`;
+function getArtifactRow(id) {
+    return getDatabase()
+        .prepare(`SELECT ${ARTIFACT_SELECT_COLUMNS}
        FROM artifacts
        WHERE id = ?`)
         .get(id);
 }
-function listArtifactRows() {
-    return getDatabase()
-        .prepare(`SELECT id, title, short_description, description, original_file_name,
-              storage_key, storage_path, content_sha256, byte_size,
-              detected_extension, declared_mime_type, detected_mime_type,
-              format_family, source_kind, source_label, uploaded_by_user_id,
-              uploaded_by_agent_id, acting_for_user_id, artifact_state,
-              danger_score, danger_level, download_policy, scan_results_json,
-              enrichment_results_json, metadata_json, created_at, updated_at
-       FROM artifacts
-       ORDER BY updated_at DESC`)
-        .all();
+function buildArtifactListWhere(parsed) {
+    const clauses = [
+        `NOT EXISTS (
+       SELECT 1
+       FROM deleted_entities
+       WHERE deleted_entities.entity_type = 'artifact'
+         AND deleted_entities.entity_id = artifacts.id
+     )`
+    ];
+    const params = [];
+    if (parsed.artifactState) {
+        clauses.push("artifacts.artifact_state = ?");
+        params.push(parsed.artifactState);
+    }
+    if (parsed.dangerLevel) {
+        clauses.push("artifacts.danger_level = ?");
+        params.push(parsed.dangerLevel);
+    }
+    if (parsed.formatFamily) {
+        clauses.push("artifacts.format_family = ?");
+        params.push(parsed.formatFamily);
+    }
+    if (parsed.query) {
+        const needle = `%${parsed.query.toLowerCase()}%`;
+        clauses.push(`(
+      LOWER(COALESCE(artifacts.title, '')) LIKE ?
+      OR LOWER(COALESCE(artifacts.short_description, '')) LIKE ?
+      OR LOWER(COALESCE(artifacts.description, '')) LIKE ?
+      OR LOWER(COALESCE(artifacts.original_file_name, '')) LIKE ?
+      OR LOWER(COALESCE(artifacts.source_label, '')) LIKE ?
+      OR LOWER(COALESCE(artifacts.metadata_json, '')) LIKE ?
+    )`);
+        params.push(needle, needle, needle, needle, needle, needle);
+    }
+    if (parsed.linkedEntityType && parsed.linkedEntityId) {
+        clauses.push(`EXISTS (
+      SELECT 1
+      FROM entity_links artifact_link_filter
+      WHERE artifact_link_filter.source_entity_type = 'artifact'
+        AND artifact_link_filter.source_entity_id = artifacts.id
+        AND artifact_link_filter.target_entity_type = ?
+        AND artifact_link_filter.target_entity_id = ?
+    )`);
+        params.push(parsed.linkedEntityType, parsed.linkedEntityId);
+    }
+    return { sql: clauses.join(" AND "), params };
 }
 function toEventMetadata(metadata) {
     const normalized = {};
@@ -612,7 +677,10 @@ function insertArtifactVersion(input) {
 }
 function deriveFallbackTitle(originalFileName) {
     const sanitized = sanitizeFileName(originalFileName);
-    return sanitized.replace(/\.[^.]+$/, "").replace(/[_-]+/g, " ").trim() || "Artifact";
+    return (sanitized
+        .replace(/\.[^.]+$/, "")
+        .replace(/[_-]+/g, " ")
+        .trim() || "Artifact");
 }
 export async function createArtifactFromUpload(input, context, services = {}) {
     const parsed = artifactUploadSchema.parse(input);
@@ -628,7 +696,8 @@ export async function createArtifactFromUpload(input, context, services = {}) {
     const blob = await ensureBlobStored(buffer, scan.detectedMimeType);
     const id = artifactId();
     const createdAt = nowIso();
-    const sourceKind = parsed.sourceKind ?? (context.source === "agent" ? "agent_upload" : "upload");
+    const sourceKind = parsed.sourceKind ??
+        (context.source === "agent" ? "agent_upload" : "upload");
     const uploadedByAgentId = parsed.uploadedByAgentId ?? context.token?.agentId ?? null;
     const metadata = {
         ...parsed.metadata,
@@ -690,38 +759,37 @@ export async function createArtifactFromUpload(input, context, services = {}) {
 export function createArtifactMetadata() {
     throw new Error("Use POST /api/v1/artifacts for artifact creation. Batch CRUD may search, link, update metadata, delete, and restore artifact records, but it must not create file artifacts.");
 }
-export function listArtifacts(input = {}) {
+export function listArtifactsPage(input = {}) {
     const parsed = artifactListQuerySchema.parse(input);
-    const rows = filterDeletedEntities("artifact", listArtifactRows());
+    const where = buildArtifactListWhere(parsed);
+    const totalRow = getDatabase()
+        .prepare(`SELECT COUNT(*) AS total FROM artifacts WHERE ${where.sql}`)
+        .get(...where.params);
+    const rows = getDatabase()
+        .prepare(`SELECT ${ARTIFACT_SELECT_COLUMNS}
+       FROM artifacts
+       WHERE ${where.sql}
+       ORDER BY updated_at DESC, id ASC
+       LIMIT ? OFFSET ?`)
+        .all(...where.params, parsed.limit, parsed.offset);
     const linksByArtifactId = new Map();
     for (const linkRow of listEntityLinksForSources("artifact", rows.map((row) => row.id))) {
         const current = linksByArtifactId.get(linkRow.sourceEntityId) ?? [];
         current.push(mapLink(linkRow));
         linksByArtifactId.set(linkRow.sourceEntityId, current);
     }
-    const query = parsed.query?.toLowerCase() ?? "";
-    return rows
-        .map((row) => mapArtifact(row, linksByArtifactId.get(row.id) ?? []))
-        .filter((artifact) => parsed.artifactState ? artifact.artifactState === parsed.artifactState : true)
-        .filter((artifact) => parsed.dangerLevel ? artifact.dangerLevel === parsed.dangerLevel : true)
-        .filter((artifact) => parsed.formatFamily ? artifact.formatFamily === parsed.formatFamily : true)
-        .filter((artifact) => query
-        ? JSON.stringify({
-            title: artifact.title,
-            shortDescription: artifact.shortDescription,
-            description: artifact.description,
-            originalFileName: artifact.originalFileName,
-            sourceLabel: artifact.sourceLabel,
-            metadata: artifact.metadata
-        })
-            .toLowerCase()
-            .includes(query)
-        : true)
-        .filter((artifact) => parsed.linkedEntityType && parsed.linkedEntityId
-        ? artifact.links.some((link) => link.targetEntityType === parsed.linkedEntityType &&
-            link.targetEntityId === parsed.linkedEntityId)
-        : true)
-        .slice(0, parsed.limit);
+    const artifacts = rows.map((row) => mapArtifact(row, linksByArtifactId.get(row.id) ?? []));
+    const total = totalRow?.total ?? 0;
+    return {
+        artifacts,
+        total,
+        limit: parsed.limit,
+        offset: parsed.offset,
+        hasMore: parsed.offset + artifacts.length < total
+    };
+}
+export function listArtifacts(input = {}) {
+    return listArtifactsPage(input).artifacts;
 }
 export function getArtifactById(id) {
     if (isEntityDeleted("artifact", id)) {
@@ -743,12 +811,13 @@ export function updateArtifactMetadata(id, input, context) {
     const nextMetadata = parsed.metadata
         ? { ...existing.metadata, ...parsed.metadata }
         : existing.metadata;
-    const nextLinks = parsed.links ?? existing.links.map((link) => ({
-        entityType: link.targetEntityType,
-        entityId: link.targetEntityId,
-        anchorKey: link.anchorKey ?? "",
-        relationship: link.relationship
-    }));
+    const nextLinks = parsed.links ??
+        existing.links.map((link) => ({
+            entityType: link.targetEntityType,
+            entityId: link.targetEntityId,
+            anchorKey: link.anchorKey ?? "",
+            relationship: link.relationship
+        }));
     runInTransaction(() => {
         getDatabase()
             .prepare(`UPDATE artifacts
@@ -799,7 +868,8 @@ export async function readArtifactDownload(id) {
     if (!artifact) {
         return null;
     }
-    if (artifact.downloadPolicy !== "human_only" || artifact.artifactState === "blocked") {
+    if (artifact.downloadPolicy !== "human_only" ||
+        artifact.artifactState === "blocked") {
         throw new Error("This artifact is not downloadable in its current state.");
     }
     const storagePath = resolveStoragePath(artifact.storageKey);

package/dist/server/apps/web/src/lib/api.js

@@ -911,6 +911,9 @@ export async function listArtifacts(options = {}) {
     if (options.limit) {
         search.set("limit", String(options.limit));
     }
+    if (typeof options.offset === "number") {
+        search.set("offset", String(options.offset));
+    }
     const suffix = search.size > 0 ? `?${search.toString()}` : "";
     return request(`/api/v1/artifacts${suffix}`);
 }

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "activation": {
     "onStartup": true,
     "onCapabilities": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "Apache-2.0",