@hawk.so/types 0.5.2 → 0.5.4

package/build/src/base/event/taskManagerItem.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Task Manager item linked to a particular Event (e.g., GitHub Issue)
+ */
+export interface TaskManagerItem {
+    /**
+     * Type of task manager item (currently only 'github-issue' is supported)
+     */
+    type: 'github-issue';
+    /**
+     * Task number (e.g., GitHub Issue number)
+     */
+    number: number;
+    /**
+     * URL to the task (e.g., GitHub Issue URL)
+     */
+    url: string;
+    /**
+     * Task title
+     */
+    title: string;
+    /**
+     * How the task was created (automatically by worker or manually by user)
+     */
+    createdBy: 'auto' | 'manual';
+    /**
+     * Task creation timestamp
+     */
+    createdAt: Date;
+    /**
+     * Agent assigned to the task (e.g., 'copilot' for GitHub Copilot)
+     */
+    assignee: 'copilot' | null;
+}

package/build/src/base/event/taskManagerItem.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/src/base/project/ProjectTaskManager.d.ts

@@ -59,5 +59,43 @@ export interface ProjectTaskManagerConfig {
          * Repository full name (owner/repo)
          */
         repoFullName: string;
+        /**
+         * Delegated user OAuth token for user-to-server authentication
+         * Used for creating issues and assigning Copilot on behalf of the user
+         */
+        delegatedUser?: {
+            /**
+             * Hawk user ID who authorized the GitHub App
+             */
+            hawkUserId: string;
+            /**
+             * GitHub user ID
+             */
+            githubUserId: number;
+            /**
+             * GitHub username/login
+             */
+            githubLogin: string;
+            /**
+             * OAuth access token (user-to-server token)
+             */
+            accessToken: string;
+            /**
+             * Date when token was created/saved
+             */
+            tokenCreatedAt: Date;
+            /**
+             * Date when token was last successfully validated
+             * null if never validated
+             */
+            tokenLastValidatedAt: Date | null;
+            /**
+             * Token status
+             * - active: token is valid (GET /user returns 200)
+             * - revoked: token was revoked (GET /user returns 401/403) or user removed authorization
+             * - missing: token is not present in project
+             */
+            status: 'active' | 'revoked' | 'missing';
+        };
     };
 }

package/build/src/dbScheme/groupedEvent.d.ts

@@ -2,6 +2,7 @@ import type { ObjectId } from 'bson';
 import type { DecodedEventData, EncodedEventData, EventData } from '../base/event/event.ts';
 import type { UserDBScheme } from './user.ts';
 import type { EventAddons } from '../base/event/addons/index.ts';
+import type { TaskManagerItem } from '../base/event/taskManagerItem.ts';
 /**
  * Event marks interface for tracking event status
  */
@@ -53,6 +54,10 @@ export interface GroupedEventDBScheme {
      * Event marks for tracking status
      */
     marks?: EventMarks;
+    /**
+     * Task Manager item linked to this event (e.g., GitHub Issue)
+     */
+    taskManagerItem?: TaskManagerItem;
 }
 /**
  * Event where 'context' and 'addons' are decoded from json strings to objects

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hawk.so/types",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "TypeScript definitions for Hawk",
   "types": "build/index.d.ts",
   "main": "build/index.js",

package/src/base/event/taskManagerItem.ts

@@ -0,0 +1,39 @@
+/**
+ * Task Manager item linked to a particular Event (e.g., GitHub Issue)
+ */
+export interface TaskManagerItem {
+  /**
+   * Type of task manager item (currently only 'github-issue' is supported)
+   */
+  type: 'github-issue';
+
+  /**
+   * Task number (e.g., GitHub Issue number)
+   */
+  number: number;
+
+  /**
+   * URL to the task (e.g., GitHub Issue URL)
+   */
+  url: string;
+
+  /**
+   * Task title
+   */
+  title: string;
+
+  /**
+   * How the task was created (automatically by worker or manually by user)
+   */
+  createdBy: 'auto' | 'manual';
+
+  /**
+   * Task creation timestamp
+   */
+  createdAt: Date;
+
+  /**
+   * Agent assigned to the task (e.g., 'copilot' for GitHub Copilot)
+   */
+  assignee: 'copilot' | null;
+}

package/src/base/project/ProjectTaskManager.ts

@@ -70,5 +70,50 @@ export interface ProjectTaskManagerConfig {
      * Repository full name (owner/repo)
      */
     repoFullName: string;
+
+    /**
+     * Delegated user OAuth token for user-to-server authentication
+     * Used for creating issues and assigning Copilot on behalf of the user
+     */
+    delegatedUser?: {
+      /**
+       * Hawk user ID who authorized the GitHub App
+       */
+      hawkUserId: string;
+
+      /**
+       * GitHub user ID
+       */
+      githubUserId: number;
+
+      /**
+       * GitHub username/login
+       */
+      githubLogin: string;
+
+      /**
+       * OAuth access token (user-to-server token)
+       */
+      accessToken: string;
+
+      /**
+       * Date when token was created/saved
+       */
+      tokenCreatedAt: Date;
+
+      /**
+       * Date when token was last successfully validated
+       * null if never validated
+       */
+      tokenLastValidatedAt: Date | null;
+
+      /**
+       * Token status
+       * - active: token is valid (GET /user returns 200)
+       * - revoked: token was revoked (GET /user returns 401/403) or user removed authorization
+       * - missing: token is not present in project
+       */
+      status: 'active' | 'revoked' | 'missing';
+    };
   };
 }

package/src/dbScheme/groupedEvent.ts

@@ -2,6 +2,7 @@ import type { ObjectId } from 'bson';
 import type { DecodedEventData, EncodedEventData, EventData } from '../base/event/event.ts';
 import type { UserDBScheme } from './user.ts';
 import type { EventAddons } from '../base/event/addons/index.ts';
+import type { TaskManagerItem } from '../base/event/taskManagerItem.ts';
 
 /**
  * Event marks interface for tracking event status
@@ -63,6 +64,11 @@ export interface GroupedEventDBScheme {
    * Event marks for tracking status
    */
   marks?: EventMarks;
+
+  /**
+   * Task Manager item linked to this event (e.g., GitHub Issue)
+   */
+  taskManagerItem?: TaskManagerItem;
 }
 
 /**