@coffer-org/plugin-claude-agent 2.0.0 → 2.2.0

package/dist/index.js

@@ -1,6 +1,7 @@
 import { definePlugin } from '@coffer-org/sdk/plugin';
 import { defineSettings } from '@coffer-org/sdk/settings';
 import { field } from '@coffer-org/sdk/fields';
+import { CLAUDE_MODELS, EFFORT_LEVELS } from "./models.js";
 export default definePlugin({
     id: 'claude-agent',
     version: '1.0.0',
@@ -8,31 +9,63 @@ export default definePlugin({
     settings: defineSettings({
         label: 'claude-agent.settings.label',
         fields: [
-            field.select({
-                key: 'auth_mode',
-                label: 'claude-agent.settings.auth_mode',
-                default: 'subscription',
-                options: [
-                    { value: 'subscription', title: 'claude-agent.settings.auth_mode_subscription' },
-                    { value: 'api_key', title: 'claude-agent.settings.auth_mode_api_key' },
+            field.group({
+                label: 'claude-agent.settings.groups.runtime',
+                icon: 'lucide:bot',
+                fields: [
+                    field.select({
+                        key: 'auth_mode',
+                        label: 'claude-agent.settings.auth_mode',
+                        default: 'subscription',
+                        options: [
+                            { value: 'subscription', title: 'claude-agent.settings.auth_mode_subscription' },
+                            { value: 'api_key', title: 'claude-agent.settings.auth_mode_api_key' },
+                        ],
+                    }),
+                    field.password({
+                        key: 'anthropic_api_key',
+                        label: 'claude-agent.settings.anthropic_api_key',
+                        view: { hidden: { auth_mode: { $ne: 'api_key' } } },
+                    }),
+                    field.select({
+                        key: 'claude_model',
+                        label: 'claude-agent.settings.claude_model',
+                        default: 'haiku',
+                        options: CLAUDE_MODELS.map((m) => ({ value: m.value, title: m.title })),
+                    }),
+                    field.select({
+                        key: 'effort',
+                        label: 'claude-agent.settings.effort',
+                        default: '',
+                        options: [
+                            { value: '', title: 'claude-agent.settings.effort_default' },
+                            ...EFFORT_LEVELS.map((v) => ({ value: v, title: v })),
+                        ],
+                    }),
+                    field.boolean({ key: 'thinking_enabled', label: 'claude-agent.settings.thinking_enabled', default: false }),
+                    field.boolean({ key: 'skip_permissions', label: 'claude-agent.settings.skip_permissions', default: true }),
+                    field.int({ key: 'response_timeout', label: 'claude-agent.settings.response_timeout', default: 600 }),
                 ],
             }),
-            field.password({
-                key: 'anthropic_api_key',
-                label: 'claude-agent.settings.anthropic_api_key',
-                view: { hidden: { auth_mode: { $ne: 'api_key' } } },
+            field.group({
+                label: 'claude-agent.settings.groups.rag',
+                icon: 'lucide:search',
+                fields: [
+                    field.boolean({ key: 'rag_enabled', label: 'claude-agent.settings.rag_enabled', default: true }),
+                    field.password({ key: 'openai_api_key', label: 'claude-agent.settings.openai_api_key' }),
+                    field.int({ key: 'rag_top_k', label: 'claude-agent.settings.rag_top_k', default: 5, view: { hidden: true } }),
+                ],
+            }),
+            field.group({
+                label: 'claude-agent.settings.groups.langfuse',
+                icon: 'lucide:activity',
+                fields: [
+                    field.boolean({ key: 'tracing_enabled', label: 'claude-agent.settings.tracing_enabled' }),
+                    field.string({ key: 'langfuse_base_url', label: 'claude-agent.settings.langfuse_base_url' }),
+                    field.password({ key: 'langfuse_public_key', label: 'claude-agent.settings.langfuse_public_key' }),
+                    field.password({ key: 'langfuse_secret_key', label: 'claude-agent.settings.langfuse_secret_key' }),
+                ],
             }),
-            field.string({ key: 'claude_model', label: 'claude-agent.settings.claude_model', default: 'haiku' }),
-            field.boolean({ key: 'skip_permissions', label: 'claude-agent.settings.skip_permissions', default: true }),
-            field.int({ key: 'response_timeout', label: 'claude-agent.settings.response_timeout', default: 600 }),
-            field.boolean({ key: 'rag_enabled', label: 'claude-agent.settings.rag_enabled', default: true }),
-            field.int({ key: 'rag_top_k', label: 'claude-agent.settings.rag_top_k', default: 5 }),
-            field.boolean({ key: 'thinking_enabled', label: 'claude-agent.settings.thinking_enabled', default: false }),
-            field.password({ key: 'openai_api_key', label: 'claude-agent.settings.openai_api_key' }),
-            field.password({ key: 'langfuse_public_key', label: 'claude-agent.settings.langfuse_public_key' }),
-            field.password({ key: 'langfuse_secret_key', label: 'claude-agent.settings.langfuse_secret_key' }),
-            field.string({ key: 'langfuse_base_url', label: 'claude-agent.settings.langfuse_base_url' }),
-            field.boolean({ key: 'tracing_enabled', label: 'claude-agent.settings.tracing_enabled' }),
         ],
     }),
 });

package/dist/models.d.ts

@@ -0,0 +1,23 @@
+export declare const CLAUDE_MODELS: readonly [{
+    readonly value: "haiku";
+    readonly id: "claude-haiku-4-5";
+    readonly title: "Haiku 4.5 — найшвидша";
+}, {
+    readonly value: "sonnet";
+    readonly id: "claude-sonnet-5";
+    readonly title: "Sonnet 5";
+}, {
+    readonly value: "opus";
+    readonly id: "claude-opus-4-8";
+    readonly title: "Opus 4.8";
+}, {
+    readonly value: "claude-opus-5";
+    readonly id: "claude-opus-5";
+    readonly title: "Opus 5";
+}, {
+    readonly value: "claude-fable-5";
+    readonly id: "claude-fable-5";
+    readonly title: "Fable 5 — найдорожча";
+}];
+export declare const EFFORT_LEVELS: readonly ["low", "medium", "high", "xhigh", "max"];
+export type Effort = (typeof EFFORT_LEVELS)[number];

package/dist/models.js

@@ -0,0 +1,8 @@
+export const CLAUDE_MODELS = [
+    { value: 'haiku', id: 'claude-haiku-4-5', title: 'Haiku 4.5 — найшвидша' },
+    { value: 'sonnet', id: 'claude-sonnet-5', title: 'Sonnet 5' },
+    { value: 'opus', id: 'claude-opus-4-8', title: 'Opus 4.8' },
+    { value: 'claude-opus-5', id: 'claude-opus-5', title: 'Opus 5' },
+    { value: 'claude-fable-5', id: 'claude-fable-5', title: 'Fable 5 — найдорожча' },
+];
+export const EFFORT_LEVELS = ['low', 'medium', 'high', 'xhigh', 'max'];

package/dist/runtime/agent.d.ts

@@ -17,6 +17,8 @@ export { modelId } from './config.ts';
 export declare function makeClient(cfg: Pick<AgentConfig, 'authMode' | 'anthropicApiKey' | 'globalCredentials'>): Anthropic;
 export declare function esc(s: string): string;
 export declare function renderContent(m: ConvMessage): string;
+export declare const MAX_TOOL_RESULT_CHARS = 100000;
+export declare function capToolResult(text: string): string;
 export interface TurnParts {
     thinking: string;
     text: string;

package/dist/runtime/agent.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import Anthropic from '@anthropic-ai/sdk';
-import { loadAgentConfig, modelId } from "./config.js";
+import { effortParam, loadAgentConfig, modelId } from "./config.js";
 import { makeAgentTools } from "./coffer.js";
 import { buildDomainSections } from '@coffer-org/server/mcp-tools';
 import { isTracing, flushTracing, langfuseFactory, TurnTracer } from "./tracing.js";
@@ -65,6 +65,13 @@ export function renderContent(m) {
     const author = m.sender ? `<author>${esc(m.sender)}</author>\n` : '';
     return `${author}<body>${esc(m.content)}</body>`;
 }
+export const MAX_TOOL_RESULT_CHARS = 100_000;
+export function capToolResult(text) {
+    if (text.length <= MAX_TOOL_RESULT_CHARS)
+        return text;
+    return (`${text.slice(0, MAX_TOOL_RESULT_CHARS)}\n\n[truncated: ${text.length} chars total. ` +
+        `Narrow the call — use limit/offset or filters, or count instead of listing.]`);
+}
 export function collectReasoning(turns) {
     const parts = [];
     for (const t of turns) {
@@ -148,6 +155,7 @@ export async function runAgent(request, deps = {}) {
             }
         }
         const thinking = thinkingParam(cfg.thinkingEnabled);
+        const outputConfig = effortParam(cfg.effort, modelId(cfg.claudeModel));
         if (cfg.thinkingEnabled)
             log.info(`extended thinking ON (${modelId(cfg.claudeModel)})`);
         let tokensIn = null;
@@ -164,6 +172,7 @@ export async function runAgent(request, deps = {}) {
                 messages,
                 tools: tools,
                 ...(thinking ? { thinking } : {}),
+                ...(outputConfig ? { output_config: outputConfig } : {}),
             }, { signal: ac.signal });
             stream.on('text', (delta) => {
                 streamed = appendTextDelta(streamed, delta);
@@ -243,7 +252,10 @@ export async function runAgent(request, deps = {}) {
                             log.warn(`tool ${b.name} threw: ${content}`);
                         }
                     }
-                    results.push({ type: 'tool_result', tool_use_id: b.id, content, is_error: isError });
+                    const capped = capToolResult(content);
+                    if (capped !== content)
+                        log.warn(`tool ${b.name} returned ${content.length} chars — truncated`);
+                    results.push({ type: 'tool_result', tool_use_id: b.id, content: capped, is_error: isError });
                 }
             }
             traceMessage(tracer, {

package/dist/runtime/config.d.ts

@@ -1,8 +1,15 @@
 export declare const APP_ROOT: string;
 export declare const PLUGIN_ROOT: string;
+import { CLAUDE_MODELS, EFFORT_LEVELS, type Effort } from '../models.ts';
+export { CLAUDE_MODELS, EFFORT_LEVELS };
+export type { Effort };
 export type AuthMode = 'subscription' | 'api_key';
 export declare function supportsAdaptiveThinking(model: string): boolean;
 export declare function modelId(alias: string): string;
+export declare function supportsEffort(model: string): boolean;
+export declare function effortParam(effort: string, model: string): {
+    effort: Effort;
+} | undefined;
 export interface AgentConfig {
     authMode: AuthMode;
     anthropicApiKey: string;
@@ -12,6 +19,7 @@ export interface AgentConfig {
     ragEnabled: boolean;
     ragTopK: number;
     thinkingEnabled: boolean;
+    effort: string;
     embeddingApiKey: string;
     langfusePublicKey: string;
     langfuseSecretKey: string;

package/dist/runtime/config.js

@@ -4,6 +4,8 @@ import { fileURLToPath } from 'node:url';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 export const APP_ROOT = path.resolve(__dirname, '../../../..');
 export const PLUGIN_ROOT = path.resolve(__dirname, '../..');
+import { CLAUDE_MODELS, EFFORT_LEVELS } from "../models.js";
+export { CLAUDE_MODELS, EFFORT_LEVELS };
 const ADAPTIVE_THINKING_MODELS = [
     'claude-opus-5', 'claude-opus-4-8', 'claude-opus-4-7', 'claude-opus-4-6',
     'claude-sonnet-5', 'claude-sonnet-4-6',
@@ -13,12 +15,18 @@ export function supportsAdaptiveThinking(model) {
     return ADAPTIVE_THINKING_MODELS.some((m) => model === m || model.startsWith(`${m}-`));
 }
 export function modelId(alias) {
-    const map = {
-        haiku: 'claude-haiku-4-5',
-        sonnet: 'claude-sonnet-5',
-        opus: 'claude-opus-4-8',
-    };
-    return map[alias] ?? (alias.startsWith('claude-') ? alias : 'claude-opus-4-8');
+    const known = CLAUDE_MODELS.find((m) => m.value === alias);
+    if (known)
+        return known.id;
+    return alias.startsWith('claude-') ? alias : 'claude-opus-4-8';
+}
+export function supportsEffort(model) {
+    return supportsAdaptiveThinking(model);
+}
+export function effortParam(effort, model) {
+    return EFFORT_LEVELS.includes(effort) && supportsEffort(model)
+        ? { effort: effort }
+        : undefined;
 }
 export function loadAgentConfig(opts = {}) {
     const env = opts.env ?? process.env;
@@ -32,9 +40,10 @@ export function loadAgentConfig(opts = {}) {
         skipPermissions: db.skip_permissions !== false,
         responseTimeout: Math.max(60, Number(env.AGENT_RESPONSE_TIMEOUT ?? db.response_timeout ?? 600) || 600),
         ragEnabled: db.rag_enabled !== false,
-        ragTopK: Number(env.AGENT_RAG_TOP_K ?? db.rag_top_k ?? 5) || 5,
+        ragTopK: 5,
         thinkingEnabled: (env.AGENT_THINKING_ENABLED ?? String(db.thinking_enabled)) === 'true'
             && supportsAdaptiveThinking(modelId(claudeModel)),
+        effort: String(env.AGENT_EFFORT ?? db.effort ?? ''),
         embeddingApiKey: env.OPENAI_API_KEY ?? db.openai_api_key ?? '',
         langfusePublicKey: env.LANGFUSE_PUBLIC_KEY ?? db.langfuse_public_key ?? '',
         langfuseSecretKey: env.LANGFUSE_SECRET_KEY ?? db.langfuse_secret_key ?? '',

package/dist/schema.js

@@ -7084,72 +7084,139 @@ var src_default = definePlugin({
 	settings: defineSettings({
 		label: "claude-agent.settings.label",
 		fields: [
-			field.select({
-				key: "auth_mode",
-				label: "claude-agent.settings.auth_mode",
-				default: "subscription",
-				options: [{
-					value: "subscription",
-					title: "claude-agent.settings.auth_mode_subscription"
-				}, {
-					value: "api_key",
-					title: "claude-agent.settings.auth_mode_api_key"
-				}]
-			}),
-			field.password({
-				key: "anthropic_api_key",
-				label: "claude-agent.settings.anthropic_api_key",
-				view: { hidden: { auth_mode: { $ne: "api_key" } } }
-			}),
-			field.string({
-				key: "claude_model",
-				label: "claude-agent.settings.claude_model",
-				default: "haiku"
-			}),
-			field.boolean({
-				key: "skip_permissions",
-				label: "claude-agent.settings.skip_permissions",
-				default: true
-			}),
-			field.int({
-				key: "response_timeout",
-				label: "claude-agent.settings.response_timeout",
-				default: 600
-			}),
-			field.boolean({
-				key: "rag_enabled",
-				label: "claude-agent.settings.rag_enabled",
-				default: true
-			}),
-			field.int({
-				key: "rag_top_k",
-				label: "claude-agent.settings.rag_top_k",
-				default: 5
-			}),
-			field.boolean({
-				key: "thinking_enabled",
-				label: "claude-agent.settings.thinking_enabled",
-				default: false
-			}),
-			field.password({
-				key: "openai_api_key",
-				label: "claude-agent.settings.openai_api_key"
-			}),
-			field.password({
-				key: "langfuse_public_key",
-				label: "claude-agent.settings.langfuse_public_key"
-			}),
-			field.password({
-				key: "langfuse_secret_key",
-				label: "claude-agent.settings.langfuse_secret_key"
+			field.group({
+				label: "claude-agent.settings.groups.runtime",
+				icon: "lucide:bot",
+				fields: [
+					field.select({
+						key: "auth_mode",
+						label: "claude-agent.settings.auth_mode",
+						default: "subscription",
+						options: [{
+							value: "subscription",
+							title: "claude-agent.settings.auth_mode_subscription"
+						}, {
+							value: "api_key",
+							title: "claude-agent.settings.auth_mode_api_key"
+						}]
+					}),
+					field.password({
+						key: "anthropic_api_key",
+						label: "claude-agent.settings.anthropic_api_key",
+						view: { hidden: { auth_mode: { $ne: "api_key" } } }
+					}),
+					field.select({
+						key: "claude_model",
+						label: "claude-agent.settings.claude_model",
+						default: "haiku",
+						options: [
+							{
+								value: "haiku",
+								id: "claude-haiku-4-5",
+								title: "Haiku 4.5 — найшвидша"
+							},
+							{
+								value: "sonnet",
+								id: "claude-sonnet-5",
+								title: "Sonnet 5"
+							},
+							{
+								value: "opus",
+								id: "claude-opus-4-8",
+								title: "Opus 4.8"
+							},
+							{
+								value: "claude-opus-5",
+								id: "claude-opus-5",
+								title: "Opus 5"
+							},
+							{
+								value: "claude-fable-5",
+								id: "claude-fable-5",
+								title: "Fable 5 — найдорожча"
+							}
+						].map((m) => ({
+							value: m.value,
+							title: m.title
+						}))
+					}),
+					field.select({
+						key: "effort",
+						label: "claude-agent.settings.effort",
+						default: "",
+						options: [{
+							value: "",
+							title: "claude-agent.settings.effort_default"
+						}, ...[
+							"low",
+							"medium",
+							"high",
+							"xhigh",
+							"max"
+						].map((v) => ({
+							value: v,
+							title: v
+						}))]
+					}),
+					field.boolean({
+						key: "thinking_enabled",
+						label: "claude-agent.settings.thinking_enabled",
+						default: false
+					}),
+					field.boolean({
+						key: "skip_permissions",
+						label: "claude-agent.settings.skip_permissions",
+						default: true
+					}),
+					field.int({
+						key: "response_timeout",
+						label: "claude-agent.settings.response_timeout",
+						default: 600
+					})
+				]
 			}),
-			field.string({
-				key: "langfuse_base_url",
-				label: "claude-agent.settings.langfuse_base_url"
+			field.group({
+				label: "claude-agent.settings.groups.rag",
+				icon: "lucide:search",
+				fields: [
+					field.boolean({
+						key: "rag_enabled",
+						label: "claude-agent.settings.rag_enabled",
+						default: true
+					}),
+					field.password({
+						key: "openai_api_key",
+						label: "claude-agent.settings.openai_api_key"
+					}),
+					field.int({
+						key: "rag_top_k",
+						label: "claude-agent.settings.rag_top_k",
+						default: 5,
+						view: { hidden: true }
+					})
+				]
 			}),
-			field.boolean({
-				key: "tracing_enabled",
-				label: "claude-agent.settings.tracing_enabled"
+			field.group({
+				label: "claude-agent.settings.groups.langfuse",
+				icon: "lucide:activity",
+				fields: [
+					field.boolean({
+						key: "tracing_enabled",
+						label: "claude-agent.settings.tracing_enabled"
+					}),
+					field.string({
+						key: "langfuse_base_url",
+						label: "claude-agent.settings.langfuse_base_url"
+					}),
+					field.password({
+						key: "langfuse_public_key",
+						label: "claude-agent.settings.langfuse_public_key"
+					}),
+					field.password({
+						key: "langfuse_secret_key",
+						label: "claude-agent.settings.langfuse_secret_key"
+					})
+				]
 			})
 		]
 	})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/plugin-claude-agent",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "type": "module",
   "engines": {
     "node": ">=24"
@@ -26,9 +26,9 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.111.0",
-    "@coffer-org/mcp": "^2.0.0",
+    "@coffer-org/mcp": "^2.2.0",
     "@coffer-org/sdk": "^2.0.0",
-    "@coffer-org/server": "^2.0.1",
+    "@coffer-org/server": "^2.1.1",
     "@langfuse/otel": "^4.6.1",
     "@langfuse/tracing": "^4.6.1",
     "@opentelemetry/sdk-trace-node": "^2.8.0",