studiograph 1.3.47 → 1.3.48-beta.1

package/dist/services/event-processor.js

@@ -0,0 +1,441 @@
+/**
+ * Event Processor — source-agnostic event capture processing
+ *
+ * Accepts a common MeetingPayload from any capture source (desktop client,
+ * external integrations, calendar, manual) and writes an `event` entity
+ * with `type: meeting` (the default). Handles:
+ * 1. Entity creation with proper frontmatter
+ * 2. Participant resolution to existing person entities
+ * 3. LLM-powered summary generation from transcript
+ * 4. Structured extraction (action items, decisions)
+ * 5. Task entity creation from action items
+ * 6. Body template population
+ *
+ * Today the only event capture surface is meeting recording, so the
+ * payload type is still MeetingPayload — generalizing the payload shape
+ * is a follow-up when/if other event sources land.
+ */
+import { completeSimple, getModel } from '@mariozechner/pi-ai';
+import { loadUserConfig, resolveModelId, resolveApiKey, resolveProvider } from '../core/user-config.js';
+import { log } from '../utils/log.js';
+// ── Processor ─────────────────────────────────────────────────────────
+export class EventProcessor {
+    workspaceManager;
+    wsHub;
+    yjsManager;
+    constructor(workspaceManager, wsHub, yjsManager) {
+        this.workspaceManager = workspaceManager;
+        this.wsHub = wsHub;
+        this.yjsManager = yjsManager;
+    }
+    /**
+     * Process a meeting payload: create entity, resolve participants,
+     * generate summary asynchronously.
+     */
+    async process(payload, repo, user) {
+        const graph = this.workspaceManager.getGraph(repo);
+        const entityId = this.generateEntityId(payload);
+        // Resolve participants to wikilinks
+        const attendeeLinks = await this.resolveParticipants(payload.participants, repo);
+        // Build frontmatter
+        const now = new Date().toISOString();
+        const data = {
+            entity_type: 'event',
+            entity_id: entityId,
+            type: 'meeting',
+            name: payload.title || `Meeting ${payload.startedAt.slice(0, 10)}`,
+            date: payload.startedAt.slice(0, 10),
+            attendees: attendeeLinks,
+            created_at: now,
+            updated_at: now,
+            created_by: user?.id ?? payload.source,
+            updated_by: user?.id ?? payload.source,
+            source_ref: `${payload.source}:${payload.sourceId}`,
+            tags: ['auto-transcribed', payload.platform].filter(Boolean),
+            processing: true,
+        };
+        if (payload.durationMinutes) {
+            data.duration = payload.durationMinutes >= 60
+                ? `${Math.round(payload.durationMinutes / 60 * 10) / 10}h`
+                : `${payload.durationMinutes}m`;
+        }
+        if (payload.meetingUrl)
+            data.location = payload.meetingUrl;
+        // Initial content (memo only, summary comes async)
+        let content = '';
+        if (payload.memo) {
+            content = `## Notes\n\n${payload.memo}`;
+        }
+        // Create the entity immediately
+        await graph.create({
+            entityType: 'event',
+            entityId,
+            data,
+            content,
+            commitMessage: `Add event: ${data.name} (via ${payload.source})`,
+            user,
+        });
+        this.broadcast('created', repo, entityId, user);
+        // Generate summary asynchronously
+        this.processAsync(payload, repo, entityId, attendeeLinks, user).catch(err => {
+            log.warn(`[event-processor] Background processing failed for ${entityId}:`, err.message);
+        });
+        return {
+            entityId,
+            repo,
+            url: `/${repo}/event/${entityId}`,
+            attendeeLinks,
+            extractionPending: true,
+            tasksCreated: [],
+        };
+    }
+    /**
+     * Process a meeting for an entity that already exists (created by the web app).
+     * Meeting capture UI flow: entity was created when recording started,
+     * user typed notes in it, now we add the transcript and generate the summary.
+     */
+    async processExisting(payload, repo, existingEntityId, user) {
+        const graph = this.workspaceManager.getGraph(repo);
+        // Verify entity exists
+        try {
+            graph.get('event', existingEntityId);
+        }
+        catch {
+            throw new Error(`Event entity not found: ${existingEntityId}`);
+        }
+        // Resolve participants
+        const attendeeLinks = await this.resolveParticipants(payload.participants, repo);
+        // Update entity with processing flag and attendees
+        const updateData = {
+            processing: true,
+            attendees: attendeeLinks,
+            updated_at: new Date().toISOString(),
+        };
+        if (payload.durationMinutes) {
+            updateData.duration = payload.durationMinutes >= 60
+                ? `${Math.round(payload.durationMinutes / 60 * 10) / 10}h`
+                : `${payload.durationMinutes}m`;
+        }
+        if (payload.platform)
+            updateData.tags = ['auto-transcribed', payload.platform];
+        await graph.update({
+            entityType: 'event',
+            entityId: existingEntityId,
+            data: updateData,
+            content: undefined, // Don't overwrite content — keep user's notes until summary is ready
+            commitMessage: `Start processing event: ${existingEntityId}`,
+            user,
+        });
+        this.broadcast('updated', repo, existingEntityId, user);
+        // Generate summary asynchronously (same pipeline as new events)
+        this.processAsync(payload, repo, existingEntityId, attendeeLinks, user).catch(async (err) => {
+            log.warn(`[event-processor] Background processing failed for ${existingEntityId}:`, err.message);
+            // Always clear the processing flag so the entity doesn't stay stuck
+            try {
+                const g = this.workspaceManager.getGraph(repo);
+                await g.update({
+                    entityType: 'event',
+                    entityId: existingEntityId,
+                    data: { processing: false },
+                    commitMessage: `Clear processing flag after error: ${existingEntityId}`,
+                    user,
+                });
+                this.broadcast('updated', repo, existingEntityId, user);
+            }
+            catch { /* non-fatal */ }
+        });
+        return {
+            entityId: existingEntityId,
+            repo,
+            url: `/${repo}/event/${existingEntityId}`,
+            attendeeLinks,
+            extractionPending: true,
+            tasksCreated: [],
+        };
+    }
+    /**
+     * Async processing: LLM summary, extraction, task creation
+     */
+    async processAsync(payload, repo, entityId, attendeeLinks, user) {
+        const graph = this.workspaceManager.getGraph(repo);
+        // Format transcript
+        const transcript = payload.transcriptText
+            ?? (payload.transcript ? this.formatTranscript(payload.transcript) : '');
+        // Use existing summary from source, or generate via LLM. Pass natural
+        // names instead of wikilinks so the model can attribute statements to
+        // specific attendees from contextual cues — the transcript only carries
+        // channel-level "Me / Them" labels, but the LLM can recover names from
+        // in-dialog mentions ("Sarah, what do you think?"), self-introductions,
+        // and the calendar attendee list.
+        const selfName = payload.participants.find(p => p.isSelf)?.name || 'Me';
+        const remoteNames = payload.participants
+            .filter(p => !p.isSelf)
+            .map(p => p.name);
+        let summary = payload.existingSummary ?? null;
+        let summaryError;
+        if (!summary && transcript) {
+            const result = await this.generateSummary(transcript, payload.title || '', payload.memo || '', selfName, remoteNames);
+            summary = result.summary;
+            summaryError = result.error;
+        }
+        if (!summary) {
+            // Fallback: raw transcript (or just memo if no transcript). Surface
+            // the LLM error inline so the user sees *why* they got a raw transcript
+            // instead of a generated summary — otherwise this fallback looks like
+            // success and the actual failure is buried in server logs.
+            const errorBanner = summaryError
+                ? `> [!warning] AI summary failed\n> ${summaryError.replace(/\n/g, '\n> ')}`
+                : null;
+            const fallbackContent = [
+                errorBanner,
+                transcript || null,
+                payload.memo ? `## Notes\n\n${payload.memo}` : null,
+            ].filter(Boolean).join('\n\n---\n\n');
+            await graph.update({
+                entityType: 'event',
+                entityId,
+                data: { processing: false },
+                // Only overwrite content if we have something to write
+                content: fallbackContent || undefined,
+                commitMessage: `Add transcript for event: ${payload.title}`,
+                user,
+                source: fallbackContent ? 'server-write' : undefined,
+            });
+            this.broadcast('updated', repo, entityId, { id: 'ai-summary', name: 'AI Summary', email: 'ai@studiograph.local' });
+            return;
+        }
+        // Extract structured data
+        const { actionItems, decisions } = await this.extractStructuredData(summary);
+        // Create task entities from action items
+        const tasksCreated = [];
+        for (const item of actionItems) {
+            try {
+                const taskId = await this.createTask(item, entityId, repo, user);
+                if (taskId)
+                    tasksCreated.push(taskId);
+            }
+            catch {
+                // Non-fatal — log and continue
+            }
+        }
+        // Build final content
+        const updateData = { processing: false };
+        let finalContent = summary;
+        if (decisions.length > 0) {
+            finalContent += `\n\n## Decisions\n\n${decisions.map(d => `- ${d}`).join('\n')}`;
+        }
+        if (tasksCreated.length > 0) {
+            finalContent += `\n\n## Action Items\n\n${tasksCreated.map(id => `- [[${id}]]`).join('\n')}`;
+        }
+        if (payload.memo) {
+            finalContent += `\n\n---\n\n## Notes\n\n${payload.memo}`;
+        }
+        if (transcript) {
+            finalContent += `\n\n---\n\n## Transcript\n\n${transcript}`;
+        }
+        await graph.update({
+            entityType: 'event',
+            entityId,
+            data: updateData,
+            content: finalContent,
+            commitMessage: `Generate event notes: ${payload.title}`,
+            user,
+            source: 'server-write',
+        });
+        this.broadcast('updated', repo, entityId, { id: 'ai-summary', name: 'AI Summary', email: 'ai@studiograph.local' });
+    }
+    /**
+     * Create a task entity from an action item string, linked to the event.
+     */
+    async createTask(actionItem, eventEntityId, repo, user) {
+        const graph = this.workspaceManager.getGraph(repo);
+        const slug = this.slugify(actionItem.slice(0, 60));
+        const taskId = `task-${slug}-${Date.now()}`;
+        const now = new Date().toISOString();
+        await graph.create({
+            entityType: 'task',
+            entityId: taskId,
+            data: {
+                entity_type: 'task',
+                entity_id: taskId,
+                name: actionItem,
+                status: 'open',
+                date: now.slice(0, 10),
+                created_at: now,
+                updated_at: now,
+                created_by: user?.id ?? 'event-processor',
+                updated_by: user?.id ?? 'event-processor',
+                tags: ['from-event'],
+            },
+            content: `## Description\n\n${actionItem}\n\n## Source\n\n- Event: [[${eventEntityId}]]\n`,
+            commitMessage: `Create task from event: ${actionItem.slice(0, 50)}`,
+            user,
+        });
+        return taskId;
+    }
+    // ── Helpers ──────────────────────────────────────────────────────────
+    generateEntityId(payload) {
+        const date = payload.startedAt.slice(0, 10);
+        const title = payload.title || 'event';
+        return `${date}-${this.slugify(title)}`;
+    }
+    async resolveParticipants(participants, repo) {
+        const wikilinks = [];
+        for (const p of participants) {
+            const slug = this.slugify(p.name);
+            // Try direct ID lookup
+            try {
+                const graph = this.workspaceManager.getGraph(repo);
+                graph.get('person', slug);
+                wikilinks.push(`[[${slug}]]`);
+                continue;
+            }
+            catch { /* not found */ }
+            // Try search
+            try {
+                const results = await this.workspaceManager.search({
+                    query: p.name,
+                    repoNames: [repo],
+                    limit: 3,
+                });
+                const match = results.find(r => r.repoName === repo && r.data?.entity_type === 'person');
+                if (match) {
+                    wikilinks.push(`[[${match.data.entity_id}]]`);
+                    continue;
+                }
+            }
+            catch { /* search failed */ }
+            // Fallback: unresolved wikilink
+            wikilinks.push(`[[${slug}]]`);
+        }
+        return wikilinks;
+    }
+    formatTranscript(segments) {
+        const blocks = [];
+        let currentSpeaker = '';
+        let currentTexts = [];
+        for (const seg of segments) {
+            if (seg.isFinal === false)
+                continue;
+            if (seg.speaker !== currentSpeaker) {
+                if (currentSpeaker && currentTexts.length > 0) {
+                    blocks.push(`**${currentSpeaker}:** ${currentTexts.join(' ')}`);
+                }
+                currentSpeaker = seg.speaker;
+                currentTexts = [];
+            }
+            currentTexts.push(seg.text);
+        }
+        if (currentSpeaker && currentTexts.length > 0) {
+            blocks.push(`**${currentSpeaker}:** ${currentTexts.join(' ')}`);
+        }
+        return blocks.join('\n\n');
+    }
+    async generateSummary(transcript, title, memo, selfName, remoteNames) {
+        const { provider, modelId, apiKey } = this.getModelConfig();
+        if (!apiKey) {
+            return { summary: null, error: `No API key configured (provider=${provider}, model=${modelId})` };
+        }
+        try {
+            const model = getModel(provider, modelId);
+            const remoteNameList = remoteNames.length > 0 ? remoteNames.join(', ') : '(none on calendar)';
+            const prompt = `You are a meeting notes assistant. Generate structured meeting notes from this transcript.
+
+Meeting: ${title}
+Note-taker (the "Me" channel): ${selfName}
+Other attendees from calendar: ${remoteNameList}
+${memo ? `Note-taker's typed notes: ${memo}` : ''}
+
+Transcript:
+${transcript.slice(0, 30000)}
+
+The transcript labels are channel-based: "**Me:**" is ${selfName}; "**Them:**" is whichever remote attendee was speaking (multiple remote attendees share the same label, since they all came through the same audio channel).
+
+Use contextual cues to attribute statements to specific people by name when you're reasonably confident — names mentioned in dialog ("Sarah, what do you think?"), self-introductions ("Hi, I'm Marcus"), domain expertise references, and the calendar attendee list above. When you genuinely can't tell which attendee said something, write generically ("an attendee asked…", "the team discussed…") rather than guess. Never fabricate attribution.
+
+Write structured meeting notes in Markdown:
+1. Brief 2–3 sentence overview
+2. ### section headers for each major topic
+3. Bullet points for key points, decisions, context — attribute to attendees by name where context permits
+4. End with ### Next Steps listing concrete action items (include assignee name if identifiable)
+
+Guidelines:
+- Third person, past tense
+- Concise but capture the substance
+- Preserve important quotes when relevant
+- Group related points under clear headers
+- State decisions clearly
+
+Return ONLY the Markdown notes.`;
+            const response = await completeSimple(model, { messages: [{ role: 'user', content: prompt, timestamp: Date.now() }] }, { apiKey, maxTokens: 4096 });
+            const textContent = response.content.find(c => c.type === 'text');
+            const text = textContent?.type === 'text' ? textContent.text : '';
+            const trimmed = text.trim();
+            if (!trimmed) {
+                return { summary: null, error: `LLM returned empty response (provider=${provider}, model=${modelId})` };
+            }
+            return { summary: trimmed };
+        }
+        catch (err) {
+            const message = err.message || String(err);
+            log.warn('[event-processor] LLM summary failed:', message);
+            return { summary: null, error: `LLM call failed (provider=${provider}, model=${modelId}): ${message}` };
+        }
+    }
+    async extractStructuredData(summary) {
+        const { provider, modelId, apiKey } = this.getModelConfig();
+        if (!apiKey)
+            return { actionItems: [], decisions: [] };
+        try {
+            const model = getModel(provider, modelId);
+            const response = await completeSimple(model, {
+                messages: [{
+                        role: 'user',
+                        content: `Extract action items and decisions from these meeting notes. Return JSON only:
+{"actionItems": ["item with assignee if mentioned"], "decisions": ["decision made"]}
+
+Notes:
+${summary.slice(0, 8000)}`,
+                        timestamp: Date.now(),
+                    }],
+            }, { apiKey, maxTokens: 1024 });
+            const textContent = response.content.find(c => c.type === 'text');
+            const text = textContent?.type === 'text' ? textContent.text : '';
+            const parsed = JSON.parse(text);
+            return {
+                actionItems: Array.isArray(parsed.actionItems) ? parsed.actionItems : [],
+                decisions: Array.isArray(parsed.decisions) ? parsed.decisions : [],
+            };
+        }
+        catch {
+            return { actionItems: [], decisions: [] };
+        }
+    }
+    getModelConfig() {
+        const userConfig = loadUserConfig();
+        const provider = resolveProvider(userConfig);
+        const modelId = resolveModelId(userConfig);
+        const apiKey = resolveApiKey(userConfig);
+        return { provider, modelId, apiKey };
+    }
+    broadcast(action, repo, entityId, user) {
+        this.wsHub?.broadcast({
+            type: 'entity_change',
+            action,
+            repo,
+            entityType: 'event',
+            entityId,
+            actor: user?.name ?? 'system',
+            source: 'api',
+            timestamp: new Date().toISOString(),
+        });
+    }
+    slugify(str) {
+        return str
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, '-')
+            .replace(/^-|-$/g, '')
+            .slice(0, 80);
+    }
+}
+//# sourceMappingURL=event-processor.js.map

package/dist/services/event-processor.js.map

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

package/dist/services/folder-creation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared folder creation for network callers (web route + MCP tool).
+ *
+ * Wraps Workspace.registerRepo() with the concerns that are common to every
+ * network-facing creation path: kebab-case name validation, reserved-prefix
+ * guards, duplicate detection, folder-admin membership grant for the creator,
+ * and a folder_created WS broadcast.
+ *
+ * The CLI (`studiograph folder add`) deliberately does NOT use this helper —
+ * it runs locally with filesystem privileges, has no user identity to grant
+ * membership to, and no WS hub to broadcast on. It calls registerRepo()
+ * directly (see src/cli/commands/folder.ts).
+ *
+ * The private-folder auto-provision path (`ensurePrivateFolder` in
+ * src/server/routes/auth-api.ts) also calls registerRepo() directly because
+ * it has different semantics: private=true, no folder-admin grant, one per
+ * user. Not a fit for this helper.
+ */
+import type { WorkspaceManager } from '../core/workspace-manager.js';
+import type { AuthService, AuthUser } from './auth-service.js';
+import type { WsHub } from '../server/ws-hub.js';
+import type { RepoConfig } from '../core/types.js';
+export type FolderCreationErrorCode = 'invalid_name' | 'duplicate' | 'internal';
+export declare class FolderCreationError extends Error {
+    readonly code: FolderCreationErrorCode;
+    constructor(code: FolderCreationErrorCode, message: string);
+}
+export interface CreateSharedFolderInput {
+    name: string;
+    display_name?: string;
+    description?: string;
+}
+export declare function createSharedFolder(workspaceManager: WorkspaceManager, authService: AuthService, input: CreateSharedFolderInput, user: AuthUser | undefined, wsHub?: WsHub): Promise<RepoConfig>;

package/dist/services/folder-creation.js

@@ -0,0 +1,103 @@
+/**
+ * Shared folder creation for network callers (web route + MCP tool).
+ *
+ * Wraps Workspace.registerRepo() with the concerns that are common to every
+ * network-facing creation path: kebab-case name validation, reserved-prefix
+ * guards, duplicate detection, folder-admin membership grant for the creator,
+ * and a folder_created WS broadcast.
+ *
+ * The CLI (`studiograph folder add`) deliberately does NOT use this helper —
+ * it runs locally with filesystem privileges, has no user identity to grant
+ * membership to, and no WS hub to broadcast on. It calls registerRepo()
+ * directly (see src/cli/commands/folder.ts).
+ *
+ * The private-folder auto-provision path (`ensurePrivateFolder` in
+ * src/server/routes/auth-api.ts) also calls registerRepo() directly because
+ * it has different semantics: private=true, no folder-admin grant, one per
+ * user. Not a fit for this helper.
+ */
+import { Workspace } from '../core/workspace.js';
+export class FolderCreationError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'FolderCreationError';
+    }
+}
+const SLUG_REGEX = /^[a-z0-9][a-z0-9-]*$/;
+const MAX_NAME_LENGTH = 64;
+/**
+ * Reserved for per-user private folder auto-provisioning
+ * (`entries-<userId>` in auth-api.ts#ensurePrivateFolder). Letting a
+ * shared folder squat this prefix would block a new user's private
+ * provisioning on login.
+ */
+const RESERVED_NAME_REGEX = /^entries-\d+$/;
+export async function createSharedFolder(workspaceManager, authService, input, user, wsHub) {
+    const name = typeof input.name === 'string' ? input.name : '';
+    const display_name = input.display_name;
+    const description = input.description;
+    if (!name || !SLUG_REGEX.test(name)) {
+        throw new FolderCreationError('invalid_name', 'Folder name must be kebab-case (lowercase letters, digits, hyphens; must start with a letter or digit)');
+    }
+    if (name.length > MAX_NAME_LENGTH) {
+        throw new FolderCreationError('invalid_name', `Folder name must be ${MAX_NAME_LENGTH} characters or fewer`);
+    }
+    if (RESERVED_NAME_REGEX.test(name)) {
+        throw new FolderCreationError('invalid_name', 'Folder name "entries-<number>" is reserved for per-user private folders');
+    }
+    const workspace = new Workspace(workspaceManager.workspacePath);
+    let repo;
+    try {
+        repo = await workspace.registerRepo({
+            name,
+            display_name: display_name || undefined,
+            description,
+            owner_id: user?.id,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (/already registered/i.test(msg)) {
+            throw new FolderCreationError('duplicate', `Folder "${name}" already exists`);
+        }
+        throw new FolderCreationError('internal', msg);
+    }
+    workspaceManager.reloadConfig();
+    if (user)
+        authService.grantFolderAccess(user.id, name, 'admin');
+    // For an authenticated creator, deliver to that user's own sessions only.
+    // A regular `broadcast()` would be filtered by `canReceive()` against each
+    // client's connection-time folder snapshot — which by definition doesn't
+    // contain a brand-new folder — so the event would be silently dropped.
+    // Patch the snapshot via `addUserFolder` so subsequent `entity_change`
+    // broadcasts for entities in this folder reach the creator without
+    // requiring a reconnect.
+    //
+    // For anonymous / API-without-identity creates (CLI, scripts), fall back
+    // to a plain broadcast. Open-mode clients (`client.folders === null`)
+    // bypass canReceive and will pick it up; auth-mode clients would have
+    // dropped it anyway, which preserves the prior behavior.
+    if (wsHub) {
+        if (user) {
+            wsHub.addUserFolder(String(user.id), name);
+            wsHub.broadcastToUser(String(user.id), {
+                type: 'folder_created',
+                repo: name,
+                actor: user.displayName,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        else {
+            wsHub.broadcast({
+                type: 'folder_created',
+                repo: name,
+                actor: 'API',
+                timestamp: new Date().toISOString(),
+            });
+        }
+    }
+    return repo;
+}
+//# sourceMappingURL=folder-creation.js.map

package/dist/services/folder-creation.js.map

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