agent-devkit 0.3.3 → 0.3.4

package/README.md

@@ -3,7 +3,7 @@
 Agent DevKit is a TypeScript/Node rewrite of the `agent-devkit` package.
 
 The public npm package is `agent-devkit`; the canonical command is `agent`.
-Version `0.3.3` starts a new implementation focused on a maintainable CLI/TUI
+Version `0.3.4` starts a new implementation focused on a maintainable CLI/TUI
 runtime while preserving the product direction from the legacy `0.3.x` line.
 
 ## Status
@@ -145,7 +145,7 @@ Rules:
 ## Distribution
 
 The package is npm-first and publishes the `agent` binary from `dist/main.js`.
-Standalone binaries are outside the initial `0.3.3` scope.
+Standalone binaries are outside the initial `0.3.4` scope.
 
 Installing the npm package must not create runtime folders or project files.
 State is created only when the user runs the tool:
@@ -187,8 +187,8 @@ agent reset --dry-run
 agent reset --yes
 agent reset -g --dry-run
 agent update --latest --dry-run
-agent update 0.3.3 --dry-run
-agent update 0.3.3 --yes
+agent update 0.3.4 --dry-run
+agent update 0.3.4 --yes
 agent preferences
 agent preferences --json
 agent preferences themes

package/dist/main.js

@@ -8,7 +8,7 @@ import React from "react";
 // package.json
 var package_default = {
   name: "agent-devkit",
-  version: "0.3.3",
+  version: "0.3.4",
   description: "Agent DevKit CLI and TUI runtime for specialist AI agents, capabilities and provider-aware workflows.",
   license: "MIT",
   type: "module",
@@ -3648,6 +3648,43 @@ var ModelStore = class {
 
 // src/infra/brain/local_llama_provider.ts
 var nodeLlamaModuleName = "node-llama-cpp";
+function shouldSuppressNodeLlamaLog(line) {
+  return line.startsWith("[node-llama-cpp]");
+}
+var defaultLocalGenerationOptions = {
+  maxTokens: 512,
+  temperature: 0.25,
+  topK: 40,
+  topP: 0.9
+};
+async function suppressNodeLlamaLogs(operation) {
+  const originalWrite = process.stderr.write;
+  let pending = "";
+  const filteredWrite = ((chunk, encodingOrCallback, callback) => {
+    const encoding = typeof encodingOrCallback === "string" ? encodingOrCallback : "utf8";
+    const done = typeof encodingOrCallback === "function" ? encodingOrCallback : callback;
+    const text2 = typeof chunk === "string" ? chunk : Buffer.isBuffer(chunk) ? chunk.toString(encoding) : String(chunk);
+    const lines = `${pending}${text2}`.split(/\r?\n/);
+    pending = lines.pop() ?? "";
+    for (const line of lines) {
+      if (!shouldSuppressNodeLlamaLog(line)) {
+        originalWrite.call(process.stderr, `${line}
+`);
+      }
+    }
+    done?.();
+    return true;
+  });
+  process.stderr.write = filteredWrite;
+  try {
+    return await operation();
+  } finally {
+    if (pending.length > 0 && !shouldSuppressNodeLlamaLog(pending)) {
+      originalWrite.call(process.stderr, pending);
+    }
+    process.stderr.write = originalWrite;
+  }
+}
 async function loadNodeLlama() {
   try {
     return Result.ok(await import(nodeLlamaModuleName));
@@ -3658,8 +3695,11 @@ async function loadNodeLlama() {
 function systemPromptFrom(prompt) {
   const { agent } = prompt;
   const lines = [
-    `You are ${agent.name}.`,
-    `Behavior: ${agent.behavior}. Tone: ${agent.tone}. Detail level: ${agent.detailLevel}.`
+    `You are ${agent.name}, the user's configured Agent DevKit personality.`,
+    "You operate inside Agent DevKit, a local AI agent toolkit exposed through the `agent` CLI, TUI and MCP.",
+    "Answer as the agent. Do not answer as the user, as a generic person, or as a generic chatbot.",
+    `Behavior: ${agent.behavior}. Tone: ${agent.tone}. Detail level: ${agent.detailLevel}.`,
+    "If the user asks personal questions about you, your personality or what you can do, answer from your configured persona and conversation abilities. Do not list generic human activities. Do not describe Agent DevKit internals unless the user explicitly asks about Agent DevKit, tools, commands, MCP, modules or project capabilities."
   ];
   if (agent.traits.length > 0) {
     lines.push(`Traits: ${agent.traits.join(", ")}.`);
@@ -3670,6 +3710,38 @@ function systemPromptFrom(prompt) {
       `Project: ${project.name}${project.description === void 0 ? "" : ` \u2014 ${project.description}`}.`
     );
   }
+  const { session } = prompt.context;
+  if (session !== void 0) {
+    lines.push(
+      `Session: ${session.id}. Title: ${session.title}. Messages: ${session.messageCount}.`
+    );
+  }
+  if (prompt.context.knowledge.length > 0) {
+    lines.push(
+      "",
+      "Agent DevKit knowledge:",
+      ...prompt.context.knowledge.map((knowledge) => `- ${knowledge.content}`)
+    );
+  }
+  if (prompt.tools.length > 0) {
+    lines.push(
+      "",
+      "Available tools:",
+      ...prompt.tools.map((tool) => `- ${tool.id} (${tool.risk}): ${tool.description}`)
+    );
+  }
+  lines.push(
+    "",
+    "Tool policy:",
+    `- Tool calls allowed: ${prompt.policies.allowToolCalls ? "yes" : "no"}.`,
+    `- Approval required: ${prompt.policies.approvalRequired ? "yes" : "no"}.`,
+    `- Max tool calls: ${prompt.policies.maxToolCalls}.`
+  );
+  if (!prompt.policies.allowToolCalls) {
+    lines.push(
+      "- In this mode, do not claim that you already executed actions. If the user asks for a concrete action, explain that direct tool execution is unavailable in this chat turn."
+    );
+  }
   lines.push(`Reply in ${prompt.output.language}.`);
   const history = prompt.messages.filter((message) => message.role === "user" || message.role === "assistant").slice(0, -1).map((message) => `${message.role === "user" ? "User" : agent.name}: ${message.content}`);
   if (history.length > 0) {
@@ -3727,30 +3799,32 @@ var LocalLlamaBrainProvider = class {
       return Result.fail(nodeLlama.unwrapError());
     }
     try {
-      const llama = nodeLlama.unwrap();
-      const loadedModel = await this.#loadModel(llama, model.unwrap().path);
-      const context = await loadedModel.createContext();
-      const session = new llama.LlamaChatSession({
-        contextSequence: context.getSequence(),
-        systemPrompt: systemPromptFrom(request.prompt)
-      });
-      const text2 = await session.prompt(request.prompt.task.userMessage, {
-        grammar: await this.#grammarFor(options.jsonSchema),
-        maxTokens: request.options.maxOutputTokens,
-        onTextChunk: options.onToken,
-        seed: request.options.seed,
-        temperature: request.options.temperature,
-        topK: request.options.topK,
-        topP: request.options.topP
-      });
-      const outputTokens = text2.split(/\s+/g).filter(Boolean).length;
-      return Result.ok({
-        finishReason: "stop",
-        model: model.unwrap().id,
-        provider: "local",
-        schema: "agent-devkit.brain-response/v1",
-        text: text2,
-        usage: { outputTokens }
+      return await suppressNodeLlamaLogs(async () => {
+        const llama = nodeLlama.unwrap();
+        const loadedModel = await this.#loadModel(llama, model.unwrap().path);
+        const context = await loadedModel.createContext();
+        const session = new llama.LlamaChatSession({
+          contextSequence: context.getSequence(),
+          systemPrompt: systemPromptFrom(request.prompt)
+        });
+        const text2 = await session.prompt(request.prompt.task.userMessage, {
+          grammar: await this.#grammarFor(options.jsonSchema),
+          maxTokens: request.options.maxOutputTokens ?? defaultLocalGenerationOptions.maxTokens,
+          onTextChunk: options.onToken,
+          seed: request.options.seed,
+          temperature: request.options.temperature ?? defaultLocalGenerationOptions.temperature,
+          topK: request.options.topK ?? defaultLocalGenerationOptions.topK,
+          topP: request.options.topP ?? defaultLocalGenerationOptions.topP
+        });
+        const outputTokens = text2.split(/\s+/g).filter(Boolean).length;
+        return Result.ok({
+          finishReason: "stop",
+          model: model.unwrap().id,
+          provider: "local",
+          schema: "agent-devkit.brain-response/v1",
+          text: text2,
+          usage: { outputTokens }
+        });
       });
     } catch {
       return Result.fail(ErrorCodes.BrainProviderUnavailable);
@@ -5326,6 +5400,33 @@ function characterName2(character) {
 function compact(value) {
   return value.replaceAll(/\s+/g, " ").trim();
 }
+var agentDevKitConversationKnowledge = [
+  {
+    content: "Agent DevKit is a local AI agent toolkit exposed through the `agent` CLI, a TUI and MCP. It helps users operate this project through capabilities, local state, sessions, projects, preferences, personalization, logs, secrets, dependencies and local models.",
+    id: "agent-devkit.identity",
+    source: "conversation.chat"
+  },
+  {
+    content: "When the user asks personal questions about you, your personality or what you can do, answer as the configured character using your behavior, tone, detail level and traits. Do not answer as a generic human and do not list unrelated human activities.",
+    id: "agent-devkit.self-description-rule",
+    source: "conversation.chat"
+  },
+  {
+    content: "Only describe Agent DevKit internals, modules, tools, MCP, CLI commands or project capabilities when the user explicitly asks about Agent DevKit, the project, tools, commands, MCP or capabilities.",
+    id: "agent-devkit.project-scope-rule",
+    source: "conversation.chat"
+  },
+  {
+    content: "This conversation mode can answer, keep session memory and use project context. Direct tool execution is disabled in this chat prompt.",
+    id: "agent-devkit.chat-mode-limits",
+    source: "conversation.chat"
+  },
+  {
+    content: "Current capability areas include project doctor/init/reset, package update, preferences, themes, aliases, personalization characters, logs, encrypted secrets, dependency inspection/planning, models, projects, sessions and conversation.",
+    id: "agent-devkit.capability-map",
+    source: "conversation.chat"
+  }
+];
 var ConversationChatRepository = class {
   repositoryId = "conversation.chat.repository";
   #clock;
@@ -5470,7 +5571,7 @@ var ConversationChatRepository = class {
         traits: input.character.profile.traits
       },
       context: {
-        knowledge: [],
+        knowledge: agentDevKitConversationKnowledge,
         project: input.project === void 0 ? void 0 : {
           description: input.project.description,
           id: input.project.id,
@@ -5575,6 +5676,38 @@ var conversationChatCapabilityConfig = defineCapabilityConfig({
   kind: "brain-assisted",
   risk: "writes-global-state"
 });
+function normalizeQuestion(value) {
+  return value.normalize("NFD").replaceAll(new RegExp("\\p{Diacritic}", "gu"), "").toLowerCase().replaceAll(/[^\p{Letter}\p{Number}\s]/gu, " ").replaceAll(/\s+/g, " ").trim();
+}
+function isSelfDescriptionQuestion(message) {
+  const normalized = normalizeQuestion(message);
+  return normalized === "o que voce pode fazer" || normalized === "o que voce faz" || normalized === "quais sao suas capacidades" || normalized === "quais suas capacidades" || normalized === "what can you do" || normalized === "what do you do";
+}
+function countPromptTokens(request) {
+  return request.prompt.messages.map((message) => message.content.split(/\s+/g).filter(Boolean).length).reduce((total, count) => total + count, 0);
+}
+function selfDescriptionResponse(request) {
+  if (!isSelfDescriptionQuestion(request.prompt.task.userMessage)) {
+    return void 0;
+  }
+  const { agent } = request.prompt;
+  const traits = agent.traits.length === 0 ? "sem tracos extras configurados" : agent.traits.join(", ");
+  const text2 = `${agent.name}: Eu posso conversar com voce mantendo o contexto da sessao, ajudar a raciocinar, organizar ideias, analisar informacoes e responder no meu estilo configurado. Minha postura e ${agent.behavior}, meu tom e ${agent.tone}, meu nivel de detalhe e ${agent.detailLevel}, e meus tracos atuais sao: ${traits}.`;
+  const inputTokens = countPromptTokens(request);
+  const outputTokens = text2.split(/\s+/g).filter(Boolean).length;
+  return {
+    finishReason: "stop",
+    model: "self-description",
+    provider: "system",
+    schema: "agent-devkit.brain-response/v1",
+    text: text2,
+    usage: {
+      inputTokens,
+      outputTokens,
+      totalTokens: inputTokens + outputTokens
+    }
+  };
+}
 var ConversationChatService = class extends BaseCapabilityService {
   inputSchema = ConversationChatOptionsSchema;
   outputSchema = ConversationChatResultSchema;
@@ -5622,7 +5755,11 @@ var ConversationChatService = class extends BaseCapabilityService {
       prompt: prepared.unwrap().prompt,
       schema: "agent-devkit.brain-request/v1"
     };
-    const brain = onToken !== void 0 && this.#brainProvider.generateStream !== void 0 ? await this.#brainProvider.generateStream(request, onToken) : await this.#brainProvider.generate(request);
+    const selfDescription = selfDescriptionResponse(request);
+    const brain = selfDescription === void 0 ? onToken !== void 0 && this.#brainProvider.generateStream !== void 0 ? await this.#brainProvider.generateStream(request, onToken) : await this.#brainProvider.generate(request) : Result.ok(selfDescription);
+    if (selfDescription !== void 0) {
+      onToken?.(selfDescription.text);
+    }
     if (brain.isErr()) {
       return Result.fail(brain.unwrapError());
     }
@@ -9936,30 +10073,107 @@ import { homedir as homedir22 } from "os";
 
 // src/modules/conversation/capabilities/chat/chat.viewmodel.ts
 function formatConversationChatText(result) {
-  const lines = ["Agent:", result.reply, "", `Session: ${result.sessionId}`];
+  const agentName = result.prompt.agent.name.trim();
+  const reply2 = result.reply.trim();
+  const speakerPrefix = `${agentName}:`;
+  const normalizedReply = reply2.toLowerCase().startsWith(speakerPrefix.toLowerCase()) ? reply2 : `${speakerPrefix} ${reply2}`;
+  const metadata = [`Session: ${result.sessionId}`];
   if (result.projectId !== void 0) {
-    lines.push(`Project: ${result.projectId}`);
+    metadata.push(`Project: ${result.projectId}`);
   }
-  return lines.join("\n");
+  if (result.brain.model !== void 0 || result.brain.provider !== void 0) {
+    metadata.push(
+      `Model: ${[result.brain.provider, result.brain.model].filter(Boolean).join("/")}`
+    );
+  }
+  if (result.brain.usage !== void 0) {
+    const tokens = [
+      result.brain.usage.inputTokens === void 0 ? void 0 : `input ${result.brain.usage.inputTokens}`,
+      result.brain.usage.outputTokens === void 0 ? void 0 : `output ${result.brain.usage.outputTokens}`,
+      result.brain.usage.totalTokens === void 0 ? void 0 : `total ${result.brain.usage.totalTokens}`
+    ].filter(Boolean);
+    if (tokens.length > 0) {
+      metadata.push(`Tokens: ${tokens.join(", ")}`);
+    }
+  }
+  return [normalizedReply, "", ...metadata].join("\n");
 }
 
 // src/app/cli/rootConversation.ts
+var cliConversationStatePath = {
+  namespace: "conversation",
+  segments: ["cli-state.json"]
+};
+function isCliConversationState(value) {
+  const record = value;
+  return typeof value === "object" && value !== null && "activeSessionId" in value && "schema" in value && typeof record.activeSessionId === "string" && record.activeSessionId.length > 0 && record.schema === "agent-devkit.cli-conversation-state/v1";
+}
+async function loadActiveCliSessionId(dataStore, sessions) {
+  const state = await dataStore.readJson(cliConversationStatePath);
+  if (state.isErr()) {
+    return void 0;
+  }
+  const statePayload = state.unwrap();
+  if (!isCliConversationState(statePayload)) {
+    return void 0;
+  }
+  const current = await sessions.execute({
+    action: "show",
+    includeMessages: false,
+    sessionId: statePayload.activeSessionId
+  });
+  if (current.isErr()) {
+    return void 0;
+  }
+  const result = current.unwrap();
+  if (result.action !== "show" || result.session.origin !== "cli" || result.session.status !== "active") {
+    return void 0;
+  }
+  return result.session.id;
+}
+async function saveActiveCliSessionId(dataStore, sessionId) {
+  await dataStore.writeJson(
+    cliConversationStatePath,
+    {
+      activeSessionId: sessionId,
+      schema: "agent-devkit.cli-conversation-state/v1",
+      updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    },
+    { atomic: true }
+  );
+}
 async function runRootConversation(message) {
+  const homeDirectory = homedir22();
+  const dataStore = new LocalAgentDataStore({
+    rootDirectory: `${homeDirectory}/.agent-devkit/data`
+  });
   const bindings = createConversationModuleBindings({
-    brainProvider: createBrainDockProvider({ stateDirectory: `${homedir22()}/.agent-devkit` }),
-    homeDirectory: homedir22()
+    brainProvider: createBrainDockProvider({ stateDirectory: `${homeDirectory}/.agent-devkit` }),
+    dataStore,
+    homeDirectory
   });
+  const contextBindings = createContextModuleBindings({ dataStore, homeDirectory });
   if (bindings.isErr()) {
     throw new Error(bindings.unwrapError());
   }
+  if (contextBindings.isErr()) {
+    throw new Error(contextBindings.unwrapError());
+  }
+  const activeSessionId = await loadActiveCliSessionId(
+    dataStore,
+    contextBindings.unwrap().capabilities.sessions
+  );
   const result = await bindings.unwrap().capabilities.chat.execute({
     action: "send",
-    message
+    message,
+    sessionId: activeSessionId
   });
   if (result.isErr()) {
     throw new Error(result.unwrapError());
   }
-  console.log(formatConversationChatText(result.unwrap()));
+  const payload = result.unwrap();
+  await saveActiveCliSessionId(dataStore, payload.sessionId);
+  console.log(formatConversationChatText(payload));
 }
 
 // src/infra/helpers/redaction.ts