forge-openclaw-plugin 0.3.16 → 0.3.18

package/dist/assets/workout-detail-page-BwfEhxA_.js

@@ -0,0 +1,2 @@
+const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["assets/maps-Dk9tZqTA.js","assets/vendor-y_uz1Wft.js","assets/vendor-CRS-psbw.css","assets/maps-B-YMMjus.css"])))=>i.map(i=>d[i]);
+import{S as D,e as P,j,C as c,T as B,I as H,B as E,ec as I,ea as K,ed as W}from"./index-Dj8q65se.js";import{b_ as Q,r as h,j as e,aC as O,cP as q,bt as Z,bC as Y,dz as G,cs as U}from"./vendor-y_uz1Wft.js";import{j as V,i as X,k as J}from"./state-DWw8Jay_.js";import"./maps-Dk9tZqTA.js";import{P as ee}from"./page-hero-DYmFM6-q.js";import{R as C,A as te,C as ae,X as T,Y as _,T as z,a as se,e as ie,B as re}from"./charts-Cdtn55ol.js";import"./motion-DeJZhOSA.js";import"./ui-CdEDMtXF.js";import"./board-CGgOvBP9.js";import"./forms-DhEGHkFR.js";const A={below_z1:"#94a3b8",zone_1:"#38bdf8",zone_2:"#22c55e",zone_3:"#eab308",zone_4:"#f97316",zone_5:"#ef4444"};function k(t){return t?`${Math.round(t/60)}m`:"0m"}function F(t,s){const o=new Intl.DateTimeFormat(void 0,{weekday:"short",day:"numeric",month:"short"}),n=new Intl.DateTimeFormat(void 0,{hour:"2-digit",minute:"2-digit"});return`${o.format(new Date(t))} · ${n.format(new Date(t))} - ${n.format(new Date(s))}`}function $(t){const s=typeof t=="number"?Math.floor(t):Number.parseFloat(String(t??""));return Number.isFinite(s)?new Date(s).toLocaleTimeString([],{hour:"2-digit",minute:"2-digit"}):""}function ne(t,s){if(typeof t=="number"){const o=Number.isInteger(t)?String(t):t.toFixed(1);return s&&s!=="count"?`${o} ${s}`:o}return typeof t=="boolean"?t?"Yes":"No":t==null?"n/a":String(t)}function oe(t){return t.length===0?null:{minLat:Math.min(...t.map(s=>s.latitude)),maxLat:Math.max(...t.map(s=>s.latitude)),minLon:Math.min(...t.map(s=>s.longitude)),maxLon:Math.max(...t.map(s=>s.longitude))}}function le({points:t}){var g;const s=h.useRef(null),[o,n]=h.useState(!1),u=typeof window<"u"?((g=window.localStorage.getItem("forge.map.tile-url"))==null?void 0:g.trim())??"":"";h.useEffect(()=>{let x=!1,i=null;if(!u||!s.current||t.length<2){n(!1);return}return I(()=>import("./maps-Dk9tZqTA.js").then(r=>r.m),__vite__mapDeps([0,1,2,3])).then(r=>{x||!s.current||(i=new r.Map({container:s.current,style:{version:8,sources:{tiles:{type:"raster",tiles:[u],tileSize:256}},layers:[{id:"tiles",type:"raster",source:"tiles"}]},center:[t[0].longitude,t[0].latitude],zoom:13,attributionControl:!1}),i.on("load",()=>{if(!i)return;const d=t.map(m=>[m.longitude,m.latitude]);i.addSource("route",{type:"geojson",data:{type:"Feature",properties:{},geometry:{type:"LineString",coordinates:d}}}),i.addLayer({id:"route",type:"line",source:"route",paint:{"line-color":"#f97316","line-width":4}});const f=d.reduce((m,p)=>m.extend(p),new r.LngLatBounds(d[0],d[0]));i.fitBounds(f,{padding:44,maxZoom:15}),n(!0)}))}),()=>{x=!0,i==null||i.remove()}},[t,u]);const l=oe(t),v=h.useMemo(()=>{if(!l||t.length<2)return"";const x=720,i=280,r=Math.max(1e-6,l.maxLon-l.minLon),d=Math.max(1e-6,l.maxLat-l.minLat);return t.map(f=>{const m=(f.longitude-l.minLon)/r*x,p=i-(f.latitude-l.minLat)/d*i;return`${m.toFixed(1)},${p.toFixed(1)}`}).join(" ")},[l,t]);return e.jsxs("div",{className:"relative min-h-[280px] overflow-hidden rounded-[8px] border border-[var(--ui-border-subtle)] bg-[var(--ui-surface-1)]",children:[e.jsx("div",{ref:s,className:"absolute inset-0"}),o?null:e.jsxs("svg",{viewBox:"0 0 720 280",className:"absolute inset-0 h-full w-full",children:[e.jsx("rect",{width:"720",height:"280",fill:"var(--ui-surface-1)"}),v?e.jsx("polyline",{points:v,fill:"none",stroke:"#f97316",strokeWidth:"5",strokeLinecap:"round",strokeLinejoin:"round"}):null]}),e.jsx("div",{className:"absolute left-3 top-3 max-w-[calc(100%-1.5rem)] rounded-[8px] border border-[var(--ui-border-subtle)] bg-[var(--surface-glass)] px-3 py-2 text-xs text-[var(--ui-ink-medium)] backdrop-blur",children:u?"Local-first map tiles configured":"No tile source configured; showing private route shape only"})]})}function de({zones:t}){return e.jsx("div",{className:"grid gap-3",children:t.map(s=>e.jsxs("div",{className:"grid gap-2",children:[e.jsxs("div",{className:"flex flex-wrap items-center justify-between gap-3 text-sm",children:[e.jsx("span",{className:"min-w-0 break-words text-[var(--ui-ink-medium)] [overflow-wrap:anywhere]",children:s.label}),e.jsxs("span",{className:"shrink-0 text-[var(--ui-ink-strong)]",children:[(s.percentage*100).toFixed(1),"% · ",k(s.seconds)]})]}),e.jsx("div",{className:"h-2 overflow-hidden rounded-full bg-[var(--ui-surface-2)]",children:e.jsx("div",{className:"h-full rounded-full",style:{width:`${Math.max(1,s.percentage*100)}%`,background:A[s.key]??"#f8fafc"}})})]},s.key))})}function we(){var p,y,N,b,S,L,R,M;const{workoutId:t=""}=Q(),s=V(),o=X({queryKey:["workout-detail",t],queryFn:()=>W(t),enabled:t.length>0}),n=o.data,[u,l]=h.useState(""),[v,g]=h.useState("");h.useEffect(()=>{n!=null&&n.workout&&(l(n.workout.meaningText??""),g(n.workout.tags.join(", ")))},[n==null?void 0:n.workout]);const x=J({mutationFn:()=>K(t,{meaningText:u,tags:v.split(",").map(a=>a.trim()).filter(Boolean)}),onSuccess:async()=>{await s.invalidateQueries({queryKey:["workout-detail",t]}),await s.invalidateQueries({queryKey:["forge-fitness"]})}});if(o.isLoading)return e.jsx(D,{title:"Loading workout"});if(o.isError||!n)return e.jsx(P,{eyebrow:"Workout detail",error:o.error??new Error("Forge could not load this workout detail."),onRetry:()=>void o.refetch()});const{workout:i,analytics:r,evidence:d}=n,f=d.timeSeries.filter(a=>a.metricKey==="heart_rate").map((a,w)=>({time:Date.parse(a.startedAt)+w/1e3,bpm:a.value})),m=r.zoneDurations.map(a=>({zone:a.label,minutes:Math.round(a.seconds/60),fill:A[a.key]??"#f8fafc"}));return e.jsxs("div",{className:"grid gap-6",children:[e.jsxs(O,{to:"/sports",className:"inline-flex w-fit items-center gap-2 text-sm text-[var(--ui-ink-soft)] transition hover:text-[var(--ui-ink-strong)]",children:[e.jsx(q,{className:"size-4"}),"Back to sports"]}),e.jsx(ee,{eyebrow:"Workout evidence",title:i.workoutTypeLabel??i.workoutType,description:`${F(i.startedAt,i.endedAt)} · ${i.sourceDevice||"Apple Health"}`,actions:e.jsxs("div",{className:"flex flex-wrap gap-2",children:[e.jsx(j,{children:k(i.durationSeconds)}),e.jsxs(j,{tone:"meta",children:[r.confidence," HR zones"]}),(p=r.routeSummary)!=null&&p.hasRoute?e.jsxs(j,{tone:"meta",children:[r.routeSummary.pointCount," route points"]}):null]})}),e.jsxs("section",{className:"grid gap-4 lg:grid-cols-4",children:[e.jsxs(c,{children:[e.jsx("div",{className:"text-sm text-[var(--ui-ink-soft)]",children:"Avg HR"}),e.jsx("div",{className:"mt-3 font-display text-4xl text-[var(--ui-ink-strong)]",children:r.hrSummary.averageHr??i.averageHeartRate??"n/a"}),e.jsx("div",{className:"mt-1 text-sm text-[var(--ui-ink-faint)]",children:"bpm"})]}),e.jsxs(c,{children:[e.jsx("div",{className:"text-sm text-[var(--ui-ink-soft)]",children:"Max HR"}),e.jsx("div",{className:"mt-3 font-display text-4xl text-[var(--ui-ink-strong)]",children:r.hrSummary.maxHr??i.maxHeartRate??"n/a"}),e.jsx("div",{className:"mt-1 text-sm text-[var(--ui-ink-faint)]",children:"bpm"})]}),e.jsxs(c,{children:[e.jsx("div",{className:"text-sm text-[var(--ui-ink-soft)]",children:"Training load"}),e.jsx("div",{className:"mt-3 font-display text-4xl text-[var(--ui-ink-strong)]",children:r.load.trimp??"n/a"}),e.jsx("div",{className:"mt-1 text-sm text-[var(--ui-ink-faint)]",children:"Forge TRIMP"})]}),e.jsxs(c,{children:[e.jsx("div",{className:"text-sm text-[var(--ui-ink-soft)]",children:"HR coverage"}),e.jsxs("div",{className:"mt-3 font-display text-4xl text-[var(--ui-ink-strong)]",children:[Math.round((r.dataQuality.sampleCoverage??0)*100),"%"]}),e.jsxs("div",{className:"mt-1 text-sm text-[var(--ui-ink-faint)]",children:[r.dataQuality.heartRateSampleCount??0," samples"]})]})]}),e.jsxs("section",{className:"grid min-w-0 gap-4 xl:grid-cols-[minmax(0,1.25fr)_minmax(280px,0.75fr)]",children:[e.jsxs(c,{className:"min-h-[360px] min-w-0 overflow-hidden",children:[e.jsxs("div",{className:"flex items-center gap-2 text-[var(--ui-ink-strong)]",children:[e.jsx(Z,{className:"size-4 text-[var(--primary)]"}),"Heart-rate timeline"]}),e.jsx("div",{className:"mt-4 h-[300px]",children:f.length>0?e.jsx(C,{width:"100%",height:"100%",children:e.jsxs(te,{data:f,children:[e.jsx("defs",{children:e.jsxs("linearGradient",{id:"hrFill",x1:"0",y1:"0",x2:"0",y2:"1",children:[e.jsx("stop",{offset:"0%",stopColor:"#ef4444",stopOpacity:.38}),e.jsx("stop",{offset:"100%",stopColor:"#ef4444",stopOpacity:.04})]})}),e.jsx(ae,{stroke:"var(--ui-border-subtle)",vertical:!1}),e.jsx(T,{dataKey:"time",interval:"preserveStartEnd",tick:{fill:"var(--ui-ink-soft)",fontSize:11},tickFormatter:$,type:"number",domain:["dataMin","dataMax"]}),e.jsx(_,{tick:{fill:"var(--ui-ink-soft)",fontSize:11},width:42}),e.jsx(z,{labelFormatter:$,contentStyle:{background:"var(--surface-glass)",border:"1px solid var(--ui-border-subtle)",borderRadius:8,color:"var(--ui-ink-strong)"}}),e.jsx(se,{type:"monotone",dataKey:"bpm",stroke:"#ef4444",fill:"url(#hrFill)",strokeWidth:2,dot:!1})]})}):e.jsx("div",{className:"grid h-full place-items-center rounded-[8px] bg-[var(--ui-surface-1)] text-sm text-[var(--ui-ink-soft)]",children:"No raw HR timeline has been synced for this workout yet."})})]}),e.jsxs(c,{className:"min-w-0 overflow-hidden",children:[e.jsxs("div",{className:"flex items-center gap-2 text-[var(--ui-ink-strong)]",children:[e.jsx(Y,{className:"size-4 text-[var(--primary)]"}),"Zone mix"]}),e.jsx("div",{className:"mt-4",children:e.jsx(de,{zones:r.zoneDurations})}),e.jsx("div",{className:"mt-5 h-[180px]",children:e.jsx(C,{width:"100%",height:"100%",children:e.jsxs(ie,{data:m,children:[e.jsx(T,{dataKey:"zone",tick:{fill:"var(--ui-ink-soft)",fontSize:10}}),e.jsx(_,{tick:{fill:"var(--ui-ink-soft)",fontSize:10},width:34}),e.jsx(z,{contentStyle:{background:"var(--surface-glass)",border:"1px solid var(--ui-border-subtle)",borderRadius:8,color:"var(--ui-ink-strong)"}}),e.jsx(re,{dataKey:"minutes",radius:[4,4,0,0]})]})})})]})]}),e.jsxs("section",{className:"grid min-w-0 gap-4 xl:grid-cols-[minmax(0,1fr)_360px]",children:[e.jsxs(c,{className:"min-w-0 overflow-hidden",children:[e.jsxs("div",{className:"flex items-center gap-2 text-[var(--ui-ink-strong)]",children:[e.jsx(G,{className:"size-4 text-[var(--primary)]"}),"Route"]}),e.jsx("div",{className:"mt-4",children:d.routePoints.length>1?e.jsx(le,{points:d.routePoints}):e.jsx("div",{className:"grid min-h-[240px] place-items-center rounded-[8px] bg-[var(--ui-surface-1)] text-sm text-[var(--ui-ink-soft)]",children:"No route evidence is available for this workout."})})]}),e.jsxs(c,{className:"min-w-0 overflow-hidden",children:[e.jsx("div",{className:"text-[var(--ui-ink-strong)]",children:"Captured metrics"}),e.jsx("div",{className:"mt-4 grid gap-3",children:(((y=i.details)==null?void 0:y.metrics)??[]).slice(0,14).map(a=>e.jsxs("div",{className:"min-w-0 rounded-[8px] bg-[var(--ui-surface-1)] px-3 py-2",children:[e.jsx("div",{className:"break-words text-sm text-[var(--ui-ink-soft)] [overflow-wrap:anywhere]",children:a.label}),e.jsx("div",{className:"mt-1 break-words text-[var(--ui-ink-strong)] [overflow-wrap:anywhere]",children:ne(a.value,a.unit)})]},`${a.category}:${a.key}:${a.statistic}`))})]})]}),e.jsxs("section",{className:"grid min-w-0 gap-4 lg:grid-cols-[minmax(0,1fr)_minmax(280px,0.7fr)]",children:[e.jsxs(c,{className:"min-w-0 overflow-hidden",children:[e.jsx("div",{className:"text-[var(--ui-ink-strong)]",children:"Events and phases"}),e.jsxs("div",{className:"mt-4 grid gap-3",children:[[...((N=i.details)==null?void 0:N.events)??[],...((b=i.details)==null?void 0:b.components)??[]].slice(0,18).map((a,w)=>e.jsxs("div",{className:"min-w-0 rounded-[8px] bg-[var(--ui-surface-1)] px-4 py-3",children:[e.jsxs("div",{className:"flex flex-wrap items-center justify-between gap-3",children:[e.jsx("div",{className:"min-w-0 break-words text-[var(--ui-ink-strong)] [overflow-wrap:anywhere]",children:"label"in a?a.label:a.activity.canonicalLabel}),e.jsx(j,{tone:"meta",children:k(a.durationSeconds)})]}),e.jsx("div",{className:"mt-1 text-sm text-[var(--ui-ink-soft)]",children:F(a.startedAt,a.endedAt??a.startedAt)})]},`${"type"in a?a.type:a.externalUid}:${a.startedAt}:${w}`)),(((L=(S=i.details)==null?void 0:S.events)==null?void 0:L.length)??0)+(((M=(R=i.details)==null?void 0:R.components)==null?void 0:M.length)??0)===0?e.jsx("div",{className:"rounded-[8px] bg-[var(--ui-surface-1)] p-4 text-sm text-[var(--ui-ink-soft)]",children:"No provider events or phases were captured."}):null]})]}),e.jsxs(c,{className:"min-w-0 overflow-hidden",children:[e.jsx("div",{className:"text-[var(--ui-ink-strong)]",children:"Reflection"}),e.jsxs("div",{className:"mt-4 grid gap-4",children:[e.jsxs("label",{className:"grid gap-2",children:[e.jsx("span",{className:"text-sm text-[var(--ui-ink-soft)]",children:"Meaning and impact"}),e.jsx(B,{className:"min-h-[160px]",value:u,onChange:a=>l(a.target.value)})]}),e.jsxs("label",{className:"grid gap-2",children:[e.jsx("span",{className:"text-sm text-[var(--ui-ink-soft)]",children:"Tags"}),e.jsx(H,{value:v,onChange:a=>g(a.target.value)})]}),e.jsxs(E,{type:"button",pending:x.isPending,pendingLabel:"Saving",onClick:()=>x.mutate(),children:[e.jsx(U,{className:"size-4"}),"Save reflection"]})]})]})]})]})}export{we as WorkoutDetailPage};

package/dist/index.html

@@ -130,15 +130,15 @@
         }
       }
     </style>
-    <script type="module" crossorigin src="/forge/assets/index-izRKx6JK.js"></script>
-    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-BwL6m4SE.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/state-Bpe5dF3T.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/motion-DcgUnXhY.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/ui-B9TWEtCx.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/board-CuxQRKPJ.js">
-    <link rel="modulepreload" crossorigin href="/forge/assets/forms-D1qJ3oOP.js">
+    <script type="module" crossorigin src="/forge/assets/index-Dj8q65se.js"></script>
+    <link rel="modulepreload" crossorigin href="/forge/assets/vendor-y_uz1Wft.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/state-DWw8Jay_.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/motion-DeJZhOSA.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/ui-CdEDMtXF.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/board-CGgOvBP9.js">
+    <link rel="modulepreload" crossorigin href="/forge/assets/forms-DhEGHkFR.js">
     <link rel="stylesheet" crossorigin href="/forge/assets/vendor-CRS-psbw.css">
-    <link rel="stylesheet" crossorigin href="/forge/assets/index-VzCGTBS_.css">
+    <link rel="stylesheet" crossorigin href="/forge/assets/index-CHbe1sy1.css">
   </head>
   <body class="bg-canvas text-ink antialiased">
     <div id="root">

package/dist/openclaw/parity.d.ts

@@ -2,7 +2,7 @@ export type ApiRouteKey = `${Uppercase<string>} ${string}`;
 export type ForgeSupportedPluginApiRoute = {
     method: Uppercase<string>;
     path: string;
-    purpose: "diagnostics" | "calendar" | "overview" | "operator_context" | "onboarding" | "psyche" | "xp" | "weekly_review" | "entities" | "work" | "insights" | "wiki" | "health" | "movement" | "life_force" | "workbench" | "preferences" | "questionnaires";
+    purpose: "diagnostics" | "calendar" | "overview" | "operator_context" | "onboarding" | "psyche" | "xp" | "weekly_review" | "entities" | "work" | "insights" | "wiki" | "health" | "movement" | "life_force" | "workbench" | "artifact" | "preferences" | "questionnaires";
 };
 export declare const FORGE_SUPPORTED_PLUGIN_API_ROUTES: ForgeSupportedPluginApiRoute[];
 export declare function makeApiRouteKey(method: string, path: string): ApiRouteKey;

package/dist/openclaw/parity.js

@@ -143,6 +143,16 @@ export const FORGE_SUPPORTED_PLUGIN_API_ROUTES = [
         path: "/api/v1/workbench/flows/:id/nodes/:nodeId/output",
         purpose: "workbench"
     },
+    { method: "GET", path: "/api/v1/artifacts", purpose: "artifact" },
+    { method: "POST", path: "/api/v1/artifacts", purpose: "artifact" },
+    { method: "GET", path: "/api/v1/artifacts/:id", purpose: "artifact" },
+    { method: "PATCH", path: "/api/v1/artifacts/:id", purpose: "artifact" },
+    { method: "POST", path: "/api/v1/artifacts/:id/scan", purpose: "artifact" },
+    { method: "POST", path: "/api/v1/artifacts/:id/enrich", purpose: "artifact" },
+    { method: "POST", path: "/api/v1/artifacts/:id/links", purpose: "artifact" },
+    { method: "POST", path: "/api/v1/artifacts/:id/trust", purpose: "artifact" },
+    { method: "GET", path: "/api/v1/artifacts/:id/versions", purpose: "artifact" },
+    { method: "GET", path: "/api/v1/artifacts/:id/audit", purpose: "artifact" },
     { method: "GET", path: "/api/v1/calendar/overview", purpose: "calendar" },
     {
         method: "GET",

package/dist/openclaw/routes.js

@@ -499,6 +499,84 @@ export const FORGE_PLUGIN_ROUTE_GROUPS = [
             }
         ]
     },
+    {
+        path: "/forge/v1/artifacts",
+        match: "prefix",
+        operations: [
+            {
+                method: "GET",
+                pattern: /^\/forge\/v1\/artifacts$/,
+                upstreamPath: "/api/v1/artifacts",
+                target: (_match, url) => passthroughSearch("/api/v1/artifacts", url)
+            },
+            {
+                method: "POST",
+                pattern: /^\/forge\/v1\/artifacts$/,
+                upstreamPath: "/api/v1/artifacts",
+                requestBody: "json",
+                requiresToken: true,
+                target: (_match, url) => passthroughSearch("/api/v1/artifacts", url)
+            },
+            {
+                method: "GET",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)$/,
+                upstreamPath: "/api/v1/artifacts/:id",
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}`, url)
+            },
+            {
+                method: "PATCH",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)$/,
+                upstreamPath: "/api/v1/artifacts/:id",
+                requestBody: "json",
+                requiresToken: true,
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}`, url)
+            },
+            {
+                method: "POST",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)\/scan$/,
+                upstreamPath: "/api/v1/artifacts/:id/scan",
+                requestBody: "json",
+                requiresToken: true,
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}/scan`, url)
+            },
+            {
+                method: "POST",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)\/enrich$/,
+                upstreamPath: "/api/v1/artifacts/:id/enrich",
+                requestBody: "json",
+                requiresToken: true,
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}/enrich`, url)
+            },
+            {
+                method: "POST",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)\/links$/,
+                upstreamPath: "/api/v1/artifacts/:id/links",
+                requestBody: "json",
+                requiresToken: true,
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}/links`, url)
+            },
+            {
+                method: "POST",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)\/trust$/,
+                upstreamPath: "/api/v1/artifacts/:id/trust",
+                requestBody: "json",
+                requiresToken: true,
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}/trust`, url)
+            },
+            {
+                method: "GET",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)\/versions$/,
+                upstreamPath: "/api/v1/artifacts/:id/versions",
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}/versions`, url)
+            },
+            {
+                method: "GET",
+                pattern: /^\/forge\/v1\/artifacts\/([^/]+)\/audit$/,
+                upstreamPath: "/api/v1/artifacts/:id/audit",
+                target: (match, url) => passthroughSearch(`/api/v1/artifacts/${match[1]}/audit`, url)
+            }
+        ]
+    },
     {
         path: "/forge/v1/calendar",
         match: "prefix",

package/dist/openclaw/tools.js

@@ -232,6 +232,42 @@ const workbenchRouteSpecs = {
         path: "/api/v1/workbench/flows/:id/nodes/:nodeId/output"
     }
 };
+const artifactRouteSpecs = {
+    list: { method: "GET", path: "/api/v1/artifacts" },
+    createWithBytes: {
+        method: "POST",
+        path: "/api/v1/artifacts",
+        requiresToken: true
+    },
+    readMetadata: { method: "GET", path: "/api/v1/artifacts/:id" },
+    updateMetadata: {
+        method: "PATCH",
+        path: "/api/v1/artifacts/:id",
+        requiresToken: true
+    },
+    rescan: {
+        method: "POST",
+        path: "/api/v1/artifacts/:id/scan",
+        requiresToken: true
+    },
+    enrichWithLlm: {
+        method: "POST",
+        path: "/api/v1/artifacts/:id/enrich",
+        requiresToken: true
+    },
+    replaceGenericLinks: {
+        method: "POST",
+        path: "/api/v1/artifacts/:id/links",
+        requiresToken: true
+    },
+    trustState: {
+        method: "POST",
+        path: "/api/v1/artifacts/:id/trust",
+        requiresToken: true
+    },
+    versions: { method: "GET", path: "/api/v1/artifacts/:id/versions" },
+    audit: { method: "GET", path: "/api/v1/artifacts/:id/audit" }
+};
 const optionalString = () => Type.Optional(Type.String());
 const optionalNullableString = () => Type.Optional(Type.Union([Type.String(), Type.Null()]));
 const optionalDeleteMode = () => Type.Optional(Type.Union([Type.Literal("soft"), Type.Literal("hard")]));
@@ -578,6 +614,12 @@ export function registerForgePluginTools(api, config) {
         description: "Call one allowed dedicated Workbench route after the conversation has narrowed to flow catalog, flow CRUD, execution, run history, published output, node result, or latest node output. Do not use batch CRUD for Workbench.",
         routeSpecs: workbenchRouteSpecs
     });
+    registerSpecializedRouteTool(api, config, {
+        name: "forge_call_artifact_route",
+        label: "Forge Artifact Route",
+        description: "Call one allowed dedicated Artifact Store route for metadata listing, trusted upload, metadata update, static rescan, LLM metadata enrichment, generic entity-link replacement, trust state, versions, or audit. Do not expose download, open, execute, preview, or transform stored file bytes as an agent.",
+        routeSpecs: artifactRouteSpecs
+    });
     registerReadTool(api, config, {
         name: "forge_get_user_directory",
         label: "Forge User Directory",

package/dist/server/apps/api/migrations/072_artifact_store.sql

@@ -0,0 +1,106 @@
+CREATE TABLE IF NOT EXISTS artifact_blobs (
+  content_sha256 TEXT PRIMARY KEY,
+  storage_key TEXT NOT NULL UNIQUE,
+  byte_size INTEGER NOT NULL,
+  detected_mime_type TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS artifacts (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  short_description TEXT NOT NULL DEFAULT '',
+  description TEXT NOT NULL DEFAULT '',
+  original_file_name TEXT NOT NULL,
+  storage_key TEXT NOT NULL,
+  storage_path TEXT NOT NULL,
+  content_sha256 TEXT NOT NULL,
+  byte_size INTEGER NOT NULL,
+  detected_extension TEXT NOT NULL,
+  declared_mime_type TEXT NOT NULL DEFAULT '',
+  detected_mime_type TEXT NOT NULL DEFAULT '',
+  format_family TEXT NOT NULL,
+  source_kind TEXT NOT NULL DEFAULT 'upload',
+  source_label TEXT NOT NULL DEFAULT '',
+  uploaded_by_user_id TEXT,
+  uploaded_by_agent_id TEXT,
+  acting_for_user_id TEXT,
+  artifact_state TEXT NOT NULL DEFAULT 'active',
+  danger_score INTEGER NOT NULL DEFAULT 0,
+  danger_level TEXT NOT NULL DEFAULT 'low',
+  download_policy TEXT NOT NULL DEFAULT 'human_only',
+  scan_results_json TEXT NOT NULL DEFAULT '{}',
+  enrichment_results_json TEXT NOT NULL DEFAULT '{}',
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY (content_sha256) REFERENCES artifact_blobs(content_sha256)
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_updated
+  ON artifacts (updated_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_state_danger
+  ON artifacts (artifact_state, danger_level, updated_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_sha
+  ON artifacts (content_sha256, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS artifact_versions (
+  id TEXT PRIMARY KEY,
+  artifact_id TEXT NOT NULL,
+  version_number INTEGER NOT NULL,
+  content_sha256 TEXT NOT NULL,
+  storage_key TEXT NOT NULL,
+  byte_size INTEGER NOT NULL,
+  original_file_name TEXT NOT NULL,
+  scan_results_json TEXT NOT NULL DEFAULT '{}',
+  enrichment_results_json TEXT NOT NULL DEFAULT '{}',
+  created_by_actor TEXT,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (artifact_id) REFERENCES artifacts(id) ON DELETE CASCADE,
+  FOREIGN KEY (content_sha256) REFERENCES artifact_blobs(content_sha256),
+  UNIQUE (artifact_id, version_number)
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_versions_artifact
+  ON artifact_versions (artifact_id, version_number DESC);
+
+CREATE TABLE IF NOT EXISTS entity_links (
+  source_entity_type TEXT NOT NULL,
+  source_entity_id TEXT NOT NULL,
+  target_entity_type TEXT NOT NULL,
+  target_entity_id TEXT NOT NULL,
+  anchor_key TEXT NOT NULL DEFAULT '',
+  relationship TEXT NOT NULL DEFAULT 'related',
+  created_by_actor TEXT,
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (
+    source_entity_type,
+    source_entity_id,
+    target_entity_type,
+    target_entity_id,
+    anchor_key,
+    relationship
+  )
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_links_source
+  ON entity_links (source_entity_type, source_entity_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_entity_links_target
+  ON entity_links (target_entity_type, target_entity_id, created_at DESC);
+
+CREATE TABLE IF NOT EXISTS artifact_audit_events (
+  id TEXT PRIMARY KEY,
+  artifact_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  actor TEXT,
+  source TEXT NOT NULL,
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  FOREIGN KEY (artifact_id) REFERENCES artifacts(id) ON DELETE CASCADE
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifact_audit_events_artifact
+  ON artifact_audit_events (artifact_id, created_at DESC);

package/dist/server/apps/api/migrations/073_artifact_entity_links_repair.sql

@@ -0,0 +1,24 @@
+CREATE TABLE IF NOT EXISTS entity_links (
+  source_entity_type TEXT NOT NULL,
+  source_entity_id TEXT NOT NULL,
+  target_entity_type TEXT NOT NULL,
+  target_entity_id TEXT NOT NULL,
+  anchor_key TEXT NOT NULL DEFAULT '',
+  relationship TEXT NOT NULL DEFAULT 'related',
+  created_by_actor TEXT,
+  created_at TEXT NOT NULL,
+  PRIMARY KEY (
+    source_entity_type,
+    source_entity_id,
+    target_entity_type,
+    target_entity_id,
+    anchor_key,
+    relationship
+  )
+);
+
+CREATE INDEX IF NOT EXISTS idx_entity_links_source
+  ON entity_links (source_entity_type, source_entity_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_entity_links_target
+  ON entity_links (target_entity_type, target_entity_id, created_at DESC);