@dexto/tools-lifecycle 1.6.0 → 1.6.1

package/dist/index.d.cts

@@ -1,8 +1,155 @@
-export { lifecycleToolsFactory } from './tool-factory.cjs';
-export { LIFECYCLE_TOOL_NAMES, LifecycleToolName, LifecycleToolsConfig, LifecycleToolsConfigSchema } from './tool-factory-config.cjs';
-export { createViewLogsTool } from './view-logs-tool.cjs';
-export { createSearchHistoryTool } from './search-history-tool.cjs';
-export { createMemoryCreateTool, createMemoryDeleteTool, createMemoryGetTool, createMemoryListTool, createMemoryUpdateTool } from './memory-tools.cjs';
-import '@dexto/agent-config';
-import 'zod';
-import '@dexto/core';
+import { ToolFactory } from '@dexto/agent-config';
+import { z } from 'zod';
+import { Tool } from '@dexto/core';
+
+declare const LIFECYCLE_TOOL_NAMES: readonly ["view_logs", "search_history", "memory_list", "memory_get", "memory_create", "memory_update", "memory_delete"];
+type LifecycleToolName = (typeof LIFECYCLE_TOOL_NAMES)[number];
+declare const LifecycleToolsConfigSchema: z.ZodObject<{
+    type: z.ZodLiteral<"lifecycle-tools">;
+    enabledTools: z.ZodOptional<z.ZodArray<z.ZodEnum<["view_logs", "search_history", "memory_list", "memory_get", "memory_create", "memory_update", "memory_delete"]>, "many">>;
+    maxLogLines: z.ZodDefault<z.ZodNumber>;
+    maxLogBytes: z.ZodDefault<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    type: "lifecycle-tools";
+    maxLogLines: number;
+    maxLogBytes: number;
+    enabledTools?: ("view_logs" | "search_history" | "memory_list" | "memory_get" | "memory_create" | "memory_update" | "memory_delete")[] | undefined;
+}, {
+    type: "lifecycle-tools";
+    enabledTools?: ("view_logs" | "search_history" | "memory_list" | "memory_get" | "memory_create" | "memory_update" | "memory_delete")[] | undefined;
+    maxLogLines?: number | undefined;
+    maxLogBytes?: number | undefined;
+}>;
+type LifecycleToolsConfig = z.output<typeof LifecycleToolsConfigSchema>;
+
+declare const lifecycleToolsFactory: ToolFactory<LifecycleToolsConfig>;
+
+declare const ViewLogsInputSchema: z.ZodObject<{
+    lines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    query: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["debug", "info", "warn", "error", "silly"]>, z.ZodArray<z.ZodEnum<["debug", "info", "warn", "error", "silly"]>, "many">]>>;
+    component: z.ZodOptional<z.ZodString>;
+    includeContext: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
+    lines: number;
+    includeContext: boolean;
+    query?: string | undefined;
+    level?: "debug" | "info" | "warn" | "error" | "silly" | ("debug" | "info" | "warn" | "error" | "silly")[] | undefined;
+    component?: string | undefined;
+}, {
+    lines?: number | undefined;
+    query?: string | undefined;
+    level?: "debug" | "info" | "warn" | "error" | "silly" | ("debug" | "info" | "warn" | "error" | "silly")[] | undefined;
+    component?: string | undefined;
+    includeContext?: boolean | undefined;
+}>;
+declare function createViewLogsTool(options: {
+    maxLogLines: number;
+    maxLogBytes: number;
+}): Tool<typeof ViewLogsInputSchema>;
+
+declare const SearchHistoryInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    mode: z.ZodEnum<["messages", "sessions"]>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodEnum<["user", "assistant", "system", "tool"]>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strict", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    offset: number;
+    mode: "messages" | "sessions";
+    sessionId?: string | undefined;
+    role?: "user" | "system" | "assistant" | "tool" | undefined;
+}, {
+    query: string;
+    mode: "messages" | "sessions";
+    sessionId?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+    role?: "user" | "system" | "assistant" | "tool" | undefined;
+}>;
+/**
+ * Create the `search_history` tool.
+ *
+ * Searches message/session history using the configured SearchService.
+ * Requires `ToolExecutionContext.services.search`.
+ */
+declare function createSearchHistoryTool(): Tool<typeof SearchHistoryInputSchema>;
+
+declare const MemoryListInputSchema: z.ZodObject<{
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    source: z.ZodOptional<z.ZodEnum<["user", "system"]>>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    tags?: string[] | undefined;
+    source?: "user" | "system" | undefined;
+    pinned?: boolean | undefined;
+}, {
+    tags?: string[] | undefined;
+    source?: "user" | "system" | undefined;
+    pinned?: boolean | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+declare function createMemoryListTool(): Tool<typeof MemoryListInputSchema>;
+declare const MemoryGetInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+declare function createMemoryGetTool(): Tool<typeof MemoryGetInputSchema>;
+declare const MemoryCreateInputSchema: z.ZodObject<{
+    content: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    source: z.ZodDefault<z.ZodOptional<z.ZodEnum<["user", "system"]>>>;
+    pinned: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
+    source: "user" | "system";
+    pinned: boolean;
+    content: string;
+    tags?: string[] | undefined;
+}, {
+    content: string;
+    tags?: string[] | undefined;
+    source?: "user" | "system" | undefined;
+    pinned?: boolean | undefined;
+}>;
+declare function createMemoryCreateTool(): Tool<typeof MemoryCreateInputSchema>;
+declare const MemoryUpdateInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    content: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    source: z.ZodOptional<z.ZodEnum<["user", "system"]>>;
+    pinned: z.ZodOptional<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+    tags?: string[] | undefined;
+    source?: "user" | "system" | undefined;
+    pinned?: boolean | undefined;
+    content?: string | undefined;
+}, {
+    id: string;
+    tags?: string[] | undefined;
+    source?: "user" | "system" | undefined;
+    pinned?: boolean | undefined;
+    content?: string | undefined;
+}>;
+declare function createMemoryUpdateTool(): Tool<typeof MemoryUpdateInputSchema>;
+declare const MemoryDeleteInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+declare function createMemoryDeleteTool(): Tool<typeof MemoryDeleteInputSchema>;
+
+export { LIFECYCLE_TOOL_NAMES, type LifecycleToolName, type LifecycleToolsConfig, LifecycleToolsConfigSchema, createMemoryCreateTool, createMemoryDeleteTool, createMemoryGetTool, createMemoryListTool, createMemoryUpdateTool, createSearchHistoryTool, createViewLogsTool, lifecycleToolsFactory };

package/dist/index.d.ts

@@ -1,8 +1,11 @@
+/**
+ * @dexto/tools-lifecycle
+ *
+ * Lifecycle and self-observation tools factory for Dexto agents.
+ */
 export { lifecycleToolsFactory } from './tool-factory.js';
-export { LIFECYCLE_TOOL_NAMES, LifecycleToolName, LifecycleToolsConfig, LifecycleToolsConfigSchema } from './tool-factory-config.js';
+export { LifecycleToolsConfigSchema, type LifecycleToolsConfig, LIFECYCLE_TOOL_NAMES, type LifecycleToolName, } from './tool-factory-config.js';
 export { createViewLogsTool } from './view-logs-tool.js';
 export { createSearchHistoryTool } from './search-history-tool.js';
-export { createMemoryCreateTool, createMemoryDeleteTool, createMemoryGetTool, createMemoryListTool, createMemoryUpdateTool } from './memory-tools.js';
-import '@dexto/agent-config';
-import 'zod';
-import '@dexto/core';
+export { createMemoryListTool, createMemoryGetTool, createMemoryCreateTool, createMemoryUpdateTool, createMemoryDeleteTool, } from './memory-tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACH,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,iBAAiB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EACH,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACzB,MAAM,mBAAmB,CAAC"}

package/dist/memory-tools.cjs

@@ -38,9 +38,28 @@ const MemoryListInputSchema = import_zod.z.object({
 function createMemoryListTool() {
   return (0, import_core.defineTool)({
     id: "memory_list",
-    displayName: "List Memories",
     description: "List stored memories for this agent, with optional filtering.",
     inputSchema: MemoryListInputSchema,
+    presentation: {
+      describeHeader: (input) => {
+        const filterParts = [];
+        if (input.tags && input.tags.length > 0) {
+          filterParts.push(`tags=${input.tags.join(",")}`);
+        }
+        if (input.source) {
+          filterParts.push(`source=${input.source}`);
+        }
+        if (input.pinned !== void 0) {
+          filterParts.push(`pinned=${String(input.pinned)}`);
+        }
+        filterParts.push(`limit=${input.limit}`);
+        filterParts.push(`offset=${input.offset}`);
+        return (0, import_core.createLocalToolCallHeader)({
+          title: "List Memories",
+          argsText: (0, import_core.truncateForHeader)(filterParts.join(" "), 140)
+        });
+      }
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -62,9 +81,14 @@ const MemoryGetInputSchema = import_zod.z.object({ id: import_zod.z.string().des
 function createMemoryGetTool() {
   return (0, import_core.defineTool)({
     id: "memory_get",
-    displayName: "Get Memory",
     description: "Get a memory by ID.",
     inputSchema: MemoryGetInputSchema,
+    presentation: {
+      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+        title: "Get Memory",
+        argsText: (0, import_core.truncateForHeader)(input.id, 140)
+      })
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -84,9 +108,14 @@ const MemoryCreateInputSchema = import_zod.z.object({
 function createMemoryCreateTool() {
   return (0, import_core.defineTool)({
     id: "memory_create",
-    displayName: "Create Memory",
     description: "Create a new memory.",
     inputSchema: MemoryCreateInputSchema,
+    presentation: {
+      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+        title: "Create Memory",
+        argsText: (0, import_core.truncateForHeader)(input.content, 140)
+      })
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -112,9 +141,22 @@ const MemoryUpdateInputSchema = import_zod.z.object({
 function createMemoryUpdateTool() {
   return (0, import_core.defineTool)({
     id: "memory_update",
-    displayName: "Update Memory",
     description: "Update an existing memory.",
     inputSchema: MemoryUpdateInputSchema,
+    presentation: {
+      describeHeader: (input) => {
+        const updateParts = [];
+        if (input.content !== void 0) updateParts.push("content");
+        if (input.tags !== void 0) updateParts.push("tags");
+        if (input.source !== void 0) updateParts.push("source");
+        if (input.pinned !== void 0) updateParts.push("pinned");
+        const argsText = updateParts.length > 0 ? (0, import_core.truncateForHeader)(`${input.id} ${updateParts.join(",")}`, 140) : (0, import_core.truncateForHeader)(input.id, 140);
+        return (0, import_core.createLocalToolCallHeader)({
+          title: "Update Memory",
+          argsText
+        });
+      }
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -136,9 +178,14 @@ const MemoryDeleteInputSchema = import_zod.z.object({ id: import_zod.z.string().
 function createMemoryDeleteTool() {
   return (0, import_core.defineTool)({
     id: "memory_delete",
-    displayName: "Delete Memory",
     description: "Delete a memory by ID.",
     inputSchema: MemoryDeleteInputSchema,
+    presentation: {
+      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+        title: "Delete Memory",
+        argsText: (0, import_core.truncateForHeader)(input.id, 140)
+      })
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {

package/dist/memory-tools.d.ts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
-import { Tool } from '@dexto/core';
-
+import type { Tool } from '@dexto/core';
 declare const MemoryListInputSchema: z.ZodObject<{
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     source: z.ZodOptional<z.ZodEnum<["user", "system"]>>;
@@ -20,7 +19,7 @@ declare const MemoryListInputSchema: z.ZodObject<{
     limit?: number | undefined;
     offset?: number | undefined;
 }>;
-declare function createMemoryListTool(): Tool<typeof MemoryListInputSchema>;
+export declare function createMemoryListTool(): Tool<typeof MemoryListInputSchema>;
 declare const MemoryGetInputSchema: z.ZodObject<{
     id: z.ZodString;
 }, "strict", z.ZodTypeAny, {
@@ -28,7 +27,7 @@ declare const MemoryGetInputSchema: z.ZodObject<{
 }, {
     id: string;
 }>;
-declare function createMemoryGetTool(): Tool<typeof MemoryGetInputSchema>;
+export declare function createMemoryGetTool(): Tool<typeof MemoryGetInputSchema>;
 declare const MemoryCreateInputSchema: z.ZodObject<{
     content: z.ZodString;
     tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -45,7 +44,7 @@ declare const MemoryCreateInputSchema: z.ZodObject<{
     source?: "user" | "system" | undefined;
     pinned?: boolean | undefined;
 }>;
-declare function createMemoryCreateTool(): Tool<typeof MemoryCreateInputSchema>;
+export declare function createMemoryCreateTool(): Tool<typeof MemoryCreateInputSchema>;
 declare const MemoryUpdateInputSchema: z.ZodObject<{
     id: z.ZodString;
     content: z.ZodOptional<z.ZodString>;
@@ -65,7 +64,7 @@ declare const MemoryUpdateInputSchema: z.ZodObject<{
     pinned?: boolean | undefined;
     content?: string | undefined;
 }>;
-declare function createMemoryUpdateTool(): Tool<typeof MemoryUpdateInputSchema>;
+export declare function createMemoryUpdateTool(): Tool<typeof MemoryUpdateInputSchema>;
 declare const MemoryDeleteInputSchema: z.ZodObject<{
     id: z.ZodString;
 }, "strict", z.ZodTypeAny, {
@@ -73,6 +72,6 @@ declare const MemoryDeleteInputSchema: z.ZodObject<{
 }, {
     id: string;
 }>;
-declare function createMemoryDeleteTool(): Tool<typeof MemoryDeleteInputSchema>;
-
-export { createMemoryCreateTool, createMemoryDeleteTool, createMemoryGetTool, createMemoryListTool, createMemoryUpdateTool };
+export declare function createMemoryDeleteTool(): Tool<typeof MemoryDeleteInputSchema>;
+export {};
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../src/memory-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAqC,IAAI,EAAwB,MAAM,aAAa,CAAC;AAIjG,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAoBd,CAAC;AAEd,wBAAgB,oBAAoB,IAAI,IAAI,CAAC,OAAO,qBAAqB,CAAC,CA6CzE;AAED,QAAA,MAAM,oBAAoB;;;;;;EAA8D,CAAC;AAEzF,wBAAgB,mBAAmB,IAAI,IAAI,CAAC,OAAO,oBAAoB,CAAC,CAsBvE;AAED,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;EAShB,CAAC;AAEd,wBAAgB,sBAAsB,IAAI,IAAI,CAAC,OAAO,uBAAuB,CAAC,CA4B7E;AAED,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EAQhB,CAAC;AAEd,wBAAgB,sBAAsB,IAAI,IAAI,CAAC,OAAO,uBAAuB,CAAC,CA0C7E;AAED,QAAA,MAAM,uBAAuB;;;;;;EAA8D,CAAC;AAE5F,wBAAgB,sBAAsB,IAAI,IAAI,CAAC,OAAO,uBAAuB,CAAC,CAuB7E"}

package/dist/memory-tools.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { ToolError, defineTool } from "@dexto/core";
+import { ToolError, createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core";
 const MemorySourceSchema = z.enum(["user", "system"]);
 const MemoryListInputSchema = z.object({
   tags: z.array(z.string()).optional().describe("Optional: filter by tags"),
@@ -11,9 +11,28 @@ const MemoryListInputSchema = z.object({
 function createMemoryListTool() {
   return defineTool({
     id: "memory_list",
-    displayName: "List Memories",
     description: "List stored memories for this agent, with optional filtering.",
     inputSchema: MemoryListInputSchema,
+    presentation: {
+      describeHeader: (input) => {
+        const filterParts = [];
+        if (input.tags && input.tags.length > 0) {
+          filterParts.push(`tags=${input.tags.join(",")}`);
+        }
+        if (input.source) {
+          filterParts.push(`source=${input.source}`);
+        }
+        if (input.pinned !== void 0) {
+          filterParts.push(`pinned=${String(input.pinned)}`);
+        }
+        filterParts.push(`limit=${input.limit}`);
+        filterParts.push(`offset=${input.offset}`);
+        return createLocalToolCallHeader({
+          title: "List Memories",
+          argsText: truncateForHeader(filterParts.join(" "), 140)
+        });
+      }
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -35,9 +54,14 @@ const MemoryGetInputSchema = z.object({ id: z.string().describe("Memory ID") }).
 function createMemoryGetTool() {
   return defineTool({
     id: "memory_get",
-    displayName: "Get Memory",
     description: "Get a memory by ID.",
     inputSchema: MemoryGetInputSchema,
+    presentation: {
+      describeHeader: (input) => createLocalToolCallHeader({
+        title: "Get Memory",
+        argsText: truncateForHeader(input.id, 140)
+      })
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -57,9 +81,14 @@ const MemoryCreateInputSchema = z.object({
 function createMemoryCreateTool() {
   return defineTool({
     id: "memory_create",
-    displayName: "Create Memory",
     description: "Create a new memory.",
     inputSchema: MemoryCreateInputSchema,
+    presentation: {
+      describeHeader: (input) => createLocalToolCallHeader({
+        title: "Create Memory",
+        argsText: truncateForHeader(input.content, 140)
+      })
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -85,9 +114,22 @@ const MemoryUpdateInputSchema = z.object({
 function createMemoryUpdateTool() {
   return defineTool({
     id: "memory_update",
-    displayName: "Update Memory",
     description: "Update an existing memory.",
     inputSchema: MemoryUpdateInputSchema,
+    presentation: {
+      describeHeader: (input) => {
+        const updateParts = [];
+        if (input.content !== void 0) updateParts.push("content");
+        if (input.tags !== void 0) updateParts.push("tags");
+        if (input.source !== void 0) updateParts.push("source");
+        if (input.pinned !== void 0) updateParts.push("pinned");
+        const argsText = updateParts.length > 0 ? truncateForHeader(`${input.id} ${updateParts.join(",")}`, 140) : truncateForHeader(input.id, 140);
+        return createLocalToolCallHeader({
+          title: "Update Memory",
+          argsText
+        });
+      }
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {
@@ -109,9 +151,14 @@ const MemoryDeleteInputSchema = z.object({ id: z.string().describe("Memory ID")
 function createMemoryDeleteTool() {
   return defineTool({
     id: "memory_delete",
-    displayName: "Delete Memory",
     description: "Delete a memory by ID.",
     inputSchema: MemoryDeleteInputSchema,
+    presentation: {
+      describeHeader: (input) => createLocalToolCallHeader({
+        title: "Delete Memory",
+        argsText: truncateForHeader(input.id, 140)
+      })
+    },
     async execute(input, context) {
       const agent = context.agent;
       if (!agent) {

package/dist/search-history-tool.cjs

@@ -38,9 +38,14 @@ const SearchHistoryInputSchema = import_zod.z.object({
 function createSearchHistoryTool() {
   return (0, import_core.defineTool)({
     id: "search_history",
-    displayName: "Search History",
     description: 'Search through conversation history across sessions. Use mode="messages" to search for specific messages, or mode="sessions" to find sessions containing the query. For message search, you can filter by sessionId (specific session), role (user/assistant/system/tool), limit results, and set pagination offset.',
     inputSchema: SearchHistoryInputSchema,
+    presentation: {
+      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+        title: "Search History",
+        argsText: (0, import_core.truncateForHeader)(`${input.mode}: ${input.query}`, 140)
+      })
+    },
     async execute(input, context) {
       const { query, mode, sessionId, role, limit, offset } = input;
       const searchService = context.services?.search;

package/dist/search-history-tool.d.ts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
-import { Tool } from '@dexto/core';
-
+import type { Tool } from '@dexto/core';
 declare const SearchHistoryInputSchema: z.ZodObject<{
     query: z.ZodString;
     mode: z.ZodEnum<["messages", "sessions"]>;
@@ -29,6 +28,6 @@ declare const SearchHistoryInputSchema: z.ZodObject<{
  * Searches message/session history using the configured SearchService.
  * Requires `ToolExecutionContext.services.search`.
  */
-declare function createSearchHistoryTool(): Tool<typeof SearchHistoryInputSchema>;
-
-export { createSearchHistoryTool };
+export declare function createSearchHistoryTool(): Tool<typeof SearchHistoryInputSchema>;
+export {};
+//# sourceMappingURL=search-history-tool.d.ts.map

package/dist/search-history-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-history-tool.d.ts","sourceRoot":"","sources":["../src/search-history-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAG9D,QAAA,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EA6BjB,CAAC;AAEd;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAAC,OAAO,wBAAwB,CAAC,CAqC/E"}

package/dist/search-history-tool.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { ToolError, defineTool } from "@dexto/core";
+import { ToolError, createLocalToolCallHeader, defineTool, truncateForHeader } from "@dexto/core";
 const SearchHistoryInputSchema = z.object({
   query: z.string().describe("The search query to find in conversation history"),
   mode: z.enum(["messages", "sessions"]).describe(
@@ -15,9 +15,14 @@ const SearchHistoryInputSchema = z.object({
 function createSearchHistoryTool() {
   return defineTool({
     id: "search_history",
-    displayName: "Search History",
     description: 'Search through conversation history across sessions. Use mode="messages" to search for specific messages, or mode="sessions" to find sessions containing the query. For message search, you can filter by sessionId (specific session), role (user/assistant/system/tool), limit results, and set pagination offset.',
     inputSchema: SearchHistoryInputSchema,
+    presentation: {
+      describeHeader: (input) => createLocalToolCallHeader({
+        title: "Search History",
+        argsText: truncateForHeader(`${input.mode}: ${input.query}`, 140)
+      })
+    },
     async execute(input, context) {
       const { query, mode, sessionId, role, limit, offset } = input;
       const searchService = context.services?.search;

package/dist/tool-factory-config.d.ts

@@ -1,8 +1,7 @@
 import { z } from 'zod';
-
-declare const LIFECYCLE_TOOL_NAMES: readonly ["view_logs", "search_history", "memory_list", "memory_get", "memory_create", "memory_update", "memory_delete"];
-type LifecycleToolName = (typeof LIFECYCLE_TOOL_NAMES)[number];
-declare const LifecycleToolsConfigSchema: z.ZodObject<{
+export declare const LIFECYCLE_TOOL_NAMES: readonly ["view_logs", "search_history", "memory_list", "memory_get", "memory_create", "memory_update", "memory_delete"];
+export type LifecycleToolName = (typeof LIFECYCLE_TOOL_NAMES)[number];
+export declare const LifecycleToolsConfigSchema: z.ZodObject<{
     type: z.ZodLiteral<"lifecycle-tools">;
     enabledTools: z.ZodOptional<z.ZodArray<z.ZodEnum<["view_logs", "search_history", "memory_list", "memory_get", "memory_create", "memory_update", "memory_delete"]>, "many">>;
     maxLogLines: z.ZodDefault<z.ZodNumber>;
@@ -18,6 +17,5 @@ declare const LifecycleToolsConfigSchema: z.ZodObject<{
     maxLogLines?: number | undefined;
     maxLogBytes?: number | undefined;
 }>;
-type LifecycleToolsConfig = z.output<typeof LifecycleToolsConfigSchema>;
-
-export { LIFECYCLE_TOOL_NAMES, type LifecycleToolName, type LifecycleToolsConfig, LifecycleToolsConfigSchema };
+export type LifecycleToolsConfig = z.output<typeof LifecycleToolsConfigSchema>;
+//# sourceMappingURL=tool-factory-config.d.ts.map

package/dist/tool-factory-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory-config.d.ts","sourceRoot":"","sources":["../src/tool-factory-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,oBAAoB,0HAQvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;EA0B1B,CAAC;AAEd,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/tool-factory.d.ts

@@ -1,7 +1,4 @@
-import { ToolFactory } from '@dexto/agent-config';
-import { LifecycleToolsConfig } from './tool-factory-config.js';
-import 'zod';
-
-declare const lifecycleToolsFactory: ToolFactory<LifecycleToolsConfig>;
-
-export { lifecycleToolsFactory };
+import type { ToolFactory } from '@dexto/agent-config';
+import { type LifecycleToolsConfig } from './tool-factory-config.js';
+export declare const lifecycleToolsFactory: ToolFactory<LifecycleToolsConfig>;
+//# sourceMappingURL=tool-factory.d.ts.map

package/dist/tool-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.d.ts","sourceRoot":"","sources":["../src/tool-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAEH,KAAK,oBAAoB,EAE5B,MAAM,0BAA0B,CAAC;AAalC,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,oBAAoB,CAyBnE,CAAC"}

package/dist/tool-factory.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Lifecycle Tools Factory Tests
+ */
+export {};
+//# sourceMappingURL=tool-factory.test.d.ts.map

package/dist/tool-factory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-factory.test.d.ts","sourceRoot":"","sources":["../src/tool-factory.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/view-logs-tool.cjs

@@ -92,9 +92,14 @@ async function readTailBytes(filePath, maxBytes) {
 function createViewLogsTool(options) {
   return (0, import_core.defineTool)({
     id: "view_logs",
-    displayName: "View Logs",
     description: "View this session log file (tail). Returns the most recent log lines for debugging. If file logging is not configured, returns a message instead.",
     inputSchema: ViewLogsInputSchema,
+    presentation: {
+      describeHeader: (input) => (0, import_core.createLocalToolCallHeader)({
+        title: "View Logs",
+        argsText: `${input.lines} lines`
+      })
+    },
     async execute(parsed, context) {
       const logFilePath = context.logger.getLogFilePath();
       if (!logFilePath) {

package/dist/view-logs-tool.d.ts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
-import { Tool } from '@dexto/core';
-
+import type { Tool } from '@dexto/core';
 declare const ViewLogsInputSchema: z.ZodObject<{
     lines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     query: z.ZodOptional<z.ZodString>;
@@ -20,9 +19,9 @@ declare const ViewLogsInputSchema: z.ZodObject<{
     component?: string | undefined;
     includeContext?: boolean | undefined;
 }>;
-declare function createViewLogsTool(options: {
+export declare function createViewLogsTool(options: {
     maxLogLines: number;
     maxLogBytes: number;
 }): Tool<typeof ViewLogsInputSchema>;
-
-export { createViewLogsTool };
+export {};
+//# sourceMappingURL=view-logs-tool.d.ts.map

package/dist/view-logs-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-logs-tool.d.ts","sourceRoot":"","sources":["../src/view-logs-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,IAAI,EAAwB,MAAM,aAAa,CAAC;AAK9D,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;EAwBZ,CAAC;AAyEd,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACvB,GAAG,IAAI,CAAC,OAAO,mBAAmB,CAAC,CA4HnC"}

package/dist/view-logs-tool.js

@@ -1,6 +1,6 @@
 import * as fs from "node:fs/promises";
 import { z } from "zod";
-import { ToolError, defineTool } from "@dexto/core";
+import { ToolError, createLocalToolCallHeader, defineTool } from "@dexto/core";
 const LOG_LEVEL_VALUES = ["debug", "info", "warn", "error", "silly"];
 const ViewLogsInputSchema = z.object({
   lines: z.number().int().positive().optional().default(200).describe("Number of log lines to return from the end of the log file"),
@@ -59,9 +59,14 @@ async function readTailBytes(filePath, maxBytes) {
 function createViewLogsTool(options) {
   return defineTool({
     id: "view_logs",
-    displayName: "View Logs",
     description: "View this session log file (tail). Returns the most recent log lines for debugging. If file logging is not configured, returns a message instead.",
     inputSchema: ViewLogsInputSchema,
+    presentation: {
+      describeHeader: (input) => createLocalToolCallHeader({
+        title: "View Logs",
+        argsText: `${input.lines} lines`
+      })
+    },
     async execute(parsed, context) {
       const logFilePath = context.logger.getLogFilePath();
       if (!logFilePath) {

package/dist/view-logs-tool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=view-logs-tool.test.d.ts.map

package/dist/view-logs-tool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-logs-tool.test.d.ts","sourceRoot":"","sources":["../src/view-logs-tool.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexto/tools-lifecycle",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "Lifecycle and self-observation tools for Dexto agents",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,8 +20,8 @@
   ],
   "dependencies": {
     "zod": "^3.25.0",
-    "@dexto/agent-config": "1.6.0",
-    "@dexto/core": "1.6.0"
+    "@dexto/agent-config": "1.6.1",
+    "@dexto/core": "1.6.1"
   },
   "devDependencies": {
     "tsup": "^8.0.0",
@@ -33,7 +33,7 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && node ../../scripts/clean-tsbuildinfo.mjs && tsc -b tsconfig.json --emitDeclarationOnly",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   }

package/dist/memory-tools.d.cts

@@ -1,78 +0,0 @@
-import { z } from 'zod';
-import { Tool } from '@dexto/core';
-
-declare const MemoryListInputSchema: z.ZodObject<{
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    source: z.ZodOptional<z.ZodEnum<["user", "system"]>>;
-    pinned: z.ZodOptional<z.ZodBoolean>;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, "strict", z.ZodTypeAny, {
-    limit: number;
-    offset: number;
-    tags?: string[] | undefined;
-    source?: "user" | "system" | undefined;
-    pinned?: boolean | undefined;
-}, {
-    tags?: string[] | undefined;
-    source?: "user" | "system" | undefined;
-    pinned?: boolean | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-}>;
-declare function createMemoryListTool(): Tool<typeof MemoryListInputSchema>;
-declare const MemoryGetInputSchema: z.ZodObject<{
-    id: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    id: string;
-}, {
-    id: string;
-}>;
-declare function createMemoryGetTool(): Tool<typeof MemoryGetInputSchema>;
-declare const MemoryCreateInputSchema: z.ZodObject<{
-    content: z.ZodString;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    source: z.ZodDefault<z.ZodOptional<z.ZodEnum<["user", "system"]>>>;
-    pinned: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strict", z.ZodTypeAny, {
-    source: "user" | "system";
-    pinned: boolean;
-    content: string;
-    tags?: string[] | undefined;
-}, {
-    content: string;
-    tags?: string[] | undefined;
-    source?: "user" | "system" | undefined;
-    pinned?: boolean | undefined;
-}>;
-declare function createMemoryCreateTool(): Tool<typeof MemoryCreateInputSchema>;
-declare const MemoryUpdateInputSchema: z.ZodObject<{
-    id: z.ZodString;
-    content: z.ZodOptional<z.ZodString>;
-    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    source: z.ZodOptional<z.ZodEnum<["user", "system"]>>;
-    pinned: z.ZodOptional<z.ZodBoolean>;
-}, "strict", z.ZodTypeAny, {
-    id: string;
-    tags?: string[] | undefined;
-    source?: "user" | "system" | undefined;
-    pinned?: boolean | undefined;
-    content?: string | undefined;
-}, {
-    id: string;
-    tags?: string[] | undefined;
-    source?: "user" | "system" | undefined;
-    pinned?: boolean | undefined;
-    content?: string | undefined;
-}>;
-declare function createMemoryUpdateTool(): Tool<typeof MemoryUpdateInputSchema>;
-declare const MemoryDeleteInputSchema: z.ZodObject<{
-    id: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    id: string;
-}, {
-    id: string;
-}>;
-declare function createMemoryDeleteTool(): Tool<typeof MemoryDeleteInputSchema>;
-
-export { createMemoryCreateTool, createMemoryDeleteTool, createMemoryGetTool, createMemoryListTool, createMemoryUpdateTool };

package/dist/search-history-tool.d.cts

@@ -1,34 +0,0 @@
-import { z } from 'zod';
-import { Tool } from '@dexto/core';
-
-declare const SearchHistoryInputSchema: z.ZodObject<{
-    query: z.ZodString;
-    mode: z.ZodEnum<["messages", "sessions"]>;
-    sessionId: z.ZodOptional<z.ZodString>;
-    role: z.ZodOptional<z.ZodEnum<["user", "assistant", "system", "tool"]>>;
-    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-}, "strict", z.ZodTypeAny, {
-    query: string;
-    limit: number;
-    offset: number;
-    mode: "messages" | "sessions";
-    sessionId?: string | undefined;
-    role?: "user" | "system" | "assistant" | "tool" | undefined;
-}, {
-    query: string;
-    mode: "messages" | "sessions";
-    sessionId?: string | undefined;
-    limit?: number | undefined;
-    offset?: number | undefined;
-    role?: "user" | "system" | "assistant" | "tool" | undefined;
-}>;
-/**
- * Create the `search_history` tool.
- *
- * Searches message/session history using the configured SearchService.
- * Requires `ToolExecutionContext.services.search`.
- */
-declare function createSearchHistoryTool(): Tool<typeof SearchHistoryInputSchema>;
-
-export { createSearchHistoryTool };

package/dist/tool-factory-config.d.cts

@@ -1,23 +0,0 @@
-import { z } from 'zod';
-
-declare const LIFECYCLE_TOOL_NAMES: readonly ["view_logs", "search_history", "memory_list", "memory_get", "memory_create", "memory_update", "memory_delete"];
-type LifecycleToolName = (typeof LIFECYCLE_TOOL_NAMES)[number];
-declare const LifecycleToolsConfigSchema: z.ZodObject<{
-    type: z.ZodLiteral<"lifecycle-tools">;
-    enabledTools: z.ZodOptional<z.ZodArray<z.ZodEnum<["view_logs", "search_history", "memory_list", "memory_get", "memory_create", "memory_update", "memory_delete"]>, "many">>;
-    maxLogLines: z.ZodDefault<z.ZodNumber>;
-    maxLogBytes: z.ZodDefault<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    type: "lifecycle-tools";
-    maxLogLines: number;
-    maxLogBytes: number;
-    enabledTools?: ("view_logs" | "search_history" | "memory_list" | "memory_get" | "memory_create" | "memory_update" | "memory_delete")[] | undefined;
-}, {
-    type: "lifecycle-tools";
-    enabledTools?: ("view_logs" | "search_history" | "memory_list" | "memory_get" | "memory_create" | "memory_update" | "memory_delete")[] | undefined;
-    maxLogLines?: number | undefined;
-    maxLogBytes?: number | undefined;
-}>;
-type LifecycleToolsConfig = z.output<typeof LifecycleToolsConfigSchema>;
-
-export { LIFECYCLE_TOOL_NAMES, type LifecycleToolName, type LifecycleToolsConfig, LifecycleToolsConfigSchema };

package/dist/tool-factory.d.cts

@@ -1,7 +0,0 @@
-import { ToolFactory } from '@dexto/agent-config';
-import { LifecycleToolsConfig } from './tool-factory-config.cjs';
-import 'zod';
-
-declare const lifecycleToolsFactory: ToolFactory<LifecycleToolsConfig>;
-
-export { lifecycleToolsFactory };

package/dist/view-logs-tool.d.cts

@@ -1,28 +0,0 @@
-import { z } from 'zod';
-import { Tool } from '@dexto/core';
-
-declare const ViewLogsInputSchema: z.ZodObject<{
-    lines: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    query: z.ZodOptional<z.ZodString>;
-    level: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["debug", "info", "warn", "error", "silly"]>, z.ZodArray<z.ZodEnum<["debug", "info", "warn", "error", "silly"]>, "many">]>>;
-    component: z.ZodOptional<z.ZodString>;
-    includeContext: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-}, "strict", z.ZodTypeAny, {
-    lines: number;
-    includeContext: boolean;
-    query?: string | undefined;
-    level?: "debug" | "info" | "warn" | "error" | "silly" | ("debug" | "info" | "warn" | "error" | "silly")[] | undefined;
-    component?: string | undefined;
-}, {
-    lines?: number | undefined;
-    query?: string | undefined;
-    level?: "debug" | "info" | "warn" | "error" | "silly" | ("debug" | "info" | "warn" | "error" | "silly")[] | undefined;
-    component?: string | undefined;
-    includeContext?: boolean | undefined;
-}>;
-declare function createViewLogsTool(options: {
-    maxLogLines: number;
-    maxLogBytes: number;
-}): Tool<typeof ViewLogsInputSchema>;
-
-export { createViewLogsTool };