@polka-codes/core 0.9.89 → 0.9.91

package/dist/_tsup-dts-rollup.d.ts

@@ -60,6 +60,63 @@ export { AgentWorkflowInput }
 export { AgentWorkflowInput as AgentWorkflowInput_alias_1 }
 export { AgentWorkflowInput as AgentWorkflowInput_alias_2 }
 
+declare type BaseApprovalConfig = z.infer<typeof baseApprovalConfigSchema>;
+export { BaseApprovalConfig }
+export { BaseApprovalConfig as BaseApprovalConfig_alias_1 }
+export { BaseApprovalConfig as BaseApprovalConfig_alias_2 }
+
+/**
+ * Base approval configuration pattern
+ */
+declare const baseApprovalConfigSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        destructive: "destructive";
+        commits: "commits";
+        all: "all";
+    }>>;
+    autoApprove: z.ZodOptional<z.ZodBoolean>;
+    maxCost: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export { baseApprovalConfigSchema }
+export { baseApprovalConfigSchema as baseApprovalConfigSchema_alias_1 }
+export { baseApprovalConfigSchema as baseApprovalConfigSchema_alias_2 }
+
+/**
+ * Base error class that preserves error name in stack traces
+ *
+ * All custom errors should extend this class to ensure:
+ * - Proper stack trace with error name
+ * - Cause chain support
+ * - Consistent error handling
+ */
+declare class BaseError extends Error {
+    name: string;
+    cause?: Error | undefined;
+    constructor(name: string, message: string, cause?: Error | undefined);
+}
+export { BaseError }
+export { BaseError as BaseError_alias_1 }
+export { BaseError as BaseError_alias_2 }
+
+declare type BaseModelConfig = z.infer<typeof baseModelConfigSchema>;
+export { BaseModelConfig }
+export { BaseModelConfig as BaseModelConfig_alias_1 }
+export { BaseModelConfig as BaseModelConfig_alias_2 }
+
+/**
+ * Base model configuration pattern
+ * Used wherever a provider/model combination needs to be specified
+ */
+declare const baseModelConfigSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export { baseModelConfigSchema }
+export { baseModelConfigSchema as baseModelConfigSchema_alias_1 }
+export { baseModelConfigSchema as baseModelConfigSchema_alias_2 }
+
 declare interface BreakStep {
     break: true;
 }
@@ -117,7 +174,7 @@ declare const configSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     providers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         apiKey: z.ZodOptional<z.ZodString>;
         defaultModel: z.ZodOptional<z.ZodString>;
-        defaultParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        defaultParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         location: z.ZodOptional<z.ZodString>;
         project: z.ZodOptional<z.ZodString>;
         keyFile: z.ZodOptional<z.ZodString>;
@@ -126,7 +183,7 @@ declare const configSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     }, z.core.$strip>>>;
     defaultProvider: z.ZodOptional<z.ZodString>;
     defaultModel: z.ZodOptional<z.ZodString>;
-    defaultParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    defaultParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     maxMessageCount: z.ZodOptional<z.ZodNumber>;
     budget: z.ZodOptional<z.ZodNumber>;
     retryCount: z.ZodOptional<z.ZodNumber>;
@@ -138,15 +195,15 @@ declare const configSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     }, z.core.$strict>, z.ZodObject<{
         workflow: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
-        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>, z.ZodObject<{
         script: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
         permissions: z.ZodOptional<z.ZodObject<{
             fs: z.ZodOptional<z.ZodEnum<{
+                none: "none";
                 read: "read";
                 write: "write";
-                none: "none";
             }>>;
             network: z.ZodOptional<z.ZodBoolean>;
             subprocess: z.ZodOptional<z.ZodBoolean>;
@@ -157,7 +214,7 @@ declare const configSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
     commands: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
-        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         budget: z.ZodOptional<z.ZodNumber>;
         rules: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
             path: z.ZodString;
@@ -175,7 +232,7 @@ declare const configSchema: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         search: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
             provider: z.ZodOptional<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
-            parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
             budget: z.ZodOptional<z.ZodNumber>;
             rules: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
                 path: z.ZodString;
@@ -316,6 +373,28 @@ export { createDynamicWorkflow }
 export { createDynamicWorkflow as createDynamicWorkflow_alias_1 }
 export { createDynamicWorkflow as createDynamicWorkflow_alias_2 }
 
+/**
+ * Factory that creates NAMED error classes (not anonymous) for proper stack traces
+ *
+ * The factory returns a named class that extends BaseError.
+ * Stack traces will show the actual error class name, not "BaseError" or "createErrorClass".
+ *
+ * @example
+ * ```typescript
+ * export const FileSystemAccessError = createErrorClass(
+ *   'FileSystemAccessError',
+ *   ([path, operation]: [string, string]) => `Failed to ${operation} ${path}`
+ * )
+ *
+ * // Stack trace will show: "at new FileSystemAccessError"
+ * // NOT: "at new createErrorClass" or "at new BaseError"
+ * ```
+ */
+declare function createErrorClass<T extends any[]>(name: string, template: (args: T) => string): new (...args: T) => BaseError;
+export { createErrorClass }
+export { createErrorClass as createErrorClass_alias_1 }
+export { createErrorClass as createErrorClass_alias_2 }
+
 /**
  * Create an error tool response
  *
@@ -409,6 +488,36 @@ export { DatabaseStats }
 export { DatabaseStats as DatabaseStats_alias_1 }
 export { DatabaseStats as DatabaseStats_alias_2 }
 
+/**
+ * Deep merge utility with EXPLICIT path specification
+ *
+ * This utility performs a shallow merge by default, with deep merging
+ * ONLY for paths explicitly specified. This prevents accidental deep
+ * merging of unexpected properties.
+ *
+ * @example
+ * ```typescript
+ * const config = { a: 1, b: { x: 1, y: 2 }, c: { z: 3 } }
+ * const override = { a: 2, b: { x: 10 }, c: 'not-an-object' }
+ *
+ * // Deep merge only 'b', shallow merge everything else
+ * const result = deepMerge(config, override, ['b'])
+ * // Result: { a: 2, b: { x: 10, y: 2 }, c: 'not-an-object' }
+ *
+ * // Note: 'c' was NOT deep merged because it's not in deepPaths
+ * // Note: 'b.x' was updated while 'b.y' was preserved (deep merge)
+ * ```
+ *
+ * @param base - The base object to merge into
+ * @param override - The object with values to override
+ * @param deepPaths - Array of keys that should be deep merged (must be plain objects)
+ * @returns A new object with merged values
+ */
+declare function deepMerge<T extends object>(base: T, override: Partial<T>, deepPaths: Array<keyof T>): T;
+export { deepMerge }
+export { deepMerge as deepMerge_alias_1 }
+export { deepMerge as deepMerge_alias_2 }
+
 declare const _default: {
     handler: ToolHandler<{
         readonly name: "askFollowupQuestion";
@@ -969,13 +1078,16 @@ declare interface IMemoryStore {
      * @param operation - The operation to perform ('append', 'replace', 'remove')
      * @param topic - The topic name
      * @param content - The content (required for append/replace)
-     * @param metadata - Optional metadata (entry_type, status, priority, tags)
+     * @param metadata - Optional metadata (entry_type, status, priority, tags, timestamps)
      */
     updateMemory(operation: 'append' | 'replace' | 'remove', topic: string, content: string | undefined, metadata?: {
         entry_type?: string;
         status?: string;
         priority?: string;
         tags?: string;
+        created_at?: number;
+        updated_at?: number;
+        last_accessed?: number;
     }): Promise<void>;
     /**
      * Query memory with filters
@@ -1000,7 +1112,7 @@ declare interface IMemoryStore {
     /**
      * Close the memory store and release resources
      */
-    close(): void;
+    close(): Promise<void>;
 }
 export { IMemoryStore }
 export { IMemoryStore as IMemoryStore_alias_1 }
@@ -1426,6 +1538,9 @@ declare type MemoryOperation = {
         priority?: string;
         tags?: string;
         metadata?: string;
+        created_at?: number;
+        updated_at?: number;
+        last_accessed?: number;
     };
 };
 export { MemoryOperation }
@@ -1446,6 +1561,7 @@ export { MemoryProvider as MemoryProvider_alias_2 }
  */
 declare type MemoryQuery = {
     scope?: 'global' | 'project' | 'auto';
+    name?: string;
     type?: string;
     status?: string;
     priority?: string;
@@ -1510,6 +1626,26 @@ export { MockProvider }
 export { MockProvider as MockProvider_alias_1 }
 export { MockProvider as MockProvider_alias_2 }
 
+declare type ModelConfig = z.infer<typeof modelConfigSchema>;
+export { ModelConfig }
+export { ModelConfig as ModelConfig_alias_1 }
+export { ModelConfig as ModelConfig_alias_2 }
+
+/**
+ * Model configuration with optional provider override
+ * Combines base model config with budget and rules
+ */
+declare const modelConfigSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    budget: z.ZodOptional<z.ZodNumber>;
+    rules: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodOptional<z.ZodArray<z.ZodString>>]>>;
+}, z.core.$strip>;
+export { modelConfigSchema }
+export { modelConfigSchema as modelConfigSchema_alias_1 }
+export { modelConfigSchema as modelConfigSchema_alias_2 }
+
 declare type ModelInfo = {
     inputPrice: number;
     outputPrice: number;
@@ -1568,11 +1704,16 @@ export declare function preprocessBoolean(val: unknown): unknown;
 declare type ProviderConfig = z.infer<typeof providerConfigSchema>;
 export { ProviderConfig }
 export { ProviderConfig as ProviderConfig_alias_1 }
+export { ProviderConfig as ProviderConfig_alias_2 }
 
+/**
+ * Provider configuration (credentials and settings)
+ * Separate from model selection - this is about auth and provider settings
+ */
 declare const providerConfigSchema: z.ZodObject<{
     apiKey: z.ZodOptional<z.ZodString>;
     defaultModel: z.ZodOptional<z.ZodString>;
-    defaultParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    defaultParameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     location: z.ZodOptional<z.ZodString>;
     project: z.ZodOptional<z.ZodString>;
     keyFile: z.ZodOptional<z.ZodString>;
@@ -1581,11 +1722,12 @@ declare const providerConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 export { providerConfigSchema }
 export { providerConfigSchema as providerConfigSchema_alias_1 }
+export { providerConfigSchema as providerConfigSchema_alias_2 }
 
 declare const providerModelSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
-    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     budget: z.ZodOptional<z.ZodNumber>;
     rules: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         path: z.ZodString;
@@ -1694,6 +1836,7 @@ export { ReplaceResult as ReplaceResult_alias_1 }
 
 /**
  * Resolve home directory in path
+ * Supports both Unix (HOME) and Windows (USERPROFILE) environments
  */
 declare function resolveHomePath(path: string): string;
 export { resolveHomePath }
@@ -1749,15 +1892,15 @@ declare const scriptSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
 }, z.core.$strict>, z.ZodObject<{
     workflow: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
-    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>, z.ZodObject<{
     script: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     permissions: z.ZodOptional<z.ZodObject<{
         fs: z.ZodOptional<z.ZodEnum<{
+            none: "none";
             read: "read";
             write: "write";
-            none: "none";
         }>>;
         network: z.ZodOptional<z.ZodBoolean>;
         subprocess: z.ZodOptional<z.ZodBoolean>;
@@ -1840,6 +1983,9 @@ export { SkillContext as SkillContext_alias_2 }
 
 /**
  * Error thrown when skill discovery fails
+ *
+ * Note: This error has a custom `path` property that is accessed by callers.
+ * Keeping as a class since the error factory doesn't support custom properties.
  */
 declare class SkillDiscoveryError extends Error {
     path: string;
@@ -1952,6 +2098,9 @@ export { SkillSource as SkillSource_alias_2 }
 
 /**
  * Error thrown when skill validation fails
+ *
+ * Note: This error has a custom `path` property that is accessed by callers.
+ * Keeping as a class since the error factory doesn't support custom properties.
  */
 declare class SkillValidationError extends Error {
     path: string;
@@ -2187,6 +2336,24 @@ export { TOOL_GROUPS }
 export { TOOL_GROUPS as TOOL_GROUPS_alias_1 }
 export { TOOL_GROUPS as TOOL_GROUPS_alias_2 }
 
+declare type ToolConfig = z.infer<typeof toolConfigSchema>;
+export { ToolConfig }
+export { ToolConfig as ToolConfig_alias_1 }
+export { ToolConfig as ToolConfig_alias_2 }
+
+/**
+ * Helper to create a model config schema with tool-specific overrides
+ * Used in MCP server tool configuration
+ */
+declare const toolConfigSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>;
+export { toolConfigSchema }
+export { toolConfigSchema as toolConfigSchema_alias_1 }
+export { toolConfigSchema as toolConfigSchema_alias_2 }
+
 declare type ToolHandler<_T, P> = (provider: P, args: Partial<Record<string, ToolParameterValue>>) => Promise<ToolResponse>;
 export { ToolHandler }
 export { ToolHandler as ToolHandler_alias_1 }
@@ -2620,7 +2787,7 @@ declare const WorkflowDefinitionSchema: z.ZodObject<{
     inputs: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        default: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+        default: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
     }, z.core.$strip>>>>;
     steps: z.ZodArray<z.ZodType<WorkflowControlFlowStep, unknown, z.core.$ZodTypeInternals<WorkflowControlFlowStep, unknown>>>;
     output: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2640,7 +2807,7 @@ declare const WorkflowFileSchema: z.ZodObject<{
         inputs: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            default: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+            default: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
         }, z.core.$strip>>>>;
         steps: z.ZodArray<z.ZodType<WorkflowControlFlowStep, unknown, z.core.$ZodTypeInternals<WorkflowControlFlowStep, unknown>>>;
         output: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -2663,7 +2830,7 @@ export { WorkflowInputDefinition as WorkflowInputDefinition_alias_2 }
 declare const WorkflowInputDefinitionSchema: z.ZodObject<{
     id: z.ZodString;
     description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    default: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+    default: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
 }, z.core.$strip>;
 export { WorkflowInputDefinitionSchema }
 export { WorkflowInputDefinitionSchema as WorkflowInputDefinitionSchema_alias_1 }
@@ -2683,7 +2850,7 @@ declare const WorkflowStepDefinitionSchema: z.ZodObject<{
     task: z.ZodString;
     output: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     expected_outcome: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    outputSchema: z.ZodOptional<z.ZodNullable<z.ZodAny>>;
+    outputSchema: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
     timeout: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export { WorkflowStepDefinitionSchema }

package/dist/index.d.ts

@@ -3,21 +3,31 @@ export { ParseOutputResult } from './_tsup-dts-rollup.js';
 export { parseJsonFromMarkdown } from './_tsup-dts-rollup.js';
 export { responsePrompts } from './_tsup-dts-rollup.js';
 export { computeRateLimitBackoffSeconds } from './_tsup-dts-rollup.js';
+export { BaseApprovalConfig_alias_1 as BaseApprovalConfig } from './_tsup-dts-rollup.js';
+export { BaseModelConfig_alias_1 as BaseModelConfig } from './_tsup-dts-rollup.js';
+export { baseApprovalConfigSchema_alias_1 as baseApprovalConfigSchema } from './_tsup-dts-rollup.js';
+export { baseModelConfigSchema_alias_1 as baseModelConfigSchema } from './_tsup-dts-rollup.js';
+export { ModelConfig_alias_1 as ModelConfig } from './_tsup-dts-rollup.js';
+export { modelConfigSchema_alias_1 as modelConfigSchema } from './_tsup-dts-rollup.js';
+export { ProviderConfig_alias_1 as ProviderConfig } from './_tsup-dts-rollup.js';
+export { providerConfigSchema_alias_1 as providerConfigSchema } from './_tsup-dts-rollup.js';
+export { ToolConfig_alias_1 as ToolConfig } from './_tsup-dts-rollup.js';
+export { toolConfigSchema_alias_1 as toolConfigSchema } from './_tsup-dts-rollup.js';
 export { memoryConfigSchema_alias_1 as memoryConfigSchema } from './_tsup-dts-rollup.js';
 export { DEFAULT_MEMORY_CONFIG_alias_1 as DEFAULT_MEMORY_CONFIG } from './_tsup-dts-rollup.js';
 export { MemoryConfig_alias_1 as MemoryConfig } from './_tsup-dts-rollup.js';
 export { resolveHomePath_alias_1 as resolveHomePath } from './_tsup-dts-rollup.js';
 export { ruleSchema_alias_1 as ruleSchema } from './_tsup-dts-rollup.js';
-export { providerConfigSchema_alias_1 as providerConfigSchema } from './_tsup-dts-rollup.js';
 export { providerModelSchema_alias_1 as providerModelSchema } from './_tsup-dts-rollup.js';
 export { ConfigRule_alias_1 as ConfigRule } from './_tsup-dts-rollup.js';
-export { ProviderConfig_alias_1 as ProviderConfig } from './_tsup-dts-rollup.js';
 export { scriptSchema_alias_1 as scriptSchema } from './_tsup-dts-rollup.js';
 export { ScriptConfig_alias_1 as ScriptConfig } from './_tsup-dts-rollup.js';
 export { mcpServerConfigSchema_alias_1 as mcpServerConfigSchema } from './_tsup-dts-rollup.js';
 export { McpServerConfig_alias_1 as McpServerConfig } from './_tsup-dts-rollup.js';
 export { configSchema_alias_1 as configSchema } from './_tsup-dts-rollup.js';
 export { Config_alias_1 as Config } from './_tsup-dts-rollup.js';
+export { BaseError } from './_tsup-dts-rollup.js';
+export { createErrorClass } from './_tsup-dts-rollup.js';
 export { NodeFileSystemProvider } from './_tsup-dts-rollup.js';
 export { DirectoryEntry } from './_tsup-dts-rollup.js';
 export { FileStats } from './_tsup-dts-rollup.js';
@@ -109,6 +119,7 @@ export { UpdateTodoItemOutputSchema } from './_tsup-dts-rollup.js';
 export { UpdateTodoItemOutput } from './_tsup-dts-rollup.js';
 export { ModelInfo_alias_1 as ModelInfo } from './_tsup-dts-rollup.js';
 export { UsageMeter_alias_1 as UsageMeter } from './_tsup-dts-rollup.js';
+export { deepMerge } from './_tsup-dts-rollup.js';
 export { AgentWorkflowInput } from './_tsup-dts-rollup.js';
 export { AgentToolRegistry } from './_tsup-dts-rollup.js';
 export { agentWorkflow } from './_tsup-dts-rollup.js';