@enfyra/mcp-server 0.1.95 → 0.1.97
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/dist/lib/dynamic-script-context-contract.js +1 -1
- package/dist/lib/dynamic-script-context-contract.js.map +1 -1
- package/dist/lib/mcp-example-handlers-hooks.js +6 -1
- package/dist/lib/mcp-example-handlers-hooks.js.map +1 -1
- package/dist/lib/required-knowledge.js +6 -4
- package/dist/lib/required-knowledge.js.map +1 -1
- package/package.json +1 -1
|
@@ -130,7 +130,7 @@ export function buildDynamicScriptContextTypeContract() {
|
|
|
130
130
|
global: 'HTTP/flow global socket: emitToUser(userId, event, data), emitToRoom(path, room, event, data), emitToGateway(path, event, data), broadcast(event, data) return Promise<void>; roomSize(room) returns Promise<number>.',
|
|
131
131
|
bound: 'The bound websocket socket also exposes reply(event, data), join(room), leave(room), emitToCurrentRoom(room, event, data), broadcastToRoom(room, event, data), and disconnect(), all returning Promise<void>.',
|
|
132
132
|
},
|
|
133
|
-
'@RES': 'HTTP handler only: stream(readable, options?): Promise<void>. The readable must be a server-side Node readable or approved Web ReadableStream exposed by a server package bridge. Options may include statusCode, mimetype, filename, and
|
|
133
|
+
'@RES': 'HTTP handler only: stream(readable, options?): Promise<void>. The readable must be a server-side Node readable or approved Web ReadableStream exposed by a server package bridge. Options may include statusCode, mimetype, filename, headers, and observer?: (chunkText: string, kind: "chunk" | "end" | "error") => unknown | Promise<unknown>. The observer sees arbitrary decoded fragments, then one empty end/error notification; it is best-effort and awaited before each chunk is relayed. It pipes directly to the client, so await @RES.stream(...) and do not return another payload afterward. The selected method timeout remains the single deadline for observer work and stream relay; client abort/response close cancels the task. This is the streaming response boundary; use @HELPERS.$fetch only for buffered json/text/ArrayBuffer responses.',
|
|
134
134
|
'@TRIGGER': 'trigger(flowIdOrName: Id, payload?: JsonValue): Promise<{ jobId: string; flowId: Id } | { triggered: true; flowId: Id; flowName: string }>.',
|
|
135
135
|
'$ctx.$transaction': 'Raw-only $ctx.$transaction.run<T>(callback: () => Promise<T>): Promise<T>. Only repository operations participate in rollback.',
|
|
136
136
|
'@LOGS': 'Synchronous callable: (...values: unknown[]) => void. Prefer @LOGS(message, details?).',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dynamic-script-context-contract.js","sourceRoot":"","sources":["../../src/lib/dynamic-script-context-contract.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"dynamic-script-context-contract.js","sourceRoot":"","sources":["../../src/lib/dynamic-script-context-contract.ts"],"names":[],"mappings":"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"}
|
|
@@ -244,12 +244,17 @@ return { data: response }
|
|
|
244
244
|
// After the package-readable chain has passed a non-saving admin test:
|
|
245
245
|
// await @RES.stream(upstream.body, {
|
|
246
246
|
// statusCode: upstream.statusCode,
|
|
247
|
-
// mimetype: upstream.headers["content-type"]
|
|
247
|
+
// mimetype: upstream.headers["content-type"],
|
|
248
|
+
// observer: async (fragment, kind) => {
|
|
249
|
+
// // A fragment is not a complete SSE/JSON message; buffer before parsing.
|
|
250
|
+
// }
|
|
248
251
|
// })
|
|
249
252
|
`,
|
|
250
253
|
notes: [
|
|
251
254
|
'@HELPERS.$fetch is bounded and buffered; use it for JSON, text, or ArrayBuffer responses only.',
|
|
252
255
|
'@RES.stream is the direct HTTP response boundary and must be awaited. Do not return another payload after starting it.',
|
|
256
|
+
'The optional observer is for lightweight usage inspection; chunks are fragments, so buffer message framing before parsing.',
|
|
257
|
+
'Set one method timeout for the complete upstream request and stream. If the client disconnects, do not try to send a second response; required audit work belongs in a Flow.',
|
|
253
258
|
'The sandbox does not expose native fetch/Readable/AbortController as a portable script API.',
|
|
254
259
|
'A Server package must be inspected and the complete package-readable -> @RES.stream -> client chain must pass a non-saving test before a streaming handler is persisted.',
|
|
255
260
|
'Never forward Authorization or other secret-bearing request headers to the client; allowlist response headers and keep provider keys server-side.',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mcp-example-handlers-hooks.js","sourceRoot":"","sources":["../../src/lib/mcp-example-handlers-hooks.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACjC,KAAK,EAAE,2DAA2D;IAClE,OAAO,EAAE,+DAA+D;IACxE,QAAQ,EAAE;QACR;YACE,IAAI,EAAE,mDAAmD;YACzD,IAAI,EAAE;;;;;;;;;;GAUX;YACK,KAAK,EAAE;gBACL,+DAA+D;gBAC/D,4JAA4J;gBAC5J,4GAA4G;gBAC5G,wFAAwF;aACzF;SACF;QACD;YACE,IAAI,EAAE,wDAAwD;YAC9D,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BX;YACK,KAAK,EAAE;gBACL,+GAA+G;gBAC/G,iJAAiJ;gBACjJ,sIAAsI;gBACtI,uHAAuH;aACxH;SACF;QACD;YACE,IAAI,EAAE,oCAAoC;YAC1C,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;SA0BL;YACD,KAAK,EAAE;gBACL,0JAA0J;gBAC1J,oFAAoF;gBACpF,mIAAmI;aACpI;SACF;QACD;YACE,IAAI,EAAE,yDAAyD;YAC/D,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;mEAsBqD;YAC3D,KAAK,EAAE;gBACL,uEAAuE;gBACvE,4JAA4J;gBAC5J,iIAAiI;gBACjI,kEAAkE;aACnE;SACF;QACD;YACE,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;0CAoB4B;YAClC,KAAK,EAAE;gBACL,uDAAuD;gBACvD,4IAA4I;gBAC5I,0RAA0R;gBAC1R,kDAAkD;aACnD;SACF;QACD;YACE,IAAI,EAAE,sDAAsD;YAC5D,IAAI,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wDAsC0C;YAChD,KAAK,EAAE;gBACL,4IAA4I;gBAC5I,sJAAsJ;gBACtJ,6EAA6E;gBAC7E,uMAAuM;gBACvM,oGAAoG;aACrG;SACF;QACD;YACE,IAAI,EAAE,oCAAoC;YAC1C,IAAI,EAAE;;;;;;;;;;;;;;;EAeZ;YACM,KAAK,EAAE;gBACL,iGAAiG;gBACjG,+JAA+J;gBAC/J,yMAAyM;gBACzM,0EAA0E;aAC3E;SACF;QACD;YACE,IAAI,EAAE,iDAAiD;YACvD,IAAI,EAAE
|
|
1
|
+
{"version":3,"file":"mcp-example-handlers-hooks.js","sourceRoot":"","sources":["../../src/lib/mcp-example-handlers-hooks.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
export const GLOBAL_RULES_ACK_KEY = 'EFYRA::GLOBAL-RULES::RUNTIME-ZONE-INVENTORY::SCHEMA-DESIGN-CONTEXT::20260717M';
|
|
2
2
|
export const DYNAMIC_CODE_KNOWLEDGE_ACK_KEY = 'EFYRA::DYNAMIC-REPOSITORY-CONTRACT::SCRIPT-RUNTIME-TYPES::ASYNC-HELPER-BRIDGE::20260720A';
|
|
3
3
|
export const EXTENSION_KNOWLEDGE_ACK_KEY = 'EFYRA::EXTENSION-APP-COMPOSABLE-CONTRACT::20260716B';
|
|
4
|
-
const REQUIRED_KNOWLEDGE_VERSION = '2026-08-05.
|
|
4
|
+
const REQUIRED_KNOWLEDGE_VERSION = '2026-08-05.gateway-stream-observer-abort-timeout-contract';
|
|
5
5
|
const acknowledgedDomains = new Set();
|
|
6
6
|
function hasExplicitAckKey(key) {
|
|
7
7
|
return key !== undefined && key !== null;
|
|
@@ -283,9 +283,11 @@ const DYNAMIC_CODE_SECTIONS = [
|
|
|
283
283
|
'Use @REPOS.main for the route main table and #secure.table_name or @REPOS.secure.table_name for explicit user-facing table access. Reserve #table_name/@REPOS.table_name for trusted internal work that intentionally bypasses field permissions.',
|
|
284
284
|
'HTTP fetch contract: @HELPERS.$fetch(url, options?) is the bounded request helper for JSON, text, or ArrayBuffer responses. It buffers the upstream body, applies the helper timeout/request/byte limits, and is not a streaming transport. Do not use it for SSE, chat-completions streaming, file proxying, or any response whose body must be forwarded chunk-by-chunk.',
|
|
285
285
|
'HTTP streaming contract: @RES.stream(readable, options?) is the response boundary for a custom HTTP handler. It accepts a server-side Node readable or a Web ReadableStream exposed by an approved server package bridge, then pipes it directly to the client. The handler must await @RES.stream(...) and must not return a second JSON payload afterward.',
|
|
286
|
-
'Streaming options may carry statusCode, mimetype, filename,
|
|
287
|
-
'
|
|
288
|
-
'
|
|
286
|
+
'Streaming options may carry statusCode, mimetype, filename, safe response headers, and an optional observer(chunkText, kind) callback. Use the observer only for lightweight inspection such as accumulating provider usage; chunks are arbitrary fragments, so buffer SSE/JSON framing across callbacks and never expose secrets in logs or response data.',
|
|
287
|
+
'Set the method timeout high enough for the complete upstream call and stream. It is one timeout for the request; do not add a fresh full timeout to each phase or package call.',
|
|
288
|
+
'If the client stops listening, the stream request ends and no second response is sent. Put required audit or billing work in a durable flow instead of relying on code that runs after a disconnected response.',
|
|
289
|
+
'Do not use native fetch, Readable, or AbortController in a dynamic script. For streaming, use an installed Server package and run a successful non-saving end-to-end test before saving the proxy handler.',
|
|
290
|
+
'Package installation alone is not enough to promise streaming. Verify the complete package request -> readable handle -> @RES.stream -> client response test before saving; if it is not successful, keep the endpoint buffered or report streaming as unverified.',
|
|
289
291
|
'For streaming proxy handlers, validate method/path/body and allowlist the upstream base URL before making the request; keep API keys server-side, avoid logging raw headers/body, handle upstream and client-disconnect errors, and write usage only from bounded upstream metadata after the response lifecycle is understood.',
|
|
290
292
|
'When using repository find({ deep }) in handlers/hooks/flows, include each deep relation name in top-level fields, then choose nested fields under deep.<relation>.fields.',
|
|
291
293
|
'Repository calls are async. Always await secure and trusted repository find/create/update/delete/exists calls; reads return { data: [...], meta? }.',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"required-knowledge.js","sourceRoot":"","sources":["../../src/lib/required-knowledge.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,+EAA+E,CAAC;AACpH,MAAM,CAAC,MAAM,8BAA8B,GAAG,0FAA0F,CAAC;AACzI,MAAM,CAAC,MAAM,2BAA2B,GAAG,qDAAqD,CAAC;AAEjG,MAAM,0BAA0B,GAAG,
|
|
1
|
+
{"version":3,"file":"required-knowledge.js","sourceRoot":"","sources":["../../src/lib/required-knowledge.ts"],"names":[],"mappings":"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"}
|