@stackmemoryai/stackmemory 0.2.8 → 0.3.0

package/dist/core/context/frame-digest.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/core/context/frame-digest.ts"],
+  "sourcesContent": ["/**\n * Frame Digest Generation\n * Handles creation of frame summaries and digests\n */\n\nimport { Frame, Event, Anchor, DigestResult } from './frame-types.js';\nimport { FrameDatabase } from './frame-database.js';\nimport { logger } from '../monitoring/logger.js';\n\nexport class FrameDigestGenerator {\n  constructor(private frameDb: FrameDatabase) {}\n\n  /**\n   * Generate digest for a frame\n   */\n  generateDigest(frameId: string): DigestResult {\n    try {\n      const frame = this.frameDb.getFrame(frameId);\n      if (!frame) {\n        throw new Error(`Frame not found: ${frameId}`);\n      }\n\n      const events = this.frameDb.getFrameEvents(frameId);\n      const anchors = this.frameDb.getFrameAnchors(frameId);\n\n      // Generate text summary\n      const text = this.generateTextDigest(frame, events, anchors);\n      \n      // Generate structured data\n      const structured = this.generateStructuredDigest(frame, events, anchors);\n\n      return { text, structured };\n    } catch (error) {\n      logger.error('Failed to generate frame digest', { frameId, error });\n      \n      return {\n        text: `Error generating digest for frame ${frameId}`,\n        structured: { error: (error as Error).message },\n      };\n    }\n  }\n\n  /**\n   * Generate text summary of frame\n   */\n  private generateTextDigest(frame: Frame, events: Event[], anchors: Anchor[]): string {\n    const lines: string[] = [];\n\n    // Frame header\n    lines.push(`Frame: ${frame.name} (${frame.type})`);\n    lines.push(`Duration: ${this.formatDuration(frame.created_at, frame.closed_at)}`);\n    lines.push('');\n\n    // Goals and constraints\n    if (frame.inputs.goals) {\n      lines.push(`Goals: ${frame.inputs.goals}`);\n    }\n\n    if (frame.inputs.constraints && frame.inputs.constraints.length > 0) {\n      lines.push(`Constraints: ${frame.inputs.constraints.join(', ')}`);\n    }\n\n    // Key anchors\n    const importantAnchors = anchors\n      .filter(a => a.priority >= 7)\n      .sort((a, b) => b.priority - a.priority);\n\n    if (importantAnchors.length > 0) {\n      lines.push('');\n      lines.push('Key Decisions & Facts:');\n      importantAnchors.forEach(anchor => {\n        lines.push(`- ${anchor.type}: ${anchor.text}`);\n      });\n    }\n\n    // Activity summary\n    const eventSummary = this.summarizeEvents(events);\n    if (eventSummary.length > 0) {\n      lines.push('');\n      lines.push('Activity Summary:');\n      eventSummary.forEach(summary => {\n        lines.push(`- ${summary}`);\n      });\n    }\n\n    // Outputs\n    if (frame.outputs && Object.keys(frame.outputs).length > 0) {\n      lines.push('');\n      lines.push('Outputs:');\n      Object.entries(frame.outputs).forEach(([key, value]) => {\n        lines.push(`- ${key}: ${this.formatValue(value)}`);\n      });\n    }\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Generate structured digest data\n   */\n  private generateStructuredDigest(frame: Frame, events: Event[], anchors: Anchor[]): Record<string, any> {\n    const eventsByType = this.groupEventsByType(events);\n    const anchorsByType = this.groupAnchorsByType(anchors);\n\n    return {\n      frameId: frame.frame_id,\n      frameName: frame.name,\n      frameType: frame.type,\n      duration: {\n        startTime: frame.created_at,\n        endTime: frame.closed_at,\n        durationMs: frame.closed_at ? (frame.closed_at - frame.created_at) * 1000 : null,\n      },\n      activity: {\n        totalEvents: events.length,\n        eventsByType,\n        eventTimeline: events.slice(-10).map(e => ({\n          type: e.event_type,\n          timestamp: e.ts,\n          summary: this.summarizeEvent(e),\n        })),\n      },\n      knowledge: {\n        totalAnchors: anchors.length,\n        anchorsByType,\n        keyDecisions: anchors\n          .filter(a => a.type === 'DECISION' && a.priority >= 7)\n          .map(a => a.text),\n        constraints: anchors\n          .filter(a => a.type === 'CONSTRAINT')\n          .map(a => a.text),\n        risks: anchors\n          .filter(a => a.type === 'RISK')\n          .map(a => a.text),\n      },\n      outcomes: {\n        outputs: frame.outputs,\n        success: frame.state === 'closed' && !this.hasErrorEvents(events),\n        artifacts: this.extractArtifacts(events),\n      },\n      metadata: {\n        projectId: frame.project_id,\n        runId: frame.run_id,\n        parentFrameId: frame.parent_frame_id,\n        depth: frame.depth,\n      },\n    };\n  }\n\n  /**\n   * Summarize events into readable format\n   */\n  private summarizeEvents(events: Event[]): string[] {\n    const summaries: string[] = [];\n    const eventsByType = this.groupEventsByType(events);\n\n    // Tool calls summary\n    if (eventsByType.tool_call && eventsByType.tool_call.length > 0) {\n      const toolCounts = this.countTools(eventsByType.tool_call);\n      const toolSummary = Object.entries(toolCounts)\n        .map(([tool, count]) => `${tool} (${count})`)\n        .join(', ');\n      summaries.push(`Tool calls: ${toolSummary}`);\n    }\n\n    // Decisions summary\n    if (eventsByType.decision && eventsByType.decision.length > 0) {\n      summaries.push(`Made ${eventsByType.decision.length} decisions`);\n    }\n\n    // Observations summary\n    if (eventsByType.observation && eventsByType.observation.length > 0) {\n      summaries.push(`Recorded ${eventsByType.observation.length} observations`);\n    }\n\n    // Error summary\n    const errorEvents = events.filter(e => \n      e.payload.error || e.payload.status === 'error'\n    );\n    if (errorEvents.length > 0) {\n      summaries.push(`Encountered ${errorEvents.length} errors`);\n    }\n\n    return summaries;\n  }\n\n  /**\n   * Group events by type\n   */\n  private groupEventsByType(events: Event[]): Record<string, Event[]> {\n    const groups: Record<string, Event[]> = {};\n    \n    for (const event of events) {\n      if (!groups[event.event_type]) {\n        groups[event.event_type] = [];\n      }\n      groups[event.event_type].push(event);\n    }\n    \n    return groups;\n  }\n\n  /**\n   * Group anchors by type\n   */\n  private groupAnchorsByType(anchors: Anchor[]): Record<string, number> {\n    const groups: Record<string, number> = {};\n    \n    for (const anchor of anchors) {\n      groups[anchor.type] = (groups[anchor.type] || 0) + 1;\n    }\n    \n    return groups;\n  }\n\n  /**\n   * Count tool usage\n   */\n  private countTools(toolEvents: Event[]): Record<string, number> {\n    const counts: Record<string, number> = {};\n    \n    for (const event of toolEvents) {\n      const toolName = event.payload.tool_name || 'unknown';\n      counts[toolName] = (counts[toolName] || 0) + 1;\n    }\n    \n    return counts;\n  }\n\n  /**\n   * Check if events contain errors\n   */\n  private hasErrorEvents(events: Event[]): boolean {\n    return events.some(e => \n      e.payload.error || \n      e.payload.status === 'error'\n    );\n  }\n\n  /**\n   * Extract artifacts from events\n   */\n  private extractArtifacts(events: Event[]): string[] {\n    const artifacts: string[] = [];\n    \n    for (const event of events) {\n      if (event.event_type === 'artifact' && event.payload.path) {\n        artifacts.push(event.payload.path);\n      }\n    }\n    \n    return [...new Set(artifacts)];\n  }\n\n  /**\n   * Summarize a single event\n   */\n  private summarizeEvent(event: Event): string {\n    switch (event.event_type) {\n      case 'tool_call':\n        return `${event.payload.tool_name || 'tool'}`;\n      case 'decision':\n        return `${event.payload.type}: ${event.payload.content?.substring(0, 50)}...`;\n      case 'observation':\n        return `${event.payload.content?.substring(0, 50)}...`;\n      case 'artifact':\n        return `Created ${event.payload.path}`;\n      default:\n        return event.event_type;\n    }\n  }\n\n  /**\n   * Format duration\n   */\n  private formatDuration(startTime: number, endTime?: number): string {\n    if (!endTime) {\n      return 'ongoing';\n    }\n    \n    const durationMs = (endTime - startTime) * 1000;\n    \n    if (durationMs < 1000) {\n      return `${durationMs.toFixed(0)}ms`;\n    } else if (durationMs < 60000) {\n      return `${(durationMs / 1000).toFixed(1)}s`;\n    } else {\n      return `${(durationMs / 60000).toFixed(1)}m`;\n    }\n  }\n\n  /**\n   * Format value for display\n   */\n  private formatValue(value: any): string {\n    if (typeof value === 'string') {\n      return value.length > 100 ? `${value.substring(0, 100)}...` : value;\n    } else if (typeof value === 'object') {\n      return JSON.stringify(value).substring(0, 100) + '...';\n    } else {\n      return String(value);\n    }\n  }\n}"],
+  "mappings": "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",
+  "names": []
+}