daycare-cli 0.1.1 → 2026.2.1

package/dist/engine/modules/tools/exposeCreateToolBuild.js

@@ -6,6 +6,18 @@ const schema = Type.Object({
     mode: Type.Optional(Type.Union([Type.Literal("public"), Type.Literal("local-network")])),
     authenticated: Type.Optional(Type.Boolean())
 }, { additionalProperties: false });
+const exposeCreateResultSchema = Type.Object({
+    summary: Type.String(),
+    endpointId: Type.String(),
+    domain: Type.String(),
+    provider: Type.String(),
+    mode: Type.String(),
+    authenticated: Type.Boolean()
+}, { additionalProperties: false });
+const exposeCreateReturns = {
+    schema: exposeCreateResultSchema,
+    toLLMText: (result) => result.summary
+};
 /**
  * Builds the expose_create tool for creating public or LAN endpoints.
  * Expects: exactly one target input is provided (port or unixSocket).
@@ -17,6 +29,7 @@ export function exposeCreateToolBuild(exposes) {
             description: "Expose a local HTTP port or unix socket through a tunnel provider.",
             parameters: schema
         },
+        returns: exposeCreateReturns,
         execute: async (args, _toolContext, toolCall) => {
             const payload = args;
             const target = targetResolve(payload);
@@ -31,7 +44,7 @@ export function exposeCreateToolBuild(exposes) {
             const authText = created.password
                 ? `Auth enabled. Username: daycare Password: ${created.password}`
                 : "Auth disabled.";
-            const text = [
+            const summary = [
                 `Expose endpoint created: ${created.endpoint.id}`,
                 `Domain: ${created.endpoint.domain}`,
                 `Provider: ${created.endpoint.provider}`,
@@ -43,7 +56,7 @@ export function exposeCreateToolBuild(exposes) {
                 role: "toolResult",
                 toolCallId: toolCall.id,
                 toolName: toolCall.name,
-                content: [{ type: "text", text }],
+                content: [{ type: "text", text: summary }],
                 details: {
                     endpoint: created.endpoint,
                     password: created.password
@@ -51,7 +64,17 @@ export function exposeCreateToolBuild(exposes) {
                 isError: false,
                 timestamp: Date.now()
             };
-            return { toolMessage };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    endpointId: created.endpoint.id,
+                    domain: created.endpoint.domain,
+                    provider: created.endpoint.provider,
+                    mode: created.endpoint.mode,
+                    authenticated: Boolean(created.endpoint.auth)
+                }
+            };
         }
     };
 }

package/dist/engine/modules/tools/exposeCreateToolBuild.js.map

@@ -1 +1 @@
-{"version":3,"file":"exposeCreateToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeCreateToolBuild.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"exposeCreateToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeCreateToolBuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAKtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACxB;IACE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACxD,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACtD,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACxF,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;CAC7C,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAC1C;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;IACzB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE;CAC9B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,mBAAmB,GAA2C;IAClE,MAAM,EAAE,wBAAwB;IAChC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgC;IAEhC,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,oEAAoE;YACtE,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,IAAwB,CAAC;YACzC,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAe,CAAC;YACtD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;YACrD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC;gBACnC,MAAM;gBACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,IAAI;gBACJ,aAAa;aACd,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;gBAC/B,CAAC,CAAC,6CAA6C,OAAO,CAAC,QAAQ,EAAE;gBACjE,CAAC,CAAC,gBAAgB,CAAC;YACrB,MAAM,OAAO,GAAG;gBACd,4BAA4B,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE;gBACjD,WAAW,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE;gBACpC,aAAa,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE;gBACxC,SAAS,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;gBAChC,WAAW,eAAe,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;gBACrD,QAAQ;aACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,OAAO,EAAE;oBACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC3B;gBACD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO;gBACL,WAAW;gBACX,WAAW,EAAE;oBACX,OAAO;oBACP,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;oBAC/B,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;oBAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ;oBACnC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;oBAC3B,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;iBAC9C;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAyB;IAC9C,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC;IACjD,MAAM,aAAa,GACjB,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAEjF,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAc,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAG,OAAO,CAAC,UAAqB,CAAC,IAAI,EAAE,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB;IAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC"}

package/dist/engine/modules/tools/exposeListToolBuild.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exposeListToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeListToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAIvD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC,GAC/C,cAAc,CA2ChB"}
+{"version":3,"file":"exposeListToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeListToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAwBvD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAAC,GAC/C,cAAc,CAmDhB"}

package/dist/engine/modules/tools/exposeListToolBuild.js

@@ -1,5 +1,14 @@
 import { Type } from "@sinclair/typebox";
 const schema = Type.Object({}, { additionalProperties: false });
+const exposeListResultSchema = Type.Object({
+    summary: Type.String(),
+    endpointCount: Type.Number(),
+    providerCount: Type.Number()
+}, { additionalProperties: false });
+const exposeListReturns = {
+    schema: exposeListResultSchema,
+    toLLMText: (result) => result.summary
+};
 /**
  * Builds the expose_list tool for listing active expose endpoints.
  * Expects: expose module is started.
@@ -11,12 +20,13 @@ export function exposeListToolBuild(exposes) {
             description: "List all expose endpoints and available providers.",
             parameters: schema
         },
+        returns: exposeListReturns,
         execute: async (_args, _toolContext, toolCall) => {
             const [endpoints, providers] = await Promise.all([
                 exposes.list(),
                 Promise.resolve(exposes.listProviders())
             ]);
-            const text = [
+            const summary = [
                 `Expose endpoints: ${endpoints.length}`,
                 ...endpoints.map((endpoint) => {
                     const target = endpoint.target.type === "port"
@@ -31,7 +41,7 @@ export function exposeListToolBuild(exposes) {
                 role: "toolResult",
                 toolCallId: toolCall.id,
                 toolName: toolCall.name,
-                content: [{ type: "text", text }],
+                content: [{ type: "text", text: summary }],
                 details: {
                     endpoints,
                     providers
@@ -39,7 +49,14 @@ export function exposeListToolBuild(exposes) {
                 isError: false,
                 timestamp: Date.now()
             };
-            return { toolMessage };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    endpointCount: endpoints.length,
+                    providerCount: providers.length
+                }
+            };
         }
     };
 }

package/dist/engine/modules/tools/exposeListToolBuild.js.map

@@ -1 +1 @@
-{"version":3,"file":"exposeListToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeListToolBuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAKzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;AAEhE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgD;IAEhD,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,oDAAoD;YACjE,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;YAC/C,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,OAAO,CAAC,IAAI,EAAE;gBACd,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;aACzC,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG;gBACX,qBAAqB,SAAS,CAAC,MAAM,EAAE;gBACvC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;wBAC5C,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;wBAChC,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACnC,OAAO,GAAG,QAAQ,CAAC,EAAE,WAAW,QAAQ,CAAC,MAAM,WAAW,MAAM,aAAa,QAAQ,CAAC,QAAQ,SAAS,QAAQ,CAAC,IAAI,kBAAkB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjK,CAAC,CAAC;gBACF,cAAc,SAAS,CAAC,MAAM,EAAE;gBAChC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC5B,GAAG,QAAQ,CAAC,UAAU,WAAW,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,YAAY,CAAC,MAAM,iBAAiB,QAAQ,CAAC,YAAY,CAAC,YAAY,EAAE,CAC7I;aACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE;oBACP,SAAS;oBACT,SAAS;iBACV;gBACD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"exposeListToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeListToolBuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAKzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC,CAAC;AAEhE,MAAM,sBAAsB,GAAG,IAAI,CAAC,MAAM,CACxC;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE;IAC5B,aAAa,EAAE,IAAI,CAAC,MAAM,EAAE;CAC7B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAQF,MAAM,iBAAiB,GAAyC;IAC9D,MAAM,EAAE,sBAAsB;IAC9B,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgD;IAEhD,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,oDAAoD;YACjE,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;YAC/C,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,OAAO,CAAC,IAAI,EAAE;gBACd,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;aACzC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG;gBACd,qBAAqB,SAAS,CAAC,MAAM,EAAE;gBACvC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;oBAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;wBAC5C,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;wBAChC,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;oBACnC,OAAO,GAAG,QAAQ,CAAC,EAAE,WAAW,QAAQ,CAAC,MAAM,WAAW,MAAM,aAAa,QAAQ,CAAC,QAAQ,SAAS,QAAQ,CAAC,IAAI,kBAAkB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjK,CAAC,CAAC;gBACF,cAAc,SAAS,CAAC,MAAM,EAAE;gBAChC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC5B,GAAG,QAAQ,CAAC,UAAU,WAAW,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,YAAY,CAAC,MAAM,iBAAiB,QAAQ,CAAC,YAAY,CAAC,YAAY,EAAE,CAC7I;aACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,OAAO,EAAE;oBACP,SAAS;oBACT,SAAS;iBACV;gBACD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO;gBACL,WAAW;gBACX,WAAW,EAAE;oBACX,OAAO;oBACP,aAAa,EAAE,SAAS,CAAC,MAAM;oBAC/B,aAAa,EAAE,SAAS,CAAC,MAAM;iBAChC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/modules/tools/exposeRemoveToolBuild.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exposeRemoveToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeRemoveToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAWvD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC/B,cAAc,CA6BhB"}
+{"version":3,"file":"exposeRemoveToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeRemoveToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AA0BvD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC/B,cAAc,CAqChB"}

package/dist/engine/modules/tools/exposeRemoveToolBuild.js

@@ -2,6 +2,14 @@ import { Type } from "@sinclair/typebox";
 const schema = Type.Object({
     endpointId: Type.String({ minLength: 1 })
 }, { additionalProperties: false });
+const exposeRemoveResultSchema = Type.Object({
+    summary: Type.String(),
+    endpointId: Type.String()
+}, { additionalProperties: false });
+const exposeRemoveReturns = {
+    schema: exposeRemoveResultSchema,
+    toLLMText: (result) => result.summary
+};
 /**
  * Builds the expose_remove tool for deleting expose endpoints.
  * Expects: endpointId references an existing endpoint.
@@ -13,6 +21,7 @@ export function exposeRemoveToolBuild(exposes) {
             description: "Remove an expose endpoint and tear down its tunnel.",
             parameters: schema
         },
+        returns: exposeRemoveReturns,
         execute: async (args, _toolContext, toolCall) => {
             const payload = args;
             const endpointId = payload.endpointId.trim();
@@ -20,16 +29,23 @@ export function exposeRemoveToolBuild(exposes) {
                 throw new Error("endpointId is required.");
             }
             await exposes.remove(endpointId);
+            const summary = `Expose endpoint removed: ${endpointId}`;
             const toolMessage = {
                 role: "toolResult",
                 toolCallId: toolCall.id,
                 toolName: toolCall.name,
-                content: [{ type: "text", text: `Expose endpoint removed: ${endpointId}` }],
+                content: [{ type: "text", text: summary }],
                 details: { endpointId },
                 isError: false,
                 timestamp: Date.now()
             };
-            return { toolMessage };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    endpointId
+                }
+            };
         }
     };
 }

package/dist/engine/modules/tools/exposeRemoveToolBuild.js.map

@@ -1 +1 @@
-{"version":3,"file":"exposeRemoveToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeRemoveToolBuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAKtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACxB;IACE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CAC1C,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgC;IAEhC,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,qDAAqD;YAClE,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,IAAwB,CAAC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAEjC,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,UAAU,EAAE,EAAE,CAAC;gBAC3E,OAAO,EAAE,EAAE,UAAU,EAAE;gBACvB,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"exposeRemoveToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeRemoveToolBuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAKtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACxB;IACE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CAC1C,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAC1C;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;CAC1B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,mBAAmB,GAA2C;IAClE,MAAM,EAAE,wBAAwB;IAChC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgC;IAEhC,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,qDAAqD;YAClE,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,IAAwB,CAAC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAEjC,MAAM,OAAO,GAAG,4BAA4B,UAAU,EAAE,CAAC;YACzD,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,OAAO,EAAE,EAAE,UAAU,EAAE;gBACvB,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO;gBACL,WAAW;gBACX,WAAW,EAAE;oBACX,OAAO;oBACP,UAAU;iBACX;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/modules/tools/exposeUpdateToolBuild.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exposeUpdateToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeUpdateToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAYvD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC/B,cAAc,CA4ChB"}
+{"version":3,"file":"exposeUpdateToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeUpdateToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AA6BvD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC/B,cAAc,CAqDhB"}

package/dist/engine/modules/tools/exposeUpdateToolBuild.js

@@ -3,6 +3,16 @@ const schema = Type.Object({
     endpointId: Type.String({ minLength: 1 }),
     authenticated: Type.Boolean()
 }, { additionalProperties: false });
+const exposeUpdateResultSchema = Type.Object({
+    summary: Type.String(),
+    endpointId: Type.String(),
+    domain: Type.String(),
+    authenticated: Type.Boolean()
+}, { additionalProperties: false });
+const exposeUpdateReturns = {
+    schema: exposeUpdateResultSchema,
+    toLLMText: (result) => result.summary
+};
 /**
  * Builds the expose_update tool for toggling endpoint authentication.
  * Expects: endpointId references an existing endpoint.
@@ -14,6 +24,7 @@ export function exposeUpdateToolBuild(exposes) {
             description: "Update expose endpoint authentication; enabling auth returns a new password.",
             parameters: schema
         },
+        returns: exposeUpdateReturns,
         execute: async (args, _toolContext, toolCall) => {
             const payload = args;
             const endpointId = payload.endpointId.trim();
@@ -26,7 +37,7 @@ export function exposeUpdateToolBuild(exposes) {
             const authText = updated.password
                 ? `Auth enabled. Username: daycare Password: ${updated.password}`
                 : `Auth ${updated.endpoint.auth ? "enabled" : "disabled"}.`;
-            const text = [
+            const summary = [
                 `Expose endpoint updated: ${updated.endpoint.id}`,
                 `Domain: ${updated.endpoint.domain}`,
                 authText
@@ -35,7 +46,7 @@ export function exposeUpdateToolBuild(exposes) {
                 role: "toolResult",
                 toolCallId: toolCall.id,
                 toolName: toolCall.name,
-                content: [{ type: "text", text }],
+                content: [{ type: "text", text: summary }],
                 details: {
                     endpoint: updated.endpoint,
                     password: updated.password
@@ -43,7 +54,15 @@ export function exposeUpdateToolBuild(exposes) {
                 isError: false,
                 timestamp: Date.now()
             };
-            return { toolMessage };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    endpointId: updated.endpoint.id,
+                    domain: updated.endpoint.domain,
+                    authenticated: Boolean(updated.endpoint.auth)
+                }
+            };
         }
     };
 }

package/dist/engine/modules/tools/exposeUpdateToolBuild.js.map

@@ -1 +1 @@
-{"version":3,"file":"exposeUpdateToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeUpdateToolBuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAKtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACxB;IACE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzC,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE;CAC9B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgC;IAEhC,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,8EAA8E;YAChF,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,IAAwB,CAAC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE;gBAC/C,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;gBAC/B,CAAC,CAAC,6CAA6C,OAAO,CAAC,QAAQ,EAAE;gBACjE,CAAC,CAAC,QAAQ,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC;YAC9D,MAAM,IAAI,GAAG;gBACX,4BAA4B,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE;gBACjD,WAAW,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE;gBACpC,QAAQ;aACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE;oBACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC3B;gBACD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO,EAAE,WAAW,EAAE,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"exposeUpdateToolBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/exposeUpdateToolBuild.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAKtD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACxB;IACE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACzC,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE;CAC9B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAC1C;IACE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;IACzB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE;CAC9B,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAIF,MAAM,mBAAmB,GAA2C;IAClE,MAAM,EAAE,wBAAwB;IAChC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAgC;IAEhC,OAAO;QACL,IAAI,EAAE;YACJ,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,8EAA8E;YAChF,UAAU,EAAE,MAAM;SACnB;QACD,OAAO,EAAE,mBAAmB;QAC5B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,IAAwB,CAAC;YACzC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE;gBAC/C,aAAa,EAAE,OAAO,CAAC,aAAa;aACrC,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;gBAC/B,CAAC,CAAC,6CAA6C,OAAO,CAAC,QAAQ,EAAE;gBACjE,CAAC,CAAC,QAAQ,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC;YAC9D,MAAM,OAAO,GAAG;gBACd,4BAA4B,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE;gBACjD,WAAW,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE;gBACpC,QAAQ;aACT,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,WAAW,GAAsB;gBACrC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;gBAC1C,OAAO,EAAE;oBACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC3B;gBACD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC;YAEF,OAAO;gBACL,WAAW;gBACX,WAAW,EAAE;oBACX,OAAO;oBACP,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;oBAC/B,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;oBAC/B,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;iBAC9C;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/modules/tools/heartbeat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/heartbeat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiE9C,wBAAgB,qBAAqB,IAAI,cAAc,CA8BtD;AAED,wBAAgB,qBAAqB,IAAI,cAAc,CA0CtD;AAED,wBAAgB,wBAAwB,IAAI,cAAc,CA+BzD"}
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/heartbeat.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAgHlE,wBAAgB,qBAAqB,IAAI,cAAc,CAsCtD;AAED,wBAAgB,qBAAqB,IAAI,cAAc,CAmDtD;AAED,wBAAgB,wBAAwB,IAAI,cAAc,CAwCzD"}

package/dist/engine/modules/tools/heartbeat.js

@@ -33,6 +33,32 @@ const addSchema = Type.Object({
 const removeSchema = Type.Object({
     id: Type.String({ minLength: 1 })
 }, { additionalProperties: false });
+const heartbeatRunResultSchema = Type.Object({
+    summary: Type.String(),
+    ran: Type.Number()
+}, { additionalProperties: false });
+const heartbeatRunReturns = {
+    schema: heartbeatRunResultSchema,
+    toLLMText: (result) => result.summary
+};
+const heartbeatAddResultSchema = Type.Object({
+    summary: Type.String(),
+    taskId: Type.String(),
+    title: Type.String()
+}, { additionalProperties: false });
+const heartbeatAddReturns = {
+    schema: heartbeatAddResultSchema,
+    toLLMText: (result) => result.summary
+};
+const heartbeatRemoveResultSchema = Type.Object({
+    summary: Type.String(),
+    taskId: Type.String(),
+    removed: Type.Boolean()
+}, { additionalProperties: false });
+const heartbeatRemoveReturns = {
+    schema: heartbeatRemoveResultSchema,
+    toLLMText: (result) => result.summary
+};
 export function buildHeartbeatRunTool() {
     return {
         tool: {
@@ -40,9 +66,13 @@ export function buildHeartbeatRunTool() {
             description: "Run heartbeat tasks immediately as a single batch instead of waiting for the next interval.",
             parameters: runSchema
         },
+        returns: heartbeatRunReturns,
         execute: async (args, toolContext, toolCall) => {
             const payload = args;
             const result = await toolContext.heartbeats.runNow({ ids: payload.ids });
+            const summary = result.ran > 0
+                ? `Heartbeat ran ${result.ran} task(s): ${result.taskIds.join(", ")}.`
+                : "No heartbeat tasks ran.";
             const toolMessage = {
                 role: "toolResult",
                 toolCallId: toolCall.id,
@@ -50,15 +80,19 @@ export function buildHeartbeatRunTool() {
                 content: [
                     {
                         type: "text",
-                        text: result.ran > 0
-                            ? `Heartbeat ran ${result.ran} task(s): ${result.taskIds.join(", ")}.`
-                            : "No heartbeat tasks ran."
+                        text: summary
                     }
                 ],
                 isError: false,
                 timestamp: Date.now()
             };
-            return { toolMessage };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    ran: result.ran
+                }
+            };
         }
     };
 }
@@ -69,6 +103,7 @@ export function buildHeartbeatAddTool() {
             description: "Create or update a heartbeat prompt stored in config/heartbeat (optional gate).",
             parameters: addSchema
         },
+        returns: heartbeatAddReturns,
         execute: async (args, toolContext, toolCall) => {
             const payload = args;
             const gate = execGateNormalize(payload.gate);
@@ -79,6 +114,7 @@ export function buildHeartbeatAddTool() {
                 gate,
                 overwrite: payload.overwrite
             });
+            const summary = `Heartbeat saved: ${result.id} (${result.title}).`;
             const toolMessage = {
                 role: "toolResult",
                 toolCallId: toolCall.id,
@@ -86,7 +122,7 @@ export function buildHeartbeatAddTool() {
                 content: [
                     {
                         type: "text",
-                        text: `Heartbeat saved: ${result.id} (${result.title}).`
+                        text: summary
                     }
                 ],
                 details: {
@@ -98,7 +134,14 @@ export function buildHeartbeatAddTool() {
                 isError: false,
                 timestamp: Date.now()
             };
-            return { toolMessage };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    taskId: result.id,
+                    title: result.title
+                }
+            };
         }
     };
 }
@@ -109,9 +152,13 @@ export function buildHeartbeatRemoveTool() {
             description: "Delete a heartbeat task.",
             parameters: removeSchema
         },
+        returns: heartbeatRemoveReturns,
         execute: async (args, toolContext, toolCall) => {
             const payload = args;
             const removed = await toolContext.heartbeats.removeTask(payload.id);
+            const summary = removed
+                ? `Removed heartbeat ${payload.id}.`
+                : `Heartbeat not found: ${payload.id}.`;
             const toolMessage = {
                 role: "toolResult",
                 toolCallId: toolCall.id,
@@ -119,16 +166,21 @@ export function buildHeartbeatRemoveTool() {
                 content: [
                     {
                         type: "text",
-                        text: removed
-                            ? `Removed heartbeat ${payload.id}.`
-                            : `Heartbeat not found: ${payload.id}.`
+                        text: summary
                     }
                 ],
                 details: { id: payload.id, removed },
                 isError: false,
                 timestamp: Date.now()
             };
-            return { toolMessage };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    taskId: payload.id,
+                    removed
+                }
+            };
         }
     };
 }

package/dist/engine/modules/tools/heartbeat.js.map

@@ -1 +1 @@
-{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/heartbeat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/heartbeat.ts"],"names":[],"mappings":"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"}

package/dist/engine/modules/tools/image-generation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-generation.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/image-generation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAa9C,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,uBAAuB,GACrC,cAAc,CA6FhB"}
+{"version":3,"file":"image-generation.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/image-generation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAmClE,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,uBAAuB,GACrC,cAAc,CAqGhB"}

package/dist/engine/modules/tools/image-generation.js

@@ -8,6 +8,16 @@ const schema = Type.Object({
     count: Type.Optional(Type.Number({ minimum: 1, maximum: 4 })),
     model: Type.Optional(Type.String({ minLength: 1 }))
 }, { additionalProperties: false });
+const imageGenerationResultSchema = Type.Object({
+    summary: Type.String(),
+    provider: Type.String(),
+    fileCount: Type.Number(),
+    workspaceDir: Type.String()
+}, { additionalProperties: false });
+const imageGenerationReturns = {
+    schema: imageGenerationResultSchema,
+    toLLMText: (result) => result.summary
+};
 export function buildImageGenerationTool(imageRegistry) {
     return {
         tool: {
@@ -15,6 +25,7 @@ export function buildImageGenerationTool(imageRegistry) {
             description: "Generate one or more images using the configured image provider.",
             parameters: schema
         },
+        returns: imageGenerationReturns,
         execute: async (args, toolContext, toolCall) => {
             const payload = args;
             const providers = imageRegistry.list();
@@ -45,10 +56,11 @@ export function buildImageGenerationTool(imageRegistry) {
             await fs.mkdir(workspaceFilesDir, { recursive: true });
             const createdAt = new Date();
             const timestamp = createdAt.toISOString().replace(/[:.]/g, "-");
+            const summary = `Generated ${result.files.length} image(s) with ${providerId}. Saved under ${workspaceFilesDir}.`;
             const content = [
                 {
                     type: "text",
-                    text: `Generated ${result.files.length} image(s) with ${providerId}. Saved under ${workspaceFilesDir}.`
+                    text: summary
                 }
             ];
             const workspaceFiles = [];
@@ -88,7 +100,13 @@ export function buildImageGenerationTool(imageRegistry) {
                 timestamp: Date.now()
             };
             return {
-                toolMessage
+                toolMessage,
+                typedResult: {
+                    summary,
+                    provider: providerId,
+                    fileCount: workspaceFiles.length,
+                    workspaceDir: workspaceFilesDir
+                }
             };
         }
     };

package/dist/engine/modules/tools/image-generation.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-generation.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/image-generation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"image-generation.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/image-generation.ts"],"names":[],"mappings":"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"}

package/dist/engine/modules/tools/mermaid-png.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid-png.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/mermaid-png.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,QAAA,MAAM,MAAM;;;;;EAQX,CAAC;AASF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAAC,OAAO,MAAM,CAAC,CA+DnE"}
+{"version":3,"file":"mermaid-png.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/mermaid-png.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAGlE,QAAA,MAAM,MAAM;;;;;EAQX,CAAC;AAiCF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAAC,OAAO,MAAM,CAAC,CAwEnE"}

package/dist/engine/modules/tools/mermaid-png.js

@@ -7,6 +7,17 @@ const schema = Type.Object({
     theme: Type.Optional(Type.String({ minLength: 1 })),
     width: Type.Optional(Type.Integer({ minimum: 256, maximum: 4096 }))
 }, { additionalProperties: false });
+const mermaidPngResultSchema = Type.Object({
+    summary: Type.String(),
+    fileId: Type.String(),
+    fileName: Type.String(),
+    theme: Type.String(),
+    width: Type.Number()
+}, { additionalProperties: false });
+const mermaidPngReturns = {
+    schema: mermaidPngResultSchema,
+    toLLMText: (result) => result.summary
+};
 /**
  * Builds a tool that renders Mermaid diagram source into a PNG file.
  * Expects: args.mermaid contains raw Mermaid source without markdown fences.
@@ -18,6 +29,7 @@ export function buildMermaidPngTool() {
             description: "Render raw Mermaid diagram source into a PNG file and return it as a generated artifact.",
             parameters: schema
         },
+        returns: mermaidPngReturns,
         execute: async (args, context, toolCall) => {
             const payload = args;
             const themeName = payload.theme ?? "github-light";
@@ -43,6 +55,7 @@ export function buildMermaidPngTool() {
                 data: png,
                 source: "generate_mermaid_png"
             });
+            const summary = `Generated Mermaid PNG: ${stored.path}`;
             const toolMessage = {
                 role: "toolResult",
                 toolCallId: toolCall.id,
@@ -50,7 +63,7 @@ export function buildMermaidPngTool() {
                 content: [
                     {
                         type: "text",
-                        text: `Generated Mermaid PNG: ${stored.path}`
+                        text: summary
                     }
                 ],
                 details: {
@@ -65,7 +78,14 @@ export function buildMermaidPngTool() {
                 timestamp: Date.now()
             };
             return {
-                toolMessage
+                toolMessage,
+                typedResult: {
+                    summary,
+                    fileId: stored.id,
+                    fileName: stored.name,
+                    theme: themeName,
+                    width: payload.width ?? 1600
+                }
             };
         }
     };

package/dist/engine/modules/tools/mermaid-png.js.map

@@ -1 +1 @@
-{"version":3,"file":"mermaid-png.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/mermaid-png.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mermaid-png.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/mermaid-png.ts"],"names":[],"mappings":"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"}