@agentuity/server 0.0.48 → 0.0.50

package/dist/api/session/logs.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { APIClient } from '../api';
+declare const _SessionLogsRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+declare const LogSchema: z.ZodObject<{
+    body: z.ZodString;
+    severity: z.ZodString;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+type SessionLogsRequest = z.infer<typeof _SessionLogsRequestSchema>;
+export type SessionLog = z.infer<typeof LogSchema>;
+export type SessionLogs = SessionLog[];
+/**
+ * Get logs for a session from the App API
+ *
+ * @param client APIClient configured for the App API base URL
+ * @param request
+ * @returns
+ */
+export declare function sessionLogs(client: APIClient, request: SessionLogsRequest): Promise<SessionLogs>;
+export {};
+//# sourceMappingURL=logs.d.ts.map

package/dist/api/session/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/api/session/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAqB,MAAM,QAAQ,CAAC;AAEtD,QAAA,MAAM,yBAAyB;;iBAE7B,CAAC;AAEH,QAAA,MAAM,SAAS;;;;iBAIb,CAAC;AAMH,KAAK,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAGpE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG,UAAU,EAAE,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAsB,WAAW,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,kBAAkB,GACzB,OAAO,CAAC,WAAW,CAAC,CAYtB"}

package/dist/api/session/logs.js

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import { APIResponseSchema } from '../api';
+const _SessionLogsRequestSchema = z.object({
+    id: z.string().describe('the session id'),
+});
+const LogSchema = z.object({
+    body: z.string().describe('the log body'),
+    severity: z.string().describe('the log severity'),
+    timestamp: z.string().describe('the log timestamp'),
+});
+const SessionLogsResponse = z.array(LogSchema);
+const SessionLogsResponseSchema = APIResponseSchema(SessionLogsResponse);
+/**
+ * Get logs for a session from the App API
+ *
+ * @param client APIClient configured for the App API base URL
+ * @param request
+ * @returns
+ */
+export async function sessionLogs(client, request) {
+    const resp = await client.request('GET', `/cli/session/${request.id}/logs`, SessionLogsResponseSchema);
+    if (resp.success) {
+        return resp.data;
+    }
+    throw new Error(resp.message);
+}
+//# sourceMappingURL=logs.js.map

package/dist/api/session/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/api/session/logs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAa,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAEtD,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;CACzC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACzC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACjD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;CACnD,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAE/C,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAQzE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAChC,MAAiB,EACjB,OAA2B;IAE3B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAChC,KAAK,EACL,gBAAgB,OAAO,CAAC,EAAE,OAAO,EACjC,yBAAyB,CACzB,CAAC;IAEF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC"}

package/dist/server.d.ts

@@ -1,13 +1,23 @@
-import type { FetchRequest, FetchResponse, FetchAdapter } from '@agentuity/core';
+import type { FetchRequest, FetchResponse, FetchAdapter, Logger } from '@agentuity/core';
 import { ServiceException } from '@agentuity/core';
 interface ServiceAdapterConfig {
     headers: Record<string, string>;
     onBefore?: (url: string, options: FetchRequest, invoke: () => Promise<void>) => Promise<void>;
     onAfter?: <T>(url: string, options: FetchRequest, response: FetchResponse<T>, err?: ServiceException) => Promise<void>;
 }
+/**
+ * Redacts the middle of a string while keeping a prefix and suffix visible.
+ * Ensures that if the string is too short, everything is redacted.
+ *
+ * @param input The string to redact
+ * @param prefix Number of chars to keep at the start
+ * @param suffix Number of chars to keep at the end
+ * @param mask  Character used for redaction
+ */
+export declare function redact(input: string, prefix?: number, suffix?: number, mask?: string): string;
 declare class ServerFetchAdapter implements FetchAdapter {
     #private;
-    constructor(config: ServiceAdapterConfig);
+    constructor(config: ServiceAdapterConfig, logger: Logger);
     private _invoke;
     invoke<T>(url: string, options?: FetchRequest): Promise<FetchResponse<T>>;
 }
@@ -17,6 +27,6 @@ declare class ServerFetchAdapter implements FetchAdapter {
  * @param config the service config
  * @returns
  */
-export declare function createServerFetchAdapter(config: ServiceAdapterConfig): ServerFetchAdapter;
+export declare function createServerFetchAdapter(config: ServiceAdapterConfig, logger: Logger): ServerFetchAdapter;
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EAEZ,aAAa,EACb,YAAY,EACZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAoC,MAAM,iBAAiB,CAAC;AAErF,UAAU,oBAAoB;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,OAAO,CAAC,EAAE,CAAC,CAAC,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,CAAC,EAAE,gBAAgB,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAED,cAAM,kBAAmB,YAAW,YAAY;;gBAGnC,MAAM,EAAE,oBAAoB;YAG1B,OAAO;IA2Df,MAAM,CAAC,CAAC,EACb,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiC,GACxC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAmC5B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,sBAEpE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EAEZ,aAAa,EACb,YAAY,EACZ,MAAM,EACN,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,gBAAgB,EAAoC,MAAM,iBAAiB,CAAC;AAErF,UAAU,oBAAoB;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,OAAO,CAAC,EAAE,CAAC,CAAC,EACX,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,CAAC,EAAE,gBAAgB,KAClB,OAAO,CAAC,IAAI,CAAC,CAAC;CACnB;AAID;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CACrB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAU,EAClB,MAAM,GAAE,MAAU,EAClB,IAAI,GAAE,MAAY,GAChB,MAAM,CAaR;AAgBD,cAAM,kBAAmB,YAAW,YAAY;;gBAInC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM;YAI1C,OAAO;IA6Df,MAAM,CAAC,CAAC,EACb,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiC,GACxC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAmC5B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,sBAEpF"}

package/dist/server.js

@@ -1,8 +1,46 @@
 import { toServiceException, fromResponse } from '@agentuity/core';
+const sensitiveHeaders = new Set(['authorization', 'x-api-key']);
+/**
+ * Redacts the middle of a string while keeping a prefix and suffix visible.
+ * Ensures that if the string is too short, everything is redacted.
+ *
+ * @param input The string to redact
+ * @param prefix Number of chars to keep at the start
+ * @param suffix Number of chars to keep at the end
+ * @param mask  Character used for redaction
+ */
+export function redact(input, prefix = 4, suffix = 4, mask = '*') {
+    if (!input)
+        return '';
+    // If revealing prefix+suffix would leak too much, fully mask
+    if (input.length <= prefix + suffix) {
+        return mask.repeat(input.length);
+    }
+    const start = input.slice(0, prefix);
+    const end = input.slice(-suffix);
+    const hiddenLength = input.length - prefix - suffix;
+    return start + mask.repeat(hiddenLength) + end;
+}
+const redactHeaders = (kv) => {
+    const values = [];
+    for (const k of Object.keys(kv)) {
+        const _k = k.toLowerCase();
+        const v = kv[k];
+        if (sensitiveHeaders.has(_k)) {
+            values.push(`${_k}=${redact(v)}`);
+        }
+        else {
+            values.push(`${_k}=${v}`);
+        }
+    }
+    return '[' + values.join(',') + ']';
+};
 class ServerFetchAdapter {
     #config;
-    constructor(config) {
+    #logger;
+    constructor(config, logger) {
         this.#config = config;
+        this.#logger = logger;
     }
     async _invoke(url, options) {
         const headers = {
@@ -17,8 +55,10 @@ class ServerFetchAdapter {
             options.body instanceof ArrayBuffer) {
             headers['Content-Type'] = 'application/octet-stream';
         }
+        const method = options.method ?? 'POST';
+        this.#logger.trace('sending %s to %s with headers: %s', method, url, redactHeaders(headers));
         const res = await fetch(url, {
-            method: options.method ?? 'POST',
+            method,
             body: options.body,
             headers,
             signal: options.signal,
@@ -46,7 +86,7 @@ class ServerFetchAdapter {
                     response: res,
                 };
             }
-            const data = await fromResponse(url, res);
+            const data = await fromResponse(method, url, res);
             return {
                 ok: true,
                 data,
@@ -59,7 +99,7 @@ class ServerFetchAdapter {
                 response: res,
             };
         }
-        const err = await toServiceException(url, res);
+        const err = await toServiceException(method, url, res);
         throw err;
     }
     async invoke(url, options = { method: 'POST' }) {
@@ -101,7 +141,7 @@ class ServerFetchAdapter {
  * @param config the service config
  * @returns
  */
-export function createServerFetchAdapter(config) {
-    return new ServerFetchAdapter(config);
+export function createServerFetchAdapter(config, logger) {
+    return new ServerFetchAdapter(config, logger);
 }
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/server",
-	"version": "0.0.48",
+	"version": "0.0.50",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
 	"type": "module",
@@ -25,11 +25,13 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "0.0.48",
+		"@agentuity/core": "0.0.50",
 		"zod": "^4.1.12"
 	},
 	"devDependencies": {
+		"@types/bun": "latest",
 		"@types/node": "^22.0.0",
+		"bun-types": "latest",
 		"typescript": "^5.9.0"
 	},
 	"publishConfig": {

package/src/api/api.ts

@@ -147,6 +147,8 @@ export class APIClient {
 	}
 
 	async #makeRequest(method: string, endpoint: string, body?: unknown): Promise<Response> {
+		this.#logger.trace('sending %s to %s', method, endpoint);
+
 		const maxRetries = this.#config?.maxRetries ?? 3;
 		const baseDelayMs = this.#config?.retryDelayMs ?? 100;
 
@@ -165,6 +167,11 @@ export class APIClient {
 					headers['Authorization'] = `Bearer ${this.#apiKey}`;
 				}
 
+				// Log request body for debugging deployment issues
+				if (body !== undefined && endpoint.includes('/deploy/')) {
+					this.#logger.debug('Request body: %s', JSON.stringify(body, null, 2));
+				}
+
 				const response = await fetch(url, {
 					method,
 					headers,

package/src/api/index.ts

@@ -2,4 +2,5 @@ export * from './api';
 export * from './org';
 export * from './project';
 export * from './region';
+export * from './session';
 export * from './user';

package/src/api/project/deploy.ts

@@ -35,13 +35,18 @@ const BaseFileFields = {
 const EvalSchema = z.object({
 	...BaseFileFields,
 	id: z.string().describe('the unique calculated id for the eval'),
+	evalId: z.string().describe('the unique id for eval for the project across deployments'),
 	name: z.string().describe('the name of the eval'),
 	description: z.string().optional().describe('the eval description'),
+	agentIdentifier: z.string().describe('the identifier of the agent'),
+	projectId: z.string().describe('the project id'),
 });
 
 const BaseAgentFields = {
 	...BaseFileFields,
 	id: z.string().describe('the unique calculated id for the agent'),
+	agentId: z.string().describe('the unique id for agent for the project across deployments'),
+	projectId: z.string().describe('the project id'),
 	name: z.string().describe('the name of the agent'),
 	description: z.string().optional().describe('the agent description'),
 	evals: z.array(EvalSchema).optional().describe('the evals for the agent'),
@@ -138,7 +143,7 @@ export async function projectDeploymentCreate(
 		'POST',
 		`/cli/deploy/1/start/${projectId}`,
 		CreateProjectDeploymentSchema,
-		deploymentConfig
+		deploymentConfig ?? {}
 	);
 	if (resp.success) {
 		return resp.data;

package/src/api/project/deployment.ts

@@ -1,27 +1,35 @@
 import { z } from 'zod';
-import { type APIClient, APIResponseSchema } from '../api';
+import { type APIClient, APIResponseSchema, APIResponseSchemaOptionalData } from '../api';
 
 // Simplified metadata schema for the client
 const DeploymentMetadataSchema = z.object({
-	origin: z.object({
-		trigger: z.string().optional(),
-		provider: z.string().optional(),
-		event: z.string().optional(),
-		branch: z.string().optional(),
-		commit: z.object({
-			hash: z.string(),
-			message: z.string(),
-			url: z.string().optional(),
-			author: z.object({
-				name: z.string().optional(),
-				email: z.string().optional(),
-			}).optional(),
-		}).optional(),
-		pr: z.object({
-			number: z.number(),
-			url: z.string().optional(),
-		}).optional(),
-	}).optional(),
+	origin: z
+		.object({
+			trigger: z.string().optional(),
+			provider: z.string().optional(),
+			event: z.string().optional(),
+			branch: z.string().optional(),
+			commit: z
+				.object({
+					hash: z.string(),
+					message: z.string(),
+					url: z.string().optional(),
+					author: z
+						.object({
+							name: z.string().optional(),
+							email: z.string().optional(),
+						})
+						.optional(),
+				})
+				.optional(),
+			pr: z
+				.object({
+					number: z.number(),
+					url: z.string().optional(),
+				})
+				.optional(),
+		})
+		.optional(),
 });
 
 const DeploymentSchema = z.object({
@@ -39,11 +47,17 @@ const DeploymentSchema = z.object({
 
 const DeploymentListResponseSchema = APIResponseSchema(z.array(DeploymentSchema));
 const DeploymentGetResponseSchema = APIResponseSchema(DeploymentSchema);
-const DeploymentActionResponseSchema = APIResponseSchema(z.object({ success: z.boolean() }).or(z.object({ success: z.boolean(), activeDeploymentId: z.string() })));
+const DeploymentActionResponseSchema = APIResponseSchemaOptionalData(
+	z.object({ activeDeploymentId: z.string().optional() })
+);
 
 export type DeploymentInfo = z.infer<typeof DeploymentSchema>;
 
-export async function projectDeploymentList(client: APIClient, projectId: string, limit = 10): Promise<DeploymentInfo[]> {
+export async function projectDeploymentList(
+	client: APIClient,
+	projectId: string,
+	limit = 10
+): Promise<DeploymentInfo[]> {
 	const resp = await client.request(
 		'GET',
 		`/cli/project/${projectId}/deployments?limit=${limit}`,
@@ -55,7 +69,11 @@ export async function projectDeploymentList(client: APIClient, projectId: string
 	throw new Error(resp.message);
 }
 
-export async function projectDeploymentGet(client: APIClient, projectId: string, deploymentId: string): Promise<DeploymentInfo> {
+export async function projectDeploymentGet(
+	client: APIClient,
+	projectId: string,
+	deploymentId: string
+): Promise<DeploymentInfo> {
 	const resp = await client.request(
 		'GET',
 		`/cli/project/${projectId}/deployments/${deploymentId}`,
@@ -67,7 +85,11 @@ export async function projectDeploymentGet(client: APIClient, projectId: string,
 	throw new Error(resp.message);
 }
 
-export async function projectDeploymentDelete(client: APIClient, projectId: string, deploymentId: string): Promise<void> {
+export async function projectDeploymentDelete(
+	client: APIClient,
+	projectId: string,
+	deploymentId: string
+): Promise<void> {
 	const resp = await client.request(
 		'DELETE',
 		`/cli/project/${projectId}/deployments/${deploymentId}`,
@@ -78,7 +100,11 @@ export async function projectDeploymentDelete(client: APIClient, projectId: stri
 	}
 }
 
-export async function projectDeploymentRollback(client: APIClient, projectId: string, deploymentId: string): Promise<void> {
+export async function projectDeploymentRollback(
+	client: APIClient,
+	projectId: string,
+	deploymentId: string
+): Promise<void> {
 	const resp = await client.request(
 		'POST',
 		`/cli/project/${projectId}/deployments/${deploymentId}/rollback`,
@@ -89,7 +115,10 @@ export async function projectDeploymentRollback(client: APIClient, projectId: st
 	}
 }
 
-export async function projectDeploymentUndeploy(client: APIClient, projectId: string): Promise<void> {
+export async function projectDeploymentUndeploy(
+	client: APIClient,
+	projectId: string
+): Promise<void> {
 	const resp = await client.request(
 		'POST',
 		`/cli/project/${projectId}/deployments/undeploy`,

package/src/api/session/get.ts

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+import { SessionSchema } from './list';
+
+const _SessionGetRequestSchema = z.object({
+	id: z.string().describe('the session id'),
+});
+
+const EvalRunSchema = z.object({
+	id: z.string().describe('eval run id'),
+	created_at: z.string().describe('creation timestamp'),
+	eval_id: z.string().describe('evaluation id'),
+	pending: z.boolean().describe('pending status'),
+	success: z.boolean().describe('success status'),
+	error: z.string().nullable().describe('error message'),
+	result: z.string().nullable().describe('result JSON'),
+});
+
+const EnrichedSessionDataSchema = z.object({
+	session: SessionSchema,
+	agent_names: z.array(z.string()).describe('resolved agent names'),
+	eval_runs: z.array(EvalRunSchema).describe('eval runs for this session'),
+});
+
+const SessionGetResponseSchema = APIResponseSchema(EnrichedSessionDataSchema);
+
+type SessionGetRequest = z.infer<typeof _SessionGetRequestSchema>;
+type SessionGetResponse = z.infer<typeof SessionGetResponseSchema>;
+
+export type Session = z.infer<typeof SessionSchema>;
+
+/**
+ * Get a single session by id
+ *
+ * @param client
+ * @param request
+ * @returns
+ */
+export type EvalRun = z.infer<typeof EvalRunSchema>;
+export type EnrichedSession = {
+	session: Session;
+	agentNames: string[];
+	evalRuns: EvalRun[];
+};
+
+export async function sessionGet(client: APIClient, request: SessionGetRequest): Promise<EnrichedSession> {
+	const resp = await client.request<SessionGetResponse>(
+		'GET',
+		`/session/2025-03-17/${request.id}`,
+		SessionGetResponseSchema
+	);
+
+	if (resp.success) {
+		return {
+			session: resp.data.session,
+			agentNames: resp.data.agent_names,
+			evalRuns: resp.data.eval_runs,
+		};
+	}
+
+	throw new Error(resp.message);
+}

package/src/api/session/index.ts

@@ -0,0 +1,6 @@
+export { sessionGet } from './get';
+export type { Session, EnrichedSession, EvalRun } from './get';
+export { sessionList, SessionSchema } from './list';
+export type { SessionList, SessionListResponse, SessionListOptions } from './list';
+export { sessionLogs } from './logs';
+export type { SessionLog } from './logs';

package/src/api/session/list.ts

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+
+const SessionSchema = z.object({
+	id: z.string().describe('the session id'),
+	created_at: z.string().describe('the creation timestamp'),
+	updated_at: z.string().describe('the last update timestamp'),
+	deleted: z.boolean().describe('whether the session is deleted'),
+	deleted_at: z.string().nullable().describe('the deletion timestamp'),
+	deleted_by: z.string().nullable().describe('who deleted the session'),
+	start_time: z.string().describe('the session start time'),
+	end_time: z.string().nullable().describe('the session end time'),
+	duration: z.number().nullable().describe('the session duration in nanoseconds'),
+	org_id: z.string().describe('the organization id'),
+	project_id: z.string().describe('the project id'),
+	deployment_id: z.string().describe('the deployment id'),
+	agent_ids: z.array(z.string()).describe('the agent ids involved'),
+	trigger: z.string().describe('how the session was triggered'),
+	env: z.string().describe('the environment'),
+	devmode: z.boolean().describe('whether dev mode was enabled'),
+	pending: z.boolean().describe('whether the session is pending'),
+	success: z.boolean().describe('whether the session succeeded'),
+	error: z.string().nullable().describe('the error message if failed'),
+	metadata: z.string().nullable().describe('additional metadata'),
+	cpu_time: z.number().nullable().describe('the CPU time in nanoseconds'),
+	llm_cost: z.string().nullable().describe('the LLM cost'),
+	llm_prompt_token_count: z.number().nullable().describe('the LLM prompt token count'),
+	llm_completion_token_count: z.number().nullable().describe('the LLM completion token count'),
+	total_cost: z.string().nullable().describe('the total cost'),
+	method: z.string().describe('the HTTP method'),
+	url: z.string().describe('the request URL'),
+	route_id: z.string().describe('the route id'),
+	thread_id: z.string().describe('the thread id'),
+});
+
+export { SessionSchema };
+
+const SessionListResponse = z.array(SessionSchema);
+
+const SessionListResponseSchema = APIResponseSchema(SessionListResponse);
+
+export type SessionListResponse = z.infer<typeof SessionListResponseSchema>;
+export type SessionList = z.infer<typeof SessionListResponse>;
+export type Session = z.infer<typeof SessionSchema>;
+
+export interface SessionListOptions {
+	count?: number;
+	projectId?: string;
+	deploymentId?: string;
+	trigger?: string;
+	env?: string;
+	devmode?: boolean;
+	success?: boolean;
+	threadId?: string;
+	agentIdentifier?: string;
+	startAfter?: string;
+	startBefore?: string;
+}
+
+/**
+ * List sessions
+ *
+ * @param client
+ * @param options filtering and pagination options
+ * @returns
+ */
+export async function sessionList(
+	client: APIClient,
+	options: SessionListOptions = {}
+): Promise<SessionList> {
+	const {
+		count = 10,
+		projectId,
+		deploymentId,
+		trigger,
+		env,
+		devmode,
+		success,
+		threadId,
+		agentIdentifier,
+		startAfter,
+		startBefore,
+	} = options;
+	const params = new URLSearchParams({ count: count.toString() });
+	if (projectId) params.set('projectId', projectId);
+	if (deploymentId) params.set('deploymentId', deploymentId);
+	if (trigger) params.set('trigger', trigger);
+	if (env) params.set('env', env);
+	if (devmode !== undefined) params.set('devmode', devmode.toString());
+	if (success !== undefined) params.set('success', success.toString());
+	if (threadId) params.set('threadId', threadId);
+	if (agentIdentifier) params.set('agentIdentifier', agentIdentifier);
+	if (startAfter) params.set('startAfter', startAfter);
+	if (startBefore) params.set('startBefore', startBefore);
+
+	const resp = await client.request<SessionListResponse>(
+		'GET',
+		`/session/2025-03-17?${params.toString()}`,
+		SessionListResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message);
+}

package/src/api/session/logs.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { APIClient, APIResponseSchema } from '../api';
+
+const _SessionLogsRequestSchema = z.object({
+	id: z.string().describe('the session id'),
+});
+
+const LogSchema = z.object({
+	body: z.string().describe('the log body'),
+	severity: z.string().describe('the log severity'),
+	timestamp: z.string().describe('the log timestamp'),
+});
+
+const SessionLogsResponse = z.array(LogSchema);
+
+const SessionLogsResponseSchema = APIResponseSchema(SessionLogsResponse);
+
+type SessionLogsRequest = z.infer<typeof _SessionLogsRequestSchema>;
+type SessionLogsResponse = z.infer<typeof SessionLogsResponseSchema>;
+
+export type SessionLog = z.infer<typeof LogSchema>;
+export type SessionLogs = SessionLog[];
+
+/**
+ * Get logs for a session from the App API
+ *
+ * @param client APIClient configured for the App API base URL
+ * @param request
+ * @returns
+ */
+export async function sessionLogs(
+	client: APIClient,
+	request: SessionLogsRequest
+): Promise<SessionLogs> {
+	const resp = await client.request<SessionLogsResponse>(
+		'GET',
+		`/cli/session/${request.id}/logs`,
+		SessionLogsResponseSchema
+	);
+
+	if (resp.success) {
+		return resp.data;
+	}
+
+	throw new Error(resp.message);
+}