@kodelyth/zalouser 2026.5.42 → 2026.6.1

package/klaw.plugin.json

@@ -3,16 +3,299 @@
   "activation": {
     "onStartup": false
   },
-  "channels": ["zalouser"],
+  "channels": [
+    "zalouser"
+  ],
   "contracts": {
-    "tools": ["zalouser"]
+    "tools": [
+      "zalouser"
+    ]
   },
   "channelEnvVars": {
-    "zalouser": ["ZALOUSER_PROFILE", "ZCA_PROFILE"]
+    "zalouser": [
+      "ZALOUSER_PROFILE",
+      "ZCA_PROFILE"
+    ]
   },
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {}
+  },
+  "channelConfigs": {
+    "zalouser": {
+      "schema": {
+        "$schema": "http://json-schema.org/draft-07/schema#",
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "enabled": {
+            "type": "boolean"
+          },
+          "markdown": {
+            "type": "object",
+            "properties": {
+              "tables": {
+                "type": "string",
+                "enum": [
+                  "off",
+                  "bullets",
+                  "code",
+                  "block"
+                ]
+              }
+            },
+            "additionalProperties": false
+          },
+          "profile": {
+            "type": "string"
+          },
+          "dangerouslyAllowNameMatching": {
+            "type": "boolean"
+          },
+          "dmPolicy": {
+            "type": "string",
+            "enum": [
+              "pairing",
+              "allowlist",
+              "open",
+              "disabled"
+            ]
+          },
+          "allowFrom": {
+            "type": "array",
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "historyLimit": {
+            "type": "integer",
+            "minimum": 0,
+            "maximum": 9007199254740991
+          },
+          "groupAllowFrom": {
+            "type": "array",
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "number"
+                }
+              ]
+            }
+          },
+          "groupPolicy": {
+            "default": "allowlist",
+            "type": "string",
+            "enum": [
+              "open",
+              "disabled",
+              "allowlist"
+            ]
+          },
+          "groups": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "enabled": {
+                  "type": "boolean"
+                },
+                "requireMention": {
+                  "type": "boolean"
+                },
+                "tools": {
+                  "type": "object",
+                  "properties": {
+                    "allow": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "alsoAllow": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    },
+                    "deny": {
+                      "type": "array",
+                      "items": {
+                        "type": "string"
+                      }
+                    }
+                  },
+                  "additionalProperties": false
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "messagePrefix": {
+            "type": "string"
+          },
+          "responsePrefix": {
+            "type": "string"
+          },
+          "accounts": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": {
+              "type": "object",
+              "properties": {
+                "name": {
+                  "type": "string"
+                },
+                "enabled": {
+                  "type": "boolean"
+                },
+                "markdown": {
+                  "type": "object",
+                  "properties": {
+                    "tables": {
+                      "type": "string",
+                      "enum": [
+                        "off",
+                        "bullets",
+                        "code",
+                        "block"
+                      ]
+                    }
+                  },
+                  "additionalProperties": false
+                },
+                "profile": {
+                  "type": "string"
+                },
+                "dangerouslyAllowNameMatching": {
+                  "type": "boolean"
+                },
+                "dmPolicy": {
+                  "type": "string",
+                  "enum": [
+                    "pairing",
+                    "allowlist",
+                    "open",
+                    "disabled"
+                  ]
+                },
+                "allowFrom": {
+                  "type": "array",
+                  "items": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  }
+                },
+                "historyLimit": {
+                  "type": "integer",
+                  "minimum": 0,
+                  "maximum": 9007199254740991
+                },
+                "groupAllowFrom": {
+                  "type": "array",
+                  "items": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  }
+                },
+                "groupPolicy": {
+                  "default": "allowlist",
+                  "type": "string",
+                  "enum": [
+                    "open",
+                    "disabled",
+                    "allowlist"
+                  ]
+                },
+                "groups": {
+                  "type": "object",
+                  "properties": {},
+                  "additionalProperties": {
+                    "type": "object",
+                    "properties": {
+                      "enabled": {
+                        "type": "boolean"
+                      },
+                      "requireMention": {
+                        "type": "boolean"
+                      },
+                      "tools": {
+                        "type": "object",
+                        "properties": {
+                          "allow": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "alsoAllow": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          },
+                          "deny": {
+                            "type": "array",
+                            "items": {
+                              "type": "string"
+                            }
+                          }
+                        },
+                        "additionalProperties": false
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                },
+                "messagePrefix": {
+                  "type": "string"
+                },
+                "responsePrefix": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "groupPolicy"
+              ],
+              "additionalProperties": false
+            }
+          },
+          "defaultAccount": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "groupPolicy"
+        ],
+        "additionalProperties": false
+      },
+      "label": "Zalo Personal",
+      "description": "Zalo personal account via QR code login."
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodelyth/zalouser",
-  "version": "2026.5.42",
+  "version": "2026.6.1",
   "description": "Klaw Zalo Personal Account plugin via native zca-js integration",
   "repository": {
     "type": "git",
@@ -17,11 +17,15 @@
     "@kodelyth/klaw": "2026.5.42"
   },
   "peerDependencies": {
-    "@kodelyth/klaw": ">=2026.5.19"
+    "@kodelyth/klaw": ">=2026.5.19",
+    "klaw": ">=2026.5.39"
   },
   "peerDependenciesMeta": {
     "@kodelyth/klaw": {
       "optional": true
+    },
+    "klaw": {
+      "optional": true
     }
   },
   "klaw": {
@@ -62,6 +66,15 @@
     "release": {
       "publishToClawHub": true,
       "publishToNpm": true
-    }
-  }
+    },
+    "runtimeExtensions": [
+      "./dist/index.js"
+    ],
+    "runtimeSetupEntry": "./dist/setup-entry.js"
+  },
+  "files": [
+    "dist/**",
+    "klaw.plugin.json",
+    "README.md"
+  ]
 }

package/api.ts

@@ -1,9 +0,0 @@
-export { zalouserPlugin } from "./src/channel.js";
-export { zalouserSetupPlugin } from "./src/channel.setup.js";
-export { createZalouserTool } from "./src/tool.js";
-export { createZalouserSetupWizardProxy, zalouserSetupAdapter } from "./src/setup-core.js";
-export { zalouserSetupWizard } from "./src/setup-surface.js";
-export {
-  collectZalouserSecurityAuditFindings,
-  isZalouserMutableGroupEntry,
-} from "./src/security-audit.js";

package/channel-plugin-api.ts

@@ -1,3 +0,0 @@
-// Keep bundled channel entry imports narrow so bootstrap/discovery paths do
-// not drag setup-only or tool runtime surfaces into lightweight plugin loads.
-export { zalouserPlugin } from "./src/channel.js";

package/contract-api.ts

@@ -1,2 +0,0 @@
-export { collectZalouserSecurityAuditFindings } from "./src/security-audit.js";
-export { legacyConfigRules, normalizeCompatibilityConfig } from "./src/doctor-contract.js";

package/doctor-contract-api.ts

@@ -1 +0,0 @@
-export { normalizeCompatibilityConfig, legacyConfigRules } from "./src/doctor-contract.js";

package/index.ts

@@ -1,34 +0,0 @@
-import {
-  type AnyAgentTool,
-  defineBundledChannelEntry,
-  loadBundledEntryExportSync,
-} from "klaw/plugin-sdk/channel-entry-contract";
-
-function createZalouserTool(context?: unknown): AnyAgentTool {
-  const createTool = loadBundledEntryExportSync<(context?: unknown) => AnyAgentTool>(
-    import.meta.url,
-    {
-      specifier: "./api.js",
-      exportName: "createZalouserTool",
-    },
-  );
-  return createTool(context);
-}
-
-export default defineBundledChannelEntry({
-  id: "zalouser",
-  name: "Zalo Personal",
-  description: "Zalo personal account messaging via native zca-js integration",
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: "./channel-plugin-api.js",
-    exportName: "zalouserPlugin",
-  },
-  runtime: {
-    specifier: "./runtime-api.js",
-    exportName: "setZalouserRuntime",
-  },
-  registerFull(api) {
-    api.registerTool((ctx) => createZalouserTool(ctx), { name: "zalouser" });
-  },
-});

package/runtime-api.ts

@@ -1,62 +0,0 @@
-export {
-  collectZalouserSecurityAuditFindings,
-  createZalouserSetupWizardProxy,
-  createZalouserTool,
-  isZalouserMutableGroupEntry,
-  zalouserPlugin,
-  zalouserSetupAdapter,
-  zalouserSetupPlugin,
-  zalouserSetupWizard,
-} from "./api.js";
-export { setZalouserRuntime } from "./src/runtime.js";
-export type { ReplyPayload } from "klaw/plugin-sdk/reply-runtime";
-export type {
-  BaseProbeResult,
-  ChannelAccountSnapshot,
-  ChannelDirectoryEntry,
-  ChannelGroupContext,
-  ChannelMessageActionAdapter,
-  ChannelStatusIssue,
-} from "klaw/plugin-sdk/channel-contract";
-export type {
-  KlawConfig,
-  GroupToolPolicyConfig,
-  MarkdownTableMode,
-} from "klaw/plugin-sdk/config-contracts";
-export type {
-  PluginRuntime,
-  AnyAgentTool,
-  ChannelPlugin,
-  KlawPluginToolContext,
-} from "klaw/plugin-sdk/core";
-export type { RuntimeEnv } from "klaw/plugin-sdk/runtime";
-export {
-  DEFAULT_ACCOUNT_ID,
-  buildChannelConfigSchema,
-  normalizeAccountId,
-} from "klaw/plugin-sdk/core";
-export { chunkTextForOutbound } from "klaw/plugin-sdk/text-chunking";
-export { isDangerousNameMatchingEnabled } from "klaw/plugin-sdk/dangerous-name-runtime";
-export {
-  resolveDefaultGroupPolicy,
-  resolveOpenProviderRuntimeGroupPolicy,
-  warnMissingProviderGroupPolicyFallbackOnce,
-} from "klaw/plugin-sdk/runtime-group-policy";
-export {
-  mergeAllowlist,
-  summarizeMapping,
-  formatAllowFromLowercase,
-} from "klaw/plugin-sdk/allow-from";
-export { resolveInboundMentionDecision } from "klaw/plugin-sdk/channel-inbound";
-export { createChannelPairingController } from "klaw/plugin-sdk/channel-pairing";
-export { createChannelMessageReplyPipeline } from "klaw/plugin-sdk/channel-message";
-export { buildBaseAccountStatusSnapshot } from "klaw/plugin-sdk/status-helpers";
-export { loadOutboundMediaFromUrl } from "klaw/plugin-sdk/outbound-media";
-export {
-  deliverTextOrMediaReply,
-  isNumericTargetId,
-  resolveSendableOutboundReplyParts,
-  sendPayloadWithChunkedTextAndMedia,
-  type OutboundReplyPayload,
-} from "klaw/plugin-sdk/reply-payload";
-export { resolvePreferredKlawTmpDir } from "klaw/plugin-sdk/temp-path";

package/secret-contract-api.ts

@@ -1,4 +0,0 @@
-// Zalo User does not expose secret-contract surfaces.
-export const secretTargetRegistryEntries: readonly [] = [];
-
-export function collectRuntimeConfigAssignments(): void {}

package/setup-entry.ts

@@ -1,9 +0,0 @@
-import { defineBundledChannelSetupEntry } from "klaw/plugin-sdk/channel-entry-contract";
-
-export default defineBundledChannelSetupEntry({
-  importMetaUrl: import.meta.url,
-  plugin: {
-    specifier: "./setup-plugin-api.js",
-    exportName: "zalouserSetupPlugin",
-  },
-});

package/setup-plugin-api.ts

@@ -1,2 +0,0 @@
-// Keep setup-entry imports narrow so setup loads do not pull tool surfaces.
-export { zalouserSetupPlugin } from "./src/channel.setup.js";

package/src/accounts.runtime.ts

@@ -1 +0,0 @@
-export { checkZaloAuthenticated, getZaloUserInfo } from "./zalo-js.js";

package/src/accounts.test-mocks.ts

@@ -1,14 +0,0 @@
-import { vi } from "vitest";
-import { createDefaultResolvedZalouserAccount } from "./test-helpers.js";
-
-vi.mock("./accounts.js", () => {
-  return {
-    listZalouserAccountIds: () => ["default"],
-    resolveDefaultZalouserAccountId: () => "default",
-    resolveZalouserAccountSync: () => createDefaultResolvedZalouserAccount(),
-    resolveZalouserAccount: async () => createDefaultResolvedZalouserAccount(),
-    listEnabledZalouserAccounts: async () => [createDefaultResolvedZalouserAccount()],
-    getZcaUserInfo: async () => null,
-    checkZcaAuthenticated: async () => false,
-  };
-});