audrey 0.20.0 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +170 -115
  3. package/dist/mcp-server/config.d.ts +25 -1
  4. package/dist/mcp-server/config.d.ts.map +1 -1
  5. package/dist/mcp-server/config.js +97 -12
  6. package/dist/mcp-server/config.js.map +1 -1
  7. package/dist/mcp-server/index.d.ts +83 -2
  8. package/dist/mcp-server/index.d.ts.map +1 -1
  9. package/dist/mcp-server/index.js +453 -36
  10. package/dist/mcp-server/index.js.map +1 -1
  11. package/dist/src/audrey.d.ts +4 -0
  12. package/dist/src/audrey.d.ts.map +1 -1
  13. package/dist/src/audrey.js +12 -0
  14. package/dist/src/audrey.js.map +1 -1
  15. package/dist/src/index.d.ts +4 -0
  16. package/dist/src/index.d.ts.map +1 -1
  17. package/dist/src/index.js +2 -0
  18. package/dist/src/index.js.map +1 -1
  19. package/dist/src/preflight.d.ts +51 -0
  20. package/dist/src/preflight.d.ts.map +1 -0
  21. package/dist/src/preflight.js +201 -0
  22. package/dist/src/preflight.js.map +1 -0
  23. package/dist/src/reflexes.d.ts +35 -0
  24. package/dist/src/reflexes.d.ts.map +1 -0
  25. package/dist/src/reflexes.js +87 -0
  26. package/dist/src/reflexes.js.map +1 -0
  27. package/dist/src/routes.d.ts.map +1 -1
  28. package/dist/src/routes.js +84 -7
  29. package/dist/src/routes.js.map +1 -1
  30. package/docs/assets/audrey-feature-grid.jpg +0 -0
  31. package/docs/assets/audrey-logo.svg +45 -0
  32. package/docs/assets/audrey-wordmark.png +0 -0
  33. package/docs/audrey-for-dummies.md +670 -0
  34. package/docs/future-of-llm-memory.md +452 -0
  35. package/docs/mcp-hosts.md +206 -0
  36. package/docs/ollama-local-agents.md +128 -0
  37. package/docs/production-readiness.md +11 -7
  38. package/examples/ollama-memory-agent.js +326 -0
  39. package/package.json +21 -2
@@ -69,7 +69,46 @@ export declare const memoryForgetToolSchema: {
69
69
  min_similarity: z.ZodOptional<z.ZodNumber>;
70
70
  purge: z.ZodOptional<z.ZodBoolean>;
71
71
  };
72
- interface StatusReport {
72
+ export declare const memoryPreflightToolSchema: {
73
+ action: z.ZodString;
74
+ tool: z.ZodOptional<z.ZodString>;
75
+ session_id: z.ZodOptional<z.ZodString>;
76
+ cwd: z.ZodOptional<z.ZodString>;
77
+ files: z.ZodOptional<z.ZodArray<z.ZodString>>;
78
+ strict: z.ZodOptional<z.ZodBoolean>;
79
+ limit: z.ZodOptional<z.ZodNumber>;
80
+ budget_chars: z.ZodOptional<z.ZodNumber>;
81
+ mode: z.ZodOptional<z.ZodEnum<{
82
+ balanced: "balanced";
83
+ conservative: "conservative";
84
+ aggressive: "aggressive";
85
+ }>>;
86
+ failure_window_hours: z.ZodOptional<z.ZodNumber>;
87
+ include_status: z.ZodOptional<z.ZodBoolean>;
88
+ record_event: z.ZodOptional<z.ZodBoolean>;
89
+ include_capsule: z.ZodOptional<z.ZodBoolean>;
90
+ };
91
+ export declare const memoryReflexesToolSchema: {
92
+ include_preflight: z.ZodOptional<z.ZodBoolean>;
93
+ action: z.ZodString;
94
+ tool: z.ZodOptional<z.ZodString>;
95
+ session_id: z.ZodOptional<z.ZodString>;
96
+ cwd: z.ZodOptional<z.ZodString>;
97
+ files: z.ZodOptional<z.ZodArray<z.ZodString>>;
98
+ strict: z.ZodOptional<z.ZodBoolean>;
99
+ limit: z.ZodOptional<z.ZodNumber>;
100
+ budget_chars: z.ZodOptional<z.ZodNumber>;
101
+ mode: z.ZodOptional<z.ZodEnum<{
102
+ balanced: "balanced";
103
+ conservative: "conservative";
104
+ aggressive: "aggressive";
105
+ }>>;
106
+ failure_window_hours: z.ZodOptional<z.ZodNumber>;
107
+ include_status: z.ZodOptional<z.ZodBoolean>;
108
+ record_event: z.ZodOptional<z.ZodBoolean>;
109
+ include_capsule: z.ZodOptional<z.ZodBoolean>;
110
+ };
111
+ export interface StatusReport {
73
112
  generatedAt: string;
74
113
  registered: boolean;
75
114
  dataDir: string;
@@ -80,6 +119,32 @@ interface StatusReport {
80
119
  lastConsolidation: string | null;
81
120
  error: string | null;
82
121
  }
122
+ export type DoctorSeverity = 'info' | 'warning' | 'error';
123
+ export interface DoctorCheck {
124
+ name: string;
125
+ ok: boolean;
126
+ severity: DoctorSeverity;
127
+ message: string;
128
+ hint?: string;
129
+ }
130
+ export interface DoctorReport {
131
+ generatedAt: string;
132
+ version: string;
133
+ node: string;
134
+ platform: string;
135
+ entrypoint: string;
136
+ dataDir: string;
137
+ embedding: string;
138
+ llm: string;
139
+ status: StatusReport;
140
+ checks: DoctorCheck[];
141
+ ok: boolean;
142
+ }
143
+ export declare function formatInstallGuide(host: string, env?: Record<string, string | undefined>, dryRun?: boolean): string;
144
+ export declare function runDemoCommand({ out, keep, }?: {
145
+ out?: (...args: unknown[]) => void;
146
+ keep?: boolean;
147
+ }): Promise<void>;
83
148
  export declare function buildStatusReport({ dataDir, claudeJsonPath, }?: {
84
149
  dataDir?: string;
85
150
  claudeJsonPath?: string;
@@ -94,7 +159,23 @@ export declare function runStatusCommand({ argv, dataDir, claudeJsonPath, out, }
94
159
  report: StatusReport;
95
160
  exitCode: number;
96
161
  };
162
+ export declare function buildDoctorReport({ dataDir, claudeJsonPath, env, nodeVersion, }?: {
163
+ dataDir?: string;
164
+ claudeJsonPath?: string;
165
+ env?: Record<string, string | undefined>;
166
+ nodeVersion?: string;
167
+ }): DoctorReport;
168
+ export declare function formatDoctorReport(report: DoctorReport): string;
169
+ export declare function runDoctorCommand({ argv, dataDir, claudeJsonPath, env, out, }?: {
170
+ argv?: string[];
171
+ dataDir?: string;
172
+ claudeJsonPath?: string;
173
+ env?: Record<string, string | undefined>;
174
+ out?: (...args: unknown[]) => void;
175
+ }): {
176
+ report: DoctorReport;
177
+ exitCode: number;
178
+ };
97
179
  export declare function registerShutdownHandlers(processRef: NodeJS.Process, audrey: Audrey, logger?: (...args: unknown[]) => void): (message?: string, exitCode?: number) => void;
98
180
  export declare function registerDreamTool(server: any, audrey: Audrey): void;
99
- export {};
100
181
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../mcp-server/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,KAAK,EAAgB,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAyB7G,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAQhD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAO3D;AAED,wBAAgB,uBAAuB,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAIzE;AAED,wBAAsB,2BAA2B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5F;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;CAelC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;CAclC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;CAYlC,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;CAKlC,CAAC;AAMF,UAAU,YAAY;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAoXD,wBAAgB,iBAAiB,CAAC,EAChC,OAAqC,EACrC,cAAgD,GACjD,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,CA+CnE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAmC/D;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,IAAmB,EACnB,OAAqC,EACrC,cAAgD,EAChD,GAAiB,GAClB,GAAE;IACD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CAC/B,GAAG;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAclD;AAiBD,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,OAAO,EAC1B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAoB,GACnD,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAkC/C;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAyBnE"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../mcp-server/index.ts"],"names":[],"mappings":"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"}