@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 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.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: {
@@ -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.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 = {
@@ -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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@laburen/delta-sdk",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Cliente de telemetría para los workers de Laburen en Cloudflare",
5
5
  "type": "module",
6
6
  "sideEffects": false,
@@ -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.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. */