openloops 0.1.8 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openloops",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Framework to build AI Agents",
   "author": {
     "name": "Jose Barcos",
@@ -40,7 +40,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --minify && tsc --emitDeclarationOnly",
+    "build": "tsup",
     "prepublishOnly": "yarn build",
     "check-size": "npm pack --dry-run",
     "release": "npm version patch && npm publish --access public"

package/dist/common/clients/index.d.ts

@@ -1,3 +0,0 @@
-export * from './llm-client';
-export * from './sentry-client';
-export * from './serper-client';

package/dist/common/clients/llm-client.d.ts

@@ -1,30 +0,0 @@
-import 'reflect-metadata';
-import type { KnownProvider, Message, AssistantMessage } from '@mariozechner/pi-ai';
-import { CurrentUser } from '@services/app/core';
-export declare class LLMClient {
-    private readonly logger;
-    private readonly langfuse;
-    constructor();
-    complete(params: LLMCompletionParams): Promise<AssistantMessage>;
-    private postResponse;
-    private formatContentForLog;
-    private formatMessagesForLog;
-}
-export interface LLMCompletionParams {
-    taskName: string;
-    sessionId: string;
-    answerId: string;
-    currentUser?: CurrentUser;
-    systemPrompt?: string;
-    messages: Message[];
-    provider?: KnownProvider;
-    modelName?: string;
-    temperature?: number;
-}
-export interface LLMPostResponseParams {
-    taskName: string;
-    sessionId: string;
-    answerId: string;
-    currentUser?: CurrentUser;
-    response: AssistantMessage;
-}

package/dist/common/clients/sentry-client.d.ts

@@ -1,10 +0,0 @@
-export declare class SentryClient {
-    private static instance;
-    private readonly enabled;
-    static getInstance(): SentryClient;
-    private constructor();
-    captureError(error: unknown, contextData?: Record<string, any>): Promise<void>;
-    setUser(userId: string): void;
-    private resolveDsn;
-}
-export declare const sentryClient: SentryClient;

package/dist/common/clients/serper-client.d.ts

@@ -1,66 +0,0 @@
-export declare class SerperClient {
-    private readonly logger;
-    searchOnGoogle(params: SerperSearchParams): Promise<SerperSearchResponse | undefined>;
-}
-export interface SerperSearchParams {
-    query: string;
-    type?: 'search' | 'news';
-    page?: number;
-    num?: number;
-    countryCode?: string;
-    languageCode?: string;
-}
-export interface SerperOrganicResult {
-    title: string;
-    link: string;
-    snippet: string;
-    position: number;
-    sitelinks?: Array<{
-        title: string;
-        link: string;
-    }>;
-    date?: string;
-    attributes?: Record<string, string>;
-}
-export interface SerperAnswerBox {
-    title?: string;
-    answer?: string;
-    snippet?: string;
-    source?: string;
-    sourceLink?: string;
-    temperature?: string;
-    unit?: string;
-    weather?: string;
-    humidity?: string;
-    wind?: string;
-}
-export interface SerperKnowledgeGraph {
-    title: string;
-    type?: string;
-    website?: string;
-    imageUrl?: string;
-    description?: string;
-    descriptionSource?: string;
-    descriptionLink?: string;
-    attributes?: Record<string, string>;
-}
-export interface SerperRelatedSearch {
-    query: string;
-}
-export interface SerperSearchResponse {
-    searchParameters: {
-        q: string;
-        gl?: string;
-        hl?: string;
-        type: string;
-        engine: string;
-        num?: number;
-        page?: number;
-    };
-    news?: SerperOrganicResult[];
-    organic?: SerperOrganicResult[];
-    answerBox?: SerperAnswerBox;
-    knowledgeGraph?: SerperKnowledgeGraph;
-    relatedSearches?: SerperRelatedSearch[];
-    credits?: number;
-}

package/dist/common/core/base.app.d.ts

@@ -1,12 +0,0 @@
-import { Logger } from '@common/logger';
-import { HttpError, HttpErrorProps } from '@common/error';
-import { CurrentSessionProps } from '@services/app/core/current-session';
-export declare abstract class BaseApp {
-    logger: Logger;
-    secretManager: import("@common/utils/secret-manager").SecretManager;
-    reportError: (error: Error | HttpError | string, details?: object) => Promise<void>;
-    onCatch(error: Error): Promise<void>;
-    throwHttpError(error: HttpErrorProps): void;
-    throwError401(currentSession?: CurrentSessionProps): void;
-    throwError403(currentSession?: CurrentSessionProps): void;
-}

package/dist/common/core/base.entity.d.ts

@@ -1,55 +0,0 @@
-import 'reflect-metadata';
-import { ObjectId } from 'bson';
-import { CurrentUser } from '@services/app/core';
-export interface BaseEntityProps {
-    _id?: string | ObjectId;
-    __v?: number;
-    ownerId?: string | ObjectId;
-    createdAt?: string | Date;
-    createdBy?: string | ObjectId;
-    updatedAt?: string | Date;
-    updatedBy?: string | ObjectId;
-    deletedAt?: string | Date;
-    deletedBy?: string | ObjectId;
-    deletedReason?: string;
-    archivedAt?: string | Date;
-    archivedBy?: string | ObjectId;
-    sharedWith?: string[] | ObjectId[];
-}
-export interface Document extends BaseEntityProps {
-    toUnset?: Record<string, unknown>;
-}
-export declare class BaseEntity {
-    _id?: ObjectId;
-    __v?: number;
-    ownerId?: ObjectId;
-    createdAt?: Date;
-    createdBy?: ObjectId;
-    updatedAt?: Date;
-    updatedBy?: ObjectId;
-    deletedAt?: Date;
-    deletedBy?: ObjectId;
-    deletedReason?: string;
-    archivedAt?: Date;
-    archivedBy?: ObjectId;
-    sharedWith?: ObjectId[];
-    private toUnset?;
-    static toObjectId(id?: string | ObjectId): ObjectId | undefined;
-    private static toDate;
-    private static toNumber;
-    static clean(json: any): any;
-    constructor(props: BaseEntityProps);
-    toJSON(): Document;
-    setDefaults(): void;
-    setId(id: string | ObjectId): void;
-    setOwner(currentUser?: CurrentUser): void;
-    setCreatedBy(currentUser?: CurrentUser): void;
-    setUpdatedBy(currentUser?: CurrentUser): void;
-    setDeletedBy(currentUser?: CurrentUser): void;
-    setArchivedBy(currentUser?: CurrentUser): void;
-    toDocument(): Document;
-    toFlatDocument(): Document;
-    stringify(): string;
-    unset(fields: (keyof this)[]): {} | undefined;
-    private sanitize;
-}

package/dist/common/core/base.use-case.d.ts

@@ -1,15 +0,0 @@
-import { CurrentUser, CurrentSession } from '@services/app/core';
-import { HttpError } from '@common/error';
-import { BaseApp } from './base.app';
-export interface BaseUseCaseParams {
-    currentUser?: CurrentUser;
-    currentSession?: CurrentSession;
-}
-export interface BaseUseCaseOutput {
-    message?: string;
-    data?: any;
-    error?: any;
-}
-export declare abstract class BaseUseCase<TReq, TRes> extends BaseApp {
-    abstract execute(params?: TReq): Promise<TRes | HttpError>;
-}

package/dist/common/core/index.d.ts

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

package/dist/common/core/utils/delete-empty-fields.d.ts

@@ -1 +0,0 @@
-export declare function deleteEmptyFields(object: any): any;

package/dist/common/core/utils/flatten-object.d.ts

@@ -1 +0,0 @@
-export declare function flattenObject(obj: any, parentKey?: string, result?: {}): any;

package/dist/common/core/utils/index.d.ts

@@ -1,3 +0,0 @@
-export * from './delete-empty-fields';
-export * from './is-plain-object';
-export * from './flatten-object';

package/dist/common/core/utils/is-plain-object.d.ts

@@ -1 +0,0 @@
-export declare function isPlainObject(value: any): boolean;

package/dist/common/decorators/admin-only/admin-only.d.ts

@@ -1,2 +0,0 @@
-export declare function AdminOnly(target: any, propertyKey: string): void;
-export declare function filterAdminOnlyProperties(object: Record<string, any>): Record<string, any>;

package/dist/common/decorators/admin-only/index.d.ts

@@ -1 +0,0 @@
-export * from './admin-only';

package/dist/common/decorators/index.d.ts

@@ -1,3 +0,0 @@
-export * from './mask-in-logs';
-export * from './admin-only';
-export * from './owner-only';

package/dist/common/decorators/mask-in-logs/index.d.ts

@@ -1 +0,0 @@
-export * from './mask-in-logs';

package/dist/common/decorators/mask-in-logs/mask-in-logs.d.ts

@@ -1,2 +0,0 @@
-export declare function MaskInLogs(target: any, propertyKey: string): void;
-export declare function handleMaskInLogs(object: Record<string, any>): Record<string, any>;

package/dist/common/decorators/owner-only/index.d.ts

@@ -1 +0,0 @@
-export * from './owner-only';

package/dist/common/decorators/owner-only/owner-only.d.ts

@@ -1,2 +0,0 @@
-export declare function OwnerOnly(target: any, propertyKey: string): void;
-export declare function filterOwnerOnlyProperties(object: Record<string, any>): Record<string, any>;

package/dist/common/error/http-error.d.ts

@@ -1,11 +0,0 @@
-export interface HttpErrorProps {
-    statusCode: number;
-    errorMessage: string;
-    errorDetails?: any;
-}
-export declare class HttpError {
-    readonly statusCode: number;
-    readonly errorMessage: string;
-    readonly errorDetails?: any;
-    constructor(props: HttpErrorProps);
-}

package/dist/common/error/index.d.ts

@@ -1,2 +0,0 @@
-export * from './reportError';
-export * from './http-error';

package/dist/common/error/reportError.d.ts

@@ -1,2 +0,0 @@
-import { HttpError } from './http-error';
-export declare const reportError: (error: Error | HttpError | string, details?: object) => Promise<void>;

package/dist/common/helpers/extract-json-from-text.d.ts

@@ -1 +0,0 @@
-export declare function extractJSON(plainText?: string): Partial<Record<string, any>>;

package/dist/common/helpers/index.d.ts

@@ -1,2 +0,0 @@
-export * from './extract-json-from-text';
-export * from './sanitize-string';

package/dist/common/helpers/sanitize-string.d.ts

@@ -1 +0,0 @@
-export declare function sanitizeString(input?: string): string | undefined;

package/dist/common/logger/index.d.ts

@@ -1 +0,0 @@
-export * from './pino';

package/dist/common/logger/pino.d.ts

@@ -1,12 +0,0 @@
-import 'dotenv/config';
-export declare class Logger {
-    private IS_LOCAL;
-    private logger;
-    private log;
-    info(obj?: any, msg?: string): void;
-    warn(obj?: any, msg?: string): void;
-    debug(obj?: any, msg?: string): void;
-    error(obj?: any, msg?: string): void;
-    fatal(obj?: any, msg?: string): void;
-}
-export declare const logger: Logger;

package/dist/common/repositories/index.d.ts

@@ -1,2 +0,0 @@
-export * from './mongo-db.repository';
-export * from './mongo-db.client';

package/dist/common/repositories/mongo-db.client.d.ts

@@ -1,11 +0,0 @@
-import { Db, DbOptions, MongoClientOptions } from 'mongodb';
-export declare class MongoClient {
-    private client;
-    private logger;
-    private isConnected;
-    constructor(uri: string, options?: MongoClientOptions);
-    connect(): Promise<void>;
-    close(force?: boolean): Promise<void>;
-    db(dbName?: string, options?: DbOptions): Promise<Db>;
-}
-export declare function getMongoDBClient(envVarName?: string): MongoClient;

package/dist/common/repositories/mongo-db.repository.d.ts

@@ -1,87 +0,0 @@
-import { ObjectId } from 'mongodb';
-export declare class MongoRepository<T> {
-    private readonly database;
-    private readonly collection;
-    private readonly dbClient;
-    private readonly _where;
-    private readonly report;
-    constructor(props: {
-        database: string;
-        collection: string;
-        envvar?: string;
-    });
-    parseId(id: string | undefined): ObjectId | undefined;
-    cleanInput(value: string): string;
-    private clampLimit;
-    findOne({ where, select, options }: QueryParams<T>): Promise<T | null>;
-    findMany({ where, select, options }: QueryParams<T>): Promise<T[]>;
-    findAll({ where, select }: QueryParams<T>): Promise<T[]>;
-    createOne({ payload }: CommandParams<T>): Promise<ObjectId>;
-    createMany({ payload }: CommandParams<T>): Promise<CreateManyResponse>;
-    updateOne({ where, payload, options }: CommandParams<T>): Promise<T>;
-    updateMany({ where, payload }: CommandParams<T>): Promise<number>;
-    deleteOne({ where }: CommandParams<T>): Promise<number>;
-    deleteMany({ where }: CommandParams<T>): Promise<number>;
-    count({ where, options }: QueryParams<T>): Promise<number>;
-    aggregate(pipeline: PipelineStage[]): Promise<T[]>;
-    distinct(field: string, where?: Record<string, unknown>): Promise<T[]>;
-}
-export type PipelineStage = {
-    $addFields: Record<string, unknown>;
-} | {
-    $project: Record<string, unknown>;
-} | {
-    $lookup: Record<string, unknown>;
-} | {
-    $match: Record<string, unknown>;
-} | {
-    $facet: Record<string, unknown>;
-} | {
-    $group: Record<string, unknown>;
-} | {
-    $merge: Record<string, unknown>;
-} | {
-    $sort: Record<string, unknown>;
-} | {
-    $set: Record<string, unknown>;
-} | {
-    $sample: {
-        size: number;
-    };
-} | {
-    $unwind: string;
-} | {
-    $count: string;
-} | {
-    $limit: number;
-} | {
-    $skip: number;
-} | {
-    $out: string;
-};
-type CreateManyResponse = {
-    [key: number]: ObjectId;
-};
-export interface QueryParams<T> {
-    where?: Partial<T>;
-    select?: {
-        [K in keyof T]?: 1 | 0;
-    };
-    options?: QueryOptions;
-}
-export interface QueryOptions {
-    page?: number;
-    limit?: number;
-    offset?: number;
-    sortBy?: {
-        [key: string]: 1 | -1;
-    };
-    aggregate?: boolean;
-    includeDeleted?: boolean;
-}
-export interface CommandParams<T> {
-    where?: Partial<T>;
-    payload?: Partial<T> | Partial<T>[];
-    options?: Record<string, unknown>;
-}
-export {};

package/dist/common/utils/secret-manager.d.ts

@@ -1,15 +0,0 @@
-import 'dotenv/config';
-export declare class SecretManager {
-    private static instance;
-    private cache;
-    private cryptr;
-    static getInstance(): SecretManager;
-    static encrypt(value: string): string;
-    private constructor();
-    get(key: string): string;
-    private getEnvVar;
-    private decryptEnvVar;
-    private isStringEncrypted;
-    private logElapsed;
-}
-export declare const secretManager: SecretManager;

package/dist/services/agent/core/agent-loop.d.ts

@@ -1,38 +0,0 @@
-import { CurrentUser, CurrentSession } from '@services/app/core';
-import { Logger } from '@common/logger';
-import { Chat } from '@services/agent/modules/chats/entities/chat.entity';
-import { AgentTask } from '@services/agent/modules/chats/entities/agent-task.entity';
-import { Tool, BaseParams } from '@services/agent/tools/tool';
-import { SkillRunOptions } from '@services/agent/skills/skill';
-import { WeightedKeyword, ScoredTool } from '@services/agent/utils/rank-tools-by-keywords';
-export interface RunContext {
-    task?: AgentTask;
-    chat: Chat;
-    currentUser: CurrentUser;
-    currentSession?: CurrentSession;
-    currentMessage: string;
-    answerId: string;
-    tools: Tool[];
-    searchTools: (keywords: WeightedKeyword[], opts?: {
-        page?: number;
-        limit?: number;
-    }) => ScoredTool[];
-    baseParams: BaseParams;
-    skillParams: Pick<SkillRunOptions, 'sessionId' | 'answerId' | 'userMessage' | 'currentUser' | 'currentSession' | 'chat'>;
-    reply: (content: string) => void;
-    setNextNode: (node?: string | AgentLoopNode) => void;
-    logger: Logger;
-}
-export type AgentLoopNode = (ctx: RunContext) => Promise<void>;
-export interface Author {
-    name: string;
-    email: string;
-    website?: string;
-}
-export declare abstract class AgentLoop {
-    abstract get initialNode(): string | AgentLoopNode;
-    abstract get nodes(): Record<string, AgentLoopNode>;
-    abstract get name(): string;
-    abstract get version(): string;
-    abstract get author(): Author;
-}

package/dist/services/agent/core/agent-state.d.ts

@@ -1,42 +0,0 @@
-export declare enum AgentStatus {
-    IDLE = "idle",
-    FAILED = "failed",
-    PROCESSING = "processing",
-    AWAITING_USER_INPUT = "awaiting_user_input",
-    AWAITING_USER_CONFIRMATION = "awaiting_user_confirmation"
-}
-export interface AgentError {
-    code: string;
-    message: string;
-    isRetryable: boolean;
-    timestamp: Date;
-}
-type CurrentActivity = 'running' | 'stopped' | (string & {});
-export interface AgentStateProps {
-    status?: AgentStatus;
-    language?: string;
-    lastError?: AgentError;
-    activeTaskId?: string;
-    stopRequested?: boolean;
-    currentActivity?: CurrentActivity;
-}
-export declare class AgentState {
-    status?: AgentStatus | undefined;
-    language?: string | undefined;
-    lastError?: AgentError | undefined;
-    activeTaskId?: string | undefined;
-    stopRequested?: boolean | undefined;
-    currentActivity?: CurrentActivity | undefined;
-    static fromJSON(props?: AgentStateProps): AgentState;
-    constructor(status?: AgentStatus | undefined, language?: string | undefined, lastError?: AgentError | undefined, activeTaskId?: string | undefined, stopRequested?: boolean | undefined, currentActivity?: CurrentActivity | undefined);
-    toJSON(): AgentStateProps;
-    setLanguage(language?: string): void;
-    setCurrentActivity(currentActivity: CurrentActivity): void;
-    setStatus(status: AgentStatus): void;
-    setActiveTaskId(taskId?: string): void;
-    setLastError(lastError?: AgentError): void;
-    setStopRequested(stopRequested?: boolean): void;
-    interruptExecution(): void;
-    cleanContext(): void;
-}
-export {};

package/dist/services/agent/core/agent.d.ts

@@ -1,70 +0,0 @@
-import 'reflect-metadata';
-import { CurrentUser, CurrentSession } from '@services/app/core';
-import { McpServer, McpServerProps } from '@services/agent/modules/mcp-servers/entities';
-import { Params as UsageParams, Output as UsageOutput } from '@services/agent/modules/llmcalls/lambdas/get-llm-usage';
-import { QueryOptions } from '@common/repositories';
-import { Chat, ChatProps } from '@services/agent/modules/chats/entities/chat.entity';
-import { Tool } from '@services/agent/tools/tool';
-import { AgentLoop } from './agent-loop';
-export declare const AGENT_ERROR_CODES: {
-    readonly NODE_NOT_FOUND: "AGENT_NODE_NOT_FOUND";
-};
-export interface AgentOptions {
-    loop: AgentLoop;
-    tools?: Tool[];
-}
-interface Input {
-    message: string;
-    chatId?: string;
-    messageId?: string;
-    isPrivateSession?: boolean;
-}
-type HookType = 'pre_execution' | 'post_execution';
-export declare class Agent {
-    private readonly updateChatUseCase;
-    private readonly chatRepository;
-    private readonly logger;
-    private readonly _loop;
-    private _tools;
-    private _mcps;
-    private _preHooks;
-    private _postHooks;
-    private currentChat;
-    private currentUser?;
-    private currentSession?;
-    private currentMessage;
-    private answerId;
-    private stopLoop;
-    private stopRequested;
-    private pendingNextNode?;
-    static getChat(chatId: string): Promise<ChatProps | null>;
-    static interruptExecution(chatId: string, currentUser: CurrentUser): Promise<void>;
-    static createChatSession(currentUser: CurrentUser, loop?: AgentLoop): Promise<Chat>;
-    static listUserChats(options: QueryOptions, currentUser: CurrentUser): Promise<ChatProps[] | null>;
-    static getLLMUsage(filters: UsageParams['filters'], currentUser: CurrentUser): Promise<UsageOutput['data']>;
-    static listUserMcpServers(options: QueryOptions, currentUser: CurrentUser): Promise<McpServerProps[] | null>;
-    static createMcpServer(payload: McpServerProps, currentUser: CurrentUser): Promise<McpServerProps>;
-    constructor(agentOptions: AgentOptions);
-    get tools(): Tool[];
-    get mcps(): McpServer[];
-    get notifyOnCompletion(): boolean | undefined;
-    get lastAssistantAnswer(): string | undefined;
-    run(input: Input, currentUser: CurrentUser, currentSession?: CurrentSession): Promise<{
-        data: Chat;
-    } | undefined>;
-    stopAgent(): void;
-    addTool(tool: Tool): void;
-    addHook(type: HookType, fn: Function): void;
-    private preRunner;
-    private postRunner;
-    private loadMcpServers;
-    private disconnectMcpServers;
-    private saveChat;
-    private checkInterruptionRequest;
-    private runLoop;
-    private resetNextNode;
-    private resolveNodeName;
-    private searchTools;
-    private buildRunContext;
-}
-export {};

package/dist/services/agent/loops/plan-execute/index.d.ts

@@ -1 +0,0 @@
-export * from './plan-execute-loop';

package/dist/services/agent/loops/plan-execute/plan-execute-loop.d.ts

@@ -1,27 +0,0 @@
-import { AgentLoop, RunContext } from '@services/agent/core';
-export declare class PlanExecuteLoop extends AgentLoop {
-    get initialNode(): (ctx: RunContext) => Promise<void>;
-    get nodes(): {
-        fast_responder: (ctx: RunContext) => Promise<void>;
-        strategy_engine: (ctx: RunContext) => Promise<void>;
-        action_planner: (ctx: RunContext) => Promise<void>;
-        execution_loop: (ctx: RunContext) => Promise<void>;
-        state_observer: (ctx: RunContext) => Promise<void>;
-        final_responder: (ctx: RunContext) => Promise<void>;
-        confirmation_gate: (ctx: RunContext) => Promise<void>;
-    };
-    get name(): string;
-    get version(): string;
-    get author(): {
-        name: string;
-        email: string;
-        website: string;
-    };
-    private fastResponder;
-    private strategyEngine;
-    private actionPlanner;
-    private executionLoop;
-    private confirmationGate;
-    private executionObserver;
-    private finalResponder;
-}

package/dist/services/agent/loops/shared/index.d.ts

@@ -1 +0,0 @@
-export * from './skills';

package/dist/services/agent/loops/shared/skills/action-planner.d.ts

@@ -1,35 +0,0 @@
-import { Skill } from '../../../skills/skill';
-interface PlanStepOutput {
-    step_id: number;
-    tool_name: string;
-    arguments: Record<string, any>;
-    expected_outcome: string;
-    status: 'READY' | 'MISSING_PARAMS' | 'REQUIRES_CONFIRMATION' | 'COMPLETED' | 'FAILED';
-    is_destructive: boolean;
-    missing_fields: string[];
-    rationale: string;
-    depends_on_steps: number[];
-    output: Record<string, any>;
-}
-interface ConfirmationDetails {
-    actions: Array<{
-        step_id: number;
-        description: string;
-    }>;
-    impact_summary: string;
-    confirm_label: string;
-}
-type ResponseSchema = {
-    plan_status: 'SUCCESS' | 'MISSING_TOOLS' | 'NEEDS_CLARIFICATION' | 'NEEDS_CONFIRMATION';
-    current_step_index: number;
-    missing_tools_explanation: string;
-    user_response: string;
-    steps: PlanStepOutput[];
-    needs_clarification: boolean;
-    missing_entities: string[];
-    clarification_prompt: string;
-    confirmation_details: ConfirmationDetails | null;
-    reasoning: string;
-};
-export declare const actionPlanner: Skill<ResponseSchema>;
-export {};