@agents-eco/open-agentic-framework 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,166 @@
+export interface ProviderConfig {
+    name: string;
+    apiKey?: string;
+    baseUrl: string;
+    defaultModel: string;
+    headers?: Record<string, string>;
+}
+export interface ChatMessage {
+    role: "system" | "user" | "assistant" | "tool";
+    content: string;
+    name?: string;
+    toolCallId?: string;
+}
+export interface LLMRequest {
+    model: string;
+    messages: ChatMessage[];
+    temperature?: number;
+    maxTokens?: number;
+    tools?: ToolDef[];
+    toolChoice?: "auto" | "none" | "required" | {
+        type: "function";
+        function: {
+            name: string;
+        };
+    };
+}
+export interface LLMResponse {
+    content: string;
+    toolCalls?: ToolCall[];
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    model: string;
+    finishReason: string;
+}
+export interface ToolDef {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+export interface ToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ToolResult {
+    toolCallId: string;
+    content: string;
+    isError?: boolean;
+}
+export interface SkillFrontmatter {
+    name: string;
+    description: string;
+    version?: string;
+    author?: string;
+    tools?: SkillToolDef[];
+    config?: Record<string, SkillConfigField>;
+}
+export interface SkillToolDef {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface SkillConfigField {
+    type: "string" | "number" | "boolean";
+    description: string;
+    required?: boolean;
+    default?: unknown;
+}
+export interface Skill {
+    /** Parsed frontmatter */
+    meta: SkillFrontmatter;
+    /** Full markdown body (instructions for the LLM) */
+    content: string;
+    /** File path the skill was loaded from */
+    source: string;
+    /** Tool definitions derived from the skill */
+    tools: ToolDef[];
+}
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    type: "conversation" | "observation" | "reflection" | "goal" | "skill";
+    timestamp: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MemoryStore {
+    /** Add a memory entry */
+    add(entry: Omit<MemoryEntry, "id" | "timestamp">): Promise<MemoryEntry>;
+    /** Search memories by query (semantic or keyword) */
+    search(query: string, limit?: number): Promise<MemoryEntry[]>;
+    /** Get all memories */
+    list(limit?: number): Promise<MemoryEntry[]>;
+    /** Clear all memories */
+    clear(): Promise<void>;
+}
+export interface AgentConfig {
+    /** Agent name */
+    name: string;
+    /** System prompt — the agent's personality and instructions */
+    systemPrompt: string;
+    /** LLM provider config */
+    provider: ProviderConfig;
+    /** Model override (defaults to provider.defaultModel) */
+    model?: string;
+    /** Skills to load (file paths or Skill objects) */
+    skills?: (string | Skill)[];
+    /** Skills directory to auto-discover */
+    skillsDir?: string;
+    /** Memory store (defaults to MarkdownMemory) */
+    memory?: MemoryStore | false;
+    /** Memory directory for file-based memory */
+    memoryDir?: string;
+    /** Max reasoning steps for multi-step thinking */
+    maxReasoningSteps?: number;
+    /** Temperature (0-2) */
+    temperature?: number;
+    /** Max tokens per response */
+    maxTokens?: number;
+    /** Tool executor functions keyed by tool name */
+    toolHandlers?: Record<string, ToolHandler>;
+    /** Middleware hooks */
+    hooks?: AgentHooks;
+}
+export type ToolHandler = (args: Record<string, unknown>) => Promise<string> | string;
+export interface AgentHooks {
+    /** Called before sending messages to the LLM */
+    beforeRequest?: (messages: ChatMessage[], tools: ToolDef[]) => ChatMessage[] | Promise<ChatMessage[]>;
+    /** Called after receiving LLM response */
+    afterResponse?: (response: LLMResponse) => LLMResponse | Promise<LLMResponse>;
+    /** Called when a tool is about to be executed */
+    beforeToolCall?: (name: string, args: Record<string, unknown>) => Record<string, unknown> | Promise<Record<string, unknown>>;
+    /** Called after tool execution */
+    afterToolCall?: (name: string, result: ToolResult) => ToolResult | Promise<ToolResult>;
+    /** Called on error */
+    onError?: (error: Error) => void;
+}
+export interface RunResult {
+    response: string;
+    messages: ChatMessage[];
+    toolCalls: Array<{
+        name: string;
+        args: Record<string, unknown>;
+        result: string;
+    }>;
+    usage: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+        llmCalls: number;
+    };
+    duration: number;
+}
+export interface Provider {
+    name: string;
+    chat(request: LLMRequest): Promise<LLMResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// ── Provider (LLM backend) ──────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2DAA2D"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@agents-eco/open-agentic-framework",
+  "version": "0.1.0",
+  "description": "Open agentic framework — skills-as-markdown, pluggable LLM providers, file-based memory. Built for agents.eco.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "agents-eco": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "icon.png",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch"
+  },
+  "keywords": [
+    "agents",
+    "ai",
+    "llm",
+    "agentic",
+    "framework",
+    "skills",
+    "markdown",
+    "agents-eco",
+    "open-source"
+  ],
+  "license": "MIT",
+  "author": "agents.eco",
+  "homepage": "https://agents.eco",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agents-eco/open-agentic-framework"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.3"
+  }
+}

package/skills/code-exec/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: code-exec
+description: Execute JavaScript/TypeScript code snippets and return the output
+version: "1.0"
+tools:
+  - name: execute_code
+    description: Execute a JavaScript code snippet and return stdout/stderr output
+    parameters:
+      type: object
+      properties:
+        code:
+          type: string
+          description: JavaScript code to execute
+        language:
+          type: string
+          description: "Language: 'javascript' or 'typescript' (default: javascript)"
+          enum: [javascript, typescript]
+      required:
+        - code
+---
+
+# Code Execution Skill
+
+When the user asks you to run code, calculate something, or needs a programmatic solution, use the `execute_code` tool.
+
+## Guidelines
+
+- Write clean, self-contained code snippets
+- Use `console.log()` to output results — the tool captures stdout
+- Handle errors gracefully with try/catch
+- For math calculations, use JavaScript's built-in Math library
+- For data processing, write the logic inline (no external imports)
+- Always explain what the code does before running it
+- If the code fails, analyze the error and try a corrected version

package/skills/file-ops/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: file-ops
+description: Read, write, and list files in the workspace
+version: "1.0"
+tools:
+  - name: read_file
+    description: Read the contents of a file
+    parameters:
+      type: object
+      properties:
+        path:
+          type: string
+          description: Path to the file to read
+      required:
+        - path
+  - name: write_file
+    description: Write content to a file (creates or overwrites)
+    parameters:
+      type: object
+      properties:
+        path:
+          type: string
+          description: Path to the file to write
+        content:
+          type: string
+          description: Content to write to the file
+      required:
+        - path
+        - content
+  - name: list_files
+    description: List files and directories at a given path
+    parameters:
+      type: object
+      properties:
+        path:
+          type: string
+          description: Directory path to list (default ".")
+---
+
+# File Operations Skill
+
+When the user asks you to read, write, or manage files, use the file operation tools.
+
+## Guidelines
+
+- Always confirm before overwriting existing files
+- Use relative paths from the workspace root
+- When listing files, present them in a clean, organized format
+- For large files, mention the file size and offer to show specific sections
+- Never read or write files outside the workspace without explicit permission

package/skills/web-search/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: web-search
+description: Search the web for current information using a search query
+version: "1.0"
+tools:
+  - name: web_search
+    description: Search the web for current information. Returns relevant results.
+    parameters:
+      type: object
+      properties:
+        query:
+          type: string
+          description: The search query
+        limit:
+          type: number
+          description: Max number of results (default 5)
+      required:
+        - query
+---
+
+# Web Search Skill
+
+When the user asks about current events, recent information, or anything that requires up-to-date knowledge, use the `web_search` tool.
+
+## Guidelines
+
+- Formulate clear, specific search queries
+- Summarize results concisely — don't just dump raw search results
+- If the first search doesn't find what you need, try rephrasing the query
+- Always cite your sources when presenting information from search results
+- If results are ambiguous, let the user know and offer to refine the search