@miguelarios/cal-mcp 0.20.0 → 1.0.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.
- package/CHANGELOG.md +51 -0
- package/LICENSE +21 -0
- package/README.md +8 -3
- package/dist/main.d.ts +2 -2
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +1 -1
- package/dist/main.js.map +1 -1
- package/dist/providers/CalendarBackend.d.ts +94 -0
- package/dist/providers/CalendarBackend.d.ts.map +1 -0
- package/dist/providers/CalendarBackend.js +2 -0
- package/dist/providers/CalendarBackend.js.map +1 -0
- package/dist/providers/types.d.ts +98 -0
- package/dist/providers/types.d.ts.map +1 -0
- package/dist/providers/types.js +2 -0
- package/dist/providers/types.js.map +1 -0
- package/dist/services/CalDavService.d.ts +40 -92
- package/dist/services/CalDavService.d.ts.map +1 -1
- package/dist/services/CalDavService.js +210 -64
- package/dist/services/CalDavService.js.map +1 -1
- package/dist/services/sharing.d.ts +39 -0
- package/dist/services/sharing.d.ts.map +1 -0
- package/dist/services/sharing.js +253 -0
- package/dist/services/sharing.js.map +1 -0
- package/dist/services/urlCache.d.ts +1 -1
- package/dist/services/urlCache.js +2 -2
- package/dist/services/urlCache.js.map +1 -1
- package/dist/tools/calendarManagementTools.d.ts +3 -3
- package/dist/tools/calendarManagementTools.d.ts.map +1 -1
- package/dist/tools/calendarManagementTools.js +108 -33
- package/dist/tools/calendarManagementTools.js.map +1 -1
- package/dist/tools/calendarSchemas.d.ts +67 -45
- package/dist/tools/calendarSchemas.d.ts.map +1 -1
- package/dist/tools/calendarSchemas.js +35 -14
- package/dist/tools/calendarSchemas.js.map +1 -1
- package/dist/tools/calendarTools.d.ts +2 -2
- package/dist/tools/calendarTools.d.ts.map +1 -1
- package/dist/tools/calendarTools.js +160 -112
- package/dist/tools/calendarTools.js.map +1 -1
- package/package.json +8 -4
|
@@ -5,20 +5,20 @@
|
|
|
5
5
|
*
|
|
6
6
|
* They mirror `CalendarInfo`, `EventSummary`, `EventFull` and `FreeSlot` from
|
|
7
7
|
* `../services/CalDavService.js`. `list_events` and friends can return either
|
|
8
|
-
* the summary or the full shape depending on `
|
|
8
|
+
* the summary or the full shape depending on `detailLevel`, so the event
|
|
9
9
|
* schema is the summary shape with every full-only field optional.
|
|
10
10
|
*/
|
|
11
11
|
import * as v from "valibot";
|
|
12
12
|
const nullableString = v.nullable(v.string());
|
|
13
13
|
export const calendarSchema = v.object({
|
|
14
|
-
|
|
15
|
-
|
|
14
|
+
calendarId: v.string(),
|
|
15
|
+
displayName: v.string(),
|
|
16
16
|
color: nullableString,
|
|
17
17
|
description: nullableString,
|
|
18
18
|
timezone: nullableString,
|
|
19
19
|
order: v.nullable(v.number()),
|
|
20
20
|
source: v.string(),
|
|
21
|
-
|
|
21
|
+
readOnly: v.boolean(),
|
|
22
22
|
url: v.string(),
|
|
23
23
|
ctag: v.optional(v.string()),
|
|
24
24
|
});
|
|
@@ -32,37 +32,44 @@ const attendeeSchema = v.object({
|
|
|
32
32
|
const alarmSchema = v.object({
|
|
33
33
|
type: v.picklist(["relative", "absolute"]),
|
|
34
34
|
trigger: v.union([v.number(), v.string()]),
|
|
35
|
-
|
|
35
|
+
triggerHuman: v.string(),
|
|
36
36
|
});
|
|
37
37
|
/** Summary fields, plus the full-detail fields as optional. */
|
|
38
38
|
export const eventSchema = v.object({
|
|
39
39
|
uid: v.string(),
|
|
40
|
-
|
|
40
|
+
calendarId: v.string(),
|
|
41
41
|
title: v.string(),
|
|
42
42
|
start: v.string(),
|
|
43
43
|
end: v.string(),
|
|
44
|
-
|
|
44
|
+
allDay: v.boolean(),
|
|
45
45
|
location: nullableString,
|
|
46
46
|
status: nullableString,
|
|
47
|
-
|
|
48
|
-
|
|
47
|
+
isRecurring: v.boolean(),
|
|
48
|
+
occurrenceDate: nullableString,
|
|
49
49
|
description: v.optional(nullableString),
|
|
50
50
|
url: v.optional(nullableString),
|
|
51
51
|
availability: v.optional(nullableString),
|
|
52
52
|
attendees: v.optional(v.array(attendeeSchema)),
|
|
53
53
|
organizer: v.optional(v.nullable(v.object({ name: nullableString, email: v.string() }))),
|
|
54
|
-
|
|
54
|
+
recurrenceRule: v.optional(nullableString),
|
|
55
55
|
created: v.optional(nullableString),
|
|
56
|
-
|
|
56
|
+
lastModified: v.optional(nullableString),
|
|
57
57
|
alarms: v.optional(v.array(alarmSchema)),
|
|
58
58
|
categories: v.optional(v.array(v.string())),
|
|
59
59
|
geo: v.optional(v.nullable(v.object({ latitude: v.number(), longitude: v.number() }))),
|
|
60
60
|
});
|
|
61
|
+
/**
|
|
62
|
+
* Present only when a listing spanning every provider skipped some, so a
|
|
63
|
+
* caller can tell "no events" from "could not ask" (#127).
|
|
64
|
+
*/
|
|
65
|
+
const unavailableProvidersSchema = v.optional(v.array(v.object({ provider: v.string(), error: v.string() })));
|
|
61
66
|
export const calendarListSchema = v.object({
|
|
62
67
|
calendars: v.array(calendarSchema),
|
|
68
|
+
unavailableProviders: unavailableProvidersSchema,
|
|
63
69
|
});
|
|
64
70
|
export const eventListSchema = v.object({
|
|
65
71
|
events: v.array(eventSchema),
|
|
72
|
+
unavailableProviders: unavailableProvidersSchema,
|
|
66
73
|
});
|
|
67
74
|
export const singleEventSchema = v.object({
|
|
68
75
|
event: eventSchema,
|
|
@@ -98,14 +105,28 @@ export const freeBusySchema = v.object({
|
|
|
98
105
|
sources: v.record(v.string(), v.picklist(["server", "computed"])),
|
|
99
106
|
});
|
|
100
107
|
/**
|
|
101
|
-
* Result of the three collection-management tools. `
|
|
108
|
+
* Result of the three collection-management tools. `calendarId` is always the
|
|
102
109
|
* post-operation ID, so a rename hands back the ID that resolves from now on
|
|
103
110
|
* rather than the one the caller passed in.
|
|
104
111
|
*/
|
|
105
112
|
export const calendarWriteResultSchema = v.object({
|
|
106
113
|
status: v.picklist(["created", "updated", "deleted"]),
|
|
107
|
-
|
|
114
|
+
calendarId: v.string(),
|
|
108
115
|
url: v.string(),
|
|
109
|
-
|
|
116
|
+
displayName: v.optional(v.string()),
|
|
117
|
+
});
|
|
118
|
+
/** get_calendar_sharing, share_calendar and unshare_calendar (#47). */
|
|
119
|
+
export const calendarSharingSchema = v.object({
|
|
120
|
+
calendarId: v.string(),
|
|
121
|
+
canBeShared: v.boolean(),
|
|
122
|
+
canBePublished: v.boolean(),
|
|
123
|
+
protocol: v.nullable(v.picklist(["calendarserver", "owncloud", "webdav"])),
|
|
124
|
+
shares: v.array(v.object({
|
|
125
|
+
email: nullableString,
|
|
126
|
+
principal: nullableString,
|
|
127
|
+
name: nullableString,
|
|
128
|
+
access: v.picklist(["read", "read-write"]),
|
|
129
|
+
status: v.picklist(["accepted", "pending", "declined", "invalid"]),
|
|
130
|
+
})),
|
|
110
131
|
});
|
|
111
132
|
//# sourceMappingURL=calendarSchemas.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"calendarSchemas.js","sourceRoot":"","sources":["../../src/tools/calendarSchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B,MAAM,cAAc,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AAE9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,
|
|
1
|
+
{"version":3,"file":"calendarSchemas.js","sourceRoot":"","sources":["../../src/tools/calendarSchemas.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
import { type ToolDef } from "@miguelarios/pim-core/mcp";
|
|
2
|
-
import {
|
|
3
|
-
export declare const CALENDAR_TOOLS: ReadonlyArray<ToolDef<
|
|
2
|
+
import type { IcsCalendarBackend } from "../providers/CalendarBackend.js";
|
|
3
|
+
export declare const CALENDAR_TOOLS: ReadonlyArray<ToolDef<IcsCalendarBackend>>;
|
|
4
4
|
//# sourceMappingURL=calendarTools.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"calendarTools.d.ts","sourceRoot":"","sources":["../../src/tools/calendarTools.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"calendarTools.d.ts","sourceRoot":"","sources":["../../src/tools/calendarTools.ts"],"names":[],"mappings":"AAkBA,OAAO,EAEL,KAAK,OAAO,EAMb,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AA+Q1E,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAq6BrE,CAAC"}
|