@laburen/delta-sdk 1.0.0 → 1.0.1
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 +17 -0
- package/README.md +6 -0
- package/dist/core/constantes.d.ts +1 -1
- package/dist/core/constantes.js +1 -1
- package/docs/telemetria.md +16 -0
- package/package.json +1 -1
- package/src/core/constantes.ts +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,23 @@ Formato: [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/).
|
|
|
4
4
|
El paquete es **additive-only**: se agregan funciones y campos opcionales, nunca se renombra ni se
|
|
5
5
|
saca nada. Un worker que se queda en una versión vieja sigue funcionando.
|
|
6
6
|
|
|
7
|
+
## [1.0.1] — 2026-08-04
|
|
8
|
+
|
|
9
|
+
Solo documentación. **El código no cambió**: si ya estás en `1.0.0`, actualizar es opcional.
|
|
10
|
+
|
|
11
|
+
### Cambiado
|
|
12
|
+
|
|
13
|
+
- `docs/telemetria.md` y el README ahora dicen explícitamente **qué va y qué no en un MCP sobre
|
|
14
|
+
Durable Object**: va `createTelemetry` dentro de `init()` más `withTool` en las tools, y **no** va
|
|
15
|
+
`withTelemetry` sobre el `export default`, porque el framework de MCP convierte el error de la
|
|
16
|
+
tool en un resultado con `isError: true` antes de que pueda escapar al `fetch` del worker.
|
|
17
|
+
Envolver ahí no reporta nada.
|
|
18
|
+
|
|
19
|
+
### Hay que hacer algo
|
|
20
|
+
|
|
21
|
+
Nada. Pero si instrumentaste un MCP y envolviste el `export default` con `withTelemetry`, sacalo:
|
|
22
|
+
no está reportando nada y solo duplica la config.
|
|
23
|
+
|
|
7
24
|
## [1.0.0] — 2026-08-03
|
|
8
25
|
|
|
9
26
|
Primera versión.
|
package/README.md
CHANGED
|
@@ -69,6 +69,12 @@ export class MiAgenteMCP extends McpAgent<Env> {
|
|
|
69
69
|
> en el scope global hace fallar el deploy con *"Disallowed operation called within global scope"*,
|
|
70
70
|
> y `wrangler dev` local **no lo detecta**.
|
|
71
71
|
|
|
72
|
+
> **Y no envuelvas el `export default` con `withTelemetry` en un MCP.** Aunque el worker tenga un
|
|
73
|
+
> `fetch` que rutea hacia el Durable Object, el framework de MCP atrapa el error de la tool y lo
|
|
74
|
+
> convierte en un resultado con `isError: true` antes de que llegue ahí: envolver el `export default`
|
|
75
|
+
> no reportaría nada. Acá va `createTelemetry` + `withTool`, y nada más. Ver
|
|
76
|
+
> [docs/telemetria.md](docs/telemetria.md).
|
|
77
|
+
|
|
72
78
|
## Caso 2 — Worker plano, cola y cron
|
|
73
79
|
|
|
74
80
|
```ts
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
export declare const INGEST_URL = "https://telemetry.laburen.com/events";
|
|
4
4
|
export declare const SDK_NAME = "@laburen/delta-sdk";
|
|
5
5
|
/** Tiene que coincidir con `version` del package.json; lo verifica `npm run version:check`. */
|
|
6
|
-
export declare const SDK_VERSION = "1.0.
|
|
6
|
+
export declare const SDK_VERSION = "1.0.1";
|
|
7
7
|
/** Los mismos topes que aplica la ingesta. El cliente los aplica para no perder el sobre entero;
|
|
8
8
|
* la ingesta, para no confiar en el cliente. */
|
|
9
9
|
export declare const LIMITES: {
|
package/dist/core/constantes.js
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
export const INGEST_URL = "https://telemetry.laburen.com/events";
|
|
4
4
|
export const SDK_NAME = "@laburen/delta-sdk";
|
|
5
5
|
/** Tiene que coincidir con `version` del package.json; lo verifica `npm run version:check`. */
|
|
6
|
-
export const SDK_VERSION = "1.0.
|
|
6
|
+
export const SDK_VERSION = "1.0.1";
|
|
7
7
|
/** Los mismos topes que aplica la ingesta. El cliente los aplica para no perder el sobre entero;
|
|
8
8
|
* la ingesta, para no confiar en el cliente. */
|
|
9
9
|
export const LIMITES = {
|
package/docs/telemetria.md
CHANGED
|
@@ -24,6 +24,22 @@ entera. En la práctica, el grueso del trabajo de instrumentar un worker existen
|
|
|
24
24
|
con estos wrappers: es sumar `captureException`/`captureEvent` a mano dentro de los `catch` que ya
|
|
25
25
|
existen. Ver la sección 5.
|
|
26
26
|
|
|
27
|
+
### Un MCP sobre Durable Object: qué va y qué no
|
|
28
|
+
|
|
29
|
+
Un MCP hecho con `McpAgent` tiene las dos formas a la vez: un `export default { fetch }` que rutea
|
|
30
|
+
hacia el Durable Object, y adentro las tools. **No son capas que se sumen** — una de las dos no
|
|
31
|
+
sirve acá:
|
|
32
|
+
|
|
33
|
+
- **Va:** `createTelemetry` **dentro de `init()`**, con `surface: "durable_object"` y el `ctx` del
|
|
34
|
+
agente (`ctx: this.ctx`, el original y nunca una copia), más `withTool` en cada tool que hoy no
|
|
35
|
+
atrapa su propio error.
|
|
36
|
+
- **No va:** `withTelemetry` sobre el `export default`. El framework de MCP **atrapa cualquier error
|
|
37
|
+
que lance una tool y lo convierte en un resultado con `isError: true`** antes de que pueda escapar
|
|
38
|
+
al `fetch` del worker. Envolver ahí no reportaría nunca nada, y solo duplicaría la config.
|
|
39
|
+
|
|
40
|
+
Es la misma razón por la que las tools que **sí** atrapan su propio error necesitan
|
|
41
|
+
`captureException` a mano: ese error no escapa a ningún lado, así que ningún wrapper puede verlo.
|
|
42
|
+
|
|
27
43
|
## 2. La config, campo por campo
|
|
28
44
|
|
|
29
45
|
Esta es la config que recibe `createTelemetry`. `withTelemetry` recibe la misma forma **menos**
|
package/package.json
CHANGED
package/src/core/constantes.ts
CHANGED
|
@@ -5,7 +5,7 @@ export const INGEST_URL = "https://telemetry.laburen.com/events";
|
|
|
5
5
|
export const SDK_NAME = "@laburen/delta-sdk";
|
|
6
6
|
|
|
7
7
|
/** Tiene que coincidir con `version` del package.json; lo verifica `npm run version:check`. */
|
|
8
|
-
export const SDK_VERSION = "1.0.
|
|
8
|
+
export const SDK_VERSION = "1.0.1";
|
|
9
9
|
|
|
10
10
|
/** Los mismos topes que aplica la ingesta. El cliente los aplica para no perder el sobre entero;
|
|
11
11
|
* la ingesta, para no confiar en el cliente. */
|