@agentapplicationprotocol/server 0.5.0 → 0.6.1

package/dist/src/examples/basic/index.js

@@ -54,7 +54,7 @@ const agent = new agent_js_1.Agent("basic-agent", {
 });
 const handler = {
     getMeta() {
-        return { version: 1, agents: [agent.info] };
+        return { agents: [agent.info] };
     },
     createSession(req) {
         const sessionId = `sess_${(0, node_crypto_1.randomUUID)()}`;
@@ -74,16 +74,21 @@ const handler = {
             throw new Error(`Session not found: ${sessionId}`);
         return session.runTurn(req);
     },
-    async getSession(sessionId, history) {
+    async getSession(sessionId) {
+        const session = sessions.get(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        return session.toSessionResponse();
+    },
+    async getSessionHistory(sessionId, type) {
         const session = sessions.get(sessionId);
         if (!session)
             throw new Error(`Session not found: ${sessionId}`);
         // history is never compacted, so compacted and full are the same
-        const historyData = history ? { [history]: session.history } : undefined;
-        return { ...session.toSessionResponse(), history: historyData };
+        return session.history;
     },
     async listSessions() {
-        return { sessions: [...sessions.keys()] };
+        return { sessions: [...sessions.values()].map((s) => s.toSessionResponse()) };
     },
     async deleteSession(sessionId) {
         sessions.delete(sessionId);

package/dist/src/examples/compact-history/index.js

@@ -52,7 +52,7 @@ const agent = new agent_js_1.Agent("compact-history-agent", {
 });
 const handler = {
     getMeta() {
-        return { version: 1, agents: [agent.info] };
+        return { agents: [agent.info] };
     },
     createSession(req) {
         const sessionId = `sess_${(0, node_crypto_1.randomUUID)()}`;
@@ -72,20 +72,20 @@ const handler = {
             throw new Error(`Session not found: ${sessionId}`);
         return session.runTurn(req);
     },
-    async getSession(sessionId, history) {
+    async getSession(sessionId) {
         const session = session_js_1.sessions.get(sessionId);
         if (!session)
             throw new Error(`Session not found: ${sessionId}`);
-        // history exposes both the compacted window and the full uncompacted history
-        const historyData = history === "compacted"
-            ? { compacted: session.history }
-            : history === "full"
-                ? { full: session.fullHistory }
-                : undefined;
-        return { ...session.toSessionResponse(), history: historyData };
+        return session.toSessionResponse();
+    },
+    async getSessionHistory(sessionId, type) {
+        const session = session_js_1.sessions.get(sessionId);
+        if (!session)
+            throw new Error(`Session not found: ${sessionId}`);
+        return type === "compacted" ? session.history : session.fullHistory;
     },
     async listSessions() {
-        return { sessions: [...session_js_1.sessions.keys()] };
+        return { sessions: [...session_js_1.sessions.values()].map((s) => s.toSessionResponse()) };
     },
     async deleteSession(sessionId) {
         session_js_1.sessions.delete(sessionId);

package/dist/src/server.d.ts

@@ -1,11 +1,12 @@
 import { Hono } from "hono";
-import { AgentResponse, CreateSessionRequest, CreateSessionResponse, MetaResponse, SessionListResponse, SessionResponse, SessionTurnRequest, SSEEvent } from "@agentapplicationprotocol/core";
+import { AgentResponse, CreateSessionRequest, CreateSessionResponse, HistoryMessage, MetaResponse, SessionListResponse, SessionResponse, SessionTurnRequest, SSEEvent } from "@agentapplicationprotocol/core";
 export interface Handler {
-    getMeta(): MetaResponse;
+    getMeta(): Omit<MetaResponse, "version">;
     listSessions(params: {
         after?: string;
     }): Promise<SessionListResponse>;
-    getSession(sessionId: string, history?: "compacted" | "full"): Promise<SessionResponse>;
+    getSession(sessionId: string): Promise<SessionResponse>;
+    getSessionHistory(sessionId: string, type: "compacted" | "full"): Promise<HistoryMessage[]>;
     /** The last message in `req.messages` is guaranteed to be a user message. */
     createSession(req: CreateSessionRequest): Promise<CreateSessionResponse> | AsyncIterable<SSEEvent>;
     sendTurn(sessionId: string, req: SessionTurnRequest): Promise<AgentResponse> | AsyncIterable<SSEEvent>;

package/dist/src/server.js

@@ -41,7 +41,7 @@ function redactSecretOptions(session, agents) {
  */
 function aap(handler) {
     const router = new hono_1.Hono();
-    router.get("/meta", (c) => c.json(handler.getMeta()));
+    router.get("/meta", (c) => c.json({ version: 2, ...handler.getMeta() }));
     router.put("/session", async (c) => {
         const req = await c.req.json();
         if (req.messages.at(-1)?.role !== "user")
@@ -61,24 +61,25 @@ function aap(handler) {
         return c.json(result);
     });
     router.get("/session/:id", async (c) => {
-        const historyParam = c.req.query("history");
-        const history = historyParam === "compacted" || historyParam === "full" ? historyParam : undefined;
-        const session = await handler.getSession(c.req.param("id"), history);
-        // strip history fields not matching the requested mode
-        if (session.history) {
-            if (history === "compacted")
-                delete session.history.full;
-            else if (history === "full")
-                delete session.history.compacted;
-            else
-                session.history = undefined;
-        }
-        const meta = handler.getMeta();
-        return c.json(redactSecretOptions(session, meta.agents));
+        const session = await handler.getSession(c.req.param("id"));
+        const { agents } = handler.getMeta();
+        return c.json(redactSecretOptions(session, agents));
+    });
+    router.get("/session/:id/history", async (c) => {
+        const typeParam = c.req.query("type");
+        if (typeParam !== "compacted" && typeParam !== "full")
+            return c.json({ error: 'type must be "compacted" or "full"' }, 400);
+        const messages = await handler.getSessionHistory(c.req.param("id"), typeParam);
+        return c.json({ history: { [typeParam]: messages } });
     });
     router.get("/sessions", async (c) => {
         const after = c.req.query("after");
-        return c.json(await handler.listSessions({ after }));
+        const result = await handler.listSessions({ after });
+        const { agents } = handler.getMeta();
+        return c.json({
+            ...result,
+            sessions: result.sessions.map((s) => redactSecretOptions(s, agents)),
+        });
     });
     router.delete("/session/:id", async (c) => {
         await handler.deleteSession(c.req.param("id"));

package/dist/src/server.test.js

@@ -5,11 +5,11 @@ const hono_1 = require("hono");
 const bearer_auth_1 = require("hono/bearer-auth");
 const cors_1 = require("hono/cors");
 const server_1 = require("./server");
-const meta = { version: 1, agents: [] };
+const meta = { version: 2, agents: [] };
 const session = { sessionId: "s1", agent: { name: "a" } };
 const agentResponse = { stopReason: "end_turn", messages: [] };
 const createSessionResponse = { ...agentResponse, sessionId: "s1" };
-const sessionList = { sessions: ["s1"] };
+const sessionList = { sessions: [session] };
 async function* sseEvents() {
     yield { event: "turn_start" };
     yield { event: "text", text: "hi" };
@@ -17,9 +17,10 @@ async function* sseEvents() {
 }
 function makeHandler(overrides = {}) {
     return {
-        getMeta: vitest_1.vi.fn().mockReturnValue(meta),
+        getMeta: vitest_1.vi.fn().mockReturnValue({ agents: [] }),
         listSessions: vitest_1.vi.fn().mockResolvedValue(sessionList),
         getSession: vitest_1.vi.fn().mockResolvedValue(session),
+        getSessionHistory: vitest_1.vi.fn().mockResolvedValue([]),
         createSession: vitest_1.vi.fn().mockResolvedValue(createSessionResponse),
         sendTurn: vitest_1.vi.fn().mockResolvedValue(agentResponse),
         deleteSession: vitest_1.vi.fn().mockResolvedValue(undefined),
@@ -57,22 +58,20 @@ function req(method, path, body, headers) {
             sessionId: "s1",
             agent: { name: "a", options: { key: "mysecret", model: "gpt-4" } },
         };
-        const secretMeta = {
-            version: 1,
-            agents: [
-                {
-                    name: "a",
-                    version: "1.0.0",
-                    options: [
-                        { type: "secret", name: "key", default: "" },
-                        { type: "text", name: "model", default: "" },
-                    ],
-                },
-            ],
-        };
         const app = makeApp(makeHandler({
             getSession: vitest_1.vi.fn().mockResolvedValue(secretSession),
-            getMeta: vitest_1.vi.fn().mockReturnValue(secretMeta),
+            getMeta: vitest_1.vi.fn().mockReturnValue({
+                agents: [
+                    {
+                        name: "a",
+                        version: "1.0.0",
+                        options: [
+                            { type: "secret", name: "key", default: "" },
+                            { type: "text", name: "model", default: "" },
+                        ],
+                    },
+                ],
+            }),
         }));
         const res = await app.fetch(req("GET", "/session/s1"));
         (0, vitest_1.expect)(res.status).toBe(200);
@@ -89,6 +88,37 @@ function req(method, path, body, headers) {
         (0, vitest_1.expect)(await res.json()).toEqual(sessionList);
         (0, vitest_1.expect)(handler.listSessions).toHaveBeenCalledWith({ after: "cursor1" });
     });
+    (0, vitest_1.it)("GET /sessions redacts secret options in each session", async () => {
+        const secretSession = {
+            sessionId: "s1",
+            agent: { name: "a", options: { key: "mysecret", model: "gpt-4" } },
+        };
+        const app = makeApp(makeHandler({
+            listSessions: vitest_1.vi.fn().mockResolvedValue({ sessions: [secretSession] }),
+            getMeta: vitest_1.vi.fn().mockReturnValue({
+                agents: [
+                    {
+                        name: "a",
+                        version: "1.0.0",
+                        options: [
+                            { type: "secret", name: "key", default: "" },
+                            { type: "text", name: "model", default: "" },
+                        ],
+                    },
+                ],
+            }),
+        }));
+        const res = await app.fetch(req("GET", "/sessions"));
+        (0, vitest_1.expect)(res.status).toBe(200);
+        (0, vitest_1.expect)(await res.json()).toEqual({
+            sessions: [
+                {
+                    ...secretSession,
+                    agent: { ...secretSession.agent, options: { key: "***", model: "gpt-4" } },
+                },
+            ],
+        });
+    });
     (0, vitest_1.it)("PUT /session returns 400 if last message is not a user message", async () => {
         const app = makeApp(makeHandler());
         const res = await app.fetch(req("PUT", "/session", {
@@ -158,7 +188,7 @@ function req(method, path, body, headers) {
         };
         const app = makeApp(makeHandler({
             getSession: vitest_1.vi.fn().mockResolvedValue(sessionWithOptions),
-            getMeta: vitest_1.vi.fn().mockReturnValue({ version: 1, agents: [] }),
+            getMeta: vitest_1.vi.fn().mockReturnValue({ agents: [] }),
         }));
         const res = await app.fetch(req("GET", "/session/s1"));
         (0, vitest_1.expect)(await res.json()).toEqual(sessionWithOptions);
@@ -171,7 +201,6 @@ function req(method, path, body, headers) {
         const app = makeApp(makeHandler({
             getSession: vitest_1.vi.fn().mockResolvedValue(sessionWithOptions),
             getMeta: vitest_1.vi.fn().mockReturnValue({
-                version: 1,
                 agents: [
                     {
                         name: "a",
@@ -184,46 +213,27 @@ function req(method, path, body, headers) {
         const res = await app.fetch(req("GET", "/session/s1"));
         (0, vitest_1.expect)(await res.json()).toEqual(sessionWithOptions);
     });
-    (0, vitest_1.it)("GET /session/:id?history=compacted passes param and strips full", async () => {
-        const handler = makeHandler({
-            getSession: vitest_1.vi.fn().mockResolvedValue({
-                ...session,
-                history: { compacted: [], full: [] },
-            }),
-        });
-        const app = makeApp(handler);
-        const res = await app.fetch(req("GET", "/session/s1?history=compacted"));
-        (0, vitest_1.expect)(handler.getSession).toHaveBeenCalledWith("s1", "compacted");
-        (0, vitest_1.expect)(await res.json()).toEqual({ ...session, history: { compacted: [] } });
-    });
-    (0, vitest_1.it)("GET /session/:id?history=full passes param and strips compacted", async () => {
-        const handler = makeHandler({
-            getSession: vitest_1.vi.fn().mockResolvedValue({
-                ...session,
-                history: { compacted: [], full: [] },
-            }),
-        });
-        const app = makeApp(handler);
-        const res = await app.fetch(req("GET", "/session/s1?history=full"));
-        (0, vitest_1.expect)(handler.getSession).toHaveBeenCalledWith("s1", "full");
-        (0, vitest_1.expect)(await res.json()).toEqual({ ...session, history: { full: [] } });
-    });
-    (0, vitest_1.it)("GET /session/:id without ?history passes undefined and strips history from response", async () => {
-        const handler = makeHandler({
-            getSession: vitest_1.vi.fn().mockResolvedValue({
-                ...session,
-                history: { compacted: [], full: [] },
-            }),
-        });
+    (0, vitest_1.it)("GET /session/:id/history?type=compacted calls getSessionHistory", async () => {
+        const messages = [{ role: "user", content: "hi" }];
+        const handler = makeHandler({ getSessionHistory: vitest_1.vi.fn().mockResolvedValue(messages) });
         const app = makeApp(handler);
-        const res = await app.fetch(req("GET", "/session/s1"));
-        (0, vitest_1.expect)(handler.getSession).toHaveBeenCalledWith("s1", undefined);
-        (0, vitest_1.expect)(await res.json()).toEqual(session);
+        const res = await app.fetch(req("GET", "/session/s1/history?type=compacted"));
+        (0, vitest_1.expect)(res.status).toBe(200);
+        (0, vitest_1.expect)(handler.getSessionHistory).toHaveBeenCalledWith("s1", "compacted");
+        (0, vitest_1.expect)(await res.json()).toEqual({ history: { compacted: messages } });
     });
-    (0, vitest_1.it)("GET /session/:id with invalid ?history passes undefined", async () => {
-        const handler = makeHandler();
+    (0, vitest_1.it)("GET /session/:id/history?type=full calls getSessionHistory", async () => {
+        const messages = [{ role: "user", content: "hi" }];
+        const handler = makeHandler({ getSessionHistory: vitest_1.vi.fn().mockResolvedValue(messages) });
         const app = makeApp(handler);
-        await app.fetch(req("GET", "/session/s1?history=invalid"));
-        (0, vitest_1.expect)(handler.getSession).toHaveBeenCalledWith("s1", undefined);
+        const res = await app.fetch(req("GET", "/session/s1/history?type=full"));
+        (0, vitest_1.expect)(res.status).toBe(200);
+        (0, vitest_1.expect)(handler.getSessionHistory).toHaveBeenCalledWith("s1", "full");
+        (0, vitest_1.expect)(await res.json()).toEqual({ history: { full: messages } });
+    });
+    (0, vitest_1.it)("GET /session/:id/history without valid ?type returns 400", async () => {
+        const app = makeApp(makeHandler());
+        const res = await app.fetch(req("GET", "/session/s1/history"));
+        (0, vitest_1.expect)(res.status).toBe(400);
     });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentapplicationprotocol/server",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "AAP server",
   "keywords": [
     "aap",
@@ -31,7 +31,7 @@
     "ai": "^6.0.141",
     "hono": "^4.12.8",
     "zod": "^4.3.6",
-    "@agentapplicationprotocol/core": "0.5.0"
+    "@agentapplicationprotocol/core": "0.6.1"
   },
   "devDependencies": {
     "@ai-sdk/openai": "^3.0.48",