@easynet/agent-runtime 1.0.2 → 1.0.4

package/.github/workflows/ci.yml

@@ -26,8 +26,6 @@ jobs:
         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: |
@@ -36,32 +34,19 @@ jobs:
           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: Rewrite file deps to npm/git refs for CI
+        env:
+          AGENT_SKILL_READ_TOKEN: ${{ secrets.AGENT_SKILL_READ_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: node scripts/resolve-deps.js
 
       - name: Install dependencies
         env:
           NPM_CONFIG_REGISTRY: "https://registry.npmjs.org/"
-        run: npm install --legacy-peer-deps
+        run: |
+          rm -rf node_modules package-lock.json
+          unset NPM_CONFIG_USERCONFIG NODE_AUTH_TOKEN
+          npm install --legacy-peer-deps --ignore-scripts
 
       - name: Build
         run: npm run build --if-present

package/.github/workflows/release.yml

@@ -32,8 +32,6 @@ jobs:
         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: |
@@ -42,32 +40,19 @@ jobs:
           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: Rewrite file deps to npm/git refs for CI
+        env:
+          AGENT_SKILL_READ_TOKEN: ${{ secrets.AGENT_SKILL_READ_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: node scripts/resolve-deps.js
 
       - name: Install dependencies
         env:
           NPM_CONFIG_REGISTRY: "https://registry.npmjs.org/"
-        run: npm install --legacy-peer-deps
+        run: |
+          rm -rf node_modules package-lock.json
+          unset NPM_CONFIG_USERCONFIG NODE_AUTH_TOKEN
+          npm install --legacy-peer-deps --ignore-scripts
 
       - name: Build
         run: npm run build --if-present
@@ -81,5 +66,32 @@ jobs:
       - name: Release
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-        run: npx semantic-release
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          echo "//registry.npmjs.org/:_authToken=${NPM_TOKEN}" >> .npmrc
+          npx semantic-release
+
+  notify-itermbot:
+    name: Trigger botbotgo/iTermBot
+    runs-on: ubuntu-latest
+    needs: release
+    if: success()
+    steps:
+      - name: Dispatch iTermBot rebuild/release
+        env:
+          DOWNSTREAM_TRIGGER_TOKEN: ${{ secrets.DOWNSTREAM_TRIGGER_TOKEN }}
+        run: |
+          set -euo pipefail
+          if [ -z "${DOWNSTREAM_TRIGGER_TOKEN:-}" ]; then
+            echo "Skipping downstream dispatch: DOWNSTREAM_TRIGGER_TOKEN not set."
+            exit 0
+          fi
+
+          payload=$(printf '{"event_type":"easynet-package-updated","client_payload":{"source_repo":"%s","source_ref":"%s","source_sha":"%s","source_run_id":"%s"}}' "${{ github.repository }}" "${{ github.ref_name }}" "${{ github.sha }}" "${{ github.run_id }}")
+
+          curl -fsSL -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${DOWNSTREAM_TRIGGER_TOKEN}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            "https://api.github.com/repos/botbotgo/iTermBot/dispatches" \
+            -d "${payload}"

package/agent-runtime/.github/workflows/ci.yml

@@ -0,0 +1,69 @@
+name: CI
+
+on:
+  push:
+    branches: ['**']
+  pull_request:
+    branches: ['**']
+  repository_dispatch:
+    types:
+      - easynet-package-updated
+
+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: Rewrite file deps to npm/git refs for CI
+        env:
+          AGENT_SKILL_READ_TOKEN: ${{ secrets.AGENT_SKILL_READ_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: node scripts/resolve-deps.js
+
+      - name: Install dependencies
+        env:
+          NPM_CONFIG_REGISTRY: "https://registry.npmjs.org/"
+        run: |
+          rm -f package-lock.json
+          npm install --legacy-peer-deps --ignore-scripts
+
+      - 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/agent-runtime/.github/workflows/release.yml

@@ -0,0 +1,118 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+  repository_dispatch:
+    types:
+      - easynet-package-updated
+
+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:../)
+        env:
+          AGENT_SKILL_READ_TOKEN: ${{ secrets.AGENT_SKILL_READ_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          node -e "
+          const fs = require('fs');
+          const pkgPath = 'package.json';
+          const p = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+          const deps = { ...p.dependencies, ...p.devDependencies };
+          const token = process.env.AGENT_SKILL_READ_TOKEN || process.env.GITHUB_TOKEN || '';
+          if (!token) {
+            console.error('Missing AGENT_SKILL_READ_TOKEN (or GITHUB_TOKEN) for @easynet/agent-skill private dependency.');
+            process.exit(1);
+          }
+          let changed = false;
+          for (const [name, v] of Object.entries(deps)) {
+            if (name.startsWith('@easynet/') && typeof v === 'string' && v.startsWith('file:')) {
+              const resolved = name === '@easynet/agent-skill'
+                ? ('git+https://x-access-token:' + token + '@github.com/easynet-world/agent-skill.git#master')
+                : 'latest';
+              if (p.dependencies[name]) { p.dependencies[name] = resolved; changed = true; }
+              if (p.devDependencies[name]) { p.devDependencies[name] = resolved; changed = true; }
+            }
+          }
+          if (changed) fs.writeFileSync(pkgPath, JSON.stringify(p, null, 2) + '\n');
+          "
+      - name: Remove lockfile to avoid stale ssh 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
+
+  notify-itermbot:
+    name: Trigger botbotgo/iTermBot
+    runs-on: ubuntu-latest
+    needs: release
+    if: success()
+    steps:
+      - name: Dispatch iTermBot rebuild/release
+        env:
+          DOWNSTREAM_TRIGGER_TOKEN: ${{ secrets.DOWNSTREAM_TRIGGER_TOKEN }}
+        run: |
+          set -euo pipefail
+          if [ -z "${DOWNSTREAM_TRIGGER_TOKEN:-}" ]; then
+            echo "Skipping downstream dispatch: DOWNSTREAM_TRIGGER_TOKEN not set."
+            exit 0
+          fi
+
+          payload=$(printf '{"event_type":"easynet-package-updated","client_payload":{"source_repo":"%s","source_ref":"%s","source_sha":"%s","source_run_id":"%s"}}' "${{ github.repository }}" "${{ github.ref_name }}" "${{ github.sha }}" "${{ github.run_id }}")
+
+          curl -fsSL -X POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${DOWNSTREAM_TRIGGER_TOKEN}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            "https://api.github.com/repos/botbotgo/iTermBot/dispatches" \
+            -d "${payload}"

package/agent-runtime/.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/agent-runtime/config/agent.deep.yaml

@@ -0,0 +1,25 @@
+apiVersion: easynet.world/v1
+kind: AgentConfig
+metadata:
+  name: runtime-deep-default
+spec:
+  systemPrompt: |
+    You are an assistant running in Deep Agent mode.
+    Domain rules are provided by app-level prompt templates.
+
+    ## Execution Rules
+    - Solve tasks in clear multi-step order.
+    - Use available tools as the source of truth.
+    - Prefer low-cost actions first; escalate only when needed.
+
+    ## Response Rules
+    - Keep responses concise, structured, and evidence-based.
+    - Do not invent facts not present in observations.
+    - Keep internal reasoning private.
+
+    ## Memory Rules
+    - Use `thread` for session context and transient details.
+    - Use `cross_thread` for durable preferences/facts.
+    - Never store secrets.
+  recursionLimit: 8
+  memoriesPath: /memories/

package/agent-runtime/config/agent.react.yaml

@@ -0,0 +1,24 @@
+apiVersion: easynet.world/v1
+kind: AgentConfig
+metadata:
+  name: runtime-react-default
+spec:
+  systemPrompt: |
+    You are an assistant running in ReAct mode.
+    Domain rules are provided by app-level prompt templates.
+
+    ## Tool Calls
+    - When taking an action, output exactly one tool call line: `toolName({ ... })`.
+    - The parentheses must contain exactly one valid JSON object.
+    - No extra wrapper text around tool-call JSON.
+
+    ## Response Rules
+    - Be concise, structured, and evidence-based.
+    - Do not invent facts not present in tool outputs.
+    - Keep internal reasoning private.
+
+    ## Memory Rules
+    - Use `thread` for session context and transient details.
+    - Use `cross_thread` for durable preferences/facts.
+    - Never store secrets.
+  maxSteps: 40

package/agent-runtime/example/basic-usage.ts

@@ -0,0 +1,49 @@
+import {
+  createAppContext,
+  createContextBuilders,
+  createConfigApi,
+  loadAppConfig,
+  getModelsConfigPath,
+  getMemoryConfigPath,
+  getToolConfigPath,
+  createReactAgent,
+  printReactSteps,
+  createDeepAgent,
+  malformedToolCallMiddleware,
+  createSubAgentRunner,
+  runAppCli,
+} from "@easynet/agent-runtime";
+
+async function runOnce(): Promise<void> {
+  const { createAgent } = createAppContext();
+  const ctx = await createAgent({ configPath: "./config/app.yaml", agentName: "react" });
+
+  const react = createReactAgent(ctx, { maxSteps: 6 });
+  const result = await react.run("Summarize this repository in one sentence.");
+  console.log(result.text);
+  printReactSteps(result.messages ?? []);
+
+  const sub = createSubAgentRunner(ctx);
+  const subResult = await sub.run("List risks in this codebase.", { kind: "react" });
+  console.log(subResult.text);
+
+  const deep = createDeepAgent(ctx, { maxSteps: 4 });
+  void deep;
+}
+
+function runCli(): void {
+  const configApi = createConfigApi();
+  const config = { app: { agent: { react: {} } } };
+  void loadAppConfig("./config/app.yaml");
+  void getModelsConfigPath(config, "react");
+  void getMemoryConfigPath(config, "react");
+  void getToolConfigPath(config, "react");
+  void createContextBuilders({ configApi });
+  void malformedToolCallMiddleware({ maxRetries: 1, verbose: false });
+
+  const { createBotContext } = createAppContext();
+  runAppCli({ appName: "demo-app", createBotContext: () => createBotContext("./config/app.yaml") });
+}
+
+void runOnce();
+// runCli();