feat(agent): add typed server API tools

src/routes/chatAuxiliaryRoutes.ts

@@ -85,6 +85,31 @@ export const registerChatAuxiliaryRoutes = (
     res.json(result);
   });
 
+  chatRouter.get("/result-ref/:result_ref", async (req, res) => {
+    const resultRef = req.params.result_ref?.trim();
+    const context = getLocalAgentContext(req);
+    const clientSessionId = typeof req.query.session_id === "string" ? req.query.session_id.trim() : undefined;
+    const offset = Math.max(0, Number.parseInt(String(req.query.offset ?? "0"), 10) || 0);
+    const limit = Math.min(500, Math.max(1, Number.parseInt(String(req.query.limit ?? "100"), 10) || 100));
+    if (!resultRef || !clientSessionId) {
+      res.status(400).json({ message: "result_ref and session_id are required" });
+      return;
+    }
+    const result = await resultReferenceResolver.getFullAuthorized(resultRef, {
+      actorKey: toActorKey(context.userId), clientSessionId, projectId: context.projectId,
+    }, { expectedKind: RESULT_REFERENCE_KIND.serverApiPayload });
+    if (!result) {
+      res.status(404).json({ message: "result_ref not found" });
+      return;
+    }
+    const rows = Array.isArray(result.data)
+      ? result.data
+      : result.data && typeof result.data === "object" && Array.isArray((result.data as { data?: unknown }).data)
+        ? (result.data as { data: unknown[] }).data
+        : [result.data];
+    res.json({ ...result, data: rows.slice(offset, offset + limit), page: { offset, limit, total: rows.length, has_more: offset + limit < rows.length } });
+  });
+
   chatRouter.post("/abort", async (req, res) => {
     const parsed = abortPayloadSchema.safeParse(req.body);
     if (!parsed.success) {