@kodelyth/zalouser 2026.5.39 → 2026.5.42

package/doctor-contract-api.ts

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

package/index.ts

@@ -0,0 +1,34 @@
+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/klaw.plugin.json

@@ -3,299 +3,16 @@
   "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.39",
+  "version": "2026.5.42",
   "description": "Klaw Zalo Personal Account plugin via native zca-js integration",
   "repository": {
     "type": "git",
@@ -14,7 +14,7 @@
   },
   "devDependencies": {
     "@kodelyth/plugin-sdk": "1.0.1",
-    "@kodelyth/klaw": "2026.5.41"
+    "@kodelyth/klaw": "2026.5.42"
   },
   "peerDependencies": {
     "@kodelyth/klaw": ">=2026.5.19"
@@ -26,9 +26,9 @@
   },
   "klaw": {
     "extensions": [
-      "./index.js"
+      "./index.ts"
     ],
-    "setupEntry": "./setup-entry.js",
+    "setupEntry": "./setup-entry.ts",
     "channel": {
       "id": "zalouser",
       "label": "Zalo Personal",

package/runtime-api.ts

@@ -0,0 +1,62 @@
+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

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

package/setup-entry.ts

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,2 @@
+// 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

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

package/src/accounts.test-mocks.ts

@@ -0,0 +1,14 @@
+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,
+  };
+});