@h-ai/tools 0.0.0-stage → 1.0.0-beta.31

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.
Files changed (49) hide show
  1. package/LICENSE +202 -0
  2. package/README.en.md +37 -0
  3. package/README.ja.md +37 -0
  4. package/README.md +36 -2
  5. package/dist/chunk-UA7MOYTT.js +413 -0
  6. package/dist/chunk-UA7MOYTT.js.map +1 -0
  7. package/dist/index.d.ts +16 -0
  8. package/dist/index.js +3 -0
  9. package/dist/index.js.map +1 -0
  10. package/dist/server/index.d.ts +306 -0
  11. package/dist/server/index.js +1051 -0
  12. package/dist/server/index.js.map +1 -0
  13. package/dist/tools-types-CM0lGuJr.d.ts +199 -0
  14. package/jobs/.dockerignore +4 -0
  15. package/jobs/README.md +223 -0
  16. package/jobs/archives.py +56 -0
  17. package/jobs/browser/Dockerfile +20 -0
  18. package/jobs/browser/operation.py +17 -0
  19. package/jobs/browser/render.mjs +90 -0
  20. package/jobs/browser_policy.py +36 -0
  21. package/jobs/documents/Dockerfile +23 -0
  22. package/jobs/documents/generate.py +165 -0
  23. package/jobs/documents/operation.py +84 -0
  24. package/jobs/documents/requirements.txt +3 -0
  25. package/jobs/hyperframes-runtime.mjs +73 -0
  26. package/jobs/media_files.py +78 -0
  27. package/jobs/ocr/Dockerfile +19 -0
  28. package/jobs/ocr/operation.py +18 -0
  29. package/jobs/office/Dockerfile +21 -0
  30. package/jobs/office/office_job.py +65 -0
  31. package/jobs/office/operation.py +43 -0
  32. package/jobs/preview_build/Dockerfile +19 -0
  33. package/jobs/preview_build/build.mjs +552 -0
  34. package/jobs/preview_build/operation.py +62 -0
  35. package/jobs/preview_build/package.json +11 -0
  36. package/jobs/tests/image-smoke.mjs +83 -0
  37. package/jobs/tests/requirements.txt +4 -0
  38. package/jobs/tests/test_documents_generate.py +107 -0
  39. package/jobs/tests/test_hai_tool.py +82 -0
  40. package/jobs/tests/test_media_jobs.py +449 -0
  41. package/jobs/tests/test_preview_build.py +213 -0
  42. package/jobs/tool.py +145 -0
  43. package/jobs/video_render/Dockerfile +20 -0
  44. package/jobs/video_render/operation.py +109 -0
  45. package/jobs/video_render/render.mjs +36 -0
  46. package/jobs/web_capture/Dockerfile +20 -0
  47. package/jobs/web_capture/capture.mjs +122 -0
  48. package/jobs/web_capture/operation.py +65 -0
  49. package/package.json +62 -3
@@ -0,0 +1,413 @@
1
+ import { core, ok, err } from '@h-ai/core';
2
+ import { z } from 'zod';
3
+
4
+ // src/tools-types.ts
5
+ var HaiToolsError = core.error.buildHaiErrorsDef("tools", {
6
+ NOT_FOUND: "020:404",
7
+ ALREADY_REGISTERED: "021:409",
8
+ VALIDATION_FAILED: "022:400",
9
+ EXECUTION_FAILED: "023:500",
10
+ FORBIDDEN: "024:403",
11
+ TIMEOUT: "025:504",
12
+ CANCELLED: "026:499"
13
+ });
14
+
15
+ // messages/en-US.json
16
+ var en_US_default = {
17
+ tools_notFound: "Tool is unavailable or disabled",
18
+ tools_alreadyRegistered: "Tool name is already registered",
19
+ tools_validationFailed: "Tool input is invalid",
20
+ tools_executionFailed: "Tool execution failed",
21
+ tools_sandboxUnavailable: "The execution environment cannot enable the browser sandbox. Ask an administrator to check its configuration.",
22
+ tools_previewUnsupported: "The project contains an unsupported dependency, resource or browser feature. Use local HTML/JS/CSS or supported Svelte components; see the project preview guide.",
23
+ tools_outputLimit: "The generated content exceeds the size limit. Reduce its content or assets and try again.",
24
+ tools_unsafeDocument: "The document contains unsupported active content or external references, or exceeds safety limits. Check the file and try again.",
25
+ tools_forbidden: "Tool execution is not authorized",
26
+ tools_timeout: "Tool execution timed out",
27
+ tools_cancelled: "Tool execution was cancelled",
28
+ tools_artifactCreate: "Create artifact",
29
+ tools_artifactCreateDescription: "Create editable Markdown, HTML, table or chart content in your library.",
30
+ tools_artifactRead: "Read artifact",
31
+ tools_artifactReadDescription: "Read the content and version of an existing text artifact.",
32
+ tools_artifactSave: "Save artifact",
33
+ tools_artifactSaveDescription: "Save against the version you read; concurrent edits cause a conflict.",
34
+ tools_dataAnalyze: "Analyze data",
35
+ tools_dataAnalyzeDescription: "Calculate numeric summaries and create editable table and chart artifacts.",
36
+ tools_documents: "Documents",
37
+ tools_job_documents_extract: "Extract document text",
38
+ tools_job_documents_generate: "Generate Office documents",
39
+ tools_job_office_convert: "Convert to PDF",
40
+ tools_job_office_recalculate: "Recalculate spreadsheet",
41
+ tools_job_ocr_recognize: "Recognize image text",
42
+ tools_job_browser_navigate: "Capture website screenshot",
43
+ tools_job_web_capture: "Capture website content and assets",
44
+ tools_job_preview_build: "Build a web project preview",
45
+ tools_job_video_render: "Render video project",
46
+ tools_field_title: "Title",
47
+ tools_field_kind: "Artifact type",
48
+ tools_field_content: "Content",
49
+ tools_field_id: "Existing artifact",
50
+ tools_field_baseVersion: "Base version",
51
+ tools_field_x: "Category field",
52
+ tools_field_y: "Numeric field",
53
+ tools_field_rows: "Data rows",
54
+ tools_field_chartType: "Chart type",
55
+ tools_field_format: "File format",
56
+ tools_field_paragraphs: "Paragraphs",
57
+ tools_field_headers: "Column headings",
58
+ tools_field_table: "Table",
59
+ tools_field_slides: "Slides",
60
+ tools_field_fileId: "Input file",
61
+ tools_field_url: "Website URL",
62
+ tools_field_maxScreenshots: "Screenshot count",
63
+ tools_field_fps: "Frames per second",
64
+ tools_field_language: "Recognition language",
65
+ tools_example_markdown: "Markdown note",
66
+ tools_example_noteTitle: "Project note",
67
+ tools_example_noteContent: "# Project note\n\nWrite your first draft here.",
68
+ tools_example_sales: "Monthly sales",
69
+ tools_example_report: "Quarterly report",
70
+ tools_example_reportContent: "A summary of this quarter.",
71
+ tools_documentLimits: "The UTF-8 JSON specification must fit within 256 KiB. PPTX slides allow up to 6 paragraphs of 160 characters (800 total), or a table of 6 columns and 6 data rows with cells up to 32 characters and one paragraph up to 120 characters. Slides cannot be combined with top-level content."
72
+ };
73
+
74
+ // messages/ja-JP.json
75
+ var ja_JP_default = {
76
+ tools_notFound: "\u30C4\u30FC\u30EB\u304C\u5B58\u5728\u3057\u306A\u3044\u304B\u7121\u52B9\u3067\u3059",
77
+ tools_alreadyRegistered: "\u30C4\u30FC\u30EB\u540D\u306F\u767B\u9332\u6E08\u307F\u3067\u3059",
78
+ tools_validationFailed: "\u30C4\u30FC\u30EB\u306E\u5165\u529B\u304C\u7121\u52B9\u3067\u3059",
79
+ tools_executionFailed: "\u30C4\u30FC\u30EB\u306E\u5B9F\u884C\u306B\u5931\u6557\u3057\u307E\u3057\u305F",
80
+ tools_sandboxUnavailable: "\u5B9F\u884C\u74B0\u5883\u3067\u30D6\u30E9\u30A6\u30B6\u30FC\u306E\u30B5\u30F3\u30C9\u30DC\u30C3\u30AF\u30B9\u3092\u6709\u52B9\u306B\u3067\u304D\u307E\u305B\u3093\u3002\u7BA1\u7406\u8005\u306B\u74B0\u5883\u8A2D\u5B9A\u306E\u78BA\u8A8D\u3092\u4F9D\u983C\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
81
+ tools_previewUnsupported: "\u5BFE\u5FDC\u3057\u3066\u3044\u306A\u3044\u4F9D\u5B58\u95A2\u4FC2\u3001\u7D20\u6750\u3001\u30D6\u30E9\u30A6\u30B6\u30FC\u6A5F\u80FD\u304C\u542B\u307E\u308C\u3066\u3044\u307E\u3059\u3002\u30ED\u30FC\u30AB\u30EB\u306E HTML/JS/CSS \u307E\u305F\u306F\u5BFE\u5FDC\u3059\u308B Svelte \u30B3\u30F3\u30DD\u30FC\u30CD\u30F3\u30C8\u3092\u4F7F\u7528\u3057\u3001\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u30D7\u30EC\u30D3\u30E5\u30FC\u306E\u8AAC\u660E\u3092\u78BA\u8A8D\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
82
+ tools_outputLimit: "\u751F\u6210\u5185\u5BB9\u304C\u30B5\u30A4\u30BA\u5236\u9650\u3092\u8D85\u3048\u3066\u3044\u307E\u3059\u3002\u5185\u5BB9\u3084\u7D20\u6750\u3092\u6E1B\u3089\u3057\u3066\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
83
+ tools_unsafeDocument: "\u6587\u66F8\u306B\u672A\u5BFE\u5FDC\u306E\u30A2\u30AF\u30C6\u30A3\u30D6\u30B3\u30F3\u30C6\u30F3\u30C4\u3084\u5916\u90E8\u53C2\u7167\u304C\u542B\u307E\u308C\u3066\u3044\u308B\u304B\u3001\u5B89\u5168\u4E0A\u306E\u5236\u9650\u3092\u8D85\u3048\u3066\u3044\u307E\u3059\u3002\u30D5\u30A1\u30A4\u30EB\u3092\u78BA\u8A8D\u3057\u3066\u518D\u8A66\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
84
+ tools_forbidden: "\u3053\u306E\u30C4\u30FC\u30EB\u3092\u5B9F\u884C\u3059\u308B\u6A29\u9650\u304C\u3042\u308A\u307E\u305B\u3093",
85
+ tools_timeout: "\u30C4\u30FC\u30EB\u306E\u5B9F\u884C\u304C\u30BF\u30A4\u30E0\u30A2\u30A6\u30C8\u3057\u307E\u3057\u305F",
86
+ tools_cancelled: "\u30C4\u30FC\u30EB\u306E\u5B9F\u884C\u3092\u30AD\u30E3\u30F3\u30BB\u30EB\u3057\u307E\u3057\u305F",
87
+ tools_artifactCreate: "\u6210\u679C\u7269\u3092\u4F5C\u6210",
88
+ tools_artifactCreateDescription: "\u7DE8\u96C6\u53EF\u80FD\u306A Markdown\u3001HTML\u3001\u8868\u3001\u30B0\u30E9\u30D5\u3092\u30E9\u30A4\u30D6\u30E9\u30EA\u306B\u4FDD\u5B58\u3057\u307E\u3059\u3002",
89
+ tools_artifactRead: "\u6210\u679C\u7269\u3092\u8AAD\u3080",
90
+ tools_artifactReadDescription: "\u65E2\u5B58\u306E\u30C6\u30AD\u30B9\u30C8\u6210\u679C\u7269\u306E\u5185\u5BB9\u3068\u30D0\u30FC\u30B8\u30E7\u30F3\u3092\u8AAD\u307F\u307E\u3059\u3002",
91
+ tools_artifactSave: "\u6210\u679C\u7269\u3092\u4FDD\u5B58",
92
+ tools_artifactSaveDescription: "\u8AAD\u307F\u53D6\u3063\u305F\u30D0\u30FC\u30B8\u30E7\u30F3\u306B\u57FA\u3065\u304D\u4FDD\u5B58\u3057\u307E\u3059\u3002\u540C\u6642\u7DE8\u96C6\u306F\u7AF6\u5408\u3068\u3057\u3066\u6271\u3044\u307E\u3059\u3002",
93
+ tools_dataAnalyze: "\u30C7\u30FC\u30BF\u5206\u6790",
94
+ tools_dataAnalyzeDescription: "\u6570\u5024\u3092\u96C6\u8A08\u3057\u3001\u7DE8\u96C6\u53EF\u80FD\u306A\u8868\u3068\u30B0\u30E9\u30D5\u3092\u4F5C\u6210\u3057\u307E\u3059\u3002",
95
+ tools_documents: "\u6587\u66F8",
96
+ tools_job_documents_extract: "\u6587\u66F8\u306E\u30C6\u30AD\u30B9\u30C8\u62BD\u51FA",
97
+ tools_job_documents_generate: "Office\u6587\u66F8\u3092\u751F\u6210",
98
+ tools_job_office_convert: "PDF\u306B\u5909\u63DB",
99
+ tools_job_office_recalculate: "\u8868\u8A08\u7B97\u3092\u518D\u8A08\u7B97",
100
+ tools_job_ocr_recognize: "\u753B\u50CF\u306E\u6587\u5B57\u8A8D\u8B58",
101
+ tools_job_browser_navigate: "\u30A6\u30A7\u30D6\u753B\u9762\u3092\u64AE\u5F71",
102
+ tools_job_web_capture: "\u30A6\u30A7\u30D6\u5185\u5BB9\u3068\u7D20\u6750\u3092\u53CE\u96C6",
103
+ tools_job_preview_build: "\u30A6\u30A7\u30D6\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u306E\u30D7\u30EC\u30D3\u30E5\u30FC\u3092\u30D3\u30EB\u30C9",
104
+ tools_job_video_render: "\u52D5\u753B\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u3092\u30EC\u30F3\u30C0\u30EA\u30F3\u30B0",
105
+ tools_field_title: "\u30BF\u30A4\u30C8\u30EB",
106
+ tools_field_kind: "\u6210\u679C\u7269\u306E\u7A2E\u985E",
107
+ tools_field_content: "\u672C\u6587",
108
+ tools_field_id: "\u65E2\u5B58\u306E\u6210\u679C\u7269",
109
+ tools_field_baseVersion: "\u57FA\u6E96\u30D0\u30FC\u30B8\u30E7\u30F3",
110
+ tools_field_x: "\u5206\u985E\u9805\u76EE",
111
+ tools_field_y: "\u6570\u5024\u9805\u76EE",
112
+ tools_field_rows: "\u30C7\u30FC\u30BF\u884C",
113
+ tools_field_chartType: "\u30B0\u30E9\u30D5\u306E\u7A2E\u985E",
114
+ tools_field_format: "\u30D5\u30A1\u30A4\u30EB\u5F62\u5F0F",
115
+ tools_field_paragraphs: "\u6BB5\u843D",
116
+ tools_field_headers: "\u5217\u306E\u898B\u51FA\u3057",
117
+ tools_field_table: "\u8868",
118
+ tools_field_slides: "\u30B9\u30E9\u30A4\u30C9",
119
+ tools_field_fileId: "\u5165\u529B\u30D5\u30A1\u30A4\u30EB",
120
+ tools_field_url: "\u30A6\u30A7\u30D6URL",
121
+ tools_field_maxScreenshots: "\u753B\u9762\u6570",
122
+ tools_field_fps: "\u30D5\u30EC\u30FC\u30E0\u30EC\u30FC\u30C8",
123
+ tools_field_language: "\u8A8D\u8B58\u8A00\u8A9E",
124
+ tools_example_markdown: "Markdown \u30CE\u30FC\u30C8",
125
+ tools_example_noteTitle: "\u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u30CE\u30FC\u30C8",
126
+ tools_example_noteContent: "# \u30D7\u30ED\u30B8\u30A7\u30AF\u30C8\u30CE\u30FC\u30C8\n\n\u6700\u521D\u306E\u4E0B\u66F8\u304D\u3092\u3053\u3053\u306B\u5165\u529B\u3057\u307E\u3059\u3002",
127
+ tools_example_sales: "\u6708\u5225\u58F2\u4E0A",
128
+ tools_example_report: "\u56DB\u534A\u671F\u30EC\u30DD\u30FC\u30C8",
129
+ tools_example_reportContent: "\u4ECA\u56DB\u534A\u671F\u306E\u6982\u8981\u3002",
130
+ tools_documentLimits: "UTF-8 JSON \u306F 256 KiB \u4EE5\u4E0B\u3067\u3059\u3002PPTX \u306F\u5404\u30DA\u30FC\u30B86\u6BB5\u843D\u30FB\u5404160\u6587\u5B57\u30FB\u5408\u8A08800\u6587\u5B57\u307E\u3067\u3002\u8868\u3092\u542B\u3080\u5834\u5408\u306F6\u5217\u30FB6\u30C7\u30FC\u30BF\u884C\u30FB\u30BB\u30EB32\u6587\u5B57\u307E\u3067\u3067\u3001\u672C\u6587\u306F120\u6587\u5B57\u4EE5\u4E0B\u306E1\u6BB5\u843D\u306E\u307F\u3067\u3059\u3002slides \u3068\u6700\u4E0A\u4F4D\u306E\u672C\u6587\u30FB\u8868\u306F\u4F75\u7528\u3067\u304D\u307E\u305B\u3093\u3002"
131
+ };
132
+
133
+ // messages/zh-CN.json
134
+ var zh_CN_default = {
135
+ tools_notFound: "\u5DE5\u5177\u4E0D\u5B58\u5728\u6216\u672A\u542F\u7528",
136
+ tools_alreadyRegistered: "\u5DE5\u5177\u540D\u79F0\u5DF2\u6CE8\u518C",
137
+ tools_validationFailed: "\u5DE5\u5177\u53C2\u6570\u65E0\u6548",
138
+ tools_executionFailed: "\u5DE5\u5177\u6267\u884C\u5931\u8D25",
139
+ tools_sandboxUnavailable: "\u5F53\u524D\u6267\u884C\u73AF\u5883\u65E0\u6CD5\u542F\u7528\u6D4F\u89C8\u5668\u6C99\u7BB1\uFF0C\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u68C0\u67E5\u73AF\u5883\u914D\u7F6E\u3002",
140
+ tools_previewUnsupported: "\u9879\u76EE\u5305\u542B\u4E0D\u652F\u6301\u7684\u4F9D\u8D56\u3001\u8D44\u6E90\u6216\u6D4F\u89C8\u5668\u7279\u6027\u3002\u8BF7\u4F7F\u7528\u672C\u5730 HTML/JS/CSS \u6216\u53D7\u652F\u6301\u7684 Svelte \u7EC4\u4EF6\uFF0C\u53C2\u9605\u9879\u76EE\u9884\u89C8\u8BF4\u660E\u3002",
141
+ tools_outputLimit: "\u751F\u6210\u7684\u5185\u5BB9\u8D85\u8FC7\u5927\u5C0F\u9650\u5236\uFF0C\u8BF7\u51CF\u5C11\u5185\u5BB9\u6216\u7D20\u6750\u540E\u91CD\u8BD5\u3002",
142
+ tools_unsafeDocument: "\u6587\u6863\u5305\u542B\u4E0D\u53D7\u652F\u6301\u7684\u4E3B\u52A8\u5185\u5BB9\u3001\u5916\u90E8\u5F15\u7528\u6216\u8D85\u51FA\u5B89\u5168\u9650\u5236\uFF0C\u8BF7\u68C0\u67E5\u6587\u4EF6\u540E\u91CD\u8BD5\u3002",
143
+ tools_forbidden: "\u65E0\u6743\u6267\u884C\u6B64\u5DE5\u5177",
144
+ tools_timeout: "\u5DE5\u5177\u6267\u884C\u8D85\u65F6",
145
+ tools_cancelled: "\u5DE5\u5177\u6267\u884C\u5DF2\u53D6\u6D88",
146
+ tools_artifactCreate: "\u521B\u5EFA\u6210\u679C",
147
+ tools_artifactCreateDescription: "\u751F\u6210\u53EF\u7F16\u8F91\u7684 Markdown\u3001\u7F51\u9875\u3001\u8868\u683C\u6216\u56FE\u8868\uFF0C\u5E76\u4FDD\u5B58\u5230\u5F53\u524D\u7528\u6237\u7684\u8D44\u6599\u5E93\u3002",
148
+ tools_artifactRead: "\u8BFB\u53D6\u6210\u679C",
149
+ tools_artifactReadDescription: "\u8BFB\u53D6\u5DF2\u6709\u6587\u672C\u6210\u679C\u7684\u5185\u5BB9\u548C\u7248\u672C\u3002",
150
+ tools_artifactSave: "\u4FDD\u5B58\u6210\u679C",
151
+ tools_artifactSaveDescription: "\u6309\u8BFB\u53D6\u65F6\u7684\u7248\u672C\u4FDD\u5B58\u4FEE\u6539\uFF1B\u7248\u672C\u51B2\u7A81\u65F6\u4FDD\u7559\u5F53\u524D\u5185\u5BB9\u3002",
152
+ tools_dataAnalyze: "\u6570\u636E\u5206\u6790",
153
+ tools_dataAnalyzeDescription: "\u8BA1\u7B97\u6570\u5B57\u6C47\u603B\uFF0C\u5E76\u751F\u6210\u53EF\u4EE5\u7F16\u8F91\u7684\u8868\u683C\u53CA\u56FE\u8868\u3002",
154
+ tools_documents: "\u6587\u6863",
155
+ tools_job_documents_extract: "\u63D0\u53D6\u6587\u6863\u6587\u5B57",
156
+ tools_job_documents_generate: "\u751F\u6210 Office \u6587\u6863",
157
+ tools_job_office_convert: "\u8F6C\u6362\u4E3A PDF",
158
+ tools_job_office_recalculate: "\u91CD\u65B0\u8BA1\u7B97\u8868\u683C",
159
+ tools_job_ocr_recognize: "\u8BC6\u522B\u56FE\u7247\u6587\u5B57",
160
+ tools_job_browser_navigate: "\u7F51\u9875\u622A\u56FE",
161
+ tools_job_web_capture: "\u91C7\u96C6\u7F51\u9875\u5185\u5BB9\u4E0E\u7D20\u6750",
162
+ tools_job_preview_build: "\u6784\u5EFA\u7F51\u9875\u9879\u76EE\u9884\u89C8",
163
+ tools_job_video_render: "\u6E32\u67D3\u89C6\u9891\u9879\u76EE",
164
+ tools_field_title: "\u6807\u9898",
165
+ tools_field_kind: "\u6210\u679C\u7C7B\u578B",
166
+ tools_field_content: "\u6B63\u6587",
167
+ tools_field_id: "\u5DF2\u6709\u6210\u679C",
168
+ tools_field_baseVersion: "\u57FA\u51C6\u7248\u672C",
169
+ tools_field_x: "\u5206\u7C7B\u5B57\u6BB5",
170
+ tools_field_y: "\u6570\u503C\u5B57\u6BB5",
171
+ tools_field_rows: "\u6570\u636E\u884C",
172
+ tools_field_chartType: "\u56FE\u8868\u7C7B\u578B",
173
+ tools_field_format: "\u6587\u4EF6\u683C\u5F0F",
174
+ tools_field_paragraphs: "\u6B63\u6587\u6BB5\u843D",
175
+ tools_field_headers: "\u8868\u5934",
176
+ tools_field_table: "\u8868\u683C",
177
+ tools_field_slides: "\u6F14\u793A\u9875\u9762",
178
+ tools_field_fileId: "\u8F93\u5165\u6587\u4EF6",
179
+ tools_field_url: "\u7F51\u9875\u5730\u5740",
180
+ tools_field_maxScreenshots: "\u622A\u56FE\u6570\u91CF",
181
+ tools_field_fps: "\u6BCF\u79D2\u5E27\u6570",
182
+ tools_field_language: "\u8BC6\u522B\u8BED\u8A00",
183
+ tools_example_markdown: "Markdown \u7B14\u8BB0",
184
+ tools_example_noteTitle: "\u9879\u76EE\u7B14\u8BB0",
185
+ tools_example_noteContent: "# \u9879\u76EE\u7B14\u8BB0\n\n\u5728\u8FD9\u91CC\u5199\u4E0B\u7B2C\u4E00\u7248\u5185\u5BB9\u3002",
186
+ tools_example_sales: "\u6708\u5EA6\u9500\u91CF",
187
+ tools_example_report: "\u5B63\u5EA6\u62A5\u544A",
188
+ tools_example_reportContent: "\u672C\u5B63\u5EA6\u7684\u5DE5\u4F5C\u6458\u8981\u3002",
189
+ tools_documentLimits: "UTF-8 JSON \u8D44\u6599\u4E0D\u5F97\u8D85\u8FC7 256 KiB\u3002PPTX \u6BCF\u9875\u6700\u591A 6 \u6BB5\u3001\u6BCF\u6BB5 160 \u5B57\u4E14\u5408\u8BA1 800 \u5B57\uFF1B\u6709\u8868\u683C\u65F6\u6700\u591A 6 \u5217\u30016 \u884C\u6570\u636E\u3001\u5355\u5143\u683C 32 \u5B57\uFF0C\u5E76\u4EC5\u5141\u8BB8\u4E00\u6BB5\u4E0D\u8D85\u8FC7 120 \u5B57\u7684\u6B63\u6587\u3002slides \u4E0D\u53EF\u4E0E\u9876\u5C42\u6B63\u6587\u6216\u8868\u683C\u6DF7\u7528\u3002"
190
+ };
191
+
192
+ // src/tools-i18n.ts
193
+ var toolsM = core.i18n.createMessageGetter({
194
+ "zh-CN": zh_CN_default,
195
+ "en-US": en_US_default,
196
+ "ja-JP": ja_JP_default
197
+ });
198
+
199
+ // src/tools-functions.ts
200
+ var logger = core.logger.child({ module: "tools" });
201
+ var portableName = /^[a-z][\w-]{0,63}$/i;
202
+ var maxTimeout = 2147483647;
203
+ var definitions = /* @__PURE__ */ new WeakSet();
204
+ function validTimeout(value) {
205
+ return Number.isSafeInteger(value) && value >= 0 && value <= maxTimeout;
206
+ }
207
+ function raceCancellation(run, signal) {
208
+ return new Promise((resolve, reject) => {
209
+ if (signal.aborted) {
210
+ reject(signal.reason);
211
+ return;
212
+ }
213
+ const abort = () => reject(signal.reason);
214
+ signal.addEventListener("abort", abort, { once: true });
215
+ Promise.resolve().then(() => {
216
+ signal.throwIfAborted();
217
+ return run();
218
+ }).then(resolve, reject).finally(() => signal.removeEventListener("abort", abort));
219
+ });
220
+ }
221
+ function joinedAuthorizer(registry, execution) {
222
+ if (!registry)
223
+ return execution;
224
+ if (!execution)
225
+ return registry;
226
+ return async (request) => await registry(request) && await execution(request);
227
+ }
228
+ function defineTool(definition) {
229
+ const { name, description, parameters, handler, resultHandler, timeoutMs = 3e4 } = definition;
230
+ if (!portableName.test(name) || !validTimeout(timeoutMs))
231
+ throw new TypeError("Tool definition requires a portable name and a valid timeout");
232
+ if (typeof handler === "function" === (typeof resultHandler === "function"))
233
+ throw new TypeError("Tool definition requires exactly one handler or resultHandler");
234
+ const tool = {
235
+ name,
236
+ description,
237
+ parameters,
238
+ toDefinition() {
239
+ const { $schema, ...inputSchema } = z.toJSONSchema(parameters, { io: "input" });
240
+ return {
241
+ name,
242
+ description,
243
+ inputSchema,
244
+ ...definition.title ? { title: definition.title } : {},
245
+ ...definition.examples ? { examples: definition.examples } : {}
246
+ };
247
+ },
248
+ async execute(input, options = {}) {
249
+ const duration = options.deadline === void 0 ? options.timeoutMs ?? timeoutMs : Math.max(0, options.deadline - Date.now());
250
+ if (!validTimeout(duration) || options.deadline !== void 0 && !Number.isSafeInteger(options.deadline))
251
+ return err(HaiToolsError.VALIDATION_FAILED, toolsM("tools_validationFailed"));
252
+ if (options.signal?.aborted)
253
+ return err(HaiToolsError.CANCELLED, toolsM("tools_cancelled"), options.signal.reason);
254
+ if (duration === 0)
255
+ return err(HaiToolsError.TIMEOUT, toolsM("tools_timeout"));
256
+ const timeout = new AbortController();
257
+ const timer = setTimeout(() => timeout.abort(new DOMException("Tool deadline exceeded", "TimeoutError")), duration);
258
+ const signal = options.signal ? AbortSignal.any([options.signal, timeout.signal]) : timeout.signal;
259
+ const context = {
260
+ signal,
261
+ objectId: options.objectId,
262
+ sessionId: options.sessionId,
263
+ deadline: options.deadline ?? Date.now() + duration
264
+ };
265
+ const interrupted = (cause) => options.signal?.aborted ? err(HaiToolsError.CANCELLED, toolsM("tools_cancelled"), cause) : err(HaiToolsError.TIMEOUT, toolsM("tools_timeout"), cause);
266
+ const refreshDeadline = () => {
267
+ if (Date.now() >= context.deadline && !timeout.signal.aborted)
268
+ timeout.abort(new DOMException("Tool deadline exceeded", "TimeoutError"));
269
+ };
270
+ const checkActive = () => {
271
+ refreshDeadline();
272
+ signal.throwIfAborted();
273
+ };
274
+ try {
275
+ let parsed;
276
+ try {
277
+ checkActive();
278
+ parsed = await raceCancellation(() => parameters.safeParseAsync(input), signal);
279
+ checkActive();
280
+ } catch (cause) {
281
+ refreshDeadline();
282
+ if (signal.aborted)
283
+ return interrupted(cause);
284
+ logger.debug("Tool validation failed", { tool: name });
285
+ return err(HaiToolsError.VALIDATION_FAILED, toolsM("tools_validationFailed"), cause);
286
+ }
287
+ if (!parsed.success)
288
+ return err(HaiToolsError.VALIDATION_FAILED, toolsM("tools_validationFailed"), parsed.error);
289
+ const authorizer = options.authorize;
290
+ if (authorizer) {
291
+ try {
292
+ checkActive();
293
+ const allowed = await raceCancellation(() => authorizer({ toolName: name, input: parsed.data, context }), signal);
294
+ checkActive();
295
+ if (!allowed)
296
+ return err(HaiToolsError.FORBIDDEN, toolsM("tools_forbidden"));
297
+ } catch (cause) {
298
+ refreshDeadline();
299
+ if (signal.aborted)
300
+ return interrupted(cause);
301
+ logger.debug("Tool authorization failed", { tool: name });
302
+ return err(HaiToolsError.FORBIDDEN, toolsM("tools_forbidden"), cause);
303
+ }
304
+ }
305
+ try {
306
+ checkActive();
307
+ const output = await raceCancellation(() => resultHandler ? resultHandler(parsed.data, context) : Promise.resolve(handler(parsed.data, context)).then(ok), signal);
308
+ checkActive();
309
+ return output;
310
+ } catch (cause) {
311
+ refreshDeadline();
312
+ if (signal.aborted)
313
+ return interrupted(cause);
314
+ logger.warn("Tool execution failed", { tool: name, errorCode: HaiToolsError.EXECUTION_FAILED.code });
315
+ return err(HaiToolsError.EXECUTION_FAILED, toolsM("tools_executionFailed"), cause);
316
+ }
317
+ } finally {
318
+ clearTimeout(timer);
319
+ }
320
+ }
321
+ };
322
+ Object.freeze(tool);
323
+ definitions.add(tool);
324
+ return tool;
325
+ }
326
+ function createToolRegistry(options = {}) {
327
+ const registered = /* @__PURE__ */ new Map();
328
+ const duplicate = () => err(HaiToolsError.ALREADY_REGISTERED, toolsM("tools_alreadyRegistered"));
329
+ const missing = () => err(HaiToolsError.NOT_FOUND, toolsM("tools_notFound"));
330
+ const registry = {
331
+ register(tool) {
332
+ if (!definitions.has(tool) || !portableName.test(tool.name))
333
+ return err(HaiToolsError.VALIDATION_FAILED, toolsM("tools_validationFailed"));
334
+ if (registered.has(tool.name))
335
+ return duplicate();
336
+ registered.set(tool.name, tool);
337
+ return ok(void 0);
338
+ },
339
+ registerMany(incoming) {
340
+ const names = /* @__PURE__ */ new Set();
341
+ for (const tool of incoming) {
342
+ if (!definitions.has(tool) || !portableName.test(tool.name))
343
+ return err(HaiToolsError.VALIDATION_FAILED, toolsM("tools_validationFailed"));
344
+ if (registered.has(tool.name) || names.has(tool.name))
345
+ return duplicate();
346
+ names.add(tool.name);
347
+ }
348
+ for (const tool of incoming)
349
+ registered.set(tool.name, tool);
350
+ return ok(void 0);
351
+ },
352
+ replace(tool) {
353
+ if (!definitions.has(tool) || !portableName.test(tool.name))
354
+ return err(HaiToolsError.VALIDATION_FAILED, toolsM("tools_validationFailed"));
355
+ if (!registered.has(tool.name))
356
+ return missing();
357
+ registered.set(tool.name, tool);
358
+ return ok(void 0);
359
+ },
360
+ unregister: (name) => registered.delete(name),
361
+ get: (name) => registered.get(name),
362
+ has: (name) => registered.has(name),
363
+ getNames: () => [
364
+ ...registered.keys()
365
+ ],
366
+ getDefinitions: () => [
367
+ ...registered.values()
368
+ ].map((tool) => tool.toDefinition()),
369
+ async execute(name, input, execution = {}) {
370
+ const tool = registered.get(name);
371
+ if (!tool)
372
+ return missing();
373
+ return tool.execute(input, {
374
+ ...execution,
375
+ authorize: joinedAuthorizer(options.authorize, execution.authorize)
376
+ });
377
+ },
378
+ async executeAll(calls, execution = {}) {
379
+ const outputs = [];
380
+ if (execution.parallel) {
381
+ const results = await Promise.all(calls.map((call) => registry.execute(call.name, call.input, execution)));
382
+ for (const result of results) {
383
+ if (!result.success)
384
+ return result;
385
+ outputs.push(result.data);
386
+ }
387
+ } else {
388
+ for (const call of calls) {
389
+ const result = await registry.execute(call.name, call.input, execution);
390
+ if (!result.success)
391
+ return result;
392
+ outputs.push(result.data);
393
+ }
394
+ }
395
+ return ok(outputs);
396
+ },
397
+ clear: () => registered.clear(),
398
+ get size() {
399
+ return registered.size;
400
+ }
401
+ };
402
+ return registry;
403
+ }
404
+
405
+ // src/tools-main.ts
406
+ var tools = {
407
+ define: defineTool,
408
+ createRegistry: createToolRegistry
409
+ };
410
+
411
+ export { HaiToolsError, tools, toolsM };
412
+ //# sourceMappingURL=chunk-UA7MOYTT.js.map
413
+ //# sourceMappingURL=chunk-UA7MOYTT.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/tools-types.ts","../messages/en-US.json","../messages/ja-JP.json","../messages/zh-CN.json","../src/tools-i18n.ts","../src/tools-functions.ts","../src/tools-main.ts"],"names":["core"],"mappings":"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","file":"chunk-UA7MOYTT.js","sourcesContent":["import type { HaiResult } from '@h-ai/core'\nimport type { ZodType } from 'zod'\nimport { core } from '@h-ai/core'\n\n/**\n * 工具执行错误,不包含模型或传输协议错误。\n * @example\n * ```ts\n * import { HaiToolsError } from '@h-ai/tools'\n * const forbidden = HaiToolsError.FORBIDDEN\n * ```\n */\nexport const HaiToolsError = core.error.buildHaiErrorsDef('tools', {\n NOT_FOUND: '020:404',\n ALREADY_REGISTERED: '021:409',\n VALIDATION_FAILED: '022:400',\n EXECUTION_FAILED: '023:500',\n FORBIDDEN: '024:403',\n TIMEOUT: '025:504',\n CANCELLED: '026:499',\n})\n\n/**\n * 与模型协议无关的工具描述。\n * @example\n * ```ts\n * import type { ToolDefinition } from '@h-ai/tools'\n * const definition: ToolDefinition = { name: 'echo', description: 'Echo text', inputSchema: { type: 'object' } }\n * ```\n */\nexport interface ToolDefinition {\n name: string\n title?: string\n description: string\n inputSchema: Record<string, unknown>\n examples?: readonly { label: string, input: Record<string, unknown> }[]\n}\n\n/**\n * 可信执行上下文,取消信号始终存在。\n * @example\n * ```ts\n * import type { ToolExecutionContext } from '@h-ai/tools'\n * function subject(context: ToolExecutionContext) { return context.objectId }\n * ```\n */\nexport interface ToolExecutionContext {\n signal: AbortSignal\n objectId?: string\n sessionId?: string\n deadline: number\n}\n\n/**\n * 授权只接收已经过 Schema 校验和规范化的输入。\n * @example\n * ```ts\n * import type { ToolAuthorizationRequest } from '@h-ai/tools'\n * function isBound(request: ToolAuthorizationRequest) { return !!request.context.objectId }\n * ```\n */\nexport interface ToolAuthorizationRequest {\n toolName: string\n input: unknown\n context: ToolExecutionContext\n}\n\n/**\n * 授权拒绝或异常均阻止执行。\n * @example\n * ```ts\n * import type { ToolAuthorizer } from '@h-ai/tools'\n * const authorize: ToolAuthorizer = ({ context }) => context.objectId === 'user-1'\n * ```\n */\nexport type ToolAuthorizer = (request: ToolAuthorizationRequest) => boolean | Promise<boolean>\n\n/**\n * 单次执行上下文,截止时间优先于各级超时。\n * @example\n * ```ts\n * import type { ToolExecutionOptions } from '@h-ai/tools'\n * const options: ToolExecutionOptions = { objectId: 'user-1', timeoutMs: 5000 }\n * ```\n */\nexport interface ToolExecutionOptions {\n signal?: AbortSignal\n objectId?: string\n sessionId?: string\n deadline?: number\n timeoutMs?: number\n authorize?: ToolAuthorizer\n}\n\n/**\n * 工具定义的业务输入与处理函数。\n * @example\n * ```ts\n * import type { DefineToolOptions } from '@h-ai/tools'\n * import { z } from 'zod'\n * const options: DefineToolOptions<{ value: string }, string> = { name: 'echo', description: 'Echo text', parameters: z.object({ value: z.string() }), handler: input => input.value }\n * ```\n */\nexport type DefineToolOptions<TInput, TOutput> = {\n name: string\n title?: string\n description: string\n examples?: readonly { label: string, input: Record<string, unknown> }[]\n parameters: ZodType<TInput>\n timeoutMs?: number\n} & ({\n handler: (input: TInput, context: ToolExecutionContext) => TOutput | Promise<TOutput>\n resultHandler?: never\n} | {\n handler?: never\n resultHandler: (input: TInput, context: ToolExecutionContext) => HaiResult<TOutput> | Promise<HaiResult<TOutput>>\n})\n\n/**\n * 工具实例,所有业务输入在执行时重新校验。\n * @example\n * ```ts\n * import { tools } from '@h-ai/tools'\n * import { z } from 'zod'\n * const echo = tools.define({ name: 'echo', description: 'Echo text', parameters: z.string(), handler: text => text })\n * const result = await echo.execute('hello')\n * if (!result.success) throw new Error(result.error.message)\n * ```\n */\nexport interface Tool<TInput = unknown, TOutput = unknown> {\n readonly name: string\n readonly description: string\n readonly parameters: ZodType<TInput>\n execute: (input: unknown, options?: ToolExecutionOptions) => Promise<HaiResult<TOutput>>\n toDefinition: () => ToolDefinition\n}\n\n/**\n * 注册器级授权与单次授权必须同时通过。\n * @example\n * ```ts\n * import type { ToolRegistryOptions } from '@h-ai/tools'\n * const options: ToolRegistryOptions = { authorize: ({ context }) => !!context.objectId }\n * ```\n */\nexport interface ToolRegistryOptions {\n authorize?: ToolAuthorizer\n}\n\n/**\n * 直接业务调用,不携带模型消息或 JSON 字符串参数。\n * @example\n * ```ts\n * import type { ToolInvocation } from '@h-ai/tools'\n * const invocation: ToolInvocation = { name: 'sum', input: { a: 1, b: 2 } }\n * ```\n */\nexport interface ToolInvocation {\n name: string\n input: unknown\n}\n\n/**\n * 进程内工具集合。任务状态、租约和产物由相应服务保存。\n * @example\n * ```ts\n * import { tools } from '@h-ai/tools'\n * const registry = tools.createRegistry()\n * const definitions = registry.getDefinitions()\n * ```\n */\nexport interface ToolRegistryOperations {\n register: <TInput, TOutput>(tool: Tool<TInput, TOutput>) => HaiResult<void>\n registerMany: (tools: Tool[]) => HaiResult<void>\n replace: <TInput, TOutput>(tool: Tool<TInput, TOutput>) => HaiResult<void>\n unregister: (name: string) => boolean\n get: (name: string) => Tool | undefined\n has: (name: string) => boolean\n getNames: () => string[]\n getDefinitions: () => ToolDefinition[]\n execute: (name: string, input: unknown, options?: ToolExecutionOptions) => Promise<HaiResult<unknown>>\n executeAll: (calls: ToolInvocation[], options?: ToolExecutionOptions & { parallel?: boolean }) => Promise<HaiResult<unknown[]>>\n clear: () => void\n readonly size: number\n}\n\n/**\n * Tools 的纯工厂入口,不需要 init/close。\n * @example\n * ```ts\n * import { tools } from '@h-ai/tools'\n * const registry = tools.createRegistry()\n * ```\n */\nexport interface ToolsFunctions {\n /** 定义工具。无效名称或默认超时作为定义错误抛出 TypeError。 */\n define: <TInput, TOutput>(options: DefineToolOptions<TInput, TOutput>) => Tool<TInput, TOutput>\n createRegistry: (options?: ToolRegistryOptions) => ToolRegistryOperations\n}\n","{\n \"tools_notFound\": \"Tool is unavailable or disabled\",\n \"tools_alreadyRegistered\": \"Tool name is already registered\",\n \"tools_validationFailed\": \"Tool input is invalid\",\n \"tools_executionFailed\": \"Tool execution failed\",\n \"tools_sandboxUnavailable\": \"The execution environment cannot enable the browser sandbox. Ask an administrator to check its configuration.\",\n \"tools_previewUnsupported\": \"The project contains an unsupported dependency, resource or browser feature. Use local HTML/JS/CSS or supported Svelte components; see the project preview guide.\",\n \"tools_outputLimit\": \"The generated content exceeds the size limit. Reduce its content or assets and try again.\",\n \"tools_unsafeDocument\": \"The document contains unsupported active content or external references, or exceeds safety limits. Check the file and try again.\",\n \"tools_forbidden\": \"Tool execution is not authorized\",\n \"tools_timeout\": \"Tool execution timed out\",\n \"tools_cancelled\": \"Tool execution was cancelled\",\n \"tools_artifactCreate\": \"Create artifact\",\n \"tools_artifactCreateDescription\": \"Create editable Markdown, HTML, table or chart content in your library.\",\n \"tools_artifactRead\": \"Read artifact\",\n \"tools_artifactReadDescription\": \"Read the content and version of an existing text artifact.\",\n \"tools_artifactSave\": \"Save artifact\",\n \"tools_artifactSaveDescription\": \"Save against the version you read; concurrent edits cause a conflict.\",\n \"tools_dataAnalyze\": \"Analyze data\",\n \"tools_dataAnalyzeDescription\": \"Calculate numeric summaries and create editable table and chart artifacts.\",\n \"tools_documents\": \"Documents\",\n \"tools_job_documents_extract\": \"Extract document text\",\n \"tools_job_documents_generate\": \"Generate Office documents\",\n \"tools_job_office_convert\": \"Convert to PDF\",\n \"tools_job_office_recalculate\": \"Recalculate spreadsheet\",\n \"tools_job_ocr_recognize\": \"Recognize image text\",\n \"tools_job_browser_navigate\": \"Capture website screenshot\",\n \"tools_job_web_capture\": \"Capture website content and assets\",\n \"tools_job_preview_build\": \"Build a web project preview\",\n \"tools_job_video_render\": \"Render video project\",\n \"tools_field_title\": \"Title\",\n \"tools_field_kind\": \"Artifact type\",\n \"tools_field_content\": \"Content\",\n \"tools_field_id\": \"Existing artifact\",\n \"tools_field_baseVersion\": \"Base version\",\n \"tools_field_x\": \"Category field\",\n \"tools_field_y\": \"Numeric field\",\n \"tools_field_rows\": \"Data rows\",\n \"tools_field_chartType\": \"Chart type\",\n \"tools_field_format\": \"File format\",\n \"tools_field_paragraphs\": \"Paragraphs\",\n \"tools_field_headers\": \"Column headings\",\n \"tools_field_table\": \"Table\",\n \"tools_field_slides\": \"Slides\",\n \"tools_field_fileId\": \"Input file\",\n \"tools_field_url\": \"Website URL\",\n \"tools_field_maxScreenshots\": \"Screenshot count\",\n \"tools_field_fps\": \"Frames per second\",\n \"tools_field_language\": \"Recognition language\",\n \"tools_example_markdown\": \"Markdown note\",\n \"tools_example_noteTitle\": \"Project note\",\n \"tools_example_noteContent\": \"# Project note\\n\\nWrite your first draft here.\",\n \"tools_example_sales\": \"Monthly sales\",\n \"tools_example_report\": \"Quarterly report\",\n \"tools_example_reportContent\": \"A summary of this quarter.\",\n \"tools_documentLimits\": \"The UTF-8 JSON specification must fit within 256 KiB. PPTX slides allow up to 6 paragraphs of 160 characters (800 total), or a table of 6 columns and 6 data rows with cells up to 32 characters and one paragraph up to 120 characters. Slides cannot be combined with top-level content.\"\n}\n","{\n \"tools_notFound\": \"ツールが存在しないか無効です\",\n \"tools_alreadyRegistered\": \"ツール名は登録済みです\",\n \"tools_validationFailed\": \"ツールの入力が無効です\",\n \"tools_executionFailed\": \"ツールの実行に失敗しました\",\n \"tools_sandboxUnavailable\": \"実行環境でブラウザーのサンドボックスを有効にできません。管理者に環境設定の確認を依頼してください。\",\n \"tools_previewUnsupported\": \"対応していない依存関係、素材、ブラウザー機能が含まれています。ローカルの HTML/JS/CSS または対応する Svelte コンポーネントを使用し、プロジェクトプレビューの説明を確認してください。\",\n \"tools_outputLimit\": \"生成内容がサイズ制限を超えています。内容や素材を減らして再試行してください。\",\n \"tools_unsafeDocument\": \"文書に未対応のアクティブコンテンツや外部参照が含まれているか、安全上の制限を超えています。ファイルを確認して再試行してください。\",\n \"tools_forbidden\": \"このツールを実行する権限がありません\",\n \"tools_timeout\": \"ツールの実行がタイムアウトしました\",\n \"tools_cancelled\": \"ツールの実行をキャンセルしました\",\n \"tools_artifactCreate\": \"成果物を作成\",\n \"tools_artifactCreateDescription\": \"編集可能な Markdown、HTML、表、グラフをライブラリに保存します。\",\n \"tools_artifactRead\": \"成果物を読む\",\n \"tools_artifactReadDescription\": \"既存のテキスト成果物の内容とバージョンを読みます。\",\n \"tools_artifactSave\": \"成果物を保存\",\n \"tools_artifactSaveDescription\": \"読み取ったバージョンに基づき保存します。同時編集は競合として扱います。\",\n \"tools_dataAnalyze\": \"データ分析\",\n \"tools_dataAnalyzeDescription\": \"数値を集計し、編集可能な表とグラフを作成します。\",\n \"tools_documents\": \"文書\",\n \"tools_job_documents_extract\": \"文書のテキスト抽出\",\n \"tools_job_documents_generate\": \"Office文書を生成\",\n \"tools_job_office_convert\": \"PDFに変換\",\n \"tools_job_office_recalculate\": \"表計算を再計算\",\n \"tools_job_ocr_recognize\": \"画像の文字認識\",\n \"tools_job_browser_navigate\": \"ウェブ画面を撮影\",\n \"tools_job_web_capture\": \"ウェブ内容と素材を収集\",\n \"tools_job_preview_build\": \"ウェブプロジェクトのプレビューをビルド\",\n \"tools_job_video_render\": \"動画プロジェクトをレンダリング\",\n \"tools_field_title\": \"タイトル\",\n \"tools_field_kind\": \"成果物の種類\",\n \"tools_field_content\": \"本文\",\n \"tools_field_id\": \"既存の成果物\",\n \"tools_field_baseVersion\": \"基準バージョン\",\n \"tools_field_x\": \"分類項目\",\n \"tools_field_y\": \"数値項目\",\n \"tools_field_rows\": \"データ行\",\n \"tools_field_chartType\": \"グラフの種類\",\n \"tools_field_format\": \"ファイル形式\",\n \"tools_field_paragraphs\": \"段落\",\n \"tools_field_headers\": \"列の見出し\",\n \"tools_field_table\": \"表\",\n \"tools_field_slides\": \"スライド\",\n \"tools_field_fileId\": \"入力ファイル\",\n \"tools_field_url\": \"ウェブURL\",\n \"tools_field_maxScreenshots\": \"画面数\",\n \"tools_field_fps\": \"フレームレート\",\n \"tools_field_language\": \"認識言語\",\n \"tools_example_markdown\": \"Markdown ノート\",\n \"tools_example_noteTitle\": \"プロジェクトノート\",\n \"tools_example_noteContent\": \"# プロジェクトノート\\n\\n最初の下書きをここに入力します。\",\n \"tools_example_sales\": \"月別売上\",\n \"tools_example_report\": \"四半期レポート\",\n \"tools_example_reportContent\": \"今四半期の概要。\",\n \"tools_documentLimits\": \"UTF-8 JSON は 256 KiB 以下です。PPTX は各ページ6段落・各160文字・合計800文字まで。表を含む場合は6列・6データ行・セル32文字までで、本文は120文字以下の1段落のみです。slides と最上位の本文・表は併用できません。\"\n}\n","{\n \"tools_notFound\": \"工具不存在或未启用\",\n \"tools_alreadyRegistered\": \"工具名称已注册\",\n \"tools_validationFailed\": \"工具参数无效\",\n \"tools_executionFailed\": \"工具执行失败\",\n \"tools_sandboxUnavailable\": \"当前执行环境无法启用浏览器沙箱,请联系管理员检查环境配置。\",\n \"tools_previewUnsupported\": \"项目包含不支持的依赖、资源或浏览器特性。请使用本地 HTML/JS/CSS 或受支持的 Svelte 组件,参阅项目预览说明。\",\n \"tools_outputLimit\": \"生成的内容超过大小限制,请减少内容或素材后重试。\",\n \"tools_unsafeDocument\": \"文档包含不受支持的主动内容、外部引用或超出安全限制,请检查文件后重试。\",\n \"tools_forbidden\": \"无权执行此工具\",\n \"tools_timeout\": \"工具执行超时\",\n \"tools_cancelled\": \"工具执行已取消\",\n \"tools_artifactCreate\": \"创建成果\",\n \"tools_artifactCreateDescription\": \"生成可编辑的 Markdown、网页、表格或图表,并保存到当前用户的资料库。\",\n \"tools_artifactRead\": \"读取成果\",\n \"tools_artifactReadDescription\": \"读取已有文本成果的内容和版本。\",\n \"tools_artifactSave\": \"保存成果\",\n \"tools_artifactSaveDescription\": \"按读取时的版本保存修改;版本冲突时保留当前内容。\",\n \"tools_dataAnalyze\": \"数据分析\",\n \"tools_dataAnalyzeDescription\": \"计算数字汇总,并生成可以编辑的表格及图表。\",\n \"tools_documents\": \"文档\",\n \"tools_job_documents_extract\": \"提取文档文字\",\n \"tools_job_documents_generate\": \"生成 Office 文档\",\n \"tools_job_office_convert\": \"转换为 PDF\",\n \"tools_job_office_recalculate\": \"重新计算表格\",\n \"tools_job_ocr_recognize\": \"识别图片文字\",\n \"tools_job_browser_navigate\": \"网页截图\",\n \"tools_job_web_capture\": \"采集网页内容与素材\",\n \"tools_job_preview_build\": \"构建网页项目预览\",\n \"tools_job_video_render\": \"渲染视频项目\",\n \"tools_field_title\": \"标题\",\n \"tools_field_kind\": \"成果类型\",\n \"tools_field_content\": \"正文\",\n \"tools_field_id\": \"已有成果\",\n \"tools_field_baseVersion\": \"基准版本\",\n \"tools_field_x\": \"分类字段\",\n \"tools_field_y\": \"数值字段\",\n \"tools_field_rows\": \"数据行\",\n \"tools_field_chartType\": \"图表类型\",\n \"tools_field_format\": \"文件格式\",\n \"tools_field_paragraphs\": \"正文段落\",\n \"tools_field_headers\": \"表头\",\n \"tools_field_table\": \"表格\",\n \"tools_field_slides\": \"演示页面\",\n \"tools_field_fileId\": \"输入文件\",\n \"tools_field_url\": \"网页地址\",\n \"tools_field_maxScreenshots\": \"截图数量\",\n \"tools_field_fps\": \"每秒帧数\",\n \"tools_field_language\": \"识别语言\",\n \"tools_example_markdown\": \"Markdown 笔记\",\n \"tools_example_noteTitle\": \"项目笔记\",\n \"tools_example_noteContent\": \"# 项目笔记\\n\\n在这里写下第一版内容。\",\n \"tools_example_sales\": \"月度销量\",\n \"tools_example_report\": \"季度报告\",\n \"tools_example_reportContent\": \"本季度的工作摘要。\",\n \"tools_documentLimits\": \"UTF-8 JSON 资料不得超过 256 KiB。PPTX 每页最多 6 段、每段 160 字且合计 800 字;有表格时最多 6 列、6 行数据、单元格 32 字,并仅允许一段不超过 120 字的正文。slides 不可与顶层正文或表格混用。\"\n}\n","import { core } from '@h-ai/core'\nimport messagesEnUS from '../messages/en-US.json'\nimport messagesJaJP from '../messages/ja-JP.json'\nimport messagesZhCN from '../messages/zh-CN.json'\n\n/**\n * 工具文案仅包含安全摘要,外部错误正文不用于消息插值。\n * @example 模块内部上下文\n * ```ts\n * const message = toolsM('tools_executionFailed')\n * ```\n */\nexport const toolsM = core.i18n.createMessageGetter<keyof typeof messagesZhCN>({\n 'zh-CN': messagesZhCN,\n 'en-US': messagesEnUS,\n 'ja-JP': messagesJaJP,\n})\n","import type {\n DefineToolOptions,\n Tool,\n ToolAuthorizer,\n ToolExecutionContext,\n ToolRegistryOperations,\n ToolRegistryOptions,\n} from './tools-types.js'\nimport { core, err, ok } from '@h-ai/core'\nimport { z } from 'zod'\nimport { toolsM } from './tools-i18n.js'\nimport { HaiToolsError } from './tools-types.js'\n\nconst logger = core.logger.child({ module: 'tools' })\nconst portableName = /^[a-z][\\w-]{0,63}$/i\nconst maxTimeout = 2_147_483_647\n// 工具扩展统一经过 define,避免结构类型的手写 execute 绕过授权与输入校验。\nconst definitions = new WeakSet<object>()\n\nfunction validTimeout(value: number): boolean {\n return Number.isSafeInteger(value) && value >= 0 && value <= maxTimeout\n}\n\n/** 在取消时停止等待;实际处理器仍须自行响应 signal。 */\nfunction raceCancellation<T>(run: () => T | Promise<T>, signal: AbortSignal): Promise<T> {\n return new Promise<T>((resolve, reject) => {\n if (signal.aborted) {\n reject(signal.reason)\n return\n }\n const abort = () => reject(signal.reason)\n signal.addEventListener('abort', abort, { once: true })\n Promise.resolve().then(() => {\n signal.throwIfAborted()\n return run()\n }).then(resolve, reject).finally(() => signal.removeEventListener('abort', abort))\n })\n}\n\nfunction joinedAuthorizer(registry?: ToolAuthorizer, execution?: ToolAuthorizer): ToolAuthorizer | undefined {\n if (!registry)\n return execution\n if (!execution)\n return registry\n return async request => await registry(request) && await execution(request)\n}\n\n/**\n * 定义带校验、授权与取消的中立工具。定义配置无效时抛出 TypeError。\n * @example 模块内部上下文\n * ```ts\n * const echo = defineTool({ name: 'echo', description: 'Echo', parameters: z.string(), handler: input => input })\n * const result = await echo.execute('hello')\n * if (!result.success) throw new Error(result.error.message)\n * ```\n */\nexport function defineTool<TInput, TOutput>(definition: DefineToolOptions<TInput, TOutput>): Tool<TInput, TOutput> {\n const { name, description, parameters, handler, resultHandler, timeoutMs = 30_000 } = definition\n if (!portableName.test(name) || !validTimeout(timeoutMs))\n throw new TypeError('Tool definition requires a portable name and a valid timeout')\n if ((typeof handler === 'function') === (typeof resultHandler === 'function'))\n throw new TypeError('Tool definition requires exactly one handler or resultHandler')\n\n const tool: Tool<TInput, TOutput> = {\n name,\n description,\n parameters,\n toDefinition() {\n const { $schema, ...inputSchema } = z.toJSONSchema(parameters, { io: 'input' })\n return {\n name,\n description,\n inputSchema,\n ...(definition.title\n ? { title: definition.title }\n : {}),\n ...(definition.examples\n ? { examples: definition.examples }\n : {}),\n }\n },\n async execute(input, options = {}) {\n const duration = options.deadline === undefined\n ? options.timeoutMs ?? timeoutMs\n : Math.max(0, options.deadline - Date.now())\n if (!validTimeout(duration) || (options.deadline !== undefined && !Number.isSafeInteger(options.deadline)))\n return err(HaiToolsError.VALIDATION_FAILED, toolsM('tools_validationFailed'))\n if (options.signal?.aborted)\n return err(HaiToolsError.CANCELLED, toolsM('tools_cancelled'), options.signal.reason)\n if (duration === 0)\n return err(HaiToolsError.TIMEOUT, toolsM('tools_timeout'))\n\n const timeout = new AbortController()\n const timer = setTimeout(() => timeout.abort(new DOMException('Tool deadline exceeded', 'TimeoutError')), duration)\n const signal = options.signal\n ? AbortSignal.any([options.signal, timeout.signal])\n : timeout.signal\n const context: ToolExecutionContext = {\n signal,\n objectId: options.objectId,\n sessionId: options.sessionId,\n deadline: options.deadline ?? Date.now() + duration,\n }\n const interrupted = (cause: unknown) => options.signal?.aborted\n ? err(HaiToolsError.CANCELLED, toolsM('tools_cancelled'), cause)\n : err(HaiToolsError.TIMEOUT, toolsM('tools_timeout'), cause)\n const refreshDeadline = () => {\n if (Date.now() >= context.deadline && !timeout.signal.aborted)\n timeout.abort(new DOMException('Tool deadline exceeded', 'TimeoutError'))\n }\n const checkActive = () => {\n refreshDeadline()\n signal.throwIfAborted()\n }\n try {\n // 参数校验也受同一截止时间控制,异步或抛错的校验不会越过 HaiResult 边界。\n let parsed: Awaited<ReturnType<typeof parameters.safeParseAsync>>\n try {\n checkActive()\n parsed = await raceCancellation(() => parameters.safeParseAsync(input), signal)\n checkActive()\n }\n catch (cause) {\n refreshDeadline()\n if (signal.aborted)\n return interrupted(cause)\n logger.debug('Tool validation failed', { tool: name })\n return err(HaiToolsError.VALIDATION_FAILED, toolsM('tools_validationFailed'), cause)\n }\n if (!parsed.success)\n return err(HaiToolsError.VALIDATION_FAILED, toolsM('tools_validationFailed'), parsed.error)\n\n const authorizer = options.authorize\n if (authorizer) {\n try {\n checkActive()\n const allowed = await raceCancellation(() => authorizer({ toolName: name, input: parsed.data, context }), signal)\n checkActive()\n if (!allowed)\n return err(HaiToolsError.FORBIDDEN, toolsM('tools_forbidden'))\n }\n catch (cause) {\n refreshDeadline()\n if (signal.aborted)\n return interrupted(cause)\n logger.debug('Tool authorization failed', { tool: name })\n return err(HaiToolsError.FORBIDDEN, toolsM('tools_forbidden'), cause)\n }\n }\n try {\n checkActive()\n // 显式结果处理器保留上游业务错误;普通处理器的 success 字段仍作为数据。\n const output = await raceCancellation(() => resultHandler\n ? resultHandler(parsed.data, context)\n : Promise.resolve(handler!(parsed.data, context)).then(ok), signal)\n checkActive()\n return output\n }\n catch (cause) {\n refreshDeadline()\n if (signal.aborted)\n return interrupted(cause)\n logger.warn('Tool execution failed', { tool: name, errorCode: HaiToolsError.EXECUTION_FAILED.code })\n return err(HaiToolsError.EXECUTION_FAILED, toolsM('tools_executionFailed'), cause)\n }\n }\n finally {\n clearTimeout(timer)\n }\n },\n }\n Object.freeze(tool)\n definitions.add(tool)\n return tool\n}\n\n/**\n * 创建进程内工具注册器,默认拒绝隐式覆盖。\n * @example 模块内部上下文\n * ```ts\n * const registry = createToolRegistry({ authorize: ({ context }) => !!context.objectId })\n * const result = await registry.execute('echo', 'hello', { objectId: 'user-1' })\n * if (!result.success) throw new Error(result.error.message)\n * ```\n */\nexport function createToolRegistry(options: ToolRegistryOptions = {}): ToolRegistryOperations {\n const registered = new Map<string, Tool>()\n const duplicate = () => err(HaiToolsError.ALREADY_REGISTERED, toolsM('tools_alreadyRegistered'))\n const missing = () => err(HaiToolsError.NOT_FOUND, toolsM('tools_notFound'))\n\n const registry: ToolRegistryOperations = {\n register(tool) {\n if (!definitions.has(tool) || !portableName.test(tool.name))\n return err(HaiToolsError.VALIDATION_FAILED, toolsM('tools_validationFailed'))\n if (registered.has(tool.name))\n return duplicate()\n registered.set(tool.name, tool)\n return ok(undefined)\n },\n registerMany(incoming) {\n const names = new Set<string>()\n for (const tool of incoming) {\n if (!definitions.has(tool) || !portableName.test(tool.name))\n return err(HaiToolsError.VALIDATION_FAILED, toolsM('tools_validationFailed'))\n if (registered.has(tool.name) || names.has(tool.name))\n return duplicate()\n names.add(tool.name)\n }\n for (const tool of incoming)\n registered.set(tool.name, tool)\n return ok(undefined)\n },\n replace(tool) {\n if (!definitions.has(tool) || !portableName.test(tool.name))\n return err(HaiToolsError.VALIDATION_FAILED, toolsM('tools_validationFailed'))\n if (!registered.has(tool.name))\n return missing()\n registered.set(tool.name, tool)\n return ok(undefined)\n },\n unregister: name => registered.delete(name),\n get: name => registered.get(name),\n has: name => registered.has(name),\n getNames: () => [\n ...registered.keys(),\n ],\n getDefinitions: () => [\n ...registered.values(),\n ].map(tool => tool.toDefinition()),\n async execute(name, input, execution = {}) {\n const tool = registered.get(name)\n if (!tool)\n return missing()\n return tool.execute(input, {\n ...execution,\n authorize: joinedAuthorizer(options.authorize, execution.authorize),\n })\n },\n async executeAll(calls, execution = {}) {\n const outputs: unknown[] = []\n if (execution.parallel) {\n const results = await Promise.all(calls.map(call => registry.execute(call.name, call.input, execution)))\n for (const result of results) {\n if (!result.success)\n return result\n outputs.push(result.data)\n }\n }\n else {\n for (const call of calls) {\n const result = await registry.execute(call.name, call.input, execution)\n if (!result.success)\n return result\n outputs.push(result.data)\n }\n }\n return ok(outputs)\n },\n clear: () => registered.clear(),\n get size() { return registered.size },\n }\n return registry\n}\n","import type { ToolsFunctions } from './tools-types.js'\nimport { createToolRegistry, defineTool } from './tools-functions.js'\n\n/**\n * 工具定义和注册的统一入口,无生命周期与隐式注册。\n * @example\n * ```ts\n * import { tools } from '@h-ai/tools'\n * const registry = tools.createRegistry()\n * ```\n */\nexport const tools: ToolsFunctions = {\n define: defineTool,\n createRegistry: createToolRegistry,\n}\n"]}
@@ -0,0 +1,16 @@
1
+ import { T as ToolsFunctions } from './tools-types-CM0lGuJr.js';
2
+ export { D as DefineToolOptions, H as HaiToolsError, a as Tool, b as ToolAuthorizationRequest, c as ToolAuthorizer, d as ToolDefinition, e as ToolExecutionContext, f as ToolExecutionOptions, g as ToolInvocation, h as ToolRegistryOperations, i as ToolRegistryOptions } from './tools-types-CM0lGuJr.js';
3
+ import '@h-ai/core';
4
+ import 'zod';
5
+
6
+ /**
7
+ * 工具定义和注册的统一入口,无生命周期与隐式注册。
8
+ * @example
9
+ * ```ts
10
+ * import { tools } from '@h-ai/tools'
11
+ * const registry = tools.createRegistry()
12
+ * ```
13
+ */
14
+ declare const tools: ToolsFunctions;
15
+
16
+ export { ToolsFunctions, tools };
package/dist/index.js ADDED
@@ -0,0 +1,3 @@
1
+ export { HaiToolsError, tools } from './chunk-UA7MOYTT.js';
2
+ //# sourceMappingURL=index.js.map
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}