agent-relay 1.1.0 → 1.2.0

package/dist/cloud/services/nango.js

@@ -0,0 +1,191 @@
+import { Nango } from '@nangohq/node';
+import crypto from 'node:crypto';
+import { getConfig } from '../config.js';
+export const NANGO_INTEGRATIONS = {
+    GITHUB_USER: 'github',
+    GITHUB_APP: 'github-app-oauth',
+};
+class NangoService {
+    client;
+    secret;
+    constructor() {
+        const config = getConfig();
+        this.secret = config.nango.secretKey;
+        this.client = new Nango({
+            secretKey: config.nango.secretKey,
+            ...(config.nango.host ? { host: config.nango.host } : {}),
+        });
+    }
+    /**
+     * Create a Nango connect session restricted to specific integrations.
+     */
+    async createConnectSession(allowedIntegrations, endUser) {
+        const { data } = await this.client.createConnectSession({
+            allowed_integrations: allowedIntegrations,
+            end_user: {
+                id: endUser.id,
+                email: endUser.email,
+            },
+        });
+        return data;
+    }
+    /**
+     * Fetch GitHub user profile via Nango proxy.
+     */
+    async getGithubUser(connectionId) {
+        const response = await this.client.get({
+            connectionId,
+            providerConfigKey: NANGO_INTEGRATIONS.GITHUB_USER,
+            endpoint: '/user',
+        });
+        return response.data;
+    }
+    /**
+     * Retrieve an installation access token from a GitHub App connection.
+     * Use this ONLY when you need the raw token (e.g., for git clone URLs).
+     * For API calls, use the proxy methods instead.
+     */
+    async getGithubAppToken(connectionId) {
+        const token = await this.client.getToken(NANGO_INTEGRATIONS.GITHUB_APP, connectionId, false, true);
+        // Handle different return formats from Nango
+        if (typeof token === 'string') {
+            return token;
+        }
+        // Nango may return an object with access_token
+        if (token && typeof token === 'object') {
+            const tokenObj = token;
+            if (tokenObj.access_token) {
+                return tokenObj.access_token;
+            }
+            if (tokenObj.token) {
+                return tokenObj.token;
+            }
+        }
+        console.error('[nango] Unexpected token format:', typeof token, token);
+        throw new Error('Expected GitHub App token to be a string');
+    }
+    /**
+     * List repositories available to a GitHub App installation using the Nango Proxy.
+     * The proxy automatically handles token injection and refresh.
+     * @see https://nango.dev/docs/implementation-guides/requests-proxy/implement-requests-proxy
+     */
+    async listGithubAppRepos(connectionId) {
+        const response = await this.client.get({
+            connectionId,
+            providerConfigKey: NANGO_INTEGRATIONS.GITHUB_APP,
+            endpoint: '/installation/repositories',
+            params: { per_page: '100' },
+        });
+        return response.data;
+    }
+    /**
+     * Get the GitHub App installation ID from a connection.
+     * The installation ID is stored in connection_config.installation_id
+     */
+    async getGithubAppInstallationId(connectionId) {
+        try {
+            const connection = await this.client.getConnection(NANGO_INTEGRATIONS.GITHUB_APP, connectionId);
+            // Extract installation_id from connection_config (where Nango stores it for GitHub App OAuth)
+            const connectionConfig = connection.connection_config;
+            if (connectionConfig?.installation_id) {
+                return Number(connectionConfig.installation_id);
+            }
+            console.warn('[nango] No installation_id in connection_config');
+            return null;
+        }
+        catch (err) {
+            console.error('[nango] Failed to get installation ID:', err);
+            return null;
+        }
+    }
+    /**
+     * Create an issue via Nango Proxy.
+     */
+    async createGithubIssue(connectionId, owner, repo, data) {
+        const response = await this.client.post({
+            connectionId,
+            providerConfigKey: NANGO_INTEGRATIONS.GITHUB_APP,
+            endpoint: `/repos/${owner}/${repo}/issues`,
+            data,
+        });
+        return response.data;
+    }
+    /**
+     * Create a pull request via Nango Proxy.
+     */
+    async createGithubPullRequest(connectionId, owner, repo, data) {
+        const response = await this.client.post({
+            connectionId,
+            providerConfigKey: NANGO_INTEGRATIONS.GITHUB_APP,
+            endpoint: `/repos/${owner}/${repo}/pulls`,
+            data,
+        });
+        return response.data;
+    }
+    /**
+     * Add a comment to an issue via Nango Proxy.
+     */
+    async addGithubIssueComment(connectionId, owner, repo, issueNumber, body) {
+        const response = await this.client.post({
+            connectionId,
+            providerConfigKey: NANGO_INTEGRATIONS.GITHUB_APP,
+            endpoint: `/repos/${owner}/${repo}/issues/${issueNumber}/comments`,
+            data: { body },
+        });
+        return response.data;
+    }
+    /**
+     * Update connection end user metadata (e.g., after creating a user record).
+     */
+    async updateEndUser(connectionId, providerConfigKey, endUser) {
+        await this.client.patchConnection({ connectionId, provider_config_key: providerConfigKey }, { end_user: endUser });
+    }
+    /**
+     * Delete a connection from Nango.
+     *
+     * Used to remove temporary session connections for returning users
+     * to prevent duplicate connections in Nango. In the two-connection pattern,
+     * new users get a permanent connection but returning users authenticate
+     * with a temporary one that gets deleted.
+     *
+     * @param connectionId - Nango connection ID to delete
+     * @param providerConfigKey - The integration key (e.g., 'github')
+     */
+    async deleteConnection(connectionId, providerConfigKey) {
+        await this.client.deleteConnection(providerConfigKey, connectionId);
+    }
+    /**
+     * Get connection metadata including end_user info.
+     * Useful when webhook doesn't include end_user data.
+     */
+    async getConnection(connectionId, providerConfigKey) {
+        const connection = await this.client.getConnection(providerConfigKey, connectionId);
+        return connection;
+    }
+    /**
+     * Verify webhook signature sent by Nango.
+     * Uses the new verifyIncomingWebhookRequest method.
+     * @see https://nango.dev/docs/reference/sdks/node#verify-webhook-signature
+     */
+    verifyWebhookSignature(rawBody, headers) {
+        try {
+            // Use the new method: verifyIncomingWebhookRequest(body, headers)
+            return this.client.verifyIncomingWebhookRequest(rawBody, headers);
+        }
+        catch (err) {
+            console.error('[nango] verifyIncomingWebhookRequest error:', err);
+            // Fall back to manual HMAC verification using the secret key
+            const signature = headers['x-nango-signature'];
+            const hmacSha256 = headers['x-nango-hmac-sha256'];
+            if (!signature && !hmacSha256)
+                return false;
+            const expectedSignature = crypto
+                .createHmac('sha256', this.secret)
+                .update(rawBody)
+                .digest('hex');
+            return signature === expectedSignature || hmacSha256 === expectedSignature;
+        }
+    }
+}
+export const nangoService = new NangoService();
+//# sourceMappingURL=nango.js.map

package/dist/cloud/services/nango.js.map

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

package/dist/cloud/services/persistence.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Cloud Persistence Service
+ *
+ * Handles durable persistence of agent session data for cloud deployments.
+ * Subscribes to PtyWrapper events ('summary', 'session-end') and persists
+ * to PostgreSQL via Drizzle ORM.
+ *
+ * This decouples PtyWrapper from storage concerns - the wrapper emits events,
+ * this service handles persistence. Different storage backends can be swapped
+ * by implementing alternative persistence services.
+ *
+ * @see PtyWrapperEvents in src/wrapper/pty-wrapper.ts for event definitions
+ */
+import type { PtyWrapper } from '../../wrapper/pty-wrapper.js';
+/**
+ * Configuration for CloudPersistenceService
+ */
+export interface CloudPersistenceConfig {
+    /** Workspace ID for scoping sessions */
+    workspaceId: string;
+    /** Optional callback when summary is persisted */
+    onSummaryPersisted?: (agentName: string, summaryId: string) => void;
+    /** Optional callback when session ends */
+    onSessionEnded?: (agentName: string, sessionId: string) => void;
+}
+/**
+ * CloudPersistenceService manages durable storage for agent sessions.
+ *
+ * Usage:
+ * ```typescript
+ * const persistence = new CloudPersistenceService({
+ *   workspaceId: 'workspace-123',
+ * });
+ *
+ * // Bind to a PtyWrapper instance
+ * const pty = new PtyWrapper(config);
+ * const sessionId = await persistence.bindToPtyWrapper(pty);
+ *
+ * // When done, unbind to clean up listeners
+ * persistence.unbindFromPtyWrapper(pty);
+ * ```
+ */
+export declare class CloudPersistenceService {
+    private config;
+    private boundWrappers;
+    constructor(config: CloudPersistenceConfig);
+    /**
+     * Bind to a PtyWrapper instance and start persisting its events.
+     * Creates a new agent session record and returns the session ID.
+     *
+     * @param wrapper The PtyWrapper to bind to
+     * @returns The session ID for this agent session
+     */
+    bindToPtyWrapper(wrapper: PtyWrapper): Promise<string>;
+    /**
+     * Unbind from a PtyWrapper and clean up event listeners.
+     *
+     * @param wrapper The PtyWrapper to unbind from
+     */
+    unbindFromPtyWrapper(wrapper: PtyWrapper): void;
+    /**
+     * Handle a summary event - persist to agent_summaries table.
+     */
+    private handleSummary;
+    /**
+     * Handle a session-end event - update agent_sessions with end marker.
+     */
+    private handleSessionEnd;
+    /**
+     * Get the session ID for a bound wrapper.
+     */
+    getSessionId(wrapper: PtyWrapper): string | undefined;
+    /**
+     * Get all summaries for a session.
+     */
+    getSessionSummaries(sessionId: string): Promise<{
+        id: string;
+        sessionId: string;
+        agentName: string;
+        summary: {
+            currentTask?: string;
+            completedTasks?: string[];
+            decisions?: string[];
+            context?: string;
+            files?: string[];
+        };
+        createdAt: Date;
+    }[]>;
+    /**
+     * Get the latest summary for an agent in THIS workspace.
+     * Joins through agent_sessions to ensure workspace scoping.
+     */
+    getLatestSummary(agentName: string): Promise<{
+        id: string;
+        sessionId: string;
+        agentName: string;
+        summary: {
+            currentTask?: string;
+            completedTasks?: string[];
+            decisions?: string[];
+            context?: string;
+            files?: string[];
+        };
+        createdAt: Date;
+    }>;
+    /**
+     * Get active sessions for a workspace.
+     */
+    getActiveSessions(): Promise<{
+        id: string;
+        workspaceId: string;
+        agentName: string;
+        status: string;
+        startedAt: Date;
+        endedAt: Date | null;
+        endMarker: {
+            summary?: string;
+            completedTasks?: string[];
+        } | null;
+        metadata: unknown;
+    }[]>;
+    /**
+     * Clean up all bindings.
+     */
+    destroy(): void;
+}
+/**
+ * Factory function to create a persistence service for a workspace.
+ */
+export declare function createPersistenceService(workspaceId: string): CloudPersistenceService;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/cloud/services/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../src/cloud/services/persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAiC,MAAM,8BAA8B,CAAC;AAI9F;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,0CAA0C;IAC1C,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,aAAa,CAIhB;gBAEO,MAAM,EAAE,sBAAsB;IAI1C;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IA0C5D;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAW/C;;OAEG;YACW,aAAa;IAyB3B;;OAEG;YACW,gBAAgB;IAoB9B;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS;IAIrD;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;IAQ3C;;;OAGG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;IAqBxC;;OAEG;IACG,iBAAiB;;;;;;;;;;;;;IAUvB;;OAEG;IACH,OAAO,IAAI,IAAI;CAKhB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAErF"}

package/dist/cloud/services/persistence.js

@@ -0,0 +1,200 @@
+/**
+ * Cloud Persistence Service
+ *
+ * Handles durable persistence of agent session data for cloud deployments.
+ * Subscribes to PtyWrapper events ('summary', 'session-end') and persists
+ * to PostgreSQL via Drizzle ORM.
+ *
+ * This decouples PtyWrapper from storage concerns - the wrapper emits events,
+ * this service handles persistence. Different storage backends can be swapped
+ * by implementing alternative persistence services.
+ *
+ * @see PtyWrapperEvents in src/wrapper/pty-wrapper.ts for event definitions
+ */
+import { eq, and, desc } from 'drizzle-orm';
+import { getDb } from '../db/drizzle.js';
+import { agentSessions, agentSummaries } from '../db/schema.js';
+/**
+ * CloudPersistenceService manages durable storage for agent sessions.
+ *
+ * Usage:
+ * ```typescript
+ * const persistence = new CloudPersistenceService({
+ *   workspaceId: 'workspace-123',
+ * });
+ *
+ * // Bind to a PtyWrapper instance
+ * const pty = new PtyWrapper(config);
+ * const sessionId = await persistence.bindToPtyWrapper(pty);
+ *
+ * // When done, unbind to clean up listeners
+ * persistence.unbindFromPtyWrapper(pty);
+ * ```
+ */
+export class CloudPersistenceService {
+    config;
+    boundWrappers = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Bind to a PtyWrapper instance and start persisting its events.
+     * Creates a new agent session record and returns the session ID.
+     *
+     * @param wrapper The PtyWrapper to bind to
+     * @returns The session ID for this agent session
+     */
+    async bindToPtyWrapper(wrapper) {
+        const db = getDb();
+        const agentName = wrapper.name;
+        // Create session record
+        const result = await db.insert(agentSessions).values({
+            workspaceId: this.config.workspaceId,
+            agentName,
+            status: 'active',
+            startedAt: new Date(),
+        }).returning();
+        const session = result[0];
+        if (!session) {
+            throw new Error(`Failed to create session for agent ${agentName}`);
+        }
+        const sessionId = session.id;
+        // Create event handlers
+        const summaryHandler = async (event) => {
+            await this.handleSummary(sessionId, event);
+        };
+        const sessionEndHandler = async (event) => {
+            await this.handleSessionEnd(sessionId, event);
+        };
+        // Bind handlers
+        wrapper.on('summary', summaryHandler);
+        wrapper.on('session-end', sessionEndHandler);
+        // Track binding for cleanup
+        this.boundWrappers.set(wrapper, {
+            sessionId,
+            summaryHandler,
+            sessionEndHandler,
+        });
+        console.log(`[persistence] Bound to ${agentName}, session=${sessionId}`);
+        return sessionId;
+    }
+    /**
+     * Unbind from a PtyWrapper and clean up event listeners.
+     *
+     * @param wrapper The PtyWrapper to unbind from
+     */
+    unbindFromPtyWrapper(wrapper) {
+        const binding = this.boundWrappers.get(wrapper);
+        if (!binding)
+            return;
+        wrapper.off('summary', binding.summaryHandler);
+        wrapper.off('session-end', binding.sessionEndHandler);
+        this.boundWrappers.delete(wrapper);
+        console.log(`[persistence] Unbound from ${wrapper.name}`);
+    }
+    /**
+     * Handle a summary event - persist to agent_summaries table.
+     */
+    async handleSummary(sessionId, event) {
+        try {
+            const db = getDb();
+            const result = await db.insert(agentSummaries).values({
+                sessionId,
+                agentName: event.agentName,
+                summary: event.summary,
+                createdAt: new Date(),
+            }).returning();
+            const summaryRecord = result[0];
+            if (!summaryRecord) {
+                console.error(`[persistence] Insert returned no record for ${event.agentName}`);
+                return;
+            }
+            console.log(`[persistence] Saved summary for ${event.agentName}: ${event.summary.currentTask || 'no task'}`);
+            this.config.onSummaryPersisted?.(event.agentName, summaryRecord.id);
+        }
+        catch (err) {
+            console.error(`[persistence] Failed to save summary for ${event.agentName}:`, err);
+        }
+    }
+    /**
+     * Handle a session-end event - update agent_sessions with end marker.
+     */
+    async handleSessionEnd(sessionId, event) {
+        try {
+            const db = getDb();
+            await db.update(agentSessions)
+                .set({
+                status: 'ended',
+                endedAt: new Date(),
+                endMarker: event.marker,
+            })
+                .where(eq(agentSessions.id, sessionId));
+            console.log(`[persistence] Session ended for ${event.agentName}: ${event.marker.summary || 'no summary'}`);
+            this.config.onSessionEnded?.(event.agentName, sessionId);
+        }
+        catch (err) {
+            console.error(`[persistence] Failed to end session for ${event.agentName}:`, err);
+        }
+    }
+    /**
+     * Get the session ID for a bound wrapper.
+     */
+    getSessionId(wrapper) {
+        return this.boundWrappers.get(wrapper)?.sessionId;
+    }
+    /**
+     * Get all summaries for a session.
+     */
+    async getSessionSummaries(sessionId) {
+        const db = getDb();
+        return db.select()
+            .from(agentSummaries)
+            .where(eq(agentSummaries.sessionId, sessionId))
+            .orderBy(agentSummaries.createdAt);
+    }
+    /**
+     * Get the latest summary for an agent in THIS workspace.
+     * Joins through agent_sessions to ensure workspace scoping.
+     */
+    async getLatestSummary(agentName) {
+        const db = getDb();
+        // Join with sessions to ensure we only get summaries from this workspace
+        const results = await db.select({
+            id: agentSummaries.id,
+            sessionId: agentSummaries.sessionId,
+            agentName: agentSummaries.agentName,
+            summary: agentSummaries.summary,
+            createdAt: agentSummaries.createdAt,
+        })
+            .from(agentSummaries)
+            .innerJoin(agentSessions, eq(agentSummaries.sessionId, agentSessions.id))
+            .where(and(eq(agentSummaries.agentName, agentName), eq(agentSessions.workspaceId, this.config.workspaceId)))
+            .orderBy(desc(agentSummaries.createdAt))
+            .limit(1);
+        return results[0] || null;
+    }
+    /**
+     * Get active sessions for a workspace.
+     */
+    async getActiveSessions() {
+        const db = getDb();
+        return db.select()
+            .from(agentSessions)
+            .where(and(eq(agentSessions.workspaceId, this.config.workspaceId), eq(agentSessions.status, 'active')));
+    }
+    /**
+     * Clean up all bindings.
+     */
+    destroy() {
+        for (const wrapper of this.boundWrappers.keys()) {
+            this.unbindFromPtyWrapper(wrapper);
+        }
+    }
+}
+/**
+ * Factory function to create a persistence service for a workspace.
+ */
+export function createPersistenceService(workspaceId) {
+    return new CloudPersistenceService({ workspaceId });
+}
+//# sourceMappingURL=persistence.js.map

package/dist/cloud/services/persistence.js.map

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

package/dist/cloud/services/planLimits.d.ts

@@ -14,6 +14,8 @@ export interface PlanLimits {
     maxConcurrentAgents: number;
     maxComputeHoursPerMonth: number;
     coordinatorsEnabled: boolean;
+    /** Cloud session persistence (summaries, session tracking) - Pro+ only */
+    sessionPersistence: boolean;
 }
 /**
  * Plan limits configuration
@@ -76,6 +78,19 @@ export declare function canUseCoordinator(userId: string): Promise<{
     reason?: string;
     requiredPlan?: string;
 }>;
+/**
+ * Check if user can use cloud session persistence
+ *
+ * Session persistence enables:
+ * - [[SUMMARY]] blocks saved to cloud database
+ * - [[SESSION_END]] markers for session tracking
+ * - Session recovery and handoff between agents
+ */
+export declare function canUseSessionPersistence(userId: string): Promise<{
+    allowed: boolean;
+    reason?: string;
+    requiredPlan?: string;
+}>;
 /**
  * Check if user has compute hours available
  */

package/dist/cloud/services/planLimits.d.ts.map

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

package/dist/cloud/services/planLimits.js

@@ -22,6 +22,7 @@ export const PLAN_LIMITS = {
         maxConcurrentAgents: 2,
         maxComputeHoursPerMonth: 10,
         coordinatorsEnabled: false,
+        sessionPersistence: false,
     },
     pro: {
         maxWorkspaces: 5,
@@ -29,6 +30,7 @@ export const PLAN_LIMITS = {
         maxConcurrentAgents: 10,
         maxComputeHoursPerMonth: 100,
         coordinatorsEnabled: true,
+        sessionPersistence: true,
     },
     team: {
         maxWorkspaces: 20,
@@ -36,6 +38,7 @@ export const PLAN_LIMITS = {
         maxConcurrentAgents: 50,
         maxComputeHoursPerMonth: 500,
         coordinatorsEnabled: true,
+        sessionPersistence: true,
     },
     enterprise: {
         maxWorkspaces: Infinity,
@@ -43,6 +46,7 @@ export const PLAN_LIMITS = {
         maxConcurrentAgents: Infinity,
         maxComputeHoursPerMonth: Infinity,
         coordinatorsEnabled: true,
+        sessionPersistence: true,
     },
 };
 /**
@@ -179,6 +183,30 @@ export async function canUseCoordinator(userId) {
     }
     return { allowed: true };
 }
+/**
+ * Check if user can use cloud session persistence
+ *
+ * Session persistence enables:
+ * - [[SUMMARY]] blocks saved to cloud database
+ * - [[SESSION_END]] markers for session tracking
+ * - Session recovery and handoff between agents
+ */
+export async function canUseSessionPersistence(userId) {
+    const user = await db.users.findById(userId);
+    if (!user) {
+        return { allowed: false, reason: 'User not found' };
+    }
+    const plan = user.plan || 'free';
+    const limits = getPlanLimits(plan);
+    if (!limits.sessionPersistence) {
+        return {
+            allowed: false,
+            reason: 'Cloud session persistence requires a Pro plan or higher',
+            requiredPlan: 'pro',
+        };
+    }
+    return { allowed: true };
+}
 /**
  * Check if user has compute hours available
  */