harubashi 0.1.0

package/dist/llm/openai/openai.provider.js

@@ -0,0 +1,35 @@
+"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 OpenAiProvider_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAiProvider = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+let OpenAiProvider = OpenAiProvider_1 = class OpenAiProvider {
+    configService;
+    logger = new common_1.Logger(OpenAiProvider_1.name);
+    constructor(configService) {
+        this.configService = configService;
+        const apiKey = this.configService.get('OPENAI_API_KEY');
+        if (!apiKey) {
+            this.logger.warn('OPENAI_API_KEY is not set.');
+        }
+    }
+    async generateResponse(_systemPrompt, _messages, _tools, _signal) {
+        throw new common_1.NotImplementedException('OpenAiProvider.generateResponse() will be implemented later');
+    }
+};
+exports.OpenAiProvider = OpenAiProvider;
+exports.OpenAiProvider = OpenAiProvider = OpenAiProvider_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], OpenAiProvider);
+//# sourceMappingURL=openai.provider.js.map

package/dist/llm/openai/openai.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.provider.js","sourceRoot":"","sources":["../../../src/llm/openai/openai.provider.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAA6E;AAC7E,2CAA+C;AASxC,IAAM,cAAc,sBAApB,MAAM,cAAc;IAGI;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,gBAAc,CAAC,IAAI,CAAC,CAAC;IAE1D,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAS,gBAAgB,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,aAAqB,EACrB,SAAuB,EACvB,MAAwB,EACxB,OAAqB;QAGrB,MAAM,IAAI,gCAAuB,CAC/B,6DAA6D,CAC9D,CAAC;IACJ,CAAC;CACF,CAAA;AArBY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAIiC,sBAAa;GAH9C,cAAc,CAqB1B"}

package/dist/llm/openai-compatible/openai-compatible.helper.d.ts

@@ -0,0 +1,4 @@
+import OpenAI from 'openai';
+import { LlmMessage, LlmResponse } from '../llm.interface';
+import { ToolDefinition } from '../../common/types/tool.types';
+export declare function generateViaOpenAiCompatible(client: OpenAI, model: string, systemPrompt: string, messages: LlmMessage[], tools: ToolDefinition[], signal?: AbortSignal): Promise<LlmResponse>;

package/dist/llm/openai-compatible/openai-compatible.helper.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateViaOpenAiCompatible = generateViaOpenAiCompatible;
+const message_types_1 = require("../../common/types/message.types");
+async function generateViaOpenAiCompatible(client, model, systemPrompt, messages, tools, signal) {
+    const chatMessages = buildChatMessages(systemPrompt, messages);
+    const chatTools = buildTools(tools);
+    const response = await client.chat.completions.create({
+        model,
+        messages: chatMessages,
+        tools: chatTools.length > 0 ? chatTools : undefined,
+    }, { signal });
+    const choice = response.choices[0];
+    const contentBlocks = choice
+        ? parseMessage(choice.message)
+        : [{ type: message_types_1.ContentBlockType.Text, text: '' }];
+    return {
+        contentBlocks,
+        tokenUsage: {
+            inputTokens: response.usage?.prompt_tokens ?? 0,
+            outputTokens: response.usage?.completion_tokens ?? 0,
+            totalTokens: response.usage?.total_tokens ?? 0,
+        },
+    };
+}
+function buildChatMessages(systemPrompt, messages) {
+    const out = [];
+    if (systemPrompt?.trim()) {
+        out.push({ role: 'system', content: systemPrompt });
+    }
+    for (const msg of messages) {
+        if (msg.role === 'user') {
+            pushUserMessage(out, msg.content);
+        }
+        else {
+            pushAssistantMessage(out, msg.content);
+        }
+    }
+    return out;
+}
+function pushUserMessage(out, blocks) {
+    const toolResults = blocks.filter((b) => b.type === message_types_1.ContentBlockType.ToolResult);
+    const userParts = blocks.filter((b) => b.type !== message_types_1.ContentBlockType.ToolResult);
+    if (userParts.length > 0) {
+        out.push({
+            role: 'user',
+            content: buildUserContent(userParts),
+        });
+    }
+    for (const tr of toolResults) {
+        const text = tr.content
+            .filter((c) => c.type === message_types_1.ContentBlockType.Text)
+            .map((c) => c.text)
+            .join('\n');
+        out.push({
+            role: 'tool',
+            tool_call_id: tr.tool_use_id,
+            content: tr.is_error ? `ERROR: ${text}` : text || '(no output)',
+        });
+    }
+}
+function pushAssistantMessage(out, blocks) {
+    const textParts = blocks.filter((b) => b.type === message_types_1.ContentBlockType.Text);
+    const toolUses = blocks.filter((b) => b.type === message_types_1.ContentBlockType.ToolUse);
+    const joinedText = textParts.map((t) => t.text).join('\n').trim();
+    const assistantMsg = {
+        role: 'assistant',
+        content: joinedText || null,
+    };
+    if (toolUses.length > 0) {
+        assistantMsg.tool_calls = toolUses.map((tu) => ({
+            id: tu.id,
+            type: 'function',
+            function: {
+                name: tu.name,
+                arguments: JSON.stringify(tu.input ?? {}),
+            },
+        }));
+    }
+    out.push(assistantMsg);
+}
+function buildUserContent(blocks) {
+    const hasImage = blocks.some((b) => b.type === message_types_1.ContentBlockType.Image);
+    if (!hasImage) {
+        return blocks
+            .filter((b) => b.type === message_types_1.ContentBlockType.Text)
+            .map((b) => b.text)
+            .join('\n');
+    }
+    const parts = [];
+    for (const b of blocks) {
+        if (b.type === message_types_1.ContentBlockType.Image) {
+            const img = b;
+            parts.push({
+                type: 'image_url',
+                image_url: {
+                    url: `data:${img.source.media_type};base64,${img.source.data}`,
+                },
+            });
+        }
+        else if (b.type === message_types_1.ContentBlockType.Text) {
+            parts.push({ type: 'text', text: b.text });
+        }
+    }
+    return parts;
+}
+function buildTools(tools) {
+    return tools.map((t) => ({
+        type: 'function',
+        function: {
+            name: t.name,
+            description: t.description,
+            parameters: {
+                type: t.input_schema.type,
+                properties: t.input_schema.properties,
+                required: t.input_schema.required,
+            },
+        },
+    }));
+}
+function parseMessage(message) {
+    const blocks = [];
+    if (message.content && typeof message.content === 'string') {
+        blocks.push({
+            type: message_types_1.ContentBlockType.Text,
+            text: message.content,
+        });
+    }
+    if (message.tool_calls?.length) {
+        for (const call of message.tool_calls) {
+            if (call.type !== 'function')
+                continue;
+            let input = {};
+            try {
+                input = call.function.arguments
+                    ? JSON.parse(call.function.arguments)
+                    : {};
+            }
+            catch {
+                input = { _raw_arguments: call.function.arguments };
+            }
+            blocks.push({
+                type: message_types_1.ContentBlockType.ToolUse,
+                id: call.id,
+                name: call.function.name,
+                input,
+            });
+        }
+    }
+    if (blocks.length === 0) {
+        blocks.push({ type: message_types_1.ContentBlockType.Text, text: '' });
+    }
+    return blocks;
+}
+//# sourceMappingURL=openai-compatible.helper.js.map

package/dist/llm/openai-compatible/openai-compatible.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-compatible.helper.js","sourceRoot":"","sources":["../../../src/llm/openai-compatible/openai-compatible.helper.ts"],"names":[],"mappings":"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"}

package/dist/llm/proxy/proxy.provider.d.ts

@@ -0,0 +1,9 @@
+import { ConfigService } from '@nestjs/config';
+import { ILlmProvider, LlmMessage, LlmResponse } from '../llm.interface';
+import { ToolDefinition } from '../../common/types/tool.types';
+export declare class ProxyProvider implements ILlmProvider {
+    private readonly configService;
+    private readonly logger;
+    constructor(configService: ConfigService);
+    generateResponse(_systemPrompt: string, _messages: LlmMessage[], _tools: ToolDefinition[], _signal?: AbortSignal): Promise<LlmResponse>;
+}

package/dist/llm/proxy/proxy.provider.js

@@ -0,0 +1,35 @@
+"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 ProxyProvider_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProxyProvider = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+let ProxyProvider = ProxyProvider_1 = class ProxyProvider {
+    configService;
+    logger = new common_1.Logger(ProxyProvider_1.name);
+    constructor(configService) {
+        this.configService = configService;
+        const baseUrl = this.configService.get('HARUBASHI_PROXY_BASE_URL');
+        if (!baseUrl) {
+            this.logger.warn('HARUBASHI_PROXY_BASE_URL is not set.');
+        }
+    }
+    async generateResponse(_systemPrompt, _messages, _tools, _signal) {
+        throw new common_1.NotImplementedException('ProxyProvider.generateResponse() will be implemented later');
+    }
+};
+exports.ProxyProvider = ProxyProvider;
+exports.ProxyProvider = ProxyProvider = ProxyProvider_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], ProxyProvider);
+//# sourceMappingURL=proxy.provider.js.map

package/dist/llm/proxy/proxy.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.provider.js","sourceRoot":"","sources":["../../../src/llm/proxy/proxy.provider.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAA6E;AAC7E,2CAA+C;AAkBxC,IAAM,aAAa,qBAAnB,MAAM,aAAa;IAGK;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,eAAa,CAAC,IAAI,CAAC,CAAC;IAEzD,YAA6B,aAA4B;QAA5B,kBAAa,GAAb,aAAa,CAAe;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAS,0BAA0B,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,aAAqB,EACrB,SAAuB,EACvB,MAAwB,EACxB,OAAqB;QAGrB,MAAM,IAAI,gCAAuB,CAC/B,4DAA4D,CAC7D,CAAC;IACJ,CAAC;CACF,CAAA;AArBY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;qCAIiC,sBAAa;GAH9C,aAAa,CAqBzB"}

package/dist/main.d.ts

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

package/dist/main.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@nestjs/core");
+const common_1 = require("@nestjs/common");
+const app_module_1 = require("./app.module");
+async function bootstrap() {
+    const logger = new common_1.Logger('Harubashi');
+    const app = await core_1.NestFactory.create(app_module_1.AppModule);
+    const port = process.env.PORT || 3000;
+    await app.listen(port);
+    logger.log(`Harubashi daemon running on port ${port}`);
+}
+bootstrap();
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;AAAA,uCAA2C;AAC3C,2CAAwC;AACxC,6CAAyC;AAEzC,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,WAAW,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,MAAM,kBAAW,CAAC,MAAM,CAAC,sBAAS,CAAC,CAAC;IAEhD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC;IACtC,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvB,MAAM,CAAC,GAAG,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,EAAE,CAAC"}

package/dist/prisma/prisma.module.d.ts

@@ -0,0 +1,2 @@
+export declare class PrismaModule {
+}

package/dist/prisma/prisma.module.js

@@ -0,0 +1,22 @@
+"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.PrismaModule = void 0;
+const common_1 = require("@nestjs/common");
+const prisma_service_1 = require("./prisma.service");
+let PrismaModule = class PrismaModule {
+};
+exports.PrismaModule = PrismaModule;
+exports.PrismaModule = PrismaModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [prisma_service_1.PrismaService],
+        exports: [prisma_service_1.PrismaService],
+    })
+], PrismaModule);
+//# sourceMappingURL=prisma.module.js.map

package/dist/prisma/prisma.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.module.js","sourceRoot":"","sources":["../../src/prisma/prisma.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,qDAAiD;AAO1C,IAAM,YAAY,GAAlB,MAAM,YAAY;CAAG,CAAA;AAAf,oCAAY;uBAAZ,YAAY;IALxB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,8BAAa,CAAC;QAC1B,OAAO,EAAE,CAAC,8BAAa,CAAC;KACzB,CAAC;GACW,YAAY,CAAG"}

package/dist/prisma/prisma.service.d.ts

@@ -0,0 +1,9 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { PrismaClient } from '@prisma/client';
+export declare class PrismaService extends PrismaClient implements OnModuleInit, OnModuleDestroy {
+    private readonly logger;
+    constructor(configService: ConfigService);
+    onModuleInit(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
+}

package/dist/prisma/prisma.service.js

@@ -0,0 +1,40 @@
+"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 PrismaService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrismaService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const client_1 = require("@prisma/client");
+let PrismaService = PrismaService_1 = class PrismaService extends client_1.PrismaClient {
+    logger = new common_1.Logger(PrismaService_1.name);
+    constructor(configService) {
+        const url = configService.get('DATABASE_URL');
+        if (!url) {
+            throw new Error('DATABASE_URL is not configured. Make sure ~/.harubashi/config.yaml is loaded.');
+        }
+        super({ datasources: { db: { url } } });
+    }
+    async onModuleInit() {
+        await this.$connect();
+        this.logger.log('Prisma connected to database');
+    }
+    async onModuleDestroy() {
+        await this.$disconnect();
+        this.logger.log('Prisma disconnected from database');
+    }
+};
+exports.PrismaService = PrismaService;
+exports.PrismaService = PrismaService = PrismaService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [config_1.ConfigService])
+], PrismaService);
+//# sourceMappingURL=prisma.service.js.map

package/dist/prisma/prisma.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prisma.service.js","sourceRoot":"","sources":["../../src/prisma/prisma.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAmF;AACnF,2CAA+C;AAC/C,2CAA8C;AAGvC,IAAM,aAAa,qBAAnB,MAAM,aACX,SAAQ,qBAAY;IAGH,MAAM,GAAG,IAAI,eAAM,CAAC,eAAa,CAAC,IAAI,CAAC,CAAC;IAEzD,YAAY,aAA4B;QACtC,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAS,cAAc,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;CACF,CAAA;AAzBY,sCAAa;wBAAb,aAAa;IADzB,IAAA,mBAAU,GAAE;qCAOgB,sBAAa;GAN7B,aAAa,CAyBzB"}

package/dist/sessions/sessions.module.d.ts

@@ -0,0 +1,2 @@
+export declare class SessionsModule {
+}

package/dist/sessions/sessions.module.js

@@ -0,0 +1,23 @@
+"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.SessionsModule = void 0;
+const common_1 = require("@nestjs/common");
+const prisma_module_1 = require("../prisma/prisma.module");
+const sessions_service_1 = require("./sessions.service");
+let SessionsModule = class SessionsModule {
+};
+exports.SessionsModule = SessionsModule;
+exports.SessionsModule = SessionsModule = __decorate([
+    (0, common_1.Module)({
+        imports: [prisma_module_1.PrismaModule],
+        providers: [sessions_service_1.SessionsService],
+        exports: [sessions_service_1.SessionsService],
+    })
+], SessionsModule);
+//# sourceMappingURL=sessions.module.js.map

package/dist/sessions/sessions.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.module.js","sourceRoot":"","sources":["../../src/sessions/sessions.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,2DAAuD;AACvD,yDAAqD;AAO9C,IAAM,cAAc,GAApB,MAAM,cAAc;CAAG,CAAA;AAAjB,wCAAc;yBAAd,cAAc;IAL1B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,4BAAY,CAAC;QACvB,SAAS,EAAE,CAAC,kCAAe,CAAC;QAC5B,OAAO,EAAE,CAAC,kCAAe,CAAC;KAC3B,CAAC;GACW,cAAc,CAAG"}

package/dist/sessions/sessions.service.d.ts

@@ -0,0 +1,21 @@
+import { ChatSession } from '@prisma/client';
+import { PrismaService } from '../prisma/prisma.service';
+export interface SessionSummary {
+    id: string;
+    title: string | null;
+    updatedAt: Date;
+}
+export declare class SessionsService {
+    private readonly prisma;
+    private readonly logger;
+    constructor(prisma: PrismaService);
+    ensureUser(id: string, name?: string): Promise<void>;
+    ensureDefaultUser(): Promise<void>;
+    ensureSession(id: string, userId: string, title?: string): Promise<ChatSession>;
+    ensureDefaultSession(): Promise<ChatSession>;
+    listSessions(userId: string): Promise<SessionSummary[]>;
+    getSession(id: string): Promise<ChatSession | null>;
+    switchOrCreate(userId: string, name: string): Promise<ChatSession>;
+    getPairedTelegramId(): Promise<string | null>;
+    setTelegramPairing(telegramId: string): Promise<void>;
+}

package/dist/sessions/sessions.service.js

@@ -0,0 +1,82 @@
+"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 SessionsService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionsService = void 0;
+const common_1 = require("@nestjs/common");
+const prisma_service_1 = require("../prisma/prisma.service");
+const constants_1 = require("../common/constants");
+let SessionsService = SessionsService_1 = class SessionsService {
+    prisma;
+    logger = new common_1.Logger(SessionsService_1.name);
+    constructor(prisma) {
+        this.prisma = prisma;
+    }
+    async ensureUser(id, name) {
+        await this.prisma.user.upsert({
+            where: { id },
+            update: {},
+            create: {
+                id,
+                name: name ?? null,
+            },
+        });
+    }
+    async ensureDefaultUser() {
+        return this.ensureUser(constants_1.DEFAULT_USER_ID, constants_1.DEFAULT_USER_NAME);
+    }
+    async ensureSession(id, userId, title) {
+        return this.prisma.chatSession.upsert({
+            where: { id },
+            update: { userId },
+            create: {
+                id,
+                userId,
+                title: title ?? id,
+                status: 'ACTIVE',
+            },
+        });
+    }
+    async ensureDefaultSession() {
+        return this.ensureSession(constants_1.DEFAULT_SESSION_ID, constants_1.DEFAULT_USER_ID);
+    }
+    async listSessions(userId) {
+        return this.prisma.chatSession.findMany({
+            where: { userId },
+            select: { id: true, title: true, updatedAt: true },
+            orderBy: { updatedAt: 'desc' },
+        });
+    }
+    async getSession(id) {
+        return this.prisma.chatSession.findUnique({ where: { id } });
+    }
+    async switchOrCreate(userId, name) {
+        return this.ensureSession(name, userId);
+    }
+    async getPairedTelegramId() {
+        const user = await this.prisma.user.findUnique({
+            where: { id: constants_1.DEFAULT_USER_ID },
+        });
+        return user?.telegramId ?? null;
+    }
+    async setTelegramPairing(telegramId) {
+        await this.prisma.user.update({
+            where: { id: constants_1.DEFAULT_USER_ID },
+            data: { telegramId },
+        });
+    }
+};
+exports.SessionsService = SessionsService;
+exports.SessionsService = SessionsService = SessionsService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [prisma_service_1.PrismaService])
+], SessionsService);
+//# sourceMappingURL=sessions.service.js.map

package/dist/sessions/sessions.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.service.js","sourceRoot":"","sources":["../../src/sessions/sessions.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;AAAA,2CAAoD;AAEpD,6DAAyD;AACzD,mDAI6B;AAkBtB,IAAM,eAAe,uBAArB,MAAM,eAAe;IAGG;IAFZ,MAAM,GAAG,IAAI,eAAM,CAAC,iBAAe,CAAC,IAAI,CAAC,CAAC;IAE3D,YAA6B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAQtD,KAAK,CAAC,UAAU,CAAC,EAAU,EAAE,IAAa;QACxC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,KAAK,EAAE,EAAE,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,MAAM,EAAE;gBACN,EAAE;gBACF,IAAI,EAAE,IAAI,IAAI,IAAI;aACnB;SACF,CAAC,CAAC;IACL,CAAC;IAMD,KAAK,CAAC,iBAAiB;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,2BAAe,EAAE,6BAAiB,CAAC,CAAC;IAC7D,CAAC;IASD,KAAK,CAAC,aAAa,CACjB,EAAU,EACV,MAAc,EACd,KAAc;QAEd,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;YACpC,KAAK,EAAE,EAAE,EAAE,EAAE;YACb,MAAM,EAAE,EAAE,MAAM,EAAE;YAClB,MAAM,EAAE;gBACN,EAAE;gBACF,MAAM;gBACN,KAAK,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,EAAE,QAAQ;aACjB;SACF,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,CAAC,oBAAoB;QACxB,OAAO,IAAI,CAAC,aAAa,CAAC,8BAAkB,EAAE,2BAAe,CAAC,CAAC;IACjE,CAAC;IAKD,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC;YACtC,KAAK,EAAE,EAAE,MAAM,EAAE;YACjB,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;YAClD,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;IACL,CAAC;IAKD,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IAOD,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,IAAY;QAC/C,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAOD,KAAK,CAAC,mBAAmB;QACvB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;YAC7C,KAAK,EAAE,EAAE,EAAE,EAAE,2BAAe,EAAE;SAC/B,CAAC,CAAC;QACH,OAAO,IAAI,EAAE,UAAU,IAAI,IAAI,CAAC;IAClC,CAAC;IAKD,KAAK,CAAC,kBAAkB,CAAC,UAAkB;QACzC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,KAAK,EAAE,EAAE,EAAE,EAAE,2BAAe,EAAE;YAC9B,IAAI,EAAE,EAAE,UAAU,EAAE;SACrB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA3GY,0CAAe;0BAAf,eAAe;IAD3B,IAAA,mBAAU,GAAE;qCAI0B,8BAAa;GAHvC,eAAe,CA2G3B"}

package/dist/skills/definitions/directory_explorer.md

@@ -0,0 +1,69 @@
+---
+name: directory_explorer
+description: Guidance for safely exploring the filesystem of a project using `system_execute_command`. No standalone tool — read this before using `dir` / `ls` / `find` to avoid expensive recursion into dependency or build directories.
+---
+
+## When to use this guidance
+
+Whenever the user asks you to explore a codebase, locate a file, summarize a project, or answer a question that requires inspecting the file tree. The actual listing is performed via `system_execute_command`; this guidance teaches you **how** to do it efficiently and safely.
+
+## Cross-platform listing
+
+The host OS determines the right command:
+
+- **POSIX (Linux, macOS)**: `ls -la <path>` for a single-level listing with hidden files and metadata.
+- **Windows / cmd.exe**: `dir <path>` for the equivalent.
+- **Windows / PowerShell**: `Get-ChildItem -Force <path>` or its alias `gci -Force <path>`.
+
+If you do not yet know the OS, run `uname -a` (POSIX) or `ver` (Windows) once at the start of the session.
+
+## Forbidden directories — never recurse into these
+
+The following directories are large, mostly auto-generated, and almost never relevant to user questions. **Always exclude them** when doing recursive listings or searches:
+
+- `node_modules`
+- `.git`
+- `.svn`, `.hg`
+- `dist`, `build`, `out`, `bin`, `obj`
+- `target` (Rust / Java)
+- `.cache`, `.parcel-cache`, `.turbo`, `.next`, `.nuxt`
+- `.venv`, `venv`, `env`, `__pycache__`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`
+- `vendor` (Go / PHP)
+- `coverage`, `.nyc_output`
+- `.idea`, `.vscode`, `.vs`
+
+If you must recurse, prefer tools with built-in ignore semantics:
+
+- `git ls-files` — respects `.gitignore` automatically.
+- `rg --files` (ripgrep) — respects `.gitignore` and is fast.
+- `find . -type f -not -path '*/node_modules/*' -not -path '*/.git/*'` — explicit excludes.
+
+## Strategy: shallow first, deep only when targeted
+
+1. **Start with the project root** at depth 1. List it with `ls -la` / `dir`. Form a mental model of the top-level layout (`src/`, `package.json`, `README.md`, etc.).
+2. **Drill down by intent**, one directory at a time. Do not run `ls -laR` or `dir /s` on an unknown tree — you will drown in `node_modules` output and waste tokens.
+3. **For "find the file" tasks**, prefer `git ls-files | grep <pattern>` or `rg --files | rg <pattern>`.
+4. **For "find the symbol" tasks**, prefer `rg <symbol>` over reading every file.
+
+## When in doubt
+
+If the user asks you to "scan the entire project" without context, **ask for clarification** before running an unbounded command. Mention that you can target a subtree (e.g. `src/`) instead, which is usually what they meant.
+
+## Examples
+
+```
+# Good — shallow listing of project root
+ls -la
+
+# Good — find all TypeScript files tracked by git
+git ls-files '*.ts'
+
+# Good — search for a symbol across source files
+rg 'class AgentProcessorService'
+
+# Bad — recursive listing that will dump node_modules
+ls -laR
+
+# Bad — find without excludes on a JS project
+find . -name '*.js'
+```

package/dist/skills/definitions/execute_command.md

@@ -0,0 +1,27 @@
+---
+name: system_execute_command
+description: Execute a shell command on the host operating system and return its stdout and stderr output.
+input_schema:
+  type: object
+  properties:
+    command:
+      type: string
+      description: The shell command to execute
+    workdir:
+      type: string
+      description: Working directory for command execution. Defaults to the process cwd if omitted.
+    timeout:
+      type: integer
+      description: Maximum execution time in milliseconds. Defaults to 30000.
+  required:
+    - command
+---
+
+## Usage Guidelines
+
+- Prefer simple, single-purpose commands over complex pipelines.
+- Always specify `workdir` when operating on a specific project or directory.
+- For long-running processes, set an appropriate `timeout`.
+- Never execute destructive commands (rm -rf, format, etc.) without explicit user confirmation.
+- When chaining commands, prefer `&&` over `;` to fail fast on errors.
+- Capture both stdout and stderr — errors are as valuable as output.