minutes-sdk 0.7.0 → 0.7.3

package/README.md

@@ -0,0 +1,191 @@
+# minutes-sdk
+
+Conversation memory for AI agents. Query meeting transcripts, decisions, action items, and people from any AI agent or application.
+
+The "Mem0 for human conversations." Works with [Minutes](https://github.com/silverstein/minutes) meeting files or any markdown with YAML frontmatter.
+
+## Install
+
+```bash
+npm install minutes-sdk
+```
+
+## Quick start
+
+```typescript
+import { listMeetings, searchMeetings, findOpenActions } from 'minutes-sdk';
+
+// List recent meetings
+const meetings = await listMeetings('~/meetings');
+// → [{ frontmatter: { title, date, action_items, decisions, ... }, body, path }]
+
+// Search across all meetings
+const results = await searchMeetings('~/meetings', 'pricing strategy');
+
+// Find open action items
+const actions = await findOpenActions('~/meetings', 'alex');
+// → [{ path: '...', item: { assignee: 'alex', task: '...', status: 'open' } }]
+```
+
+## API
+
+### `listMeetings(dir, limit?)`
+
+List meetings sorted by date (newest first).
+
+```typescript
+const meetings = await listMeetings('~/meetings', 50);
+```
+
+### `searchMeetings(dir, query, limit?)`
+
+Full-text search across titles and transcripts.
+
+```typescript
+const results = await searchMeetings('~/meetings', 'Q2 roadmap');
+```
+
+### `getMeeting(path)`
+
+Read a single meeting file.
+
+```typescript
+const meeting = await getMeeting('~/meetings/2026-03-24-planning.md');
+console.log(meeting.frontmatter.decisions);
+```
+
+### `findOpenActions(dir, assignee?)`
+
+Find open action items, optionally filtered by assignee.
+
+```typescript
+const allOpen = await findOpenActions('~/meetings');
+const mine = await findOpenActions('~/meetings', 'mat');
+```
+
+### `getPersonProfile(dir, name)`
+
+Build a profile for someone across all meetings — their meetings, open action items, and topics.
+
+```typescript
+const profile = await getPersonProfile('~/meetings', 'alex');
+// → { name, meetings: [...], openActions: [...], topics: ['pricing', 'api'] }
+```
+
+### `parseFrontmatter(content, path)`
+
+Parse a markdown string into a `MeetingFile`. Useful for custom integrations.
+
+```typescript
+import { parseFrontmatter } from 'minutes-sdk';
+
+const meeting = parseFrontmatter(markdownString, '/path/to/file.md');
+```
+
+## Use with AI frameworks
+
+### Vercel AI SDK tool
+
+```typescript
+import { tool } from 'ai';
+import { z } from 'zod';
+import { searchMeetings } from 'minutes-sdk';
+
+const meetingSearch = tool({
+  description: 'Search past meeting transcripts and decisions',
+  parameters: z.object({ query: z.string() }),
+  execute: async ({ query }) => {
+    const results = await searchMeetings('~/meetings', query, 5);
+    return results.map(m => ({
+      title: m.frontmatter.title,
+      date: m.frontmatter.date,
+      decisions: m.frontmatter.decisions,
+      actions: m.frontmatter.action_items,
+    }));
+  },
+});
+```
+
+### LangChain tool
+
+```typescript
+import { DynamicTool } from '@langchain/core/tools';
+import { searchMeetings } from 'minutes-sdk';
+
+const meetingTool = new DynamicTool({
+  name: 'search_meetings',
+  description: 'Search meeting transcripts for decisions and context',
+  func: async (query) => {
+    const results = await searchMeetings('~/meetings', query, 5);
+    return JSON.stringify(results.map(m => ({
+      title: m.frontmatter.title,
+      date: m.frontmatter.date,
+      summary: m.body.slice(0, 500),
+    })));
+  },
+});
+```
+
+## Types
+
+```typescript
+interface MeetingFile {
+  frontmatter: Frontmatter;
+  body: string;      // Full markdown body (transcript, summary, notes)
+  path: string;      // Absolute file path
+}
+
+interface Frontmatter {
+  title: string;
+  type: string;      // "meeting" | "memo" | "dictation"
+  date: string;      // ISO 8601
+  duration: string;
+  source?: string;   // "voice-memos" | "dictation" | undefined
+  device?: string;   // "iPhone" etc (cross-device pipeline)
+  tags: string[];
+  attendees: string[];
+  people: string[];
+  action_items: ActionItem[];
+  decisions: Decision[];
+  intents: Intent[];  // Structured commitments, questions, decisions
+}
+
+interface ActionItem {
+  assignee: string;
+  task: string;
+  due?: string;
+  status: string;    // "open" | "done"
+}
+
+interface Decision {
+  text: string;
+  topic?: string;
+}
+
+interface Intent {
+  kind: string;      // "commitment" | "decision" | "open-question"
+  what: string;
+  who?: string;
+  status: string;
+  by_date?: string;
+}
+```
+
+## How it works
+
+The SDK reads markdown files with YAML frontmatter produced by [Minutes](https://github.com/silverstein/minutes). No database, no server, no API key — just files on disk.
+
+```
+~/meetings/
+├── 2026-03-24-q2-planning.md          ← meetings
+├── 2026-03-24-client-call.md
+└── memos/
+    ├── 2026-03-24-pricing-idea.md     ← voice memos
+    └── 2026-03-23-onboarding-thought.md
+```
+
+Each file has structured YAML frontmatter (title, date, attendees, action items, decisions, intents) and a markdown body (transcript, summary, notes). The SDK parses these and provides query functions.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -1 +1 @@
-export { type ActionItem, type Decision, type Intent, type Frontmatter, type MeetingFile, splitFrontmatter, parseFrontmatter, listMeetings, searchMeetings, getMeeting, findOpenActions, getPersonProfile, } from "./reader.js";
+export { type ActionItem, type Decision, type Intent, type Frontmatter, type MeetingFile, defaultDir, splitFrontmatter, parseFrontmatter, listMeetings, searchMeetings, getMeeting, findOpenActions, findDecisions, getPersonProfile, listVoiceMemos, } from "./reader.js";

package/dist/index.js

@@ -4,12 +4,14 @@
 // decisions, action items, and people from any AI agent or app.
 //
 // Usage:
-//   import { listMeetings, searchMeetings } from 'minutes-sdk';
+//   import { listMeetings, searchMeetings, defaultDir } from 'minutes-sdk';
 //
-//   const meetings = await listMeetings('~/meetings');
-//   const results = await searchMeetings('~/meetings', 'pricing');
+//   const meetings = await listMeetings(defaultDir());
+//   const results = await searchMeetings(defaultDir(), 'pricing');
 export { 
+// Config
+defaultDir, 
 // Parsing
 splitFrontmatter, parseFrontmatter, 
 // Query API
-listMeetings, searchMeetings, getMeeting, findOpenActions, getPersonProfile, } from "./reader.js";
+listMeetings, searchMeetings, getMeeting, findOpenActions, findDecisions, getPersonProfile, listVoiceMemos, } from "./reader.js";

package/dist/reader.d.ts

@@ -84,3 +84,25 @@ export declare function getPersonProfile(dir: string, name: string): Promise<{
     openActions: ActionItem[];
     topics: string[];
 }>;
+/**
+ * Default meetings directory (~\/meetings).
+ * Override with MEETINGS_DIR env var or pass a custom path to any function.
+ */
+export declare function defaultDir(): string;
+/**
+ * List recent voice memos (type: memo), sorted by date descending.
+ * Useful for cross-device pipeline recall — "what ideas did I capture recently?"
+ */
+export declare function listVoiceMemos(dir: string, options?: {
+    days?: number;
+    limit?: number;
+}): Promise<MeetingFile[]>;
+/**
+ * Find decisions across all meetings, optionally filtered by topic keyword.
+ */
+export declare function findDecisions(dir: string, topic?: string, limit?: number): Promise<Array<{
+    path: string;
+    title: string;
+    date: string;
+    decision: Decision;
+}>>;

package/dist/reader.js

@@ -13,6 +13,7 @@
 //                      listMeetings()      searchMeetings()
 import { readFile, readdir } from "fs/promises";
 import { join, extname } from "path";
+import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 // ── Parsing ──────────────────────────────────────────────────
 /**
@@ -246,3 +247,57 @@ export async function getPersonProfile(dir, name) {
         topics: Array.from(topicSet),
     };
 }
+/**
+ * Default meetings directory (~\/meetings).
+ * Override with MEETINGS_DIR env var or pass a custom path to any function.
+ */
+export function defaultDir() {
+    return process.env.MEETINGS_DIR || join(homedir(), "meetings");
+}
+/**
+ * List recent voice memos (type: memo), sorted by date descending.
+ * Useful for cross-device pipeline recall — "what ideas did I capture recently?"
+ */
+export async function listVoiceMemos(dir, options = {}) {
+    const { days = 14, limit = 20 } = options;
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    const meetings = await listMeetings(dir, 500);
+    const memos = meetings.filter((m) => {
+        if (m.frontmatter.type !== "memo")
+            return false;
+        const date = new Date(m.frontmatter.date);
+        return date >= cutoff;
+    });
+    return memos.slice(0, limit);
+}
+/**
+ * Find decisions across all meetings, optionally filtered by topic keyword.
+ */
+export async function findDecisions(dir, topic, limit = 50) {
+    const files = await findMarkdownFiles(dir);
+    const results = [];
+    for (const file of files) {
+        const meeting = await readMeetingFile(file);
+        if (!meeting)
+            continue;
+        for (const decision of meeting.frontmatter.decisions) {
+            if (topic) {
+                const topicLower = topic.toLowerCase();
+                const matches = decision.text.toLowerCase().includes(topicLower) ||
+                    (decision.topic && decision.topic.toLowerCase().includes(topicLower));
+                if (!matches)
+                    continue;
+            }
+            results.push({
+                path: meeting.path,
+                title: meeting.frontmatter.title,
+                date: meeting.frontmatter.date,
+                decision,
+            });
+        }
+    }
+    return results
+        .sort((a, b) => b.date.localeCompare(a.date))
+        .slice(0, limit);
+}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "minutes-sdk",
-  "version": "0.7.0",
+  "version": "0.7.3",
   "description": "Conversation memory SDK — query meeting transcripts, decisions, and action items from any AI agent or application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
   "files": [
-    "dist/"
+    "dist/",
+    "README.md"
   ],
   "keywords": [
     "meeting",