mm_action 1.0.0 → 1.0.1

package/index.js

@@ -1,18 +1,16 @@
-'use strict';
-
-/**
- * Action —— 动作管理模块。
- *
- * 骨架已就绪：构造时接收配置对象，具体功能待开发。
- */
-class Action {
-  /**
-   * 构造函数
-   * @param {Object} [config] 模块配置
-   */
-  constructor(config = {}) {
-    this.config = config;
-  }
-}
-
-module.exports = Action;
+const Action = require('./lib/action');
+const Admin = require('mm_corejs').Admin;
+
+const admin = new Admin();
+admin.setClass(Action);
+
+module.exports = {
+  Action,
+  admin,
+  actionAdmin(scope, config = {}) {
+    if (!scope) {
+      scope = 'os';
+    }
+    return admin.get(scope, config);
+  }
+};

package/lib/action.js

@@ -0,0 +1,18 @@
+'use strict';
+
+/**
+ * Action —— 动作管理模块。
+ *
+ * 骨架已就绪：构造时接收配置对象，具体功能待开发。
+ */
+class Action {
+  /**
+   * 构造函数
+   * @param {Object} [config] 模块配置
+   */
+  constructor(config = {}) {
+    this.config = config;
+  }
+}
+
+module.exports = Action;

package/lib/define_action.js

@@ -0,0 +1,27 @@
+'use strict';
+
+/**
+ * 动作定义：纯契约，不持有状态。
+ * run(param, ctx) => intent | intent[] | undefined
+ */
+function defineAction(def) {
+  if (!def || typeof def !== 'object') {
+    throw new TypeError('defineAction expects an object');
+  }
+  if (!def.name || typeof def.name !== 'string') {
+    throw new TypeError('action.name must be a non-empty string');
+  }
+  if (typeof def.run !== 'function') {
+    throw new TypeError('action.execute must be a function');
+  }
+  return {
+    name: def.name,
+    description: def.description || '',
+    // 与 LLM tool 定义对齐的字段，方便后续转换
+    paramSchema: def.paramSchema || null,
+    validate: def.validate || (() => {}),
+    run: def.run, 
+  };
+}
+
+module.exports = { defineAction };

package/lib/dispatcher.js

@@ -0,0 +1,80 @@
+'use strict';
+
+const EFFECT_INTENT = '@effect';
+
+function assertInterface(obj, methods, label) {
+  if (!obj || typeof obj !== 'object') {
+    throw new TypeError(`${label} must be an object`);
+  }
+  for (const m of methods) {
+    if (typeof obj[m] !== 'function') {
+      throw new TypeError(`${label} must implement ${m}()`);
+    }
+  }
+}
+
+/**
+ * 鸭子类型注入：只要求 store.apply 和 effects.run，不 import 具体类。
+ * 因此本包 dependencies 为空，用户可换成任何兼容实现（Redux、自研等）。
+ */
+class Dispatcher {
+  constructor({ store, effects, maxDepth = 8 } = {}) {
+    assertInterface(store, ['apply'], 'store');
+    assertInterface(effects, ['run'], 'effects');
+    this.store = store;
+    this.effects = effects;
+    this.maxDepth = maxDepth;
+    this.actions = new Map();
+  }
+
+  register(action) {
+    if (!action || !action.name) {
+      throw new TypeError('action must have a name');
+    }
+    if (typeof action.execute !== 'function') {
+      throw new TypeError('action.execute must be a function');
+    }
+    if (this.actions.has(action.name)) {
+      throw new Error(`action already registered: ${action.name}`);
+    }
+    this.actions.set(action.name, action);
+    return this;
+  }
+
+  /**
+   * 意图分两类：
+   *   { type: 'xxx', payload }                         → store.apply
+   *   { type: '@effect', name, args, then }            → effects.run，结果回流到 then 动作
+   */
+  async dispatch(name, input, ctx = {}, depth = 0) {
+    if (depth > this.maxDepth) {
+      throw new Error(`dispatch depth exceeded: ${name}`);
+    }
+    const action = this.actions.get(name);
+    if (!action) throw new Error(`unknown action: ${name}`);
+
+    action.validate(input);
+
+    let intents = await action.execute(input, ctx);
+    if (intents == null) return;
+    if (!Array.isArray(intents)) intents = [intents];
+
+    for (const intent of intents) {
+      if (!intent || typeof intent.type !== 'string') {
+        throw new TypeError('intent must have a string type');
+      }
+
+      if (intent.type === EFFECT_INTENT) {
+        if (!intent.name) throw new Error('effect intent requires name');
+        const observation = await this.effects.run(intent.name, intent.args, ctx);
+        if (intent.then) {
+          await this.dispatch(intent.then, { observation }, ctx, depth + 1);
+        }
+      } else {
+        this.store.apply(intent);
+      }
+    }
+  }
+}
+
+module.exports = { Dispatcher, EFFECT_INTENT, assertInterface };

package/package.json

@@ -1,26 +1,29 @@
 {
-  "name": "mm_action",
-  "version": "1.0.0",
-  "description": "动作管理模块：提供动作的注册与管理能力",
-  "main": "index.js",
-  "repository": {
-    "type": "git",
-    "url": "git+https://gitee.com/qiuwenwu91/mm_action.git"
-  },
-  "keywords": [
-    "mm_mod",
-    "mm_infra",
-    "action",
-    "动作"
-  ],
-  "layer": "infra",
-  "group": "common",
-  "author": "邱文武",
-  "license": "ISC",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "scripts": {
-    "test": "node test.js"
-  }
-}
+    "name": "mm_action",
+    "version": "1.0.1",
+    "description": "动作管理模块：提供动作的注册与管理能力",
+    "main": "index.js",
+    "repository": {
+        "type": "git",
+        "url": "git+https://gitee.com/qiuwenwu91/mm_action.git"
+    },
+    "keywords": [
+        "mm_mod",
+        "mm_infra",
+        "action",
+        "动作"
+    ],
+    "layer": "infra",
+    "group": "common",
+    "author": "邱文武",
+    "license": "ISC",
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "scripts": {
+        "test": "node test.js"
+    },
+    "dependencies": {
+        "mm_corejs": "^1.1.6"
+    }
+}

package/test.js

@@ -1,10 +1,26 @@
 'use strict';
 
 const assert = require('assert');
-const Action = require('./index.js');
+const mod = require('./index.js');
 
+// 1. 导出结构校验
+assert.strictEqual(typeof mod.Action, 'function', '应导出 Action 类');
+assert.ok(mod.admin, '应导出 admin 实例');
+assert.strictEqual(typeof mod.actionAdmin, 'function', '应导出 actionAdmin 函数');
+
+const { Action } = mod;
+
+// 2. 实例化与默认配置
 const instance = new Action();
 assert.ok(instance instanceof Action, 'instance 应为 Action 实例');
 assert.deepStrictEqual(instance.config, {}, '默认配置应为空对象');
 
-console.log('mm_action test passed');
+// 3. 传入配置
+const configured = new Action({ type: 'click' });
+assert.deepStrictEqual(configured.config, { type: 'click' }, '应保存传入的配置');
+
+// 4. 工厂函数返回 Action 实例
+const scoped = mod.actionAdmin('test');
+assert.ok(scoped instanceof Action, 'actionAdmin 应返回 Action 实例');
+
+console.log('mm_action test passed');