@taico/events 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types/task-events.js';
+export * from './types/thread-events.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './types/task-events.js';
+export * from './types/thread-events.js';

package/dist/types/task-events.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Task Wire Event Types for WebSocket Communication
+ *
+ * These types define the structure of events sent between backend and frontend
+ * via WebSocket for the Tasks domain. They serve as a contract between the
+ * backend gateway and frontend consumers.
+ *
+ * Import these types in both backend (for emission) and frontend (for reception)
+ * to ensure type safety across the wire protocol.
+ */
+/**
+ * Wire event names for Tasks domain
+ * These are the stable, external event identifiers sent over the wire protocol.
+ */
+export declare const TaskWireEvents: {
+    readonly TASK_CREATED: "task.created";
+    readonly TASK_UPDATED: "task.updated";
+    readonly TASK_DELETED: "task.deleted";
+    readonly TASK_ASSIGNED: "task.assigned";
+    readonly TASK_STATUS_CHANGED: "task.status_changed";
+    readonly TASK_COMMENTED: "task.commented";
+    readonly TASK_ARTEFACT_ADDED: "task.artefact_added";
+    readonly INPUT_REQUEST_ANSWERED: "input.request.answered";
+    readonly TASK_ACTIVITY: "task.activity";
+    readonly TASK_ACTIVITY_POST: "task.activity.post";
+};
+export type TaskWireEventName = (typeof TaskWireEvents)[keyof typeof TaskWireEvents];
+/**
+ * Base actor structure included in all events
+ */
+export interface EventActor {
+    id: string;
+    type?: string;
+    slug?: string;
+    displayName?: string;
+    avatarUrl?: string | null;
+}
+/**
+ * Actor structure for minimal event payloads
+ */
+export interface MinimalEventActor {
+    id: string;
+}
+/**
+ * Task structure as sent over the wire
+ * Matches TaskResponseDto from backend
+ */
+export interface TaskWirePayload {
+    id: string;
+    name: string;
+    description: string;
+    status: 'NOT_STARTED' | 'IN_PROGRESS' | 'FOR_REVIEW' | 'DONE';
+    assignee: string | null;
+    assigneeActor: EventActor | null;
+    sessionId: string;
+    comments: CommentWirePayload[];
+    artefacts: ArtefactWirePayload[];
+    inputRequests: InputRequestWirePayload[];
+    tags: TagWirePayload[];
+    createdByActor: EventActor;
+    dependsOnIds: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Comment structure as sent over the wire
+ * Matches CommentResponseDto from backend
+ */
+export interface CommentWirePayload {
+    id: string;
+    taskId: string;
+    commenterName: string;
+    commenterActor: EventActor | null;
+    content: string;
+    createdAt: string;
+}
+/**
+ * Artefact structure as sent over the wire
+ * Matches ArtefactResponseDto from backend
+ */
+export interface ArtefactWirePayload {
+    id: string;
+    taskId: string;
+    name: string;
+    link: string;
+    createdAt: string;
+}
+/**
+ * Input request structure as sent over the wire
+ * Matches InputRequestResponseDto from backend
+ */
+export interface InputRequestWirePayload {
+    id: string;
+    taskId: string;
+    askedByActorId: string;
+    assignedToActorId: string;
+    question: string;
+    answer: string | null;
+    resolvedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Tag structure as sent over the wire
+ * Matches TagResponseDto from backend
+ */
+export interface TagWirePayload {
+    id: string;
+    name: string;
+    color?: string;
+}
+/**
+ * Task created event
+ * Emitted when a new task is created
+ */
+export interface TaskCreatedWireEvent {
+    payload: TaskWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Task updated event
+ * Emitted when a task is updated
+ */
+export interface TaskUpdatedWireEvent {
+    payload: TaskWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Task deleted event
+ * Emitted when a task is deleted
+ */
+export interface TaskDeletedWireEvent {
+    payload: {
+        taskId: string;
+    };
+    actor: MinimalEventActor;
+}
+/**
+ * Task assigned event
+ * Emitted when a task is assigned to an actor
+ */
+export interface TaskAssignedWireEvent {
+    payload: TaskWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Task status changed event
+ * Emitted when a task's status changes
+ */
+export interface TaskStatusChangedWireEvent {
+    payload: TaskWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Comment added event
+ * Emitted when a comment is added to a task
+ */
+export interface TaskCommentedWireEvent {
+    payload: CommentWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Artefact added event
+ * Emitted when an artefact is added to a task
+ */
+export interface TaskArtefactAddedWireEvent {
+    payload: ArtefactWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Input request answered event
+ * Emitted when an input request is answered
+ */
+export interface InputRequestAnsweredWireEvent {
+    payload: InputRequestWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Task activity event (ephemeral)
+ * Emitted for real-time activity updates (e.g., agent working on task)
+ */
+export interface TaskActivityWireEvent {
+    taskId: string;
+    kind: string;
+    message?: string;
+    ts: number;
+    by?: string;
+}
+/**
+ * Union type of all task wire events
+ */
+export type TaskWireEvent = TaskCreatedWireEvent | TaskUpdatedWireEvent | TaskDeletedWireEvent | TaskAssignedWireEvent | TaskStatusChangedWireEvent | TaskCommentedWireEvent | TaskArtefactAddedWireEvent | InputRequestAnsweredWireEvent;
+/**
+ * Type guards for event identification
+ */
+export declare function isTaskCreatedEvent(event: TaskWireEvent): event is TaskCreatedWireEvent;
+export declare function isTaskDeletedEvent(event: TaskWireEvent): event is TaskDeletedWireEvent;
+export declare function isTaskCommentedEvent(event: TaskWireEvent): event is TaskCommentedWireEvent;

package/dist/types/task-events.js

@@ -0,0 +1,38 @@
+/**
+ * Task Wire Event Types for WebSocket Communication
+ *
+ * These types define the structure of events sent between backend and frontend
+ * via WebSocket for the Tasks domain. They serve as a contract between the
+ * backend gateway and frontend consumers.
+ *
+ * Import these types in both backend (for emission) and frontend (for reception)
+ * to ensure type safety across the wire protocol.
+ */
+/**
+ * Wire event names for Tasks domain
+ * These are the stable, external event identifiers sent over the wire protocol.
+ */
+export const TaskWireEvents = {
+    TASK_CREATED: 'task.created',
+    TASK_UPDATED: 'task.updated',
+    TASK_DELETED: 'task.deleted',
+    TASK_ASSIGNED: 'task.assigned',
+    TASK_STATUS_CHANGED: 'task.status_changed',
+    TASK_COMMENTED: 'task.commented',
+    TASK_ARTEFACT_ADDED: 'task.artefact_added',
+    INPUT_REQUEST_ANSWERED: 'input.request.answered',
+    TASK_ACTIVITY: 'task.activity',
+    TASK_ACTIVITY_POST: 'task.activity.post',
+};
+/**
+ * Type guards for event identification
+ */
+export function isTaskCreatedEvent(event) {
+    return 'payload' in event && 'id' in event.payload && 'name' in event.payload;
+}
+export function isTaskDeletedEvent(event) {
+    return 'payload' in event && 'taskId' in event.payload;
+}
+export function isTaskCommentedEvent(event) {
+    return ('payload' in event && 'taskId' in event.payload && 'content' in event.payload);
+}

package/dist/types/thread-events.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Thread Wire Event Types for WebSocket Communication
+ *
+ * These types define the structure of events sent between backend and frontend
+ * via WebSocket for the Threads domain. They serve as a contract between the
+ * backend gateway and frontend consumers.
+ *
+ * Import these types in both backend (for emission) and frontend (for reception)
+ * to ensure type safety across the wire protocol.
+ */
+import type { MinimalEventActor, TagWirePayload } from './task-events.js';
+/**
+ * Wire event names for Threads domain
+ * These are the stable, external event identifiers sent over the wire protocol.
+ */
+export declare const ThreadWireEvents: {
+    readonly THREAD_CREATED: "thread.created";
+    readonly THREAD_UPDATED: "thread.updated";
+    readonly THREAD_DELETED: "thread.deleted";
+    readonly THREAD_TITLE_UPDATED: "thread.title.updated";
+    readonly MESSAGE_CREATED: "thread.message.created";
+    readonly AGENT_ACTIVITY: "thread.agent.activity";
+};
+export type ThreadWireEventName = (typeof ThreadWireEvents)[keyof typeof ThreadWireEvents];
+/**
+ * Task summary structure as sent over the wire
+ */
+export interface TaskSummaryWirePayload {
+    id: string;
+    name: string;
+    status: 'NOT_STARTED' | 'IN_PROGRESS' | 'FOR_REVIEW' | 'DONE';
+}
+/**
+ * Context block summary structure as sent over the wire
+ */
+export interface ContextBlockSummaryWirePayload {
+    id: string;
+    title: string;
+}
+export declare enum ActorType {
+    HUMAN = "human",
+    AGENT = "agent"
+}
+export interface Actor {
+    id: string;
+    type: ActorType;
+    slug: string;
+    displayName: string;
+    avatarUrl: string | null;
+    introduction: string | null;
+}
+/**
+ * Thread structure as sent over the wire
+ * Matches ThreadResponseDto from backend
+ */
+export interface ThreadWirePayload {
+    id: string;
+    title: string;
+    createdByActorId: string;
+    createdByActor: Actor;
+    parentTaskId: string | null;
+    parentTask: TaskSummaryWirePayload | null;
+    stateBlockId: string;
+    stateBlock: ContextBlockSummaryWirePayload;
+    tags: TagWirePayload[];
+    tasks: TaskSummaryWirePayload[];
+    contextBlocks: ContextBlockSummaryWirePayload[];
+    participantActorIds: string[];
+    participants: Actor[];
+    rowVersion: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Thread message structure as sent over the wire
+ * Matches ThreadMessageResponseDto from backend
+ */
+export interface ThreadMessageWirePayload {
+    id: string;
+    threadId: string;
+    content: string;
+    createdByActorId: string | null;
+    createdByActor: Actor | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Thread created event
+ * Emitted when a new thread is created
+ */
+export interface ThreadCreatedWireEvent {
+    payload: ThreadWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Thread updated event
+ * Emitted when a thread is updated
+ */
+export interface ThreadUpdatedWireEvent {
+    payload: ThreadWirePayload;
+    actor: MinimalEventActor;
+}
+/**
+ * Thread deleted event
+ * Emitted when a thread is deleted
+ */
+export interface ThreadDeletedWireEvent {
+    payload: {
+        threadId: string;
+    };
+    actor: MinimalEventActor;
+}
+/**
+ * Thread title updated event
+ * Emitted when a thread title changes after initial creation.
+ */
+export interface ThreadTitleUpdatedWireEvent {
+    payload: {
+        threadId: string;
+        title: string;
+    };
+    actor: MinimalEventActor;
+}
+/**
+ * Message created event
+ * Emitted when a message is created in a thread
+ */
+export interface MessageCreatedWireEvent {
+    payload: ThreadMessageWirePayload;
+    actor: MinimalEventActor;
+}
+export type ThreadAgentActivityKind = 'thinking' | 'tool_calling';
+/**
+ * Agent activity event
+ * Emitted for ephemeral assistant actions (thinking/tool calling)
+ */
+export interface AgentActivityWireEvent {
+    payload: {
+        threadId: string;
+        kind: ThreadAgentActivityKind;
+    };
+    actor: MinimalEventActor;
+}
+/**
+ * Union type of all thread wire events
+ */
+export type ThreadWireEvent = ThreadCreatedWireEvent | ThreadUpdatedWireEvent | ThreadDeletedWireEvent | ThreadTitleUpdatedWireEvent | MessageCreatedWireEvent | AgentActivityWireEvent;

package/dist/types/thread-events.js

@@ -0,0 +1,27 @@
+/**
+ * Thread Wire Event Types for WebSocket Communication
+ *
+ * These types define the structure of events sent between backend and frontend
+ * via WebSocket for the Threads domain. They serve as a contract between the
+ * backend gateway and frontend consumers.
+ *
+ * Import these types in both backend (for emission) and frontend (for reception)
+ * to ensure type safety across the wire protocol.
+ */
+/**
+ * Wire event names for Threads domain
+ * These are the stable, external event identifiers sent over the wire protocol.
+ */
+export const ThreadWireEvents = {
+    THREAD_CREATED: 'thread.created',
+    THREAD_UPDATED: 'thread.updated',
+    THREAD_DELETED: 'thread.deleted',
+    THREAD_TITLE_UPDATED: 'thread.title.updated',
+    MESSAGE_CREATED: 'thread.message.created',
+    AGENT_ACTIVITY: 'thread.agent.activity',
+};
+export var ActorType;
+(function (ActorType) {
+    ActorType["HUMAN"] = "human";
+    ActorType["AGENT"] = "agent";
+})(ActorType || (ActorType = {}));

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@taico/events",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "private": false,
   "license": "MIT",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "package.json"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -15,9 +19,11 @@
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json"
+    "build": "tsc -p tsconfig.build.json",
+    "pack": "npm run build && npm pack",
+    "release": "npm run build && npm publish --access public"
   },
   "devDependencies": {
     "typescript": "^5.6.3"
   }
-}
+}

package/src/index.ts

@@ -1 +0,0 @@
-export * from './types/task-events.js';

package/src/types/task-events.ts

@@ -1,219 +0,0 @@
-/**
- * Task Wire Event Types for WebSocket Communication
- *
- * These types define the structure of events sent between backend and frontend
- * via WebSocket for the Tasks domain. They serve as a contract between the
- * backend gateway and frontend consumers.
- *
- * Import these types in both backend (for emission) and frontend (for reception)
- * to ensure type safety across the wire protocol.
- */
-
-/**
- * Wire event names for Tasks domain
- * These are the stable, external event identifiers sent over the wire protocol.
- */
-export const TaskWireEvents = {
-  TASK_CREATED: 'task.created',
-  TASK_UPDATED: 'task.updated',
-  TASK_DELETED: 'task.deleted',
-  TASK_ASSIGNED: 'task.assigned',
-  TASK_STATUS_CHANGED: 'task.status_changed',
-  TASK_COMMENTED: 'task.commented',
-  INPUT_REQUEST_ANSWERED: 'input.request.answered',
-  TASK_ACTIVITY: 'task.activity',
-  TASK_ACTIVITY_POST: 'task.activity.post',
-} as const;
-
-export type TaskWireEventName =
-  (typeof TaskWireEvents)[keyof typeof TaskWireEvents];
-
-/**
- * Base actor structure included in all events
- */
-export interface EventActor {
-  id: string;
-  type?: string;
-  slug?: string;
-  displayName?: string;
-  avatarUrl?: string | null;
-}
-
-/**
- * Actor structure for minimal event payloads
- */
-export interface MinimalEventActor {
-  id: string;
-}
-
-/**
- * Task structure as sent over the wire
- * Matches TaskResponseDto from backend
- */
-export interface TaskWirePayload {
-  id: string;
-  name: string;
-  description: string;
-  status: 'NOT_STARTED' | 'IN_PROGRESS' | 'FOR_REVIEW' | 'DONE';
-  assignee: string | null;
-  assigneeActor: EventActor | null;
-  sessionId: string;
-  comments: CommentWirePayload[];
-  inputRequests: InputRequestWirePayload[];
-  tags: TagWirePayload[];
-  createdByActor: EventActor;
-  dependsOnIds: string[];
-  createdAt: string;
-  updatedAt: string;
-}
-
-/**
- * Comment structure as sent over the wire
- * Matches CommentResponseDto from backend
- */
-export interface CommentWirePayload {
-  id: string;
-  taskId: string;
-  commenterName: string;
-  commenterActor: EventActor | null;
-  content: string;
-  createdAt: string;
-}
-
-/**
- * Input request structure as sent over the wire
- * Matches InputRequestResponseDto from backend
- */
-export interface InputRequestWirePayload {
-  id: string;
-  taskId: string;
-  askedByActorId: string;
-  assignedToActorId: string;
-  question: string;
-  answer: string | null;
-  resolvedAt: string | null;
-  createdAt: string;
-  updatedAt: string;
-}
-
-/**
- * Tag structure as sent over the wire
- * Matches TagResponseDto from backend
- */
-export interface TagWirePayload {
-  id: string;
-  name: string;
-  color?: string;
-}
-
-/**
- * Task created event
- * Emitted when a new task is created
- */
-export interface TaskCreatedWireEvent {
-  payload: TaskWirePayload;
-  actor: MinimalEventActor;
-}
-
-/**
- * Task updated event
- * Emitted when a task is updated
- */
-export interface TaskUpdatedWireEvent {
-  payload: TaskWirePayload;
-  actor: MinimalEventActor;
-}
-
-/**
- * Task deleted event
- * Emitted when a task is deleted
- */
-export interface TaskDeletedWireEvent {
-  payload: {
-    taskId: string;
-  };
-  actor: MinimalEventActor;
-}
-
-/**
- * Task assigned event
- * Emitted when a task is assigned to an actor
- */
-export interface TaskAssignedWireEvent {
-  payload: TaskWirePayload;
-  actor: MinimalEventActor;
-}
-
-/**
- * Task status changed event
- * Emitted when a task's status changes
- */
-export interface TaskStatusChangedWireEvent {
-  payload: TaskWirePayload;
-  actor: MinimalEventActor;
-}
-
-/**
- * Comment added event
- * Emitted when a comment is added to a task
- */
-export interface TaskCommentedWireEvent {
-  payload: CommentWirePayload;
-  actor: MinimalEventActor;
-}
-
-/**
- * Input request answered event
- * Emitted when an input request is answered
- */
-export interface InputRequestAnsweredWireEvent {
-  payload: InputRequestWirePayload;
-  actor: MinimalEventActor;
-}
-
-/**
- * Task activity event (ephemeral)
- * Emitted for real-time activity updates (e.g., agent working on task)
- */
-export interface TaskActivityWireEvent {
-  taskId: string;
-  kind: string;
-  message?: string;
-  ts: number;
-  by?: string;
-}
-
-/**
- * Union type of all task wire events
- */
-export type TaskWireEvent =
-  | TaskCreatedWireEvent
-  | TaskUpdatedWireEvent
-  | TaskDeletedWireEvent
-  | TaskAssignedWireEvent
-  | TaskStatusChangedWireEvent
-  | TaskCommentedWireEvent
-  | InputRequestAnsweredWireEvent;
-
-/**
- * Type guards for event identification
- */
-export function isTaskCreatedEvent(
-  event: TaskWireEvent,
-): event is TaskCreatedWireEvent {
-  return 'payload' in event && 'id' in event.payload && 'name' in event.payload;
-}
-
-export function isTaskDeletedEvent(
-  event: TaskWireEvent,
-): event is TaskDeletedWireEvent {
-  return 'payload' in event && 'taskId' in event.payload;
-}
-
-export function isTaskCommentedEvent(
-  event: TaskWireEvent,
-): event is TaskCommentedWireEvent {
-  return (
-    'payload' in event && 'taskId' in event.payload && 'content' in event.payload
-  );
-}

package/tsconfig.build.json

@@ -1,13 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "declaration": true,
-    "emitDeclarationOnly": false,
-    "noEmit": false,
-    "rootDir": "src",
-  },
-  "include": [
-    "src/**/*",
-  ],
-}