@world-engines/agent-kit 0.1.0-alpha.0

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 (77) hide show
  1. package/LICENSE +46 -0
  2. package/assets/README.md +58 -0
  3. package/assets/docs/development/README.md +25 -0
  4. package/assets/docs/development/authoring-bridge.md +52 -0
  5. package/assets/docs/development/authoring-workflows.md +48 -0
  6. package/assets/docs/development/chatplay-view.md +111 -0
  7. package/assets/docs/development/cli.md +145 -0
  8. package/assets/docs/development/desktop-transfer-security.md +46 -0
  9. package/assets/docs/development/generated/authoring-bridge-contract.json +598 -0
  10. package/assets/docs/development/generated/authoring-bridge-contract.md +660 -0
  11. package/assets/docs/development/generated/chatplay-sdk/SOURCE.json +10 -0
  12. package/assets/docs/development/generated/chatplay-sdk/chatplay-sdk.d.ts +309 -0
  13. package/assets/docs/development/generated/chatplay-sdk/descriptor.json +699 -0
  14. package/assets/docs/development/generated/chatplay-sdk/descriptor.md +363 -0
  15. package/assets/docs/development/installation-and-structure.md +70 -0
  16. package/assets/docs/development/local-gui.md +94 -0
  17. package/assets/docs/development/scene-authoring.md +74 -0
  18. package/assets/guides/long-form-ladybug-trigger.md +98 -0
  19. package/assets/launchers/worldengine-codex.ps1 +105 -0
  20. package/assets/launchers/worldengine-mcp.cmd +5 -0
  21. package/assets/launchers/worldengine-npm.cjs +18 -0
  22. package/assets/launchers/worldengine.cmd +39 -0
  23. package/assets/prompts/local-author-system.md +40 -0
  24. package/assets/skills/caveman/LICENSE.md +13 -0
  25. package/assets/skills/caveman/SKILL.md +50 -0
  26. package/assets/skills/caveman/SOURCE.md +9 -0
  27. package/assets/skills/diagnose/SKILL.md +118 -0
  28. package/assets/skills/diagnose/SOURCE.md +3 -0
  29. package/assets/skills/diagnose/scripts/hitl-loop.template.sh +41 -0
  30. package/assets/skills/i-have-adhd/LICENSE.md +9 -0
  31. package/assets/skills/i-have-adhd/SKILL.md +139 -0
  32. package/assets/skills/i-have-adhd/SOURCE.md +9 -0
  33. package/assets/skills/i-have-adhd/agents/gemini.toml +24 -0
  34. package/assets/skills/i-have-adhd/agents/openai.yaml +7 -0
  35. package/assets/skills/improve-codebase-architecture/DEEPENING.md +37 -0
  36. package/assets/skills/improve-codebase-architecture/INTERFACE-DESIGN.md +44 -0
  37. package/assets/skills/improve-codebase-architecture/LANGUAGE.md +53 -0
  38. package/assets/skills/improve-codebase-architecture/SKILL.md +72 -0
  39. package/assets/skills/improve-codebase-architecture/SOURCE.md +3 -0
  40. package/assets/skills/lossless-document-authoring/SKILL.md +45 -0
  41. package/assets/skills/lossless-document-authoring/references/d4f-workflow.md +155 -0
  42. package/assets/skills/platform-conversion/SKILL.md +23 -0
  43. package/assets/skills/platform-conversion/references/scenario-conversion.md +17 -0
  44. package/assets/skills/platform-conversion/references/view-conversion.md +19 -0
  45. package/assets/skills/setup-matt-pocock-skills/LICENSE.md +9 -0
  46. package/assets/skills/setup-matt-pocock-skills/SKILL.md +122 -0
  47. package/assets/skills/setup-matt-pocock-skills/SOURCE.md +11 -0
  48. package/assets/skills/setup-matt-pocock-skills/domain.md +51 -0
  49. package/assets/skills/setup-matt-pocock-skills/issue-tracker-github.md +22 -0
  50. package/assets/skills/setup-matt-pocock-skills/issue-tracker-gitlab.md +23 -0
  51. package/assets/skills/setup-matt-pocock-skills/issue-tracker-local.md +19 -0
  52. package/assets/skills/setup-matt-pocock-skills/triage-labels.md +15 -0
  53. package/assets/skills/tdd/SKILL.md +110 -0
  54. package/assets/skills/tdd/SOURCE.md +3 -0
  55. package/assets/skills/tdd/deep-modules.md +33 -0
  56. package/assets/skills/tdd/interface-design.md +31 -0
  57. package/assets/skills/tdd/mocking.md +59 -0
  58. package/assets/skills/tdd/refactoring.md +10 -0
  59. package/assets/skills/tdd/tests.md +61 -0
  60. package/assets/skills/to-issues/SKILL.md +90 -0
  61. package/assets/skills/to-issues/SOURCE.md +3 -0
  62. package/assets/skills/to-prd/SKILL.md +77 -0
  63. package/assets/skills/to-prd/SOURCE.md +3 -0
  64. package/assets/skills/triage/AGENT-BRIEF.md +168 -0
  65. package/assets/skills/triage/OUT-OF-SCOPE.md +101 -0
  66. package/assets/skills/triage/SKILL.md +104 -0
  67. package/assets/skills/triage/SOURCE.md +3 -0
  68. package/assets/skills/zoom-out/SKILL.md +8 -0
  69. package/assets/skills/zoom-out/SOURCE.md +3 -0
  70. package/assets/skills-disabled/chat-authority-recovery/SKILL.md +8 -0
  71. package/assets/skills-disabled/codepicker/SKILL.md +8 -0
  72. package/assets/skills-disabled/pacemaker/SKILL.md +8 -0
  73. package/assets/skills-disabled/project-spec-ticket-orchestration/SKILL.md +8 -0
  74. package/assets/skills-disabled/release-deployment-auditor/SKILL.md +8 -0
  75. package/dist/index.d.ts +132 -0
  76. package/dist/index.js +382 -0
  77. package/package.json +51 -0
@@ -0,0 +1,660 @@
1
+ # AuthoringBridge 当前工具面机械投影
2
+
3
+ > 本文件由 `scripts/sync-development-contracts.mjs` 从 `@world-engines/authoring-bridge` 生成;不要手改。
4
+
5
+ 工具总数:22。
6
+
7
+ ## `world_schema`
8
+
9
+ - domain: `world`
10
+ - project effect: `false`
11
+
12
+ ```json
13
+ {
14
+ "type": "object",
15
+ "properties": {},
16
+ "required": [],
17
+ "additionalProperties": false
18
+ }
19
+ ```
20
+
21
+ ## `spatial_template_library`
22
+
23
+ - domain: `world`
24
+ - project effect: `false`
25
+
26
+ ```json
27
+ {
28
+ "type": "object",
29
+ "properties": {},
30
+ "required": [],
31
+ "additionalProperties": false
32
+ }
33
+ ```
34
+
35
+ ## `world_search`
36
+
37
+ - domain: `world`
38
+ - project effect: `false`
39
+
40
+ ```json
41
+ {
42
+ "type": "object",
43
+ "properties": {
44
+ "query": {
45
+ "type": "string",
46
+ "minLength": 1
47
+ },
48
+ "mode": {
49
+ "type": "string",
50
+ "enum": [
51
+ "keyword",
52
+ "full_text",
53
+ "semantic",
54
+ "hybrid"
55
+ ]
56
+ },
57
+ "limit": {
58
+ "type": "integer",
59
+ "minimum": 1
60
+ },
61
+ "cursor": {
62
+ "type": "string"
63
+ },
64
+ "filters": {
65
+ "type": "object",
66
+ "additionalProperties": true
67
+ }
68
+ },
69
+ "required": [
70
+ "query",
71
+ "mode"
72
+ ],
73
+ "additionalProperties": false
74
+ }
75
+ ```
76
+
77
+ ## `world_get`
78
+
79
+ - domain: `world`
80
+ - project effect: `false`
81
+
82
+ ```json
83
+ {
84
+ "type": "object",
85
+ "properties": {
86
+ "ids": {
87
+ "type": "array",
88
+ "items": {
89
+ "type": "string",
90
+ "minLength": 1
91
+ },
92
+ "minItems": 1
93
+ },
94
+ "limit": {
95
+ "type": "integer",
96
+ "minimum": 1,
97
+ "maximum": 200
98
+ },
99
+ "cursor": {
100
+ "type": "string",
101
+ "minLength": 1
102
+ },
103
+ "include_relations": {
104
+ "type": "boolean"
105
+ }
106
+ },
107
+ "required": [],
108
+ "additionalProperties": false,
109
+ "oneOf": [
110
+ {
111
+ "type": "object",
112
+ "properties": {
113
+ "ids": {
114
+ "type": "array",
115
+ "items": {
116
+ "type": "string",
117
+ "minLength": 1
118
+ },
119
+ "minItems": 1
120
+ },
121
+ "include_relations": {
122
+ "type": "boolean"
123
+ }
124
+ },
125
+ "required": [
126
+ "ids"
127
+ ],
128
+ "additionalProperties": false
129
+ },
130
+ {
131
+ "type": "object",
132
+ "properties": {
133
+ "limit": {
134
+ "type": "integer",
135
+ "minimum": 1,
136
+ "maximum": 200
137
+ },
138
+ "cursor": {
139
+ "type": "string",
140
+ "minLength": 1
141
+ },
142
+ "include_relations": {
143
+ "type": "boolean"
144
+ }
145
+ },
146
+ "required": [
147
+ "limit"
148
+ ],
149
+ "additionalProperties": false
150
+ }
151
+ ]
152
+ }
153
+ ```
154
+
155
+ ## `world_traverse`
156
+
157
+ - domain: `world`
158
+ - project effect: `false`
159
+
160
+ ```json
161
+ {
162
+ "type": "object",
163
+ "properties": {
164
+ "start_ids": {
165
+ "type": "array",
166
+ "items": {
167
+ "type": "string",
168
+ "minLength": 1
169
+ },
170
+ "minItems": 1
171
+ },
172
+ "scope_id": {
173
+ "type": "string",
174
+ "minLength": 1
175
+ },
176
+ "direction": {
177
+ "type": "string",
178
+ "enum": [
179
+ "in",
180
+ "out",
181
+ "both"
182
+ ]
183
+ },
184
+ "depth": {
185
+ "type": "integer",
186
+ "minimum": 1,
187
+ "maximum": 4
188
+ },
189
+ "entity_kinds": {
190
+ "type": "array",
191
+ "items": {
192
+ "type": "string",
193
+ "minLength": 1
194
+ },
195
+ "minItems": 0
196
+ },
197
+ "relation_kinds": {
198
+ "type": "array",
199
+ "items": {
200
+ "type": "string",
201
+ "minLength": 1
202
+ },
203
+ "minItems": 0
204
+ },
205
+ "semantic_only": {
206
+ "type": "boolean"
207
+ },
208
+ "limit": {
209
+ "type": "integer",
210
+ "minimum": 1,
211
+ "maximum": 1000
212
+ }
213
+ },
214
+ "required": [
215
+ "start_ids",
216
+ "direction",
217
+ "depth"
218
+ ],
219
+ "additionalProperties": false
220
+ }
221
+ ```
222
+
223
+ ## `world_apply`
224
+
225
+ - domain: `world`
226
+ - project effect: `true`
227
+
228
+ ```json
229
+ {
230
+ "type": "object",
231
+ "properties": {
232
+ "operations": {
233
+ "type": "array",
234
+ "items": {
235
+ "type": "object",
236
+ "additionalProperties": true
237
+ },
238
+ "minItems": 1
239
+ }
240
+ },
241
+ "required": [
242
+ "operations"
243
+ ],
244
+ "additionalProperties": false
245
+ }
246
+ ```
247
+
248
+ ## `world_history`
249
+
250
+ - domain: `world`
251
+ - project effect: `false`
252
+
253
+ ```json
254
+ {
255
+ "type": "object",
256
+ "properties": {
257
+ "target_ids": {
258
+ "type": "array",
259
+ "items": {
260
+ "type": "string",
261
+ "minLength": 1
262
+ },
263
+ "minItems": 1
264
+ },
265
+ "cursor": {
266
+ "type": "string"
267
+ },
268
+ "limit": {
269
+ "type": "integer",
270
+ "minimum": 1
271
+ }
272
+ },
273
+ "required": [
274
+ "target_ids"
275
+ ],
276
+ "additionalProperties": false
277
+ }
278
+ ```
279
+
280
+ ## `trigger_schema`
281
+
282
+ - domain: `trigger`
283
+ - project effect: `false`
284
+
285
+ ```json
286
+ {
287
+ "type": "object",
288
+ "properties": {},
289
+ "required": [],
290
+ "additionalProperties": false
291
+ }
292
+ ```
293
+
294
+ ## `trigger_read`
295
+
296
+ - domain: `trigger`
297
+ - project effect: `false`
298
+
299
+ ```json
300
+ {
301
+ "type": "object",
302
+ "properties": {
303
+ "trigger_ids": {
304
+ "type": "array",
305
+ "items": {
306
+ "type": "string",
307
+ "minLength": 1
308
+ },
309
+ "minItems": 0
310
+ },
311
+ "include_document": {
312
+ "type": "boolean"
313
+ }
314
+ },
315
+ "required": [],
316
+ "additionalProperties": false
317
+ }
318
+ ```
319
+
320
+ ## `trigger_apply`
321
+
322
+ - domain: `trigger`
323
+ - project effect: `true`
324
+
325
+ ```json
326
+ {
327
+ "type": "object",
328
+ "properties": {
329
+ "operations": {
330
+ "type": "array",
331
+ "items": {
332
+ "type": "object",
333
+ "additionalProperties": true
334
+ },
335
+ "minItems": 1
336
+ }
337
+ },
338
+ "required": [
339
+ "operations"
340
+ ],
341
+ "additionalProperties": false
342
+ }
343
+ ```
344
+
345
+ ## `trigger_validate`
346
+
347
+ - domain: `trigger`
348
+ - project effect: `false`
349
+
350
+ ```json
351
+ {
352
+ "type": "object",
353
+ "properties": {
354
+ "candidate_document": {
355
+ "type": "object",
356
+ "additionalProperties": true
357
+ }
358
+ },
359
+ "required": [],
360
+ "additionalProperties": false
361
+ }
362
+ ```
363
+
364
+ ## `trigger_simulate`
365
+
366
+ - domain: `trigger`
367
+ - project effect: `false`
368
+
369
+ ```json
370
+ {
371
+ "type": "object",
372
+ "properties": {
373
+ "event": {
374
+ "type": "object",
375
+ "additionalProperties": true
376
+ },
377
+ "state": {
378
+ "type": "object",
379
+ "additionalProperties": true
380
+ }
381
+ },
382
+ "required": [
383
+ "event",
384
+ "state"
385
+ ],
386
+ "additionalProperties": false
387
+ }
388
+ ```
389
+
390
+ ## `interaction_layout_read`
391
+
392
+ - domain: `layout`
393
+ - project effect: `false`
394
+
395
+ ```json
396
+ {
397
+ "type": "object",
398
+ "properties": {
399
+ "viewport": {
400
+ "type": "string",
401
+ "enum": [
402
+ "pc",
403
+ "mobile"
404
+ ]
405
+ }
406
+ },
407
+ "required": [
408
+ "viewport"
409
+ ],
410
+ "additionalProperties": false
411
+ }
412
+ ```
413
+
414
+ ## `interaction_layout_apply`
415
+
416
+ - domain: `layout`
417
+ - project effect: `true`
418
+
419
+ ```json
420
+ {
421
+ "type": "object",
422
+ "properties": {
423
+ "viewport": {
424
+ "type": "string",
425
+ "enum": [
426
+ "pc",
427
+ "mobile"
428
+ ]
429
+ },
430
+ "patch": {
431
+ "type": "object",
432
+ "additionalProperties": true
433
+ }
434
+ },
435
+ "required": [
436
+ "viewport",
437
+ "patch"
438
+ ],
439
+ "additionalProperties": false
440
+ }
441
+ ```
442
+
443
+ ## `trigger_blueprint_layout_read`
444
+
445
+ - domain: `layout`
446
+ - project effect: `false`
447
+
448
+ ```json
449
+ {
450
+ "type": "object",
451
+ "properties": {
452
+ "trigger_ids": {
453
+ "type": "array",
454
+ "items": {
455
+ "type": "string",
456
+ "minLength": 1
457
+ },
458
+ "minItems": 0
459
+ }
460
+ },
461
+ "required": [],
462
+ "additionalProperties": false
463
+ }
464
+ ```
465
+
466
+ ## `trigger_blueprint_layout_apply`
467
+
468
+ - domain: `layout`
469
+ - project effect: `true`
470
+
471
+ ```json
472
+ {
473
+ "type": "object",
474
+ "properties": {
475
+ "patch": {
476
+ "type": "object",
477
+ "additionalProperties": true
478
+ }
479
+ },
480
+ "required": [
481
+ "patch"
482
+ ],
483
+ "additionalProperties": false
484
+ }
485
+ ```
486
+
487
+ ## `retrieval_config_read`
488
+
489
+ - domain: `retrieval`
490
+ - project effect: `false`
491
+
492
+ ```json
493
+ {
494
+ "type": "object",
495
+ "properties": {},
496
+ "required": [],
497
+ "additionalProperties": false
498
+ }
499
+ ```
500
+
501
+ ## `retrieval_config_apply`
502
+
503
+ - domain: `retrieval`
504
+ - project effect: `true`
505
+
506
+ ```json
507
+ {
508
+ "type": "object",
509
+ "properties": {
510
+ "patch": {
511
+ "type": "object",
512
+ "additionalProperties": true
513
+ }
514
+ },
515
+ "required": [
516
+ "patch"
517
+ ],
518
+ "additionalProperties": false
519
+ }
520
+ ```
521
+
522
+ ## `retrieval_probe`
523
+
524
+ - domain: `retrieval`
525
+ - project effect: `false`
526
+
527
+ ```json
528
+ {
529
+ "type": "object",
530
+ "properties": {
531
+ "query": {
532
+ "type": "string",
533
+ "minLength": 1
534
+ },
535
+ "candidate_config": {
536
+ "type": "object",
537
+ "additionalProperties": true
538
+ },
539
+ "top_k": {
540
+ "type": "integer",
541
+ "minimum": 1
542
+ }
543
+ },
544
+ "required": [
545
+ "query",
546
+ "candidate_config"
547
+ ],
548
+ "additionalProperties": false
549
+ }
550
+ ```
551
+
552
+ ## `ask_user`
553
+
554
+ - domain: `human`
555
+ - project effect: `false`
556
+
557
+ ```json
558
+ {
559
+ "type": "object",
560
+ "properties": {
561
+ "prompt": {
562
+ "type": "string",
563
+ "minLength": 1
564
+ },
565
+ "choices": {
566
+ "type": "array",
567
+ "items": {
568
+ "type": "string",
569
+ "minLength": 1
570
+ },
571
+ "minItems": 0
572
+ },
573
+ "allow_freeform": {
574
+ "type": "boolean"
575
+ }
576
+ },
577
+ "required": [
578
+ "prompt"
579
+ ],
580
+ "additionalProperties": false
581
+ }
582
+ ```
583
+
584
+ ## `preview_inspect`
585
+
586
+ - domain: `preview`
587
+ - project effect: `false`
588
+
589
+ ```json
590
+ {
591
+ "type": "object",
592
+ "properties": {
593
+ "selector": {
594
+ "type": "string"
595
+ },
596
+ "include_screenshot": {
597
+ "type": "boolean"
598
+ },
599
+ "include_console": {
600
+ "type": "boolean"
601
+ }
602
+ },
603
+ "required": [],
604
+ "additionalProperties": false
605
+ }
606
+ ```
607
+
608
+ ## `preview_interact`
609
+
610
+ - domain: `preview`
611
+ - project effect: `false`
612
+
613
+ ```json
614
+ {
615
+ "type": "object",
616
+ "properties": {
617
+ "action": {
618
+ "type": "string",
619
+ "enum": [
620
+ "click",
621
+ "type",
622
+ "press",
623
+ "scroll",
624
+ "navigate"
625
+ ]
626
+ },
627
+ "target": {
628
+ "type": "string",
629
+ "minLength": 1
630
+ },
631
+ "value": {
632
+ "type": "string"
633
+ }
634
+ },
635
+ "required": [
636
+ "action",
637
+ "target"
638
+ ],
639
+ "additionalProperties": false
640
+ }
641
+ ```
642
+
643
+ ## 错误码
644
+
645
+ - `E_PROJECT_NOT_OPEN`
646
+ - `E_PROJECT_BUSY`
647
+ - `E_PATH_OUTSIDE_PROJECT`
648
+ - `E_STALE_PROJECT_REVISION`
649
+ - `E_SCHEMA_INVALID`
650
+ - `E_VALIDATION_FAILED`
651
+ - `E_REFERENCE_MISSING`
652
+ - `E_OPERATION_ID_CONFLICT`
653
+ - `E_OPERATION_UNCERTAIN`
654
+ - `E_PREVIEW_NOT_RUNNING`
655
+ - `E_PREVIEW_NOT_READY`
656
+ - `E_AUTH_REQUIRED`
657
+ - `E_REMOTE_FORBIDDEN`
658
+ - `E_CONFIRMATION_REQUIRED`
659
+ - `E_ROLLBACK_FAILED`
660
+
@@ -0,0 +1,10 @@
1
+ {
2
+ "schema_version": 1,
3
+ "source": "@chatplay/sdk-descriptor generated projection",
4
+ "generated_from": {
5
+ "packages/chatplay-sdk-descriptor/generated/descriptor.md": "de94cbb317f44f162b5052e8f8789c74ce83783b08048509ac018c8af6dfe23c",
6
+ "packages/chatplay-sdk-descriptor/generated/descriptor.json": "427bb16f3bf80163aaddfb95a7b618175affbbd2271ae5a48c345f59737fb239",
7
+ "packages/chatplay-sdk-descriptor/generated/chatplay-sdk.d.ts": "c60171864127966139d655e842a54892a104a236ff341a9446662a94af4ead03"
8
+ },
9
+ "update": "node packages/worldengine-agent-kit/scripts/sync-development-contracts.mjs"
10
+ }