@lupaflow/types 0.1.0 → 0.1.2

package/dist/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+module.exports = __toCommonJS(src_exports);
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./events\"\nexport * from \"./provider\"\nexport * from \"./tool\"\nexport * from \"./memory\"\nexport * from \"./agent\"\nexport * from \"./workflow\"\nexport * from \"./plugin\"\n"],"mappings":";;;;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,319 @@
+type EventName = "agent:start" | "agent:thinking" | "agent:response" | "agent:error" | "agent:complete" | "tool:start" | "tool:finish" | "tool:error" | "memory:update" | "memory:retrieve" | "workflow:start" | "workflow:step" | "workflow:complete" | "workflow:error" | "provider:start" | "provider:complete" | "provider:error" | "llm:token";
+interface BaseEvent {
+    id: string;
+    name: EventName;
+    timestamp: number;
+    agentId?: string;
+    runId?: string;
+}
+interface AgentStartEvent extends BaseEvent {
+    name: "agent:start";
+    config: Record<string, unknown>;
+}
+interface AgentThinkingEvent extends BaseEvent {
+    name: "agent:thinking";
+    message: string;
+}
+interface AgentResponseEvent extends BaseEvent {
+    name: "agent:response";
+    content: string;
+    tokens?: number;
+    latencyMs?: number;
+}
+interface AgentErrorEvent extends BaseEvent {
+    name: "agent:error";
+    error: string;
+    retryAttempt?: number;
+}
+interface AgentCompleteEvent extends BaseEvent {
+    name: "agent:complete";
+    totalTokens: number;
+    totalLatencyMs: number;
+    toolCalls: number;
+}
+interface ToolStartEvent extends BaseEvent {
+    name: "tool:start";
+    tool: string;
+    args: Record<string, unknown>;
+}
+interface ToolFinishEvent extends BaseEvent {
+    name: "tool:finish";
+    tool: string;
+    result: unknown;
+    durationMs: number;
+}
+interface ToolErrorEvent extends BaseEvent {
+    name: "tool:error";
+    tool: string;
+    error: string;
+}
+interface MemoryUpdateEvent extends BaseEvent {
+    name: "memory:update";
+    type: string;
+    key: string;
+}
+interface MemoryRetrieveEvent extends BaseEvent {
+    name: "memory:retrieve";
+    type: string;
+    key: string;
+    results: number;
+}
+interface WorkflowStartEvent extends BaseEvent {
+    name: "workflow:start";
+    steps: number;
+}
+interface WorkflowStepEvent extends BaseEvent {
+    name: "workflow:step";
+    step: number;
+    stepName: string;
+    status: "running" | "completed" | "failed";
+}
+interface WorkflowCompleteEvent extends BaseEvent {
+    name: "workflow:complete";
+    totalSteps: number;
+    failedSteps: number;
+    durationMs: number;
+}
+interface ProviderStartEvent extends BaseEvent {
+    name: "provider:start";
+    provider: string;
+    model: string;
+}
+interface ProviderCompleteEvent extends BaseEvent {
+    name: "provider:complete";
+    provider: string;
+    model: string;
+    tokens: number;
+    latencyMs: number;
+    cost?: number;
+}
+interface ProviderErrorEvent extends BaseEvent {
+    name: "provider:error";
+    provider: string;
+    model: string;
+    error: string;
+}
+interface LLMTokenEvent extends BaseEvent {
+    name: "llm:token";
+    tokens: number;
+    cost?: number;
+}
+type LupaEvent = AgentStartEvent | AgentThinkingEvent | AgentResponseEvent | AgentErrorEvent | AgentCompleteEvent | ToolStartEvent | ToolFinishEvent | ToolErrorEvent | MemoryUpdateEvent | MemoryRetrieveEvent | WorkflowStartEvent | WorkflowStepEvent | WorkflowCompleteEvent | ProviderStartEvent | ProviderCompleteEvent | ProviderErrorEvent | LLMTokenEvent;
+
+interface ToolParameter {
+    type: "string" | "number" | "boolean" | "array" | "object";
+    description: string;
+    required?: boolean;
+    enum?: string[];
+    items?: ToolParameter;
+    properties?: Record<string, ToolParameter>;
+}
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, ToolParameter>;
+    required?: string[];
+}
+interface Tool {
+    definition: ToolDefinition;
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}
+
+type ProviderName = "openai" | "anthropic" | "google" | "openrouter" | "groq" | "mistral" | "xai" | "ollama";
+type ModelRole = "system" | "user" | "assistant" | "tool";
+interface Message {
+    role: ModelRole;
+    content: string | null;
+    toolCallId?: string;
+    name?: string;
+    toolCalls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+interface ToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+interface ToolResult {
+    toolCallId: string;
+    name: string;
+    content: string;
+}
+interface ProviderConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+}
+interface CompletionRequest {
+    messages: Message[];
+    tools?: Tool[];
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    model?: string;
+}
+interface CompletionResponse {
+    content: string | null;
+    toolCalls: ToolCall[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    latencyMs: number;
+    finishReason: string;
+}
+type StreamChunk = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_call";
+    toolCall: ToolCall;
+} | {
+    type: "finish";
+    content: string;
+    toolCalls: ToolCall[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    finishReason: string;
+};
+
+type MemoryType = "short-term" | "long-term" | "semantic" | "session" | "user" | "project" | "vector";
+interface MemoryEntry {
+    id: string;
+    type: MemoryType;
+    key: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+    scope?: string;
+}
+interface MemoryQuery {
+    type?: MemoryType;
+    key?: string;
+    scope?: string;
+    query?: string;
+    limit?: number;
+    threshold?: number;
+}
+interface MemorySearchResult {
+    entry: MemoryEntry;
+    score: number;
+}
+
+interface Personality {
+    name?: string;
+    traits?: string[];
+    tone?: string;
+    style?: string;
+}
+interface Goal {
+    description: string;
+    priority?: number;
+    completed?: boolean;
+}
+interface Constraint {
+    description: string;
+    type?: "hard" | "soft";
+}
+interface AgentConfig {
+    id?: string;
+    name: string;
+    provider: ProviderName;
+    model?: string;
+    systemPrompt?: string;
+    personality?: Personality;
+    goals?: Goal[];
+    constraints?: Constraint[];
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+    maxContextMessages?: number;
+    tools?: Tool[];
+    memory?: {
+        shortTerm?: boolean;
+        longTerm?: boolean;
+        semantic?: boolean;
+        session?: boolean;
+        user?: boolean;
+        project?: boolean;
+    };
+}
+
+type WorkflowStepType = "agent" | "tool" | "transform" | "condition" | "loop";
+interface WorkflowStepConfig {
+    id: string;
+    name: string;
+    type: WorkflowStepType;
+    agent?: AgentConfig;
+    tool?: Tool;
+    input?: Record<string, unknown>;
+    transform?: (input: unknown) => unknown;
+    condition?: (input: unknown) => boolean;
+    maxIterations?: number;
+    onComplete?: (result: unknown) => void;
+    onError?: (error: Error) => void;
+}
+interface WorkflowConfig {
+    id?: string;
+    name: string;
+    description?: string;
+    steps: WorkflowStepConfig[];
+    maxRetries?: number;
+    onComplete?: (results: unknown[]) => void;
+    onError?: (error: Error) => void;
+}
+interface WorkflowResult {
+    id: string;
+    name: string;
+    success: boolean;
+    steps: WorkflowStepResult[];
+    durationMs: number;
+    error?: string;
+}
+interface WorkflowStepResult {
+    id: string;
+    name: string;
+    type: WorkflowStepType;
+    status: "success" | "failed" | "skipped";
+    input?: unknown;
+    output?: unknown;
+    durationMs: number;
+    error?: string;
+}
+
+interface Plugin {
+    name: string;
+    version: string;
+    description?: string;
+    onLoad?: () => void | Promise<void>;
+    onUnload?: () => void | Promise<void>;
+    onEvent?: (event: LupaEvent) => void | Promise<void>;
+    hooks?: {
+        beforeAgentRun?: (config: Record<string, unknown>) => Record<string, unknown>;
+        afterAgentRun?: (result: unknown) => unknown;
+        beforeToolCall?: (tool: string, args: Record<string, unknown>) => Record<string, unknown>;
+        afterToolCall?: (result: unknown) => unknown;
+        beforeProviderCall?: (provider: string, request: Record<string, unknown>) => Record<string, unknown>;
+        afterProviderCall?: (response: Record<string, unknown>) => Record<string, unknown>;
+    };
+}
+
+export type { AgentCompleteEvent, AgentConfig, AgentErrorEvent, AgentResponseEvent, AgentStartEvent, AgentThinkingEvent, BaseEvent, CompletionRequest, CompletionResponse, Constraint, EventName, Goal, LLMTokenEvent, LupaEvent, MemoryEntry, MemoryQuery, MemoryRetrieveEvent, MemorySearchResult, MemoryType, MemoryUpdateEvent, Message, ModelRole, Personality, Plugin, ProviderCompleteEvent, ProviderConfig, ProviderErrorEvent, ProviderName, ProviderStartEvent, StreamChunk, Tool, ToolCall, ToolDefinition, ToolErrorEvent, ToolFinishEvent, ToolParameter, ToolResult, ToolStartEvent, WorkflowCompleteEvent, WorkflowConfig, WorkflowResult, WorkflowStartEvent, WorkflowStepConfig, WorkflowStepEvent, WorkflowStepResult, WorkflowStepType };

package/dist/index.d.ts

@@ -0,0 +1,319 @@
+type EventName = "agent:start" | "agent:thinking" | "agent:response" | "agent:error" | "agent:complete" | "tool:start" | "tool:finish" | "tool:error" | "memory:update" | "memory:retrieve" | "workflow:start" | "workflow:step" | "workflow:complete" | "workflow:error" | "provider:start" | "provider:complete" | "provider:error" | "llm:token";
+interface BaseEvent {
+    id: string;
+    name: EventName;
+    timestamp: number;
+    agentId?: string;
+    runId?: string;
+}
+interface AgentStartEvent extends BaseEvent {
+    name: "agent:start";
+    config: Record<string, unknown>;
+}
+interface AgentThinkingEvent extends BaseEvent {
+    name: "agent:thinking";
+    message: string;
+}
+interface AgentResponseEvent extends BaseEvent {
+    name: "agent:response";
+    content: string;
+    tokens?: number;
+    latencyMs?: number;
+}
+interface AgentErrorEvent extends BaseEvent {
+    name: "agent:error";
+    error: string;
+    retryAttempt?: number;
+}
+interface AgentCompleteEvent extends BaseEvent {
+    name: "agent:complete";
+    totalTokens: number;
+    totalLatencyMs: number;
+    toolCalls: number;
+}
+interface ToolStartEvent extends BaseEvent {
+    name: "tool:start";
+    tool: string;
+    args: Record<string, unknown>;
+}
+interface ToolFinishEvent extends BaseEvent {
+    name: "tool:finish";
+    tool: string;
+    result: unknown;
+    durationMs: number;
+}
+interface ToolErrorEvent extends BaseEvent {
+    name: "tool:error";
+    tool: string;
+    error: string;
+}
+interface MemoryUpdateEvent extends BaseEvent {
+    name: "memory:update";
+    type: string;
+    key: string;
+}
+interface MemoryRetrieveEvent extends BaseEvent {
+    name: "memory:retrieve";
+    type: string;
+    key: string;
+    results: number;
+}
+interface WorkflowStartEvent extends BaseEvent {
+    name: "workflow:start";
+    steps: number;
+}
+interface WorkflowStepEvent extends BaseEvent {
+    name: "workflow:step";
+    step: number;
+    stepName: string;
+    status: "running" | "completed" | "failed";
+}
+interface WorkflowCompleteEvent extends BaseEvent {
+    name: "workflow:complete";
+    totalSteps: number;
+    failedSteps: number;
+    durationMs: number;
+}
+interface ProviderStartEvent extends BaseEvent {
+    name: "provider:start";
+    provider: string;
+    model: string;
+}
+interface ProviderCompleteEvent extends BaseEvent {
+    name: "provider:complete";
+    provider: string;
+    model: string;
+    tokens: number;
+    latencyMs: number;
+    cost?: number;
+}
+interface ProviderErrorEvent extends BaseEvent {
+    name: "provider:error";
+    provider: string;
+    model: string;
+    error: string;
+}
+interface LLMTokenEvent extends BaseEvent {
+    name: "llm:token";
+    tokens: number;
+    cost?: number;
+}
+type LupaEvent = AgentStartEvent | AgentThinkingEvent | AgentResponseEvent | AgentErrorEvent | AgentCompleteEvent | ToolStartEvent | ToolFinishEvent | ToolErrorEvent | MemoryUpdateEvent | MemoryRetrieveEvent | WorkflowStartEvent | WorkflowStepEvent | WorkflowCompleteEvent | ProviderStartEvent | ProviderCompleteEvent | ProviderErrorEvent | LLMTokenEvent;
+
+interface ToolParameter {
+    type: "string" | "number" | "boolean" | "array" | "object";
+    description: string;
+    required?: boolean;
+    enum?: string[];
+    items?: ToolParameter;
+    properties?: Record<string, ToolParameter>;
+}
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, ToolParameter>;
+    required?: string[];
+}
+interface Tool {
+    definition: ToolDefinition;
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}
+
+type ProviderName = "openai" | "anthropic" | "google" | "openrouter" | "groq" | "mistral" | "xai" | "ollama";
+type ModelRole = "system" | "user" | "assistant" | "tool";
+interface Message {
+    role: ModelRole;
+    content: string | null;
+    toolCallId?: string;
+    name?: string;
+    toolCalls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+}
+interface ToolCall {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+}
+interface ToolResult {
+    toolCallId: string;
+    name: string;
+    content: string;
+}
+interface ProviderConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+}
+interface CompletionRequest {
+    messages: Message[];
+    tools?: Tool[];
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    model?: string;
+}
+interface CompletionResponse {
+    content: string | null;
+    toolCalls: ToolCall[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    latencyMs: number;
+    finishReason: string;
+}
+type StreamChunk = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_call";
+    toolCall: ToolCall;
+} | {
+    type: "finish";
+    content: string;
+    toolCalls: ToolCall[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    finishReason: string;
+};
+
+type MemoryType = "short-term" | "long-term" | "semantic" | "session" | "user" | "project" | "vector";
+interface MemoryEntry {
+    id: string;
+    type: MemoryType;
+    key: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+    scope?: string;
+}
+interface MemoryQuery {
+    type?: MemoryType;
+    key?: string;
+    scope?: string;
+    query?: string;
+    limit?: number;
+    threshold?: number;
+}
+interface MemorySearchResult {
+    entry: MemoryEntry;
+    score: number;
+}
+
+interface Personality {
+    name?: string;
+    traits?: string[];
+    tone?: string;
+    style?: string;
+}
+interface Goal {
+    description: string;
+    priority?: number;
+    completed?: boolean;
+}
+interface Constraint {
+    description: string;
+    type?: "hard" | "soft";
+}
+interface AgentConfig {
+    id?: string;
+    name: string;
+    provider: ProviderName;
+    model?: string;
+    systemPrompt?: string;
+    personality?: Personality;
+    goals?: Goal[];
+    constraints?: Constraint[];
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+    maxContextMessages?: number;
+    tools?: Tool[];
+    memory?: {
+        shortTerm?: boolean;
+        longTerm?: boolean;
+        semantic?: boolean;
+        session?: boolean;
+        user?: boolean;
+        project?: boolean;
+    };
+}
+
+type WorkflowStepType = "agent" | "tool" | "transform" | "condition" | "loop";
+interface WorkflowStepConfig {
+    id: string;
+    name: string;
+    type: WorkflowStepType;
+    agent?: AgentConfig;
+    tool?: Tool;
+    input?: Record<string, unknown>;
+    transform?: (input: unknown) => unknown;
+    condition?: (input: unknown) => boolean;
+    maxIterations?: number;
+    onComplete?: (result: unknown) => void;
+    onError?: (error: Error) => void;
+}
+interface WorkflowConfig {
+    id?: string;
+    name: string;
+    description?: string;
+    steps: WorkflowStepConfig[];
+    maxRetries?: number;
+    onComplete?: (results: unknown[]) => void;
+    onError?: (error: Error) => void;
+}
+interface WorkflowResult {
+    id: string;
+    name: string;
+    success: boolean;
+    steps: WorkflowStepResult[];
+    durationMs: number;
+    error?: string;
+}
+interface WorkflowStepResult {
+    id: string;
+    name: string;
+    type: WorkflowStepType;
+    status: "success" | "failed" | "skipped";
+    input?: unknown;
+    output?: unknown;
+    durationMs: number;
+    error?: string;
+}
+
+interface Plugin {
+    name: string;
+    version: string;
+    description?: string;
+    onLoad?: () => void | Promise<void>;
+    onUnload?: () => void | Promise<void>;
+    onEvent?: (event: LupaEvent) => void | Promise<void>;
+    hooks?: {
+        beforeAgentRun?: (config: Record<string, unknown>) => Record<string, unknown>;
+        afterAgentRun?: (result: unknown) => unknown;
+        beforeToolCall?: (tool: string, args: Record<string, unknown>) => Record<string, unknown>;
+        afterToolCall?: (result: unknown) => unknown;
+        beforeProviderCall?: (provider: string, request: Record<string, unknown>) => Record<string, unknown>;
+        afterProviderCall?: (response: Record<string, unknown>) => Record<string, unknown>;
+    };
+}
+
+export type { AgentCompleteEvent, AgentConfig, AgentErrorEvent, AgentResponseEvent, AgentStartEvent, AgentThinkingEvent, BaseEvent, CompletionRequest, CompletionResponse, Constraint, EventName, Goal, LLMTokenEvent, LupaEvent, MemoryEntry, MemoryQuery, MemoryRetrieveEvent, MemorySearchResult, MemoryType, MemoryUpdateEvent, Message, ModelRole, Personality, Plugin, ProviderCompleteEvent, ProviderConfig, ProviderErrorEvent, ProviderName, ProviderStartEvent, StreamChunk, Tool, ToolCall, ToolDefinition, ToolErrorEvent, ToolFinishEvent, ToolParameter, ToolResult, ToolStartEvent, WorkflowCompleteEvent, WorkflowConfig, WorkflowResult, WorkflowStartEvent, WorkflowStepConfig, WorkflowStepEvent, WorkflowStepResult, WorkflowStepType };

package/dist/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "@lupaflow/types",
-    "version":  "0.1.0",
+    "version":  "0.1.2",
     "type":  "module",
     "license":  "MIT",
     "publishConfig":  {
@@ -16,7 +16,8 @@
                               "import":  "./dist/index.js"
                           }
                 },
-    "scripts":  {
+"files":  ["dist",  "src",  "package.json"],
+    "scripts": {
                     "build":  "tsup",
                     "dev":  "tsup --watch"
                 },

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src"]
-}

package/tsup.config.ts

@@ -1,9 +0,0 @@
-import { defineConfig } from "tsup"
-export default defineConfig({
-  entry: { index: "src/index.ts" },
-  format: ["cjs", "esm"],
-  dts: true,
-  sourcemap: true,
-  clean: true,
-  external: [/node_modules/],
-})