@ghostpaw/questlog 0.2.0 → 0.4.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 (3) hide show
  1. package/dist/index.cjs +226 -431
  2. package/dist/index.js +226 -431
  3. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -3751,71 +3751,42 @@ var manageRepeatableTool = defineQuestlogTool({
3751
3751
  now: "Evaluation or spawn timestamp for previewing or materializing due anchors."
3752
3752
  },
3753
3753
  outputDescription: "Returns the changed repeatable quest, due anchor preview items, or spawned quest details for the selected recurrence action. Empty previews and empty spawns return structured success or no-op results, and repeatable hiding is now intentionally routed through `retire_work`.",
3754
- inputSchema: {
3755
- type: "object",
3756
- oneOf: [
3757
- objectSchema(
3758
- {
3759
- action: enumSchema("Action to perform.", ["archive"]),
3760
- archivedAt: integerSchema("Optional archive timestamp."),
3761
- repeatableQuestId: integerSchema("Repeatable quest to archive.")
3762
- },
3763
- ["action", "repeatableQuestId"]
3764
- ),
3765
- objectSchema(
3766
- {
3767
- action: enumSchema("Action to perform.", ["create"]),
3768
- repeatableQuest: objectSchema(
3769
- {
3770
- title: stringSchema("Title for the new repeatable quest."),
3771
- objective: stringSchema("Objective for the new repeatable quest."),
3772
- rrule: stringSchema("RRULE describing recurrence."),
3773
- anchorAt: integerSchema("Recurrence anchor timestamp.")
3774
- },
3775
- ["title", "objective", "rrule", "anchorAt"]
3776
- )
3777
- },
3778
- ["action", "repeatableQuest"]
3779
- ),
3780
- objectSchema(
3781
- {
3782
- action: enumSchema("Action to perform.", ["preview_due"]),
3783
- now: integerSchema("Evaluation timestamp for due anchors.")
3784
- },
3785
- ["action"]
3786
- ),
3787
- objectSchema(
3754
+ inputSchema: objectSchema(
3755
+ {
3756
+ action: enumSchema("Action to perform.", [
3757
+ "archive",
3758
+ "create",
3759
+ "preview_due",
3760
+ "spawn_due",
3761
+ "update"
3762
+ ]),
3763
+ repeatableQuestId: integerSchema("Repeatable quest to archive or update."),
3764
+ repeatableQuest: objectSchema(
3788
3765
  {
3789
- action: enumSchema("Action to perform.", ["spawn_due"]),
3790
- now: integerSchema("Evaluation timestamp for materializing due anchors.")
3766
+ title: stringSchema("Title for the new repeatable quest."),
3767
+ objective: stringSchema("Objective for the new repeatable quest."),
3768
+ rrule: stringSchema("RRULE describing recurrence."),
3769
+ anchorAt: integerSchema("Recurrence anchor timestamp.")
3791
3770
  },
3792
- ["action", "now"]
3771
+ ["title", "objective", "rrule", "anchorAt"]
3793
3772
  ),
3794
- objectSchema(
3795
- {
3796
- action: enumSchema("Action to perform.", ["update"]),
3797
- repeatableQuestId: integerSchema("Repeatable quest to update."),
3798
- title: stringSchema("Optional new title."),
3799
- objective: stringSchema("Optional new objective."),
3800
- questlineId: integerSchema("Optional new questline id."),
3801
- rrule: stringSchema("Optional new RRULE."),
3802
- anchorAt: integerSchema("Optional new recurrence anchor timestamp."),
3803
- notBeforeOffsetSeconds: integerSchema("Optional new not-before offset in seconds."),
3804
- dueOffsetSeconds: integerSchema("Optional new due offset in seconds."),
3805
- scheduledStartOffsetSeconds: integerSchema(
3806
- "Optional new scheduled-start offset in seconds."
3807
- ),
3808
- scheduledEndOffsetSeconds: integerSchema("Optional new scheduled-end offset in seconds."),
3809
- allDay: booleanSchema("Whether future schedules are all-day."),
3810
- estimateSeconds: integerSchema("Optional new effort estimate."),
3811
- archivedAt: integerSchema("Optional archive timestamp."),
3812
- now: integerSchema("Optional update timestamp.")
3813
- },
3814
- ["action", "repeatableQuestId"]
3815
- )
3816
- ],
3817
- description: "Manage repeatable quest definitions and due materialization."
3818
- },
3773
+ title: stringSchema("Optional new title for the update action."),
3774
+ objective: stringSchema("Optional new objective for the update action."),
3775
+ questlineId: integerSchema("Optional new questline id."),
3776
+ rrule: stringSchema("Optional new RRULE."),
3777
+ anchorAt: integerSchema("Optional new recurrence anchor timestamp."),
3778
+ notBeforeOffsetSeconds: integerSchema("Optional new not-before offset in seconds."),
3779
+ dueOffsetSeconds: integerSchema("Optional new due offset in seconds."),
3780
+ scheduledStartOffsetSeconds: integerSchema("Optional new scheduled-start offset in seconds."),
3781
+ scheduledEndOffsetSeconds: integerSchema("Optional new scheduled-end offset in seconds."),
3782
+ allDay: booleanSchema("Whether future schedules are all-day."),
3783
+ estimateSeconds: integerSchema("Optional new effort estimate."),
3784
+ archivedAt: integerSchema("Optional archive timestamp."),
3785
+ now: integerSchema("Evaluation or update timestamp.")
3786
+ },
3787
+ ["action"],
3788
+ "Manage repeatable quest definitions and due materialization."
3789
+ ),
3819
3790
  handler: manageRepeatableToolHandler
3820
3791
  });
3821
3792
 
@@ -4019,60 +3990,29 @@ var organizeWorkTool = defineQuestlogTool({
4019
3990
  now: "Optional timestamp for unlock changes."
4020
3991
  },
4021
3992
  outputDescription: "Returns the updated questline detail or target quest detail after grouping or dependency changes. Repeated equivalent changes return structured no-op results.",
4022
- inputSchema: {
4023
- type: "object",
4024
- oneOf: [
4025
- objectSchema(
4026
- {
4027
- action: enumSchema("Action to perform.", ["add_unlock"]),
4028
- fromQuestId: integerSchema("Prerequisite quest id."),
4029
- now: integerSchema("Optional timestamp for the unlock change."),
4030
- toQuestId: integerSchema("Quest whose blockers should change.")
4031
- },
4032
- ["action", "fromQuestId", "toQuestId"]
4033
- ),
4034
- objectSchema(
4035
- {
4036
- action: enumSchema("Action to perform.", ["archive_questline"]),
4037
- archivedAt: integerSchema("Optional archive timestamp."),
4038
- questlineId: integerSchema("Questline to archive.")
4039
- },
4040
- ["action", "questlineId"]
4041
- ),
4042
- objectSchema(
4043
- {
4044
- action: enumSchema("Action to perform.", ["remove_unlock"]),
4045
- fromQuestId: integerSchema("Prerequisite quest id."),
4046
- now: integerSchema("Optional timestamp for the unlock change."),
4047
- toQuestId: integerSchema("Quest whose blockers should change.")
4048
- },
4049
- ["action", "fromQuestId", "toQuestId"]
4050
- ),
4051
- objectSchema(
4052
- {
4053
- action: enumSchema("Action to perform.", ["replace_unlocks"]),
4054
- fromQuestIds: arraySchema(integerSchema("Quest id."), "Full prerequisite quest id set."),
4055
- now: integerSchema("Optional timestamp for the unlock change."),
4056
- toQuestId: integerSchema("Quest whose blockers should change.")
4057
- },
4058
- ["action", "fromQuestIds", "toQuestId"]
4059
- ),
4060
- objectSchema(
4061
- {
4062
- action: enumSchema("Action to perform.", ["set_questline_fields"]),
4063
- questlineId: integerSchema("Questline to update."),
4064
- title: stringSchema("Optional new questline title."),
4065
- description: stringSchema("Optional new questline description."),
4066
- startsAt: integerSchema("Optional questline start timestamp."),
4067
- dueAt: integerSchema("Optional questline due timestamp."),
4068
- archivedAt: integerSchema("Optional archive timestamp."),
4069
- now: integerSchema("Optional update timestamp.")
4070
- },
4071
- ["action", "questlineId"]
4072
- )
4073
- ],
4074
- description: "Organize questline fields and unlock dependencies."
4075
- },
3993
+ inputSchema: objectSchema(
3994
+ {
3995
+ action: enumSchema("Action to perform.", [
3996
+ "add_unlock",
3997
+ "archive_questline",
3998
+ "remove_unlock",
3999
+ "replace_unlocks",
4000
+ "set_questline_fields"
4001
+ ]),
4002
+ questlineId: integerSchema("Questline to update or archive."),
4003
+ title: stringSchema("Optional new questline title."),
4004
+ description: stringSchema("Optional new questline description."),
4005
+ startsAt: integerSchema("Optional questline start timestamp."),
4006
+ dueAt: integerSchema("Optional questline due timestamp."),
4007
+ archivedAt: integerSchema("Optional archive timestamp."),
4008
+ toQuestId: integerSchema("Quest whose blockers should change."),
4009
+ fromQuestId: integerSchema("Prerequisite quest id."),
4010
+ fromQuestIds: arraySchema(integerSchema("Quest id."), "Full prerequisite quest id set."),
4011
+ now: integerSchema("Optional timestamp.")
4012
+ },
4013
+ ["action"],
4014
+ "Organize questline fields and unlock dependencies."
4015
+ ),
4076
4016
  handler: organizeWorkToolHandler
4077
4017
  });
4078
4018
 
@@ -4162,35 +4102,22 @@ var planQuestTool = defineQuestlogTool({
4162
4102
  now: "Optional timestamp for updating the quest."
4163
4103
  },
4164
4104
  outputDescription: "Returns the updated quest detail after objective or planning changes. If the requested planning state is already present, the tool returns a structured no-op result.",
4165
- inputSchema: {
4166
- type: "object",
4167
- oneOf: [
4168
- objectSchema(
4169
- {
4170
- action: enumSchema("Action to perform.", ["revise_objective"]),
4171
- now: integerSchema("Optional update timestamp."),
4172
- objective: stringSchema("The new quest objective text."),
4173
- questId: integerSchema("The quest to refine.")
4174
- },
4175
- ["action", "questId", "objective"]
4176
- ),
4177
- objectSchema(
4178
- {
4179
- action: enumSchema("Action to perform.", ["set_time"]),
4180
- questId: integerSchema("The quest to refine."),
4181
- notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
4182
- dueAt: integerSchema("Optional latest acceptable completion timestamp."),
4183
- scheduledStartAt: integerSchema("Optional planned schedule window start."),
4184
- scheduledEndAt: integerSchema("Optional planned schedule window end."),
4185
- allDay: booleanSchema("Whether the planned schedule window is all-day."),
4186
- estimateSeconds: integerSchema("Optional active-effort estimate in seconds."),
4187
- now: integerSchema("Optional update timestamp.")
4188
- },
4189
- ["action", "questId"]
4190
- )
4191
- ],
4192
- description: "Refine a quest objective or planning state."
4193
- },
4105
+ inputSchema: objectSchema(
4106
+ {
4107
+ action: enumSchema("Action to perform.", ["revise_objective", "set_time"]),
4108
+ questId: integerSchema("The quest to refine."),
4109
+ objective: stringSchema("The new quest objective text. Required for revise_objective."),
4110
+ notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
4111
+ dueAt: integerSchema("Optional latest acceptable completion timestamp."),
4112
+ scheduledStartAt: integerSchema("Optional planned schedule window start."),
4113
+ scheduledEndAt: integerSchema("Optional planned schedule window end."),
4114
+ allDay: booleanSchema("Whether the planned schedule window is all-day."),
4115
+ estimateSeconds: integerSchema("Optional active-effort estimate in seconds."),
4116
+ now: integerSchema("Optional update timestamp.")
4117
+ },
4118
+ ["action", "questId"],
4119
+ "Refine a quest objective or planning state."
4120
+ ),
4194
4121
  handler: planQuestToolHandler
4195
4122
  });
4196
4123
 
@@ -4746,105 +4673,46 @@ var rewardWorkTool = defineQuestlogTool({
4746
4673
  now: "Optional timestamp for removing a reward or replacing repeatable reward templates."
4747
4674
  },
4748
4675
  outputDescription: "Returns the updated or claimed reward when one concrete reward changes, or a structured success result for repeatable future template replacement. Already-claimed rewards return a structured no-op for claim and an error for invalid update or remove attempts.",
4749
- inputSchema: {
4750
- type: "object",
4751
- oneOf: [
4752
- objectSchema(
4676
+ inputSchema: objectSchema(
4677
+ {
4678
+ action: enumSchema("Action to perform.", [
4679
+ "add",
4680
+ "claim",
4681
+ "remove",
4682
+ "replace_repeatable_template",
4683
+ "update"
4684
+ ]),
4685
+ target: objectSchema(
4753
4686
  {
4754
- action: enumSchema("Action to perform.", ["add"]),
4755
- reward: objectSchema(
4756
- {
4757
- kind: stringSchema("Reward kind."),
4758
- name: stringSchema("Reward name.")
4759
- },
4760
- ["kind", "name"]
4761
- ),
4762
- target: objectSchema(
4763
- {
4764
- id: integerSchema("Quest id."),
4765
- kind: enumSchema("Target kind.", ["quest"])
4766
- },
4767
- ["id", "kind"]
4768
- )
4687
+ id: integerSchema("Target entity id."),
4688
+ kind: enumSchema("Target kind.", ["quest", "reward", "repeatable_quest"])
4769
4689
  },
4770
- ["action", "reward", "target"]
4690
+ ["id", "kind"]
4771
4691
  ),
4772
- objectSchema(
4692
+ reward: objectSchema(
4773
4693
  {
4774
- action: enumSchema("Action to perform.", ["claim"]),
4775
- claimedAt: integerSchema("Optional claim timestamp."),
4776
- target: objectSchema(
4777
- {
4778
- id: integerSchema("Reward id."),
4779
- kind: enumSchema("Target kind.", ["reward"])
4780
- },
4781
- ["id", "kind"]
4782
- )
4694
+ kind: stringSchema("Reward kind."),
4695
+ name: stringSchema("Reward name."),
4696
+ now: integerSchema("Optional update timestamp for the update action.")
4783
4697
  },
4784
- ["action", "target"]
4698
+ []
4785
4699
  ),
4786
- objectSchema(
4787
- {
4788
- action: enumSchema("Action to perform.", ["remove"]),
4789
- now: integerSchema("Optional removal timestamp."),
4790
- target: objectSchema(
4791
- {
4792
- id: integerSchema("Reward id."),
4793
- kind: enumSchema("Target kind.", ["reward"])
4794
- },
4795
- ["id", "kind"]
4796
- )
4797
- },
4798
- ["action", "target"]
4799
- ),
4800
- objectSchema(
4801
- {
4802
- action: enumSchema("Action to perform.", ["replace_repeatable_template"]),
4803
- now: integerSchema("Optional timestamp for replacing templates."),
4804
- rewards: arraySchema(
4805
- objectSchema(
4806
- {
4807
- kind: stringSchema("Reward kind."),
4808
- name: stringSchema("Reward name.")
4809
- },
4810
- ["kind", "name"]
4811
- ),
4812
- "Full future reward template set."
4813
- ),
4814
- target: objectSchema(
4815
- {
4816
- id: integerSchema("Repeatable quest id."),
4817
- kind: enumSchema("Target kind.", ["repeatable_quest"])
4818
- },
4819
- ["id", "kind"]
4820
- )
4821
- },
4822
- ["action", "target", "rewards"]
4700
+ rewards: arraySchema(
4701
+ objectSchema(
4702
+ {
4703
+ kind: stringSchema("Reward kind."),
4704
+ name: stringSchema("Reward name.")
4705
+ },
4706
+ ["kind", "name"]
4707
+ ),
4708
+ "Full future reward template set. Required for replace_repeatable_template."
4823
4709
  ),
4824
- objectSchema(
4825
- {
4826
- action: enumSchema("Action to perform.", ["update"]),
4827
- reward: objectSchema(
4828
- {
4829
- kind: stringSchema("Optional reward kind."),
4830
- name: stringSchema("Optional reward name."),
4831
- now: integerSchema("Optional update timestamp.")
4832
- },
4833
- []
4834
- ),
4835
- target: objectSchema(
4836
- {
4837
- id: integerSchema("Reward id."),
4838
- kind: enumSchema("Target kind.", ["reward"])
4839
- },
4840
- ["id", "kind"]
4841
- )
4842
- },
4843
- ["action", "target", "reward"]
4844
- )
4845
- ],
4846
- description: "Manage quest rewards and repeatable reward templates."
4847
- },
4710
+ claimedAt: integerSchema("Optional claim timestamp."),
4711
+ now: integerSchema("Optional timestamp for removal or template replacement.")
4712
+ },
4713
+ ["action", "target"],
4714
+ "Manage quest rewards and repeatable reward templates."
4715
+ ),
4848
4716
  handler: rewardWorkToolHandler
4849
4717
  });
4850
4718
 
@@ -5000,66 +4868,39 @@ var runQuestTool = defineQuestlogTool({
5000
4868
  followups: "Follow-up quest creation inputs used only for the abandon-and-spawn-followups action."
5001
4869
  },
5002
4870
  outputDescription: "Returns the updated quest detail after the selected lifecycle action, plus purpose-shaped primary, updated, and created refs when follow-up work is spawned. Safe repeated starts return structured no-op results.",
5003
- inputSchema: {
5004
- type: "object",
5005
- oneOf: [
5006
- objectSchema(
5007
- {
5008
- action: enumSchema("Action to perform.", ["abandon"]),
5009
- outcome: stringSchema("Terminal outcome text."),
5010
- questId: integerSchema("Quest to abandon."),
5011
- resolvedAt: integerSchema("Optional resolved timestamp.")
5012
- },
5013
- ["action", "questId", "outcome"]
5014
- ),
5015
- objectSchema(
5016
- {
5017
- action: enumSchema("Action to perform.", ["abandon_and_spawn_followups"]),
5018
- followups: arraySchema(
5019
- objectSchema(
5020
- {
5021
- title: stringSchema("Title for a follow-up quest."),
5022
- objective: stringSchema("Objective for a follow-up quest.")
5023
- },
5024
- ["title", "objective"]
5025
- ),
5026
- "Follow-up quests to create atomically."
5027
- ),
5028
- outcome: stringSchema("Terminal outcome text."),
5029
- questId: integerSchema("Quest to abandon."),
5030
- resolvedAt: integerSchema("Optional resolved timestamp.")
5031
- },
5032
- ["action", "questId", "outcome", "followups"]
4871
+ inputSchema: objectSchema(
4872
+ {
4873
+ action: enumSchema("Action to perform.", [
4874
+ "start",
4875
+ "log_effort",
4876
+ "finish",
4877
+ "abandon",
4878
+ "abandon_and_spawn_followups"
4879
+ ]),
4880
+ questId: integerSchema("Quest whose execution state should change."),
4881
+ startedAt: integerSchema("Optional start timestamp for the start action."),
4882
+ effortSeconds: integerSchema(
4883
+ "Positive active-effort increment in seconds. Required for log_effort."
5033
4884
  ),
5034
- objectSchema(
5035
- {
5036
- action: enumSchema("Action to perform.", ["finish"]),
5037
- outcome: stringSchema("Terminal outcome text."),
5038
- questId: integerSchema("Quest to finish."),
5039
- resolvedAt: integerSchema("Optional resolved timestamp.")
5040
- },
5041
- ["action", "questId", "outcome"]
4885
+ now: integerSchema("Optional effort-log timestamp."),
4886
+ outcome: stringSchema(
4887
+ "Terminal outcome text. Required for finish, abandon, and abandon_and_spawn_followups."
5042
4888
  ),
5043
- objectSchema(
5044
- {
5045
- action: enumSchema("Action to perform.", ["log_effort"]),
5046
- effortSeconds: integerSchema("Positive active-effort increment in seconds."),
5047
- now: integerSchema("Optional effort-log timestamp."),
5048
- questId: integerSchema("Quest to update.")
5049
- },
5050
- ["action", "questId", "effortSeconds"]
5051
- ),
5052
- objectSchema(
5053
- {
5054
- action: enumSchema("Action to perform.", ["start"]),
5055
- questId: integerSchema("Quest to start."),
5056
- startedAt: integerSchema("Optional start timestamp.")
5057
- },
5058
- ["action", "questId"]
4889
+ resolvedAt: integerSchema("Optional resolved timestamp for finish or abandon actions."),
4890
+ followups: arraySchema(
4891
+ objectSchema(
4892
+ {
4893
+ title: stringSchema("Title for a follow-up quest."),
4894
+ objective: stringSchema("Objective for a follow-up quest.")
4895
+ },
4896
+ ["title", "objective"]
4897
+ ),
4898
+ "Follow-up quests to create atomically. Required for abandon_and_spawn_followups."
5059
4899
  )
5060
- ],
5061
- description: "Run quest lifecycle actions."
5062
- },
4900
+ },
4901
+ ["action", "questId"],
4902
+ "Run quest lifecycle actions."
4903
+ ),
5063
4904
  handler: runQuestToolHandler
5064
4905
  });
5065
4906
 
@@ -5391,8 +5232,8 @@ function shapeWorkToolHandler(db, input) {
5391
5232
  }
5392
5233
  var shapeWorkTool = defineQuestlogTool({
5393
5234
  name: shapeWorkToolName,
5394
- description: "Shape real work structure by settling rumors, creating quests or questlines, and attaching or detaching quests from questlines.",
5395
- whenToUse: "Use this when deciding what real work exists and how it should be grouped before or around execution.",
5235
+ description: "Create a quest (with timing, tags, and objective in one call), create a questline, settle a rumor into concrete work, or manage quest-questline membership. Use create_quest for clear commitments \u2014 include tags and timing directly to avoid follow-up calls.",
5236
+ whenToUse: "Use this when deciding what real work exists and how it should be grouped before or around execution. Prefer a single create_quest call with all fields over separate create + plan_quest + tag_work calls.",
5396
5237
  whenNotToUse: "Do not use this for quest execution steps like starting, finishing, abandoning, or logging effort.",
5397
5238
  sideEffects: "writes_state",
5398
5239
  readOnly: false,
@@ -5401,104 +5242,96 @@ var shapeWorkTool = defineQuestlogTool({
5401
5242
  inputDescriptions: {
5402
5243
  action: "Which structure-shaping action to perform, such as settling a rumor, creating a quest, or attaching a quest to a questline.",
5403
5244
  rumorId: "The rumor to dismiss, reopen, or settle when the action targets intake.",
5404
- questline: "Questline creation data used when creating a questline directly or as part of rumor settlement.",
5405
- quests: "Concrete quest creation inputs used when settling a rumor into real work.",
5245
+ questline: "Questline creation data used when creating a questline directly or as part of rumor settlement. Include description for context.",
5246
+ quests: "Concrete quest creation inputs when settling a rumor into real work. Each quest supports the same fields as the quest property \u2014 include timing and tags directly.",
5406
5247
  settledAt: "Optional settlement timestamp for rumor settlement.",
5407
- quest: "Quest creation input used when directly creating one concrete quest.",
5248
+ quest: "Quest creation input when directly creating one concrete quest. Include timing fields (dueAt, scheduledStartAt, etc.), tags, and rewards to create a fully specified quest in one call.",
5408
5249
  questId: "The concrete quest being attached to or detached from a questline.",
5409
5250
  questlineId: "The questline that should receive the quest for attach actions.",
5410
5251
  dismissedAt: "Optional dismissal timestamp for dismissing a rumor.",
5411
5252
  now: "Optional timestamp for reopen or questline membership changes."
5412
5253
  },
5413
5254
  outputDescription: "Returns the changed or created rumor, quest, questline, or created quest set for the selected shape-work action, plus purpose-shaped primary and created or updated refs. Repeated safe actions return structured no-op results, and rumor settlement can ask for missing structure instead of failing.",
5414
- inputSchema: {
5415
- type: "object",
5416
- oneOf: [
5417
- objectSchema(
5418
- {
5419
- action: enumSchema("Action to perform.", ["attach_quest_to_questline"]),
5420
- now: integerSchema("Optional timestamp for the membership change."),
5421
- questId: integerSchema("Quest to attach."),
5422
- questlineId: integerSchema("Questline that should receive the quest.")
5423
- },
5424
- ["action", "questId", "questlineId"]
5425
- ),
5426
- objectSchema(
5427
- {
5428
- action: enumSchema("Action to perform.", ["create_quest"]),
5429
- quest: objectSchema(
5430
- {
5431
- title: stringSchema("Title for the new quest."),
5432
- objective: stringSchema("Objective for the new quest.")
5433
- },
5434
- ["title", "objective"]
5435
- )
5436
- },
5437
- ["action", "quest"]
5438
- ),
5439
- objectSchema(
5440
- {
5441
- action: enumSchema("Action to perform.", ["create_questline"]),
5442
- questline: objectSchema(
5443
- {
5444
- title: stringSchema("Title for the new questline.")
5445
- },
5446
- ["title"]
5447
- )
5448
- },
5449
- ["action", "questline"]
5450
- ),
5451
- objectSchema(
5452
- {
5453
- action: enumSchema("Action to perform.", ["detach_quest_from_questline"]),
5454
- now: integerSchema("Optional timestamp for the membership change."),
5455
- questId: integerSchema("Quest to detach.")
5456
- },
5457
- ["action", "questId"]
5458
- ),
5459
- objectSchema(
5255
+ inputSchema: objectSchema(
5256
+ {
5257
+ action: enumSchema("Action to perform.", [
5258
+ "attach_quest_to_questline",
5259
+ "create_quest",
5260
+ "create_questline",
5261
+ "detach_quest_from_questline",
5262
+ "dismiss_rumor",
5263
+ "reopen_rumor",
5264
+ "settle_rumor"
5265
+ ]),
5266
+ questId: integerSchema("Quest to attach or detach."),
5267
+ questlineId: integerSchema("Questline that should receive the quest."),
5268
+ quest: objectSchema(
5460
5269
  {
5461
- action: enumSchema("Action to perform.", ["dismiss_rumor"]),
5462
- dismissedAt: integerSchema("Optional dismissal timestamp."),
5463
- rumorId: integerSchema("Rumor to dismiss.")
5270
+ title: stringSchema("Title for the new quest."),
5271
+ objective: stringSchema("Objective for the new quest."),
5272
+ questlineId: integerSchema("Optional questline to place the quest in."),
5273
+ tags: arraySchema(stringSchema("Tag name."), "Optional tags to apply at creation."),
5274
+ rewards: arraySchema(
5275
+ objectSchema(
5276
+ {
5277
+ kind: stringSchema("Reward kind."),
5278
+ name: stringSchema("Reward name.")
5279
+ },
5280
+ ["kind", "name"]
5281
+ ),
5282
+ "Optional rewards to attach at creation."
5283
+ ),
5284
+ dueAt: integerSchema("Optional latest acceptable completion timestamp."),
5285
+ notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
5286
+ scheduledStartAt: integerSchema("Optional planned schedule window start."),
5287
+ scheduledEndAt: integerSchema("Optional planned schedule window end."),
5288
+ allDay: booleanSchema("Whether the scheduled window is all-day."),
5289
+ estimateSeconds: integerSchema("Optional active-effort estimate in seconds.")
5464
5290
  },
5465
- ["action", "rumorId"]
5291
+ ["title", "objective"]
5466
5292
  ),
5467
- objectSchema(
5293
+ questline: objectSchema(
5468
5294
  {
5469
- action: enumSchema("Action to perform.", ["reopen_rumor"]),
5470
- now: integerSchema("Optional reopen timestamp."),
5471
- rumorId: integerSchema("Rumor to reopen.")
5295
+ title: stringSchema("Questline title."),
5296
+ description: stringSchema("Optional questline description.")
5472
5297
  },
5473
- ["action", "rumorId"]
5298
+ []
5474
5299
  ),
5475
- objectSchema(
5476
- {
5477
- action: enumSchema("Action to perform.", ["settle_rumor"]),
5478
- rumorId: integerSchema("Rumor to settle."),
5479
- settledAt: integerSchema("Optional settlement timestamp."),
5480
- questline: objectSchema(
5481
- {
5482
- title: stringSchema("Optional questline title to create during settlement.")
5483
- },
5484
- []
5485
- ),
5486
- quests: arraySchema(
5487
- objectSchema(
5488
- {
5489
- title: stringSchema("Title for a created quest."),
5490
- objective: stringSchema("Objective for a created quest.")
5491
- },
5492
- ["title", "objective"]
5300
+ rumorId: integerSchema("Rumor to settle, dismiss, or reopen."),
5301
+ dismissedAt: integerSchema("Optional dismissal timestamp."),
5302
+ settledAt: integerSchema("Optional settlement timestamp."),
5303
+ quests: arraySchema(
5304
+ objectSchema(
5305
+ {
5306
+ title: stringSchema("Title for a created quest."),
5307
+ objective: stringSchema("Objective for a created quest."),
5308
+ tags: arraySchema(stringSchema("Tag name."), "Optional tags to apply at creation."),
5309
+ rewards: arraySchema(
5310
+ objectSchema(
5311
+ {
5312
+ kind: stringSchema("Reward kind."),
5313
+ name: stringSchema("Reward name.")
5314
+ },
5315
+ ["kind", "name"]
5316
+ ),
5317
+ "Optional rewards to attach at creation."
5493
5318
  ),
5494
- "Optional quests to create during settlement."
5495
- )
5496
- },
5497
- ["action", "rumorId"]
5498
- )
5499
- ],
5500
- description: "Shape the work graph by settling rumors, creating work, or moving quests into questlines."
5501
- },
5319
+ dueAt: integerSchema("Optional latest acceptable completion timestamp."),
5320
+ notBeforeAt: integerSchema("Optional earliest actionable timestamp."),
5321
+ scheduledStartAt: integerSchema("Optional planned schedule window start."),
5322
+ scheduledEndAt: integerSchema("Optional planned schedule window end."),
5323
+ allDay: booleanSchema("Whether the scheduled window is all-day."),
5324
+ estimateSeconds: integerSchema("Optional active-effort estimate in seconds.")
5325
+ },
5326
+ ["title", "objective"]
5327
+ ),
5328
+ "Quests to create during rumor settlement. Include timing and tags directly."
5329
+ ),
5330
+ now: integerSchema("Optional timestamp for membership or reopen changes.")
5331
+ },
5332
+ ["action"],
5333
+ "Create quests with timing and tags, create questlines, settle rumors into work, or manage quest-questline membership."
5334
+ ),
5502
5335
  handler: shapeWorkToolHandler
5503
5336
  });
5504
5337
 
@@ -5698,60 +5531,22 @@ var tagWorkTool = defineQuestlogTool({
5698
5531
  now: "Optional timestamp for the tag mutation."
5699
5532
  },
5700
5533
  outputDescription: "Returns the normalized final tag set for the target after the selected tag action. Repeated equivalent changes return structured no-op results.",
5701
- inputSchema: {
5702
- type: "object",
5703
- oneOf: [
5704
- objectSchema(
5705
- {
5706
- action: enumSchema("Action to perform.", ["add"]),
5707
- now: integerSchema("Optional timestamp for the tag mutation."),
5708
- tagNames: arraySchema(stringSchema("Tag name."), "Tags to add."),
5709
- target: objectSchema(
5710
- {
5711
- id: integerSchema("Quest id."),
5712
- kind: enumSchema("Target kind.", ["quest"])
5713
- },
5714
- ["id", "kind"]
5715
- )
5716
- },
5717
- ["action", "target", "tagNames"]
5718
- ),
5719
- objectSchema(
5534
+ inputSchema: objectSchema(
5535
+ {
5536
+ action: enumSchema("Action to perform.", ["add", "remove", "replace"]),
5537
+ target: objectSchema(
5720
5538
  {
5721
- action: enumSchema("Action to perform.", ["remove"]),
5722
- now: integerSchema("Optional timestamp for the tag mutation."),
5723
- tagNames: arraySchema(stringSchema("Tag name."), "Tags to remove."),
5724
- target: objectSchema(
5725
- {
5726
- id: integerSchema("Quest id."),
5727
- kind: enumSchema("Target kind.", ["quest"])
5728
- },
5729
- ["id", "kind"]
5730
- )
5539
+ id: integerSchema("Target entity id."),
5540
+ kind: enumSchema("Target kind.", ["quest", "repeatable_quest"])
5731
5541
  },
5732
- ["action", "target", "tagNames"]
5542
+ ["id", "kind"]
5733
5543
  ),
5734
- objectSchema(
5735
- {
5736
- action: enumSchema("Action to perform.", ["replace"]),
5737
- now: integerSchema("Optional timestamp for the tag mutation."),
5738
- tagNames: arraySchema(
5739
- stringSchema("Tag name."),
5740
- "Tags to make the full replacement set."
5741
- ),
5742
- target: objectSchema(
5743
- {
5744
- id: integerSchema("Target id."),
5745
- kind: enumSchema("Target kind.", ["quest", "repeatable_quest"])
5746
- },
5747
- ["id", "kind"]
5748
- )
5749
- },
5750
- ["action", "target", "tagNames"]
5751
- )
5752
- ],
5753
- description: "Mutate tags on quests or repeatable quests."
5754
- },
5544
+ tagNames: arraySchema(stringSchema("Tag name."), "Tag names to add, remove, or replace."),
5545
+ now: integerSchema("Optional timestamp for the tag mutation.")
5546
+ },
5547
+ ["action", "target", "tagNames"],
5548
+ "Mutate tags on quests or repeatable quests."
5549
+ ),
5755
5550
  handler: tagWorkToolHandler
5756
5551
  });
5757
5552