byterover-cli 0.4.0 → 1.0.0

package/dist/infra/cipher/storage/tool-part-factory.js

@@ -0,0 +1,197 @@
+/**
+ * Factory for creating and managing tool parts with state machine.
+ *
+ * This module provides utilities for:
+ * - Creating tool parts in pending state
+ * - Transitioning tool parts through their lifecycle (pending → running → completed/error)
+ * - Marking tool parts as compacted for pruning
+ *
+ * Based on OpenCode's tool state machine pattern.
+ */
+import { randomUUID } from 'node:crypto';
+/**
+ * Factory for creating and managing tool parts with state machine.
+ *
+ * Tool parts track the full lifecycle of a tool call:
+ * 1. Pending: Tool call received from LLM, not yet started
+ * 2. Running: Execution has started
+ * 3. Completed: Execution finished successfully with output
+ * 4. Error: Execution failed with error message
+ *
+ * This enables:
+ * - Real-time UI feedback during tool execution
+ * - Better conversation history representation
+ * - Efficient compaction (mark individual outputs as compacted)
+ */
+export const ToolPartFactory = {
+    /**
+     * Create a new tool part in pending state.
+     *
+     * @param messageId - ID of the message this part belongs to
+     * @param callId - Unique identifier for this tool call
+     * @param toolName - Name of the tool being called
+     * @param input - Parsed input arguments
+     * @returns StoredPart with pending tool state
+     */
+    createPending(messageId, callId, toolName, input) {
+        const now = Date.now();
+        return {
+            content: '', // Tool parts store state in toolState, not content
+            createdAt: now,
+            id: randomUUID(),
+            messageId,
+            toolName,
+            toolState: {
+                callId,
+                input,
+                status: 'pending',
+            },
+            type: 'tool',
+        };
+    },
+    /**
+     * Mark a tool part as compacted.
+     * Clears the output while preserving the state structure.
+     *
+     * @param part - The tool part to mark as compacted
+     * @returns Updated StoredPart with compactedAt timestamp
+     */
+    markCompacted(part) {
+        if (part.type !== 'tool' || !part.toolState) {
+            throw new Error('Cannot mark non-tool part as compacted');
+        }
+        const now = Date.now();
+        return {
+            ...part,
+            compactedAt: now,
+            toolState: {
+                ...part.toolState,
+                // Clear output but keep other state for reference
+                output: part.toolState.output ? '[Compacted]' : undefined,
+            },
+        };
+    },
+    /**
+     * Convert a StoredPart's tool state to the format used in message-types.ts.
+     * Useful for reconstructing InternalMessage from stored parts.
+     *
+     * @param toolState - The stored tool state
+     * @returns Tool state in the format expected by ToolPart
+     */
+    toToolPartState(toolState) {
+        const input = toolState.input ?? {};
+        switch (toolState.status) {
+            case 'completed': {
+                return {
+                    attachments: toolState.attachments?.map((att) => ({
+                        data: att.data,
+                        filename: att.filename,
+                        mime: att.mime,
+                        type: att.type,
+                    })),
+                    input,
+                    output: toolState.output ?? '',
+                    status: 'completed',
+                    time: {
+                        end: toolState.completedAt ?? Date.now(),
+                        start: toolState.startedAt ?? Date.now(),
+                    },
+                    title: toolState.title,
+                };
+            }
+            case 'error': {
+                return {
+                    error: toolState.error ?? 'Unknown error',
+                    input,
+                    status: 'error',
+                    time: {
+                        end: toolState.completedAt ?? Date.now(),
+                        start: toolState.startedAt ?? Date.now(),
+                    },
+                };
+            }
+            case 'pending': {
+                return { input, status: 'pending' };
+            }
+            case 'running': {
+                return {
+                    input,
+                    startedAt: toolState.startedAt ?? Date.now(),
+                    status: 'running',
+                };
+            }
+        }
+    },
+    /**
+     * Transition a tool part to completed state.
+     *
+     * @param part - The tool part to update
+     * @param output - Tool output content
+     * @param options - Additional options (title, metadata, attachments)
+     * @returns Updated StoredPart with completed state
+     */
+    transitionToCompleted(part, output, options) {
+        if (part.type !== 'tool' || !part.toolState) {
+            throw new Error('Cannot transition non-tool part to completed');
+        }
+        const now = Date.now();
+        return {
+            ...part,
+            toolState: {
+                ...part.toolState,
+                attachments: options?.attachments?.map((att) => ({
+                    data: att.data,
+                    filename: att.filename,
+                    mime: att.mime,
+                    type: att.type,
+                })),
+                completedAt: now,
+                output,
+                status: 'completed',
+                title: options?.title,
+            },
+        };
+    },
+    /**
+     * Transition a tool part to error state.
+     *
+     * @param part - The tool part to update
+     * @param error - Error message
+     * @returns Updated StoredPart with error state
+     */
+    transitionToError(part, error) {
+        if (part.type !== 'tool' || !part.toolState) {
+            throw new Error('Cannot transition non-tool part to error');
+        }
+        const now = Date.now();
+        return {
+            ...part,
+            toolState: {
+                ...part.toolState,
+                completedAt: now,
+                error,
+                status: 'error',
+            },
+        };
+    },
+    /**
+     * Transition a tool part to running state.
+     *
+     * @param part - The tool part to update
+     * @returns Updated StoredPart with running state
+     */
+    transitionToRunning(part) {
+        if (part.type !== 'tool' || !part.toolState) {
+            throw new Error('Cannot transition non-tool part to running');
+        }
+        const now = Date.now();
+        return {
+            ...part,
+            toolState: {
+                ...part.toolState,
+                startedAt: now,
+                status: 'running',
+            },
+        };
+    },
+};

package/dist/infra/cipher/system-prompt/contributor-schemas.d.ts

@@ -0,0 +1,516 @@
+import { z } from 'zod';
+/**
+ * Schema for static contributors.
+ * Returns inline content directly.
+ */
+export declare const StaticContributorConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    content: z.ZodString;
+    type: z.ZodLiteral<"static">;
+}, "strict", z.ZodTypeAny, {
+    type: "static";
+    content: string;
+    id: string;
+    enabled: boolean;
+    priority: number;
+}, {
+    type: "static";
+    content: string;
+    id: string;
+    priority: number;
+    enabled?: boolean | undefined;
+}>;
+/**
+ * Schema for file contributors.
+ * Loads content from YAML files.
+ */
+export declare const FileContributorConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    filepath: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        cache: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        validateMtime: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strict", z.ZodTypeAny, {
+        cache: boolean;
+        validateMtime: boolean;
+    }, {
+        cache?: boolean | undefined;
+        validateMtime?: boolean | undefined;
+    }>>;
+    type: z.ZodLiteral<"file">;
+}, "strict", z.ZodTypeAny, {
+    type: "file";
+    id: string;
+    filepath: string;
+    enabled: boolean;
+    priority: number;
+    options?: {
+        cache: boolean;
+        validateMtime: boolean;
+    } | undefined;
+}, {
+    type: "file";
+    id: string;
+    filepath: string;
+    priority: number;
+    options?: {
+        cache?: boolean | undefined;
+        validateMtime?: boolean | undefined;
+    } | undefined;
+    enabled?: boolean | undefined;
+}>;
+/**
+ * Schema for memory contributor options.
+ */
+export declare const MemoryContributorOptionsSchema: z.ZodObject<{
+    includeTags: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pinnedOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strict", z.ZodTypeAny, {
+    limit: number;
+    includeTags: boolean;
+    pinnedOnly: boolean;
+}, {
+    limit?: number | undefined;
+    includeTags?: boolean | undefined;
+    pinnedOnly?: boolean | undefined;
+}>;
+/**
+ * Schema for memory contributors.
+ * Loads memories from the memory manager.
+ */
+export declare const MemoryContributorConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    options: z.ZodOptional<z.ZodObject<{
+        includeTags: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        pinnedOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strict", z.ZodTypeAny, {
+        limit: number;
+        includeTags: boolean;
+        pinnedOnly: boolean;
+    }, {
+        limit?: number | undefined;
+        includeTags?: boolean | undefined;
+        pinnedOnly?: boolean | undefined;
+    }>>;
+    type: z.ZodLiteral<"memory">;
+}, "strict", z.ZodTypeAny, {
+    type: "memory";
+    id: string;
+    enabled: boolean;
+    priority: number;
+    options?: {
+        limit: number;
+        includeTags: boolean;
+        pinnedOnly: boolean;
+    } | undefined;
+}, {
+    type: "memory";
+    id: string;
+    priority: number;
+    options?: {
+        limit?: number | undefined;
+        includeTags?: boolean | undefined;
+        pinnedOnly?: boolean | undefined;
+    } | undefined;
+    enabled?: boolean | undefined;
+}>;
+/**
+ * Schema for environment contributors.
+ * Provides environment context (working directory, git status, etc.).
+ */
+export declare const EnvironmentContributorConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"environment">;
+}, "strict", z.ZodTypeAny, {
+    type: "environment";
+    id: string;
+    enabled: boolean;
+    priority: number;
+}, {
+    type: "environment";
+    id: string;
+    priority: number;
+    enabled?: boolean | undefined;
+}>;
+/**
+ * Schema for datetime contributors.
+ * Provides current date and time.
+ */
+export declare const DateTimeContributorConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"dateTime">;
+}, "strict", z.ZodTypeAny, {
+    type: "dateTime";
+    id: string;
+    enabled: boolean;
+    priority: number;
+}, {
+    type: "dateTime";
+    id: string;
+    priority: number;
+    enabled?: boolean | undefined;
+}>;
+/**
+ * Discriminated union schema for all contributor configurations.
+ */
+export declare const ContributorConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    content: z.ZodString;
+    type: z.ZodLiteral<"static">;
+}, "strict", z.ZodTypeAny, {
+    type: "static";
+    content: string;
+    id: string;
+    enabled: boolean;
+    priority: number;
+}, {
+    type: "static";
+    content: string;
+    id: string;
+    priority: number;
+    enabled?: boolean | undefined;
+}>, z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    filepath: z.ZodString;
+    options: z.ZodOptional<z.ZodObject<{
+        cache: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        validateMtime: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strict", z.ZodTypeAny, {
+        cache: boolean;
+        validateMtime: boolean;
+    }, {
+        cache?: boolean | undefined;
+        validateMtime?: boolean | undefined;
+    }>>;
+    type: z.ZodLiteral<"file">;
+}, "strict", z.ZodTypeAny, {
+    type: "file";
+    id: string;
+    filepath: string;
+    enabled: boolean;
+    priority: number;
+    options?: {
+        cache: boolean;
+        validateMtime: boolean;
+    } | undefined;
+}, {
+    type: "file";
+    id: string;
+    filepath: string;
+    priority: number;
+    options?: {
+        cache?: boolean | undefined;
+        validateMtime?: boolean | undefined;
+    } | undefined;
+    enabled?: boolean | undefined;
+}>, z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    options: z.ZodOptional<z.ZodObject<{
+        includeTags: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        pinnedOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strict", z.ZodTypeAny, {
+        limit: number;
+        includeTags: boolean;
+        pinnedOnly: boolean;
+    }, {
+        limit?: number | undefined;
+        includeTags?: boolean | undefined;
+        pinnedOnly?: boolean | undefined;
+    }>>;
+    type: z.ZodLiteral<"memory">;
+}, "strict", z.ZodTypeAny, {
+    type: "memory";
+    id: string;
+    enabled: boolean;
+    priority: number;
+    options?: {
+        limit: number;
+        includeTags: boolean;
+        pinnedOnly: boolean;
+    } | undefined;
+}, {
+    type: "memory";
+    id: string;
+    priority: number;
+    options?: {
+        limit?: number | undefined;
+        includeTags?: boolean | undefined;
+        pinnedOnly?: boolean | undefined;
+    } | undefined;
+    enabled?: boolean | undefined;
+}>, z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"environment">;
+}, "strict", z.ZodTypeAny, {
+    type: "environment";
+    id: string;
+    enabled: boolean;
+    priority: number;
+}, {
+    type: "environment";
+    id: string;
+    priority: number;
+    enabled?: boolean | undefined;
+}>, z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    id: z.ZodString;
+    priority: z.ZodNumber;
+} & {
+    type: z.ZodLiteral<"dateTime">;
+}, "strict", z.ZodTypeAny, {
+    type: "dateTime";
+    id: string;
+    enabled: boolean;
+    priority: number;
+}, {
+    type: "dateTime";
+    id: string;
+    priority: number;
+    enabled?: boolean | undefined;
+}>]>;
+/**
+ * Schema for the system prompt manager configuration.
+ */
+export declare const SystemPromptManagerConfigSchema: z.ZodObject<{
+    contributors: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        id: z.ZodString;
+        priority: z.ZodNumber;
+    } & {
+        content: z.ZodString;
+        type: z.ZodLiteral<"static">;
+    }, "strict", z.ZodTypeAny, {
+        type: "static";
+        content: string;
+        id: string;
+        enabled: boolean;
+        priority: number;
+    }, {
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        id: z.ZodString;
+        priority: z.ZodNumber;
+    } & {
+        filepath: z.ZodString;
+        options: z.ZodOptional<z.ZodObject<{
+            cache: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            validateMtime: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strict", z.ZodTypeAny, {
+            cache: boolean;
+            validateMtime: boolean;
+        }, {
+            cache?: boolean | undefined;
+            validateMtime?: boolean | undefined;
+        }>>;
+        type: z.ZodLiteral<"file">;
+    }, "strict", z.ZodTypeAny, {
+        type: "file";
+        id: string;
+        filepath: string;
+        enabled: boolean;
+        priority: number;
+        options?: {
+            cache: boolean;
+            validateMtime: boolean;
+        } | undefined;
+    }, {
+        type: "file";
+        id: string;
+        filepath: string;
+        priority: number;
+        options?: {
+            cache?: boolean | undefined;
+            validateMtime?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        id: z.ZodString;
+        priority: z.ZodNumber;
+    } & {
+        options: z.ZodOptional<z.ZodObject<{
+            includeTags: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            pinnedOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strict", z.ZodTypeAny, {
+            limit: number;
+            includeTags: boolean;
+            pinnedOnly: boolean;
+        }, {
+            limit?: number | undefined;
+            includeTags?: boolean | undefined;
+            pinnedOnly?: boolean | undefined;
+        }>>;
+        type: z.ZodLiteral<"memory">;
+    }, "strict", z.ZodTypeAny, {
+        type: "memory";
+        id: string;
+        enabled: boolean;
+        priority: number;
+        options?: {
+            limit: number;
+            includeTags: boolean;
+            pinnedOnly: boolean;
+        } | undefined;
+    }, {
+        type: "memory";
+        id: string;
+        priority: number;
+        options?: {
+            limit?: number | undefined;
+            includeTags?: boolean | undefined;
+            pinnedOnly?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        id: z.ZodString;
+        priority: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"environment">;
+    }, "strict", z.ZodTypeAny, {
+        type: "environment";
+        id: string;
+        enabled: boolean;
+        priority: number;
+    }, {
+        type: "environment";
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    }>, z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        id: z.ZodString;
+        priority: z.ZodNumber;
+    } & {
+        type: z.ZodLiteral<"dateTime">;
+    }, "strict", z.ZodTypeAny, {
+        type: "dateTime";
+        id: string;
+        enabled: boolean;
+        priority: number;
+    }, {
+        type: "dateTime";
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    }>]>, "many">;
+}, "strict", z.ZodTypeAny, {
+    contributors: ({
+        type: "static";
+        content: string;
+        id: string;
+        enabled: boolean;
+        priority: number;
+    } | {
+        type: "file";
+        id: string;
+        filepath: string;
+        enabled: boolean;
+        priority: number;
+        options?: {
+            cache: boolean;
+            validateMtime: boolean;
+        } | undefined;
+    } | {
+        type: "memory";
+        id: string;
+        enabled: boolean;
+        priority: number;
+        options?: {
+            limit: number;
+            includeTags: boolean;
+            pinnedOnly: boolean;
+        } | undefined;
+    } | {
+        type: "environment";
+        id: string;
+        enabled: boolean;
+        priority: number;
+    } | {
+        type: "dateTime";
+        id: string;
+        enabled: boolean;
+        priority: number;
+    })[];
+}, {
+    contributors: ({
+        type: "static";
+        content: string;
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    } | {
+        type: "file";
+        id: string;
+        filepath: string;
+        priority: number;
+        options?: {
+            cache?: boolean | undefined;
+            validateMtime?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    } | {
+        type: "memory";
+        id: string;
+        priority: number;
+        options?: {
+            limit?: number | undefined;
+            includeTags?: boolean | undefined;
+            pinnedOnly?: boolean | undefined;
+        } | undefined;
+        enabled?: boolean | undefined;
+    } | {
+        type: "environment";
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    } | {
+        type: "dateTime";
+        id: string;
+        priority: number;
+        enabled?: boolean | undefined;
+    })[];
+}>;
+export type ValidatedStaticContributorConfig = z.infer<typeof StaticContributorConfigSchema>;
+export type ValidatedFileContributorConfig = z.infer<typeof FileContributorConfigSchema>;
+export type ValidatedMemoryContributorConfig = z.infer<typeof MemoryContributorConfigSchema>;
+export type ValidatedEnvironmentContributorConfig = z.infer<typeof EnvironmentContributorConfigSchema>;
+export type ValidatedDateTimeContributorConfig = z.infer<typeof DateTimeContributorConfigSchema>;
+export type ValidatedContributorConfig = z.infer<typeof ContributorConfigSchema>;
+export type ValidatedSystemPromptManagerConfig = z.infer<typeof SystemPromptManagerConfigSchema>;