@tenex-chat/backend 0.9.4 → 0.9.6

package/src/llm/utils/claudeCodePromptCompiler.ts

@@ -1,141 +0,0 @@
-import type { ModelMessage, TextPart, ImagePart } from "ai";
-
-/**
- * Extract text content from a message content field.
- * Handles both string content and multimodal content (TextPart + ImagePart arrays).
- *
- * For multimodal content, extracts the text part and notes any images.
- */
-function extractTextContent(content: ModelMessage["content"]): string {
-    if (typeof content === "string") {
-        return content;
-    }
-
-    if (!Array.isArray(content)) {
-        return JSON.stringify(content);
-    }
-
-    // Handle multimodal content (arrays of parts)
-    const parts: string[] = [];
-    let imageCount = 0;
-
-    for (const part of content) {
-        if ((part as TextPart).type === "text") {
-            parts.push((part as TextPart).text);
-        } else if ((part as ImagePart).type === "image") {
-            imageCount++;
-        }
-    }
-
-    // If there were images, note them at the end
-    if (imageCount > 0) {
-        parts.push(`[${imageCount} image${imageCount > 1 ? "s" : ""} attached]`);
-    }
-
-    return parts.join("\n");
-}
-
-/**
- * System prompt type for Claude Code.
- * Can be a string for custom system prompt, or use preset with append for
- * Claude Code's built-in instructions plus custom content.
- */
-export type ClaudeCodeSystemPrompt = string | {
-    type: "preset";
-    preset: "claude_code";
-    append?: string;
-};
-
-/**
- * Compiles system messages for Claude Code's systemPrompt.append.
- * Uses the new systemPrompt API (replacing deprecated customSystemPrompt/appendSystemPrompt).
- *
- * IMPORTANT: Only system messages are included in systemPrompt.append.
- * User/assistant messages are passed separately via the messages array to streamText().
- * This separation is critical for session resumption to work correctly - if conversation
- * history is duplicated in both systemPrompt.append AND messages, it creates a session
- * state that can't be reconstructed on resume.
- *
- * Note: Multimodal content (images) is converted to text descriptions since
- * Claude Code uses a text-based prompt compilation approach.
- */
-export function compileMessagesForClaudeCode(messages: ModelMessage[]): {
-    systemPrompt?: ClaudeCodeSystemPrompt;
-} {
-    if (messages.length === 0) {
-        return { systemPrompt: undefined };
-    }
-
-    // Extract only system messages - user/assistant go in messages array
-    const systemMessages = messages.filter((m) => m.role === "system");
-
-    if (systemMessages.length === 0) {
-        return { systemPrompt: undefined };
-    }
-
-    // Combine all system messages into the append content
-    const appendParts: string[] = [];
-
-    for (const msg of systemMessages) {
-        const content =
-            typeof msg.content === "string"
-                ? msg.content
-                : extractTextContent(msg.content);
-        appendParts.push(content);
-    }
-
-    const appendContent = appendParts.join("\n\n");
-
-    // Use Claude Code's built-in preset with our system content appended
-    return {
-        systemPrompt: {
-            type: "preset",
-            preset: "claude_code",
-            append: appendContent,
-        },
-    };
-}
-
-/**
- * Converts system messages to user messages for active Claude Code sessions.
- * When resuming a session, Claude Code doesn't receive new system messages,
- * so we convert them to user messages to ensure they're delivered.
- *
- * Note: Multimodal content is preserved for user messages (they support images),
- * but system messages with multimodal content are converted to text descriptions.
- */
-export function convertSystemMessagesForResume(messages: ModelMessage[]): ModelMessage[] {
-    // For resuming sessions, we need to convert system messages that appear
-    // after the conversation started into user messages
-
-    // Find the first non-system message (start of conversation)
-    const conversationStartIndex = messages.findIndex((m) => m.role !== "system");
-
-    if (conversationStartIndex === -1) {
-        // All messages are system messages, no conversion needed
-        return messages;
-    }
-
-    // Convert messages, preserving order
-    const convertedMessages = messages.map((msg, index) => {
-        // Keep initial system messages as-is (they were part of initial prompt)
-        if (index < conversationStartIndex) {
-            return msg;
-        }
-
-        // Convert subsequent system messages to user messages with clear marker
-        if (msg.role === "system") {
-            // Use extractTextContent to handle multimodal content gracefully
-            const content = extractTextContent(msg.content);
-            return {
-                role: "user" as const,
-                content: `[System Context]: ${content}`,
-            };
-        }
-
-        // Keep user and assistant messages as-is (preserving multimodal content)
-        return msg;
-    });
-
-    return convertedMessages as ModelMessage[];
-}

package/src/nostr/constants.ts

@@ -1,38 +0,0 @@
-/**
- * Nostr event kinds used in the application
- */
-export enum NostrKind {
-    // Standard kinds
-    TEXT_NOTE = 1,
-    REACTION = 7,
-    ARTICLE = 30023,
-}
-
-/**
- * Standard Nostr tag names
- */
-export enum NostrTag {
-    // Standard tags
-    EVENT = "e",
-    PUBKEY = "p",
-    REPLACEABLE = "a",
-
-    // Application-specific tags
-    MODE = "mode",
-    PARTICIPANT = "participant",
-    REASON = "reason",
-    TOOL = "tool",
-}
-
-/**
- * Tag values for specific application modes
- */
-export enum TagValue {
-    REACTION_POSITIVE = "+",
-    DELEGATE = "delegate",
-}
-
-/**
- * Maximum lengths for various fields
- */
-export const MAX_REASON_LENGTH = 200;

package/src/prompts/core/index.ts

@@ -1,3 +0,0 @@
-export { FragmentRegistry, fragmentRegistry } from "./FragmentRegistry";
-export { PromptBuilder } from "./PromptBuilder";
-export type { FragmentConfig, PromptFragment } from "./types";

package/src/prompts/index.ts

@@ -1,21 +0,0 @@
-// Export core functionality
-
-export { FragmentRegistry, fragmentRegistry } from "./core/FragmentRegistry";
-export { PromptBuilder } from "./core/PromptBuilder";
-export type { FragmentConfig, PromptFragment } from "./core/types";
-
-// Import all fragments to ensure they're registered when the module is imported
-// Priority 01 - Identity
-import "./fragments/01-agent-identity";
-
-// Priority 10 - Early context
-import "./fragments/10-referenced-article"; // Conditional
-
-// Priority 15 - Available agents
-import "./fragments/15-available-agents";
-
-// Priority 20 - Mode context
-import "./fragments/20-voice-mode"; // Conditional
-
-// Priority 24 - Lessons
-import "./fragments/24-retrieved-lessons"; // Shared

package/src/services/image/index.ts

@@ -1,12 +0,0 @@
-export {
-    ImageGenerationService,
-    type ImageConfig,
-    type ImageGenerationOptions,
-    type ImageResult,
-    type ImageConfigOptions,
-    type AspectRatio,
-    type ImageSize,
-    OPENROUTER_IMAGE_MODELS,
-    ASPECT_RATIOS,
-    IMAGE_SIZES,
-} from "./ImageGenerationService";

package/src/services/status/index.ts

@@ -1,11 +0,0 @@
-/**
- * Status Publishing Services
- *
- * Handles broadcasting of status events for daemon, projects, and operations
- */
-
-// Project status (single project context)
-export { ProjectStatusService } from "./ProjectStatusService";
-
-// Operations status (LLM operations)
-export { OperationsStatusService } from "./OperationsStatusService";

package/src/telemetry/diagnostics.ts

@@ -1,27 +0,0 @@
-/**
- * Diagnostics Configuration - Feature flag for diagnostic instrumentation
- *
- * Controls whether detailed diagnostic telemetry is collected.
- * Disable in production for performance; enable when investigating issues.
- *
- * Set TENEX_DIAGNOSTICS=true to enable all diagnostic instrumentation.
- */
-
-/**
- * Check if diagnostics are enabled via environment variable.
- * Caches the result at module load time.
- */
-export function isDiagnosticsEnabled(): boolean {
-    return process.env.TENEX_DIAGNOSTICS === "true";
-}
-
-/**
- * Get the diagnostics enabled state (for logging/tracing).
- */
-export function getDiagnosticsState(): { enabled: boolean; source: string } {
-    const enabled = isDiagnosticsEnabled();
-    return {
-        enabled,
-        source: enabled ? "TENEX_DIAGNOSTICS=true" : "default (disabled)",
-    };
-}

package/src/tools/implementations/rag_query.ts

@@ -1,107 +0,0 @@
-import type { ToolExecutionContext } from "@/tools/types";
-import { type RAGQueryResult, RAGService } from "@/services/rag/RAGService";
-import type { AISdkTool } from "@/tools/types";
-import { type ToolResponse, executeToolWithErrorHandling } from "@/tools/utils";
-import { tool } from "ai";
-import { z } from "zod";
-
-const ragQuerySchema = z.object({
-    description: z
-        .string()
-        .trim()
-        .min(1, "Description is required and cannot be empty")
-        .describe(
-            "REQUIRED: A clear, concise description of why you're querying this collection (5-10 words). Helps provide human-readable context for the operation."
-        ),
-    collection: z.string().describe("Name of the collection to query"),
-    query_text: z.string().describe("The text query for semantic search"),
-    top_k: z
-        .number()
-        .int()
-        .min(1)
-        .max(100)
-        .optional()
-        .describe("Number of top results to return (default: 5, range: 1-100)"),
-    include_metadata: z
-        .boolean()
-        .optional()
-        .describe("Whether to include document metadata in results (default: true)"),
-});
-
-/**
- * Formatted result for tool response
- */
-interface FormattedQueryResult {
-    rank: number;
-    score: number;
-    content: string;
-    metadata?: Record<string, unknown>;
-    source?: string;
-    id?: string;
-    timestamp?: string;
-}
-
-/**
- * Format query results for response
- */
-function formatResults(
-    results: RAGQueryResult[],
-    includeMetadata: boolean
-): FormattedQueryResult[] {
-    return results.map((result, index) => ({
-        rank: index + 1,
-        score: result.score,
-        content:
-            result.document.content.length > 500
-                ? `${result.document.content.substring(0, 500)}...`
-                : result.document.content,
-        ...(includeMetadata && {
-            metadata: result.document.metadata,
-            source: result.document.source,
-            id: result.document.id,
-            timestamp: result.document.timestamp
-                ? new Date(result.document.timestamp).toISOString()
-                : undefined,
-        }),
-    }));
-}
-
-/**
- * Core implementation of RAG semantic search
- */
-async function executeQuery(
-    input: z.infer<typeof ragQuerySchema>,
-    _context: ToolExecutionContext
-): Promise<ToolResponse> {
-    const { collection, query_text } = input;
-
-    // Use provided top_k or default to 5
-    // The schema already validates the range (1-100) and integer constraint
-    const topK = input.top_k ?? 5;
-    const includeMetadata = input.include_metadata ?? true;
-
-    const ragService = RAGService.getInstance();
-    const results = await ragService.query(collection, query_text, topK);
-
-    return {
-        success: true,
-        collection: collection,
-        query: query_text,
-        results_count: results.length,
-        results: formatResults(results, includeMetadata),
-    };
-}
-
-/**
- * Query a RAG collection using semantic search
- */
-export function createRAGQueryTool(context: ToolExecutionContext): AISdkTool {
-    return tool({
-        description:
-            "Perform semantic search on a RAG collection. Returns the most relevant documents based on vector similarity to the query.",
-        inputSchema: ragQuerySchema,
-        execute: async (input: unknown) => {
-            return executeToolWithErrorHandling("rag_query", input as z.infer<typeof ragQuerySchema>, context, executeQuery);
-        },
-    }) as AISdkTool;
-} 

package/src/types/index.ts

@@ -1,46 +0,0 @@
-/**
- * Types barrel export
- *
- * Centralized exports for all custom types used throughout the system.
- */
-
-// Event ID types and utilities
-export {
-    // Branded types
-    type FullEventId,
-    type ShortEventId,
-    type ShellTaskId,
-    type AnyEventId,
-    type AnyTaskId,
-
-    // Constants
-    FULL_EVENT_ID_LENGTH,
-    SHORT_EVENT_ID_LENGTH,
-    SHELL_TASK_ID_LENGTH,
-
-    // Type guards
-    isFullEventId,
-    isShortEventId,
-    isShellTaskId,
-    detectIdType,
-
-    // Factory functions
-    createFullEventId,
-    createShortEventId,
-    createShellTaskId,
-    tryCreateFullEventId,
-    tryCreateShortEventId,
-    tryCreateShellTaskId,
-
-    // Conversion functions
-    shortenEventId,
-    toRawString,
-
-    // Assertion functions
-    assertFullEventId,
-    assertShortEventId,
-    assertShellTaskId,
-
-    // Utility functions
-    parseEventId,
-} from "./event-ids";

package/src/utils/agentFetcher.ts

@@ -1,107 +0,0 @@
-import type NDK from "@nostr-dev-kit/ndk";
-import type { NDKEvent } from "@nostr-dev-kit/ndk";
-import { NDKAgentDefinition, type ETagReference } from "@/events/NDKAgentDefinition";
-import { logger } from "./logger";
-
-/**
- * Represents the parsed data from an agent definition event.
- * Contains all fields needed to instantiate or display an agent.
- */
-export interface AgentDefinitionData {
-    /** The Nostr event ID of the agent definition */
-    id: string;
-    /** The slug identifier (d-tag) for versioning */
-    slug: string | undefined;
-    /** Display name of the agent */
-    title: string;
-    /** Short one-liner description */
-    description: string;
-    /** Extended markdown description from content field */
-    markdownDescription: string | undefined;
-    /** The agent's role/personality */
-    role: string;
-    /** Detailed operational instructions */
-    instructions: string;
-    /** Criteria for when to use this agent */
-    useCriteria: string;
-    /** Version number of the agent definition */
-    version: number;
-    /** Unix timestamp when the event was created */
-    created_at: number | undefined;
-    /** Pubkey of the agent definition author */
-    pubkey: string;
-    /** References to bundled file metadata events */
-    fileETags: ETagReference[];
-    /** Reference to the source agent if this is a fork */
-    forkSource: ETagReference | undefined;
-}
-
-/**
- * Fetches an agent event from Nostr
- * @param eventId - The ID of the event containing the agent
- * @param ndk - The NDK instance to use for fetching
- * @returns The agent event or null if not found
- */
-export async function fetchAgent(eventId: string, ndk: NDK): Promise<NDKEvent | null> {
-    try {
-        // Strip "nostr:" prefix if present
-        const cleanEventId = eventId.startsWith("nostr:") ? eventId.substring(6) : eventId;
-
-        const event = await ndk.fetchEvent(cleanEventId, { groupable: false });
-
-        if (!event) {
-            logger.debug(`Agent event not found: ${cleanEventId}`);
-            return null;
-        }
-
-        return event;
-    } catch (error) {
-        logger.error(`Failed to fetch agent event: ${eventId}`, error);
-        return null;
-    }
-}
-
-/**
- * Fetches an agent definition from a Nostr event
- * @param eventId - The ID of the event containing the agent definition
- * @param ndk - The NDK instance to use for fetching
- * @returns The agent definition data or null if not found
- */
-export async function fetchAgentDefinition(
-    eventId: string,
-    ndk: NDK
-): Promise<AgentDefinitionData | null> {
-    try {
-        // Strip "nostr:" prefix if present
-        const cleanEventId = eventId.startsWith("nostr:") ? eventId.substring(6) : eventId;
-
-        const event = await ndk.fetchEvent(cleanEventId, { groupable: false });
-
-        if (!event) {
-            logger.warning(`Agent event not found: ${cleanEventId}`);
-            return null;
-        }
-
-        // Use NDKAgentDefinition for proper parsing
-        const agentDef = NDKAgentDefinition.from(event);
-
-        return {
-            id: event.id,
-            slug: agentDef.slug,
-            title: agentDef.title || "Unnamed Agent",
-            description: agentDef.description || "",
-            markdownDescription: agentDef.markdownDescription,
-            role: agentDef.role || "assistant",
-            instructions: agentDef.instructions || "",
-            useCriteria: agentDef.useCriteria || "",
-            version: agentDef.version,
-            created_at: event.created_at,
-            pubkey: event.pubkey,
-            fileETags: agentDef.getFileETags(),
-            forkSource: agentDef.getForkSource(),
-        };
-    } catch (error) {
-        logger.error(`Failed to fetch agent event: ${eventId}`, error);
-        return null;
-    }
-}

package/src/utils/conversation-utils.ts

@@ -1 +0,0 @@
-// Conversation utility functions

package/src/utils/process.ts

@@ -1,49 +0,0 @@
-import { logger } from "@/utils/logger";
-
-/**
- * Handler function called during graceful shutdown
- */
-export type ShutdownHandler = (signal: string) => Promise<void>;
-
-/**
- * Sets up graceful shutdown handlers for various termination signals
- * @param shutdownHandler - Async function to handle cleanup during shutdown
- * @description Handles SIGTERM, SIGINT, SIGHUP signals and uncaught exceptions/rejections
- */
-export function setupGracefulShutdown(shutdownHandler: ShutdownHandler): void {
-    let isShuttingDown = false;
-
-    const shutdown = async (signal: string): Promise<void> => {
-        if (isShuttingDown) return;
-        isShuttingDown = true;
-
-        logger.info(`Received ${signal}, shutting down gracefully...`);
-
-        try {
-            await shutdownHandler(signal);
-            logger.info("Shutdown complete");
-            process.exit(0);
-        } catch (error) {
-            logger.error("Error during shutdown", { error });
-            process.exit(1);
-        }
-    };
-
-    // Handle various termination signals
-    process.on("SIGTERM", () => shutdown("SIGTERM"));
-    process.on("SIGINT", () => shutdown("SIGINT"));
-    process.on("SIGHUP", () => shutdown("SIGHUP"));
-
-    // Handle uncaught errors
-    process.on("uncaughtException", (error) => {
-        logger.error("Uncaught exception", { error });
-        shutdown("uncaughtException");
-    });
-
-    process.on("unhandledRejection", (reason, promise) => {
-        logger.error("Unhandled rejection", { reason, promise });
-        // Don't shutdown for unhandled rejections - they're usually not critical
-        // e.g., relay rejections like "replaced: have newer event"
-        // Let the daemon's handler deal with these instead
-    });
-}