@agentic-eng/easa 0.1.0 → 0.1.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 EASA Contributors
+Copyright (c) 2026 Lahiru Ratnayaka
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,121 +1,55 @@
-# @agentic-eng/easa
+# ⚠️ @agentic-eng/easa — DEPRECATED
 
-> EASA — Easy Agent System Architecture: A minimal, type-safe TypeScript framework for building LLM-powered agent systems.
+> **This package is deprecated and will be removed after 15 April 2026.**
+>
+> Please migrate to [`@agentic-eng/agent`](https://www.npmjs.com/package/@agentic-eng/agent), which contains all the same exports.
 
-[![npm](https://img.shields.io/npm/v/@agentic-eng/easa)](https://www.npmjs.com/package/@agentic-eng/easa)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+---
 
-> **Beta** — API may change before 1.0. Feedback welcome!
+## Migration Guide
 
-This is the **umbrella package** that re-exports everything from all EASA packages in a single import. For granular, tree-shakeable imports, use [`@agentic-eng/agent`](https://www.npmjs.com/package/@agentic-eng/agent) directly.
-
-## Installation
+Replace your dependency:
 
 ```bash
-npm install @agentic-eng/easa
-# or
-pnpm add @agentic-eng/easa
+# Remove this package
+npm uninstall @agentic-eng/easa
+
+# Install the replacement
+npm install @agentic-eng/agent
 ```
 
-## Quick Start
-
-```typescript
-import { Agent, ToolRegistry, FlatFileMemoryProvider, ConsoleEventEmitter } from '@agentic-eng/easa';
-import type { LLMProvider, Tool } from '@agentic-eng/easa';
-
-// 1. Bring your own LLM
-const provider: LLMProvider = {
-  async chat(messages) {
-    const res = await callYourLLM(messages);
-    return { message: { role: 'assistant', content: res.text } };
-  },
-  async *chatStream(messages) {
-    for await (const chunk of streamYourLLM(messages)) {
-      yield { delta: chunk.text, done: chunk.finished };
-    }
-  },
-};
-
-// 2. Define tools
-const calculator: Tool = {
-  definition: {
-    name: 'calculator',
-    description: 'Evaluates arithmetic expressions.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        expression: { type: 'string', description: 'Math expression' },
-      },
-      required: ['expression'],
-    },
-  },
-  async execute(input) {
-    const result = evaluate(input.expression as string);
-    return { toolName: 'calculator', success: true, output: String(result) };
-  },
-};
-
-const tools = new ToolRegistry();
-tools.register(calculator);
-
-// 3. Create an agent
-const agent = new Agent({
-  name: 'assistant',
-  provider,
-  systemPrompt: 'You are a helpful assistant.',
-  tools,
-  memory: new FlatFileMemoryProvider('./memory'),
-  emitter: new ConsoleEventEmitter(),
-  maxIterations: 10,
-});
-
-// 4. Use it
-const result = await agent.invoke('What is 42 × 17?');
-console.log(result.content);
-console.log(`Done in ${result.trace.totalIterations} iteration(s)`);
-
-// Or stream
-for await (const chunk of agent.invokeStream('Tell me a story.')) {
-  process.stdout.write(chunk.delta);
-}
+Update your imports:
+
+```diff
+- import { Agent, ToolRegistry } from '@agentic-eng/easa';
++ import { Agent, ToolRegistry } from '@agentic-eng/agent';
+
+- import type { LLMProvider, Tool } from '@agentic-eng/easa';
++ import type { LLMProvider, Tool } from '@agentic-eng/agent';
 ```
 
-## What's Included
+**No API changes** — all exports are identical. This is a drop-in replacement.
 
-Everything from `@agentic-eng/agent` is re-exported:
+---
 
-| Export | Description |
-| --- | --- |
-| `Agent` | Core agent class with reasoning loop |
-| `ToolRegistry` | Tool management (custom + MCP) |
-| `FlatFileMemoryProvider` | File-based memory using KNL format |
-| `ConsoleEventEmitter` | Pretty-printed console event logger |
-| `NoopEventEmitter` | Silent emitter (default) |
-| `LLMProvider` | Interface — implement for your LLM backend |
-| `Tool` | Interface — implement for custom tools |
-| `MemoryProvider` | Interface — implement for custom storage |
-| `AgentEventEmitter` | Interface — implement for custom observability |
-| Error classes | `EasaError`, `ProviderError`, `AgentConfigError`, `MaxIterationsError`, `ReasoningParseError`, `ToolExecutionError` |
-
-## Key Features
-
-- **Reasoning Loop** — JSON-controlled iteration: the LLM decides when it's done
-- **Tool System** — Hybrid approach: compact index every call, full schema on demand
-- **Memory** — Pluggable persistence (built-in KNL flat files or custom backends)
-- **Event Emission** — OTEL-aligned lifecycle events at every execution point
-- **Streaming** — Single-pass streaming via `invokeStream()`
-- **Zero LLM Lock-in** — Bring any LLM backend via the `LLMProvider` interface
-- **Dual Output** — ESM + CJS with full TypeScript declarations
-
-## Documentation
-
-Full documentation with detailed examples for each feature is available in the [`@agentic-eng/agent` README](https://www.npmjs.com/package/@agentic-eng/agent).
-
-## Granular Packages
-
-| Package | Description |
+## Why?
+
+The `@agentic-eng/easa` umbrella package was a thin re-export layer over `@agentic-eng/agent`. Going forward, `@agentic-eng/agent` is the single, primary package for the EASA framework. Consolidating to one package simplifies installation, reduces confusion, and streamlines releases.
+
+## Timeline
+
+| Date | Action |
 | --- | --- |
-| [`@agentic-eng/agent`](https://www.npmjs.com/package/@agentic-eng/agent) | Core agent, reasoning loop, tools, memory, events |
+| **Now** | `@agentic-eng/easa` marked as deprecated on npm |
+| **15 April 2026** | Final version — no further updates |
+| **After 15 April 2026** | Package will remain on npm but receive no maintenance |
+
+## Feedback & Contact
+
+Questions about migrating? Reach out:
+
+- **Email:** [lahirunimantha@outlook.com](mailto:lahirunimantha@outlook.com)
+- **LinkedIn:** [Lahiru Nimantha](https://www.linkedin.com/in/lahirunimantha/)
 
 ## License
 

package/dist/index.cjs

@@ -2,7 +2,11 @@
 
 var agent = require('@agentic-eng/agent');
 
-
+// src/index.ts
+var _warn = globalThis.console.warn;
+_warn(
+  "\x1B[33m[DEPRECATED]\x1B[0m @agentic-eng/easa is deprecated and will be removed after 15 April 2026. Please migrate to @agentic-eng/agent. See https://www.npmjs.com/package/@agentic-eng/agent"
+);
 
 Object.defineProperty(exports, "Agent", {
   enumerable: true,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs","sourcesContent":[]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAcA,IAAM,KAAA,GAAS,WAA6E,OAAA,CAAQ,IAAA;AACpG,KAAA;AAAA,EACE;AAEF,CAAA","file":"index.cjs","sourcesContent":["/**\n * @deprecated This package is deprecated and will be removed after 15 April 2026.\n * Please migrate to `@agentic-eng/agent` which contains all the same exports.\n *\n * Migration:\n *   npm uninstall @agentic-eng/easa\n *   npm install @agentic-eng/agent\n *\n * Then update imports:\n *   - import { Agent } from '@agentic-eng/easa';\n *   + import { Agent } from '@agentic-eng/agent';\n */\n\n// Runtime deprecation warning\nconst _warn = (globalThis as unknown as { console: { warn: (...args: string[]) => void } }).console.warn;\n_warn(\n  '\\x1b[33m[DEPRECATED]\\x1b[0m @agentic-eng/easa is deprecated and will be removed after 15 April 2026. ' +\n  'Please migrate to @agentic-eng/agent. See https://www.npmjs.com/package/@agentic-eng/agent'\n);\n\n// Core\nexport {\n  Agent,\n  FlatFileMemoryProvider,\n  ToolRegistry,\n  ConsoleEventEmitter,\n  NoopEventEmitter,\n  EasaError,\n  ProviderError,\n  AgentConfigError,\n  MaxIterationsError,\n  ReasoningParseError,\n  ToolExecutionError,\n} from '@agentic-eng/agent';\nexport type {\n  AgentConfig,\n  InvokeResult,\n  LLMProvider,\n  MemoryProvider,\n  Tool,\n  ToolInputSchema,\n  ToolDefinition,\n  ToolCallRequest,\n  ToolResult,\n  EventType,\n  AgentEvent,\n  AgentEventEmitter,\n  Role,\n  Message,\n  ChatOptions,\n  ChatResponse,\n  ChatChunk,\n  TokenUsage,\n  ReasoningAction,\n  LLMReasoningResponse,\n  MemoryEntry,\n  IterationResult,\n  ReasoningTrace,\n  InvokeOptions,\n} from '@agentic-eng/agent';\n"]}

package/dist/index.js

@@ -1,3 +1,9 @@
 export { Agent, AgentConfigError, ConsoleEventEmitter, EasaError, FlatFileMemoryProvider, MaxIterationsError, NoopEventEmitter, ProviderError, ReasoningParseError, ToolExecutionError, ToolRegistry } from '@agentic-eng/agent';
+
+// src/index.ts
+var _warn = globalThis.console.warn;
+_warn(
+  "\x1B[33m[DEPRECATED]\x1B[0m @agentic-eng/easa is deprecated and will be removed after 15 April 2026. Please migrate to @agentic-eng/agent. See https://www.npmjs.com/package/@agentic-eng/agent"
+);
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AAcA,IAAM,KAAA,GAAS,WAA6E,OAAA,CAAQ,IAAA;AACpG,KAAA;AAAA,EACE;AAEF,CAAA","file":"index.js","sourcesContent":["/**\n * @deprecated This package is deprecated and will be removed after 15 April 2026.\n * Please migrate to `@agentic-eng/agent` which contains all the same exports.\n *\n * Migration:\n *   npm uninstall @agentic-eng/easa\n *   npm install @agentic-eng/agent\n *\n * Then update imports:\n *   - import { Agent } from '@agentic-eng/easa';\n *   + import { Agent } from '@agentic-eng/agent';\n */\n\n// Runtime deprecation warning\nconst _warn = (globalThis as unknown as { console: { warn: (...args: string[]) => void } }).console.warn;\n_warn(\n  '\\x1b[33m[DEPRECATED]\\x1b[0m @agentic-eng/easa is deprecated and will be removed after 15 April 2026. ' +\n  'Please migrate to @agentic-eng/agent. See https://www.npmjs.com/package/@agentic-eng/agent'\n);\n\n// Core\nexport {\n  Agent,\n  FlatFileMemoryProvider,\n  ToolRegistry,\n  ConsoleEventEmitter,\n  NoopEventEmitter,\n  EasaError,\n  ProviderError,\n  AgentConfigError,\n  MaxIterationsError,\n  ReasoningParseError,\n  ToolExecutionError,\n} from '@agentic-eng/agent';\nexport type {\n  AgentConfig,\n  InvokeResult,\n  LLMProvider,\n  MemoryProvider,\n  Tool,\n  ToolInputSchema,\n  ToolDefinition,\n  ToolCallRequest,\n  ToolResult,\n  EventType,\n  AgentEvent,\n  AgentEventEmitter,\n  Role,\n  Message,\n  ChatOptions,\n  ChatResponse,\n  ChatChunk,\n  TokenUsage,\n  ReasoningAction,\n  LLMReasoningResponse,\n  MemoryEntry,\n  IterationResult,\n  ReasoningTrace,\n  InvokeOptions,\n} from '@agentic-eng/agent';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-eng/easa",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "EASA — Easy Agent System Architecture: A Minimal TypeScript Framework for Agent Systems.",
   "keywords": [
     "agent",
@@ -43,7 +43,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@agentic-eng/agent": "0.1.0"
+    "@agentic-eng/agent": "0.1.1"
   },
   "devDependencies": {
     "tsup": "^8.0.0",