@agentuity/task 1.0.54

package/AGENTS.md

@@ -0,0 +1,40 @@
+# Agent Guidelines for @agentuity/task
+
+## Package Overview
+
+Standalone package for the Agentuity Task service. Provides a simple, ergonomic client for managing tasks, comments, tags, and attachments in a lightweight task tracking system.
+
+## Commands
+
+- **Build**: `bun run build`
+- **Typecheck**: `bun run typecheck`
+- **Clean**: `rm -rf dist`
+
+## Architecture
+
+- **Runtime**: Node.js and Bun compatible
+- **Exports**: TaskClient and all types from @agentuity/core/task
+- **Dependencies**: @agentuity/core, @agentuity/server, zod
+
+## Usage
+
+```typescript
+import { TaskClient } from '@agentuity/task';
+
+const client = new TaskClient();
+
+// Create a task
+const task = await client.create({
+  title: 'Implement feature',
+  description: 'Add new feature to the system',
+  priority: 'high'
+});
+
+// Add a comment
+await client.createComment(task.id, 'Started working on this');
+```
+
+## Publishing
+
+1. Run `bun run build`
+2. Must publish **after** @agentuity/core

package/README.md

@@ -0,0 +1,59 @@
+# @agentuity/task
+
+A standalone package for the Agentuity Task service - a lightweight task tracking system.
+
+## Installation
+
+```bash
+npm install @agentuity/task
+```
+
+## Quick Start
+
+```typescript
+import { TaskClient } from '@agentuity/task';
+
+const client = new TaskClient();
+
+// Create a task
+const task = await client.create({
+  title: 'Implement new feature',
+  description: 'Add support for batch operations',
+  priority: 'high',
+  type: 'feature'
+});
+
+console.log('Created task:', task.id);
+
+// Add a comment
+await client.createComment(task.id, 'Started working on this task');
+
+// Create and assign tags
+const tag = await client.createTag('backend', '#3366cc');
+await client.addTagToTask(task.id, tag.id);
+
+// List tasks
+const { tasks, total } = await client.list({ status: 'open' });
+console.log(`Found ${total} open tasks`);
+```
+
+## Configuration
+
+```typescript
+const client = new TaskClient({
+  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_TASK_URL` | Override Task API URL | Auto-detected |
+
+## License
+
+Apache-2.0

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+export { TaskStorageService, type Task, type Comment, type Tag, type TaskChangelogEntry, type TaskChangelogResult, type CreateTaskParams, type UpdateTaskParams, type ListTasksParams, type ListTasksResult, type BatchDeleteTasksParams, type BatchDeleteTasksResult, type CreateUserParams, type CreateProjectParams, type ListCommentsResult, type ListTagsResult, type Attachment, type CreateAttachmentParams, type PresignUploadResponse, type PresignDownloadResponse, type ListAttachmentsResult, type ListUsersResult, type ListProjectsResult, type TaskActivityParams, type TaskActivityResult, type TaskPriority, type TaskType, type TaskStatus, type EntityRef, type UserEntityRef, type UserType, TaskSchema, TaskPrioritySchema, TaskTypeSchema, TaskStatusSchema, EntityRefSchema, UserTypeSchema, UserEntityRefSchema, CommentSchema, TagSchema, TaskChangelogEntrySchema, CreateTaskParamsSchema, UpdateTaskParamsSchema, ListTasksParamsSchema, ListTasksResultSchema, BatchDeleteTasksParamsSchema, BatchDeleteTasksResultSchema, TaskChangelogResultSchema, ListCommentsResultSchema, ListTagsResultSchema, AttachmentSchema, CreateAttachmentParamsSchema, PresignUploadResponseSchema, PresignDownloadResponseSchema, ListAttachmentsResultSchema, ListUsersResultSchema, ListProjectsResultSchema, TaskActivityParamsSchema, TaskActivityResultSchema, normalizeTaskStatus, } from '@agentuity/core/task';
+import { type CreateTaskParams, type UpdateTaskParams, type ListTasksParams, type ListTasksResult, type Task, type Comment, type Tag, type TaskChangelogResult, type ListCommentsResult, type CreateAttachmentParams, type PresignUploadResponse, type PresignDownloadResponse, type ListAttachmentsResult, type ListUsersResult, type ListProjectsResult, type TaskActivityResult, type TaskActivityParams, type Attachment, type EntityRef } from '@agentuity/core/task';
+import { type Logger } from '@agentuity/server';
+import { z } from 'zod';
+export declare const TaskClientOptionsSchema: 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 TaskClientOptions = z.infer<typeof TaskClientOptionsSchema>;
+export declare class TaskClient {
+    #private;
+    constructor(options?: TaskClientOptions);
+    create(params: CreateTaskParams): Promise<Task>;
+    get(id: string): Promise<Task | null>;
+    list(params?: ListTasksParams): Promise<ListTasksResult>;
+    update(id: string, params: UpdateTaskParams): Promise<Task>;
+    close(id: string): Promise<Task>;
+    softDelete(id: string): Promise<Task>;
+    changelog(id: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<TaskChangelogResult>;
+    createComment(taskId: string, body: string, userId: string, author?: EntityRef): Promise<Comment>;
+    getComment(commentId: string): Promise<Comment | null>;
+    updateComment(commentId: string, body: string): Promise<Comment>;
+    deleteComment(commentId: string): Promise<void>;
+    listComments(taskId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ListCommentsResult>;
+    createTag(name: string, color?: string): Promise<Tag>;
+    getTag(tagId: string): Promise<Tag | null>;
+    updateTag(tagId: string, name: string, color?: string): Promise<Tag>;
+    deleteTag(tagId: string): Promise<void>;
+    listTags(): Promise<Tag[]>;
+    addTagToTask(taskId: string, tagId: string): Promise<void>;
+    removeTagFromTask(taskId: string, tagId: string): Promise<void>;
+    listTagsForTask(taskId: string): Promise<Tag[]>;
+    uploadAttachment(taskId: string, params: CreateAttachmentParams): Promise<PresignUploadResponse>;
+    confirmAttachment(attachmentId: string): Promise<Attachment>;
+    downloadAttachment(attachmentId: string): Promise<PresignDownloadResponse>;
+    listAttachments(taskId: string): Promise<ListAttachmentsResult>;
+    deleteAttachment(attachmentId: string): Promise<void>;
+    listUsers(): Promise<ListUsersResult>;
+    listProjects(): Promise<ListProjectsResult>;
+    getActivity(params?: TaskActivityParams): Promise<TaskActivityResult>;
+}
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,119 @@
+export { TaskStorageService, TaskSchema, TaskPrioritySchema, TaskTypeSchema, TaskStatusSchema, EntityRefSchema, UserTypeSchema, UserEntityRefSchema, CommentSchema, TagSchema, TaskChangelogEntrySchema, CreateTaskParamsSchema, UpdateTaskParamsSchema, ListTasksParamsSchema, ListTasksResultSchema, BatchDeleteTasksParamsSchema, BatchDeleteTasksResultSchema, TaskChangelogResultSchema, ListCommentsResultSchema, ListTagsResultSchema, AttachmentSchema, CreateAttachmentParamsSchema, PresignUploadResponseSchema, PresignDownloadResponseSchema, ListAttachmentsResultSchema, ListUsersResultSchema, ListProjectsResultSchema, TaskActivityParamsSchema, TaskActivityResultSchema, normalizeTaskStatus, } from '@agentuity/core/task';
+import { TaskStorageService, } from '@agentuity/core/task';
+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 TaskClientOptionsSchema = z.object({
+    apiKey: z.string().optional().describe('API key for authentication'),
+    url: z.string().optional().describe('Base URL for the Task API'),
+    orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+    logger: z.custom(isLogger).optional().describe('Custom logger instance'),
+});
+export class TaskClient {
+    #service;
+    constructor(options = {}) {
+        const validatedOptions = TaskClientOptionsSchema.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_TASK_URL') || serviceUrls.catalyst;
+        const logger = validatedOptions.logger ?? createMinimalLogger();
+        const headers = buildClientHeaders({
+            apiKey,
+            orgId: validatedOptions.orgId,
+        });
+        const adapter = createServerFetchAdapter({ headers }, logger);
+        this.#service = new TaskStorageService(url, adapter);
+    }
+    async create(params) {
+        return this.#service.create(params);
+    }
+    async get(id) {
+        return this.#service.get(id);
+    }
+    async list(params) {
+        return this.#service.list(params);
+    }
+    async update(id, params) {
+        return this.#service.update(id, params);
+    }
+    async close(id) {
+        return this.#service.close(id);
+    }
+    async softDelete(id) {
+        return this.#service.softDelete(id);
+    }
+    async changelog(id, params) {
+        return this.#service.changelog(id, params);
+    }
+    async createComment(taskId, body, userId, author) {
+        return this.#service.createComment(taskId, body, userId, author);
+    }
+    async getComment(commentId) {
+        return this.#service.getComment(commentId);
+    }
+    async updateComment(commentId, body) {
+        return this.#service.updateComment(commentId, body);
+    }
+    async deleteComment(commentId) {
+        return this.#service.deleteComment(commentId);
+    }
+    async listComments(taskId, params) {
+        return this.#service.listComments(taskId, params);
+    }
+    async createTag(name, color) {
+        return this.#service.createTag(name, color);
+    }
+    async getTag(tagId) {
+        return this.#service.getTag(tagId);
+    }
+    async updateTag(tagId, name, color) {
+        return this.#service.updateTag(tagId, name, color);
+    }
+    async deleteTag(tagId) {
+        return this.#service.deleteTag(tagId);
+    }
+    async listTags() {
+        const result = await this.#service.listTags();
+        return result.tags;
+    }
+    async addTagToTask(taskId, tagId) {
+        return this.#service.addTagToTask(taskId, tagId);
+    }
+    async removeTagFromTask(taskId, tagId) {
+        return this.#service.removeTagFromTask(taskId, tagId);
+    }
+    async listTagsForTask(taskId) {
+        return this.#service.listTagsForTask(taskId);
+    }
+    async uploadAttachment(taskId, params) {
+        return this.#service.uploadAttachment(taskId, params);
+    }
+    async confirmAttachment(attachmentId) {
+        return this.#service.confirmAttachment(attachmentId);
+    }
+    async downloadAttachment(attachmentId) {
+        return this.#service.downloadAttachment(attachmentId);
+    }
+    async listAttachments(taskId) {
+        return this.#service.listAttachments(taskId);
+    }
+    async deleteAttachment(attachmentId) {
+        return this.#service.deleteAttachment(attachmentId);
+    }
+    async listUsers() {
+        return this.#service.listUsers();
+    }
+    async listProjects() {
+        return this.#service.listProjects();
+    }
+    async getActivity(params) {
+        return this.#service.getActivity(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/task",
+	"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,256 @@
+export {
+	TaskStorageService,
+	type Task,
+	type Comment,
+	type Tag,
+	type TaskChangelogEntry,
+	type TaskChangelogResult,
+	type CreateTaskParams,
+	type UpdateTaskParams,
+	type ListTasksParams,
+	type ListTasksResult,
+	type BatchDeleteTasksParams,
+	type BatchDeleteTasksResult,
+	type CreateUserParams,
+	type CreateProjectParams,
+	type ListCommentsResult,
+	type ListTagsResult,
+	type Attachment,
+	type CreateAttachmentParams,
+	type PresignUploadResponse,
+	type PresignDownloadResponse,
+	type ListAttachmentsResult,
+	type ListUsersResult,
+	type ListProjectsResult,
+	type TaskActivityParams,
+	type TaskActivityResult,
+	type TaskPriority,
+	type TaskType,
+	type TaskStatus,
+	type EntityRef,
+	type UserEntityRef,
+	type UserType,
+	TaskSchema,
+	TaskPrioritySchema,
+	TaskTypeSchema,
+	TaskStatusSchema,
+	EntityRefSchema,
+	UserTypeSchema,
+	UserEntityRefSchema,
+	CommentSchema,
+	TagSchema,
+	TaskChangelogEntrySchema,
+	CreateTaskParamsSchema,
+	UpdateTaskParamsSchema,
+	ListTasksParamsSchema,
+	ListTasksResultSchema,
+	BatchDeleteTasksParamsSchema,
+	BatchDeleteTasksResultSchema,
+	TaskChangelogResultSchema,
+	ListCommentsResultSchema,
+	ListTagsResultSchema,
+	AttachmentSchema,
+	CreateAttachmentParamsSchema,
+	PresignUploadResponseSchema,
+	PresignDownloadResponseSchema,
+	ListAttachmentsResultSchema,
+	ListUsersResultSchema,
+	ListProjectsResultSchema,
+	TaskActivityParamsSchema,
+	TaskActivityResultSchema,
+	normalizeTaskStatus,
+} from '@agentuity/core/task';
+
+import {
+	TaskStorageService,
+	type CreateTaskParams,
+	type UpdateTaskParams,
+	type ListTasksParams,
+	type ListTasksResult,
+	type Task,
+	type Comment,
+	type Tag,
+	type TaskChangelogResult,
+	type ListCommentsResult,
+	type CreateAttachmentParams,
+	type PresignUploadResponse,
+	type PresignDownloadResponse,
+	type ListAttachmentsResult,
+	type ListUsersResult,
+	type ListProjectsResult,
+	type TaskActivityResult,
+	type TaskActivityParams,
+	type Attachment,
+	type EntityRef,
+} from '@agentuity/core/task';
+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 TaskClientOptionsSchema = z.object({
+	apiKey: z.string().optional().describe('API key for authentication'),
+	url: z.string().optional().describe('Base URL for the Task API'),
+	orgId: z.string().optional().describe('Organization ID for multi-tenant operations'),
+	logger: z.custom<Logger>(isLogger).optional().describe('Custom logger instance'),
+});
+export type TaskClientOptions = z.infer<typeof TaskClientOptionsSchema>;
+
+export class TaskClient {
+	readonly #service: TaskStorageService;
+
+	constructor(options: TaskClientOptions = {}) {
+		const validatedOptions = TaskClientOptionsSchema.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_TASK_URL') || serviceUrls.catalyst;
+
+		const logger = validatedOptions.logger ?? createMinimalLogger();
+
+		const headers = buildClientHeaders({
+			apiKey,
+			orgId: validatedOptions.orgId,
+		});
+
+		const adapter = createServerFetchAdapter({ headers }, logger);
+		this.#service = new TaskStorageService(url, adapter);
+	}
+
+	async create(params: CreateTaskParams): Promise<Task> {
+		return this.#service.create(params);
+	}
+
+	async get(id: string): Promise<Task | null> {
+		return this.#service.get(id);
+	}
+
+	async list(params?: ListTasksParams): Promise<ListTasksResult> {
+		return this.#service.list(params);
+	}
+
+	async update(id: string, params: UpdateTaskParams): Promise<Task> {
+		return this.#service.update(id, params);
+	}
+
+	async close(id: string): Promise<Task> {
+		return this.#service.close(id);
+	}
+
+	async softDelete(id: string): Promise<Task> {
+		return this.#service.softDelete(id);
+	}
+
+	async changelog(
+		id: string,
+		params?: { limit?: number; offset?: number }
+	): Promise<TaskChangelogResult> {
+		return this.#service.changelog(id, params);
+	}
+
+	async createComment(
+		taskId: string,
+		body: string,
+		userId: string,
+		author?: EntityRef
+	): Promise<Comment> {
+		return this.#service.createComment(taskId, body, userId, author);
+	}
+
+	async getComment(commentId: string): Promise<Comment | null> {
+		return this.#service.getComment(commentId);
+	}
+
+	async updateComment(commentId: string, body: string): Promise<Comment> {
+		return this.#service.updateComment(commentId, body);
+	}
+
+	async deleteComment(commentId: string): Promise<void> {
+		return this.#service.deleteComment(commentId);
+	}
+
+	async listComments(
+		taskId: string,
+		params?: { limit?: number; offset?: number }
+	): Promise<ListCommentsResult> {
+		return this.#service.listComments(taskId, params);
+	}
+
+	async createTag(name: string, color?: string): Promise<Tag> {
+		return this.#service.createTag(name, color);
+	}
+
+	async getTag(tagId: string): Promise<Tag | null> {
+		return this.#service.getTag(tagId);
+	}
+
+	async updateTag(tagId: string, name: string, color?: string): Promise<Tag> {
+		return this.#service.updateTag(tagId, name, color);
+	}
+
+	async deleteTag(tagId: string): Promise<void> {
+		return this.#service.deleteTag(tagId);
+	}
+
+	async listTags(): Promise<Tag[]> {
+		const result = await this.#service.listTags();
+		return result.tags;
+	}
+
+	async addTagToTask(taskId: string, tagId: string): Promise<void> {
+		return this.#service.addTagToTask(taskId, tagId);
+	}
+
+	async removeTagFromTask(taskId: string, tagId: string): Promise<void> {
+		return this.#service.removeTagFromTask(taskId, tagId);
+	}
+
+	async listTagsForTask(taskId: string): Promise<Tag[]> {
+		return this.#service.listTagsForTask(taskId);
+	}
+
+	async uploadAttachment(
+		taskId: string,
+		params: CreateAttachmentParams
+	): Promise<PresignUploadResponse> {
+		return this.#service.uploadAttachment(taskId, params);
+	}
+
+	async confirmAttachment(attachmentId: string): Promise<Attachment> {
+		return this.#service.confirmAttachment(attachmentId);
+	}
+
+	async downloadAttachment(attachmentId: string): Promise<PresignDownloadResponse> {
+		return this.#service.downloadAttachment(attachmentId);
+	}
+
+	async listAttachments(taskId: string): Promise<ListAttachmentsResult> {
+		return this.#service.listAttachments(taskId);
+	}
+
+	async deleteAttachment(attachmentId: string): Promise<void> {
+		return this.#service.deleteAttachment(attachmentId);
+	}
+
+	async listUsers(): Promise<ListUsersResult> {
+		return this.#service.listUsers();
+	}
+
+	async listProjects(): Promise<ListProjectsResult> {
+		return this.#service.listProjects();
+	}
+
+	async getActivity(params?: TaskActivityParams): Promise<TaskActivityResult> {
+		return this.#service.getActivity(params);
+	}
+}