@easynet/agent-runtime 1.0.1

package/.github/workflows/ci.yml

@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches: ['**']
+  pull_request:
+    branches: ['**']
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test & Build
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Force npm registry to npmjs.org
+        run: |
+          touch .npmrc
+          grep -q '^registry=https://registry.npmjs.org' .npmrc || echo "registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@easynet:registry=' .npmrc || echo "@easynet:registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@wallee:registry=' .npmrc || echo "@wallee:registry=https://registry.npmjs.org/" >> .npmrc
+
+      - name: Use @easynet deps from npm (CI has no file:../)
+        run: |
+          node -e "
+          const fs = require('fs');
+          const pkgPath = 'package.json';
+          const p = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+          let changed = false;
+          for (const section of ['dependencies', 'devDependencies']) {
+            if (!p[section]) continue;
+            for (const [name, v] of Object.entries(p[section])) {
+              if (name.startsWith('@easynet/') && typeof v === 'string' && v.startsWith('file:')) {
+                p[section][name] = 'latest';
+                changed = true;
+              }
+            }
+          }
+          if (changed) fs.writeFileSync(pkgPath, JSON.stringify(p, null, 2) + '\n');
+          "
+
+      - name: Remove lockfile to avoid stale local/git refs
+        run: rm -f package-lock.json
+
+      - name: Install dependencies
+        env:
+          NPM_CONFIG_REGISTRY: "https://registry.npmjs.org/"
+        run: npm install --legacy-peer-deps
+
+      - name: Build
+        run: npm run build --if-present
+
+      - name: Typecheck
+        run: npm run typecheck --if-present
+
+      - name: Test
+        run: npm test --if-present
+
+      - name: Diagnostics (on failure)
+        if: failure()
+        run: |
+          echo "Node: $(node -v) | npm: $(npm -v)"
+          echo "--- .npmrc ---"
+          cat .npmrc 2>&1 || true
+          echo "--- npm config ---"
+          npm config list 2>&1 || true
+          npm ls --depth=0 2>&1 | head -50

package/.github/workflows/release.yml

@@ -0,0 +1,82 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Force npm registry to npmjs.org
+        run: |
+          touch .npmrc
+          grep -q '^registry=https://registry.npmjs.org' .npmrc || echo "registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@easynet:registry=' .npmrc || echo "@easynet:registry=https://registry.npmjs.org/" >> .npmrc
+          grep -q '@wallee:registry=' .npmrc || echo "@wallee:registry=https://registry.npmjs.org/" >> .npmrc
+
+      - name: Use @easynet deps from npm (CI has no file:../)
+        run: |
+          node -e "
+          const fs = require('fs');
+          const pkgPath = 'package.json';
+          const p = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+          let changed = false;
+          for (const section of ['dependencies', 'devDependencies']) {
+            if (!p[section]) continue;
+            for (const [name, v] of Object.entries(p[section])) {
+              if (name.startsWith('@easynet/') && typeof v === 'string' && v.startsWith('file:')) {
+                p[section][name] = 'latest';
+                changed = true;
+              }
+            }
+          }
+          if (changed) fs.writeFileSync(pkgPath, JSON.stringify(p, null, 2) + '\n');
+          "
+
+      - name: Remove lockfile to avoid stale local/git refs
+        run: rm -f package-lock.json
+
+      - name: Install dependencies
+        env:
+          NPM_CONFIG_REGISTRY: "https://registry.npmjs.org/"
+        run: npm install --legacy-peer-deps
+
+      - name: Build
+        run: npm run build --if-present
+
+      - name: Typecheck
+        run: npm run typecheck --if-present
+
+      - name: Test
+        run: npm test --if-present
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

package/.releaserc.cjs

@@ -0,0 +1,26 @@
+/** @type {import('semantic-release').GlobalConfig} */
+module.exports = {
+  branches: ['master'],
+  plugins: [
+    [
+      '@semantic-release/commit-analyzer',
+      {
+        releaseRules: [
+          { type: 'feat', release: 'patch' },
+          { type: 'fix', release: 'patch' },
+          { type: 'docs', release: 'patch' },
+          { type: 'chore', release: 'patch' },
+          { type: 'refactor', release: 'patch' },
+          { type: 'perf', release: 'patch' },
+          { type: 'test', release: 'patch' },
+          { type: 'ci', release: 'patch' },
+          { type: 'build', release: 'patch' },
+          { message: '*', release: 'patch' },
+        ],
+      },
+    ],
+    '@semantic-release/release-notes-generator',
+    '@semantic-release/npm',
+    '@semantic-release/git',
+  ],
+};

package/dist/cli.d.ts

@@ -0,0 +1,43 @@
+import { type AgentEventListener } from "@easynet/agent-common";
+import type { BotContext } from "./context.js";
+export interface AppCliUiOptions {
+    /** Prompt/section label for user. Default: current OS user (username(uid)). */
+    userLabel?: string;
+    /** Prompt/section label for assistant. Default: agent kind (ReAct/Deep). */
+    assistantLabel?: string;
+    /** Enable ANSI colors in interactive output. Default: true when TTY and NO_COLOR is not set. */
+    useColor?: boolean;
+    /** Render assistant output as terminal-friendly markdown. Default: true. */
+    renderMarkdown?: boolean;
+    /** Echo the user question in the response section. Default: true. */
+    echoUserQuestion?: boolean;
+    /** Startup loading line. Set false to suppress. */
+    loadingText?: string | false;
+    /** Show animated loading progress while creating bot context. */
+    loadingSpinner?: boolean;
+    /** Startup ready line. Set false to suppress. */
+    readyText?: string | false;
+    /** Interactive intro line before prompt. Set false to suppress. */
+    interactiveIntro?: string | false;
+    /** Show animated spinner while a user request is being processed. */
+    processingSpinner?: boolean;
+    /** Spinner label shown while processing. Set false to suppress label/spinner. */
+    processingText?: string | false;
+}
+export interface AppCliOptions {
+    appName: string;
+    createBotContext: () => Promise<BotContext>;
+    /** Extra interactive commands, e.g. { "list tools": (ctx) => ... } */
+    interactiveCommands?: Record<string, (ctx: BotContext) => void | Promise<void>>;
+    /** Extra event listener(s) for structured runtime logs. */
+    eventListener?: AgentEventListener | AgentEventListener[];
+    /** Called after context is ready, before the REPL starts. Failures are logged but do not crash. */
+    onReady?: (ctx: BotContext) => void | Promise<void>;
+    /** Called during shutdown (exit/signal). Should be synchronous and fast. */
+    onShutdown?: (ctx: BotContext) => void;
+    /** Interactive UI style options. */
+    ui?: AppCliUiOptions;
+}
+export declare function createStructuredRunEventListener(writer?: (line: string) => void): AgentEventListener;
+export declare function runAppCli(options: AppCliOptions): void;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO/C,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gGAAgG;IAChG,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC7B,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC3B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,sEAAsE;IACtE,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChF,2DAA2D;IAC3D,aAAa,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IAC1D,mGAAmG;IACnG,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,4EAA4E;IAC5E,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC;IACvC,oCAAoC;IACpC,EAAE,CAAC,EAAE,eAAe,CAAC;CACtB;AAidD,wBAAgB,gCAAgC,CAC9C,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAoB,GAC7C,kBAAkB,CAkIpB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAoFtD"}