@dexto/core 1.1.4 → 1.1.6

package/dist/systemPrompt/schemas.d.ts

@@ -0,0 +1,401 @@
+import { z } from 'zod';
+
+declare const ContributorConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    id: z.ZodString;
+    priority: z.ZodNumber;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+} & {
+    type: z.ZodLiteral<"static">;
+    content: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "static";
+    content: string;
+    id: string;
+    priority: number;
+    enabled: boolean;
+}, {
+    type: "static";
+    content: string;
+    id: string;
+    priority: number;
+    enabled?: boolean | undefined;
+}>, z.ZodObject<{
+    id: z.ZodString;
+    priority: z.ZodNumber;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+} & {
+    type: z.ZodLiteral<"dynamic">;
+    source: z.ZodEnum<["dateTime", "memorySummary", "resources"]>;
+}, "strict", z.ZodTypeAny, {
+    type: "dynamic";
+    id: string;
+    priority: number;
+    enabled: boolean;
+    source: "resources" | "dateTime" | "memorySummary";
+}, {
+    type: "dynamic";
+    id: string;
+    priority: number;
+    source: "resources" | "dateTime" | "memorySummary";
+    enabled?: boolean | undefined;
+}>, z.ZodObject<{
+    id: z.ZodString;
+    priority: z.ZodNumber;
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+} & {
+    type: z.ZodLiteral<"file">;
+    files: z.ZodArray<z.ZodString, "many">;
+    options: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        includeFilenames: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        separator: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        errorHandling: z.ZodDefault<z.ZodOptional<z.ZodEnum<["skip", "error"]>>>;
+        maxFileSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        includeMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strict", z.ZodTypeAny, {
+        includeFilenames: boolean;
+        separator: string;
+        errorHandling: "error" | "skip";
+        maxFileSize: number;
+        includeMetadata: boolean;
+    }, {
+        includeFilenames?: boolean | undefined;
+        separator?: string | undefined;
+        errorHandling?: "error" | "skip" | undefined;
+        maxFileSize?: number | undefined;
+        includeMetadata?: boolean | undefined;
+    }>>>;
+}, "strict", z.ZodTypeAny, {
+    options: {
+        includeFilenames: boolean;
+        separator: string;
+        errorHandling: "error" | "skip";
+        maxFileSize: number;
+        includeMetadata: boolean;
+    };
+    type: "file";
+    id: string;
+    priority: number;
+    enabled: boolean;
+    files: string[];
+}, {
+    type: "file";
+    id: string;
+    priority: number;
+    files: string[];
+    options?: {
+        includeFilenames?: boolean | undefined;
+        separator?: string | undefined;
+        errorHandling?: "error" | "skip" | undefined;
+        maxFileSize?: number | undefined;
+        includeMetadata?: boolean | undefined;
+    } | undefined;
+    enabled?: boolean | undefined;
+}>]>;
+type ContributorConfig = z.input<typeof ContributorConfigSchema>;
+type ValidatedContributorConfig = z.output<typeof ContributorConfigSchema>;
+declare const SystemPromptContributorsSchema: z.ZodObject<{
+    contributors: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        id: z.ZodString;
+        priority: z.ZodNumber;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        type: z.ZodLiteral<"static">;
+        content: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled: boolean;
+    }, {
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        priority: z.ZodNumber;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        type: z.ZodLiteral<"dynamic">;
+        source: z.ZodEnum<["dateTime", "memorySummary", "resources"]>;
+    }, "strict", z.ZodTypeAny, {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        source: "resources" | "dateTime" | "memorySummary";
+    }, {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        source: "resources" | "dateTime" | "memorySummary";
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        priority: z.ZodNumber;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        type: z.ZodLiteral<"file">;
+        files: z.ZodArray<z.ZodString, "many">;
+        options: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            includeFilenames: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            separator: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            errorHandling: z.ZodDefault<z.ZodOptional<z.ZodEnum<["skip", "error"]>>>;
+            maxFileSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            includeMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strict", z.ZodTypeAny, {
+            includeFilenames: boolean;
+            separator: string;
+            errorHandling: "error" | "skip";
+            maxFileSize: number;
+            includeMetadata: boolean;
+        }, {
+            includeFilenames?: boolean | undefined;
+            separator?: string | undefined;
+            errorHandling?: "error" | "skip" | undefined;
+            maxFileSize?: number | undefined;
+            includeMetadata?: boolean | undefined;
+        }>>>;
+    }, "strict", z.ZodTypeAny, {
+        options: {
+            includeFilenames: boolean;
+            separator: string;
+            errorHandling: "error" | "skip";
+            maxFileSize: number;
+            includeMetadata: boolean;
+        };
+        type: "file";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        files: string[];
+    }, {
+        type: "file";
+        id: string;
+        priority: number;
+        files: string[];
+        options?: {
+            includeFilenames?: boolean | undefined;
+            separator?: string | undefined;
+            errorHandling?: "error" | "skip" | undefined;
+            maxFileSize?: number | undefined;
+            includeMetadata?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    }>]>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    contributors: ({
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled: boolean;
+    } | {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        source: "resources" | "dateTime" | "memorySummary";
+    } | {
+        options: {
+            includeFilenames: boolean;
+            separator: string;
+            errorHandling: "error" | "skip";
+            maxFileSize: number;
+            includeMetadata: boolean;
+        };
+        type: "file";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        files: string[];
+    })[];
+}, {
+    contributors?: ({
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    } | {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        source: "resources" | "dateTime" | "memorySummary";
+        enabled?: boolean | undefined;
+    } | {
+        type: "file";
+        id: string;
+        priority: number;
+        files: string[];
+        options?: {
+            includeFilenames?: boolean | undefined;
+            separator?: string | undefined;
+            errorHandling?: "error" | "skip" | undefined;
+            maxFileSize?: number | undefined;
+            includeMetadata?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    })[] | undefined;
+}>;
+declare const SystemPromptConfigSchema: z.ZodBranded<z.ZodUnion<[z.ZodEffects<z.ZodString, {
+    contributors: {
+        id: string;
+        type: "static";
+        content: string;
+        priority: number;
+        enabled: boolean;
+    }[];
+}, string>, z.ZodObject<{
+    contributors: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        id: z.ZodString;
+        priority: z.ZodNumber;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        type: z.ZodLiteral<"static">;
+        content: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled: boolean;
+    }, {
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        priority: z.ZodNumber;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        type: z.ZodLiteral<"dynamic">;
+        source: z.ZodEnum<["dateTime", "memorySummary", "resources"]>;
+    }, "strict", z.ZodTypeAny, {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        source: "resources" | "dateTime" | "memorySummary";
+    }, {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        source: "resources" | "dateTime" | "memorySummary";
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        id: z.ZodString;
+        priority: z.ZodNumber;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    } & {
+        type: z.ZodLiteral<"file">;
+        files: z.ZodArray<z.ZodString, "many">;
+        options: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            includeFilenames: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            separator: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            errorHandling: z.ZodDefault<z.ZodOptional<z.ZodEnum<["skip", "error"]>>>;
+            maxFileSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            includeMetadata: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strict", z.ZodTypeAny, {
+            includeFilenames: boolean;
+            separator: string;
+            errorHandling: "error" | "skip";
+            maxFileSize: number;
+            includeMetadata: boolean;
+        }, {
+            includeFilenames?: boolean | undefined;
+            separator?: string | undefined;
+            errorHandling?: "error" | "skip" | undefined;
+            maxFileSize?: number | undefined;
+            includeMetadata?: boolean | undefined;
+        }>>>;
+    }, "strict", z.ZodTypeAny, {
+        options: {
+            includeFilenames: boolean;
+            separator: string;
+            errorHandling: "error" | "skip";
+            maxFileSize: number;
+            includeMetadata: boolean;
+        };
+        type: "file";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        files: string[];
+    }, {
+        type: "file";
+        id: string;
+        priority: number;
+        files: string[];
+        options?: {
+            includeFilenames?: boolean | undefined;
+            separator?: string | undefined;
+            errorHandling?: "error" | "skip" | undefined;
+            maxFileSize?: number | undefined;
+            includeMetadata?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    }>]>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    contributors: ({
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled: boolean;
+    } | {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        source: "resources" | "dateTime" | "memorySummary";
+    } | {
+        options: {
+            includeFilenames: boolean;
+            separator: string;
+            errorHandling: "error" | "skip";
+            maxFileSize: number;
+            includeMetadata: boolean;
+        };
+        type: "file";
+        id: string;
+        priority: number;
+        enabled: boolean;
+        files: string[];
+    })[];
+}, {
+    contributors?: ({
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    } | {
+        type: "dynamic";
+        id: string;
+        priority: number;
+        source: "resources" | "dateTime" | "memorySummary";
+        enabled?: boolean | undefined;
+    } | {
+        type: "file";
+        id: string;
+        priority: number;
+        files: string[];
+        options?: {
+            includeFilenames?: boolean | undefined;
+            separator?: string | undefined;
+            errorHandling?: "error" | "skip" | undefined;
+            maxFileSize?: number | undefined;
+            includeMetadata?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    })[] | undefined;
+}>]>, "ValidatedSystemPromptConfig">;
+type SystemPromptConfig = z.input<typeof SystemPromptConfigSchema>;
+type ValidatedSystemPromptConfig = z.output<typeof SystemPromptConfigSchema>;
+
+export { type ContributorConfig, ContributorConfigSchema, type SystemPromptConfig, SystemPromptConfigSchema, SystemPromptContributorsSchema, type ValidatedContributorConfig, type ValidatedSystemPromptConfig };

package/dist/systemPrompt/schemas.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+import { PROMPT_GENERATOR_SOURCES } from "./registry.js";
+const BaseContributorSchema = z.object({
+  id: z.string().describe("Unique identifier for the contributor"),
+  priority: z.number().int().nonnegative().describe("Execution priority of the contributor (lower numbers run first)"),
+  enabled: z.boolean().optional().default(true).describe("Whether this contributor is currently active")
+}).strict();
+const StaticContributorSchema = BaseContributorSchema.extend({
+  type: z.literal("static"),
+  content: z.string().describe("Static content for the contributor (REQUIRED for 'static')")
+  // No 'source' field here, as it's not relevant to static contributors
+}).strict();
+const DynamicContributorSchema = BaseContributorSchema.extend({
+  type: z.literal("dynamic"),
+  source: z.enum(PROMPT_GENERATOR_SOURCES).describe("Source identifier for dynamic content (REQUIRED for 'dynamic')")
+  // No 'content' field here, as it's not relevant to dynamic contributors (source provides the content)
+}).strict();
+const FileContributorSchema = BaseContributorSchema.extend({
+  type: z.literal("file"),
+  files: z.array(z.string()).min(1).describe("Array of file paths to include as context (.md and .txt files)"),
+  options: z.object({
+    includeFilenames: z.boolean().optional().default(true).describe("Whether to include the filename as a header for each file"),
+    separator: z.string().optional().default("\n\n---\n\n").describe("Separator to use between multiple files"),
+    errorHandling: z.enum(["skip", "error"]).optional().default("skip").describe(
+      "How to handle missing or unreadable files: skip (ignore) or error (throw)"
+    ),
+    maxFileSize: z.number().int().positive().optional().default(1e5).describe("Maximum file size in bytes (default: 100KB)"),
+    includeMetadata: z.boolean().optional().default(false).describe(
+      "Whether to include file metadata (size, modification time) in the context"
+    )
+  }).strict().optional().default({})
+}).strict();
+const ContributorConfigSchema = z.discriminatedUnion(
+  "type",
+  // The field to discriminate on
+  [StaticContributorSchema, DynamicContributorSchema, FileContributorSchema],
+  {
+    // Optional: Custom error message for invalid discriminator
+    errorMap: (issue, ctx) => {
+      if (issue.code === z.ZodIssueCode.invalid_union_discriminator) {
+        return {
+          message: `Invalid contributor type. Expected 'static', 'dynamic', or 'file'.`
+        };
+      }
+      return { message: ctx.defaultError };
+    }
+  }
+).describe(
+  "Configuration for a system prompt contributor. Type 'static' requires 'content', type 'dynamic' requires 'source', type 'file' requires 'files'."
+);
+const SystemPromptContributorsSchema = z.object({
+  contributors: z.array(ContributorConfigSchema).min(1).default([
+    {
+      id: "dateTime",
+      type: "dynamic",
+      priority: 10,
+      source: "dateTime",
+      enabled: true
+    },
+    {
+      id: "resources",
+      type: "dynamic",
+      priority: 20,
+      source: "resources",
+      enabled: false
+    }
+  ]).describe("An array of contributor configurations that make up the system prompt")
+}).strict();
+const SystemPromptConfigSchema = z.union([
+  z.string().transform((str) => ({
+    contributors: [
+      { id: "inline", type: "static", content: str, priority: 0, enabled: true }
+    ]
+  })),
+  SystemPromptContributorsSchema
+]).describe("Plain string or structured contributors object").brand();
+export {
+  ContributorConfigSchema,
+  SystemPromptConfigSchema,
+  SystemPromptContributorsSchema
+};

package/dist/systemPrompt/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/systemPrompt/types.d.cts

@@ -0,0 +1,19 @@
+import { MCPManager } from '../mcp/manager.cjs';
+import '../mcp/schemas.cjs';
+import 'zod';
+import '../mcp/types.cjs';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '../tools/types.cjs';
+import 'json-schema';
+import '@modelcontextprotocol/sdk/types.js';
+
+interface DynamicContributorContext {
+    mcpManager: MCPManager;
+}
+interface SystemPromptContributor {
+    id: string;
+    priority: number;
+    getContent(context: DynamicContributorContext): Promise<string>;
+}
+
+export type { DynamicContributorContext, SystemPromptContributor };

package/dist/systemPrompt/types.d.ts

@@ -0,0 +1,19 @@
+import { MCPManager } from '../mcp/manager.js';
+import '../mcp/schemas.js';
+import 'zod';
+import '../mcp/types.js';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '../tools/types.js';
+import 'json-schema';
+import '@modelcontextprotocol/sdk/types.js';
+
+interface DynamicContributorContext {
+    mcpManager: MCPManager;
+}
+interface SystemPromptContributor {
+    id: string;
+    priority: number;
+    getContent(context: DynamicContributorContext): Promise<string>;
+}
+
+export type { DynamicContributorContext, SystemPromptContributor };

package/dist/tools/confirmation/allowed-tools-provider/factory.cjs

@@ -0,0 +1,44 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var factory_exports = {};
+__export(factory_exports, {
+  createAllowedToolsProvider: () => createAllowedToolsProvider
+});
+module.exports = __toCommonJS(factory_exports);
+var import_in_memory = require("./in-memory.js");
+var import_storage = require("./storage.js");
+var import_errors = require("../../errors.js");
+function createAllowedToolsProvider(config) {
+  switch (config.type) {
+    case "memory":
+      return new import_in_memory.InMemoryAllowedToolsProvider();
+    case "storage":
+      return new import_storage.StorageAllowedToolsProvider(config.storage);
+    default: {
+      const _exhaustive = config;
+      throw import_errors.ToolError.configInvalid(
+        `Unsupported AllowedToolsConfig type: ${config?.type}`
+      );
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAllowedToolsProvider
+});

package/dist/tools/confirmation/allowed-tools-provider/factory.d.cts

@@ -0,0 +1,19 @@
+import { IAllowedToolsProvider } from './types.cjs';
+import { StorageBackends } from '../../../storage/backend/types.cjs';
+import '../../../storage/backend/cache-backend.cjs';
+import '../../../storage/backend/database-backend.cjs';
+import '../../../storage/schemas.cjs';
+import 'zod';
+
+type AllowedToolsConfig = {
+    type: 'memory';
+} | {
+    type: 'storage';
+    storage: StorageBackends;
+};
+/**
+ * Create an AllowedToolsProvider based on configuration.
+ */
+declare function createAllowedToolsProvider(config: AllowedToolsConfig): IAllowedToolsProvider;
+
+export { type AllowedToolsConfig, createAllowedToolsProvider };

package/dist/tools/confirmation/allowed-tools-provider/factory.d.ts

@@ -0,0 +1,19 @@
+import { IAllowedToolsProvider } from './types.js';
+import { StorageBackends } from '../../../storage/backend/types.js';
+import '../../../storage/backend/cache-backend.js';
+import '../../../storage/backend/database-backend.js';
+import '../../../storage/schemas.js';
+import 'zod';
+
+type AllowedToolsConfig = {
+    type: 'memory';
+} | {
+    type: 'storage';
+    storage: StorageBackends;
+};
+/**
+ * Create an AllowedToolsProvider based on configuration.
+ */
+declare function createAllowedToolsProvider(config: AllowedToolsConfig): IAllowedToolsProvider;
+
+export { type AllowedToolsConfig, createAllowedToolsProvider };

package/dist/tools/confirmation/allowed-tools-provider/factory.js

@@ -0,0 +1,20 @@
+import { InMemoryAllowedToolsProvider } from "./in-memory.js";
+import { StorageAllowedToolsProvider } from "./storage.js";
+import { ToolError } from "../../errors.js";
+function createAllowedToolsProvider(config) {
+  switch (config.type) {
+    case "memory":
+      return new InMemoryAllowedToolsProvider();
+    case "storage":
+      return new StorageAllowedToolsProvider(config.storage);
+    default: {
+      const _exhaustive = config;
+      throw ToolError.configInvalid(
+        `Unsupported AllowedToolsConfig type: ${config?.type}`
+      );
+    }
+  }
+}
+export {
+  createAllowedToolsProvider
+};