@csmedeiros/codemax 1.0.3 → 1.0.7

package/dist/conversation/prompts/systemPrompt.js

@@ -1,149 +0,0 @@
-/**
- * System prompts for the LangChain agent.
- *
- * Customize these prompts to change your agent's behavior and personality.
- */
-import { HumanMessage } from '@langchain/core/messages';
-/**
- * Marks ephemeral per-turn system messages that carry the host date/time; stripped before persisting thread history.
- */
-export const CODEMAX_TURN_DATETIME_MARKER = '<!--codemax-datetime-context-->';
-function stringifyMessageContent(content) {
-    if (typeof content === 'string')
-        return content;
-    if (Array.isArray(content)) {
-        return content
-            .map(block => {
-            if (typeof block === 'string')
-                return block;
-            if (block && typeof block === 'object' && 'text' in block) {
-                return String(block.text);
-            }
-            return '';
-        })
-            .join('\n');
-    }
-    return '';
-}
-/**
- * Current local date/time using the host OS time zone and locale (via Intl).
- */
-export function formatLocalDateTimeContext() {
-    const resolved = Intl.DateTimeFormat().resolvedOptions();
-    const timeZone = resolved.timeZone ?? 'UTC';
-    const locale = resolved.locale;
-    const now = new Date();
-    const localLine = new Intl.DateTimeFormat(locale, {
-        dateStyle: 'full',
-        timeStyle: 'long',
-        timeZone,
-    }).format(now);
-    return [
-        `Host time zone (IANA): ${timeZone}`,
-        `Current local date and time: ${localLine}`,
-        `Instant (UTC, ISO 8601): ${now.toISOString()}`,
-    ].join('\n');
-}
-/**
- * Content for a single-turn HumanMessage injected before each agent invocation.
- * Using a user message (not system) keeps the system prompt stable for prompt caching.
- */
-export function buildCodemaxTurnDatetimeUserContent() {
-    return `${CODEMAX_TURN_DATETIME_MARKER}\n# Current date and time (host system)\n${formatLocalDateTimeContext()}`;
-}
-/**
- * Removes the ephemeral datetime user message from graph output so REPL history does not accumulate it.
- */
-export function stripCodemaxTurnDatetimeFromMessages(messages) {
-    const idx = messages.findIndex(m => {
-        if (!(m instanceof HumanMessage))
-            return false;
-        return stringifyMessageContent(m.content).startsWith(CODEMAX_TURN_DATETIME_MARKER);
-    });
-    if (idx === -1)
-        return messages;
-    return [...messages.slice(0, idx), ...messages.slice(idx + 1)];
-}
-/**
- * The main system prompt that defines the agent's behavior.
- * This is passed to createAgent as the systemPrompt parameter.
- */
-export const COMPACT_SUMMARY_PROMPT = `You are compacting a long agentic coding session. Produce a detailed summary preserving:
-- The user's overarching goals and the current task being worked on.
-- All file paths read, written, or modified and their purposes.
-- Key decisions and their rationale.
-- Current todo state and in-progress work.
-- Important tool results (errors, search hits, file contents that informed decisions).
-- Open questions and unresolved blockers.
-
-Be specific — preserve exact filenames, function names, identifiers, command outputs, and error messages. Format as structured Markdown with clear sections. Do not omit details that would be needed to continue the work seamlessly.`;
-export const SYSTEM_PROMPT = `
-<role>
-
-You are CodeMax, the next-generation code agent.
-You are responsible for solving software development tasks by generating code, explanations, and reasoning steps.
-
-</role>
-
-<general_instructions>
-
-- When the conversation includes a system message with the host's current local date and time (and time zone), use it for anything that depends on "now", "today", or scheduling.
-- You will receive a task and you will need to solve it.
-- The first step is to understand the task and the context by reading the codebase documentation and codebase, and write a TO-DO list of the steps you need to take to solve the task using the 'todoTool'.
-- As you progress through the task, you must update the status of the items in the TO-DO list using the 'todoTool'.
-
-</general_instructions>
-
-<rules>
-
-When rules are injected into this conversation, you MUST follow them strictly and without exception.
-Rules override your default behavior. They are not suggestions — treat them as hard constraints.
-If a rule conflicts with a general instruction, the rule wins.
-
-</rules>
-
-<file_reading>
-
-- NEVER read an entire file unless you are certain you need every line.
-- Always use 'startLine' and 'endLine' to read only the portion you need.
-- If you do not know how many lines a file has or where the relevant section is, start by reading lines 1–20 to orient yourself, then read further ranges as needed.
-- Prefer multiple small reads over one large read.
-
-</file_reading>
-
-<todo_tool>
-  - Use the 'todoTool' to manage your task list.
-  - Actions: 'add', 'update', 'remove', 'list'.
-  - Statuses: 'pending', 'in_progress', 'completed'.
-  - When starting a task, 'add' all the steps you identified.
-  - When you start working on a step, 'update' its status to 'in_progress'.
-  - When you finish a step, 'update' its status to 'completed'.
-</todo_tool>
-
-<subagents>
-
-  - You are able to use subagents to help you solve tasks.
-  - You can delegate tasks for subagents to solve.
-  - For delegation, you must use the 'subagent' tool.
-  - The subagent tool will return a report of the task completion.
-  - The report will be a JSON file with the following properties:
-    - 'status': 'success' or 'error'
-    - 'message': a short description of the result
-    - 'data': the data returned by the subagent
-    - 'files': a list of dictionaries with the following properties:
-      - 'path': the path of the file
-      - 'content': a short description of what he did in the file
-</subagents>
-
-
-
-<response_format>
-
-- You must NEVER answer with emojis.
-- You must ALWAYS answer with markdown headings and markdown bullet points.
-- You must ALWAYS answer with a clear and concise response.
-- Your answers must be ALWAYS about what the user wants to know about or what you have done in your work.
-- NEVER answer with unnecessary facts or anything that doesn't relate to the user's request, your answer, or what the user wants to know.
-
-</response_format>
-`;

package/dist/entry/cli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/entry/cli.js

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-import React from 'react';
-import { render } from 'ink';
-import meow from 'meow';
-import App from '../terminal/app.js';
-import { shutdownLangfuseTracing } from '../observability/langfuseTracing.js';
-for (const sig of ['SIGINT', 'SIGTERM', 'exit']) {
-    process.on(sig, () => {
-        void shutdownLangfuseTracing();
-    });
-}
-const cli = meow(`
-	Usage
-	  $ codemax
-
-	Examples
-	  $ codemax
-`, {
-    importMeta: import.meta,
-    flags: {},
-});
-// `cli` is parsed to keep a place for future flags while we iterate.
-void cli;
-render(React.createElement(App, null));

package/dist/observability/langfuseTracing.d.ts

@@ -1,5 +0,0 @@
-import type { BaseCallbackHandler } from '@langchain/core/callbacks/base';
-export declare function initLangfuseTracing(): boolean;
-export declare function shutdownLangfuseTracing(): Promise<void>;
-export declare function getLangfuseCallbacksForTurn(sessionId: string): BaseCallbackHandler[];
-export declare function createCodemaxSessionId(prefix: string): string;

package/dist/observability/langfuseTracing.js

@@ -1,76 +0,0 @@
-import { NodeSDK } from '@opentelemetry/sdk-node';
-import { LangfuseSpanProcessor } from '@langfuse/otel';
-import { CallbackHandler } from '@langfuse/langchain';
-import { randomUUID } from 'node:crypto';
-let tracingEnabled = false;
-let otelSdk;
-function langfuseEnvConfigured() {
-    const sk = process.env['LANGFUSE_SECRET_KEY']?.trim();
-    const pk = process.env['LANGFUSE_PUBLIC_KEY']?.trim();
-    return Boolean(sk && pk);
-}
-// Guards all serialized-argument callbacks against undefined — some non-OpenAI
-// models omit the first argument, causing `.id.at(-1)` / `.name` to throw.
-class SafeCallbackHandler extends CallbackHandler {
-    async handleToolStart(tool, input, runId, parentRunId, tags, metadata, runName) {
-        if (!tool)
-            return;
-        return super.handleToolStart(tool, input, runId, parentRunId, tags, metadata, runName);
-    }
-    async handleChainStart(chain, inputs, runId, parentRunId, tags, metadata, runType, runName) {
-        if (!chain)
-            return;
-        return super.handleChainStart(chain, inputs, runId, parentRunId, tags, metadata, runType, runName);
-    }
-    async handleLLMStart(llm, prompts, runId, parentRunId, extraParams, tags, metadata, runName) {
-        if (!llm)
-            return;
-        return super.handleLLMStart(llm, prompts, runId, parentRunId, extraParams, tags, metadata, runName);
-    }
-    async handleChatModelStart(llm, messages, runId, parentRunId, extraParams, tags, metadata, runName) {
-        if (!llm)
-            return;
-        return super.handleChatModelStart(llm, messages, runId, parentRunId, extraParams, tags, metadata, runName);
-    }
-    // handleGenerationStart is an internal method called by handleChatModelStart /
-    // handleLLMStart — guard it directly so async re-entrant calls can't crash either.
-    async handleGenerationStart(llm, messages, runId, parentRunId, extraParams, tags, metadata, runName) {
-        if (!llm)
-            return;
-        // handleGenerationStart is not declared on the base type — call via prototype
-        const proto = Object.getPrototypeOf(Object.getPrototypeOf(this));
-        return proto.handleGenerationStart.call(this, llm, messages, runId, parentRunId, extraParams, tags, metadata, runName);
-    }
-}
-export function initLangfuseTracing() {
-    if (!langfuseEnvConfigured())
-        return false;
-    otelSdk = new NodeSDK({
-        spanProcessors: [new LangfuseSpanProcessor()],
-    });
-    otelSdk.start();
-    tracingEnabled = true;
-    return true;
-}
-export async function shutdownLangfuseTracing() {
-    if (otelSdk) {
-        await otelSdk.shutdown();
-    }
-}
-export function getLangfuseCallbacksForTurn(sessionId) {
-    if (!tracingEnabled)
-        return [];
-    const userId = process.env['CODEMAX_USER_ID']?.trim() ||
-        process.env['LANGFUSE_USER_ID']?.trim();
-    return [
-        new SafeCallbackHandler({
-            sessionId,
-            ...(userId ? { userId } : {}),
-            tags: ['codemax', 'cli'],
-            traceMetadata: { app: 'codemax' },
-        }),
-    ];
-}
-export function createCodemaxSessionId(prefix) {
-    return `${prefix}-${randomUUID()}`;
-}

package/dist/shared/types.d.ts

@@ -1,25 +0,0 @@
-export type TranscriptItem = {
-    id: string;
-    role: 'user';
-    text: string;
-} | {
-    id: string;
-    role: 'assistant';
-    text: string;
-    timestamp: string;
-} | {
-    id: string;
-    role: 'system';
-    text: string;
-} | {
-    id: string;
-    role: 'tool';
-    text: string;
-    kind: 'start' | 'end' | 'error' | 'approval';
-    toolName: string;
-    toolCall?: any;
-} | {
-    id: string;
-    role: 'meta';
-    text: string;
-};

package/dist/shared/types.js

@@ -1 +0,0 @@
-export {};

package/dist/terminal/app.d.ts

@@ -1,2 +0,0 @@
-import React from 'react';
-export default function App(): React.JSX.Element;