@minded-ai/mindedjs 1.0.0-ec2-beta-1

package/docs/tooling/timers.md

@@ -0,0 +1,61 @@
+# Timers
+
+Timers allow you to schedule delayed actions and handle time-based events in your MindedJS agents.
+
+## Overview
+
+The timer system provides three main functions:
+- `resetTimer` - Set or reset a timer for a specific session
+- `cancelTimer` - Cancel an existing timer
+- `onTimer` - Register handlers for timer events
+
+## Setting Timers
+
+Use `resetTimer` to create or update a timer:
+
+```typescript
+import { resetTimer } from '@minded-ai/mindedjs';
+
+await resetTimer({
+  sessionId: 'session-123',
+  seconds: 30,
+  timerName: 'inactivity-followup',
+  payload: {
+    message: 'Are you still there?',
+    attemptNumber: 1
+  }
+});
+```
+
+## Canceling Timers
+
+Cancel a timer before it triggers:
+
+```typescript
+import { cancelTimer } from '@minded-ai/mindedjs';
+
+await cancelTimer('session-123', 'inactivity-followup');
+```
+
+## Handling Timer Events
+
+Register handlers that execute when timers trigger:
+
+```typescript
+import { onTimer } from '@minded-ai/mindedjs';
+
+onTimer({
+  timerName: 'inactivity-followup',
+  handler: async ({ sessionId, payload }) => {
+    // Re-engage with the user
+    await agent.invoke({
+      triggerName: 'timerFollowup',
+      triggerBody: { 
+        message: payload.message,
+        attemptNumber: payload.attemptNumber 
+      },
+      sessionId
+    });
+  }
+});
+```

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@minded-ai/mindedjs",
+  "version": "1.0.0-ec2-beta-1",
+  "description": "MindedJS is a TypeScript library for building agents.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "minded": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "docs"
+  ],
+  "scripts": {
+    "build": "tsc && npm run copy-templates && rsync -a --include='*/' --include='*.py' --exclude='*' src/ dist/",
+    "copy-templates": "cp -r src/cli/lambdaHandlerTemplate.ts dist/cli/",
+    "watch": "tsc -w",
+    "test": "NODE_ENV=test mocha --parallel --jobs auto --retries 1 -r ts-node/register -r ./test/setup.ts \"test/**/*.test.ts\"",
+    "testFile": "NODE_ENV=test mocha -r ts-node/register -r ./test/setup.ts",
+    "order-refund": "cd examples/orderRefundAgent && nodemon --watch '**/*.ts' --exec 'ts-node' orderRefundAgent.ts",
+    "zendesk": "cd examples/zendesk && nodemon --watch '**/*.ts' --exec 'ts-node' zendeskAgent.ts",
+    "example-voice": "cd examples/voice && nodemon --watch '**/*.ts' --exec 'ts-node' voiceAgent.ts",
+    "example-browser": "cd examples/browserUsingAgent && nodemon --watch '**/*.ts' --exec 'ts-node' browserUsingAgent.ts",
+    "lint": "eslint .",
+    "lintFix": "eslint --fix .",
+    "generateApiDocs": "typedoc"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@editorjs/editorjs": "^2.30.8",
+    "@eslint/js": "^9.27.0",
+    "@types/aws-lambda": "^8.10.150",
+    "@types/chai": "^4.3.11",
+    "@types/ejs": "^3.1.5",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^20.11.19",
+    "@types/sinon": "^17.0.4",
+    "@types/ws": "^8.18.1",
+    "chai": "^4.3.10",
+    "dotenv": "^16.4.5",
+    "eslint": "^9.27.0",
+    "globals": "^16.2.0",
+    "mocha": "^10.3.0",
+    "nodemon": "^3.1.10",
+    "sinon": "^20.0.0",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.28.5",
+    "typescript": "^5.3.3",
+    "typescript-eslint": "^8.32.1"
+  },
+  "dependencies": {
+    "@langchain/core": "^0.3.55",
+    "@langchain/langgraph": "^0.2.72",
+    "@types/js-yaml": "^4.0.9",
+    "axios": "^1.9.0",
+    "ejs": "^3.1.10",
+    "flatted": "^3.3.3",
+    "js-yaml": "^4.1.0",
+    "langchain": "^0.3.25",
+    "pino": "^9.7.0",
+    "pino-pretty": "^13.0.0",
+    "socket.io-client": "^4.8.1",
+    "uuid": "^11.1.0",
+    "ws": "^8.15.1",
+    "zod": "^3.25.74",
+    "zod-to-json-schema": "^3.24.6"
+  },
+  "peerDependencies": {
+    "playwright": "^1.55.0"
+  }
+}