@ztimson/momentum 0.53.2 → 1.0.0

package/README.md

@@ -3,7 +3,7 @@
   <br />
   
   <!-- Logo -->
-  <img src="server/public/favicon.png" alt="Logo" width="200" height="200">
+  <img src="https://momentum.zakscode.com/favicon.png" alt="Logo" width="200" height="200">
 
   <!-- Title -->
   ### Momentum
@@ -12,18 +12,18 @@
   Enterprise Record Management
 
   <!-- Repo badges -->
-  [![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/momentum/tags%3Ftoken%3D35a3bf73a216782a7435f86117412bcb9784b716&query=$[0].name)](https://git.zakscode.com/ztimson/momentum/tags)
-  [![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/momentum%3Ftoken%3D35a3bf73a216782a7435f86117412bcb9784b716&query=open_pr_counter)](https://git.zakscode.com/ztimson/momentum/pulls)
-  [![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/ztimson/momentum%3Ftoken%3D35a3bf73a216782a7435f86117412bcb9784b716&query=open_issues_count)](https://git.zakscode.com/ztimson/momentum/issues)
+  [![Version](https://img.shields.io/badge/dynamic/json.svg?label=Version&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/momentum/momentum/tags%3Ftoken%3D35a3bf73a216782a7435f86117412bcb9784b716&query=$[0].name)](https://git.zakscode.com/momentum/momentum/tags)
+  [![Pull Requests](https://img.shields.io/badge/dynamic/json.svg?label=Pull%20Requests&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/momentum/momentum%3Ftoken%3D35a3bf73a216782a7435f86117412bcb9784b716&query=open_pr_counter)](https://git.zakscode.com/momentum/momentum/pulls)
+  [![Issues](https://img.shields.io/badge/dynamic/json.svg?label=Issues&style=for-the-badge&url=https://git.zakscode.com/api/v1/repos/momentum/momentum%3Ftoken%3D35a3bf73a216782a7435f86117412bcb9784b716&query=open_issues_count)](https://git.zakscode.com/momentum/momentum/issues)
 
   <!-- Links -->
 
   ---
   <div>
-    <a href="https://git.zakscode.com/ztimson/momentum/wiki" target="_blank">Documentation</a>
-    • <a href="https://git.zakscode.com/ztimson/momentum/releases" target="_blank">Release Notes</a>
-    • <a href="https://git.zakscode.com/ztimson/momentum/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
-    • <a href="https://git.zakscode.com/ztimson/momentum/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
+    <a href="https://git.zakscode.com/momentum/momentum/wiki" target="_blank">Documentation</a>
+    • <a href="https://git.zakscode.com/momentum/momentum/releases" target="_blank">Release Notes</a>
+    • <a href="https://git.zakscode.com/momentum/momentum/issues/new?template=.github%2fissue_template%2fbug.md" target="_blank">Report a Bug</a>
+    • <a href="https://git.zakscode.com/momentum/momentum/issues/new?template=.github%2fissue_template%2fenhancement.md" target="_blank">Request a Feature</a>
   </div>
 
   ---
@@ -40,61 +40,112 @@
 
 ## About
 
-Momentum is a self-hosted enterprise resource planning tool. What does that mean? Think something similar to [Firebase](https://firebase.google.com) but you are in full control of your data & services.
+https://momentum.zakscode.com
 
-It was developed as a generic backend to add functionality to single page applications such as angular, react, svelte or vue. Momentum comes with a client library to make integration extremely easy.
+Momentum is a self-hosted _Enterprise Resource Planning_ (ERP) tool with a _content managment system_ (CMS). What does that mean? We can automate your businesses day-to-day operations and give you a pretty interface to control it by storing & coordinating your data & information; from any location or server.
 
-Momentum also comes with a management interface to allow easy administration of momentum without having to build anything.
+While several businesses might deliver the same final product as your business, what sets you apart is your institutional knowledge and unique execution. However, most of this is
+lost when businesses are forced to conform to software and not the other way around. This is where Momentum is different.
+
+Momentum delivers several feature-packed modules to cover every software need and an intuitive _Content Management System_ (CMS) to connect features as needed.
+And with the built-in AI or a programmer you can build & integrate custom apps and websites in seconds.
+
+Here at ZaksCode we believe the current standard software is held to is pitiful. We aim to keep your business by being the best, not vendor lock-in practices.
+Not only do we offer the most features and the best experience, but we do so while being the smallest, fastest, most efficient & secure ERP system out there.
 
 Features include:
   - Actions
-    - Write server side code to create custom functionality
+    - Write server side code to "mod" Momentum & create custom functionality
     - Writen with javascript & the momentum client library to minimize the learning curve
     - Custom library and can be installed & accessed from actions using Docker & NPM
-    - Trigger actions including CRONs, RESTFUL requests & system events
-    - Extremely fast
+    - Trigger actions via events, CRONs or REST requests
+    - Kept in memory for high performance and 0 cold start time
+  - AI
+    - Ask the assistant questions about your records
+    - Automate your workflow and use AI to process data & files automatically
+    - Use the AI to build actions, apps & websites with momentum integration
+    - Local / Offline ASR & OCR models to extract text from most file types (text, image, pdf, audio, video)
+    - Local or remote LLM models
+  - Analytics
+    - Track device specs & performance
+    - Track IP addresses and trace on demand (not stored)
+    - Track a user journey (which pages are visited for how long)
+    - Track referrers & ad campaigns
+    - Track conversion rates & custom metrics tracking
+    - UI for viewing all data & running custom reports
   - Authentication
     - Manage users with custom values
     - Manage groups with cascading permissions & custom values
     - Token management for 3rd party applications
-    - Full permission system which supports custom values
+    - Full permission system with custom permissions support
     - Account validation & reset emails
     - Optional public registration form
-    - OAuth support for custom applications
-    - Custom password strength rules
+    - Host OAuth portal for custom application login
+    - Custom password strength & rotation settings
     - Two-Factor Authentication
+    - OAuth & LDAP support
   - Data
-    - Edit database like an Excel table 
-    - Create custom forms & reports to interact with data
-    - Interact with data through the REST API
-    - Granular collection & document level permissions
-    - Automatic metadata tracking
+    - Advanced search
+    - Edit database like an Excel spreadsheet
+    - Conditional styling
+    - Calculate columns with excel formulas or javascript
+    - Granular collection & record level permissions
+    - Automatic metadata & history tracking
     - Easy import/export to CSV, Excel & JSON
+  - Forms
+    - Create forms that integrate with database
+    - Create custom reports with graphs, maps & more
+    - Granular permissions
   - Logs
-    - Save & view server logs through the UI for easy debugging
-    - Submit client logs to momentum to aid in remote debugging
-    - Client logs come with device information such as user agent & screen size
+    - Save & view server logs for easy debugging
+    - Submit logs to track remote environments
+    - Capture remote device specs for debugging
+    - Unlimited remote logging channels
+    - Local logs for debugging mobile devices
+    - All changes are recorded and can be reverted
+  - Messaging
+    - Send emails with SMTP
+    - Send notifications to apps
+    - Phone call & SMS integration with Twilio
+    - Supports WebRTC with built-in STUN/TURN server for video/voice calls
+  - Payments
+    - Stripe support to handle payments & subscriptions
+    - Manage products through spreadsheets
+    - Easy form & report integration
+	- Create custom discount codes
+    - Automatic taxes
   - Storage
-    - Storage anything with momentum storage 
-    - Built in filebrowser
-    - Upload & download files with the API
-    - Full file permissions
+    - Store files
+    - Share files with any user/group
+    - Built-in filebrowser with drag & drop
     - Automatic metadata tracking
+    - Full file/folder permissions
   - Static File Server
-    - Host your single page application using Momentum for easy hosting
+    - Host your web applications with the API
+    - Built-in filebrowser with drag & drop
+    - Automatic metadata tracking
     - Configurable routing
   - Settings
     - Full theming & white label support 
     - Manage the server through variables which can be changed at runtime
     - Create & use custom variables for your application
   - Miscellaneous
-    - Automatically turn website into Progressive Web App 
-    - Caching & offline support built into the client library
-    - Socket support to keep all clients in sync automatically
-    - Generate PDFs from templates, HTML or links
-    - SMTP support to send emails from templates
-    - Twilio support to manage texts & calls
-    - Stripe support to handle payments & subscriptions
+    - CCPA / GDPR / PIPEDA compliant
+    - Configurable Terms of Service & Privacy Policy
+    - Automatic notifications/SMS/call/email alerts
+    - Generate PDFs from templates, forms, pages or HTML
+    - Turn any website into an offline mobile/desktop app
+    - Caching & offline support built in
+    - Live collaborative editing
+    - All features support REST for easy integration with websites & apps
+    - Writen documentation & OpenApi docs
+    - Extremely light weight & small
+    - Configurable endpoint protection with rate limiting & CAPTCHA bot detection
+    - Handles thousands of requests per second per instance while losing < 1GB of RAM
+    - Prometheus metrics
+
+Demo Sites:
+- https://law.momentum.zakscode.com
 
 ### Built With
 [![Docker](https://img.shields.io/badge/Docker-384d54?style=for-the-badge&logo=docker)](https://docker.com/)
@@ -113,9 +164,9 @@ Features include:
 - [Docker](https://docs.docker.com/install/)
 
 #### Instructions
-1. _Optional: Use momentum to host your [static site](https://git.zakscode.com/ztimson/momentum/wiki/Static)_
-2. Download the [docker-compose](https://git.zakscode.com/ztimson/momentum/src/branch/develop/docker-compose.yml) file: `curl -o momentum.yaml https://git.zakscode.com/ztimson/momentum/raw/branch/develop/docker-compose.yml`
-3. Configure the [Environment Variables](https://git.zakscode.com/ztimson/momentum/wiki/Environment-Variables) inside the docker-compose
+1. _Optional: Use momentum to host your [static site](https://git.zakscode.com/momentum/momentum/wiki/Static)_
+2. Download the [docker-compose](https://git.zakscode.com/momentum/momentum/src/branch/develop/docker-compose.yml) file: `curl -o momentum.yaml https://git.zakscode.com/momentum/momentum/raw/branch/develop/docker-compose.yml`
+3. Configure the [Environment Variables](https://git.zakscode.com/momentum/momentum/wiki/Environment-Variables) inside the docker-compose
 4. Start the server with: `docker-compose up -f momentum.yaml`
 5. Open http://localhost:80
 	- Default login: `admin/admin`
@@ -132,13 +183,17 @@ Features include:
 - [Docker](https://docs.docker.com/install/)
 - [Node.js](https://nodejs.org/en/download)
 
+##### Optional
+- _[ffmpeg](https://ffmpeg.org/download.html) (Video utilities)_
+- _[Whisper](https://github.com/ggml-org/whisper.cpp/releases/tag/v1.7.6) (Audio -> Text)_
+
 #### Instructions
 1. Install the dependencies: `npm install`
 2. Start MongoDB: `docker-compose up db`
 3. Start the dev server: `npm run start`
 4. Open http://localhost:3000
 	- Default login: `admin/admin`
-	- Configure [System Variables](https://git.zakscode.com/ztimson/momentum/wiki/System-Variables)
+	- Configure [System Variables](https://git.zakscode.com/momentum/momentum/wiki/System-Variables)
 
 </details>
 

package/bin/build-models.mjs

@@ -3,14 +3,18 @@
 import fs from 'fs';
 import {join} from 'path';
 import {Momentum} from '../dist/index.mjs';
-import * as readline from 'node:readline';
-import {camelCase, formatDate} from '@ztimson/utils';
+import {formatDate, kebabCase, pascalCase} from '@ztimson/utils';
+import readline from 'readline';
+import packageFile from '../package.json' with {type: 'json'};
 
-export function ask(prompt, hide = false) {
-	const rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+function ask(prompt, hide = false) {
+	const rl = readline.createInterface({input: process.stdin, output: process.stdout, terminal: true});
 	return new Promise((resolve) => {
 		if (!hide) {
-			rl.question(prompt, (answer) => (rl.close(), resolve(answer)));
+			rl.question(prompt, (answer) => {
+				resolve(answer);
+				rl.close();
+			});
 		} else {
 			let input = '';
 			const onKeyPress = (char, key) => {
@@ -38,70 +42,57 @@ export function ask(prompt, hide = false) {
 	});
 }
 
-function createProp(column) {
-	let prop = column.prop;
-	if(column.type == 'formula' || column.type == 'javascript') prop = `readonly ${prop}`;
-	prop += column.required ? ': ' : '?: ';
-	if(column.type == 'formula' || column.type == 'javascript') prop += 'any';
-	else if(column.type == 'link') prop += 'string';
-	else if(column.type == 'timestamp') prop += 'Date';
-	else prop += `${column.type}`;
-	return prop;
-}
-
 // Main loop
 (async () => {
 	try {
 		// Arguments
-		let [,, destination, url, username, password] = process.argv;
-		const packageFile = await import('../package.json', {with: { type: 'json' }});
+		let [, , destination, url, username, password] = process.argv;
 		console.log(`Momentum v${packageFile.default.version}`);
 		let momentum;
 
 		// Login
 		do {
-			while(!url) url = await ask('URL: ');
-			while(!username) username = await ask('Username: ');
-			while(!password) password = await ask('Password: ', true);
+			while (!url) url = await ask('URL: ');
+			while (!username) username = await ask('Username: ');
+			while (!password) password = await ask('Password: ', true);
 
-			if(!url.startsWith('http')) url = 'http://' + url;
+			if (!url.startsWith('http')) url = 'http://' + url;
 			momentum = new Momentum(url);
 			await momentum.auth.login(username, password)
 				.catch(err => {
 					url = username = password = '';
 					console.log('Failed to authenticate');
 				});
-		} while(!momentum?.auth.user);
+		} while (!momentum?.auth.user);
 		console.log('Login Succeeded!\n');
 
-		if(!destination) destination = await ask('Destination (src/models): ');
-		if(!destination) destination = 'src/models';
+		if (!destination) destination = await ask('Destination (src/models): ');
+		if (!destination) destination = 'src/models';
 		let path = join(process.cwd(), destination);
-		if(!fs.existsSync(path)) fs.mkdirSync(path);
+		if (!fs.existsSync(path)) fs.mkdirSync(path);
 
 		console.log('\nCollecting Schemas...');
-		const schemas = await momentum.data.schema.read();
+		const schemas = await momentum.schemas.read();
 		schemas.forEach(schema => {
-			const fileName = camelCase(schema.path) + '.ts';
+			const fileName = kebabCase(schema.path) + '.ts';
 			console.log(`Creating Model: ${schema.path} -> ${fileName}`);
 			const path = join(process.cwd(), destination, fileName);
-			fs.writeFileSync(path, `import {Meta} from '@ztimson/momentum';
+			fs.writeFileSync(path, `import {Formula, Link, Meta} from '@ztimson/momentum';
 
 /**
- * ${schema.path}
- *
- * ${schema.description}
- *
- * Generated by Momentum v${packageFile.default.version} - ${formatDate('YYYY-MM-DD')}
+ * Generated by Momentum v${packageFile.default.version}
+ * Date: ${formatDate('YYYY-MM-DD')}
+ * Schema: ${schema.path}
+ * Description: ${schema.description}
  */
-export interface ${camelCase(schema.path)} extends Meta${schema.columns.length ? '' : ', Record<string, any>'} {
-${schema.columns.map(column => `\t${createProp(column)};`).join('\n')}
+export interface ${pascalCase(schema.path)} extends Meta${schema.columns.length ? '' : ', Record<string, any>'} {
+${schema.columns.map(column => `\t${column.readonly ? 'readonly ' : ''}${column.prop}${column.required ? ':' : '?:'} ${column.type};`).join('\n')}
 }
 `);
 		});
 		console.log('Done!');
 		process.exit();
-	} catch(err) {
+	} catch (err) {
 		console.error(`\n${err.stack || err.stackTrace || err.message || err.toString()}`);
 		process.exit(1);
 	}

package/dist/actions.d.ts

@@ -1,63 +1,97 @@
-import { Api } from './api';
-import { Cache, HttpRequestOptions, PathEventEmitter } from '@ztimson/utils';
+import { HttpRequestOptions } from '@ztimson/utils';
+import { AssetController } from './asset-controller';
 import { Meta } from './core';
+import { Momentum } from './momentum';
+export type ToolArgs = {
+    [key: string]: {
+        /** Argument type */
+        type: 'array' | 'boolean' | 'number' | 'object' | 'string';
+        /** Argument description */
+        description: string;
+        /** Required argument */
+        required?: boolean;
+        /** Default value */
+        default?: any;
+        /** Options */
+        enum?: string[];
+        /** Minimum value or length */
+        min?: number;
+        /** Maximum value or length */
+        max?: number;
+        /** Match pattern */
+        pattern?: string;
+        /** Child arguments */
+        items?: {
+            [key: string]: ToolArgs;
+        };
+    };
+};
 /** Action model */
 export type Action = Meta & {
     /** Action name */
     name: string;
-    /** Trigger with CRON, CRUD or Event */
+    /** Disable action */
+    disabled?: boolean;
+    /** Trigger with AI call, CRON, CRUD or Event */
     trigger: {
         type: ActionType;
-        value: string;
+        value: string | ToolArgs;
     };
     /** Run as system or with triggering user permissions */
-    system?: boolean;
+    system?: boolean | null;
     /** Action code */
     fn: string;
     /** User nodes */
-    notes?: string;
+    notes?: string | null;
     /** Last execution timestamp */
-    lastRun?: Date;
+    readonly lastRun?: null | Date;
     /** Last execution duration */
-    lastRunLength?: number;
+    readonly lastRunDuration?: number | null;
     /** Next scheduled run time (CRON only) */
-    nextRun?: Date;
+    readonly nextRun?: null | Date;
     /** Last execution results */
-    response?: ActionResult;
+    readonly response?: ActionResult | null;
 };
 /** Action execution result */
 export type ActionResult = {
     /** ID of associated action */
-    action: string;
+    readonly action: string;
+    /** Runtime */
+    readonly duration: number;
+    /** Start timestamp */
+    readonly start: Date;
     /** Console output */
-    stdout: any[];
+    readonly stdout: any[];
     /** Console errors */
-    stderr: any[];
+    readonly stderr: any[];
     /** HTTP Response */
-    response?: any;
+    readonly response?: any;
     /** Action return value */
-    return?: any;
+    readonly return?: any;
 };
+/** Action triggers - Ordered to optimize filtering */
 export declare enum ActionType {
-    'CRON' = 0,
-    'EVENT' = 1,
-    'DELETE' = 2,
-    'GET' = 3,
-    'PATCH' = 4,
-    'POST' = 5,
-    'PUT' = 6
+    /** HTTP DELETE request */
+    'DELETE' = 0,
+    /** HTTP POST request */
+    'POST' = 1,
+    /** HTTP PATCH request */
+    'PATCH' = 2,
+    /** HTTP PUT request */
+    'PUT' = 3,
+    /** HTTP GET request */
+    'GET' = 4,
+    /** Internal Event */
+    'EVENT' = 6,
+    /** CRON Job */
+    'CRON' = 5,
+    /** AI tool call */
+    'AI' = 7
 }
-/** Execute custom Javascript on trigger event */
-export declare class Actions extends PathEventEmitter {
-    private readonly api;
-    cache: Cache<string, Action>;
-    constructor(api: Api | string);
-    /**
-     * All saved actions
-     * @param {boolean} reload Will use cached response if false
-     * @return {Promise<Action[]>} List of saved actions
-     */
-    all(reload?: boolean): Promise<Action[]>;
+/** Run cloud functions & custom code */
+export declare class Actions extends AssetController<Action> {
+    protected momentum: Momentum;
+    constructor(momentum: Momentum);
     /**
      * Manually trigger an actions execution
      * @param {string} id Action ID
@@ -65,19 +99,6 @@ export declare class Actions extends PathEventEmitter {
      * @return {Promise<ActionResult>} All action output including console logs & return
      */
     debug(id: string, opts?: HttpRequestOptions): Promise<ActionResult>;
-    /**
-     * Delete an existing action
-     * @param {string} id Action ID
-     * @return {Promise<void>} Delete complete
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Fetch action info
-     * @param {string} id Action ID
-     * @param {boolean} reload Will use cached response if false
-     * @return {Promise<Action | null>} Requested action
-     */
-    read(id: string, reload?: boolean): Promise<Action | null>;
     /**
      * Run an HTTP action
      * @param {string} path HTTP path excluding `/api/actions/run`
@@ -85,11 +106,5 @@ export declare class Actions extends PathEventEmitter {
      * @return {Promise<T>} HTTP response
      */
     run<T>(path: string, opts?: HttpRequestOptions): Promise<T>;
-    /**
-     * Update an action
-     * @param {Action} action The new action
-     * @return {Promise<Action>} Saved action
-     */
-    update(action: Action): Promise<Action>;
 }
 //# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAC,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAM,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAC,IAAI,EAAC,MAAM,QAAQ,CAAC;AAE5B,mBAAmB;AACnB,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG;IAC3B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE;QAAC,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC;IAC3C,wDAAwD;IACxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,YAAY,CAAA;CACvB,CAAA;AAED,8BAA8B;AAC9B,MAAM,MAAM,YAAY,GAAG;IAC1B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,GAAG,EAAE,CAAC;IACd,oBAAoB;IACpB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,GAAG,CAAC;CACb,CAAA;AAED,oBAAY,UAAU;IACrB,MAAM,IAAA;IACN,OAAO,IAAA;IACP,QAAQ,IAAA;IACR,KAAK,IAAA;IACL,OAAO,IAAA;IACP,MAAM,IAAA;IACN,KAAK,IAAA;CACL;AAED,iDAAiD;AACjD,qBAAa,OAAQ,SAAQ,gBAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAO;IAE3B,KAAK,wBAAoC;gBAE7B,GAAG,EAAE,GAAG,GAAG,MAAM;IAK7B;;;;OAIG;IACG,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS9C;;;;;OAKG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC;IAIvE;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW1D;;;;;OAKG;IACH,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/D;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAWvC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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"}

package/dist/ai.d.ts

@@ -1,36 +1,62 @@
-import { PathEventEmitter } from '@ztimson/utils';
-import { Api } from './api';
+import { PathEventEmitter } from './core';
+import { Momentum } from './momentum';
+export type AiInfo = {
+    /** Service provider: Anthropic, OpenAI, Ollama */
+    readonly host: string;
+    /** Assistant LLM version */
+    readonly model: string;
+    /** Available tools */
+    readonly tools: {
+        [name: string]: string;
+    };
+};
+export type AiMessage = {
+    /** Message type */
+    readonly role: 'assistant' | 'function' | 'system' | 'tool' | 'user';
+    /** OpenAI tool call */
+    readonly name?: string;
+    /** Anthropic tool call */
+    readonly tool_use_id?: string;
+    /** Ollama tool call */
+    readonly tool_call_id?: string;
+    /** Message value */
+    readonly content: string;
+};
 /** AI integrations */
 export declare class Ai extends PathEventEmitter {
-    private readonly api;
-    constructor(api: Api | string);
+    protected momentum: Momentum;
+    constructor(momentum: Momentum);
+    /** Cancel current AI requests */
+    abort(): Promise<void>;
     /**
      * Ask the AI assistant a question
      * @param {string} question Users question
-     * @param {any} context Additional data to aid response
+     * @param {context: string, stream: Function} options context - Any hidden context information. stream - Receive response in chunks
      * @return {Promise<string>} AI's response
      */
-    ask(question: string, context?: any): Promise<string>;
+    ask(question: string, options?: {
+        context?: any;
+        files?: File[];
+        stream?: (chunk: {
+            text?: string;
+            done?: boolean;
+            tool?: string;
+        }) => any;
+    }): Promise<string>;
     /**
      * Clear AI assistant memory & context
      * @return {Promise<void>} Resolves once complete
      */
-    clear(): import('@ztimson/utils').PromiseProgress<any>;
+    clear(): Promise<void>;
     /**
      * Current chat history
-     * @return {Promise<{role: string, content: string}[]>}
+     * @return {Promise<AiMessage[]>}
      */
-    history(): Promise<{
-        role: string;
-        content: string;
-    }[]>;
+    history(): Promise<AiMessage[]>;
     /**
      * Get model info
-     * @return {Promise<{host: string, model: string}>} Model Info
+     * @return {AiInfo>} Model Info
      */
-    info(): Promise<{
-        host: string;
-        model: string;
-    }>;
+    info(): Promise<AiInfo>;
 }
 //# sourceMappingURL=ai.d.ts.map

package/dist/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAM,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAC,GAAG,EAAC,MAAM,OAAO,CAAC;AAE1B,sBAAsB;AACtB,qBAAa,EAAG,SAAQ,gBAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAO;gBAEf,GAAG,EAAE,GAAG,GAAG,MAAM;IAK7B;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAWrD;;;OAGG;IACH,KAAK;IAKL;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,EAAE,CAAC;IAOrD;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC;CAG9C"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../src/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAM,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEpC,MAAM,MAAM,MAAM,GAAG;IACpB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE;QAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;KAAC,CAAA;CACxC,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACvB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACrE,uBAAuB;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CACzB,CAAA;AAED,sBAAsB;AACtB,qBAAa,EAAG,SAAQ,gBAAgB;IAC3B,SAAS,CAAC,QAAQ,EAAE,QAAQ;gBAAlB,QAAQ,EAAE,QAAQ;IAIxC,iCAAiC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB;;;;;OAKG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;QAAC,OAAO,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAC,KAAK,GAAG,CAAA;KAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BpK;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAO/B;;;OAGG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAGvB"}