@agentapplicationprotocol/client 0.5.0 → 0.6.0

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import { AgentResponse, CreateSessionRequest, CreateSessionResponse, MetaResponse, SessionListResponse, SessionResponse, SessionTurnRequest, SSEEvent } from "@agentapplicationprotocol/core";
+import { AgentResponse, CreateSessionRequest, CreateSessionResponse, MetaResponse, SessionHistoryResponse, SessionListResponse, SessionResponse, SessionTurnRequest, SSEEvent } from "@agentapplicationprotocol/core";
 export interface ClientOptions {
     baseUrl: string;
     apiKey: string;
@@ -22,10 +22,12 @@ export declare class Client {
     listSessions(params?: {
         after?: string;
     }): Promise<SessionListResponse>;
-    /** Fetches all session IDs across all pages. */
-    listAllSessions(): Promise<string[]>;
+    /** Fetches all sessions across all pages. */
+    listAllSessions(): Promise<SessionResponse[]>;
     /** GET /session/:id */
-    getSession(sessionId: string, history?: "compacted" | "full"): Promise<SessionResponse>;
+    getSession(sessionId: string): Promise<SessionResponse>;
+    /** GET /session/:id/history */
+    getSessionHistory(sessionId: string, type: "compacted" | "full"): Promise<SessionHistoryResponse>;
     /** PUT /session — non-streaming */
     createSession(req: CreateSessionRequest & {
         stream?: "none";

package/dist/src/client.js

@@ -50,8 +50,12 @@ class Client {
         return parseSSE(res.body);
     }
     /** GET /meta */
-    getMeta() {
-        return this.request("GET", "/meta");
+    async getMeta() {
+        const meta = await this.request("GET", "/meta");
+        if (meta.version !== 2) {
+            throw new Error(`Protocol version mismatch: expected 2, got ${meta.version}`);
+        }
+        return meta;
     }
     /** GET /sessions */
     listSessions(params) {
@@ -61,7 +65,7 @@ class Client {
         }
         return this.request("GET", path);
     }
-    /** Fetches all session IDs across all pages. */
+    /** Fetches all sessions across all pages. */
     async listAllSessions() {
         const sessions = [];
         let after;
@@ -73,11 +77,12 @@ class Client {
         return sessions;
     }
     /** GET /session/:id */
-    getSession(sessionId, history) {
-        const path = history
-            ? `/session/${sessionId}?${new URLSearchParams({ history }).toString()}`
-            : `/session/${sessionId}`;
-        return this.request("GET", path);
+    getSession(sessionId) {
+        return this.request("GET", `/session/${sessionId}`);
+    }
+    /** GET /session/:id/history */
+    getSessionHistory(sessionId, type) {
+        return this.request("GET", `/session/${sessionId}/history?${new URLSearchParams({ type }).toString()}`);
     }
     createSession(req) {
         if (req.messages.at(-1)?.role !== "user")

package/dist/src/client.test.js

@@ -37,19 +37,19 @@ let client;
 (0, vitest_1.describe)("Client", () => {
     (0, vitest_1.it)("strips trailing slash from baseUrl", () => {
         const c = new client_1.Client({ baseUrl: BASE_URL + "/", apiKey: API_KEY });
-        const fetch = mockFetch({});
+        const fetch = mockFetch({ version: 2, agents: [] });
         vitest_1.vi.stubGlobal("fetch", fetch);
         c.getMeta();
         (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/meta`);
     });
     (0, vitest_1.it)("sends Authorization header", async () => {
-        const fetch = mockFetch({ version: 1, agents: [] });
+        const fetch = mockFetch({ version: 2, agents: [] });
         vitest_1.vi.stubGlobal("fetch", fetch);
         await client.getMeta();
         (0, vitest_1.expect)(fetch.mock.calls[0][1].headers["Authorization"]).toBe(`Bearer ${API_KEY}`);
     });
     (0, vitest_1.it)("getMeta: GET /meta", async () => {
-        const meta = { version: 1, agents: [] };
+        const meta = { version: 2, agents: [] };
         vitest_1.vi.stubGlobal("fetch", mockFetch(meta));
         (0, vitest_1.expect)(await client.getMeta()).toEqual(meta);
     });
@@ -58,20 +58,20 @@ let client;
         vitest_1.vi.stubGlobal("fetch", mockFetch(session));
         (0, vitest_1.expect)(await client.getSession("s1")).toEqual(session);
     });
-    (0, vitest_1.it)("getSession: appends ?history=compacted", async () => {
-        const fetch = mockFetch({ sessionId: "s1", agent: { name: "a" } });
+    (0, vitest_1.it)("getSessionHistory: appends ?type=compacted", async () => {
+        const fetch = mockFetch({ history: { compacted: [] } });
         vitest_1.vi.stubGlobal("fetch", fetch);
-        await client.getSession("s1", "compacted");
-        (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/session/s1?history=compacted`);
+        await client.getSessionHistory("s1", "compacted");
+        (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/session/s1/history?type=compacted`);
     });
-    (0, vitest_1.it)("getSession: appends ?history=full", async () => {
-        const fetch = mockFetch({ sessionId: "s1", agent: { name: "a" } });
+    (0, vitest_1.it)("getSessionHistory: appends ?type=full", async () => {
+        const fetch = mockFetch({ history: { full: [] } });
         vitest_1.vi.stubGlobal("fetch", fetch);
-        await client.getSession("s1", "full");
-        (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/session/s1?history=full`);
+        await client.getSessionHistory("s1", "full");
+        (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/session/s1/history?type=full`);
     });
     (0, vitest_1.it)("listSessions: GET /sessions without cursor", async () => {
-        const res = { sessions: ["s1"] };
+        const res = { sessions: [{ sessionId: "s1", agent: { name: "a" } }] };
         const fetch = mockFetch(res);
         vitest_1.vi.stubGlobal("fetch", fetch);
         await client.listSessions();
@@ -84,20 +84,22 @@ let client;
         (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/sessions?after=cursor1`);
     });
     (0, vitest_1.it)("listAllSessions: paginates until no next", async () => {
+        const s1 = { sessionId: "s1", agent: { name: "a" } };
+        const s2 = { sessionId: "s2", agent: { name: "a" } };
         const fetch = vitest_1.vi
             .fn()
             .mockResolvedValueOnce({
             ok: true,
             status: 200,
-            json: () => Promise.resolve({ sessions: ["s1"], next: "c1" }),
+            json: () => Promise.resolve({ sessions: [s1], next: "c1" }),
         })
             .mockResolvedValueOnce({
             ok: true,
             status: 200,
-            json: () => Promise.resolve({ sessions: ["s2"] }),
+            json: () => Promise.resolve({ sessions: [s2] }),
         });
         vitest_1.vi.stubGlobal("fetch", fetch);
-        (0, vitest_1.expect)(await client.listAllSessions()).toEqual(["s1", "s2"]);
+        (0, vitest_1.expect)(await client.listAllSessions()).toEqual([s1, s2]);
         (0, vitest_1.expect)(fetch).toHaveBeenCalledTimes(2);
     });
     (0, vitest_1.it)("deleteSession: DELETE /session/:id returns void on 204", async () => {

package/dist/src/session.d.ts

@@ -1,4 +1,4 @@
-import { AgentConfig, AgentInfo, CreateSessionRequest, HistoryMessage, SessionTurnRequest, SSEEvent, ToolCallEvent, ToolSpec } from "@agentapplicationprotocol/core";
+import { AgentConfig, AgentInfo, CreateSessionRequest, HistoryMessage, SessionResponse, SessionTurnRequest, SSEEvent, ToolCallEvent, ToolSpec } from "@agentapplicationprotocol/core";
 import { Client } from "./client";
 /** Unresolved tool calls from a turn, split by origin. */
 export interface PendingToolUse {
@@ -31,10 +31,12 @@ export declare class Session {
     }>;
     /**
      * Loads an existing session and resolves any pending tool use.
-     * @param agents - List of known agents to match against the session's agent name.
+     * @param res - Session response from `client.getSession()`.
+     * @param agentInfo - Agent metadata matching the session's agent.
+     * @param history - If provided, fetches history of the given type.
      * @returns The loaded session and any pending tool calls.
      */
-    static load(client: Client, sessionId: string, agents: AgentInfo[], history?: "full" | "compacted"): Promise<{
+    static load(client: Client, res: SessionResponse, agentInfo: AgentInfo, history?: "full" | "compacted"): Promise<{
         session: Session;
         pending: PendingToolUse;
     }>;

package/dist/src/session.js

@@ -45,17 +45,18 @@ class Session {
     }
     /**
      * Loads an existing session and resolves any pending tool use.
-     * @param agents - List of known agents to match against the session's agent name.
+     * @param res - Session response from `client.getSession()`.
+     * @param agentInfo - Agent metadata matching the session's agent.
+     * @param history - If provided, fetches history of the given type.
      * @returns The loaded session and any pending tool calls.
      */
-    static async load(client, sessionId, agents, history) {
-        const res = await client.getSession(sessionId, history);
-        const agentInfo = agents.find((a) => a.name === res.agent.name);
-        if (!agentInfo)
-            throw new Error(`Unknown agent: ${res.agent.name}`);
-        const session = new Session(sessionId, client, agentInfo, res.agent, res.tools);
-        const h = history === "compacted" ? res.history?.compacted : res.history?.full;
-        session.history.push(...(h ?? []));
+    static async load(client, res, agentInfo, history) {
+        const session = new Session(res.sessionId, client, agentInfo, res.agent, res.tools);
+        if (history) {
+            const histRes = await client.getSessionHistory(res.sessionId, history);
+            const h = history === "compacted" ? histRes.history.compacted : histRes.history.full;
+            session.history.push(...(h ?? []));
+        }
         return { session, pending: (0, utils_1.resolvePendingToolUse)(session.history, session.tools) };
     }
     /**

package/dist/src/session.test.js

@@ -32,40 +32,28 @@ let client;
     client = new client_1.Client({ baseUrl: BASE_URL, apiKey: "key" });
 });
 (0, vitest_1.describe)("Session.load", () => {
+    const sessionRes = { sessionId: "s1", agent: { name: "test-agent" } };
     (0, vitest_1.it)("returns session with correct sessionId and agentConfig", async () => {
-        const res = { sessionId: "s1", agent: { name: "test-agent" } };
-        vitest_1.vi.stubGlobal("fetch", mockFetch(res));
-        const { session } = await session_1.Session.load(client, "s1", [agentInfo]);
+        const { session } = await session_1.Session.load(client, sessionRes, agentInfo);
         (0, vitest_1.expect)(session.sessionId).toBe("s1");
         (0, vitest_1.expect)(session.agentConfig).toEqual({ name: "test-agent" });
         (0, vitest_1.expect)(session.agent).toBe(agentInfo);
     });
     (0, vitest_1.it)("populates history from full history", async () => {
         const history = [{ role: "user", content: "hi" }];
-        const res = {
-            sessionId: "s1",
-            agent: { name: "test-agent" },
-            history: { full: history },
-        };
-        vitest_1.vi.stubGlobal("fetch", mockFetch(res));
-        const { session } = await session_1.Session.load(client, "s1", [agentInfo], "full");
+        vitest_1.vi.stubGlobal("fetch", mockFetch({ history: { full: history } }));
+        const { session } = await session_1.Session.load(client, sessionRes, agentInfo, "full");
         (0, vitest_1.expect)(session.history).toEqual(history);
     });
     (0, vitest_1.it)("populates history from compacted history", async () => {
         const history = [{ role: "user", content: "summary" }];
-        const res = {
-            sessionId: "s1",
-            agent: { name: "test-agent" },
-            history: { compacted: history },
-        };
-        vitest_1.vi.stubGlobal("fetch", mockFetch(res));
-        const { session } = await session_1.Session.load(client, "s1", [agentInfo], "compacted");
+        vitest_1.vi.stubGlobal("fetch", mockFetch({ history: { compacted: history } }));
+        const { session } = await session_1.Session.load(client, sessionRes, agentInfo, "compacted");
         (0, vitest_1.expect)(session.history).toEqual(history);
     });
     (0, vitest_1.it)("returns empty history when no history in response", async () => {
-        const res = { sessionId: "s1", agent: { name: "test-agent" } };
-        vitest_1.vi.stubGlobal("fetch", mockFetch(res));
-        const { session } = await session_1.Session.load(client, "s1", [agentInfo], "full");
+        vitest_1.vi.stubGlobal("fetch", mockFetch({ history: {} }));
+        const { session } = await session_1.Session.load(client, sessionRes, agentInfo, "full");
         (0, vitest_1.expect)(session.history).toEqual([]);
     });
     (0, vitest_1.it)("resolves pending client tool use from history", async () => {
@@ -83,30 +71,23 @@ let client;
                 content: [{ type: "tool_use", toolCallId: "tc1", name: "myTool", input: {} }],
             },
         ];
-        const res = {
-            sessionId: "s1",
-            agent: { name: "test-agent" },
-            tools,
-            history: { full: history },
-        };
-        vitest_1.vi.stubGlobal("fetch", mockFetch(res));
-        const { pending } = await session_1.Session.load(client, "s1", [agentInfo], "full");
+        vitest_1.vi.stubGlobal("fetch", mockFetch({ history: { full: history } }));
+        const res = { sessionId: "s1", agent: { name: "test-agent" }, tools };
+        const { pending } = await session_1.Session.load(client, res, agentInfo, "full");
         (0, vitest_1.expect)(pending.client).toEqual([{ toolCallId: "tc1", name: "myTool", input: {} }]);
         (0, vitest_1.expect)(pending.server).toEqual([]);
     });
-    (0, vitest_1.it)("calls getSession with correct history param", async () => {
-        const fetch = mockFetch({
-            sessionId: "s1",
-            agent: { name: "test-agent" },
-        });
+    (0, vitest_1.it)("calls getSessionHistory with correct type param", async () => {
+        const fetch = mockFetch({ history: { compacted: [] } });
         vitest_1.vi.stubGlobal("fetch", fetch);
-        await session_1.Session.load(client, "s1", [agentInfo], "compacted");
-        (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/session/s1?history=compacted`);
+        await session_1.Session.load(client, sessionRes, agentInfo, "compacted");
+        (0, vitest_1.expect)(fetch.mock.calls[0][0]).toBe(`${BASE_URL}/session/s1/history?type=compacted`);
     });
-    (0, vitest_1.it)("throws if agent name not found in list", async () => {
-        const res = { sessionId: "s1", agent: { name: "unknown-agent" } };
-        vitest_1.vi.stubGlobal("fetch", mockFetch(res));
-        await (0, vitest_1.expect)(session_1.Session.load(client, "s1", [agentInfo])).rejects.toThrow("Unknown agent: unknown-agent");
+    (0, vitest_1.it)("does not fetch when no history requested", async () => {
+        const fetch = vitest_1.vi.fn();
+        vitest_1.vi.stubGlobal("fetch", fetch);
+        await session_1.Session.load(client, sessionRes, agentInfo);
+        (0, vitest_1.expect)(fetch).not.toHaveBeenCalled();
     });
 });
 (0, vitest_1.describe)("Session.create", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentapplicationprotocol/client",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "AAP client",
   "keywords": [
     "aap",
@@ -29,7 +29,7 @@
   "types": "dist/src/index.d.ts",
   "dependencies": {
     "eventsource-parser": "^3.0.6",
-    "@agentapplicationprotocol/core": "0.5.0"
+    "@agentapplicationprotocol/core": "0.6.0"
   },
   "scripts": {
     "build": "tsc",