@miguelarios/pim-core 0.7.0 → 0.8.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/README.md +10 -0
- package/dist/config.d.ts +1 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +4 -0
- package/dist/config.js.map +1 -1
- package/dist/ics/index.d.ts +1 -0
- package/dist/ics/index.d.ts.map +1 -1
- package/dist/ics/index.js +3 -0
- package/dist/ics/index.js.map +1 -1
- package/dist/mcp/index.d.ts +97 -0
- package/dist/mcp/index.d.ts.map +1 -0
- package/dist/mcp/index.js +135 -0
- package/dist/mcp/index.js.map +1 -0
- package/package.json +8 -2
package/README.md
CHANGED
|
@@ -4,6 +4,16 @@ Shared config, validation, errors, and utilities for PIM agent MCP servers.
|
|
|
4
4
|
|
|
5
5
|
This is an internal library used by [@miguelarios/email-mcp](https://www.npmjs.com/package/@miguelarios/email-mcp), [@miguelarios/cal-mcp](https://www.npmjs.com/package/@miguelarios/cal-mcp), and [@miguelarios/card-mcp](https://www.npmjs.com/package/@miguelarios/card-mcp). You probably don't need to install this directly.
|
|
6
6
|
|
|
7
|
+
## Entry points
|
|
8
|
+
|
|
9
|
+
| Import | Contents |
|
|
10
|
+
|--------|----------|
|
|
11
|
+
| `@miguelarios/pim-core` | Config loading, `PimError` hierarchy and `ErrorCode`, vCard parse/build, timezone helpers |
|
|
12
|
+
| `@miguelarios/pim-core/ics` | iCalendar parsing, generation, and component mutation |
|
|
13
|
+
| `@miguelarios/pim-core/mcp` | MCP plumbing for revision 2026-07-28 — `ToolDef`, `registerTools`, `dispatchTool`, result helpers (`structured`, `fail`, `toolError`), and `confirmDestructive` |
|
|
14
|
+
|
|
15
|
+
Only the `/mcp` subpath pulls in `@modelcontextprotocol/server`; the other two are protocol-agnostic.
|
|
16
|
+
|
|
7
17
|
## License
|
|
8
18
|
|
|
9
19
|
MIT
|
package/dist/config.d.ts
CHANGED
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiBD,wBAAgB,iBAAiB,IAAI,aAAa,CAwBjD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CA2C/C;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiBD,wBAAgB,iBAAiB,IAAI,aAAa,CAwBjD;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wBAAgB,gBAAgB,IAAI,YAAY,CA2C/C;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAWD,wBAAgB,eAAe,IAAI,WAAW,CA+C7C"}
|
package/dist/config.js
CHANGED
|
@@ -106,6 +106,10 @@ export function loadEmailConfig() {
|
|
|
106
106
|
},
|
|
107
107
|
fromName: process.env.SMTP_FROM_NAME || undefined,
|
|
108
108
|
autoSent: process.env.SMTP_AUTO_SENT === "true",
|
|
109
|
+
allowedFrom: (process.env.SMTP_ALLOWED_FROM || "")
|
|
110
|
+
.split(",")
|
|
111
|
+
.map((value) => value.trim())
|
|
112
|
+
.filter(Boolean),
|
|
109
113
|
};
|
|
110
114
|
}
|
|
111
115
|
catch (error) {
|
package/dist/config.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
|
package/dist/ics/index.d.ts
CHANGED
|
@@ -6,6 +6,7 @@ export { parseIcsEvents } from "./parse-events.js";
|
|
|
6
6
|
export { parseIcsTodos } from "./parse-todos.js";
|
|
7
7
|
export { parseIcsJournals } from "./parse-journals.js";
|
|
8
8
|
export { generateEventIcs, toIcalTime } from "./generate.js";
|
|
9
|
+
export { formatTriggerHuman } from "./_shared.js";
|
|
9
10
|
export { createExceptionComponent, combineIcsComponents, addExdateToIcs, removeExceptionFromIcs, updateMasterEventIcs, splitIcsByUid, } from "./components.js";
|
|
10
11
|
export type { ExceptionOverrides, MasterEventUpdates } from "./components.js";
|
|
11
12
|
//# sourceMappingURL=index.d.ts.map
|
package/dist/ics/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ics/index.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ics/index.ts"],"names":[],"mappings":"AAGA,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,SAAS,EACT,WAAW,EACX,UAAU,EACV,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACd,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
|
package/dist/ics/index.js
CHANGED
|
@@ -8,5 +8,8 @@ export { parseIcsEvents } from "./parse-events.js";
|
|
|
8
8
|
export { parseIcsTodos } from "./parse-todos.js";
|
|
9
9
|
export { parseIcsJournals } from "./parse-journals.js";
|
|
10
10
|
export { generateEventIcs, toIcalTime } from "./generate.js";
|
|
11
|
+
// Exported so callers that build an event response by hand (rather than by
|
|
12
|
+
// re-reading it) can render `trigger_human` exactly as the parser would.
|
|
13
|
+
export { formatTriggerHuman } from "./_shared.js";
|
|
11
14
|
export { createExceptionComponent, combineIcsComponents, addExdateToIcs, removeExceptionFromIcs, updateMasterEventIcs, splitIcsByUid, } from "./components.js";
|
|
12
15
|
//# sourceMappingURL=index.js.map
|
package/dist/ics/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ics/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AACjF,8CAA8C;AAC9C,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAY9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACd,MAAM,iBAAiB,CAAC"}
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ics/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AACjF,8CAA8C;AAC9C,OAAO,eAAe,CAAC;AAEvB,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAY9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,2EAA2E;AAC3E,yEAAyE;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,aAAa,GACd,MAAM,iBAAiB,CAAC"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { type CallToolResult, type InputRequiredResult, type JsonSchemaType, type McpServer, type ServerContext, type ToolAnnotations } from "@modelcontextprotocol/server";
|
|
2
|
+
import type { GenericSchema } from "valibot";
|
|
3
|
+
import { type PimError } from "../errors.js";
|
|
4
|
+
/** Result a tool handler may return: a finished call, or a request for more input. */
|
|
5
|
+
export type ToolResult = CallToolResult | InputRequiredResult;
|
|
6
|
+
export type { CallToolResult, InputRequiredResult, ServerContext, ToolAnnotations };
|
|
7
|
+
/**
|
|
8
|
+
* A declarative tool definition.
|
|
9
|
+
*
|
|
10
|
+
* Tools stay an inspectable array rather than a pile of `registerTool` calls so
|
|
11
|
+
* they can be asserted over in tests and registered in one place.
|
|
12
|
+
*/
|
|
13
|
+
export interface ToolDef<Service, Args = any> {
|
|
14
|
+
/** Wire name. Must match the spec's `[A-Za-z0-9_.-]`, 1-128 character rule. */
|
|
15
|
+
name: string;
|
|
16
|
+
/** Human-readable display name shown by clients. */
|
|
17
|
+
title: string;
|
|
18
|
+
description: string;
|
|
19
|
+
/**
|
|
20
|
+
* Behaviour hints. Clients use these to decide what to put in front of the
|
|
21
|
+
* user — a host may auto-approve a read-only tool and confirm a destructive
|
|
22
|
+
* one. All four hints are required here so none is forgotten.
|
|
23
|
+
*/
|
|
24
|
+
annotations: Required<Pick<ToolAnnotations, "readOnlyHint" | "destructiveHint" | "idempotentHint" | "openWorldHint">>;
|
|
25
|
+
/** Raw JSON Schema for the arguments. Validated before the handler runs. */
|
|
26
|
+
inputSchema: JsonSchemaType;
|
|
27
|
+
/** Valibot schema describing `structuredContent`. Validated before the result leaves the server. */
|
|
28
|
+
outputSchema?: GenericSchema;
|
|
29
|
+
handler: (args: Args, service: Service, ctx: ServerContext) => Promise<ToolResult>;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Registers every tool against an {@link McpServer}. The SDK derives argument
|
|
33
|
+
* validation from `inputSchema` and validates `structuredContent` against
|
|
34
|
+
* `outputSchema`, so handlers receive checked arguments and cannot emit a
|
|
35
|
+
* result that contradicts its advertised schema.
|
|
36
|
+
*/
|
|
37
|
+
export declare function registerTools<Service>(server: McpServer, defs: ReadonlyArray<ToolDef<Service>>, service: Service): void;
|
|
38
|
+
/**
|
|
39
|
+
* Invokes one tool's handler by name, bypassing the MCP transport.
|
|
40
|
+
*
|
|
41
|
+
* Useful for testing handlers in isolation and for embedding the tools without
|
|
42
|
+
* a protocol layer. Argument validation lives in the SDK's `tools/call` path,
|
|
43
|
+
* so callers of this function are responsible for passing well-formed `args`.
|
|
44
|
+
*/
|
|
45
|
+
export declare function dispatchTool<Service>(defs: ReadonlyArray<ToolDef<Service>>, name: string, args: Record<string, unknown>, service: Service, ctx?: ServerContext): Promise<ToolResult>;
|
|
46
|
+
/** A successful result carrying only human-readable text. */
|
|
47
|
+
export declare function ok(text: string): CallToolResult;
|
|
48
|
+
/**
|
|
49
|
+
* A successful result carrying machine-readable data.
|
|
50
|
+
*
|
|
51
|
+
* The spec requires a tool returning structured content to also return the
|
|
52
|
+
* serialized JSON in a text block, for clients that do not read
|
|
53
|
+
* `structuredContent`.
|
|
54
|
+
*/
|
|
55
|
+
export declare function structured<T>(payload: T): CallToolResult;
|
|
56
|
+
/** A tool execution error the model can read and self-correct from. */
|
|
57
|
+
export declare function fail(code: string, message: string, retryable?: boolean): CallToolResult;
|
|
58
|
+
/**
|
|
59
|
+
* Converts a thrown error into a tool execution error.
|
|
60
|
+
*
|
|
61
|
+
* Unlike the previous per-package handling, the {@link PimError} code survives
|
|
62
|
+
* to the client instead of being flattened into a bare string. `mapCode` lets a
|
|
63
|
+
* server keep its own external code vocabulary.
|
|
64
|
+
*/
|
|
65
|
+
export declare function toolError(err: unknown, mapCode?: (error: PimError) => string): CallToolResult;
|
|
66
|
+
/** The outcome of a {@link confirmDestructive} gate. */
|
|
67
|
+
export type ConfirmOutcome = {
|
|
68
|
+
status: "proceed";
|
|
69
|
+
}
|
|
70
|
+
/** Return `result` from the handler unchanged. */
|
|
71
|
+
| {
|
|
72
|
+
status: "interrupt";
|
|
73
|
+
result: ToolResult;
|
|
74
|
+
};
|
|
75
|
+
/**
|
|
76
|
+
* Gates an irreversible operation behind user confirmation, using the
|
|
77
|
+
* 2026-07-28 multi round-trip request pattern: the first call returns
|
|
78
|
+
* `resultType: "input_required"` with an elicitation, and the client retries
|
|
79
|
+
* with the answer.
|
|
80
|
+
*
|
|
81
|
+
* Works on 2025-era connections too — the SDK's legacy shim turns the
|
|
82
|
+
* `input_required` return into a real server-to-client `elicitation/create`
|
|
83
|
+
* and re-enters the handler, so this needs no era branching.
|
|
84
|
+
*
|
|
85
|
+
* Set `PIM_MCP_CONFIRM=off` to skip confirmation entirely (headless use).
|
|
86
|
+
*/
|
|
87
|
+
export declare function confirmDestructive(ctx: ServerContext, key: string, message: string): ConfirmOutcome;
|
|
88
|
+
/**
|
|
89
|
+
* Cache hints for `tools/list`. Our tool lists are static and identical for
|
|
90
|
+
* every caller, so they are safe for shared caches. Only ever emitted on
|
|
91
|
+
* 2026-07-28 connections; 2025-era responses are unaffected.
|
|
92
|
+
*/
|
|
93
|
+
export declare const TOOL_LIST_CACHE_HINT: {
|
|
94
|
+
readonly ttlMs: 3600000;
|
|
95
|
+
readonly cacheScope: "public";
|
|
96
|
+
};
|
|
97
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EAIrB,MAAM,8BAA8B,CAAC;AAOtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,KAAK,QAAQ,EAAc,MAAM,cAAc,CAAC;AAEzD,sFAAsF;AACtF,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAI9D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAEpF;;;;;GAKG;AAKH,MAAM,WAAW,OAAO,CAAC,OAAO,EAAE,IAAI,GAAG,GAAG;IAC1C,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,WAAW,EAAE,QAAQ,CACnB,IAAI,CAAC,eAAe,EAAE,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,eAAe,CAAC,CAC/F,CAAC;IACF,4EAA4E;IAC5E,WAAW,EAAE,cAAc,CAAC;IAC5B,oGAAoG;IACpG,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACpF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EACnC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EACrC,OAAO,EAAE,OAAO,GACf,IAAI,CAgBN;AAKD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAClC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,OAAO,EAChB,GAAG,GAAE,aAAyB,GAC7B,OAAO,CAAC,UAAU,CAAC,CAMrB;AAED,6DAA6D;AAC7D,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,cAAc,CAKxD;AAED,uEAAuE;AACvE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,cAAc,CAKrF;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,MAAM,GAAG,cAAc,CAG7F;AAED,wDAAwD;AACxD,MAAM,MAAM,cAAc,GACtB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE;AACvB,kDAAkD;GAChD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC;AAEhD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,cAAc,CAsChB;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;CAAsD,CAAC"}
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import { fromJsonSchema, inputRequired, inputResponse, } from "@modelcontextprotocol/server";
|
|
2
|
+
/**
|
|
3
|
+
* Shared MCP plumbing for the PIM servers, built on the 2026-07-28 protocol
|
|
4
|
+
* revision. Kept behind the `@miguelarios/pim-core/mcp` subpath so consumers of
|
|
5
|
+
* the main entry point do not pull in the MCP SDK.
|
|
6
|
+
*/
|
|
7
|
+
import { toStandardJsonSchema } from "@valibot/to-json-schema";
|
|
8
|
+
import { toPimError } from "../errors.js";
|
|
9
|
+
/**
|
|
10
|
+
* Registers every tool against an {@link McpServer}. The SDK derives argument
|
|
11
|
+
* validation from `inputSchema` and validates `structuredContent` against
|
|
12
|
+
* `outputSchema`, so handlers receive checked arguments and cannot emit a
|
|
13
|
+
* result that contradicts its advertised schema.
|
|
14
|
+
*/
|
|
15
|
+
export function registerTools(server, defs, service) {
|
|
16
|
+
for (const def of defs) {
|
|
17
|
+
server.registerTool(def.name, {
|
|
18
|
+
title: def.title,
|
|
19
|
+
description: def.description,
|
|
20
|
+
annotations: def.annotations,
|
|
21
|
+
inputSchema: fromJsonSchema(def.inputSchema),
|
|
22
|
+
...(def.outputSchema ? { outputSchema: toStandardJsonSchema(def.outputSchema) } : {}),
|
|
23
|
+
},
|
|
24
|
+
// the SDK infers handler args from the
|
|
25
|
+
// schema generic; the per-tool `Args` type is asserted by each tool module instead.
|
|
26
|
+
(args, ctx) => def.handler(args, service, ctx));
|
|
27
|
+
}
|
|
28
|
+
}
|
|
29
|
+
/** A handler context carrying no multi round-trip input responses. */
|
|
30
|
+
const EMPTY_CTX = { mcpReq: { inputResponses: undefined } };
|
|
31
|
+
/**
|
|
32
|
+
* Invokes one tool's handler by name, bypassing the MCP transport.
|
|
33
|
+
*
|
|
34
|
+
* Useful for testing handlers in isolation and for embedding the tools without
|
|
35
|
+
* a protocol layer. Argument validation lives in the SDK's `tools/call` path,
|
|
36
|
+
* so callers of this function are responsible for passing well-formed `args`.
|
|
37
|
+
*/
|
|
38
|
+
export function dispatchTool(defs, name, args, service, ctx = EMPTY_CTX) {
|
|
39
|
+
const tool = defs.find((def) => def.name === name);
|
|
40
|
+
if (!tool) {
|
|
41
|
+
return Promise.resolve(fail("UNKNOWN_TOOL", `Unknown tool: ${name}`));
|
|
42
|
+
}
|
|
43
|
+
return tool.handler(args, service, ctx);
|
|
44
|
+
}
|
|
45
|
+
/** A successful result carrying only human-readable text. */
|
|
46
|
+
export function ok(text) {
|
|
47
|
+
return { content: [{ type: "text", text }] };
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* A successful result carrying machine-readable data.
|
|
51
|
+
*
|
|
52
|
+
* The spec requires a tool returning structured content to also return the
|
|
53
|
+
* serialized JSON in a text block, for clients that do not read
|
|
54
|
+
* `structuredContent`.
|
|
55
|
+
*/
|
|
56
|
+
export function structured(payload) {
|
|
57
|
+
return {
|
|
58
|
+
content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
|
|
59
|
+
structuredContent: payload,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
/** A tool execution error the model can read and self-correct from. */
|
|
63
|
+
export function fail(code, message, retryable = false) {
|
|
64
|
+
return {
|
|
65
|
+
content: [{ type: "text", text: JSON.stringify({ error: code, message, retryable }) }],
|
|
66
|
+
isError: true,
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* Converts a thrown error into a tool execution error.
|
|
71
|
+
*
|
|
72
|
+
* Unlike the previous per-package handling, the {@link PimError} code survives
|
|
73
|
+
* to the client instead of being flattened into a bare string. `mapCode` lets a
|
|
74
|
+
* server keep its own external code vocabulary.
|
|
75
|
+
*/
|
|
76
|
+
export function toolError(err, mapCode) {
|
|
77
|
+
const pimError = toPimError(err instanceof Error ? err : new Error(String(err)));
|
|
78
|
+
return fail(mapCode ? mapCode(pimError) : pimError.code, pimError.message, pimError.isRetryable);
|
|
79
|
+
}
|
|
80
|
+
/**
|
|
81
|
+
* Gates an irreversible operation behind user confirmation, using the
|
|
82
|
+
* 2026-07-28 multi round-trip request pattern: the first call returns
|
|
83
|
+
* `resultType: "input_required"` with an elicitation, and the client retries
|
|
84
|
+
* with the answer.
|
|
85
|
+
*
|
|
86
|
+
* Works on 2025-era connections too — the SDK's legacy shim turns the
|
|
87
|
+
* `input_required` return into a real server-to-client `elicitation/create`
|
|
88
|
+
* and re-enters the handler, so this needs no era branching.
|
|
89
|
+
*
|
|
90
|
+
* Set `PIM_MCP_CONFIRM=off` to skip confirmation entirely (headless use).
|
|
91
|
+
*/
|
|
92
|
+
export function confirmDestructive(ctx, key, message) {
|
|
93
|
+
if (process.env.PIM_MCP_CONFIRM === "off")
|
|
94
|
+
return { status: "proceed" };
|
|
95
|
+
const view = inputResponse(ctx.mcpReq.inputResponses, key);
|
|
96
|
+
if (view.kind === "elicit") {
|
|
97
|
+
if (view.action === "accept" && view.content?.confirm === true) {
|
|
98
|
+
return { status: "proceed" };
|
|
99
|
+
}
|
|
100
|
+
// Declined, cancelled, or answered "no". Do NOT re-ask — re-issuing the
|
|
101
|
+
// elicitation here would loop until the client's round limit.
|
|
102
|
+
return {
|
|
103
|
+
status: "interrupt",
|
|
104
|
+
result: fail("CONFIRMATION_DECLINED", "Cancelled: the user did not confirm this operation."),
|
|
105
|
+
};
|
|
106
|
+
}
|
|
107
|
+
return {
|
|
108
|
+
status: "interrupt",
|
|
109
|
+
result: inputRequired({
|
|
110
|
+
inputRequests: {
|
|
111
|
+
[key]: inputRequired.elicit({
|
|
112
|
+
message,
|
|
113
|
+
requestedSchema: {
|
|
114
|
+
type: "object",
|
|
115
|
+
properties: {
|
|
116
|
+
confirm: {
|
|
117
|
+
type: "boolean",
|
|
118
|
+
title: "Confirm",
|
|
119
|
+
description: "Set to true to proceed with this irreversible operation.",
|
|
120
|
+
},
|
|
121
|
+
},
|
|
122
|
+
required: ["confirm"],
|
|
123
|
+
},
|
|
124
|
+
}),
|
|
125
|
+
},
|
|
126
|
+
}),
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
/**
|
|
130
|
+
* Cache hints for `tools/list`. Our tool lists are static and identical for
|
|
131
|
+
* every caller, so they are safe for shared caches. Only ever emitted on
|
|
132
|
+
* 2026-07-28 connections; 2025-era responses are unaffected.
|
|
133
|
+
*/
|
|
134
|
+
export const TOOL_LIST_CACHE_HINT = { ttlMs: 3_600_000, cacheScope: "public" };
|
|
135
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@miguelarios/pim-core",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.8.0",
|
|
4
4
|
"description": "Shared config, validation, errors, and utilities for PIM agent MCP servers",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"pim",
|
|
@@ -28,6 +28,10 @@
|
|
|
28
28
|
"./ics": {
|
|
29
29
|
"import": "./dist/ics/index.js",
|
|
30
30
|
"types": "./dist/ics/index.d.ts"
|
|
31
|
+
},
|
|
32
|
+
"./mcp": {
|
|
33
|
+
"import": "./dist/mcp/index.js",
|
|
34
|
+
"types": "./dist/mcp/index.d.ts"
|
|
31
35
|
}
|
|
32
36
|
},
|
|
33
37
|
"scripts": {
|
|
@@ -36,9 +40,11 @@
|
|
|
36
40
|
"test": "vitest run"
|
|
37
41
|
},
|
|
38
42
|
"dependencies": {
|
|
43
|
+
"@modelcontextprotocol/server": "^2.0.0",
|
|
39
44
|
"@touch4it/ical-timezones": "^1.9.0",
|
|
45
|
+
"@valibot/to-json-schema": "^1.7.1",
|
|
40
46
|
"ical.js": "^2.2.1",
|
|
41
|
-
"valibot": "^1.
|
|
47
|
+
"valibot": "^1.4.0"
|
|
42
48
|
},
|
|
43
49
|
"devDependencies": {
|
|
44
50
|
"typescript": "^5.7.0",
|