@pinepaper.studio/mcp-server 1.4.3 → 1.5.0

package/dist/agent/session-manager.js

@@ -0,0 +1,311 @@
+/**
+ * PinePaper Agent Session Manager
+ *
+ * Manages job/session lifecycle for agent workflows.
+ * Provides batch code execution, item tracking, and job state management.
+ */
+// Simple unique ID generator (avoids uuid dependency)
+function generateUniqueId() {
+    return Math.random().toString(36).substring(2, 10);
+}
+// =============================================================================
+// SESSION MANAGER CLASS
+// =============================================================================
+/**
+ * Manages agent job/session lifecycle.
+ *
+ * Features:
+ * - Job start/end with automatic tracking
+ * - Code queuing for batch execution
+ * - Item and relation tracking per job
+ * - Screenshot policy management
+ */
+export class AgentSessionManager {
+    currentJob = null;
+    jobHistory = [];
+    /**
+     * Generate a unique job ID
+     */
+    generateJobId() {
+        return `job_${Date.now()}_${generateUniqueId()}`;
+    }
+    /**
+     * Check if a job is currently active
+     */
+    hasActiveJob() {
+        return this.currentJob !== null;
+    }
+    /**
+     * Get the current job context
+     */
+    getCurrentJob() {
+        return this.currentJob;
+    }
+    /**
+     * Start a new agent job
+     */
+    startJob(options = {}) {
+        // End any existing job first
+        if (this.currentJob) {
+            console.warn('[AgentSession] Ending previous job before starting new one');
+            // Don't await - just clean up state
+            this.currentJob = null;
+        }
+        const jobId = this.generateJobId();
+        const now = Date.now();
+        this.currentJob = {
+            jobId,
+            name: options.name,
+            startTime: now,
+            itemsCreated: [],
+            relationsCreated: [],
+            codeQueue: [],
+            screenshotPolicy: options.screenshotPolicy || 'on_complete',
+            canvasPreset: options.canvasPreset,
+            agentMode: true,
+        };
+        console.error(`[AgentSession] Started job: ${jobId}${options.name ? ` (${options.name})` : ''}`);
+        return this.currentJob;
+    }
+    /**
+     * End the current job and return results
+     */
+    endJob() {
+        if (!this.currentJob) {
+            console.warn('[AgentSession] No active job to end');
+            return null;
+        }
+        const job = this.currentJob;
+        const duration = Date.now() - job.startTime;
+        const result = {
+            jobId: job.jobId,
+            name: job.name,
+            duration,
+            itemsCreated: [...job.itemsCreated],
+            relationsCreated: [...job.relationsCreated],
+        };
+        // Store in history
+        this.jobHistory.push(result);
+        // Clear current job
+        this.currentJob = null;
+        console.error(`[AgentSession] Ended job: ${job.jobId} (${duration}ms, ${job.itemsCreated.length} items)`);
+        return result;
+    }
+    /**
+     * Queue code for batch execution
+     */
+    queueCode(code) {
+        if (!this.currentJob) {
+            console.warn('[AgentSession] No active job - executing immediately');
+            return;
+        }
+        this.currentJob.codeQueue.push(code);
+    }
+    /**
+     * Get queued code and clear the queue
+     */
+    flushCodeQueue() {
+        if (!this.currentJob) {
+            return [];
+        }
+        const queue = [...this.currentJob.codeQueue];
+        this.currentJob.codeQueue = [];
+        return queue;
+    }
+    /**
+     * Get combined code from queue as a single script
+     */
+    getCombinedCode() {
+        if (!this.currentJob || this.currentJob.codeQueue.length === 0) {
+            return '';
+        }
+        const queue = this.currentJob.codeQueue;
+        // Wrap in IIFE with error handling and result collection
+        const combinedCode = `
+(async function() {
+  const _results = [];
+  const _itemIds = [];
+
+  try {
+${queue.map((code, i) => `
+    // Operation ${i + 1}
+    try {
+      const _result${i} = await (async () => {
+        ${code}
+      })();
+      _results.push({ index: ${i}, success: true, result: _result${i} });
+      if (_result${i} && _result${i}.itemId) {
+        _itemIds.push(_result${i}.itemId);
+      }
+    } catch (e) {
+      _results.push({ index: ${i}, success: false, error: e.message });
+      throw e; // Re-throw for atomic mode
+    }
+`).join('\n')}
+
+    return { success: true, itemIds: _itemIds, results: _results };
+  } catch (e) {
+    return { success: false, error: e.message, itemIds: _itemIds, results: _results };
+  }
+})();
+    `.trim();
+        return combinedCode;
+    }
+    /**
+     * Check if there's queued code
+     */
+    hasQueuedCode() {
+        return this.currentJob !== null && this.currentJob.codeQueue.length > 0;
+    }
+    /**
+     * Get queue size
+     */
+    getQueueSize() {
+        return this.currentJob?.codeQueue.length ?? 0;
+    }
+    /**
+     * Register an item created during the job
+     */
+    registerItem(itemId) {
+        if (this.currentJob && itemId) {
+            this.currentJob.itemsCreated.push(itemId);
+        }
+    }
+    /**
+     * Register a relation created during the job
+     */
+    registerRelation(relationId) {
+        if (this.currentJob && relationId) {
+            this.currentJob.relationsCreated.push(relationId);
+        }
+    }
+    /**
+     * Get screenshot policy for current job
+     */
+    getScreenshotPolicy() {
+        return this.currentJob?.screenshotPolicy ?? 'on_request';
+    }
+    /**
+     * Check if screenshot should be taken based on policy and event
+     */
+    shouldTakeScreenshot(event) {
+        const policy = this.getScreenshotPolicy();
+        switch (event) {
+            case 'operation':
+                return false; // Never screenshot per operation in agent mode
+            case 'error':
+                return policy === 'on_error' || policy === 'on_complete';
+            case 'complete':
+                return policy === 'on_complete';
+            default:
+                return false;
+        }
+    }
+    /**
+     * Generate code for canvas reset
+     */
+    generateResetCode(options = {}) {
+        const parts = [];
+        // Clear all items
+        parts.push(`
+// Clear canvas
+if (app.clearCanvas) {
+  app.clearCanvas();
+} else {
+  // Fallback: remove all items from text layer
+  if (app.textItemGroup) {
+    app.textItemGroup.removeChildren();
+  }
+  // Clear pattern group
+  if (app.patternGroup) {
+    app.patternGroup.removeChildren();
+  }
+  // Clear item registry
+  if (app.itemRegistry) {
+    app.itemRegistry.clear();
+  }
+  // Clear relation registry
+  if (app.relationRegistry) {
+    app.relationRegistry.clear();
+  }
+}
+    `.trim());
+        // Set canvas size if preset specified
+        if (options.canvasPreset) {
+            parts.push(`
+// Set canvas size to preset
+app.setCanvasSize('${options.canvasPreset}');
+      `.trim());
+        }
+        // Set background color if specified
+        if (options.backgroundColor && !options.preserveBackground) {
+            parts.push(`
+// Set background color
+app.setBackgroundColor('${options.backgroundColor}');
+      `.trim());
+        }
+        // Save history state
+        parts.push(`
+// Save state
+if (app.historyManager) {
+  app.historyManager.saveState();
+}
+({ success: true, reset: true });
+    `.trim());
+        return parts.join('\n\n');
+    }
+    /**
+     * Get job history
+     */
+    getJobHistory() {
+        return [...this.jobHistory];
+    }
+    /**
+     * Clear job history
+     */
+    clearHistory() {
+        this.jobHistory = [];
+    }
+    /**
+     * Get statistics about the current session
+     */
+    getStats() {
+        const completedJobs = this.jobHistory.length;
+        const totalItemsCreated = this.jobHistory.reduce((sum, job) => sum + job.itemsCreated.length, 0);
+        return {
+            activeJob: this.hasActiveJob(),
+            currentJobId: this.currentJob?.jobId ?? null,
+            currentJobDuration: this.currentJob ? Date.now() - this.currentJob.startTime : null,
+            itemsInCurrentJob: this.currentJob?.itemsCreated.length ?? 0,
+            codeQueueSize: this.getQueueSize(),
+            completedJobs,
+            totalItemsCreated: totalItemsCreated + (this.currentJob?.itemsCreated.length ?? 0),
+        };
+    }
+}
+// =============================================================================
+// SINGLETON INSTANCE
+// =============================================================================
+let sessionManagerInstance = null;
+/**
+ * Get the singleton session manager instance
+ */
+export function getSessionManager() {
+    if (!sessionManagerInstance) {
+        sessionManagerInstance = new AgentSessionManager();
+    }
+    return sessionManagerInstance;
+}
+/**
+ * Reset the session manager (useful for testing)
+ */
+export function resetSessionManager() {
+    if (sessionManagerInstance) {
+        if (sessionManagerInstance.hasActiveJob()) {
+            sessionManagerInstance.endJob();
+        }
+        sessionManagerInstance.clearHistory();
+    }
+    sessionManagerInstance = null;
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/agent/session-manager.js.map

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