@agentuity/schedule 1.0.54

package/AGENTS.md

@@ -0,0 +1,37 @@
+# Agent Guidelines for @agentuity/schedule
+
+## Package Overview
+
+Standalone package for the Agentuity Schedule service. Provides a simple, ergonomic client for managing cron-based scheduled jobs.
+
+## Commands
+
+- **Build**: `bun run build`
+- **Typecheck**: `bun run typecheck`
+- **Clean**: `rm -rf dist`
+
+## Architecture
+
+- **Runtime**: Node.js and Bun compatible
+- **Exports**: ScheduleClient and all types from @agentuity/core/schedule
+- **Dependencies**: @agentuity/core, @agentuity/server, zod
+
+## Usage
+
+```typescript
+import { ScheduleClient } from '@agentuity/schedule';
+
+const client = new ScheduleClient();
+
+// Create a schedule
+const result = await client.create({
+  name: 'Hourly Sync',
+  expression: '0 * * * *',
+  destinations: [{ type: 'url', config: { url: 'https://example.com/sync' } }]
+});
+```
+
+## Publishing
+
+1. Run `bun run build`
+2. Must publish **after** @agentuity/core

package/README.md

@@ -0,0 +1,57 @@
+# @agentuity/schedule
+
+A standalone package for the Agentuity Schedule service.
+
+## Installation
+
+```bash
+npm install @agentuity/schedule
+```
+
+## Quick Start
+
+```typescript
+import { ScheduleClient } from '@agentuity/schedule';
+
+const client = new ScheduleClient();
+
+// Create a schedule that runs every hour
+const result = await client.create({
+  name: 'Hourly Sync',
+  expression: '0 * * * *',
+  destinations: [
+    { type: 'url', config: { url: 'https://example.com/sync' } }
+  ]
+});
+
+console.log('Created schedule:', result.schedule.id);
+console.log('Next run:', result.schedule.due_date);
+
+// List all schedules
+const { schedules, total } = await client.list();
+console.log(`Found ${total} schedules`);
+
+// Get schedule details
+const { schedule, destinations } = await client.get(result.schedule.id);
+```
+
+## Configuration
+
+```typescript
+const client = new ScheduleClient({
+  apiKey: 'your-api-key',
+  url: 'https://api.agentuity.com',
+});
+```
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `AGENTUITY_SDK_KEY` | API key for authentication | Required |
+| `AGENTUITY_REGION` | Region for API endpoints | `usc` |
+| `AGENTUITY_SCHEDULE_URL` | Override Schedule API URL | Auto-detected |
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+export { ScheduleService, type Schedule, type ScheduleDestination, type ScheduleDelivery, type CreateScheduleParams, type UpdateScheduleParams, type CreateScheduleDestinationParams, type ScheduleListResult, type ScheduleGetResult, type ScheduleCreateResult, type ScheduleDeliveryListResult, ScheduleSchema, ScheduleDestinationSchema, ScheduleDeliverySchema, CreateScheduleParamsSchema, UpdateScheduleParamsSchema, CreateScheduleDestinationParamsSchema, ScheduleListResultSchema, ScheduleGetResultSchema, ScheduleCreateResultSchema, ScheduleDeliveryListResultSchema, } from '@agentuity/core/schedule';
+import { type CreateScheduleParams, type UpdateScheduleParams, type CreateScheduleDestinationParams, type ScheduleGetResult, type ScheduleListResult, type ScheduleCreateResult, type ScheduleDeliveryListResult, type Schedule, type ScheduleDestination } from '@agentuity/core/schedule';
+import { type Logger } from '@agentuity/server';
+import { z } from 'zod';
+export declare const ScheduleClientOptionsSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    url: z.ZodOptional<z.ZodString>;
+    orgId: z.ZodOptional<z.ZodString>;
+    logger: z.ZodOptional<z.ZodCustom<Logger, Logger>>;
+}, z.core.$strip>;
+export type ScheduleClientOptions = z.infer<typeof ScheduleClientOptionsSchema>;
+export declare class ScheduleClient {
+    #private;
+    constructor(options?: ScheduleClientOptions);
+    create(params: CreateScheduleParams): Promise<ScheduleCreateResult>;
+    list(params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ScheduleListResult>;
+    get(scheduleId: string): Promise<ScheduleGetResult>;
+    update(scheduleId: string, params: UpdateScheduleParams): Promise<{
+        schedule: Schedule;
+    }>;
+    delete(scheduleId: string): Promise<void>;
+    createDestination(scheduleId: string, params: CreateScheduleDestinationParams): Promise<{
+        destination: ScheduleDestination;
+    }>;
+    deleteDestination(destinationId: string): Promise<void>;
+    listDeliveries(scheduleId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ScheduleDeliveryListResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,eAAe,EACf,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,cAAc,EACd,yBAAyB,EACzB,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,qCAAqC,EACrC,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,gCAAgC,GAChC,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAEN,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAgD,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI9F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,2BAA2B;;;;;iBAKtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,qBAAa,cAAc;;gBAGd,OAAO,GAAE,qBAA0B;IAoBzC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAInE,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAI/E,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAInD,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAIzF,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,+BAA+B,GACrC,OAAO,CAAC;QAAE,WAAW,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAI1C,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,cAAc,CACnB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1C,OAAO,CAAC,0BAA0B,CAAC;CAGtC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+export { ScheduleService, ScheduleSchema, ScheduleDestinationSchema, ScheduleDeliverySchema, CreateScheduleParamsSchema, UpdateScheduleParamsSchema, CreateScheduleDestinationParamsSchema, ScheduleListResultSchema, ScheduleGetResultSchema, ScheduleCreateResultSchema, ScheduleDeliveryListResultSchema, } from '@agentuity/core/schedule';
+import { ScheduleService, } from '@agentuity/core/schedule';
+import { createServerFetchAdapter, buildClientHeaders } from '@agentuity/server';
+import { createMinimalLogger } from '@agentuity/core';
+import { getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { z } from 'zod';
+const isLogger = (val) => typeof val === 'object' &&
+    val !== null &&
+    ['info', 'warn', 'error', 'debug', 'trace'].every((m) => typeof val[m] === 'function');
+export const ScheduleClientOptionsSchema = z.object({
+    apiKey: z.string().optional().describe('API key for authentication'),
+    url: z.string().optional().describe('Base URL for the Schedule API'),
+    orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+    logger: z.custom(isLogger).optional().describe('Custom logger instance'),
+});
+export class ScheduleClient {
+    #service;
+    constructor(options = {}) {
+        const validatedOptions = ScheduleClientOptionsSchema.parse(options);
+        const apiKey = validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
+        const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+        const serviceUrls = getServiceUrls(region);
+        const url = validatedOptions.url || getEnv('AGENTUITY_SCHEDULE_URL') || serviceUrls.catalyst;
+        const logger = validatedOptions.logger ?? createMinimalLogger();
+        const headers = buildClientHeaders({
+            apiKey,
+            orgId: validatedOptions.orgId,
+        });
+        const adapter = createServerFetchAdapter({ headers }, logger);
+        this.#service = new ScheduleService(url, adapter);
+    }
+    async create(params) {
+        return this.#service.create(params);
+    }
+    async list(params) {
+        return this.#service.list(params);
+    }
+    async get(scheduleId) {
+        return this.#service.get(scheduleId);
+    }
+    async update(scheduleId, params) {
+        return this.#service.update(scheduleId, params);
+    }
+    async delete(scheduleId) {
+        return this.#service.delete(scheduleId);
+    }
+    async createDestination(scheduleId, params) {
+        return this.#service.createDestination(scheduleId, params);
+    }
+    async deleteDestination(destinationId) {
+        return this.#service.deleteDestination(destinationId);
+    }
+    async listDeliveries(scheduleId, params) {
+        return this.#service.listDeliveries(scheduleId, params);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+	"name": "@agentuity/schedule",
+	"version": "1.0.54",
+	"license": "Apache-2.0",
+	"author": "Agentuity employees and contributors",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"AGENTS.md",
+		"README.md",
+		"src",
+		"dist"
+	],
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"clean": "rm -rf dist tsconfig.tsbuildinfo",
+		"build": "bunx tsc --build --force",
+		"typecheck": "bunx tsc --noEmit",
+		"prepublishOnly": "bun run clean && bun run build"
+	},
+	"dependencies": {
+		"@agentuity/core": "1.0.54",
+		"@agentuity/server": "1.0.54",
+		"zod": "^4.3.5"
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"@types/node": "^22.0.0",
+		"bun-types": "latest",
+		"typescript": "^5.9.0"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"sideEffects": false
+}

package/src/index.ts

@@ -0,0 +1,118 @@
+export {
+	ScheduleService,
+	type Schedule,
+	type ScheduleDestination,
+	type ScheduleDelivery,
+	type CreateScheduleParams,
+	type UpdateScheduleParams,
+	type CreateScheduleDestinationParams,
+	type ScheduleListResult,
+	type ScheduleGetResult,
+	type ScheduleCreateResult,
+	type ScheduleDeliveryListResult,
+	ScheduleSchema,
+	ScheduleDestinationSchema,
+	ScheduleDeliverySchema,
+	CreateScheduleParamsSchema,
+	UpdateScheduleParamsSchema,
+	CreateScheduleDestinationParamsSchema,
+	ScheduleListResultSchema,
+	ScheduleGetResultSchema,
+	ScheduleCreateResultSchema,
+	ScheduleDeliveryListResultSchema,
+} from '@agentuity/core/schedule';
+
+import {
+	ScheduleService,
+	type CreateScheduleParams,
+	type UpdateScheduleParams,
+	type CreateScheduleDestinationParams,
+	type ScheduleGetResult,
+	type ScheduleListResult,
+	type ScheduleCreateResult,
+	type ScheduleDeliveryListResult,
+	type Schedule,
+	type ScheduleDestination,
+} from '@agentuity/core/schedule';
+import { createServerFetchAdapter, buildClientHeaders, type Logger } from '@agentuity/server';
+import { createMinimalLogger } from '@agentuity/core';
+import { getEnv } from '@agentuity/core';
+import { getServiceUrls } from '@agentuity/core/config';
+import { z } from 'zod';
+
+const isLogger = (val: unknown): val is Logger =>
+	typeof val === 'object' &&
+	val !== null &&
+	['info', 'warn', 'error', 'debug', 'trace'].every(
+		(m) => typeof (val as Record<string, unknown>)[m] === 'function'
+	);
+
+export const ScheduleClientOptionsSchema = z.object({
+	apiKey: z.string().optional().describe('API key for authentication'),
+	url: z.string().optional().describe('Base URL for the Schedule API'),
+	orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+	logger: z.custom<Logger>(isLogger).optional().describe('Custom logger instance'),
+});
+export type ScheduleClientOptions = z.infer<typeof ScheduleClientOptionsSchema>;
+
+export class ScheduleClient {
+	readonly #service: ScheduleService;
+
+	constructor(options: ScheduleClientOptions = {}) {
+		const validatedOptions = ScheduleClientOptionsSchema.parse(options);
+		const apiKey =
+			validatedOptions.apiKey || getEnv('AGENTUITY_SDK_KEY') || getEnv('AGENTUITY_CLI_KEY');
+		const region = getEnv('AGENTUITY_REGION') ?? 'usc';
+		const serviceUrls = getServiceUrls(region);
+
+		const url = validatedOptions.url || getEnv('AGENTUITY_SCHEDULE_URL') || serviceUrls.catalyst;
+
+		const logger = validatedOptions.logger ?? createMinimalLogger();
+
+		const headers = buildClientHeaders({
+			apiKey,
+			orgId: validatedOptions.orgId,
+		});
+
+		const adapter = createServerFetchAdapter({ headers }, logger);
+		this.#service = new ScheduleService(url, adapter);
+	}
+
+	async create(params: CreateScheduleParams): Promise<ScheduleCreateResult> {
+		return this.#service.create(params);
+	}
+
+	async list(params?: { limit?: number; offset?: number }): Promise<ScheduleListResult> {
+		return this.#service.list(params);
+	}
+
+	async get(scheduleId: string): Promise<ScheduleGetResult> {
+		return this.#service.get(scheduleId);
+	}
+
+	async update(scheduleId: string, params: UpdateScheduleParams): Promise<{ schedule: Schedule }> {
+		return this.#service.update(scheduleId, params);
+	}
+
+	async delete(scheduleId: string): Promise<void> {
+		return this.#service.delete(scheduleId);
+	}
+
+	async createDestination(
+		scheduleId: string,
+		params: CreateScheduleDestinationParams
+	): Promise<{ destination: ScheduleDestination }> {
+		return this.#service.createDestination(scheduleId, params);
+	}
+
+	async deleteDestination(destinationId: string): Promise<void> {
+		return this.#service.deleteDestination(destinationId);
+	}
+
+	async listDeliveries(
+		scheduleId: string,
+		params?: { limit?: number; offset?: number }
+	): Promise<ScheduleDeliveryListResult> {
+		return this.#service.listDeliveries(scheduleId, params);
+	}
+}