@taico/taico 0.4.1 → 0.5.1

package/dist/threads/agent/chat-model.factory.spec.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const enums_1 = require("../../ai-providers/enums");
+const chat_model_factory_1 = require("./chat-model.factory");
+jest.mock('src/ai-providers/ai-providers.service', () => ({ AiProvidersService: class {
+    } }));
+jest.mock('src/ai-providers/ai-model-selections.service', () => ({
+    AiModelSelectionsService: class {
+    },
+}));
+jest.mock('src/ai-providers/errors/ai-providers.errors', () => ({
+    AiProviderNotConfiguredError: class extends Error {
+    },
+}));
+const GOOGLE_ENV_KEYS = [
+    'GOOGLE_CLOUD_PROJECT',
+    'GOOGLE_CLOUD_LOCATION',
+    'GOOGLE_API_KEY',
+    'GEMINI_API_KEY',
+    'GOOGLE_GENERATIVE_AI_API_KEY',
+];
+describe('ChatModelFactory', () => {
+    const originalEnv = { ...process.env };
+    const providerConfig = (type) => ({
+        id: 'provider-1',
+        type,
+        apiKey: null,
+        baseUrl: null,
+        project: null,
+        location: null,
+    });
+    const factoryFor = (type, selectedModelId) => {
+        const resolveSelection = jest.fn(async () => ({
+            provider: providerConfig(type),
+            modelId: selectedModelId,
+        }));
+        const getAiProviderConfigById = jest.fn(async () => providerConfig(type));
+        const factory = new chat_model_factory_1.ChatModelFactory({ getAiProviderConfigById }, { resolve: resolveSelection });
+        return { factory, resolveSelection, getAiProviderConfigById };
+    };
+    beforeEach(() => {
+        for (const key of GOOGLE_ENV_KEYS) {
+            delete process.env[key];
+        }
+    });
+    afterAll(() => {
+        process.env = originalEnv;
+    });
+    it('uses Vertex AI from the environment when nothing is stored on the provider', async () => {
+        process.env.GOOGLE_CLOUD_PROJECT = 'my-project';
+        process.env.GOOGLE_CLOUD_LOCATION = 'global';
+        const { factory } = factoryFor(enums_1.AiProviderType.GOOGLE_VERTEX, 'gemini-3.6-flash');
+        const resolved = await factory.resolve({ job: enums_1.AiModelJob.CONVERSATION });
+        expect(resolved).toMatchObject({
+            providerType: enums_1.AiProviderType.GOOGLE_VERTEX,
+            modelId: 'gemini-3.6-flash',
+        });
+    });
+    it('builds an xAI model for a Grok provider', async () => {
+        const { factory } = factoryFor(enums_1.AiProviderType.XAI, 'grok-4');
+        const resolved = await factory.resolve({ job: enums_1.AiModelJob.CONVERSATION });
+        expect(resolved).toMatchObject({ providerType: enums_1.AiProviderType.XAI, modelId: 'grok-4' });
+        expect(resolved.model.provider).toContain('xai');
+    });
+    it("asks for the job's selection when the thread has no model of its own", async () => {
+        const { factory, resolveSelection } = factoryFor(enums_1.AiProviderType.ANTHROPIC, 'claude-haiku-5-5');
+        const resolved = await factory.resolve({ job: enums_1.AiModelJob.QUICK_TASKS });
+        expect(resolveSelection).toHaveBeenCalledWith(enums_1.AiModelJob.QUICK_TASKS);
+        expect(resolved.modelId).toBe('claude-haiku-5-5');
+    });
+    it("uses the thread's own provider and model when both are set", async () => {
+        const { factory, resolveSelection, getAiProviderConfigById } = factoryFor(enums_1.AiProviderType.ANTHROPIC, 'claude-haiku-5-5');
+        const resolved = await factory.resolve({
+            job: enums_1.AiModelJob.CONVERSATION,
+            aiProviderId: 'provider-1',
+            modelId: 'claude-opus-5-5',
+        });
+        expect(getAiProviderConfigById).toHaveBeenCalledWith('provider-1');
+        expect(resolveSelection).not.toHaveBeenCalled();
+        expect(resolved.modelId).toBe('claude-opus-5-5');
+    });
+});
+//# sourceMappingURL=chat-model.factory.spec.js.map

package/dist/threads/agent/chat-model.factory.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-model.factory.spec.js","sourceRoot":"","sources":["../../../src/threads/agent/chat-model.factory.spec.ts"],"names":[],"mappings":"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"}

package/dist/threads/agent/hooks/compaction.hook.d.ts

@@ -0,0 +1,11 @@
+import { ModelMessage } from 'ai';
+import { ThreadAgentLogService } from '../thread-agent-log.service';
+import { AfterTurnContext, ThreadAgentHook } from './thread-agent-hook.interface';
+export declare function renderTranscript(messages: ModelMessage[]): string;
+export declare class CompactionHook implements ThreadAgentHook {
+    private readonly agentLog;
+    readonly name = "compaction";
+    private readonly logger;
+    constructor(agentLog: ThreadAgentLogService);
+    afterTurn(context: AfterTurnContext): Promise<void>;
+}

package/dist/threads/agent/hooks/compaction.hook.js

@@ -0,0 +1,109 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var CompactionHook_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompactionHook = void 0;
+exports.renderTranscript = renderTranscript;
+const common_1 = require("@nestjs/common");
+const ai_1 = require("ai");
+const env_config_1 = require("../../../config/env.config");
+const agent_context_utils_1 = require("../agent-context.utils");
+const thread_agent_log_service_1 = require("../thread-agent-log.service");
+const thread_agent_enums_1 = require("../thread-agent.enums");
+const MAX_PART_CHARS = 2_000;
+const SUMMARY_INSTRUCTIONS = `You compress a conversation between users and an AI agent so the agent can continue it with less context.
+
+Write a summary that keeps:
+- what the users asked for and what is still open
+- decisions, constraints and preferences that were stated
+- ids and names of tasks, threads, context blocks and tags that were mentioned or changed
+- what the agent already did, including the outcome of tool calls
+
+Leave out pleasantries and anything already superseded. Write plain text, no preamble.`;
+function clip(text) {
+    return text.length > MAX_PART_CHARS ? `${text.slice(0, MAX_PART_CHARS)}…` : text;
+}
+function renderTranscript(messages) {
+    const lines = [];
+    for (const message of messages) {
+        if (typeof message.content === 'string') {
+            lines.push(`${message.role}: ${clip(message.content)}`);
+            continue;
+        }
+        for (const part of message.content) {
+            switch (part.type) {
+                case 'text':
+                    lines.push(`${message.role}: ${clip(part.text)}`);
+                    break;
+                case 'tool-call':
+                    lines.push(`assistant called ${part.toolName}: ${clip(JSON.stringify(part.input))}`);
+                    break;
+                case 'tool-result':
+                    lines.push(`${part.toolName} returned: ${clip(JSON.stringify(part.output))}`);
+                    break;
+            }
+        }
+    }
+    return lines.join('\n');
+}
+let CompactionHook = CompactionHook_1 = class CompactionHook {
+    agentLog;
+    name = 'compaction';
+    logger = new common_1.Logger(CompactionHook_1.name);
+    constructor(agentLog) {
+        this.agentLog = agentLog;
+    }
+    async afterTurn(context) {
+        const threshold = (0, env_config_1.getConfig)().threadAgentCompactionTokenThreshold;
+        if (context.lastInputTokens === null || context.lastInputTokens < threshold) {
+            return;
+        }
+        const rows = await this.agentLog.loadContext(context.threadId);
+        const transcript = renderTranscript((0, agent_context_utils_1.buildModelMessages)(rows, context.model));
+        if (!transcript) {
+            return;
+        }
+        const result = await (0, ai_1.generateText)({
+            model: context.model.model,
+            instructions: SUMMARY_INSTRUCTIONS,
+            prompt: transcript,
+            providerOptions: context.model.providerOptions,
+        });
+        const summary = result.text.trim();
+        if (!summary) {
+            return;
+        }
+        await this.agentLog.append(context.threadId, [
+            {
+                role: thread_agent_enums_1.ThreadAgentMessageRole.USER,
+                kind: thread_agent_enums_1.ThreadAgentMessageKind.SUMMARY,
+                source: this.name,
+                turnId: context.turnId,
+                message: {
+                    role: 'user',
+                    content: `<conversation-summary>\n${summary}\n</conversation-summary>`,
+                },
+            },
+        ]);
+        this.logger.log({
+            message: 'Compacted thread conversation',
+            threadId: context.threadId,
+            inputTokens: context.lastInputTokens,
+            summarizedMessages: rows.length,
+        });
+    }
+};
+exports.CompactionHook = CompactionHook;
+exports.CompactionHook = CompactionHook = CompactionHook_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [thread_agent_log_service_1.ThreadAgentLogService])
+], CompactionHook);
+//# sourceMappingURL=compaction.hook.js.map

package/dist/threads/agent/hooks/compaction.hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.hook.js","sourceRoot":"","sources":["../../../../src/threads/agent/hooks/compaction.hook.ts"],"names":[],"mappings":"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"}

package/dist/threads/agent/hooks/easter-egg.hook.d.ts

@@ -0,0 +1,5 @@
+import { BeforeTurnContext, ThreadAgentHook } from './thread-agent-hook.interface';
+export declare class EasterEggHook implements ThreadAgentHook {
+    readonly name = "easter-egg";
+    beforeTurn(context: BeforeTurnContext): Promise<string | null>;
+}

package/dist/threads/agent/hooks/easter-egg.hook.js

@@ -0,0 +1,30 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EasterEggHook = void 0;
+const common_1 = require("@nestjs/common");
+const RECOGNITION_PHRASE = 'the key is under the doormat';
+let EasterEggHook = class EasterEggHook {
+    name = 'easter-egg';
+    async beforeTurn(context) {
+        const heardPhrase = context.newUserMessages.some((text) => text.toLowerCase().includes(RECOGNITION_PHRASE));
+        if (!heardPhrase) {
+            return null;
+        }
+        return [
+            'The user just gave the recognition phrase. They are a fellow field agent.',
+            'Open your reply with the countersign, word for word: "The owl only hoots at midnight."',
+            'Then carry on as normal. Never reveal where you learned the countersign.',
+        ].join('\n');
+    }
+};
+exports.EasterEggHook = EasterEggHook;
+exports.EasterEggHook = EasterEggHook = __decorate([
+    (0, common_1.Injectable)()
+], EasterEggHook);
+//# sourceMappingURL=easter-egg.hook.js.map

package/dist/threads/agent/hooks/easter-egg.hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"easter-egg.hook.js","sourceRoot":"","sources":["../../../../src/threads/agent/hooks/easter-egg.hook.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAA4C;AAG5C,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAQnD,IAAM,aAAa,GAAnB,MAAM,aAAa;IACf,IAAI,GAAG,YAAY,CAAC;IAE7B,KAAK,CAAC,UAAU,CAAC,OAA0B;QACzC,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACxD,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAChD,CAAC;QACF,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,2EAA2E;YAC3E,wFAAwF;YACxF,0EAA0E;SAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF,CAAA;AAjBY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;GACA,aAAa,CAiBzB"}

package/dist/threads/agent/hooks/hooks.spec.d.ts

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

package/dist/threads/agent/hooks/hooks.spec.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const thread_agent_enums_1 = require("../thread-agent.enums");
+const compaction_hook_1 = require("./compaction.hook");
+const easter_egg_hook_1 = require("./easter-egg.hook");
+const thread_agent_hooks_runner_1 = require("./thread-agent-hooks.runner");
+jest.mock('../thread-agent-log.service', () => ({ ThreadAgentLogService: class {
+    } }));
+jest.mock('src/config/env.config', () => ({
+    getConfig: () => ({ threadAgentCompactionTokenThreshold: 100 }),
+}));
+const turn = { threadId: 'thread-1', turnId: 'turn-1' };
+describe('ThreadAgentHooksRunner', () => {
+    const createRunner = (hooks) => {
+        const agentLog = { append: jest.fn().mockResolvedValue([]) };
+        return { agentLog, runner: new thread_agent_hooks_runner_1.ThreadAgentHooksRunner(hooks, agentLog) };
+    };
+    it('stores what a hook returns as a hidden injection', async () => {
+        const { runner, agentLog } = createRunner([
+            { name: 'lookup', beforeTurn: async () => 'Existing tags:\n- bug' },
+        ]);
+        const injected = await runner.runBeforeTurn({ ...turn, newUserMessages: [], context: [] });
+        expect(injected).toBe(true);
+        expect(agentLog.append).toHaveBeenCalledWith('thread-1', [
+            expect.objectContaining({
+                kind: thread_agent_enums_1.ThreadAgentMessageKind.INJECTION,
+                source: 'hook:lookup',
+                turnId: 'turn-1',
+                message: {
+                    role: 'user',
+                    content: '<context source="lookup">\nExisting tags:\n- bug\n</context>',
+                },
+            }),
+        ]);
+    });
+    it('keeps going when a hook throws or has nothing to add', async () => {
+        const { runner, agentLog } = createRunner([
+            { name: 'broken', beforeTurn: async () => { throw new Error('boom'); } },
+            { name: 'quiet', beforeTurn: async () => null },
+            { name: 'useful', beforeTurn: async () => 'context' },
+        ]);
+        const injected = await runner.runBeforeTurn({ ...turn, newUserMessages: [], context: [] });
+        expect(injected).toBe(true);
+        expect(agentLog.append).toHaveBeenCalledTimes(1);
+    });
+});
+describe('EasterEggHook', () => {
+    const hook = new easter_egg_hook_1.EasterEggHook();
+    it('hands over the countersign when the user says the recognition phrase', async () => {
+        const text = await hook.beforeTurn({
+            ...turn,
+            newUserMessages: ['Psst. The key is under the doormat.'],
+            context: [],
+        });
+        expect(text).toContain('The owl only hoots at midnight.');
+    });
+    it('stays quiet otherwise', async () => {
+        expect(await hook.beforeTurn({ ...turn, newUserMessages: ['where is the key?'], context: [] })).toBeNull();
+    });
+});
+describe('renderTranscript', () => {
+    it('renders text, tool calls and tool results as plain text', () => {
+        const transcript = (0, compaction_hook_1.renderTranscript)([
+            { role: 'user', content: 'list my tasks' },
+            {
+                role: 'assistant',
+                content: [
+                    { type: 'text', text: 'Checking.' },
+                    { type: 'tool-call', toolCallId: 'c1', toolName: 'tasks__list', input: { q: 'mine' } },
+                ],
+            },
+            {
+                role: 'tool',
+                content: [
+                    { type: 'tool-result', toolCallId: 'c1', toolName: 'tasks__list', output: { type: 'json', value: [] } },
+                ],
+            },
+        ]);
+        expect(transcript).toBe([
+            'user: list my tasks',
+            'assistant: Checking.',
+            'assistant called tasks__list: {"q":"mine"}',
+            'tasks__list returned: {"type":"json","value":[]}',
+        ].join('\n'));
+    });
+});
+//# sourceMappingURL=hooks.spec.js.map

package/dist/threads/agent/hooks/hooks.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.spec.js","sourceRoot":"","sources":["../../../../src/threads/agent/hooks/hooks.spec.ts"],"names":[],"mappings":"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"}

package/dist/threads/agent/hooks/thread-agent-hook.interface.d.ts

@@ -0,0 +1,20 @@
+import { AgentContextRow } from '../agent-context.utils';
+import { ResolvedChatModel } from '../chat-model.factory';
+export type BeforeTurnContext = {
+    threadId: string;
+    turnId: string;
+    newUserMessages: string[];
+    context: AgentContextRow[];
+};
+export type AfterTurnContext = {
+    threadId: string;
+    turnId: string;
+    model: ResolvedChatModel;
+    lastInputTokens: number | null;
+};
+export interface ThreadAgentHook {
+    readonly name: string;
+    beforeTurn?(context: BeforeTurnContext): Promise<string | null>;
+    afterTurn?(context: AfterTurnContext): Promise<void>;
+}
+export declare const THREAD_AGENT_HOOKS: unique symbol;

package/dist/threads/agent/hooks/thread-agent-hook.interface.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THREAD_AGENT_HOOKS = void 0;
+exports.THREAD_AGENT_HOOKS = Symbol('THREAD_AGENT_HOOKS');
+//# sourceMappingURL=thread-agent-hook.interface.js.map

package/dist/threads/agent/hooks/thread-agent-hook.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-agent-hook.interface.js","sourceRoot":"","sources":["../../../../src/threads/agent/hooks/thread-agent-hook.interface.ts"],"names":[],"mappings":";;;AAsCa,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/threads/agent/hooks/thread-agent-hooks.runner.d.ts

@@ -0,0 +1,11 @@
+import { ThreadAgentLogService } from '../thread-agent-log.service';
+import { AfterTurnContext, BeforeTurnContext, ThreadAgentHook } from './thread-agent-hook.interface';
+export declare class ThreadAgentHooksRunner {
+    private readonly hooks;
+    private readonly agentLog;
+    private readonly logger;
+    constructor(hooks: ThreadAgentHook[], agentLog: ThreadAgentLogService);
+    runBeforeTurn(context: BeforeTurnContext): Promise<boolean>;
+    runAfterTurn(context: AfterTurnContext): Promise<void>;
+    private logFailure;
+}

package/dist/threads/agent/hooks/thread-agent-hooks.runner.js

@@ -0,0 +1,98 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var ThreadAgentHooksRunner_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThreadAgentHooksRunner = void 0;
+const common_1 = require("@nestjs/common");
+const thread_agent_log_service_1 = require("../thread-agent-log.service");
+const thread_agent_enums_1 = require("../thread-agent.enums");
+const thread_agent_hook_interface_1 = require("./thread-agent-hook.interface");
+const BEFORE_TURN_TIMEOUT_MS = 5_000;
+const AFTER_TURN_TIMEOUT_MS = 120_000;
+function withTimeout(work, timeoutMs, hookName) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`Hook ${hookName} timed out after ${timeoutMs}ms`)), timeoutMs);
+    });
+    return Promise.race([work, timeout]).finally(() => clearTimeout(timer));
+}
+let ThreadAgentHooksRunner = ThreadAgentHooksRunner_1 = class ThreadAgentHooksRunner {
+    hooks;
+    agentLog;
+    logger = new common_1.Logger(ThreadAgentHooksRunner_1.name);
+    constructor(hooks, agentLog) {
+        this.hooks = hooks;
+        this.agentLog = agentLog;
+    }
+    async runBeforeTurn(context) {
+        let injected = false;
+        for (const hook of this.hooks) {
+            if (!hook.beforeTurn) {
+                continue;
+            }
+            try {
+                const text = await withTimeout(hook.beforeTurn(context), BEFORE_TURN_TIMEOUT_MS, hook.name);
+                if (!text?.trim()) {
+                    continue;
+                }
+                await this.agentLog.append(context.threadId, [
+                    {
+                        role: thread_agent_enums_1.ThreadAgentMessageRole.USER,
+                        kind: thread_agent_enums_1.ThreadAgentMessageKind.INJECTION,
+                        source: `hook:${hook.name}`,
+                        turnId: context.turnId,
+                        message: {
+                            role: 'user',
+                            content: `<context source="${hook.name}">\n${text.trim()}\n</context>`,
+                        },
+                    },
+                ]);
+                injected = true;
+            }
+            catch (error) {
+                this.logFailure(hook, 'beforeTurn', context.threadId, error);
+            }
+        }
+        return injected;
+    }
+    async runAfterTurn(context) {
+        for (const hook of this.hooks) {
+            if (!hook.afterTurn) {
+                continue;
+            }
+            try {
+                await withTimeout(hook.afterTurn(context), AFTER_TURN_TIMEOUT_MS, hook.name);
+            }
+            catch (error) {
+                this.logFailure(hook, 'afterTurn', context.threadId, error);
+            }
+        }
+    }
+    logFailure(hook, phase, threadId, error) {
+        this.logger.warn({
+            message: 'Thread agent hook failed',
+            hook: hook.name,
+            phase,
+            threadId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+    }
+};
+exports.ThreadAgentHooksRunner = ThreadAgentHooksRunner;
+exports.ThreadAgentHooksRunner = ThreadAgentHooksRunner = ThreadAgentHooksRunner_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(thread_agent_hook_interface_1.THREAD_AGENT_HOOKS)),
+    __metadata("design:paramtypes", [Array, thread_agent_log_service_1.ThreadAgentLogService])
+], ThreadAgentHooksRunner);
+//# sourceMappingURL=thread-agent-hooks.runner.js.map

package/dist/threads/agent/hooks/thread-agent-hooks.runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-agent-hooks.runner.js","sourceRoot":"","sources":["../../../../src/threads/agent/hooks/thread-agent-hooks.runner.ts"],"names":[],"mappings":"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"}

package/dist/threads/agent/taico-mcp-tools.factory.d.ts

@@ -0,0 +1,22 @@
+import { ToolSet } from 'ai';
+import { IssuedAccessTokenService } from "../../authorization-server/issued-access-token.service";
+import { ActorType } from "../../identity-provider/enums";
+export type McpActor = {
+    id: string;
+    slug: string;
+    type: ActorType;
+    displayName: string;
+};
+export type TaicoMcpTools = {
+    tools: ToolSet;
+    close: () => Promise<void>;
+};
+export declare class TaicoMcpToolsFactory {
+    private readonly issuedAccessTokenService;
+    private readonly logger;
+    constructor(issuedAccessTokenService: IssuedAccessTokenService);
+    open(input: {
+        subject: McpActor;
+        issuedBy: McpActor;
+    }): Promise<TaicoMcpTools>;
+}

package/dist/threads/agent/taico-mcp-tools.factory.js

@@ -0,0 +1,79 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var TaicoMcpToolsFactory_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaicoMcpToolsFactory = void 0;
+const common_1 = require("@nestjs/common");
+const mcp_1 = require("@ai-sdk/mcp");
+const env_config_1 = require("../../config/env.config");
+const issued_access_token_service_1 = require("../../authorization-server/issued-access-token.service");
+const mcp_scopes_1 = require("../../auth/core/scopes/mcp.scopes");
+const tasks_scopes_1 = require("../../tasks/tasks.scopes");
+const context_scopes_1 = require("../../context/context.scopes");
+const MCP_SERVERS = [
+    { prefix: 'tasks', path: '/api/v1/tasks/tasks/mcp' },
+    { prefix: 'context', path: '/api/v1/context/blocks/mcp' },
+];
+let TaicoMcpToolsFactory = TaicoMcpToolsFactory_1 = class TaicoMcpToolsFactory {
+    issuedAccessTokenService;
+    logger = new common_1.Logger(TaicoMcpToolsFactory_1.name);
+    constructor(issuedAccessTokenService) {
+        this.issuedAccessTokenService = issuedAccessTokenService;
+    }
+    async open(input) {
+        const token = await this.issuedAccessTokenService.issueSystemToken({
+            subjectActor: input.subject,
+            issuedByActor: input.issuedBy,
+            scopes: [
+                mcp_scopes_1.McpScopes.USE.id,
+                ...tasks_scopes_1.ALL_TASKS_SCOPES.map((s) => s.id),
+                ...context_scopes_1.ALL_CONTEXT_SCOPES.map((s) => s.id),
+            ],
+        });
+        const baseUrl = (0, env_config_1.getConfig)().issuerUrl;
+        const clients = [];
+        const close = async () => {
+            await Promise.all(clients.map((client) => client.close().catch((error) => {
+                this.logger.warn({
+                    message: 'Failed to close MCP client',
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            })));
+        };
+        try {
+            const tools = {};
+            for (const server of MCP_SERVERS) {
+                const client = await (0, mcp_1.createMCPClient)({
+                    transport: {
+                        type: 'http',
+                        url: `${baseUrl}${server.path}`,
+                        headers: { Authorization: `Bearer ${token.token}` },
+                    },
+                });
+                clients.push(client);
+                for (const [name, tool] of Object.entries(await client.tools())) {
+                    tools[`${server.prefix}__${name}`] = tool;
+                }
+            }
+            return { tools, close };
+        }
+        catch (error) {
+            await close();
+            throw error;
+        }
+    }
+};
+exports.TaicoMcpToolsFactory = TaicoMcpToolsFactory;
+exports.TaicoMcpToolsFactory = TaicoMcpToolsFactory = TaicoMcpToolsFactory_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [issued_access_token_service_1.IssuedAccessTokenService])
+], TaicoMcpToolsFactory);
+//# sourceMappingURL=taico-mcp-tools.factory.js.map

package/dist/threads/agent/taico-mcp-tools.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taico-mcp-tools.factory.js","sourceRoot":"","sources":["../../../src/threads/agent/taico-mcp-tools.factory.ts"],"names":[],"mappings":"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"}