@perstack/api-client 0.0.51 → 0.0.53

package/dist/index.mjs

@@ -73,16 +73,16 @@ function createNetworkError(error) {
 		cause: error instanceof Error ? error : void 0
 	};
 }
-async function handleHttpError(response$23) {
+async function handleHttpError(response$19) {
 	let errorBody;
 	try {
-		errorBody = await response$23.json();
+		errorBody = await response$19.json();
 	} catch {
 		errorBody = void 0;
 	}
 	return {
 		ok: false,
-		error: createHttpError(response$23.status, response$23.statusText, errorBody)
+		error: createHttpError(response$19.status, response$19.statusText, errorBody)
 	};
 }
 function createHttpError(status, statusText, body) {
@@ -219,20 +219,20 @@ function createFetcher(config) {
 			}
 		});
 	}
-	async function request$23(method, path, body, options) {
+	async function request$19(method, path, body, options) {
 		const { signal, cleanup, isTimeout } = createTimeoutSignal(options?.signal);
 		try {
-			const response$23 = await fetch(buildUrl(path), {
+			const response$19 = await fetch(buildUrl(path), {
 				method,
 				headers: buildHeaders(body ? { hasBody: true } : void 0),
 				body: body ? JSON.stringify(body) : void 0,
 				signal,
 				credentials: getCredentials()
 			});
-			if (!response$23.ok) return handleHttpError(response$23);
+			if (!response$19.ok) return handleHttpError(response$19);
 			return {
 				ok: true,
-				data: await response$23.json()
+				data: await response$19.json()
 			};
 		} catch (error) {
 			if (error instanceof Error && error.name === "AbortError") {
@@ -256,16 +256,16 @@ function createFetcher(config) {
 	async function requestBlob(path, options) {
 		const { signal, cleanup, isTimeout } = createTimeoutSignal(options?.signal);
 		try {
-			const response$23 = await fetch(buildUrl(path), {
+			const response$19 = await fetch(buildUrl(path), {
 				method: "GET",
 				headers: buildHeaders(),
 				signal,
 				credentials: getCredentials()
 			});
-			if (!response$23.ok) return handleHttpError(response$23);
+			if (!response$19.ok) return handleHttpError(response$19);
 			return {
 				ok: true,
-				data: await response$23.blob()
+				data: await response$19.blob()
 			};
 		} catch (error) {
 			if (error instanceof Error && error.name === "AbortError") {
@@ -289,17 +289,17 @@ function createFetcher(config) {
 	async function requestStream(path, options) {
 		const { signal, cleanup, isTimeout } = createTimeoutSignal(options?.signal);
 		try {
-			const response$23 = await fetch(buildUrl(path), {
+			const response$19 = await fetch(buildUrl(path), {
 				method: "GET",
 				headers: buildHeaders(),
 				signal,
 				credentials: getCredentials()
 			});
-			if (!response$23.ok) {
+			if (!response$19.ok) {
 				cleanup();
-				return handleHttpError(response$23);
+				return handleHttpError(response$19);
 			}
-			if (!response$23.body) {
+			if (!response$19.body) {
 				cleanup();
 				return {
 					ok: false,
@@ -310,7 +310,7 @@ function createFetcher(config) {
 			const idleTimeout = options?.streamIdleTimeout ?? timeout;
 			return {
 				ok: true,
-				data: wrapStreamWithIdleTimeout(response$23.body, idleTimeout, options?.signal)
+				data: wrapStreamWithIdleTimeout(response$19.body, idleTimeout, options?.signal)
 			};
 		} catch (error) {
 			cleanup();
@@ -333,13 +333,13 @@ function createFetcher(config) {
 	async function requestNoContent(method, path, options) {
 		const { signal, cleanup, isTimeout } = createTimeoutSignal(options?.signal);
 		try {
-			const response$23 = await fetch(buildUrl(path), {
+			const response$19 = await fetch(buildUrl(path), {
 				method,
 				headers: buildHeaders(),
 				signal,
 				credentials: getCredentials()
 			});
-			if (!response$23.ok) return handleHttpError(response$23);
+			if (!response$19.ok) return handleHttpError(response$19);
 			return {
 				ok: true,
 				data: void 0
@@ -364,10 +364,10 @@ function createFetcher(config) {
 		}
 	}
 	return {
-		get: (path, options) => request$23("GET", path, void 0, options),
-		post: (path, body, options) => request$23("POST", path, body, options),
-		put: (path, body, options) => request$23("PUT", path, body, options),
-		delete: (path, options) => request$23("DELETE", path, void 0, options),
+		get: (path, options) => request$19("GET", path, void 0, options),
+		post: (path, body, options) => request$19("POST", path, body, options),
+		put: (path, body, options) => request$19("PUT", path, body, options),
+		delete: (path, options) => request$19("DELETE", path, void 0, options),
 		deleteNoContent: (path, options) => requestNoContent("DELETE", path, options),
 		getBlob: (path, options) => requestBlob(path, options),
 		getStream: (path, options) => requestStream(path, options)
@@ -386,6 +386,31 @@ function buildQueryString(params) {
 
 //#endregion
 //#region src/lib/sse.ts
+async function* parseSSEEvents(reader) {
+	const decoder = new TextDecoder();
+	let buffer = "";
+	while (true) {
+		const { value, done } = await reader.read();
+		if (done) break;
+		buffer += decoder.decode(value, { stream: true });
+		const events = buffer.split("\n\n");
+		buffer = events.pop() || "";
+		for (const event of events) {
+			if (event.trim() === "") continue;
+			const lines = event.split("\n");
+			const eventType = lines.find((line) => line.startsWith("event:"))?.slice(6).trim();
+			const data = lines.find((line) => line.startsWith("data:"))?.slice(5).trim();
+			if (!eventType || !data) continue;
+			if (eventType !== "message" && eventType !== "error" && eventType !== "complete") continue;
+			try {
+				yield {
+					event: eventType,
+					data: JSON.parse(data)
+				};
+			} catch {}
+		}
+	}
+}
 async function* parseSSE(reader) {
 	const decoder = new TextDecoder();
 	let buffer = "";
@@ -507,86 +532,6 @@ const organizationSchema = z.object({
 	maxExperts: z.number().int().min(0)
 });
 
-//#endregion
-//#region ../models/src/domain/user.ts
-const userStatusSchema = z.enum([
-	"active",
-	"inactive",
-	"deleted"
-]);
-const userSchema = z.object({
-	type: z.literal("user"),
-	id: cuidSchema,
-	email: z.string().email(),
-	emailVerified: z.boolean(),
-	name: z.string().min(1).max(255).optional(),
-	image: z.string().url().optional(),
-	status: userStatusSchema,
-	organizations: z.array(organizationSchema),
-	createdAt: datetimeSchema,
-	updatedAt: datetimeSchema
-});
-
-//#endregion
-//#region ../models/src/domain/apiKey.ts
-const apiKeyPermissionsSchema = z.object({
-	operations: z.array(z.string()),
-	experts: z.union([z.array(z.string()), z.literal("*")]).optional()
-});
-const apiKeySchema = z.object({
-	type: z.literal("apiKey"),
-	id: cuidSchema,
-	name: z.string().min(1).max(255).optional(),
-	start: z.string().optional(),
-	prefix: z.string().optional(),
-	user: userSchema.optional(),
-	enabled: z.boolean(),
-	expiresAt: datetimeSchema.optional(),
-	permissions: apiKeyPermissionsSchema.optional(),
-	lastRequest: datetimeSchema.optional(),
-	createdAt: datetimeSchema,
-	updatedAt: datetimeSchema
-});
-const createApiKeyInputSchema = z.object({
-	name: z.string().min(1).max(255).optional(),
-	organizationId: cuidSchema,
-	operations: z.array(z.string()).optional(),
-	experts: z.union([z.array(z.string()), z.literal("*")]).optional(),
-	expiresIn: z.number().min(60).optional()
-});
-const createApiKeyResponseSchema = z.object({
-	apiKey: apiKeySchema,
-	key: z.string()
-});
-
-//#endregion
-//#region ../models/src/api/api-keys/create.ts
-const request$22 = { body: z.object({
-	name: z.string().min(1).max(255).optional(),
-	operations: z.array(z.string()).optional(),
-	experts: z.union([z.array(z.string()), z.literal("*")]).optional(),
-	wildcardApplicationAccess: z.boolean().optional(),
-	applicationIds: z.array(cuidSchema).optional(),
-	expiresIn: z.number().min(60).optional()
-}) };
-const response$22 = z.object({ data: z.object({
-	apiKey: apiKeySchema.extend({
-		permissions: apiKeyPermissionsSchema.optional(),
-		wildcardApplicationAccess: z.boolean(),
-		applicationIds: z.array(cuidSchema)
-	}),
-	key: z.string()
-}) });
-
-//#endregion
-//#region ../models/src/api/api-keys/get.ts
-const request$21 = { params: z.object({ apiKeyId: cuidSchema }) };
-const response$21 = z.object({ data: z.object({ apiKey: apiKeySchema.extend({
-	permissions: apiKeyPermissionsSchema.optional(),
-	wildcardApplicationAccess: z.boolean(),
-	applicationIds: z.array(cuidSchema)
-}) }) });
-
 //#endregion
 //#region ../models/src/lib/dedent.ts
 /**
@@ -644,6 +589,16 @@ const errorForbidden = z.object({
 	error: z.literal("Forbidden"),
 	reason: z.string()
 }).describe("Access denied. The authenticated user does not have permission to perform this action.");
+const errorUsageLimitExceeded = z.object({
+	code: z.literal(403),
+	error: z.literal("Forbidden"),
+	reason: z.string(),
+	details: z.object({
+		minutesUsed: z.number(),
+		limitMinutes: z.number(),
+		upgradeUrl: z.string()
+	})
+}).describe("Usage limit exceeded. Upgrade your plan to continue.");
 const errorNotFound = z.object({
 	code: z.literal(404),
 	error: z.literal("Not Found"),
@@ -665,30 +620,6 @@ const errorUnauthorizedFlexible = z.object({
 	reason: z.string()
 }).describe("Unauthorized");
 
-//#endregion
-//#region ../models/src/api/api-keys/revoke.ts
-const request$20 = { params: z.object({ apiKeyId: cuidSchema }) };
-const response$20 = z.object({ data: z.object({ apiKey: apiKeySchema.extend({
-	permissions: apiKeyPermissionsSchema.optional(),
-	wildcardApplicationAccess: z.boolean(),
-	applicationIds: z.array(cuidSchema)
-}) }) });
-
-//#endregion
-//#region ../models/src/api/api-keys/update.ts
-const request$19 = {
-	params: z.object({ apiKeyId: cuidSchema }),
-	body: z.object({
-		applicationIds: z.array(cuidSchema).optional(),
-		wildcardApplicationAccess: z.boolean().optional()
-	})
-};
-const response$19 = z.object({ data: z.object({ apiKey: apiKeySchema.extend({
-	permissions: apiKeyPermissionsSchema.optional(),
-	wildcardApplicationAccess: z.boolean(),
-	applicationIds: z.array(cuidSchema)
-}) }) });
-
 //#endregion
 //#region ../models/src/domain/application.ts
 const applicationNameSchema = z.string().min(1).max(maxApplicationNameLength).regex(applicationNameRegex);
@@ -707,7 +638,9 @@ const applicationSchema = z.object({
 	name: applicationNameSchema,
 	status: applicationStatusSchema,
 	expertCount: z.number().describe("Number of expert draft scopes associated with this application").optional(),
-	providers: z.array(providerSchema).describe("List of configured providers for this application").optional()
+	providers: z.array(providerSchema).describe("List of configured providers for this application").optional(),
+	totalJobs: z.number().describe("Total number of jobs executed for this application").optional(),
+	lastJobExecutionAt: z.string().datetime({ offset: true }).nullable().describe("Timestamp of the most recent job execution").optional()
 });
 
 //#endregion
@@ -865,7 +798,8 @@ const expertVersionSchema = z.object({
 	updatedAt: datetimeSchema,
 	createdBy: cuidSchema,
 	updatedBy: cuidSchema,
-	tags: z.array(expertTagFieldSchema)
+	tags: z.array(expertTagFieldSchema),
+	readmeUrl: z.string().optional()
 });
 const expertScopeWithVersionsSchema = expertScopeSchema.extend({ versions: z.array(expertVersionSchema) });
 
@@ -945,7 +879,7 @@ const expertSchema = z.object({
 	key: expertKeyFieldSchema,
 	name: expertNameFieldSchema,
 	version: expertVersionFieldSchema,
-	description: z.string().min(1).max(maxExpertDescriptionLength).optional(),
+	description: z.string().max(maxExpertDescriptionLength).optional(),
 	instruction: z.string().min(1).max(maxExpertInstructionLength),
 	skills: z.record(skillNameSchema, skillSchema).optional().default({}),
 	delegates: z.array(expertKeyFieldSchema).min(0).max(maxExpertDelegateItems).optional().default([]),
@@ -1269,8 +1203,8 @@ const jobSchema = z.object({
 	status: jobStatusSchema,
 	coordinatorExpertKey: expertKeyFieldSchema,
 	query: z.string().min(1).max(maxExpertJobQueryLength).optional(),
-	files: z.array(z.string().min(1).max(maxExpertJobFileNameLength)),
 	expert: expertWithMetadataSchema,
+	expertDraftRefId: cuidSchema.optional(),
 	provider: providerSchema,
 	model: modelEnum,
 	reasoningBudget: reasoningBudgetSchema,
@@ -1279,7 +1213,8 @@ const jobSchema = z.object({
 	currentStep: z.number().int().min(0),
 	totalSteps: z.number().int().min(0),
 	totalDuration: z.number().min(0),
-	usage: usageSchema
+	usage: usageSchema,
+	lastActivity: activityOrGroupSchema.nullable().optional()
 });
 
 //#endregion
@@ -1287,9 +1222,8 @@ const jobSchema = z.object({
 const request$6 = {
 	params: z.object({ jobId: cuidSchema }),
 	body: z.object({
-		query: jobSchema.shape.query.optional(),
+		query: z.string().min(1).max(maxExpertJobQueryLength),
 		interactiveToolCallResult: z.boolean().optional(),
-		files: z.union([z.instanceof(File), z.array(z.instanceof(File))]).optional(),
 		provider: providerSchema.optional(),
 		model: jobSchema.shape.model.optional(),
 		reasoningBudget: reasoningBudgetSchema.optional(),
@@ -1301,17 +1235,23 @@ const response$6 = z.object({ data: z.object({ job: jobSchema }) });
 
 //#endregion
 //#region ../models/src/api/jobs/create.ts
-const request$5 = { body: z.object({
+const baseBodySchema = z.object({
 	applicationId: cuidSchema.describe("Application ID to create the job in"),
-	expertKey: expertKeyFieldSchema,
-	query: jobSchema.shape.query.optional(),
-	files: z.union([z.instanceof(File), z.array(z.instanceof(File))]).optional(),
+	query: z.string().min(1).max(maxExpertJobQueryLength),
 	provider: providerSchema,
 	model: jobSchema.shape.model.optional(),
 	reasoningBudget: reasoningBudgetSchema.optional(),
 	maxSteps: z.coerce.number().optional(),
 	maxRetries: z.coerce.number().optional()
-}) };
+});
+const request$5 = { body: baseBodySchema.extend({
+	expertKey: expertKeyFieldSchema.optional(),
+	draftRefId: cuidSchema.describe("Draft ref ID to run the job with").optional()
+}).refine((data) => {
+	const hasExpertKey = data.expertKey !== void 0;
+	const hasDraftRefId = data.draftRefId !== void 0;
+	return hasExpertKey && !hasDraftRefId || !hasExpertKey && hasDraftRefId;
+}, { message: "Either expertKey or draftRefId must be provided, but not both" }) };
 const response$5 = z.object({ data: z.object({ job: jobSchema }) });
 
 //#endregion
@@ -1320,7 +1260,12 @@ const request$4 = { query: z.object({
 	sort: z.enum(["createdAt", "updatedAt"]).optional(),
 	order: z.enum(["asc", "desc"]).optional(),
 	take: z.coerce.number().min(1).max(100).default(20),
-	skip: z.coerce.number().min(0).default(0)
+	skip: z.coerce.number().min(0).default(0),
+	expertScopeId: cuidSchema.optional(),
+	expertDraftScopeId: cuidSchema.optional(),
+	applicationId: cuidSchema.optional(),
+	statuses: z.preprocess((val) => typeof val === "string" ? val.split(",") : val, z.array(jobStatusSchema).optional()),
+	expertKeyFilter: z.string().max(100).optional()
 }) };
 const response$4 = z.object({
 	data: z.object({ jobs: z.array(jobSchema) }),
@@ -1444,59 +1389,6 @@ const request = {
 };
 const response = z.object({ data: z.object({ providerSetting: providerSettingResponseSchema }) });
 
-//#endregion
-//#region src/endpoints/api-keys.ts
-const BASE_PATH$6 = "/api/v1/api_keys";
-function createApiKeysApi(fetcher) {
-	return {
-		async create(input, options) {
-			const result = request$22.body.safeParse(input);
-			if (!result.success) return {
-				ok: false,
-				error: createValidationError(result.error)
-			};
-			return fetcher.post(BASE_PATH$6, input, options);
-		},
-		async list(input, options) {
-			const queryParams = new URLSearchParams();
-			if (input?.take !== void 0) queryParams.set("take", String(input.take));
-			if (input?.skip !== void 0) queryParams.set("skip", String(input.skip));
-			const queryString = queryParams.toString();
-			const url = queryString ? `${BASE_PATH$6}?${queryString}` : BASE_PATH$6;
-			return fetcher.get(url, options);
-		},
-		async get(id, options) {
-			const result = request$21.params.safeParse({ apiKeyId: id });
-			if (!result.success) return {
-				ok: false,
-				error: createValidationError(result.error)
-			};
-			return fetcher.get(`${BASE_PATH$6}/${id}`, options);
-		},
-		async revoke(id, options) {
-			const result = request$20.params.safeParse({ apiKeyId: id });
-			if (!result.success) return {
-				ok: false,
-				error: createValidationError(result.error)
-			};
-			return fetcher.post(`${BASE_PATH$6}/${id}/revoke`, {}, options);
-		},
-		async update(id, input, options) {
-			const paramsResult = request$19.params.safeParse({ apiKeyId: id });
-			if (!paramsResult.success) return {
-				ok: false,
-				error: createValidationError(paramsResult.error)
-			};
-			const bodyResult = request$19.body.safeParse(input);
-			if (!bodyResult.success) return {
-				ok: false,
-				error: createValidationError(bodyResult.error)
-			};
-			return fetcher.post(`${BASE_PATH$6}/${id}`, input, options);
-		}
-	};
-}
-
 //#endregion
 //#region src/endpoints/applications.ts
 const BASE_PATH$5 = "/api/v1/applications";
@@ -1687,6 +1579,12 @@ function createExpertsApi(fetcher) {
 
 //#endregion
 //#region src/endpoints/jobs-checkpoints.ts
+function isErrorEventData(data) {
+	return typeof data === "object" && data !== null && "type" in data && typeof data.type === "string" && "jobId" in data && typeof data.jobId === "string";
+}
+function isCompleteEventData(data) {
+	return typeof data === "object" && data !== null && "status" in data && typeof data.status === "string" && "jobId" in data && typeof data.jobId === "string";
+}
 function createCheckpointsApi(fetcher, basePath) {
 	return {
 		async list(jobId, params, options) {
@@ -1736,6 +1634,49 @@ function createCheckpointsApi(fetcher, basePath) {
 					error: createNetworkError(error)
 				};
 			}
+		},
+		async *streamEvents(jobId, options) {
+			const result = await fetcher.getStream(`${basePath}/${jobId}/checkpoints/stream`, options);
+			if (!result.ok) {
+				yield {
+					ok: false,
+					error: result.error
+				};
+				return;
+			}
+			const reader = result.data.getReader();
+			try {
+				for await (const sseEvent of parseSSEEvents(reader)) if (sseEvent.event === "message") yield {
+					ok: true,
+					data: {
+						event: "message",
+						data: sseEvent.data
+					}
+				};
+				else if (sseEvent.event === "error" && isErrorEventData(sseEvent.data)) yield {
+					ok: true,
+					data: {
+						event: "error",
+						data: sseEvent.data
+					}
+				};
+				else if (sseEvent.event === "complete" && isCompleteEventData(sseEvent.data)) yield {
+					ok: true,
+					data: {
+						event: "complete",
+						data: sseEvent.data
+					}
+				};
+			} catch (error) {
+				if (error instanceof DOMException && error.name === "AbortError") yield {
+					ok: false,
+					error: createAbortError()
+				};
+				else yield {
+					ok: false,
+					error: createNetworkError(error)
+				};
+			}
 		}
 	};
 }
@@ -1849,7 +1790,6 @@ function createProviderSettingsApi(fetcher) {
 function createApiClient(config) {
 	const fetcher = createFetcher(config);
 	return {
-		apiKeys: createApiKeysApi(fetcher),
 		applications: createApplicationsApi(fetcher),
 		env: createEnvApi(fetcher),
 		jobs: createJobsApi(fetcher),
@@ -1859,5 +1799,5 @@ function createApiClient(config) {
 }
 
 //#endregion
-export { buildAuthHeaders, buildQueryString, createAbortError, createApiClient, createFetcher, createHttpError, createNetworkError, createTimeoutError, createValidationError, handleHttpError, isAbortError, isClientError, isHttpError, isNetworkError, isTimeoutError, isValidationError, matchExperts, matchOperations, matchWildcard, parseApiKeyPermissions, parseSSE, stringifyApiKeyPermissions };
+export { buildAuthHeaders, buildQueryString, createAbortError, createApiClient, createFetcher, createHttpError, createNetworkError, createTimeoutError, createValidationError, handleHttpError, isAbortError, isClientError, isHttpError, isNetworkError, isTimeoutError, isValidationError, matchExperts, matchOperations, matchWildcard, parseApiKeyPermissions, parseSSE, parseSSEEvents, stringifyApiKeyPermissions };
 //# sourceMappingURL=index.mjs.map