@larksuite/openclaw-lark 2026.3.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +10 -0
- package/README.md +283 -0
- package/index.d.ts +37 -0
- package/index.d.ts.map +1 -0
- package/index.js +119 -0
- package/index.js.map +1 -0
- package/openclaw.plugin.json +10 -0
- package/package.json +47 -0
- package/skills/feishu-bitable/SKILL.md +248 -0
- package/skills/feishu-bitable/references/examples.md +813 -0
- package/skills/feishu-bitable/references/field-properties.md +763 -0
- package/skills/feishu-bitable/references/record-values.md +911 -0
- package/skills/feishu-calendar/SKILL.md +244 -0
- package/skills/feishu-channel-rules/SKILL.md +18 -0
- package/skills/feishu-channel-rules/references/markdown-syntax.md +138 -0
- package/skills/feishu-create-doc/SKILL.md +719 -0
- package/skills/feishu-fetch-doc/SKILL.md +93 -0
- package/skills/feishu-im-read/SKILL.md +163 -0
- package/skills/feishu-task/SKILL.md +293 -0
- package/skills/feishu-troubleshoot/SKILL.md +70 -0
- package/skills/feishu-update-doc/SKILL.md +285 -0
- package/src/card/builder.d.ts +100 -0
- package/src/card/builder.d.ts.map +1 -0
- package/src/card/builder.js +381 -0
- package/src/card/builder.js.map +1 -0
- package/src/card/cardkit.d.ts +91 -0
- package/src/card/cardkit.d.ts.map +1 -0
- package/src/card/cardkit.js +182 -0
- package/src/card/cardkit.js.map +1 -0
- package/src/card/flush-controller.d.ts +46 -0
- package/src/card/flush-controller.d.ts.map +1 -0
- package/src/card/flush-controller.js +135 -0
- package/src/card/flush-controller.js.map +1 -0
- package/src/card/markdown-style.d.ts +17 -0
- package/src/card/markdown-style.d.ts.map +1 -0
- package/src/card/markdown-style.js +98 -0
- package/src/card/markdown-style.js.map +1 -0
- package/src/card/reply-dispatcher-types.d.ts +121 -0
- package/src/card/reply-dispatcher-types.d.ts.map +1 -0
- package/src/card/reply-dispatcher-types.js +58 -0
- package/src/card/reply-dispatcher-types.js.map +1 -0
- package/src/card/reply-dispatcher.d.ts +16 -0
- package/src/card/reply-dispatcher.d.ts.map +1 -0
- package/src/card/reply-dispatcher.js +293 -0
- package/src/card/reply-dispatcher.js.map +1 -0
- package/src/card/reply-mode.d.ts +39 -0
- package/src/card/reply-mode.d.ts.map +1 -0
- package/src/card/reply-mode.js +66 -0
- package/src/card/reply-mode.js.map +1 -0
- package/src/card/streaming-card-controller.d.ts +88 -0
- package/src/card/streaming-card-controller.d.ts.map +1 -0
- package/src/card/streaming-card-controller.js +717 -0
- package/src/card/streaming-card-controller.js.map +1 -0
- package/src/card/unavailable-guard.d.ts +36 -0
- package/src/card/unavailable-guard.d.ts.map +1 -0
- package/src/card/unavailable-guard.js +84 -0
- package/src/card/unavailable-guard.js.map +1 -0
- package/src/channel/abort-detect.d.ts +35 -0
- package/src/channel/abort-detect.d.ts.map +1 -0
- package/src/channel/abort-detect.js +125 -0
- package/src/channel/abort-detect.js.map +1 -0
- package/src/channel/chat-queue.d.ts +42 -0
- package/src/channel/chat-queue.d.ts.map +1 -0
- package/src/channel/chat-queue.js +59 -0
- package/src/channel/chat-queue.js.map +1 -0
- package/src/channel/config-adapter.d.ts +24 -0
- package/src/channel/config-adapter.d.ts.map +1 -0
- package/src/channel/config-adapter.js +102 -0
- package/src/channel/config-adapter.js.map +1 -0
- package/src/channel/directory.d.ts +58 -0
- package/src/channel/directory.d.ts.map +1 -0
- package/src/channel/directory.js +192 -0
- package/src/channel/directory.js.map +1 -0
- package/src/channel/event-handlers.d.ts +16 -0
- package/src/channel/event-handlers.d.ts.map +1 -0
- package/src/channel/event-handlers.js +222 -0
- package/src/channel/event-handlers.js.map +1 -0
- package/src/channel/monitor.d.ts +18 -0
- package/src/channel/monitor.d.ts.map +1 -0
- package/src/channel/monitor.js +128 -0
- package/src/channel/monitor.js.map +1 -0
- package/src/channel/onboarding-config.d.ts +18 -0
- package/src/channel/onboarding-config.d.ts.map +1 -0
- package/src/channel/onboarding-config.js +89 -0
- package/src/channel/onboarding-config.js.map +1 -0
- package/src/channel/onboarding-migrate.d.ts +26 -0
- package/src/channel/onboarding-migrate.d.ts.map +1 -0
- package/src/channel/onboarding-migrate.js +68 -0
- package/src/channel/onboarding-migrate.js.map +1 -0
- package/src/channel/onboarding.d.ts +13 -0
- package/src/channel/onboarding.d.ts.map +1 -0
- package/src/channel/onboarding.js +297 -0
- package/src/channel/onboarding.js.map +1 -0
- package/src/channel/plugin.d.ts +14 -0
- package/src/channel/plugin.d.ts.map +1 -0
- package/src/channel/plugin.js +279 -0
- package/src/channel/plugin.js.map +1 -0
- package/src/channel/probe.d.ts +15 -0
- package/src/channel/probe.d.ts.map +1 -0
- package/src/channel/probe.js +22 -0
- package/src/channel/probe.js.map +1 -0
- package/src/channel/types.d.ts +37 -0
- package/src/channel/types.d.ts.map +1 -0
- package/src/channel/types.js +8 -0
- package/src/channel/types.js.map +1 -0
- package/src/commands/auth.d.ts +16 -0
- package/src/commands/auth.d.ts.map +1 -0
- package/src/commands/auth.js +85 -0
- package/src/commands/auth.js.map +1 -0
- package/src/commands/diagnose.d.ts +70 -0
- package/src/commands/diagnose.d.ts.map +1 -0
- package/src/commands/diagnose.js +808 -0
- package/src/commands/diagnose.js.map +1 -0
- package/src/commands/doctor.d.ts +18 -0
- package/src/commands/doctor.d.ts.map +1 -0
- package/src/commands/doctor.js +439 -0
- package/src/commands/doctor.js.map +1 -0
- package/src/commands/index.d.ts +9 -0
- package/src/commands/index.d.ts.map +1 -0
- package/src/commands/index.js +208 -0
- package/src/commands/index.js.map +1 -0
- package/src/core/accounts.d.ts +38 -0
- package/src/core/accounts.d.ts.map +1 -0
- package/src/core/accounts.js +179 -0
- package/src/core/accounts.js.map +1 -0
- package/src/core/agent-config.d.ts +101 -0
- package/src/core/agent-config.d.ts.map +1 -0
- package/src/core/agent-config.js +140 -0
- package/src/core/agent-config.js.map +1 -0
- package/src/core/api-error.d.ts +49 -0
- package/src/core/api-error.d.ts.map +1 -0
- package/src/core/api-error.js +113 -0
- package/src/core/api-error.js.map +1 -0
- package/src/core/app-owner-fallback.d.ts +22 -0
- package/src/core/app-owner-fallback.d.ts.map +1 -0
- package/src/core/app-owner-fallback.js +39 -0
- package/src/core/app-owner-fallback.js.map +1 -0
- package/src/core/app-scope-checker.d.ts +88 -0
- package/src/core/app-scope-checker.d.ts.map +1 -0
- package/src/core/app-scope-checker.js +191 -0
- package/src/core/app-scope-checker.js.map +1 -0
- package/src/core/auth-errors.d.ts +143 -0
- package/src/core/auth-errors.d.ts.map +1 -0
- package/src/core/auth-errors.js +156 -0
- package/src/core/auth-errors.js.map +1 -0
- package/src/core/chat-info-cache.d.ts +58 -0
- package/src/core/chat-info-cache.d.ts.map +1 -0
- package/src/core/chat-info-cache.js +153 -0
- package/src/core/chat-info-cache.js.map +1 -0
- package/src/core/config-schema.d.ts +449 -0
- package/src/core/config-schema.d.ts.map +1 -0
- package/src/core/config-schema.js +201 -0
- package/src/core/config-schema.js.map +1 -0
- package/src/core/device-flow.d.ts +78 -0
- package/src/core/device-flow.d.ts.map +1 -0
- package/src/core/device-flow.js +213 -0
- package/src/core/device-flow.js.map +1 -0
- package/src/core/feishu-fetch.d.ts +19 -0
- package/src/core/feishu-fetch.d.ts.map +1 -0
- package/src/core/feishu-fetch.js +26 -0
- package/src/core/feishu-fetch.js.map +1 -0
- package/src/core/footer-config.d.ts +25 -0
- package/src/core/footer-config.d.ts.map +1 -0
- package/src/core/footer-config.js +40 -0
- package/src/core/footer-config.js.map +1 -0
- package/src/core/lark-client.d.ts +109 -0
- package/src/core/lark-client.d.ts.map +1 -0
- package/src/core/lark-client.js +354 -0
- package/src/core/lark-client.js.map +1 -0
- package/src/core/lark-logger.d.ts +24 -0
- package/src/core/lark-logger.d.ts.map +1 -0
- package/src/core/lark-logger.js +155 -0
- package/src/core/lark-logger.js.map +1 -0
- package/src/core/lark-ticket.d.ts +30 -0
- package/src/core/lark-ticket.d.ts.map +1 -0
- package/src/core/lark-ticket.js +36 -0
- package/src/core/lark-ticket.js.map +1 -0
- package/src/core/message-unavailable.d.ts +54 -0
- package/src/core/message-unavailable.d.ts.map +1 -0
- package/src/core/message-unavailable.js +131 -0
- package/src/core/message-unavailable.js.map +1 -0
- package/src/core/owner-policy.d.ts +32 -0
- package/src/core/owner-policy.d.ts.map +1 -0
- package/src/core/owner-policy.js +53 -0
- package/src/core/owner-policy.js.map +1 -0
- package/src/core/permission-url.d.ts +23 -0
- package/src/core/permission-url.d.ts.map +1 -0
- package/src/core/permission-url.js +73 -0
- package/src/core/permission-url.js.map +1 -0
- package/src/core/raw-request.d.ts +28 -0
- package/src/core/raw-request.d.ts.map +1 -0
- package/src/core/raw-request.js +63 -0
- package/src/core/raw-request.js.map +1 -0
- package/src/core/scope-manager.d.ts +169 -0
- package/src/core/scope-manager.d.ts.map +1 -0
- package/src/core/scope-manager.js +214 -0
- package/src/core/scope-manager.js.map +1 -0
- package/src/core/security-check.d.ts +73 -0
- package/src/core/security-check.d.ts.map +1 -0
- package/src/core/security-check.js +175 -0
- package/src/core/security-check.js.map +1 -0
- package/src/core/shutdown-hooks.d.ts +23 -0
- package/src/core/shutdown-hooks.d.ts.map +1 -0
- package/src/core/shutdown-hooks.js +57 -0
- package/src/core/shutdown-hooks.js.map +1 -0
- package/src/core/targets.d.ts +50 -0
- package/src/core/targets.d.ts.map +1 -0
- package/src/core/targets.js +128 -0
- package/src/core/targets.js.map +1 -0
- package/src/core/token-store.d.ts +55 -0
- package/src/core/token-store.d.ts.map +1 -0
- package/src/core/token-store.js +315 -0
- package/src/core/token-store.js.map +1 -0
- package/src/core/tool-client.d.ts +177 -0
- package/src/core/tool-client.d.ts.map +1 -0
- package/src/core/tool-client.js +381 -0
- package/src/core/tool-client.js.map +1 -0
- package/src/core/tool-scopes.d.ts +154 -0
- package/src/core/tool-scopes.d.ts.map +1 -0
- package/src/core/tool-scopes.js +326 -0
- package/src/core/tool-scopes.js.map +1 -0
- package/src/core/tools-config.d.ts +35 -0
- package/src/core/tools-config.d.ts.map +1 -0
- package/src/core/tools-config.js +88 -0
- package/src/core/tools-config.js.map +1 -0
- package/src/core/types.d.ts +88 -0
- package/src/core/types.d.ts.map +1 -0
- package/src/core/types.js +12 -0
- package/src/core/types.js.map +1 -0
- package/src/core/uat-client.d.ts +47 -0
- package/src/core/uat-client.d.ts.map +1 -0
- package/src/core/uat-client.js +173 -0
- package/src/core/uat-client.js.map +1 -0
- package/src/core/version.d.ts +26 -0
- package/src/core/version.d.ts.map +1 -0
- package/src/core/version.js +50 -0
- package/src/core/version.js.map +1 -0
- package/src/messaging/converters/audio.d.ts +9 -0
- package/src/messaging/converters/audio.d.ts.map +1 -0
- package/src/messaging/converters/audio.js +22 -0
- package/src/messaging/converters/audio.js.map +1 -0
- package/src/messaging/converters/calendar.d.ts +14 -0
- package/src/messaging/converters/calendar.d.ts.map +1 -0
- package/src/messaging/converters/calendar.js +51 -0
- package/src/messaging/converters/calendar.js.map +1 -0
- package/src/messaging/converters/content-converter.d.ts +42 -0
- package/src/messaging/converters/content-converter.d.ts.map +1 -0
- package/src/messaging/converters/content-converter.js +107 -0
- package/src/messaging/converters/content-converter.js.map +1 -0
- package/src/messaging/converters/file.d.ts +9 -0
- package/src/messaging/converters/file.d.ts.map +1 -0
- package/src/messaging/converters/file.js +21 -0
- package/src/messaging/converters/file.js.map +1 -0
- package/src/messaging/converters/folder.d.ts +9 -0
- package/src/messaging/converters/folder.d.ts.map +1 -0
- package/src/messaging/converters/folder.js +21 -0
- package/src/messaging/converters/folder.js.map +1 -0
- package/src/messaging/converters/hongbao.d.ts +9 -0
- package/src/messaging/converters/hongbao.d.ts.map +1 -0
- package/src/messaging/converters/hongbao.js +17 -0
- package/src/messaging/converters/hongbao.js.map +1 -0
- package/src/messaging/converters/image.d.ts +9 -0
- package/src/messaging/converters/image.d.ts.map +1 -0
- package/src/messaging/converters/image.js +19 -0
- package/src/messaging/converters/image.js.map +1 -0
- package/src/messaging/converters/index.d.ts +9 -0
- package/src/messaging/converters/index.d.ts.map +1 -0
- package/src/messaging/converters/index.js +51 -0
- package/src/messaging/converters/index.js.map +1 -0
- package/src/messaging/converters/interactive/card-converter.d.ts +77 -0
- package/src/messaging/converters/interactive/card-converter.d.ts.map +1 -0
- package/src/messaging/converters/interactive/card-converter.js +1174 -0
- package/src/messaging/converters/interactive/card-converter.js.map +1 -0
- package/src/messaging/converters/interactive/card-utils.d.ts +10 -0
- package/src/messaging/converters/interactive/card-utils.d.ts.map +1 -0
- package/src/messaging/converters/interactive/card-utils.js +43 -0
- package/src/messaging/converters/interactive/card-utils.js.map +1 -0
- package/src/messaging/converters/interactive/index.d.ts +9 -0
- package/src/messaging/converters/interactive/index.d.ts.map +1 -0
- package/src/messaging/converters/interactive/index.js +22 -0
- package/src/messaging/converters/interactive/index.js.map +1 -0
- package/src/messaging/converters/interactive/legacy.d.ts +12 -0
- package/src/messaging/converters/interactive/legacy.d.ts.map +1 -0
- package/src/messaging/converters/interactive/legacy.js +58 -0
- package/src/messaging/converters/interactive/legacy.js.map +1 -0
- package/src/messaging/converters/interactive/types.d.ts +24 -0
- package/src/messaging/converters/interactive/types.d.ts.map +1 -0
- package/src/messaging/converters/interactive/types.js +25 -0
- package/src/messaging/converters/interactive/types.js.map +1 -0
- package/src/messaging/converters/location.d.ts +9 -0
- package/src/messaging/converters/location.d.ts.map +1 -0
- package/src/messaging/converters/location.js +20 -0
- package/src/messaging/converters/location.js.map +1 -0
- package/src/messaging/converters/merge-forward.d.ts +33 -0
- package/src/messaging/converters/merge-forward.d.ts.map +1 -0
- package/src/messaging/converters/merge-forward.js +226 -0
- package/src/messaging/converters/merge-forward.js.map +1 -0
- package/src/messaging/converters/post.d.ts +12 -0
- package/src/messaging/converters/post.d.ts.map +1 -0
- package/src/messaging/converters/post.js +136 -0
- package/src/messaging/converters/post.js.map +1 -0
- package/src/messaging/converters/share.d.ts +10 -0
- package/src/messaging/converters/share.d.ts.map +1 -0
- package/src/messaging/converters/share.js +24 -0
- package/src/messaging/converters/share.js.map +1 -0
- package/src/messaging/converters/sticker.d.ts +9 -0
- package/src/messaging/converters/sticker.d.ts.map +1 -0
- package/src/messaging/converters/sticker.js +19 -0
- package/src/messaging/converters/sticker.js.map +1 -0
- package/src/messaging/converters/system.d.ts +13 -0
- package/src/messaging/converters/system.d.ts.map +1 -0
- package/src/messaging/converters/system.js +33 -0
- package/src/messaging/converters/system.js.map +1 -0
- package/src/messaging/converters/text.d.ts +9 -0
- package/src/messaging/converters/text.d.ts.map +1 -0
- package/src/messaging/converters/text.js +15 -0
- package/src/messaging/converters/text.js.map +1 -0
- package/src/messaging/converters/todo.d.ts +9 -0
- package/src/messaging/converters/todo.d.ts.map +1 -0
- package/src/messaging/converters/todo.js +42 -0
- package/src/messaging/converters/todo.js.map +1 -0
- package/src/messaging/converters/types.d.ts +108 -0
- package/src/messaging/converters/types.d.ts.map +1 -0
- package/src/messaging/converters/types.js +8 -0
- package/src/messaging/converters/types.js.map +1 -0
- package/src/messaging/converters/unknown.d.ts +9 -0
- package/src/messaging/converters/unknown.d.ts.map +1 -0
- package/src/messaging/converters/unknown.js +17 -0
- package/src/messaging/converters/unknown.js.map +1 -0
- package/src/messaging/converters/utils.d.ts +23 -0
- package/src/messaging/converters/utils.d.ts.map +1 -0
- package/src/messaging/converters/utils.js +52 -0
- package/src/messaging/converters/utils.js.map +1 -0
- package/src/messaging/converters/video-chat.d.ts +9 -0
- package/src/messaging/converters/video-chat.d.ts.map +1 -0
- package/src/messaging/converters/video-chat.js +24 -0
- package/src/messaging/converters/video-chat.js.map +1 -0
- package/src/messaging/converters/video.d.ts +9 -0
- package/src/messaging/converters/video.d.ts.map +1 -0
- package/src/messaging/converters/video.js +33 -0
- package/src/messaging/converters/video.js.map +1 -0
- package/src/messaging/converters/vote.d.ts +9 -0
- package/src/messaging/converters/vote.d.ts.map +1 -0
- package/src/messaging/converters/vote.js +25 -0
- package/src/messaging/converters/vote.js.map +1 -0
- package/src/messaging/inbound/dedup.d.ts +60 -0
- package/src/messaging/inbound/dedup.d.ts.map +1 -0
- package/src/messaging/inbound/dedup.js +117 -0
- package/src/messaging/inbound/dedup.js.map +1 -0
- package/src/messaging/inbound/dispatch-builders.d.ts +84 -0
- package/src/messaging/inbound/dispatch-builders.d.ts.map +1 -0
- package/src/messaging/inbound/dispatch-builders.js +153 -0
- package/src/messaging/inbound/dispatch-builders.js.map +1 -0
- package/src/messaging/inbound/dispatch-commands.d.ts +28 -0
- package/src/messaging/inbound/dispatch-commands.d.ts.map +1 -0
- package/src/messaging/inbound/dispatch-commands.js +113 -0
- package/src/messaging/inbound/dispatch-commands.js.map +1 -0
- package/src/messaging/inbound/dispatch-context.d.ts +68 -0
- package/src/messaging/inbound/dispatch-context.d.ts.map +1 -0
- package/src/messaging/inbound/dispatch-context.js +137 -0
- package/src/messaging/inbound/dispatch-context.js.map +1 -0
- package/src/messaging/inbound/dispatch.d.ts +48 -0
- package/src/messaging/inbound/dispatch.d.ts.map +1 -0
- package/src/messaging/inbound/dispatch.js +193 -0
- package/src/messaging/inbound/dispatch.js.map +1 -0
- package/src/messaging/inbound/enrich.d.ts +103 -0
- package/src/messaging/inbound/enrich.d.ts.map +1 -0
- package/src/messaging/inbound/enrich.js +228 -0
- package/src/messaging/inbound/enrich.js.map +1 -0
- package/src/messaging/inbound/gate-effects.d.ts +24 -0
- package/src/messaging/inbound/gate-effects.d.ts.map +1 -0
- package/src/messaging/inbound/gate-effects.js +44 -0
- package/src/messaging/inbound/gate-effects.js.map +1 -0
- package/src/messaging/inbound/gate.d.ts +61 -0
- package/src/messaging/inbound/gate.d.ts.map +1 -0
- package/src/messaging/inbound/gate.js +234 -0
- package/src/messaging/inbound/gate.js.map +1 -0
- package/src/messaging/inbound/handler.d.ts +36 -0
- package/src/messaging/inbound/handler.d.ts.map +1 -0
- package/src/messaging/inbound/handler.js +174 -0
- package/src/messaging/inbound/handler.js.map +1 -0
- package/src/messaging/inbound/media-resolver.d.ts +33 -0
- package/src/messaging/inbound/media-resolver.d.ts.map +1 -0
- package/src/messaging/inbound/media-resolver.js +88 -0
- package/src/messaging/inbound/media-resolver.js.map +1 -0
- package/src/messaging/inbound/mention.d.ts +40 -0
- package/src/messaging/inbound/mention.d.ts.map +1 -0
- package/src/messaging/inbound/mention.js +82 -0
- package/src/messaging/inbound/mention.js.map +1 -0
- package/src/messaging/inbound/parse-io.d.ts +51 -0
- package/src/messaging/inbound/parse-io.d.ts.map +1 -0
- package/src/messaging/inbound/parse-io.js +82 -0
- package/src/messaging/inbound/parse-io.js.map +1 -0
- package/src/messaging/inbound/parse.d.ts +29 -0
- package/src/messaging/inbound/parse.d.ts.map +1 -0
- package/src/messaging/inbound/parse.js +107 -0
- package/src/messaging/inbound/parse.js.map +1 -0
- package/src/messaging/inbound/permission.d.ts +18 -0
- package/src/messaging/inbound/permission.d.ts.map +1 -0
- package/src/messaging/inbound/permission.js +41 -0
- package/src/messaging/inbound/permission.js.map +1 -0
- package/src/messaging/inbound/policy.d.ts +95 -0
- package/src/messaging/inbound/policy.d.ts.map +1 -0
- package/src/messaging/inbound/policy.js +161 -0
- package/src/messaging/inbound/policy.js.map +1 -0
- package/src/messaging/inbound/reaction-handler.d.ts +62 -0
- package/src/messaging/inbound/reaction-handler.d.ts.map +1 -0
- package/src/messaging/inbound/reaction-handler.js +221 -0
- package/src/messaging/inbound/reaction-handler.js.map +1 -0
- package/src/messaging/inbound/user-name-cache.d.ts +83 -0
- package/src/messaging/inbound/user-name-cache.d.ts.map +1 -0
- package/src/messaging/inbound/user-name-cache.js +242 -0
- package/src/messaging/inbound/user-name-cache.js.map +1 -0
- package/src/messaging/outbound/actions.d.ts +17 -0
- package/src/messaging/outbound/actions.d.ts.map +1 -0
- package/src/messaging/outbound/actions.js +310 -0
- package/src/messaging/outbound/actions.js.map +1 -0
- package/src/messaging/outbound/chat-manage.d.ts +65 -0
- package/src/messaging/outbound/chat-manage.d.ts.map +1 -0
- package/src/messaging/outbound/chat-manage.js +112 -0
- package/src/messaging/outbound/chat-manage.js.map +1 -0
- package/src/messaging/outbound/deliver.d.ts +156 -0
- package/src/messaging/outbound/deliver.d.ts.map +1 -0
- package/src/messaging/outbound/deliver.js +299 -0
- package/src/messaging/outbound/deliver.js.map +1 -0
- package/src/messaging/outbound/fetch.d.ts +13 -0
- package/src/messaging/outbound/fetch.d.ts.map +1 -0
- package/src/messaging/outbound/fetch.js +13 -0
- package/src/messaging/outbound/fetch.js.map +1 -0
- package/src/messaging/outbound/forward.d.ts +27 -0
- package/src/messaging/outbound/forward.d.ts.map +1 -0
- package/src/messaging/outbound/forward.js +49 -0
- package/src/messaging/outbound/forward.js.map +1 -0
- package/src/messaging/outbound/media-url-utils.d.ts +30 -0
- package/src/messaging/outbound/media-url-utils.d.ts.map +1 -0
- package/src/messaging/outbound/media-url-utils.js +131 -0
- package/src/messaging/outbound/media-url-utils.js.map +1 -0
- package/src/messaging/outbound/media.d.ts +256 -0
- package/src/messaging/outbound/media.d.ts.map +1 -0
- package/src/messaging/outbound/media.js +749 -0
- package/src/messaging/outbound/media.js.map +1 -0
- package/src/messaging/outbound/outbound.d.ts +90 -0
- package/src/messaging/outbound/outbound.d.ts.map +1 -0
- package/src/messaging/outbound/outbound.js +112 -0
- package/src/messaging/outbound/outbound.js.map +1 -0
- package/src/messaging/outbound/reactions.d.ts +125 -0
- package/src/messaging/outbound/reactions.d.ts.map +1 -0
- package/src/messaging/outbound/reactions.js +379 -0
- package/src/messaging/outbound/reactions.js.map +1 -0
- package/src/messaging/outbound/send.d.ts +136 -0
- package/src/messaging/outbound/send.d.ts.map +1 -0
- package/src/messaging/outbound/send.js +289 -0
- package/src/messaging/outbound/send.js.map +1 -0
- package/src/messaging/outbound/typing.d.ts +61 -0
- package/src/messaging/outbound/typing.d.ts.map +1 -0
- package/src/messaging/outbound/typing.js +136 -0
- package/src/messaging/outbound/typing.js.map +1 -0
- package/src/messaging/shared/message-lookup.d.ts +55 -0
- package/src/messaging/shared/message-lookup.d.ts.map +1 -0
- package/src/messaging/shared/message-lookup.js +118 -0
- package/src/messaging/shared/message-lookup.js.map +1 -0
- package/src/messaging/types.d.ts +177 -0
- package/src/messaging/types.d.ts.map +1 -0
- package/src/messaging/types.js +11 -0
- package/src/messaging/types.js.map +1 -0
- package/src/tools/auto-auth.d.ts +57 -0
- package/src/tools/auto-auth.d.ts.map +1 -0
- package/src/tools/auto-auth.js +925 -0
- package/src/tools/auto-auth.js.map +1 -0
- package/src/tools/helpers.d.ts +220 -0
- package/src/tools/helpers.d.ts.map +1 -0
- package/src/tools/helpers.js +298 -0
- package/src/tools/helpers.js.map +1 -0
- package/src/tools/mcp/doc/create.d.ts +13 -0
- package/src/tools/mcp/doc/create.d.ts.map +1 -0
- package/src/tools/mcp/doc/create.js +45 -0
- package/src/tools/mcp/doc/create.js.map +1 -0
- package/src/tools/mcp/doc/fetch.d.ts +13 -0
- package/src/tools/mcp/doc/fetch.d.ts.map +1 -0
- package/src/tools/mcp/doc/fetch.js +37 -0
- package/src/tools/mcp/doc/fetch.js.map +1 -0
- package/src/tools/mcp/doc/index.d.ts +13 -0
- package/src/tools/mcp/doc/index.d.ts.map +1 -0
- package/src/tools/mcp/doc/index.js +42 -0
- package/src/tools/mcp/doc/index.js.map +1 -0
- package/src/tools/mcp/doc/update.d.ts +13 -0
- package/src/tools/mcp/doc/update.d.ts.map +1 -0
- package/src/tools/mcp/doc/update.js +62 -0
- package/src/tools/mcp/doc/update.js.map +1 -0
- package/src/tools/mcp/shared.d.ts +58 -0
- package/src/tools/mcp/shared.d.ts.map +1 -0
- package/src/tools/mcp/shared.js +224 -0
- package/src/tools/mcp/shared.js.map +1 -0
- package/src/tools/oapi/bitable/app-table-field.d.ts +17 -0
- package/src/tools/oapi/bitable/app-table-field.d.ts.map +1 -0
- package/src/tools/oapi/bitable/app-table-field.js +224 -0
- package/src/tools/oapi/bitable/app-table-field.js.map +1 -0
- package/src/tools/oapi/bitable/app-table-record.d.ts +21 -0
- package/src/tools/oapi/bitable/app-table-record.d.ts.map +1 -0
- package/src/tools/oapi/bitable/app-table-record.js +449 -0
- package/src/tools/oapi/bitable/app-table-record.js.map +1 -0
- package/src/tools/oapi/bitable/app-table-view.d.ts +18 -0
- package/src/tools/oapi/bitable/app-table-view.d.ts.map +1 -0
- package/src/tools/oapi/bitable/app-table-view.js +197 -0
- package/src/tools/oapi/bitable/app-table-view.js.map +1 -0
- package/src/tools/oapi/bitable/app-table.d.ts +20 -0
- package/src/tools/oapi/bitable/app-table.d.ts.map +1 -0
- package/src/tools/oapi/bitable/app-table.js +249 -0
- package/src/tools/oapi/bitable/app-table.js.map +1 -0
- package/src/tools/oapi/bitable/app.d.ts +19 -0
- package/src/tools/oapi/bitable/app.d.ts.map +1 -0
- package/src/tools/oapi/bitable/app.js +188 -0
- package/src/tools/oapi/bitable/app.js.map +1 -0
- package/src/tools/oapi/bitable/index.d.ts +10 -0
- package/src/tools/oapi/bitable/index.d.ts.map +1 -0
- package/src/tools/oapi/bitable/index.js +10 -0
- package/src/tools/oapi/bitable/index.js.map +1 -0
- package/src/tools/oapi/calendar/calendar.d.ts +16 -0
- package/src/tools/oapi/calendar/calendar.d.ts.map +1 -0
- package/src/tools/oapi/calendar/calendar.js +124 -0
- package/src/tools/oapi/calendar/calendar.js.map +1 -0
- package/src/tools/oapi/calendar/event-attendee.d.ts +17 -0
- package/src/tools/oapi/calendar/event-attendee.d.ts.map +1 -0
- package/src/tools/oapi/calendar/event-attendee.js +275 -0
- package/src/tools/oapi/calendar/event-attendee.js.map +1 -0
- package/src/tools/oapi/calendar/event.d.ts +17 -0
- package/src/tools/oapi/calendar/event.d.ts.map +1 -0
- package/src/tools/oapi/calendar/event.js +721 -0
- package/src/tools/oapi/calendar/event.js.map +1 -0
- package/src/tools/oapi/calendar/freebusy.d.ts +14 -0
- package/src/tools/oapi/calendar/freebusy.d.ts.map +1 -0
- package/src/tools/oapi/calendar/freebusy.js +113 -0
- package/src/tools/oapi/calendar/freebusy.js.map +1 -0
- package/src/tools/oapi/calendar/index.d.ts +9 -0
- package/src/tools/oapi/calendar/index.d.ts.map +1 -0
- package/src/tools/oapi/calendar/index.js +9 -0
- package/src/tools/oapi/calendar/index.js.map +1 -0
- package/src/tools/oapi/chat/chat.d.ts +17 -0
- package/src/tools/oapi/chat/chat.d.ts.map +1 -0
- package/src/tools/oapi/chat/chat.js +126 -0
- package/src/tools/oapi/chat/chat.js.map +1 -0
- package/src/tools/oapi/chat/index.d.ts +11 -0
- package/src/tools/oapi/chat/index.d.ts.map +1 -0
- package/src/tools/oapi/chat/index.js +16 -0
- package/src/tools/oapi/chat/index.js.map +1 -0
- package/src/tools/oapi/chat/members.d.ts +12 -0
- package/src/tools/oapi/chat/members.d.ts.map +1 -0
- package/src/tools/oapi/chat/members.js +83 -0
- package/src/tools/oapi/chat/members.js.map +1 -0
- package/src/tools/oapi/common/get-user.d.ts +13 -0
- package/src/tools/oapi/common/get-user.d.ts.map +1 -0
- package/src/tools/oapi/common/get-user.js +108 -0
- package/src/tools/oapi/common/get-user.js.map +1 -0
- package/src/tools/oapi/common/index.d.ts +7 -0
- package/src/tools/oapi/common/index.d.ts.map +1 -0
- package/src/tools/oapi/common/index.js +7 -0
- package/src/tools/oapi/common/index.js.map +1 -0
- package/src/tools/oapi/common/search-user.d.ts +12 -0
- package/src/tools/oapi/common/search-user.d.ts.map +1 -0
- package/src/tools/oapi/common/search-user.js +75 -0
- package/src/tools/oapi/common/search-user.js.map +1 -0
- package/src/tools/oapi/drive/doc-comments.d.ts +16 -0
- package/src/tools/oapi/drive/doc-comments.d.ts.map +1 -0
- package/src/tools/oapi/drive/doc-comments.js +288 -0
- package/src/tools/oapi/drive/doc-comments.js.map +1 -0
- package/src/tools/oapi/drive/doc-media.d.ts +20 -0
- package/src/tools/oapi/drive/doc-media.d.ts.map +1 -0
- package/src/tools/oapi/drive/doc-media.js +337 -0
- package/src/tools/oapi/drive/doc-media.js.map +1 -0
- package/src/tools/oapi/drive/file.d.ts +20 -0
- package/src/tools/oapi/drive/file.d.ts.map +1 -0
- package/src/tools/oapi/drive/file.js +485 -0
- package/src/tools/oapi/drive/file.js.map +1 -0
- package/src/tools/oapi/drive/index.d.ts +13 -0
- package/src/tools/oapi/drive/index.d.ts.map +1 -0
- package/src/tools/oapi/drive/index.js +37 -0
- package/src/tools/oapi/drive/index.js.map +1 -0
- package/src/tools/oapi/helpers.d.ts +174 -0
- package/src/tools/oapi/helpers.d.ts.map +1 -0
- package/src/tools/oapi/helpers.js +341 -0
- package/src/tools/oapi/helpers.js.map +1 -0
- package/src/tools/oapi/im/format-messages.d.ts +51 -0
- package/src/tools/oapi/im/format-messages.d.ts.map +1 -0
- package/src/tools/oapi/im/format-messages.js +166 -0
- package/src/tools/oapi/im/format-messages.js.map +1 -0
- package/src/tools/oapi/im/index.d.ts +11 -0
- package/src/tools/oapi/im/index.d.ts.map +1 -0
- package/src/tools/oapi/im/index.js +18 -0
- package/src/tools/oapi/im/index.js.map +1 -0
- package/src/tools/oapi/im/message-read.d.ts +14 -0
- package/src/tools/oapi/im/message-read.d.ts.map +1 -0
- package/src/tools/oapi/im/message-read.js +412 -0
- package/src/tools/oapi/im/message-read.js.map +1 -0
- package/src/tools/oapi/im/message.d.ts +17 -0
- package/src/tools/oapi/im/message.d.ts.map +1 -0
- package/src/tools/oapi/im/message.js +171 -0
- package/src/tools/oapi/im/message.js.map +1 -0
- package/src/tools/oapi/im/resource.d.ts +14 -0
- package/src/tools/oapi/im/resource.d.ts.map +1 -0
- package/src/tools/oapi/im/resource.js +152 -0
- package/src/tools/oapi/im/resource.js.map +1 -0
- package/src/tools/oapi/im/time-utils.d.ts +47 -0
- package/src/tools/oapi/im/time-utils.d.ts.map +1 -0
- package/src/tools/oapi/im/time-utils.js +202 -0
- package/src/tools/oapi/im/time-utils.js.map +1 -0
- package/src/tools/oapi/im/user-name-uat.d.ts +24 -0
- package/src/tools/oapi/im/user-name-uat.d.ts.map +1 -0
- package/src/tools/oapi/im/user-name-uat.js +128 -0
- package/src/tools/oapi/im/user-name-uat.js.map +1 -0
- package/src/tools/oapi/index.d.ts +12 -0
- package/src/tools/oapi/index.d.ts.map +1 -0
- package/src/tools/oapi/index.js +59 -0
- package/src/tools/oapi/index.js.map +1 -0
- package/src/tools/oapi/sdk-types.d.ts +97 -0
- package/src/tools/oapi/sdk-types.d.ts.map +1 -0
- package/src/tools/oapi/sdk-types.js +13 -0
- package/src/tools/oapi/sdk-types.js.map +1 -0
- package/src/tools/oapi/search/doc-search.d.ts +14 -0
- package/src/tools/oapi/search/doc-search.d.ts.map +1 -0
- package/src/tools/oapi/search/doc-search.js +203 -0
- package/src/tools/oapi/search/doc-search.js.map +1 -0
- package/src/tools/oapi/search/index.d.ts +13 -0
- package/src/tools/oapi/search/index.d.ts.map +1 -0
- package/src/tools/oapi/search/index.js +34 -0
- package/src/tools/oapi/search/index.js.map +1 -0
- package/src/tools/oapi/sheets/index.d.ts +13 -0
- package/src/tools/oapi/sheets/index.d.ts.map +1 -0
- package/src/tools/oapi/sheets/index.js +32 -0
- package/src/tools/oapi/sheets/index.js.map +1 -0
- package/src/tools/oapi/sheets/sheet.d.ts +17 -0
- package/src/tools/oapi/sheets/sheet.d.ts.map +1 -0
- package/src/tools/oapi/sheets/sheet.js +652 -0
- package/src/tools/oapi/sheets/sheet.js.map +1 -0
- package/src/tools/oapi/task/comment.d.ts +16 -0
- package/src/tools/oapi/task/comment.d.ts.map +1 -0
- package/src/tools/oapi/task/comment.js +142 -0
- package/src/tools/oapi/task/comment.js.map +1 -0
- package/src/tools/oapi/task/index.d.ts +9 -0
- package/src/tools/oapi/task/index.d.ts.map +1 -0
- package/src/tools/oapi/task/index.js +9 -0
- package/src/tools/oapi/task/index.js.map +1 -0
- package/src/tools/oapi/task/subtask.d.ts +15 -0
- package/src/tools/oapi/task/subtask.d.ts.map +1 -0
- package/src/tools/oapi/task/subtask.js +164 -0
- package/src/tools/oapi/task/subtask.js.map +1 -0
- package/src/tools/oapi/task/task.d.ts +17 -0
- package/src/tools/oapi/task/task.d.ts.map +1 -0
- package/src/tools/oapi/task/task.js +346 -0
- package/src/tools/oapi/task/task.js.map +1 -0
- package/src/tools/oapi/task/tasklist.d.ts +22 -0
- package/src/tools/oapi/task/tasklist.d.ts.map +1 -0
- package/src/tools/oapi/task/tasklist.js +323 -0
- package/src/tools/oapi/task/tasklist.js.map +1 -0
- package/src/tools/oapi/wiki/index.d.ts +13 -0
- package/src/tools/oapi/wiki/index.d.ts.map +1 -0
- package/src/tools/oapi/wiki/index.js +35 -0
- package/src/tools/oapi/wiki/index.js.map +1 -0
- package/src/tools/oapi/wiki/space-node.d.ts +18 -0
- package/src/tools/oapi/wiki/space-node.d.ts.map +1 -0
- package/src/tools/oapi/wiki/space-node.js +253 -0
- package/src/tools/oapi/wiki/space-node.js.map +1 -0
- package/src/tools/oapi/wiki/space.d.ts +16 -0
- package/src/tools/oapi/wiki/space.d.ts.map +1 -0
- package/src/tools/oapi/wiki/space.js +132 -0
- package/src/tools/oapi/wiki/space.js.map +1 -0
- package/src/tools/oauth-batch-auth.d.ts +12 -0
- package/src/tools/oauth-batch-auth.d.ts.map +1 -0
- package/src/tools/oauth-batch-auth.js +142 -0
- package/src/tools/oauth-batch-auth.js.map +1 -0
- package/src/tools/oauth-cards.d.ts +27 -0
- package/src/tools/oauth-cards.d.ts.map +1 -0
- package/src/tools/oauth-cards.js +251 -0
- package/src/tools/oauth-cards.js.map +1 -0
- package/src/tools/oauth.d.ts +48 -0
- package/src/tools/oauth.d.ts.map +1 -0
- package/src/tools/oauth.js +619 -0
- package/src/tools/oauth.js.map +1 -0
- package/src/tools/onboarding-auth.d.ts +28 -0
- package/src/tools/onboarding-auth.d.ts.map +1 -0
- package/src/tools/onboarding-auth.js +131 -0
- package/src/tools/onboarding-auth.js.map +1 -0
- package/src/tools/tat/im/index.d.ts +16 -0
- package/src/tools/tat/im/index.d.ts.map +1 -0
- package/src/tools/tat/im/index.js +19 -0
- package/src/tools/tat/im/index.js.map +1 -0
- package/src/tools/tat/im/resource.d.ts +16 -0
- package/src/tools/tat/im/resource.d.ts.map +1 -0
- package/src/tools/tat/im/resource.js +158 -0
- package/src/tools/tat/im/resource.js.map +1 -0
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
|
|
3
|
+
* SPDX-License-Identifier: MIT
|
|
4
|
+
*
|
|
5
|
+
* OAPI 工具专用辅助函数
|
|
6
|
+
*
|
|
7
|
+
* 提供 OAPI 工具特有的功能(如时间转换),并复用通用辅助函数。
|
|
8
|
+
*/
|
|
9
|
+
import type { ClawdbotConfig } from 'openclaw/plugin-sdk';
|
|
10
|
+
import type { Client as LarkClient } from '@larksuiteoapi/node-sdk';
|
|
11
|
+
export { formatToolResult, formatToolError, createToolLogger, createClientGetter, createToolContext, getFirstAccount, validateRequiredParams, validateEnum, } from '../helpers';
|
|
12
|
+
export type { ToolResult, ClientGetter, ToolContext } from '../helpers';
|
|
13
|
+
export { ToolClient, createToolClient, NeedAuthorizationError, AppScopeMissingError, UserAuthRequiredError, UserScopeInsufficientError, } from '../../core/tool-client';
|
|
14
|
+
export type { ApiFn, InvokeFn, InvokeOptions, InvokeByPathOptions, AuthHint, TryInvokeResult, } from '../../core/tool-client';
|
|
15
|
+
/**
|
|
16
|
+
* 从配置直接创建飞书客户端(OAPI 工具常用模式)
|
|
17
|
+
*
|
|
18
|
+
* 这是对 createClientGetter 的简化封装,直接返回客户端实例而非 getter 函数。
|
|
19
|
+
*
|
|
20
|
+
* @param config - OpenClaw 配置对象
|
|
21
|
+
* @returns 飞书 SDK 客户端实例
|
|
22
|
+
* @throws 如果没有启用的账号
|
|
23
|
+
*
|
|
24
|
+
* @example
|
|
25
|
+
* ```typescript
|
|
26
|
+
* export function registerMyOapiTool(api: OpenClawPluginApi) {
|
|
27
|
+
* api.registerTool({
|
|
28
|
+
* name: "my_oapi_tool",
|
|
29
|
+
* async execute(_toolCallId, params) {
|
|
30
|
+
* const client = createFeishuClientFromConfig(api.config);
|
|
31
|
+
* const res = await client.calendar.calendarEvent.list({ ... });
|
|
32
|
+
* return json(res.data);
|
|
33
|
+
* }
|
|
34
|
+
* });
|
|
35
|
+
* }
|
|
36
|
+
* ```
|
|
37
|
+
*/
|
|
38
|
+
export declare function createFeishuClientFromConfig(config: ClawdbotConfig): LarkClient;
|
|
39
|
+
/**
|
|
40
|
+
* 格式化返回值为 JSON(OAPI 工具常用简化接口)
|
|
41
|
+
*
|
|
42
|
+
* 这是对 formatToolResult 的简化封装,函数名更短便于频繁使用。
|
|
43
|
+
*
|
|
44
|
+
* @param data - 要返回的数据
|
|
45
|
+
* @returns 格式化的工具返回值
|
|
46
|
+
*
|
|
47
|
+
* @example
|
|
48
|
+
* ```typescript
|
|
49
|
+
* return json({ task: taskData });
|
|
50
|
+
* return json({ error: "Invalid parameter" });
|
|
51
|
+
* ```
|
|
52
|
+
*/
|
|
53
|
+
export declare function json(data: unknown): import("./helpers").ToolResult;
|
|
54
|
+
/**
|
|
55
|
+
* 解析时间字符串为 Unix 时间戳(秒)
|
|
56
|
+
*
|
|
57
|
+
* 支持多种格式:
|
|
58
|
+
* 1. ISO 8601 / RFC 3339(带时区):"2024-01-01T00:00:00+08:00"
|
|
59
|
+
* 2. 不带时区的格式(默认为北京时间 UTC+8):
|
|
60
|
+
* - "2026-02-25 14:30"
|
|
61
|
+
* - "2026-02-25 14:30:00"
|
|
62
|
+
* - "2026-02-25T14:30:00"
|
|
63
|
+
*
|
|
64
|
+
* @param input - 时间字符串
|
|
65
|
+
* @returns Unix 时间戳字符串(秒),解析失败返回 null
|
|
66
|
+
*
|
|
67
|
+
* @example
|
|
68
|
+
* ```typescript
|
|
69
|
+
* parseTimeToTimestamp("2026-02-25T14:30:00+08:00") // => "1740459000"
|
|
70
|
+
* parseTimeToTimestamp("2026-02-25 14:30") // => "1740459000" (默认北京时间)
|
|
71
|
+
* parseTimeToTimestamp("2026-02-25T14:30:00") // => "1740459000" (默认北京时间)
|
|
72
|
+
* parseTimeToTimestamp("invalid") // => null
|
|
73
|
+
* ```
|
|
74
|
+
*/
|
|
75
|
+
export declare function parseTimeToTimestamp(input: string): string | null;
|
|
76
|
+
/**
|
|
77
|
+
* 解析时间字符串为 Unix 时间戳(毫秒)
|
|
78
|
+
*
|
|
79
|
+
* 支持多种格式:
|
|
80
|
+
* 1. ISO 8601 / RFC 3339(带时区):"2024-01-01T00:00:00+08:00"
|
|
81
|
+
* 2. 不带时区的格式(默认为北京时间 UTC+8):
|
|
82
|
+
* - "2026-02-25 14:30"
|
|
83
|
+
* - "2026-02-25 14:30:00"
|
|
84
|
+
* - "2026-02-25T14:30:00"
|
|
85
|
+
*
|
|
86
|
+
* @param input - 时间字符串
|
|
87
|
+
* @returns Unix 时间戳字符串(毫秒),解析失败返回 null
|
|
88
|
+
*
|
|
89
|
+
* @example
|
|
90
|
+
* ```typescript
|
|
91
|
+
* parseTimeToTimestampMs("2026-02-25T14:30:00+08:00") // => "1740459000000"
|
|
92
|
+
* parseTimeToTimestampMs("2026-02-25 14:30") // => "1740459000000" (默认北京时间)
|
|
93
|
+
* parseTimeToTimestampMs("2026-02-25T14:30:00") // => "1740459000000" (默认北京时间)
|
|
94
|
+
* parseTimeToTimestampMs("invalid") // => null
|
|
95
|
+
* ```
|
|
96
|
+
*/
|
|
97
|
+
export declare function parseTimeToTimestampMs(input: string): string | null;
|
|
98
|
+
/**
|
|
99
|
+
* 解析时间字符串为 RFC 3339 格式(用于 freebusy API)
|
|
100
|
+
*
|
|
101
|
+
* 支持多种格式:
|
|
102
|
+
* 1. ISO 8601 / RFC 3339(带时区):"2024-01-01T00:00:00+08:00" - 直接返回
|
|
103
|
+
* 2. 不带时区的格式(默认为北京时间 UTC+8):
|
|
104
|
+
* - "2026-02-25 14:30" - 转换为 "2026-02-25T14:30:00+08:00"
|
|
105
|
+
* - "2026-02-25 14:30:00" - 转换为 "2026-02-25T14:30:00+08:00"
|
|
106
|
+
* - "2026-02-25T14:30:00" - 转换为 "2026-02-25T14:30:00+08:00"
|
|
107
|
+
*
|
|
108
|
+
* @param input - 时间字符串
|
|
109
|
+
* @returns RFC 3339 格式的时间字符串,解析失败返回 null
|
|
110
|
+
*
|
|
111
|
+
* @example
|
|
112
|
+
* ```typescript
|
|
113
|
+
* parseTimeToRFC3339("2026-02-25T14:30:00+08:00") // => "2026-02-25T14:30:00+08:00"
|
|
114
|
+
* parseTimeToRFC3339("2026-02-25 14:30") // => "2026-02-25T14:30:00+08:00"
|
|
115
|
+
* parseTimeToRFC3339("2026-02-25T14:30:00") // => "2026-02-25T14:30:00+08:00"
|
|
116
|
+
* ```
|
|
117
|
+
*/
|
|
118
|
+
export declare function parseTimeToRFC3339(input: string): string | null;
|
|
119
|
+
/**
|
|
120
|
+
* 转换时间范围对象(用于 search 等 API)
|
|
121
|
+
*
|
|
122
|
+
* 将包含 ISO 8601 格式时间字符串的时间范围转换为时间戳。
|
|
123
|
+
*
|
|
124
|
+
* @param timeRange - 时间范围对象,包含可选的 start 和 end 字段
|
|
125
|
+
* @param unit - 时间戳单位,'s' 为秒,'ms' 为毫秒,默认为 's'
|
|
126
|
+
* @returns 转换后的时间范围对象,包含数字类型的时间戳
|
|
127
|
+
* @throws 如果时间格式错误
|
|
128
|
+
*
|
|
129
|
+
* @example
|
|
130
|
+
* ```typescript
|
|
131
|
+
* convertTimeRange({ start: "2026-02-25T14:00:00+08:00", end: "2026-02-25T18:00:00+08:00" })
|
|
132
|
+
* // => { start: 1740459000, end: 1740473400 }
|
|
133
|
+
*
|
|
134
|
+
* convertTimeRange({ start: "2026-02-25T14:00:00+08:00" }, 'ms')
|
|
135
|
+
* // => { start: 1740459000000 }
|
|
136
|
+
* ```
|
|
137
|
+
*/
|
|
138
|
+
export declare function convertTimeRange(timeRange: {
|
|
139
|
+
start?: string;
|
|
140
|
+
end?: string;
|
|
141
|
+
} | undefined, unit?: 's' | 'ms'): {
|
|
142
|
+
start?: number;
|
|
143
|
+
end?: number;
|
|
144
|
+
} | undefined;
|
|
145
|
+
export declare const SHANGHAI_UTC_OFFSET_HOURS = 8;
|
|
146
|
+
export declare const SHANGHAI_OFFSET_SUFFIX = "+08:00";
|
|
147
|
+
export declare function pad2(value: number): string;
|
|
148
|
+
/**
|
|
149
|
+
* Convert a Unix timestamp (seconds or milliseconds) to ISO 8601 string
|
|
150
|
+
* in the Asia/Shanghai timezone.
|
|
151
|
+
*
|
|
152
|
+
* Auto-detects seconds vs milliseconds based on magnitude.
|
|
153
|
+
*
|
|
154
|
+
* @returns e.g. `"2026-02-25T14:30:00+08:00"`, or `null` on invalid input
|
|
155
|
+
*/
|
|
156
|
+
export declare function unixTimestampToISO8601(raw: string | number | undefined): string | null;
|
|
157
|
+
/**
|
|
158
|
+
* Re-export 飞书 API 错误处理函数
|
|
159
|
+
*
|
|
160
|
+
* 这些函数专门用于处理飞书 Open API 的响应和错误。
|
|
161
|
+
*/
|
|
162
|
+
export { assertLarkOk, formatLarkError } from '../../core/api-error';
|
|
163
|
+
/**
|
|
164
|
+
* Check whether an error is a structured invoke-level auth/permission error.
|
|
165
|
+
*
|
|
166
|
+
* Useful in intermediate catch blocks that need to let auth errors bubble up
|
|
167
|
+
* to the outer `handleInvokeErrorWithAutoAuth`.
|
|
168
|
+
*
|
|
169
|
+
* For "allow-to-fail" sub-operations, prefer `client.tryInvoke()` over
|
|
170
|
+
* manual `isInvokeError` + throw.
|
|
171
|
+
*/
|
|
172
|
+
export declare function isInvokeError(err: unknown): boolean;
|
|
173
|
+
export { handleInvokeErrorWithAutoAuth } from '../auto-auth';
|
|
174
|
+
//# sourceMappingURL=helpers.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../src/tools/oapi/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAMpE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAMxE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,QAAQ,EACR,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAQhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAG/E;AAQD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,kCAEjC;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CjE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2CnE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmC/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACvD,IAAI,GAAE,GAAG,GAAG,IAAU,GACrB;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA2B9C;AAMD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAqBtF;AAMD;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAQrE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMnD;AAMD,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC"}
|
|
@@ -0,0 +1,341 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
|
|
3
|
+
* SPDX-License-Identifier: MIT
|
|
4
|
+
*
|
|
5
|
+
* OAPI 工具专用辅助函数
|
|
6
|
+
*
|
|
7
|
+
* 提供 OAPI 工具特有的功能(如时间转换),并复用通用辅助函数。
|
|
8
|
+
*/
|
|
9
|
+
// ---------------------------------------------------------------------------
|
|
10
|
+
// 通用功能(从 tools/helpers.ts 导入)
|
|
11
|
+
// ---------------------------------------------------------------------------
|
|
12
|
+
export { formatToolResult, formatToolError, createToolLogger, createClientGetter, createToolContext, getFirstAccount, validateRequiredParams, validateEnum, } from '../helpers';
|
|
13
|
+
// ---------------------------------------------------------------------------
|
|
14
|
+
// ToolClient(工具层统一客户端)
|
|
15
|
+
// ---------------------------------------------------------------------------
|
|
16
|
+
export { ToolClient, createToolClient, NeedAuthorizationError, AppScopeMissingError, UserAuthRequiredError, UserScopeInsufficientError, } from '../../core/tool-client';
|
|
17
|
+
// ---------------------------------------------------------------------------
|
|
18
|
+
// OAPI 专用:客户端便捷创建
|
|
19
|
+
// ---------------------------------------------------------------------------
|
|
20
|
+
import { createClientGetter } from '../helpers';
|
|
21
|
+
/**
|
|
22
|
+
* 从配置直接创建飞书客户端(OAPI 工具常用模式)
|
|
23
|
+
*
|
|
24
|
+
* 这是对 createClientGetter 的简化封装,直接返回客户端实例而非 getter 函数。
|
|
25
|
+
*
|
|
26
|
+
* @param config - OpenClaw 配置对象
|
|
27
|
+
* @returns 飞书 SDK 客户端实例
|
|
28
|
+
* @throws 如果没有启用的账号
|
|
29
|
+
*
|
|
30
|
+
* @example
|
|
31
|
+
* ```typescript
|
|
32
|
+
* export function registerMyOapiTool(api: OpenClawPluginApi) {
|
|
33
|
+
* api.registerTool({
|
|
34
|
+
* name: "my_oapi_tool",
|
|
35
|
+
* async execute(_toolCallId, params) {
|
|
36
|
+
* const client = createFeishuClientFromConfig(api.config);
|
|
37
|
+
* const res = await client.calendar.calendarEvent.list({ ... });
|
|
38
|
+
* return json(res.data);
|
|
39
|
+
* }
|
|
40
|
+
* });
|
|
41
|
+
* }
|
|
42
|
+
* ```
|
|
43
|
+
*/
|
|
44
|
+
export function createFeishuClientFromConfig(config) {
|
|
45
|
+
const getClient = createClientGetter(config);
|
|
46
|
+
return getClient();
|
|
47
|
+
}
|
|
48
|
+
// ---------------------------------------------------------------------------
|
|
49
|
+
// OAPI 专用:返回值格式化(简化版)
|
|
50
|
+
// ---------------------------------------------------------------------------
|
|
51
|
+
import { formatToolResult } from '../helpers';
|
|
52
|
+
/**
|
|
53
|
+
* 格式化返回值为 JSON(OAPI 工具常用简化接口)
|
|
54
|
+
*
|
|
55
|
+
* 这是对 formatToolResult 的简化封装,函数名更短便于频繁使用。
|
|
56
|
+
*
|
|
57
|
+
* @param data - 要返回的数据
|
|
58
|
+
* @returns 格式化的工具返回值
|
|
59
|
+
*
|
|
60
|
+
* @example
|
|
61
|
+
* ```typescript
|
|
62
|
+
* return json({ task: taskData });
|
|
63
|
+
* return json({ error: "Invalid parameter" });
|
|
64
|
+
* ```
|
|
65
|
+
*/
|
|
66
|
+
export function json(data) {
|
|
67
|
+
return formatToolResult(data);
|
|
68
|
+
}
|
|
69
|
+
// ---------------------------------------------------------------------------
|
|
70
|
+
// OAPI 专用:时间转换工具
|
|
71
|
+
// ---------------------------------------------------------------------------
|
|
72
|
+
/**
|
|
73
|
+
* 解析时间字符串为 Unix 时间戳(秒)
|
|
74
|
+
*
|
|
75
|
+
* 支持多种格式:
|
|
76
|
+
* 1. ISO 8601 / RFC 3339(带时区):"2024-01-01T00:00:00+08:00"
|
|
77
|
+
* 2. 不带时区的格式(默认为北京时间 UTC+8):
|
|
78
|
+
* - "2026-02-25 14:30"
|
|
79
|
+
* - "2026-02-25 14:30:00"
|
|
80
|
+
* - "2026-02-25T14:30:00"
|
|
81
|
+
*
|
|
82
|
+
* @param input - 时间字符串
|
|
83
|
+
* @returns Unix 时间戳字符串(秒),解析失败返回 null
|
|
84
|
+
*
|
|
85
|
+
* @example
|
|
86
|
+
* ```typescript
|
|
87
|
+
* parseTimeToTimestamp("2026-02-25T14:30:00+08:00") // => "1740459000"
|
|
88
|
+
* parseTimeToTimestamp("2026-02-25 14:30") // => "1740459000" (默认北京时间)
|
|
89
|
+
* parseTimeToTimestamp("2026-02-25T14:30:00") // => "1740459000" (默认北京时间)
|
|
90
|
+
* parseTimeToTimestamp("invalid") // => null
|
|
91
|
+
* ```
|
|
92
|
+
*/
|
|
93
|
+
export function parseTimeToTimestamp(input) {
|
|
94
|
+
try {
|
|
95
|
+
const trimmed = input.trim();
|
|
96
|
+
// 检查是否包含时区信息(Z 或 +/- 偏移)
|
|
97
|
+
const hasTimezone = /[Zz]$|[+-]\d{2}:\d{2}$/.test(trimmed);
|
|
98
|
+
if (hasTimezone) {
|
|
99
|
+
// 有时区信息,直接解析
|
|
100
|
+
const date = new Date(trimmed);
|
|
101
|
+
if (isNaN(date.getTime()))
|
|
102
|
+
return null;
|
|
103
|
+
return Math.floor(date.getTime() / 1000).toString();
|
|
104
|
+
}
|
|
105
|
+
// 没有时区信息,当作北京时间处理
|
|
106
|
+
// 支持格式:YYYY-MM-DD HH:mm 或 YYYY-MM-DD HH:mm:ss 或 YYYY-MM-DDTHH:mm:ss
|
|
107
|
+
const normalized = trimmed.replace('T', ' ');
|
|
108
|
+
const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})(?::(\d{2}))?$/);
|
|
109
|
+
if (!match) {
|
|
110
|
+
// 尝试直接解析(可能是其他 ISO 8601 格式)
|
|
111
|
+
const date = new Date(trimmed);
|
|
112
|
+
if (isNaN(date.getTime()))
|
|
113
|
+
return null;
|
|
114
|
+
return Math.floor(date.getTime() / 1000).toString();
|
|
115
|
+
}
|
|
116
|
+
const [, year, month, day, hour, minute, second] = match;
|
|
117
|
+
// 当作北京时间(UTC+8),转换为 UTC
|
|
118
|
+
const utcDate = new Date(Date.UTC(parseInt(year), parseInt(month) - 1, parseInt(day), parseInt(hour) - 8, // 北京时间减去 8 小时得到 UTC
|
|
119
|
+
parseInt(minute), parseInt(second ?? '0')));
|
|
120
|
+
return Math.floor(utcDate.getTime() / 1000).toString();
|
|
121
|
+
}
|
|
122
|
+
catch {
|
|
123
|
+
return null;
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* 解析时间字符串为 Unix 时间戳(毫秒)
|
|
128
|
+
*
|
|
129
|
+
* 支持多种格式:
|
|
130
|
+
* 1. ISO 8601 / RFC 3339(带时区):"2024-01-01T00:00:00+08:00"
|
|
131
|
+
* 2. 不带时区的格式(默认为北京时间 UTC+8):
|
|
132
|
+
* - "2026-02-25 14:30"
|
|
133
|
+
* - "2026-02-25 14:30:00"
|
|
134
|
+
* - "2026-02-25T14:30:00"
|
|
135
|
+
*
|
|
136
|
+
* @param input - 时间字符串
|
|
137
|
+
* @returns Unix 时间戳字符串(毫秒),解析失败返回 null
|
|
138
|
+
*
|
|
139
|
+
* @example
|
|
140
|
+
* ```typescript
|
|
141
|
+
* parseTimeToTimestampMs("2026-02-25T14:30:00+08:00") // => "1740459000000"
|
|
142
|
+
* parseTimeToTimestampMs("2026-02-25 14:30") // => "1740459000000" (默认北京时间)
|
|
143
|
+
* parseTimeToTimestampMs("2026-02-25T14:30:00") // => "1740459000000" (默认北京时间)
|
|
144
|
+
* parseTimeToTimestampMs("invalid") // => null
|
|
145
|
+
* ```
|
|
146
|
+
*/
|
|
147
|
+
export function parseTimeToTimestampMs(input) {
|
|
148
|
+
try {
|
|
149
|
+
const trimmed = input.trim();
|
|
150
|
+
// 检查是否包含时区信息(Z 或 +/- 偏移)
|
|
151
|
+
const hasTimezone = /[Zz]$|[+-]\d{2}:\d{2}$/.test(trimmed);
|
|
152
|
+
if (hasTimezone) {
|
|
153
|
+
// 有时区信息,直接解析
|
|
154
|
+
const date = new Date(trimmed);
|
|
155
|
+
if (isNaN(date.getTime()))
|
|
156
|
+
return null;
|
|
157
|
+
return date.getTime().toString();
|
|
158
|
+
}
|
|
159
|
+
// 没有时区信息,当作北京时间处理
|
|
160
|
+
// 支持格式:YYYY-MM-DD HH:mm 或 YYYY-MM-DD HH:mm:ss 或 YYYY-MM-DDTHH:mm:ss
|
|
161
|
+
const normalized = trimmed.replace('T', ' ');
|
|
162
|
+
const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})(?::(\d{2}))?$/);
|
|
163
|
+
if (!match) {
|
|
164
|
+
// 尝试直接解析(可能是其他 ISO 8601 格式)
|
|
165
|
+
const date = new Date(trimmed);
|
|
166
|
+
if (isNaN(date.getTime()))
|
|
167
|
+
return null;
|
|
168
|
+
return date.getTime().toString();
|
|
169
|
+
}
|
|
170
|
+
const [, year, month, day, hour, minute, second] = match;
|
|
171
|
+
// 当作北京时间(UTC+8),转换为 UTC
|
|
172
|
+
const utcDate = new Date(Date.UTC(parseInt(year), parseInt(month) - 1, parseInt(day), parseInt(hour) - 8, // 北京时间减去 8 小时得到 UTC
|
|
173
|
+
parseInt(minute), parseInt(second ?? '0')));
|
|
174
|
+
return utcDate.getTime().toString();
|
|
175
|
+
}
|
|
176
|
+
catch {
|
|
177
|
+
return null;
|
|
178
|
+
}
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* 解析时间字符串为 RFC 3339 格式(用于 freebusy API)
|
|
182
|
+
*
|
|
183
|
+
* 支持多种格式:
|
|
184
|
+
* 1. ISO 8601 / RFC 3339(带时区):"2024-01-01T00:00:00+08:00" - 直接返回
|
|
185
|
+
* 2. 不带时区的格式(默认为北京时间 UTC+8):
|
|
186
|
+
* - "2026-02-25 14:30" - 转换为 "2026-02-25T14:30:00+08:00"
|
|
187
|
+
* - "2026-02-25 14:30:00" - 转换为 "2026-02-25T14:30:00+08:00"
|
|
188
|
+
* - "2026-02-25T14:30:00" - 转换为 "2026-02-25T14:30:00+08:00"
|
|
189
|
+
*
|
|
190
|
+
* @param input - 时间字符串
|
|
191
|
+
* @returns RFC 3339 格式的时间字符串,解析失败返回 null
|
|
192
|
+
*
|
|
193
|
+
* @example
|
|
194
|
+
* ```typescript
|
|
195
|
+
* parseTimeToRFC3339("2026-02-25T14:30:00+08:00") // => "2026-02-25T14:30:00+08:00"
|
|
196
|
+
* parseTimeToRFC3339("2026-02-25 14:30") // => "2026-02-25T14:30:00+08:00"
|
|
197
|
+
* parseTimeToRFC3339("2026-02-25T14:30:00") // => "2026-02-25T14:30:00+08:00"
|
|
198
|
+
* ```
|
|
199
|
+
*/
|
|
200
|
+
export function parseTimeToRFC3339(input) {
|
|
201
|
+
try {
|
|
202
|
+
const trimmed = input.trim();
|
|
203
|
+
// 检查是否包含时区信息(Z 或 +/- 偏移)
|
|
204
|
+
const hasTimezone = /[Zz]$|[+-]\d{2}:\d{2}$/.test(trimmed);
|
|
205
|
+
if (hasTimezone) {
|
|
206
|
+
// 有时区信息,验证后直接返回
|
|
207
|
+
const date = new Date(trimmed);
|
|
208
|
+
if (isNaN(date.getTime()))
|
|
209
|
+
return null;
|
|
210
|
+
return trimmed;
|
|
211
|
+
}
|
|
212
|
+
// 没有时区信息,当作北京时间处理,转换为 RFC 3339 格式
|
|
213
|
+
// 支持格式:YYYY-MM-DD HH:mm 或 YYYY-MM-DD HH:mm:ss 或 YYYY-MM-DDTHH:mm:ss
|
|
214
|
+
const normalized = trimmed.replace('T', ' ');
|
|
215
|
+
const match = normalized.match(/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2})(?::(\d{2}))?$/);
|
|
216
|
+
if (!match) {
|
|
217
|
+
// 尝试直接解析(可能是其他 ISO 8601 格式)
|
|
218
|
+
const date = new Date(trimmed);
|
|
219
|
+
if (isNaN(date.getTime()))
|
|
220
|
+
return null;
|
|
221
|
+
// 如果能解析但没有时区,添加 +08:00
|
|
222
|
+
return trimmed.includes('T') ? `${trimmed}+08:00` : trimmed;
|
|
223
|
+
}
|
|
224
|
+
const [, year, month, day, hour, minute, second] = match;
|
|
225
|
+
const sec = second ?? '00';
|
|
226
|
+
// 直接构造 RFC 3339 格式(北京时间 UTC+8)
|
|
227
|
+
return `${year}-${month}-${day}T${hour}:${minute}:${sec}+08:00`;
|
|
228
|
+
}
|
|
229
|
+
catch {
|
|
230
|
+
return null;
|
|
231
|
+
}
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* 转换时间范围对象(用于 search 等 API)
|
|
235
|
+
*
|
|
236
|
+
* 将包含 ISO 8601 格式时间字符串的时间范围转换为时间戳。
|
|
237
|
+
*
|
|
238
|
+
* @param timeRange - 时间范围对象,包含可选的 start 和 end 字段
|
|
239
|
+
* @param unit - 时间戳单位,'s' 为秒,'ms' 为毫秒,默认为 's'
|
|
240
|
+
* @returns 转换后的时间范围对象,包含数字类型的时间戳
|
|
241
|
+
* @throws 如果时间格式错误
|
|
242
|
+
*
|
|
243
|
+
* @example
|
|
244
|
+
* ```typescript
|
|
245
|
+
* convertTimeRange({ start: "2026-02-25T14:00:00+08:00", end: "2026-02-25T18:00:00+08:00" })
|
|
246
|
+
* // => { start: 1740459000, end: 1740473400 }
|
|
247
|
+
*
|
|
248
|
+
* convertTimeRange({ start: "2026-02-25T14:00:00+08:00" }, 'ms')
|
|
249
|
+
* // => { start: 1740459000000 }
|
|
250
|
+
* ```
|
|
251
|
+
*/
|
|
252
|
+
export function convertTimeRange(timeRange, unit = 's') {
|
|
253
|
+
if (!timeRange)
|
|
254
|
+
return undefined;
|
|
255
|
+
const result = {};
|
|
256
|
+
const parseFn = unit === 'ms' ? parseTimeToTimestampMs : parseTimeToTimestamp;
|
|
257
|
+
if (timeRange.start) {
|
|
258
|
+
const ts = parseFn(timeRange.start);
|
|
259
|
+
if (!ts) {
|
|
260
|
+
throw new Error(`Invalid time format for start. Must use ISO 8601 / RFC 3339 with timezone, e.g. "2024-01-01T00:00:00+08:00". Received: ${timeRange.start}`);
|
|
261
|
+
}
|
|
262
|
+
result.start = parseInt(ts, 10);
|
|
263
|
+
}
|
|
264
|
+
if (timeRange.end) {
|
|
265
|
+
const ts = parseFn(timeRange.end);
|
|
266
|
+
if (!ts) {
|
|
267
|
+
throw new Error(`Invalid time format for end. Must use ISO 8601 / RFC 3339 with timezone, e.g. "2024-01-01T00:00:00+08:00". Received: ${timeRange.end}`);
|
|
268
|
+
}
|
|
269
|
+
result.end = parseInt(ts, 10);
|
|
270
|
+
}
|
|
271
|
+
return Object.keys(result).length > 0 ? result : undefined;
|
|
272
|
+
}
|
|
273
|
+
// ---------------------------------------------------------------------------
|
|
274
|
+
// OAPI 专用:Unix 时间戳 → ISO 8601 (上海时区)
|
|
275
|
+
// ---------------------------------------------------------------------------
|
|
276
|
+
export const SHANGHAI_UTC_OFFSET_HOURS = 8;
|
|
277
|
+
export const SHANGHAI_OFFSET_SUFFIX = '+08:00';
|
|
278
|
+
export function pad2(value) {
|
|
279
|
+
return String(value).padStart(2, '0');
|
|
280
|
+
}
|
|
281
|
+
/**
|
|
282
|
+
* Convert a Unix timestamp (seconds or milliseconds) to ISO 8601 string
|
|
283
|
+
* in the Asia/Shanghai timezone.
|
|
284
|
+
*
|
|
285
|
+
* Auto-detects seconds vs milliseconds based on magnitude.
|
|
286
|
+
*
|
|
287
|
+
* @returns e.g. `"2026-02-25T14:30:00+08:00"`, or `null` on invalid input
|
|
288
|
+
*/
|
|
289
|
+
export function unixTimestampToISO8601(raw) {
|
|
290
|
+
if (raw === undefined || raw === null)
|
|
291
|
+
return null;
|
|
292
|
+
const text = typeof raw === 'number' ? String(raw) : String(raw).trim();
|
|
293
|
+
if (!/^-?\d+$/.test(text))
|
|
294
|
+
return null;
|
|
295
|
+
const num = Number(text);
|
|
296
|
+
if (!Number.isFinite(num))
|
|
297
|
+
return null;
|
|
298
|
+
const utcMs = Math.abs(num) >= 1e12 ? num : num * 1000;
|
|
299
|
+
const beijingDate = new Date(utcMs + SHANGHAI_UTC_OFFSET_HOURS * 60 * 60 * 1000);
|
|
300
|
+
if (Number.isNaN(beijingDate.getTime()))
|
|
301
|
+
return null;
|
|
302
|
+
const year = beijingDate.getUTCFullYear();
|
|
303
|
+
const month = pad2(beijingDate.getUTCMonth() + 1);
|
|
304
|
+
const day = pad2(beijingDate.getUTCDate());
|
|
305
|
+
const hour = pad2(beijingDate.getUTCHours());
|
|
306
|
+
const minute = pad2(beijingDate.getUTCMinutes());
|
|
307
|
+
const second = pad2(beijingDate.getUTCSeconds());
|
|
308
|
+
return `${year}-${month}-${day}T${hour}:${minute}:${second}${SHANGHAI_OFFSET_SUFFIX}`;
|
|
309
|
+
}
|
|
310
|
+
// ---------------------------------------------------------------------------
|
|
311
|
+
// OAPI 专用:飞书 API 错误处理
|
|
312
|
+
// ---------------------------------------------------------------------------
|
|
313
|
+
/**
|
|
314
|
+
* Re-export 飞书 API 错误处理函数
|
|
315
|
+
*
|
|
316
|
+
* 这些函数专门用于处理飞书 Open API 的响应和错误。
|
|
317
|
+
*/
|
|
318
|
+
export { assertLarkOk, formatLarkError } from '../../core/api-error';
|
|
319
|
+
// ---------------------------------------------------------------------------
|
|
320
|
+
// OAPI 专用:invoke() 错误判断
|
|
321
|
+
// ---------------------------------------------------------------------------
|
|
322
|
+
import { AppScopeMissingError, UserAuthRequiredError, UserScopeInsufficientError } from '../../core/tool-client';
|
|
323
|
+
/**
|
|
324
|
+
* Check whether an error is a structured invoke-level auth/permission error.
|
|
325
|
+
*
|
|
326
|
+
* Useful in intermediate catch blocks that need to let auth errors bubble up
|
|
327
|
+
* to the outer `handleInvokeErrorWithAutoAuth`.
|
|
328
|
+
*
|
|
329
|
+
* For "allow-to-fail" sub-operations, prefer `client.tryInvoke()` over
|
|
330
|
+
* manual `isInvokeError` + throw.
|
|
331
|
+
*/
|
|
332
|
+
export function isInvokeError(err) {
|
|
333
|
+
return (err instanceof UserAuthRequiredError ||
|
|
334
|
+
err instanceof AppScopeMissingError ||
|
|
335
|
+
err instanceof UserScopeInsufficientError);
|
|
336
|
+
}
|
|
337
|
+
// ---------------------------------------------------------------------------
|
|
338
|
+
// 自动授权:handleInvokeErrorWithAutoAuth
|
|
339
|
+
// ---------------------------------------------------------------------------
|
|
340
|
+
export { handleInvokeErrorWithAutoAuth } from '../auto-auth';
|
|
341
|
+
//# sourceMappingURL=helpers.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../src/tools/oapi/helpers.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
|
|
3
|
+
* SPDX-License-Identifier: MIT
|
|
4
|
+
*
|
|
5
|
+
* 消息格式化公共函数
|
|
6
|
+
*
|
|
7
|
+
* 将飞书 IM API 返回的原始消息对象转换为 AI 可读的 JSON 格式。
|
|
8
|
+
* 由 feishu_im_user_get_messages 和 feishu_im_user_get_thread_messages 共享。
|
|
9
|
+
*
|
|
10
|
+
* 所有 API 调用均通过 UAT(用户身份)进行。
|
|
11
|
+
*/
|
|
12
|
+
import type { LarkAccount } from '../../../core/types';
|
|
13
|
+
import type { ToolClient } from '../../../core/tool-client';
|
|
14
|
+
import type { ApiMessageItem } from '../../../messaging/converters/types';
|
|
15
|
+
export interface FormattedMessage {
|
|
16
|
+
message_id: string;
|
|
17
|
+
msg_type: string;
|
|
18
|
+
content: string;
|
|
19
|
+
sender: {
|
|
20
|
+
id: string;
|
|
21
|
+
sender_type: string;
|
|
22
|
+
name?: string;
|
|
23
|
+
};
|
|
24
|
+
create_time: string;
|
|
25
|
+
/** 回复的消息 ID(parent_id)。有 thread_id 时省略,因为话题上下文可推断 */
|
|
26
|
+
reply_to?: string;
|
|
27
|
+
thread_id?: string;
|
|
28
|
+
mentions?: Array<{
|
|
29
|
+
key: string;
|
|
30
|
+
id: string;
|
|
31
|
+
name: string;
|
|
32
|
+
}>;
|
|
33
|
+
deleted: boolean;
|
|
34
|
+
updated: boolean;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* 格式化单条消息对象。
|
|
38
|
+
*
|
|
39
|
+
* 使用 convertMessageContent 将 body.content 转为 AI 可读文本,
|
|
40
|
+
* 并过滤掉 AI 不需要的字段(upper_message_id、tenant_key 等)。
|
|
41
|
+
*/
|
|
42
|
+
export declare function formatMessageItem(item: ApiMessageItem, accountId: string, nameResolver: (openId: string) => string | undefined, ctxOverrides?: Partial<import('../../../messaging/converters/types.js').ConvertContext>): Promise<FormattedMessage>;
|
|
43
|
+
/**
|
|
44
|
+
* 批量格式化消息列表(UAT 路径)。
|
|
45
|
+
*
|
|
46
|
+
* 先批量解析所有 sender 的名字(写入 UAT 缓存),再逐条格式化。
|
|
47
|
+
* 这样 formatMessageItem 中的 sender.name 和 converter 的
|
|
48
|
+
* resolveUserName 都能从 UAT 缓存中读到名字。
|
|
49
|
+
*/
|
|
50
|
+
export declare function formatMessageList(items: ApiMessageItem[], account: LarkAccount, log: (...args: unknown[]) => void, client: ToolClient): Promise<FormattedMessage[]>;
|
|
51
|
+
//# sourceMappingURL=format-messages.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"format-messages.d.ts","sourceRoot":"","sources":["../../../../../src/tools/oapi/im/format-messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAgB1E,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AA6BD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EACpD,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,wCAAwC,EAAE,cAAc,CAAC,GACtF,OAAO,CAAC,gBAAgB,CAAC,CA8E3B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EACjC,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiD7B"}
|