@agentuity/core 1.0.32 → 1.0.33

package/src/services/keyvalue.ts

@@ -344,7 +344,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	async get<T>(name: string, key: string): Promise<DataResult<T>> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/kv/2025-03-17/${encodeURIComponent(name)}/${encodeURIComponent(key)}`
+			`/kv/${encodeURIComponent(name)}/${encodeURIComponent(key)}`
 		);
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 		const res = await this.#adapter.invoke<T>(url, {
@@ -406,7 +406,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 		}
 		const url = buildUrl(
 			this.#baseUrl,
-			`/kv/2025-03-17/${encodeURIComponent(name)}/${encodeURIComponent(key)}${ttlstr}`
+			`/kv/${encodeURIComponent(name)}/${encodeURIComponent(key)}${ttlstr}`
 		);
 		const [body, contentType] = await toPayload(value);
 		const signal = AbortSignal.timeout(30_000);
@@ -433,7 +433,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	async delete(name: string, key: string): Promise<void> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/kv/2025-03-17/${encodeURIComponent(name)}/${encodeURIComponent(key)}`
+			`/kv/${encodeURIComponent(name)}/${encodeURIComponent(key)}`
 		);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke(url, {
@@ -454,7 +454,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	}
 
 	async getStats(name: string): Promise<KeyValueStats> {
-		const url = buildUrl(this.#baseUrl, `/kv/2025-03-17/stats/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/kv/stats/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 		const res = await this.#adapter.invoke<KeyValueStats>(url, {
 			method: 'GET',
@@ -502,10 +502,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 			queryParams.set('agent_name', params.agentName);
 		}
 		const queryString = queryParams.toString();
-		const url = buildUrl(
-			this.#baseUrl,
-			`/kv/2025-03-17/stats${queryString ? `?${queryString}` : ''}`
-		);
+		const url = buildUrl(this.#baseUrl, `/kv/stats${queryString ? `?${queryString}` : ''}`);
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 		const res = await this.#adapter.invoke<
 			Record<string, KeyValueStats> | KeyValueStatsPaginated
@@ -524,7 +521,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	}
 
 	async getNamespaces(): Promise<string[]> {
-		const url = buildUrl(this.#baseUrl, '/kv/2025-03-17/namespaces');
+		const url = buildUrl(this.#baseUrl, '/kv/namespaces');
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 		const res = await this.#adapter.invoke<string[]>(url, {
 			method: 'GET',
@@ -546,7 +543,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	): Promise<Record<string, KeyValueItemWithMetadata<T>>> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/kv/2025-03-17/search/${encodeURIComponent(name)}/${encodeURIComponent(keyword)}`
+			`/kv/search/${encodeURIComponent(name)}/${encodeURIComponent(keyword)}`
 		);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<Record<string, KeyValueItemWithMetadata<T>>>(url, {
@@ -564,7 +561,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	}
 
 	async getKeys(name: string): Promise<string[]> {
-		const url = buildUrl(this.#baseUrl, `/kv/2025-03-17/keys/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/kv/keys/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<string[]>(url, {
 			method: 'GET',
@@ -581,7 +578,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	}
 
 	async deleteNamespace(name: string): Promise<void> {
-		const url = buildUrl(this.#baseUrl, `/kv/2025-03-17/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/kv/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke(url, {
 			method: 'DELETE',
@@ -598,7 +595,7 @@ export class KeyValueStorageService implements KeyValueStorage {
 	}
 
 	async createNamespace(name: string, params?: CreateNamespaceParams): Promise<void> {
-		const url = buildUrl(this.#baseUrl, `/kv/2025-03-17/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/kv/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 
 		const body =

package/src/services/queue.ts

@@ -424,7 +424,7 @@ export class QueueStorageService implements QueueService {
 			});
 		}
 
-		const basePath = `/queue/messages/publish/2026-01-15/${encodeURIComponent(queueName)}`;
+		const basePath = `/queue/messages/publish/${encodeURIComponent(queueName)}`;
 		const url = buildUrl(this.#baseUrl, params?.sync ? `${basePath}?sync=true` : basePath);
 
 		const requestBody: Record<string, unknown> = {
@@ -499,7 +499,7 @@ export class QueueStorageService implements QueueService {
 			};
 		}
 
-		const url = buildUrl(this.#baseUrl, '/queue/create/2026-01-15');
+		const url = buildUrl(this.#baseUrl, '/queue/create');
 
 		const requestBody: Record<string, unknown> = {
 			name: queueName,
@@ -573,10 +573,7 @@ export class QueueStorageService implements QueueService {
 	async deleteQueue(queueName: string): Promise<void> {
 		validateQueueNameInternal(queueName);
 
-		const url = buildUrl(
-			this.#baseUrl,
-			`/queue/delete/2026-01-15/${encodeURIComponent(queueName)}`
-		);
+		const url = buildUrl(this.#baseUrl, `/queue/delete/${encodeURIComponent(queueName)}`);
 
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<void>(url, {

package/src/services/schedule.ts

@@ -361,7 +361,7 @@ export class ScheduleService {
 	 * ```
 	 */
 	async create(params: CreateScheduleParams): Promise<ScheduleCreateResult> {
-		const url = buildUrl(this.#baseUrl, '/schedule/create/2026-02-24');
+		const url = buildUrl(this.#baseUrl, '/schedule/create');
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<ScheduleCreateResult>(url, {
 			method: 'POST',
@@ -412,9 +412,7 @@ export class ScheduleService {
 			qs.set('offset', String(params.offset));
 		}
 
-		const path = qs.toString()
-			? `/schedule/list/2026-02-24?${qs.toString()}`
-			: '/schedule/list/2026-02-24';
+		const path = qs.toString() ? `/schedule/list?${qs.toString()}` : '/schedule/list';
 		const url = buildUrl(this.#baseUrl, path);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<ScheduleListResult>(url, {
@@ -452,10 +450,7 @@ export class ScheduleService {
 	 * ```
 	 */
 	async get(scheduleId: string): Promise<ScheduleGetResult> {
-		const url = buildUrl(
-			this.#baseUrl,
-			`/schedule/get/2026-02-24/${encodeURIComponent(scheduleId)}`
-		);
+		const url = buildUrl(this.#baseUrl, `/schedule/get/${encodeURIComponent(scheduleId)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<ScheduleGetResult>(url, {
 			method: 'GET',
@@ -501,10 +496,7 @@ export class ScheduleService {
 	 * ```
 	 */
 	async update(scheduleId: string, params: UpdateScheduleParams): Promise<{ schedule: Schedule }> {
-		const url = buildUrl(
-			this.#baseUrl,
-			`/schedule/update/2026-02-24/${encodeURIComponent(scheduleId)}`
-		);
+		const url = buildUrl(this.#baseUrl, `/schedule/update/${encodeURIComponent(scheduleId)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<{ schedule: Schedule }>(url, {
 			method: 'PUT',
@@ -539,10 +531,7 @@ export class ScheduleService {
 	 * ```
 	 */
 	async delete(scheduleId: string): Promise<void> {
-		const url = buildUrl(
-			this.#baseUrl,
-			`/schedule/delete/2026-02-24/${encodeURIComponent(scheduleId)}`
-		);
+		const url = buildUrl(this.#baseUrl, `/schedule/delete/${encodeURIComponent(scheduleId)}`);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<void>(url, {
 			method: 'DELETE',
@@ -588,7 +577,7 @@ export class ScheduleService {
 	): Promise<{ destination: ScheduleDestination }> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/schedule/destinations/create/2026-02-24/${encodeURIComponent(scheduleId)}`
+			`/schedule/destinations/create/${encodeURIComponent(scheduleId)}`
 		);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<{ destination: ScheduleDestination }>(url, {
@@ -627,7 +616,7 @@ export class ScheduleService {
 	async deleteDestination(destinationId: string): Promise<void> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/schedule/destinations/delete/2026-02-24/${encodeURIComponent(destinationId)}`
+			`/schedule/destinations/delete/${encodeURIComponent(destinationId)}`
 		);
 		const signal = AbortSignal.timeout(30_000);
 		const res = await this.#adapter.invoke<void>(url, {
@@ -681,7 +670,7 @@ export class ScheduleService {
 			qs.set('offset', String(params.offset));
 		}
 
-		const basePath = `/schedule/deliveries/2026-02-24/${encodeURIComponent(scheduleId)}`;
+		const basePath = `/schedule/deliveries/${encodeURIComponent(scheduleId)}`;
 		const path = qs.toString() ? `${basePath}?${qs.toString()}` : basePath;
 		const url = buildUrl(this.#baseUrl, path);
 		const signal = AbortSignal.timeout(30_000);

package/src/services/stream.ts

@@ -116,9 +116,9 @@ export interface StreamInfo {
 	sizeBytes: number;
 
 	/**
-	 * ISO 8601 timestamp when stream expires, or undefined if stream never expires
+	 * ISO 8601 timestamp when stream expires, or null if stream never expires
 	 */
-	expiresAt?: string;
+	expiresAt: string | null;
 }
 
 /**
@@ -792,7 +792,7 @@ export class StreamStorageService implements StreamStorage {
 					metadata: s.metadata ?? {},
 					url: s.url,
 					sizeBytes: s.size_bytes,
-					...(s.expires_at && { expiresAt: s.expires_at }),
+					expiresAt: s.expires_at ?? null,
 				})),
 				total: res.data.total,
 			};
@@ -833,7 +833,7 @@ export class StreamStorageService implements StreamStorage {
 				metadata: res.data.metadata ?? {},
 				url: res.data.url,
 				sizeBytes: res.data.size_bytes,
-				...(res.data.expires_at && { expiresAt: res.data.expires_at }),
+				expiresAt: res.data.expires_at ?? null,
 			};
 		}
 		throw await toServiceException('POST', url, res.response);

package/src/services/vector.ts

@@ -721,7 +721,7 @@ export class VectorStorageService implements VectorStorage {
 			}
 		}
 
-		const url = buildUrl(this.#baseUrl, `/vector/2025-03-17/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/vector/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000);
 
 		// Transform documents to handle TTL: null → 0 for "no expiration"
@@ -780,7 +780,7 @@ export class VectorStorageService implements VectorStorage {
 
 		const url = buildUrl(
 			this.#baseUrl,
-			`/vector/2025-03-17/${encodeURIComponent(name)}/${encodeURIComponent(key)}`
+			`/vector/${encodeURIComponent(name)}/${encodeURIComponent(key)}`
 		);
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 
@@ -881,7 +881,7 @@ export class VectorStorageService implements VectorStorage {
 			}
 		}
 
-		const url = buildUrl(this.#baseUrl, `/vector/2025-03-17/search/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/vector/search/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000);
 
 		const attributes: Record<string, string> = {
@@ -946,10 +946,10 @@ export class VectorStorageService implements VectorStorage {
 		if (keys.length === 1 && firstKey) {
 			url = buildUrl(
 				this.#baseUrl,
-				`/vector/2025-03-17/${encodeURIComponent(name)}/${encodeURIComponent(firstKey)}`
+				`/vector/${encodeURIComponent(name)}/${encodeURIComponent(firstKey)}`
 			);
 		} else {
-			url = buildUrl(this.#baseUrl, `/vector/2025-03-17/${encodeURIComponent(name)}`);
+			url = buildUrl(this.#baseUrl, `/vector/${encodeURIComponent(name)}`);
 			body = safeStringify({ keys });
 		}
 
@@ -998,7 +998,7 @@ export class VectorStorageService implements VectorStorage {
 			throw new VectorStorageNameRequiredError();
 		}
 
-		const url = buildUrl(this.#baseUrl, `/vector/2025-03-17/stats/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/vector/stats/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 
 		const res = await this.#adapter.invoke<VectorStatsResponse>(url, {
@@ -1043,10 +1043,7 @@ export class VectorStorageService implements VectorStorage {
 			queryParams.set('name', params.name);
 		}
 		const queryString = queryParams.toString();
-		const url = buildUrl(
-			this.#baseUrl,
-			`/vector/2025-03-17/stats${queryString ? `?${queryString}` : ''}`
-		);
+		const url = buildUrl(this.#baseUrl, `/vector/stats${queryString ? `?${queryString}` : ''}`);
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 
 		const res = await this.#adapter.invoke<
@@ -1068,7 +1065,7 @@ export class VectorStorageService implements VectorStorage {
 	}
 
 	async getNamespaces(): Promise<string[]> {
-		const url = buildUrl(this.#baseUrl, '/vector/2025-03-17/namespaces');
+		const url = buildUrl(this.#baseUrl, '/vector/namespaces');
 		const signal = AbortSignal.timeout(30_000); // 30s timeout for Neon cold starts
 		const res = await this.#adapter.invoke<string[]>(url, {
 			method: 'GET',
@@ -1089,7 +1086,7 @@ export class VectorStorageService implements VectorStorage {
 			throw new VectorStorageNameRequiredError();
 		}
 
-		const url = buildUrl(this.#baseUrl, `/vector/2025-03-17/${encodeURIComponent(name)}`);
+		const url = buildUrl(this.#baseUrl, `/vector/${encodeURIComponent(name)}`);
 		const signal = AbortSignal.timeout(30_000);
 
 		const res = await this.#adapter.invoke<VectorDeleteNamespaceResponse>(url, {

package/src/services/webhook.ts

@@ -49,10 +49,11 @@ export interface Webhook {
 
 	/**
 	 * The fully-qualified ingest URL where HTTP requests should be sent.
+	 * Only present when the webhook is first created.
 	 *
 	 * @remarks Format: `https://<catalyst-url>/webhook/<orgId>-<webhookId>`
 	 */
-	url: string;
+	url?: string;
 }
 
 /**
@@ -371,7 +372,7 @@ export class WebhookService {
 	 * ```
 	 */
 	async create(params: CreateWebhookParams): Promise<WebhookCreateResult> {
-		const url = buildUrl(this.#baseUrl, '/webhook/2026-02-24/create');
+		const url = buildUrl(this.#baseUrl, '/webhook/create');
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<Webhook>>(url, {
 			method: 'POST',
@@ -421,9 +422,7 @@ export class WebhookService {
 			qs.set('offset', String(params.offset));
 		}
 
-		const path = qs.toString()
-			? `/webhook/2026-02-24/list?${qs.toString()}`
-			: '/webhook/2026-02-24/list';
+		const path = qs.toString() ? `/webhook/list?${qs.toString()}` : '/webhook/list';
 		const url = buildUrl(this.#baseUrl, path);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<Webhook[]>>(url, {
@@ -469,10 +468,7 @@ export class WebhookService {
 	 * ```
 	 */
 	async get(webhookId: string): Promise<WebhookGetResult> {
-		const url = buildUrl(
-			this.#baseUrl,
-			`/webhook/2026-02-24/get/${encodeURIComponent(webhookId)}`
-		);
+		const url = buildUrl(this.#baseUrl, `/webhook/get/${encodeURIComponent(webhookId)}`);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<Webhook>>(url, {
 			method: 'GET',
@@ -514,10 +510,7 @@ export class WebhookService {
 	 * ```
 	 */
 	async update(webhookId: string, params: UpdateWebhookParams): Promise<UpdateWebhookResult> {
-		const url = buildUrl(
-			this.#baseUrl,
-			`/webhook/2026-02-24/update/${encodeURIComponent(webhookId)}`
-		);
+		const url = buildUrl(this.#baseUrl, `/webhook/update/${encodeURIComponent(webhookId)}`);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<Webhook>>(url, {
 			method: 'PUT',
@@ -555,10 +548,7 @@ export class WebhookService {
 	 * ```
 	 */
 	async delete(webhookId: string): Promise<void> {
-		const url = buildUrl(
-			this.#baseUrl,
-			`/webhook/2026-02-24/delete/${encodeURIComponent(webhookId)}`
-		);
+		const url = buildUrl(this.#baseUrl, `/webhook/delete/${encodeURIComponent(webhookId)}`);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<null>>(url, {
 			method: 'DELETE',
@@ -611,7 +601,7 @@ export class WebhookService {
 	): Promise<CreateDestinationResult> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/webhook/2026-02-24/destination-create/${encodeURIComponent(webhookId)}`
+			`/webhook/destination-create/${encodeURIComponent(webhookId)}`
 		);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<WebhookDestination>>(url, {
@@ -656,7 +646,7 @@ export class WebhookService {
 	async listDestinations(webhookId: string): Promise<ListDestinationsResult> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/webhook/2026-02-24/destination-list/${encodeURIComponent(webhookId)}`
+			`/webhook/destination-list/${encodeURIComponent(webhookId)}`
 		);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<WebhookDestination[]>>(url, {
@@ -696,7 +686,7 @@ export class WebhookService {
 	async deleteDestination(webhookId: string, destinationId: string): Promise<void> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/webhook/2026-02-24/destination-delete/${encodeURIComponent(webhookId)}/${encodeURIComponent(destinationId)}`
+			`/webhook/destination-delete/${encodeURIComponent(webhookId)}/${encodeURIComponent(destinationId)}`
 		);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<null>>(url, {
@@ -754,7 +744,7 @@ export class WebhookService {
 			qs.set('offset', String(params.offset));
 		}
 
-		const basePath = `/webhook/2026-02-24/receipt-list/${encodeURIComponent(webhookId)}`;
+		const basePath = `/webhook/receipt-list/${encodeURIComponent(webhookId)}`;
 		const path = qs.toString() ? `${basePath}?${qs.toString()}` : basePath;
 		const url = buildUrl(this.#baseUrl, path);
 		const signal = createTimeoutSignal();
@@ -799,7 +789,7 @@ export class WebhookService {
 	async getReceipt(webhookId: string, receiptId: string): Promise<WebhookReceipt> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/webhook/2026-02-24/receipt-get/${encodeURIComponent(webhookId)}/${encodeURIComponent(receiptId)}`
+			`/webhook/receipt-get/${encodeURIComponent(webhookId)}/${encodeURIComponent(receiptId)}`
 		);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<WebhookReceipt>>(url, {
@@ -852,7 +842,7 @@ export class WebhookService {
 			qs.set('offset', String(params.offset));
 		}
 
-		const basePath = `/webhook/2026-02-24/delivery-list/${encodeURIComponent(webhookId)}`;
+		const basePath = `/webhook/delivery-list/${encodeURIComponent(webhookId)}`;
 		const path = qs.toString() ? `${basePath}?${qs.toString()}` : basePath;
 		const url = buildUrl(this.#baseUrl, path);
 		const signal = createTimeoutSignal();
@@ -901,7 +891,7 @@ export class WebhookService {
 	async retryDelivery(webhookId: string, deliveryId: string): Promise<void> {
 		const url = buildUrl(
 			this.#baseUrl,
-			`/webhook/2026-02-24/delivery-retry/${encodeURIComponent(webhookId)}/${encodeURIComponent(deliveryId)}`
+			`/webhook/delivery-retry/${encodeURIComponent(webhookId)}/${encodeURIComponent(deliveryId)}`
 		);
 		const signal = createTimeoutSignal();
 		const res = await this.#adapter.invoke<WebhookResponse<null>>(url, {