@access-mcp/announcements 0.3.0 → 0.5.0

package/dist/server.d.ts

@@ -9,6 +9,10 @@ export declare class AnnouncementsServer extends BaseAccessServer {
     /**
      * Get or create the Drupal auth provider for JSON:API write operations.
      * Requires DRUPAL_API_URL, DRUPAL_USERNAME, and DRUPAL_PASSWORD env vars.
+     *
+     * Acting user is determined in priority order:
+     * 1. X-Acting-User header (from request context)
+     * 2. ACTING_USER environment variable (fallback)
      */
     private getDrupalAuth;
     protected getTools(): Tool[];
@@ -28,12 +32,20 @@ export declare class AnnouncementsServer extends BaseAccessServer {
     private enhanceAnnouncements;
     private searchAnnouncements;
     /**
-     * Get the acting user's UID from environment variable.
-     * This identifies who the announcement should be attributed to.
+     * Get the acting user's ACCESS ID for content attribution.
+     *
+     * Priority order:
+     * 1. X-Acting-User header (from request context)
+     * 2. ACTING_USER environment variable (fallback)
+     *
+     * Returns the ACCESS ID (e.g., "username@access-ci.org")
      */
-    private getActingUserUid;
+    private getActingUserAccessId;
     /**
      * Create a new announcement via Drupal JSON:API
+     *
+     * The X-Acting-User header (set by DrupalAuthProvider) tells Drupal which
+     * ACCESS user is creating the content. Drupal handles user resolution.
      */
     private createAnnouncement;
     /**
@@ -45,17 +57,32 @@ export declare class AnnouncementsServer extends BaseAccessServer {
      */
     private deleteAnnouncement;
     /**
-     * Get announcements created by the acting user
+     * Get announcements created by the acting user.
+     *
+     * Uses a Drupal Views page display exposed via jsonapi_views at
+     * /jsonapi/views/mcp_my_announcements/page_1.
+     * The JsonApiViewsUserParameterSubscriber resolves X-Acting-User header to uid
+     * and injects it as the contextual filter argument, so no user UUID lookup is needed.
      */
     private getMyAnnouncements;
     /**
-     * Get a user's UUID by their Drupal user ID (internal helper)
+     * Get announcement context - tags, affinity groups, and options for creating announcements.
+     *
+     * Uses a Drupal Views page display exposed via jsonapi_views at
+     * /jsonapi/views/mcp_my_affinity_groups/page_1 for affinity groups lookup.
+     * The JsonApiViewsUserParameterSubscriber resolves X-Acting-User header to uid,
+     * so no user UUID lookup is needed.
      */
-    private getUserUuidByUid;
+    private getAnnouncementContext;
     /**
-     * Get announcement context - tags, affinity groups, and options for creating announcements
+     * Suggest tags for announcement content using Drupal's AI tag suggestion service.
      */
-    private getAnnouncementContext;
+    private static readonly JSON_HEADERS;
+    private suggestTags;
+    /**
+     * Generate a summary for announcement content using Drupal's AI summary service.
+     */
+    private suggestSummary;
     /**
      * Look up affinity group UUID by ID or name
      */
@@ -76,5 +103,5 @@ export declare class AnnouncementsServer extends BaseAccessServer {
     /**
      * Get tag UUIDs by their names (with caching)
      */
-    private getTagUuidsByName;
+    private resolveTagNames;
 }